@almadar/ui 2.32.0 → 2.33.2

package/dist/avl/index.d.cts

@@ -1,5 +1,7 @@
-import React from 'react';
+import * as React from 'react';
+import React__default from 'react';
 import { OrbitalSchema } from '@almadar/core';
+import { Node, Edge, NodeProps, EdgeProps } from '@xyflow/react';
 
 /**
  * Almadar Visual Language (AVL) shared types.
@@ -64,7 +66,7 @@ interface AvlOrbitalProps {
     opacity?: number;
     className?: string;
 }
-declare const AvlOrbital: React.FC<AvlOrbitalProps>;
+declare const AvlOrbital: React__default.FC<AvlOrbitalProps>;
 
 interface AvlEntityProps extends AvlBaseProps {
     r?: number;
@@ -72,7 +74,7 @@ interface AvlEntityProps extends AvlBaseProps {
     persistence?: AvlPersistenceKind;
     label?: string;
 }
-declare const AvlEntity: React.FC<AvlEntityProps>;
+declare const AvlEntity: React__default.FC<AvlEntityProps>;
 
 interface AvlTraitProps {
     cx?: number;
@@ -85,20 +87,20 @@ interface AvlTraitProps {
     opacity?: number;
     className?: string;
 }
-declare const AvlTrait: React.FC<AvlTraitProps>;
+declare const AvlTrait: React__default.FC<AvlTraitProps>;
 
 interface AvlPageProps extends AvlBaseProps {
     size?: number;
     label?: string;
 }
-declare const AvlPage: React.FC<AvlPageProps>;
+declare const AvlPage: React__default.FC<AvlPageProps>;
 
 interface AvlApplicationProps extends AvlBaseProps {
     width?: number;
     height?: number;
     label?: string;
 }
-declare const AvlApplication: React.FC<AvlApplicationProps>;
+declare const AvlApplication: React__default.FC<AvlApplicationProps>;
 
 interface AvlStateProps extends AvlBaseProps {
     name?: string;
@@ -111,7 +113,7 @@ interface AvlStateProps extends AvlBaseProps {
     /** V2: Number of transitions touching this state. Drives proportional width. */
     transitionCount?: number;
 }
-declare const AvlState: React.FC<AvlStateProps>;
+declare const AvlState: React__default.FC<AvlStateProps>;
 
 interface AvlTransitionProps {
     x1: number;
@@ -129,19 +131,19 @@ interface AvlTransitionProps {
     opacity?: number;
     className?: string;
 }
-declare const AvlTransition: React.FC<AvlTransitionProps>;
+declare const AvlTransition: React__default.FC<AvlTransitionProps>;
 
 interface AvlEventProps extends AvlBaseProps {
     size?: number;
     label?: string;
 }
-declare const AvlEvent: React.FC<AvlEventProps>;
+declare const AvlEvent: React__default.FC<AvlEventProps>;
 
 interface AvlGuardProps extends AvlBaseProps {
     size?: number;
     label?: string;
 }
-declare const AvlGuard: React.FC<AvlGuardProps>;
+declare const AvlGuard: React__default.FC<AvlGuardProps>;
 
 interface AvlEffectProps extends AvlBaseProps {
     effectType: AvlEffectType;
@@ -150,7 +152,7 @@ interface AvlEffectProps extends AvlBaseProps {
     /** V2: Render a category-colored background circle behind the icon. */
     showBackground?: boolean;
 }
-declare const AvlEffect: React.FC<AvlEffectProps>;
+declare const AvlEffect: React__default.FC<AvlEffectProps>;
 
 interface AvlFieldProps extends AvlBaseProps {
     /** Angle in radians from entity center. */
@@ -159,14 +161,14 @@ interface AvlFieldProps extends AvlBaseProps {
     required?: boolean;
     label?: string;
 }
-declare const AvlField: React.FC<AvlFieldProps>;
+declare const AvlField: React__default.FC<AvlFieldProps>;
 
 interface AvlFieldTypeProps extends AvlBaseProps {
     kind: AvlFieldTypeKind;
     size?: number;
     label?: string;
 }
-declare const AvlFieldType: React.FC<AvlFieldTypeProps>;
+declare const AvlFieldType: React__default.FC<AvlFieldTypeProps>;
 
 interface AvlBindingProps {
     x1: number;
@@ -178,40 +180,40 @@ interface AvlBindingProps {
     opacity?: number;
     className?: string;
 }
-declare const AvlBinding: React.FC<AvlBindingProps>;
+declare const AvlBinding: React__default.FC<AvlBindingProps>;
 
 interface AvlPersistenceProps extends AvlBaseProps {
     kind: AvlPersistenceKind;
     size?: number;
     label?: string;
 }
-declare const AvlPersistence: React.FC<AvlPersistenceProps>;
+declare const AvlPersistence: React__default.FC<AvlPersistenceProps>;
 
 interface AvlOperatorProps extends AvlBaseProps {
     name: string;
     namespace?: AvlOperatorNamespace;
     size?: number;
 }
-declare const AvlOperator: React.FC<AvlOperatorProps>;
+declare const AvlOperator: React__default.FC<AvlOperatorProps>;
 
 interface AvlSExprProps extends AvlBaseProps {
     width?: number;
     height?: number;
     label?: string;
 }
-declare const AvlSExpr: React.FC<AvlSExprProps>;
+declare const AvlSExpr: React__default.FC<AvlSExprProps>;
 
 interface AvlLiteralProps extends AvlBaseProps {
     value: string;
     size?: number;
 }
-declare const AvlLiteral: React.FC<AvlLiteralProps>;
+declare const AvlLiteral: React__default.FC<AvlLiteralProps>;
 
 interface AvlBindingRefProps extends AvlBaseProps {
     path: string;
     size?: number;
 }
-declare const AvlBindingRef: React.FC<AvlBindingRefProps>;
+declare const AvlBindingRef: React__default.FC<AvlBindingRefProps>;
 
 interface AvlStateMachineState {
     name: string;
@@ -232,7 +234,7 @@ interface AvlStateMachineProps {
     color?: string;
     animated?: boolean;
 }
-declare const AvlStateMachine: React.FC<AvlStateMachineProps>;
+declare const AvlStateMachine: React__default.FC<AvlStateMachineProps>;
 
 interface AvlOrbitalUnitTrait {
     name: string;
@@ -251,7 +253,7 @@ interface AvlOrbitalUnitProps {
     color?: string;
     animated?: boolean;
 }
-declare const AvlOrbitalUnit: React.FC<AvlOrbitalUnitProps>;
+declare const AvlOrbitalUnit: React__default.FC<AvlOrbitalUnitProps>;
 
 interface AvlClosedCircuitState {
     name: string;
@@ -270,7 +272,7 @@ interface AvlClosedCircuitProps {
     color?: string;
     animated?: boolean;
 }
-declare const AvlClosedCircuit: React.FC<AvlClosedCircuitProps>;
+declare const AvlClosedCircuit: React__default.FC<AvlClosedCircuitProps>;
 
 interface AvlEmitListenProps {
     emitter: {
@@ -286,7 +288,7 @@ interface AvlEmitListenProps {
     color?: string;
     animated?: boolean;
 }
-declare const AvlEmitListen: React.FC<AvlEmitListenProps>;
+declare const AvlEmitListen: React__default.FC<AvlEmitListenProps>;
 
 interface AvlSlotMapSlot {
     name: string;
@@ -304,7 +306,7 @@ interface AvlSlotMapProps {
     color?: string;
     animated?: boolean;
 }
-declare const AvlSlotMap: React.FC<AvlSlotMapProps>;
+declare const AvlSlotMap: React__default.FC<AvlSlotMapProps>;
 
 interface AvlExprTreeNode {
     label: string;
@@ -317,7 +319,7 @@ interface AvlExprTreeProps {
     color?: string;
     animated?: boolean;
 }
-declare const AvlExprTree: React.FC<AvlExprTreeProps>;
+declare const AvlExprTree: React__default.FC<AvlExprTreeProps>;
 
 interface AvlTransitionLaneEffect {
     type: AvlEffectType | string;
@@ -334,7 +336,7 @@ interface AvlTransitionLaneProps {
     color?: string;
     onTransitionClick?: () => void;
 }
-declare const AvlTransitionLane: React.FC<AvlTransitionLaneProps>;
+declare const AvlTransitionLane: React__default.FC<AvlTransitionLaneProps>;
 
 interface AvlSwimLaneProps {
     listenedEvents: string[];
@@ -342,9 +344,9 @@ interface AvlSwimLaneProps {
     centerWidth: number;
     height: number;
     color?: string;
-    children: React.ReactNode;
+    children: React__default.ReactNode;
 }
-declare const AvlSwimLane: React.FC<AvlSwimLaneProps>;
+declare const AvlSwimLane: React__default.FC<AvlSwimLaneProps>;
 
 /**
  * AvlBehaviorGlyph - Visual identity for a behavior.
@@ -405,7 +407,7 @@ interface AvlBehaviorGlyphProps {
     /** Click handler */
     onClick?: () => void;
 }
-declare const AvlBehaviorGlyph: React.FC<AvlBehaviorGlyphProps>;
+declare const AvlBehaviorGlyph: React__default.FC<AvlBehaviorGlyphProps>;
 
 /**
  * AVL layout utilities for positioning atoms in composed diagrams.
@@ -567,6 +569,256 @@ declare function parseTraitLevel(schema: OrbitalSchema, orbitalName: string, tra
  */
 declare function parseTransitionLevel(schema: OrbitalSchema, orbitalName: string, traitName: string, transitionIndex: number): TransitionLevelData | null;
 
+/**
+ * AVL Canvas Types
+ *
+ * Types for the unified AVL + Flow canvas. These define the data shapes
+ * for React Flow nodes and edges that render AVL primitives.
+ */
+
+/** The four zoom bands of the unified AVL canvas. */
+type ZoomBand = 'system' | 'module' | 'behavior' | 'detail';
+/** Thresholds for zoom band transitions (React Flow viewport zoom). */
+declare const ZOOM_BAND_THRESHOLDS: {
+    readonly system: readonly [0.1, 0.4];
+    readonly module: readonly [0.4, 1];
+    readonly behavior: readonly [1, 2.5];
+    readonly detail: readonly [2.5, 5];
+};
+/** Data carried by every orbital node in the unified canvas. */
+interface AvlNodeData extends Record<string, unknown> {
+    orbitalName: string;
+    entityName: string;
+    persistence: string;
+    fields: FieldInfo[];
+    traits: OrbitalTraitInfo[];
+    pages: OrbitalPageInfo[];
+    traitDetails: Record<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;
+}
+
+/** Determine which zoom band the current viewport zoom falls into. */
+declare function computeZoomBand(zoom: number): ZoomBand;
+/**
+ * Compute progress (0..1) within a zoom band.
+ * Useful for crossfade transitions between bands.
+ */
+declare function zoomProgress(zoom: number, band: ZoomBand): number;
+/** Context providing the current zoom band to all node components. */
+declare const ZoomBandContext: React.Context<ZoomBand>;
+/** Hook to read the current zoom band. */
+declare function useZoomBand(): ZoomBand;
+
+/**
+ * AVL Flow Converter
+ *
+ * Converts an OrbitalSchema into React Flow nodes and edges
+ * for the unified AVL canvas. Reuses the existing AVL schema parser.
+ */
+
+/**
+ * Transform an OrbitalSchema into React Flow nodes and edges.
+ * Pre-parses all orbital and trait details for responsive zoom.
+ */
+declare function schemaToFlowGraph(schema: OrbitalSchema): {
+    nodes: Node<AvlNodeData>[];
+    edges: Edge<AvlEdgeData>[];
+};
+
+/**
+ * AVL ELK Layout
+ *
+ * Shared ELK-based layout engine for state machines. Extracted from
+ * AvlTraitScene so both the V2 scene renderer and the V3 BehaviorView
+ * can share the same layout computation.
+ */
+
+interface LayoutNode {
+    id: string;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    isInitial?: boolean;
+    isTerminal?: boolean;
+    role: StateRole;
+    transitionCount: number;
+}
+interface LayoutEdge {
+    id: string;
+    from: string;
+    to: string;
+    event: string;
+    effects: Array<{
+        type: string;
+    }>;
+    guard: boolean;
+    guardExpr?: string;
+    index: number;
+    labelX: number;
+    labelY: number;
+    labelW: number;
+    labelH: number;
+    points: Array<{
+        x: number;
+        y: number;
+    }>;
+    isSelf: boolean;
+    isBackward: boolean;
+}
+interface ElkLayout {
+    nodes: LayoutNode[];
+    edges: LayoutEdge[];
+    width: number;
+    height: number;
+}
+declare function computeTraitLayout(data: TraitLevelData): Promise<ElkLayout>;
+declare function edgePath(points: Array<{
+    x: number;
+    y: number;
+}>): string;
+
+/**
+ * SystemNode — Compact orbital node for the system zoom band (0.1x-0.4x).
+ *
+ * Renders miniature AVL primitives: entity glyph, field-type dots,
+ * state chain (role-colored dots), and page squares.
+ */
+
+interface SystemNodeProps {
+    data: AvlNodeData;
+}
+declare const SystemNode: React__default.FC<SystemNodeProps>;
+
+/**
+ * MiniStateMachine — Inline simplified state machine for the ModuleCard.
+ *
+ * Renders a compact left-to-right flow of AvlState nodes connected
+ * by AvlTransition arrows, with AvlEffect icons below.
+ * No ELK layout needed — uses simple horizontal positioning.
+ */
+
+interface MiniStateMachineProps {
+    data: TraitLevelData;
+    className?: string;
+}
+declare const MiniStateMachine: React__default.FC<MiniStateMachineProps>;
+
+/**
+ * ModuleCard — Structured card for the module zoom band (0.4x-1.0x).
+ *
+ * Renders AVL primitives inside a card container:
+ * - Entity section: AvlEntity glyph + AvlPersistence + AvlFieldType grid
+ * - Trait sections: MiniStateMachine per trait + AvlEffect icons + emit/listen indicators
+ * - Pages section: AvlPage squares with route labels
+ */
+
+interface ModuleCardProps {
+    data: AvlNodeData;
+}
+declare const ModuleCard: React__default.FC<ModuleCardProps>;
+
+/**
+ * BehaviorView — Full state machine for the behavior zoom band (1.0x-2.5x).
+ *
+ * Uses ELK layout from avl-elk-layout.ts. Renders AvlState, AvlTransitionLane,
+ * and AvlSwimLane inside an inline SVG within a React Flow node.
+ */
+
+interface BehaviorViewProps {
+    data: AvlNodeData;
+}
+declare const BehaviorView: React__default.FC<BehaviorViewProps>;
+
+/**
+ * DetailView — Transition specification card for the detail zoom band (2.5x-5.0x).
+ *
+ * Renders a spec card with: from/to AvlState nodes, AvlEvent trigger,
+ * AvlGuard diamond, numbered AvlEffect icons with binding paths,
+ * and AvlFieldType shapes.
+ */
+
+interface DetailViewProps {
+    data: AvlNodeData;
+}
+declare const DetailView: React__default.FC<DetailViewProps>;
+
+/**
+ * AvlOrbitalNode — Single React Flow node type for the unified AVL canvas.
+ *
+ * Reads the current ZoomBand from context and renders the appropriate
+ * sub-component: SystemNode, ModuleCard, BehaviorView, or DetailView.
+ *
+ * Using a single node type (instead of switching types per zoom band)
+ * prevents React from unmounting/remounting nodes on zoom changes.
+ */
+
+declare const AvlOrbitalNode: React__default.FC<NodeProps>;
+
+/**
+ * AvlTransitionEdge — React Flow edge for state machine transitions.
+ *
+ * Bezier path with event label at midpoint. Guard diamond and effect
+ * dot indicators shown inline. Forward transitions are solid dark,
+ * backward transitions are dashed lighter.
+ */
+
+interface AvlTransitionEdgeData extends Record<string, unknown> {
+    event: string;
+    hasGuard?: boolean;
+    hasEffects?: boolean;
+}
+type AvlTransitionFlowEdge = Edge<AvlTransitionEdgeData, 'transition'>;
+declare const AvlTransitionEdge: React__default.FC<EdgeProps<AvlTransitionFlowEdge>>;
+
+/**
+ * AvlEventWireEdge — React Flow edge for emit/listen event wiring.
+ *
+ * Dashed orange Bezier path with event name label at midpoint.
+ * Uses AVL CONNECTION_COLORS.emitListen styling.
+ */
+
+interface AvlEventWireEdgeData extends Record<string, unknown> {
+    event: string;
+    compatible?: boolean;
+}
+type AvlEventWireFlowEdge = Edge<AvlEventWireEdgeData, 'eventWire'>;
+declare const AvlEventWireEdge: React__default.FC<EdgeProps<AvlEventWireFlowEdge>>;
+
+/**
+ * AvlBackwardEdge — Dashed backward/retry transition edge.
+ *
+ * Uses CONNECTION_COLORS.backward styling: dashed, lighter color.
+ */
+
+declare const AvlBackwardEdge: React__default.FC<EdgeProps>;
+
+/**
+ * AvlPageEdge — Thin solid page-reference edge.
+ *
+ * Slate colored, 1px, used for page-to-trait references.
+ */
+
+declare const AvlPageEdge: React__default.FC<EdgeProps>;
+
+/**
+ * AvlBindingEdge — Dotted violet binding edge with @ marker.
+ *
+ * Used for data binding connections. Dotted line at 1px with
+ * a small @ label at the midpoint.
+ */
+
+declare const AvlBindingEdge: React__default.FC<EdgeProps>;
+
 /**
  * AVL Cosmic Zoom State Machine
  *
@@ -578,13 +830,68 @@ declare function parseTransitionLevel(schema: OrbitalSchema, orbitalName: string
 type ZoomLevel = 'application' | 'orbital' | 'trait' | 'transition';
 
 /**
- * AvlCosmicZoom - Interactive Zoomable Orbital Visualization
+ * FlowCanvas — Unified AVL + Flow canvas organism.
  *
- * The host organism that owns the SVG viewport and delegates to
- * scene renderers at each zoom level. Manages animation, pan/zoom,
- * and breadcrumb navigation.
+ * One React Flow canvas with continuous semantic zoom. AVL primitives
+ * render inside React Flow nodes. The ZoomBandContext drives node
+ * rendering at different zoom levels.
  *
- * @packageDocumentation
+ * Replaces both AvlCosmicZoom (SVG viewer) and OrbitalFlow (Flow editor).
+ */
+
+interface FlowCanvasProps {
+    schema: OrbitalSchema | string;
+    className?: string;
+    color?: string;
+    animated?: boolean;
+    width?: number | string;
+    height?: number | string;
+    onZoomChange?: (level: ZoomLevel, context: {
+        orbital?: string;
+        trait?: string;
+    }) => void;
+    focusTarget?: {
+        type: 'orbital' | 'trait';
+        name: string;
+    };
+    initialOrbital?: string;
+    initialTrait?: string;
+    stateCoverage?: Record<string, 'covered' | 'uncovered' | 'partial'>;
+}
+declare const FlowCanvas: React__default.FC<FlowCanvasProps>;
+
+/**
+ * ZoomBreadcrumb — HTML overlay showing current zoom band context.
+ *
+ * Positioned absolute top-left of the FlowCanvas.
+ * Shows AVL primitive icons inline with breadcrumb segments.
+ */
+
+interface ZoomBreadcrumbProps {
+    band: ZoomBand;
+    applicationName?: string;
+    orbitalName?: string;
+    traitName?: string;
+    eventName?: string;
+}
+declare const ZoomBreadcrumb: React__default.FC<ZoomBreadcrumbProps>;
+
+/**
+ * ZoomLegend — Collapsible HTML overlay showing AVL primitives
+ * relevant to the current zoom band.
+ */
+
+interface ZoomLegendProps {
+    band: ZoomBand;
+}
+declare const ZoomLegend: React__default.FC<ZoomLegendProps>;
+
+/**
+ * AvlCosmicZoom — Interactive Zoomable Orbital Visualization
+ *
+ * V3: Delegates to FlowCanvas, which renders AVL primitives inside
+ * React Flow nodes with continuous semantic zoom. The Props interface
+ * is preserved for backward compatibility with callers.
  */
 
 interface AvlCosmicZoomProps {
@@ -611,46 +918,13 @@ interface AvlCosmicZoomProps {
     height?: number | string;
     /** Coverage data for verification overlay */
     stateCoverage?: Record<string, 'covered' | 'uncovered' | 'partial'>;
+    /** Dynamic focus target. Changes animate the zoom to the specified orbital/trait. */
+    focusTarget?: {
+        type: 'orbital' | 'trait';
+        name: string;
+    };
 }
-declare const AvlCosmicZoom: React.FC<AvlCosmicZoomProps>;
-
-/**
- * AvlApplicationScene - Zoom Level 1
- *
- * Shows all orbitals in the application with cross-orbital
- * emit/listen arrows. Each orbital is a clickable AvlOrbitalUnit.
- */
-
-interface AvlApplicationSceneProps {
-    data: ApplicationLevelData;
-    color?: string;
-    onOrbitalClick?: (orbitalName: string, position: {
-        x: number;
-        y: number;
-    }) => void;
-}
-declare const AvlApplicationScene: React.FC<AvlApplicationSceneProps>;
-
-/**
- * AvlOrbitalScene - Zoom Level 2
- *
- * Shows a single orbital: entity nucleus with fields,
- * trait rings, page markers, and external connection arrows.
- */
-
-interface AvlOrbitalSceneProps {
-    data: OrbitalLevelData;
-    color?: string;
-    /** Currently highlighted trait (before zooming in) */
-    highlightedTrait?: string | null;
-    onTraitClick?: (traitName: string, position: {
-        x: number;
-        y: number;
-    }) => void;
-    /** Called when a trait tab is hovered/selected (highlight without zoom) */
-    onTraitHighlight?: (traitName: string | null) => void;
-}
-declare const AvlOrbitalScene: React.FC<AvlOrbitalSceneProps>;
+declare const AvlCosmicZoom: React__default.FC<AvlCosmicZoomProps>;
 
 /**
  * AvlTraitScene V2 - Zoom Level 3
@@ -667,7 +941,7 @@ interface AvlTraitSceneProps {
         y: number;
     }) => void;
 }
-declare const AvlTraitScene: React.FC<AvlTraitSceneProps>;
+declare const AvlTraitScene: React__default.FC<AvlTraitSceneProps>;
 
 /**
  * AvlTransitionScene V2 - Zoom Level 4
@@ -680,7 +954,7 @@ interface AvlTransitionSceneProps {
     data: TransitionLevelData;
     color?: string;
 }
-declare const AvlTransitionScene: React.FC<AvlTransitionSceneProps>;
+declare const AvlTransitionScene: React__default.FC<AvlTransitionSceneProps>;
 
 /**
  * AvlClickTarget
@@ -710,8 +984,8 @@ interface AvlClickTargetProps {
     /** Accessible label */
     label?: string;
     /** Children (the AVL atoms to render on top) */
-    children: React.ReactNode;
+    children: React__default.ReactNode;
 }
-declare const AvlClickTarget: React.FC<AvlClickTargetProps>;
+declare const AvlClickTarget: React__default.FC<AvlClickTargetProps>;
 
-export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlApplicationScene, type AvlApplicationSceneProps, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, type AvlOrbitalProps, AvlOrbitalScene, type AvlOrbitalSceneProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlPage, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, CONNECTION_COLORS, type CrossLink, DOMAIN_COLORS, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, type EffectCategory, type GlyphSize, type OrbitalLevelData, STATE_COLORS, type StateRole, type TraitLevelData, type TransitionLevelData, type ZoomLevel, arcPath, curveControlPoint, getStateRole, gridPositions, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, ringPositions };
+export { AVL_FIELD_TYPE_SHAPES, AVL_OPERATOR_COLORS, type ApplicationLevelData, AvlApplication, type AvlApplicationProps, AvlBackwardEdge, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, AvlBindingEdge, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, type AvlEdgeData, AvlEffect, type AvlEffectProps, type AvlEffectType, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlEventWireEdge, type AvlEventWireEdgeData, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeKind, type AvlFieldTypeProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, type AvlNodeData, AvlOperator, type AvlOperatorNamespace, type AvlOperatorProps, AvlOrbital, AvlOrbitalNode, type AvlOrbitalProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlPage, AvlPageEdge, type AvlPageProps, AvlPersistence, type AvlPersistenceKind, type AvlPersistenceProps, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, AvlStateMachine, type AvlStateMachineProps, type AvlStateMachineState, type AvlStateMachineTransition, type AvlStateProps, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionEdge, type AvlTransitionEdgeData, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, BehaviorView, CONNECTION_COLORS, type CrossLink, DOMAIN_COLORS, DetailView, EFFECT_CATEGORY_COLORS, EFFECT_TYPE_TO_CATEGORY, type EffectCategory, type ElkLayout, FlowCanvas, type FlowCanvasProps, type GlyphSize, type LayoutEdge, type LayoutNode, MiniStateMachine, ModuleCard, type OrbitalLevelData, STATE_COLORS, type StateRole, SystemNode, type TraitLevelData, type TransitionLevelData, ZOOM_BAND_THRESHOLDS, type ZoomBand, ZoomBandContext, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, type ZoomLevel, arcPath, computeTraitLayout, computeZoomBand, curveControlPoint, edgePath, getStateRole, gridPositions, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, radialPositions, ringPositions, schemaToFlowGraph, useZoomBand, zoomProgress };

package/dist/avl/index.d.ts

@@ -1,8 +1,8 @@
 /**
  * @almadar/ui/avl
  *
- * Almadar Visual Language (AVL) - Formal visual notation for .orb constructs.
- * Atoms render <g> elements for composition. Molecules render full <svg>.
+ * Almadar Visual Language (AVL) — Formal visual notation for .orb constructs.
+ * V3: Unified with React Flow. AVL primitives render inside React Flow nodes.
  */
 export { AvlOrbital, type AvlOrbitalProps } from '../components/atoms/avl';
 export { AvlEntity, type AvlEntityProps } from '../components/atoms/avl';
@@ -36,4 +36,19 @@ export { AvlBehaviorGlyph, type AvlBehaviorGlyphProps, type BehaviorLevel, type
 export { AvlTransitionLane, type AvlTransitionLaneProps } from '../components/molecules/avl';
 export { AvlSwimLane, type AvlSwimLaneProps } from '../components/molecules/avl';
 export { ringPositions, arcPath, radialPositions, gridPositions, curveControlPoint } from '../components/molecules/avl';
-export { AvlCosmicZoom, type AvlCosmicZoomProps, AvlApplicationScene, type AvlApplicationSceneProps, AvlOrbitalScene, type AvlOrbitalSceneProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransitionScene, type AvlTransitionSceneProps, AvlClickTarget, type AvlClickTargetProps, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, type ApplicationLevelData, type OrbitalLevelData, type TraitLevelData, type TransitionLevelData, type CrossLink, type ZoomLevel, } from '../components/organisms/avl';
+export { type ZoomBand, type AvlNodeData, type AvlEdgeData, ZOOM_BAND_THRESHOLDS } from '../components/molecules/avl/avl-canvas-types';
+export { computeZoomBand, zoomProgress, useZoomBand, ZoomBandContext } from '../components/molecules/avl/avl-zoom-band';
+export { schemaToFlowGraph } from '../components/molecules/avl/avl-flow-converter';
+export { SystemNode } from '../components/molecules/avl/SystemNode';
+export { ModuleCard } from '../components/molecules/avl/ModuleCard';
+export { MiniStateMachine } from '../components/molecules/avl/MiniStateMachine';
+export { BehaviorView } from '../components/molecules/avl/BehaviorView';
+export { DetailView } from '../components/molecules/avl/DetailView';
+export { AvlOrbitalNode } from '../components/molecules/avl/AvlOrbitalNode';
+export { AvlTransitionEdge, type AvlTransitionEdgeData } from '../components/molecules/avl/AvlTransitionEdge';
+export { AvlEventWireEdge, type AvlEventWireEdgeData } from '../components/molecules/avl/AvlEventWireEdge';
+export { AvlBackwardEdge } from '../components/molecules/avl/AvlBackwardEdge';
+export { AvlPageEdge } from '../components/molecules/avl/AvlPageEdge';
+export { AvlBindingEdge } from '../components/molecules/avl/AvlBindingEdge';
+export { computeTraitLayout, edgePath, type LayoutNode, type LayoutEdge, type ElkLayout } from '../components/molecules/avl/avl-elk-layout';
+export { FlowCanvas, type FlowCanvasProps, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, AvlCosmicZoom, type AvlCosmicZoomProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransitionScene, type AvlTransitionSceneProps, AvlClickTarget, type AvlClickTargetProps, parseApplicationLevel, parseOrbitalLevel, parseTraitLevel, parseTransitionLevel, type ApplicationLevelData, type OrbitalLevelData, type TraitLevelData, type TransitionLevelData, type CrossLink, type ZoomLevel, } from '../components/organisms/avl';