slm-design/DRAFT/domains/framework-bindings.md

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.

Возможная структура

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:

'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:

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 пока требует отдельных примеров.