@almadar/ui 5.147.0 → 5.149.0

package/dist/{avl-schema-parser-DVmrgdwc.d.cts → avl-schema-parser-CVzkNzg7.d.cts}

@@ -1,7 +1,7 @@
 import { AnimationName, Asset, ScenePos, EventEmit, JsonObject, JsonValue } from '@almadar/core';
 import React__default from 'react';
 import * as THREE from 'three';
-import { D as DrawableNode } from './paintDispatch-Cb_hQj4Y.cjs';
+import { D as DrawableNode } from './paintDispatch-BjZjUbcb.cjs';
 
 /**
  * Sprite Sheet Animation Types
@@ -307,10 +307,11 @@ interface CameraState {
  * (forwarded as `followTarget`), falling back to the scene centre.
  *
  * Interaction: keyboard maps to semantic events (device-agnostic input). Pointer
- * click/hover on neutral drawables needs a per-entity id + a scene-space raycast
- * the descriptors don't yet carry — that hit-test is a tracked fork
- * (docs/Almadar_Std_Game_V2_PLAN.md); the click/hover event props are accepted but
- * not yet emitted from a raycast.
+ * click on a tagged drawable (a descriptor carrying `DrawableBase.id`) raycasts to
+ * the mesh and walks up to the tagged ancestor → `unitClickEvent {unitId,x,z}`;
+ * a click that hits no tagged mesh falls back to the ground-plane cell raycast →
+ * `tileClickEvent`. Pointer hover/feature events are accepted but not yet
+ * emitted (docs/Almadar_Std_Gaps.md S-CANVAS3D-HOVER-DEAD).
  *
  * @packageDocumentation
  */
@@ -422,8 +423,9 @@ interface Canvas3DHostProps {
         terrain?: string;
         elevation?: number;
     }>;
-    /** Declarative event: unit click. Emitted `{ unitId, x, z }` when the raycast lands on a
-     *  cell whose descriptor carries an `id` (a tagged unit sprite). */
+    /** Declarative event: unit click. Emitted `{ unitId, x, z }` when the raycast hits a
+     *  mesh tagged with a descriptor `id` (or lands on a ground cell whose descriptor
+     *  carries an `id`). */
     unitClickEvent?: EventEmit<{
         unitId: string;
         x: number;
@@ -477,8 +479,12 @@ interface Canvas3DHostProps {
     loadingMessage?: string;
     /** Unit draw-size multiplier (accepted for API parity; sizing is drawable-authored). */
     unitScale?: number;
-    /** Board zoom (accepted for API parity; 3D zoom is camera-driven, not group-scaled). */
-    scale?: number;
+    /** Board zoom — the neutral `Camera.zoom`. Dollies the camera: the framing
+     *  distance is divided by `zoom` (undefined/1 = default framing; <= 0 ignored). */
+    zoom?: number;
+    /** Enable the orbit camera controls. Default true; `follow`/`chase` modes always
+     *  disable them (the follow camera is authoritative). */
+    controlsEnabled?: boolean;
     /** Maps a keydown `e.code` → the board's SEMANTIC event (device-agnostic input). */
     keyMap?: Record<string, string>;
     /** Maps a keyup `e.code` → the board's SEMANTIC event. */
@@ -494,6 +500,9 @@ interface Canvas3DHostProps {
     fov?: number;
     /** Orbit the mode's framing position around the vertical axis through the target, in radians — the neutral `Camera.azimuth`. */
     azimuth?: number;
+    /** Orbit height angle above the ground plane, in radians — the neutral `Camera.elevation`
+     *  (perspective mode). Omitted → the mode's fixed framing height. */
+    elevation?: number;
     /** 3D scene light rig as data — ambient/directional/hemisphere/point lights + optional
      *  'room' environment. Omitted → the standard fixed rig (this host's current
      *  hardcoded lights, unchanged). */

package/dist/{avl-schema-parser-BRJ77Yze.d.ts → avl-schema-parser-Cx_4SVg9.d.ts}

@@ -1,7 +1,7 @@
 import { AnimationName, Asset, ScenePos, EventEmit, JsonObject, JsonValue } from '@almadar/core';
 import React__default from 'react';
 import * as THREE from 'three';
-import { D as DrawableNode } from './paintDispatch-Cb_hQj4Y.js';
+import { D as DrawableNode } from './paintDispatch-CxdLjHQq.js';
 
 /**
  * Sprite Sheet Animation Types
@@ -307,10 +307,11 @@ interface CameraState {
  * (forwarded as `followTarget`), falling back to the scene centre.
  *
  * Interaction: keyboard maps to semantic events (device-agnostic input). Pointer
- * click/hover on neutral drawables needs a per-entity id + a scene-space raycast
- * the descriptors don't yet carry — that hit-test is a tracked fork
- * (docs/Almadar_Std_Game_V2_PLAN.md); the click/hover event props are accepted but
- * not yet emitted from a raycast.
+ * click on a tagged drawable (a descriptor carrying `DrawableBase.id`) raycasts to
+ * the mesh and walks up to the tagged ancestor → `unitClickEvent {unitId,x,z}`;
+ * a click that hits no tagged mesh falls back to the ground-plane cell raycast →
+ * `tileClickEvent`. Pointer hover/feature events are accepted but not yet
+ * emitted (docs/Almadar_Std_Gaps.md S-CANVAS3D-HOVER-DEAD).
  *
  * @packageDocumentation
  */
@@ -422,8 +423,9 @@ interface Canvas3DHostProps {
         terrain?: string;
         elevation?: number;
     }>;
-    /** Declarative event: unit click. Emitted `{ unitId, x, z }` when the raycast lands on a
-     *  cell whose descriptor carries an `id` (a tagged unit sprite). */
+    /** Declarative event: unit click. Emitted `{ unitId, x, z }` when the raycast hits a
+     *  mesh tagged with a descriptor `id` (or lands on a ground cell whose descriptor
+     *  carries an `id`). */
     unitClickEvent?: EventEmit<{
         unitId: string;
         x: number;
@@ -477,8 +479,12 @@ interface Canvas3DHostProps {
     loadingMessage?: string;
     /** Unit draw-size multiplier (accepted for API parity; sizing is drawable-authored). */
     unitScale?: number;
-    /** Board zoom (accepted for API parity; 3D zoom is camera-driven, not group-scaled). */
-    scale?: number;
+    /** Board zoom — the neutral `Camera.zoom`. Dollies the camera: the framing
+     *  distance is divided by `zoom` (undefined/1 = default framing; <= 0 ignored). */
+    zoom?: number;
+    /** Enable the orbit camera controls. Default true; `follow`/`chase` modes always
+     *  disable them (the follow camera is authoritative). */
+    controlsEnabled?: boolean;
     /** Maps a keydown `e.code` → the board's SEMANTIC event (device-agnostic input). */
     keyMap?: Record<string, string>;
     /** Maps a keyup `e.code` → the board's SEMANTIC event. */
@@ -494,6 +500,9 @@ interface Canvas3DHostProps {
     fov?: number;
     /** Orbit the mode's framing position around the vertical axis through the target, in radians — the neutral `Camera.azimuth`. */
     azimuth?: number;
+    /** Orbit height angle above the ground plane, in radians — the neutral `Camera.elevation`
+     *  (perspective mode). Omitted → the mode's fixed framing height. */
+    elevation?: number;
     /** 3D scene light rig as data — ambient/directional/hemisphere/point lights + optional
      *  'room' environment. Omitted → the standard fixed rig (this host's current
      *  hardcoded lights, unchanged). */

package/dist/{cn-BAn68sNO.d.cts → cn-BnAJZcNb.d.cts}

@@ -1,6 +1,6 @@
 import { OrbitalSchema, SExpr, Effect, OrbitalVerificationAPI, TraitStateSnapshot, EventPayload, BusEvent, VerificationCheck, BridgeHealth, VerificationSnapshot, VerificationSummary, TransitionTrace, ServerResponseTrace, CheckStatus, AssetLoadStatus } from '@almadar/core';
 import React__default from 'react';
-import { D as DrawableNode } from './paintDispatch-Cb_hQj4Y.cjs';
+import { D as DrawableNode } from './paintDispatch-BjZjUbcb.cjs';
 import { ClassValue } from 'clsx';
 
 /**
@@ -126,12 +126,6 @@ type LessonSegment = MixedSegment | {
     visualizationType: InteractiveOrbitalType;
     description: string;
 };
-/** User progress state passed into SegmentRenderer. */
-interface LessonUserProgress {
-    activationResponse?: string;
-    reflectionNotes?: string[];
-    bloomAnswered?: Record<number, boolean>;
-}
 /** Parse a lesson string into typed segments. Returns `[]` when input is empty. */
 declare function parseLessonSegments(lesson: string | undefined): LessonSegment[];
 
@@ -382,4 +376,4 @@ declare function clearVerification(): void;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { parseMarkdownWithCodeBlocks as $, parseLessonSegments as A, parseMarkdownWithCodeBlocks$1 as B, type ContentSegment as C, DEFAULT_CONFIG as D, type EntityDefinition as E, recordServerResponse as F, recordTransition as G, registerCheck as H, registerTraitSnapshot as I, renderStateMachineToDomData as J, renderStateMachineToSvg as K, type LessonSegment as L, subscribeToVerification as M, updateAssetStatus as N, updateBridgeHealth as O, updateCheck as P, waitForTransition as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, type LessonUserProgress as U, type VisualizerConfig as V, type InteractiveOrbitalType as W, type BloomLevel as X, BloomQuizBlock as Y, type BloomQuizBlockProps as Z, type MixedSegment as _, type DomEntityBox as a, type DomLayoutData as b, type DomOutputsBox as c, type DomStateNode as d, type DomTransitionLabel as e, type DomTransitionPath as f, type StateMachineDefinition as g, type TransitionDefinition as h, bindCanvasCapture as i, bindEventBus as j, bindLastDrawables as k, bindTraitStateGetter as l, clearVerification as m, cn as n, extractOutputsFromTransitions as o, extractStateMachine as p, formatGuard as q, getAllChecks as r, getBridgeHealth as s, getEffectSummary as t, getSnapshot as u, getSummary as v, getTraitSnapshots as w, getTransitions as x, getTransitionsForTrait as y, parseContentSegments as z };
+export { parseLessonSegments as A, parseMarkdownWithCodeBlocks$1 as B, type ContentSegment as C, DEFAULT_CONFIG as D, type EntityDefinition as E, recordServerResponse as F, recordTransition as G, registerCheck as H, registerTraitSnapshot as I, renderStateMachineToDomData as J, renderStateMachineToSvg as K, type LessonSegment as L, subscribeToVerification as M, updateAssetStatus as N, updateBridgeHealth as O, updateCheck as P, waitForTransition as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, type InteractiveOrbitalType as U, type VisualizerConfig as V, type BloomLevel as W, BloomQuizBlock as X, type BloomQuizBlockProps as Y, type MixedSegment as Z, parseMarkdownWithCodeBlocks as _, type DomEntityBox as a, type DomLayoutData as b, type DomOutputsBox as c, type DomStateNode as d, type DomTransitionLabel as e, type DomTransitionPath as f, type StateMachineDefinition as g, type TransitionDefinition as h, bindCanvasCapture as i, bindEventBus as j, bindLastDrawables as k, bindTraitStateGetter as l, clearVerification as m, cn as n, extractOutputsFromTransitions as o, extractStateMachine as p, formatGuard as q, getAllChecks as r, getBridgeHealth as s, getEffectSummary as t, getSnapshot as u, getSummary as v, getTraitSnapshots as w, getTransitions as x, getTransitionsForTrait as y, parseContentSegments as z };

package/dist/{cn-CWxxLkri.d.ts → cn-DJTUjk1M.d.ts}

@@ -1,6 +1,6 @@
 import { OrbitalSchema, SExpr, Effect, OrbitalVerificationAPI, TraitStateSnapshot, EventPayload, BusEvent, VerificationCheck, BridgeHealth, VerificationSnapshot, VerificationSummary, TransitionTrace, ServerResponseTrace, CheckStatus, AssetLoadStatus } from '@almadar/core';
 import React__default from 'react';
-import { D as DrawableNode } from './paintDispatch-Cb_hQj4Y.js';
+import { D as DrawableNode } from './paintDispatch-CxdLjHQq.js';
 import { ClassValue } from 'clsx';
 
 /**
@@ -126,12 +126,6 @@ type LessonSegment = MixedSegment | {
     visualizationType: InteractiveOrbitalType;
     description: string;
 };
-/** User progress state passed into SegmentRenderer. */
-interface LessonUserProgress {
-    activationResponse?: string;
-    reflectionNotes?: string[];
-    bloomAnswered?: Record<number, boolean>;
-}
 /** Parse a lesson string into typed segments. Returns `[]` when input is empty. */
 declare function parseLessonSegments(lesson: string | undefined): LessonSegment[];
 
@@ -382,4 +376,4 @@ declare function clearVerification(): void;
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { parseMarkdownWithCodeBlocks as $, parseLessonSegments as A, parseMarkdownWithCodeBlocks$1 as B, type ContentSegment as C, DEFAULT_CONFIG as D, type EntityDefinition as E, recordServerResponse as F, recordTransition as G, registerCheck as H, registerTraitSnapshot as I, renderStateMachineToDomData as J, renderStateMachineToSvg as K, type LessonSegment as L, subscribeToVerification as M, updateAssetStatus as N, updateBridgeHealth as O, updateCheck as P, waitForTransition as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, type LessonUserProgress as U, type VisualizerConfig as V, type InteractiveOrbitalType as W, type BloomLevel as X, BloomQuizBlock as Y, type BloomQuizBlockProps as Z, type MixedSegment as _, type DomEntityBox as a, type DomLayoutData as b, type DomOutputsBox as c, type DomStateNode as d, type DomTransitionLabel as e, type DomTransitionPath as f, type StateMachineDefinition as g, type TransitionDefinition as h, bindCanvasCapture as i, bindEventBus as j, bindLastDrawables as k, bindTraitStateGetter as l, clearVerification as m, cn as n, extractOutputsFromTransitions as o, extractStateMachine as p, formatGuard as q, getAllChecks as r, getBridgeHealth as s, getEffectSummary as t, getSnapshot as u, getSummary as v, getTraitSnapshots as w, getTransitions as x, getTransitionsForTrait as y, parseContentSegments as z };
+export { parseLessonSegments as A, parseMarkdownWithCodeBlocks$1 as B, type ContentSegment as C, DEFAULT_CONFIG as D, type EntityDefinition as E, recordServerResponse as F, recordTransition as G, registerCheck as H, registerTraitSnapshot as I, renderStateMachineToDomData as J, renderStateMachineToSvg as K, type LessonSegment as L, subscribeToVerification as M, updateAssetStatus as N, updateBridgeHealth as O, updateCheck as P, waitForTransition as Q, type RenderOptions as R, type StateDefinition as S, type TraitSnapshotGetter as T, type InteractiveOrbitalType as U, type VisualizerConfig as V, type BloomLevel as W, BloomQuizBlock as X, type BloomQuizBlockProps as Y, type MixedSegment as Z, parseMarkdownWithCodeBlocks as _, type DomEntityBox as a, type DomLayoutData as b, type DomOutputsBox as c, type DomStateNode as d, type DomTransitionLabel as e, type DomTransitionPath as f, type StateMachineDefinition as g, type TransitionDefinition as h, bindCanvasCapture as i, bindEventBus as j, bindLastDrawables as k, bindTraitStateGetter as l, clearVerification as m, cn as n, extractOutputsFromTransitions as o, extractStateMachine as p, formatGuard as q, getAllChecks as r, getBridgeHealth as s, getEffectSummary as t, getSnapshot as u, getSummary as v, getTraitSnapshots as w, getTransitions as x, getTransitionsForTrait as y, parseContentSegments as z };