@endge/core 5.0.0 → 6.0.0

package/dist/features/core/modules/program/EndgeProgram_Module.d.ts

@@ -0,0 +1,111 @@
+import { ActionProgramPayload, ComponentSFCTagRegistryEntry, ComputationProgramPayload, DataViewProgramPayload, EndgeProgramSnapshot, EndgeStyleProgramPayload, ProgramArtifact, ProgramArtifactRef, ProgramArtifactStatus, ProgramDiagnostic, ProgramEntityType, QueryProgramPayload } from './domain/types/program.types';
+import { CompositionProgramPayload } from '../source/domain/types/composition-source.types';
+import { FilterProgramPayload } from '../source/domain/types/filter-source.types';
+import { StoreSourceArtifact } from '../source/domain/types/store-source.types';
+import { StreamSourceArtifact } from '../source/domain/types/stream-source.types';
+import { TypeProgramCatalogEntry, TypeProgramPayload } from '../source/domain/types/type-source.types';
+import { UpdateSourceArtifact } from '../source/domain/types/update-source.types';
+import { VocabProgramPayload } from '../source/domain/types/vocab-source.types';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/**
+ * Хранилище compiled artifacts, полученных после компиляции домена.
+ */
+export declare class EndgeProgram_Module extends EndgeModule {
+    private _artifacts;
+    private _indexByIdentity;
+    private _componentIdentityByTag;
+    private _status;
+    private _compilerVersion;
+    /**
+     * Возвращает общий статус текущей compiled program.
+     */
+    get status(): ProgramArtifactStatus;
+    /**
+     * Возвращает версию компилятора, которой собрана текущая program.
+     */
+    get compilerVersion(): string;
+    /**
+     * Открывает новую сессию компиляции и очищает предыдущие artifacts.
+     */
+    beginCompile(compilerVersion: string): void;
+    /**
+     * Обновляет общий статус program с учетом приоритета warning/error.
+     */
+    setStatus(status: ProgramArtifactStatus): void;
+    /** Пересчитывает общий status после compiler linking pass. */
+    recalculateStatus(): void;
+    /**
+     * Добавляет compiled artifact и индексирует его по id и identity.
+     */
+    addArtifact<TPayload>(artifact: ProgramArtifact<TPayload>): ProgramArtifact<TPayload>;
+    /** Заменяет build-derived registry пользовательских SFC tags. */
+    setComponentTags(entries: readonly ComponentSFCTagRegistryEntry[]): void;
+    /** Разрешает пользовательский SFC tag в persisted identity компонента. */
+    resolveComponentTag(tag: string): string | null;
+    /** Возвращает snapshot build-derived registry без выдачи mutable Map наружу. */
+    getComponentTags(): ComponentSFCTagRegistryEntry[];
+    /**
+     * Возвращает artifact по типу сущности и id или identity.
+     */
+    getArtifact<TPayload = unknown>(entityType: ProgramEntityType, idOrIdentity: string | number): ProgramArtifact<TPayload> | null;
+    /**
+     * Возвращает artifact по compact reference.
+     */
+    getArtifactByRef<TPayload = unknown>(ref: Pick<ProgramArtifactRef, 'entityType'> & {
+        id?: string | number;
+        identity?: string;
+    }): ProgramArtifact<TPayload> | null;
+    /** Возвращает скомпилированный артефакт Action по id или identity. */
+    getActionArtifact(idOrIdentity: string | number): ProgramArtifact<ActionProgramPayload> | null;
+    /** Возвращает compiled query artifact по id или identity. */
+    getQueryArtifact(idOrIdentity: string | number): ProgramArtifact<QueryProgramPayload> | null;
+    /** Возвращает compiled Vocab artifact по id или identity. */
+    getVocabArtifact(idOrIdentity: string | number): ProgramArtifact<VocabProgramPayload> | null;
+    /** Возвращает скомпилированный артефакт Computation по id или identity. */
+    getComputationArtifact(idOrIdentity: string | number): ProgramArtifact<ComputationProgramPayload> | null;
+    /** Возвращает compiled DataView artifact по id или identity. */
+    getDataViewArtifact(idOrIdentity: string | number): ProgramArtifact<DataViewProgramPayload> | null;
+    /** Возвращает compiled Store artifact по id или identity. */
+    getStoreArtifact(idOrIdentity: string | number): ProgramArtifact<StoreSourceArtifact> | null;
+    /** Возвращает compiled Stream artifact по id или identity. */
+    getStreamArtifact(idOrIdentity: string | number): ProgramArtifact<StreamSourceArtifact> | null;
+    /** Возвращает compiled Update artifact по id или identity. */
+    getUpdateArtifact(idOrIdentity: string | number): ProgramArtifact<UpdateSourceArtifact> | null;
+    /** Возвращает compiled Filter artifact по id или identity. */
+    getFilterArtifact(idOrIdentity: string | number): ProgramArtifact<FilterProgramPayload> | null;
+    /** Возвращает compiled Composition artifact по id или identity. */
+    getCompositionArtifact(idOrIdentity: string | number): ProgramArtifact<CompositionProgramPayload> | null;
+    /** Возвращает скомпилированный документ EndgeCSS по сохранённому id или identity. */
+    getStyleArtifact(idOrIdentity: string | number): ProgramArtifact<EndgeStyleProgramPayload> | null;
+    /** Возвращает один артефакт Type, принадлежащий компилятору. */
+    getTypeArtifact(idOrIdentity: string | number): ProgramArtifact<TypeProgramPayload> | null;
+    /** Стабильный каталог для редактора, полученный только из скомпилированных артефактов Type. */
+    getTypeCatalog(): TypeProgramCatalogEntry[];
+    /**
+     * Возвращает diagnostics для конкретного artifact или всей program.
+     */
+    getDiagnostics(ref?: Pick<ProgramArtifactRef, 'entityType'> & {
+        id?: string | number;
+        identity?: string;
+    }): ProgramDiagnostic[];
+    /**
+     * Возвращает все compiled artifacts.
+     */
+    getArtifacts(): ProgramArtifact[];
+    /**
+     * Очищает compiled program и возвращает статус в `valid`.
+     */
+    clear(): void;
+    /**
+     * Сбрасывает program при reset federation.
+     */
+    reset(): void;
+    /**
+     * Формирует summary snapshot для диагностики compiled program.
+     */
+    snapshot(): EndgeProgramSnapshot;
+    /**
+     * Внутренний helper модуля: key For.
+     */
+    private _keyFor;
+}

package/dist/features/core/modules/program/domain/types/action-program.types.d.ts

@@ -0,0 +1,8 @@
+import { ActionTargetSelector } from '../../../actions/domain/action.types';
+import { ActionSourceDocument } from '../../../source/domain/types/action-source.types';
+export interface ActionProgramPayload {
+    type: 'action';
+    sourceVersion: number;
+    sourceDocument: ActionSourceDocument | null;
+    target: ActionTargetSelector[] | null;
+}

package/dist/features/core/modules/program/domain/types/program.types.d.ts

@@ -0,0 +1,291 @@
+import { RComponentContract, RComponentDependencies } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_AST } from '../../../domain/types/component/sfc/ast.types';
+import { RComponentSFC_RuntimeDependencies } from '../../../domain/types/component/sfc/dependencies.types';
+import { RComponentSFC_IR } from '../../../domain/types/component/sfc/ir.types';
+import { RComponentSFCSource_Parts } from '../../../domain/types/component/sfc/source.types';
+import { ComputationProgramPayload } from '../../../domain/types/computation/computation-program.types';
+import { ProgramMetadata } from './program-metadata.types';
+import { DataViewManualTransform, DataViewPipelineStep, DataViewRef, DataViewSourceDocument } from '../../../source/domain/types/data-view-source.types';
+import { ResponseOutputTransform } from '../../../source/domain/types/response-output.types';
+import { QueryProgramProp, SourceExpressionIR, SourceFieldDefinition } from '../../../source/domain/types/source-expression.types';
+import { VocabProgramPayload } from '../../../source/domain/types/vocab-source.types';
+import { EndgeStyleSheetArtifact } from '../../../styles/domain/types/style.types';
+export type { ActionProgramPayload } from './action-program.types';
+export type { ConfigurationProgramPayload } from '../../../source/domain/types/configuration-source.types';
+export type ProgramArtifactKey = string;
+/** Тип доменной сущности, для которой compiler может построить program artifact. */
+export type ProgramEntityType = 'type' | 'component-sfc' | 'computation' | 'action' | 'query' | 'vocab' | 'data-view' | 'store' | 'stream' | 'update' | 'filter' | 'composition' | 'style' | 'configuration';
+/** Итоговый статус artifact после компиляции и валидации. */
+export type ProgramArtifactStatus = 'valid' | 'warning' | 'error';
+/** Возможность, которую artifact предоставляет runtime/render слоям. */
+export type ProgramCapability = 'compilable' | 'runnable' | 'executable' | 'renderable' | 'data-provider' | 'configuration';
+/** Стабильная ссылка на compiled artifact внутри Endge.program. */
+export interface ProgramArtifactRef {
+    /** Тип доменной сущности, которой принадлежит artifact. */
+    entityType: ProgramEntityType;
+    /** Persisted id доменной сущности или fallback id, если persisted id еще нет. */
+    id: string | number;
+    /** Стабильная identity доменной сущности для поиска без привязки к database id. */
+    identity: string;
+}
+/** Диагностическое сообщение, полученное во время компиляции artifact. */
+export interface ProgramDiagnostic {
+    /** Уровень важности диагностического сообщения. */
+    severity: 'info' | 'warning' | 'error';
+    /** Машинный код диагностики для фильтрации, тестов и UI-группировки. */
+    code: string;
+    /** Человекочитаемое описание проблемы или предупреждения. */
+    message: string;
+    /** Artifact, к которому относится диагностика. Заполняется при добавлении в program. */
+    entityRef?: ProgramArtifactRef;
+    /** Путь внутри source/model: например script, template, style или definition.nodes. */
+    sourcePath?: string;
+    /** Абсолютный offset начала проблемного фрагмента в source. */
+    start?: number;
+    /** Абсолютный offset конца проблемного фрагмента в source. */
+    end?: number;
+}
+/** Зависимость compiled artifact от другой доменной сущности или внешней capability. */
+export interface ProgramDependency {
+    /** Тип зависимой сущности. Может быть расширен строкой для внешних источников. */
+    entityType: ProgramEntityType | string;
+    /** Id зависимой сущности, если он известен compiler-у. */
+    id: string | number;
+    /** Identity зависимой сущности, если она известна compiler-у. */
+    identity?: string;
+    /** Роль зависимости: child-component, renderer, data-source и т.п. */
+    role?: string;
+    /** Необязательное местоположение в Source ссылки на зависимость для диагностики linker. */
+    sourcePath?: string;
+    start?: number;
+    end?: number;
+}
+/** Единица compiled program: результат компиляции одной доменной сущности. */
+export interface ProgramArtifact<TPayload = unknown> {
+    /** Ссылка на исходную доменную сущность и ключ artifact в program. */
+    ref: ProgramArtifactRef;
+    /** Hash стабильного source-снимка, по которому можно понять, менялся ли artifact input. */
+    sourceHash: string;
+    /** Версия compiler pipeline, построившая artifact. */
+    compilerVersion: string;
+    /** Hash structural context и effective configuration этой сборки. */
+    contextHash?: string;
+    /** Итоговый статус artifact с учетом diagnostics. */
+    status: ProgramArtifactStatus;
+    /** Список diagnostics, привязанных к artifact. */
+    diagnostics: ProgramDiagnostic[];
+    /** Список зависимостей, найденных compiler-ом. */
+    dependencies: ProgramDependency[];
+    /** Возможности artifact для runtime/render/query слоев. */
+    capabilities: ProgramCapability[];
+    /** Публичная compiler-derived metadata сущности и её внутренних узлов. */
+    metadata: ProgramMetadata;
+    /** Typed payload конкретного artifact: SFC IR, compiled flow, query plan и т.п. */
+    payload: TPayload;
+    /** Локальные compiled artifacts, принадлежащие только этому artifact. */
+    children?: ProgramArtifact[];
+}
+export type QueryProgramOutputSource = {
+    type: 'response';
+    path: string | null;
+    expression?: import('../../../source/domain/types/source-expression.types').SourceExpressionIR;
+} | {
+    type: 'output';
+    key: string;
+};
+export interface QueryProgramOutput {
+    key: string;
+    source: QueryProgramOutputSource;
+    /** Упорядоченная цепочка transform для новых runtimes. */
+    transforms?: ResponseOutputTransform[];
+    /** Проекция совместимости для runtimes, скомпилированных до упорядоченных transforms. */
+    dataViews: DataViewRef[];
+    contract?: SourceFieldDefinition | null;
+    materialization: {
+        kind: 'source';
+    } | {
+        kind: 'derived';
+        strategy: import('../../../source/domain/types/data-view-source.types').DataViewMaterializationStrategy;
+    };
+}
+/** Статическое значение для обратной совместимости или скомпилированное выражение runtime-запроса. */
+export type QueryProgramRequestValue<T> = T | SourceExpressionIR;
+/** Payload artifact для query-сущности. */
+export interface QueryProgramPayload {
+    /** Версия source syntax, определяющая runtime contract. */
+    sourceVersion: number;
+    /** Parser-level AST query source, нужен для diagnostics/debug UI. */
+    ast?: unknown;
+    /** Canonical authoring-модель query source. */
+    sourceDocument?: unknown;
+    /** Тип query: REST, GraphQL, custom или другой поддерживаемый источник. */
+    type: string;
+    /** HTTP method для REST query. */
+    method?: QueryProgramRequestValue<string>;
+    /** Endpoint или базовая ссылка источника данных. */
+    endpoint: QueryProgramRequestValue<string>;
+    /** Тело запроса, GraphQL document или custom query expression. */
+    query: QueryProgramRequestValue<string>;
+    /** GraphQL operation name, если artifact использует query-gql transport. */
+    operationName?: string;
+    /** Политика GraphQL errors в HTTP 2xx response. */
+    errorPolicy?: 'throw' | 'ignore';
+    /** HTTP-заголовки транспорта Query. */
+    headers?: QueryProgramRequestValue<Record<string, string>>;
+    /** Auth config, подготовленный для runtime query layer. */
+    auth?: QueryProgramRequestValue<unknown>;
+    /** Request timeout для REST query. */
+    timeoutMs?: QueryProgramRequestValue<number>;
+    /** Отправлять body как application/x-www-form-urlencoded. */
+    sendAsFormUrlencoded?: QueryProgramRequestValue<boolean>;
+    /** Единственный runtime input contract Query. */
+    props: QueryProgramProp[];
+    /** Безопасный request.body IR. При null отправляется пустой object payload. */
+    requestBody: SourceExpressionIR | null;
+    /** Безопасный GraphQL variables IR. */
+    requestVariables?: SourceExpressionIR | null;
+    /** Включены ли mock data для query. */
+    mockDataEnabled?: boolean;
+    /** Query с mock-payload. */
+    mockData?: unknown;
+    /** Ordered output graph, который runtime вычисляет после backend response. */
+    outputs: QueryProgramOutput[];
+}
+export type { VocabProgramPayload };
+/** Payload artifact для DataView: executable read-model без persisted runtime state. */
+export interface DataViewProgramPayload {
+    /** Тип artifact для diagnostics/debug UI. */
+    type: 'data-view';
+    /** Режим выполнения source: manual transform, pipeline, object projection или root expression. */
+    mode: 'manual' | 'pipeline' | 'projection' | 'expression';
+    /** Runtime-ready strategy; auto всегда разрешен compiler-ом заранее. */
+    materializationStrategy: import('../../../source/domain/types/data-view-source.types').DataViewMaterializationStrategy;
+    /** Canonical source document для debug/preview UI. */
+    sourceDocument: DataViewSourceDocument | null;
+    /** Декларативный входной и выходной тип DataView. */
+    contract?: DataViewSourceDocument['contract'];
+    /** Контракт внешних параметров одного materialized DataView instance. */
+    props?: SourceFieldDefinition[];
+    /** Row-local predicate, применяемый после pipeline steps. */
+    filter?: SourceExpressionIR | null;
+    /** Compiled manual transform. Используется только в mode=manual. */
+    transform: DataViewManualTransform | null;
+    /** Compiled pipeline steps. Используется только в mode=pipeline. */
+    steps: DataViewPipelineStep[];
+    /** Compiled object fields. Используется только в mode=projection. */
+    output: Record<string, SourceExpressionIR>;
+    /** Compiled root expression. Используется только в mode=expression. */
+    expression?: SourceExpressionIR | null;
+}
+/** Payload artifact для нового source-first SFC компонента. */
+export interface ComponentSFCProgramPayload {
+    /** Независимый статус компилятора для каждой секции SFC. */
+    sections?: Record<'script' | 'template' | 'style', ProgramArtifactStatus>;
+    /** Разложенный canonical source: script, template и style. */
+    sourceParts: RComponentSFCSource_Parts;
+    /** Внешний контракт компонента: inputs, events, slots. */
+    contract: RComponentContract;
+    /** Зависимости компонента: дочерние компоненты, data sources, actions, renderers. */
+    dependencies: RComponentDependencies;
+    /** Runtime-зависимости SFC v1, по которым host подписывается на input source. */
+    runtimeDependencies: RComponentSFC_RuntimeDependencies;
+    /** Preview-only props для песочницы/debug UI. Не являются runtime default props. */
+    previewProps: ComponentSFCPreviewProps | null;
+    /** Runtime-параметры только для preview: заполнение локального store, запуск queries/actions и прочее. */
+    previewOptions: ComponentSFCPreviewOptions | null;
+    /** Parser-level AST SFC source, нужен для diagnostics и debug UI. */
+    ast: RComponentSFC_AST | null;
+    /** Target-neutral semantic IR, который renderer-слои используют для DOM/Nova. */
+    ir: RComponentSFC_IR | null;
+}
+/** Source-first документ стилей в payload runtime. */
+export interface EndgeStyleProgramPayload {
+    /** Скомпилированная таблица стилей, нейтральная к renderer. */
+    stylesheet: EndgeStyleSheetArtifact;
+    /** ID тем, предоставляемые этим документом. */
+    themes: string[];
+    /** Внешние зависимости, найденные при компиляции условий стилей. */
+    dependencies: ProgramDependency[];
+}
+export type { ComputationProgramPayload };
+/** Одна запись build-derived registry пользовательских SFC tags. */
+export interface ComponentSFCTagRegistryEntry {
+    /** Пользовательский tag, доступный в template. */
+    tag: string;
+    /** Identity persisted SFC-компонента, на который разрешается tag. */
+    identity: string;
+}
+export type ComponentSFCPreviewLiteral = null | string | number | boolean | ComponentSFCPreviewLiteral[] | {
+    [key: string]: ComponentSFCPreviewLiteral;
+};
+export interface ComponentSFCPreviewStoreProp {
+    type: 'store';
+    path: string;
+}
+export interface ComponentSFCPreviewDataProp {
+    type: 'data';
+    store: string;
+    path: string;
+}
+export type ComponentSFCPreviewPropValue = ComponentSFCPreviewLiteral | ComponentSFCPreviewStoreProp | ComponentSFCPreviewDataProp;
+export type ComponentSFCPreviewProps = Record<string, ComponentSFCPreviewPropValue>;
+export interface ComponentSFCPreviewRunTarget {
+    type: 'query';
+    identity: string;
+    storeTo?: {
+        store: string;
+        fields: Record<string, string>;
+    };
+}
+export interface ComponentSFCPreviewOptions {
+    seed?: Record<string, ComponentSFCPreviewLiteral>;
+    run?: ComponentSFCPreviewRunTarget[];
+}
+/** Контекст одного запуска compiler pipeline. */
+export interface ProgramCompileContext {
+    /** Версия compiler pipeline, которая попадет во все artifacts текущей сборки. */
+    compilerVersion: string;
+    /** Неизменяемый структурный контекст и фактическая конфигурация этой сборки. */
+    buildContext: import('../../../configuration/domain/types/configuration.type').EndgeBuildContext;
+}
+/** Handler компиляции одного типа доменных сущностей. */
+export interface EntityCompilerHandler<TEntity = unknown, TPayload = unknown> {
+    /** Тип сущности, которую умеет компилировать handler. */
+    entityType: ProgramEntityType;
+    /** Функция компиляции одной сущности в один typed artifact. */
+    compile: (entity: TEntity, context: ProgramCompileContext) => ProgramArtifact<TPayload>;
+}
+/** Сводный snapshot текущего Endge.program для diagnostics/debug UI. */
+export interface EndgeProgramSnapshot {
+    /** Unix timestamp создания snapshot. */
+    generatedAt: number;
+    /** Общий статус program, агрегированный по всем artifacts. */
+    status: ProgramArtifactStatus;
+    /** Версия compiler, которой была собрана текущая program. */
+    compilerVersion: string;
+    /** Общее количество artifacts в program. */
+    total: number;
+    /** Количество artifacts по статусам valid/warning/error. */
+    byStatus: Record<ProgramArtifactStatus, number>;
+    /** Количество artifacts по типам доменных сущностей. */
+    byEntityType: Record<string, number>;
+    /** Все diagnostics из всех artifacts. */
+    diagnostics: ProgramDiagnostic[];
+    /** Компактные сведения по каждому artifact без тяжелого payload. */
+    artifacts: Array<{
+        /** Ссылка на artifact. */
+        ref: ProgramArtifactRef;
+        /** Итоговый статус artifact. */
+        status: ProgramArtifactStatus;
+        /** Количество diagnostics у artifact. */
+        diagnostics: number;
+        /** Количество зависимостей у artifact. */
+        dependencies: number;
+        /** Возможности artifact. */
+        capabilities: ProgramCapability[];
+        /** Исходный входной артефакт для hash. */
+        sourceHash: string;
+        /** Версия compiler, построившая artifact. */
+        compilerVersion: string;
+    }>;
+}

package/dist/features/core/modules/runtime/ComponentSFCEventBoundary.d.ts

@@ -0,0 +1,36 @@
+import { RComponentSFC_IR_EventBinding } from '../domain/types/component/sfc/ir.types';
+import { ComponentSFCEventRuntimeSource, ComponentSFCPortManifest, ComponentSFCRequiredPortBinding } from '../domain/types/component/sfc/ports.types';
+import { ComponentSFCRuntimeHost } from './hosts/ComponentSFCRuntimeHost';
+/** Router Event уровня mount для границы одного артефакта Component SFC. */
+export declare class ComponentSFCEventBoundary {
+    private readonly _host;
+    readonly componentIdentity: string;
+    private readonly _manifest;
+    private readonly _parent;
+    private readonly _parentSource?;
+    private readonly _parentBindings;
+    private readonly _parentEventTransform?;
+    private readonly _requiredPortBindings;
+    private readonly _consumedLocalOnce;
+    constructor(_host: ComponentSFCRuntimeHost | null, componentIdentity: string, _manifest: ComponentSFCPortManifest, _parent?: ComponentSFCEventBoundary | null, _parentSource?: ComponentSFCEventRuntimeSource | undefined, _parentBindings?: readonly RComponentSFC_IR_EventBinding[], _parentEventTransform?: ((event: string, payload: unknown) => {
+        event: string;
+        payload: unknown;
+    } | null) | undefined, _requiredPortBindings?: readonly ComponentSFCRequiredPortBinding[]);
+    createChild(componentIdentity: string, manifest: ComponentSFCPortManifest, source: ComponentSFCEventRuntimeSource, bindings?: readonly RComponentSFC_IR_EventBinding[], transform?: (event: string, payload: unknown) => {
+        event: string;
+        payload: unknown;
+    } | null, requiredPortBindings?: readonly ComponentSFCRequiredPortBinding[]): ComponentSFCEventBoundary;
+    /** True, когда текущий публичный манифест наблюдает один Event этого дочернего source. */
+    observesChild(source: ComponentSFCEventRuntimeSource, event: string): boolean;
+    /** Фиксирует логическое правило `.once` уровня mount после его совпадения. */
+    claimLocalOnce(key: string): boolean;
+    /** Выполняет локальные реакции `@event`, затем маршрутизирует событие, если отсутствует `.stop`. */
+    routeChild(source: ComponentSFCEventRuntimeSource, event: string, payload: unknown, bindings?: readonly RComponentSFC_IR_EventBinding[], trace?: string[], depth?: number, scope?: Record<string, unknown>): Promise<void>;
+    /** Получает событие встроенного или вложенного дочернего элемента и вычисляет публичные порты по источнику. */
+    emitChild(source: ComponentSFCEventRuntimeSource, event: string, payload: unknown, trace?: string[], depth?: number): Promise<void>;
+    /** Отправляет Event, объявленный собственным событием этого компонента. */
+    emitOwn(name: string, payload: unknown, trace?: string[], depth?: number): Promise<void>;
+    private _dispatch;
+    private _resolveRequiredPortAction;
+    private _reportError;
+}

package/dist/features/core/modules/runtime/EndgeRuntimeScopes_Module.d.ts

@@ -0,0 +1,32 @@
+import { RuntimeHost } from './domain/runtime-host.types';
+import { RuntimeScope } from './RuntimeScope';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/** Индексирует runtime scopes и membership RuntimeHost. */
+export declare class EndgeRuntimeScopes_Module extends EndgeModule {
+    private readonly _scopes;
+    private readonly _scopeByRuntime;
+    private readonly _scopeDisposers;
+    private _transactionDepth;
+    private _notificationPending;
+    /**
+     * ----------------------------------------
+     * PUBLIC
+     * ----------------------------------------
+     */
+    register(scope: RuntimeScope): RuntimeScope;
+    transaction<T>(operation: () => T): T;
+    get(id: string): RuntimeScope | null;
+    getAll(): RuntimeScope[];
+    snapshot(): import('./domain/runtime-scope.types').RuntimeScopeSnapshot[];
+    attachRuntime(scopeId: string, host: RuntimeHost<any, any>): void;
+    detachRuntime(runtimeId: string): void;
+    getByRuntime(runtimeId: string): RuntimeScope | null;
+    remove(id: string): Promise<void>;
+    reset(): Promise<void>;
+    /**
+     * ----------------------------------------
+     * PRIVATE
+     * ----------------------------------------
+     */
+    private _changed;
+}

package/dist/features/core/modules/runtime/EndgeRuntime_Module.d.ts

@@ -0,0 +1,141 @@
+import { RuntimeEntityType } from './domain/runtime-entity-map.types';
+import { RuntimeExecuteOptions } from './domain/runtime-execute.type';
+import { DestroyedRuntimeHostSnapshot, RuntimeHost, RuntimeInspectionLease } from './domain/runtime-host.types';
+import { AnyRuntimeHost, AnyRuntimeStrategy } from './domain/runtime-strategy.types';
+import { EndgeRuntimeSnapshot, RuntimeExecutableModel } from './domain/runtime.types';
+import { RuntimeAppScopeOptions, RuntimeAppScope } from './RuntimeAppScope';
+import { EndgeDataMode } from '../workspace/domain/workspace.types';
+import { EndgeRuntimeScopes_Module } from './EndgeRuntimeScopes_Module';
+import { EndgeComposition } from './execution/endge-composition';
+import { EndgeDataView } from './execution/endge-data-view';
+import { EndgeProject } from './execution/endge-project';
+import { EndgeQuery } from './execution/endge-query';
+import { EndgeOperations_Module } from './operation/EndgeOperations_Module';
+import { RuntimeScope } from './RuntimeScope';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/** Модуль создания, регистрации и уничтожения runtime hosts и app scopes. */
+export declare class EndgeRuntime_Module extends EndgeModule {
+    readonly query: EndgeQuery;
+    readonly dataView: EndgeDataView;
+    readonly composition: EndgeComposition;
+    readonly project: EndgeProject;
+    readonly operations: EndgeOperations_Module;
+    readonly scopes: EndgeRuntimeScopes_Module;
+    private _hosts;
+    private _strategies;
+    private _inited;
+    private _appNode;
+    private _scopeNodes;
+    private _appScopes;
+    private _defaultAppScope;
+    private _unsubscribeWorkspace;
+    private _unsubscribeContext;
+    private _destroyedSnapshotLeases;
+    private _destroyingRuntimeIds;
+    /** Сохраняет только ограниченные лёгкие описатели для явного inspector. */
+    acquireDestroyedHostSnapshots(limit: number): RuntimeInspectionLease;
+    /** Создаёт default app scope и регистрирует runtime strategies. */
+    constructor();
+    /**
+     * Настраивает Raph runtime до загрузки и сборки домена.
+     */
+    setup(): void;
+    /**
+     * Регистрирует runtime-фазы в Raph один раз.
+     */
+    start(): void;
+    /**
+     * Создаёт runtime-host для переданной доменной модели.
+     */
+    execute(model: RuntimeExecutableModel, options?: RuntimeExecuteOptions): AnyRuntimeHost | null;
+    /** Разрешает data mode по ближайшему Composition override с fallback на общий Endge context. */
+    resolveDataMode(host: RuntimeHost<any, any> | null | undefined): EndgeDataMode;
+    /**
+     * Регистрирует стратегию запуска runtime-сущности.
+     */
+    registerStrategy(strategy: AnyRuntimeStrategy): void;
+    /** Создаёт или возвращает именованный root runtime scope приложения. */
+    createAppScope(options: RuntimeAppScopeOptions): RuntimeAppScope;
+    /** Возвращает lifecycle scope, которому принадлежит RuntimeHost. */
+    getRuntimeScopeByHost(runtimeId: string): RuntimeScope | null;
+    /** Возвращает корневой scope обычного запуска приложения. */
+    getDefaultAppScope(): RuntimeAppScope;
+    /** Возвращает зарегистрированный AppScope. */
+    getAppScope(id: string): RuntimeAppScope | null;
+    /**
+     * Возвращает runtime-host по его runtime-id.
+     */
+    getRuntimeById<T = AnyRuntimeHost>(runtimeId: string): T | null;
+    /**
+     * Возвращает список всех активных runtime-host.
+     */
+    getRuntimeHosts(): AnyRuntimeHost[];
+    /**
+     * Инвалидирует все renderable roots активных application scopes.
+     * Операция намеренно coarse-grained: context preferences меняются редко,
+     * поэтому отдельный dependency graph на этом этапе не нужен.
+     */
+    invalidateApplicationScopes(): void;
+    /** Регистрирует host, созданный владельцем составной runtime-сущности. */
+    registerRuntimeHost(host: AnyRuntimeHost): boolean;
+    /**
+     * Возвращает snapshots удалённых runtime hosts для inspection tools.
+     */
+    getDeletedRuntimeHostSnapshots(): DestroyedRuntimeHostSnapshot[];
+    /**
+     * Полностью удаляет один snapshot уничтоженного runtime host.
+     */
+    removeDeletedRuntimeHostSnapshot(runtimeId: string): void;
+    /**
+     * Полностью очищает snapshots уничтоженных runtime hosts.
+     */
+    clearDeletedRuntimeHostSnapshots(): void;
+    /**
+     * Возвращает runtime-host по доменной сущности.
+     */
+    getRuntimeHostsByEntity(entityType: RuntimeEntityType, entityIdentity: string, appScopeId?: string): AnyRuntimeHost[];
+    /**
+     * Возвращает общий snapshot runtime-состояния.
+     */
+    snapshot(): EndgeRuntimeSnapshot;
+    /**
+     * Корректно разрушает runtime-host по runtime-id.
+     */
+    destroyRuntime(runtimeId: string): void;
+    /**
+     * Корректно разрушает runtime-host и всех его дочерних host.
+     */
+    destroyRuntimeTree(runtimeId: string): void;
+    /** Корректно разрушает runtime tree и ждёт завершения всего teardown. */
+    destroyRuntimeTreeAsync(runtimeId: string): Promise<void>;
+    /**
+     * Корректно разрушает все зарегистрированные runtime-host.
+     */
+    reset(): Promise<void>;
+    /** Проецирует фактические переменные workspace в runtime namespace Raph. */
+    private _syncWorkspaceVariablesToRaph;
+    /** Восстанавливает сохранённые значения runtime-фильтров независимо от переменных workspace. */
+    private _hydrateRuntimeFilters;
+    /**
+     * Внутренний destroy для host с контролем уведомления подписчиков.
+     */
+    private _destroyRuntimeInternal;
+    private _syncDestroyedSnapshotLimit;
+    private _createDestroyedSnapshot;
+    /** Регистрирует host, подключает infrastructure и только затем активирует его. */
+    private _registerAndActivateHost;
+    /** Лениво пересоздаёт корень жизненного цикла после полного Endge.reset(). */
+    private _ensureLifecycleAppScope;
+    /**
+     * Регистрирует встроенные стратегии в порядке от специальных к общим.
+     */
+    private _registerDefaultStrategies;
+    /** Разрешает scope запуска: explicit -> parent -> default app. */
+    private _resolveAppScope;
+    /** Создаёт Raph graph node для AppScope независимо от data namespace. */
+    private _ensureScopeNode;
+    /** Разрешает и проверяет явно переданный parent host. */
+    private _resolveParentHost;
+    /** Разрешает artifact reader и запрещает невалидную явную зависимость. */
+    private _resolveArtifactReader;
+}

package/dist/features/core/modules/runtime/RuntimeActionRegistry.d.ts

@@ -0,0 +1,18 @@
+import { AnyRuntimeAction, RuntimeAction, RuntimeActionContext, RuntimeActionId, RuntimeActionRegistrySnapshot } from '../actions/domain/action.types';
+/** Реестр вызываемых runtime-провайдеров Action. */
+export declare class RuntimeActionRegistry {
+    private readonly _actions;
+    register<TContext extends RuntimeActionContext, TPayload = unknown, TResult = void>(action: RuntimeAction<TContext, TPayload, TResult>): () => void;
+    registerMany(actions: AnyRuntimeAction[]): void;
+    unregister(id: RuntimeActionId): void;
+    clear(): void;
+    has(id: RuntimeActionId): boolean;
+    get<TContext extends RuntimeActionContext, TPayload = unknown, TResult = void>(id: RuntimeActionId): RuntimeAction<TContext, TPayload, TResult> | null;
+    list(input?: {
+        surface?: string;
+    }): AnyRuntimeAction[];
+    canExecute<TContext extends RuntimeActionContext, TPayload = unknown>(id: RuntimeActionId, context: TContext, payload?: TPayload): boolean;
+    execute<TContext extends RuntimeActionContext, TPayload = unknown, TResult = void>(id: RuntimeActionId, context: TContext, payload?: TPayload): Promise<TResult | undefined>;
+    snapshot(): RuntimeActionRegistrySnapshot;
+    private _assertActionId;
+}