Агентный слой

Диф

Основной артефакт работы агента: что именно он изменил в файле.

Компонент

terrain/heightmap.ts +3 −2

41const size = 256;

42let seed = 0;

42let seed = Date.now();

— пропущено 18 строк —

Разметка

<div class="inst-diff">
  <div class="inst-diff-head">
    <span class="inst-diff-path">terrain/heightmap.ts</span>
    <span class="inst-diff-stat"><span data-kind="add">+3</span> <span data-kind="del">−2</span></span>
  </div>
  <div class="inst-diff-body">
    <div class="inst-diff-line"><span class="inst-diff-num">41</span><span class="inst-diff-code">const size = 256;</span></div>
    <div class="inst-diff-line" data-kind="del"><span class="inst-diff-num">42</span><span class="inst-diff-code">let seed = 0;</span></div>
    <div class="inst-diff-line" data-kind="add"><span class="inst-diff-num">42</span><span class="inst-diff-code">let seed = Date.now();</span></div>
    <div class="inst-diff-fold">— пропущено 18 строк —</div>
  </div>
</div>

Контракт

Что	Обязательно	Почему
`data-kind` на строке	да	Носитель категории. Строка без него — контекст, и это верное умолчание
`inst-diff-num` отдельным узлом	да	Номер не выделяется мышью: скопированный диф иначе приходит вперемешку с номерами строк
`inst-diff-code` вокруг кода	да	Только он держит моноширинный набор и не переносит строку
`inst-diff-fold` на месте пропуска	нет, но обычно да	Свёрнутый участок — данные о том, что показано не всё

Доступность


Не только цвет	Знак `+`/`−` в первой колонке. Это главное требование компонента
Номера строк	`user-select: none` — при копировании фрагмента номера не попадают в буфер вместе с кодом
Копирование	Знак — псевдоэлемент, поэтому копируется чистый код, а не `+const size`
Путь к файлу	Обрезается с конца многоточием. Полный путь обязан оставаться в `title` — иначе диф безымянен
Прокрутка	Тело прокручивается по горизонтали и должно быть достижимо с клавиатуры
Печать	Тонированные фоны в `@media print` заменяются на печатаемые, знак остаётся: на бумаге тон исчезает вовсе

Устройство

Строка добавления несёт +, строка удаления −. Это выполнение закона библиотеки: цвет не имеет права быть единственным носителем состояния. Диф, где изменения различаются только зелёным и красным фоном, для дальтоника — и на чёрно-белой печати — превращается в сплошной текст.

Знак рисуется псевдоэлементом из data-kind, поэтому он не попадает в выделение и не копируется вместе с кодом.

Варианты

<div class="inst-diff-line" data-kind="add">…</div>

Значение	Что значит
нет атрибута	Строка контекста, не изменялась
`add`	Добавлена
`del`	Удалена

Добавленная строка не находится в состоянии «ok» — она относится к виду «добавление». Поэтому здесь свой атрибут, а не data-tone: тон соврал бы про смысл. Тот же data-kind несут и числа в шапке дифа — одна ось, одна запись.

Поведение

<div class="inst-diff-fold">— пропущено 18 строк —</div>

Как и свёрнутый вывод шага, участок называет своё число словами. Молча пропустить строки — то же враньё про объём.

Сценарии

Диф с шапкой, статистикой и свёрнутым участком.

Что проверить руками: выделите несколько строк и скопируйте. В буфер уйдёт чистый код — без номеров строк и без знаков + и −. Номера несут user-select: none, знак рисуется псевдоэлементом. Диф, из которого нельзя скопировать код, бесполезен в тот момент, когда он нужен.

В контексте

src/world/biomes.ts +3 −2

свёрнуто 118 строк

119119 const seed = opts.seed ?? 0;

120 const noise = simplex2(seed);

121 if (noise > 0.5) return TUNDRA;

120 const noise = simplex2(seed, { octaves: 3 });

121 // тундра и степь перекрывались в 12 клетках — разводим по высоте

122 if (noise > 0.5 && height > 0.72) return TUNDRA;

122123 return STEPPE;