@endge/core 1.2.7 → 1.2.9

package/dist/domain/entities/reflect/RComputation.d.ts

@@ -1,6 +1,5 @@
 import { DuplicateOptions, REntity } from './REntity';
 import { DiagnosticsProblemInput } from '../../types/diagnostics';
-import { RField } from './RField';
 /** Persisted executable specification. Runtime execution is provided separately. */
 export declare class RComputation extends REntity {
     displayName: string;
@@ -8,8 +7,6 @@ export declare class RComputation extends REntity {
     source: string;
     sourceVersion: number;
     contractVersion: number;
-    input: RField | null;
-    output: RField | null;
     static fromPayload(json: any): RComputation;
     static fromPlain(json: any, storageMeta?: any): RComputation;
     toPlain(): Record<string, unknown>;

package/dist/domain/entities/reflect/RStream.d.ts

@@ -0,0 +1,8 @@
+import { DuplicateOptions, REntity } from './REntity';
+/** Persisted source-first definition of a normalized event stream. */
+export declare class RStream extends REntity {
+    readonly type: "stream";
+    source: string;
+    sourceVersion: number;
+    duplicate(options: DuplicateOptions): RStream;
+}

package/dist/domain/entities/reflect/RType.d.ts

@@ -1,20 +1,13 @@
-import { RField } from './RField';
 import { REntity } from './REntity';
 /**
- * Класс рефлексии для хранения информации о типе.
- * Содержит название и список полей.
+ * Source-first доменная сущность типа.
  */
 export declare class RType extends REntity {
     get id(): string;
     name: string;
     isPrimitive: boolean;
-    /** Независимый Type Source. Legacy fields не генерируются из него автоматически. */
+    /** Каноническое структурное определение типа. */
     source: string;
     sourceVersion: number;
-    fields: Map<string, RField>;
     constructor(name: string);
-    addField(field: RField): void;
-    getField(fieldName: string | number): RField | null;
-    hasField(fieldName: string | number): boolean;
-    getFields(): string[];
 }

package/dist/domain/entities/reflect/RUpdate.d.ts

@@ -0,0 +1,10 @@
+import { DuplicateOptions, REntity } from './REntity';
+/** Persisted source-first Store-owned mutation definition. */
+export declare class RUpdate extends REntity {
+    readonly type: "update";
+    /** Stable identity of the only Store that may execute this Update. */
+    storeIdentity: string;
+    source: string;
+    sourceVersion: number;
+    duplicate(options: DuplicateOptions): RUpdate;
+}

package/dist/domain/entities/runtime/RuntimeHostBase.d.ts

@@ -141,6 +141,8 @@ export declare abstract class RuntimeHostBase<TType extends RuntimeEntityType, T
      * ACCESS
      */
     getArtifact(): ProgramArtifact<TArtifactPayload> | null;
+    /** Возвращает read-only artifact reader текущей runtime session. */
+    getArtifactReader(): RuntimeArtifactReader | null;
     /**
      * ACCESS
      */

package/dist/domain/entities/runtime/hosts/ComponentSFCRuntimeHost.d.ts

@@ -4,6 +4,8 @@ import { RComponentSFC_AST, RComponentSFC_IR, RComponentSFC_RuntimeDependencies,
 import { ComponentSFCPreviewOptions, ComponentSFCProgramPayload, ProgramDiagnostic } from '../../../types/program/program.types';
 import { RuntimeArtifactReader, RuntimeHost, RuntimeHostContext, RuntimeHostInputSource, RuntimeHostUpdateContext } from '../../../types/runtime/runtime-host.types';
 import { ComputationResource } from '../../../types/computation';
+import { SourceFieldOption } from '../../../types/source/source-expression.types';
+import { VocabOptionMapping } from '../../../types/runtime/vocab-cache.types';
 import { RuntimeHostBase } from '../RuntimeHostBase';
 /**
  * Runtime-host нового SFC-компонента.
@@ -18,6 +20,7 @@ export declare class ComponentSFCRuntimeHost extends RuntimeHostBase<'component-
     private readonly _computationErrorSignatures;
     private _styleLease;
     private readonly _eventPortListeners;
+    private readonly _vocabDisposers;
     constructor(input: {
         id: string;
         model: RComponentSFC;
@@ -43,6 +46,11 @@ export declare class ComponentSFCRuntimeHost extends RuntimeHostBase<'component-
     getDiagnostics(): ProgramDiagnostic[];
     /** Переводит public key через накопленный Composition catalog этого runtime. */
     translate(key: string, fallback?: string): string;
+    /**
+     * Читает Vocab alias из ближайшего Composition scope и преобразует cache
+     * records в renderer-neutral Select options.
+     */
+    resolveVocabOptions(alias: string, mapping?: Partial<VocabOptionMapping>): SourceFieldOption[];
     /** Возвращает внешний контракт компонента из compiled artifact. */
     getContract(): RComponentContract | null;
     /** Возвращает зависимости компонента из compiled artifact. */
@@ -90,6 +98,8 @@ export declare class ComponentSFCRuntimeHost extends RuntimeHostBase<'component-
     /** Backward-compatible alias для старого runtime prepare API. */
     preparePlaceholders(target: RComponentRenderTarget | null): void;
     private makeArtifactResourcePayload;
+    /** Подписывает host на shared Vocab path один раз, включая вложенные SFC artifacts. */
+    private _ensureVocabSubscription;
     private _createRuntimeBoundaryNodes;
     private _createTableColumnBoundaryNode;
     private _bindRaphInputSource;

package/dist/domain/entities/runtime/hosts/CompositionRuntimeHost.d.ts

@@ -1,8 +1,10 @@
 import { RComposition } from '../../reflect/RComposition';
 import { FilterViewRuntimeHost } from './FilterViewRuntimeHost';
+import { StoreMutationPlan } from '../../../types/source/update-source.types';
 import { CompositionFilterFieldsSlice, CompositionProgramPayload, CompositionPublicOutputHandle, CompositionRuntimeActivationHandle, CompositionRuntimeChildHandle } from '../../../types/source/composition-source.types';
 import { RuntimeArtifactReader, RuntimeHost, RuntimeHostContext, RuntimeHostInputSource, RuntimeHostUpdateContext } from '../../../types/runtime/runtime-host.types';
 import { I18nRuntimeCatalog } from '../../../types/i18n.types';
+import { VocabRuntimeCatalog } from '../../../types/runtime/vocab-cache.types';
 import { RuntimeHostBase } from '../RuntimeHostBase';
 import { RuntimeScope } from '../RuntimeScope';
 /** Runtime orchestration host: children, bindings, hooks и public handles. */
@@ -25,8 +27,11 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     private _ownedStoreRuntimeIds;
     private _compositionInputBindings;
     private _i18nCatalogs;
+    private _vocabCatalogs;
     private _orchestratedQueries;
     private _orchestratedSuccesses;
+    private _streamBatches;
+    private _streamBatchTimers;
     private _mounted;
     constructor(input: {
         id: string;
@@ -51,6 +56,8 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     getScope(path: string): RuntimeScope | null;
     /** Возвращает накопленный translation catalog для заданного lifecycle scope. */
     getI18nCatalog(scopePath?: string): I18nRuntimeCatalog;
+    /** Возвращает накопленный Vocab catalog для заданного lifecycle scope. */
+    getVocabCatalog(scopePath?: string): VocabRuntimeCatalog;
     getRuntimeHandle(path: string): CompositionRuntimeActivationHandle | null;
     /** Возвращает текущее значение публичного Composition output. */
     getOutput(name: string): unknown;
@@ -58,6 +65,10 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     getDataSnapshot(): Readonly<Record<string, unknown>>;
     /** Возвращает текущие значения публичных Composition props. */
     getProps(): Readonly<Record<string, unknown>>;
+    /** Imperative local mutation for UI flows that do not need a persisted RUpdate. */
+    mutateStore(dataAlias: string, plan: StoreMutationPlan): void;
+    /** Explicitly invokes one named Store-owned RUpdate outside Stream dispatch. */
+    applyStoreUpdate(dataAlias: string, updateIdentity: string, payload: unknown): void;
     /** Устанавливает literal/Raph-backed источник публичных Composition props. */
     setInputSource(input: RuntimeHostInputSource | null | undefined): void;
     /** Проверяет обязательные props до создания child runtime graph. */
@@ -78,7 +89,9 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     destroy(): Promise<void>;
     /** Строит effective catalogs по той же иерархии, что и lifecycle scopes. */
     private _buildI18nCatalogs;
-    /** Монтирует vocab data и разрешает Store aliases через explicit, ancestor или local provider. */
+    /** Строит nearest-scope catalog публичных Vocab aliases поверх shared cache paths. */
+    private _buildVocabCatalogs;
+    /** Регистрирует shared Vocab paths и разрешает Store aliases через explicit, ancestor или local provider. */
     private _mountData;
     /** Находит ближайший Store provider только среди Composition ancestors. */
     private _findAncestorStoreProvider;
@@ -88,8 +101,12 @@ export declare class CompositionRuntimeHost extends RuntimeHostBase<'composition
     private _publishUpdates;
     protected onUpdate(ctx: RuntimeHostUpdateContext): void;
     private _requireDataPath;
+    private _requireStoreRuntime;
+    private _resolveDataReference;
     private _createChild;
     private _bindChild;
+    private _bindStreamDispatch;
+    private _flushStreamBatch;
     private _makeOutputs;
     /** Не допускает прямые и транзитивные циклы Composition runtime tree. */
     private _assertCompositionCycle;

package/dist/domain/entities/runtime/hosts/FilterViewRuntimeHost.d.ts

@@ -14,6 +14,7 @@ export declare class FilterViewRuntimeHost extends RuntimeHostBase<'filter', Run
     private readonly _implementation;
     private readonly _onSourceChange;
     private readonly _disposeSourceWatch;
+    private readonly _disposeVocabWatch;
     private _props;
     constructor(input: {
         id: string;
@@ -40,4 +41,16 @@ export declare class FilterViewRuntimeHost extends RuntimeHostBase<'filter', Run
     getSlice(): CompositionFilterFieldsSlice;
     destroy(): void;
     private _resolveControl;
+    /**
+     * Возвращает готовые renderer-neutral options без сетевых запросов.
+     */
+    private _resolveOptions;
+    /**
+     * Возвращает Raph path справочника, используемого полем.
+     */
+    private _resolveVocabPath;
+    /**
+     * Читает вложенное значение строки справочника.
+     */
+    private _readPath;
 }

package/dist/domain/entities/runtime/hosts/StoreRuntimeHost.d.ts

@@ -1,6 +1,8 @@
 import { RStore } from '../../reflect/RStore';
 import { RuntimeArtifactReader, RuntimeHost, RuntimeHostContext } from '../../../types/runtime/runtime-host.types';
 import { StoreDataDescriptor, StoreSourceArtifact } from '../../../types/source/store-source.types';
+import { StoreMutationPlan } from '../../../types/source/update-source.types';
+import { StreamEventEnvelope } from '../../../types/source/stream-source.types';
 import { RuntimeHostBase } from '../RuntimeHostBase';
 /** Runtime-владелец writable Store state и реактивных DataView projections. */
 export declare class StoreRuntimeHost extends RuntimeHostBase<'store', RuntimeHostContext<'store'>, StoreSourceArtifact> {
@@ -31,8 +33,22 @@ export declare class StoreRuntimeHost extends RuntimeHostBase<'store', RuntimeHo
     isWritable(path: string): boolean;
     /** Записывает значение в writable Store field и запускает derived graph через Raph. */
     set(path: string, value: unknown): void;
+    /**
+     * Маршрутизирует нормализованное событие по compile-time таблице Store.
+     * Возвращает false, если Store не объявляет Update для данного типа.
+     */
+    dispatch(event: StreamEventEnvelope): boolean;
+    /** Применяет именованный дочерний Update к Store без привязки к транспорту. */
+    applyUpdate(updateIdentity: string, payload: unknown): void;
+    /**
+     * Применяет inline mutation из Composition/UI.
+     * Это escape hatch для локальных изменений, которым не нужен persisted RUpdate.
+     */
+    applyMutation(plan: StoreMutationPlan): void;
     /** Освобождает derived registrations до удаления Store state. */
     destroy(): void;
     /** Инициализирует writable fields и затем immediate derived graph. */
     private _mount;
+    private _makeMutationPlans;
+    private _applyMutationPlan;
 }

package/dist/domain/entities/runtime/hosts/StreamRuntimeHost.d.ts

@@ -0,0 +1,30 @@
+import { RStream } from '../../reflect/RStream';
+import { RuntimeArtifactReader, RuntimeHost, RuntimeHostContext } from '../../../types/runtime/runtime-host.types';
+import { StreamTransportFactory } from '../../../types/runtime/stream-runtime.types';
+import { StreamSourceArtifact } from '../../../types/source/stream-source.types';
+import { RuntimeHostBase } from '../RuntimeHostBase';
+/** Runtime lifecycle owner for one compiled Stream transport. */
+export declare class StreamRuntimeHost extends RuntimeHostBase<'stream', RuntimeHostContext<'stream'>, StreamSourceArtifact> {
+    private _connection;
+    constructor(input: {
+        id: string;
+        model: RStream;
+        parent?: RuntimeHost<any, any> | null;
+        meta?: Record<string, unknown>;
+        artifactReader: RuntimeArtifactReader;
+        privateTransportFactory: StreamTransportFactory;
+    });
+    private readonly _transportFactory;
+    static createRuntime(input: {
+        id: string;
+        model: RStream;
+        meta?: Record<string, any>;
+        parent?: RuntimeHost<any, any> | null;
+        artifacts: RuntimeArtifactReader;
+        transportFactory: StreamTransportFactory;
+    }): StreamRuntimeHost | null;
+    start(): void;
+    stop(): void;
+    destroy(): void;
+    private _receive;
+}

package/dist/domain/types/component/sfc/dependencies.types.d.ts

@@ -42,12 +42,25 @@ export interface RComponentSFC_RuntimeBoundaryDependency {
     /** Колонки таблицы, которые можно обновлять точечно. */
     columns: RComponentSFC_RuntimeTableColumnDependency[];
 }
+/** Runtime-зависимость SFC от Vocab alias ближайшего Composition scope. */
+export interface RComponentSFC_RuntimeVocabDependency {
+    /** Публичный, scope-local alias; физическая Vocab identity сюда не протекает. */
+    alias: string;
+    /** Путь option value внутри элемента Vocab. */
+    valuePath: string;
+    /** Путь option label внутри элемента Vocab. */
+    labelPath: string;
+    /** Исходное выражение для diagnostics/debug. */
+    raw: string;
+}
 /** Набор runtime-зависимостей SFC artifact. */
 export interface RComponentSFC_RuntimeDependencies {
     /** Зависимости от props, которые можно связать с внешним input source. */
     props: RComponentSFC_RuntimeDependency[];
     /** Patchable boundaries, для которых runtime строит отдельные Raph-ноды. */
     boundaries: RComponentSFC_RuntimeBoundaryDependency[];
+    /** Vocab aliases, которые должен предоставить ближайший Composition scope. */
+    vocabs?: RComponentSFC_RuntimeVocabDependency[];
 }
 /** Создает пустой dependency artifact SFC runtime. */
 export declare function createEmptyComponentSFCRuntimeDependencies(): RComponentSFC_RuntimeDependencies;

package/dist/domain/types/component/sfc/ir.types.d.ts

@@ -123,6 +123,19 @@ export interface RComponentSFC_IR_ExpressionValue {
     source: string;
     /** Зависимости, которые выражение читает. */
     reads: RComponentSFC_IR_Read[];
+    /** Статические обращения к Vocab aliases текущего Composition scope. */
+    vocabReads?: RComponentSFC_IR_VocabRead[];
+}
+/** Статическое обращение `vocab(alias, mapping?)` внутри SFC expression. */
+export interface RComponentSFC_IR_VocabRead {
+    /** Публичный alias из ближайшего Composition scope. */
+    alias: string;
+    /** Путь option value внутри элемента Vocab. */
+    valuePath: string;
+    /** Путь option label внутри элемента Vocab. */
+    labelPath: string;
+    /** Исходное выражение для diagnostics/debug. */
+    raw: string;
 }
 /** Реактивное чтение, найденное внутри выражения. */
 export interface RComponentSFC_IR_Read {

package/dist/domain/types/computation/computation-source.types.d.ts

@@ -1,4 +1,5 @@
 import { SourceExpressionIR } from '../source/source-expression.types';
+import { ComputationContractField } from './computation-program.types';
 export interface ComputationSourceRange {
     start: number;
     end: number;
@@ -23,6 +24,8 @@ export type ComputationSourceNode = {
 };
 /** Canonical compiler-derived representation of defineComputation source. */
 export interface ComputationSourceDocument {
+    input: ComputationContractField | null;
+    output: ComputationContractField | null;
     outputs: ComputationSourceNode[];
     result: SourceExpressionIR;
 }

package/dist/domain/types/document/document.types.d.ts

@@ -20,6 +20,8 @@ import { RWorkspace } from '../../entities/reflect/RWorkspace';
 import { RComponent } from '../component/component.types';
 import { RComposition } from '../../entities/reflect/RComposition';
 import { RStore } from '../../entities/reflect/RStore';
+import { RStream } from '../../entities/reflect/RStream';
+import { RUpdate } from '../../entities/reflect/RUpdate';
 import { RMock } from '../../entities/reflect/RMock';
 import { RComputation } from '../../entities/reflect/RComputation';
 /**
@@ -84,7 +86,7 @@ export declare enum DomainSectionType {
 /**
  * Все возможные типы документов
  */
-export type DomainDocumentType = 'primitive' | 'type' | 'action' | 'converter' | 'computation' | 'data-view' | 'composition' | 'store' | 'mock' | 'integration' | 'page-template' | 'page' | 'navigation' | 'environment' | 'policy' | 'style' | 'vocabs' | 'i18n-bundles' | 'auth-profile' | 'tenant' | 'project' | 'workspace' | Exclude<ComponentType, ComponentType.Component | ComponentType.Html> | QueryType | ParameterType | FilterType;
+export type DomainDocumentType = 'primitive' | 'type' | 'action' | 'converter' | 'computation' | 'data-view' | 'composition' | 'store' | 'stream' | 'update' | 'mock' | 'integration' | 'page-template' | 'page' | 'navigation' | 'environment' | 'policy' | 'style' | 'vocabs' | 'i18n-bundles' | 'auth-profile' | 'tenant' | 'project' | 'workspace' | Exclude<ComponentType, ComponentType.Component | ComponentType.Html> | QueryType | ParameterType | FilterType;
 /**
  * Описывает любой документ
  */
@@ -96,4 +98,4 @@ export interface Document {
 /**
  * Описывает любой документ рефлекцию
  */
-export type RDocument = RComponent | RComponentSFC | RQuery | RDataView | RComposition | RStore | RMock | RAction | RConverter | RComputation | RIntegration | RParameter | RFilter | RPolicy | RStyle | RType | RVocabs | RI18nBundle | RAuthProfile | RWorkspace | RTenant | RPageTemplate | RPage | RNavigation;
+export type RDocument = RComponent | RComponentSFC | RQuery | RDataView | RComposition | RStore | RStream | RUpdate | RMock | RAction | RConverter | RComputation | RIntegration | RParameter | RFilter | RPolicy | RStyle | RType | RVocabs | RI18nBundle | RAuthProfile | RWorkspace | RTenant | RPageTemplate | RPage | RNavigation;

package/dist/domain/types/document/domain-export.type.d.ts

@@ -12,6 +12,8 @@ export interface EndgeDomainPlain {
     dataViews: unknown[];
     compositions: unknown[];
     stores: unknown[];
+    streams: unknown[];
+    updates: unknown[];
     mocks: unknown[];
     components: unknown[];
     componentSFCs: unknown[];

package/dist/domain/types/document/schema.types.d.ts

@@ -24,6 +24,8 @@ import { Tenants_Repository } from '../../../model/db/repositories/Tenants_Repos
 import { Workspaces_Repository } from '../../../model/db/repositories/Workspaces_Repository';
 import { Compositions_Repository } from '../../../model/db/repositories/Compositions_Repository';
 import { Stores_Repository } from '../../../model/db/repositories/Stores_Repository';
+import { Streams_Repository } from '../../../model/db/repositories/Streams_Repository';
+import { Updates_Repository } from '../../../model/db/repositories/Updates_Repository';
 import { Mocks_Repository } from '../../../model/db/repositories/Mocks_Repository';
 import { Computations_Repository } from '../../../model/db/repositories/Computations_Repository';
 export interface EndgeSchemaDump {
@@ -35,6 +37,8 @@ export interface EndgeSchemaDump {
     dataViews: any[];
     compositions: any[];
     stores: any[];
+    streams: any[];
+    updates: any[];
     mocks: any[];
     folders: any[];
     components: any[];
@@ -73,6 +77,8 @@ export type RepositoriesBag = {
     dataViews: DataViews_Repository;
     compositions: Compositions_Repository;
     stores: Stores_Repository;
+    streams: Streams_Repository;
+    updates: Updates_Repository;
     mocks: Mocks_Repository;
     folders: Folders_Repository;
     components: Components_Repository;

package/dist/domain/types/program/program.types.d.ts

@@ -2,13 +2,13 @@ import { ActionCompiledFlow } from '../flow/action.types';
 import { RComponentContract, RComponentDependencies } from '../component/component-core.types';
 import { DataViewManualTransform, DataViewPipelineStep, DataViewRef, DataViewSourceDocument } from '../source/data-view-source.types';
 import { RComponentSFC_AST, RComponentSFC_IR, RComponentSFC_RuntimeDependencies, RComponentSFCSource_Parts } from '../component/sfc';
-import { QueryProgramProp, SourceExpressionIR } from '../source/source-expression.types';
+import { QueryProgramProp, SourceExpressionIR, SourceFieldDefinition } from '../source/source-expression.types';
 import { ProgramMetadata } from './program-metadata.types';
 import { ComputationProgramPayload } from '../computation';
 import { EndgeStyleSheetArtifact } from '../style';
 import { ActionImplementation, ActionTargetSelector } from '../runtime/action.types';
 /** Тип доменной сущности, для которой compiler может построить program artifact. */
-export type ProgramEntityType = 'type' | 'component-sfc' | 'computation' | 'action' | 'query' | 'data-view' | 'store' | 'filter' | 'composition' | 'style';
+export type ProgramEntityType = 'type' | 'component-sfc' | 'computation' | 'action' | 'query' | 'data-view' | 'store' | 'stream' | 'update' | 'filter' | 'composition' | 'style';
 /** Итоговый статус artifact после компиляции и валидации. */
 export type ProgramArtifactStatus = 'valid' | 'warning' | 'error';
 /** Возможность, которую artifact предоставляет runtime/render слоям. */
@@ -106,6 +106,7 @@ export interface QueryProgramOutput {
     key: string;
     source: QueryProgramOutputSource;
     dataViews: DataViewRef[];
+    contract?: SourceFieldDefinition | null;
     materialization: {
         kind: 'source';
     } | {
@@ -160,6 +161,8 @@ export interface DataViewProgramPayload {
     materializationStrategy: import('../source/data-view-source.types').DataViewMaterializationStrategy;
     /** Canonical source document для debug/preview UI. */
     sourceDocument: DataViewSourceDocument | null;
+    /** Декларативный входной и выходной тип DataView. */
+    contract?: DataViewSourceDocument['contract'];
     /** Compiled manual transform. Используется только в mode=manual. */
     transform: DataViewManualTransform | null;
     /** Compiled pipeline steps. Используется только в mode=pipeline. */

package/dist/domain/types/runtime/action.types.d.ts

@@ -4,6 +4,9 @@ export type RuntimeActionSurface = string;
 /** Stable identities of targetless Actions provided by Endge itself. */
 export declare const BUILTIN_ACTION_IDS: {
     readonly consoleLog: "built-in-console-log";
+    readonly vocabAcquire: "built-in-vocabs-acquire";
+    readonly vocabRefresh: "built-in-vocabs-refresh";
+    readonly vocabInvalidate: "built-in-vocabs-invalidate";
 };
 /** Declarative reference accepted by interactive primitives such as MenuItem. */
 export interface ActionBinding<TInput = unknown> {

package/dist/domain/types/runtime/index.d.ts

@@ -1,4 +1,5 @@
 export * from './action.types';
+export * from './vocab-cache.types';
 export * from './implementation.types';
 export * from './context-persistence.types';
 export * from './query-execution.types';

package/dist/domain/types/runtime/runtime-entity-map.types.d.ts

@@ -6,6 +6,7 @@ import { RQuery } from '../../entities/reflect/RQuery';
 import { RFilter } from '../../entities/reflect/RFilter';
 import { RComposition } from '../../entities/reflect/RComposition';
 import { RStore } from '../../entities/reflect/RStore';
+import { RStream } from '../../entities/reflect/RStream';
 /**
  * Канонический перечень сущностей, для которых может существовать runtime-host.
  */
@@ -24,6 +25,8 @@ export interface RuntimeEntityModelMap {
     composition: RComposition;
     /** Source-first reactive Store runtime. */
     store: RStore;
+    /** External or emulated normalized event stream. */
+    stream: RStream;
     /** Доменная модель action. */
     action: RAction;
 }

package/dist/domain/types/runtime/runtime-host.types.d.ts

@@ -68,6 +68,10 @@ export interface StoreRuntimeHostContext extends RuntimeHostContextBase {
     writableFields: string[];
     derivedFields: string[];
 }
+export interface StreamRuntimeHostContext extends RuntimeHostContextBase {
+    lastEventAt: string | null;
+    receivedCount: number;
+}
 export interface ComponentSFCRuntimeHostContext extends RuntimeHostContextBase {
     /** Target последней подготовки SFC. */
     target: 'dom' | 'canvas' | null;
@@ -90,6 +94,7 @@ export interface RuntimeHostContextMap {
     filter: FilterRuntimeHostContext;
     composition: CompositionRuntimeHostContext;
     store: StoreRuntimeHostContext;
+    stream: StreamRuntimeHostContext;
     'component-sfc': ComponentSFCRuntimeHostContext;
     page: PageRuntimeHostContext;
     project: ProjectRuntimeHostContext;
@@ -309,6 +314,8 @@ export interface RuntimeHost<TType extends RuntimeEntityType = RuntimeEntityType
     bindUpdate: (binding: RuntimeHostUpdateBinding) => () => void;
     /** Возвращает compiled artifact, связанный с host, если он доступен. */
     getArtifact: () => ProgramArtifact<TArtifactPayload> | null;
+    /** Возвращает session-local reader, через который host читает compiled artifacts. */
+    getArtifactReader: () => RuntimeArtifactReader | null;
     /** Возвращает payload compiled artifact, связанный с host, если он доступен. */
     getArtifactPayload: () => TArtifactPayload | null;
     /** Изменить статус host и обновить updatedAt. */

package/dist/domain/types/runtime/runtime-project-session.types.d.ts

@@ -1,6 +1,7 @@
 import { CompositionPublicOutputHandle, CompositionSession } from '../source/composition-source.types';
 import { CompositionRuntimeHost } from '../../entities/runtime/hosts/CompositionRuntimeHost';
 import { RuntimeScopeHandle } from './runtime-scope.types';
+import { RuntimeArtifactReader } from './runtime-host.types';
 export interface ProjectCompositionRegistry {
     get: (identity: string) => ProjectCompositionHandle | null;
     require: (identity: string) => ProjectCompositionHandle;
@@ -21,6 +22,8 @@ export interface ProjectCompositionHandle {
 export interface ProjectRuntimeMountOptions {
     /** `declared` preserves root activateOn; `none` creates stable handles for an on-demand/debug session. */
     autoActivate?: 'declared' | 'none';
+    /** Session-local artifact projection used by Preview without mutating Endge.program. */
+    artifactReader?: RuntimeArtifactReader;
 }
 export interface ProjectRuntimeSession {
     readonly id: string;

package/dist/domain/types/runtime/runtime.types.d.ts

@@ -1,6 +1,7 @@
 import { RFilter } from '../../entities/reflect/RFilter';
 import { RComposition } from '../../entities/reflect/RComposition';
 import { RStore } from '../../entities/reflect/RStore';
+import { RStream } from '../../entities/reflect/RStream';
 import { RAction } from '../../entities/reflect/RAction';
 import { RComponentSFC } from '../../entities/reflect/RComponentSFC';
 import { RPage } from '../../entities/reflect/RPage';
@@ -10,8 +11,8 @@ import { RuntimeHostRegistrySnapshot } from './runtime-registry.types';
 /**
  * Runtime kinds
  */
-export type RuntimeKind = 'query' | 'filter' | 'composition' | 'store' | 'action' | 'runtime';
-export type RuntimeExecutableModel = RQuery | RAction | RProject | RPage | RComponentSFC | RFilter | RComposition | RStore;
+export type RuntimeKind = 'query' | 'filter' | 'composition' | 'store' | 'stream' | 'action' | 'runtime';
+export type RuntimeExecutableModel = RQuery | RAction | RProject | RPage | RComponentSFC | RFilter | RComposition | RStore | RStream;
 export interface EndgeRuntimeSnapshot extends RuntimeHostRegistrySnapshot {
     generatedAt: number;
     scopes: import('./runtime-scope.types').RuntimeScopeSnapshot[];

package/dist/domain/types/runtime/stream-runtime.types.d.ts

@@ -0,0 +1,17 @@
+import { StreamSourceArtifact } from '../source/stream-source.types';
+export interface StreamTransportMessage {
+    sourceEvent: string;
+    id: string | null;
+    data: unknown;
+}
+export interface StreamTransportConnection {
+    close: () => void;
+}
+/** Browser-neutral port used by StreamRuntimeHost. */
+export interface StreamTransportFactory {
+    open: (artifact: StreamSourceArtifact, callbacks: {
+        message: (message: StreamTransportMessage) => void;
+        error: (error: unknown) => void;
+        open: () => void;
+    }) => StreamTransportConnection;
+}

package/dist/domain/types/runtime/vocab-cache.types.d.ts

@@ -0,0 +1,33 @@
+export type VocabReference = string | number;
+export type VocabLoadStrategy = 'cache-first' | 'network-first' | 'stale-while-revalidate';
+export type VocabLoadErrorPolicy = 'fail' | 'use-cache';
+export interface VocabLoadPolicy {
+    strategy: VocabLoadStrategy;
+    /**
+     * Максимальный возраст cache entry в миллисекундах.
+     * `null` означает, что cache не устаревает автоматически.
+     */
+    maxAgeMs: number | null;
+    onError: VocabLoadErrorPolicy;
+}
+export declare const DEFAULT_VOCAB_LOAD_POLICY: Readonly<VocabLoadPolicy>;
+export type VocabCacheOperationStatus = 'cache-hit' | 'loaded' | 'refreshed' | 'refreshing' | 'invalidated';
+export interface VocabCacheOperationResult {
+    identity: string;
+    status: VocabCacheOperationStatus;
+    count: number;
+}
+/** Один публичный Vocab alias, доступный внутри runtime scope Composition. */
+export interface VocabRuntimeCatalogEntry {
+    /** Физическая identity Vocab-документа, полезная для diagnostics. */
+    identity: string;
+    /** Реактивный Raph path загруженного массива значений. */
+    path: string;
+}
+/** Накопленный Vocab catalog ближайшего Composition scope. */
+export type VocabRuntimeCatalog = Record<string, VocabRuntimeCatalogEntry>;
+/** Явное преобразование элемента Vocab в renderer-neutral option. */
+export interface VocabOptionMapping {
+    valuePath: string;
+    labelPath: string;
+}