@endge/core 4.0.3 → 6.0.0

package/dist/features/core/modules/auth/services/AuthRequestResolver.d.ts

@@ -0,0 +1,16 @@
+import { AuthRequestPolicy, AuthResolvedSession, AuthResolveOptions } from '../domain/types/auth-profile.types';
+import { AuthProfileRegistry } from './AuthProfileRegistry';
+import { AuthSessionManager } from './AuthSessionManager';
+import { AuthInteractionRequiredError } from '../domain/AuthInteractionRequiredError';
+/** Разрешает auth policy запроса без изменения sessions других profiles. */
+export declare class AuthRequestResolver {
+    private readonly _profiles;
+    private readonly _sessions;
+    private readonly _onInteractionRequired?;
+    constructor(_profiles: AuthProfileRegistry, _sessions: AuthSessionManager, _onInteractionRequired?: ((error: AuthInteractionRequiredError) => void) | undefined);
+    /** Возвращает transport-neutral credentials для none/inherit/profile policy. */
+    resolve(policy: AuthRequestPolicy, options?: AuthResolveOptions): Promise<AuthResolvedSession>;
+    /** Публикует типизированный сигнал host до завершения запроса с ошибкой. */
+    private _throwInteractionRequired;
+    private _publishAndThrow;
+}

package/dist/features/core/modules/auth/services/AuthSessionManager.d.ts

@@ -0,0 +1,61 @@
+import { AuthEnsureOptions, AuthProfileSchema, AuthResolvedSession, AuthSessionSource, AuthTokenSet, EndgeAuthContext } from '../domain/types/auth-profile.types';
+import { AuthAdapterRegistry } from './AuthAdapterRegistry';
+import { AuthProfileRegistry } from './AuthProfileRegistry';
+import { AuthSessionStore } from './AuthSessionStore';
+interface AuthSessionManagerDependencies {
+    getWorkspaceIdentity: () => string;
+    onSessionChange: () => void;
+    now?: () => number;
+}
+/** Владеет изолированными sessions runtime auth profiles. */
+export declare class AuthSessionManager {
+    private readonly _profiles;
+    private readonly _adapters;
+    private readonly _store;
+    private readonly _dependencies;
+    private readonly _states;
+    private readonly _operations;
+    private readonly _sources;
+    private readonly _now;
+    private _defaultProfile;
+    constructor(_profiles: AuthProfileRegistry, _adapters: AuthAdapterRegistry, _store: AuthSessionStore, _dependencies: AuthSessionManagerDependencies);
+    /** Runtime-профиль идентификации по умолчанию. */
+    get profileIdentity(): string | null;
+    /** Показывает наличие действующей session default runtime profile. */
+    get isAuthenticated(): boolean;
+    /** Безопасный actor/session context без tokens. */
+    get context(): EndgeAuthContext;
+    /** Claims default profile session только для presentation, не для authorization decisions. */
+    get claims(): Record<string, unknown>;
+    /** Загруженный OIDC userinfo default profile session. */
+    get userInfo(): Record<string, unknown> | null;
+    /** Выбирает default runtime profile и восстанавливает его snapshot. */
+    configureDefault(profile: AuthProfileSchema | null): void;
+    /** Подключает host-owned session source и запрещает смешивание с persisted snapshot profile. */
+    connect(profileIdentity: string, source: AuthSessionSource): void;
+    /** Гарантирует действующую session default runtime profile. */
+    ensureValid(options?: AuthEnsureOptions): Promise<boolean>;
+    /** Загружает userinfo для session default runtime profile. */
+    ensureUserInfo(): Promise<Record<string, unknown> | null>;
+    /** Завершает session default runtime profile и всегда очищает local snapshot. */
+    logout(): Promise<void>;
+    /** Гарантирует session указанного profile, не меняя default profile. */
+    ensureProfile(profileInput: AuthProfileSchema, options?: AuthEnsureOptions): Promise<AuthTokenSet | null>;
+    /** Преобразует token set в transport-neutral request session. */
+    toResolvedSession(profile: AuthProfileSchema, token: AuthTokenSet): AuthResolvedSession;
+    /** Сбрасывает runtime state, сохраняя local/sessionStorage snapshots. */
+    resetRuntime(): void;
+    private _authenticateWhenAllowed;
+    private _authenticate;
+    private _setState;
+    private _clearState;
+    private _defaultState;
+    private _isAccessTokenUsable;
+    private _isSessionUsable;
+    private _isAccessTokenFresh;
+    private _refreshSkewMs;
+    private _isRefreshExpired;
+    private _workspaceIdentity;
+    private _singleFlight;
+}
+export {};

package/dist/features/core/modules/auth/services/AuthSessionStore.d.ts

@@ -0,0 +1,20 @@
+import { AuthProfileSchema } from '../domain/types/auth-profile.types';
+import { AuthSessionSnapshot } from '../domain/types/auth-runtime.types';
+/** Хранит versioned token snapshots согласно profile persistence policy. */
+export declare class AuthSessionStore {
+    private readonly _memory;
+    private _namespace;
+    /** Устанавливает namespace, предоставленный host-приложением до restore/build. */
+    setNamespace(namespace: string | undefined): void;
+    /** Возвращает namespaced storage key для workspace/profile. */
+    getKey(workspaceIdentity: string, profileIdentity: string): string;
+    /** Восстанавливает snapshot и удаляет повреждённое значение. */
+    read(workspaceIdentity: string, profile: AuthProfileSchema): AuthSessionSnapshot | null;
+    /** Сохраняет token snapshot без credentials и userinfo. */
+    write(workspaceIdentity: string, profile: AuthProfileSchema, snapshot: AuthSessionSnapshot): void;
+    /** Удаляет session из всех поддерживаемых storage. */
+    remove(workspaceIdentity: string, profileIdentity: string): void;
+    /** Очищает только memory sessions при reset lifecycle. */
+    resetRuntime(): void;
+    private _storage;
+}

package/dist/features/core/modules/auth/services/auth-context.d.ts

@@ -0,0 +1,14 @@
+import { EndgeAuthContext } from '../domain/types/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/features/core/modules/compiler/EndgeCompiler_Module.d.ts

@@ -0,0 +1,240 @@
+import { EndgeBootContext } from '../../kernel/types/bootstrap.types';
+import { RStore } from '../domain/entities/RStore';
+import { RStream } from '../domain/entities/RStream';
+import { RStyle } from '../domain/entities/RStyle';
+import { RType } from '../domain/entities/RType';
+import { RUpdate } from '../domain/entities/RUpdate';
+import { RVocabs } from '../domain/entities/RVocabs';
+import { ActionProgramPayload, ComponentSFCProgramPayload, ComputationProgramPayload, DataViewProgramPayload, EndgeStyleProgramPayload, ProgramArtifact, ProgramEntityType, QueryProgramPayload } from '../program/domain/types/program.types';
+import { CompositionProgramPayload } from '../source/domain/types/composition-source.types';
+import { FilterProgramPayload } from '../source/domain/types/filter-source.types';
+import { StoreSourceArtifact } from '../source/domain/types/store-source.types';
+import { StreamSourceArtifact } from '../source/domain/types/stream-source.types';
+import { TypeProgramPayload } from '../source/domain/types/type-source.types';
+import { UpdateSourceArtifact } from '../source/domain/types/update-source.types';
+import { VocabProgramPayload } from '../source/domain/types/vocab-source.types';
+import { RAction } from '../domain/entities/RAction';
+import { RComponentSFC } from '../domain/entities/RComponentSFC';
+import { RComposition } from '../domain/entities/RComposition';
+import { RComputation } from '../domain/entities/RComputation';
+import { RDataView } from '../domain/entities/RDataView';
+import { RFilter } from '../domain/entities/RFilter';
+import { RQuery } from '../domain/entities/RQuery';
+import { EndgeModule } from '../../../federation/EndgeModule';
+/**
+ * Компилятор persisted domain model в compiled program artifacts.
+ */
+export declare class EndgeCompiler_Module extends EndgeModule<EndgeBootContext> {
+    /** Хранит compiler handlers, локальные counters, component caches и активный diagnostics span. */
+    private readonly _handlers;
+    private _localDataViewCounter;
+    private _localFilterCounter;
+    private _componentTagDiagnosticsByIdentity;
+    private _componentPortManifestCache;
+    private _componentPortManifestResolving;
+    private _compileSpan;
+    /**
+     * ----------------------------------------
+     * PUBLIC
+     * ----------------------------------------
+     */
+    /**
+     * Создает singleton-bound compiler module и регистрирует стандартные handlers.
+     *
+     * Регистрация выполняется один раз при создании модуля, чтобы build-фаза
+     * только запускала pipeline и не пересобирала таблицу обработчиков.
+     */
+    constructor();
+    /** Возвращает фактически зарегистрированные compiler entity types для contract verification. */
+    listSupportedEntityTypes(): ProgramEntityType[];
+    /**
+     * Lifecycle-точка входа компилятора.
+     *
+     * На build-фазе читает текущий `Endge.domain`, очищает/начинает новый
+     * `Endge.program` compile cycle и строит artifacts для сущностей.
+     */
+    build(_ctx: EndgeBootContext): void;
+    /** Компилирует один query source в Endge.program без запуска остальных compiler-фаз. */
+    buildQuery(entity: RQuery): ProgramArtifact<QueryProgramPayload>;
+    /** Компилирует один Vocab source в Endge.program. */
+    buildVocab(entity: RVocabs): ProgramArtifact<VocabProgramPayload>;
+    /** Компилирует одну Computation в безопасный runtime artifact. */
+    buildComputation(entity: RComputation): ProgramArtifact<ComputationProgramPayload>;
+    /** Компилирует один Type Source в общий Type Registry. */
+    buildType(entity: RType): ProgramArtifact<TypeProgramPayload>;
+    /** Компилирует один сохранённый Action в неизменяемый артефакт Program. */
+    buildAction(entity: RAction): ProgramArtifact<ActionProgramPayload>;
+    /** Компилирует один ComponentSFC без запуска полного domain build. */
+    buildComponentSFC(entity: RComponentSFC): ProgramArtifact<ComponentSFCProgramPayload>;
+    /** Компилирует один DataView source в Endge.program без запуска остальных compiler-фаз. */
+    buildDataView(entity: RDataView): ProgramArtifact<DataViewProgramPayload>;
+    /** Компилирует один Store source в Endge.program. */
+    buildStore(entity: RStore): ProgramArtifact<StoreSourceArtifact>;
+    /** Компилирует один Stream source в Endge.program. */
+    buildStream(entity: RStream): ProgramArtifact<StreamSourceArtifact>;
+    /** Компилирует один дочерний Update source в Endge.program. */
+    buildUpdate(entity: RUpdate): ProgramArtifact<UpdateSourceArtifact>;
+    /** Компилирует один Filter source в Endge.program. */
+    buildFilter(entity: RFilter): ProgramArtifact<FilterProgramPayload>;
+    /** Компилирует один Composition source в Endge.program. */
+    buildComposition(entity: RComposition): ProgramArtifact<CompositionProgramPayload>;
+    /**
+     * Компилирует transient Composition artifact без публикации в Endge.program.
+     * Используется runtime session overlays, которым нельзя менять общий build.
+     */
+    compileCompositionArtifact(entity: RComposition): ProgramArtifact<CompositionProgramPayload>;
+    /** Компилирует один глобальный source-first документ EndgeCSS. */
+    buildStyle(entity: RStyle): ProgramArtifact<EndgeStyleProgramPayload>;
+    /**
+     * ----------------------------------------
+     * PRIVATE
+     * ----------------------------------------
+     */
+    /** Собирает полный registry встроенных compiler handlers для поддерживаемых Domain documents. */
+    private _registerDefaultHandlers;
+    /**
+     * Регистрирует handler компиляции для поддерживаемого program entity.
+     *
+     * Сейчас используется только для встроенной SFC-регистрации.
+     */
+    private _registerHandler;
+    /** Создаёт единый immutable context для полного и точечного compiler entry points. */
+    private _createCompileContext;
+    /**
+     * Компилирует однотипную фазу доменных сущностей через зарегистрированный handler.
+     *
+     * Метод отвечает за единый diagnostics span, обработку ошибок и перевод
+     * `Endge.program` в error status при неуспешной фазе.
+     */
+    private _compilePhase;
+    /**
+     * Компилирует одну доменную сущность и добавляет artifact в активный `Endge.program`.
+     *
+     * Само преобразование делегируется handler-у, зарегистрированному для
+     * конкретного `ProgramEntityType`.
+     */
+    private _compileEntity;
+    /** Стабильный порядок исходников: сначала системные документы, затем авторские по identity. */
+    private _orderedStyles;
+    /** Возвращает static artifact dependencies внешних computation calls. */
+    private _computationDependencies;
+    /** Проверяет контракт одного владельца по Type Registry, построенному из исходников. */
+    private _typeContractDiagnostics;
+    /** Создаёт стабильные зависимости Program для каждого выражения пользовательского типа. */
+    private _typeDependencies;
+    /** Публикует статическую ссылку Query на профиль авторизации в общем графе Program. */
+    private _queryAuthDependencies;
+    /** Добавляет явные зависимости RMock, используемые только fixtures preview для Composition. */
+    private _compositionPreviewDependencies;
+    /** Диагностика preview остаётся предупреждением, чтобы сломанный fixture не делал production-выполнение невалидным. */
+    private _compositionPreviewDiagnostics;
+    /** Связывает computation artifacts, запрещает missing/invalid/cyclic references и выводит effective execution mode. */
+    private _linkComputations;
+    /** Добавляет linker diagnostic без duplicate сообщений и обновляет artifact status. */
+    private _addComputationLinkDiagnostic;
+    /** Находит strongly connected components, которые образуют реальные cycles. */
+    private _findComputationCycles;
+    /** Восстанавливает один точный cycle path внутри strongly connected component. */
+    private _findCyclePath;
+    /** Компилирует один исходник SFC и кеширует его вычисленный манифест публичных портов для проброса родителем. */
+    private _compileComponentSFCSource;
+    /** Читает явные имена корневых Variant без рекурсивной компиляции дочернего элемента. */
+    private _resolveComponentVariantNames;
+    /** Вычисляет публичные порты дочернего элемента независимо от порядка компиляции доменных компонентов. */
+    private _resolveComponentPortManifest;
+    /** Вычисляет Type Source независимо от порядка компиляции типов и компонентов. */
+    private _resolveTypeDefinition;
+    /** Материализует итоговые предоставленные и проброшенные порты SFC Action как производные дескрипторы. */
+    private _materializeProvidedActions;
+    /** Вычисляет дескриптор доменного provider без зависимости от порядка компиляции SFC. */
+    private _resolvePortProvider;
+    /**
+     * Строит registry пользовательских SFC tags до компиляции templates.
+     *
+     * В registry попадают только однозначные tags. Конфликты остаются persisted,
+     * но превращают artifacts всех владельцев tag в error на build-фазе.
+     */
+    private _prepareComponentTagRegistry;
+    /** Добавляет build diagnostic владельцу persisted SFC tag. */
+    private _addComponentTagDiagnostic;
+    /** Связывает каждый внешний шаг Action с каталогами storage или установленного кода. */
+    private _linkActionDependencies;
+    /**
+     * Создает унифицированный `ProgramArtifact` из доменной сущности и payload.
+     *
+     * Метод централизует ref, source hash, diagnostics, status, capabilities
+     * и compiler version, чтобы handlers описывали только payload-специфику.
+     */
+    private _makeArtifact;
+    /** Материализует локальные DataView внутри query output graph в child artifacts. */
+    private _materializeResponseOutputDataViews;
+    /** Сворачивает цепочку DataView: byKey допустим только при одинаковом доказанном ключе. */
+    private _resolveDataViewChainStrategy;
+    /** Рекурсивно ищет локальный DataView artifact среди дочерних artifacts. */
+    private _findDataViewChild;
+    /** Материализует локальные Filter defaults query props в child artifacts. */
+    private _materializeQueryLocalFilters;
+    /** Компилирует owned Filter artifact без регистрации в Endge.program. */
+    private _compileLocalFilterArtifact;
+    /** Материализует i18n resources в Composition program artifact. */
+    private _materializeCompositionI18n;
+    /**
+     * Запрещает неявный override одного public translation key вдоль
+     * Composition/scope ancestry. Разные aliases остаются независимыми.
+     */
+    private _compositionI18nCollisionDiagnostics;
+    /** Проверяет domain/program references и stable-prop bindings Composition. */
+    private _validateComposition;
+    /** Сортирует Composition так, чтобы compiled artifact зависимости появился раньше consumer. */
+    private _orderCompositionsForCompile;
+    /** Проверяет достижимость Composition dependency для compile-time cycle diagnostics. */
+    private _compositionDependsOn;
+    /** Читает только прямые Composition dependencies из source без создания Program artifact. */
+    private _compositionDependencies;
+    /** Материализует локальные DataView внутри DataView pipeline steps в child artifacts. */
+    private _materializeDataViewLocalDataViews;
+    /** Материализует локальные DataView refs внутри pipeline steps. */
+    private _materializeDataViewRefsInSteps;
+    /** Заменяет inline DataView refs на local refs и собирает external dependencies. */
+    private _materializeDataViewRefs;
+    /** Компилирует локальный DataView source в child artifact без записи в Endge.program. */
+    private _compileLocalDataViewArtifact;
+    /**
+     * Строит стабильную ссылку artifact на исходную доменную сущность.
+     *
+     * Ссылка используется для diagnostics, indexes и поиска в read-model.
+     */
+    private _makeRef;
+    /** Переносит pure entity validation result в diagnostics compiled artifact. */
+    private _collectEntityDiagnostics;
+    /**
+     * Формирует стабильный input для hash-а artifact.
+     *
+     * Сюда входят только поля, изменение которых должно инвалидировать
+     * compiled artifact на уровне program read-model.
+     */
+    private _toStableSource;
+    /** Возвращает сохраненный query source. Legacy generation больше не используется runtime compiler-ом. */
+    private _resolveQuerySource;
+    /** Возвращает сохраненный DataView source. */
+    private _resolveDataViewSource;
+    /** Возвращает Filter source без fallback на legacy fields. */
+    private _resolveFilterSource;
+    /** Возвращает сохраненный Composition source. */
+    private _resolveCompositionSource;
+    /** Создает пустой query payload для error-artifact. */
+    private _makeEmptyQueryPayload;
+    /** Создает пустой Filter payload для error-artifact. */
+    private _makeEmptyFilterPayload;
+    /** Создает пустой Composition payload для error-artifact. */
+    private _makeEmptyCompositionPayload;
+    /** Создает пустой DataView payload для error-artifact. */
+    private _makeEmptyDataViewPayload;
+    /**
+     * Возвращает короткий deterministic hash для source snapshot artifact.
+     *
+     * Хеш не является криптографическим; он нужен только как дешёвый marker
+     * изменения входных данных компиляции.
+     */
+    private _hashString;
+}

package/dist/features/core/modules/compiler/services/action/action-compile.d.ts

@@ -0,0 +1,9 @@
+import { RAction } from '../../../domain/entities/RAction';
+import { ActionProgramPayload, ProgramDependency, ProgramDiagnostic } from '../../../program/domain/types/program.types';
+export interface ActionCompileResult {
+    payload: ActionProgramPayload;
+    diagnostics: Omit<ProgramDiagnostic, 'entityRef'>[];
+    dependencies: ProgramDependency[];
+}
+/** Компилирует сохранённый Source Action в Program. */
+export declare function compileAction(entity: RAction): ActionCompileResult;

package/dist/features/core/modules/compiler/services/action/action-target-validation.d.ts

@@ -0,0 +1,10 @@
+import { ActionExecutionTarget, ActionTargetSelector } from '../../../actions/domain/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);
+}
+/** Нормализует и проверяет контракт authoring-цели. */
+export declare function normalizeActionTargets(value: unknown): ActionTargetSelector[] | null;
+/** Проверяет одну конкретную runtime-цель по альтернативным селекторам. */
+export declare function validateActionTarget(selectors: readonly ActionTargetSelector[] | null, target: ActionExecutionTarget | undefined): void;

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-attributes.d.ts

@@ -0,0 +1,9 @@
+import { RComponentContractInput, RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_AST } from '../../../domain/types/component/sfc/ast.types';
+import { ComponentSFCAttributeAnalysisOptions, ComponentSFCTagAttributeContract } from '../../../domain/types/component/sfc/tag-attribute-contract.types';
+/** Проверяет статические значения конечных SFC-атрибутов по renderer-neutral контрактам. */
+export declare function validateComponentSFCAttributeValues(source: string, ast: RComponentSFC_AST | null, options?: ComponentSFCAttributeAnalysisOptions): RComponentDiagnostic[];
+/** Возвращает встроенные и подключенные извне контракты без повторов имён. */
+export declare function resolveComponentSFCTagAttributeContracts(tag: string, options?: ComponentSFCAttributeAnalysisOptions): readonly ComponentSFCTagAttributeContract[];
+/** Преобразует literal-union inputs пользовательского компонента в editor-контракты. */
+export declare function createComponentSFCAttributeContractsFromInputs(inputs: readonly RComponentContractInput[]): ComponentSFCTagAttributeContract[];

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-built-in-tags.d.ts

@@ -0,0 +1,4 @@
+import { RComponentSFC_IR_Tag } from '../../../domain/types/component/sfc/ir.types';
+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/features/core/modules/compiler/services/component-sfc/component-sfc-compile.d.ts

@@ -0,0 +1,56 @@
+import { EndgeSFCEditingConfiguration } from '../../../configuration/domain/types/configuration.type';
+import { RComponentContract, RComponentDependencies, RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_AST } from '../../../domain/types/component/sfc/ast.types';
+import { RComponentSFC_RuntimeDependencies } from '../../../domain/types/component/sfc/dependencies.types';
+import { RComponentSFC_IR } from '../../../domain/types/component/sfc/ir.types';
+import { ComponentSFCPortManifest, ComponentSFCPortProviderDescriptor } from '../../../domain/types/component/sfc/ports.types';
+import { RComponentSFCSource_Parts } from '../../../domain/types/component/sfc/source.types';
+import { ProgramMetadata } from '../../../program/domain/types/program-metadata.types';
+import { ComponentSFCPreviewOptions, ComponentSFCPreviewProps } from '../../../program/domain/types/program.types';
+import { TypeSourceDefinition } from '../../../source/domain/types/type-source.types';
+/** Результат полного SFC compiler pipeline в core. */
+export interface ComponentSFCCompileResult {
+    /** Разложенный canonical source. */
+    sourceParts: RComponentSFCSource_Parts;
+    /** AST уровня parser. */
+    ast: RComponentSFC_AST | null;
+    /** Семантический 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;
+    /** Статус каждой секции; ошибки style не отменяют отображение template. */
+    sections: Record<'script' | 'template' | 'style', 'valid' | 'warning' | 'error'>;
+}
+/** Внешний registry-контекст, который связывает чистый SFC compiler с domain build. */
+export interface ComponentSFCCompileOptions {
+    /** Стабильный сохранённый идентификатор для scope id стилей компонента. */
+    identity?: string;
+    /** Разрешает прямой пользовательский tag в identity компонента. */
+    resolveComponentTag?: (tag: string) => string | null;
+    /** Проверяет существование статической identity из Component is. */
+    hasComponentIdentity?: (identity: string) => boolean;
+    /** Определяет и описывает провайдер порта по умолчанию для проверки при сборке. */
+    resolvePortProvider?: (identity: string, expectedKind: 'computation' | 'component' | 'action' | 'query') => ComponentSFCPortProviderDescriptor | null;
+    /** Определяет скомпилированный публичный манифест портов вложенного SFC-компонента. */
+    resolveComponentPortManifest?: (identity: string) => ComponentSFCPortManifest | null;
+    /** Определяет явные корневые variants одного вложенного пользовательского компонента. */
+    resolveComponentVariants?: (identity: string) => string[] | null;
+    /** Определяет внешнее объявление Type Registry для именованного контракта SFC. */
+    resolveTypeDefinition?: (identity: string) => TypeSourceDefinition | null;
+    /** Effective edit-session defaults из immutable build context. */
+    sfcEditing?: EndgeSFCEditingConfiguration;
+}
+/** Компилирует Endge SFC source до target-neutral artifact для Endge.program. */
+export declare function compileComponentSFC(source: string, options?: ComponentSFCCompileOptions): ComponentSFCCompileResult;

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-dependencies.d.ts

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

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-expression.d.ts

@@ -0,0 +1,48 @@
+import { EndgeRuntimeContextSnapshot } from '../../../context/domain/context-persistence.types';
+import { RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_IR_Value } from '../../../domain/types/component/sfc/ir.types';
+import { EndgeConfigurationSchemaEntry } from '../../../source/domain/types/configuration-source.types';
+/** Контекст анализа выражения 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[];
+}
+export type ComponentSFCExpressionCompletionScope = 'table-row-menu' | 'table-column-menu';
+export interface ComponentSFCExpressionCompletionRequest {
+    source: string;
+    cursor: number;
+    scope: ComponentSFCExpressionCompletionScope;
+    context?: Readonly<EndgeRuntimeContextSnapshot> | Record<string, unknown>;
+    configurations?: Iterable<EndgeConfigurationSchemaEntry>;
+}
+export interface ComponentSFCExpressionCompletion {
+    label: string;
+    insertText: string;
+    kind: 'variable' | 'property' | 'configuration';
+    detail: string;
+    documentation?: string;
+    replace: {
+        start: number;
+        end: number;
+    };
+}
+/**
+ * Возвращает renderer-neutral подсказки для SFC expression в точной lexical
+ * области. UI отвечает только за отображение и применение replacement range.
+ */
+export declare function resolveComponentSFCExpressionCompletions(request: ComponentSFCExpressionCompletionRequest): ComponentSFCExpressionCompletion[];
+/** Возвращает статический 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;

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-forward.d.ts

@@ -0,0 +1,19 @@
+import { RComponentDependencies, RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_IR_Template } from '../../../domain/types/component/sfc/ir.types';
+import { ComponentSFCPortManifest } from '../../../domain/types/component/sfc/ports.types';
+export interface ComponentSFCPortForwardOptions {
+    resolveComponentPortManifest?: (identity: string) => ComponentSFCPortManifest | null;
+}
+export interface ComponentSFCPortForwardResult {
+    diagnostics: RComponentDiagnostic[];
+    dependencies: RComponentDependencies;
+}
+/** Сопоставляет статические правила forward с bindings компонентов этого template SFC. */
+export declare function resolveComponentSFCPortForwards(manifest: ComponentSFCPortManifest, template: RComponentSFC_IR_Template | null, options?: ComponentSFCPortForwardOptions): ComponentSFCPortForwardResult;
+/** Возвращает собственный публичный манифест встроенного компонента, нейтрального к renderer. */
+export declare function createBuiltInComponentPortManifest(tag: string): ComponentSFCPortManifest | null;
+/** Встроенные манифесты, используемые компилятором и frontend-каталогами событий. */
+export declare function listBuiltInComponentPortManifests(): Array<{
+    tag: string;
+    manifest: ComponentSFCPortManifest;
+}>;

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-interactions.d.ts

@@ -0,0 +1,12 @@
+import { RComponentDependencies, RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_AST_Attribute } from '../../../domain/types/component/sfc/ast.types';
+import { RComponentSFC_IR_EventModifier, RComponentSFC_IR_InteractionGroup } from '../../../domain/types/component/sfc/ir.types';
+import { ComponentSFCPortManifest } from '../../../domain/types/component/sfc/ports.types';
+export interface ComponentSFCInteractionCompileContext {
+    props: string[];
+    locals: string[];
+}
+/** Статически обнаруживает недопустимые сочетания passive и prevent в общих описателях trigger. */
+export declare function hasComponentSFCPassivePreventConflict(source: string, suffixes?: readonly RComponentSFC_IR_EventModifier[]): boolean;
+/** Компилирует одну принадлежащую Source аннотацию `:on` в нейтральные к renderer правила. */
+export declare function compileComponentSFCInteractionAnnotation(attribute: RComponentSFC_AST_Attribute, manifest: ComponentSFCPortManifest | null, context: ComponentSFCInteractionCompileContext, dependencies: RComponentDependencies, diagnostics: RComponentDiagnostic[], ownerPorts?: ComponentSFCPortManifest | null): RComponentSFC_IR_InteractionGroup | null;

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-parse.d.ts

@@ -0,0 +1,14 @@
+import { RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_AST } from '../../../domain/types/component/sfc/ast.types';
+import { RComponentSFCSource_Parts } from '../../../domain/types/component/sfc/source.types';
+/** Результат parser pass для SFC-компонента. */
+export interface ComponentSFCParseResult {
+    /** Разложенный source для editor/debug UI. */
+    sourceParts: RComponentSFCSource_Parts;
+    /** Stable AST, независимый от внутренних типов Vue parser. */
+    ast: RComponentSFC_AST | null;
+    /** Диагностический проход parser. */
+    diagnostics: RComponentDiagnostic[];
+}
+/** Разбирает SFC source в stable AST без построения semantic IR. */
+export declare function parseComponentSFC(source: string): ComponentSFCParseResult;

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-ports.d.ts

@@ -0,0 +1,21 @@
+import { RComponentDependencies, RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_AST_Script } from '../../../domain/types/component/sfc/ast.types';
+import { ComponentSFCEventAction, ComponentSFCPortManifest, ComponentSFCPortProviderDescriptor, RComponentSFC_IR_PortCall } from '../../../domain/types/component/sfc/ports.types';
+import { TypeSourceDefinition } from '../../../source/domain/types/type-source.types';
+export interface ComponentSFCPortAnalysisOptions {
+    resolveProvider?: (identity: string, expectedKind: 'computation' | 'component' | 'action' | 'query') => ComponentSFCPortProviderDescriptor | null;
+    resolveTypeDefinition?: (identity: string) => TypeSourceDefinition | null;
+}
+/** Компилирует одну прямую реакцию или непустой упорядоченный массив реакций. */
+export declare function compileComponentSFCLocalEventActions(eventName: string, source: string, sourceOffset: number, dependencies: RComponentDependencies, diagnostics: RComponentDiagnostic[], ownerPorts?: ComponentSFCPortManifest | null): ComponentSFCEventAction[];
+/** Компилирует безопасную грамматику реакций для локальных template bindings `@event`. */
+export declare function compileComponentSFCLocalEventAction(eventName: string, source: string, sourceOffset: number, dependencies: RComponentDependencies, diagnostics: RComponentDiagnostic[], ownerPorts?: ComponentSFCPortManifest | null): ComponentSFCEventAction | null;
+export interface ComponentSFCPortAnalysisResult {
+    manifest: ComponentSFCPortManifest;
+    calls: RComponentSFC_IR_PortCall[];
+    dependencies: RComponentDependencies;
+    diagnostics: RComponentDiagnostic[];
+    bindingName: string | null;
+}
+/** Разбирает `definePorts` и локальные порты вычислений верхнего уровня из script setup. */
+export declare function analyzeComponentSFCPorts(script: RComponentSFC_AST_Script | null, dependencies: RComponentDependencies, options?: ComponentSFCPortAnalysisOptions): ComponentSFCPortAnalysisResult;

package/dist/features/core/modules/compiler/services/component-sfc/component-sfc-script.d.ts

@@ -0,0 +1,30 @@
+import { RComponentContract, RComponentDiagnostic } from '../../../domain/types/component/component-core.types';
+import { RComponentSFC_AST_Script } from '../../../domain/types/component/sfc/ast.types';
+import { RComponentSFC_IR_LocalBinding, RComponentSFC_IR_Prop } from '../../../domain/types/component/sfc/ir.types';
+import { ProgramMetadataMap } from '../../../program/domain/types/program-metadata.types';
+import { ComponentSFCPreviewOptions, ComponentSFCPreviewProps } from '../../../program/domain/types/program.types';
+import { TypeSourceDefinition } from '../../../source/domain/types/type-source.types';
+export interface ComponentSFCTypeResolutionOptions {
+    resolveTypeDefinition?: (identity: string) => TypeSourceDefinition | null;
+}
+/** Результат анализа script-секции SFC. */
+export interface ComponentSFCScriptAnalysisResult {
+    /** Контракт компонента, извлеченный из defineProps. */
+    contract: RComponentContract;
+    /** IR props компонента. */
+    props: RComponentSFC_IR_Prop[];
+    /** Локальные bindings script setup. */
+    locals: RComponentSFC_IR_LocalBinding[];
+    /** Preview-only props для SFC Playground. Не входят в runtime contract. */
+    previewProps: ComponentSFCPreviewProps | null;
+    /** Preview-only runtime options для запуска песочницы компонента. */
+    previewOptions: ComponentSFCPreviewOptions | null;
+    /** Публичная metadata компонента из defineMetadata. */
+    metadata: ProgramMetadataMap;
+    /** Диагностический проход script. */
+    diagnostics: RComponentDiagnostic[];
+}
+/** Анализирует script setup и извлекает контракт/locals для IR. */
+export declare function analyzeComponentSFCScript(script: RComponentSFC_AST_Script | null, options?: ComponentSFCTypeResolutionOptions): ComponentSFCScriptAnalysisResult;
+/** Определяет inline или именованные TypeScript-контракты объектов, используемые макросами SFC. */
+export declare function parseComponentSFCTypeFields(source: string, scriptContent?: string, options?: ComponentSFCTypeResolutionOptions): RComponentSFC_IR_Prop[];