@almadar/ui 6.59.0 → 6.62.0

package/dist/avl/index.d.ts

@@ -1,7 +1,7 @@
 import { OperatorCategory } from '@almadar/std';
 import * as React$1 from 'react';
 import React__default from 'react';
-import { FieldType, EntityPersistence, SExpr, EvalTrace, A11yProps, EventEmit, Expression, UISlot, OrbitalSchema, EntityData, EditFocus, EventPayload, AriaRole, DomainQuestion, DomainQuestionAnswer, ThemeDefinition, CircuitStepResult, GuardEvaluation, EffectTrace } from '@almadar/core';
+import { FieldType, EntityPersistence, SExpr, EvalTrace, A11yProps, EventEmit, Expression, OrbitalSchema, EntityData, EditFocus, EventPayload, AriaRole, DomainQuestion, DomainQuestionAnswer, ThemeDefinition, CircuitStepResult, GuardEvaluation, EffectTrace, EventPayloadValue } from '@almadar/core';
 import { A as AvlAnnotations, a as AvlNodeData, F as FileTreeItem, b as AvlNote } from '../FileTree-BSfgp-HH.js';
 export { c as AvlEdgeData, d as AvlStateMachine, e as AvlStateMachineProps, B as BehaviorView, M as ModuleCard, s as schemaToFlowGraph } from '../FileTree-BSfgp-HH.js';
 import { T as TraitLevelData, d as TraitTransitionInfo, c as TransitionLevelData, S as SerializedEffect } from '../avl-schema-parser-CH1QoZw1.js';
@@ -762,16 +762,15 @@ interface PatternEventSource {
 }
 /** A slot + pattern config pair extracted from a render-ui effect. */
 interface RenderUIEntry {
-    slot: UISlot | string;
+    slot: string;
     pattern: AnyPatternConfig;
 }
-/** Data for a preview node (used at both overview and expanded levels). */
-interface PreviewNodeData {
-    [key: string]: string | number | boolean | string[] | Expression | null | RenderUIEntry[] | PatternEventSource[] | Array<{
-        event: string;
-        fromState: string;
-        toState: string;
-    }> | OrbitalSchema | EntityData | undefined;
+/**
+ * Data for a preview node (used at both overview and expanded levels). A closed
+ * type alias, not an index-signature interface: it stays assignable to React
+ * Flow's `Record<string, unknown>` node-data bound while every field is declared.
+ */
+type PreviewNodeData = {
     /** Orbital this node belongs to. */
     orbitalName: string;
     /** Trait name (a card showing a picked state). */
@@ -891,7 +890,7 @@ interface PreviewNodeData {
     _fullSchema?: OrbitalSchema;
     /** Mock entity data for the orbital preview. */
     _mockData?: EntityData;
-}
+};
 /** Data for event flow edges. */
 interface EventEdgeData {
     [key: string]: string | boolean | undefined;
@@ -1608,6 +1607,7 @@ interface FlowCanvasProps {
     systemDependencies?: SystemDependencies;
     /** Trait level: which lens (and trait filter) shows — pass with `onTraitViewChange` to keep it across remounts. */
     traitView?: TraitView;
+    /** @notification */
     onTraitViewChange?: (view: TraitView) => void;
     /** Dependencies lens: emits UI:{openBehaviorEvent} with { name } to open a selected behavior's source. */
     openBehaviorEvent?: EventEmit<{
@@ -1618,7 +1618,10 @@ interface FlowCanvasProps {
         steps: readonly AvlPlayStep[];
         cursor: number;
     };
-    /** Fired when the focused orbital, the scope, or the focused card's state changes. */
+    /**
+     * Fired when the focused orbital, the scope, or the focused card's state changes.
+     * @notification
+     */
     onFocusChange?: (focus: CanvasFocusChange) => void;
     /** The orbital cards open on (local view) — or, with `initialLevel="trait-expanded"`, the orbital whose traits are shown. */
     initialOrbital?: string;
@@ -1666,13 +1669,17 @@ interface FlowCanvasProps {
      * name on enter and `null` on leave. Reserved for the upcoming trace
      * tooltip: consumers will use it to anchor a popover that shows the
      * subagent's live trace + reasoning for the hovered orbital.
+     * @notification
      */
     onOrbitalHover?: (orbitalName: string | null) => void;
     /** Layout hint: 'pipeline' renders nodes left-to-right, 'grid' (default) uses sqrt-based grid. */
     layoutHint?: 'pipeline' | 'grid';
     /** Called when the user clicks a node in overview level (for composition hints). */
     onNodeSelect?: (orbitalName: string) => void;
-    /** @deprecated Use onNodeClick instead. Kept for AvlCosmicZoom compat. */
+    /**
+     * @deprecated Use onNodeClick instead. Kept for AvlCosmicZoom compat.
+     * @notification
+     */
     onZoomChange?: (level: string, context: Record<string, string | undefined>) => void;
     /** @deprecated Not used in V3. */
     focusTarget?: {
@@ -1711,6 +1718,7 @@ interface FlowCanvasProps {
     /**
      * Fired on node drag-stop and card resize with the full {id → placement}
      * map of the current node set, so the consumer can persist the arrangement.
+     * @notification
      */
     onPositionsChange?: (positions: Record<string, CanvasNodePlacement>) => void;
     /**
@@ -1718,6 +1726,7 @@ interface FlowCanvasProps {
      * escape, clear-on-level-change, and pattern-selection sync all route
      * through this. Lets a consumer mirror selection into a persistent
      * properties panel rendered outside the canvas (see `externalInspector`).
+     * @notification
      */
     onSelectedNodeChange?: (node: PreviewNodeData | null) => void;
     /**
@@ -1728,6 +1737,7 @@ interface FlowCanvasProps {
      * `externalInspector`) has no other way to learn which pattern the user
      * picked — pass this straight through to `OrbInspector`'s `selectedPattern`
      * prop to keep Design-tab prop editing working outside the canvas.
+     * @notification
      */
     onSelectedPatternChange?: (pattern: SelectedPattern | null) => void;
     /**
@@ -2174,4 +2184,17 @@ declare namespace KnobSettingRow {
     var displayName: string;
 }
 
-export { AVL_GLYPH_KINDS, AVL_GRAPH_NODE_TYPES, AvlAnnotations, AvlApplication, type AvlApplicationProps, AvlBackwardEdge, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, AvlBindingEdge, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlCircuit, type AvlCircuitProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, AvlEffect, AvlEffectChip, type AvlEffectChipProps, type AvlEffectProps, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlEventWireEdge, type AvlEventWireEdgeData, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeProps, AvlGlyph, type AvlGlyphKind, type AvlGlyphProps, AvlGraphCanvas, type AvlGraphCanvasProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, AvlNodeData, AvlNote, AvlOperator, type AvlOperatorProps, AvlOrbital, type AvlOrbitalProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps, AvlPage, AvlPageEdge, type AvlPageProps, AvlPersistence, type AvlPersistenceProps, type AvlPlayStep, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, type AvlStateMachinePlayback, type AvlStateProps, type AvlStepRequest, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionDetail, type AvlTransitionDetailProps, AvlTransitionEdge, type AvlTransitionEdgeData, AvlTransitionExplainer, type AvlTransitionExplainerProps, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionPlayback, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, CANVAS_TOOLS, CONNECTION_COLORS, type CanvasContainerNode, CanvasDndProvider, type CanvasDndProviderProps, type CanvasDragKind, type CanvasDragPayload, type CanvasDropEvent, type CanvasDropTarget, type CanvasFocusChange, type CanvasResolvedDrop, type CanvasScope, type CanvasStateGroup, type CanvasStateOption, type CanvasStateOptions, type CanvasStateView, type CanvasTool, type CanvasVerify, CanvasVerifyContext, type CanvasViewOptions, type CardVerdict, DEPLOYMENT_ROW, DOMAIN_COLORS, DependencyColumnNode, type DependencyLayer, DependencyNode, DetailView, EDITABLE, EFFECT_CATEGORY_COLORS, type EffectCategory, type ElementEditAccess, ElementEditAccessContext, type ElementEditAccessResolver, type ElementKnob, type ElementPropAccess, type ElementSettings, type ElkLayout, type EventEdgeData, EventFlowEdge, FIELD_TYPE_SHAPES, type FieldTypeShape, FlowCanvas, type FlowCanvasProps, type GlyphSize, type InlineTextEditOptions, KnobField, type KnobFieldProps, KnobSettingRow, type KnobSettingRowProps, LIVE_STATE, type LayerIdParts, type LayeredColumn, type LayeredColumnId, type LayeredEdge, type LayeredGraphInput, type LayeredRow, type LayeredUnit, LayersPanel, type LayersPanelProps, type LayoutEdge, type LayoutNode, MiniStateMachine, OPERATOR_CATEGORY_COLORS, OrbInspector, type OrbInspectorProps, OrbPreviewNode, type PatternEventSource, type PlayedStep, type PreviewNodeData, type RenderUIEntry, STATE_COLORS, type SelectedPattern, type StateRole, SystemBandNode, type SystemDependencies, SystemMapContext, type SystemMapContextValue, SystemNode, type TraitFlowEdge, type TraitFlowUnit, TraitLevelData, TraitTransitionInfo, type TraitView, TransitionLevelData, type UseCanvasDraggableArgs, type UseCanvasDraggableResult, type UseCanvasDroppableArgs, type UseCanvasDroppableResult, type ViewLevel, ZOOM_BAND_THRESHOLDS, type ZoomBand, ZoomBandContext, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, ZoomLevel, arcPath, armPosition, armsOf, canvasViewGraph, computeTraitLayout, computeZoomBand, curveControlPoint, dependencyReach, deploymentGraph, deriveEditFocusFromElement, dropBusEvent, edgePath, effectCategoryOf, firedTransition, flowNeighbors, getStateRole, gridPositions, hasCanvasTool, initialStateOf, layeredGraph, optionForPlayedStep, parseLayerId, propAccessAt, radialPositions, ringPositions, schemaToDependencyGraph, schemaToLayerItems, schemaToOverviewGraph, stateMachinePlayback, stateOptionsOf, traitFlowGraph, transitionPlayback, useCanvasDraggable, useCanvasDroppable, useInlineTextEdit, useZoomBand, zoomProgress };
+/**
+ * Typed decoders for the AVL organisms' rich props (G-CROSS-131): a `.lolo` value arrives as an
+ * `EventPayloadValue` and is validated into the component's declared type field by field, so the
+ * compiled app needs no cast. Pattern configs go through core's `PatternObjectSchema`.
+ */
+
+/** Validates a node of the canvas preview (`OrbInspector node`). */
+declare function decodePreviewNodeData(value: EventPayloadValue): PreviewNodeData;
+/** Validates an in-node pattern selection (`OrbInspector selectedPattern`). */
+declare function decodeSelectedPattern(value: EventPayloadValue): SelectedPattern;
+/** Validates persisted canvas node positions (`FlowCanvas nodePositions`). */
+declare function decodeNodePlacements(value: EventPayloadValue): Record<string, CanvasNodePlacement>;
+
+export { AVL_GLYPH_KINDS, AVL_GRAPH_NODE_TYPES, AvlAnnotations, AvlApplication, type AvlApplicationProps, AvlBackwardEdge, type AvlBaseProps, AvlBehaviorGlyph, type AvlBehaviorGlyphProps, AvlBinding, AvlBindingEdge, type AvlBindingProps, AvlBindingRef, type AvlBindingRefProps, AvlCircuit, type AvlCircuitProps, AvlClickTarget, type AvlClickTargetProps, AvlClosedCircuit, type AvlClosedCircuitProps, type AvlClosedCircuitState, type AvlClosedCircuitTransition, AvlCosmicZoom, type AvlCosmicZoomProps, AvlEffect, AvlEffectChip, type AvlEffectChipProps, type AvlEffectProps, AvlEmitListen, type AvlEmitListenProps, AvlEntity, type AvlEntityProps, AvlEvent, type AvlEventProps, AvlEventWireEdge, type AvlEventWireEdgeData, AvlExprTree, type AvlExprTreeNode, type AvlExprTreeProps, AvlField, type AvlFieldProps, AvlFieldType, type AvlFieldTypeProps, AvlGlyph, type AvlGlyphKind, type AvlGlyphProps, AvlGraphCanvas, type AvlGraphCanvasProps, AvlGuard, type AvlGuardProps, AvlLiteral, type AvlLiteralProps, AvlNodeData, AvlNote, AvlOperator, type AvlOperatorProps, AvlOrbital, type AvlOrbitalProps, AvlOrbitalUnit, type AvlOrbitalUnitPage, type AvlOrbitalUnitProps, type AvlOrbitalUnitTrait, AvlOrbitalsCosmicZoom, type AvlOrbitalsCosmicZoomProps, AvlPage, AvlPageEdge, type AvlPageProps, AvlPersistence, type AvlPersistenceProps, type AvlPlayStep, AvlSExpr, type AvlSExprProps, AvlSlotMap, type AvlSlotMapProps, type AvlSlotMapSlot, AvlState, type AvlStateMachinePlayback, type AvlStateProps, type AvlStepRequest, AvlSwimLane, type AvlSwimLaneProps, AvlTrait, type AvlTraitProps, AvlTraitScene, type AvlTraitSceneProps, AvlTransition, AvlTransitionDetail, type AvlTransitionDetailProps, AvlTransitionEdge, type AvlTransitionEdgeData, AvlTransitionExplainer, type AvlTransitionExplainerProps, AvlTransitionLane, type AvlTransitionLaneProps, type AvlTransitionPlayback, type AvlTransitionProps, AvlTransitionScene, type AvlTransitionSceneProps, type BehaviorGlyphChild, type BehaviorGlyphConnection, type BehaviorLevel, CANVAS_TOOLS, CONNECTION_COLORS, type CanvasContainerNode, CanvasDndProvider, type CanvasDndProviderProps, type CanvasDragKind, type CanvasDragPayload, type CanvasDropEvent, type CanvasDropTarget, type CanvasFocusChange, type CanvasResolvedDrop, type CanvasScope, type CanvasStateGroup, type CanvasStateOption, type CanvasStateOptions, type CanvasStateView, type CanvasTool, type CanvasVerify, CanvasVerifyContext, type CanvasViewOptions, type CardVerdict, DEPLOYMENT_ROW, DOMAIN_COLORS, DependencyColumnNode, type DependencyLayer, DependencyNode, DetailView, EDITABLE, EFFECT_CATEGORY_COLORS, type EffectCategory, type ElementEditAccess, ElementEditAccessContext, type ElementEditAccessResolver, type ElementKnob, type ElementPropAccess, type ElementSettings, type ElkLayout, type EventEdgeData, EventFlowEdge, FIELD_TYPE_SHAPES, type FieldTypeShape, FlowCanvas, type FlowCanvasProps, type GlyphSize, type InlineTextEditOptions, KnobField, type KnobFieldProps, KnobSettingRow, type KnobSettingRowProps, LIVE_STATE, type LayerIdParts, type LayeredColumn, type LayeredColumnId, type LayeredEdge, type LayeredGraphInput, type LayeredRow, type LayeredUnit, LayersPanel, type LayersPanelProps, type LayoutEdge, type LayoutNode, MiniStateMachine, OPERATOR_CATEGORY_COLORS, OrbInspector, type OrbInspectorProps, OrbPreviewNode, type PatternEventSource, type PlayedStep, type PreviewNodeData, type RenderUIEntry, STATE_COLORS, type SelectedPattern, type StateRole, SystemBandNode, type SystemDependencies, SystemMapContext, type SystemMapContextValue, SystemNode, type TraitFlowEdge, type TraitFlowUnit, TraitLevelData, TraitTransitionInfo, type TraitView, TransitionLevelData, type UseCanvasDraggableArgs, type UseCanvasDraggableResult, type UseCanvasDroppableArgs, type UseCanvasDroppableResult, type ViewLevel, ZOOM_BAND_THRESHOLDS, type ZoomBand, ZoomBandContext, ZoomBreadcrumb, type ZoomBreadcrumbProps, ZoomLegend, type ZoomLegendProps, ZoomLevel, arcPath, armPosition, armsOf, canvasViewGraph, computeTraitLayout, computeZoomBand, curveControlPoint, decodeNodePlacements, decodePreviewNodeData, decodeSelectedPattern, dependencyReach, deploymentGraph, deriveEditFocusFromElement, dropBusEvent, edgePath, effectCategoryOf, firedTransition, flowNeighbors, getStateRole, gridPositions, hasCanvasTool, initialStateOf, layeredGraph, optionForPlayedStep, parseLayerId, propAccessAt, radialPositions, ringPositions, schemaToDependencyGraph, schemaToLayerItems, schemaToOverviewGraph, stateMachinePlayback, stateOptionsOf, traitFlowGraph, transitionPlayback, useCanvasDraggable, useCanvasDroppable, useInlineTextEdit, useZoomBand, zoomProgress };