@endge/core 7.1.0 → 9.0.0

package/dist/features/core/modules/runtime/operation/operation-history.d.ts

@@ -28,6 +28,7 @@ export declare class OperationHistory implements RuntimeOwnedResource {
     private _paused;
     private _disposed;
     private _queue;
+    private _pending;
     private _limit;
     constructor(_options: OperationHistoryOptions);
     get limit(): number;
@@ -36,7 +37,13 @@ export declare class OperationHistory implements RuntimeOwnedResource {
     canUndo(): boolean;
     canRedo(): boolean;
     setLimit(value: number): void;
-    commit(entry: OperationHistoryEntry): void;
+    commit(entry: OperationHistoryEntry): Promise<void>;
+    /** Serializes the data mutation and its history entry with undo/redo. */
+    execute<T>(operation: () => Promise<{
+        result: T;
+        entry: OperationHistoryEntry;
+    }>): Promise<T>;
+    private _commit;
     undo(): Promise<unknown>;
     redo(): Promise<unknown>;
     pause(): void;

package/dist/features/core/modules/runtime/services/strategies/CompositionRuntimeStrategy.d.ts

@@ -5,5 +5,5 @@ export declare class CompositionRuntimeStrategy implements RuntimeStrategy<RComp
     readonly id = "runtime:composition";
     readonly entityType: "composition";
     supports(model: unknown): model is RComposition;
-    create(ctx: Parameters<RuntimeStrategy<RComposition, CompositionRuntimeHost>['create']>[0]): CompositionRuntimeHost | null;
+    create(ctx: Parameters<RuntimeStrategy<RComposition, CompositionRuntimeHost>['create']>[0]): CompositionRuntimeHost<"composition"> | null;
 }

package/dist/features/core/modules/runtime/services/strategies/ProjectRuntimeStrategy.d.ts

@@ -1,8 +1,9 @@
 import { RuntimeStrategy } from '../../domain/runtime-strategy.types';
 import { RProject } from '../../../domain/entities/RProject';
+import { ProjectRuntimeHost } from '../../hosts/ProjectRuntimeHost';
 export declare class ProjectRuntimeStrategy implements RuntimeStrategy<RProject> {
     readonly id = "runtime:project";
     readonly entityType = "project";
     supports(model: unknown): model is RProject;
-    create(ctx: Parameters<RuntimeStrategy<RProject>['create']>[0]): import('../../domain/runtime-host.types').RuntimeHost<"project", import('../../domain/runtime-host.types').ProjectRuntimeHostContext, unknown>;
+    create(ctx: Parameters<RuntimeStrategy<RProject>['create']>[0]): ProjectRuntimeHost | null;
 }

package/dist/features/core/modules/source/EndgeSource_Module.d.ts

@@ -48,6 +48,8 @@ export declare class EndgeSource_Module extends EndgeModule {
     semanticHighlights(sourceKind: SourceKind | string, context: SourceLanguageContext): SourceLanguageSemanticHighlight[];
     /** Возвращает renderer-neutral inline annotations для source-документа. */
     inlineHints(sourceKind: SourceKind | string, context: SourceLanguageContext): SourceLanguageInlineHint[];
+    /** Source owner передаёт strategies только актуальные read-only authoring inputs. */
+    private _simulationCatalog;
     /** Регистрирует встроенные strategies ядра. */
     private _registerDefaultStrategies;
     /** Возвращает strategy или бросает явную ошибку для некорректного source-kind. */

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

@@ -375,7 +375,7 @@ export interface CompositionRuntimeOutputHandle {
     output?: string;
 }
 /** Публичный контракт Composition host без зависимости Domain от concrete Model runtime. */
-export interface CompositionRuntimeHostHandle extends RuntimeHost<'composition', any, CompositionProgramPayload> {
+export interface CompositionRuntimeHostHandle<TType extends 'composition' | 'project' = 'composition' | 'project'> extends RuntimeHost<TType, any, CompositionProgramPayload> {
     mountGraph: () => Promise<void>;
     getChild: (name: string) => RuntimeHost<any, any> | null;
     getChildren: () => CompositionRuntimeChildHandle[];

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

@@ -0,0 +1,53 @@
+import { ProgramDependency, ProgramDiagnostic } from '../../../program/domain/types/program.types';
+/** Декларация будущей подмены request. Генерация данных здесь не выполняется. */
+export interface SimulationMockRequest {
+    kind: 'mock-request';
+    seed?: string;
+    arrays: Record<string, number>;
+}
+export interface SimulationRuntimeOverride {
+    alias: string;
+    runtimes?: SimulationRuntimeOverride[];
+    request?: SimulationMockRequest;
+}
+export type SimulationTargetReference = {
+    entityType: 'composition';
+    identity: string;
+} | {
+    entityType: 'project';
+    identity: string;
+};
+export interface SimulationSourceDocument {
+    target: SimulationTargetReference;
+    runtimes: SimulationRuntimeOverride[];
+}
+export interface SimulationSourceArtifact extends SimulationSourceDocument {
+    type: 'simulation';
+    sourceVersion: number;
+}
+export interface SimulationSourceCompileResult {
+    ast: unknown | null;
+    document: SimulationSourceDocument | null;
+    artifact: SimulationSourceArtifact | null;
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+    dependencies: ProgramDependency[];
+    locations: Record<string, {
+        start: number;
+        end: number;
+    }>;
+}
+/** Read-only authoring inputs; Source services не получают Domain owner. */
+export interface SimulationSourceInput {
+    id: string | number;
+    identity: string;
+    displayName?: string;
+    source: string;
+    sourceVersion: number;
+    isPrimitive?: boolean;
+}
+export interface SimulationSourceCatalog {
+    projects: readonly SimulationSourceInput[];
+    compositions: readonly SimulationSourceInput[];
+    queries: readonly SimulationSourceInput[];
+    types: readonly SimulationSourceInput[];
+}

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

@@ -1,7 +1,7 @@
 import { I18nCatalogProvenance, I18nRuntimeCatalog } from '../../../i18n/domain/i18n.types';
 import { TypeSourceDefinition } from './type-source.types';
 /** Канонический тип source-документа, для которого выбирается source strategy. */
-export type SourceKind = 'action' | 'query' | 'vocab' | 'data-view' | 'filter' | 'composition' | 'store' | 'stream' | 'update' | 'computation' | 'style' | 'type' | 'configuration';
+export type SourceKind = 'action' | 'query' | 'vocab' | 'data-view' | 'filter' | 'composition' | 'store' | 'stream' | 'simulation' | 'update' | 'computation' | 'style' | 'type' | 'configuration';
 /** Тип нейтральной source completion без привязки к Monaco или другому editor API. */
 export type SourceLanguageCompletionKind = 'keyword' | 'function' | 'property' | 'value' | 'snippet';
 /** Позиция курсора внутри source-документа. */
@@ -78,7 +78,7 @@ export interface SourceLanguageSignatureHelp {
     }>;
 }
 /** Логический тип внешнего доменного документа, на который ссылается source. */
-export type SourceDocumentReferenceTarget = 'action' | 'auth-profile' | 'component' | 'composition' | 'computation' | 'converter' | 'data-view' | 'filter' | 'i18n-bundles' | 'mock' | 'query' | 'store' | 'stream' | 'update' | 'style' | 'type' | 'vocabs';
+export type SourceDocumentReferenceTarget = 'action' | 'auth-profile' | 'component' | 'composition' | 'computation' | 'converter' | 'data-view' | 'filter' | 'i18n-bundles' | 'project' | 'mock' | 'query' | 'store' | 'stream' | 'update' | 'style' | 'type' | 'vocabs';
 /** Семантическая ссылка из source на внешний доменный документ. */
 export interface SourceDocumentReference {
     /** Логический тип цели; UI может уточнить concrete document type через domain. */

package/dist/features/core/modules/source/services/SimulationSourceResolver.d.ts

@@ -0,0 +1,33 @@
+import { ProgramDependency } from '../../program/domain/types/program.types';
+import { CompositionSourceDocument } from '../domain/types/composition-source.types';
+import { SimulationSourceCatalog, SimulationSourceCompileResult, SimulationSourceInput, SimulationTargetReference } from '../domain/types/simulation-source.types';
+interface SimulationCompositionBranch {
+    owner: SimulationSourceInput;
+    document: CompositionSourceDocument;
+    scopePath: string;
+}
+export interface SimulationSourceTarget {
+    alias: string;
+    kind: 'project' | 'composition' | 'scope' | 'query' | 'unsupported';
+    identity: string;
+    branch: SimulationCompositionBranch | null;
+}
+interface QueryArrayContract {
+    paths: string[];
+    dependencies: ProgramDependency[];
+    errors: string[];
+}
+/** Read-only разрешение aliases и контрактов; не создаёт RuntimeHost или generator payload. */
+export declare class SimulationSourceResolver {
+    private readonly _catalog;
+    private readonly _branches;
+    private readonly _queryContracts;
+    constructor(_catalog: SimulationSourceCatalog);
+    composition(identity: string): SimulationCompositionBranch | null;
+    graph(reference: SimulationTargetReference): SimulationCompositionBranch | null;
+    children(branch: SimulationCompositionBranch): SimulationSourceTarget[];
+    target(reference: SimulationTargetReference, aliases: readonly string[]): SimulationSourceTarget | null;
+    queryContract(identity: string): QueryArrayContract;
+    analyze(result: SimulationSourceCompileResult): SimulationSourceCompileResult;
+}
+export {};

package/dist/features/core/modules/source/services/compilers/simulation-source-compile.d.ts

@@ -0,0 +1,3 @@
+import { SimulationSourceCompileResult } from '../../domain/types/simulation-source.types';
+/** Разбирает только whitelist Simulation v1, не исполняя authored Source. */
+export declare function compileSimulationSource(source: string, sourceVersion?: number): SimulationSourceCompileResult;

package/dist/features/core/modules/source/services/strategies/SimulationSourceEngineStrategy.d.ts

@@ -0,0 +1,10 @@
+import { SimulationSourceCatalog } from '../../domain/types/simulation-source.types';
+import { SourceEngineCompileResult, SourceEngineStrategy, SourceKind } from '../../domain/types/source-engine.types';
+export declare class SimulationSourceEngineStrategy implements SourceEngineStrategy {
+    private readonly _catalog;
+    readonly id = "source:simulation";
+    readonly sourceKind: SourceKind;
+    constructor(_catalog: () => SimulationSourceCatalog);
+    supports(sourceKind: SourceKind | string): boolean;
+    compile(source: string): SourceEngineCompileResult;
+}

package/dist/features/core/modules/source/services/strategies/SimulationSourceLanguageStrategy.d.ts

@@ -0,0 +1,14 @@
+import { SimulationSourceCatalog } from '../../domain/types/simulation-source.types';
+import { SourceKind, SourceLanguageCompletion, SourceLanguageContext, SourceLanguageStrategy, SourceLanguageValidationResult } from '../../domain/types/source-engine.types';
+export declare class SimulationSourceLanguageStrategy implements SourceLanguageStrategy {
+    private readonly _catalog;
+    readonly id = "source-language:simulation";
+    readonly sourceKind: SourceKind;
+    readonly syntax: import('../../domain/types/source-engine.types').SourceLanguageSyntaxDefinition;
+    constructor(_catalog: () => SimulationSourceCatalog);
+    supports(sourceKind: SourceKind | string): boolean;
+    createDefaultSource(): string;
+    validate(source: string): SourceLanguageValidationResult;
+    completions(context: SourceLanguageContext): SourceLanguageCompletion[];
+    resolveReference(context: SourceLanguageContext): import('../../domain/types/source-engine.types').SourceDocumentReference | null;
+}

package/dist/features/core/modules/source/templates/project.default.source.d.ts

@@ -0,0 +1,2 @@
+/** Пустой корневой граф нового проекта, готовый к запуску без внешних ресурсов. */
+export declare const PROJECT_DEFAULT_SOURCE = "defineComposition({\n  activateOn: startup(),\n  data: {},\n  resources: {},\n  runtimes: {},\n  hooks: [],\n  outputs: {},\n})\n";

package/dist/features/core/modules/source/templates/simulation.default.source.d.ts

@@ -0,0 +1,2 @@
+/** Новый документ требует выбора целевой Composition или Project. */
+export declare const SIMULATION_DEFAULT_SOURCE = "defineSimulation({\n  target: composition(''),\n  overrides: {\n    runtimes: {},\n  },\n})";

package/dist/main.d.ts

@@ -6,6 +6,9 @@ export * from './features/federation/types/endge-modules.types';
 export * from './features/federation/constants/federation.constants';
 export * from './features/federation/types/federation.types';
 export * from './features/core/kernel/endge';
+export * from './features/core/modules/bridge/EndgeBridge_Module';
+export * from './features/core/modules/bridge/domain/bridge.type';
+export { parseBridgeAllowedServers } from './features/core/modules/bridge/config/bridge.config';
 export * from './features/core/modules/domain/EndgeDomain_Module';
 export * from './features/core/modules/document-import/EndgeDocumentImport_Module';
 export { EndgeDomainRepository_Module, EndgeDomainRepositoryReadOnlyError } from './features/core/modules/domain-repository/EndgeDomainRepository_Module';
@@ -123,6 +126,7 @@ export * from './features/core/modules/source/domain/types/source-engine.types';
 export * from './features/core/modules/source/domain/types/source-expression.types';
 export * from './features/core/modules/source/domain/types/store-source.types';
 export * from './features/core/modules/source/domain/types/stream-source.types';
+export * from './features/core/modules/source/domain/types/simulation-source.types';
 export * from './features/core/modules/source/domain/types/update-source.types';
 export * from './features/core/modules/source/domain/types/type-source.types';
 export * from './features/core/modules/source/domain/types/configuration-source.types';
@@ -145,6 +149,7 @@ export * from './features/core/modules/domain/entities/RDataView';
 export * from './features/core/modules/domain/entities/RComposition';
 export * from './features/core/modules/domain/entities/RStore';
 export * from './features/core/modules/domain/entities/RStream';
+export * from './features/core/modules/domain/entities/RSimulation';
 export * from './features/core/modules/domain/entities/RUpdate';
 export * from './features/core/modules/domain/entities/RMock';
 export * from './features/core/modules/domain/entities/RQueryFilter';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@endge/core",
   "type": "module",
-  "version": "7.1.0",
+  "version": "9.0.0",
   "private": false,
   "packageManager": "pnpm@8.8.0",
   "license": "Apache-2.0",
@@ -30,7 +30,7 @@
     "lint-fix": "eslint . --fix --cache"
   },
   "peerDependencies": {
-    "@endge/raph": "^3.2.0",
+    "@endge/raph": "^3.3.0",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",
     "reflect-metadata": "^0.2.2"
@@ -38,7 +38,7 @@
   "dependencies": {
     "@babel/parser": "^7.27.2",
     "@babel/types": "^7.27.1",
-    "@endge/utils": "^0.26.0",
+    "@endge/utils": "^0.26.1",
     "@vue/compiler-dom": "^3.5.24",
     "@vue/compiler-sfc": "^3.5.24",
     "axios": "^1.13.2",
@@ -64,5 +64,6 @@
     "unplugin-dts": "^1.0.3",
     "vite": "^6.1.0",
     "vitest": "^2.1.9"
-  }
+  },
+  "version_updated": "09.09.2026"
 }

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

@@ -1,86 +0,0 @@
-import { EndgeModule } from '../../federation/EndgeModule';
-export interface RuntimeDebugTab {
-    id: string;
-    url: string;
-    title: string;
-    at: number;
-}
-/**
- * Подключает вкладку к каналу обмена для отладки.
- * start() - создаёт канал и слушает регистрации (вызывать в админке).
- * activate() - регистрирует текущую вкладку как клиент Runtime Debug.
- */
-export declare class EndgeRuntimeDebugger_Module extends EndgeModule {
-    /** Канал для отправки (activate) */
-    private _channel;
-    /** Канал для приёма (start); живёт глобально в админке */
-    private _listenerChannel;
-    private _tabId;
-    private _tabs;
-    private _autoRegisterTimer;
-    private _analysisByTabId;
-    private _diagnosticsListener;
-    private _unsubscribeDiagnostics;
-    /** Закрывает browser channels, timers и diagnostics subscription. */
-    reset(): void;
-    /** Доступ к текущему состоянию runtime debugger. */
-    /**
-     * Возвращает список вкладок, известных runtime debugger.
-     */
-    get tabs(): RuntimeDebugTab[];
-    /**
-     * Показывает, открыт ли BroadcastChannel для runtime debug.
-     */
-    get isListening(): boolean;
-    /**
-     * Возвращает накопленные результаты анализа для вкладки.
-     */
-    getAnalysis(tabId: string): string[];
-    /** Возвращает безопасную диагностическую проекцию известных debug-вкладок. */
-    createDiagnosticsSnapshot(): unknown;
-    /**
-     * Отправить команду во все подключённые вкладки.
-     * Используется админкой для запуска анализа по текущей вкладке.
-     */
-    sendCommand(command: string, payload?: Record<string, unknown>): void;
-    /**
-     * Запустить прослушку канала (создать канал и накапливать вкладки). Вызывать из админки при init.
-     */
-    startListening(): void;
-    /**
-     * Остановить прослушку, закрыть канал, очистить список вкладок.
-     */
-    stop(): void;
-    private _onMessage;
-    /**
-     * Возвращает Channel.
-     */
-    private _getChannel;
-    /**
-     * Возвращает Tab Id.
-     */
-    private _getTabId;
-    /**
-     * Внутренний helper модуля: post Register.
-     */
-    private _postRegister;
-    /**
-     * Обработка команд на стороне клиентской вкладки.
-     * Здесь просто логируем получение команды для отладки.
-     */
-    private _onClientMessage;
-    /**
-     * Гарантирует Auto Register.
-     */
-    private _ensureAutoRegister;
-    /**
-     * Зарегистрировать текущую вкладку в канале отладки.
-     * При активации подписывается на Endge.diagnostics и дублирует записи в канал для админки.
-     */
-    activate(): void;
-    /** Один раз подписаться на diagnostics и слать записи в канал. Не делаем на странице админки. */
-    /**
-     * Гарантирует Diagnostics Forwarding.
-     */
-    private _ensureDiagnosticsForwarding;
-}