Тексты, которые пишет скилл (references/texts.md)

Источник: ds-skills/src/skills/astra-figma-doc-build/references/texts.md — справочник скилла astra-figma-doc-build

Документация Astra DS — на русском. Скилл пишет только строки из этого файла; всё остальное приходит из компонента дословно: имена свойств, значений, слоёв, description.

Тон — сухой и описательный: факт из инвентаря, без оценок и советов. Правила инфостиля команды — ds-internal/writing/infostyle.md в корне astra-doc.

1. Глоссарий заголовков блоков

Имя свойства → Title блока в «Спецификации». Свойство не из таблицы — имя дословно.


`Configuration`	Конфигурация
`Size`	Размеры
`State`	Состояния
`Style`	Стили
`Skeleton`	Скелетон

Заголовки взяты из живых секций Astra DS (Tag, Popover). Сравнение — по имени до #, без учёта регистра.

2. Шаблоны «Спецификации»

Подстановки — в <…>. Склонение числительного — функция plural ниже.


`lead`	`description` пуст, есть набор	`<Имя> — <N> <вариант> по свойствам <A>, <B> и <C>.`
`lead.one-axis`	`description` пуст, одно свойство-вариант	`<Имя> — <N> <вариант> по свойству <A>.`
`lead.single`	`description` пуст, компонент без набора	`<Имя> — компонент без вариантов.`
`block.state`	свойство `State` (или по глоссарию «Состояния»)	`У компонента есть следующие состояния` — дословно как в шаблоне `ds-component`
`block.variant`	любое другое свойство-вариант	`Свойство <Имя> — <N> <значение>.`
`block.boolean`	собственное `BOOLEAN`, найден слой с `visible` = это свойство	`Свойство <Имя> показывает и прячет слой <Слой>.`
`block.boolean.no-layer`	слой не найден	описание выключено: `Show Description = false`
`row.boolean`	строки блока `BOOLEAN`	`Включено`, `Выключено` — в этом порядке
`row.variant`	строки блока свойства-варианта	значение дословно, без пояснения

Имена свойств, значений и слоёв в текстах — без кавычек и обратных апострофов: так написаны живые секции.

// plural(5, ["вариант", "варианта", "вариантов"]) → "вариантов"
function plural(n, forms) {
  const a = Math.abs(n) % 100, b = a % 10;
  if (a > 10 && a < 20) return forms[2];
  if (b > 1 && b < 5) return forms[1];
  if (b === 1) return forms[0];
  return forms[2];
}

Формы: ["вариант", "варианта", "вариантов"], ["значение", "значения", "значений"].

3. «История изменений»


`Новая версия`	первая сборка; пользователь сказал «новая версия»	первая — `1.0.0`; дальше `major+1`, `minor=0`, `patch=0`
`Доработка компонента`	пользователь описал доработку	`minor+1`, `patch=0`
`Исправление бага`	пользователь описал исправление	`patch+1`

Пользователь описал изменение, но не назвал тип — Доработка компонента.

Первая запись — без текста описания: так оформлены первые записи Popover и Tag. Текст новой записи при пересборке — слова пользователя об изменении, без пересказа и без добавлений.

Дата — дд.мм.гг, ведущие нули обязательны: 05.03.26, не 5.3.26.

4. Неразрывные пробелы

Всё, что скилл пишет в Figma, проходит через nb() из рецепта 0 (build-recipes.md). Правило команды (infostyle.md, раздел 10):


предлоги, союзы, частицы в одну-две буквы и «для», «без», «при», «под», «над», «про», «или», «как»	неразрывный пробел после	«по·свойству», «и·Size»
тире	неразрывный пробел перед	«Popover·— 8 вариантов»
число и слово после него	неразрывный пробел между	«8·вариантов», «3·значения»

Имена из компонента nb() не ломает: правило трогает только пробелы.

5. Отчёт

Отчёт — в чат, после снимка секции. Пишется инфостилем: главное — в первой строке.


`component`	Компонент
`section`	Секция
`pages`	Страницы
`built`	Собрано
`moved`	Набор перенесён
`generated`	Написал скилл
`no-block`	Свойства без блока
`unplaced`	Оси без подписи
`sparse`	Строки не по мастеру по умолчанию
`typos`	Опечатки исходника
`gaps`	Осталось заполнить
`old`	Старая секция

Порядок: первая строка — что собрано и где (ссылка на секцию). Дальше пункты в порядке таблицы; пустой пункт не писать. В «Осталось заполнить» всегда стоят страницы «Рекомендации» и «Редактура»: их дизайнер добавляет из шаблона ds-component сам.