textmachine/frontend
2026-08-02 20:22:21 +03:00
..
docs Write S2 session prompt: shell and ui-layer scope, owner layout corrections over stale prompt section, gate-tail backlog rows in scope, S3 entry blocked on API contract 2026-08-02 20:22:21 +03:00
scripts Add self-installing pre-commit gate: frontend commits demand green check, zone-mixing and never-commit files blocked, plus exact version pins and engine-strict npmrc 2026-08-02 19:39:29 +03:00
src Move run state from chapters to books, derive language and phased progress from data, extend the network gate to every transport, and lock route and lang literals with tests 2026-08-02 18:04:06 +03:00
.gitignore Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference 2026-08-02 15:07:34 +03:00
.npmrc Add self-installing pre-commit gate: frontend commits demand green check, zone-mixing and never-commit files blocked, plus exact version pins and engine-strict npmrc 2026-08-02 19:39:29 +03:00
.prettierignore Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference 2026-08-02 15:07:34 +03:00
.prettierrc.json Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference 2026-08-02 15:07:34 +03:00
eslint.config.js Move run state from chapters to books, derive language and phased progress from data, extend the network gate to every transport, and lock route and lang literals with tests 2026-08-02 18:04:06 +03:00
index.html Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference 2026-08-02 15:07:34 +03:00
package-lock.json Add self-installing pre-commit gate: frontend commits demand green check, zone-mixing and never-commit files blocked, plus exact version pins and engine-strict npmrc 2026-08-02 19:39:29 +03:00
package.json Add self-installing pre-commit gate: frontend commits demand green check, zone-mixing and never-commit files blocked, plus exact version pins and engine-strict npmrc 2026-08-02 19:39:29 +03:00
README.md Add self-installing pre-commit gate: frontend commits demand green check, zone-mixing and never-commit files blocked, plus exact version pins and engine-strict npmrc 2026-08-02 19:39:29 +03:00
stylelint.config.js Isolate mocks behind src/api seam enforced by lint, fix two inverted verdict phrasings against engine docs, add accessibility and type-aware gates, encode chapter state by shape and colour 2026-08-02 17:22:53 +03:00
tsconfig.json Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference 2026-08-02 15:07:34 +03:00
vite.config.ts Land frontend S1: pinned Vite/React/TS scaffold, five-step check with verified colour gate, no-sudo Playwright shot loop, measured tokens.css, showcase converged with Fleet reference 2026-08-02 15:07:34 +03:00

frontend — веб-интерфейс

Зона записи сессий «Фронт». Пройдены этапы S0 (план) и S1 (инструменты, скриншот-цикл, токены, витрина); продуктовых экранов ещё нет — они на S2S7 (docs/BACKLOG.md, Ф-1).

Как запустить

npm install
npm run dev          # http://localhost:5173/showcase
npm run check        # prettier → eslint → stylelint → tsc → vitest
npm run check:full   # + сборка + скриншот
npm run shot         # снимок витрины в .shots/ — открыть и посмотреть глазами

Для скриншот-цикла нужен Chromium Playwright и локальные библиотеки в .tooling/ (ставятся без sudo, процедура — docs/FRONTEND_PLAN.md §4).

npm install заодно ставит pre-commit хук (scripts/githooks/): коммит с frontend-путями не проходит без зелёного npm run check; смесь frontend/ с чужой зоной и файлы «никогда не коммитить» блокируются для всех (D39.88). Обход — git commit --no-verify.

Что здесь будет

Веб-приложение поверх ../platform/. MVP — не IDE, а дашборд + читалка: библиотека книг, наблюдение за прогоном, подпись банка памяти, сравнение оригинала с переводом, добавление главы. Редактирование перевода прямо в интерфейсе — ПОЗЖЕ (тогда появится редактор текста; в MVP не нужен).

Десктоп — то же самое приложение в окне (Tauri), отдельной логики не имеет. В MVP не делается.

Документы

  • docs/FRONTEND_SESSION_PROMPT.md — промт фронт-сессий: область этапов, референсы с измеренными значениями, экраны, ограничения, порядок работы.
  • docs/STACK_DECISIONS.md — пины версий, ловушки и список того, что достраивается в движке. Источник: многоагентное исследование 02.08.2026.
  • docs/FRONTEND_PLAN.md — план S0: сверенные пины, карта src/, слои каскада, правила поддерживаемости в проверяемой форме, протокол скриншот-цикла, перепроверенные замеры референса и список расхождений витрины.
  • docs/PROGRESS.md — журнал зоны: текущее состояние, решения владельца по продукту, открытые вопросы, хроника сессий.
  • docs/BACKLOG.md — зонный бэклог фронта.
  • references/ — три скриншота-референса (Fleet, Antigravity).

Источник внешнего вида — один

Замеры с references/fleet.png, зафиксированные в tokens.css. Промежуточных дизайн-макетов нет: инструменты проектирования макетов не используются (решение владельца 02.08). Палитра и геометрия сняты с референса пипеткой и лежат в STACK_DECISIONS.md и §1.1 промта — их берут как данность, а не выводят заново.

⚠ JetBrains Fleet закрыт (скачивание прекращено 22.12.2025) — добрать новые измерения неоткуда. Всё, что не замерено (кегли, интерлиньяж, внутренние отступы), подбирается на глаз по скриншоту.