@endge/core 6.0.0 → 7.0.0

package/dist/features/core/kernel/config/modules.config.d.ts

@@ -59,7 +59,7 @@ export declare const ENDGE_CORE_MODULES: readonly [{
     readonly after: readonly ["workspace", "domain", "context", "configurationSchema"];
 }, {
     readonly key: "diagnostics";
-    readonly create: () => EndgeDiagnostics_Module;
+    readonly create: ({ createDiagnosticsSnapshot, getModule }: import('../../../federation/types/endge-modules.types').EndgeModuleFactoryContext) => EndgeDiagnostics_Module;
     readonly after: "configuration";
 }, {
     readonly key: "source";

package/dist/features/core/kernel/endge.d.ts

@@ -1,8 +1,8 @@
 /**
  * Единая статическая федерация Endge Core.
- * Lifecycle context и readonly accessors выводятся из деклараций её Modules.
+ * Lifecycle context и readonly accessors выводятся из деклараций её graph.
  */
-export declare const Endge: import('../../federation/EndgeFederation').DefinedEndgeFederation<readonly [{
+declare const EndgeCore: import('../../federation/EndgeFederation').DefinedEndgeFederation<readonly [{
     readonly key: "context";
     readonly create: () => import('../modules/context/EndgeContext_Module').EndgeContext_Module;
 }, {
@@ -35,7 +35,7 @@ export declare const Endge: import('../../federation/EndgeFederation').DefinedEn
     readonly after: readonly ["workspace", "domain", "context", "configurationSchema"];
 }, {
     readonly key: "diagnostics";
-    readonly create: () => import('../modules/diagnostics/EndgeDiagnostics_Module').EndgeDiagnostics_Module;
+    readonly create: ({ createDiagnosticsSnapshot, getModule }: import('../../../main').EndgeModuleFactoryContext) => import('../modules/diagnostics/EndgeDiagnostics_Module').EndgeDiagnostics_Module;
     readonly after: "configuration";
 }, {
     readonly key: "source";
@@ -109,4 +109,10 @@ export declare const Endge: import('../../federation/EndgeFederation').DefinedEn
     readonly key: "styles";
     readonly create: () => import('../modules/styles/EndgeStyles_Module').EndgeStyles_Module;
     readonly after: readonly ["ui", "domain", "program", "compiler"];
-}], import('../../../main').EndgeFederationContext & import('./types/bootstrap.types').EndgeBootContext>;
+}], readonly [], import('../../../main').EndgeFederationContext & import('./types/bootstrap.types').EndgeBootContext>;
+/** Типизированные accessors, которые внешние packages добавляют через module augmentation. */
+export interface EndgeExtensions {
+}
+/** Единый facade Core и всех зарегистрированных до boot расширений. */
+export declare const Endge: typeof EndgeCore & Readonly<EndgeExtensions>;
+export {};

package/dist/features/core/modules/EndgeRuntimeDebugger_Module.d.ts

@@ -36,6 +36,8 @@ export declare class EndgeRuntimeDebugger_Module extends EndgeModule {
      * Возвращает накопленные результаты анализа для вкладки.
      */
     getAnalysis(tabId: string): string[];
+    /** Возвращает безопасную диагностическую проекцию известных debug-вкладок. */
+    createDiagnosticsSnapshot(): unknown;
     /**
      * Отправить команду во все подключённые вкладки.
      * Используется админкой для запуска анализа по текущей вкладке.

package/dist/features/core/modules/auth/EndgeAuth_Module.d.ts

@@ -1,6 +1,6 @@
 import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
 import { AuthInteractionRequiredError } from './domain/AuthInteractionRequiredError';
-import { AuthProfileSchema, OidcBrowserSessionOptions } from './domain/types/auth-profile.types';
+import { AuthProfileSchema, EndgeAuthContext, OidcBrowserSessionOptions } from './domain/types/auth-profile.types';
 import { OidcBrowserSession_Adapter } from './adapters/OidcBrowserSession_Adapter';
 import { AuthAdapterRegistry } from './services/AuthAdapterRegistry';
 import { AuthProfileRegistry } from './services/AuthProfileRegistry';
@@ -25,6 +25,8 @@ export declare class EndgeAuth_Module extends EndgeModule<EndgeBootContext> {
     constructor();
     /** Подписывает host-приложение на запросы, требующие интерактивного OIDC flow. */
     onInteractionRequired(listener: AuthInteractionRequiredListener): () => void;
+    /** Возвращает безопасный auth context без tokens, claims и userinfo. */
+    createDiagnosticsSnapshot(): EndgeAuthContext;
     /** Подключает storage namespace и безопасные context providers. */
     setup(ctx: EndgeBootContext): void;
     /** Валидирует Domain profiles и восстанавливает session default runtime profile. */

package/dist/features/core/modules/configuration/EndgeConfiguration_Module.d.ts

@@ -9,6 +9,8 @@ export declare class EndgeConfiguration_Module extends EndgeModule<EndgeBootCont
     build(ctx: EndgeBootContext): void;
     /** Очищает effective configuration перед следующим boot. */
     reset(): void;
+    /** Включает effective configuration текущего build в диагностическое дерево. */
+    createDiagnosticsSnapshot(): EndgeConfiguration;
     /** Возвращает effective configuration текущего build. */
     get current(): EndgeConfiguration;
     /** Возвращает immutable compiler input текущего build. */

package/dist/features/core/modules/configuration/domain/types/configuration.type.d.ts

@@ -1,5 +1,5 @@
 import { DiagnosticsSeverityNumber, DiagnosticsSignal, EndgeDiagnosticsConfiguration, EndgeDiagnosticsOutputConfiguration, EndgeDiagnosticsRoute } from '../../../diagnostics/domain/types/diagnostics.types';
-import { ComponentSFCInteractionKeyboardCondition, ComponentSFCInteractionTrigger } from '../../../domain/types/component/sfc/ir.types';
+import { ComponentSFCInteractionKeyboardCondition, ComponentSFCInteractionTrigger, ComponentSFCInteractionTriggerActivation } from '../../../domain/types/component/sfc/ir.types';
 import { EndgeExecutionContext } from '../../../runtime/domain/execution-context.types';
 import { EndgeJSONValue } from '../../../source/domain/types/configuration-source.types';
 export type EndgeConfigurationValues = Record<string, Record<string, EndgeJSONValue>>;
@@ -130,6 +130,12 @@ export interface EndgeDiagnosticsSnapshotContentPatch {
     telemetry?: EndgeValueOverride<boolean>;
     problems?: EndgeValueOverride<boolean>;
     configuration?: EndgeValueOverride<boolean>;
+    effectiveConfiguration?: EndgeValueOverride<boolean>;
+    domain?: EndgeValueOverride<boolean>;
+    program?: EndgeValueOverride<boolean>;
+    runtime?: EndgeValueOverride<boolean>;
+    raphData?: EndgeValueOverride<boolean>;
+    raphGraph?: EndgeValueOverride<boolean>;
 }
 /** Patch условий автоматического snapshot. */
 export interface EndgeDiagnosticsAutomaticSnapshotPatch {
@@ -139,9 +145,15 @@ export interface EndgeDiagnosticsAutomaticSnapshotPatch {
     cooldownSeconds?: EndgeValueOverride<number>;
     outputIds?: EndgeCollectionPatch<string>;
 }
+/** Patch snapshot, скачиваемого глобальной комбинацией клавиш. */
+export interface EndgeDiagnosticsShortcutSnapshotPatch {
+    triggerSet?: EndgeValueOverride<ComponentSFCInteractionTriggerActivation>;
+    content?: EndgeDiagnosticsSnapshotContentPatch;
+}
 /** Patch snapshots configuration текущего cascade layer. */
 export interface EndgeDiagnosticsSnapshotsPatch {
     content?: EndgeDiagnosticsSnapshotContentPatch;
+    shortcut?: EndgeDiagnosticsShortcutSnapshotPatch;
     automatic?: EndgeDiagnosticsAutomaticSnapshotPatch;
 }
 /** Patch diagnostics configuration текущего cascade layer. */

package/dist/features/core/modules/context/EndgeContext_Module.d.ts

@@ -1,6 +1,7 @@
 import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
 import { EndgeConfiguration } from '../configuration/domain/types/configuration.type';
 import { EndgeContextPersistenceConfig, EndgeContextSnapshot, EndgeKeyboardContextSnapshot, EndgePersistenceScope, EndgeRuntimeContextSnapshot, EndgeSessionIdentityProvider, EndgeStorageAdapter } from './domain/context-persistence.types';
+import { EndgeContextStateListener, EndgeContextStateTransform } from './domain/context-state.types';
 import { EndgePersistenceInput } from './persistence/EndgeStorageAdapterRegistry';
 import { EndgeExecutionContext, EndgeExecutionContextResolutionInput } from '../runtime/domain/execution-context.types';
 import { EndgeDataMode } from '../workspace/domain/workspace.types';
@@ -13,6 +14,7 @@ import { EndgeModule } from '../../../federation/EndgeModule';
 export declare class EndgeContext_Module extends EndgeModule<EndgeBootContext> {
     private readonly _adapters;
     private readonly _runtimeControllers;
+    private readonly _stateListeners;
     private _contextPersistence;
     private _currentWorkspace;
     private _currentTenant;
@@ -47,6 +49,7 @@ export declare class EndgeContext_Module extends EndgeModule<EndgeBootContext> {
     /** Показывает, что Tenant принудительно задан authenticated session provider. */
     get isTenantLockedBySession(): boolean;
     /** Сериализует текущий execution scope в snapshot. */
+    createDiagnosticsSnapshot(): Record<string, unknown>;
     serialize(): EndgeContextSnapshot;
     /** Возвращает полный доступный SFC контекст без добавления временных значений в persistence. */
     runtimeSnapshot(): EndgeRuntimeContextSnapshot;
@@ -64,6 +67,14 @@ export declare class EndgeContext_Module extends EndgeModule<EndgeBootContext> {
     loadFromStorage(): EndgeContextSnapshot | undefined;
     /** Возвращает полный persistence scope текущей сессии. */
     getPersistenceScope(): EndgePersistenceScope;
+    /** Возвращает dynamic state текущего полного context scope. */
+    getState<T>(key: string, transform?: EndgeContextStateTransform<T>): T | undefined;
+    /** Сохраняет dynamic state в scope текущих workspace/tenant/project/environment/user. */
+    setState<T>(key: string, state: T, transform?: EndgeContextStateTransform<T>): void;
+    /** Удаляет dynamic state только из текущего полного context scope. */
+    removeState(key: string): void;
+    /** Подписывает потребителя на изменения одного dynamic state key. */
+    subscribeState(key: string, listener: EndgeContextStateListener): () => void;
     /** Создаёт или возвращает controller runtime-состояния по runtime id. */
     createRuntimeStateController(input: {
         runtimeId: string;
@@ -143,6 +154,8 @@ export declare class EndgeContext_Module extends EndgeModule<EndgeBootContext> {
     private _serializeForPersistence;
     /** Выбирает storage adapter для заданной persistence policy. */
     private _resolveAdapter;
+    private _notifyState;
+    private _warnStateFailure;
     private _syncPersistentContextToRaph;
     private _setRaphValueIfChanged;
     /** Возвращает identity активного workspace для persistence scope. */

package/dist/features/core/modules/context/domain/context-state.types.d.ts

@@ -0,0 +1,12 @@
+import { ClassConstructor } from 'class-transformer';
+/** Ручное преобразование между runtime-состоянием и JSON-compatible представлением. */
+export interface EndgeContextStateCodec<T> {
+    serialize: (state: T) => unknown;
+    deserialize: (value: unknown) => T;
+}
+/**
+ * Способ преобразования dynamic state: class-transformer constructor либо ручной codec.
+ * Без transform значение сохраняется как обычное JSON-compatible значение.
+ */
+export type EndgeContextStateTransform<T> = ClassConstructor<T> | EndgeContextStateCodec<T>;
+export type EndgeContextStateListener = () => void;

package/dist/features/core/modules/context/persistence/context-state.d.ts

@@ -0,0 +1,7 @@
+import { EndgePersistenceScope } from '../domain/context-persistence.types';
+import { EndgeContextStateTransform } from '../domain/context-state.types';
+/** Строит изолированный ключ dynamic state из полного context scope и ключа потребителя. */
+export declare function buildContextStateStorageKey(scope: EndgePersistenceScope, key: string): string;
+export declare function normalizeContextStateKey(value: unknown): string;
+export declare function serializeContextState<T>(state: T, transform?: EndgeContextStateTransform<T>): unknown;
+export declare function deserializeContextState<T>(value: unknown, transform?: EndgeContextStateTransform<T>): T;

package/dist/features/core/modules/diagnostics/EndgeDiagnosticsSnapshots_Module.d.ts

@@ -0,0 +1,55 @@
+import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
+import { DiagnosticsSnapshotRuntimeAdapter } from './domain/types/diagnostics-snapshot-runtime-adapter.type';
+import { DiagnosticsSnapshot, DiagnosticsSnapshotOptions, DiagnosticsSnapshotProviders } from './domain/types/diagnostics.types';
+import { EndgeProblems_Module } from './EndgeProblems_Module';
+import { EndgeTelemetry_Module } from './EndgeTelemetry_Module';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/** Владелец создания, доставки, скачивания и trigger policies диагностических snapshots. */
+export declare class EndgeDiagnosticsSnapshots_Module extends EndgeModule<EndgeBootContext> {
+    private readonly _telemetry;
+    private readonly _problems;
+    private readonly _providers;
+    private readonly _runtimeAdapter;
+    private _automaticErrorTimestamps;
+    private _automaticCooldownUntil;
+    private _unsubscribeAutomaticRecords;
+    private _unsubscribeShortcut;
+    private _shortcutMatcher;
+    private _started;
+    /** Создаёт snapshots owner поверх telemetry, problems и platform adapter. */
+    constructor(_telemetry: EndgeTelemetry_Module, _problems: EndgeProblems_Module, _providers?: DiagnosticsSnapshotProviders, _runtimeAdapter?: DiagnosticsSnapshotRuntimeAdapter);
+    /** Восстанавливает internal policy subscriptions после telemetry build/reset. */
+    build(_ctx: EndgeBootContext): void;
+    /** Включает глобальную shortcut subscription только в live lifecycle. */
+    start(_ctx: EndgeBootContext): void;
+    /** Освобождает live subscriptions и transient policy state. */
+    reset(): void;
+    /** Синхронизирует subscriptions после применения новой effective configuration. */
+    configure(): void;
+    /** Возвращает JSON-safe snapshot выбранных частей текущего состояния Core. */
+    snapshot(options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
+    /** Создаёт snapshot и доставляет его в выбранные configured outputs. */
+    sendSnapshot(outputIds?: readonly string[], options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
+    /** Создаёт snapshot и сохраняет его platform adapter-ом в JSON-файл. */
+    downloadSnapshot(options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
+    /** Восстанавливает внутреннюю подписку на ERROR/FATAL records после configure. */
+    private _subscribeAutomaticSnapshots;
+    /** Пересоздаёт live shortcut subscription по effective trigger activation. */
+    private _syncShortcutSubscription;
+    /** Читает одну часть snapshot из её state owner и локализует возможный сбой. */
+    private _captureSection;
+    /** Сохраняет прежние top-level поля, получая их из нового дерева владельцев. */
+    private _federationOwnerSections;
+    /** Поддерживает независимое использование Diagnostics без владеющей Federation. */
+    private _legacyOwnerSections;
+    /** Применяет существующие content toggles к тяжёлым Core Modules до чтения их состояния. */
+    private _federationOptions;
+    /** Переносит snapshot Core Module в совместимое top-level поле без повторного сбора. */
+    private _takeModuleSnapshot;
+    /** Показывает, что состояние Diagnostics Module представлено корневыми полями файла. */
+    private _referenceDiagnosticsModule;
+    /** Применяет sliding window и cooldown политики автоматического snapshot. */
+    private _handleAutomaticSnapshotRecord;
+    /** Переводит persisted content policy в публичные snapshot options. */
+    private _snapshotOptions;
+}

package/dist/features/core/modules/diagnostics/EndgeDiagnostics_Module.d.ts

@@ -1,13 +1,14 @@
 import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
 import { DiagnosticsAdapter, DiagnosticsAdapterFactory, DiagnosticsFlushResult } from './domain/types/diagnostics-adapter.type';
-import { DiagnosticsContextProvider, DiagnosticsExceptionOptions, DiagnosticsFilter, DiagnosticsListener, DiagnosticsLogInput, DiagnosticsLogOptions, DiagnosticsLogRecord, DiagnosticsRecord, DiagnosticsResource, DiagnosticsSnapshot, DiagnosticsSnapshotOptions, DiagnosticsSpanHandle, DiagnosticsSpanOptions, DiagnosticsSpanRecord, DiagnosticsSubscribeOptions, EndgeDiagnosticsConfiguration } from './domain/types/diagnostics.types';
+import { DiagnosticsContextProvider, DiagnosticsExceptionOptions, DiagnosticsFilter, DiagnosticsListener, DiagnosticsLogInput, DiagnosticsLogOptions, DiagnosticsLogRecord, DiagnosticsRecord, DiagnosticsResource, DiagnosticsSnapshot, DiagnosticsSnapshotOptions, DiagnosticsSnapshotProviders, DiagnosticsSpanHandle, DiagnosticsSpanOptions, DiagnosticsSpanRecord, DiagnosticsSubscribeOptions, EndgeDiagnosticsConfiguration } from './domain/types/diagnostics.types';
 import { DiagnosticsAdapterRegistry } from './adapters/DiagnosticsAdapterRegistry';
+import { EndgeDiagnosticsSnapshots_Module } from './EndgeDiagnosticsSnapshots_Module';
 import { EndgeProblems_Module } from './EndgeProblems_Module';
 import { EndgeTelemetry_Module } from './EndgeTelemetry_Module';
 import { EndgeModule } from '../../../federation/EndgeModule';
 /**
  * Родительский diagnostics-модуль ядра.
- * Объединяет append-only telemetry history и replaceable registry актуальных problems.
+ * Объединяет telemetry history, актуальные problems и lifecycle snapshots policy.
  */
 export declare class EndgeDiagnostics_Module extends EndgeModule<EndgeBootContext> {
     /** Registry системных и внешних adapter factories. */
@@ -16,17 +17,15 @@ export declare class EndgeDiagnostics_Module extends EndgeModule<EndgeBootContex
     readonly telemetry: EndgeTelemetry_Module;
     /** Подмодуль актуальных authoring/build/runtime problems. */
     readonly problems: EndgeProblems_Module;
-    /** Состояние automatic snapshot policy и её внутренней подписки. */
-    private _automaticErrorTimestamps;
-    private _automaticCooldownUntil;
-    private _unsubscribeAutomaticRecords;
+    /** Подмодуль создания, доставки и browser download диагностических snapshots. */
+    readonly snapshots: EndgeDiagnosticsSnapshots_Module;
     /**
      * ----------------------------------------
      * PUBLIC
      * ----------------------------------------
      */
     /** Связывает независимые уведомления подмодулей с родительским diagnostics-модулем. */
-    constructor();
+    constructor(snapshotProviders?: DiagnosticsSnapshotProviders);
     /** Передаёт setup lifecycle подмодулям в порядке их зависимостей. */
     setup(ctx: EndgeBootContext): Promise<void>;
     /** Передаёт load lifecycle подмодулям в порядке их зависимостей. */
@@ -67,8 +66,12 @@ export declare class EndgeDiagnostics_Module extends EndgeModule<EndgeBootContex
     query(filter?: DiagnosticsFilter): readonly DiagnosticsRecord[];
     /** Возвращает JSON-safe snapshot telemetry, problems и optional configuration. */
     snapshot(options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
+    /** Включает snapshots собственных submodules без рекурсивного запуска общего сборщика. */
+    createDiagnosticsSnapshot(): unknown;
     /** Создаёт snapshot и доставляет его в выбранные configured outputs. */
     sendSnapshot(outputIds?: readonly string[], options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
+    /** Создаёт snapshot и сохраняет его в JSON-файл через platform adapter. */
+    downloadSnapshot(options?: DiagnosticsSnapshotOptions): DiagnosticsSnapshot;
     /** Возвращает telemetry counters текущей session. */
     getCounters(): ReturnType<EndgeTelemetry_Module['getCounters']>;
     /** Очищает только telemetry history, не затрагивая актуальные problems. */
@@ -85,15 +88,6 @@ export declare class EndgeDiagnostics_Module extends EndgeModule<EndgeBootContex
     unregisterAdapter(adapterId: string): Promise<void>;
     /** Выполняет best-effort flush всех telemetry adapters. */
     flush(): Promise<DiagnosticsFlushResult>;
-    /**
-     * ----------------------------------------
-     * PRIVATE
-     * ----------------------------------------
-     */
-    /** Восстанавливает внутреннюю подписку на ERROR/FATAL records после reset. */
-    private _subscribeAutomaticSnapshots;
-    /** Применяет sliding window и cooldown политики автоматического snapshot. */
-    private _handleAutomaticSnapshotRecord;
     /**
      * ----------------------------------------
      * ACCESS

package/dist/features/core/modules/diagnostics/adapters/BrowserDiagnosticsSnapshot_Adapter.d.ts

@@ -0,0 +1,9 @@
+import { DiagnosticsSnapshotRuntimeAdapter, DiagnosticsSnapshotShortcutEvent } from '../domain/types/diagnostics-snapshot-runtime-adapter.type';
+import { DiagnosticsSnapshot } from '../domain/types/diagnostics.types';
+/** Browser implementation platform boundary диагностических snapshots. */
+export declare class BrowserDiagnosticsSnapshot_Adapter implements DiagnosticsSnapshotRuntimeAdapter {
+    /** Подписывает Core на глобальные keyboard events текущего document. */
+    subscribeShortcut(listener: (event: DiagnosticsSnapshotShortcutEvent) => void): () => void;
+    /** Сохраняет JSON-safe snapshot в файл средствами browser platform. */
+    downloadJson(snapshot: DiagnosticsSnapshot): void;
+}

package/dist/features/core/modules/diagnostics/domain/diagnostics-snapshot.d.ts

@@ -0,0 +1,7 @@
+import { DiagnosticsJsonValue } from './types/diagnostics.types';
+export interface DiagnosticsJsonSerializationResult {
+    value: DiagnosticsJsonValue;
+    redactedFields: number;
+}
+/** Преобразует произвольное состояние в JSON-safe диагностическую проекцию с редактированием секретов. */
+export declare function serializeDiagnosticsJson(input: unknown): DiagnosticsJsonSerializationResult;

package/dist/features/core/modules/diagnostics/domain/types/diagnostics-snapshot-runtime-adapter.type.d.ts

@@ -0,0 +1,15 @@
+import { DiagnosticsSnapshot } from './diagnostics.types';
+import { ComponentSFCInteractionTriggerEvent, ComponentSFCInteractionTriggerPlatform } from '../../../domain/types/component/sfc/ir.types';
+/** Keyboard event, приведённое platform adapter к общему TriggerSet contract. */
+export interface DiagnosticsSnapshotShortcutEvent {
+    type: 'keydown' | 'keyup';
+    occurrence: ComponentSFCInteractionTriggerEvent;
+    platform: ComponentSFCInteractionTriggerPlatform;
+    preventDefault: () => void;
+    stopPropagation: () => void;
+}
+/** Platform boundary подписки на shortcut и сохранения snapshot-файла. */
+export interface DiagnosticsSnapshotRuntimeAdapter {
+    subscribeShortcut: (listener: (event: DiagnosticsSnapshotShortcutEvent) => void) => () => void;
+    downloadJson: (snapshot: DiagnosticsSnapshot) => void;
+}

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

@@ -1,3 +1,5 @@
+import { ComponentSFCInteractionTriggerActivation } from '../../../domain/types/component/sfc/ir.types';
+import { EndgeFederationDiagnosticsSnapshot, EndgeFederationDiagnosticsSnapshotOptions } from '../../../../../federation/types/federation.types';
 /** Сигналы, которые поддерживает первая версия модуля диагностики. */
 export type DiagnosticsSignal = 'log' | 'span';
 /** Фаза жизненного цикла, в которой создана диагностическая запись. */
@@ -133,6 +135,10 @@ export interface EndgeDiagnosticsCollectionConfiguration {
 export type DiagnosticsAdapterOptionValue = string | number | boolean | null | DiagnosticsAdapterOptionValue[] | {
     [key: string]: DiagnosticsAdapterOptionValue;
 };
+/** Рекурсивное JSON-safe значение диагностического snapshot. */
+export type DiagnosticsJsonValue = string | number | boolean | null | DiagnosticsJsonValue[] | {
+    [key: string]: DiagnosticsJsonValue;
+};
 /** Именованный канал вывода, создаваемый через adapter registry. */
 export interface EndgeDiagnosticsOutputConfiguration {
     id: string;
@@ -174,6 +180,12 @@ export interface EndgeDiagnosticsSnapshotContentConfiguration {
     telemetry: boolean;
     problems: boolean;
     configuration: boolean;
+    effectiveConfiguration?: boolean;
+    domain?: boolean;
+    program?: boolean;
+    runtime?: boolean;
+    raphData?: boolean;
+    raphGraph?: boolean;
 }
 /** Условия автоматического snapshot по ERROR/FATAL records. */
 export interface EndgeDiagnosticsAutomaticSnapshotConfiguration {
@@ -183,9 +195,16 @@ export interface EndgeDiagnosticsAutomaticSnapshotConfiguration {
     cooldownSeconds: number;
     outputIds: string[];
 }
-/** Effective configuration ручных и автоматических snapshots. */
+/** Настройки snapshot, скачиваемого глобальной комбинацией клавиш. */
+export interface EndgeDiagnosticsShortcutSnapshotConfiguration {
+    /** Legacy TriggerSet либо sequence-объект; массив сохраняется без миграции persisted документов. */
+    triggerSet: ComponentSFCInteractionTriggerActivation;
+    content: EndgeDiagnosticsSnapshotContentConfiguration;
+}
+/** Effective configuration ручных, shortcut и автоматических snapshots. */
 export interface EndgeDiagnosticsSnapshotsConfiguration {
     content: EndgeDiagnosticsSnapshotContentConfiguration;
+    shortcut: EndgeDiagnosticsShortcutSnapshotConfiguration;
     automatic: EndgeDiagnosticsAutomaticSnapshotConfiguration;
 }
 /** Полная effective configuration модуля диагностики. */
@@ -264,12 +283,37 @@ export interface DiagnosticsCounters {
 }
 /** Параметры создания JSON-safe snapshot. */
 export interface DiagnosticsSnapshotOptions {
-    trigger?: 'manual' | 'automatic';
+    trigger?: 'manual' | 'shortcut' | 'automatic';
     includeTelemetry?: boolean;
     includeProblems?: boolean;
     includeConfiguration?: boolean;
+    includeEffectiveConfiguration?: boolean;
+    includeDomain?: boolean;
+    includeProgram?: boolean;
+    includeRuntime?: boolean;
+    includeRaphData?: boolean;
+    includeRaphGraph?: boolean;
     filter?: DiagnosticsFilter;
 }
+/** Параметры диагностической проекции Raph, принадлежащей runtime-модулю. */
+export interface DiagnosticsRaphSnapshotOptions {
+    includeData: boolean;
+    includeGraph: boolean;
+}
+/** Lazy providers state owners, подключаемые composition root ядра. */
+export interface DiagnosticsSnapshotProviders {
+    federation?: (options: EndgeFederationDiagnosticsSnapshotOptions) => EndgeFederationDiagnosticsSnapshot;
+    effectiveConfiguration?: () => unknown;
+    domain?: () => unknown;
+    program?: () => unknown;
+    runtime?: () => unknown;
+    raph?: (options: DiagnosticsRaphSnapshotOptions) => unknown;
+}
+/** Ошибка чтения одной запрошенной части snapshot без отмены остальных частей. */
+export interface DiagnosticsSnapshotCaptureError {
+    section: 'federation' | 'effectiveConfiguration' | 'domain' | 'program' | 'runtime' | 'raph';
+    message: string;
+}
 /** Telemetry-часть диагностического snapshot. */
 export interface DiagnosticsTelemetrySnapshot {
     sessionId: string;
@@ -279,11 +323,24 @@ export interface DiagnosticsTelemetrySnapshot {
 }
 /** JSON-safe snapshot текущего состояния diagnostics-модуля. */
 export interface DiagnosticsSnapshot {
+    format?: 'endge-diagnostics-snapshot';
+    version?: 1 | 2;
     generatedAt: number;
-    trigger: 'manual' | 'automatic';
+    trigger: 'manual' | 'shortcut' | 'automatic';
     telemetry?: DiagnosticsTelemetrySnapshot;
     problems?: DiagnosticsProblemsSnapshot;
     configuration?: EndgeDiagnosticsConfiguration;
+    effectiveConfiguration?: DiagnosticsJsonValue;
+    domain?: DiagnosticsJsonValue;
+    program?: DiagnosticsJsonValue;
+    runtime?: DiagnosticsJsonValue;
+    raph?: DiagnosticsJsonValue;
+    federation?: DiagnosticsJsonValue;
+    captureErrors?: DiagnosticsSnapshotCaptureError[];
+    redaction?: {
+        applied: true;
+        fields: number;
+    };
 }
 /** Обработчик одной принятой диагностической записи. */
 export type DiagnosticsListener = (record: DiagnosticsRecord) => void;

package/dist/features/core/modules/domain/EndgeDomain_Module.d.ts

@@ -1239,9 +1239,9 @@ export declare class EndgeDomain_Module extends EndgeModule<EndgeBootContext> {
      * Проверяет наличие Version по id или identity.
      */
     hasVersion(identity: string): boolean;
-    /**
-     * Преобразует EndgeDomain_Module в JSON-объект.
-     */
+    /** Возвращает полный persisted Domain для диагностического дерева. */
+    createDiagnosticsSnapshot(): EndgeDomainPlain;
+    /** Преобразует EndgeDomain_Module в JSON-объект. */
     toPlain(): EndgeDomainPlain;
     /**
      * Нормализует блоки областей страницы: из формата Payload (entity: { relationTo, value }) в entityType/entityIdentity.

package/dist/features/core/modules/domain/component/component-sfc-edit-trigger.d.ts

@@ -1,6 +1,37 @@
-import { ComponentSFCInteractionKeyboardCondition, ComponentSFCInteractionTrigger, ComponentSFCInteractionTriggerEvent, ComponentSFCInteractionTriggerHeldKeys, ComponentSFCInteractionTriggerModifiers, ComponentSFCInteractionTriggerPlatform } from '../types/component/sfc/ir.types';
+import { ComponentSFCInteractionKeyboardCondition, ComponentSFCInteractionTrigger, ComponentSFCInteractionTriggerActivation, ComponentSFCInteractionTriggerEvent, ComponentSFCInteractionTriggerHeldKeys, ComponentSFCInteractionTriggerModifiers, ComponentSFCInteractionTriggerPlatform } from '../types/component/sfc/ir.types';
+export declare const DEFAULT_COMPONENT_SFC_INTERACTION_SEQUENCE_INTERVAL_MS = 1000;
+export type ComponentSFCInteractionTriggerActivationMatch = {
+    status: 'none';
+} | {
+    status: 'progress' | 'complete';
+    trigger: ComponentSFCInteractionTrigger;
+    stepIndex: number;
+    triggerIndex: number;
+};
 /** Нормализует общее значение trigger `edit-on` или `on`. */
 export declare function normalizeComponentSFCInteractionTriggers(value: unknown): ComponentSFCInteractionTrigger[];
+/** Нормализует legacy TriggerSet или последовательность, не меняя форму обычного набора. */
+export declare function normalizeComponentSFCInteractionTriggerActivation(value: unknown): ComponentSFCInteractionTriggerActivation;
+/** Проверяет, содержит ли активация хотя бы один исполнимый TriggerSet. */
+export declare function hasComponentSFCInteractionTriggerActivation(activation: ComponentSFCInteractionTriggerActivation): boolean;
+/** Stateful matcher последовательностей, общий для runtime-владельцев и platform adapters. */
+export declare class ComponentSFCInteractionTriggerActivationMatcher {
+    private readonly _activation;
+    private readonly _onceTriggered;
+    private _matchedOnce;
+    private _nextStepIndex;
+    private _deadline;
+    constructor(value: unknown);
+    /** Принимает очередное событие и возвращает прогресс либо завершение активации. */
+    match(eventName: string, event: ComponentSFCInteractionTriggerEvent, platform: ComponentSFCInteractionTriggerPlatform, occurredAt?: number): ComponentSFCInteractionTriggerActivationMatch;
+    /** Сбрасывает transient progress и once-состояние при lifecycle/configuration reset. */
+    reset(): void;
+    private _matchSequence;
+    private _matchSet;
+    private _shouldResetSequence;
+    private _resetProgress;
+    private _onceKey;
+}
 /** Проверяет один нормализованный trigger без зависимости от DOM и конкретного renderer-а. */
 export declare function matchesComponentSFCInteractionTrigger(trigger: ComponentSFCInteractionTrigger, event: ComponentSFCInteractionTriggerEvent, platform: ComponentSFCInteractionTriggerPlatform): boolean;
 /** Приводит browser platform label к стабильным значениям edit-on контракта. */

package/dist/features/core/modules/domain/types/component/sfc/dependencies.types.d.ts

@@ -1,4 +1,4 @@
-import { RComponentSFC_IR_Read } from './ir.types';
+import { RComponentSFC_IR_DataMetaReference, RComponentSFC_IR_Read } from './ir.types';
 /** Источник runtime-зависимости SFC v1. */
 export type RComponentSFC_RuntimeDependencySource = 'props' | 'context';
 /** Runtime-зависимость SFC template от входного prop. */
@@ -63,6 +63,14 @@ export interface RComponentSFC_RuntimeVocabDependency {
     /** Исходное выражение для diagnostics/debug. */
     raw: string;
 }
+/** Реактивное чтение Meta-plane, разрешаемое через provenance входного prop. */
+export interface RComponentSFC_RuntimeMetaDependency {
+    reference: RComponentSFC_IR_DataMetaReference;
+    /** Table boundary для row-reference; null для обычного prop. */
+    boundaryId: string | null;
+    namespace: string | null;
+    raw: string;
+}
 /** Набор runtime-зависимостей SFC artifact. */
 export interface RComponentSFC_RuntimeDependencies {
     /** Зависимости от props, которые можно связать с внешним input source. */
@@ -73,6 +81,8 @@ export interface RComponentSFC_RuntimeDependencies {
     boundaries: RComponentSFC_RuntimeBoundaryDependency[];
     /** Vocab aliases, которые должен предоставить ближайший Composition scope. */
     vocabs?: RComponentSFC_RuntimeVocabDependency[];
+    /** Read-only зависимости `$data.metaOf(...)`. */
+    meta?: RComponentSFC_RuntimeMetaDependency[];
 }
 /** Создает пустой dependency artifact SFC runtime. */
 export declare function createEmptyComponentSFCRuntimeDependencies(): RComponentSFC_RuntimeDependencies;

package/dist/features/core/modules/domain/types/component/sfc/ir.types.d.ts

@@ -105,6 +105,20 @@ export interface ComponentSFCInteractionTrigger extends ComponentSFCInteractionK
     capture?: boolean;
     passive?: boolean;
 }
+/** Альтернативные trigger-условия, любое из которых завершает один шаг активации. */
+export type ComponentSFCInteractionTriggerSet = ComponentSFCInteractionTrigger[];
+/** Один шаг последовательной активации и допустимая пауза после предыдущего шага. */
+export interface ComponentSFCInteractionTriggerSequenceStep {
+    triggerSet: ComponentSFCInteractionTriggerSet;
+    maxIntervalMs?: number;
+}
+/** Последовательность TriggerSet-шагов; каждый следующий шаг ожидается в пределах своего интервала. */
+export interface ComponentSFCInteractionTriggerSequence {
+    mode: 'sequence';
+    steps: ComponentSFCInteractionTriggerSequenceStep[];
+}
+/** Универсальная активация: legacy TriggerSet либо последовательность таких наборов. */
+export type ComponentSFCInteractionTriggerActivation = ComponentSFCInteractionTriggerSet | ComponentSFCInteractionTriggerSequence;
 export type ComponentSFCInteractionTriggerPlatform = 'macos' | 'windows' | 'linux' | 'unknown';
 /** Renderer-neutral snapshot нативного события для проверки edit trigger. */
 export interface ComponentSFCInteractionTriggerEvent {
@@ -315,6 +329,23 @@ export interface RComponentSFC_IR_ExpressionValue {
     reads: RComponentSFC_IR_Read[];
     /** Статические обращения к Vocab aliases текущего Composition scope. */
     vocabReads?: RComponentSFC_IR_VocabRead[];
+    /** Статические read-only обращения `$data.metaOf(reference[, namespace])`. */
+    dataMetaReads?: RComponentSFC_IR_DataMetaRead[];
+}
+/** Ссылка на business value, метаданные которого читает Component SFC. */
+export type RComponentSFC_IR_DataMetaReference = {
+    kind: 'prop';
+    prop: string;
+    path: string[];
+} | {
+    kind: 'table-row';
+    path: string[];
+};
+/** Статическое обращение к Raph Meta-plane без публикации DataPath в props. */
+export interface RComponentSFC_IR_DataMetaRead {
+    reference: RComponentSFC_IR_DataMetaReference;
+    namespace: string | null;
+    raw: string;
 }
 /** Статическое обращение `vocab(alias, mapping?)` внутри SFC expression. */
 export interface RComponentSFC_IR_VocabRead {

package/dist/features/core/modules/implementations/EndgeImplementations_Module.d.ts

@@ -20,6 +20,8 @@ export declare class EndgeImplementations_Module extends EndgeModule {
     resolveOptional(request: ImplementationResolutionRequest): ResolvedImplementation | null;
     /** Вычисляет и выполняет один вызов через его фактический provider. */
     execute<TResult = unknown>(request: ImplementationResolutionRequest, invocation: ImplementationInvocation): Promise<TResult>;
+    /** Включает безопасную проекцию implementations в диагностическое дерево. */
+    createDiagnosticsSnapshot(): ImplementationSnapshot;
     /** Возвращает сериализуемый snapshot инспекции без функций. */
     snapshot(): ImplementationSnapshot;
     /** Освобождает providers и bindings после зависимых execution Modules. */

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

@@ -100,9 +100,9 @@ export declare class EndgeProgram_Module extends EndgeModule {
      * Сбрасывает program при reset federation.
      */
     reset(): void;
-    /**
-     * Формирует summary snapshot для диагностики compiled program.
-     */
+    /** Включает summary compiled program в диагностическое дерево Module. */
+    createDiagnosticsSnapshot(): EndgeProgramSnapshot;
+    /** Формирует summary snapshot для диагностики compiled program. */
     snapshot(): EndgeProgramSnapshot;
     /**
      * Внутренний helper модуля: key For.