@endge/core 2.0.2 → 2.0.3

package/dist/domain/entities/runtime/ComponentSFCEventBoundary.d.ts

@@ -1,5 +1,5 @@
 import { ComponentSFCRuntimeHost } from './hosts/ComponentSFCRuntimeHost';
-import { ComponentSFCEventRuntimeSource, ComponentSFCPortManifest } from '../../types/component/sfc/ports.types';
+import { ComponentSFCEventRuntimeSource, ComponentSFCRequiredPortBinding, ComponentSFCPortManifest } from '../../types/component/sfc/ports.types';
 import { RComponentSFC_IR_EventBinding } from '../../types/component/sfc/ir.types';
 /** Mount-scoped Event router for one Component SFC artifact boundary. */
 export declare class ComponentSFCEventBoundary {
@@ -10,15 +10,16 @@ export declare class ComponentSFCEventBoundary {
     private readonly parentSource?;
     private readonly parentBindings;
     private readonly parentEventTransform?;
+    private readonly requiredPortBindings;
     private readonly consumedLocalOnce;
     constructor(host: ComponentSFCRuntimeHost | null, componentIdentity: string, manifest: ComponentSFCPortManifest, parent?: ComponentSFCEventBoundary | null, parentSource?: ComponentSFCEventRuntimeSource | undefined, parentBindings?: readonly RComponentSFC_IR_EventBinding[], parentEventTransform?: ((event: string, payload: unknown) => {
         event: string;
         payload: unknown;
-    } | null) | undefined);
+    } | null) | undefined, requiredPortBindings?: readonly ComponentSFCRequiredPortBinding[]);
     createChild(componentIdentity: string, manifest: ComponentSFCPortManifest, source: ComponentSFCEventRuntimeSource, bindings?: readonly RComponentSFC_IR_EventBinding[], transform?: (event: string, payload: unknown) => {
         event: string;
         payload: unknown;
-    } | null): ComponentSFCEventBoundary;
+    } | null, requiredPortBindings?: readonly ComponentSFCRequiredPortBinding[]): ComponentSFCEventBoundary;
     /** True when the current public manifest observes one Event of this child source. */
     observesChild(source: ComponentSFCEventRuntimeSource, event: string): boolean;
     /** Claims a mount-scoped logical `.once` rule after it has matched. */
@@ -30,5 +31,6 @@ export declare class ComponentSFCEventBoundary {
     /** Emits an Event declared as own by this component. */
     emitOwn(name: string, payload: unknown, trace?: string[], depth?: number): Promise<void>;
     private dispatch;
+    private resolveRequiredPortAction;
     private reportError;
 }

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

@@ -11,13 +11,13 @@ export interface RComponentRef {
     /** Идентификатор компонента внутри выбранного хранилища. */
     id: string | number;
     /** Semantic dependency role in the compiled artifact. */
-    role?: 'child-component' | 'port-default-component';
+    role?: 'child-component' | 'port-default-component' | 'port-override-component';
 }
 /** Ссылка SFC-компонента на computation provider. */
 export interface RComputationRef {
     source: 'computation';
     id: string | number;
-    role: 'port-default-computation';
+    role: 'port-default-computation' | 'port-override-computation';
 }
 /** Описание одного сообщения компилятора или валидатора. */
 export interface RComponentDiagnostic {

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

@@ -1,6 +1,6 @@
 import { RComponentSFC_SourceRange } from './location.types';
 import { RComponentDiagnostic } from '../component-core.types';
-import { ComponentSFCEventAction, ComponentSFCPortForwardOrigin, ComponentSFCPortManifest, RComponentSFC_IR_ComponentPortMarker, RComponentSFC_IR_PortCall } from './ports.types';
+import { ComponentSFCEventAction, ComponentSFCRequiredPortBinding, ComponentSFCPortForwardOrigin, ComponentSFCPortManifest, RComponentSFC_IR_ComponentPortMarker, RComponentSFC_IR_PortCall } from './ports.types';
 import { EndgeStyleSheetArtifact } from '../../style/style.types';
 /** Семантическая модель компонента после compiler pipeline, независимая от DOM и Nova. */
 export interface RComponentSFC_IR {
@@ -178,6 +178,8 @@ export interface RComponentSFC_IR_ElementNode {
     children: RComponentSFC_IR_Node[];
     /** Local component port marker retained for future provider overrides. */
     port?: RComponentSFC_IR_ComponentPortMarker;
+    /** Static per-instance bindings for required ports of this child component. */
+    portBindings?: ComponentSFCRequiredPortBinding[];
     /** Compiler-resolved Table menus, including forwarded Action identities and targets. */
     tableMenus?: RComponentSFC_IR_TableMenus;
     /** Позиция исходного AST-узла. */
@@ -200,6 +202,8 @@ export interface ComponentSFCTableMenuItemDescriptor {
     id: string;
     label: RComponentSFC_IR_Value;
     action: string;
+    /** Required Action port whose mounted provider may replace `action`. */
+    requiredPort?: string;
     input?: RComponentSFC_IR_Value;
     icon?: string;
     /** Set only for a provided alias forwarded from this exact Table node. */

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

@@ -2,7 +2,8 @@ import { RComponentContractInput } from '../component-core.types';
 import { RComponentSFC_IR_Value } from './ir.types';
 import { RComponentSFC_SourceRange } from './location.types';
 export type ComponentSFCPortRole = 'require' | 'provides' | 'emits';
-export type ComponentSFCPortKind = 'computation' | 'component' | 'action' | 'event';
+export type ComponentSFCPortKind = 'computation' | 'component' | 'action' | 'query' | 'event';
+export type ComponentSFCRequiredPortKind = Exclude<ComponentSFCPortKind, 'event'>;
 /** Public child port selected by a compile-time `definePorts.forward` rule. */
 export interface ComponentSFCPortForwardOrigin {
     nodeId: string;
@@ -59,6 +60,12 @@ export type ComponentSFCPortProviderDescriptor = {
         isArray?: boolean;
         optional?: boolean;
     } | null;
+} | {
+    kind: 'query';
+    identity: string;
+    active: boolean;
+    inputs: RComponentContractInput[];
+    outputs: RComponentContractInput[];
 };
 /** Computation port declared by `computation<Input, Output>`. */
 export interface ComponentSFCComputationPort {
@@ -92,6 +99,25 @@ export interface ComponentSFCActionPort {
     forwardedFrom?: ComponentSFCPortForwardOrigin;
     sourceRange?: RComponentSFC_SourceRange;
 }
+/** Callable Query required by a component. */
+export interface ComponentSFCQueryPort {
+    kind: 'query';
+    name: string;
+    defaultIdentity: string;
+    inputType: string;
+    outputType: string;
+    inputs: RComponentContractInput[];
+    outputs: RComponentContractInput[];
+    forwardedFrom?: ComponentSFCPortForwardOrigin;
+    sourceRange?: RComponentSFC_SourceRange;
+}
+/** One static provider override attached to a mounted child Component SFC call. */
+export interface ComponentSFCRequiredPortBinding {
+    port: string;
+    kind: ComponentSFCRequiredPortKind;
+    identity: string;
+    sourceRange?: RComponentSFC_SourceRange;
+}
 /** Multicast notification emitted by this component. */
 export interface ComponentSFCEventPort {
     kind: 'event';
@@ -165,7 +191,14 @@ export interface ComponentSFCEventEmitAction {
     event: string;
     payload?: ComponentSFCEventInputValue;
 }
-export type ComponentSFCEventAction = ComponentSFCEventDirectAction | ComponentSFCEventDirectQuery | ComponentSFCEventTypescriptAction | ComponentSFCEventEmitAction;
+/** Calls one required executable port through its effective per-instance provider. */
+export interface ComponentSFCEventRequiredPortAction {
+    kind: 'required-port';
+    portKind: 'action' | 'query';
+    port: string;
+    input?: ComponentSFCEventInputValue;
+}
+export type ComponentSFCEventAction = ComponentSFCEventDirectAction | ComponentSFCEventDirectQuery | ComponentSFCEventTypescriptAction | ComponentSFCEventEmitAction | ComponentSFCEventRequiredPortAction;
 export interface ComponentSFCEventRuntimeSource {
     nodeId: string;
     ref?: string;
@@ -187,6 +220,7 @@ export interface ComponentSFCRequiredPorts {
     computations: ComponentSFCComputationPort[];
     components: ComponentSFCComponentPort[];
     actions: ComponentSFCActionPort[];
+    queries: ComponentSFCQueryPort[];
 }
 export interface ComponentSFCProvidedPorts {
     actions: ComponentSFCActionPort[];

package/dist/domain/types/component/sfc/tag-input-contract.types.d.ts

@@ -1,7 +1,10 @@
 import { RComponentContractInput } from '../component-core.types';
 import { RComponentSFC_IR_Tag } from './ir.types';
 /** Публичный входной параметр renderer-neutral встроенного SFC tag. */
-export type ComponentSFCTagInputContract = Readonly<RComponentContractInput>;
+export type ComponentSFCTagInputContract = Readonly<RComponentContractInput> & {
+    /** Допустимые SFC spelling aliases для одного renderer-facing параметра. */
+    aliases?: readonly string[];
+};
 /**
  * Data-facing входы встроенных tags для source-aware visual editors.
  * Presentation-атрибуты остаются в отдельном редакторе атрибутов.
@@ -11,6 +14,11 @@ export declare const ENDGE_SFC_TAG_INPUT_CONTRACTS: {
         readonly name: "value";
         readonly type: "string";
         readonly optional: true;
+    }, {
+        readonly name: "editorVariant";
+        readonly aliases: readonly ["editor-variant"];
+        readonly type: "'default' | 'compact'";
+        readonly optional: true;
     }];
     readonly DateTime: readonly [{
         readonly name: "value";
@@ -24,6 +32,16 @@ export declare const ENDGE_SFC_TAG_INPUT_CONTRACTS: {
         readonly name: "timezone";
         readonly type: "string";
         readonly optional: true;
+    }, {
+        readonly name: "editMode";
+        readonly aliases: readonly ["edit-mode"];
+        readonly type: "'datetime' | 'time'";
+        readonly optional: true;
+    }, {
+        readonly name: "editorVariant";
+        readonly aliases: readonly ["editor-variant"];
+        readonly type: "'default' | 'compact'";
+        readonly optional: true;
     }, {
         readonly name: "empty";
         readonly type: "string";
@@ -33,6 +51,11 @@ export declare const ENDGE_SFC_TAG_INPUT_CONTRACTS: {
         readonly name: "value";
         readonly type: "number";
         readonly optional: false;
+    }, {
+        readonly name: "editorVariant";
+        readonly aliases: readonly ["editor-variant"];
+        readonly type: "'default' | 'compact'";
+        readonly optional: true;
     }, {
         readonly name: "decimals";
         readonly type: "number";

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

@@ -42,7 +42,7 @@ export interface ComponentSFCCompileOptions {
     /** Проверяет существование статической 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;
+    resolvePortProvider?: (identity: string, expectedKind: 'computation' | 'component' | 'action' | 'query') => ComponentSFCPortProviderDescriptor | null;
     /** Resolves the compiled public port manifest of a nested SFC component. */
     resolveComponentPortManifest?: (identity: string) => ComponentSFCPortManifest | null;
     /** Resolves explicit root variants of one nested custom component. */

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

@@ -9,4 +9,4 @@ export interface ComponentSFCInteractionCompileContext {
 /** Detects statically invalid passive/prevent combinations in shared trigger descriptors. */
 export declare function hasComponentSFCPassivePreventConflict(source: string, suffixes?: readonly RComponentSFC_IR_EventModifier[]): boolean;
 /** Compiles one source-owned `:on` annotation into renderer-neutral rules. */
-export declare function compileComponentSFCInteractionAnnotation(attribute: RComponentSFC_AST_Attribute, manifest: ComponentSFCPortManifest | null, context: ComponentSFCInteractionCompileContext, dependencies: RComponentDependencies, diagnostics: RComponentDiagnostic[]): RComponentSFC_IR_InteractionGroup | null;
+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/model/services/compiler/component-sfc/component-sfc-ports.d.ts

@@ -3,11 +3,11 @@ import { TypeSourceDefinition } from '../../../../domain/types/source/type-sourc
 import { ComponentSFCEventAction, ComponentSFCPortManifest, ComponentSFCPortProviderDescriptor, RComponentSFC_IR_PortCall } from '../../../../domain/types/component/sfc/ports.types';
 import { RComponentSFC_AST_Script } from '../../../../domain/types/component/sfc/ast.types';
 export interface ComponentSFCPortAnalysisOptions {
-    resolveProvider?: (identity: string, expectedKind: 'computation' | 'component' | 'action') => ComponentSFCPortProviderDescriptor | null;
+    resolveProvider?: (identity: string, expectedKind: 'computation' | 'component' | 'action' | 'query') => ComponentSFCPortProviderDescriptor | null;
     resolveTypeDefinition?: (identity: string) => TypeSourceDefinition | null;
 }
 /** Compiles the safe reaction grammar used by local `@event` template bindings. */
-export declare function compileComponentSFCLocalEventAction(eventName: string, source: string, sourceOffset: number, dependencies: RComponentDependencies, diagnostics: RComponentDiagnostic[]): ComponentSFCEventAction | null;
+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[];

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

@@ -1,7 +1,7 @@
 import { RComponentDependencies, RComponentDiagnostic } from '../../../../domain/types/component/component-core.types';
 import { RComponentSFC_AST_Template } from '../../../../domain/types/component/sfc/ast.types';
 import { RComponentSFC_IR_Template } from '../../../../domain/types/component/sfc/ir.types';
-import { ComponentSFCComponentPort, ComponentSFCPortManifest } from '../../../../domain/types/component/sfc/ports.types';
+import { ComponentSFCComponentPort, ComponentSFCPortProviderDescriptor, ComponentSFCRequiredPortKind, ComponentSFCPortManifest } from '../../../../domain/types/component/sfc/ports.types';
 import { ProgramNodeMetadata } from '../../../../domain/types/program/program-metadata.types';
 import { EndgeSFCEditingConfiguration } from '../../../../domain/types/configuration/configuration.type';
 /** Контекст компиляции template в IR. */
@@ -12,12 +12,16 @@ export interface ComponentSFCTemplateCompileContext {
     locals: string[];
     /** Local component ports have priority over the global user tag registry. */
     componentPorts?: ComponentSFCComponentPort[];
+    /** Required ports owned by the Component SFC currently being compiled. */
+    ownerPorts?: ComponentSFCPortManifest | null;
     /** Разрешает зарегистрированный пользовательский tag в identity компонента. */
     resolveComponentTag?: (tag: string) => string | null;
     /** Проверяет статическую identity из Component is. */
     hasComponentIdentity?: (identity: string) => boolean;
     /** Resolves public Events of a nested user Component for local `@event` bindings. */
     resolveComponentPortManifest?: (identity: string) => ComponentSFCPortManifest | null;
+    /** Resolves static providers used by flat child port bindings. */
+    resolvePortProvider?: (identity: string, expectedKind: ComponentSFCRequiredPortKind) => ComponentSFCPortProviderDescriptor | null;
     /** Resolves explicit root Variant names of a nested custom component. */
     resolveComponentVariants?: (identity: string) => string[] | null;
     /** Effective defaults завершения edit session для текущего build context. */

package/dist/model/services/query/QueryExecutor.d.ts

@@ -16,6 +16,8 @@ export declare class QueryExecutor {
     /** Выполняет REST artifact. */
     private _runRest;
     private _throwHttpError;
+    /** Пишет краткую transport-индикацию без request body, headers и response payload. */
+    private _writeRequestError;
     /** Публикует runtime warning безопасного expression evaluator. */
     private _writeExpressionWarning;
     private _asRecord;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@endge/core",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "private": false,
   "license": "Apache-2.0",
   "type": "module",
@@ -29,7 +29,7 @@
   "dependencies": {
     "@babel/parser": "^7.27.2",
     "@babel/types": "^7.27.1",
-    "@endge/utils": "^0.24.11",
+    "@endge/utils": "^0.24.12",
     "@vue/compiler-dom": "^3.5.24",
     "@vue/compiler-sfc": "^3.5.24",
     "axios": "^1.13.2",
@@ -46,8 +46,8 @@
     "yaml": "^2.8.1"
   },
   "peerDependencies": {
-    "@endge/raph": "^3.0.9",
-    "@endge/utils": "^0.24.11",
+    "@endge/raph": "^3.0.10",
+    "@endge/utils": "^0.24.12",
     "@primevue/themes": "^4.0.0-rc.1",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.1",