@endge/core 1.2.5 → 1.2.8

package/dist/model/endge/security/endge-auth.d.ts

@@ -0,0 +1,143 @@
+import { GetAccessTokenOpts, StoredAuthToken } from '../../../domain/types/auth/auth.types';
+import { EndgeAuthContext } from '../../../domain/types/auth/auth-profile.types';
+import { AxiosInstance } from 'axios';
+import { EndgeModule } from '../../../domain/entities/endge/EndgeModule';
+import { EndgeAuthProfiles } from './endge-auth-profiles';
+/** Модуль legacy Keycloak-аутентификации и управления token lifecycle. */
+export declare class EndgeAuth extends EndgeModule {
+    /** Profile/adapters service, owned by the auth module. */
+    readonly profiles: EndgeAuthProfiles;
+    private auth;
+    private client;
+    /** Единственный axios инстанс для всего модуля */
+    private readonly http;
+    private accessToken;
+    private refreshToken;
+    private idToken;
+    private sessionState;
+    private accessExpiresAt;
+    private refreshExpiresAt;
+    private backgroundInterval;
+    private initPromise;
+    private isInitialized;
+    private loginPromise;
+    private _userInfo;
+    private _unregisterDiagnosticsContext;
+    /**
+     * Создает auth-модуль с изолированным axios instance.
+     */
+    constructor();
+    /** Подключает безопасный auth context к общему diagnostics enrichment pipeline. */
+    setup(): void;
+    /**
+     * Возвращает axios instance, который автоматически использует Authorization header.
+     */
+    get axios(): AxiosInstance;
+    /**
+     * Возвращает текущий access token.
+     */
+    get token(): string;
+    /**
+     * Возвращает активный auth-provider.
+     */
+    get provider(): 'keycloak_manual' | 'keycloak_form';
+    /**
+     * Показывает, есть ли действующий access token.
+     */
+    get isAuthenticated(): boolean;
+    /**
+     * Возвращает загруженный userinfo payload.
+     */
+    get userInfo(): any;
+    /** Возвращает минимальный синхронный actor/session snapshot без tokens и полного claims. */
+    get context(): EndgeAuthContext;
+    /**
+     * Инициализирует auth-конфигурацию из профиля авторизации и восстанавливает токены из storage.
+     */
+    init(): Promise<void>;
+    /**
+     * Гарантирует Init.
+     */
+    private ensureInit;
+    /**
+     * Внутренний helper модуля: init Once.
+     */
+    private initOnce;
+    /** Собирает auth config из первого активного Keycloak profile. */
+    private getAuthFromProfile;
+    /**
+     * Выполняет ручной login с credentials из auth profile.
+     */
+    login(): Promise<StoredAuthToken>;
+    /**
+     * Выполняет form login с credentials из UI.
+     */
+    loginForm(username: string, password: string): Promise<StoredAuthToken>;
+    /**
+     * Обновляет access token через refresh token.
+     */
+    refresh(): Promise<boolean>;
+    /**
+     * Проверяет срок access token и обновляет его при приближении истечения.
+     */
+    checkAccessToken(): Promise<void>;
+    /**
+     * Выполняет logout, очищает storage, локальные токены и Authorization header.
+     */
+    logout(): Promise<void>;
+    /**
+     * Останавливает фоновую проверку и обновление access token.
+     */
+    stopBackgroundRefresh(): void;
+    /**
+     * Внутренний helper модуля: require Auth.
+     */
+    private requireAuth;
+    /**
+     * Внутренний helper модуля: require Service.
+     */
+    private requireClient;
+    /**
+     * Внутренний helper модуля: login With Credentials.
+     */
+    private loginWithCredentials;
+    /**
+     * Внутренний helper модуля: save To Storage.
+     */
+    private saveToStorage;
+    /**
+     * Внутренний helper модуля: load From Storage.
+     */
+    private loadFromStorage;
+    /**
+     * Применяет Auth Header.
+     */
+    private applyAuthHeader;
+    /**
+     * Проверяет is Stored Auth Token.
+     */
+    private isStoredAuthToken;
+    /**
+     * Запускает Background Refresh.
+     */
+    private startBackgroundRefresh;
+    /**
+     * Полностью сбрасывает auth-состояние модуля.
+     */
+    reset(): void;
+    /**
+     * Гарантирует Authenticated.
+     */
+    private ensureAuthenticated;
+    /**
+     * Возвращает token согласно режиму: none, manual или inherit.
+     */
+    getAccessToken(opts?: GetAccessTokenOpts): Promise<string | undefined>;
+    /**
+     * Явная подгрузка userinfo.
+     * Используем уже инициализированный сервис + axios с Authorization.
+     */
+    loadUserInfo(): Promise<void>;
+    /** Преобразует auth context в OTel-aligned attributes для каждого нового diagnostics record. */
+    private _getDiagnosticsAttributes;
+}

package/dist/model/endge/security/index.d.ts

@@ -0,0 +1,2 @@
+export * from './endge-auth';
+export * from './endge-auth-profiles';

package/dist/model/endge/ui/endge-styles.d.ts

@@ -0,0 +1,26 @@
+import { EndgeStyleMatchNode, AcquireEndgeStyleOptions, EndgeStyleLease, EndgeStylePlacement, EndgeStyleResolvedDeclaration, EndgeStyleSheetArtifact, EndgeStyleTargetProfile } from '../../../domain/types/style';
+import { EndgeModule } from '../../../domain/entities/endge/EndgeModule';
+export interface EndgeStyleResolver {
+    readonly target: EndgeStyleTargetProfile;
+    resolve: (node: EndgeStyleMatchNode, theme?: string) => Record<string, EndgeStyleResolvedDeclaration>;
+}
+/** Neutral style registry. Renderer materializers consume its artifacts/resolver. */
+export declare class EndgeStyles extends EndgeModule {
+    private _unsubscribeProgram;
+    private readonly _placements;
+    private _leaseSequence;
+    private _transactionDepth;
+    private _notificationPending;
+    start(): void;
+    /** Returns valid compiled artifacts. Availability does not activate a style. */
+    getAvailableArtifacts(): EndgeStyleSheetArtifact[];
+    /** Returns only placements acquired by live runtime owners. */
+    getActivePlacements(): EndgeStylePlacement[];
+    getActiveArtifacts(): EndgeStyleSheetArtifact[];
+    acquireStyle(options: AcquireEndgeStyleOptions): EndgeStyleLease;
+    transaction<T>(operation: () => T): T;
+    /** Creates a renderer-neutral resolver over the active program snapshot. */
+    createResolver(target: EndgeStyleTargetProfile): EndgeStyleResolver;
+    reset(): void;
+    private _changed;
+}

package/dist/model/endge/ui/endge-ui-registry.d.ts

@@ -0,0 +1,128 @@
+import { UIAstNodeBase, UIAstNodeLayout, UIComponentConfigDefinition, UIComponentDefinition, UIComponentPresetDocument, UIComponentDefinitionGroup, UIComponentRendererRegistration, UIJsxComponentDocument, UIPrimitiveKind, UIRegistryNodeDraft, UIRegistrySnapshot, UIResolveRendererOptions, UIResolvedComponentRenderer, UIPresentationRoleContract, UIPresentationSurface } from '../../../domain/types/ui/ui-composition.types';
+import { EndgeModule } from '../../../domain/entities/endge/EndgeModule';
+import { UIAdapterRegistry } from './registry/UIAdapterRegistry';
+/** Модуль UI definitions, presets, renderers и adapter registry. */
+export declare class EndgeUIRegistry 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/model/endge/ui/endge-ui.d.ts

@@ -0,0 +1,110 @@
+import { EndgeUISnapshot, TimeZoneMode } from '../../../domain/types/ui/ui.types';
+import { EndgeModule } from '../../../domain/entities/endge/EndgeModule';
+/**
+ * UI-состояние ядра: zoom, theme и режим отображения времени.
+ */
+export declare class EndgeUI 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 readonly DEFAULT_IS_LOCAL_TIME;
+    private readonly LS_KEY_IS_LOCAL_TIME;
+    private _zoom;
+    private _theme;
+    private _isLocalTime;
+    /**
+     * Восстанавливает UI-настройки из localStorage и применяет тему к document.
+     */
+    constructor();
+    /** Подключает UI projection к пользовательскому контексту после загрузки workspace. */
+    start(): void;
+    /** Отключает runtime subscription; пользовательское значение остаётся в EndgeContext. */
+    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;
+    /**
+     * Считывает Is Local Time From LS.
+     */
+    private readIsLocalTimeFromLS;
+    /**
+     * Записывает Is Local Time To LS.
+     */
+    private writeIsLocalTimeToLS;
+}

package/dist/model/endge/ui/index.d.ts

@@ -0,0 +1,4 @@
+export * from './endge-ui';
+export * from './endge-ui-registry';
+export * from './endge-styles';
+export * from './registry/UIAdapterRegistry';

package/dist/model/endge/ui/registry/UIAdapterRegistry.d.ts

@@ -0,0 +1,30 @@
+import { UIActiveRenderAdapterRequirement, UIRenderAdapter, UIRenderAdapterDescriptor, UIRenderAdapterRequirement } from '../../../../domain/types/ui/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;
+    /** Возвращает 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/model/helpers/raph-phases/endge-runtime-boundary.d.ts

@@ -1,4 +1,4 @@
-import { DepGraph, PhaseExecutorContext, PhaseName, RaphPhase, RaphNode } from '@endge/raph';
+import { DepGraph, PhaseExecutorContext, PhaseName, RaphPhase, RaphNode } from '../../../../../@endge-raph/dist/main.d.ts';
 /** Опции фабрики */
 export interface BoundaryPhaseOptions {
     isBoundary: (n: RaphNode) => boolean;

package/dist/model/helpers/raph-phases/runtime-boundary-update-phase.d.ts

@@ -0,0 +1,20 @@
+import { DepGraph, PhaseEvent, PhaseExecutorContext, PhaseName, RaphPhase, RaphNode } from '../../../../../@endge-raph/dist/main.d.ts';
+import { RuntimeDirtyBoundary, RuntimeHost } from '../../../domain/types/runtime/runtime-host.types';
+export interface RuntimeBoundaryAggregatedUpdate {
+    node: RaphNode;
+    events: PhaseEvent[];
+    boundaries: RuntimeDirtyBoundary[];
+}
+export interface RuntimeBoundaryUpdatePhaseOptions {
+    name?: PhaseName;
+    getGraph?: () => DepGraph<RaphNode>;
+    resolveHost?: (runtimeId: string) => RuntimeHost | null;
+}
+/** Универсальная Raph-фаза обновления runtime-сущностей через верхние dirty boundaries. */
+export declare class RuntimeBoundaryUpdatePhase {
+    static readonly PHASE_NAME: PhaseName;
+    /** Создает Raph-фазу, которая вызывает update у runtime-host верхних dirty boundaries. */
+    static make(options?: RuntimeBoundaryUpdatePhaseOptions): RaphPhase;
+}
+/** Агрегирует dirty runtime-ноды к минимальному списку верхних dirty boundaries. */
+export declare function aggregateRuntimeBoundaryUpdates(graph: DepGraph<RaphNode>, ctxs: PhaseExecutorContext[]): RuntimeBoundaryAggregatedUpdate[];

package/dist/model/helpers/raph-phases/runtime-node-update-phase.d.ts

@@ -0,0 +1,16 @@
+import { PhaseName, RaphPhase } from '../../../../../@endge-raph/dist/main.d.ts';
+import { RuntimeHost } from '../../../domain/types/runtime/runtime-host.types';
+export interface RuntimeNodeUpdatePhaseOptions {
+    name?: PhaseName;
+    resolveHost?: (runtimeId: string) => RuntimeHost | null;
+}
+/**
+ * Выполняет логические runtime update-ы.
+ *
+ * Фаза ничего не знает о Query, Filter или Composition: она лишь передаёт
+ * накопленные Raph events root-ноды соответствующему RuntimeHost.
+ */
+export declare class RuntimeNodeUpdatePhase {
+    static readonly PHASE_NAME: PhaseName;
+    static make(options?: RuntimeNodeUpdatePhaseOptions): RaphPhase;
+}

package/dist/model/services/{Auth_Service.d.ts → auth/AuthTokenService.d.ts}

@@ -1,10 +1,10 @@
-import { EndgeApi } from '../../domain/entities/endge/EndgeApi';
-import { KeycloakTokenResponse } from '../../domain/types/auth.types';
+import { EndgeApi } from '../../../domain/entities/endge/EndgeApi';
+import { KeycloakTokenResponse } from '../../../domain/types/auth/auth.types';
 /**
- * Лёгкий клиент Keycloak-совместимого токен-эндпоинта.
+ * Service токен-операций для Keycloak-совместимого endpoint.
  * Работает поверх EndgeApi (form-urlencoded).
  */
-export declare class AuthService {
+export declare class AuthTokenService {
     private readonly api;
     private readonly clientId;
     private readonly defaultScope;
@@ -15,9 +15,11 @@ export declare class AuthService {
         clientId: string;
         scope?: string;
         headers?: Record<string, string>;
-    }): AuthService;
+    }): AuthTokenService;
     /** Resource Owner Password Credentials (password grant). */
     generateJWT(username: string, password: string, scope?: string): Promise<KeycloakTokenResponse>;
     refresh(refreshToken: string): Promise<KeycloakTokenResponse>;
     logout(refreshToken: string): Promise<void>;
 }
+/** @deprecated Use AuthTokenService. */
+export { AuthTokenService as AuthService };

package/dist/{domain/services/auth.d.ts → model/services/auth/KeycloakAuthClient.d.ts}

@@ -1,7 +1,7 @@
-import { KeycloakTokenResponse, StoredAuthToken } from '../types/auth.types';
+import { KeycloakTokenResponse, StoredAuthToken } from '../../../domain/types/auth/auth.types';
 import { AxiosInstance } from 'axios';
 export declare function mapTokenResponseToStored(data: KeycloakTokenResponse, now?: Date): StoredAuthToken;
-export declare class KeycloakAuthService {
+export declare class KeycloakAuthClient {
     private readonly http;
     private readonly tokenPath;
     private readonly logoutPath;

package/dist/model/services/auth/auth-context.d.ts

@@ -0,0 +1,14 @@
+import { EndgeAuthContext } from '../../../domain/types/auth/auth-profile.types';
+/** Минимальные источники, из которых можно построить безопасный auth context. */
+export interface EndgeAuthContextSource {
+    authenticated: boolean;
+    accessToken?: string;
+    idToken?: string;
+    sessionState?: string;
+    profileIdentity?: string;
+    userInfo?: unknown;
+}
+/** Декодирует только JWT payload; результат не используется для authorization decisions. */
+export declare function decodeJwtClaims(token: string | null | undefined): Record<string, unknown> | null;
+/** Строит минимальный actor/session snapshot без сохранения tokens или полного claims. */
+export declare function createEndgeAuthContext(source: EndgeAuthContextSource): EndgeAuthContext;

package/dist/model/services/compiler/action/action-compile.d.ts

@@ -0,0 +1,8 @@
+import { RAction } from '../../../../domain/entities/reflect/RAction';
+import { ActionProgramPayload, ProgramDiagnostic } from '../../../../domain/types/program/program.types';
+export interface ActionCompileResult {
+    payload: ActionProgramPayload;
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+}
+/** Compiles persisted Flow source and the semantic Action contract into Program. */
+export declare function compileAction(entity: RAction): ActionCompileResult;

package/dist/model/services/compiler/action/action-target-validation.d.ts

@@ -0,0 +1,10 @@
+import { ActionExecutionTarget, ActionTargetSelector } from '../../../../domain/types/runtime/action.types';
+export type ActionTargetErrorCode = 'action-target-required' | 'action-target-type-mismatch' | 'action-target-identity-mismatch';
+export declare class ActionTargetError extends Error {
+    readonly code: ActionTargetErrorCode;
+    constructor(code: ActionTargetErrorCode, message: string);
+}
+/** Normalizes and validates an authoring target contract. */
+export declare function normalizeActionTargets(value: unknown): ActionTargetSelector[] | null;
+/** Validates one concrete runtime target against alternative selectors. */
+export declare function validateActionTarget(selectors: readonly ActionTargetSelector[] | null, target: ActionExecutionTarget | undefined): void;

package/dist/model/services/compiler/component-sfc/component-sfc-built-in-tags.d.ts

@@ -0,0 +1,4 @@
+import { RComponentSFC_IR_Tag } from '../../../../domain/types/component/sfc';
+export declare const ENDGE_SFC_BUILT_IN_TAGS: Set<RComponentSFC_IR_Tag>;
+/** Проверяет, является ли tag встроенным renderer-neutral SFC primitive. */
+export declare function isComponentSFCBuiltInTag(tag: string): tag is RComponentSFC_IR_Tag;

package/dist/model/services/compiler/component-sfc/component-sfc-compile.d.ts

@@ -0,0 +1,47 @@
+import { RComponentContract, RComponentDependencies, RComponentDiagnostic } from '../../../../domain/types/component/component-core.types';
+import { ComponentSFCPreviewOptions, ComponentSFCPreviewProps } from '../../../../domain/types/program/program.types';
+import { RComponentSFCSource_Parts, RComponentSFC_AST, RComponentSFC_IR, RComponentSFC_RuntimeDependencies, ComponentSFCPortManifest, ComponentSFCPortProviderDescriptor } from '../../../../domain/types/component/sfc';
+import { ProgramMetadata } from '../../../../domain/types/program/program-metadata.types';
+import { TypeSourceDefinition } from '../../../../domain/types/source/type-source.types';
+/** Результат полного SFC compiler pipeline в core. */
+export interface ComponentSFCCompileResult {
+    /** Разложенный canonical source. */
+    sourceParts: RComponentSFCSource_Parts;
+    /** Parser-level AST. */
+    ast: RComponentSFC_AST | null;
+    /** Target-neutral semantic IR. */
+    ir: RComponentSFC_IR | null;
+    /** Внешний контракт компонента. */
+    contract: RComponentContract;
+    /** Зависимости компонента. */
+    dependencies: RComponentDependencies;
+    /** Runtime-зависимости SFC v1, извлеченные из IR reads. */
+    runtimeDependencies: RComponentSFC_RuntimeDependencies;
+    /** Preview-only props для песочницы и debug UI. Не меняют contract. */
+    previewProps: ComponentSFCPreviewProps | null;
+    /** Preview-only runtime options для песочницы компонента. */
+    previewOptions: ComponentSFCPreviewOptions | null;
+    /** Все diagnostics pipeline. */
+    diagnostics: RComponentDiagnostic[];
+    /** Публичная metadata компонента и его template-узлов. */
+    metadata: ProgramMetadata;
+    /** Per-section status; style errors do not invalidate template rendering. */
+    sections: Record<'script' | 'template' | 'style', 'valid' | 'warning' | 'error'>;
+}
+/** Внешний registry-контекст, который связывает чистый SFC compiler с domain build. */
+export interface ComponentSFCCompileOptions {
+    /** Stable persisted identity used for the component style scope id. */
+    identity?: string;
+    /** Разрешает прямой пользовательский tag в identity компонента. */
+    resolveComponentTag?: (tag: string) => string | null;
+    /** Проверяет существование статической identity из Component is. */
+    hasComponentIdentity?: (identity: string) => boolean;
+    /** Resolves and describes a default port provider for build-time validation. */
+    resolvePortProvider?: (identity: string, expectedKind: 'computation' | 'component' | 'action') => ComponentSFCPortProviderDescriptor | null;
+    /** Resolves the compiled public port manifest of a nested SFC component. */
+    resolveComponentPortManifest?: (identity: string) => ComponentSFCPortManifest | null;
+    /** Resolves an external Type Registry definition used by a named SFC contract. */
+    resolveTypeDefinition?: (identity: string) => TypeSourceDefinition | null;
+}
+/** Компилирует Endge SFC source до target-neutral artifact для Endge.program. */
+export declare function compileComponentSFC(source: string, options?: ComponentSFCCompileOptions): ComponentSFCCompileResult;

package/dist/model/services/compiler/component-sfc/component-sfc-dependencies.d.ts

@@ -0,0 +1,3 @@
+import { RComponentSFC_IR, RComponentSFC_RuntimeDependencies } from '../../../../domain/types/component/sfc';
+/** Анализирует SFC IR и собирает runtime-зависимости от входных props. */
+export declare function analyzeComponentSFCRuntimeDependencies(ir: RComponentSFC_IR | null): RComponentSFC_RuntimeDependencies;

package/dist/model/services/compiler/component-sfc/component-sfc-expression.d.ts

@@ -0,0 +1,22 @@
+import { RComponentDiagnostic } from '../../../../domain/types/component/component-core.types';
+import { RComponentSFC_IR_Value } from '../../../../domain/types/component/sfc';
+/** Контекст анализа выражения SFC template/script. */
+export interface ComponentSFCExpressionContext {
+    /** Имена props, доступные выражению. */
+    props?: Iterable<string>;
+    /** Имена локальных bindings, доступные выражению. */
+    locals?: Iterable<string>;
+    /** Путь source для diagnostics. */
+    sourcePath?: string;
+}
+/** Результат компиляции expression в renderer-neutral IR value. */
+export interface ComponentSFCExpressionCompileResult {
+    /** Нормализованное значение IR. */
+    value: RComponentSFC_IR_Value;
+    /** Diagnostics, найденные при анализе expression. */
+    diagnostics: RComponentDiagnostic[];
+}
+/** Возвращает статический fallback из `t(key, fallback)` без i18n/runtime-контекста. */
+export declare function readComponentSFCTranslationFallback(source: string): string | null;
+/** Компилирует expression и извлекает reactive reads для runtime-подписок. */
+export declare function compileComponentSFCExpression(source: string, context?: ComponentSFCExpressionContext): ComponentSFCExpressionCompileResult;