@almadar/ui 5.147.0 → 5.149.0

package/dist/lib/drawable/three/index.cjs

@@ -1556,27 +1556,30 @@ function Mesh3D({
   ] });
 }
 function Drawable3D({ node, projector, groupOpacity = 1 }) {
-  switch (node.type) {
-    case "draw-sprite":
-      return /* @__PURE__ */ jsxRuntime.jsx(Sprite3D, { node, projector, groupOpacity });
-    case "draw-shape":
-      return /* @__PURE__ */ jsxRuntime.jsx(Shape3D, { node, projector, groupOpacity });
-    case "draw-text":
-      return /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node, projector, groupOpacity });
-    case "draw-mesh":
-      return /* @__PURE__ */ jsxRuntime.jsx(Mesh3D, { node, projector, groupOpacity });
-    case "draw-sprite-layer":
-      return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Sprite3D, { node: item, projector, groupOpacity }, i)) });
-    case "draw-shape-layer":
-      return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Shape3D, { node: item, projector, groupOpacity }, i)) });
-    case "draw-text-layer":
-      return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node: item, projector, groupOpacity }, i)) });
-    case "draw-group": {
-      if (!isValidScenePos(node.position) || !Array.isArray(node.items)) return null;
-      if (node.clip) warnUnsupported3d("draw-group:clip");
-      return /* @__PURE__ */ jsxRuntime.jsx(Group3D, { node, projector, groupOpacity });
+  const rendered = (() => {
+    switch (node.type) {
+      case "draw-sprite":
+        return /* @__PURE__ */ jsxRuntime.jsx(Sprite3D, { node, projector, groupOpacity });
+      case "draw-shape":
+        return /* @__PURE__ */ jsxRuntime.jsx(Shape3D, { node, projector, groupOpacity });
+      case "draw-text":
+        return /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node, projector, groupOpacity });
+      case "draw-mesh":
+        return /* @__PURE__ */ jsxRuntime.jsx(Mesh3D, { node, projector, groupOpacity });
+      case "draw-sprite-layer":
+        return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Sprite3D, { node: item, projector, groupOpacity }, i)) });
+      case "draw-shape-layer":
+        return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Shape3D, { node: item, projector, groupOpacity }, i)) });
+      case "draw-text-layer":
+        return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsxRuntime.jsx(Text3D, { node: item, projector, groupOpacity }, i)) });
+      case "draw-group": {
+        if (!isValidScenePos(node.position) || !Array.isArray(node.items)) return null;
+        if (node.clip) warnUnsupported3d("draw-group:clip");
+        return /* @__PURE__ */ jsxRuntime.jsx(Group3D, { node, projector, groupOpacity });
+      }
     }
-  }
+  })();
+  return node.id ? /* @__PURE__ */ jsxRuntime.jsx("group", { userData: { drawableId: node.id }, children: rendered }) : rendered;
 }
 function Group3D({
   node,
@@ -1639,14 +1642,15 @@ function CameraPose({
   controls
 }) {
   const camera = fiber.useThree((s) => s.camera);
+  const [px, py, pz] = position;
   React3.useEffect(() => {
-    camera.position.set(position[0], position[1], position[2]);
+    camera.position.set(px, py, pz);
     if (camera.isPerspectiveCamera) {
       camera.fov = fov;
       camera.updateProjectionMatrix();
     }
     controls.current?.update();
-  }, [camera, position, fov, controls]);
+  }, [camera, px, py, pz, fov, controls]);
   return null;
 }
 function RoomEnvironment3D() {
@@ -1689,6 +1693,9 @@ var Canvas3DHost = React3.forwardRef(
     pixelsPerUnit,
     fov,
     azimuth,
+    elevation,
+    zoom,
+    controlsEnabled = true,
     lighting,
     post,
     children,
@@ -1820,7 +1827,7 @@ var Canvas3DHost = React3.forwardRef(
       );
       const cx = cameraTarget[0];
       const cz = cameraTarget[2];
-      const d = size * 1;
+      const d = size * 1 / (zoom !== void 0 && zoom > 0 ? zoom : 1);
       const fovDeg = fov ?? 45;
       const base = (() => {
         switch (cameraMode) {
@@ -1833,8 +1840,11 @@ var Canvas3DHost = React3.forwardRef(
           case "follow":
             return { position: [cx, d * 0.5, cz + d], fov: fovDeg };
           case "perspective":
-          default:
-            return { position: [cx + d, d, cz + d], fov: fovDeg };
+          default: {
+            if (elevation === void 0) return { position: [cx + d, d, cz + d], fov: fovDeg };
+            const el = Math.min(Math.max(elevation, 0), Math.PI / 2 - 0.1);
+            return { position: [cx + d, d * Math.tan(el), cz + d], fov: fovDeg };
+          }
         }
       })();
       if (!azimuth) return base;
@@ -1843,7 +1853,7 @@ var Canvas3DHost = React3.forwardRef(
       const c = Math.cos(azimuth);
       const s = Math.sin(azimuth);
       return { position: [cx + ox * c - oz * s, base.position[1], cz + ox * s + oz * c], fov: base.fov };
-    }, [cameraMode, gridBounds, cellSize, cameraTarget, fov, azimuth]);
+    }, [cameraMode, gridBounds, cellSize, cameraTarget, fov, azimuth, elevation, zoom]);
     const followWorld = React3.useMemo(() => {
       if (followTarget) return drawableProjector.toWorld(followTarget);
       return cameraTarget;
@@ -1866,6 +1876,23 @@ var Canvas3DHost = React3.forwardRef(
         eventBus.emit(`UI:${tileClickEvent}`, { x: cell.x, z: cell.y });
       }
     }, [tileClickEvent, unitClickEvent, gridConfig, gridBounds, hitIndex, eventBus]);
+    const handleDrawableClick = React3.useCallback((e) => {
+      if (!unitClickEvent) return;
+      let obj = e.object;
+      while (obj) {
+        const id = obj.userData.drawableId;
+        if (id !== void 0) {
+          e.stopPropagation();
+          eventBus.emit(`UI:${unitClickEvent}`, {
+            unitId: id,
+            x: e.point.x / gridConfig.cellSize + gridBounds.minX,
+            z: e.point.z / gridConfig.cellSize + gridBounds.minZ
+          });
+          return;
+        }
+        obj = obj.parent;
+      }
+    }, [unitClickEvent, gridConfig, gridBounds, eventBus]);
     if (externalLoading) {
       return /* @__PURE__ */ jsxRuntime.jsx(
         Canvas3DLoadingState,
@@ -1919,7 +1946,7 @@ var Canvas3DHost = React3.forwardRef(
                 },
                 children: [
                   /* @__PURE__ */ jsxRuntime.jsx(CameraController3D, { onCameraChange: eventHandlers.handleCameraChange }),
-                  /* @__PURE__ */ jsxRuntime.jsx(CameraPose, { position: cameraConfig.position, fov: cameraConfig.fov, controls: controlsRef }),
+                  cameraMode !== "follow" && cameraMode !== "chase" && /* @__PURE__ */ jsxRuntime.jsx(CameraPose, { position: cameraConfig.position, fov: cameraConfig.fov, controls: controlsRef }),
                   (cameraMode === "follow" || cameraMode === "chase") && /* @__PURE__ */ jsxRuntime.jsx(FollowCamera3D, { target: followWorld, offset: followOffset }),
                   /* @__PURE__ */ jsxRuntime.jsx(
                     Lighting3D,
@@ -1964,7 +1991,7 @@ var Canvas3DHost = React3.forwardRef(
                       fadeStrength: 1
                     }
                   ),
-                  allDrawables.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(BoneRegistryContext.Provider, { value: boneStore, children: /* @__PURE__ */ jsxRuntime.jsx("group", { children: allDrawables.map((node, i) => /* @__PURE__ */ jsxRuntime.jsx(Drawable3D, { node, projector: drawableProjector }, i)) }) }),
+                  allDrawables.length > 0 && /* @__PURE__ */ jsxRuntime.jsx(BoneRegistryContext.Provider, { value: boneStore, children: /* @__PURE__ */ jsxRuntime.jsx("group", { onClick: unitClickEvent ? handleDrawableClick : void 0, children: allDrawables.map((node, i) => /* @__PURE__ */ jsxRuntime.jsx(Drawable3D, { node, projector: drawableProjector }, i)) }) }),
                   (tileClickEvent || unitClickEvent) && /* @__PURE__ */ jsxRuntime.jsxs(
                     "mesh",
                     {
@@ -1994,7 +2021,7 @@ var Canvas3DHost = React3.forwardRef(
                     drei.OrbitControls,
                     {
                       ref: controlsRef,
-                      enabled: cameraMode !== "follow" && cameraMode !== "chase",
+                      enabled: controlsEnabled && cameraMode !== "follow" && cameraMode !== "chase",
                       target: cameraTarget,
                       enableDamping: true,
                       dampingFactor: 0.05,

package/dist/lib/drawable/three/index.d.cts

@@ -1,12 +1,13 @@
-import { C as CanvasPointLightConfig, I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-DVmrgdwc.cjs';
-export { d as Canvas3DHost, e as Canvas3DHostHandle, f as Canvas3DHostProps, d as GameCanvas3D, U as UnitAnimationState } from '../../../avl-schema-parser-DVmrgdwc.cjs';
+import { C as CanvasPointLightConfig, I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-CVzkNzg7.cjs';
+export { d as Canvas3DHost, e as Canvas3DHostHandle, f as Canvas3DHostProps, d as GameCanvas3D, U as UnitAnimationState } from '../../../avl-schema-parser-CVzkNzg7.cjs';
 import * as React$1 from 'react';
 import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import * as THREE from 'three';
 import { QuadraticBezierCurve3 } from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { JsonObject, EventEmit, OrbitalSchema } from '@almadar/core';
-import '../../../paintDispatch-Cb_hQj4Y.cjs';
+import '../../../paintDispatch-BjZjUbcb.cjs';
+import '../../../types-B3nHgnMG.cjs';
 
 /**
  * Scene3D

package/dist/lib/drawable/three/index.d.ts

@@ -1,12 +1,13 @@
-import { C as CanvasPointLightConfig, I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-BRJ77Yze.js';
-export { d as Canvas3DHost, e as Canvas3DHostHandle, f as Canvas3DHostProps, d as GameCanvas3D, U as UnitAnimationState } from '../../../avl-schema-parser-BRJ77Yze.js';
+import { C as CanvasPointLightConfig, I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-Cx_4SVg9.js';
+export { d as Canvas3DHost, e as Canvas3DHostHandle, f as Canvas3DHostProps, d as GameCanvas3D, U as UnitAnimationState } from '../../../avl-schema-parser-Cx_4SVg9.js';
 import * as React$1 from 'react';
 import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import * as THREE from 'three';
 import { QuadraticBezierCurve3 } from 'three';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { JsonObject, EventEmit, OrbitalSchema } from '@almadar/core';
-import '../../../paintDispatch-Cb_hQj4Y.js';
+import '../../../paintDispatch-CxdLjHQq.js';
+import '../../../types-B3nHgnMG.js';
 
 /**
  * Scene3D

package/dist/lib/drawable/three/index.js

@@ -1532,27 +1532,30 @@ function Mesh3D({
   ] });
 }
 function Drawable3D({ node, projector, groupOpacity = 1 }) {
-  switch (node.type) {
-    case "draw-sprite":
-      return /* @__PURE__ */ jsx(Sprite3D, { node, projector, groupOpacity });
-    case "draw-shape":
-      return /* @__PURE__ */ jsx(Shape3D, { node, projector, groupOpacity });
-    case "draw-text":
-      return /* @__PURE__ */ jsx(Text3D, { node, projector, groupOpacity });
-    case "draw-mesh":
-      return /* @__PURE__ */ jsx(Mesh3D, { node, projector, groupOpacity });
-    case "draw-sprite-layer":
-      return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Sprite3D, { node: item, projector, groupOpacity }, i)) });
-    case "draw-shape-layer":
-      return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Shape3D, { node: item, projector, groupOpacity }, i)) });
-    case "draw-text-layer":
-      return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Text3D, { node: item, projector, groupOpacity }, i)) });
-    case "draw-group": {
-      if (!isValidScenePos(node.position) || !Array.isArray(node.items)) return null;
-      if (node.clip) warnUnsupported3d("draw-group:clip");
-      return /* @__PURE__ */ jsx(Group3D, { node, projector, groupOpacity });
+  const rendered = (() => {
+    switch (node.type) {
+      case "draw-sprite":
+        return /* @__PURE__ */ jsx(Sprite3D, { node, projector, groupOpacity });
+      case "draw-shape":
+        return /* @__PURE__ */ jsx(Shape3D, { node, projector, groupOpacity });
+      case "draw-text":
+        return /* @__PURE__ */ jsx(Text3D, { node, projector, groupOpacity });
+      case "draw-mesh":
+        return /* @__PURE__ */ jsx(Mesh3D, { node, projector, groupOpacity });
+      case "draw-sprite-layer":
+        return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Sprite3D, { node: item, projector, groupOpacity }, i)) });
+      case "draw-shape-layer":
+        return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Shape3D, { node: item, projector, groupOpacity }, i)) });
+      case "draw-text-layer":
+        return /* @__PURE__ */ jsx(Fragment, { children: node.items.map((item, i) => /* @__PURE__ */ jsx(Text3D, { node: item, projector, groupOpacity }, i)) });
+      case "draw-group": {
+        if (!isValidScenePos(node.position) || !Array.isArray(node.items)) return null;
+        if (node.clip) warnUnsupported3d("draw-group:clip");
+        return /* @__PURE__ */ jsx(Group3D, { node, projector, groupOpacity });
+      }
     }
-  }
+  })();
+  return node.id ? /* @__PURE__ */ jsx("group", { userData: { drawableId: node.id }, children: rendered }) : rendered;
 }
 function Group3D({
   node,
@@ -1615,14 +1618,15 @@ function CameraPose({
   controls
 }) {
   const camera = useThree((s) => s.camera);
+  const [px, py, pz] = position;
   useEffect(() => {
-    camera.position.set(position[0], position[1], position[2]);
+    camera.position.set(px, py, pz);
     if (camera.isPerspectiveCamera) {
       camera.fov = fov;
       camera.updateProjectionMatrix();
     }
     controls.current?.update();
-  }, [camera, position, fov, controls]);
+  }, [camera, px, py, pz, fov, controls]);
   return null;
 }
 function RoomEnvironment3D() {
@@ -1665,6 +1669,9 @@ var Canvas3DHost = forwardRef(
     pixelsPerUnit,
     fov,
     azimuth,
+    elevation,
+    zoom,
+    controlsEnabled = true,
     lighting,
     post,
     children,
@@ -1796,7 +1803,7 @@ var Canvas3DHost = forwardRef(
       );
       const cx = cameraTarget[0];
       const cz = cameraTarget[2];
-      const d = size * 1;
+      const d = size * 1 / (zoom !== void 0 && zoom > 0 ? zoom : 1);
       const fovDeg = fov ?? 45;
       const base = (() => {
         switch (cameraMode) {
@@ -1809,8 +1816,11 @@ var Canvas3DHost = forwardRef(
           case "follow":
             return { position: [cx, d * 0.5, cz + d], fov: fovDeg };
           case "perspective":
-          default:
-            return { position: [cx + d, d, cz + d], fov: fovDeg };
+          default: {
+            if (elevation === void 0) return { position: [cx + d, d, cz + d], fov: fovDeg };
+            const el = Math.min(Math.max(elevation, 0), Math.PI / 2 - 0.1);
+            return { position: [cx + d, d * Math.tan(el), cz + d], fov: fovDeg };
+          }
         }
       })();
       if (!azimuth) return base;
@@ -1819,7 +1829,7 @@ var Canvas3DHost = forwardRef(
       const c = Math.cos(azimuth);
       const s = Math.sin(azimuth);
       return { position: [cx + ox * c - oz * s, base.position[1], cz + ox * s + oz * c], fov: base.fov };
-    }, [cameraMode, gridBounds, cellSize, cameraTarget, fov, azimuth]);
+    }, [cameraMode, gridBounds, cellSize, cameraTarget, fov, azimuth, elevation, zoom]);
     const followWorld = useMemo(() => {
       if (followTarget) return drawableProjector.toWorld(followTarget);
       return cameraTarget;
@@ -1842,6 +1852,23 @@ var Canvas3DHost = forwardRef(
         eventBus.emit(`UI:${tileClickEvent}`, { x: cell.x, z: cell.y });
       }
     }, [tileClickEvent, unitClickEvent, gridConfig, gridBounds, hitIndex, eventBus]);
+    const handleDrawableClick = useCallback((e) => {
+      if (!unitClickEvent) return;
+      let obj = e.object;
+      while (obj) {
+        const id = obj.userData.drawableId;
+        if (id !== void 0) {
+          e.stopPropagation();
+          eventBus.emit(`UI:${unitClickEvent}`, {
+            unitId: id,
+            x: e.point.x / gridConfig.cellSize + gridBounds.minX,
+            z: e.point.z / gridConfig.cellSize + gridBounds.minZ
+          });
+          return;
+        }
+        obj = obj.parent;
+      }
+    }, [unitClickEvent, gridConfig, gridBounds, eventBus]);
     if (externalLoading) {
       return /* @__PURE__ */ jsx(
         Canvas3DLoadingState,
@@ -1895,7 +1922,7 @@ var Canvas3DHost = forwardRef(
                 },
                 children: [
                   /* @__PURE__ */ jsx(CameraController3D, { onCameraChange: eventHandlers.handleCameraChange }),
-                  /* @__PURE__ */ jsx(CameraPose, { position: cameraConfig.position, fov: cameraConfig.fov, controls: controlsRef }),
+                  cameraMode !== "follow" && cameraMode !== "chase" && /* @__PURE__ */ jsx(CameraPose, { position: cameraConfig.position, fov: cameraConfig.fov, controls: controlsRef }),
                   (cameraMode === "follow" || cameraMode === "chase") && /* @__PURE__ */ jsx(FollowCamera3D, { target: followWorld, offset: followOffset }),
                   /* @__PURE__ */ jsx(
                     Lighting3D,
@@ -1940,7 +1967,7 @@ var Canvas3DHost = forwardRef(
                       fadeStrength: 1
                     }
                   ),
-                  allDrawables.length > 0 && /* @__PURE__ */ jsx(BoneRegistryContext.Provider, { value: boneStore, children: /* @__PURE__ */ jsx("group", { children: allDrawables.map((node, i) => /* @__PURE__ */ jsx(Drawable3D, { node, projector: drawableProjector }, i)) }) }),
+                  allDrawables.length > 0 && /* @__PURE__ */ jsx(BoneRegistryContext.Provider, { value: boneStore, children: /* @__PURE__ */ jsx("group", { onClick: unitClickEvent ? handleDrawableClick : void 0, children: allDrawables.map((node, i) => /* @__PURE__ */ jsx(Drawable3D, { node, projector: drawableProjector }, i)) }) }),
                   (tileClickEvent || unitClickEvent) && /* @__PURE__ */ jsxs(
                     "mesh",
                     {
@@ -1970,7 +1997,7 @@ var Canvas3DHost = forwardRef(
                     OrbitControls,
                     {
                       ref: controlsRef,
-                      enabled: cameraMode !== "follow" && cameraMode !== "chase",
+                      enabled: controlsEnabled && cameraMode !== "follow" && cameraMode !== "chase",
                       target: cameraTarget,
                       enableDamping: true,
                       dampingFactor: 0.05,

package/dist/lib/index.d.cts

@@ -1,8 +1,9 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, L as LessonSegment, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseLessonSegments, B as parseMarkdownWithCodeBlocks, F as recordServerResponse, G as recordTransition, H as registerCheck, I as registerTraitSnapshot, J as renderStateMachineToDomData, K as renderStateMachineToSvg, M as subscribeToVerification, N as updateAssetStatus, O as updateBridgeHealth, P as updateCheck, Q as waitForTransition } from '../cn-BAn68sNO.cjs';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, L as LessonSegment, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseLessonSegments, B as parseMarkdownWithCodeBlocks, F as recordServerResponse, G as recordTransition, H as registerCheck, I as registerTraitSnapshot, J as renderStateMachineToDomData, K as renderStateMachineToSvg, M as subscribeToVerification, N as updateAssetStatus, O as updateBridgeHealth, P as updateCheck, Q as waitForTransition } from '../cn-BnAJZcNb.cjs';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
 import 'react';
-import '../paintDispatch-Cb_hQj4Y.cjs';
+import '../paintDispatch-BjZjUbcb.cjs';
+import '../types-B3nHgnMG.cjs';
 import 'clsx';
 
 /**

package/dist/lib/index.d.ts

@@ -1,8 +1,9 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, L as LessonSegment, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseLessonSegments, B as parseMarkdownWithCodeBlocks, F as recordServerResponse, G as recordTransition, H as registerCheck, I as registerTraitSnapshot, J as renderStateMachineToDomData, K as renderStateMachineToSvg, M as subscribeToVerification, N as updateAssetStatus, O as updateBridgeHealth, P as updateCheck, Q as waitForTransition } from '../cn-CWxxLkri.js';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, L as LessonSegment, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseLessonSegments, B as parseMarkdownWithCodeBlocks, F as recordServerResponse, G as recordTransition, H as registerCheck, I as registerTraitSnapshot, J as renderStateMachineToDomData, K as renderStateMachineToSvg, M as subscribeToVerification, N as updateAssetStatus, O as updateBridgeHealth, P as updateCheck, Q as waitForTransition } from '../cn-DJTUjk1M.js';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
 import 'react';
-import '../paintDispatch-Cb_hQj4Y.js';
+import '../paintDispatch-CxdLjHQq.js';
+import '../types-B3nHgnMG.js';
 import 'clsx';
 
 /**

package/dist/{paintDispatch-Cb_hQj4Y.d.ts → paintDispatch-BjZjUbcb.d.cts}

@@ -1,22 +1,6 @@
 import { ScenePos, Asset } from '@almadar/core';
+import { P as Point, R as Rect } from './types-B3nHgnMG.cjs';
 
-/** Source sub-rectangle within a texture (an atlas frame). Omitted → whole texture. */
-interface BlitSrc {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
-/** A polyline/polygon vertex in pixel space. */
-interface PainterPoint {
-    x: number;
-    y: number;
-}
-/** A drop shadow applied to subsequent draws until cleared. */
-interface PainterShadow {
-    color: string;
-    blur: number;
-}
 /** One color stop of a {@link PainterGradient}; `offset` is 0..1 along the gradient. */
 interface PainterGradientStop {
     offset: number;
@@ -57,50 +41,6 @@ interface DrawableBase {
     id?: string;
 }
 
-/**
- * `draw-sprite` — the neutral image/atlas-frame drawable atom (dimension-agnostic).
- *
- * ONE descriptor (`DrawSpriteProps`, grounded in core `ScenePos` + `Asset`) with
- * TWO backends: `paintSprite` (2D, here — via the portable `Painter2D` seam) and
- * an R3F mesh (`Sprite3D` in `lib/drawable/mesh3d`, kept OUT of this file so the
- * 2D paint path never pulls `three`/`drei` into an app bundle — the codebase
- * code-splits R3F). The canvas host picks the backend by `mode`; that is what
- * makes canvas-2d and canvas-3d the same `children` interface. Genre uses (tile,
- * unit body, feature, effect, movement ghost, background cover) are all this atom
- * with different `anchor`/`size`/`frame`/`flip`/`shadow` — composed in `.lolo`,
- * not here. The React component renders `null` (a drawable is painted by the host,
- * not the DOM); it exists so the pattern pipeline registers a `draw-sprite`
- * pattern and standalone pages stay inspectable.
- */
-
-interface DrawSpriteProps extends DrawableBase {
-    type: 'draw-sprite';
-    /** Logical scene position; the projector maps it to pixels / world. */
-    position: ScenePos;
-    /** The image / atlas reference to blit. */
-    asset: Asset;
-    /** How the sprite aligns to its projected position. Default `'top-left'`. */
-    anchor?: DrawableAnchor;
-    /** Draw width in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
-    width?: number;
-    /** Draw height in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
-    height?: number;
-    /** Explicit atlas sub-rect override (px); omitted → resolved from `asset.atlas`/`asset.sprite`. */
-    frame?: BlitSrc;
-    /** Animation to play. 3D backend: a named GLB clip (matched case-insensitively). 2D painter: when `asset.atlas` resolves to a `SpriteSheetAtlas` manifest, the canonical row of that name (idle/walk/attack/hit/death) plays off the host paint clock; an explicit `frame` rect overrides. */
-    animation?: string;
-    /** Override the sheet row's loop flag. The paint clock is wall-time, so one-shot rows hold their final frame — preview pages set `true` to cycle attack/hit/death continuously. */
-    loop?: boolean;
-    /** Mirror horizontally (facing). */
-    flipX?: boolean;
-    /** Rotation in radians about the sprite's center. */
-    rotation?: number;
-    /** 0..1 opacity. */
-    opacity?: number;
-    /** Drop shadow (e.g. a team-colored glow). */
-    shadow?: PainterShadow;
-}
-
 /**
  * `draw-shape` — the neutral vector-fill/stroke drawable atom (dimension-agnostic).
  *
@@ -128,11 +68,11 @@ type DrawShapeGradientStop = PainterGradientStop;
 interface DrawShapeGradient {
     kind: 'linear' | 'radial' | 'conic';
     /** Linear start point in world units. */
-    from?: PainterPoint;
+    from?: Point;
     /** Linear end point in world units. */
-    to?: PainterPoint;
+    to?: Point;
     /** Radial/conic center in world units. */
-    center?: PainterPoint;
+    center?: Point;
     /** Radial radius in world units. */
     radius?: number;
     /** Conic start angle in radians. */
@@ -216,7 +156,7 @@ interface DrawShapeProps extends DrawableBase {
     offsetX?: number;
     offsetY?: number;
     /** Poly vertices as world-unit offsets relative to the cell's projected top-left. */
-    points?: PainterPoint[];
+    points?: Point[];
     /** SVG path data in world units relative to the cell's projected top-left — same coordinate convention as `points`. */
     d?: string;
     fill?: string;
@@ -239,7 +179,7 @@ interface DrawShapeProps extends DrawableBase {
     /** Rotation in radians (painter units, same as `draw-group`), about `pivot`. */
     rotate?: number;
     /** Rotation pivot in world units relative to the cell's projected top-left; default `{x:0.5, y:0.5}` (cell center). */
-    pivot?: PainterPoint;
+    pivot?: Point;
     /** Soft glow / drop-shadow behind the shape; `blur` in world units. */
     shadow?: DrawShapeShadow;
     /** Keyframe animation over this shape's props; the host runs a paint clock while present. */
@@ -248,6 +188,50 @@ interface DrawShapeProps extends DrawableBase {
     opacity?: number;
 }
 
+/**
+ * `draw-sprite` — the neutral image/atlas-frame drawable atom (dimension-agnostic).
+ *
+ * ONE descriptor (`DrawSpriteProps`, grounded in core `ScenePos` + `Asset`) with
+ * TWO backends: `paintSprite` (2D, here — via the portable `Painter2D` seam) and
+ * an R3F mesh (`Sprite3D` in `lib/drawable/mesh3d`, kept OUT of this file so the
+ * 2D paint path never pulls `three`/`drei` into an app bundle — the codebase
+ * code-splits R3F). The canvas host picks the backend by `mode`; that is what
+ * makes canvas-2d and canvas-3d the same `children` interface. Genre uses (tile,
+ * unit body, feature, effect, movement ghost, background cover) are all this atom
+ * with different `anchor`/`size`/`frame`/`flip`/`shadow` — composed in `.lolo`,
+ * not here. The React component renders `null` (a drawable is painted by the host,
+ * not the DOM); it exists so the pattern pipeline registers a `draw-sprite`
+ * pattern and standalone pages stay inspectable.
+ */
+
+interface DrawSpriteProps extends DrawableBase {
+    type: 'draw-sprite';
+    /** Logical scene position; the projector maps it to pixels / world. */
+    position: ScenePos;
+    /** The image / atlas reference to blit. */
+    asset: Asset;
+    /** How the sprite aligns to its projected position. Default `'top-left'`. */
+    anchor?: DrawableAnchor;
+    /** Draw width in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
+    width?: number;
+    /** Draw height in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
+    height?: number;
+    /** Explicit atlas sub-rect override (px); omitted → resolved from `asset.atlas`/`asset.sprite`. */
+    frame?: Rect;
+    /** Animation to play. 3D backend: a named GLB clip (matched case-insensitively). 2D painter: when `asset.atlas` resolves to a `SpriteSheetAtlas` manifest, the canonical row of that name (idle/walk/attack/hit/death) plays off the host paint clock; an explicit `frame` rect overrides. */
+    animation?: string;
+    /** Override the sheet row's loop flag. The paint clock is wall-time, so one-shot rows hold their final frame — preview pages set `true` to cycle attack/hit/death continuously. */
+    loop?: boolean;
+    /** Mirror horizontally (facing). */
+    flipX?: boolean;
+    /** Rotation in radians about the sprite's center. */
+    rotation?: number;
+    /** 0..1 opacity. */
+    opacity?: number;
+    /** Drop shadow (e.g. a team-colored glow). */
+    shadow?: DrawShapeShadow;
+}
+
 /**
  * `draw-text` — the neutral text drawable atom (dimension-agnostic).
  *
@@ -258,6 +242,16 @@ interface DrawShapeProps extends DrawableBase {
  * component renders `null` (a drawable is painted by the host, not the DOM).
  */
 
+/**
+ * Mirrors DOM lib.dom.d.ts `CanvasTextAlign` by value (used directly instead
+ * of the ambient global so the pattern-sync scanner — which only indexes
+ * `components/**` and can't see ambient TS-lib types — resolves this to a
+ * concrete enum instead of `json`). Structurally identical; `node.align`
+ * still flows straight into `Painter2D.text`'s `TextStyle.align`.
+ */
+type DrawTextAlign = 'center' | 'end' | 'left' | 'right' | 'start';
+/** Mirrors DOM `CanvasTextBaseline` by value — see {@link DrawTextAlign}. */
+type DrawTextBaseline = 'alphabetic' | 'bottom' | 'hanging' | 'ideographic' | 'middle' | 'top';
 interface DrawTextProps extends DrawableBase {
     type: 'draw-text';
     text: string;
@@ -268,8 +262,8 @@ interface DrawTextProps extends DrawableBase {
     offsetY?: number;
     color: string;
     font?: string;
-    align?: CanvasTextAlign;
-    baseline?: CanvasTextBaseline;
+    align?: DrawTextAlign;
+    baseline?: DrawTextBaseline;
     opacity?: number;
 }
 
@@ -525,4 +519,4 @@ interface DrawTextLayerProps extends DrawableBase {
 /** Every drawable descriptor. The host's `children` are a `DrawableNode[]`. */
 type DrawableNode = DrawSpriteProps | DrawShapeProps | DrawTextProps | DrawGroupProps | DrawMeshProps | DrawSpriteLayerProps | DrawShapeLayerProps | DrawTextLayerProps;
 
-export type { DrawableNode as D };
+export type { DrawableNode as D, MeshShapeKind as M, MeshMaterial as a, DrawGroupProps as b, DrawTextProps as c, DrawMeshProps as d };