@endge/core 5.0.0 → 6.0.0

package/dist/features/core/modules/ui/EndgeUIRegistry_Module.d.ts

@@ -0,0 +1,128 @@
+import { UIAstNodeBase, UIAstNodeLayout, UIComponentConfigDefinition, UIComponentDefinition, UIComponentDefinitionGroup, UIComponentPresetDocument, UIComponentRendererRegistration, UIJsxComponentDocument, UIPresentationRoleContract, UIPresentationSurface, UIPrimitiveKind, UIRegistryNodeDraft, UIRegistrySnapshot, UIResolvedComponentRenderer, UIResolveRendererOptions } from './domain/types/ui-composition.types';
+import { UIAdapterRegistry } from './registry/UIAdapterRegistry';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/** Модуль UI definitions, presets, renderers и adapter registry. */
+export declare class EndgeUIRegistry_Module extends EndgeModule {
+    readonly adapters: UIAdapterRegistry;
+    private _definitions;
+    private _configDefinitions;
+    private _presetComponents;
+    private _jsxComponents;
+    private _renderersByRef;
+    private _rendererRefsByIndex;
+    /**
+     * Создает registry и регистрирует системные UI definitions.
+     */
+    constructor();
+    /**
+     * Очищает registry и восстанавливает default UI definitions.
+     */
+    reset(): void;
+    /**
+     * Возвращает snapshot зарегистрированных UI refs.
+     */
+    serialize(): UIRegistrySnapshot;
+    /**
+     * Регистрирует UI component definitions.
+     */
+    registerDefinitions(definitions: UIComponentDefinition[]): void;
+    /**
+     * Регистрирует config definitions для UI components.
+     */
+    registerConfigDefinitions(definitions: UIComponentConfigDefinition[]): void;
+    /**
+     * Регистрирует preset components для palette/library.
+     */
+    registerPresetComponents(components: UIComponentPresetDocument[]): void;
+    /**
+     * Регистрирует JSX components для UI editor palette.
+     */
+    registerJsxComponents(components: UIJsxComponentDocument[]): void;
+    /**
+     * Возвращает список UI definitions с optional фильтрацией.
+     */
+    listDefinitions(input?: {
+        includeSystem?: boolean;
+        paletteOnly?: boolean;
+    }): UIComponentDefinition[];
+    /**
+     * Возвращает группы visible definitions для palette.
+     */
+    listDefinitionGroups(): UIComponentDefinitionGroup[];
+    /**
+     * Возвращает UI definition по ref.
+     */
+    getDefinition(definitionRef: string | null | undefined): UIComponentDefinition | null;
+    /**
+     * Возвращает UI definition или выбрасывает ошибку, если ref неизвестен.
+     */
+    getDefinitionOrThrow(definitionRef: string): UIComponentDefinition;
+    /**
+     * Возвращает config definition по kind.
+     */
+    getConfigDefinition(kind: string | null | undefined): UIComponentConfigDefinition | null;
+    /**
+     * Возвращает зарегистрированные preset components.
+     */
+    listPresetComponents(): UIComponentPresetDocument[];
+    /**
+     * Возвращает зарегистрированные JSX components.
+     */
+    listJsxComponents(): UIJsxComponentDocument[];
+    /**
+     * Возвращает preset component по id.
+     */
+    getPresetComponent(componentId: string | null | undefined): UIComponentPresetDocument | null;
+    /**
+     * Возвращает JSX component по id.
+     */
+    getJsxComponent(componentId: string | null | undefined): UIJsxComponentDocument | null;
+    /**
+     * Сопоставляет legacy primitive kind с definition ref нового UI registry.
+     */
+    resolveLegacyDefinitionRef(kind: UIPrimitiveKind, props?: Record<string, unknown> | null): string;
+    /**
+     * Возвращает layout по умолчанию для definition.
+     */
+    getDefinitionDefaultLayout(definitionRef: string): UIAstNodeLayout | undefined;
+    /**
+     * Возвращает props по умолчанию для definition.
+     */
+    getDefinitionDefaultProps(definitionRef: string): Record<string, unknown>;
+    /**
+     * Создает UI AST node на основе definition и пользовательских patch-значений.
+     */
+    createNodeFromDefinition(input: UIRegistryNodeDraft): UIAstNodeBase;
+    /**
+     * Создает корневую page-ноду для UI AST.
+     */
+    createRootNode(input?: {
+        id?: string;
+        propsPatch?: Record<string, unknown>;
+    }): UIAstNodeBase<'page'>;
+    /**
+     * Нормализует node относительно зарегистрированной definition.
+     */
+    normalizeNodeDefinition<TNode extends UIAstNodeBase>(node: TNode): TNode;
+    /**
+     * Регистрирует renderer для definition/surface/role.
+     */
+    registerRenderer(input: UIComponentRendererRegistration): void;
+    /**
+     * Назначает renderer по умолчанию для роли и поверхности definition.
+     */
+    setDefaultRendererRef(definitionRef: string, surface: UIPresentationSurface, role: string, rendererRef: string): void;
+    /**
+     * Возвращает renderer по его ссылке.
+     */
+    getRendererByRef(rendererRef: string | null | undefined): UIResolvedComponentRenderer | null;
+    /**
+     * Подбирает renderer по definition, surface, role и возможной явной ссылке.
+     */
+    resolveRenderer(input: UIResolveRendererOptions): UIResolvedComponentRenderer | null;
+    /**
+     * Возвращает Fallback Surfaces.
+     */
+    private _getFallbackSurfaces;
+}
+export declare function getUIPresentationRoleContract(definition: UIComponentDefinition, role: string): UIPresentationRoleContract | null;

package/dist/features/core/modules/ui/EndgeUI_Module.d.ts

@@ -0,0 +1,99 @@
+import { EndgeUISnapshot, TimeZoneMode } from './domain/types/ui.types';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/**
+ * UI-состояние ядра: zoom, theme и режим отображения времени.
+ */
+export declare class EndgeUI_Module extends EndgeModule {
+    private _offContext;
+    private _offWorkspace;
+    private readonly _MIN_ZOOM;
+    private readonly _MAX_ZOOM;
+    private readonly _STEP_ZOOM;
+    private readonly _DEFAULT_ZOOM;
+    private readonly _LS_KEY_ZOOM;
+    private _zoom;
+    private _theme;
+    /**
+     * Восстанавливает UI-настройки из localStorage и применяет тему к document.
+     */
+    constructor();
+    /** Подключает UI projection к пользовательскому контексту после загрузки workspace. */
+    start(): void;
+    /** Отключает runtime subscription; пользовательское значение остаётся в EndgeContext_Module. */
+    reset(): void;
+    /**
+     * Возвращает полный snapshot UI-настроек.
+     */
+    get snapshot(): EndgeUISnapshot;
+    /**
+     * Возвращает текущий процент zoom.
+     */
+    get zoom(): number;
+    /**
+     * Возвращает CSS-класс текущего zoom.
+     */
+    get zoomClass(): string;
+    /**
+     * Устанавливает zoom с ограничением допустимого диапазона.
+     */
+    setZoom(value: number): void;
+    /**
+     * Возвращает zoom к значению по умолчанию.
+     */
+    resetZoom(): void;
+    /**
+     * Увеличивает zoom на один шаг.
+     */
+    zoomUp(): void;
+    /**
+     * Уменьшает zoom на один шаг.
+     */
+    zoomDown(): void;
+    /**
+     * Внутренний helper модуля: clamp Zoom.
+     */
+    private _clampZoom;
+    /**
+     * Считывает Zoom From LS.
+     */
+    private _readZoomFromLS;
+    /**
+     * Записывает Zoom To LS.
+     */
+    private _writeZoomToLS;
+    /**
+     * Возвращает текущую тему.
+     */
+    get theme(): string;
+    /** Возвращает workspace theme catalog; до boot используется безопасный bootstrap fallback. */
+    get availableThemes(): string[];
+    /**
+     * Показывает, активна ли темная тема.
+     */
+    get isDark(): boolean;
+    /**
+     * Устанавливает тему, сохраняет ее и применяет CSS-классы к document.
+     */
+    setTheme(next: string): void;
+    private _syncThemeFromContext;
+    /**
+     * Применяет Theme To Document.
+     */
+    private _applyThemeToDocument;
+    /**
+     * Показывает, используется ли локальное время вместо UTC.
+     */
+    get isLocalTime(): boolean;
+    /**
+     * Возвращает текущий режим времени для UI.
+     */
+    get timeZone(): TimeZoneMode;
+    /**
+     * Явно выставить режим.
+     */
+    setLocalTime(value: boolean): void;
+    /**
+     * Переключатель LT <-> UTC.
+     */
+    switchTime(): void;
+}

package/dist/features/core/modules/ui/domain/types/context-menu.types.d.ts

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

package/dist/features/core/modules/ui/domain/types/ui-render-adapter.type.d.ts

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

package/dist/features/core/modules/ui/registry/UIAdapterRegistry.d.ts

@@ -0,0 +1,32 @@
+import { UIActiveRenderAdapterRequirement, UIRenderAdapter, UIRenderAdapterDescriptor, UIRenderAdapterRequirement } from '../domain/types/ui-render-adapter.type';
+/** Хранит runtime implementations UI adapter-ов и выбранный adapter. */
+export declare class UIAdapterRegistry {
+    private readonly _onChange;
+    private _adapters;
+    private _activeAdapterId;
+    constructor(_onChange?: () => void);
+    /** Регистрирует adapter и запрещает неявную замену implementation с тем же id. */
+    register<TImplementation>(input: UIRenderAdapter<TImplementation>): UIRenderAdapter<TImplementation>;
+    /** Проверяет наличие adapter-а по id. */
+    has(id: string | null | undefined): boolean;
+    /** Возвращает adapter по id без проверки его контракта. */
+    get<TImplementation = unknown>(id: string | null | undefined): UIRenderAdapter<TImplementation> | null;
+    /** Возвращает configured adapter либо первый зарегистрированный fallback в заданном порядке. */
+    resolveAvailable<TImplementation = unknown>(preferredId: string | null | undefined, fallbackIds?: readonly string[]): UIRenderAdapter<TImplementation> | null;
+    /** Возвращает adapter и проверяет его protocol, renderer и обязательные renderer keys. */
+    require<TImplementation = unknown>(requirement: UIRenderAdapterRequirement): UIRenderAdapter<TImplementation>;
+    /** Проверяет и делает adapter активным для текущего workspace runtime. */
+    activate<TImplementation = unknown>(input: string | UIRenderAdapterRequirement): UIRenderAdapter<TImplementation>;
+    /** Возвращает активный adapter без проверки consumer-контракта. */
+    get active(): UIRenderAdapter | null;
+    /** Возвращает активный adapter и проверяет его consumer-контракт. */
+    requireActive<TImplementation = unknown>(requirement?: UIActiveRenderAdapterRequirement): UIRenderAdapter<TImplementation>;
+    /** Возвращает сериализуемые descriptors всех зарегистрированных adapter-ов. */
+    list(): UIRenderAdapterDescriptor[];
+    /** Очищает runtime registrations и active adapter. */
+    reset(): void;
+    /** Нормализует descriptor, сохраняя runtime implementations без сериализации. */
+    private _normalizeAdapter;
+    /** Проверяет совместимость adapter-а с контрактом конкретного render engine. */
+    private _assertRequirement;
+}

package/dist/features/core/modules/ui/tooltip/endge-tooltip-markdown.d.ts

@@ -0,0 +1,5 @@
+import { EndgeTooltipMarkdownBlock } from '../domain/types/tooltip-markdown.types';
+/** Разбирает намеренно небольшой безопасный поднабор Tooltip Markdown без создания HTML. */
+export declare function parseEndgeTooltipMarkdown(source: unknown): EndgeTooltipMarkdownBlock[];
+/** Стабильный DOM id одного tooltip уровня consumer без утечки значений Source в селекторы. */
+export declare function createEndgeTooltipDomId(seed: string): string;