@endge/core 5.0.0 → 7.0.0

package/dist/domain/types/kernel/bootstrap.types.d.ts

@@ -1,55 +0,0 @@
-import { EndgeAuthBootOptions } from '../auth/auth-profile.types';
-import { EndgeDomainBundle } from '../document/domain-export.type';
-import { EndgeDomainProvider } from '../document/domain-provider.type';
-import { EndgeExecutionContext } from '../runtime/execution-context.types';
-/**
- * Источник получения доменных данных
- * default - работа с внешним сервисом backend
- * bundle - read-only работа с переносимым workspace snapshot
- * plain - данные подтягиваются из файла
- */
-export type EndgeDataProvider = 'default' | 'bundle' | 'plain';
-/**
- * Конфигурация загрузки движка
- * Определяет workspace, данные которого должны быть активированы из persisted Domain.
- * Tenant, project и environment передаются отдельно через EndgeBootContext.context.
- */
-export interface EndgeLoadScope {
-    workspaceIdentity?: string;
-}
-export interface EndgeUIBootOptions {
-    /** Host-local fallback order when the configured adapter implementation is unavailable. */
-    adapterFallbackIds?: readonly string[];
-}
-export interface EndgeBootContext {
-    /**
-     * Источник получения доменных данных
-     */
-    dataProvider: EndgeDataProvider;
-    /**
-     * Граница загружаемого persisted Domain.
-     */
-    scope: EndgeLoadScope;
-    /** Structural context immutable for one complete boot/build lifecycle. */
-    context?: Partial<EndgeExecutionContext>;
-    /**
-     * Runtime/env vars, которые нужны ядру.
-     */
-    vars: Record<string, unknown>;
-    /** Host-local UI policy; it does not mutate persisted Workspace configuration. */
-    ui?: EndgeUIBootOptions;
-    /** Host-owned browser session namespace. */
-    auth?: EndgeAuthBootOptions;
-    /**
-     * Для plain provider.
-     */
-    plainSource?: unknown;
-    /** Внешний источник live snapshot для default backend provider. */
-    domainProvider?: EndgeDomainProvider;
-    /** Переносимый read-only workspace snapshot для bundle provider. */
-    bundleSource?: EndgeDomainBundle;
-    /**
-     * Для отмены долгой загрузки/сборки.
-     */
-    signal?: AbortSignal;
-}

package/dist/domain/types/kernel/endge-modules.types.d.ts

@@ -1,18 +0,0 @@
-import { EndgeModule } from '../../entities/endge/EndgeModule';
-export type EndgeModuleConstructor<T extends EndgeModule = EndgeModule> = new () => T;
-export interface EndgeModuleDefinition<T extends EndgeModule = EndgeModule> {
-    key: string;
-    module: EndgeModuleConstructor<T>;
-    before?: string | string[];
-    after?: string | string[];
-}
-export interface EndgeModuleDescriptor<T extends EndgeModule = EndgeModule> {
-    key: string;
-    module: T;
-    before?: string | string[];
-    after?: string | string[];
-}
-export interface EndgePlugin {
-    id: string;
-    install: () => void;
-}

package/dist/domain/types/kernel/federation.types.d.ts

@@ -1,14 +0,0 @@
-import { EndgeModule } from '../../entities/endge/EndgeModule';
-import { EndgeBootContext } from './bootstrap.types';
-import { EndgeModuleDescriptor, EndgePlugin } from './endge-modules.types';
-export interface EndgeFederationHost {
-    isConfigured: boolean;
-    isConfiguring: boolean;
-    isSetup: boolean;
-    isInitialized: boolean;
-    bootContext: EndgeBootContext | null;
-    moduleDescriptors: EndgeModuleDescriptor[];
-    modules: Map<string, EndgeModule>;
-    plugins: EndgePlugin[];
-    installedPluginIds: Set<string>;
-}

package/dist/domain/types/kernel/forge.types.d.ts

@@ -1,30 +0,0 @@
-/**
- * Endge Модуль
- */
-export interface EndgeModule {
-    id: string;
-    setup: () => void;
-    destroy?: () => void;
-    toPlain?: () => object;
-    fromPlain?: (data: object) => void;
-}
-export type EndgeEventMap = Record<string, any>;
-/**
- * Токены (типизированные идентификаторы сервисов)
- */
-export type EndgeToken<T, E extends EndgeEventMap> = string & {
-    __t?: T;
-    __ev?: E;
-};
-export declare function endgeToken<T, E extends EndgeEventMap = object>(id: string): EndgeToken<T, E>;
-export type EndgeModuleCtor = new () => EndgeModule;
-export type EndgeModuleSpec = EndgeModule | EndgeModuleCtor;
-export type EndgeModuleLoader = (() => Promise<EndgeModuleSpec> | EndgeModuleSpec) | EndgeModuleSpec;
-export interface EndgeModuleInstall<T extends EndgeModule, E extends EndgeEventMap = object> {
-    name: string;
-    version: string;
-    description: string;
-    author: string;
-    token: EndgeToken<T, E>;
-    loader: EndgeModuleLoader;
-}

package/dist/domain/types/mock/mock-data.type.d.ts

@@ -1,37 +0,0 @@
-import { RMock } from '../../entities/reflect/RMock';
-export type RMockContentSource = 'document' | 'code-provider';
-export type RMockContentType = 'application/json' | 'text/plain';
-/** Контекст вызова code provider для persisted mock-документа. */
-export interface EndgeMockProviderContext {
-    mock: RMock;
-}
-/** Кодовая реализация содержимого, подключаемая к persisted mock по codeRef. */
-export interface EndgeMockProvider {
-    ref: string;
-    description?: string;
-    provide: (context: EndgeMockProviderContext) => unknown;
-}
-/** @deprecated Используйте EndgeMockProvider. */
-export interface EndgeMockRegistration {
-    /** Стабильный identity, используемый в source через mock(identity). */
-    identity: string;
-    /** Исходный mock payload. EndgeMock хранит и возвращает независимые копии. */
-    data: unknown;
-    /** Необязательное описание сценария для diagnostics и configurator UI. */
-    description?: string;
-}
-/** Публичное описание зарегистрированного mock payload без самих данных. */
-export interface EndgeMockDescriptor {
-    ref: string;
-    description?: string;
-}
-export type EndgeMockBindingStatus = 'document' | 'connected' | 'missing-document' | 'missing-provider' | 'invalid-content';
-/** Сериализуемый snapshot модуля EndgeMock. */
-export interface EndgeMockSnapshot {
-    providers: EndgeMockDescriptor[];
-}
-/** Compiler/runtime reference на mock payload. */
-export interface EndgeMockReference {
-    kind: 'mock';
-    identity: string;
-}

package/dist/domain/types/presentation/context-menu.types.d.ts

@@ -1,20 +0,0 @@
-import { RuntimeActionId } from '../runtime/action.types';
-export type ContextMenuItemKind = 'item' | 'separator';
-export interface ContextMenuDescriptor {
-    kind: 'context-menu';
-    items: ContextMenuNodeDescriptor[];
-}
-export type ContextMenuNodeDescriptor = ContextMenuItemDescriptor | ContextMenuSeparatorDescriptor;
-export interface ContextMenuItemDescriptor {
-    kind: 'item';
-    id: string;
-    label: string;
-    action: RuntimeActionId;
-    input?: unknown;
-    icon?: string;
-    disabled?: boolean;
-}
-export interface ContextMenuSeparatorDescriptor {
-    kind: 'separator';
-    id: string;
-}

package/dist/domain/types/presentation/filter-view.type.d.ts

@@ -1,45 +0,0 @@
-import { SourceFieldDefinition, SourceFieldOption } from '../source/source-expression.types';
-export declare const ENDGE_UI_SELECT_METADATA_NAMESPACE = "endge.ui.select";
-export declare const FILTER_SELECT_AUTO_OPTIMIZE_THRESHOLD = 10;
-/** Presentation hints встроенного Select; неизвестные metadata adapters игнорируют. */
-export interface FilterSelectPresentationMetadata {
-    searchable?: boolean;
-}
-/** Результат применения metadata и безопасных adapter defaults к Select. */
-export interface FilterSelectPresentation {
-    searchable: boolean;
-    virtualized: boolean;
-}
-/** Применяет явный searchable override и автоматическую оптимизацию больших списков. */
-export declare function resolveFilterSelectPresentation(field: Pick<SourceFieldDefinition, 'metadata'>, optionCount: number): FilterSelectPresentation;
-/** Renderer-neutral primitive, выбранный для поля Filter view. */
-export type FilterViewControlType = 'Input' | 'Textarea' | 'Checkbox' | 'Select';
-/** Явное переопределение автоматически выбранного контрола. */
-export interface FilterViewControlDefinition {
-    type: FilterViewControlType;
-}
-/** Стабильные props, которые понимает встроенный Filter view generator. */
-export interface FilterViewBuiltinProps {
-    showLabels?: boolean;
-    labels?: Record<string, string>;
-}
-/** Способ отображения Filter view. */
-export type FilterViewImplementation = {
-    kind: 'generated';
-} | {
-    kind: 'component';
-    identity: string;
-};
-/** Одно поле готового renderer-neutral плана Filter view. */
-export interface FilterViewRenderField extends SourceFieldDefinition {
-    control: FilterViewControlDefinition;
-    value: unknown;
-    options: SourceFieldOption[];
-}
-/** Готовый renderer-neutral план Filter view. */
-export interface FilterViewRenderModel {
-    implementation: FilterViewImplementation;
-    /** Открытый user-defined props bag для встроенного или пользовательского renderer-а. */
-    props: Readonly<Record<string, unknown>>;
-    fields: FilterViewRenderField[];
-}

package/dist/domain/types/presentation/ui-render-adapter.type.d.ts

@@ -1,37 +0,0 @@
-/** Протокол renderer-адаптеров для SFC v1. */
-export declare const ENDGE_SFC_RENDER_ADAPTER_PROTOCOL = "endge-sfc";
-/** Текущая версия контракта renderer-адаптеров SFC. */
-export declare const ENDGE_SFC_RENDER_ADAPTER_PROTOCOL_VERSION = 1;
-/** SFC primitives, внешний вид которых полностью определяет renderer-адаптер. */
-export declare const ENDGE_SFC_RENDER_ADAPTER_REQUIRED_KEYS: readonly ["Text", "DateTime", "Number", "Icon", "Badge", "Dot", "Box", "Flex", "Grid", "Divider", "Input", "Textarea", "Checkbox", "Select"];
-export type EndgeSFCRenderAdapterKey = typeof ENDGE_SFC_RENDER_ADAPTER_REQUIRED_KEYS[number];
-/** Renderer-neutral описание зарегистрированного UI adapter-а. */
-export interface UIRenderAdapter<TImplementation = unknown> {
-    id: string;
-    protocol: string;
-    protocolVersion: number;
-    renderer: string;
-    renderers: Readonly<Record<string, TImplementation>>;
-    /** Opaque host entry points owned by this adapter: shell, SFC root, runtime root, etc. */
-    roots?: Readonly<Record<string, unknown>>;
-}
-/** Требования consumer-а к renderer adapter-у. */
-export interface UIRenderAdapterRequirement {
-    id: string;
-    protocol?: string;
-    protocolVersion?: number;
-    renderer?: string;
-    requiredRendererKeys?: readonly string[];
-    requiredRootKeys?: readonly string[];
-}
-/** Требования к уже активированному renderer adapter-у. */
-export type UIActiveRenderAdapterRequirement = Omit<UIRenderAdapterRequirement, 'id'>;
-/** Сериализуемое описание adapter-а без его runtime implementations. */
-export interface UIRenderAdapterDescriptor {
-    id: string;
-    protocol: string;
-    protocolVersion: number;
-    renderer: string;
-    rendererKeys: string[];
-    rootKeys: string[];
-}

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

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

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

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