@almadar/ui 4.54.5 → 4.54.7

package/dist/avl/index.d.cts

@@ -840,8 +840,12 @@ declare const AvlBindingEdge: React__default.FC<EdgeProps>;
  * - `behavior-expanded` (L3) — drilled into a single imported behavior at
  *   L2: one card per transition of THAT behavior. Used to inspect what an
  *   import contributes without leaving the canvas.
+ * - `trait-expanded` — one card per trait of a single orbital, connected
+ *   by intra-orbital `emits → listens` edges. Used by the cosmic tab to
+ *   render the trait-level circuit when the user drills into an orbital
+ *   from the L1 grid. Not used by the canvas tab today.
  */
-type ViewLevel = 'overview' | 'expanded' | 'behavior-expanded';
+type ViewLevel = 'overview' | 'expanded' | 'behavior-expanded' | 'trait-expanded';
 /**
  * An interactive element inside a render-ui pattern that fires an event.
  * For example, a button with `event: "CHECKOUT"` is an event source.
@@ -954,6 +958,42 @@ interface PreviewNodeData extends Record<string, unknown> {
      * card. Renderer can surface it as a "+N screens" badge.
      */
     transitionCount?: number;
+    /**
+     * Discriminator for the node variant. Absent on overview/expanded/
+     * behavior-expanded cards (those use field-presence-based discrimination
+     * via `behaviorAlias`/`transitionEvent`). Set to `'trait-card'` for nodes
+     * produced by `orbitalToTraitGraph` so renderers can branch cleanly.
+     */
+    kind?: 'trait-card';
+    /**
+     * Trait-card transitions (`kind === 'trait-card'` only). One row per
+     * transition; each row is clickable and drills to L4 transition detail
+     * in cosmic. `event` is the trigger; `fromState` / `toState` mirror the
+     * underlying state-machine edge.
+     */
+    transitions?: Array<{
+        event: string;
+        fromState: string;
+        toState: string;
+    }>;
+    /**
+     * Trait-card `emits` event names (`kind === 'trait-card'` only). One
+     * source handle per entry on the right edge of the card. Drives the
+     * outgoing wire endpoints in `orbitalToTraitGraph`.
+     */
+    emits?: string[];
+    /**
+     * Trait-card `listens` event names (`kind === 'trait-card'` only). One
+     * target handle per entry on the left edge of the card. Drives the
+     * incoming wire endpoints in `orbitalToTraitGraph`.
+     */
+    listens?: string[];
+    /**
+     * Trait-card `linkedEntity` (`kind === 'trait-card'` only). Surfaced as a
+     * subtitle/badge next to the trait name so users can see what entity the
+     * trait operates on. Mirrors `Trait.linkedEntity` from the resolved schema.
+     */
+    linkedEntity?: string;
 }
 /** Data for event flow edges. */
 interface EventEdgeData extends Record<string, unknown> {
@@ -1432,7 +1472,7 @@ interface FlowCanvasProps {
     width?: number | string;
     height?: number | string;
     onNodeClick?: (context: {
-        level: ViewLevel | 'code';
+        level: ViewLevel | 'code' | 'transition';
         orbital: string;
         trait?: string;
         transition?: string;
@@ -1575,6 +1615,12 @@ declare const ZoomLegend: React__default.FC<ZoomLegendProps>;
  * useReducer-based state machine managing which zoom level is displayed,
  * what is selected, and animation state.
  *
+ * Shared by AvlOrbitalsCosmicZoom (2D) and Avl3DViewer (3D). The 3D
+ * viewer drills through every level (`application → orbital → trait →
+ * transition`); the 2D cosmic view skips the `'orbital'` level after
+ * COSMIC-1 (no Orbital-View screen) by dispatching `JUMP_TO_TRAIT_CIRCUIT`
+ * to land directly at `'trait'`.
+ *
  * @packageDocumentation
  */
 type ZoomLevel = 'application' | 'orbital' | 'trait' | 'transition';