@endge/core 1.2.5 → 1.2.8

package/dist/domain/types/auth/auth-profile.types.d.ts

@@ -0,0 +1,50 @@
+export type AuthProfileAdapterId = 'keycloak_manual' | 'keycloak_form' | 'manual_token';
+export type AuthProfilePersist = 'localStorage' | 'sessionStorage' | 'memory';
+export interface AuthProfileConfig {
+    [key: string]: unknown;
+}
+export interface AuthProfileCredentialRefs {
+    [key: string]: string | undefined;
+}
+export interface AuthProfileSchema {
+    id: string | number;
+    identity: string;
+    name: string;
+    displayName: string;
+    description?: string | null;
+    adapterId: AuthProfileAdapterId;
+    config: AuthProfileConfig;
+    credentialRefs: AuthProfileCredentialRefs;
+    persist: AuthProfilePersist;
+    folderId?: string | number | null;
+    active: boolean;
+    deletedAt?: string | null;
+    meta?: Record<string, unknown>;
+}
+export interface AuthSession {
+    accessToken?: string;
+    headers?: Record<string, string>;
+    expiresAt?: number | null;
+    subject?: string | null;
+    sessionId?: string | null;
+    claims?: Record<string, unknown>;
+    raw?: unknown;
+}
+/** Минимальный синхронный auth context без tokens и полного claims payload. */
+export interface EndgeAuthContext {
+    authenticated: boolean;
+    subject?: string;
+    sessionId?: string;
+    profileIdentity?: string;
+}
+export interface AuthProfileAdapterContext {
+    profile: AuthProfileSchema;
+    manualToken?: string;
+    credentials?: Record<string, string>;
+}
+export interface AuthProfileAdapter {
+    id: AuthProfileAdapterId | string;
+    label: string;
+    resolve(ctx: AuthProfileAdapterContext): Promise<AuthSession>;
+    logout?(ctx: AuthProfileAdapterContext): Promise<void>;
+}

package/dist/domain/types/{auth.types.d.ts → auth/auth.types.d.ts}

@@ -36,9 +36,9 @@ export type AuthConfig = NoneAuthConfig | KeycloakBasicConfig;
 /** Ответ Keycloak при выдаче/рефреше токена (строго типизированный). */
 export interface KeycloakTokenResponse {
     access_token: string;
-    expires_in: number;
-    refresh_expires_in: number;
-    refresh_token: string;
+    expires_in?: number;
+    refresh_expires_in?: number;
+    refresh_token?: string;
     token_type: 'Bearer';
     id_token?: string;
     'not-before-policy'?: number;
@@ -66,15 +66,11 @@ export interface AuthSnapshot {
 export interface StoredAuthToken {
     access_token: string;
     refresh_token?: string;
+    id_token?: string;
+    session_state?: string;
     access_expires: string;
     refresh_expires?: string;
 }
-export interface KeycloakTokenResponse {
-    access_token: string;
-    refresh_token?: string;
-    expires_in?: number;
-    refresh_expires_in?: number;
-}
 export type EndgeTokenMode = 'inherit' | 'manual' | 'none';
 export interface GetAccessTokenOpts {
     mode?: EndgeTokenMode;

package/dist/domain/types/auth/index.d.ts

@@ -0,0 +1,2 @@
+export * from './auth.types';
+export * from './auth-profile.types';

package/dist/domain/types/component/component-core.types.d.ts

@@ -0,0 +1,87 @@
+/** Цель рендера, под которую компонент может быть скомпилирован. */
+export type RComponentRenderTarget = 'dom' | 'canvas';
+/** Источник описания компонента в новой ветке модели. */
+export type RComponentSourceKind = 'component-sfc';
+/** Уровень диагностического сообщения компилятора компонента. */
+export type RComponentDiagnosticSeverity = 'info' | 'warning' | 'error';
+/** Ссылка на компонент из чистого SFC-хранилища новой версии. */
+export interface RComponentRef {
+    /** Тип хранилища, в котором лежит новый компонент. */
+    source: 'component-sfc';
+    /** Идентификатор компонента внутри выбранного хранилища. */
+    id: string | number;
+    /** Semantic dependency role in the compiled artifact. */
+    role?: 'child-component' | 'port-default-component';
+}
+/** Ссылка SFC-компонента на computation provider. */
+export interface RComputationRef {
+    source: 'computation';
+    id: string | number;
+    role: 'port-default-computation';
+}
+/** Описание одного сообщения компилятора или валидатора. */
+export interface RComponentDiagnostic {
+    /** Уровень важности сообщения. */
+    severity: RComponentDiagnosticSeverity;
+    /** Машинный код ошибки или предупреждения. */
+    code: string;
+    /** Человекочитаемое описание проблемы. */
+    message: string;
+    /** Опциональный путь до секции source: script/template/style. */
+    sourcePath?: string;
+    /** Начальная позиция в source, если она известна компилятору. */
+    start?: number;
+    /** Конечная позиция в source, если она известна компилятору. */
+    end?: number;
+}
+/** Контракт входных данных компонента. */
+export interface RComponentContractInput {
+    /** Имя входного параметра, доступное в template/script. */
+    name: string;
+    /** Тип входного параметра в доменной модели. */
+    type: string;
+    /** Флаг массива для простого отображения в UI конфигуратора. */
+    isArray?: boolean;
+    /** Флаг необязательного параметра. */
+    optional?: boolean;
+}
+/** Контракт события, которое компонент может отправить наружу. */
+export interface RComponentContractEvent {
+    /** Имя события, объявленное в definePorts.emits. */
+    name: string;
+    /** Описание полезной нагрузки события. */
+    payloadType?: string;
+}
+/** Контракт slot, который компонент разрешает переопределять. */
+export interface RComponentContractSlot {
+    /** Имя slot, default используется для содержимого без имени. */
+    name: string;
+    /** Имена параметров, которые slot получает в scope. */
+    scope?: string[];
+}
+/** Контракт компонента, извлеченный из source. */
+export interface RComponentContract {
+    /** Входные данные компонента. */
+    inputs: RComponentContractInput[];
+    /** События, которые компонент может emit-ить. */
+    events: RComponentContractEvent[];
+    /** Slot-ы, которые компонент предоставляет. */
+    slots: RComponentContractSlot[];
+}
+/** Набор внешних зависимостей, найденных при компиляции компонента. */
+export interface RComponentDependencies {
+    /** Дочерние компоненты, на которые ссылается template. */
+    components: RComponentRef[];
+    /** Computation providers required by source ports. */
+    computations: RComputationRef[];
+    /** Действия, которые вызываются из handlers или bindings. */
+    actions: string[];
+    /** Источники данных, которые компонент читает напрямую. */
+    dataSources: string[];
+    /** Внешние render/capability ссылки. */
+    renderers: string[];
+}
+/** Пустой контракт нужен, чтобы compile всегда возвращал предсказуемую форму. */
+export declare function createEmptyComponentContract(): RComponentContract;
+/** Пустой набор зависимостей используется перед каждым новым проходом compile. */
+export declare function createEmptyComponentDependencies(): RComponentDependencies;

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

@@ -0,0 +1,12 @@
+import { RComponentDSL } from '../../entities/reflect/RComponentDSL';
+import { RComponentSFC } from '../../entities/reflect/RComponentSFC';
+import { RComponentTable } from '../../entities/reflect/RComponentTable';
+import { ComponentType } from '../document/document.types';
+/** Legacy-компоненты, которые уже используются в таблицах. */
+export type RComponent = RComponentDSL | RComponentTable;
+/** Любой компонент доменной модели, включая новую чистую SFC-ветку. */
+export type RAnyComponent = RComponent | RComponentSFC;
+/**
+ * Разновидности типов компонентов, которые могут быть встроены в таблицу
+ */
+export type ColumnComponentType = ComponentType.Html | ComponentType.Component;

package/dist/domain/types/component/index.d.ts

@@ -0,0 +1,3 @@
+export * from './component-core.types';
+export * from './component.types';
+export * from './sfc';

package/dist/domain/types/component/sfc/ast.types.d.ts

@@ -0,0 +1,144 @@
+import { RComponentSFC_SourceRange } from './location.types';
+/** Parser-level AST SFC source до построения семантического IR. */
+export interface RComponentSFC_AST {
+    /** Версия AST-модели. */
+    version: 1;
+    /** Разобранная script-секция. */
+    script: RComponentSFC_AST_Script | null;
+    /** Разобранная template-секция. */
+    template: RComponentSFC_AST_Template | null;
+    /** Разобранная style-секция. */
+    style: RComponentSFC_AST_Style | null;
+}
+/** AST script setup секции. */
+export interface RComponentSFC_AST_Script {
+    /** Язык script-секции: ts, js или другое значение из source. */
+    lang: string | null;
+    /** Флаг script setup. Для Endge SFC v1 ожидается true. */
+    setup: boolean;
+    /** Полный текст script-секции без внешнего тега. */
+    content: string;
+    /** Синтаксическое объявление defineProps, если оно найдено. */
+    props: RComponentSFC_AST_PropsDeclaration | null;
+    /** Preview-only значения props для песочницы, если найден definePreviewProps. */
+    previewProps: RComponentSFC_AST_PreviewPropsDeclaration | null;
+    /** Статические объявления публичной metadata компонента. */
+    metadata: RComponentSFC_AST_MetadataDeclaration[];
+    /** Верхнеуровневые bindings, найденные в script. */
+    bindings: RComponentSFC_AST_ScriptBinding[];
+    /** Позиция script-секции в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST объявления defineProps. */
+export interface RComponentSFC_AST_PropsDeclaration {
+    /** Исходный текст generic-типа или runtime-объекта props. */
+    source: string;
+    /** Формат объявления props. */
+    mode: 'type' | 'runtime';
+    /** Позиция объявления defineProps в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST объявления definePreviewProps. */
+export interface RComponentSFC_AST_PreviewPropsDeclaration {
+    /** Исходный текст первого аргумента, переданного в definePreviewProps. */
+    source: string;
+    /** Исходный текст второго аргумента preview options, если он указан. */
+    optionsSource?: string | null;
+    /** Позиция объявления definePreviewProps в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST объявления `defineMetadata({...})` внутри script setup. */
+export interface RComponentSFC_AST_MetadataDeclaration {
+    /** Исходный текст object literal, переданного в defineMetadata. */
+    source: string;
+    /** Позиция полного вызова defineMetadata в SFC source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST binding из script setup. */
+export interface RComponentSFC_AST_ScriptBinding {
+    /** Имя binding, доступное template-компилятору. */
+    name: string;
+    /** Синтаксический тип binding. */
+    kind: 'prop' | 'const' | 'let' | 'function' | 'import' | 'store' | 'unknown';
+    /** Позиция binding в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST template секции. */
+export interface RComponentSFC_AST_Template {
+    /** Корневые узлы template. */
+    roots: RComponentSFC_AST_TemplateNode[];
+    /** Позиция template-секции в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST узел template до семантической нормализации. */
+export type RComponentSFC_AST_TemplateNode = RComponentSFC_AST_ElementNode | RComponentSFC_AST_TextNode | RComponentSFC_AST_InterpolationNode;
+/** AST element-узел template. */
+export interface RComponentSFC_AST_ElementNode {
+    /** Тип AST-узла. */
+    kind: 'element';
+    /** Имя тега ровно в том виде, как оно написано в template. */
+    tag: string;
+    /** Статические и динамические атрибуты элемента. */
+    attributes: RComponentSFC_AST_Attribute[];
+    /** Директивы элемента: if, else-if, else, for, key и другие будущие расширения. */
+    directives: RComponentSFC_AST_Directive[];
+    /** Дочерние узлы элемента. */
+    children: RComponentSFC_AST_TemplateNode[];
+    /** Флаг self-closing записи. */
+    selfClosing: boolean;
+    /** Позиция узла в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST текстовый узел template. */
+export interface RComponentSFC_AST_TextNode {
+    /** Тип AST-узла. */
+    kind: 'text';
+    /** Текстовое содержимое узла. */
+    content: string;
+    /** Позиция узла в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST interpolation-узел template. */
+export interface RComponentSFC_AST_InterpolationNode {
+    /** Тип AST-узла. */
+    kind: 'interpolation';
+    /** Выражение внутри {{ ... }}. */
+    expression: string;
+    /** Позиция узла в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST атрибут template-элемента. */
+export interface RComponentSFC_AST_Attribute {
+    /** Имя атрибута без синтаксического префикса. */
+    name: string;
+    /** Значение атрибута, если оно указано. */
+    value: string | null;
+    /** Флаг динамического binding через :name. */
+    dynamic: boolean;
+    /** Позиция атрибута в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST директива template-элемента. */
+export interface RComponentSFC_AST_Directive {
+    /** Имя директивы без v-prefix: if, else-if, else, for, key, bind, on. */
+    name: string;
+    /** Аргумент директивы, если синтаксис его поддерживает. */
+    argument?: string;
+    /** Выражение директивы, если оно есть. */
+    expression?: string;
+    /** Static modifiers such as `.stop`, `.prevent` and `.capture`. */
+    modifiers: string[];
+    /** Позиция директивы в полном source. */
+    range: RComponentSFC_SourceRange;
+}
+/** AST style секции. */
+export interface RComponentSFC_AST_Style {
+    /** Язык style-секции: endgecss или другое значение из source. */
+    lang: string | null;
+    /** Флаг scoped-стилей. */
+    scoped: boolean;
+    /** Полный текст style-секции без внешнего тега. */
+    content: string;
+    /** Позиция style-секции в полном source. */
+    range: RComponentSFC_SourceRange;
+}

package/dist/domain/types/component/sfc/dependencies.types.d.ts

@@ -0,0 +1,66 @@
+import { RComponentSFC_IR_Read } from './ir.types';
+/** Источник runtime-зависимости SFC v1. */
+export type RComponentSFC_RuntimeDependencySource = 'props';
+/** Runtime-зависимость SFC template от входного prop. */
+export interface RComponentSFC_RuntimeDependency {
+    /** Источник зависимости. В v1 поддерживаем только props. */
+    source: RComponentSFC_RuntimeDependencySource;
+    /** Имя входного prop, например `flight`. */
+    prop: string;
+    /** Путь внутри prop, например `['status']` для `flight.status`. */
+    path: string[];
+    /** Исходный read из IR, полезен для diagnostics/debug. */
+    raw: string;
+    /** Нормализованный read из IR. */
+    read: RComponentSFC_IR_Read;
+}
+/** Тип patchable runtime boundary внутри SFC IR. */
+export type RComponentSFC_RuntimeBoundaryKind = 'table';
+/** Runtime-зависимость колонки таблицы от полей текущей строки. */
+export interface RComponentSFC_RuntimeTableColumnDependency {
+    /** Стабильный boundary-id колонки, совпадает с id IR node. */
+    id: string;
+    /** Ключ колонки из `<Column key="...">`. */
+    key: string;
+    /** Видимый индекс колонки внутри таблицы. */
+    index: number;
+    /** Поля alias-а `row`, которые читает cell template. */
+    rowReads: string[];
+}
+/** Patchable runtime boundary SFC, для которой создается отдельная Raph-нода. */
+export interface RComponentSFC_RuntimeBoundaryDependency {
+    /** Стабильный boundary-id, совпадает с id IR node. */
+    id: string;
+    /** Тип boundary. В v1 поддерживаем Table. */
+    kind: RComponentSFC_RuntimeBoundaryKind;
+    /** Имя prop, из которого boundary получает коллекцию. */
+    sourceProp: string;
+    /** Путь внутри prop, если source выражен как `foo.bar`. */
+    sourcePath: string[];
+    /** Поле ключа строки из `row-key`. */
+    rowKey: string | null;
+    /** Колонки таблицы, которые можно обновлять точечно. */
+    columns: RComponentSFC_RuntimeTableColumnDependency[];
+}
+/** Runtime-зависимость SFC от Vocab alias ближайшего Composition scope. */
+export interface RComponentSFC_RuntimeVocabDependency {
+    /** Публичный, scope-local alias; физическая Vocab identity сюда не протекает. */
+    alias: string;
+    /** Путь option value внутри элемента Vocab. */
+    valuePath: string;
+    /** Путь option label внутри элемента Vocab. */
+    labelPath: string;
+    /** Исходное выражение для diagnostics/debug. */
+    raw: string;
+}
+/** Набор runtime-зависимостей SFC artifact. */
+export interface RComponentSFC_RuntimeDependencies {
+    /** Зависимости от props, которые можно связать с внешним input source. */
+    props: RComponentSFC_RuntimeDependency[];
+    /** Patchable boundaries, для которых runtime строит отдельные Raph-ноды. */
+    boundaries: RComponentSFC_RuntimeBoundaryDependency[];
+    /** Vocab aliases, которые должен предоставить ближайший Composition scope. */
+    vocabs?: RComponentSFC_RuntimeVocabDependency[];
+}
+/** Создает пустой dependency artifact SFC runtime. */
+export declare function createEmptyComponentSFCRuntimeDependencies(): RComponentSFC_RuntimeDependencies;

package/dist/domain/types/component/sfc/index.d.ts

@@ -0,0 +1,14 @@
+export * from './source.types';
+export * from './table-visibility.types';
+export * from './table-events.types';
+export * from './intrinsic-events.types';
+export * from './tag-input-contract.types';
+export * from './location.types';
+export * from './ast.types';
+export * from './ir.types';
+export * from './dependencies.types';
+export * from './ports.types';
+export * from './ports-source.types';
+export * from './props-visual.types';
+export * from './metadata-visual.types';
+export * from './visual-projection.types';

package/dist/domain/types/component/sfc/intrinsic-events.types.d.ts

@@ -0,0 +1,37 @@
+import { RComponentSFC_IR_Tag } from './ir.types';
+export interface ComponentSFCEventModifiersState {
+    alt: boolean;
+    ctrl: boolean;
+    meta: boolean;
+    shift: boolean;
+}
+export interface ComponentSFCInteractionEventPayload {
+    type: string;
+    modifiers: ComponentSFCEventModifiersState;
+}
+export interface ComponentSFCPointerEventPayload extends ComponentSFCInteractionEventPayload {
+    x: number;
+    y: number;
+    button: number;
+    buttons: number;
+    pointerType: 'mouse' | 'touch' | 'pen' | 'unknown';
+}
+export interface ComponentSFCKeyboardEventPayload extends ComponentSFCInteractionEventPayload {
+    key: string;
+    code: string;
+    repeat: boolean;
+}
+export interface ComponentSFCInputEventPayload extends ComponentSFCInteractionEventPayload {
+    value: unknown;
+    checked?: boolean;
+}
+export interface ComponentSFCIntrinsicEventDefinition {
+    name: string;
+    displayName: string;
+    payloadType: string;
+    description: string;
+}
+export declare const COMPONENT_SFC_INTERACTION_EVENT_DEFINITIONS: readonly ComponentSFCIntrinsicEventDefinition[];
+export declare const COMPONENT_SFC_FORM_EVENT_DEFINITIONS: readonly [ComponentSFCIntrinsicEventDefinition, ComponentSFCIntrinsicEventDefinition];
+export declare function listComponentSFCEventCapableTags(): readonly RComponentSFC_IR_Tag[];
+export declare function getComponentSFCIntrinsicEventDefinitions(tag: RComponentSFC_IR_Tag): readonly ComponentSFCIntrinsicEventDefinition[];

package/dist/domain/types/component/sfc/ir.types.d.ts

@@ -0,0 +1,172 @@
+import { RComponentSFC_SourceRange } from './location.types';
+import { ComponentSFCEventAction, ComponentSFCPortManifest, RComponentSFC_IR_ComponentPortMarker, RComponentSFC_IR_PortCall } from './ports.types';
+import { EndgeStyleSheetArtifact } from '../../style';
+/** Семантическая модель компонента после compiler pipeline, независимая от DOM и Nova. */
+export interface RComponentSFC_IR {
+    /** Версия IR-модели. */
+    version: 1;
+    /** Нормализованная модель script setup. */
+    script: RComponentSFC_IR_Script;
+    /** Нормализованный граф template-узлов: Text, Flex, Box, Component и другие primitives. */
+    template: RComponentSFC_IR_Template;
+    /** Нормализованная модель endgecss-стилей. */
+    style: RComponentSFC_IR_Style | null;
+}
+/** IR script-секции после извлечения контракта и локальных bindings. */
+export interface RComponentSFC_IR_Script {
+    /** Входные props компонента. */
+    props: RComponentSFC_IR_Prop[];
+    /** Локальные bindings, доступные template-выражениям. */
+    locals: RComponentSFC_IR_LocalBinding[];
+    /** Port declarations resolved during compilation. */
+    ports: ComponentSFCPortManifest;
+    /** Top-level computation port calls that initialize template locals. */
+    portCalls: RComponentSFC_IR_PortCall[];
+}
+/** IR prop компонента. */
+export interface RComponentSFC_IR_Prop {
+    /** Имя prop. */
+    name: string;
+    /** Доменный или TypeScript-тип prop в нормализованном виде. */
+    type: string;
+    /** Флаг массива. */
+    isArray?: boolean;
+    /** Флаг необязательного prop. */
+    optional?: boolean;
+    /** Позиция исходного объявления prop. */
+    sourceRange?: RComponentSFC_SourceRange;
+}
+/** IR локальный binding script setup. */
+export interface RComponentSFC_IR_LocalBinding {
+    /** Имя binding. */
+    name: string;
+    /** Тип binding, если compiler смог его определить. */
+    type?: string;
+    /** Позиция исходного объявления binding. */
+    sourceRange?: RComponentSFC_SourceRange;
+}
+/** IR template-секции. */
+export interface RComponentSFC_IR_Template {
+    /** Корневые узлы нормализованного template. */
+    roots: RComponentSFC_IR_Node[];
+}
+/** IR узел template после нормализации в Endge primitives. */
+export type RComponentSFC_IR_Node = RComponentSFC_IR_ElementNode | RComponentSFC_IR_TextNode | RComponentSFC_IR_ExpressionNode;
+/** Поддерживаемые v1 primitives нового SFC template. */
+export type RComponentSFC_IR_Tag = 'Text' | 'DateTime' | 'Number' | 'Icon' | 'Badge' | 'Dot' | 'Box' | 'Flex' | 'Grid' | 'Divider' | 'Input' | 'Textarea' | 'Checkbox' | 'Select' | 'Component' | 'Table' | 'Column' | 'Cell' | 'ColumnMenu' | 'MenuItem' | 'MenuSeparator';
+/** IR element-узел, который renderer-слои могут читать без знания исходного синтаксиса. */
+export interface RComponentSFC_IR_ElementNode {
+    /** Стабильный id узла внутри IR. */
+    id: string;
+    /** Тип IR-узла. */
+    kind: 'element';
+    /** Нормализованный Endge primitive tag. */
+    tag: RComponentSFC_IR_Tag;
+    /** Original public component tag before normalization to Component. */
+    componentTag?: string;
+    /** Нормализованные props элемента. */
+    props: Record<string, RComponentSFC_IR_Value>;
+    /** Нормализованные control-flow директивы элемента. */
+    directives: RComponentSFC_IR_Directives;
+    /** Local renderer Event reactions declared through `@event` attributes. */
+    events?: RComponentSFC_IR_EventBinding[];
+    /** Дочерние IR-узлы. */
+    children: RComponentSFC_IR_Node[];
+    /** Local component port marker retained for future provider overrides. */
+    port?: RComponentSFC_IR_ComponentPortMarker;
+    /** Позиция исходного AST-узла. */
+    sourceRange?: RComponentSFC_SourceRange;
+}
+export type RComponentSFC_IR_EventModifier = 'stop' | 'prevent' | 'self' | 'once' | 'capture' | 'passive';
+export interface RComponentSFC_IR_EventBinding {
+    name: string;
+    modifiers: RComponentSFC_IR_EventModifier[];
+    action: ComponentSFCEventAction;
+    sourceRange?: RComponentSFC_SourceRange;
+}
+/** IR текстовый узел. */
+export interface RComponentSFC_IR_TextNode {
+    /** Стабильный id узла внутри IR. */
+    id: string;
+    /** Тип IR-узла. */
+    kind: 'text';
+    /** Текстовое содержимое. */
+    value: string;
+    /** Позиция исходного AST-узла. */
+    sourceRange?: RComponentSFC_SourceRange;
+}
+/** IR expression-узел, обычно полученный из interpolation. */
+export interface RComponentSFC_IR_ExpressionNode {
+    /** Стабильный id узла внутри IR. */
+    id: string;
+    /** Тип IR-узла. */
+    kind: 'expression';
+    /** Нормализованное выражение. */
+    value: RComponentSFC_IR_Value;
+    /** Позиция исходного AST-узла. */
+    sourceRange?: RComponentSFC_SourceRange;
+}
+/** Нормализованное значение prop/directive/text expression. */
+export type RComponentSFC_IR_Value = RComponentSFC_IR_LiteralValue | RComponentSFC_IR_ExpressionValue;
+/** Literal-значение без runtime-вычисления. */
+export interface RComponentSFC_IR_LiteralValue {
+    /** Тип значения. */
+    kind: 'literal';
+    /** Непосредственное значение. */
+    value: unknown;
+}
+/** Runtime-выражение с зависимостями для реактивного обновления. */
+export interface RComponentSFC_IR_ExpressionValue {
+    /** Тип значения. */
+    kind: 'expression';
+    /** Исходный текст выражения. */
+    source: string;
+    /** Зависимости, которые выражение читает. */
+    reads: RComponentSFC_IR_Read[];
+    /** Статические обращения к Vocab aliases текущего Composition scope. */
+    vocabReads?: RComponentSFC_IR_VocabRead[];
+}
+/** Статическое обращение `vocab(alias, mapping?)` внутри SFC expression. */
+export interface RComponentSFC_IR_VocabRead {
+    /** Публичный alias из ближайшего Composition scope. */
+    alias: string;
+    /** Путь option value внутри элемента Vocab. */
+    valuePath: string;
+    /** Путь option label внутри элемента Vocab. */
+    labelPath: string;
+    /** Исходное выражение для diagnostics/debug. */
+    raw: string;
+}
+/** Реактивное чтение, найденное внутри выражения. */
+export interface RComponentSFC_IR_Read {
+    /** Источник чтения: props, Raph/store или локальный binding. */
+    source: 'props' | 'raph' | 'local';
+    /** Нормализованный путь чтения. */
+    path: string[];
+    /** Исходный текст чтения. */
+    raw: string;
+}
+/** Нормализованные control-flow директивы IR element-узла. */
+export interface RComponentSFC_IR_Directives {
+    /** Условие отображения узла. */
+    if?: RComponentSFC_IR_Value;
+    /** Условие отображения else-if узла. */
+    elseIf?: RComponentSFC_IR_Value;
+    /** Флаг else ветки. */
+    else?: boolean;
+    /** Описание цикла for. */
+    for?: RComponentSFC_IR_ForDirective;
+    /** Значение key для повторяемых узлов. */
+    key?: RComponentSFC_IR_Value;
+}
+/** Нормализованная for-директива. */
+export interface RComponentSFC_IR_ForDirective {
+    /** Имя переменной элемента коллекции. */
+    item: string;
+    /** Имя переменной индекса, если она указана. */
+    index?: string;
+    /** Источник коллекции. */
+    source: RComponentSFC_IR_Value;
+}
+/** IR style-секции после нормализации endgecss. */
+export type RComponentSFC_IR_Style = EndgeStyleSheetArtifact;

package/dist/domain/types/component/sfc/location.types.d.ts

@@ -0,0 +1,15 @@
+/** Позиция фрагмента внутри полного SFC source. */
+export interface RComponentSFC_SourceRange {
+    /** Абсолютный offset начала фрагмента в source. */
+    start: number;
+    /** Абсолютный offset конца фрагмента в source. */
+    end: number;
+    /** Номер строки начала фрагмента, если parser его посчитал. */
+    startLine?: number;
+    /** Номер колонки начала фрагмента, если parser его посчитал. */
+    startColumn?: number;
+    /** Номер строки конца фрагмента, если parser его посчитал. */
+    endLine?: number;
+    /** Номер колонки конца фрагмента, если parser его посчитал. */
+    endColumn?: number;
+}