@almadar/ui 5.147.0 → 5.149.0

package/dist/components/index.js

@@ -1,6 +1,6 @@
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import * as React77 from 'react';
-import React77__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, useState, useLayoutEffect, Suspense, useSyncExternalStore, lazy, useId } from 'react';
+import React77__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, useState, useLayoutEffect, useId, Suspense, useSyncExternalStore, lazy } from 'react';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { EventBusContext, useTraitScopeChain, useCurrentPagePath, useGameAudioContextOptional, useEntitySchemaOptional, useEntityBindingSnapshot, useTraitScope, TraitScopeProvider } from '@almadar/ui/providers';
@@ -8615,7 +8615,10 @@ var init_LearningCanvas = __esm({
           ctx.fillRect(0, 0, width, height);
         }
         for (const shape of shapes) {
-          drawShape(ctx, shape, width, height);
+          if (shape.type !== "text") drawShape(ctx, shape, width, height);
+        }
+        for (const shape of shapes) {
+          if (shape.type === "text") drawShape(ctx, shape, width, height);
         }
       }, [width, height, backgroundColor, shapes]);
       useEffect(() => {
@@ -8696,7 +8699,7 @@ var init_AlgorithmCanvas = __esm({
     DEFAULT_CELL_COLOR = "#e5e7eb";
     DEFAULT_POINTER_COLOR = "#dc2626";
     POINTER_BAND = 34;
-    TOP_PAD = 12;
+    TOP_PAD = 26;
     AlgorithmCanvas = ({
       className,
       width = 600,
@@ -9800,23 +9803,188 @@ var init_BehaviorView = __esm({
     BehaviorView.displayName = "BehaviorView";
   }
 });
-var BiologyCanvas;
+function LearningScene3D({
+  className,
+  width = 600,
+  height = 400,
+  title,
+  backgroundColor,
+  drawables,
+  camera,
+  lighting,
+  post,
+  showGrid = false,
+  shadows,
+  interactive,
+  isLoading,
+  error,
+  onItemClick
+}) {
+  const instanceId = useId().replace(/[^a-zA-Z0-9]/g, "");
+  const clickEvent = onItemClick ? `LEARNING_SCENE_3D.ITEM_CLICK.${instanceId}` : void 0;
+  const onItemClickRef = useRef(onItemClick);
+  onItemClickRef.current = onItemClick;
+  useEventListener(`UI:${clickEvent ?? "LEARNING_SCENE_3D.ITEM_CLICK.__disabled"}`, (event) => {
+    const unitId = event.payload?.unitId;
+    if (typeof unitId === "string") onItemClickRef.current?.(unitId);
+  });
+  const props3d = {
+    drawables,
+    isLoading,
+    error: error ? error.message : null,
+    cameraMode: camera?.mode ?? "perspective",
+    ...camera?.zoom !== void 0 ? { zoom: camera.zoom } : {},
+    ...camera?.fov !== void 0 ? { fov: camera.fov } : {},
+    ...camera?.azimuth !== void 0 ? { azimuth: camera.azimuth } : {},
+    ...camera?.elevation !== void 0 ? { elevation: camera.elevation } : {},
+    ...camera?.target !== void 0 ? { followTarget: camera.target } : {},
+    backgroundColor,
+    showGrid,
+    ...shadows !== void 0 ? { shadows } : {},
+    ...interactive !== void 0 ? { controlsEnabled: interactive } : {},
+    lighting,
+    post,
+    ...clickEvent !== void 0 ? { unitClickEvent: clickEvent } : {}
+  };
+  return /* @__PURE__ */ jsx(Card, { className, children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
+    title ? /* @__PURE__ */ jsx(Typography, { variant: "h4", children: title }) : null,
+    /* @__PURE__ */ jsx("div", { style: { width, height, display: "flex" }, children: /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(Canvas3DHost, { ...props3d }) }) })
+  ] }) });
+}
+function meshSphere(id, x, y, z, radius, color, opts) {
+  return {
+    type: "draw-mesh",
+    ...id !== void 0 ? { id } : {},
+    shape: opts?.shape ?? "sphere",
+    position: { x, y, z },
+    radius,
+    pivot: "center",
+    segments: opts?.segments ?? 24,
+    material: { color, ...opts?.material },
+    ...opts?.opacity !== void 0 ? { opacity: opts.opacity } : {}
+  };
+}
+function axisRotation(from, to) {
+  const wx = to[0] - from[0];
+  const wy = to[2] - from[2];
+  const wz = to[1] - from[1];
+  const len = Math.sqrt(wx * wx + wy * wy + wz * wz);
+  const tilt = Math.acos(Math.min(1, Math.max(-1, len > 0 ? wy / len : 1)));
+  return [0, Math.atan2(wz, -wx), tilt];
+}
+function segmentLength(from, to) {
+  const dx = to[0] - from[0];
+  const dy = to[1] - from[1];
+  const dz = to[2] - from[2];
+  return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+function cylinderBetween(from, to, radius, color) {
+  const len = segmentLength(from, to);
+  if (len < 1e-6) return null;
+  return {
+    type: "draw-mesh",
+    shape: "cylinder",
+    position: { x: (from[0] + to[0]) / 2, y: (from[1] + to[1]) / 2, z: (from[2] + to[2]) / 2 },
+    radius,
+    height: len,
+    rotation: axisRotation(from, to),
+    pivot: "center",
+    segments: 12,
+    material: { color }
+  };
+}
+function arrowBetween(from, to, color, shaftRadius = 0.08) {
+  const len = segmentLength(from, to);
+  if (len < 1e-6) return null;
+  const tipLen = Math.min(shaftRadius * 8, len * 0.35);
+  const k = (len - tipLen) / len;
+  const delta = [to[0] - from[0], to[1] - from[1], to[2] - from[2]];
+  const shaftEnd = [delta[0] * k, delta[1] * k, delta[2] * k];
+  const tipStart = shaftEnd;
+  const tipEnd = delta;
+  const shaft = cylinderBetween([0, 0, 0], shaftEnd, shaftRadius, color);
+  const tipLenActual = segmentLength(tipStart, tipEnd);
+  const tip = {
+    type: "draw-mesh",
+    shape: "cone",
+    position: {
+      x: (tipStart[0] + tipEnd[0]) / 2,
+      y: (tipStart[1] + tipEnd[1]) / 2,
+      z: (tipStart[2] + tipEnd[2]) / 2
+    },
+    radius: shaftRadius * 3,
+    height: tipLenActual,
+    rotation: axisRotation(tipStart, tipEnd),
+    pivot: "center",
+    segments: 12,
+    material: { color }
+  };
+  return {
+    type: "draw-group",
+    position: { x: from[0], y: from[1], z: from[2] },
+    items: tipLenActual < 1e-6 ? shaft ? [shaft] : [] : shaft ? [shaft, tip] : [tip]
+  };
+}
+function billboardLabel(text, x, y, z, opts) {
+  return {
+    type: "draw-text",
+    text,
+    position: { x, y, z },
+    color: opts?.color ?? "#111827"
+  };
+}
+function labelColorForBackground(backgroundColor) {
+  const m = /^#(?:([0-9a-f]{3})|([0-9a-f]{6}))$/i.exec(backgroundColor ?? "");
+  if (!m) return "#111827";
+  const hex = m[1] !== void 0 ? m[1].split("").map((c) => c + c).join("") : m[2];
+  const r = parseInt(hex.slice(0, 2), 16) / 255;
+  const g = parseInt(hex.slice(2, 4), 16) / 255;
+  const b = parseInt(hex.slice(4, 6), 16) / 255;
+  const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+  return luminance < 0.5 ? "#e5e7eb" : "#111827";
+}
+function get3DClickPayload(onShapeClick, idToIndex) {
+  if (!onShapeClick) return void 0;
+  return (id) => onShapeClick({ id, index: idToIndex.get(id) ?? -1 });
+}
+var Canvas3DHost;
+var init_learningScene3D = __esm({
+  "components/learning/molecules/learningScene3D.tsx"() {
+    "use client";
+    init_atoms();
+    init_Stack();
+    init_useEventBus();
+    Canvas3DHost = lazy(
+      () => import('@almadar/ui/components/molecules/game/three').then((m) => ({ default: m.Canvas3DHost }))
+    );
+    LearningScene3D.displayName = "LearningScene3D";
+  }
+});
+var biologyLog, BiologyCanvas;
 var init_BiologyCanvas = __esm({
   "components/learning/molecules/BiologyCanvas.tsx"() {
     "use client";
     init_atoms();
     init_Stack();
     init_LearningCanvas();
+    init_learningScene3D();
+    biologyLog = createLogger("almadar:ui:biology-canvas");
     BiologyCanvas = ({
       className,
       width = 600,
       height = 400,
       title,
       backgroundColor,
+      mode = "2d",
+      camera,
+      lighting,
+      post,
       nodes = [],
       edges = [],
       shapes = [],
-      interactive = false,
+      showGrid,
+      shadows,
+      interactive,
       animate = false,
       onShapeClick,
       isLoading,
@@ -9877,6 +10045,75 @@ var init_BiologyCanvas = __esm({
         out.push(...shapes);
         return out;
       }, [nodes, edges, shapes]);
+      const drawables3D = useMemo(() => {
+        if (mode !== "3d") return [];
+        if (shapes.length > 0) {
+          biologyLog.debug("shapes ignored in 3D mode (pixel-authored 2D vocabulary)", { count: shapes.length });
+        }
+        const out = [];
+        const labelColor = labelColorForBackground(backgroundColor);
+        const nodeById = /* @__PURE__ */ new Map();
+        for (const n of nodes) {
+          if (n.id) nodeById.set(n.id, n);
+        }
+        for (const e of edges) {
+          const a = nodeById.get(e.from);
+          const b = nodeById.get(e.to);
+          if (!a || !b) continue;
+          const edgeRadius = Math.max(0.04, Math.min(a.radius ?? 0.5, b.radius ?? 0.5) * 0.12);
+          const edge = cylinderBetween([a.x, a.y, a.z ?? 0], [b.x, b.y, b.z ?? 0], edgeRadius, e.color ?? "#9ca3af");
+          if (edge) out.push(edge);
+          if (e.label) {
+            out.push(
+              billboardLabel(
+                e.label,
+                (a.x + b.x) / 2,
+                (a.y + b.y) / 2,
+                ((a.z ?? 0) + (b.z ?? 0)) / 2,
+                { color: labelColor }
+              )
+            );
+          }
+        }
+        for (const n of nodes) {
+          const radius = n.radius ?? 0.5;
+          const nz = n.z ?? 0;
+          out.push(meshSphere(n.id, n.x, n.y, nz, radius, n.color ?? "#16a34a", { shape: n.shape, ...n.opacity !== void 0 ? { opacity: n.opacity } : {} }));
+          if (n.label) {
+            out.push(billboardLabel(n.label, n.x, n.y, nz + radius, { color: labelColor }));
+          }
+        }
+        return out;
+      }, [mode, nodes, edges, shapes, backgroundColor]);
+      const nodeIndexById = useMemo(() => {
+        const m = /* @__PURE__ */ new Map();
+        nodes.forEach((n, i) => {
+          if (n.id) m.set(n.id, i);
+        });
+        return m;
+      }, [nodes]);
+      if (mode === "3d") {
+        return /* @__PURE__ */ jsx(
+          LearningScene3D,
+          {
+            className,
+            width,
+            height,
+            title,
+            backgroundColor,
+            drawables: drawables3D,
+            camera,
+            lighting,
+            post,
+            showGrid,
+            shadows,
+            interactive,
+            isLoading,
+            error,
+            onItemClick: get3DClickPayload(onShapeClick, nodeIndexById)
+          }
+        );
+      }
       return /* @__PURE__ */ jsx(Card, { className, children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
         title ? /* @__PURE__ */ jsx(Typography, { variant: "h4", children: title }) : null,
         /* @__PURE__ */ jsx(
@@ -9886,7 +10123,7 @@ var init_BiologyCanvas = __esm({
             height,
             backgroundColor,
             shapes: derivedShapes,
-            interactive,
+            interactive: interactive ?? false,
             animate,
             onShapeClick,
             isLoading,
@@ -17278,9 +17515,10 @@ function Canvas({
       drawables: [...drawables ?? [], ...childDrawables],
       isLoading,
       cameraMode: to3DCameraMode(camera?.mode),
-      ...zoom !== void 0 ? { scale: zoom } : {},
+      ...zoom !== void 0 ? { zoom } : {},
       ...camera?.fov !== void 0 ? { fov: camera.fov } : {},
       ...camera?.azimuth !== void 0 ? { azimuth: camera.azimuth } : {},
+      ...camera?.elevation !== void 0 ? { elevation: camera.elevation } : {},
       ...camera?.target !== void 0 ? { followTarget: camera.target } : {},
       unitScale,
       backgroundColor,
@@ -17303,7 +17541,7 @@ function Canvas({
       keyUpMap
     };
     return /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(Canvas3DHost, { ...props3d }) }),
+      /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(Canvas3DHost2, { ...props3d }) }),
       React77.Children.count(children) > 0 && /* @__PURE__ */ jsx(DrawableRegistryContext.Provider, { value: registerChildDrawable, children: /* @__PURE__ */ jsx("div", { "aria-hidden": "true", style: { position: "absolute", width: 0, height: 0, overflow: "hidden" }, children }) })
     ] });
   }
@@ -17333,13 +17571,13 @@ function Canvas({
     }
   );
 }
-var Canvas3DHost, canvasLog;
+var Canvas3DHost2, canvasLog;
 var init_Canvas = __esm({
   "components/game/molecules/Canvas.tsx"() {
     "use client";
     init_registry();
     init_Canvas2D();
-    Canvas3DHost = lazy(
+    Canvas3DHost2 = lazy(
       () => import('@almadar/ui/components/molecules/game/three').then((m) => ({ default: m.Canvas3DHost }))
     );
     canvasLog = createLogger("almadar:ui:game-canvas");
@@ -19066,24 +19304,41 @@ var init_ChatBar = __esm({
     ChatBar.displayName = "ChatBar";
   }
 });
-var ChemistryCanvas;
+function bondPerpendicular(a, b) {
+  const dx = b[0] - a[0];
+  const dy = b[1] - a[1];
+  const px = dy;
+  const py = -dx;
+  const len = Math.sqrt(px * px + py * py);
+  if (len < 1e-6) return [1, 0, 0];
+  return [px / len, py / len, 0];
+}
+var chemistryLog, ChemistryCanvas;
 var init_ChemistryCanvas = __esm({
   "components/learning/molecules/ChemistryCanvas.tsx"() {
     "use client";
     init_atoms();
     init_Stack();
     init_LearningCanvas();
+    init_learningScene3D();
+    chemistryLog = createLogger("almadar:ui:chemistry-canvas");
     ChemistryCanvas = ({
       className,
       width = 600,
       height = 400,
       title,
       backgroundColor,
+      mode = "2d",
+      camera,
+      lighting,
+      post,
       atoms = [],
       bonds = [],
       arrows = [],
       shapes = [],
-      interactive = false,
+      showGrid,
+      shadows,
+      interactive,
       animate = false,
       onShapeClick,
       isLoading,
@@ -19162,6 +19417,88 @@ var init_ChemistryCanvas = __esm({
         out.push(...shapes);
         return out;
       }, [atoms, bonds, arrows, shapes]);
+      const drawables3D = useMemo(() => {
+        if (mode !== "3d") return [];
+        if (shapes.length > 0) {
+          chemistryLog.debug("shapes ignored in 3D mode (pixel-authored 2D vocabulary)", { count: shapes.length });
+        }
+        const out = [];
+        const labelColor = labelColorForBackground(backgroundColor);
+        const atomById = /* @__PURE__ */ new Map();
+        for (const a of atoms) {
+          if (a.id) atomById.set(a.id, a);
+        }
+        for (const b of bonds) {
+          const a = atomById.get(b.from);
+          const c = atomById.get(b.to);
+          if (!a || !c) continue;
+          const color = b.color ?? "#6b7280";
+          const from = [a.x, a.y, a.z ?? 0];
+          const to = [c.x, c.y, c.z ?? 0];
+          const perp = bondPerpendicular(from, to);
+          const bondRadius = Math.max(0.06, Math.min(a.radius ?? 0.45, c.radius ?? 0.45) * 0.22);
+          const step = bondRadius * 2.2;
+          const offsets = b.type === "double" ? [-step, step] : b.type === "triple" ? [-step, 0, step] : [0];
+          for (const off of offsets) {
+            const bond = cylinderBetween(
+              [from[0] + perp[0] * off, from[1] + perp[1] * off, from[2] + perp[2] * off],
+              [to[0] + perp[0] * off, to[1] + perp[1] * off, to[2] + perp[2] * off],
+              bondRadius,
+              color
+            );
+            if (bond) out.push(bond);
+          }
+        }
+        for (const a of arrows) {
+          const angle = (a.angle ?? 0) * (Math.PI / 180);
+          const len = a.length ?? 60;
+          const x2 = a.x + Math.cos(angle) * len;
+          const y2 = a.y + Math.sin(angle) * len;
+          const arrow = arrowBetween([a.x, a.y, 0], [x2, y2, 0], a.color ?? "#dc2626");
+          if (arrow) out.push(arrow);
+          if (a.label) {
+            out.push(billboardLabel(a.label, (a.x + x2) / 2, (a.y + y2) / 2, 0, { color: labelColor }));
+          }
+        }
+        for (const a of atoms) {
+          const radius = a.radius ?? 0.45;
+          const az = a.z ?? 0;
+          out.push(meshSphere(a.id, a.x, a.y, az, radius, a.color ?? "#2563eb"));
+          if (a.element) {
+            out.push(billboardLabel(a.element, a.x, a.y, az + radius, { color: labelColor }));
+          }
+        }
+        return out;
+      }, [mode, atoms, bonds, arrows, shapes, backgroundColor]);
+      const atomIndexById = useMemo(() => {
+        const m = /* @__PURE__ */ new Map();
+        atoms.forEach((a, i) => {
+          if (a.id) m.set(a.id, i);
+        });
+        return m;
+      }, [atoms]);
+      if (mode === "3d") {
+        return /* @__PURE__ */ jsx(
+          LearningScene3D,
+          {
+            className,
+            width,
+            height,
+            title,
+            backgroundColor,
+            drawables: drawables3D,
+            camera,
+            lighting,
+            post,
+            showGrid,
+            shadows,
+            interactive,
+            isLoading,
+            error,
+            onItemClick: get3DClickPayload(onShapeClick, atomIndexById)
+          }
+        );
+      }
       return /* @__PURE__ */ jsx(Card, { className, children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
         title ? /* @__PURE__ */ jsx(Typography, { variant: "h4", children: title }) : null,
         /* @__PURE__ */ jsx(
@@ -19171,7 +19508,7 @@ var init_ChemistryCanvas = __esm({
             height,
             backgroundColor,
             shapes: derivedShapes,
-            interactive,
+            interactive: interactive ?? false,
             animate,
             onShapeClick,
             isLoading,
@@ -23681,6 +24018,7 @@ var init_FilterGroup = __esm({
     init_Badge();
     init_Stack();
     init_Icon();
+    init_RangeSlider();
     init_useEventBus();
     init_useQuerySingleton();
     resolveFilterType = (filter) => filter.filterType ?? filter.type;
@@ -23875,6 +24213,35 @@ var init_FilterGroup = __esm({
                   onClear: () => handleFilterSelect(`${filter.field}_to`, null)
                 }
               )
+            ] }) : resolveFilterType(filter) === "numberrange" || resolveFilterType(filter) === "number-range" ? /* @__PURE__ */ jsxs("div", { className: "flex flex-col gap-2", children: [
+              /* @__PURE__ */ jsx(
+                RangeSlider,
+                {
+                  min: filter.min ?? 0,
+                  max: filter.max ?? 100,
+                  step: filter.step ?? 1,
+                  value: Number(
+                    selectedValues[`${filter.field}_min`] ?? filter.min ?? 0
+                  ),
+                  onChange: (v) => handleFilterSelect(`${filter.field}_min`, String(v)),
+                  showTooltip: true,
+                  "aria-label": t("filterGroup.from")
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                RangeSlider,
+                {
+                  min: filter.min ?? 0,
+                  max: filter.max ?? 100,
+                  step: filter.step ?? 1,
+                  value: Number(
+                    selectedValues[`${filter.field}_max`] ?? filter.max ?? 100
+                  ),
+                  onChange: (v) => handleFilterSelect(`${filter.field}_max`, String(v)),
+                  showTooltip: true,
+                  "aria-label": t("filterGroup.to")
+                }
+              )
             ] }) : resolveFilterType(filter) === "text" ? /* @__PURE__ */ jsx(
               Input,
               {
@@ -23957,6 +24324,36 @@ var init_FilterGroup = __esm({
                     className: "text-sm min-w-[100px]"
                   }
                 )
+              ] }) : resolveFilterType(filter) === "numberrange" || resolveFilterType(filter) === "number-range" ? /* @__PURE__ */ jsxs(HStack, { gap: "xs", align: "center", children: [
+                /* @__PURE__ */ jsx(
+                  RangeSlider,
+                  {
+                    min: filter.min ?? 0,
+                    max: filter.max ?? 100,
+                    step: filter.step ?? 1,
+                    value: Number(
+                      selectedValues[`${filter.field}_min`] ?? filter.min ?? 0
+                    ),
+                    onChange: (v) => handleFilterSelect(`${filter.field}_min`, String(v)),
+                    className: "min-w-[100px]",
+                    "aria-label": t("filterGroup.from")
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "-" }),
+                /* @__PURE__ */ jsx(
+                  RangeSlider,
+                  {
+                    min: filter.min ?? 0,
+                    max: filter.max ?? 100,
+                    step: filter.step ?? 1,
+                    value: Number(
+                      selectedValues[`${filter.field}_max`] ?? filter.max ?? 100
+                    ),
+                    onChange: (v) => handleFilterSelect(`${filter.field}_max`, String(v)),
+                    className: "min-w-[100px]",
+                    "aria-label": t("filterGroup.to")
+                  }
+                )
               ] }) : resolveFilterType(filter) === "text" ? /* @__PURE__ */ jsx(
                 Input,
                 {
@@ -24075,6 +24472,38 @@ var init_FilterGroup = __esm({
                     className: "min-w-[130px]"
                   }
                 )
+              ] }) : resolveFilterType(filter) === "numberrange" || resolveFilterType(filter) === "number-range" ? /* @__PURE__ */ jsxs(HStack, { gap: "xs", align: "center", children: [
+                /* @__PURE__ */ jsx(
+                  RangeSlider,
+                  {
+                    min: filter.min ?? 0,
+                    max: filter.max ?? 100,
+                    step: filter.step ?? 1,
+                    value: Number(
+                      selectedValues[`${filter.field}_min`] ?? filter.min ?? 0
+                    ),
+                    onChange: (v) => handleFilterSelect(`${filter.field}_min`, String(v)),
+                    showTooltip: true,
+                    className: "min-w-[130px]",
+                    "aria-label": t("filterGroup.from")
+                  }
+                ),
+                /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: "-" }),
+                /* @__PURE__ */ jsx(
+                  RangeSlider,
+                  {
+                    min: filter.min ?? 0,
+                    max: filter.max ?? 100,
+                    step: filter.step ?? 1,
+                    value: Number(
+                      selectedValues[`${filter.field}_max`] ?? filter.max ?? 100
+                    ),
+                    onChange: (v) => handleFilterSelect(`${filter.field}_max`, String(v)),
+                    showTooltip: true,
+                    className: "min-w-[130px]",
+                    "aria-label": t("filterGroup.to")
+                  }
+                )
               ] }) : resolveFilterType(filter) === "text" ? /* @__PURE__ */ jsx(
                 Input,
                 {
@@ -29107,19 +29536,25 @@ var init_MathCanvas = __esm({
     };
   }
 });
-var PhysicsCanvas;
+var physicsLog2, PhysicsCanvas;
 var init_PhysicsCanvas = __esm({
   "components/learning/molecules/PhysicsCanvas.tsx"() {
     "use client";
     init_atoms();
     init_Stack();
     init_LearningCanvas();
+    init_learningScene3D();
+    physicsLog2 = createLogger("almadar:ui:physics-canvas");
     PhysicsCanvas = ({
       className,
       width = 600,
       height = 400,
       title,
       backgroundColor,
+      mode = "2d",
+      camera,
+      lighting,
+      post,
       bodies = [],
       constraints = [],
       showVelocity = true,
@@ -29127,7 +29562,9 @@ var init_PhysicsCanvas = __esm({
       velocityScale = 20,
       forceScale = 20,
       shapes = [],
-      interactive = false,
+      showGrid,
+      shadows,
+      interactive,
       animate = false,
       onShapeClick,
       isLoading,
@@ -29199,6 +29636,89 @@ var init_PhysicsCanvas = __esm({
         out.push(...shapes);
         return out;
       }, [bodies, constraints, showVelocity, showForces, velocityScale, forceScale, shapes]);
+      const drawables3D = useMemo(() => {
+        if (mode !== "3d") return [];
+        if (shapes.length > 0) {
+          physicsLog2.debug("shapes ignored in 3D mode (pixel-authored 2D vocabulary)", { count: shapes.length });
+        }
+        const out = [];
+        const labelColor = labelColorForBackground(backgroundColor);
+        const bodyById = /* @__PURE__ */ new Map();
+        for (const b of bodies) {
+          if (b.id) bodyById.set(b.id, b);
+        }
+        for (const c of constraints) {
+          const a = bodyById.get(c.from);
+          const b = bodyById.get(c.to);
+          if (!a || !b) continue;
+          const rodRadius = Math.max(0.05, Math.min(a.radius ?? 0.5, b.radius ?? 0.5) * 0.15);
+          const rod = cylinderBetween([a.x, a.y, a.z ?? 0], [b.x, b.y, b.z ?? 0], rodRadius, c.color ?? "#9ca3af");
+          if (rod) out.push(rod);
+        }
+        for (const b of bodies) {
+          const radius = b.radius ?? 0.5;
+          const bz = b.z ?? 0;
+          out.push(meshSphere(b.id, b.x, b.y, bz, radius, b.color ?? "#2563eb"));
+          if (b.label) {
+            out.push(billboardLabel(b.label, b.x, b.y, bz + radius, { color: labelColor }));
+          }
+          const vx = b.vx ?? 0;
+          const vy = b.vy ?? 0;
+          const vz = b.vz ?? 0;
+          const arrowRadius = Math.max(0.05, radius * 0.15);
+          if (showVelocity && (vx !== 0 || vy !== 0 || vz !== 0)) {
+            const arrow = arrowBetween(
+              [b.x, b.y, bz],
+              [b.x + vx * velocityScale, b.y + vy * velocityScale, bz + vz * velocityScale],
+              "#16a34a",
+              arrowRadius
+            );
+            if (arrow) out.push(arrow);
+          }
+          const fx = b.fx ?? 0;
+          const fy = b.fy ?? 0;
+          const fz = b.fz ?? 0;
+          if (showForces && (fx !== 0 || fy !== 0 || fz !== 0)) {
+            const arrow = arrowBetween(
+              [b.x, b.y, bz],
+              [b.x + fx * forceScale, b.y + fy * forceScale, bz + fz * forceScale],
+              "#dc2626",
+              arrowRadius
+            );
+            if (arrow) out.push(arrow);
+          }
+        }
+        return out;
+      }, [mode, bodies, constraints, showVelocity, showForces, velocityScale, forceScale, shapes, backgroundColor]);
+      const bodyIndexById = useMemo(() => {
+        const m = /* @__PURE__ */ new Map();
+        bodies.forEach((b, i) => {
+          if (b.id) m.set(b.id, i);
+        });
+        return m;
+      }, [bodies]);
+      if (mode === "3d") {
+        return /* @__PURE__ */ jsx(
+          LearningScene3D,
+          {
+            className,
+            width,
+            height,
+            title,
+            backgroundColor,
+            drawables: drawables3D,
+            camera,
+            lighting,
+            post,
+            showGrid,
+            shadows,
+            interactive,
+            isLoading,
+            error,
+            onItemClick: get3DClickPayload(onShapeClick, bodyIndexById)
+          }
+        );
+      }
       return /* @__PURE__ */ jsx(Card, { className, children: /* @__PURE__ */ jsxs(VStack, { gap: "sm", children: [
         title ? /* @__PURE__ */ jsx(Typography, { variant: "h4", children: title }) : null,
         /* @__PURE__ */ jsx(
@@ -29208,7 +29728,7 @@ var init_PhysicsCanvas = __esm({
             height,
             backgroundColor,
             shapes: derivedShapes,
-            interactive,
+            interactive: interactive ?? false,
             animate,
             onShapeClick,
             isLoading,
@@ -29826,12 +30346,12 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect66, useRef: useRef64, useCallback: useCallback107, useState: useState104 } = React77__default;
+      const { useEffect: useEffect66, useRef: useRef65, useCallback: useCallback107, useState: useState104 } = React77__default;
       const { Typography: Typography2 } = await Promise.resolve().then(() => (init_Typography(), Typography_exports));
       const { useEventBus: useEventBus2 } = await Promise.resolve().then(() => (init_useEventBus(), useEventBus_exports));
       function MapUpdater({ centerLat, centerLng, zoom }) {
         const map = useMap();
-        const prevRef = useRef64({ centerLat, centerLng, zoom });
+        const prevRef = useRef65({ centerLat, centerLng, zoom });
         useEffect66(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
@@ -39623,6 +40143,7 @@ var init_molecules2 = __esm({
     init_BiologyCanvas();
     init_ChemistryCanvas();
     init_AlgorithmCanvas();
+    init_learningScene3D();
     init_GraphView();
     init_MapView();
     init_NumberStepper();
@@ -40876,7 +41397,7 @@ function getEnumOptions(field) {
     }));
   }
   const validation = field.validation;
-  if (validation?.enum && Array.isArray(validation.enum)) {
+  if (validation?.enum && validation.enum.length > 0) {
     return validation.enum.map((v) => ({
       value: v,
       label: v.charAt(0).toUpperCase() + v.slice(1).replace(/_/g, " ")
@@ -50285,4 +50806,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, Card2 as ActionCard, ActionPalette, ActionTile, ActivationBlock, Alert, AlgorithmCanvas, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, Aside, AssetPicker, AtlasImage, AtlasPanel, AuthLayout, Avatar, Badge, BehaviorView, BiologyCanvas, BloomQuizBlock, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, BranchingLogicBuilder, Breadcrumb, Button, ButtonGroup, CTABanner, CalendarGrid, Canvas, Canvas2D, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, Center, Chart, ChartLegend, ChatBar, Checkbox, ChemistryCanvas, ChoiceButton, Coachmark, CodeBlock, CodeRunnerPanel, CollapsibleSection, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ContentSection, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTIONS, DEFAULT_MATRIX_COLUMNS, DEFAULT_SLOTS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangePicker, DateRangeSelector, DayCell, DetailPanel, Dialog, DialogueBubble, Divider, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, 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, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FileTree, FilterGroup, FilterPill, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioToggle, GameHud, GameIcon, GameMenu, GameShell, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, HStack, Header, HealthBar, HeroOrganism, HeroSection, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, IconPicker, ImportPreviewTree, ImportProgress, ImportSourcePicker, InfiniteScrollSentinel, Input, InputGroup, InstallBox, JazariStateMachine, JsonTreeEditor, Label, LandingPageTemplate, LawReferenceTooltip, LearningCanvas, Lightbox, LikertScale, LineChart2 as LineChart, List3 as List, LoadingState, MapView, MarkdownContent, MarketingFooter, MarketingStatCard, MasterDetail, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, ModuleCard, Navigation, NodeSlotEditor, NotifyListener, NumberStepper, OnboardingSpotlight, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, PageTransition, Pagination, PatternTile, PhysicsCanvas, Popover, PositionedCanvas, Presence, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PropertyInspector, PullQuote, PullToRefresh, QrScanner, QuizBlock, Radio, RangeSlider, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, RichBlockEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SectionHeader, SegmentRenderer, Select, SequenceBar, ServiceCatalog, SharedEntityStoreContext, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SlotContentRenderer, SocialProof, SortableList, Spacer, Sparkline, Spinner, Split, SplitPane, SplitSection, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StepFlow, StepFlowOrganism, SubagentTracePanel, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagCloud, TagInput, TeamCard, TeamOrganism, TerrainPalette, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UploadDropZone, VStack, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, boardEntity, bool, calculateAttackTargets, calculateValidMoves, cn, createInitialGameState, createSharedEntityStore, createTranslate, createUnitAnimationState, getCurrentFrame, getTileDimensions, inferDirection, isoToScreen, makeAsset, makeAssetMap, mapBookData, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, parseLessonSegments, parseMarkdownWithCodeBlocks, parseQueryBinding, pendulum, projectileMotion, registerCodeLanguageLoader, resolveFieldMap, resolveFrame, resolveSheetDirection, rows, runTickFrame, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAgentChat, useAnchorRect, useAtlasSliceDataUrl, useAuthContext, useCamera, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useLongPress, useMediaQuery, useOrbitalHistory, usePresence, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate114 as useTranslate, useUIEvents, useUISlotManager, useUnitSpriteAtlas, useValidation, vec2 };
+export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, Card2 as ActionCard, ActionPalette, ActionTile, ActivationBlock, Alert, AlgorithmCanvas, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, Aside, AssetPicker, AtlasImage, AtlasPanel, AuthLayout, Avatar, Badge, BehaviorView, BiologyCanvas, BloomQuizBlock, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, BranchingLogicBuilder, Breadcrumb, Button, ButtonGroup, CTABanner, CalendarGrid, Canvas, Canvas2D, Card, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, Center, Chart, ChartLegend, ChatBar, Checkbox, ChemistryCanvas, ChoiceButton, Coachmark, CodeBlock, CodeRunnerPanel, CollapsibleSection, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ContentSection, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTIONS, DEFAULT_MATRIX_COLUMNS, DEFAULT_SLOTS, DIAMOND_TOP_Y, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangePicker, DateRangeSelector, DayCell, DetailPanel, Dialog, DialogueBubble, Divider, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, 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, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FileTree, FilterGroup, FilterPill, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioToggle, GameHud, GameIcon, GameMenu, GameShell, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, HStack, Header, HealthBar, HeroOrganism, HeroSection, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, IconPicker, ImportPreviewTree, ImportProgress, ImportSourcePicker, InfiniteScrollSentinel, Input, InputGroup, InstallBox, JazariStateMachine, JsonTreeEditor, Label, LandingPageTemplate, LawReferenceTooltip, LearningCanvas, LearningScene3D, Lightbox, LikertScale, LineChart2 as LineChart, List3 as List, LoadingState, MapView, MarkdownContent, MarketingFooter, MarketingStatCard, MasterDetail, MasterDetailLayout, MathCanvas, MatrixQuestion, MediaGallery, Menu, Meter, Modal, ModalSlot, ModuleCard, Navigation, NodeSlotEditor, NotifyListener, NumberStepper, OnboardingSpotlight, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, PageTransition, Pagination, PatternTile, PhysicsCanvas, Popover, PositionedCanvas, Presence, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PropertyInspector, PullQuote, PullToRefresh, QrScanner, QuizBlock, Radio, RangeSlider, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, RichBlockEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SectionHeader, SegmentRenderer, Select, SequenceBar, ServiceCatalog, SharedEntityStoreContext, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, Skeleton, SlotContentRenderer, SocialProof, SortableList, Spacer, Sparkline, Spinner, Split, SplitPane, SplitSection, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateGraph, StateJsonView, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StepFlow, StepFlowOrganism, SubagentTracePanel, SvgBranch, SvgConnection, SvgFlow, SvgGrid, SvgLobe, SvgMesh, SvgMorph, SvgNode, SvgPulse, SvgRing, SvgShield, SvgStack, SwipeableRow, Switch, TERRAIN_COLORS, TILE_HEIGHT, TILE_WIDTH, TabbedContainer, TableView, Tabs, TagCloud, TagInput, TeamCard, TeamOrganism, TerrainPalette, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UploadDropZone, VStack, VersionDiff, ViolationAlert, VoteStack, WizardContainer, WizardNavigation, WizardProgress, arrowBetween, billboardLabel, boardEntity, bool, calculateAttackTargets, calculateValidMoves, cn, createInitialGameState, createSharedEntityStore, createTranslate, createUnitAnimationState, cylinderBetween, get3DClickPayload, getCurrentFrame, getTileDimensions, inferDirection, isoToScreen, makeAsset, makeAssetMap, mapBookData, meshSphere, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, parseLessonSegments, parseMarkdownWithCodeBlocks, parseQueryBinding, pendulum, projectileMotion, registerCodeLanguageLoader, resolveFieldMap, resolveFrame, resolveSheetDirection, rows, runTickFrame, screenToIso, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, useAgentChat, useAnchorRect, useAtlasSliceDataUrl, useAuthContext, useCamera, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useLongPress, useMediaQuery, useOrbitalHistory, usePresence, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSharedEntityStoreContext, useSwipeGesture, useTapReveal, useTraitListens, useTranslate114 as useTranslate, useUIEvents, useUISlotManager, useUnitSpriteAtlas, useValidation, vec2 };