@endge/core 5.0.0 → 7.0.0

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

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

package/dist/features/core/modules/domain/component/sfc/component-sfc-source-parts.d.ts

@@ -0,0 +1,9 @@
+import { RComponentSFCSource_Parts } from '../../types/component/sfc/source.types';
+/** Создает пустые sourceParts для нового компонента. */
+export declare function createEmptySFCSourceParts(): RComponentSFCSource_Parts;
+/** Создает глубокую копию вкладок source без привязки к редакторскому объекту. */
+export declare function cloneSFCSourceParts(parts: RComponentSFCSource_Parts): RComponentSFCSource_Parts;
+/** Сериализует вкладки конфигуратора в полноценный .endge SFC. */
+export declare function serializeSFCSourceParts(parts: RComponentSFCSource_Parts): string;
+/** Разбирает простой SFC-source на вкладки редактора v1. */
+export declare function parseSFCSourceParts(source: string): RComponentSFCSource_Parts;

package/dist/features/core/modules/domain/component/sfc-editing.config.d.ts

@@ -0,0 +1,3 @@
+import { EndgeSFCEditingConfiguration } from '../../configuration/domain/types/configuration.type';
+/** Системные triggers завершения edit session до Workspace cascade. */
+export declare const DEFAULT_ENDGE_SFC_EDITING_CONFIGURATION: Readonly<EndgeSFCEditingConfiguration>;

package/dist/features/core/modules/domain/component/table.d.ts

@@ -0,0 +1,4 @@
+import { ColumnSortConfig } from '../../runtime/domain/table.types';
+export declare function normalizeSortType(v: unknown): string;
+export declare function normalizeSortBy(v: unknown): string;
+export declare function normalizeSortConfig(raw: unknown): ColumnSortConfig | null;

package/dist/features/core/modules/domain/documents/domain-document-descriptors.d.ts

@@ -0,0 +1,102 @@
+import { DocumentSerializationContext } from './service-document-serializer';
+import { DocumentDraftOptions } from '../types/document/document-draft.type';
+import { DomainDocumentType, ComponentType, DomainSectionType, FilterType, ParameterType, QueryType } from '../types/document/document.types';
+import { EndgeDomainCollection } from '../types/document/domain-provider.type';
+import { ProgramEntityType } from '../../program/domain/types/program.types';
+import { RuntimeEntityType } from '../../runtime/domain/runtime-entity-map.types';
+import { SourceKind } from '../../source/domain/types/source-engine.types';
+import { RAction } from '../entities/RAction';
+import { RAuthProfile } from '../entities/RAuthProfile';
+import { RComponentDSL } from '../entities/RComponentDSL';
+import { RComponentSFC } from '../entities/RComponentSFC';
+import { RComponentTable } from '../entities/RComponentTable';
+import { RComposition } from '../entities/RComposition';
+import { RComputation } from '../entities/RComputation';
+import { RConfiguration } from '../entities/RConfiguration';
+import { RConverter } from '../entities/RConverter';
+import { RDataView } from '../entities/RDataView';
+import { REnvironment } from '../entities/REnvironment';
+import { RFilter } from '../entities/RFilter';
+import { RI18nBundle } from '../entities/RI18nBundle';
+import { RIntegration } from '../entities/RIntegration';
+import { RMock } from '../entities/RMock';
+import { RNavigation } from '../entities/RNavigation';
+import { RPage } from '../entities/RPage';
+import { RPageTemplate } from '../entities/RPageTemplate';
+import { RParameter } from '../entities/RParameter';
+import { RPolicy } from '../entities/RPolicy';
+import { RProject } from '../entities/RProject';
+import { RQuery } from '../entities/RQuery';
+import { RStore } from '../entities/RStore';
+import { RStream } from '../entities/RStream';
+import { RStyle } from '../entities/RStyle';
+import { RTenant } from '../entities/RTenant';
+import { RType } from '../entities/RType';
+import { RUpdate } from '../entities/RUpdate';
+import { RVocabs } from '../entities/RVocabs';
+import { RWorkspace } from '../entities/RWorkspace';
+export type DomainCollectionKey = 'projects' | 'types' | 'queries' | 'dataViews' | 'compositions' | 'stores' | 'streams' | 'updates' | 'mocks' | 'componentSFCs' | 'actions' | 'filters' | 'converters' | 'computations' | 'environments' | 'tenants' | 'styles' | 'configurations' | 'vocabs' | 'authProfiles' | 'i18nBundles' | 'navigations';
+/** Точное соответствие document type конкретной Domain-модели. */
+export interface DomainDocumentModelMap {
+    'primitive': RType;
+    'type': RType;
+    'action': RAction;
+    'converter': RConverter;
+    'computation': RComputation;
+    'data-view': RDataView;
+    'composition': RComposition;
+    'store': RStore;
+    'stream': RStream;
+    'update': RUpdate;
+    'mock': RMock;
+    'integration': RIntegration;
+    'page-template': RPageTemplate;
+    'page': RPage;
+    'navigation': RNavigation;
+    'environment': REnvironment;
+    'policy': RPolicy;
+    'style': RStyle;
+    'configuration': RConfiguration;
+    'vocabs': RVocabs;
+    'i18n-bundles': RI18nBundle;
+    'auth-profile': RAuthProfile;
+    'tenant': RTenant;
+    'project': RProject;
+    'workspace': RWorkspace;
+    [ComponentType.DSL]: RComponentDSL;
+    [ComponentType.Table]: RComponentTable;
+    [ComponentType.SFC]: RComponentSFC;
+    [QueryType.Custom]: RQuery;
+    [QueryType.GraphQL]: RQuery;
+    [QueryType.REST]: RQuery;
+    [ParameterType.DefaultParameter]: RParameter;
+    [FilterType.DefaultFilter]: RFilter;
+}
+export interface DomainDocumentCapabilityMetadata {
+    source: SourceKind | 'component-sfc' | null;
+    program: ProgramEntityType | null;
+    runtime: RuntimeEntityType | null;
+}
+export interface DomainDocumentPersistenceDescriptor {
+    collection: EndgeDomainCollection;
+    serialize: (source: unknown, context: DocumentSerializationContext) => Record<string, unknown>;
+}
+export interface DomainDocumentDescriptor<TType extends DomainDocumentType = DomainDocumentType> {
+    type: TType;
+    section: DomainSectionType;
+    domainCollection: DomainCollectionKey | null;
+    materialize: (source: Record<string, unknown>) => DomainDocumentModelMap[TType];
+    createNew: ((options: DocumentDraftOptions) => DomainDocumentModelMap[TType]) | null;
+    structuralValidationOwner: 'entity';
+    persistence: DomainDocumentPersistenceDescriptor | null;
+    capabilities: DomainDocumentCapabilityMetadata;
+}
+type DescriptorMap = {
+    [TType in DomainDocumentType]: DomainDocumentDescriptor<TType>;
+};
+export declare const DOMAIN_DOCUMENT_DESCRIPTORS: DescriptorMap;
+/** Возвращает канонический descriptor конкретного document type. */
+export declare function getDomainDocumentDescriptor<TType extends DomainDocumentType>(type: TType): DomainDocumentDescriptor<TType>;
+/** Создаёт новый Domain-документ через канонический descriptor. */
+export declare function createNewDomainDocument<TType extends DomainDocumentType>(type: TType, options: DocumentDraftOptions): DomainDocumentModelMap[TType];
+export {};

package/dist/features/core/modules/domain/documents/service-document-serializer.d.ts

@@ -0,0 +1,11 @@
+import { DomainDocumentType } from '../types/document/document.types';
+/** Явные Domain lookup-зависимости чистой сериализации persisted-документа. */
+export interface DocumentSerializationContext {
+    resolveFolderIdentity: (value: string | number) => string | null;
+    resolveNavigationIdentity: (value: string | number) => string | null;
+    resolveEnvironmentIdentity: (value: string | number) => string | null;
+}
+/** Преобразует persisted-модель Core в строгий write DTO service-backend. */
+export declare function serializeServiceDocument(documentType: DomainDocumentType, source: unknown, context: DocumentSerializationContext): Record<string, unknown>;
+/** Преобразует RFolder в write DTO service-backend. */
+export declare function serializeServiceFolder(source: unknown, context: Pick<DocumentSerializationContext, 'resolveFolderIdentity'>): Record<string, unknown>;

package/dist/features/core/modules/domain/entities/RAction.d.ts

@@ -0,0 +1,20 @@
+import { ActionImplementation, ActionTargetSelector } from '../../actions/domain/action.types';
+import { DuplicateOptions, REntity } from './REntity';
+import { EntityRef } from '../types/document/entity-management.type';
+/** Каноническое определение Action на основе Source. Исполняемый код предоставляет провайдер. */
+export declare class RAction extends REntity {
+    displayName: string;
+    description: string | null;
+    source: string;
+    sourceVersion: number;
+    target: ActionTargetSelector[] | null;
+    contract: {
+        input: unknown | null;
+        output: unknown | null;
+    };
+    defaultImplementation: ActionImplementation;
+    owner?: EntityRef;
+    static fromPlain(json: any, storageMeta?: any): RAction;
+    toPlain(): Record<string, unknown>;
+    duplicate(options: DuplicateOptions): RAction;
+}

package/dist/features/core/modules/domain/entities/RAuthProfile.d.ts

@@ -0,0 +1,14 @@
+import { AuthProfileAdapterId, AuthProfileConfig, AuthProfileCredentials, AuthSessionPolicy } from '../../auth/domain/types/auth-profile.types';
+import { DuplicateOptions, REntity } from './REntity';
+export declare class RAuthProfile extends REntity {
+    displayName: string;
+    description: string | null;
+    adapterId: AuthProfileAdapterId;
+    config: AuthProfileConfig;
+    credentials: AuthProfileCredentials;
+    session: AuthSessionPolicy | undefined;
+    active: boolean;
+    static fromPlain(raw: any): RAuthProfile;
+    toPlain(): Record<string, unknown>;
+    duplicate(options: DuplicateOptions): RAuthProfile;
+}

package/dist/features/core/modules/domain/entities/RComponent.d.ts

@@ -0,0 +1,25 @@
+import { DuplicateOptions } from './REntity';
+import { RComponent } from '../types/component/component.types';
+/**
+ * Создает экземпляр ComponentModel из JSON-объекта.
+ * Ожидается, что JSON имеет следующие поля:
+ *  - name: строка
+ *  - type: строка
+ *  - template: строка с HTML-шаблоном (например, "<div>{{var1}}</div>")
+ *  - "vars-shapes": массив объектов вида { var: string, shape: { ... } }
+ *  - input: объект, описывающий входной тип
+ *
+ * @param json JSON-объект с описанием компонента.
+ * @returns Новый экземпляр ComponentModel.
+ */
+export declare function ReflectComponentFromPlain(json: Record<string, any>): RComponent | null;
+export declare function ReflectComponentToPlain(component: RComponent): Record<string, any> | null;
+/**
+ * Полная копия компонента с новым identity и именем (в корне).
+ * Сохраняет всю внутреннюю структуру (колонки таблицы, DSL и т.д.).
+ */
+export declare function duplicateComponent(component: RComponent, options: DuplicateOptions): RComponent;
+/**
+ * Строит объект для PATCH/POST компонента в Payload (flat-поля, без использования schema).
+ */
+export declare function ReflectComponentToPayloadData(component: RComponent, componentIdentityToId: Map<string, number>, converterIdentityToId: Map<string, number>): Record<string, any>;

package/dist/features/core/modules/domain/entities/RComponentBase.d.ts

@@ -0,0 +1,18 @@
+import { ComponentType } from '../types/document/document.types';
+import { REntity } from './REntity';
+import { RField } from './RField';
+import { ComponentKind } from '../types/component/component.types';
+/**
+ * Архивная persisted-модель legacy-компонента.
+ *
+ * Класс хранит только поля документа. Legacy compile/runtime/render pipeline
+ * удалён; исполнение поддерживается только для source-first компонентов.
+ */
+export declare class RComponentBase extends REntity {
+    kind: ComponentKind;
+    type: ComponentType;
+    inputFields: Record<string, RField>;
+    /** Сохранённый legacy source настройки. Он хранится только для просмотра. */
+    setupScript: string;
+    runtimeFilters: string[];
+}

package/dist/features/core/modules/domain/entities/RComponentCore.d.ts

@@ -0,0 +1,26 @@
+import { DuplicateOptions, REntity } from './REntity';
+import { RComponentRenderTarget, RComponentSourceKind } from '../types/component/component-core.types';
+/**
+ * Чистая базовая модель компонента нового поколения.
+ *
+ * В этом классе хранятся только persisted-поля документа. Runtime-состояние,
+ * диагностика, AST и IR живут в ComponentSFCRuntimeHost.
+ */
+export declare abstract class RComponentCore extends REntity {
+    /** Внутренний маркер новой ветки компонентов. */
+    kind: string;
+    /** Формат source, из которого построен компонент. */
+    sourceKind: RComponentSourceKind;
+    /** Версия схемы новой модели компонента. */
+    modelVersion: number;
+    /** Список целей рендера, которые компонент потенциально поддерживает. */
+    supportedTargets: RComponentRenderTarget[];
+    /** Возвращает canonical source компонента. */
+    abstract getSource(): string;
+    /** Проверяет, заявлена ли поддержка конкретной цели рендера. */
+    supportsTarget(target: RComponentRenderTarget): boolean;
+    /** Создает базовую копию полей, общих для всех новых компонентов. */
+    protected copyCoreFieldsTo(target: RComponentCore): void;
+    /** Базовый класс не знает, как копировать конкретный source наследника. */
+    duplicate(_options: DuplicateOptions): RComponentCore;
+}

package/dist/features/core/modules/domain/entities/RComponentSFC.d.ts

@@ -0,0 +1,33 @@
+import { DuplicateOptions } from './REntity';
+import { RComponentSFCSource_Parts } from '../types/component/sfc/source.types';
+import { RComponentCore } from './RComponentCore';
+import { ComponentType } from '../types/document/document.types';
+/**
+ * Новый SFC-компонент Endge.
+ *
+ * Это persisted source-first модель. Она не содержит runtime-представления:
+ * sourceParts, diagnostics, AST и IR вычисляются runtime-host.
+ */
+export declare class RComponentSFC extends RComponentCore {
+    /** Внутренний маркер SFC-компонента новой ветки. */
+    kind: string;
+    /** Тип доменного документа и Payload documentType. */
+    type: ComponentType.SFC;
+    /** Canonical .endge source: script/template/style в одном тексте. */
+    source: string;
+    /** Опциональный пользовательский tag для прямого вызова компонента из SFC template. */
+    tag: string | null;
+    constructor();
+    /** Возвращает canonical source компонента. */
+    getSource(): string;
+    /** Обновляет canonical source без изменения runtime-derived состояния. */
+    setSource(source: string): void;
+    /** Собирает persisted source из вкладок редактора. */
+    setSourceParts(parts: RComponentSFCSource_Parts): void;
+    /** Создает копию SFC-компонента как новый доменный документ. */
+    duplicate(options: DuplicateOptions): RComponentSFC;
+    /** Возвращает plain-форму для domain dump/export. */
+    toPlain(): Record<string, unknown>;
+    /** Восстанавливает SFC-компонент из plain schema или Payload-normalized объекта. */
+    static fromPlain(raw: any): RComponentSFC;
+}

package/dist/features/core/modules/domain/entities/RComponentTable.d.ts

@@ -0,0 +1,14 @@
+import { RComponentTableColumn } from './RComponentTableColumn';
+import { TableBinding } from '../../runtime/domain/table-binding.types';
+import { RComponentBase } from './RComponentBase';
+/** Архивный table-документ без compile/runtime поведения. */
+export declare class RComponentTable extends RComponentBase {
+    /** Полная сохранённая структура колонок. */
+    columns: RComponentTableColumn[];
+    /** Поле inputFields, содержащее строки таблицы. */
+    sourceIndex: string;
+    /** Persisted key bindings старой таблицы. */
+    bindings: TableBinding;
+    /** Сохранённая высота строки. */
+    rowSize: string | number | 'zoom';
+}

package/dist/features/core/modules/domain/entities/RComponentTableColumn.d.ts

@@ -0,0 +1,60 @@
+import { Constructor } from '@endge/utils';
+import { ColumnComponentType } from '../types/component/component.types';
+import { EndgeEventBinding } from '../../events/domain/events.types';
+import { ColumnSortConfig } from '../../runtime/domain/table.types';
+export declare class ReflectComponentTableColumnBase {
+    id: string;
+    isActive: boolean;
+    title: string;
+    type: ColumnComponentType;
+    dataPaths: Record<string, string>;
+    dataConverters: Record<string, string>;
+    width: number;
+    pin: 'left' | 'right' | 'none';
+    sort: ColumnSortConfig | null;
+    /**
+     * Конфигурация отчетов.
+     *
+     * - null/undefined/{} => "по умолчанию": все dataPaths включены, форматирование базовое
+     * - либо объект по ключам dataPaths:
+     *
+     * reports: {
+     *   data: {
+     *     enabled: true,
+     *     formatter: { type: 'DateTime', format: 'DD/MM/YYYY' }
+     *   }
+     * }
+     */
+    reports: Record<string, {
+        enabled?: boolean;
+        formatter?: {
+            type?: string;
+            format?: string;
+        };
+    }> | null;
+    eventBindings: EndgeEventBinding[];
+    toPlain(): Record<string, any>;
+    fromPlain(json: Record<string, any>): void;
+}
+export declare class ReflectComponentTableColumnHtml extends ReflectComponentTableColumnBase {
+    template: string | null;
+    toPlain(): Record<string, any>;
+    fromPlain(json: Record<string, any>): void;
+}
+export declare class ReflectComponentTableColumnComponent extends ReflectComponentTableColumnBase {
+    componentId: number | null;
+    toPlain(): Record<string, any>;
+    fromPlain(json: Record<string, any>): void;
+}
+export type RComponentTableColumn = ReflectComponentTableColumnHtml | ReflectComponentTableColumnComponent;
+/**
+ * Маппер типов
+ */
+export declare const ColumnTypeMap: Record<ColumnComponentType, Constructor<RComponentTableColumn>>;
+/**
+ * Безопасный конструктор для типа.
+ * Возвращает конструктор колонки в зависимости от типа.
+ */
+export declare function RComponentTableColumn_TypeCtor(type: ColumnComponentType): Constructor<RComponentTableColumn> | null;
+export declare function RComponentTableColumn_isComponent(column: RComponentTableColumn): column is ReflectComponentTableColumnComponent;
+export declare function RComponentTableColumn_isHtml(column: RComponentTableColumn): column is ReflectComponentTableColumnHtml;

package/dist/features/core/modules/domain/entities/RComputation.d.ts

@@ -0,0 +1,15 @@
+import { DiagnosticsProblemInput } from '../../diagnostics/domain/types/diagnostics.types';
+import { DuplicateOptions, REntity } from './REntity';
+/** Сохранённая исполняемая спецификация. Runtime-выполнение предоставляется отдельно. */
+export declare class RComputation extends REntity {
+    displayName: string;
+    description: string | null;
+    source: string;
+    sourceVersion: number;
+    contractVersion: number;
+    static fromPlain(json: any, storageMeta?: any): RComputation;
+    toPlain(): Record<string, unknown>;
+    /** Возвращает validation problems computation без mutable entity state. */
+    getDiagnosticProblems(): DiagnosticsProblemInput[];
+    duplicate(options: DuplicateOptions): RComputation;
+}

package/dist/features/core/modules/domain/entities/RConfiguration.d.ts

@@ -0,0 +1,11 @@
+import { DuplicateOptions, REntity } from './REntity';
+/** Принадлежащий Workspace Source-документ, объявляющий одну категорию настроек. */
+export declare class RConfiguration extends REntity {
+    readonly type: "configuration";
+    description: string | null;
+    source: string;
+    sourceVersion: number;
+    static fromPlain(json: any, storageMeta?: any): RConfiguration;
+    toPlain(): Record<string, unknown>;
+    duplicate(options: DuplicateOptions): RConfiguration;
+}

package/dist/features/core/modules/domain/entities/RConverter.d.ts

@@ -0,0 +1,15 @@
+import { EntityManagement } from '../types/document/entity-management.type';
+import { REntity } from './REntity';
+export interface RConverterSchema extends EntityManagement {
+    id: number;
+    name: string;
+    description?: string | null;
+    meta: Record<string, unknown>;
+}
+export declare class RConverter extends REntity {
+    description: string | null;
+    customHandler: ((v: any, options?: Record<string, unknown>) => any) | undefined;
+    setCustom(fn: ((v: any, options?: Record<string, unknown>) => any) | undefined): void;
+    convert(v: any, options?: Record<string, unknown>): any;
+    toPlain(): RConverterSchema;
+}

package/dist/features/core/modules/domain/entities/REntity.d.ts

@@ -0,0 +1,49 @@
+import { DiagnosticsProblemInput } from '../../diagnostics/domain/types/diagnostics.types';
+import { EntityManagement, EntityOrigin, ManagedBy } from '../types/document/entity-management.type';
+/** Опции для дублирования сущности: новый identity и опционально имя. */
+export interface DuplicateOptions {
+    identity: string;
+    name?: string;
+}
+/** Нормализует произвольную metadata документа и разрывает ссылку на transport object. */
+export declare function normalizeEntityMeta(value: unknown): Record<string, unknown>;
+export declare class REntity<TId extends string | number = number> {
+    /** Идентификатор в storage (Payload: number, plain: string | number) */
+    id: TId;
+    identity: string;
+    /** Человекочитаемое имя документа */
+    displayName: string;
+    name: string;
+    description: string | null;
+    /** Id папки, в которой расположен документ (связь по id). */
+    folderId?: string | number | null;
+    /** Кто управляет жизненным циклом документа. */
+    managedBy: ManagedBy;
+    /** Источник effective entity; только storage-сущности сохраняются и экспортируются. */
+    origin: EntityOrigin;
+    /** Opaque installation ID; используется только для integration-managed документов. */
+    managedById: string | null;
+    /** Временная сущность runtime/editor, не должна отображаться как обычный документ домена. */
+    isTemporary: boolean;
+    /** Произвольные метаданные (из Payload meta, по умолчанию {}). */
+    meta: Record<string, unknown>;
+    createdAt?: string;
+    updatedAt?: string;
+    deletedAt?: string | null;
+    author?: string | null;
+    active?: boolean | null;
+    /** Применяет общий meta-контракт к transport/plain документу. */
+    applyEntityMeta(raw: unknown): void;
+    /** Подмешивает storage-мета и meta из Payload. */
+    applyStorageMeta(raw: any): void;
+    applyManagement(raw: EntityManagement | Record<string, unknown> | null | undefined): void;
+    /** Возвращает текущие validation problems без сохранения mutable state в сущности. */
+    getDiagnosticProblems(): DiagnosticsProblemInput[];
+    /** Выполняет legacy compile hook без хранения validation state в сущности. */
+    compile(): void;
+    /**
+     * Возвращает полную копию сущности с новым identity и именем (в корне, folderId = null).
+     * Переопределяется в наследниках для корректного глубокого копирования структуры.
+     */
+    duplicate(_options: DuplicateOptions): REntity;
+}

package/dist/features/core/modules/domain/entities/REnvironment.d.ts

@@ -0,0 +1,9 @@
+import { EndgeConfigurationContribution } from '../../configuration/domain/types/configuration.type';
+import { DuplicateOptions, REntity } from './REntity';
+/** Сущность окружения (коллекция environments). Без привязки к проекту. */
+export declare class REnvironment extends REntity {
+    configuration: EndgeConfigurationContribution;
+    static fromPlain(input: Record<string, unknown>): REnvironment;
+    toPlain(): Record<string, unknown>;
+    duplicate(options: DuplicateOptions): REnvironment;
+}

package/dist/features/core/modules/domain/entities/RFilter.d.ts

@@ -0,0 +1,13 @@
+import { DomainDocumentType } from '../types/document/document.types';
+import { FilterFieldItemSchema, RFilterSchema } from '../types/document/filter.types';
+import { REntity } from './REntity';
+export declare class RFilter extends REntity {
+    fields: FilterFieldItemSchema[];
+    /** Независимый source-first контракт нового Filter runtime. */
+    source: string;
+    /** Версия Filter source syntax. */
+    sourceVersion: number;
+    get type(): DomainDocumentType;
+    static fromPlain(json: RFilterSchema): RFilter;
+    toPlain(): RFilterSchema;
+}

package/dist/features/core/modules/domain/entities/RFolder.d.ts

@@ -0,0 +1,19 @@
+import { REntity } from './REntity';
+/**
+ * Доменная сущность для папок (folders).
+ *
+ * Может быть создана:
+ *  - из payload-формата (с полями id, identity, displayName...)
+ *  - из plain-domain-формата (schema)
+ */
+export declare class RFolder extends REntity {
+    /** Тип сущностей, для которых предназначена папка (canonical collection slug). */
+    entityType: string | null;
+    /** Id родительской папки (null если корень). */
+    parent: string | number | null;
+    /** Загружает папку из plain-schema (schema.toPlain()) */
+    static fromPlain(json: any): RFolder;
+    /** Экспорт только схемы (parent уже id в plain). */
+    toPlain(): any;
+    compile(): void;
+}

package/dist/features/core/modules/domain/entities/RI18nBundle.d.ts

@@ -0,0 +1,16 @@
+import { DiagnosticsProblemInput } from '../../diagnostics/domain/types/diagnostics.types';
+import { DuplicateOptions, REntity } from './REntity';
+/** Дерево сообщений по локали (формат vue-i18n). */
+export type RI18nBundleLocales = Record<string, Record<string, unknown>>;
+/** Сущность словаря переводов (коллекция i18n-bundles). Один документ = словарь с несколькими локалями. */
+export declare class RI18nBundle extends REntity {
+    description: string | null;
+    /** По коду локали (ru, en) — дерево ключ-значение. */
+    locales: RI18nBundleLocales;
+    active: boolean;
+    static fromPlain(json: any): RI18nBundle;
+    toPlain(): Record<string, unknown>;
+    /** Возвращает validation problems i18n bundle без mutable entity state. */
+    getDiagnosticProblems(): DiagnosticsProblemInput[];
+    duplicate(options: DuplicateOptions): RI18nBundle;
+}

package/dist/features/core/modules/domain/entities/RIntegration.d.ts

@@ -0,0 +1,15 @@
+import { DuplicateOptions, REntity } from './REntity';
+import { EntityManagement } from '../types/document/entity-management.type';
+export interface RIntegrationSchema extends EntityManagement {
+    id: string | number;
+    identity: string;
+    name: string;
+    description?: string | null;
+    meta: Record<string, unknown>;
+}
+/** Сущность интеграции (коллекция integrations). */
+export declare class RIntegration extends REntity {
+    description: string | null;
+    toPlain(): RIntegrationSchema;
+    duplicate(options: DuplicateOptions): RIntegration;
+}

package/dist/features/core/modules/domain/entities/RMock.d.ts

@@ -0,0 +1,20 @@
+import { DiagnosticsProblemInput } from '../../diagnostics/domain/types/diagnostics.types';
+import { DuplicateOptions, REntity } from './REntity';
+import { RMockContentSource, RMockContentType } from '../../mock/domain/types/mock-data.type';
+/** Сохранённый source-first документ mock. */
+export declare class RMock extends REntity {
+    displayName: string;
+    description: string | null;
+    contentSource: RMockContentSource;
+    contentType: RMockContentType;
+    source: string;
+    codeRef: string | null;
+    /** Создает доменную модель из portable plain source. */
+    static fromPlain(json: any, storageMeta?: any): RMock;
+    /** Возвращает portable persisted representation. */
+    toPlain(): Record<string, unknown>;
+    /** Возвращает validation problems mock-документа без mutable entity state. */
+    getDiagnosticProblems(): DiagnosticsProblemInput[];
+    /** Создает копию документа с новым identity. */
+    duplicate(options: DuplicateOptions): RMock;
+}

package/dist/features/core/modules/domain/entities/RNavigation.d.ts

@@ -0,0 +1,23 @@
+import { DuplicateOptions, REntity } from './REntity';
+import { DomainDocumentType } from '../types/document/document.types';
+import { EntityManagement } from '../types/document/entity-management.type';
+import { NavigationTreeNodeDoc } from '../types/document/navigation.types';
+export interface RNavigationSchema extends EntityManagement {
+    id: string | number;
+    identity: string;
+    name: string;
+    displayName?: string;
+    description?: string | null;
+    folderId?: string | number | null;
+    tree?: NavigationTreeNodeDoc[];
+    meta?: Record<string, unknown>;
+}
+/** Навигация (коллекция navigations). */
+export declare class RNavigation extends REntity {
+    description: string | null;
+    tree: NavigationTreeNodeDoc[];
+    /** Тип документа для редактора/инспектора. */
+    get type(): DomainDocumentType;
+    toPlain(): RNavigationSchema;
+    duplicate(options: DuplicateOptions): RNavigation;
+}