@endge/core 6.0.0 → 7.0.0

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

@@ -2,7 +2,7 @@ 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 { EndgeRuntimeRaphSnapshot, EndgeRuntimeSnapshot, RuntimeExecutableModel } from './domain/runtime.types';
 import { RuntimeAppScopeOptions, RuntimeAppScope } from './RuntimeAppScope';
 import { EndgeDataMode } from '../workspace/domain/workspace.types';
 import { EndgeRuntimeScopes_Module } from './EndgeRuntimeScopes_Module';
@@ -94,10 +94,17 @@ export declare class EndgeRuntime_Module extends EndgeModule {
      * Возвращает runtime-host по доменной сущности.
      */
     getRuntimeHostsByEntity(entityType: RuntimeEntityType, entityIdentity: string, appScopeId?: string): AnyRuntimeHost[];
-    /**
-     * Возвращает общий snapshot runtime-состояния.
-     */
+    /** Включает hosts, scopes и operation histories в диагностическое дерево Module. */
+    createDiagnosticsSnapshot(): EndgeRuntimeSnapshot & {
+        operations: unknown;
+    };
+    /** Возвращает общий snapshot runtime-состояния. */
     snapshot(): EndgeRuntimeSnapshot;
+    /** Формирует принадлежащую runtime-модулю диагностическую проекцию Raph. */
+    snapshotRaph(options: {
+        includeData: boolean;
+        includeGraph: boolean;
+    }): EndgeRuntimeRaphSnapshot;
     /**
      * Корректно разрушает runtime-host по runtime-id.
      */
@@ -116,6 +123,8 @@ export declare class EndgeRuntime_Module extends EndgeModule {
     private _syncWorkspaceVariablesToRaph;
     /** Восстанавливает сохранённые значения runtime-фильтров независимо от переменных workspace. */
     private _hydrateRuntimeFilters;
+    /** Однократно переносит прежний глобальный storage runtime-фильтров. */
+    private _migrateLegacyRuntimeFilters;
     /**
      * Внутренний destroy для host с контролем уведомления подписчиков.
      */

package/dist/features/core/modules/runtime/domain/runtime-host.types.d.ts

@@ -211,6 +211,12 @@ export interface RuntimeHostLocalInputSource {
 export interface RuntimeHostRaphInputBinding {
     path: string;
     wildcardDynamic?: boolean;
+    /** Необязательный исходный DataPath для Meta, если value был преобразован. */
+    metaSource?: {
+        path: string;
+        key?: string;
+        fields?: Record<string, string>;
+    };
 }
 /** Raph-backed input source runtime-host-а. */
 export interface RuntimeHostRaphInputSource {

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

@@ -17,6 +17,18 @@ export interface EndgeRuntimeSnapshot extends RuntimeHostRegistrySnapshot {
     generatedAt: number;
     scopes: import('./runtime-scope.types').RuntimeScopeSnapshot[];
 }
+/** Опциональные данные и graph-состояние Raph для диагностического snapshot. */
+export interface EndgeRuntimeRaphSnapshot {
+    data?: unknown;
+    graph?: {
+        runtimeId: string;
+        loopEnabled: boolean;
+        frame: unknown;
+        nodes: unknown[];
+        tree: unknown[];
+        derived: unknown;
+    };
+}
 /**
  * Событие для query: изменение фильтра
  */

package/dist/features/core/modules/runtime/hosts/ComponentSFCRuntimeHost.d.ts

@@ -2,7 +2,7 @@ import { RComponentSFC } from '../../domain/entities/RComponentSFC';
 import { RComponentContract, RComponentDependencies, RComponentRenderTarget } 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 { ComponentSFCEditedEventPayload, RComponentSFC_IR } from '../../domain/types/component/sfc/ir.types';
+import { ComponentSFCEditedEventPayload, RComponentSFC_IR, RComponentSFC_IR_DataMetaReference } from '../../domain/types/component/sfc/ir.types';
 import { ComponentSFCEventOccurrence, ComponentSFCEventPort, ComponentSFCEventRuntimeSource } from '../../domain/types/component/sfc/ports.types';
 import { RComponentSFCSource_Parts } from '../../domain/types/component/sfc/source.types';
 import { ComputationResource } from '../../domain/types/computation/computation-runtime.types';
@@ -100,6 +100,11 @@ export declare class ComponentSFCRuntimeHost extends RuntimeHostBase<'component-
     setInputSource(input: RuntimeHostInputSource | null | undefined): void;
     /** Возвращает текущий input source host-а. */
     getInputSource(): RuntimeHostInputSource | null;
+    /** Читает Meta-plane по compiler-known ссылке, не раскрывая SFC физический DataPath. */
+    readDataMeta(reference: RComponentSFC_IR_DataMetaReference & {
+        boundaryId?: string;
+        rowKey?: unknown;
+    }, namespace?: string): unknown;
     /**
      * Получает runtime update от universal boundary phase.
      *
@@ -128,6 +133,10 @@ export declare class ComponentSFCRuntimeHost extends RuntimeHostBase<'component-
     private _createRuntimeBoundaryNodes;
     private _createTableColumnBoundaryNode;
     private _bindRaphInputSource;
+    private _bindRaphMetaInputSource;
+    private _resolveDataMetaObservedPath;
+    private _resolveDataMetaPath;
+    private _mapMetaField;
     /** Зависимости контекста основаны на Raph и не зависят от вида входных props компонента. */
     private _bindRaphContextSources;
     private _observeContextPath;

package/dist/features/core/modules/runtime/hosts/CompositionRuntimeHost.d.ts

@@ -126,6 +126,7 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     private _compiledInputs;
     /** Материализует authored bindings в единый runtime input source child Composition. */
     private _makeInputSource;
+    private _makeMetaSourceInputBinding;
     private _subscribeBinding;
     private _bindingPath;
     private _materializeBinding;

package/dist/features/core/modules/runtime/hosts/StoreRuntimeHost.d.ts

@@ -31,6 +31,8 @@ export declare class StoreRuntimeHost extends RuntimeHostBase<'store', RuntimeHo
     getDataSnapshot(): Readonly<Record<string, unknown>>;
     /** Проверяет, можно ли записывать в root field указанного Store path. */
     isWritable(path: string): boolean;
+    /** Проверяет принадлежность root field этому Store, включая derived field. */
+    isDeclared(path: string): boolean;
     /** Записывает значение в writable Store field и запускает derived graph через Raph. */
     set(path: string, value: unknown): void;
     /**
@@ -51,4 +53,6 @@ export declare class StoreRuntimeHost extends RuntimeHostBase<'store', RuntimeHo
     private _mount;
     private _makeMutationPlans;
     private _applyMutationPlan;
+    private _validateMetaPlan;
+    private _validateMutationPlans;
 }

package/dist/features/core/modules/runtime/operation/EndgeOperations_Module.d.ts

@@ -19,6 +19,8 @@ export declare class EndgeOperations_Module extends EndgeModule {
     redo(): Promise<unknown>;
     canUndo(): boolean;
     canRedo(): boolean;
+    /** Возвращает безопасное summary зарегистрированных operation histories. */
+    createDiagnosticsSnapshot(): unknown;
     /** Освобождает histories и глобальный keyboard listener текущего Runtime. */
     reset(): void;
     /**

package/dist/features/core/modules/source/domain/types/composition-source.types.d.ts

@@ -86,6 +86,7 @@ export type CompositionBindingValue = {
     kind: 'data';
     data: string;
     path: string;
+    metaSource?: CompositionMetaSourceBinding;
 } | {
     kind: 'runtime-metadata';
     runtime: string;
@@ -100,10 +101,18 @@ export type CompositionBindingValue = {
     path: string;
     identity: string;
     props: Record<string, CompositionBindingValue>;
+    metaSource?: CompositionMetaSourceBinding;
 } | {
     kind: 'expression';
     expression: SourceExpressionIR;
 };
+/** Явная provenance-ссылка Meta-plane для преобразованного входного значения. */
+export interface CompositionMetaSourceBinding {
+    data: string;
+    path: string;
+    key?: string;
+    fields?: Record<string, string>;
+}
 export interface CompositionDataDescriptor {
     name: string;
     /** Полный data path. Для root data совпадает с name. */

package/dist/features/core/modules/source/domain/types/source-expression.types.d.ts

@@ -3,7 +3,7 @@ import { TypeSourceExpression } from './type-source.types';
 /** Identity Type Registry для контрактов полей Query и Filter. */
 export type SourceFieldType = 'String' | 'Number' | 'Boolean' | 'Date' | 'Time' | 'DateTime' | 'Object' | 'Any' | (string & {});
 /** Источник безопасного чтения значения внутри source expression. */
-export type SourceExpressionReadKind = 'env' | 'prop' | 'value' | 'row' | 'response' | 'store' | 'current' | 'scope' | 'composition-output' | 'composition-outputs' | 'composition-data' | 'composition-store' | 'composition-filter-fields' | 'composition-runtime-metadata' | 'metadata' | 'computation-output';
+export type SourceExpressionReadKind = 'env' | 'prop' | 'value' | 'row' | 'response' | 'store' | 'current' | 'scope' | 'composition-output' | 'composition-outputs' | 'composition-data' | 'composition-store' | 'composition-filter-fields' | 'composition-runtime-metadata' | 'metadata' | 'computation-output' | 'update-input' | 'update-item' | 'update-parent' | 'update-data' | 'update-meta' | 'update-has-data' | 'update-has-meta';
 /** Whitelist операций статического expression IR. */
 export type SourceExpressionOperation = 'merge' | 'compact' | 'get' | 'get-or' | 'has' | 'default-to' | 'pick' | 'omit' | 'defaults' | 'keys' | 'values' | 'entries' | 'map' | 'where' | 'reject' | 'find' | 'some' | 'every' | 'flat-map' | 'flatten' | 'uniq' | 'uniq-by' | 'concat' | 'take' | 'drop' | 'sort-by' | 'group-by' | 'key-by' | 'size' | 'sum' | 'sum-by' | 'min' | 'max' | 'min-by' | 'max-by' | 'trim' | 'lower-case' | 'upper-case' | 'split' | 'join' | 'match' | 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'includes' | 'or' | 'when' | 'not' | 'is-nil' | 'is-empty' | 'and' | 'between' | 'in-list' | 'in-array' | 'relative-date' | 'relative-date-time' | 'left-join' | 'full-join' | 'join-by' | 'join-by-any' | 'join-coalesce' | 'lookup-one' | 'lookup-many' | 'enrich' | 'coalesce' | 'choose' | 'lookup-value' | 'to-string' | 'to-number' | 'to-boolean' | 'type-of' | 'is-string' | 'is-number' | 'is-boolean' | 'is-array' | 'is-object' | 'is-date-time' | 'is-duration' | 'add' | 'subtract' | 'multiply' | 'divide' | 'modulo' | 'abs' | 'negate' | 'round' | 'floor' | 'ceil' | 'clamp' | 'average' | 'average-by' | 'starts-with' | 'ends-with' | 'replace' | 'replace-all' | 'slice' | 'pad-start' | 'pad-end' | 'normalize-whitespace' | 'set' | 'unset' | 'rename' | 'get-key' | 'from-entries' | 'first' | 'last' | 'at' | 'reverse' | 'sort-by-desc' | 'order-by' | 'chunk' | 'union' | 'intersection' | 'difference' | 'count-by' | 'date-time' | 'duration' | 'date-time-add' | 'date-time-subtract' | 'date-time-difference' | 'date-time-start-of' | 'date-time-end-of' | 'date-time-part' | 'duration-add' | 'duration-subtract' | 'duration-total' | 'contains-all' | 'contains-any';
 /**

package/dist/features/core/modules/source/domain/types/update-source.types.d.ts

@@ -1,11 +1,16 @@
 import { ProgramDiagnostic } from '../../../program/domain/types/program.types';
+import { SourceExpressionIR } from './source-expression.types';
 export type UpdateMutationStrategy = 'set' | 'merge' | 'replace' | 'append' | 'remove';
 export interface UpdateMutationDescriptor {
     strategy: UpdateMutationStrategy;
     target: string;
+    plane?: 'data' | 'meta';
+    namespace?: string | null;
     forEach: string | null;
     ifExists: string | null;
     valueFrom: string | null;
+    value?: SourceExpressionIR | null;
+    when?: SourceExpressionIR | null;
     vars: Record<string, string>;
 }
 export interface UpdateSourceDocument {
@@ -25,8 +30,10 @@ export interface UpdateSourceCompileResult {
     diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
 }
 export interface StoreMutationPlan {
+    plane?: 'data' | 'meta';
     strategy: UpdateMutationStrategy;
     path: string;
+    namespace?: string;
     value?: unknown;
     vars?: Record<string, unknown>;
 }

package/dist/features/core/modules/ui/EndgeUI_Module.d.ts

@@ -5,25 +5,27 @@ import { EndgeModule } from '../../../federation/EndgeModule';
  */
 export declare class EndgeUI_Module extends EndgeModule {
     private _offContext;
+    private _offZoomState;
     private _offWorkspace;
     private readonly _MIN_ZOOM;
     private readonly _MAX_ZOOM;
     private readonly _STEP_ZOOM;
     private readonly _DEFAULT_ZOOM;
-    private readonly _LS_KEY_ZOOM;
+    private readonly _ZOOM_STATE_KEY;
+    private readonly _LEGACY_LS_KEY_ZOOM;
     private _zoom;
     private _theme;
     /**
-     * Восстанавливает UI-настройки из localStorage и применяет тему к document.
+     * Создаёт UI-модуль с безопасными bootstrap defaults и применяет тему к document.
      */
     constructor();
     /** Подключает UI projection к пользовательскому контексту после загрузки workspace. */
     start(): void;
     /** Отключает runtime subscription; пользовательское значение остаётся в EndgeContext_Module. */
     reset(): void;
-    /**
-     * Возвращает полный snapshot UI-настроек.
-     */
+    /** Включает текущие UI-настройки в диагностическое дерево. */
+    createDiagnosticsSnapshot(): EndgeUISnapshot;
+    /** Возвращает полный snapshot UI-настроек. */
     get snapshot(): EndgeUISnapshot;
     /**
      * Возвращает текущий процент zoom.
@@ -53,14 +55,9 @@ export declare class EndgeUI_Module extends EndgeModule {
      * Внутренний helper модуля: clamp Zoom.
      */
     private _clampZoom;
-    /**
-     * Считывает Zoom From LS.
-     */
-    private _readZoomFromLS;
-    /**
-     * Записывает Zoom To LS.
-     */
-    private _writeZoomToLS;
+    private _syncZoomFromContext;
+    /** Однократно переносит прежний глобальный zoom в user-scoped context state. */
+    private _migrateLegacyZoom;
     /**
      * Возвращает текущую тему.
      */

package/dist/features/core/modules/ui/ui-composition.config.d.ts

@@ -33,7 +33,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
         }[];
     };
     defaultLayout?: undefined;
@@ -78,7 +78,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -126,7 +126,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -174,7 +174,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -222,7 +222,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -270,7 +270,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -319,7 +319,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: ({
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -375,7 +375,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -423,7 +423,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: ({
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;
@@ -481,7 +481,7 @@ export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
         roles: {
             role: string;
             description: string;
-            supportedSurfaces: ("runtime" | "canvas" | "admin")[];
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
             defaultRendererRefs: {
                 admin: string;
                 runtime: string;

package/dist/features/federation/EndgeFederation.d.ts

@@ -1,80 +1,108 @@
-import { AnyEndgeModule, EndgeFederationContextOf, EndgeFederationModuleAccessors, EndgeModuleDefinitions, EndgeModuleDescriptor, EndgePlugin } from './types/endge-modules.types';
-import { EndgeFederationContext, EndgeFederationDefinition, EndgeFederationHost, EndgeFederationState } from './types/federation.types';
+import { AnyEndgeModule, EndgeFederationContextOf, EndgeFederationModuleAccessors, EndgeModuleDefinition, EndgeModuleDefinitions, EndgeModuleDescriptor } from './types/endge-modules.types';
+import { AnyEndgeFederation, EndgeChildFederationDefinition, EndgeChildFederationDefinitions, EndgeFederationContext, EndgeFederationDefinition, EndgeFederationDiagnosticsSnapshot, EndgeFederationDiagnosticsSnapshotOptions, EndgeFederationHost, EndgeFederationState, EndgeLifecycleNodeDescriptor, EndgePlugin } from './types/federation.types';
+type EndgeFederationPhase = 'setup' | 'load' | 'build' | 'start';
+declare const ENDGE_FEDERATION_CONTROL_KEY: unique symbol;
+type UnionToIntersection<TValue> = (TValue extends unknown ? (value: TValue) => void : never) extends ((value: infer TResult) => void) ? TResult : never;
+type EndgeChildFederationContext<TFederation> = TFederation extends {
+    boot: (ctx: infer TContext) => Promise<void>;
+} ? TContext : EndgeFederationContext;
+type EndgeChildFederationsContext<TDefinitions extends EndgeChildFederationDefinitions> = [TDefinitions[number]] extends [never] ? EndgeFederationContext : UnionToIntersection<EndgeChildFederationContext<TDefinitions[number]['federation']>> extends infer TContext extends EndgeFederationContext ? TContext : EndgeFederationContext;
 type EndgeFederationConstructor = abstract new (...args: any[]) => EndgeFederation;
 type EndgeFederationStatics = Omit<typeof EndgeFederation, 'prototype' | 'boot' | 'build'>;
-export type DefinedEndgeFederation<TDefinitions extends EndgeModuleDefinitions, TContext extends EndgeFederationContext = EndgeFederationContextOf<TDefinitions>> = EndgeFederationConstructor & EndgeFederationStatics & EndgeFederationModuleAccessors<TDefinitions> & {
+type EndgeFederationAccessors<TDefinitions extends EndgeChildFederationDefinitions> = {
+    readonly [TDefinition in TDefinitions[number] as TDefinition['key']]: TDefinition['federation'];
+};
+export type DefinedEndgeFederation<TDefinitions extends EndgeModuleDefinitions, TFederations extends EndgeChildFederationDefinitions = readonly [], TContext extends EndgeFederationContext = EndgeFederationContextOf<TDefinitions> & EndgeChildFederationsContext<TFederations>> = EndgeFederationConstructor & EndgeFederationStatics & EndgeFederationModuleAccessors<TDefinitions> & EndgeFederationAccessors<TFederations> & {
     readonly prototype: EndgeFederation;
     boot: (ctx: TContext) => Promise<void>;
     build: (ctx?: TContext) => Promise<void>;
 };
+interface EndgeFederationControl {
+    readonly id: string;
+    attach: (parentFederationId: string) => void;
+    createDiagnosticsSnapshot: (path: string[], options: EndgeFederationDiagnosticsSnapshotOptions) => EndgeFederationDiagnosticsSnapshot;
+    configure: () => void;
+    runPhase: (phase: EndgeFederationPhase, ctx: EndgeFederationContext) => Promise<void>;
+    reset: () => Promise<void>;
+}
 /**
- * Общая статическая федерация модулей.
- * Хост федерации живёт в `globalThis`, поэтому один и тот же класс
+ * Общая статическая федерация lifecycle-узлов.
+ * Хост федерации живёт в `globalThis`, поэтому один и тот же id
  * остаётся singleton даже при загрузке из разных пакетов/бандлов.
  */
 export declare abstract class EndgeFederation {
     protected static readonly federationId: string;
-    /**
-     * Создаёт статическую федерацию с ленивыми модулями и типизированными readonly accessors.
-     * Для дополнительного поведения возвращённый class-like facade можно наследовать.
-     */
-    static define<const TDefinitions extends EndgeModuleDefinitions>(definition: EndgeFederationDefinition<TDefinitions>): DefinedEndgeFederation<TDefinitions, EndgeFederationContextOf<TDefinitions>>;
+    protected static readonly federationDefinitionSignature: string | null;
+    /** Стабильная runtime identity Federation. */
+    static get id(): string;
+    /** Создаёт Federation с ленивыми Modules и дочерними Federations. */
+    static define<const TDefinitions extends EndgeModuleDefinitions, const TFederations extends EndgeChildFederationDefinitions = readonly []>(definition: EndgeFederationDefinition<TDefinitions, TFederations>): DefinedEndgeFederation<TDefinitions, TFederations>;
     static get isInitialized(): boolean;
     static get isConfigured(): boolean;
     static get state(): EndgeFederationState;
     static get lastError(): unknown | null;
-    /**
-     * Хук для одноразовой регистрации модулей в порядке вызова.
-     */
+    /** Рекурсивно снимает диагностическое состояние явного Federation graph. */
+    static createDiagnosticsSnapshot(options?: EndgeFederationDiagnosticsSnapshotOptions): EndgeFederationDiagnosticsSnapshot;
+    /** Хук одноразовой декларации собственных lifecycle-узлов Federation. */
     protected static configureFederation(): void;
-    /**
-     * Запускает федерацию по полному lifecycle pipeline: `setup -> load -> build -> start`.
-     */
+    /** Запускает всё дерево Federation по pipeline `setup -> load -> build -> start`. */
     static boot(ctx: EndgeFederationContext): Promise<void>;
     private static _runBoot;
-    /**
-     * Добавляет plugin в список расширений федерации.
-     * Plugin устанавливается во время конфигурации федерации, до boot.
-     */
+    /** Регистрирует декларативное расширение до configuration Federation. */
     static use(plugin: EndgePlugin): void;
-    /**
-     * Декларирует модуль федерации.
-     * Итоговый порядок строится после установки plugin-модулей.
-     */
+    /** Декларирует уже созданный Module во время custom configuration. */
     static defineModule<T extends AnyEndgeModule>(descriptor: EndgeModuleDescriptor<T>): T;
-    /**
-     * Декларирует модули федерации.
-     * Итоговый порядок строится после установки plugin-модулей.
-     */
-    static defineModules(descriptors: EndgeModuleDescriptor[]): void;
-    /**
-     * Выполняет `setup()` для всех модулей один раз до первого `start()`.
-     */
-    protected static setup(ctx?: EndgeFederationContext, touchedModules?: Set<AnyEndgeModule>): Promise<void>;
-    protected static load(ctx?: EndgeFederationContext, touchedModules?: Set<AnyEndgeModule>): Promise<void>;
+    static defineModules(descriptors: readonly EndgeModuleDescriptor[]): void;
+    /** Декларирует лениво создаваемые Modules во время configuration. */
+    protected static defineModuleDefinitions(definitions: readonly EndgeModuleDefinition[]): void;
+    /** Декларирует дочернюю Federation как composite lifecycle-узел. */
+    static defineFederation(definition: EndgeChildFederationDefinition): void;
+    static defineFederations(definitions: readonly EndgeChildFederationDefinition[]): void;
+    protected static setup(ctx?: EndgeFederationContext, touchedNodes?: Set<EndgeLifecycleNodeDescriptor>): Promise<void>;
+    protected static load(ctx?: EndgeFederationContext, touchedNodes?: Set<EndgeLifecycleNodeDescriptor>): Promise<void>;
     static build(ctx?: EndgeFederationContext): Promise<void>;
-    protected static start(ctx?: EndgeFederationContext, touchedModules?: Set<AnyEndgeModule>): Promise<void>;
-    /**
-     * Выполняет `reset()` в обратном dependency order и сбрасывает состояние федерации.
-     */
+    protected static start(ctx?: EndgeFederationContext, touchedNodes?: Set<EndgeLifecycleNodeDescriptor>): Promise<void>;
+    /** Сбрасывает всё дерево в обратном dependency order. */
     static reset(): Promise<void>;
     private static _runReset;
     private static _buildPhase;
     private static _runPhase;
-    private static _resetModules;
+    private static _resetNodes;
     private static _finishBuild;
+    private static _finishReset;
     static getModule<T extends AnyEndgeModule = AnyEndgeModule>(key: string): T;
     static tryGetModule<T extends AnyEndgeModule = AnyEndgeModule>(key: string): T | null;
     static hasModule(key: string): boolean;
+    static getFederation<T extends AnyEndgeFederation = AnyEndgeFederation>(key: string): T;
+    static tryGetFederation<T extends AnyEndgeFederation = AnyEndgeFederation>(key: string): T | null;
+    static hasFederation(key: string): boolean;
     protected static get host(): EndgeFederationHost;
+    private static _ensureConfigured;
     private static _getFederationId;
     private static _createHost;
     private static _getOrCreateHost;
     private static _normalizeHost;
-    private static _normalizeDefinitions;
+    private static _normalizeModuleDefinitions;
+    private static _normalizeFederationDefinitions;
+    private static _normalizeNodeKey;
     private static _requireBootContext;
+    private static _requireConfiguringHost;
+    private static _assertNodeKeyAvailable;
+    private static _validatePluginKeys;
     private static _installPlugins;
-    private static _finalizeModules;
+    private static _finalizeNodes;
+    private static _defineAccessors;
+    private static _defineHostAccessors;
+    private static _assertAccessorAvailable;
+    private static _defineAccessor;
+    private static _createDefinitionSignature;
+    private static _createPluginSignature;
+    private static _getFederationControl;
+    protected static [ENDGE_FEDERATION_CONTROL_KEY](): EndgeFederationControl;
+    private static _createDiagnosticsSnapshot;
+    private static _attachToParent;
+    private static _runAttachedPhase;
+    private static _resetAttached;
     private static _registry;
 }
 export {};

package/dist/features/federation/EndgeModule.d.ts

@@ -37,6 +37,13 @@ export declare abstract class EndgeModule<TContext extends EndgeFederationContex
      * Метод можно не переопределять.
      */
     reset(): void | Promise<void>;
+    /**
+     * Возвращает состояние Module для общего диагностического snapshot.
+     * По умолчанию используется persistence-проекция `serialize()`; Module может
+     * переопределить метод более подробным или безопасным диагностическим представлением.
+     * Снимки принадлежащих Module submodules явно включает их родитель.
+     */
+    createDiagnosticsSnapshot(): unknown;
     /**
      * Возвращает сериализуемый snapshot состояния модуля.
      * Конкретный persistent Module сам определяет storage contract и момент сохранения.

package/dist/features/federation/tools/sort-endge-modules.d.ts

@@ -1,2 +1,9 @@
 import { EndgeModuleDescriptor } from '../types/endge-modules.types';
+interface EndgeOrderedDescriptor {
+    readonly key: string;
+    readonly before?: string | readonly string[];
+    readonly after?: string | readonly string[];
+}
+export declare function sortEndgeOrderedDescriptors<TDescriptor extends EndgeOrderedDescriptor>(descriptors: readonly TDescriptor[]): TDescriptor[];
 export declare function sortEndgeModuleDescriptors(descriptors: EndgeModuleDescriptor[]): EndgeModuleDescriptor[];
+export {};

package/dist/features/federation/types/endge-modules.types.d.ts

@@ -1,10 +1,11 @@
 import { EndgeModule } from '../EndgeModule';
-import { EndgeFederationContext } from './federation.types';
+import { EndgeFederationContext, EndgeFederationDiagnosticsSnapshot, EndgeFederationDiagnosticsSnapshotOptions } from './federation.types';
 export type AnyEndgeModule = EndgeModule<any>;
 export type EndgeModuleOrder = string | readonly string[];
 /** Доступ к уже объявленным модулям во время создания graph dependencies. */
 export interface EndgeModuleFactoryContext {
     getModule: <T extends AnyEndgeModule = AnyEndgeModule>(key: string) => T;
+    createDiagnosticsSnapshot: (options?: EndgeFederationDiagnosticsSnapshotOptions) => EndgeFederationDiagnosticsSnapshot;
 }
 /** Декларативное описание лениво создаваемого модуля федерации. */
 export interface EndgeModuleDefinition<TKey extends string = string, TModule extends AnyEndgeModule = AnyEndgeModule> {
@@ -29,8 +30,4 @@ export type EndgeFederationContextOf<TDefinitions extends EndgeModuleDefinitions
 export type EndgeFederationModuleAccessors<TDefinitions extends EndgeModuleDefinitions> = {
     readonly [TDefinition in TDefinitions[number] as TDefinition['key']]: ReturnType<TDefinition['create']>;
 };
-export interface EndgePlugin {
-    id: string;
-    install: () => void;
-}
 export {};