Начать работу

«42» — переносимая спецификация, не пакет компонентов. Выберите сценарий: адаптировать канон в продукте или добавить публичный скин.

Что здесь можно подключить

Внешний продукт берёт канон, примеры и токены как контракт, затем реализует их в своём стеке.

Публичный скин — дельта компонентных токенов поверх Blueprint. Он живёт в «42» и доступен всем потребителям.

Открыть полный обзор и индекс канона

Разработчику

Адаптируйте контракт в своём продукте и фиксируйте синхронизацию manifest/lock-файлами. Готовой зависимости для установки нет.

  1. Опишите локальное покрытие. Создайте 42.consumer.json: укажите framework, canonical id реализованных компонентов, локальные пути, соответствие пропсов и осознанные отступления.
  2. Зафиксируйте релиз. Сохраните версию и ревизии из release.json в 42.lock.json. При обновлении читайте changes.json только для сущностей из manifest.
  3. Реализуйте решение по намерению. Найдите сущность по useCases и прочитайте её правила, состояния и невозможные комбинации. Если канон не покрывает задачу, зафиксируйте пробел и не придумывайте API.
  4. Возьмите пример и значения. Возьмите сценарий из examples.json, значения — из tokens.json, покрытие скинами — из scope.json.

Открыть

  • release.json — текущая версия и ревизии артефактов и сущностей
  • consumer-examples.json — Vue- и Svelte-примеры manifest/lock-протокола
  • spec.json — нормативный контракт: выбор, правила и API сущностей
  • examples.json — живые Svelte-примеры без ручной копии кода
  • tokens.json — DTCG-проекция значений и алиасов токенов
  • agents.md — готовый порядок работы для ИИ-агента
  • Удалённый MCP — resources и tools поверх того же release bundle

Дизайнеру

Добавляйте скин, только если он должен стать публичной частью «42».

  1. Начните с Blueprint. Сравните Blueprint с макетом и выпишите отличающиеся компонентные токены. Поведение, API и сетка --sp-* остаются общими.
  2. Подготовьте дельту, а не вторую систему. В src/styles/skins/<id>.css оставьте только переопределения [data-skin='<id>']. Не добавляйте неизвестные токены и вторую шкалу отступов.
  3. Зарегистрируйте скин. Импортируйте CSS-дельту в src/app.css и добавьте id, название, краткое описание и источник в src/lib/spec/skins.js.
  4. Проверьте результат. Проверьте скин в селекте, на /skins и в /scope.json. Затем запустите контракт, контраст и сборку.

Открыть

  • Скины — живое сравнение существующих productScope
  • Скоуп — фактическое покрытие компонентов каждым скином
  • Архитектура скинов — границы Blueprint, дельт и автоматических проверок

Граница двух сценариев

  • Локальная реализация продукта остаётся в его репозитории и не регистрируется как скин «42».
  • «42» публикует контракт и проверочные фикстуры, но не читает и не изменяет репозиторий потребителя.
  • Публичный скин меняет productScope, но сохраняет поведение канона.
  • Устанавливаемая библиотека компонентов — отдельный продукт, не способ подключить эту спецификацию.