@almadar/ui 5.76.1 → 5.76.4

package/dist/components/game/3d/patterns.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Curated list of the PUBLIC 3D (Three.js) render-ui pattern components.
+ *
+ * The 3D family is a code-split optional surface (published via the
+ * `@almadar/ui/components/{organisms,molecules}/game/three` subpath, never in
+ * the main barrel — that would pull @react-three/fiber into every app). This
+ * file is the source of truth for WHICH 3D components are render-ui patterns:
+ * `pattern-sync` discovers `patterns.ts` files by walking the tree and admits
+ * exactly the names listed here, so the 3D scene internals re-exported alongside
+ * them (Scene3D, Camera3D, Lighting3D, ModelLoader, Canvas3D, …) do NOT leak in
+ * as factory patterns. Move this file anywhere under `components/` and the
+ * scanner still finds it.
+ *
+ * @packageDocumentation
+ */
+export { GameCanvas3D } from './molecules/GameCanvas3D';
+export { GameBoard3D } from './organisms/GameBoard3D';
+export { GameCanvas3DBattleTemplate } from './templates/GameCanvas3DBattleTemplate';
+export { GameCanvas3DCastleTemplate } from './templates/GameCanvas3DCastleTemplate';
+export { GameCanvas3DWorldMapTemplate } from './templates/GameCanvas3DWorldMapTemplate';

package/dist/components/index.cjs

@@ -30125,37 +30125,6 @@ var init_useCanvasEffects = __esm({
     init_combatPresets();
   }
 });
-function GameAudioToggle({
-  size = "sm",
-  className
-}) {
-  const ctx = providers.useGameAudioContextOptional();
-  const [localMuted, setLocalMuted] = React80.useState(false);
-  const muted = ctx ? ctx.muted : localMuted;
-  const setMuted = ctx ? ctx.setMuted : setLocalMuted;
-  const handleToggle = React80.useCallback(() => {
-    setMuted(!muted);
-  }, [muted, setMuted]);
-  return /* @__PURE__ */ jsxRuntime.jsx(
-    exports.Button,
-    {
-      variant: "ghost",
-      size,
-      onClick: handleToggle,
-      className: cn("text-lg leading-none px-2", className),
-      "aria-pressed": muted,
-      children: muted ? "\u{1F507}" : "\u{1F50A}"
-    }
-  );
-}
-var init_GameAudioToggle = __esm({
-  "components/game/2d/atoms/GameAudioToggle.tsx"() {
-    "use client";
-    init_atoms();
-    init_cn();
-    GameAudioToggle.displayName = "GameAudioToggle";
-  }
-});
 function pickPath(entry) {
   if (Array.isArray(entry.path)) {
     return entry.path[Math.floor(Math.random() * entry.path.length)];
@@ -30423,6 +30392,101 @@ var init_useGameAudio = __esm({
     useGameAudio.displayName = "useGameAudio";
   }
 });
+function useGameAudioContext() {
+  const ctx = React80.useContext(exports.GameAudioContext);
+  if (!ctx) {
+    throw new Error("useGameAudioContext must be used inside <GameAudioProvider>");
+  }
+  return ctx;
+}
+function useGameAudioContextOptional() {
+  return React80.useContext(exports.GameAudioContext);
+}
+function GameAudioProvider({
+  manifest,
+  baseUrl = "",
+  children,
+  initialMuted = false
+}) {
+  const eventBus = useEventBus();
+  const { play, stop, stopAll, playMusic, stopMusic, muted, setMuted, masterVolume, setMasterVolume } = useGameAudio({ manifest, baseUrl, initialMuted });
+  React80.useEffect(() => {
+    const unsubPlay = eventBus.on("UI:PLAY_SOUND", (event) => {
+      const key = event.payload?.key;
+      if (key) play(key);
+    });
+    const unsubStop = eventBus.on("UI:STOP_SOUND", (event) => {
+      const key = event.payload?.key;
+      if (key) {
+        stop(key);
+      } else {
+        stopAll();
+      }
+    });
+    const unsubChangeMusic = eventBus.on("UI:CHANGE_MUSIC", (event) => {
+      const key = event.payload?.key;
+      if (key) {
+        playMusic(key);
+      } else {
+        stopMusic();
+      }
+    });
+    const unsubStopMusic = eventBus.on("UI:STOP_MUSIC", () => {
+      stopMusic();
+    });
+    return () => {
+      unsubPlay();
+      unsubStop();
+      unsubChangeMusic();
+      unsubStopMusic();
+    };
+  }, [eventBus, play, stop, stopAll, playMusic, stopMusic]);
+  const value = { muted, setMuted, masterVolume, setMasterVolume, play, playMusic, stopMusic };
+  return /* @__PURE__ */ jsxRuntime.jsx(exports.GameAudioContext.Provider, { value, children });
+}
+exports.GameAudioContext = void 0;
+var init_GameAudioProvider = __esm({
+  "components/game/shared/providers/GameAudioProvider.tsx"() {
+    "use client";
+    init_useEventBus();
+    init_useGameAudio();
+    exports.GameAudioContext = React80.createContext(null);
+    exports.GameAudioContext.displayName = "GameAudioContext";
+    GameAudioProvider.displayName = "GameAudioProvider";
+  }
+});
+function GameAudioToggle({
+  size = "sm",
+  className
+}) {
+  const ctx = useGameAudioContextOptional();
+  const [localMuted, setLocalMuted] = React80.useState(false);
+  const muted = ctx ? ctx.muted : localMuted;
+  const setMuted = ctx ? ctx.setMuted : setLocalMuted;
+  const handleToggle = React80.useCallback(() => {
+    setMuted(!muted);
+  }, [muted, setMuted]);
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    exports.Button,
+    {
+      variant: "ghost",
+      size,
+      onClick: handleToggle,
+      className: cn("text-lg leading-none px-2", className),
+      "aria-pressed": muted,
+      children: muted ? "\u{1F507}" : "\u{1F50A}"
+    }
+  );
+}
+var init_GameAudioToggle = __esm({
+  "components/game/2d/atoms/GameAudioToggle.tsx"() {
+    "use client";
+    init_atoms();
+    init_cn();
+    init_GameAudioProvider();
+    GameAudioToggle.displayName = "GameAudioToggle";
+  }
+});
 function useBattleState(initialUnits, eventConfig = {}, callbacks = {}) {
   const eventBus = useEventBus();
   const {
@@ -36482,6 +36546,8 @@ var init_VisualNovelTemplate = __esm({
     VisualNovelTemplate.displayName = "VisualNovelTemplate";
   }
 });
+
+// components/game/2d/molecules/index.ts
 var init_molecules = __esm({
   "components/game/2d/molecules/index.ts"() {
     init_shared();
@@ -36514,6 +36580,7 @@ var init_molecules = __esm({
     init_useUnitSpriteAtlas();
     init_CanvasEffect();
     init_useCanvasEffects();
+    init_GameAudioProvider();
     init_GameAudioToggle();
     init_useGameAudio();
     init_useCamera();
@@ -36954,13 +37021,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect78, useRef: useRef78, useCallback: useCallback127, useState: useState119 } = React80__namespace.default;
+      const { useEffect: useEffect79, useRef: useRef78, useCallback: useCallback127, useState: useState119 } = React80__namespace.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 = useRef78({ centerLat, centerLng, zoom });
-        useEffect78(() => {
+        useEffect79(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -36971,7 +37038,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect78(() => {
+        useEffect79(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -52756,9 +52823,33 @@ var init_ToastSlot = __esm({
     exports.ToastSlot.displayName = "ToastSlot";
   }
 });
-
-// components/core/organisms/component-registry.generated.ts
-var COMPONENT_REGISTRY;
+function lazyThree(name, loader) {
+  const Lazy = React80__namespace.default.lazy(
+    () => loader().then((m) => {
+      const Resolved = m[name];
+      if (!Resolved) {
+        throw new Error(
+          `[@almadar/ui] 3D component "${name}" was not found in the three subpath bundle.`
+        );
+      }
+      return { default: Resolved };
+    })
+  );
+  function ThreeWrapper(props) {
+    return React80__namespace.default.createElement(
+      ThreeBoundary,
+      { name },
+      React80__namespace.default.createElement(
+        React80__namespace.default.Suspense,
+        { fallback: null },
+        React80__namespace.default.createElement(Lazy, props)
+      )
+    );
+  }
+  ThreeWrapper.displayName = `Lazy(${name})`;
+  return ThreeWrapper;
+}
+var ThreeBoundary, GameBoard3D, GameCanvas3D, GameCanvas3DBattleTemplate, GameCanvas3DCastleTemplate, GameCanvas3DWorldMapTemplate, COMPONENT_REGISTRY;
 var init_component_registry_generated = __esm({
   "components/core/organisms/component-registry.generated.ts"() {
     init_AboutPageTemplate();
@@ -52869,9 +52960,11 @@ var init_component_registry_generated = __esm({
     init_Form();
     init_FormField();
     init_FormSectionHeader();
+    init_GameAudioProvider();
     init_GameAudioToggle();
     init_GameCard();
     init_GameHud();
+    init_GameIcon();
     init_GameMenu();
     init_GameShell();
     init_GameTemplate();
@@ -53056,6 +53149,33 @@ var init_component_registry_generated = __esm({
     init_WizardProgress();
     init_WorldMapBoard();
     init_WorldMapTemplate();
+    ThreeBoundary = class extends React80__namespace.default.Component {
+      constructor() {
+        super(...arguments);
+        __publicField(this, "state", { failed: false });
+      }
+      static getDerivedStateFromError() {
+        return { failed: true };
+      }
+      render() {
+        if (this.state.failed) {
+          return React80__namespace.default.createElement(
+            "div",
+            {
+              "data-testid": "three-unavailable",
+              style: { padding: 16, fontSize: 13, lineHeight: 1.5, opacity: 0.7 }
+            },
+            `3D pattern "${this.props.name}" requires three.js. Install the optional peers three + @react-three/fiber + @react-three/drei (matching the host React major) to render it.`
+          );
+        }
+        return this.props.children;
+      }
+    };
+    GameBoard3D = lazyThree("GameBoard3D", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3D = lazyThree("GameCanvas3D", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DBattleTemplate = lazyThree("GameCanvas3DBattleTemplate", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DCastleTemplate = lazyThree("GameCanvas3DCastleTemplate", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DWorldMapTemplate = lazyThree("GameCanvas3DWorldMapTemplate", () => import('@almadar/ui/components/molecules/game/three'));
     COMPONENT_REGISTRY = {
       "AboutPageTemplate": exports.AboutPageTemplate,
       "Accordion": exports.Accordion,
@@ -53171,9 +53291,16 @@ var init_component_registry_generated = __esm({
       "Form": exports.Form,
       "FormField": exports.FormField,
       "FormSectionHeader": exports.FormSectionHeader,
+      "GameAudioProvider": GameAudioProvider,
       "GameAudioToggle": GameAudioToggle,
+      "GameBoard3D": GameBoard3D,
+      "GameCanvas3D": GameCanvas3D,
+      "GameCanvas3DBattleTemplate": GameCanvas3DBattleTemplate,
+      "GameCanvas3DCastleTemplate": GameCanvas3DCastleTemplate,
+      "GameCanvas3DWorldMapTemplate": GameCanvas3DWorldMapTemplate,
       "GameCard": GameCard,
       "GameHud": GameHud,
+      "GameIcon": GameIcon,
       "GameMenu": GameMenu,
       "GameShell": exports.GameShell,
       "GameTemplate": exports.GameTemplate,
@@ -56591,18 +56718,6 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-Object.defineProperty(exports, "GameAudioContext", {
-  enumerable: true,
-  get: function () { return providers.GameAudioContext; }
-});
-Object.defineProperty(exports, "GameAudioProvider", {
-  enumerable: true,
-  get: function () { return providers.GameAudioProvider; }
-});
-Object.defineProperty(exports, "useGameAudioContext", {
-  enumerable: true,
-  get: function () { return providers.useGameAudioContext; }
-});
 exports.ALMADAR_DND_MIME = ALMADAR_DND_MIME;
 exports.ActionButton = ActionButton;
 exports.ActionCard = Card2;
@@ -56647,6 +56762,7 @@ exports.EditorToolbar = EditorToolbar;
 exports.EventHandlerBoard = EventHandlerBoard;
 exports.EventLog = EventLog;
 exports.FishingBoard = FishingBoard;
+exports.GameAudioProvider = GameAudioProvider;
 exports.GameAudioToggle = GameAudioToggle;
 exports.GameCard = GameCard;
 exports.GameHud = GameHud;
@@ -56794,6 +56910,7 @@ exports.useExtensions = useExtensions;
 exports.useFileEditor = useFileEditor;
 exports.useFileSystem = useFileSystem;
 exports.useGameAudio = useGameAudio;
+exports.useGameAudioContext = useGameAudioContext;
 exports.useGitHubBranches = useGitHubBranches;
 exports.useGitHubRepo = useGitHubRepo;
 exports.useGitHubRepos = useGitHubRepos;

package/dist/components/index.js

@@ -3,8 +3,7 @@ import * as React80 from 'react';
 import React80__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, useState, useId, Suspense, lazy, useLayoutEffect, useSyncExternalStore } from 'react';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
-import { EventBusContext, useTraitScope, useCurrentPagePath, useGameAudioContextOptional, useEntitySchemaOptional, TraitScopeProvider } from '@almadar/ui/providers';
-export { GameAudioContext, GameAudioProvider, useGameAudioContext } from '@almadar/ui/providers';
+import { EventBusContext, useTraitScope, useCurrentPagePath, useEntitySchemaOptional, TraitScopeProvider } from '@almadar/ui/providers';
 import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import * as LucideIcons2 from 'lucide-react';
 import { X, List, Printer, ChevronRight, ChevronLeft, CheckCircle, XCircle, Wrench, RotateCcw, Send, Play, Terminal, ChevronDown, Bug, ArrowRight, Pause, SkipForward, Search, ChevronUp, MoreHorizontal, Package, Calendar, Pencil, Eye, Image as Image$1, Upload, ZoomIn, TrendingUp, TrendingDown, Minus, AlertCircle, Circle, Clock, CheckCircle2, Loader2, Code, FileText, WrapText, Check, Copy, HelpCircle, Type, Heading1, Heading2, Heading3, ListOrdered, Quote, GitBranch, Plus, Trash, ArrowLeft, Menu as Menu$1, AlertTriangle, Trash2, Eraser, ZoomOut, Download, Lightbulb, PauseCircle, Link2, Tag, User, DollarSign } from 'lucide-react';
@@ -30080,37 +30079,6 @@ var init_useCanvasEffects = __esm({
     init_combatPresets();
   }
 });
-function GameAudioToggle({
-  size = "sm",
-  className
-}) {
-  const ctx = useGameAudioContextOptional();
-  const [localMuted, setLocalMuted] = useState(false);
-  const muted = ctx ? ctx.muted : localMuted;
-  const setMuted = ctx ? ctx.setMuted : setLocalMuted;
-  const handleToggle = useCallback(() => {
-    setMuted(!muted);
-  }, [muted, setMuted]);
-  return /* @__PURE__ */ jsx(
-    Button,
-    {
-      variant: "ghost",
-      size,
-      onClick: handleToggle,
-      className: cn("text-lg leading-none px-2", className),
-      "aria-pressed": muted,
-      children: muted ? "\u{1F507}" : "\u{1F50A}"
-    }
-  );
-}
-var init_GameAudioToggle = __esm({
-  "components/game/2d/atoms/GameAudioToggle.tsx"() {
-    "use client";
-    init_atoms();
-    init_cn();
-    GameAudioToggle.displayName = "GameAudioToggle";
-  }
-});
 function pickPath(entry) {
   if (Array.isArray(entry.path)) {
     return entry.path[Math.floor(Math.random() * entry.path.length)];
@@ -30378,6 +30346,101 @@ var init_useGameAudio = __esm({
     useGameAudio.displayName = "useGameAudio";
   }
 });
+function useGameAudioContext() {
+  const ctx = useContext(GameAudioContext);
+  if (!ctx) {
+    throw new Error("useGameAudioContext must be used inside <GameAudioProvider>");
+  }
+  return ctx;
+}
+function useGameAudioContextOptional() {
+  return useContext(GameAudioContext);
+}
+function GameAudioProvider({
+  manifest,
+  baseUrl = "",
+  children,
+  initialMuted = false
+}) {
+  const eventBus = useEventBus();
+  const { play, stop, stopAll, playMusic, stopMusic, muted, setMuted, masterVolume, setMasterVolume } = useGameAudio({ manifest, baseUrl, initialMuted });
+  useEffect(() => {
+    const unsubPlay = eventBus.on("UI:PLAY_SOUND", (event) => {
+      const key = event.payload?.key;
+      if (key) play(key);
+    });
+    const unsubStop = eventBus.on("UI:STOP_SOUND", (event) => {
+      const key = event.payload?.key;
+      if (key) {
+        stop(key);
+      } else {
+        stopAll();
+      }
+    });
+    const unsubChangeMusic = eventBus.on("UI:CHANGE_MUSIC", (event) => {
+      const key = event.payload?.key;
+      if (key) {
+        playMusic(key);
+      } else {
+        stopMusic();
+      }
+    });
+    const unsubStopMusic = eventBus.on("UI:STOP_MUSIC", () => {
+      stopMusic();
+    });
+    return () => {
+      unsubPlay();
+      unsubStop();
+      unsubChangeMusic();
+      unsubStopMusic();
+    };
+  }, [eventBus, play, stop, stopAll, playMusic, stopMusic]);
+  const value = { muted, setMuted, masterVolume, setMasterVolume, play, playMusic, stopMusic };
+  return /* @__PURE__ */ jsx(GameAudioContext.Provider, { value, children });
+}
+var GameAudioContext;
+var init_GameAudioProvider = __esm({
+  "components/game/shared/providers/GameAudioProvider.tsx"() {
+    "use client";
+    init_useEventBus();
+    init_useGameAudio();
+    GameAudioContext = createContext(null);
+    GameAudioContext.displayName = "GameAudioContext";
+    GameAudioProvider.displayName = "GameAudioProvider";
+  }
+});
+function GameAudioToggle({
+  size = "sm",
+  className
+}) {
+  const ctx = useGameAudioContextOptional();
+  const [localMuted, setLocalMuted] = useState(false);
+  const muted = ctx ? ctx.muted : localMuted;
+  const setMuted = ctx ? ctx.setMuted : setLocalMuted;
+  const handleToggle = useCallback(() => {
+    setMuted(!muted);
+  }, [muted, setMuted]);
+  return /* @__PURE__ */ jsx(
+    Button,
+    {
+      variant: "ghost",
+      size,
+      onClick: handleToggle,
+      className: cn("text-lg leading-none px-2", className),
+      "aria-pressed": muted,
+      children: muted ? "\u{1F507}" : "\u{1F50A}"
+    }
+  );
+}
+var init_GameAudioToggle = __esm({
+  "components/game/2d/atoms/GameAudioToggle.tsx"() {
+    "use client";
+    init_atoms();
+    init_cn();
+    init_GameAudioProvider();
+    GameAudioToggle.displayName = "GameAudioToggle";
+  }
+});
 function useBattleState(initialUnits, eventConfig = {}, callbacks = {}) {
   const eventBus = useEventBus();
   const {
@@ -36437,6 +36500,8 @@ var init_VisualNovelTemplate = __esm({
     VisualNovelTemplate.displayName = "VisualNovelTemplate";
   }
 });
+
+// components/game/2d/molecules/index.ts
 var init_molecules = __esm({
   "components/game/2d/molecules/index.ts"() {
     init_shared();
@@ -36469,6 +36534,7 @@ var init_molecules = __esm({
     init_useUnitSpriteAtlas();
     init_CanvasEffect();
     init_useCanvasEffects();
+    init_GameAudioProvider();
     init_GameAudioToggle();
     init_useGameAudio();
     init_useCamera();
@@ -36909,13 +36975,13 @@ var init_MapView = __esm({
         shadowSize: [41, 41]
       });
       L.Marker.prototype.options.icon = defaultIcon;
-      const { useEffect: useEffect78, useRef: useRef78, useCallback: useCallback127, useState: useState119 } = React80__default;
+      const { useEffect: useEffect79, useRef: useRef78, useCallback: useCallback127, useState: useState119 } = React80__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 = useRef78({ centerLat, centerLng, zoom });
-        useEffect78(() => {
+        useEffect79(() => {
           const prev = prevRef.current;
           if (prev.centerLat !== centerLat || prev.centerLng !== centerLng || prev.zoom !== zoom) {
             map.setView([centerLat, centerLng], zoom);
@@ -36926,7 +36992,7 @@ var init_MapView = __esm({
       }
       function MapClickHandler({ onMapClick }) {
         const map = useMap();
-        useEffect78(() => {
+        useEffect79(() => {
           if (!onMapClick) return;
           const handler = (e) => {
             onMapClick(e.latlng.lat, e.latlng.lng);
@@ -52711,9 +52777,33 @@ var init_ToastSlot = __esm({
     ToastSlot.displayName = "ToastSlot";
   }
 });
-
-// components/core/organisms/component-registry.generated.ts
-var COMPONENT_REGISTRY;
+function lazyThree(name, loader) {
+  const Lazy = React80__default.lazy(
+    () => loader().then((m) => {
+      const Resolved = m[name];
+      if (!Resolved) {
+        throw new Error(
+          `[@almadar/ui] 3D component "${name}" was not found in the three subpath bundle.`
+        );
+      }
+      return { default: Resolved };
+    })
+  );
+  function ThreeWrapper(props) {
+    return React80__default.createElement(
+      ThreeBoundary,
+      { name },
+      React80__default.createElement(
+        React80__default.Suspense,
+        { fallback: null },
+        React80__default.createElement(Lazy, props)
+      )
+    );
+  }
+  ThreeWrapper.displayName = `Lazy(${name})`;
+  return ThreeWrapper;
+}
+var ThreeBoundary, GameBoard3D, GameCanvas3D, GameCanvas3DBattleTemplate, GameCanvas3DCastleTemplate, GameCanvas3DWorldMapTemplate, COMPONENT_REGISTRY;
 var init_component_registry_generated = __esm({
   "components/core/organisms/component-registry.generated.ts"() {
     init_AboutPageTemplate();
@@ -52824,9 +52914,11 @@ var init_component_registry_generated = __esm({
     init_Form();
     init_FormField();
     init_FormSectionHeader();
+    init_GameAudioProvider();
     init_GameAudioToggle();
     init_GameCard();
     init_GameHud();
+    init_GameIcon();
     init_GameMenu();
     init_GameShell();
     init_GameTemplate();
@@ -53011,6 +53103,33 @@ var init_component_registry_generated = __esm({
     init_WizardProgress();
     init_WorldMapBoard();
     init_WorldMapTemplate();
+    ThreeBoundary = class extends React80__default.Component {
+      constructor() {
+        super(...arguments);
+        __publicField(this, "state", { failed: false });
+      }
+      static getDerivedStateFromError() {
+        return { failed: true };
+      }
+      render() {
+        if (this.state.failed) {
+          return React80__default.createElement(
+            "div",
+            {
+              "data-testid": "three-unavailable",
+              style: { padding: 16, fontSize: 13, lineHeight: 1.5, opacity: 0.7 }
+            },
+            `3D pattern "${this.props.name}" requires three.js. Install the optional peers three + @react-three/fiber + @react-three/drei (matching the host React major) to render it.`
+          );
+        }
+        return this.props.children;
+      }
+    };
+    GameBoard3D = lazyThree("GameBoard3D", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3D = lazyThree("GameCanvas3D", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DBattleTemplate = lazyThree("GameCanvas3DBattleTemplate", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DCastleTemplate = lazyThree("GameCanvas3DCastleTemplate", () => import('@almadar/ui/components/molecules/game/three'));
+    GameCanvas3DWorldMapTemplate = lazyThree("GameCanvas3DWorldMapTemplate", () => import('@almadar/ui/components/molecules/game/three'));
     COMPONENT_REGISTRY = {
       "AboutPageTemplate": AboutPageTemplate,
       "Accordion": Accordion,
@@ -53126,9 +53245,16 @@ var init_component_registry_generated = __esm({
       "Form": Form,
       "FormField": FormField,
       "FormSectionHeader": FormSectionHeader,
+      "GameAudioProvider": GameAudioProvider,
       "GameAudioToggle": GameAudioToggle,
+      "GameBoard3D": GameBoard3D,
+      "GameCanvas3D": GameCanvas3D,
+      "GameCanvas3DBattleTemplate": GameCanvas3DBattleTemplate,
+      "GameCanvas3DCastleTemplate": GameCanvas3DCastleTemplate,
+      "GameCanvas3DWorldMapTemplate": GameCanvas3DWorldMapTemplate,
       "GameCard": GameCard,
       "GameHud": GameHud,
+      "GameIcon": GameIcon,
       "GameMenu": GameMenu,
       "GameShell": GameShell,
       "GameTemplate": GameTemplate,
@@ -56546,4 +56672,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, ActionButton, Card2 as ActionCard, ActionPalette, ActionTile, ActivationBlock, Alert, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, Aside, AssetPicker, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BehaviorView, BloomQuizBlock, BoardgameBoard, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, BranchingLogicBuilder, Breadcrumb, BuilderBoard, Button, ButtonGroup, CTABanner, CalendarGrid, Canvas2D, CanvasEffect, Card, CardBattlerBoard, CardBattlerTemplate, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, ChatBar, Checkbox, ChoiceButton, CityBuilderBoard, CityBuilderTemplate, ClassifierBoard, Coachmark, CodeBlock, CodeRunnerPanel, CollapsibleSection, ComboCounter, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ContentSection, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTIONS, DEFAULT_MATRIX_COLUMNS, DEFAULT_SLOTS, DIAMOND_TOP_Y, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangePicker, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, Dialog, DialogueBubble, Divider, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EMPTY_EFFECT_STATE, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmptyState, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FileTree, FilterGroup, FilterPill, FishingBoard, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioToggle, GameCard, GameHud, GameIcon, GameMenu, GameShell, GameTemplate, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, HStack, Header, HealthBar, HeroOrganism, HeroSection, HexStrategyBoard, HolidayRunnerBoard, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, IconPicker, InfiniteScrollSentinel, Input, InputGroup, InstallBox, InventoryGrid, ItemSlot, JazariStateMachine, JsonTreeEditor, Label, LandingPageTemplate, LawReferenceTooltip, Lightbox, LikertScale, LineChart2 as LineChart, List3 as List, LoadingState, MapView, MarkdownContent, MarketingFooter, MarketingStatCard, MasterDetail, MasterDetailLayout, MatchPuzzleBoard, MatrixQuestion, MediaGallery, Menu, Meter, MiniMap, MinigolfBoard, Modal, ModalSlot, ModuleCard, Navigation, NegotiatorBoard, NodeSlotEditor, NotifyListener, NumberStepper, ObjectRulePanel, OnboardingSpotlight, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PatternTile, PinballBoard, PirateBoard, PlatformerBoard, PlatformerTemplate, Popover, PositionedCanvas, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PropertyInspector, PullQuote, PullToRefresh, QrScanner, QuizBlock, RacingBoard, Radio, RangeSlider, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, ResourceBar, ResourceCounter, RichBlockEditor, RoguelikeBoard, RoguelikeTemplate, RuleEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SectionHeader, SegmentRenderer, Select, SequenceBar, SequencerBoard, ServiceCatalog, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SocialProof, SokobanBoard, SortableList, SpaceShmupBoard, SpaceStationBoard, Spacer, Sparkline, Spinner, Split, SplitPane, SplitSection, SportsBoard, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateJsonView, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StatusEffect, 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, TanksBoard, TeamCard, TeamOrganism, TerrainPalette, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TopDownShooterBoard, TopDownShooterTemplate, TowerDefenseBoard, TowerDefenseTemplate, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UploadDropZone, VStack, VariablePanel, VersionDiff, ViolationAlert, VisualNovelBoard, VisualNovelTemplate, VoteStack, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, boardEntity, bool, calculateAttackTargets, calculateValidMoves, cn, createCombatPresets, createInitialGameState, createTranslate, createUnitAnimationState, drawEffectState, drawSprite, drawTintedImage, getAllEffectSpriteUrls, getCurrentFrame, getTileDimensions, hasActiveEffects, inferDirection, isoToScreen, makeAsset, makeAssetMap, mapBookData, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, parseLessonSegments, parseMarkdownWithCodeBlocks, parseQueryBinding, pendulum, projectileMotion, resolveFieldMap, resolveFrame, resolveSheetDirection, rows, screenToIso, spawnOverlay, spawnParticles, spawnSequence, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, updateEffectState, useAgentChat, useAnchorRect, useAuthContext, useBattleState, useCamera, useCanvasEffects, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSwipeGesture, useTapReveal, useTraitListens, useTranslate135 as useTranslate, useUIEvents, useUISlotManager, useUnitSpriteAtlas, useValidation, vec2 };
+export { ALL_PRESETS, ALMADAR_DND_MIME, AR_BOOK_FIELDS, AboutPageTemplate, Accordion, ActionButton, Card2 as ActionCard, ActionPalette, ActionTile, ActivationBlock, Alert, AnimatedCounter, AnimatedGraphic, AnimatedReveal, ArticleSection, Aside, AssetPicker, AuthLayout, Avatar, Badge, BattleBoard, BattleTemplate, BehaviorView, BloomQuizBlock, BoardgameBoard, BookChapterView, BookCoverPage, BookNavBar, BookTableOfContents, BookViewer, Box, BranchingLogicBuilder, Breadcrumb, BuilderBoard, Button, ButtonGroup, CTABanner, CalendarGrid, Canvas2D, CanvasEffect, Card, CardBattlerBoard, CardBattlerTemplate, CardBody, CardContent, CardFooter, CardGrid, CardHeader, CardTitle, Carousel, CaseStudyCard, CaseStudyOrganism, CastleBoard, CastleTemplate, Center, Chart, ChartLegend, ChatBar, Checkbox, ChoiceButton, CityBuilderBoard, CityBuilderTemplate, ClassifierBoard, Coachmark, CodeBlock, CodeRunnerPanel, CollapsibleSection, ComboCounter, CommunityLinks, ConditionalWrapper, ConfettiEffect, ConfirmDialog, ConnectionBlock, Container, ContentRenderer, ContentSection, ControlButton, ControlGrid, CounterTemplate, DEFAULT_LIKERT_OPTIONS, DEFAULT_MATRIX_COLUMNS, DEFAULT_SLOTS, DIAMOND_TOP_Y, DamageNumber, DashboardGrid, DashboardLayout, DataGrid, DataList, DataTable, DateRangePicker, DateRangeSelector, DayCell, DebuggerBoard, DetailPanel, Dialog, DialogueBubble, Divider, DocBreadcrumb, DocPagination, DocSearch, DocSidebar, DocTOC, DocumentViewer, StateMachineView as DomStateMachineVisualizer, Drawer, DrawerSlot, ELEMENT_SELECTED_EVENT, EMPTY_EFFECT_STATE, EdgeDecoration, EditorCheckbox, EditorSelect, EditorSlider, EditorTextInput, EditorToolbar, EmptyState, EntityDisplayEvents, ErrorBoundary, ErrorState, EventHandlerBoard, EventLog, FEATURE_COLORS, FEATURE_TYPES, FLOOR_HEIGHT, FeatureCard, FeatureDetailPageTemplate, FeatureGrid, FeatureGridOrganism, FileTree, FilterGroup, FilterPill, FishingBoard, Flex, FlipCard, FlipContainer, FloatingActionButton, Form, FormActions, FormField, FormLayout, FormSection, FormSectionHeader, GameAudioContext, GameAudioProvider, GameAudioToggle, GameCard, GameHud, GameIcon, GameMenu, GameShell, GameTemplate, GenericAppTemplate, GeometricPattern, GradientDivider, GraphCanvas, GraphView, Grid, GridPicker, HStack, Header, HealthBar, HeroOrganism, HeroSection, HexStrategyBoard, HolidayRunnerBoard, I18nProvider, IDENTITY_BOOK_FIELDS, Icon, IconPicker, InfiniteScrollSentinel, Input, InputGroup, InstallBox, InventoryGrid, ItemSlot, JazariStateMachine, JsonTreeEditor, Label, LandingPageTemplate, LawReferenceTooltip, Lightbox, LikertScale, LineChart2 as LineChart, List3 as List, LoadingState, MapView, MarkdownContent, MarketingFooter, MarketingStatCard, MasterDetail, MasterDetailLayout, MatchPuzzleBoard, MatrixQuestion, MediaGallery, Menu, Meter, MiniMap, MinigolfBoard, Modal, ModalSlot, ModuleCard, Navigation, NegotiatorBoard, NodeSlotEditor, NotifyListener, NumberStepper, ObjectRulePanel, OnboardingSpotlight, OptionConstraintGroup, StateMachineView as OrbitalStateMachineView, OrbitalVisualization, Overlay, PageHeader, Pagination, PatternTile, PinballBoard, PirateBoard, PlatformerBoard, PlatformerTemplate, Popover, PositionedCanvas, PricingCard, PricingGrid, PricingOrganism, PricingPageTemplate, ProgressBar, ProgressDots, PropertyInspector, PullQuote, PullToRefresh, QrScanner, QuizBlock, RacingBoard, Radio, RangeSlider, ReflectionBlock, RelationSelect, RepeatableFormSection, ReplyTree, ResourceBar, ResourceCounter, RichBlockEditor, RoguelikeBoard, RoguelikeTemplate, RuleEditor, RuntimeDebugger, SHEET_COLUMNS, SPRITE_SHEET_LAYOUT, ScaledDiagram, ScoreDisplay, SearchInput, Section, SectionHeader, SegmentRenderer, Select, SequenceBar, SequencerBoard, ServiceCatalog, ShowcaseCard, ShowcaseOrganism, SidePanel, Sidebar, SignaturePad, SimpleGrid, SimulationCanvas, SimulationControls, SimulationGraph, SimulatorBoard, Skeleton, SlotContentRenderer, SocialProof, SokobanBoard, SortableList, SpaceShmupBoard, SpaceStationBoard, Spacer, Sparkline, Spinner, Split, SplitPane, SplitSection, SportsBoard, Sprite, Stack, StarRating, StatBadge, StatCard, StatDisplay, StateArchitectBoard, StateIndicator, StateJsonView, StateMachineView, StateNode2 as StateNode, StatsGrid, StatsOrganism, StatusBar, StatusDot, StatusEffect, 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, TanksBoard, TeamCard, TeamOrganism, TerrainPalette, TextHighlight, Textarea, ThemeToggle, TimeSlotCell, Timeline, TimerDisplay, Toast, ToastSlot, Tooltip, TopDownShooterBoard, TopDownShooterTemplate, TowerDefenseBoard, TowerDefenseTemplate, TraitFrame, TraitSlot, TraitStateViewer, TransitionArrow, TrendIndicator, TurnIndicator, TypewriterText, Typography, UISlotComponent, UISlotRenderer, UncontrolledBattleBoard, UploadDropZone, VStack, VariablePanel, VersionDiff, ViolationAlert, VisualNovelBoard, VisualNovelTemplate, VoteStack, WaypointMarker, WizardContainer, WizardNavigation, WizardProgress, WorldMapBoard, WorldMapTemplate, boardEntity, bool, calculateAttackTargets, calculateValidMoves, cn, createCombatPresets, createInitialGameState, createTranslate, createUnitAnimationState, drawEffectState, drawSprite, drawTintedImage, getAllEffectSpriteUrls, getCurrentFrame, getTileDimensions, hasActiveEffects, inferDirection, isoToScreen, makeAsset, makeAssetMap, mapBookData, num, objAvailableActions, objAvailableEvents, objCurrentState, objIcon, objId, objMaxRules, objName, objRules, objStates, parseEditFocus, parseLessonSegments, parseMarkdownWithCodeBlocks, parseQueryBinding, pendulum, projectileMotion, resolveFieldMap, resolveFrame, resolveSheetDirection, rows, screenToIso, spawnOverlay, spawnParticles, spawnSequence, springOscillator, str, tickAnimationState, toCodeLanguage, transitionAnimation, unitHealth, unitPosition, unitTeam, updateEffectState, useAgentChat, useAnchorRect, useAuthContext, useBattleState, useCamera, useCanvasEffects, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGameAudio, useGameAudioContext, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useImageCache, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSwipeGesture, useTapReveal, useTraitListens, useTranslate135 as useTranslate, useUIEvents, useUISlotManager, useUnitSpriteAtlas, useValidation, vec2 };