@almadar/shell-web 0.1.0 → 1.1.0

package/dist/components/index.d.ts

@@ -1,16 +1,14 @@
 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-_Y-5uLM_.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-_Y-5uLM_.js';
-import { EntityRow, FieldValue, EntityRole, Asset, AnimationName, SpriteDirection, AnimationDef, A11yProps, EventKey, EventEmit, EventPayload, AssetUrl, ScenePos, Camera, SoundEntry, EntityWith, DiagramMarkRoles, TraitConfigValue, SkeletonVariant, SkeletonSpec, SkeletonNode, SurfaceMode, EventListen, JsonValue, AssetCatalog, SExpr, JsonObject, EventPayloadValue, DeclaredTraitConfig, TraitConfig, ControlValue, OrbitalSchema, Trait, TraceActivity, OrbitalEntity, FormSubmitPayload, TraitDescription, UISlot, 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, SoundEntry, 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-CVwjkV_2.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-ChW5mVuK.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-ChW5mVuK.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-Cm9BnvmP.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 '../EventBusProvider-BFFHfN4O.js';
+import { D as DrawableNode, P as Projector, M as MeshShapeKind } from '../verificationRegistry-oopV1J1n.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-oopV1J1n.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-D7wo5ryN.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';
@@ -18,17 +16,13 @@ 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';
 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-CabxhfTv.js';
-export { ALMADAR_DND_MIME, AuthContextValue, AuthUser, CanvasGestureCallbacks, CanvasGestureHandlers, CompileResult, CompileStage, DragReorderResult, DraggablePayload, Extension, ExtensionManifest, FileSystemFile, FileSystemStatus, GitHubRepo, GitHubStatus, 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, claimDelivery, createSharedEntityStore, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useLongPress, usePageHead, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTickVisibility, useTraitListens, useUIEvents, useValidation } from '../hooks/index.js';
-export { E as EditorKeyEvent, a as KeyCaptureEntry, K as KeyCaptureTable, U as UseKeyboardRouterOptions, k as keyChord, m as mergeCaptureTables, u as useKeyboardRouter } from '../useKeyboardRouter-Dsq553Ur.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';
 
 /**
@@ -86,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.
@@ -364,8 +644,10 @@ interface ScoreDisplayProps extends Omit<React$1.AriaAttributes, keyof A11yProps
     className?: string;
     /** Number formatting locale */
     locale?: string;
+    /** Formatted value supplied by the program's presentation expression. */
+    displayValue?: string;
 }
-declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale: localeProp, ...rest }: ScoreDisplayProps): React$1.JSX.Element;
+declare function ScoreDisplay({ assetUrl, value, score, label, icon, size, className, locale: localeProp, displayValue, ...rest }: ScoreDisplayProps): React$1.JSX.Element;
 declare namespace ScoreDisplay {
     var displayName: string;
 }
@@ -418,8 +700,10 @@ interface TimerDisplayProps extends Omit<React$1.AriaAttributes, keyof A11yProps
     lowThreshold?: number;
     /** Icon asset rendered to the left of the time value. Falls back to no icon. */
     iconAsset?: Asset;
+    /** Time text supplied by the program's presentation expression. */
+    displayText?: string;
 }
-declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, ...rest }: TimerDisplayProps): React$1.JSX.Element;
+declare function TimerDisplay({ seconds, running, format, size, className, lowThreshold, iconAsset, displayText, ...rest }: TimerDisplayProps): React$1.JSX.Element;
 declare namespace TimerDisplay {
     var displayName: string;
 }
@@ -484,7 +768,7 @@ interface ControlGridButton {
     assetUrl?: Asset;
     variant?: 'primary' | 'secondary' | 'ghost' | string;
 }
-type DPadDirection = 'up' | 'down' | 'left' | 'right';
+type DPadDirection = 'up' | 'down' | 'left' | 'right' | 'up-left' | 'up-right' | 'down-left' | 'down-right';
 interface ControlGridProps extends Omit<React$1.AriaAttributes, keyof A11yProps>, A11yProps {
     kind: ControlGridKind;
     /** action buttons (kind="actions") */
@@ -540,6 +824,8 @@ interface StatBadgeProps extends Omit<React$1.AriaAttributes, keyof A11yProps>,
     label: string;
     /** Current value (defaults to 0 if not provided) */
     value?: number | string;
+    /** Formatted numeric value supplied by the program's presentation expression. */
+    displayValue?: string;
     /** Maximum value (for bar/hearts format) */
     max?: number;
     /** Data source entity name (for schema config) */
@@ -557,7 +843,7 @@ interface StatBadgeProps extends Omit<React$1.AriaAttributes, keyof A11yProps>,
     /** Additional CSS classes */
     className?: string;
 }
-declare function StatBadge({ assetUrl, iconUrl, label, value, max, format, icon, size, variant, className, source: _source, field: _field, ...rest }: StatBadgeProps): React$1.JSX.Element;
+declare function StatBadge({ assetUrl, iconUrl, label, value, displayValue, max, format, icon, size, variant, className, source: _source, field: _field, ...rest }: StatBadgeProps): React$1.JSX.Element;
 declare namespace StatBadge {
     var displayName: string;
 }
@@ -864,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).
  *
@@ -884,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
  */
@@ -1030,6 +1370,11 @@ interface GameAudioToggleProps extends Omit<React__default.AriaAttributes, keyof
     size?: 'sm' | 'md' | 'lg';
     /** Additional CSS classes */
     className?: string;
+    /** Authored mute state. When supplied, the caller owns updates. */
+    muted?: boolean;
+    /** Accessible labels supplied by the translated parent view. */
+    soundOnLabel?: string;
+    mutedLabel?: string;
     /** Loading state (passed through) */
     isLoading?: boolean;
     /** Error state (passed through) */
@@ -1043,7 +1388,7 @@ interface GameAudioToggleProps extends Omit<React__default.AriaAttributes, keyof
         muted: boolean;
     }>;
 }
-declare function GameAudioToggle({ size, className, onAsset, offAsset, toggleEvent, ...rest }: GameAudioToggleProps): React__default.JSX.Element;
+declare function GameAudioToggle({ size, className, muted: authoredMuted, soundOnLabel, mutedLabel, onAsset, offAsset, toggleEvent, isLoading, ...rest }: GameAudioToggleProps): React__default.JSX.Element;
 declare namespace GameAudioToggle {
     var displayName: string;
 }
@@ -1226,6 +1571,10 @@ interface TraitSlotProps extends Omit<React__default.AriaAttributes, keyof A11yP
     locked?: boolean;
     /** Label shown when locked */
     lockLabel?: string;
+    /** Accessible name for an empty slot; author supplies translated text. */
+    emptyLabel?: string;
+    /** Accessible name for the remove control; author supplies translated text. */
+    removeLabel?: string;
     /** Whether slot is selected */
     selected?: boolean;
     /** Size variant */
@@ -1273,7 +1622,7 @@ interface TraitSlotProps extends Omit<React__default.AriaAttributes, keyof A11yP
         itemId: string;
     }>;
 }
-declare function TraitSlot({ slotNumber, equippedItem, locked, lockLabel, selected, size, showTooltip, categoryColors, tooltipFrameUrl, className, feedback, onItemDrop, draggable, onDragStart, onClick, onRemove, clickEvent, removeEvent, dropEvent, ...rest }: TraitSlotProps): React__default.JSX.Element;
+declare function TraitSlot({ slotNumber, equippedItem, locked, lockLabel, emptyLabel, removeLabel, selected, size, showTooltip, categoryColors, tooltipFrameUrl, className, feedback, onItemDrop, draggable, onDragStart, onClick, onRemove, clickEvent, removeEvent, dropEvent, ...rest }: TraitSlotProps): React__default.JSX.Element;
 declare namespace TraitSlot {
     var displayName: string;
 }
@@ -1392,87 +1741,6 @@ declare namespace EditorToolbar {
     var displayName: string;
 }
 
-/**
- * Shared types for entity-display organisms.
- *
- * All entity-display organisms (DataTable, List, Table, CardGrid, DetailPanel)
- * extend EntityDisplayProps to guarantee a uniform prop contract.
- *
- * Exception: Form manages local `formData` state for field input tracking.
- * This is the ONE allowed exception — documented here.
- */
-
-declare const EntityDisplayEvents: {
-    readonly SORT: "SORT";
-    readonly PAGINATE: "PAGINATE";
-    readonly SEARCH: "SEARCH";
-    readonly FILTER: "FILTER";
-    readonly CLEAR_FILTERS: "CLEAR_FILTERS";
-    readonly SELECT: "SELECT";
-    readonly DESELECT: "DESELECT";
-};
-interface SortPayload {
-    field: string;
-    direction: 'asc' | 'desc';
-}
-interface PaginatePayload {
-    page: number;
-    pageSize?: number;
-}
-interface SearchPayload {
-    query: string;
-}
-interface FilterPayload {
-    field: string;
-    operator: string;
-    value: FieldValue;
-}
-interface SelectPayload {
-    ids: (string | number)[];
-}
-/**
- * Common non-entity display state shared by every display organism — loading,
- * error, and the render-ui display hints (sort/search/pagination/selection).
- * Carries NO entity data and NO generic. Components that show entity data add
- * their own `entity?: EntityRow | readonly EntityRow[]` field directly (the one
- * unified entity type from `@almadar/core`); components that only need the
- * loading/hint surface just extend this.
- */
-interface DisplayStateProps {
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Current sort field */
-    sortBy?: string;
-    /** Current sort direction */
-    sortDirection?: 'asc' | 'desc';
-    /** Current search query value */
-    searchValue?: string;
-    /** Current page number (1-indexed) */
-    page?: number;
-    /** Number of items per page */
-    pageSize?: number;
-    /** Total number of items (for pagination display) */
-    totalCount?: number;
-    /**
-     * Active filters, keyed by field name. Scalar-only (`string | number |
-     * boolean`) rather than the full `FieldValue` domain: `FieldValue` is a
-     * self-referential union (adds `Date`, nested arrays/objects) the
-     * pattern-sync scanner can't shape into a `Map string V` knob, so it always
-     * degraded to `json`. This narrows out date/array/nested-object filter
-     * values — no current call site in this package constructs this prop, so
-     * nothing here breaks, but a caller wiring a date-range or multi-select
-     * filter through this prop would need those. Flagged for the coordinator;
-     * revert to `Record<string, FieldValue>` if that capability is needed.
-     */
-    activeFilters?: Record<string, string | number | boolean>;
-    /** Currently selected item IDs */
-    selectedIds?: readonly (string | number)[];
-}
-
 /**
  * ActionTile Component
  *
@@ -1483,7 +1751,7 @@ interface DisplayStateProps {
  * @packageDocumentation
  */
 
-interface ActionTileProps extends DisplayStateProps, Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
+interface ActionTileProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** The action data */
     action: SlotItemData;
     /** Size variant */
@@ -1495,6 +1763,8 @@ interface ActionTileProps extends DisplayStateProps, Omit<React__default.AriaAtt
         bg: string;
         border: string;
     }>;
+    /** Additional CSS classes */
+    className?: string;
 }
 declare function ActionTile({ action, size, disabled, categoryColors, className, ...rest }: ActionTileProps): React__default.JSX.Element;
 declare namespace ActionTile {
@@ -1575,10 +1845,14 @@ interface SequenceBarProps extends Omit<React__default.AriaAttributes, keyof A11
     slotFeedback?: Array<'correct' | 'wrong' | null>;
     /** Size variant */
     size?: 'sm' | 'md' | 'lg';
+    /** Accessible name for empty slots; author supplies translated text. */
+    emptyLabel?: string;
+    /** Accessible name for remove controls; author supplies translated text. */
+    removeLabel?: string;
     /** Additional CSS classes */
     className?: string;
 }
-declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, slotDropEvent, slotRemoveEvent, playing, currentStep, categoryColors, slotFeedback, size, className, ...rest }: SequenceBarProps): React__default.JSX.Element;
+declare function SequenceBar({ slots, maxSlots, onSlotDrop, onSlotRemove, slotDropEvent, slotRemoveEvent, playing, currentStep, categoryColors, slotFeedback, size, emptyLabel, removeLabel, className, ...rest }: SequenceBarProps): React__default.JSX.Element;
 declare namespace SequenceBar {
     var displayName: string;
 }
@@ -1747,7 +2021,7 @@ interface GameShellProps extends Omit<React__default.AriaAttributes, keyof A11yP
     backgroundAsset?: Asset;
     /** Per-call-site 9-sliced panel override. Chrome normally comes from the active theme; most callers leave this unset. */
     hudBackgroundAsset?: Asset;
-    /** Game display-font key (pixel | fredoka | future | future-narrow | blocks | mini) or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme. Unset = the theme token decides. */
+    /** Shared game display-font alias or a CSS font-family. Scoped override of the theme contract's --font-family-display slot: titles and numerics take this face, body text follows the active theme. Unset = the theme token decides. */
     fontFamily?: string;
     /** Scopes an `@almadar/ui` theme (e.g. "game-sci-fi-dark") to this shell's subtree. */
     "data-theme"?: string;
@@ -1757,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.
  *
@@ -1820,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. */
@@ -1883,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
@@ -2101,6 +2392,11 @@ interface ErrorStateProps extends A11yProps {
 }
 declare const ErrorState: React__default.FC<ErrorStateProps>;
 
+/**
+ * @role status
+ * @tokens --color-muted --color-border
+ * @motion css
+ */
 interface SkeletonProps extends A11yProps {
     /** The skeleton variant to render */
     variant?: SkeletonVariant;
@@ -2224,6 +2520,11 @@ declare const Accordion: React__default.FC<AccordionProps>;
  */
 
 type AlertVariant = "info" | "success" | "warning" | "error";
+/**
+ * @role status
+ * @tokens --color-error --color-warning --color-success --color-info
+ * @motion none
+ */
 interface AlertProps extends A11yProps {
     /** Alert content (children or message) */
     children?: React__default.ReactNode;
@@ -2748,6 +3049,51 @@ interface FloatingActionButtonProps extends A11yProps {
 }
 declare const FloatingActionButton: React__default.FC<FloatingActionButtonProps>;
 
+/**
+ * GuestView — paints the UI of a guest program session (program/open) inside the opener's view.
+ * Paint only: a click on a control inside it is routed by the kernel to the opener as its
+ * `deliver` event { guest, address, event, payload }.
+ *
+ * The guest's own traits are the ones an `@trait.X` inside its paint names, so the view holds a scoped
+ * UISlotProvider seeded with every paint the guest made: `TraitFrame` resolves against the guest, not the host.
+ * Every slot the guest paints renders inside the view (contained, never the host page's), and an in-app link
+ * inside it is the guest's navigation, emitted as `navigate`, never the host router's. Each guest paint is scoped to
+ * the trait that drew it (its `orbital`, as a page scopes its own), so a click names its painter for the kernel.
+ */
+
+interface GuestPaintEntry {
+    /** Slot the guest trait painted */
+    slot: UISlot;
+    /** Guest trait that painted `content` */
+    trait: string;
+    /** The guest orbital declaring `trait`: the scope its controls emit under */
+    orbital?: string | null;
+    /** Whether the trait is embedded (`@trait.X`) on the guest's page rather than the page root */
+    embedded: boolean;
+    /** The painted pattern tree */
+    content: PatternNode | string | null;
+}
+interface GuestViewProps {
+    /** Guest session handle (`program/open` answers it, e.g. "guest-1"). Data for the kernel; never rendered. */
+    guest: string;
+    /** The guest's page-root trait whose paint is `children`: their controls are scoped to it. Never rendered. */
+    source: string;
+    /** The opener trait's declared event a click inside this view is delivered as. The kernel emits it, never the renderer. */
+    deliver: EventKey;
+    /** The opener trait's declared event an in-app link inside this view is emitted as, with { guest, route }. Without it a link inside the guest does nothing. */
+    navigate?: EventKey;
+    /** The guest's current route (`program/open` and `program/navigate` answer it): the current page path of everything inside, so the guest's navigation shows its own active page and closes its own drawers. */
+    route?: string;
+    /** Every paint the guest made (`rendered` entries, the latest per trait and slot). An `@trait.X` inside the content resolves to the guest's trait X from these. */
+    paints?: ReadonlyArray<GuestPaintEntry>;
+    /** The guest's painted content */
+    children?: React__default.ReactNode;
+}
+/**
+ * GuestView - Paints a guest program's UI; guest, source and deliver are kernel routing data
+ */
+declare const GuestView: React__default.FC<GuestViewProps>;
+
 /**
  * Grid Component
  *
@@ -3433,6 +3779,12 @@ interface TabItem {
     /** Whether this tab is currently active (for controlled tabs) */
     active?: boolean;
 }
+/**
+ * @role tablist
+ * @tokens --color-muted --color-primary --color-border --color-foreground --color-muted-foreground
+ * @contrast muted-foreground background
+ * @motion css
+ */
 interface TabsProps extends A11yProps {
     /** Tab items */
     items?: TabItem[];
@@ -3600,12 +3952,16 @@ interface DrawerProps extends A11yProps {
     children?: React__default.ReactNode;
     /** Footer content */
     footer?: React__default.ReactNode;
+    /** Controls in the header beside the close button, outside the title heading (e.g. a size toggle). */
+    headerActions?: React__default.ReactNode;
     /** Position (left or right) */
     position?: DrawerPosition;
     /** Width (CSS value or preset size) */
     width?: string | DrawerSize;
     /** Show close button */
     showCloseButton?: boolean;
+    /** Accessible name for the close button, when supplied by the program. */
+    closeButtonLabel?: string;
     /** Close on overlay click */
     closeOnOverlayClick?: boolean;
     /** Close on escape key */
@@ -3614,6 +3970,10 @@ interface DrawerProps extends A11yProps {
     className?: string;
     /** Declarative close event — emits UI:{closeEvent} via eventBus when drawer should close */
     closeEvent?: EventKey;
+    /** Block the page behind it: an overlay, no page scroll, focus kept inside. `false` leaves the page usable beside the drawer (no overlay, no focus trap); Escape and the close button still close it.
+     * @default true
+     */
+    modal?: boolean;
 }
 declare const Drawer: React__default.FC<DrawerProps>;
 
@@ -3850,8 +4210,8 @@ interface CodeDiagnostic {
  *
  * Event Contract:
  * - Emits: UI:COPY_CODE { language, success }
- * - Emits: UI:EDITOR_FOCUS { editorId }
- * - Emits: UI:EDITOR_BLUR { editorId }
+ * - Emits: UI:EDITOR_FOCUS { editorId }, UI:EDITOR_BLUR { editorId } (the declared `onEditorFocus` / `onEditorBlur`)
+ * - Reports focus and blur to EditorFocusContext, which the keyboard router reads
  *
  * The editor capability props (`onMotion` / `onOperate` / `onInsertText` /
  * `onSetMode`) are declarative bus LISTENS (`EventListen<P>`), not emits —
@@ -3868,6 +4228,7 @@ type PrismLanguageGrammar = (prism: object) => void;
 /** A consumer-supplied async grammar fetcher. Returns the language module
  *  default (registered with PrismLight), or `null` if no grammar exists. */
 type CodeLanguageLoader = (lang: string) => Promise<PrismLanguageGrammar | null>;
+type ErrorLineSeverity = 'error' | 'warning';
 /** Wire up a dynamic language-grammar loader. Must be called from app source
  *  (not a pre-bundled dependency) so the bundler can split grammars into chunks. */
 declare function registerCodeLanguageLoader(loader: CodeLanguageLoader | null): void;
@@ -3944,9 +4305,10 @@ interface CodeBlockProps extends A11yProps {
      * warning = yellow. Honored by the editable overlay and (GAP-84) by
      * viewer mode's non-diff highlight; pass undefined (default) to disable.
      * The consumer is responsible for computing the path → line map from the
-     * schema + validation results.
+     * schema + validation results. A program authors it as a record of the
+     * line number (as text) to severity, read the same way.
      */
-    errorLines?: Map<number, 'error' | 'warning'>;
+    errorLines?: ReadonlyMap<number, ErrorLineSeverity> | Readonly<Record<string, ErrorLineSeverity>>;
     /** Lines to mark and keep in view (1-based, inclusive): the code of the step a running program just took. */
     highlightLines?: {
         start: number;
@@ -4116,6 +4478,24 @@ interface CodeBlockProps extends A11yProps {
      * @tier presentation
      */
     lineNumbers?: boolean;
+    /**
+     * Read-only only: event emitted when the reader picks Ask on code they selected (as `UI:<askEvent>`)
+     * @tier presentation
+     */
+    askEvent?: EventEmit<{
+        selectedText: string;
+    }>;
+    /**
+     * Read-only only: event emitted when the reader picks Note on code they selected (as `UI:<noteEvent>`)
+     * @tier presentation
+     */
+    noteEvent?: EventEmit<{
+        selectedText: string;
+    }>;
+    /** Ask action label (default: translated) */
+    askLabel?: string;
+    /** Note action label (default: translated) */
+    noteLabel?: string;
 }
 declare const CodeBlock: React__default.NamedExoticComponent<CodeBlockProps>;
 
@@ -4815,9 +5195,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
  */
@@ -4980,9 +5359,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;
@@ -5003,9 +5382,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
  */
@@ -5118,17 +5496,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. */
@@ -5148,7 +5526,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.
@@ -5196,7 +5574,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;
@@ -5214,7 +5592,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
@@ -5239,7 +5617,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;
@@ -5248,6 +5626,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;
@@ -5273,9 +5653,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;
@@ -5298,8 +5678,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
  */
@@ -5368,7 +5748,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). */
@@ -5377,9 +5757,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). */
@@ -5397,9 +5777,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`). */
@@ -5408,13 +5788,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`. */
@@ -5441,7 +5821,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;
@@ -5454,7 +5834,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;
@@ -5490,9 +5870,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;
@@ -5515,8 +5895,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
  */
@@ -5584,7 +5964,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. */
@@ -5602,9 +5982,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. */
@@ -5615,14 +5995,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;
@@ -5643,7 +6023,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;
@@ -5656,7 +6036,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;
@@ -5685,9 +6065,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;
@@ -5710,20 +6090,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
  */
@@ -5849,14 +6217,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
  */
@@ -5930,96 +6292,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
  *
@@ -6136,9 +6408,9 @@ interface MapViewProps extends A11yProps {
     /** Routes (polylines with optional popups) drawn over the tile layer */
     routes?: MapRouteData[];
     /** Map center latitude */
-    centerLat?: number;
+    centerLat?: number | null;
     /** Map center longitude */
-    centerLng?: number;
+    centerLng?: number | null;
     /** Zoom level (1-18, default 13) */
     zoom?: number;
     /** Height of the map container (default "400px") */
@@ -6202,7 +6474,12 @@ declare const NumberStepper: React__default.FC<NumberStepperProps>;
 
 type StarRatingSize = "sm" | "md" | "lg";
 type StarRatingPrecision = "full" | "half";
-/** @accessibleName label */
+/**
+ * @accessibleName label
+ * @role img
+ * @tokens --color-warning --color-muted-foreground
+ * @motion css
+ */
 interface StarRatingProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** Current rating value */
     value?: number;
@@ -6328,6 +6605,8 @@ type RowActionCondition = SExpr | ((row: EntityRow) => boolean);
  * S-expression, or the compiled shell's `(row) => payload` closure.
  */
 type RowActionPayload = SExpr | ((row: EntityRow) => EventPayload);
+/** A literal route or an authored `(fn row <string>)` expression. */
+type RowActionRoute = SExpr;
 
 /**
  * useDataDnd — shared drag-drop machinery for DataList + DataGrid.
@@ -6382,9 +6661,8 @@ interface DataGridItemAction {
     /** Event name to emit (dispatched as UI:{event} with { row: itemData }).
      *  Optional when `navigatesTo` is set — a navigating action never emits. */
     event?: EventKey;
-    /** Route to navigate to instead of emitting — `{{row.field}}`
-     *  placeholders interpolate from the item row (CardGrid's contract). */
-    navigatesTo?: string;
+    /** Literal route or `(fn row <string>)` destination; navigation suppresses the action event. */
+    navigatesTo?: RowActionRoute;
     /** Lucide icon name or component */
     icon?: IconInput;
     /** Button variant */
@@ -6500,8 +6778,8 @@ interface DataListItemAction {
     when?: RowActionCondition;
     /** Extra data the action sends, authored as `(fn row { key: <expr> })`; it emits `{ id, row }` plus these keys. */
     payload?: RowActionPayload;
-    /** Page the action opens instead of emitting; `{{row.<field>}}` is replaced with the row's value. */
-    navigatesTo?: string;
+    /** Literal route or `(fn row <string>)` destination; navigation suppresses the action event. */
+    navigatesTo?: RowActionRoute;
 }
 interface DataListSwipeAction {
     /** Button label */
@@ -7299,6 +7577,12 @@ interface LikertOption {
     /** Visible label below (radios) or inside (buttons) the control */
     label: string;
 }
+/**
+ * @role radiogroup
+ * @tokens --color-primary --color-muted --color-surface --color-border --color-foreground
+ * @contrast foreground surface
+ * @motion css
+ */
 interface LikertScaleProps extends A11yProps {
     /** Optional row prompt above the scale */
     question?: string;
@@ -7636,11 +7920,17 @@ interface DocumentDetailsProps extends A11yProps {
         id: string;
         name: string;
     }>;
+    /** The kernel-injected `{ value, label }` options per relation field; a relation chip reads its label from the
+     *  option for its id (labelled by the relation's declared display field), else shows the record id. */
+    relationsData?: Readonly<Record<string, ReadonlyArray<{
+        value: string;
+        label: string;
+    }>>>;
     /** Card heading (defaults to the localized "Details") */
     title?: string;
     className?: string;
 }
-declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, title, className, ...rest }: DocumentDetailsProps): React__default.ReactElement | null;
+declare function DocumentDetails({ entity, fields, metaCommitEvent, relationEvent, relationsData, title, className, ...rest }: DocumentDetailsProps): React__default.ReactElement | null;
 
 /**
  * ReplyTree Organism Component
@@ -7687,20 +7977,20 @@ interface ReplyTreeProps extends A11yProps {
 }
 declare const ReplyTree: React__default.FC<ReplyTreeProps>;
 
-interface BranchingQuestion {
+type BranchingQuestion = {
     id: string;
     label: string;
     optionValues?: string[];
-}
+};
 type BranchingOperator = 'equals' | 'not-equals' | 'contains' | 'in';
 declare const END_OF_SURVEY = "end-of-survey";
-interface BranchingRule extends EventPayload {
+type BranchingRule = {
     id: string;
     sourceQuestionId: string;
     operator: BranchingOperator;
     value: string | string[];
     targetQuestionId: string | typeof END_OF_SURVEY;
-}
+};
 interface BranchingLogicBuilderProps extends A11yProps {
     questions: readonly BranchingQuestion[] | EventPayloadValue;
     /**
@@ -7882,6 +8172,12 @@ interface DocBreadcrumbItem {
     /** Navigation href (omit for the current/last item) */
     href?: string;
 }
+/**
+ * @role navigation
+ * @tokens --color-foreground --color-muted-foreground
+ * @contrast muted-foreground background
+ * @motion none
+ */
 interface DocBreadcrumbProps extends A11yProps {
     /** Breadcrumb path items, last item is treated as current page */
     items: DocBreadcrumbItem[];
@@ -7902,6 +8198,12 @@ interface DocPaginationLink {
     href: string;
     category?: string;
 }
+/**
+ * @role navigation
+ * @tokens --color-border --color-accent --color-muted-foreground
+ * @contrast muted-foreground background
+ * @motion css
+ */
 interface DocPaginationProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** Previous page link */
     prev?: DocPaginationLink;
@@ -7952,6 +8254,12 @@ interface DocSidebarItem {
     /** Whether this item is currently active */
     active?: boolean;
 }
+/**
+ * @role navigation
+ * @tokens --color-muted-foreground
+ * @contrast muted-foreground background
+ * @motion none
+ */
 interface DocSidebarProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** Sidebar navigation items */
     items: DocSidebarItem[];
@@ -7975,6 +8283,12 @@ interface DocTOCItem {
     /** Heading level: 2 for h2, 3 for h3, etc. */
     level: number;
 }
+/**
+ * @role navigation
+ * @tokens --color-foreground --color-muted-foreground
+ * @contrast muted-foreground background
+ * @motion css
+ */
 interface DocTOCProps extends Omit<React__default.AriaAttributes, keyof A11yProps>, A11yProps {
     /** Table of contents items */
     items: DocTOCItem[];
@@ -8062,6 +8376,87 @@ interface PageHeaderProps extends A11yProps {
 }
 declare const PageHeader: React__default.FC<PageHeaderProps>;
 
+/**
+ * Shared types for entity-display organisms.
+ *
+ * All entity-display organisms (DataTable, List, Table, CardGrid, DetailPanel)
+ * extend EntityDisplayProps to guarantee a uniform prop contract.
+ *
+ * Exception: Form manages local `formData` state for field input tracking.
+ * This is the ONE allowed exception — documented here.
+ */
+
+declare const EntityDisplayEvents: {
+    readonly SORT: "SORT";
+    readonly PAGINATE: "PAGINATE";
+    readonly SEARCH: "SEARCH";
+    readonly FILTER: "FILTER";
+    readonly CLEAR_FILTERS: "CLEAR_FILTERS";
+    readonly SELECT: "SELECT";
+    readonly DESELECT: "DESELECT";
+};
+interface SortPayload {
+    field: string;
+    direction: 'asc' | 'desc';
+}
+interface PaginatePayload {
+    page: number;
+    pageSize?: number;
+}
+interface SearchPayload {
+    query: string;
+}
+interface FilterPayload {
+    field: string;
+    operator: string;
+    value: FieldValue;
+}
+interface SelectPayload {
+    ids: (string | number)[];
+}
+/**
+ * Common non-entity display state shared by every display organism — loading,
+ * error, and the render-ui display hints (sort/search/pagination/selection).
+ * Carries NO entity data and NO generic. Components that show entity data add
+ * their own `entity?: EntityRow | readonly EntityRow[]` field directly (the one
+ * unified entity type from `@almadar/core`); components that only need the
+ * loading/hint surface just extend this.
+ */
+interface DisplayStateProps {
+    /** Additional CSS classes */
+    className?: string;
+    /** Loading state indicator */
+    isLoading?: boolean;
+    /** Error state */
+    error?: UiError | null;
+    /** Current sort field */
+    sortBy?: string;
+    /** Current sort direction */
+    sortDirection?: 'asc' | 'desc';
+    /** Current search query value */
+    searchValue?: string;
+    /** Current page number (1-indexed) */
+    page?: number;
+    /** Number of items per page */
+    pageSize?: number;
+    /** Total number of items (for pagination display) */
+    totalCount?: number;
+    /**
+     * Active filters, keyed by field name. Scalar-only (`string | number |
+     * boolean`) rather than the full `FieldValue` domain: `FieldValue` is a
+     * self-referential union (adds `Date`, nested arrays/objects) the
+     * pattern-sync scanner can't shape into a `Map string V` knob, so it always
+     * degraded to `json`. This narrows out date/array/nested-object filter
+     * values — no current call site in this package constructs this prop, so
+     * nothing here breaks, but a caller wiring a date-range or multi-select
+     * filter through this prop would need those. Flagged for the coordinator;
+     * revert to `Record<string, FieldValue>` if that capability is needed.
+     */
+    activeFilters?: Record<string, string | number | boolean>;
+    /** Currently selected item IDs */
+    selectedIds?: readonly (string | number)[];
+}
+
 interface FormSectionProps extends Omit<DisplayStateProps, keyof A11yProps>, A11yProps {
     /** Section title */
     title?: string;
@@ -10043,6 +10438,45 @@ interface StateMachineViewProps extends Omit<AvlStateMachineProps, 'trait'> {
     trait?: TraitLevelData;
     /** A described trait (`behavior/describe`), drawn from its machine when no `trait` is given. */
     description?: TraitDescription | null;
+    /** A whole mounted orbital (`program/self { mounted: true }`): every trait drawn as nested boxes on one canvas, instead of a single trait.
+     * @example {"page":"/orders","traits":[{"trait":"OrderPage","orbital":"Orders","parent":null,"depth":0,"embeddedIn":[],"renders":true,"linked":false,"stepsIn":"browser","linkedEntity":"Order","states":[{"name":"browsing","isInitial":true,"isTerminal":false},{"name":"editing","isInitial":false,"isTerminal":false}],"transitions":[{"index":0,"from":["browsing"],"to":"editing","event":"EDIT","guarded":false,"emits":[]},{"index":1,"from":["editing"],"to":"browsing","event":"CANCEL","guarded":false,"emits":[]}],"emits":[],"listens":[],"instances":[]}],"wires":[]}
+     */
+    orbital?: MountedOrbital | null;
+    /** Current state per trait in orbital mode; a trait without an entry shows the states of its running instances. @default []
+     * @example [{"trait":"OrderPage","state":"browsing"}]
+     */
+    activeStates?: {
+        trait: string;
+        state: string;
+    }[];
+    /** The last fired transition in orbital mode: its trait and the transition `index`. @default null
+     * @example {"trait":"OrderPage","index":0}
+     */
+    firedTransition?: {
+        trait: string;
+        index: number;
+    } | null;
+    /** Orbital mode: the transitions the last dispatch fired, in order, drawn as one numbered route for a moment, then faded. @default []
+     * @example [{"trait":"OrderPage","index":0}]
+     */
+    route?: {
+        trait: string;
+        index: number;
+    }[];
+    /** Orbital mode: boxes at a trait depth below this draw their own machine (when they have more than one state). @default 2 */
+    expandDepth?: number;
+    /** Orbital mode: the trait whose box is marked as chosen. @default "" */
+    selectedTrait?: string;
+    /** Orbital mode: emitted with the trait's name when a box is chosen. */
+    selectEvent?: EventEmit<{
+        trait: string;
+    }>;
+    /** Orbital mode: shows the inspect toggle; emitted with the trait picked from its output on the page. */
+    pickEvent?: EventEmit<{
+        trait: string;
+    }>;
+    /** Orbital mode: the canvas scrolls inside this height. @default "calc(100vh - 9rem)" */
+    maxHeight?: string;
     /** Loading state indicator */
     isLoading?: boolean;
     /** Error state */
@@ -10206,7 +10640,7 @@ declare const TabbedContainer: React__default.FC<TabbedContainerProps>;
  * collapsible right secondary sidebar. Resizable boundaries are delegated to
  * SplitPane (same directory) — DockLayout owns no drag/resize math itself.
  *
- * sidebarWidth/bottomPanelHeight are SplitPane ratio values (0-100), not
+ * sidebarWidth/secondarySidebarWidth/bottomPanelHeight are SplitPane ratio values (0-100), not
  * pixels: they pass straight through to SplitPane's `ratio` contract so the
  * boundary math stays owned by SplitPane.
  *
@@ -10253,8 +10687,12 @@ interface DockLayoutProps extends Omit<React__default.AriaAttributes, keyof A11y
     secondarySidebar?: React__default.ReactNode;
     /** Width of `rail` in pixels; the rail sizes the column itself when omitted. */
     railWidth?: number;
-    /** Width of `secondarySidebar` in pixels (fixed — not resizable). @default 280 */
+    /** Right sidebar size as a SplitPane ratio (0-100, percentage of the main/right-sidebar split). @default 25 */
     secondarySidebarWidth?: number;
+    /** @notification */
+    onSecondarySidebarWidthChange?: (width: number) => void;
+    /** Minimum right sidebar size in pixels, forwarded to SplitPane's `minSize`. @default 240 */
+    secondarySidebarMinSize?: number;
     /** Whether `sidebar` is collapsed (controlled; the layout keeps its own state when omitted). */
     sidebarCollapsed?: boolean;
     /** @notification */
@@ -10281,6 +10719,14 @@ interface DockLayoutProps extends Omit<React__default.AriaAttributes, keyof A11y
     onSecondarySidebarCollapsedChange?: (collapsed: boolean) => void;
     /** The mobile variant; decided by the viewport (narrower than 1024px) when omitted. */
     compact?: boolean;
+    /** Compact: accessible name for the button that opens the menu. */
+    openMenuLabel?: string;
+    /** Compact: accessible name for the button returning to the menu. */
+    backToMenuLabel?: string;
+    /** Compact: title of the menu drawer. */
+    menuLabel?: string;
+    /** Compact: accessible name for each drawer close button. */
+    closeDrawerLabel?: string;
     /** Compact: the top-bar button that opens `secondarySidebar` (e.g. "Inspector", "Chat"). */
     secondarySidebarLabel?: string;
     secondarySidebarIcon?: IconInput;
@@ -10451,6 +10897,8 @@ interface UISlotRendererProps {
      * claims the transition so its chrome stays still.
      */
     pageKey?: string;
+    /** Already-rendered content for the main slot (a guest view's page-root paint); the other slots read the provider as usual. */
+    main?: React__default.ReactNode;
 }
 /**
  * Main UI Slot Renderer component.
@@ -10468,7 +10916,7 @@ interface UISlotRendererProps {
  * }
  * ```
  */
-declare function UISlotRenderer({ includeHud, hudMode, includeFloating, className, suspense, pageKey, }: UISlotRendererProps): React__default.ReactElement;
+declare function UISlotRenderer({ includeHud, hudMode, includeFloating, className, suspense, pageKey, main, }: UISlotRendererProps): React__default.ReactElement;
 declare namespace UISlotRenderer {
     var displayName: string;
 }
@@ -10674,6 +11122,8 @@ interface MachinePanelProps {
     transitions: readonly TransitionTrace[];
     /** Without it the panel draws the machine alone. */
     describe?: DescribeTrait;
+    /** Already described trait sources, keyed by `<behavior>.traits.<trait>` for a serialized program view. */
+    descriptions?: Readonly<Record<string, TraitDescription>>;
     /** The program's behavior, naming the traits it authors itself; an imported trait carries its own. */
     behavior?: string;
     /** How long a replay shows each hop. */
@@ -10681,7 +11131,7 @@ interface MachinePanelProps {
     /** The program's imports (`behavior/dependencies`), placing each composed unit in its layer. */
     dependencies?: DependencyGraph;
 }
-declare function MachinePanel({ schema, transitions, describe, behavior, replayStepMs, dependencies }: MachinePanelProps): React$1.ReactElement;
+declare function MachinePanel({ schema, transitions, describe, descriptions, behavior, replayStepMs, dependencies }: MachinePanelProps): React$1.ReactElement;
 declare namespace MachinePanel {
     var displayName: string;
 }
@@ -10905,7 +11355,7 @@ interface TopBarAction {
      *  `navigatesTo`. At least one of the two should be set; an entry with
      *  neither renders an inert button. */
     event?: EventKey;
-    /** Destination URL. Emits `UI:NAVIGATE` on click, the same mechanism
+    /** Destination URL. Navigates through the nav stack on click, the same mechanism
      *  `ButtonGroup` / `PageHeader` / `DocumentViewer` already use for their
      *  action descriptors — the top bar was the odd one out, which forced a
      *  navigation-only button to invent an event nothing listens for. Set
@@ -10988,7 +11438,7 @@ interface DashboardLayoutProps {
      *  works inside the embedded playground where `pathname` would be
      *  the studio route. */
     currentPath?: string;
-    /** The trait's reaction to Sign out; the host ends the session through `UI:SIGN_OUT` either way. */
+    /** The trait's reaction to Sign out; the program ends the session with `(auth/sign-out)` in its arm for the event. */
     onSignOut?: () => void;
     /** Layout mode. Default `"sidebar"`.
      *  - `sidebar`: Left sidebar nav + top header (classic dashboard)
@@ -11089,5 +11539,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, 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, 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 };