Зависимости Level 2

Уточнение графа зависимостей внутри и между доменными пакетами.

Связанные правила

Направление внутри пакета

Исходный модуль	Допустимые зависимости
`business`	Собственные сегменты, объявленный нейтральный `shared`, объявленные business-safe внешние пакеты, type-only публичные business-контракты других доменов
Adapter	Собственный `business`, `infra`, конкретная техническая реализация, `shared`
Preset	Собственный `business`, закрытые или самостоятельные adapters, type-only API других доменов
Framework binding module	Собственный `business`, публичные API framework-модулей своего домена, фреймворк, `ui`, `shared`
Место сборки графа	Публичные API presets и framework-модулей всех входящих в граф доменов

business не достигает adapters, presets, framework-модулей, product SDK, storage, API браузера или Node.js. Проверяется весь транзитивный import-граф его публичной точки входа.

Междоменные импорты

Модуль одного доменного пакета не импортирует runtime-экспорты другого доменного пакета. Разрешён только type-only импорт публичного контракта его business, по возможности суженный через Pick.

import type { AuthApi } from '@/domains/auth/business'

export type UserDeps = {
  auth: Pick<AuthApi, 'getSession'>
}

Type-only импорт остаётся архитектурным ребром. Runtime- и type-only зависимости образуют единый DAG и не могут создавать цикл.

Pure function, hook, Provider, context, component или framework state другого домена являются runtime-экспортами и не образуют исключение. Независимая общая функция переносится в shared, а UI нескольких доменов собирается в compositions.

Runtime-инъекция API

Готовый API другого домена передаётся preset-модулю аргументом. Preset не импортирует его runtime-фабрику или сборку:

createAuthForRequest()
  → AuthApi
  → createUserForRequest({ authApi })
  → UserApi

Место сборки графа создаёт независимые домены раньше зависимых. Если сбой AuthApi становится результатом публичного сценария UserApi, приложению доступна только собственная доменная ошибка User. Точный механизм различения ошибок при exception-модели остаётся открытым вопросом.

Framework-состояние

Framework binding module использует framework API только своего доменного пакета:

// Допустимо внутри domains/auth/react/login-form
import { useAuthSession } from '@/domains/auth/react/session'

// Недопустимо внутри domains/user/react/profile
import { useAuthSession } from '@/domains/auth/react/session'

Во втором случае композиционный модуль читает состояния обоих доменов и передаёт необходимые данные или callbacks через публичные свойства компонентов.

Границы сред

Каждый client-, server- или shared-entry point имеет совместимый транзитивный import-граф. Серверный preset или adapter не реэкспортируется через business, Framework Group или клиентский preset.

Tree shaking не является доказательством изоляции. Проверка выполняется до удаления неиспользуемого кода.

4.8 KiB Raw Blame History Unescape Escape