@endge/core 1.2.5

package/dist/domain/types/faceted-cascade.d.ts

@@ -0,0 +1,300 @@
+import { EndgeBindingMode, EndgeResolvedOverrideBase } from './resolve.types';
+import { ConfigurationContract } from './configuration-contract.types';
+/**
+ * Тип facet-слоя, в котором работает override-специфика.
+ * Behavior отвечает за подмену поведения, Presentation - за подмену представления,
+ * Configuration - за подмену и наблюдение конфигурационных полей.
+ */
+export declare enum EndgeFacetType {
+    Behavior = "behavior",
+    Presentation = "presentation",
+    Configuration = "configuration"
+}
+/**
+ * Базовый набор сущностей, поддерживающих faceted cascade.
+ * Это общие entity type для behavior- и presentation-контрактов.
+ */
+export declare enum FacetedCascadeEntityType {
+    Project = "project",
+    View = "view",
+    Component = "component",
+    Query = "query",
+    Page = "page",
+    PageTemplate = "page-template"
+}
+/**
+ * Область действия override-контракта.
+ * Owner - слот относится к самой сущности.
+ * Target - слот относится к дочерней/связанной сущности.
+ * Global - слот описывает глобальную точку расширения.
+ */
+export declare enum FacetedCascadeScope {
+    Owner = "owner",
+    Target = "target",
+    Global = "global"
+}
+/**
+ * Упрощённая схема полезной нагрузки или контекста для контракта.
+ */
+export type FacetedCascadeSchema = Record<string, unknown>;
+/**
+ * Общая база для всех override-контрактов.
+ * Контракт описывает допустимый слот подмены, но сам по себе не хранит правило override.
+ */
+export interface FacetedCascadeContractBase<TEntity extends string = string> {
+    /**
+     * Facet-слой, к которому относится слот подмены.
+     */
+    facet: EndgeFacetType;
+    /**
+     * Тип сущности, для которой открыт слот подмены.
+     */
+    entityType: TEntity;
+    /**
+     * Короткое имя слота для UI и документации.
+     */
+    title: string;
+    /**
+     * Человекочитаемое описание назначения слота.
+     */
+    description?: string | null;
+    /**
+     * Область действия слота в каскаде.
+     */
+    scope: FacetedCascadeScope;
+    /**
+     * Разрешено ли пользователю создавать override/binding для этого слота.
+     * Для совместимости со старой behavior-моделью поле оставлено общим и опциональным.
+     */
+    supportsBinding?: boolean;
+    /**
+     * Можно ли переопределять слот по environment.
+     */
+    supportsEnvironmentOverride: boolean;
+}
+/**
+ * Семантическая категория behavior-слота.
+ * Нужна для группировки событий и навигации в конфигураторе.
+ */
+export declare enum BehaviorContractKind {
+    Lifecycle = "lifecycle",
+    Interaction = "interaction",
+    Data = "data",
+    Composition = "composition"
+}
+/**
+ * Контракт behavior-слота.
+ * Описывает событие, на которое сущность или контекст могут подменять поведение.
+ */
+export interface BehaviorContract<TEntity extends string = string> extends FacetedCascadeContractBase<TEntity> {
+    facet: EndgeFacetType.Behavior;
+    /**
+     * Каноническое имя события, используемое как selector в behavior cascade.
+     */
+    eventName: string;
+    /**
+     * Категория события.
+     */
+    eventKind: BehaviorContractKind;
+    /**
+     * Схема payload события, если она нужна для UI и валидации.
+     */
+    payloadSchema?: FacetedCascadeSchema | null;
+    /**
+     * Схема дополнительного runtime-контекста события.
+     */
+    contextSchema?: FacetedCascadeSchema | null;
+}
+/**
+ * Семантическая категория presentation-слота.
+ * Нужна для группировки ролей представления в конфигураторе.
+ */
+export declare enum PresentationContractKind {
+    Renderer = "renderer",
+    Layout = "layout",
+    Asset = "asset",
+    State = "state",
+    Composition = "composition"
+}
+/**
+ * Контракт presentation-слота.
+ * Описывает роль представления, для которой можно подменять renderer, layout, asset или state-specific UI.
+ */
+export interface PresentationContract<TEntity extends string = string> extends FacetedCascadeContractBase<TEntity> {
+    facet: EndgeFacetType.Presentation;
+    /**
+     * Каноническая роль представления, используемая как selector в presentation cascade.
+     */
+    role: string;
+    /**
+     * Категория presentation-слота.
+     */
+    contractKind: PresentationContractKind;
+    /**
+     * Схема props/контекста, которыми может оперировать presentation-слот.
+     */
+    propsSchema?: FacetedCascadeSchema | null;
+    /**
+     * Схема дополнительного контекста разрешения presentation-слота.
+     */
+    contextSchema?: FacetedCascadeSchema | null;
+}
+/**
+ * Общий union контрактов faceted cascade.
+ * Реестр контрактов хранит все три типа одновременно и различает их по `facet`.
+ */
+export type EndgeContract<TEntity extends string = string> = BehaviorContract<TEntity> | PresentationContract<TEntity> | ConfigurationContract<TEntity>;
+/**
+ * Совместимые aliases для существующего behavior/event-слоя.
+ * Пока behavior bindings ещё опираются на термин "event contract".
+ */
+export type EventContract = BehaviorContract<FacetedCascadeEntityType>;
+export type EventContractSchema = FacetedCascadeSchema;
+export { FacetedCascadeEntityType as EventContractEntityType, BehaviorContractKind as EventContractKind, FacetedCascadeScope as EventContractScope, };
+/**
+ * Общая база документа override-binding для обоих facet-слоёв.
+ * Binding хранит уже конкретное правило подмены в рамках каскада.
+ */
+export interface FacetedCascadeBindingDocBase {
+    id: number;
+    identity: string;
+    displayName: string;
+    projectId?: number | null;
+    ownerType: string;
+    ownerId: number;
+    targetType: string;
+    targetId?: number | null;
+    mode: EndgeBindingMode;
+    priority: number;
+    isEnabled: boolean;
+    environmentId?: number | null;
+    isInherited?: boolean;
+    originBindingId?: number | null;
+    folder?: number | null;
+}
+/**
+ * База payload для создания/обновления override-binding.
+ */
+export interface FacetedCascadeBindingWriteDataBase {
+    identity: string;
+    displayName: string;
+    projectId?: number | null;
+    ownerType: string;
+    ownerId: number;
+    targetType: string;
+    targetId?: number | null;
+    mode: EndgeBindingMode;
+    priority: number;
+    isEnabled: boolean;
+    environmentId?: number | null;
+    isInherited?: boolean;
+    originBindingId?: number | null;
+    folder?: number | null;
+}
+/**
+ * Общие параметры резолва override-binding.
+ */
+export interface FacetedCascadeBindingResolverOptions {
+    ownerType: string;
+    ownerId: number;
+    targetType?: string | null;
+    targetId?: number | null;
+    environmentId?: number | null;
+}
+/**
+ * База resolved-override результата после применения каскада.
+ */
+export type FacetedCascadeResolvedBindingBase = EndgeResolvedOverrideBase;
+/**
+ * Конкретное правило подмены поведения.
+ */
+export interface BehaviorBindingDoc extends FacetedCascadeBindingDocBase {
+    targetId: number;
+    eventName: string;
+    scriptRef: string;
+}
+/**
+ * Payload для записи behavior-binding.
+ */
+export interface BehaviorBindingWriteData extends FacetedCascadeBindingWriteDataBase {
+    targetId: number;
+    eventName: string;
+    scriptRef: string;
+}
+/**
+ * Параметры резолва behavior-binding для конкретного события.
+ */
+export interface BehaviorBindingResolverOptions extends FacetedCascadeBindingResolverOptions {
+    eventName?: string | null;
+}
+/**
+ * Итоговый resolved behavior-binding после применения каскада.
+ */
+export interface ResolvedBehaviorBinding extends FacetedCascadeResolvedBindingBase {
+    eventName: string;
+    scriptRef: string;
+}
+/**
+ * Конкретное правило подмены представления.
+ */
+export interface PresentationBindingDoc extends FacetedCascadeBindingDocBase {
+    role: string;
+    rendererRef: string;
+    when?: string | null;
+}
+/**
+ * Payload для записи presentation-binding.
+ */
+export interface PresentationBindingWriteData extends FacetedCascadeBindingWriteDataBase {
+    role: string;
+    rendererRef: string;
+    when?: string | null;
+}
+/**
+ * Параметры резолва presentation-binding для конкретной роли.
+ */
+export interface PresentationBindingResolverOptions extends FacetedCascadeBindingResolverOptions {
+    role?: string | null;
+}
+/**
+ * Итоговый resolved presentation-binding после применения каскада.
+ */
+export interface ResolvedPresentationBinding extends FacetedCascadeResolvedBindingBase {
+    role: string;
+    rendererRef: string;
+    when: string | null;
+}
+/**
+ * Результат резолва behavior-контракта: найденные биндинги и метаданные запроса.
+ */
+export interface BehaviorResolveResult {
+    /** Параметры, с которыми выполнялся резолв. */
+    request: BehaviorBindingResolverOptions;
+    /** Событие (selector), по которому искали. */
+    eventName: string;
+    /** Найденные биндинги после каскада. */
+    bindings: ResolvedBehaviorBinding[];
+    /** Найден ли хотя бы один биндинг. */
+    found: boolean;
+    /** Количество найденных биндингов. */
+    count: number;
+    /** Фасет для единообразия с presentation. */
+    facet: 'behavior';
+}
+/**
+ * Результат резолва presentation-контракта: найденные биндинги и метаданные запроса.
+ */
+export interface PresentationResolveResult {
+    /** Параметры, с которыми выполнялся резолв. */
+    request: PresentationBindingResolverOptions;
+    /** Роль (selector), по которой искали. */
+    role: string;
+    /** Найденные биндинги после каскада. */
+    bindings: ResolvedPresentationBinding[];
+    /** Найден ли хотя бы один биндинг. */
+    found: boolean;
+    /** Количество найденных биндингов. */
+    count: number;
+    /** Фасет для единообразия с behavior. */
+    facet: 'presentation';
+}

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

@@ -0,0 +1,39 @@
+/** Опция статического списка поля фильтра. */
+export interface FilterStaticOptionSchema {
+    value: string;
+    label?: string;
+}
+/** Режим поля фильтра: список (статический/словарь) или примитив. */
+export type FilterFieldMode = 'static' | 'vocab' | 'date' | 'time' | 'datetime' | 'boolean' | 'string' | 'number';
+/** Поле фильтра (коллекция filters в Payload). */
+export interface FilterFieldItemSchema {
+    key: string;
+    label?: string;
+    mode: FilterFieldMode;
+    staticOptions?: FilterStaticOptionSchema[];
+    vocabIdentity?: string;
+    vocabCollection?: string;
+    valuePath?: string;
+    /** Путь до поля подписи в UI фильтра (в документе словаря). */
+    displayNamePath?: string;
+    /** Для словаря: разрешён ли множественный выбор (по умолчанию true). */
+    multiple?: boolean;
+    /** Цепочка конвертеров (identity из домена), применяются последовательно. */
+    converterIdentities?: string[];
+    defaultValue?: string;
+    active?: boolean;
+}
+/** Схема фильтра (коллекция filters в Payload). */
+export interface RFilterSchema {
+    identity: string;
+    displayName: string;
+    fields?: FilterFieldItemSchema[];
+    folder?: string | null;
+    /** Id папки в Payload (для relationship при сохранении). */
+    folderId?: number | string | null;
+    author?: string | null;
+    active?: boolean;
+    deletedAt?: string | null;
+    meta?: Record<string, unknown>;
+    inherited?: boolean;
+}

package/dist/domain/types/flow-condition.types.d.ts

@@ -0,0 +1,39 @@
+import { FlowHandlerContext } from './action.types';
+export type { FlowHandlerContext };
+/**
+ * Параметр входа условия из реестра (для UI и валидации).
+ */
+export interface FlowConditionInputParam {
+    name: string;
+    label: string;
+    valueType: string;
+    optional?: boolean;
+    /** Секции домена, с которых разрешён выбор сущности (например vocabs). */
+    acceptSectionTypes?: string[];
+}
+/**
+ * Спека условия для реестра (метаданные + evaluator).
+ */
+export interface FlowConditionSpec {
+    id: string;
+    title: string;
+    description: string | null;
+    inputParams: FlowConditionInputParam[];
+    evaluate(ctx: FlowHandlerContext, params: Record<string, unknown>): boolean | Promise<boolean>;
+}
+/**
+ * Конфиг одной ветки switch в режиме реестра.
+ */
+export interface FlowSwitchBranchConfig {
+    conditionId: string;
+    params: Record<string, unknown>;
+    portId: string;
+}
+/**
+ * Параметры узла switch в flow.
+ */
+export interface FlowSwitchParams {
+    conditionMode?: 'script' | 'registry';
+    scriptExpression?: string;
+    branches?: FlowSwitchBranchConfig[];
+}

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

@@ -0,0 +1,30 @@
+/**
+ * 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 const 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/jsx.types.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Константы классов и атрибутов для генерации HTML из JSX/DSL.
+ * Используются для стилизации и идентификации тегов и компонентов в DOM.
+ */
+export declare const EndgeJsxAttr: {
+    /** Класс тега верхнего уровня в дереве DSL */
+    readonly TagRoot: "endge-tag-root";
+    /** Класс любого вложенного тега (в т.ч. внутри v-if/v-else) */
+    readonly Tag: "endge-tag";
+    /** Атрибут уникального идентификатора тега в дереве */
+    readonly TagIdentity: "endge-tag-identity";
+    /** Атрибут идентификатора компонента из домена (на верхнем уровне обёртки). Для отображения, может меняться. */
+    readonly ComponentIdentity: "endge-component-identity";
+    /** Стабильный id компонента для селекторов стилей (не меняется при смене identity). */
+    readonly ComponentId: "data-endge-component-id";
+};

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

@@ -0,0 +1,7 @@
+export type TableBinding = {
+    keys: Record<string, // имя входной переменной
+    {
+        pk: string;
+        fk: string;
+    }>;
+};

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

@@ -0,0 +1,27 @@
+/** Типы документа навигации из Payload (коллекция navigations). */
+/** Узел полного дерева навигации. */
+export interface NavigationTreeNodeDoc {
+    id?: string | null;
+    type: 'link' | 'group';
+    title: string;
+    icon?: string | null;
+    hidden?: boolean;
+    disabled?: boolean;
+    collapsedTitle?: string | null;
+    path?: string | null;
+    routeName?: string | null;
+    external?: boolean;
+    children?: NavigationTreeNodeDoc[];
+}
+/** Документ навигации из Payload. */
+export interface NavigationDoc {
+    id: number | string;
+    identity: string;
+    displayName: string;
+    description?: string | null;
+    folder?: number | string;
+    project?: number | string;
+    isSystem?: boolean;
+    tree?: NavigationTreeNodeDoc[];
+    meta?: Record<string, unknown>;
+}

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

@@ -0,0 +1,66 @@
+export type RQueryAuthMode = 'none' | 'token';
+export interface RQueryAuth {
+    mode: RQueryAuthMode;
+    /**
+     * Необязательный ручной токен. Если НЕ задан, будет взят из Endge.auth.
+     * Пример: "eyJhbGciOi..."
+     */
+    manualToken?: string;
+    /** Схема для заголовка (по умолчанию "Bearer"). */
+    scheme?: string;
+    /** Имя заголовка (по умолчанию "Authorization"). */
+    headerName?: string;
+    /**
+     * Куда класть токен: в заголовок или в query.
+     * По умолчанию 'header'.
+     */
+    sendAs?: 'header' | 'query';
+    /** Имя query-параметра (если sendAs='query', по умолчанию 'access_token'). */
+    queryParamName?: string;
+}
+/** Режим применения списка фильтров запроса (пока только слияние по порядку). */
+export type RQueryFilterApplyMode = 'merge';
+export type FilterFieldType = 'string' | 'number' | 'boolean' | 'date' | 'datetime' | 'select' | 'multi-select';
+export interface FilterStaticValue {
+    label: string;
+    value: string;
+}
+export interface FilterDynamicSource {
+    type: 'payload' | 'vocabs' | 'query';
+    collection?: string;
+    mapLabel?: string;
+    mapValue?: string;
+    queryIdentity?: string;
+}
+export interface FilterFieldSchema {
+    key: string;
+    label: string;
+    description?: string;
+    required?: boolean;
+    multiple?: boolean;
+    type: FilterFieldType;
+    staticValues?: FilterStaticValue[];
+    dynamicSource?: FilterDynamicSource | null;
+}
+export interface RuntimeFilterLink {
+    identity: string;
+    displayName: string;
+    description?: string;
+}
+/** Схема параметра (коллекция parameters в Payload). */
+export interface RParameterSchema {
+    identity: string;
+    displayName: string;
+    description?: string;
+    fields: FilterFieldSchema[];
+    runtimeFilters?: RuntimeFilterLink[];
+    folder?: string | null;
+    author?: string;
+    active: boolean;
+    deletedAt?: string | null;
+}
+export declare class RuntimeFilterLinkEntity {
+    identity: string;
+    displayName: string;
+    description?: string;
+}

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

@@ -0,0 +1,70 @@
+export type EndgeBindingMode = 'replace' | 'append' | 'prepend' | 'disable';
+export type EndgeResolveSelectionMode = 'all' | 'inherited-only' | 'direct-only';
+export interface EndgeResolveOptions {
+    ownerType: string;
+    ownerId: number;
+    targetType?: string | null;
+    targetId?: number | null;
+    selector?: string | null;
+    environmentId?: number | null;
+}
+export interface EndgeResolvedOverrideBase {
+    id: number | null;
+    identity: string;
+    displayName: string;
+    ownerType: string;
+    ownerId: number;
+    targetType: string;
+    targetId: number | null;
+    selector: string;
+    mode: EndgeBindingMode;
+    priority: number;
+    isEnabled: boolean;
+    environmentId: number | null;
+    isInherited: boolean;
+    originBindingId: number | null;
+    sourceOwnerType: string;
+    sourceOwnerId: number;
+    source: 'direct' | 'inherited';
+    depth: number;
+}
+export interface EndgeResolveSourceCommon {
+    id?: unknown;
+    identity?: unknown;
+    displayName?: unknown;
+    name?: unknown;
+    ownerType?: unknown;
+    ownerId?: unknown;
+    targetType?: unknown;
+    targetId?: unknown;
+    mode?: unknown;
+    priority?: unknown;
+    isEnabled?: unknown;
+    environmentId?: unknown;
+    originBindingId?: unknown;
+}
+export interface EndgeResolveBuildContext {
+    requestedOwnerType: string;
+    requestedOwnerId: number;
+    requestedTargetType: string;
+    requestedTargetId: number | null;
+    selector: string;
+    id: number | null;
+    identity: string;
+    displayName: string;
+    mode: EndgeBindingMode;
+    priority: number;
+    isEnabled: boolean;
+    environmentId: number | null;
+    originBindingId: number | null;
+    sourceOwnerType: string;
+    sourceOwnerId: number;
+    source: 'direct' | 'inherited';
+    depth: number;
+}
+export interface EndgeResolveEngineConfig<TSource extends EndgeResolveSourceCommon, TResolved extends EndgeResolvedOverrideBase> {
+    getSource: () => TSource[];
+    getSelector: (raw: TSource) => unknown;
+    buildResolved: (raw: TSource, ctx: EndgeResolveBuildContext) => TResolved | null;
+    isResolvedValid?: (item: TResolved) => boolean;
+}

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

@@ -0,0 +1,28 @@
+import { RAction } from '../entities/reflect/RAction';
+import { RComponentTable } from '../entities/reflect/RComponentTable';
+import { RPage } from '../entities/reflect/RPage';
+import { RProject } from '../entities/reflect/RProject';
+import { RQuery } from '../entities/reflect/RQuery';
+import { RView } from '../entities/reflect/RView';
+import { RComponent } from './component.types';
+/**
+ * Канонический перечень сущностей, для которых может существовать runtime-host.
+ */
+export interface RuntimeEntityModelMap {
+    /** Доменная модель проекта. */
+    project: RProject;
+    /** Доменная модель страницы. */
+    page: RPage;
+    /** Доменная модель view. */
+    view: RView;
+    /** Базовая доменная модель компонента. */
+    component: RComponent;
+    /** Доменная модель запроса. */
+    query: RQuery;
+    /** Доменная модель action. */
+    action: RAction;
+    /** Доменная модель табличного компонента. */
+    table: RComponentTable;
+}
+/** Дискриминатор типа runtime-сущности. */
+export type RuntimeEntityType = keyof RuntimeEntityModelMap;