Собственный контракт становится юнитом или компонентом. Паттерн описывает, как сущности работают вместе. Композиция, зависимая от данных одного продукта, остаётся в этом продукте.
Есть ли у сущности собственные состояния, семантика или повторяемый API?
Нужно ли зафиксировать порядок и отношения нескольких компонентов?
Определяются ли части навигацией, данными или ролями конкретного продукта?
Перенесётся ли решение без копирования маршрутов, терминов и бизнес-логики?
Повторяется ли решение и можно ли отличить его контракт?
Тип: паттерн · Цель: form · Отношение: region.
Секция группирует поля и не добавляет поведения. Нужную семантику задают heading или fieldset с legend.
Что делать. Описывать секции в паттерне form. Универсальная обёртка FormSection скрыла бы выбор семантики.
Тип: компонент · Цель: tag-input · Отношение: entity.
Поле свободных меток с чипами и крестиками — это Tag Input: собственный ввод, значения и удаление.
tagger и tagger__tag — поле ввода и чип с крестиком; свободные значения, справочника нет.Что делать. Использовать tag-input; чип внутри — tag с clearable. Имя tagger остаётся алиасом продукта.
Тип: компонент · Цель: copy-field · Отношение: entity.
Значение только для чтения с кнопкой копирования — Copy Field; имя snippet в системе занято под Svelte snippets.
Что делать. Использовать copy-field; snippet — алиас продукта в описании компонента.
Тип: компонент · Цель: flipper · Отношение: entity.
Переключатель направления сортировки в тулбаре списка — круглая кнопка-значок с циклическим значением, то есть Flipper.
flipper с value 0..3 и type default/plain.flipper-pin уже закрыт Toggle Button short.Что делать. Использовать flipper для циклических режимов, toggle-button — для двоичных.
Тип: компонент · Цель: segmented-control · Отношение: entity.
Три сегмента none / include / exclude с тонами — Segmented Control с tone include и exclude.
deselectable и tone сегментов include/exclude.Что делать. Собирать из segmented-control; отдельная сущность не нужна.
Тип: компонент · Цель: checkbox-group · Отношение: entity.
Список с перетаскиванием порядка на экранах продукта — настройка видимых колонок таблицы: набор признаков, у которых меняют порядок. Это Checkbox Group с reorderable, а не отдельная сущность.
drag-list и drag-list__item — строки с рукояткой и чекбоксом; собственного значения, кроме набора и порядка, нет.Что делать. Использовать checkbox-group с reorderable: рукоятки меняют порядок items, чекбоксы — видимость, а продукт сохраняет порядок через bind:items. Отдельный sortable-list нужен только после появления второго сценария с собственным контрактом.
Тип: продуктовая деталь · Цель: admy-cashback-level · Отношение: local.
Уровни кешбэка — бизнес-данные одного продукта: шкала, пороги и подписи не переносятся.
Что делать. Собирать из meter либо progress с продуктовыми данными; в канон не регистрировать.
Тип: продуктовая деталь · Цель: admy-placeholder-chart · Отношение: local.
Заглушка графика — пустое состояние области с продуктовой иллюстрацией; графиков в каноне нет.
areaStates, а не компонентом.Что делать. На экране — область в состоянии empty; заглушка остаётся в продукте.
Тип: продуктовая деталь · Цель: admy-feed · Отношение: local.
Лента событий определяется данными и типами событий одного продукта.
feed и feed__item перечисляют продуктовые события.Что делать. Собирать ленту из text, status, tag и avatar в паттерне списка; отдельной сущности нет.
Тип: паттерн · Цель: entity-list · Отношение: local.
Список платежей — экземпляр «Списка сущностей»: строки с суммой, датой и состоянием.
payments и payments__item повторяют строку выдачи с наведением; собственного поведения нет.Что делать. Описывать экран платежей паттерном entity-list; компонент не заводить.
Тип: паттерн · Цель: form · Отношение: local.
Экран входа и восстановления пароля — экземпляры «Формы» с полями и одним главным действием.
login и login-password-recovery состоят из Input (пароль — type=password) и Button.Что делать. Собирать по паттерну form в каркасе shell: auth: каркас приложения на экране входа не рисуется, документ стоит в Auth Layout.
Тип: продуктовая деталь · Цель: hierarchical-selector · Отношение: local.
Иерархический выбор в продукте уже признан продуктовым: решение hierarchical-choice отдаёт правила обхода уровней и наследования продукту. Одиночное дерево осталось единственной сущностью канона, которая эти правила частично описывала.
tree-select, ни tree-view не встречаются в китах ADMY Kit и Tesseract и ни на одном из 126 экранов frontend_old.authored в 2026-07: контракт написан от идеи иерархии, а не снят с кита.treeNodeSchema была единственной рекурсивной формой экранного документа — рекурсия обслуживала только эти две сущности.Что делать. Иерархию собирать поверх плоских полей канона (select, combobox, multi-select) продуктовым селектором. В канон дерево не возвращать без имени в ките или экрана продукта.
Тип: компонент · Цель: input · Отношение: entity.
Короткое поле с одним действием и ответом под ним — это Input с кнопкой-суффиксом и подсказкой: собственного контракта у сущности не осталось.
authored в 2026-08.snippet) и остаётся — обратного направления кит не знает.Что делать. Промокод и код приглашения собирать из input с кнопкой-суффиксом; ответ показывать сообщением поля.
Для каждого сценария агент должен выбрать подходящую сущность и отклонить ложные варианты по указанной причине.
global-application-navigation
Выбрать: pattern:application-shell
header - Отдельная оболочка шапки не фиксирует отношения с navigation и main.sidebar - Отдельная боковая панель не задаёт адаптивность и возврат фокуса всего каркаса.Причина. Задача связывает несколько регионов страницы, поэтому её описывает паттерн.
long-form-sections
Выбрать: pattern:form
form-section - Универсальная обёртка скроет различие heading и fieldset/legend.Причина. Секция остаётся регионом формы. У неё нет самостоятельного поведения или переносимого API.
immediate-binary-setting
Выбрать: component:switch
checkbox - Checkbox выражает значение, которое обычно подтверждается вместе с формой.button - Button запускает действие и не сообщает устойчивое булево состояние.toggle-button - Toggle Button переключает локальный режим инструмента, а не самостоятельную настройку с немедленным эффектом.Причина. Switch одновременно показывает текущее состояние и обещает немедленное переключение.
submitted-binary-value
Выбрать: component:checkbox
switch - Switch обещал бы немедленный эффект, которого здесь нет.Причина. Checkbox честно выражает отмечаемое значение до отдельного подтверждения формы.
exact-numeric-value
Выбрать: component:input-number
input - Input хранит строку и подходит цифрам только как идентификатору, телефону или коду.slider - Slider подходит быстрому выбору положения, когда точный ввод вторичен.Причина. Input Number сохраняет числовую форму значения и объединяет точный ввод с границами и шагом.
visible-single-choice
Выбрать: component:radio
select - Select скроет варианты, которые важно сравнить до выбора.segmented-control - Segmented control предназначен для коротких режимов, а не ответов формы.Причина. Radio сохраняет весь набор видимым и связывает варианты общим вопросом.
short-view-mode
Выбрать: component:segmented-control
radio - Radio создаст семантику вопроса формы вместо переключателя режима.select - Select без причины спрячет короткий ряд режимов.tabs - Tabs переключает панели одного контекста, а не значение режима.toggle-group - Toggle Group допускает снять single-выбор или включить несколько независимых режимов.Причина. Segmented control держит короткие режимы видимыми и подчёркивает единственный активный.
fixed-process-position
Выбрать: component:steps
progress - Progress показывает непрерывный или числовой ход одной операции, а не именованные этапы.breadcrumbs - Breadcrumbs описывает иерархический путь страницы, а не последовательность процесса.pagination - Pagination переходит между страницами коллекции и является навигацией.Причина. Steps вычисляет completed, current и upcoming по порядку items. Сам компонент остаётся статическим индикатором.
compact-known-single-choice
Выбрать: component:select
radio - Radio без необходимости займёт место постоянно видимым списком.combobox - Combobox добавит поле поиска к списку, который и без него быстро просматривается.menu - Menu запускает команды, а не хранит выбранное значение формы.Причина. Select сворачивает короткий закрытый список и сохраняет видимым выбранное значение.
long-single-choice
Выбрать: component:combobox
select - Select не фильтрует длинный список по введённому запросу.input - Input примет произвольный текст вместо значения из закрытого набора.Причина. Combobox сохраняет single-choice и добавляет поиск без свободного значения.
destructive-expensive-action
Выбрать: pattern:destructive-confirmation
button - Одна кнопка не содержит проверки объекта и последствия.alert - Alert сообщает риск, но сам не организует подтверждение и отмену.dialog - Один Dialog даёт модальную оболочку, но не фиксирует объект, последствие и пару действий подтверждения.Причина. Задача требует композиции сообщения, спокойной отмены и конкретного danger-действия.
reversible-action-with-undo
Выбрать: component:toast
destructive-confirmation - Паттерн подтверждения нужен только при необратимой или дорогой ошибке.dialog - Модальная пауза избыточна, когда действие можно сразу отменить.Причина. Toast сообщает о результате и даёт отменить действие без отдельного подтверждения заранее.
compact-searchable-multiple-choice
Выбрать: component:multi-select
combobox - Combobox выбирает одно значение и не показывает выбранный набор.dualist - Две рабочие области избыточны для компактного выбранного набора.Причина. Multi Select объединяет поиск и удаляемые выбранные значения в одном поле формы.
searchable-multiple-choice
Выбрать: component:dualist
checkbox-group - Плоская группа не решает поиск и обзор большого выбранного набора.multi-select - Компактное поле не даёт отдельной области для проверки и массового управления выбранным.Причина. Dualist делает доступный и выбранный наборы отдельными областями одного сценария.
hierarchical-choice
Выбрать: product-local:hierarchical-selector
select - Плоский список скроет уровни и родительский путь значения.combobox - Плоский поиск не сохраняет пошаговый просмотр иерархии.multi-select - Multi Select работает с плоским набором и теряет отношения родителей и потомков.Причина. Иерархия осталась за каноном целиком: правила обхода уровней, частичного выбора и наследования задаёт продукт. Канон даёт плоские поля выбора, дерево собирается поверх них.
business-specific-dashboard-block
Выбрать: product-local:campaign-summary
application-shell - Глобальный каркас не должен поглощать бизнес-виджеты страницы.form - Паттерн ввода не описывает продуктовую сводку.Причина. Повторяется бизнес-композиция одного продукта, а не переносимый контракт дизайн-системы.