sync

DRAFT/level-3/domains/framework-bindings.md

@@ -0,0 +1,109 @@
+# Framework bindings внутри Domain
+
+> Рабочая заметка. Не является нормативным разделом спецификации.
+
+## Определение
+
+### FW-N001: Framework code определяется зависимостью от framework
+
+К framework code относится код, существующий из-за React, Vue, Next.js или другого framework/runtime contract:
+
+- components;
+- providers и contexts;
+- framework hooks;
+- framework lifecycle;
+- directives и framework entrypoints;
+- framework-specific types;
+- server/client component boundaries.
+
+Такой код может принадлежать Domain по смыслу, но не размещается внутри framework-neutral business.
+
+## Роль binding
+
+### FW-N002: Framework binding адаптирует готовый business API
+
+Framework binding может:
+
+- предоставить готовый business API через context/provider;
+- построить React/Vue hook доступа;
+- связать framework lifecycle с domain subscription;
+- предоставить domain-specific framework component;
+- получить API instance через props, context или preset.
+
+Framework binding не изменяет business rules и не реализует source adapter вместо Domain preset/adapters.
+
+## Возможная структура
+
+```text
+domains/auth/{framework-binding}/
+├── providers/
+├── hooks/
+├── components/
+├── types/
+└── index.ts
+```
+
+`{framework-binding}` является placeholder. SLM пока не выбирает между `react`, `bindings/react`, `framework/react` и другим локальным соглашением. Чёткая граница определяется самостоятельным module и отдельным public entrypoint, а не обязательным именем родительской папки.
+
+Если одна папка предоставляет cohesive framework API, она является module. Если папка только классифицирует несколько самостоятельных binding modules, она является logical group и не имеет собственного `index.ts`.
+
+## Reactive state
+
+### FW-N003: Framework hook строится снаружи business
+
+Если business предоставляет framework-neutral `getSnapshot` и `subscribe`, React binding может использовать `useSyncExternalStore`:
+
+```ts
+'use client'
+
+export const createUseAuth = (authApi: AuthApi) => {
+  return () => {
+    return useSyncExternalStore(
+      authApi.subscribeAuthState,
+      authApi.getAuthState,
+      authApi.getAuthState,
+    )
+  }
+}
+```
+
+Это только иллюстрация направления. Финальная форма state port должна учитывать реальный state/query runtime.
+
+Business при таком подходе не импортирует React и не возвращает React hook как единственный способ чтения состояния.
+
+## Framework module как assembly site
+
+### FW-N004: Provider может владеть API instance
+
+Provider вправе вызвать preset или factory, если provider является явным владельцем scope и lifecycle:
+
+```text
+AuthProvider
+  → createBrowserAuth preset
+  → AuthApi instance
+  → context
+  → access hooks
+```
+
+Provider construction не должен запускать I/O или subscription до framework commit/effect. Cleanup выполняется владельцем lifecycle.
+
+Framework module не обязан собирать API. Он также может получить готовый instance от route/page/application graph owner.
+
+## Framework-neutral и environment-neutral
+
+Эти свойства различаются:
+
+| Свойство | Запрещённая зависимость |
+|---|---|
+| Framework-neutral | React, Vue, Next lifecycle и types |
+| Environment-neutral | Browser-only, Node-only, server-only, env/runtime globals |
+
+Business factory должна удовлетворять обоим свойствам. Framework binding по определению framework-specific, а preset по определению может быть environment-specific.
+
+## Domain UI
+
+### FW-N005: Framework принадлежность не доказывает Domain ownership
+
+React component размещается внутри Domain только если его ответственность принадлежит Domain. Page, screen, route outcome, локальный текст ошибки и продуктовая композиция могут остаться в `compositions`.
+
+Граница между domain-specific components и consumer compositions пока требует отдельных примеров.