@almadar/ui 5.76.2 → 5.76.5

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

@@ -1304,14 +1304,17 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
   Wrapped.displayName = `Lazy.${libKey}.${fallbackName}`;
   return Wrapped;
 }
+function isComponentLike(v) {
+  return v != null && (typeof v === "function" || typeof v === "object");
+}
 function resolveLucide(name) {
   if (lucideAliases[name]) return lucideAliases[name];
   const pascal = kebabToPascal(name);
   const lucideMap = LucideIcons2__namespace;
   const direct = lucideMap[pascal];
-  if (direct && typeof direct === "function") return direct;
+  if (isComponentLike(direct)) return direct;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "function") return asIs;
+  if (isComponentLike(asIs)) return asIs;
   return LucideIcons2__namespace.HelpCircle;
 }
 function resolvePhosphor(name, weight, family) {
@@ -1955,12 +1958,13 @@ function resolveIcon(name) {
 }
 function doResolve(name) {
   if (iconAliases[name]) return iconAliases[name];
+  const isComponentLike2 = (v) => v != null && (typeof v === "function" || typeof v === "object");
   const pascalName = kebabToPascal2(name);
   const lucideMap = LucideIcons2__namespace;
   const directLookup = lucideMap[pascalName];
-  if (directLookup && typeof directLookup === "object") return directLookup;
+  if (isComponentLike2(directLookup)) return directLookup;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "object") return asIs;
+  if (isComponentLike2(asIs)) return asIs;
   return LucideIcons2__namespace.HelpCircle;
 }
 var colorTokenClasses, iconAliases, resolvedCache, sizeClasses, animationClasses; exports.Icon = void 0;
@@ -52823,9 +52827,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();
@@ -52936,9 +52964,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();
@@ -53123,6 +53153,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,
@@ -53238,9 +53295,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,

package/dist/components/index.js

@@ -1258,14 +1258,17 @@ function lazyFamilyIcon(libKey, importer, pick, fallbackName, family) {
   Wrapped.displayName = `Lazy.${libKey}.${fallbackName}`;
   return Wrapped;
 }
+function isComponentLike(v) {
+  return v != null && (typeof v === "function" || typeof v === "object");
+}
 function resolveLucide(name) {
   if (lucideAliases[name]) return lucideAliases[name];
   const pascal = kebabToPascal(name);
   const lucideMap = LucideIcons2;
   const direct = lucideMap[pascal];
-  if (direct && typeof direct === "function") return direct;
+  if (isComponentLike(direct)) return direct;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "function") return asIs;
+  if (isComponentLike(asIs)) return asIs;
   return LucideIcons2.HelpCircle;
 }
 function resolvePhosphor(name, weight, family) {
@@ -1909,12 +1912,13 @@ function resolveIcon(name) {
 }
 function doResolve(name) {
   if (iconAliases[name]) return iconAliases[name];
+  const isComponentLike2 = (v) => v != null && (typeof v === "function" || typeof v === "object");
   const pascalName = kebabToPascal2(name);
   const lucideMap = LucideIcons2;
   const directLookup = lucideMap[pascalName];
-  if (directLookup && typeof directLookup === "object") return directLookup;
+  if (isComponentLike2(directLookup)) return directLookup;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "object") return asIs;
+  if (isComponentLike2(asIs)) return asIs;
   return LucideIcons2.HelpCircle;
 }
 var colorTokenClasses, iconAliases, resolvedCache, sizeClasses, animationClasses, Icon;
@@ -52777,9 +52781,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();
@@ -52890,9 +52918,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();
@@ -53077,6 +53107,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,
@@ -53192,9 +53249,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,

package/dist/marketing/index.cjs

@@ -3165,14 +3165,17 @@ var lucideAliases = {
   "sort-asc": LucideIcons2__namespace.ArrowUpNarrowWide,
   "sort-desc": LucideIcons2__namespace.ArrowDownNarrowWide
 };
+function isComponentLike(v) {
+  return v != null && (typeof v === "function" || typeof v === "object");
+}
 function resolveLucide(name) {
   if (lucideAliases[name]) return lucideAliases[name];
   const pascal = kebabToPascal(name);
   const lucideMap = LucideIcons2__namespace;
   const direct = lucideMap[pascal];
-  if (direct && typeof direct === "function") return direct;
+  if (isComponentLike(direct)) return direct;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "function") return asIs;
+  if (isComponentLike(asIs)) return asIs;
   return LucideIcons2__namespace.HelpCircle;
 }
 var phosphorAliases = {
@@ -3806,12 +3809,13 @@ function resolveIcon(name) {
 }
 function doResolve(name) {
   if (iconAliases[name]) return iconAliases[name];
+  const isComponentLike2 = (v) => v != null && (typeof v === "function" || typeof v === "object");
   const pascalName = kebabToPascal2(name);
   const lucideMap = LucideIcons2__namespace;
   const directLookup = lucideMap[pascalName];
-  if (directLookup && typeof directLookup === "object") return directLookup;
+  if (isComponentLike2(directLookup)) return directLookup;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "object") return asIs;
+  if (isComponentLike2(asIs)) return asIs;
   return LucideIcons2__namespace.HelpCircle;
 }
 var sizeClasses = {

package/dist/marketing/index.js

@@ -3141,14 +3141,17 @@ var lucideAliases = {
   "sort-asc": LucideIcons2.ArrowUpNarrowWide,
   "sort-desc": LucideIcons2.ArrowDownNarrowWide
 };
+function isComponentLike(v) {
+  return v != null && (typeof v === "function" || typeof v === "object");
+}
 function resolveLucide(name) {
   if (lucideAliases[name]) return lucideAliases[name];
   const pascal = kebabToPascal(name);
   const lucideMap = LucideIcons2;
   const direct = lucideMap[pascal];
-  if (direct && typeof direct === "function") return direct;
+  if (isComponentLike(direct)) return direct;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "function") return asIs;
+  if (isComponentLike(asIs)) return asIs;
   return LucideIcons2.HelpCircle;
 }
 var phosphorAliases = {
@@ -3782,12 +3785,13 @@ function resolveIcon(name) {
 }
 function doResolve(name) {
   if (iconAliases[name]) return iconAliases[name];
+  const isComponentLike2 = (v) => v != null && (typeof v === "function" || typeof v === "object");
   const pascalName = kebabToPascal2(name);
   const lucideMap = LucideIcons2;
   const directLookup = lucideMap[pascalName];
-  if (directLookup && typeof directLookup === "object") return directLookup;
+  if (isComponentLike2(directLookup)) return directLookup;
   const asIs = lucideMap[name];
-  if (asIs && typeof asIs === "object") return asIs;
+  if (isComponentLike2(asIs)) return asIs;
   return LucideIcons2.HelpCircle;
 }
 var sizeClasses = {