@endge/core 5.0.0 → 7.0.0

package/dist/features/core/modules/ui/ui-composition.config.d.ts

@@ -0,0 +1,524 @@
+import { UIAstNodeBase } from './domain/types/ui-composition.types';
+/** Декларативная конфигурация встроенных UI-компонентов. */
+export declare const UI_COMPONENT_HOST_DEFINITION_ID = "ui.component-host";
+export declare const ENDGE_UI_DEFAULT_DEFINITIONS: ({
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "page";
+    jsxTag: string;
+    supportsChildren: true;
+    paletteVisible: false;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        title: string;
+        gap: number;
+        padding: number;
+        rowHeight: number;
+        text?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+        rendererRef?: undefined;
+    };
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+        }[];
+    };
+    defaultLayout?: undefined;
+    stubDescription?: undefined;
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "text";
+    jsxTag: string;
+    supportsChildren: false;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        text: string;
+        title?: undefined;
+        gap?: undefined;
+        padding?: undefined;
+        rowHeight?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+        rendererRef?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        }[];
+    };
+    stubDescription?: undefined;
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "button";
+    jsxTag: string;
+    supportsChildren: false;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        label: string;
+        title?: undefined;
+        gap?: undefined;
+        padding?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+        rendererRef?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        }[];
+    };
+    stubDescription?: undefined;
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "box";
+    jsxTag: string;
+    supportsChildren: true;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        title: string;
+        padding: number;
+        gap?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+        rendererRef?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        }[];
+    };
+    stubDescription?: undefined;
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "flex";
+    jsxTag: string;
+    supportsChildren: true;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        direction: string;
+        gap: number;
+        padding: number;
+        title?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        label?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+        rendererRef?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        }[];
+    };
+    stubDescription?: undefined;
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "grid";
+    jsxTag: string;
+    supportsChildren: true;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        columns: number;
+        gap: number;
+        padding: number;
+        minHeight: number;
+        title?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        rendererRef?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        }[];
+    };
+    stubDescription?: undefined;
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "box";
+    jsxTag: string;
+    supportsChildren: true;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: string;
+    defaultNodeName: string;
+    defaultProps: {
+        title: string;
+        padding: number;
+        gap?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+        rendererRef?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    stubDescription: string;
+    presentationContract: {
+        id: string;
+        roles: ({
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        } | {
+            role: string;
+            description: string;
+            supportedSurfaces: "admin"[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime?: undefined;
+            };
+        })[];
+    };
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "custom-component";
+    jsxTag: string;
+    supportsChildren: false;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        title: string;
+        rendererRef: string;
+        gap?: undefined;
+        padding?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    stubDescription: string;
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        }[];
+    };
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "custom-component";
+    jsxTag: string;
+    supportsChildren: false;
+    paletteVisible: true;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: string;
+    defaultNodeName: string;
+    defaultProps: {
+        title: string;
+        rendererRef: string;
+        gap?: undefined;
+        padding?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    stubDescription: string;
+    presentationContract: {
+        id: string;
+        roles: ({
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        } | {
+            role: string;
+            description: string;
+            supportedSurfaces: "admin"[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime?: undefined;
+            };
+        })[];
+    };
+    defaultRendererRef?: undefined;
+    allowsRendererRefOverride?: undefined;
+} | {
+    id: string;
+    title: string;
+    description: string;
+    groupId: string;
+    groupTitle: string;
+    groupDescription: string;
+    primitiveKind: "custom-component";
+    jsxTag: string;
+    supportsChildren: false;
+    paletteVisible: false;
+    canvasAccentClass: string;
+    keywords: string[];
+    configKind: null;
+    defaultNodeName: string;
+    defaultProps: {
+        title: string;
+        rendererRef: string;
+        gap?: undefined;
+        padding?: undefined;
+        rowHeight?: undefined;
+        text?: undefined;
+        label?: undefined;
+        direction?: undefined;
+        columns?: undefined;
+        minHeight?: undefined;
+    };
+    defaultLayout: {
+        colStart: number;
+        rowStart: number;
+        span: number;
+        rowSpan: number;
+    };
+    defaultRendererRef: string;
+    allowsRendererRefOverride: true;
+    stubDescription: string;
+    presentationContract: {
+        id: string;
+        roles: {
+            role: string;
+            description: string;
+            supportedSurfaces: ("canvas" | "runtime" | "admin")[];
+            defaultRendererRefs: {
+                admin: string;
+                runtime: string;
+            };
+        }[];
+    };
+})[];
+export declare const ENDGE_UI_DEFAULT_CONFIG_DEFINITIONS: {
+    kind: string;
+    title: string;
+    description: string;
+    definitionRef: string;
+}[];
+export declare const ENDGE_UI_DEFAULT_PRESET_COMPONENTS: {
+    id: string;
+    title: string;
+    description: string;
+    definitionRef: string;
+    configRef: string;
+    propsPatch: {
+        title: string;
+    };
+    layoutPatch: {
+        span: number;
+        rowSpan: number;
+    };
+    keywords: string[];
+}[];
+export declare const ENDGE_UI_DEFAULT_JSX_COMPONENTS: {
+    id: string;
+    title: string;
+    description: string;
+    definitionRef: string;
+    jsxSource: string;
+    keywords: string[];
+    ast: {
+        rootId: string;
+        nodes: Record<string, UIAstNodeBase<import('./domain/types/ui-composition.types').UIPrimitiveKind, Record<string, unknown>>>;
+    };
+}[];

package/dist/features/core/modules/updates/EndgeUpdates_Module.d.ts

@@ -0,0 +1,12 @@
+import { EndgeModule } from '../../../federation/EndgeModule';
+/**
+ * Модуль применения внешних update-сообщений к runtime state.
+ * Устаревшие update-профили из документа настроек удалены; новый SSE pipeline
+ * должен описываться отдельной доменной моделью.
+ */
+export declare class EndgeUpdates_Module extends EndgeModule {
+    /** Обрабатывает legacy update profile; текущая реализация оставлена как no-op boundary. */
+    applyUpdateForProfile(profileIdentity: string, message: unknown, opts?: {
+        vars?: Record<string, string>;
+    }): number;
+}

package/dist/features/core/modules/workspace/EndgeWorkspace_Module.d.ts

@@ -0,0 +1,80 @@
+import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
+import { EndgeDataMode, EndgeWorkspaceDefinition, EndgeWorkspaceLocale, EndgeWorkspaceLocaleLabelMode, EndgeWorkspaceTheme, EndgeWorkspaceTimezone, EndgeWorkspaceVar } from './domain/workspace.types';
+import { WorkspaceVariables } from '../context/endge-vars';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/**
+ * Модуль workspace-профиля frontend-приложения.
+ * Владеет workspace, загруженным из service-backend или release bundle.
+ */
+export declare class EndgeWorkspace_Module extends EndgeModule<EndgeBootContext> {
+    private _current;
+    readonly variables: WorkspaceVariables;
+    /** Сохраняет переопределения окружения до загрузки определения workspace. */
+    setup(ctx: EndgeBootContext): void;
+    /** Строит workspace из загруженного source. */
+    build(ctx: EndgeBootContext): void;
+    /** Очищает загруженный workspace. */
+    reset(): void;
+    /** Проверяет, поддерживает ли workspace указанную locale. */
+    supportsLocale(locale: string | null | undefined): boolean;
+    /** Нормализует locale по правилам активного workspace. */
+    normalizeLocale(locale: string | null | undefined): string;
+    /** Возвращает label locale в указанном режиме. */
+    getLocaleLabel(locale: string, mode?: EndgeWorkspaceLocaleLabelMode): string;
+    /** Проверяет, поддерживает ли workspace указанную тему. */
+    supportsTheme(theme: string | null | undefined): boolean;
+    /** Нормализует тему по правилам активного workspace. */
+    normalizeTheme(theme: string | null | undefined): string;
+    /** Возвращает пользовательское имя темы. */
+    getThemeLabel(theme: string): string;
+    /** Проверяет, поддерживает ли workspace указанную временную зону. */
+    supportsTimezone(timezone: string | null | undefined): boolean;
+    /** Нормализует временную зону по правилам активного workspace. */
+    normalizeTimezone(timezone: string | null | undefined): string;
+    /** Возвращает пользовательское имя временной зоны. */
+    getTimezoneLabel(timezone: string): string;
+    /** Применяет и публикует новую workspace-конфигурацию. */
+    apply(input: unknown): void;
+    /** Сериализует текущую workspace-конфигурацию. */
+    serialize(): EndgeWorkspaceDefinition;
+    /** Возвращает workspace или сообщает о нарушении boot lifecycle. */
+    private _requireCurrent;
+    /** Возвращает effective configuration после resolution и root configuration до него. */
+    private _configurationOrNull;
+    private _configuration;
+    /**
+     * ACCESS
+     */
+    /** Показывает, загружен ли workspace. */
+    get isLoaded(): boolean;
+    /** Возвращает текущую нормализованную workspace-конфигурацию. */
+    get current(): EndgeWorkspaceDefinition;
+    /** Возвращает сохранённое значение по умолчанию, используемое при отсутствии локального runtime-переопределения. */
+    get dataMode(): EndgeDataMode;
+    /** Показывает, запускает ли workspace runtime с mock-данными по умолчанию. */
+    get isMockEnabled(): boolean;
+    /** Возвращает доступные workspace locales. */
+    get locales(): EndgeWorkspaceLocale[];
+    /** Возвращает определения workspace variables. */
+    get vars(): EndgeWorkspaceVar[];
+    /** Явное имя для сохранённых определений переменных. */
+    get variableDefinitions(): EndgeWorkspaceVar[];
+    /** Возвращает locale по умолчанию. */
+    get defaultLocale(): string;
+    /** Возвращает fallback locale. */
+    get fallbackLocale(): string;
+    /** Возвращает доступные workspace themes. */
+    get themes(): EndgeWorkspaceTheme[];
+    /** Возвращает тему по умолчанию. */
+    get defaultTheme(): string;
+    /** Возвращает доступные workspace timezones. */
+    get timezones(): EndgeWorkspaceTimezone[];
+    /** Возвращает временную зону по умолчанию. */
+    get defaultTimezone(): string;
+    /** Возвращает identity auth profile по умолчанию. */
+    get defaultAuthProfileIdentity(): string | null;
+    /** Возвращает список разрешённых SFC adapter ids. */
+    get sfcAdapterIds(): string[];
+    /** Возвращает SFC adapter id по умолчанию. */
+    get defaultSfcAdapterId(): string;
+}

package/dist/features/core/modules/workspace/domain/workspace.types.d.ts

@@ -0,0 +1,28 @@
+import { EndgeConfiguration, EndgeLocaleDefinition, EndgeThemeDefinition, EndgeTimezoneDefinition, EndgeVariableDefinition } from '../../configuration/domain/types/configuration.type';
+import { EntityManagement } from '../../domain/types/document/entity-management.type';
+export type EndgeWorkspaceLocale = EndgeLocaleDefinition;
+export type EndgeDataMode = 'live' | 'mock';
+export type EndgeWorkspaceLocaleLabelMode = keyof Pick<EndgeWorkspaceLocale, 'displayName' | 'shortLabel'>;
+export type EndgeWorkspaceTheme = EndgeThemeDefinition;
+export type EndgeWorkspaceTimezone = EndgeTimezoneDefinition;
+export type EndgeWorkspaceVar = EndgeVariableDefinition;
+/** Фактическая переменная workspace после применения переопределений runtime и окружения. */
+export interface EndgeResolvedWorkspaceVariable {
+    name: string;
+    defaultValue: string;
+    currentValue: string;
+}
+export interface WorkspaceIntegrationReference {
+    integrationId: string | number;
+    integrationIdentity: string;
+    version: string;
+}
+export interface EndgeWorkspaceDefinition extends EntityManagement {
+    identity: string;
+    displayName: string;
+    dataMode: EndgeDataMode;
+    meta?: Record<string, unknown>;
+    installedIntegrations: WorkspaceIntegrationReference[];
+    configuration: EndgeConfiguration;
+}
+export type EndgeWorkspaceDefinitionInput = Partial<EndgeWorkspaceDefinition> & Record<string, unknown>;