@almadar/ui 5.70.0 → 5.72.0

package/dist/avl/index.d.cts

@@ -1,7 +1,8 @@
 import * as React from 'react';
 import React__default from 'react';
-import { OrbitalSchema, UISlot, Expression, EntityPersistence, EventPayloadField, EditFocus, EventPayload, ThemeDefinition } from '@almadar/core';
+import { JsonObject, JsonValue, OrbitalSchema, Expression, UISlot, EntityData, EditFocus, EventPayload, ThemeDefinition } from '@almadar/core';
 import { Node, Edge, NodeProps, EdgeProps } from '@xyflow/react';
+import { AnyPatternConfig } from '@almadar/patterns';
 import { useDraggable } from '@dnd-kit/core';
 
 /**
@@ -454,6 +455,10 @@ declare function curveControlPoint(x1: number, y1: number, x2: number, y2: numbe
  * @packageDocumentation
  */
 
+interface SerializedEffect extends JsonObject {
+    type: string;
+    args: JsonValue[];
+}
 interface ApplicationOrbitalData {
     name: string;
     entityName: string;
@@ -477,13 +482,13 @@ interface ApplicationLevelData {
     orbitals: ApplicationOrbitalData[];
     crossLinks: CrossLink[];
 }
-interface FieldInfo {
+interface FieldInfo extends JsonObject {
     name: string;
     type: string;
     required: boolean;
     hasDefault: boolean;
 }
-interface OrbitalTraitInfo {
+interface OrbitalTraitInfo extends JsonObject {
     name: string;
     stateCount: number;
     eventCount: number;
@@ -491,14 +496,14 @@ interface OrbitalTraitInfo {
     emits: string[];
     listens: string[];
 }
-interface OrbitalPageInfo {
+interface OrbitalPageInfo extends JsonObject {
     name: string;
     route: string;
 }
-interface ExternalLink {
+interface ExternalLink extends JsonObject {
     targetOrbital: string;
     eventName: string;
-    direction: 'out' | 'in';
+    direction: string;
     traitName: string;
 }
 interface OrbitalLevelData {
@@ -512,23 +517,20 @@ interface OrbitalLevelData {
     pages: OrbitalPageInfo[];
     externalLinks: ExternalLink[];
 }
-interface TraitStateInfo {
+interface TraitStateInfo extends JsonObject {
     name: string;
-    isInitial?: boolean;
-    isTerminal?: boolean;
+    isInitial: boolean | null;
+    isTerminal: boolean | null;
 }
-interface TraitTransitionInfo {
+interface TraitTransitionInfo extends JsonObject {
     from: string;
     to: string;
     event: string;
-    guard?: unknown;
-    effects: Array<{
-        type: string;
-        args: unknown[];
-    }>;
+    guard: JsonValue | null;
+    effects: SerializedEffect[];
     index: number;
 }
-interface TraitLevelData {
+interface TraitLevelData extends JsonObject {
     name: string;
     linkedEntity: string;
     states: TraitStateInfo[];
@@ -587,24 +589,24 @@ declare const ZOOM_BAND_THRESHOLDS: {
     readonly detail: readonly [2.5, 5];
 };
 /** Data carried by every orbital node in the unified canvas. */
-interface AvlNodeData extends Record<string, unknown> {
+interface AvlNodeData extends JsonObject {
     orbitalName: string;
     entityName: string;
     persistence: string;
     fields: FieldInfo[];
     traits: OrbitalTraitInfo[];
     pages: OrbitalPageInfo[];
-    traitDetails: Record<string, TraitLevelData>;
+    traitDetails: {
+        [k: string]: TraitLevelData;
+    };
     externalLinks: ExternalLink[];
 }
-/** Edge kind determines visual style. */
-type AvlEdgeKind = 'eventWire' | 'page';
 /** Data carried by edges in the unified canvas. */
-interface AvlEdgeData extends Record<string, unknown> {
-    edgeKind: AvlEdgeKind;
-    event?: string;
-    fromTrait?: string;
-    toTrait?: string;
+interface AvlEdgeData extends JsonObject {
+    edgeKind: string;
+    event: string | null;
+    fromTrait: string | null;
+    toTrait: string | null;
 }
 
 /** Determine which zoom band the current viewport zoom falls into. */
@@ -781,7 +783,8 @@ declare const AvlOrbitalNode: React__default.FC<NodeProps>;
  * backward transitions are dashed lighter.
  */
 
-interface AvlTransitionEdgeData extends Record<string, unknown> {
+interface AvlTransitionEdgeData {
+    [key: string]: string | boolean | undefined;
     event: string;
     hasGuard?: boolean;
     hasEffects?: boolean;
@@ -796,7 +799,8 @@ declare const AvlTransitionEdge: React__default.FC<EdgeProps<AvlTransitionFlowEd
  * Uses AVL CONNECTION_COLORS.emitListen styling.
  */
 
-interface AvlEventWireEdgeData extends Record<string, unknown> {
+interface AvlEventWireEdgeData {
+    [key: string]: string | boolean | undefined;
     event: string;
     compatible?: boolean;
 }
@@ -900,10 +904,15 @@ interface PatternEventSource {
 /** A slot + pattern config pair extracted from a render-ui effect. */
 interface RenderUIEntry {
     slot: UISlot | string;
-    pattern: Record<string, unknown>;
+    pattern: AnyPatternConfig;
 }
 /** Data for a preview node (used at both overview and expanded levels). */
-interface PreviewNodeData extends Record<string, unknown> {
+interface PreviewNodeData {
+    [key: string]: string | number | boolean | string[] | Expression | null | RenderUIEntry[] | PatternEventSource[] | Array<{
+        event: string;
+        fromState: string;
+        toState: string;
+    }> | OrbitalSchema | EntityData | undefined;
     /** Orbital this node belongs to. */
     orbitalName: string;
     /** Trait name (only at expanded level). */
@@ -1018,9 +1027,14 @@ interface PreviewNodeData extends Record<string, unknown> {
      * trait operates on. Mirrors `Trait.linkedEntity` from the resolved schema.
      */
     linkedEntity?: string;
+    /** Full parsed schema threaded to node renderers (e.g. TraitCardNode). */
+    _fullSchema?: OrbitalSchema;
+    /** Mock entity data for the orbital preview. */
+    _mockData?: EntityData;
 }
 /** Data for event flow edges. */
-interface EventEdgeData extends Record<string, unknown> {
+interface EventEdgeData {
+    [key: string]: string | boolean | undefined;
     /** The event name displayed on the edge. */
     event: string;
     /** Source state name (expanded level). */
@@ -1063,7 +1077,7 @@ interface EventEdgeData extends Record<string, unknown> {
  * Build a React Flow graph for the overview level.
  * Each orbital gets one node showing its INIT transition's UI.
  */
-declare function schemaToOverviewGraph(schema: OrbitalSchema, mockData?: Record<string, unknown[]>, behaviorMeta?: Record<string, {
+declare function schemaToOverviewGraph(schema: OrbitalSchema, mockData?: EntityData, behaviorMeta?: Record<string, {
     layer: string;
 }>, layoutHint?: 'pipeline' | 'grid', orbitalStatus?: Record<string, PreviewNodeData['status']>, screenSize?: ScreenSize): {
     nodes: Node<PreviewNodeData>[];
@@ -1080,7 +1094,7 @@ declare function schemaToOverviewGraph(schema: OrbitalSchema, mockData?: Record<
  * anonymous `INIT` peers (STUDIO-1). Drill into a grouped card to reach
  * L3 (`orbitalAliasToExpandedGraph`).
  */
-declare function orbitalToExpandedGraph(schema: OrbitalSchema, orbitalName: string, mockData?: Record<string, unknown[]>, screenSize?: ScreenSize): {
+declare function orbitalToExpandedGraph(schema: OrbitalSchema, orbitalName: string, mockData?: EntityData, screenSize?: ScreenSize): {
     nodes: Node<PreviewNodeData>[];
     edges: Edge<EventEdgeData>[];
 };
@@ -1126,50 +1140,71 @@ declare const EventFlowEdge: React__default.NamedExoticComponent<EdgeProps>;
  *   Expanded: One node per UI state within an orbital (OrbPreviewNode)
  */
 
+/** Serializable payload field — mirrors EventPayloadField from @almadar/core. */
+interface SerializedPayloadField extends JsonObject {
+    name: string;
+    type: string;
+    required: boolean | null;
+    description: string | null;
+}
+/** Serializable behavior glyph child — mirrors BehaviorGlyphChild from AvlBehaviorGlyph. */
+interface SerializedGlyphChild extends JsonObject {
+    name: string;
+    fieldCount: number | null;
+    stateCount: number | null;
+    persistence: string | null;
+    effectTypes: string[];
+}
+/** Serializable behavior glyph connection — mirrors BehaviorGlyphConnection from AvlBehaviorGlyph. */
+interface SerializedGlyphConnection extends JsonObject {
+    from: string;
+    to: string;
+    event: string;
+}
 /** Extended view level adding 'behavior' to the existing overview/expanded. */
 type ComposeViewLevel = 'behavior' | 'overview' | 'expanded';
 /** An event that can be wired between behaviors. */
-interface ConnectableEvent {
+interface ConnectableEvent extends JsonObject {
     /** Event name (e.g., "ADD_TO_CART"). */
     event: string;
     /** Typed payload fields if declared. */
-    payloadFields?: EventPayloadField[];
+    payloadFields: SerializedPayloadField[] | null;
     /** Vertical position hint (0..1) for handle placement on the node. */
     positionHint: number;
 }
 /** Data for a BehaviorComposeNode in React Flow. */
-interface BehaviorComposeNodeData extends Record<string, unknown> {
+interface BehaviorComposeNodeData extends JsonObject {
     /** Behavior name from registry (e.g., "std-cart"). */
     behaviorName: string;
     /** Composition level: atom, molecule, organism. */
-    level: BehaviorLevel;
+    level: string;
     /** Domain for color coding (e.g., "commerce"). */
-    domain?: string;
+    domain: string | null;
     /** Layer classification (e.g., "Domain", "UI Patterns"). */
-    layer?: string;
+    layer: string | null;
     /** Primary entity name (e.g., "CartItem"). */
     entityName: string;
     /** Number of states in the behavior. */
     stateCount: number;
     /** Number of entity fields. */
-    fieldCount?: number;
+    fieldCount: number | null;
     /** Persistence kind. */
-    persistence?: EntityPersistence;
+    persistence: string | null;
     /** Effect types used by this behavior. */
-    effectTypes?: AvlEffectType[];
+    effectTypes: string[] | null;
     /** Child behaviors for molecule/organism glyphs. */
-    children?: BehaviorGlyphChild[];
+    children: SerializedGlyphChild[] | null;
     /** Connections between children (for organism glyphs). */
-    connections?: BehaviorGlyphConnection[];
+    connections: SerializedGlyphConnection[] | null;
     /** Events this behavior can emit (source handles). */
     connectableEvents: ConnectableEvent[];
     /** Behaviors this is composable with (for palette hints). */
-    composableWith?: string[];
+    composableWith: string[] | null;
     /** Names of orbitals produced by this behavior (for drill-down). */
     orbitalNames: string[];
 }
 /** Edge data for behavior-level wiring. */
-interface BehaviorWireEdgeData extends Record<string, unknown> {
+interface BehaviorWireEdgeData extends JsonObject {
     /** The event name displayed on the edge. */
     event: string;
     /** Source behavior name. */
@@ -1177,7 +1212,7 @@ interface BehaviorWireEdgeData extends Record<string, unknown> {
     /** Target behavior name. */
     targetBehavior: string;
     /** Typed payload fields if declared. */
-    payloadFields?: EventPayloadField[];
+    payloadFields: SerializedPayloadField[] | null;
 }
 /** Mapping from behavior name to its metadata + produced orbitals. */
 interface BehaviorCanvasEntry {
@@ -1196,13 +1231,13 @@ interface BehaviorCanvasEntry {
     /** Number of entity fields. */
     fieldCount?: number;
     /** Persistence kind. */
-    persistence?: EntityPersistence;
+    persistence?: string;
     /** Effect types used. */
-    effectTypes?: AvlEffectType[];
+    effectTypes?: string[];
     /** Child behaviors (molecule/organism). */
-    children?: BehaviorGlyphChild[];
+    children?: SerializedGlyphChild[];
     /** Connections between children (organism). */
-    connections?: BehaviorGlyphConnection[];
+    connections?: SerializedGlyphConnection[];
     /** Events available for wiring. */
     connectableEvents: ConnectableEvent[];
     /** Compatible behavior names. */
@@ -1264,11 +1299,13 @@ interface BehaviorRegistryRecord {
         }>;
     };
     connectableEvents: string[];
-    eventPayloads: Record<string, Array<{
-        name: string;
-        type: string;
-        required?: boolean;
-    }>>;
+    eventPayloads: {
+        [k: string]: Array<{
+            name: string;
+            type: string;
+            required?: boolean;
+        }>;
+    };
     composableWith: string[];
 }
 /**
@@ -1499,7 +1536,7 @@ declare namespace OrbInspector {
 
 interface FlowCanvasProps {
     schema: OrbitalSchema | string;
-    mockData?: Record<string, unknown[]>;
+    mockData?: EntityData;
     className?: string;
     width?: number | string;
     height?: number | string;