@almadar/shell-web 1.0.0 → 1.2.0

package/dist/components/index.d.ts

@@ -1,33 +1,28 @@
 import * as React$1 from 'react';
 import React__default, { ReactNode, ErrorInfo } from 'react';
-import { U as UnitAnimationState, F as FacingDirection, S as SpriteSheetUrls, f as SpriteFrameDims, R as ResolvedFrame, g as CanvasLighting, h as CanvasPost, a as IsometricUnit, i as CameraState } from '../Canvas3DHost-BkZQB5l2.js';
-export { B as BoardTile, G as GameAction, j as GamePhase, k as GameState, l as GameUnit, b as IsometricFeature, I as IsometricTile, P as Position, m as UnitTrait, n as calculateAttackTargets, o as calculateValidMoves, p as createInitialGameState } from '../Canvas3DHost-BkZQB5l2.js';
-import { EntityRow, FieldValue, EntityRole, Asset, AnimationName, SpriteDirection, AnimationDef, A11yProps, EventKey, EventEmit, EventPayload, AssetUrl, ScenePos, Camera, SoundEntry, EntityWith, DiagramMarkRoles, TraitConfigValue, SkeletonVariant, SkeletonSpec, SkeletonNode, SurfaceMode, UISlot, PatternNode, EventListen, JsonValue, AssetCatalog, SExpr, JsonObject, EventPayloadValue, DeclaredTraitConfig, TraitConfig, ControlValue, OrbitalSchema, Trait, TraceActivity, OrbitalEntity, FormSubmitPayload, TraitDescription, MountedOrbital, EnterAnimation, TraitValue, TransitionTrace, DependencyGraph, EditFocus, TraceSubagent, TraceChatMessage } from '@almadar/core';
+import { AnimationName, Asset, EntityRow, FieldValue, EntityRole, SpriteDirection, AnimationDef, A11yProps, EventKey, EventEmit, EventPayload, AssetUrl, ScenePos, Camera, AudioPlay, EntityWith, DiagramMarkRoles, GpuBuffer, TraitConfigValue, SkeletonVariant, SkeletonSpec, SkeletonNode, SurfaceMode, UISlot, PatternNode, EventListen, JsonValue, AssetCatalog, SExpr, JsonObject, EventPayloadValue, DeclaredTraitConfig, TraitConfig, ControlValue, OrbitalSchema, Trait, TraceActivity, OrbitalEntity, FormSubmitPayload, TraitDescription, MountedOrbital, EnterAnimation, TraitValue, TransitionTrace, DependencyGraph, EditFocus, TraceSubagent, TraceChatMessage } from '@almadar/core';
 export { AnimationDef, AnimationName, AudioManifest, BusEvent, BusEventListener, BusEventSource, BusEventListener as EventListener, SkeletonVariant, SoundEntry, SpriteDirection, UISlot, Unsubscribe } from '@almadar/core';
 import { IconInput, UiError, FxOverlayItem, BadgeColor, DisplayField, DisplayFieldFormat, BadgeVariant, ColorToken } from '../core.js';
 import '../EventBusProvider-BFFHfN4O.js';
-import { D as DrawableNode, P as Projector, M as MeshShapeKind, a as MeshMaterial, b as DrawGroupProps, c as DrawTextProps, d as DrawMeshProps } from '../paintDispatch-CuJLsr9Y.js';
-export { e as DrawFxLayer, f as DrawGroup, g as DrawMesh, h as DrawShape, i as DrawShapeLayer, j as DrawSkinnedMesh, k as DrawSprite, l as DrawSpriteLayer, m as DrawText, n as DrawTextLayer } from '../paintDispatch-CuJLsr9Y.js';
-export { G as GameAudioContext, a as GameAudioContextValue, e as GameAudioControls, b as GameAudioProvider, c as GameAudioProviderProps, U as UseGameAudioOptions, f as useGameAudio, u as useGameAudioContext } from '../GameAudioProvider-ceM_n0ey.js';
-import { AvlStateMachineProps } from '../avl/index.js';
-export { B as BehaviorView, f as BehaviorViewProps, g as FileTree, F as FileTreeItem, h as FileTreeNode, i as FileTreeProps, M as ModuleCard, j as ModuleCardProps } from '../FileTree-BCFnBEuQ.js';
+import { D as DrawableNode, P as Projector, M as MeshShapeKind } from '../verificationRegistry-BLuQU1JV.js';
+export { A as DrawFxLayer, B as DrawGroup, C as DrawMesh, E as DrawShape, F as DrawShapeLayer, G as DrawSkinnedMesh, H as DrawSprite, I as DrawSpriteLayer, J as DrawText, K as DrawTextLayer } from '../verificationRegistry-BLuQU1JV.js';
+export { G as GameAudioContext, a as GameAudioContextValue, e as GameAudioControls, b as GameAudioProvider, c as GameAudioProviderProps, U as UseGameAudioOptions, f as useGameAudio, u as useGameAudioContext } from '../GameAudioProvider-BgWOOYT3.js';
+import { AvlStateMachineProps, TraitLevelData } from '../avl/index.js';
+export { B as BehaviorView, l as BehaviorViewProps, m as FileTree, F as FileTreeItem, n as FileTreeNode, o as FileTreeProps, M as ModuleCard, q as ModuleCardProps } from '../FileTree-B3GDAjaQ.js';
 import { LucideIcon } from 'lucide-react';
 import { InputProps, ButtonProps, PatternVariant, SelectOption } from '../core.js';
-import { k as ContentAnnotation, L as LessonSegment } from '../parseLessonSegments-GpCeMrb2.js';
+import { j as ContentAnnotation, L as LessonSegment } from '../SegmentRenderer-BAQ6Jwf6.js';
 import { EditorMotion, EditorOperator, ContentSegment } from '../lib/index.js';
-export { B as BloomLevel, l as BloomQuizBlock, n as BloomQuizBlockProps, o as CodeRunnerPanel, q as CodeRunnerPanelProps, r as CodeSimulationOutput, s as LessonUserProgress, S as SegmentRenderer, t as SegmentRendererProps, h as parseLessonSegments } from '../parseLessonSegments-GpCeMrb2.js';
+export { B as BloomLevel, k as BloomQuizBlock, l as BloomQuizBlockProps, n as CodeRunnerPanel, o as CodeRunnerPanelProps, q as CodeSimulationOutput, r as LessonUserProgress, S as SegmentRenderer, s as SegmentRendererProps } from '../SegmentRenderer-BAQ6Jwf6.js';
 import { LanguageCode } from '@almadar/core/i18n';
 import { EmojiPickPayload, ItemActionPayload, SelectionChangePayload } from '@almadar/core/patterns';
-import { TraitLevelData } from '../avl/index.js';
-import { a as SlotContent, c as SlotPropValue } from '../useUISlots-CiobNFGb.js';
-export { D as DEFAULT_SLOTS, S as SlotChangeCallback, b as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-CiobNFGb.js';
-import '../verificationRegistry-CVrcxG1s.js';
+import { a as SlotContent, c as SlotPropValue } from '../useUISlots-BLcGd__D.js';
+export { D as DEFAULT_SLOTS, S as SlotChangeCallback, b as SlotRenderConfig, U as UISlotManager, u as useUISlotManager } from '../useUISlots-BLcGd__D.js';
 export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, EditorKeyEvent, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, KeyCaptureEntry, KeyCaptureTable, LongPressHandlers, LongPressOptions, OpenFile, PageHeadInput, Positioned, PullToRefreshOptions, PullToRefreshResult, QuerySingletonEntity, QuerySingletonResult, QuerySingletonState, QueryState, RenderInterpolationHandle, RenderInterpolationOptions, SelectedFile, SharedEntityStore, SharedEntityStoreContext, SharedEntitySubscriber, SharedEntityWriter, SwipeGestureOptions, SwipeGestureResult, SwipeHandlers, TraitListenSpec, UseCanvasGesturesOptions, UseCompileResult, UseDraggableOptions, UseDraggableResult, UseDropZoneOptions, UseDropZoneResult, UseExtensionsOptions, UseExtensionsResult, UseFileEditorOptions, UseFileEditorResult, UseFileSystemResult, UseKeyboardRouterOptions, claimDelivery, createSharedEntityStore, keyChord, mergeCaptureTables, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useKeyboardRouter, useLongPress, usePageHead, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTickVisibility, useTraitListens, useUIEvents, useValidation } from '../hooks/index.js';
 export { S as SlotHostManifest, a as SlotHostRegion, b as assertUniqueSlotsPerHost } from '../slot-host-CPzrxLo9.js';
-import 'three';
-import '@xyflow/react';
 import '@almadar/shell-runtime/client/EventTransport';
 import '../verification-C5pTeMJv.js';
+import '@xyflow/react';
 import '@tanstack/react-query';
 
 /**
@@ -85,6 +80,292 @@ declare namespace TraitFrame {
     var displayName: string;
 }
 
+/**
+ * Sprite Sheet Animation Types
+ *
+ * Type definitions for frame-based sprite sheet animation system.
+ * Supports standard 8-column × 5-row character sheets.
+ *
+ * `AnimationName`, `AnimationDef`, and `SpriteDirection` are canonically owned
+ * by `@almadar/core` (they travel with a `spriteSheet`-role `Asset.url`'s
+ * resolved atlas contract) — re-exported here so existing call sites in this
+ * package don't need to change their import path.
+ *
+ * @packageDocumentation
+ */
+
+/** Unit facing direction on screen (4 isometric directions) */
+type FacingDirection = 'se' | 'sw' | 'ne' | 'nw';
+/** A resolved frame ready to draw on canvas */
+interface ResolvedFrame {
+    /** URL of the sprite sheet image */
+    sheetUrl: string;
+    /** Source X in the sheet (pixel offset) */
+    sx: number;
+    /** Source Y in the sheet (pixel offset) */
+    sy: number;
+    /** Source width (frame width) */
+    sw: number;
+    /** Source height (frame height) */
+    sh: number;
+    /** Whether to flip horizontally when drawing (for NE/NW directions) */
+    flipX: boolean;
+    /** When true, canvas should apply sine-bob breathing offset (frozen idle frame) */
+    applyBreathing?: boolean;
+}
+/** Per-unit animation state tracked in the animation system */
+interface UnitAnimationState {
+    /** Unit identifier */
+    unitId: string;
+    /** Current animation playing */
+    animation: AnimationName;
+    /** Current facing direction */
+    direction: FacingDirection;
+    /** Current frame index within the animation */
+    frame: number;
+    /** Elapsed time in current animation (ms) */
+    elapsed: number;
+    /** Animation to play after current one-shot completes (null = idle) */
+    queuedAnimation: AnimationName | null;
+    /** Whether the current one-shot animation has finished its last frame */
+    finished: boolean;
+}
+/** Frame dimensions for a sprite sheet */
+interface SpriteFrameDims {
+    /** Width of a single frame in pixels */
+    width: number;
+    /** Height of a single frame in pixels */
+    height: number;
+}
+/**
+ * Sheet URLs per facing. Legacy hand-drawn packs ship only se/sw (ne/nw are
+ * mirror-flipped — a cheat that shows the face while walking away); 3D-baked
+ * sheets also ship real ne/nw, which `resolveFrame` prefers when present.
+ */
+interface SpriteSheetUrls {
+    /** Southeast-facing sheet URL */
+    se: string;
+    /** Southwest-facing sheet URL */
+    sw: string;
+    /** Northeast-facing sheet URL (real back view; omitted → mirror of sw) */
+    ne?: string;
+    /** Northwest-facing sheet URL (real back view; omitted → mirror of se) */
+    nw?: string;
+}
+
+/**
+ * Game Types — Generalized
+ *
+ * Core type definitions for tactical game state.
+ * Extracted from Trait Wars and generalized for any game project.
+ */
+interface Position {
+    x: number;
+    y: number;
+}
+interface GameUnit {
+    id: string;
+    name: string;
+    characterType: string;
+    team: 'player' | 'enemy' | 'neutral';
+    position: Position;
+    health: number;
+    maxHealth: number;
+    movement: number;
+    attack: number;
+    defense: number;
+    traits: UnitTrait[];
+}
+interface UnitTrait {
+    name: string;
+    currentState: string;
+    states: string[];
+    cooldown: number;
+}
+interface BoardTile {
+    terrain: string;
+    unitId?: string;
+    isBlocked?: boolean;
+}
+type GamePhase = 'observation' | 'planning' | 'execution' | 'tick';
+interface GameState {
+    board: BoardTile[][];
+    units: Record<string, GameUnit>;
+    currentPhase: GamePhase;
+    currentTurn: number;
+    activeTeam: 'player' | 'enemy' | 'neutral';
+    selectedUnitId?: string;
+    validMoves: Position[];
+    attackTargets: Position[];
+}
+type GameAction = {
+    type: 'SELECT_UNIT';
+    unitId: string;
+} | {
+    type: 'MOVE_UNIT';
+    from: Position;
+    to: Position;
+} | {
+    type: 'ATTACK';
+    attackerId: string;
+    targetId: string;
+} | {
+    type: 'END_TURN';
+} | {
+    type: 'EXECUTE_TRAITS';
+};
+/**
+ * Create the initial game state with board and units.
+ *
+ * @param {number} width - Board width in tiles
+ * @param {number} height - Board height in tiles
+ * @param {GameUnit[]} units - Initial units to place on the board
+ * @param {string} [defaultTerrain] - Default terrain type for empty tiles
+ * @returns {GameState} The initialized game state
+ */
+declare function createInitialGameState(width: number, height: number, units: GameUnit[], defaultTerrain?: string): GameState;
+/**
+ * Calculate valid movement positions for a unit.
+ *
+ * Returns all tiles within the unit's movement range that are
+ * not blocked and don't contain other units.
+ *
+ * @param {GameState} state - Current game state
+ * @param {string} unitId - ID of the unit to calculate moves for
+ * @returns {Position[]} Array of valid move positions
+ */
+declare function calculateValidMoves(state: GameState, unitId: string): Position[];
+/**
+ * Calculate valid attack targets for a unit.
+ *
+ * Returns adjacent positions containing enemy units that can be attacked.
+ *
+ * @param {GameState} state - Current game state
+ * @param {string} unitId - ID of the unit to calculate targets for
+ * @returns {Position[]} Array of valid attack target positions
+ */
+declare function calculateAttackTargets(state: GameState, unitId: string): Position[];
+
+/** A single isometric tile on the grid */
+interface IsometricTile {
+    /** Optional unique identifier (required for 3D rendering) */
+    id?: string;
+    /** Grid x coordinate */
+    x: number;
+    /** Grid y coordinate (2D) */
+    y: number;
+    /** Grid z coordinate (3D alternative to y) */
+    z?: number;
+    /** Terrain type key (e.g., 'grass', 'stone', 'water') - 2D */
+    terrain?: string;
+    /** Tile type for visual rendering (3D) */
+    type?: string;
+    /** Direct sprite URL override (bypasses getTerrainSprite resolver) */
+    terrainSprite?: Asset;
+    /** Fallback/override fill color (2D + 3D) — bypasses the terrain color map. `.lolo`-computed. */
+    color?: string;
+    /** Whether units can traverse this tile (default true) */
+    passable?: boolean;
+    /** Movement cost for pathfinding (default 1) */
+    movementCost?: number;
+    /** Optional tile type for visual variants */
+    tileType?: string;
+    /** Elevation offset for 3D rendering */
+    elevation?: number;
+    /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
+    modelUrl?: Asset;
+    /** Y-axis rotation in degrees (3D) — orients directional pieces (track corners, road bends) */
+    rotation?: number;
+}
+/** A unit positioned on the isometric grid */
+type IsometricUnit = {
+    /** Unique unit identifier */
+    id: string;
+    /** Current grid position (2D format) */
+    position?: {
+        x: number;
+        y: number;
+    };
+    /** Grid x coordinate (3D format) */
+    x?: number;
+    /** Grid y coordinate (3D format) */
+    y?: number;
+    /** Grid z coordinate (3D format) */
+    z?: number;
+    /** Static sprite URL (used when no sprite sheet animation) */
+    sprite?: Asset;
+    /** Sprite-sheet atlas JSON URL (e.g. `.../guardian-sprite-sheet.json`).
+     *  When set, the canvas loads the atlas and crops/animates a single frame
+     *  by animation state instead of drawing the whole sheet. */
+    spriteSheet?: Asset;
+    /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
+    modelUrl?: Asset;
+    /** Unit archetype key for sprite resolution */
+    unitType?: string;
+    /** Hero identifier for sprite sheet lookup */
+    heroId?: string;
+    /** Display name rendered below the unit */
+    name?: string;
+    /** Team affiliation for coloring */
+    team?: 'player' | 'enemy' | 'neutral';
+    /** Faction for 3D rendering (player/enemy/neutral) */
+    faction?: 'player' | 'enemy' | 'neutral';
+    /** Fallback/override tint color (2D + 3D) — bypasses the team/faction color map. `.lolo`-computed. */
+    tint?: string;
+    /** Current health */
+    health?: number;
+    /** Maximum health */
+    maxHealth?: number;
+    /** Trait attachments for state display */
+    traits?: UnitTrait[];
+    /** Previous position for movement trail ghost */
+    previousPosition?: {
+        x: number;
+        y: number;
+    };
+    /** Elevation offset for 3D rendering */
+    elevation?: number;
+    /** Animation name — driven by the LOLO state machine; renderer defaults to 'idle' */
+    animation?: AnimationName;
+    /** Frame index within the animation — driven by the LOLO state machine; renderer defaults to 0 */
+    frame?: number;
+    /** Y-axis heading in radians (3D) — travel/facing direction. Orients the unit model and
+     *  drives the `chase` camera (behind + above, looking along heading). Driving boards set this. */
+    heading?: number;
+};
+/** A map feature (resource, building, portal, etc.) */
+type IsometricFeature = {
+    /** Optional unique identifier (required for 3D rendering) */
+    id?: string;
+    /** Grid x coordinate */
+    x: number;
+    /** Grid y coordinate (2D) */
+    y: number;
+    /** Grid z coordinate (3D alternative to y) */
+    z?: number;
+    /** Feature type key (e.g., 'goldMine', 'castle', 'portal') */
+    type: string;
+    /** Direct sprite URL override (bypasses getFeatureSprite resolver) */
+    sprite?: Asset;
+    /** 3D model URL (GLB format) for GameCanvas3D */
+    assetUrl?: Asset;
+    /** Color override for 3D rendering */
+    color?: string;
+    /** Elevation offset for 3D rendering */
+    elevation?: number;
+    /** Y-axis rotation in radians (3D) — orients directional features (arches, signs, docks). */
+    rotation?: number;
+};
+/** Camera state for pan/zoom */
+interface CameraState {
+    /** Camera X offset in pixels */
+    x: number;
+    /** Camera Y offset in pixels */
+    y: number;
+    /** Zoom level (1.0 = 100%) */
+    zoom: number;
+}
+
 /**
  * boardEntity — tiny coercion helpers for reading `EntityRow` data inside game
  * boards.
@@ -869,6 +1150,60 @@ declare namespace Canvas2D {
     var displayName: string;
 }
 
+/**
+ * The 3D scene props a pattern declares as data (light rig, post-processing stack), shared by the `canvas` and
+ * learning patterns and drawn by orbital-canvas.
+ *
+ * @packageDocumentation
+ */
+/** Single light's tunable knobs (ambient/directional share this shape). */
+type CanvasLightConfig = {
+    intensity?: number;
+    color?: string;
+    position?: [number, number, number];
+};
+/** Hemisphere (sky/ground) light config. */
+type CanvasHemisphereConfig = {
+    intensity?: number;
+    color?: string;
+    groundColor?: string;
+};
+/** Point light config — `position` is required since a point light has no meaningful default placement. */
+type CanvasPointLightConfig = {
+    intensity?: number;
+    color?: string;
+    position: [number, number, number];
+    distance?: number;
+    decay?: number;
+};
+/** Canvas-level 3D light rig, authored as data. Every field is optional; an omitted field takes the standard rig's value. */
+type CanvasLighting = {
+    /** Default intensity 0.6, color '#ffffff'. */
+    ambient?: CanvasLightConfig;
+    /** Default intensity 0.8, color '#ffffff', position [10, 20, 10]. */
+    directional?: CanvasLightConfig;
+    /** Default intensity 0.3, color '#87ceeb', groundColor '#362d1d'. */
+    hemisphere?: CanvasHemisphereConfig;
+    /** Additional point lights. Default none. */
+    points?: CanvasPointLightConfig[];
+    /** Procedural environment for PBR reflection (metals/glass). Default 'none'. */
+    environment?: 'room' | 'none';
+    /** Output tone mapping. Default 'aces' (filmic); 'none' renders material colors faithfully. */
+    toneMapping?: 'aces' | 'none';
+};
+/** Canvas-level post-processing stack. Every field is optional; an omitted field means that pass is not run. */
+type CanvasPost = {
+    bloom?: {
+        intensity?: number;
+        threshold?: number;
+        smoothing?: number;
+    };
+    vignette?: {
+        offset?: number;
+        darkness?: number;
+    };
+};
+
 /**
  * Canvas — the unified game canvas draw-host (P6 closing).
  *
@@ -889,8 +1224,8 @@ declare namespace Canvas2D {
  * shapes so the single value stays assignable to either host's prop (the two hosts
  * still emit their own coordinate shape at runtime).
  *
- * The 3D host (three.js/R3F) is lazy-imported so a 2D-only app never pulls the
- * 3D bundle — the code-split boundary the drawable atoms were built R3F-free for.
+ * The 3D painter is orbital-canvas (wasm), handed the pattern's own props as its
+ * scene config.
  *
  * @packageDocumentation
  */
@@ -902,6 +1237,8 @@ interface CanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11
     mode?: CanvasMode;
     /** Neutral drawable descriptors — the `draw-*` children. Routed to the host's painter. */
     drawables?: DrawableNode[];
+    /** Text alternative for the scene, rendered as visually hidden text and linked by aria-describedby. */
+    description?: string;
     /** Neutral camera pose. Mapped to the underlying host's framing + zoom. */
     camera?: Camera;
     /** 2D grid layout (2D mode only): isometric / hex / flat / free / side. */
@@ -996,7 +1333,7 @@ interface CanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11
      *  Forwarded to the 2D host, which collects them via drawable registry context. */
     children?: React$1.ReactNode;
 }
-declare function Canvas({ mode, drawables, camera, projection, className, isLoading, unitScale, showMinimap, fit, tileWidth, backgroundImage, backgroundColor, worldWidth, worldHeight, pixelsPerUnit, showGrid, shadows, showCoordinates, showTileInfo, fogOfWar, lighting, post, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, featureClickEvent, keyMap, keyUpMap, editable, selectedId, onSelect, onMove, selectEvent, moveEvent, children, ...rest }: CanvasProps): React$1.JSX.Element;
+declare function Canvas({ mode, drawables, camera, projection, className, isLoading, unitScale, showMinimap, fit, tileWidth, backgroundImage, backgroundColor, worldWidth, worldHeight, pixelsPerUnit, showGrid, shadows, showCoordinates, showTileInfo, fogOfWar, lighting, post, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, featureClickEvent, keyMap, keyUpMap, editable, selectedId, onSelect, onMove, selectEvent, moveEvent, children, description, ...rest }: CanvasProps): React$1.JSX.Element;
 declare namespace Canvas {
     var displayName: string;
 }
@@ -1059,22 +1396,20 @@ declare namespace GameAudioToggle {
 }
 
 interface GameAudioCueProps {
-    /** Manifest key played as a one-shot SFX each time `cueSeq` advances. */
-    cue?: string;
-    /** Monotonically increasing counter — bumping it re-triggers `cue`. */
+    /** Monotonically increasing counter — bumping it plays `cuePlay` once. */
     cueSeq?: number;
-    /** Manifest key to crossfade to as looping background music; unset/empty stops music. */
-    music?: string;
+    /** The resolved one-shot to play on the next `cueSeq` bump. */
+    cuePlay?: AudioPlay;
+    /** The resolved looping track; an empty key fades the current one out. */
+    musicPlay?: AudioPlay;
+    /** Resolved sounds started on the first user gesture while unmuted. */
+    autostart?: AudioPlay[];
     /** Muted state, owned externally and mirrored into the hook. */
     muted?: boolean;
     /** Master volume 0-1, owned externally and mirrored into the hook. */
     volume?: number;
-    /** Sound manifest — keys mapped to sound definitions (path, volume, loop, ...). */
-    manifest: Record<string, SoundEntry>;
-    /** Base URL prepended to every manifest path. */
-    baseUrl?: string;
 }
-declare function GameAudioCue({ cue, cueSeq, music, muted, volume, manifest, baseUrl, }: GameAudioCueProps): null;
+declare function GameAudioCue({ cueSeq, cuePlay, musicPlay, autostart, muted, volume, }: GameAudioCueProps): null;
 declare namespace GameAudioCue {
     var displayName: string;
 }
@@ -1696,10 +2031,9 @@ declare const GameShell: React__default.FC<GameShellProps>;
 /**
  * LearningCanvas
  *
- * A pure, declarative HTML5 canvas atom for math and science visualizations.
- * Accepts a list of primitive shapes (line, arrow, circle, rect, polygon, path,
- * text, axis, grid) and renders them. Optional interactivity emits click/hover
- * events, and optional animation drives a continuous render loop.
+ * A declarative canvas atom for math and science visualizations: a list of primitive shapes (line, arrow, circle,
+ * rect, polygon, path, text, axis, grid) plus readout chips and trace insets, mapped and drawn by orbital-canvas.
+ * Optional interactivity emits click events.
  *
  * This is the foundational atom for the `learning/` behavior family.
  *
@@ -1759,6 +2093,22 @@ interface LearningShape extends DiagramMarkRoles {
     /** venn-region only: ids of sibling `circle` shapes SUBTRACTED from the `inside` intersection (true lens/exclusion shading). */
     outside?: string[];
 }
+/**
+ * Particles packed as data (a GPU readback, for one): one little-endian 32-bit word every `stride` bytes, x in bits
+ * 0-11, y in bits 12-23 and a `palette` index in bits 24-31. Drawn in one pass, without a shape per particle.
+ */
+interface LearningParticles {
+    /** The packed words as base64 bytes (a CPU copy); exactly one of `data` or `buffer`. */
+    data?: string;
+    /** The packed words where they lie on the GPU (a program's compute output, drawn without a readback). */
+    buffer?: GpuBuffer;
+    /** Bytes from one particle's word to the next. */
+    stride: number;
+    /** Drawn half-size of each particle, in scene pixels. */
+    radius: number;
+    /** Particle colors by index: tone names, `var()` tokens or literals; an index past the end takes the last. */
+    palette: string[];
+}
 /** A single top-right status chip (e.g. a live measurement or score). */
 interface LearningReadout {
     /** Chip label, shown before the value. */
@@ -1822,6 +2172,8 @@ interface LearningCanvasProps extends A11yProps {
     fontFamily?: string;
     /** Declarative shapes to draw. */
     shapes?: LearningShape[];
+    /** Packed particles drawn under the shapes in one pass ({@link LearningParticles}). */
+    particles?: LearningParticles;
     /**
      * Neutral game-canvas drawables (e.g. `draw-sprite`, `draw-fx-layer`) painted
      * in world coordinates via the supplied `projector`. This lets the learning
@@ -2826,6 +3178,8 @@ interface MenuItem {
     id?: string;
     /** Item label */
     label: string;
+    /** A second, quieter line under the label. */
+    description?: string;
     /** Item icon (Lucide icon name or component) */
     icon?: IconInput;
     /** Item badge */
@@ -3915,6 +4269,46 @@ interface CodeViewerFile {
     code: string;
     language?: CodeLanguage;
 }
+/** Buffer mode: a position in the text, zero-based line and character column (the units of `str/len`). */
+interface CodeCursor {
+    row: number;
+    col: number;
+}
+/** Buffer mode: the selected range, end inclusive of the cursor's character; `linewise` selects whole lines. */
+interface CodeSelection {
+    fromRow: number;
+    fromCol: number;
+    toRow: number;
+    toCol: number;
+    linewise: boolean;
+}
+/**
+ * Buffer mode: a painted range, `to` exclusive. `tone` names a theme color role: syntax
+ * (keyword, string, comment, number, type, function, operator, punctuation, variable) or
+ * annotation (search, review, review-recent, error, warning, info). `label` is its accessible name.
+ */
+interface CodeDecoration {
+    id: string;
+    fromRow: number;
+    fromCol: number;
+    toRow: number;
+    toCol: number;
+    tone: string;
+    label?: string;
+}
+/** Buffer mode: a note anchored below a range; `busy` shows that more is on its way. */
+interface CodePopover {
+    fromRow: number;
+    fromCol: number;
+    toRow: number;
+    toCol: number;
+    title: string;
+    sections: {
+        heading: string;
+        lines: string[];
+    }[];
+    busy: boolean;
+}
 interface CodeBlockProps extends A11yProps {
     /** The code content to display */
     code?: string;
@@ -4079,6 +4473,59 @@ interface CodeBlockProps extends A11yProps {
      * @tier presentation
      */
     operators?: readonly EditorOperator[];
+    /**
+     * Buffer mode: when set, the program owns the text and the cursor (std-text-buffer) and this
+     * surface only paints them — `code` split on newlines, the caret here, `selection`,
+     * `decorations` and `popover` — and emits input as events: every keydown through `onKey`, a
+     * press through `onPointerDown`, the character the pointer rests over through `onHover`. It
+     * never edits, moves the caret or interprets a key itself, and keeps the cursor line in view.
+     * @tier presentation
+     */
+    cursor?: CodeCursor;
+    /**
+     * Buffer mode: the caret shape the program's mode asks for.
+     * @tier presentation
+     */
+    caret?: EditorCaret;
+    /**
+     * Buffer mode: the selected range to paint (VISUAL), or none.
+     * @tier presentation
+     */
+    selection?: CodeSelection | null;
+    /**
+     * Buffer mode: ranges painted by tone (syntax colors, search hits, review highlights).
+     * @tier presentation
+     */
+    decorations?: CodeDecoration[];
+    /**
+     * Buffer mode: a note anchored below a range, or none.
+     * @tier presentation
+     */
+    popover?: CodePopover | null;
+    /**
+     * Number each line by its distance from the cursor line; the cursor line shows its own number.
+     * @tier presentation
+     */
+    relativeLineNumbers?: boolean;
+    /**
+     * Buffer mode: emits UI:{onPointerDown} with the zero-based row and column a pointer pressed.
+     * @tier presentation
+     */
+    onPointerDown?: EventEmit<{
+        editorId: string;
+        row: number;
+        col: number;
+    }>;
+    /**
+     * Buffer mode: emits UI:{onHover} with the zero-based row and column the pointer moved onto
+     * (once per character it enters).
+     * @tier presentation
+     */
+    onHover?: EventEmit<{
+        editorId: string;
+        row: number;
+        col: number;
+    }>;
     /**
      * Editable only: answers the caret's valid continuations after a keystroke (and on
      * Ctrl-Space); they show under the editor and Tab or a click inserts one.
@@ -4145,6 +4592,7 @@ interface CodeBlockProps extends A11yProps {
     /** Note action label (default: translated) */
     noteLabel?: string;
 }
+/** Buffer mode is on exactly when the program supplies a `cursor`; every other block is the classic one. */
 declare const CodeBlock: React__default.NamedExoticComponent<CodeBlockProps>;
 
 /**
@@ -4843,9 +5291,8 @@ declare const ProgressDots: React__default.FC<ProgressDotsProps>;
 /**
  * MathCanvas
  *
- * A field-scoped learning molecule for mathematics. Renders a coordinate plane
- * with axes, grid, curves (sampled points), scatter points, and vectors on top
- * of the declarative `LearningCanvas` atom.
+ * A field-scoped learning molecule for math: axes, grid, curves, points, vectors, regions, bars, guides, angles,
+ * hops and game drawables in plot coordinates, mapped and drawn by orbital-canvas.
  *
  * @packageDocumentation
  */
@@ -5008,9 +5455,9 @@ interface MathCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>,
      * the same x/y world→pixel transform used for curves/points.
      */
     drawables?: DrawableNode[];
-    /** Top-right status chips, forwarded verbatim to LearningCanvas. */
+    /** Top-right status chips (the LearningCanvas vocabulary). */
     readouts?: LearningReadout[];
-    /** Inset sparkline panels, forwarded verbatim to LearningCanvas. */
+    /** Inset sparkline panels (the LearningCanvas vocabulary). */
     traces?: LearningTracePanel[];
     interactive?: boolean;
     animate?: boolean;
@@ -5031,9 +5478,8 @@ declare const MathCanvas: React$1.FC<MathCanvasProps>;
 /**
  * PhysicsCanvas
  *
- * A field-scoped learning molecule for physics. Renders bodies, constraints,
- * velocity arrows, and force arrows on top of the declarative `LearningCanvas`
- * atom.
+ * A field-scoped learning molecule for physics: bodies, constraints, velocity and force arrows, fixtures, fields
+ * and meters in 2D, or a 3D scene, mapped and drawn by orbital-canvas.
  *
  * @packageDocumentation
  */
@@ -5146,17 +5592,17 @@ interface PhysicsTrail {
     fade?: boolean;
 }
 /** One elevation color band for a `surface3d` height field; sorted ascending by `min`. */
-interface PhysicsSurfaceBand {
+type PhysicsSurfaceBand = {
     /** Inclusive floor height in cells; omit for the catch-all lowest band. */
     min?: number;
     color: string;
-}
+};
 /**
  * A 3D height-field mesh (a wave, a terrain, a potential surface) rendered
  * from a row-major grid of heights. 3D only.
  * @synonyms heightfield, wave surface, terrain, potential surface
  */
-interface PhysicsSurface3D {
+type PhysicsSurface3D = {
     /** Grid columns. */
     nx: number;
     /** Grid rows. */
@@ -5176,7 +5622,7 @@ interface PhysicsSurface3D {
     opacity?: number;
     /** Faceted low-poly shading (default true). */
     flatShading?: boolean;
-}
+};
 /**
  * A single labeled 3D arrow (field arrow, axis-triad leg, force/velocity
  * vector), rendered via `vectors3d` + `vectorScale`. 3D only.
@@ -5224,7 +5670,7 @@ interface PhysicsAngleMarker {
  * A single uniform vector/into-page/out-of-page lattice drawn over a region.
  * @synonyms magnetic field, into page, out of page, field grid
  */
-interface PhysicsField {
+type PhysicsField = {
     kind: 'arrows' | 'into' | 'out';
     /** Lattice cell size in pixels (default 48). */
     spacing?: number;
@@ -5242,7 +5688,7 @@ interface PhysicsField {
     width?: number;
     /** Region height (default canvas height). */
     height?: number;
-}
+};
 /**
  * A bottom-left labeled bar gauge for a scalar quantity (energy, speed, charge, ...).
  * @synonyms energy bar, KE, PE, gauge
@@ -5267,7 +5713,7 @@ interface PhysicsCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProp
     keyMap?: Record<string, EventKey>;
     /** Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`. */
     keyUpMap?: Record<string, EventKey>;
-    /** Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host. */
+    /** Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas. */
     mode?: '2d' | '3d';
     /** 3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target }). */
     camera?: Camera;
@@ -5276,6 +5722,8 @@ interface PhysicsCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProp
     /** 3D only: post-processing stack (bloom/vignette). */
     post?: CanvasPost;
     bodies?: LearningPhysicsBody[];
+    /** 2D mode: packed particles drawn in one pass under the bodies (a GPU readback), instead of a body per particle. */
+    particles?: LearningParticles;
     constraints?: LearningPhysicsConstraint[];
     showVelocity?: boolean;
     showForces?: boolean;
@@ -5301,9 +5749,9 @@ interface PhysicsCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProp
     meters?: PhysicsMeter[];
     /** Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D). */
     shapes?: LearningShape[];
-    /** Top-right status chip row, forwarded to LearningCanvas verbatim. */
+    /** Top-right status chip row (the LearningCanvas vocabulary). */
     readouts?: LearningReadout[];
-    /** Inset sparkline panels, forwarded to LearningCanvas verbatim. */
+    /** Inset sparkline panels (the LearningCanvas vocabulary). */
     traces?: LearningTracePanel[];
     /** 3D only: show the ground grid (default off). */
     showGrid?: boolean;
@@ -5326,8 +5774,8 @@ declare const PhysicsCanvas: React$1.FC<PhysicsCanvasProps>;
 /**
  * BiologyCanvas
  *
- * A field-scoped learning molecule for biology. Renders cells, organelles,
- * membranes, and connections on top of the declarative `LearningCanvas` atom.
+ * A field-scoped learning molecule for biology: nodes, edges, compartments, bands, stages and a DNA helix in 2D,
+ * or a 3D scene, mapped and drawn by orbital-canvas.
  *
  * @packageDocumentation
  */
@@ -5396,7 +5844,7 @@ interface BiologyStage {
     color?: string;
 }
 /** One base pair (rung) of a `helix` ladder. */
-interface BiologyHelixRung {
+type BiologyHelixRung = {
     /** Base letter on strand A (top). */
     a?: string;
     /** Base letter on strand B (bottom). */
@@ -5405,9 +5853,9 @@ interface BiologyHelixRung {
     state?: 'paired' | 'open' | 'new';
     /** Overrides the state-derived rung color. */
     color?: string;
-}
+};
 /** A DNA double-helix ladder rendered as two strand polylines plus rungs, with an optional unzipped fork. */
-interface BiologyHelix {
+type BiologyHelix = {
     /** Panel left edge (default 24). */
     x?: number;
     /** Panel top edge (default canvas height * 0.25). */
@@ -5425,9 +5873,9 @@ interface BiologyHelix {
     colorB?: string;
     /** Default paired-rung color: a tone name, token or literal (default `muted`). */
     rungColor?: string;
-}
+};
 /** One base-pair rung of a 3D `helix3d` ladder. */
-interface BiologyHelixRung3D {
+type BiologyHelixRung3D = {
     /** Clickable when present — stamped on this rung's marker sphere. */
     id?: string;
     /** Rung cylinder + marker color: a tone name, token or literal (default `muted`). */
@@ -5436,13 +5884,13 @@ interface BiologyHelixRung3D {
     radius?: number;
     /** Billboard label above the marker. */
     label?: string;
-}
+};
 /**
  * A 3D DNA double-helix: two beaded backbone strands plus a base-pair rung
  * per index, optionally unwound (replication-fork style) at one end. 3D only.
  * @synonyms DNA double helix, base pairs 3D
  */
-interface BiologyHelix3D {
+type BiologyHelix3D = {
     /** Rung count; defaults to `rungs.length`. One of `count`/`rungs` is required. */
     count?: number;
     /** Per-rung overrides, padded with defaults up to `count`. */
@@ -5469,7 +5917,7 @@ interface BiologyHelix3D {
     unwoundCount?: number;
     /** Spread multiplier for unwound rungs (default 1.8). */
     unwindSpread?: number;
-}
+};
 interface BiologyCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
     className?: string;
     width?: number;
@@ -5482,7 +5930,7 @@ interface BiologyCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProp
     keyMap?: Record<string, EventKey>;
     /** Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`. */
     keyUpMap?: Record<string, EventKey>;
-    /** Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host. */
+    /** Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas. */
     mode?: '2d' | '3d';
     /** 3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target }). */
     camera?: Camera;
@@ -5518,9 +5966,9 @@ interface BiologyCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProp
     helix3d?: BiologyHelix3D;
     /** Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D). */
     shapes?: LearningShape[];
-    /** Top-right status chip row, forwarded to LearningCanvas verbatim. */
+    /** Top-right status chip row (the LearningCanvas vocabulary). */
     readouts?: LearningReadout[];
-    /** Inset sparkline panels, forwarded to LearningCanvas verbatim. */
+    /** Inset sparkline panels (the LearningCanvas vocabulary). */
     traces?: LearningTracePanel[];
     /** 3D only: show the ground grid (default off). */
     showGrid?: boolean;
@@ -5543,8 +5991,8 @@ declare const BiologyCanvas: React$1.FC<BiologyCanvasProps>;
 /**
  * ChemistryCanvas
  *
- * A field-scoped learning molecule for chemistry. Renders atoms, bonds, and
- * reaction arrows on top of the declarative `LearningCanvas` atom.
+ * A field-scoped learning molecule for chemistry: atoms, bonds, arrows, containers and an equation in 2D, or a 3D
+ * scene, mapped and drawn by orbital-canvas.
  *
  * @packageDocumentation
  */
@@ -5612,7 +6060,7 @@ interface ChemistryArrow {
     label?: string;
 }
 /** One basis site of a `lattice3d` crystal, replicated across the generated block. */
-interface ChemistryLatticeSite {
+type ChemistryLatticeSite = {
     /** Basis-site key; bonds reference sites by key, not by generated id. */
     key: string;
     /** Fractional cell offset, 0..1. */
@@ -5630,9 +6078,9 @@ interface ChemistryLatticeSite {
     yEdge?: boolean;
     /** Replicate on the +z face so the boundary plane completes (n+1 planes along z). */
     zEdge?: boolean;
-}
+};
 /** A bond rule generating one cylinder per valid `from`→`to` site-instance pair. */
-interface ChemistryLatticeBond {
+type ChemistryLatticeBond = {
     /** Basis-site key this bond originates from. */
     from: string;
     /** Basis-site key this bond targets. */
@@ -5643,14 +6091,14 @@ interface ChemistryLatticeBond {
     dz?: number;
     /** Bond color: a tone name, token or literal (default the `ink` tone). */
     color?: string;
-}
+};
 /**
  * A 3D crystal lattice (simple cubic, BCC, FCC, rock salt, diamond, ...)
  * generated procedurally from a fractional basis + bond rules into a block
  * centered on the origin. 3D only.
  * @synonyms crystal lattice, unit cell, BCC FCC
  */
-interface ChemistryLattice3D {
+type ChemistryLattice3D = {
     basis: ChemistryLatticeSite[];
     /** Unit cells replicated along x/y/z (default 2 each). */
     nx?: number;
@@ -5671,7 +6119,7 @@ interface ChemistryLattice3D {
     selectedId?: string;
     /** Selected-site color: a tone name, token or literal (default the `highlight` tone). */
     selectedColor?: string;
-}
+};
 interface ChemistryCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
     className?: string;
     width?: number;
@@ -5684,7 +6132,7 @@ interface ChemistryCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yPr
     keyMap?: Record<string, EventKey>;
     /** Maps a keyup `e.code` to a semantic event emitted as `UI:{event}`. */
     keyUpMap?: Record<string, EventKey>;
-    /** Painter: 2D raster (default) or 3D mesh scene via the lazy three.js host. */
+    /** Painter: 2D raster (default) or 3D mesh scene, both drawn by orbital-canvas. */
     mode?: '2d' | '3d';
     /** 3D only: neutral camera pose ({ mode, zoom, fov, azimuth, target }). */
     camera?: Camera;
@@ -5713,9 +6161,9 @@ interface ChemistryCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yPr
     lattice3d?: ChemistryLattice3D;
     /** Extra declarative shapes in canvas pixel coordinates (2D mode only — ignored in 3D). */
     shapes?: LearningShape[];
-    /** Top-right status chip row, forwarded to LearningCanvas verbatim. */
+    /** Top-right status chip row (the LearningCanvas vocabulary). */
     readouts?: LearningReadout[];
-    /** Inset sparkline panels, forwarded to LearningCanvas verbatim. */
+    /** Inset sparkline panels (the LearningCanvas vocabulary). */
     traces?: LearningTracePanel[];
     /** 3D only: show the ground grid (default off). */
     showGrid?: boolean;
@@ -5738,20 +6186,8 @@ declare const ChemistryCanvas: React$1.FC<ChemistryCanvasProps>;
 /**
  * AlgorithmCanvas
  *
- * A field-scoped learning molecule for computer-science algorithm visualizations.
- * Projects semantic `bars` (sorting/histograms), `slots` (registers/variables),
- * `cells` (grids/arrays/DP tables), `buckets` (hash-table chaining), and `frames`
- * (call stacks) into pixel-space shapes on the declarative `LearningCanvas` atom,
- * so a `.lolo` behavior never computes pixel coordinates — it just sets the family
- * arrays and lets this molecule lay them out. `pointers` (index cursors) and
- * `ranges` (highlighted spans) decorate the bars/slots panel. Graph/tree
- * algorithms use `AlgoGraphCanvas` (nodes + edges + layouts); this canvas owns
- * only the bar/slot/cell/bucket/frame vocabulary.
- *
- * When more than one of `bars`/`slots`/`cells`/`buckets`/`frames` is populated,
- * they share the canvas height as equal vertical panels in that fixed order
- * (`panelHeight = height / panelCount`); with exactly one family present the
- * panel math collapses to the original full-height layout unchanged.
+ * A field-scoped learning molecule for algorithms: bars, cells, pointers, ranges, slots, frames and buckets, mapped
+ * and drawn by orbital-canvas.
  *
  * @packageDocumentation
  */
@@ -5877,14 +6313,8 @@ declare const AlgorithmCanvas: React$1.FC<AlgorithmCanvasProps>;
 /**
  * AlgoGraphCanvas
  *
- * A field-scoped learning molecule for computer-science graph/tree algorithm
- * visualizations (BFS/DFS/Dijkstra/A-star/topological sort/tree traversals).
- * Declares a fixed node/edge state vocabulary with default colors and
- * deterministic layouts (`manual` | `tree` | `layered` | `circle`) so a
- * `.lolo` behavior never computes pixel coordinates — it just sets node
- * `state`/edges and picks a layout. Distinguish from the core d3-force
- * `GraphCanvas`: this one is a dumb deterministic projection, not a
- * force simulation.
+ * A field-scoped learning molecule for graph algorithms: nodes in a deterministic layout, edges and node badges,
+ * mapped and drawn by orbital-canvas.
  *
  * @packageDocumentation
  */
@@ -5958,96 +6388,6 @@ interface AlgoGraphCanvasProps extends Omit<React$1.AriaAttributes, keyof A11yPr
 }
 declare const AlgoGraphCanvas: React$1.FC<AlgoGraphCanvasProps>;
 
-/**
- * learningScene3D — the shared 3D seam for the learning canvas molecules
- * (PhysicsCanvas / BiologyCanvas / ChemistryCanvas), mirroring the game
- * `Canvas` molecule's 2D/3D split: each molecule derives neutral drawable
- * descriptors from its vocabulary and this module hosts them in the lazy
- * `Canvas3DHost`, so three.js/R3F never enters a 2D-only bundle.
- *
- * The lazy import is the code-split boundary: the package's one split ESM build
- * makes it its own chunk (the `./three` entry).
- *
- * Click: the host speaks `EventEmit` (a bus event-name string), so the wrapper
- * mints a per-instance, dot-qualified event name (dot-qualified flows through
- * trait-scope qualification verbatim — a bare key would be scope-rewritten and
- * never reach this listener) and bridges it back to the molecule's
- * `onShapeClick` callback contract via `useEventListener` — the same
- * bus→callback mechanism `MediaGallery`/`StateMachineView` use.
- *
- * The derivation helpers below are pure descriptor builders (no three imports).
- * Scene coordinates are cells: `x`/`y` the ground plane, `z` the height.
- *
- * @packageDocumentation
- */
-
-/** A point in scene space: `[x, y, z]` — x/y the ground plane, z the height (cells). */
-type Learning3DPoint = [number, number, number];
-interface LearningScene3DProps extends A11yProps {
-    /** Text alternative for the scene, rendered as visually hidden text and linked by aria-describedby. */
-    description?: string;
-    className?: string;
-    width?: number;
-    height?: number;
-    title?: string;
-    backgroundColor?: string;
-    /** Overrides the theme's categorical palette (`series-1…N`) for this scene. */
-    series?: string[];
-    /** Neutral drawable descriptors derived from the molecule's vocabulary. */
-    drawables: DrawableNode[];
-    /** Neutral camera pose; `mode` defaults to 'perspective' for learning scenes. */
-    camera?: Camera;
-    /** 3D scene light rig as data. Omitted → the host's standard fixed rig. */
-    lighting?: CanvasLighting;
-    /** 3D post-processing stack (bloom/vignette). Omitted → no post pass. */
-    post?: CanvasPost;
-    /** Show the 3D ground grid. Default false (the learning scenes' current look). */
-    showGrid?: boolean;
-    /** Enable 3D shadows. Omitted → the host default (shadows on). */
-    shadows?: boolean;
-    /** Enable the orbit camera controls. Omitted → the host default (controls on). */
-    interactive?: boolean;
-    isLoading?: boolean;
-    error?: UiError | null;
-    /** Fires with the `id` of a clicked descriptor (descriptors carry `id` via DrawableBase). */
-    onItemClick?: (id: string) => void;
-}
-declare function LearningScene3D({ className, width, height, title, backgroundColor, series, drawables, camera, lighting, post, showGrid, shadows, interactive, isLoading, error, onItemClick, description, ...rest }: LearningScene3DProps): React$1.JSX.Element;
-declare namespace LearningScene3D {
-    var displayName: string;
-}
-interface MeshSphereOpts {
-    /** Primitive kind (default 'sphere'; organelles read well as 'capsule'). */
-    shape?: MeshShapeKind;
-    segments?: number;
-    material?: MeshMaterial;
-    opacity?: number;
-}
-/** A sphere (or `opts.shape` primitive) centred at the scene point, `id`-tagged for click. */
-declare function meshSphere(id: string | undefined, x: number, y: number, z: number, radius: number, color: string, opts?: MeshSphereOpts): DrawMeshProps;
-/** A cylinder spanning from→to, centred on the midpoint. Null when the segment is degenerate. */
-declare function cylinderBetween(from: Learning3DPoint, to: Learning3DPoint, radius: number, color: string): DrawMeshProps | null;
-/**
- * An arrow from→to as a `draw-group` (shaft cylinder + tip cone) local to `from`.
- * `shaftRadius` is in scene cells (default: a thin rod at cell scale). `id`,
- * when given, is stamped on the returned draw-group for click routing.
- */
-declare function arrowBetween(from: Learning3DPoint, to: Learning3DPoint, color: string, shaftRadius?: number, id?: string): DrawGroupProps | null;
-/** A billboarded text label above the scene point (the 3D host lifts it off the item). */
-declare function billboardLabel(text: string, x: number, y: number, z: number, opts?: {
-    color?: string;
-}): DrawTextProps;
-/**
- * Bridge the 3D host's `{ unitId }` click back to the molecules' 2D
- * `onShapeClick({ id, index })` contract — `index` is the item's position in
- * its vocabulary array (−1 when the id is unknown).
- */
-declare function get3DClickPayload(onShapeClick: ((payload: {
-    id?: string;
-    type?: string;
-    index: number;
-}) => void) | undefined, idToIndex: ReadonlyMap<string, number>): ((id: string) => void) | undefined;
-
 /**
  * GraphView Molecule Component
  *
@@ -6695,6 +7035,8 @@ interface TableViewColumn {
     colorMap?: Readonly<Record<string, BadgeColor>>;
     /** Display text per exact value (for `format: 'badge'`); unmapped values show as stored */
     labels?: Readonly<Record<string, string>>;
+    /** Lucide icon name per exact value (for `format: 'badge'`), shown inside the badge so status is never colour alone */
+    iconMap?: Readonly<Record<string, string>>;
     /** `h3`/`h4` marks the row's title column: on narrow tables it heads the stacked card, unlabelled */
     variant?: 'h3' | 'h4';
     /** Lucide icon name or component shown before the header label. */
@@ -9583,8 +9925,10 @@ interface AgentActivityRowProps {
     onJump?: (target: AgentActivityJumpTarget) => void;
     /** What the row knows from its list (`activityRowFacts`). */
     facts: RowFacts;
+    /** The declared label of the tool a tool step names, shown in place of its address. */
+    toolLabel?: string;
 }
-declare function AgentActivityRow({ activity, onJump, facts }: AgentActivityRowProps): React__default.ReactElement;
+declare function AgentActivityRow({ activity, onJump, facts, toolLabel }: AgentActivityRowProps): React__default.ReactElement;
 declare namespace AgentActivityRow {
     var displayName: string;
 }
@@ -9635,9 +9979,16 @@ interface AgentChatFeedProps {
     idPrefix: string;
     /** The agent is running — the feed shows it is thinking. */
     working?: boolean;
+    /** Declared labels of the tools a step can name: a step of a listed tool shows its label, not its address. */
+    toolLabels?: readonly AgentToolLabel[];
     className?: string;
 }
-declare function AgentChatFeed({ activities, emptyTitle, rawLlmPreferenceKey, idPrefix, working, className }: AgentChatFeedProps): React__default.ReactElement;
+/** The label a tool's steps are shown under. */
+interface AgentToolLabel {
+    tool: string;
+    label: string;
+}
+declare function AgentChatFeed({ activities, emptyTitle, rawLlmPreferenceKey, idPrefix, working, toolLabels, className }: AgentChatFeedProps): React__default.ReactElement;
 declare namespace AgentChatFeed {
     var displayName: string;
 }
@@ -10185,6 +10536,27 @@ interface FormProps extends Omit<React__default.FormHTMLAttributes<HTMLFormEleme
 }
 declare const Form: React__default.FC<FormProps>;
 
+/**
+ * AvlOrbitalMachine — a whole mounted orbital on one canvas: every rendering
+ * trait is a box nested inside its parent, boxes within `expandDepth` draw
+ * their own machine, the rest are compact boxes that open in place, traits
+ * that never paint sit in a background lane, and `Trait.EVENT` listens are
+ * dashed wires between boxes, drawn only for the chosen trait and the last
+ * dispatch's route. Choosing a box emits `selectEvent`; with `pickEvent` an
+ * inspect toggle picks a trait from its output on the page, then opens and
+ * scrolls to its box.
+ */
+
+interface OrbitalFocusTarget {
+    trait: string;
+    /** The event of the transition to show; empty shows the trait's box. */
+    event: string;
+    from: string;
+    to: string;
+    /** Changes with each request, so asking for the same transition again scrolls again. */
+    nonce: number;
+}
+
 /**
  * StateMachineView — the AVL state machine with loading / error / empty states.
  */
@@ -10231,6 +10603,10 @@ interface StateMachineViewProps extends Omit<AvlStateMachineProps, 'trait'> {
     pickEvent?: EventEmit<{
         trait: string;
     }>;
+    /** Orbital mode: a transition to scroll to; its trait's box opens and the canvas scrolls to the transition. @default null
+     * @example {"trait":"OrderPage","event":"EDIT","from":"browsing","to":"editing","nonce":1}
+     */
+    focusTarget?: OrbitalFocusTarget | null;
     /** Orbital mode: the canvas scrolls inside this height. @default "calc(100vh - 9rem)" */
     maxHeight?: string;
     /** Loading state indicator */
@@ -10949,6 +11325,8 @@ interface ChatFocusRequest {
     id: string | number;
     /** Shown in the input until the next message is sent. */
     placeholder?: string;
+    /** Put in the input, replacing what is there, for the user to edit and send. */
+    text?: string;
 }
 interface ChatBarProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** Pipeline status */
@@ -11295,5 +11673,5 @@ interface GenericAppTemplateProps extends TemplateProps, Omit<React__default.Ari
 }
 declare const GenericAppTemplate: React__default.FC<GenericAppTemplateProps>;
 
-export { ALL_PRESETS, Accordion, Card as ActionCard, ActionPalette, ActionTile, ActivationBlock, ActivityRail, AgentActivityFeed, AgentActivityRow, AgentChatFeed, AgentThinkingRow, Alert, AlgoGraphCanvas, AlgorithmCanvas, AnimatedCounter, AssetPicker, AuthLayout, BiologyCanvas, BranchingLogicBuilder, Breadcrumb, ButtonGroup, COMPACT_MEDIA_QUERY, CalendarGrid, CameraState, Canvas, Canvas2D, Carousel, ChangeList, Chart, ChartLegend, ChatBar, ChemistryCanvas, ChoiceButton, Coachmark, CodeBlock, CollapsibleSection, CommandPalette, CommitRow, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DateRangePicker, DateRangeSelector, DetailPanel, DialogueBubble, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DockLayout, DocumentDetails, DocumentPanel, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmojiPicker, EmptyState, EntityDisplayEvents, ErrorBoundary, ErrorState, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FacingDirection, FeatureCard, FeatureGrid, FilterGroup, Flex, FlipCard, FloatingActionButton, FloatingToolbar, Form, FormActions, FormField, FormLayout, FormSection$1 as FormSection, FormSectionHeader, FxOverlay, GameAudioCue, GameAudioToggle, GameHud, GameMenu, GameShell, Gantt, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, GuestView, Header, HealthBar, IconButton, IconPicker, ImportPreviewTree, ImportProgress, ImportSourcePicker, InputGroup, IsometricUnit, JazariStateMachine, JsonTreeEditor, LearningCanvas, LearningScene3D, LessonSegment, Lightbox, LikertScale, LineChart, LoadingState, MachinePanel, MapView, MarkdownContent, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, Navigation, NodeSlotEditor, NumberStepper, OnboardingSpotlight, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, PageHeader, PageTransition, Pagination, PhysicsCanvas, Popover, PositionedCanvas, ProgressDots, PropertyInspector, PullToRefresh, QrScanner, QuizBlock, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, ResolvedFrame, RichTextEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SequenceBar, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SkeletonTree, SlotContent, SlotContentRenderer, SocialProof, SortableList, Split, SplitPane, SpriteFrameDims, SpriteSheetUrls, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, StatusBar, SubagentTracePanel, SwipeableRow, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagInput, TerrainPalette, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TopNavItem, TraitFrame, TraitSlot, TraitStateViewer, UISlotComponent, UISlotRenderer, UnitAnimationState, UploadDropZone, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, activityRowFacts, applyCompletion, applySuggestions, arrowBetween, billboardLabel, boardEntity, bool, createUnitAnimationState, cylinderBetween, dispatchCommandPaletteCommand, get3DClickPayload, getCurrentFrame, groupIntoConversations, inferDirection, isoToScreen, makeAsset, makeAssetMap, meshSphere, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, parseMarkdownWithCodeBlocks, pendulum, preloadCodeHighlighter, projectileMotion, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, rows, sanitizeRichHtml, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAnchorRect, useCamera, useCompactLayout, useDockLayout, useImageCache, useUnitSpriteAtlas, vec2 };
-export type { AccordionItem, AccordionProps, CardProps as ActionCardProps, ActionPaletteProps, ActionTileProps, ActivationBlockProps, ActivityRailItem, ActivityRailProps, AgentActivityFeedProps, AgentActivityJumpTarget, AgentActivityRowProps, AgentChatFeedProps, AgentConversation, AlertProps, AlertVariant, AlgoGraphCanvasProps, AlgoGraphEdge, AlgoGraphEdgeState, AlgoGraphLayout, AlgoGraphNode, AlgoGraphNodeBadge, AlgoGraphNodeState, AlgorithmBar, AlgorithmCanvasProps, AlgorithmCell, AlgorithmPointer, AnimatedCounterProps, AssetPickerProps, AuthLayoutProps, BiologyCanvasProps, BiologyEdge, BiologyNode, BranchingLogicBuilderProps, BranchingQuestion, BranchingRule, BreadcrumbItem, BreadcrumbProps, ButtonGroupProps, CalendarGridProps, CameraMode, Canvas2DProps, CanvasItemShape, CanvasItemStatus, CanvasMode, CanvasProps, CardAction, CarouselProps, ChangeListItem, ChangeListProps, ChangeType, ChartDataPoint, ChartLegendItem, ChartLegendProps, ChartProps, ChartSeries, ChartType, ChatBarProps, ChatBarStatus, ChatFocusRequest, ChemistryArrow, ChemistryAtom, ChemistryBond, ChemistryCanvasProps, ChoiceButtonProps, CoachmarkAnchor, CoachmarkPlacement, CoachmarkProps, CodeAssistProvider, CodeAssistRequest, CodeAssistResult, CodeBlockProps, CodeCompletion, CodeCompletionProvider, CodeCompletionResult, CodeDiagnostic, CodeLanguage, CodeLanguageLoader, CodeSuggestion, CodeViewerAction, CodeViewerFile, CodeViewerMode, CollapsibleSectionProps, CommandPaletteCommand, CommandPaletteProps, CommitKind, CommitRowProps, ConfirmDialogProps, ConfirmDialogVariant, ConnectionBlockProps, ContainerProps, ContentRendererProps, ControlButtonProps, ControlGridButton, ControlGridKind, ControlGridProps, CounterSize, CounterTemplateProps, CounterVariant, DPadDirection, DashboardGridCell, DashboardGridProps, DashboardLayoutProps, DataGridField, DataGridItemAction, DataGridProps, DataListField, DataListItemAction, DataListProps, DateRangePickerPreset, DateRangePickerProps, DateRangeSelectorOption, DateRangeSelectorProps, DescribeTrait, DetailField, DetailPanelProps, DetailSection, DialogueBubbleProps, DiffHunk, DiffLine$1 as DiffLine, DiffLineType, DiffRevision, DispatchCommandPaletteCommandDeps, DisplayStateProps, DocBreadcrumbItem, DocBreadcrumbProps, DocPaginationLink, DocPaginationProps, DocSearchProps, DocSearchResult, DocSidebarItem, DocSidebarProps, DocTOCItem, DocTOCProps, DockLayoutContextValue, DockLayoutProps, DocumentDetailsField, DocumentDetailsProps, DocumentPanelAction, DocumentPanelProps, DocumentType, DocumentViewerProps, DotSize, DotState, DrawerPosition, DrawerProps, DrawerSize, DrawerSlotProps, EdgeDecorationProps, EdgeSide, EdgeVariant, EditorCheckboxProps, EditorMode, EditorSelectProps, EditorSliderProps, EditorTextInputProps, EditorToolbarProps, EmojiPickerPosition, EmojiPickerProps, EmptyStateProps, ErrorBoundaryProps, ErrorStateProps, FeatureCardProps, FeatureGridProps, FilterDefinition, FilterGroupProps, FilterPayload, FlexProps, FlipCardProps, FloatingAction, FloatingActionButtonProps, FloatingToolbarItem, FloatingToolbarPosition, FloatingToolbarProps, FormActionsProps, FormFieldProps, FormLayoutProps, FormProps, FormSectionHeaderProps, FormSectionProps, FxOverlayProps, GameAudioCueProps, GameAudioToggleProps, GameHudElement, GameHudProps, GameHudStat, GameMenuProps, GameShellProps, GanttLink, GanttProps, GenericAppTemplateProps, GeometricPatternProps, GradientDividerProps, GraphCanvasProps, GraphEdge, GraphNode, GraphSimilarity, GraphViewEdge, GraphViewNode, GraphViewProps, GridPickerCellSize, GridPickerProps, GridProps, GuestViewProps, HeaderProps, HealthBarProps, IconButtonProps, IconPickerProps, ImportEntityDisplay, ImportPreviewTreeProps, ImportPreviewUnit, ImportProgressCounts, ImportProgressProps, ImportProgressStep, ImportSkippedElement, ImportSourceOption, ImportSourcePickerProps, InputGroupProps, JazariStateMachineProps, JsonTreeEditorProps, Learning3DPoint, LearningCanvasProps, LearningPhysicsBody, LearningPhysicsConstraint, LearningPoint, LearningScene3DProps, LearningShape, LearningShapeType, LightboxImage, LightboxProps, LikertOption, LikertScaleProps, LineChartProps, LoadingStateProps, MachinePanelProps, MapMarkerData, MapRouteData, MapRouteWaypoint, MapViewProps, MarkdownContentProps, MasterDetailLayoutProps, MathCanvasProps, MathCurve, MathPoint, MathVector, MatrixColumn, MatrixQuestionProps, MatrixRow, MediaGalleryProps, MediaItem, MenuItem, MenuOption, MenuProps, MeshSphereOpts, MeterAction, MeterProps, MeterThreshold, MeterVariant, MixedSegment, ModalProps, ModalSize, ModalSlotProps, NavItem, NavigationItem, NavigationProps, NodeSlotEditorProps, NumberStepperProps, NumberStepperSize, OnboardingSpotlightProps, OptionConstraint, OptionConstraintGroupProps, OptionConstraintOption, OrbitalVisualizationProps, PageBreadcrumb, PageHeaderProps, PageTransitionProps, PaginatePayload, PaginationProps, PhysicsCanvasProps, PickerItem, Platform, PopoverProps, PositionedCanvasProps, PrismLanguageGrammar, ProgressDotsProps, Projection, PropertyInspectorProps, PullToRefreshProps, QrScanResult, QrScannerProps, QuizBlockProps, ReflectionBlockProps, RelationOption, RelationSelectProps, RepeatableFormSectionProps, RepeatableItem, ReplyTreeProps, RichTextEditorProps, RowFacts, RuleDefinition, RuleOption, RuntimeDebuggerProps, ScaledDiagramProps, ScoreDisplayProps, SearchInputProps, SearchPayload, SectionProps, SelectPayload, SequenceBarProps, SidePanelProps, SidePlayer, SidebarItem, SidebarProps, SignaturePadProps, SimpleGridProps, SkeletonProps, SlotItemData, SocialProofItem, SocialProofProps, SortPayload, SortableListProps, SplitPaneProps, SplitProps, SpotlightStep, StarRatingPrecision, StarRatingProps, StarRatingSize, StatBadgeProps, StatCardProps, StatDisplayProps, StateGraphProps, StateGraphTransition, StateJsonViewProps, StateMachineViewProps, StatusBarProps, SubagentTracePanelProps, SwipeAction, SwipeableRowProps, TabDefinition, TabItem, TabbedContainerProps, TableViewColumn, TableViewProps, TabsProps, TagInputProps, TeamUnitTraits, TemplateProps, TerrainPaletteProps, TileCoord, TileLayout, TimelineItem, TimelineItemStatus, TimelineProps, TimerDisplayProps, ToastProps, ToastSlotProps, ToastVariant, TooltipProps, TopNavItemData, TopNavItemProps, TraceDisclosureLevel, TraitFrameProps, TraitSlotProps, TraitStateMachineDefinition, TraitStateViewerProps, TraitTransition, UISlotComponentProps, UISlotRendererProps, UploadDropZoneProps, Vec2, DiffLine as VersionDiffLine, VersionDiffProps, ViolationAlertProps, ViolationRecord, VoteStackProps, WizardContainerProps, WizardNavigationProps, WizardProgressProps, WizardProgressStep, WizardStep };
+export { ALL_PRESETS, Accordion, Card as ActionCard, ActionPalette, ActionTile, ActivationBlock, ActivityRail, AgentActivityFeed, AgentActivityRow, AgentChatFeed, AgentThinkingRow, Alert, AlgoGraphCanvas, AlgorithmCanvas, AnimatedCounter, AssetPicker, AuthLayout, BiologyCanvas, BranchingLogicBuilder, Breadcrumb, ButtonGroup, COMPACT_MEDIA_QUERY, CalendarGrid, Canvas, Canvas2D, Carousel, ChangeList, Chart, ChartLegend, ChatBar, ChemistryCanvas, ChoiceButton, Coachmark, CodeBlock, CollapsibleSection, CommandPalette, CommitRow, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTION_KEYS, DEFAULT_MATRIX_COLUMN_KEYS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DateRangePicker, DateRangeSelector, DetailPanel, DialogueBubble, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DockLayout, DocumentDetails, DocumentPanel, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmojiPicker, EmptyState, EntityDisplayEvents, ErrorBoundary, ErrorState, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureGrid, FilterGroup, Flex, FlipCard, FloatingActionButton, FloatingToolbar, Form, FormActions, FormField, FormLayout, FormSection$1 as FormSection, FormSectionHeader, FxOverlay, GameAudioCue, GameAudioToggle, GameHud, GameMenu, GameShell, Gantt, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, GuestView, Header, HealthBar, IconButton, IconPicker, ImportPreviewTree, ImportProgress, ImportSourcePicker, InputGroup, JazariStateMachine, JsonTreeEditor, LearningCanvas, LessonSegment, Lightbox, LikertScale, LineChart, LoadingState, MachinePanel, MapView, MarkdownContent, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, Navigation, NodeSlotEditor, NumberStepper, OnboardingSpotlight, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, PageHeader, PageTransition, Pagination, PhysicsCanvas, Popover, PositionedCanvas, ProgressDots, PropertyInspector, PullToRefresh, QrScanner, QuizBlock, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, RichTextEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SequenceBar, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SkeletonTree, SlotContent, SlotContentRenderer, SocialProof, SortableList, Split, SplitPane, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, StatusBar, SubagentTracePanel, SwipeableRow, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagInput, TerrainPalette, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TopNavItem, TraitFrame, TraitSlot, TraitStateViewer, UISlotComponent, UISlotRenderer, UploadDropZone, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, activityRowFacts, applyCompletion, applySuggestions, boardEntity, bool, calculateAttackTargets, calculateValidMoves, createInitialGameState, createUnitAnimationState, dispatchCommandPaletteCommand, getCurrentFrame, groupIntoConversations, inferDirection, isoToScreen, makeAsset, makeAssetMap, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, parseMarkdownWithCodeBlocks, pendulum, preloadCodeHighlighter, projectileMotion, registerCodeLanguageLoader, renderPatternValue, resolveFrame, resolveSheetDirection, rows, sanitizeRichHtml, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAnchorRect, useCamera, useCompactLayout, useDockLayout, useImageCache, useUnitSpriteAtlas, vec2 };
+export type { AccordionItem, AccordionProps, CardProps as ActionCardProps, ActionPaletteProps, ActionTileProps, ActivationBlockProps, ActivityRailItem, ActivityRailProps, AgentActivityFeedProps, AgentActivityJumpTarget, AgentActivityRowProps, AgentChatFeedProps, AgentConversation, AlertProps, AlertVariant, AlgoGraphCanvasProps, AlgoGraphEdge, AlgoGraphEdgeState, AlgoGraphLayout, AlgoGraphNode, AlgoGraphNodeBadge, AlgoGraphNodeState, AlgorithmBar, AlgorithmCanvasProps, AlgorithmCell, AlgorithmPointer, AnimatedCounterProps, AssetPickerProps, AuthLayoutProps, BiologyCanvasProps, BiologyEdge, BiologyNode, BoardTile, BranchingLogicBuilderProps, BranchingQuestion, BranchingRule, BreadcrumbItem, BreadcrumbProps, ButtonGroupProps, CalendarGridProps, CameraMode, CameraState, Canvas2DProps, CanvasItemShape, CanvasItemStatus, CanvasMode, CanvasProps, CardAction, CarouselProps, ChangeListItem, ChangeListProps, ChangeType, ChartDataPoint, ChartLegendItem, ChartLegendProps, ChartProps, ChartSeries, ChartType, ChatBarProps, ChatBarStatus, ChatFocusRequest, ChemistryArrow, ChemistryAtom, ChemistryBond, ChemistryCanvasProps, ChoiceButtonProps, CoachmarkAnchor, CoachmarkPlacement, CoachmarkProps, CodeAssistProvider, CodeAssistRequest, CodeAssistResult, CodeBlockProps, CodeCompletion, CodeCompletionProvider, CodeCompletionResult, CodeDiagnostic, CodeLanguage, CodeLanguageLoader, CodeSuggestion, CodeViewerAction, CodeViewerFile, CodeViewerMode, CollapsibleSectionProps, CommandPaletteCommand, CommandPaletteProps, CommitKind, CommitRowProps, ConfirmDialogProps, ConfirmDialogVariant, ConnectionBlockProps, ContainerProps, ContentRendererProps, ControlButtonProps, ControlGridButton, ControlGridKind, ControlGridProps, CounterSize, CounterTemplateProps, CounterVariant, DPadDirection, DashboardGridCell, DashboardGridProps, DashboardLayoutProps, DataGridField, DataGridItemAction, DataGridProps, DataListField, DataListItemAction, DataListProps, DateRangePickerPreset, DateRangePickerProps, DateRangeSelectorOption, DateRangeSelectorProps, DescribeTrait, DetailField, DetailPanelProps, DetailSection, DialogueBubbleProps, DiffHunk, DiffLine$1 as DiffLine, DiffLineType, DiffRevision, DispatchCommandPaletteCommandDeps, DisplayStateProps, DocBreadcrumbItem, DocBreadcrumbProps, DocPaginationLink, DocPaginationProps, DocSearchProps, DocSearchResult, DocSidebarItem, DocSidebarProps, DocTOCItem, DocTOCProps, DockLayoutContextValue, DockLayoutProps, DocumentDetailsField, DocumentDetailsProps, DocumentPanelAction, DocumentPanelProps, DocumentType, DocumentViewerProps, DotSize, DotState, DrawerPosition, DrawerProps, DrawerSize, DrawerSlotProps, EdgeDecorationProps, EdgeSide, EdgeVariant, EditorCheckboxProps, EditorMode, EditorSelectProps, EditorSliderProps, EditorTextInputProps, EditorToolbarProps, EmojiPickerPosition, EmojiPickerProps, EmptyStateProps, ErrorBoundaryProps, ErrorStateProps, FacingDirection, FeatureCardProps, FeatureGridProps, FilterDefinition, FilterGroupProps, FilterPayload, FlexProps, FlipCardProps, FloatingAction, FloatingActionButtonProps, FloatingToolbarItem, FloatingToolbarPosition, FloatingToolbarProps, FormActionsProps, FormFieldProps, FormLayoutProps, FormProps, FormSectionHeaderProps, FormSectionProps, FxOverlayProps, GameAction, GameAudioCueProps, GameAudioToggleProps, GameHudElement, GameHudProps, GameHudStat, GameMenuProps, GamePhase, GameShellProps, GameState, GameUnit, GanttLink, GanttProps, GenericAppTemplateProps, GeometricPatternProps, GradientDividerProps, GraphCanvasProps, GraphEdge, GraphNode, GraphSimilarity, GraphViewEdge, GraphViewNode, GraphViewProps, GridPickerCellSize, GridPickerProps, GridProps, GuestViewProps, HeaderProps, HealthBarProps, IconButtonProps, IconPickerProps, ImportEntityDisplay, ImportPreviewTreeProps, ImportPreviewUnit, ImportProgressCounts, ImportProgressProps, ImportProgressStep, ImportSkippedElement, ImportSourceOption, ImportSourcePickerProps, InputGroupProps, IsometricFeature, IsometricTile, IsometricUnit, JazariStateMachineProps, JsonTreeEditorProps, LearningCanvasProps, LearningPhysicsBody, LearningPhysicsConstraint, LearningPoint, LearningShape, LearningShapeType, LightboxImage, LightboxProps, LikertOption, LikertScaleProps, LineChartProps, LoadingStateProps, MachinePanelProps, MapMarkerData, MapRouteData, MapRouteWaypoint, MapViewProps, MarkdownContentProps, MasterDetailLayoutProps, MathCanvasProps, MathCurve, MathPoint, MathVector, MatrixColumn, MatrixQuestionProps, MatrixRow, MediaGalleryProps, MediaItem, MenuItem, MenuOption, MenuProps, MeterAction, MeterProps, MeterThreshold, MeterVariant, MixedSegment, ModalProps, ModalSize, ModalSlotProps, NavItem, NavigationItem, NavigationProps, NodeSlotEditorProps, NumberStepperProps, NumberStepperSize, OnboardingSpotlightProps, OptionConstraint, OptionConstraintGroupProps, OptionConstraintOption, OrbitalVisualizationProps, PageBreadcrumb, PageHeaderProps, PageTransitionProps, PaginatePayload, PaginationProps, PhysicsCanvasProps, PickerItem, Platform, PopoverProps, Position, PositionedCanvasProps, PrismLanguageGrammar, ProgressDotsProps, Projection, PropertyInspectorProps, PullToRefreshProps, QrScanResult, QrScannerProps, QuizBlockProps, ReflectionBlockProps, RelationOption, RelationSelectProps, RepeatableFormSectionProps, RepeatableItem, ReplyTreeProps, ResolvedFrame, RichTextEditorProps, RowFacts, RuleDefinition, RuleOption, RuntimeDebuggerProps, ScaledDiagramProps, ScoreDisplayProps, SearchInputProps, SearchPayload, SectionProps, SelectPayload, SequenceBarProps, SidePanelProps, SidePlayer, SidebarItem, SidebarProps, SignaturePadProps, SimpleGridProps, SkeletonProps, SlotItemData, SocialProofItem, SocialProofProps, SortPayload, SortableListProps, SplitPaneProps, SplitProps, SpotlightStep, SpriteFrameDims, SpriteSheetUrls, StarRatingPrecision, StarRatingProps, StarRatingSize, StatBadgeProps, StatCardProps, StatDisplayProps, StateGraphProps, StateGraphTransition, StateJsonViewProps, StateMachineViewProps, StatusBarProps, SubagentTracePanelProps, SwipeAction, SwipeableRowProps, TabDefinition, TabItem, TabbedContainerProps, TableViewColumn, TableViewProps, TabsProps, TagInputProps, TeamUnitTraits, TemplateProps, TerrainPaletteProps, TileCoord, TileLayout, TimelineItem, TimelineItemStatus, TimelineProps, TimerDisplayProps, ToastProps, ToastSlotProps, ToastVariant, TooltipProps, TopNavItemData, TopNavItemProps, TraceDisclosureLevel, TraitFrameProps, TraitSlotProps, TraitStateMachineDefinition, TraitStateViewerProps, TraitTransition, UISlotComponentProps, UISlotRendererProps, UnitAnimationState, UnitTrait, UploadDropZoneProps, Vec2, DiffLine as VersionDiffLine, VersionDiffProps, ViolationAlertProps, ViolationRecord, VoteStackProps, WizardContainerProps, WizardNavigationProps, WizardProgressProps, WizardProgressStep, WizardStep };