@endge/core 5.0.0 → 6.0.0

package/dist/features/core/modules/source/domain/types/filter-view.type.d.ts

@@ -0,0 +1,45 @@
+import { SourceFieldDefinition, SourceFieldOption } from './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/features/core/modules/source/domain/types/query-source.types.d.ts

@@ -0,0 +1,120 @@
+import { RQueryAuth } from '../../../domain/types/document/query.types';
+import { ProgramMetadataMap } from '../../../program/domain/types/program-metadata.types';
+import { ProgramDiagnostic, QueryProgramPayload } from '../../../program/domain/types/program.types';
+import { DataViewRef } from './data-view-source.types';
+import { ResponseOutputTransform } from './response-output.types';
+import { QueryProgramProp, SourceExpressionIR, SourceFieldDefinition } from './source-expression.types';
+/** Поддерживаемые transport-kind Query source. */
+export type QuerySourceKind = 'rest' | 'graphql';
+/** Политика GraphQL errors в HTTP 2xx response. */
+export type QueryGraphQLErrorPolicy = 'throw' | 'ignore';
+/** Статическое значение запроса или безопасное выражение, вычисляемое из props Query в runtime. */
+export type QuerySourceRequestValue<T> = T | SourceExpressionIR;
+/** Source-описание HTTP request части REST-запроса. */
+export interface QuerySourceRestRequest {
+    /** Endpoint или Endge var-token вида {API_URL}. */
+    endpoint: QuerySourceRequestValue<string>;
+    /** REST path. В legacy RQuery это поле хранится как query. */
+    path: QuerySourceRequestValue<string>;
+    /** Метод HTTP. */
+    method: QuerySourceRequestValue<string>;
+    /** Заголовки HTTP. */
+    headers: QuerySourceRequestValue<Record<string, string>>;
+    /** Конфигурация авторизации. */
+    auth: QuerySourceRequestValue<RQueryAuth>;
+    /** Таймаут запроса. */
+    timeoutMs?: QuerySourceRequestValue<number>;
+    /** Отправлять body как application/x-www-form-urlencoded. */
+    formUrlencoded?: QuerySourceRequestValue<boolean>;
+    /** Безопасный body expression для query source v2. */
+    body?: SourceExpressionIR | null;
+}
+/** Source-описание GraphQL operation и variables. */
+export interface QuerySourceGraphQLRequest {
+    /** GraphQL endpoint или Endge var-token вида {API_URL}. */
+    endpoint: QuerySourceRequestValue<string>;
+    /** Статический GraphQL document из gql template. */
+    document: string;
+    /** Operation name для document с несколькими operations. */
+    operationName?: string;
+    /** Безопасное variables expression, построенное через variables(...). */
+    variables?: SourceExpressionIR | null;
+    /** Дополнительные HTTP headers. */
+    headers: QuerySourceRequestValue<Record<string, string>>;
+    /** Конфигурация авторизации. */
+    auth: QuerySourceRequestValue<RQueryAuth>;
+    /** Таймаут запроса. */
+    timeoutMs?: QuerySourceRequestValue<number>;
+    /** Обработка GraphQL errors в HTTP 2xx response. */
+    errorPolicy: QueryGraphQLErrorPolicy;
+}
+/** Source-описание mock-режима запроса. */
+export interface QuerySourceMock {
+    /** Включены ли mock data. */
+    enabled: boolean;
+    /** Mock-данные. */
+    data: unknown;
+}
+export type QueryOutputSource = {
+    type: 'response';
+    path: string | null;
+    expression?: SourceExpressionIR;
+} | {
+    type: 'output';
+    key: string;
+};
+export interface QuerySourceOutput {
+    key: string;
+    source: QueryOutputSource;
+    /** Упорядоченная цепочка transform. */
+    transforms: ResponseOutputTransform[];
+    /** Проекция совместимости, содержащая только transforms DataView. */
+    dataViews: DataViewRef[];
+    contract?: SourceFieldDefinition | null;
+}
+export type QuerySourceOutputs = QuerySourceOutput[];
+interface QuerySourceDocumentBase {
+    /** Единственный runtime input contract Query. */
+    props: QueryProgramProp[];
+    /** Упорядоченный выходной граф: источники response/output и преобразования. */
+    outputs: QuerySourceOutputs;
+    /** Конфигурация mock. */
+    mock: QuerySourceMock;
+}
+export interface QuerySourceRestDocument extends QuerySourceDocumentBase {
+    kind: 'rest';
+    request: QuerySourceRestRequest;
+}
+export interface QuerySourceGraphQLDocument extends QuerySourceDocumentBase {
+    kind: 'graphql';
+    request: QuerySourceGraphQLRequest;
+}
+/** Canonical authoring-модель source-only Query v2. */
+export type QuerySourceDocument = QuerySourceRestDocument | QuerySourceGraphQLDocument;
+/** Публичные editor-slots, которые query source patcher умеет менять точечно. */
+export type QuerySourcePatchPath = 'kind' | 'request.endpoint' | 'request.path' | 'request.method' | 'request.headers' | 'request.auth' | 'request.timeoutMs' | 'request.formUrlencoded' | 'request.body' | 'props' | 'outputs' | 'mock.enabled' | 'mock.data';
+/** Операция AST-патчинга query source. */
+export interface QuerySourcePatchOperation {
+    /** Изменяемый editor-slot. */
+    path: QuerySourcePatchPath;
+    /** Новое normalized значение, если patcher должен сам напечатать expression. */
+    value?: unknown;
+    /** Готовое source-expression для сложных DSL-значений: env(...), field(...), filter... */
+    expression?: string;
+}
+/** Patch query source: одиночная операция или пачка операций. */
+export type QuerySourcePatch = QuerySourcePatchOperation | QuerySourcePatchOperation[];
+/** Результат компиляции query source. */
+export interface QuerySourceCompileResult {
+    /** AST уровня parser. */
+    ast: unknown | null;
+    /** Canonical authoring-модель. */
+    document: QuerySourceDocument | null;
+    /** Query artifact payload для Endge.program. */
+    artifact: QueryProgramPayload | null;
+    /** Публичная metadata, извлечённая из canonical source. */
+    metadata: ProgramMetadataMap;
+    /** Diagnostics source compiler-а. */
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+}
+export {};

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

@@ -0,0 +1,10 @@
+import { DataViewRef } from './data-view-source.types';
+/** Упорядоченный transform response-output, общий для Query и Vocab. */
+export type ResponseOutputTransform = {
+    kind: 'data-view';
+    ref: DataViewRef;
+} | {
+    kind: 'converter';
+    identity: string;
+    options?: Record<string, unknown>;
+};

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

@@ -0,0 +1,242 @@
+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';
+/** Тип нейтральной source completion без привязки к Monaco или другому editor API. */
+export type SourceLanguageCompletionKind = 'keyword' | 'function' | 'property' | 'value' | 'snippet';
+/** Позиция курсора внутри source-документа. */
+export interface SourceLanguagePosition {
+    /** Номер строки, начиная с 1. */
+    lineNumber: number;
+    /** Номер колонки, начиная с 1. */
+    column: number;
+}
+/** Контекст, который UI/editor adapter передает language strategy. */
+export interface SourceLanguageContext {
+    /** Текущий текст source-документа. */
+    source: string;
+    /** Текущая позиция курсора, если она есть у editor adapter. */
+    position?: SourceLanguagePosition;
+    /** Символы Type Registry на основе Source, доступные этому редактору. */
+    typeSymbols?: Array<{
+        identity: string;
+        displayName?: string;
+        category?: 'primitive' | 'reference' | 'user';
+        definition?: TypeSourceDefinition | null;
+        entityReference?: {
+            target: string;
+            storage: 'id' | 'identity';
+        };
+    }>;
+    /** Каталог установленных определений storage и кода для completions identity. */
+    documentSymbols?: Array<{
+        target: SourceDocumentReferenceTarget;
+        identity: string;
+        displayName?: string;
+        description?: string | null;
+    }>;
+    /** Identity документа, владеющего текущей диагностикой Source. */
+    ownerIdentity?: string;
+    /** Фактические каталоги переводов для всех текущих вхождений Project. */
+    i18n?: SourceLanguageI18nContext;
+}
+/** Одно статически спроецированное вхождение Composition в текущем Project. */
+export interface SourceLanguageI18nOccurrence {
+    id: string;
+    catalogsByScope: Readonly<Record<string, I18nRuntimeCatalog>>;
+    provenanceByScope: Readonly<Record<string, I18nCatalogProvenance>>;
+}
+/** Вход переводов, подготовленный приложением без монтирования Runtime. */
+export interface SourceLanguageI18nContext {
+    locale: string;
+    fallbackLocale: string;
+    occurrences: readonly SourceLanguageI18nOccurrence[];
+}
+/** Нейтральная completion item, которую editor adapter мапит в свой формат. */
+export interface SourceLanguageCompletion {
+    /** Текст, отображаемый в списке подсказок. */
+    label: string;
+    /** Семантический тип подсказки. */
+    kind: SourceLanguageCompletionKind;
+    /** Текст, который нужно вставить. Может быть snippet-ом. */
+    insertText: string;
+    /** Краткое описание справа от completion item. */
+    detail?: string;
+    /** Документация completion item. */
+    documentation?: string;
+}
+export interface SourceLanguageSignatureHelp {
+    activeSignature: number;
+    activeParameter: number;
+    signatures: Array<{
+        label: string;
+        documentation?: string;
+        parameters: Array<{
+            label: string;
+            documentation?: string;
+        }>;
+    }>;
+}
+/** Логический тип внешнего доменного документа, на который ссылается source. */
+export type SourceDocumentReferenceTarget = 'action' | 'auth-profile' | 'component' | 'composition' | 'computation' | 'converter' | 'data-view' | 'filter' | 'i18n-bundles' | 'mock' | 'query' | 'store' | 'stream' | 'update' | 'style' | 'type' | 'vocabs';
+/** Семантическая ссылка из source на внешний доменный документ. */
+export interface SourceDocumentReference {
+    /** Логический тип цели; UI может уточнить concrete document type через domain. */
+    target: SourceDocumentReferenceTarget;
+    /** Persisted identity целевого документа. */
+    identity: string;
+    /** Полуоткрытый диапазон reference-expression в source offsets. */
+    range: {
+        start: number;
+        end: number;
+    };
+}
+/** Нейтральное к renderer семантическое выделение одного диапазона Source. */
+export interface SourceLanguageSemanticHighlight {
+    kind: 'type-reference';
+    status: 'resolved' | 'unresolved';
+    identity: string;
+    range: SourceDocumentReference['range'];
+}
+/** Нейтральная к renderer inline-аннотация после одного диапазона Source. */
+export interface SourceLanguageInlineHint {
+    kind: 'translation';
+    status: 'resolved' | 'ambiguous';
+    text: string;
+    tooltip?: string;
+    range: SourceDocumentReference['range'];
+}
+/** Результат validation source language strategy. */
+export interface SourceLanguageValidationResult extends SourceEngineResult {
+    /** Diagnostics, найденные language strategy. */
+    diagnostics: unknown[];
+}
+/** Минимальная операция source engine. Детальные операции появятся вместе с patch engine. */
+export interface SourceEngineOperation {
+    /** Тип операции, например replace-slot или insert-block. */
+    type: string;
+    /** Дополнительный payload операции. */
+    payload?: Record<string, unknown>;
+}
+/** Базовый результат source operation до внедрения полноценного patch engine. */
+export interface SourceEngineResult {
+    /** Было ли действие обработано стратегией. */
+    ok: boolean;
+    /** Машинное сообщение об ошибке или причине no-op. */
+    message?: string;
+}
+/** Результат генерации source из persisted/legacy модели. */
+export interface SourceEngineGenerateResult extends SourceEngineResult {
+    /** Сгенерированный source-документ. */
+    source?: string;
+    /** Нормализованный source document, если стратегия его построила. */
+    document?: unknown;
+}
+/** Результат компиляции source в normalized document и runtime artifact payload. */
+export interface SourceEngineCompileResult extends SourceEngineResult {
+    /** AST уровня parser. */
+    ast?: unknown;
+    /** Нормализованный source document. */
+    document?: unknown;
+    /** Payload артефакта, готовый для runtime и program. */
+    artifact?: any;
+    /** Публичная metadata, извлечённая из source. */
+    metadata?: import('../../../program/domain/types/program-metadata.types').ProgramMetadataMap;
+    /** Diagnostics, найденные source compiler-ом. */
+    diagnostics?: unknown[];
+    /** Статические зависимости Program, найденные компилятором Source. */
+    dependencies?: import('../../../program/domain/types/program.types').ProgramDependency[];
+}
+/** Результат parse source без обязательной runtime-компиляции. */
+export interface SourceParseResult<TDocument = unknown> extends SourceEngineResult {
+    /** AST уровня parser. */
+    ast?: unknown;
+    /** Нормализованный source document. */
+    document?: TDocument;
+    /** Diagnostics, найденные parser/compiler-ом. */
+    diagnostics?: unknown[];
+}
+/** Результат patch source-документа. */
+export interface SourcePatchResult<TDocument = unknown> extends SourceParseResult<TDocument> {
+    /** Новый source-документ. */
+    source: string;
+    /** Был ли source реально изменен. */
+    changed: boolean;
+}
+/** Strategy source patching для одного source-kind. */
+export interface SourcePatchStrategy<TPatch = unknown, TDocument = unknown> {
+    /** Стабильный id стратегии для debug/плагинов. */
+    id: string;
+    /** Тип source-документа, который обслуживает стратегия. */
+    sourceKind: SourceKind;
+    /** Проверяет, может ли стратегия обслужить переданный source-kind. */
+    supports: (sourceKind: SourceKind | string) => boolean;
+    /** Парсит source в editor-facing normalized document. */
+    parse: (source: string) => SourceParseResult<TDocument>;
+    /** Применяет минимальный patch, сохраняя остальной авторский source. */
+    patch: (source: string, patch: TPatch) => SourcePatchResult<TDocument>;
+}
+/** Strategy source engine для одного source-kind. */
+export interface SourceEngineStrategy {
+    /** Стабильный id стратегии для debug/плагинов. */
+    id: string;
+    /** Тип source-документа, который обслуживает стратегия. */
+    sourceKind: SourceKind;
+    /** Проверяет, может ли стратегия обслужить переданный source-kind. */
+    supports: (sourceKind: SourceKind | string) => boolean;
+    /** Выполняет нейтральную source operation. Пока используется как будущий контракт patch/analyze API. */
+    execute?: (operation: SourceEngineOperation) => SourceEngineResult;
+    /** Генерирует source из persisted/legacy модели. */
+    generate?: (model: unknown) => SourceEngineGenerateResult;
+    /** Компилирует source в normalized document и artifact payload. */
+    compile?: (source: string) => SourceEngineCompileResult;
+}
+/** Нейтральный token pattern source-языка, не завязанный на Monaco API. */
+export interface SourceLanguageTokenPattern {
+    pattern: RegExp;
+    token: string;
+    next?: string;
+}
+/** Editor-facing синтаксис, которым владеет SourceLanguageStrategy. */
+export interface SourceLanguageSyntaxDefinition {
+    aliases: string[];
+    extensions: string[];
+    comments: {
+        lineComment: string;
+        blockComment: [string, string];
+    };
+    brackets: Array<[string, string]>;
+    autoClosingPairs: Array<{
+        open: string;
+        close: string;
+    }>;
+    triggerCharacters: string[];
+    tokenizer: Record<string, SourceLanguageTokenPattern[]>;
+}
+/** Strategy source language для editor-facing операций одного source-kind. */
+export interface SourceLanguageStrategy {
+    /** Стабильный id стратегии для debug/плагинов. */
+    id: string;
+    /** Тип source-документа, который обслуживает стратегия. */
+    sourceKind: SourceKind;
+    /** Проверяет, может ли стратегия обслужить переданный source-kind. */
+    supports: (sourceKind: SourceKind | string) => boolean;
+    /** Описывает подсветку, brackets и editor triggers в adapter-neutral формате. */
+    syntax: SourceLanguageSyntaxDefinition;
+    /** Возвращает базовый source для новой сущности. */
+    createDefaultSource: (variant?: string) => string;
+    /** Нормализует поддержанный syntax, сохраняя остальной авторский source. */
+    normalize?: (source: string) => string;
+    /** Валидирует source без знания о конкретном editor adapter. */
+    validate: (source: string, context?: SourceLanguageContext) => SourceLanguageValidationResult;
+    /** Возвращает доступные подсказки языка в нейтральном формате. */
+    completions: (context: SourceLanguageContext) => SourceLanguageCompletion[];
+    /** Возвращает сведения о сигнатуре вызова в текущей позиции курсора. */
+    signatureHelp?: (context: SourceLanguageContext) => SourceLanguageSignatureHelp | null;
+    /** Возвращает внешнюю document reference под курсором, если язык её поддерживает. */
+    resolveReference?: (context: SourceLanguageContext) => SourceDocumentReference | null;
+    /** Возвращает semantic highlights без привязки к конкретному editor adapter. */
+    semanticHighlights?: (context: SourceLanguageContext) => SourceLanguageSemanticHighlight[];
+    /** Возвращает inline annotations без привязки к конкретному editor adapter. */
+    inlineHints?: (context: SourceLanguageContext) => SourceLanguageInlineHint[];
+}

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

@@ -0,0 +1,113 @@
+import { ProgramMetadataMap } from '../../../program/domain/types/program-metadata.types';
+import { TypeSourceExpression } from './type-source.types';
+/** Identity Type Registry для контрактов полей Query и Filter. */
+export type SourceFieldType = 'String' | 'Number' | 'Boolean' | 'Date' | 'Time' | 'DateTime' | 'Object' | 'Any' | (string & {});
+/** Источник безопасного чтения значения внутри source expression. */
+export type SourceExpressionReadKind = 'env' | 'prop' | 'value' | 'row' | 'response' | 'store' | 'current' | 'scope' | 'composition-output' | 'composition-outputs' | 'composition-data' | 'composition-store' | 'composition-filter-fields' | 'composition-runtime-metadata' | 'metadata' | 'computation-output';
+/** Whitelist операций статического expression IR. */
+export type SourceExpressionOperation = 'merge' | 'compact' | 'get' | 'get-or' | 'has' | 'default-to' | 'pick' | 'omit' | 'defaults' | 'keys' | 'values' | 'entries' | 'map' | 'where' | 'reject' | 'find' | 'some' | 'every' | 'flat-map' | 'flatten' | 'uniq' | 'uniq-by' | 'concat' | 'take' | 'drop' | 'sort-by' | 'group-by' | 'key-by' | 'size' | 'sum' | 'sum-by' | 'min' | 'max' | 'min-by' | 'max-by' | 'trim' | 'lower-case' | 'upper-case' | 'split' | 'join' | 'match' | 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'includes' | 'or' | 'when' | 'not' | 'is-nil' | 'is-empty' | 'and' | 'between' | 'in-list' | 'in-array' | 'relative-date' | 'relative-date-time' | 'left-join' | 'full-join' | 'join-by' | 'join-by-any' | 'join-coalesce' | 'lookup-one' | 'lookup-many' | 'enrich' | 'coalesce' | 'choose' | 'lookup-value' | 'to-string' | 'to-number' | 'to-boolean' | 'type-of' | 'is-string' | 'is-number' | 'is-boolean' | 'is-array' | 'is-object' | 'is-date-time' | 'is-duration' | 'add' | 'subtract' | 'multiply' | 'divide' | 'modulo' | 'abs' | 'negate' | 'round' | 'floor' | 'ceil' | 'clamp' | 'average' | 'average-by' | 'starts-with' | 'ends-with' | 'replace' | 'replace-all' | 'slice' | 'pad-start' | 'pad-end' | 'normalize-whitespace' | 'set' | 'unset' | 'rename' | 'get-key' | 'from-entries' | 'first' | 'last' | 'at' | 'reverse' | 'sort-by-desc' | 'order-by' | 'chunk' | 'union' | 'intersection' | 'difference' | 'count-by' | 'date-time' | 'duration' | 'date-time-add' | 'date-time-subtract' | 'date-time-difference' | 'date-time-start-of' | 'date-time-end-of' | 'date-time-part' | 'duration-add' | 'duration-subtract' | 'duration-total' | 'contains-all' | 'contains-any';
+/**
+ * Безопасное runtime-выражение, полученное из source callback.
+ *
+ * IR не содержит исполняемого JavaScript и вычисляется только штатным evaluator-ом.
+ */
+export type SourceExpressionIR = {
+    type: 'literal';
+    value: unknown;
+} | {
+    type: 'object';
+    properties: Record<string, SourceExpressionIR>;
+} | {
+    type: 'array';
+    items: SourceExpressionIR[];
+} | {
+    type: 'read';
+    source: SourceExpressionReadKind;
+    path: string;
+    parameters?: string[];
+} | {
+    type: 'transform';
+    transform: 'data-view' | 'converter';
+    identity: string;
+    input: SourceExpressionIR;
+    options?: SourceExpressionIR;
+} | {
+    type: 'operation';
+    operation: SourceExpressionOperation;
+    arguments: SourceExpressionIR[];
+};
+/** Статический вариант выбора source-field. */
+export interface SourceFieldOption {
+    value: string | number | boolean;
+    label?: string;
+}
+/** Ссылка source-field на доменный vocab. */
+export interface SourceFieldVocab {
+    identity: string;
+    valuePath: string;
+    labelPath: string;
+}
+/** Общий compiled field contract для Filter и Query props. */
+export interface SourceFieldDefinition {
+    key: string;
+    type: SourceFieldType;
+    /** Точный inline-контракт для objectOf/recordOf; type сохраняет coarse runtime identity. */
+    typeExpression?: TypeSourceExpression;
+    optional: boolean;
+    array: boolean;
+    defaultValue?: SourceExpressionIR;
+    options?: SourceFieldOption[];
+    vocab?: SourceFieldVocab;
+    /** Статическая presentation metadata поля, не влияющая на Filter state. */
+    metadata?: ProgramMetadataMap;
+}
+/** Default value prop, вычисляемый через output внешнего или локального Filter. */
+export type SourceFieldDefaultSource = {
+    kind: 'filter';
+    identity: string;
+    output: string;
+} | {
+    kind: 'inline-filter';
+    source: string;
+    output: string;
+} | {
+    kind: 'local-filter';
+    ref: {
+        entityType: 'filter';
+        id: string | number;
+        identity: string;
+    };
+    output: string;
+};
+/** Query prop на базе общего field contract. */
+export interface QueryProgramProp extends SourceFieldDefinition {
+    defaultSource?: SourceFieldDefaultSource;
+}
+/** Контекст вычисления безопасного source expression. */
+export interface SourceExpressionContext {
+    /** Разрешает чтение env(name), не предоставляя workspace вычислителю. */
+    environment?: (name: string) => unknown;
+    props?: Record<string, unknown>;
+    values?: Record<string, unknown>;
+    row?: unknown;
+    response?: unknown;
+    stores?: Record<string, unknown>;
+    current?: unknown;
+    scope?: unknown;
+    read?: (expression: Extract<SourceExpressionIR, {
+        type: 'read';
+    }>) => unknown;
+    transform?: (expression: Extract<SourceExpressionIR, {
+        type: 'transform';
+    }>, input: unknown, options: unknown) => unknown;
+    onWarning?: (warning: SourceExpressionWarning) => void;
+}
+/** Публичное имя общего декларативного value DSL. */
+export type ValueExpressionIR = SourceExpressionIR;
+export type ValueExpressionContext = SourceExpressionContext;
+/** Runtime warning безопасного expression evaluator. */
+export interface SourceExpressionWarning {
+    code: string;
+    message: string;
+    data?: unknown;
+}

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

@@ -0,0 +1,43 @@
+import { EndgeMockReference } from '../../../mock/domain/types/mock-data.type';
+import { ProgramDiagnostic } from '../../../program/domain/types/program.types';
+import { DataViewRef } from './data-view-source.types';
+import { SourceFieldDefinition } from './source-expression.types';
+export type StoreDataDescriptor = StoreValueDescriptor | StoreDerivedDescriptor;
+export interface StoreValueDescriptor {
+    key: string;
+    kind: 'value';
+    initial: StoreValueInitializer;
+    contract?: SourceFieldDefinition | null;
+}
+export type StoreValueInitializer = {
+    kind: 'literal';
+    value: unknown;
+} | EndgeMockReference;
+export interface StoreDerivedDescriptor {
+    key: string;
+    kind: 'derived';
+    source: string;
+    dataViews: DataViewRef[];
+    materializationStrategy?: import('./data-view-source.types').DataViewMaterializationStrategy;
+    contract?: SourceFieldDefinition | null;
+}
+export interface StoreSourceDocument {
+    data: StoreDataDescriptor[];
+}
+/** Скомпилированная таблица маршрутизации событий к дочерним Update. */
+export interface StoreUpdateHandlerDescriptor {
+    identity: string;
+    eventTypes: string[];
+}
+/** Готовый для runtime артефакт source Store v1. */
+export interface StoreSourceArtifact extends StoreSourceDocument {
+    type: 'store';
+    sourceVersion: number;
+    updateHandlers: StoreUpdateHandlerDescriptor[];
+}
+export interface StoreSourceCompileResult {
+    ast: unknown | null;
+    document: StoreSourceDocument | null;
+    artifact: StoreSourceArtifact | null;
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+}

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

@@ -0,0 +1,40 @@
+import { ProgramDiagnostic } from '../../../program/domain/types/program.types';
+export interface StreamSseTransportDescriptor {
+    kind: 'sse';
+    url: string;
+    withCredentials: boolean;
+    authMode: 'inherit' | 'profile' | 'none';
+    authProfileIdentity: string | null;
+}
+export type StreamTransportDescriptor = StreamSseTransportDescriptor;
+export interface StreamEventDescriptor {
+    sourceEvent: string;
+    type: string | null;
+    typePath: string | null;
+    payloadPath: string | null;
+}
+export interface StreamSourceDocument {
+    transport: StreamTransportDescriptor;
+    events: StreamEventDescriptor[];
+}
+/** Готовый для runtime артефакт Stream. */
+export interface StreamSourceArtifact extends StreamSourceDocument {
+    type: 'stream';
+    sourceVersion: number;
+}
+export interface StreamSourceCompileResult {
+    ast: unknown | null;
+    document: StreamSourceDocument | null;
+    artifact: StreamSourceArtifact | null;
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+}
+export interface StreamEventEnvelope {
+    type: string;
+    payload: unknown;
+    meta: {
+        id: string | null;
+        source: string;
+        sourceEvent: string;
+        occurredAt: string;
+    };
+}