@almadar/ui 4.44.1 → 4.46.0

package/dist/components/molecules/game/ResourceBar.d.ts

@@ -5,7 +5,7 @@ export interface ResourceBarResource {
     /** Resource name */
     label: string;
     /** Current amount */
-    value: number;
+    value?: number;
     /** Maximum amount (displays as bar if provided) */
     max?: number;
 }

package/dist/components/organisms/game/three/index.cjs

@@ -5,12 +5,12 @@ var fiber = require('@react-three/fiber');
 var THREE6 = require('three');
 var jsxRuntime = require('react/jsx-runtime');
 var drei = require('@react-three/drei');
+var logger = require('@almadar/logger');
 var GLTFLoader = require('three/examples/jsm/loaders/GLTFLoader');
 var OrbitControls_js = require('three/examples/jsm/controls/OrbitControls.js');
 var GLTFLoader_js = require('three/examples/jsm/loaders/GLTFLoader.js');
 var OBJLoader_js = require('three/examples/jsm/loaders/OBJLoader.js');
 var providers = require('@almadar/ui/providers');
-var logger = require('@almadar/logger');
 var clsx = require('clsx');
 var tailwindMerge = require('tailwind-merge');
 var postprocessing = require('@react-three/postprocessing');
@@ -253,6 +253,7 @@ function Canvas3DLoadingState({
     /* @__PURE__ */ jsxRuntime.jsx("div", { className: "canvas-3d-loading__background", children: /* @__PURE__ */ jsxRuntime.jsx("div", { className: "bg__grid" }) })
   ] });
 }
+var log = logger.createLogger("almadar:ui:game:canvas3d:error-boundary");
 var Canvas3DErrorBoundary = class extends React21.Component {
   constructor(props) {
     super(props);
@@ -280,8 +281,8 @@ var Canvas3DErrorBoundary = class extends React21.Component {
   componentDidCatch(error, errorInfo) {
     this.setState({ errorInfo });
     this.props.onError?.(error, errorInfo);
-    console.error("[Canvas3DErrorBoundary] Error caught:", error);
-    console.error("[Canvas3DErrorBoundary] Component stack:", errorInfo.componentStack);
+    log.error("Error caught", { error });
+    log.error("Component stack", { componentStack: errorInfo.componentStack ?? "<none>" });
   }
   render() {
     if (this.state.hasError) {
@@ -324,6 +325,7 @@ var Canvas3DErrorBoundary = class extends React21.Component {
     return this.props.children;
   }
 };
+var log2 = logger.createLogger("almadar:ui:game:model-loader");
 function detectAssetRoot(modelUrl) {
   const idx = modelUrl.indexOf("/3d/");
   if (idx !== -1) {
@@ -342,7 +344,7 @@ function useGLTFModel(url, resourceBasePath) {
       setState({ model: null, isLoading: false, error: null });
       return;
     }
-    console.log("[ModelLoader] Loading:", url);
+    log2.debug("Loading", { url });
     setState((prev) => ({ ...prev, isLoading: true, error: null }));
     const assetRoot = resourceBasePath || detectAssetRoot(url);
     const loader = new GLTFLoader.GLTFLoader();
@@ -350,7 +352,7 @@ function useGLTFModel(url, resourceBasePath) {
     loader.load(
       url,
       (gltf) => {
-        console.log("[ModelLoader] Loaded:", url);
+        log2.debug("Loaded", { url });
         setState({
           model: gltf.scene,
           isLoading: false,
@@ -359,8 +361,7 @@ function useGLTFModel(url, resourceBasePath) {
       },
       void 0,
       (err) => {
-        const errorMsg = err instanceof Error ? err.message : String(err);
-        console.warn("[ModelLoader] Failed:", url, errorMsg);
+        log2.warn("Failed", { url, error: err instanceof Error ? err : String(err) });
         setState({
           model: null,
           isLoading: false,
@@ -476,6 +477,7 @@ function ModelLoader({
     }
   );
 }
+var log3 = logger.createLogger("almadar:ui:game:physics");
 function PhysicsObject3D({
   entityId,
   modelUrl,
@@ -564,13 +566,13 @@ function PhysicsObject3D({
 }
 function usePhysics3DController(entityId) {
   const applyForce = (fx, fy, fz) => {
-    console.log(`Apply force to ${entityId}:`, { fx, fy, fz });
+    log3.debug("apply force", { entityId, fx, fy, fz });
   };
   const setVelocity = (vx, vy, vz) => {
-    console.log(`Set velocity for ${entityId}:`, { vx, vy, vz });
+    log3.debug("set velocity", { entityId, vx, vy, vz });
   };
   const setPosition = (x, y, z) => {
-    console.log(`Set position for ${entityId}:`, { x, y, z });
+    log3.debug("set position", { entityId, x, y, z });
   };
   const jump = (force = 10) => {
     applyForce(0, force, 0);
@@ -1376,7 +1378,7 @@ function useRaycaster(options) {
     isWithinCanvas
   };
 }
-var log = logger.createLogger("almadar:eventbus");
+var log4 = logger.createLogger("almadar:eventbus");
 var subLog = logger.createLogger("almadar:eventbus:subscribe");
 var scopeLog = logger.createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
@@ -1396,13 +1398,13 @@ var fallbackEventBus = {
       source
     };
     const handlers = fallbackListeners.get(type);
-    log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
+    log4.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
     if (handlers) {
       handlers.forEach((handler) => {
         try {
           handler(event);
         } catch (error) {
-          console.error(`[EventBus] Error in listener for '${type}':`, error);
+          log4.error("Error in listener", { type, error: error instanceof Error ? error : String(error) });
         }
       });
     }
@@ -1410,7 +1412,7 @@ var fallbackEventBus = {
       try {
         handler(event);
       } catch (error) {
-        console.error(`[EventBus] Error in onAny listener for '${type}':`, error);
+        log4.error("Error in onAny listener", { type, error: error instanceof Error ? error : String(error) });
       }
     });
   },
@@ -2089,6 +2091,7 @@ function FeatureRenderer({
     );
   }) });
 }
+var log5 = logger.createLogger("almadar:ui:game:feature-renderer");
 function detectAssetRoot3(modelUrl) {
   const idx = modelUrl.indexOf("/3d/");
   if (idx !== -1) {
@@ -2238,7 +2241,7 @@ function preloadFeatures(urls) {
       const loader = new GLTFLoader.GLTFLoader();
       loader.setResourcePath(detectAssetRoot3(url));
       loader.load(url, () => {
-        console.log("[FeatureRenderer3D] Preloaded:", url);
+        log5.debug("Preloaded", { url });
       });
     }
   });

package/dist/components/organisms/game/three/index.js

@@ -4,12 +4,12 @@ import * as THREE6 from 'three';
 import { Vector3, QuadraticBezierCurve3, MathUtils, Quaternion } from 'three';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { OrbitControls, Grid, Stars, Sparkles, Html, RoundedBox } from '@react-three/drei';
+import { createLogger } from '@almadar/logger';
 import { GLTFLoader as GLTFLoader$1 } from 'three/examples/jsm/loaders/GLTFLoader';
 import { OrbitControls as OrbitControls$1 } from 'three/examples/jsm/controls/OrbitControls.js';
 import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { OBJLoader } from 'three/examples/jsm/loaders/OBJLoader.js';
 import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
-import { createLogger } from '@almadar/logger';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
 import { EffectComposer, Bloom, DepthOfField, Vignette } from '@react-three/postprocessing';
@@ -229,6 +229,7 @@ function Canvas3DLoadingState({
     /* @__PURE__ */ jsx("div", { className: "canvas-3d-loading__background", children: /* @__PURE__ */ jsx("div", { className: "bg__grid" }) })
   ] });
 }
+var log = createLogger("almadar:ui:game:canvas3d:error-boundary");
 var Canvas3DErrorBoundary = class extends Component {
   constructor(props) {
     super(props);
@@ -256,8 +257,8 @@ var Canvas3DErrorBoundary = class extends Component {
   componentDidCatch(error, errorInfo) {
     this.setState({ errorInfo });
     this.props.onError?.(error, errorInfo);
-    console.error("[Canvas3DErrorBoundary] Error caught:", error);
-    console.error("[Canvas3DErrorBoundary] Component stack:", errorInfo.componentStack);
+    log.error("Error caught", { error });
+    log.error("Component stack", { componentStack: errorInfo.componentStack ?? "<none>" });
   }
   render() {
     if (this.state.hasError) {
@@ -300,6 +301,7 @@ var Canvas3DErrorBoundary = class extends Component {
     return this.props.children;
   }
 };
+var log2 = createLogger("almadar:ui:game:model-loader");
 function detectAssetRoot(modelUrl) {
   const idx = modelUrl.indexOf("/3d/");
   if (idx !== -1) {
@@ -318,7 +320,7 @@ function useGLTFModel(url, resourceBasePath) {
       setState({ model: null, isLoading: false, error: null });
       return;
     }
-    console.log("[ModelLoader] Loading:", url);
+    log2.debug("Loading", { url });
     setState((prev) => ({ ...prev, isLoading: true, error: null }));
     const assetRoot = resourceBasePath || detectAssetRoot(url);
     const loader = new GLTFLoader$1();
@@ -326,7 +328,7 @@ function useGLTFModel(url, resourceBasePath) {
     loader.load(
       url,
       (gltf) => {
-        console.log("[ModelLoader] Loaded:", url);
+        log2.debug("Loaded", { url });
         setState({
           model: gltf.scene,
           isLoading: false,
@@ -335,8 +337,7 @@ function useGLTFModel(url, resourceBasePath) {
       },
       void 0,
       (err) => {
-        const errorMsg = err instanceof Error ? err.message : String(err);
-        console.warn("[ModelLoader] Failed:", url, errorMsg);
+        log2.warn("Failed", { url, error: err instanceof Error ? err : String(err) });
         setState({
           model: null,
           isLoading: false,
@@ -452,6 +453,7 @@ function ModelLoader({
     }
   );
 }
+var log3 = createLogger("almadar:ui:game:physics");
 function PhysicsObject3D({
   entityId,
   modelUrl,
@@ -540,13 +542,13 @@ function PhysicsObject3D({
 }
 function usePhysics3DController(entityId) {
   const applyForce = (fx, fy, fz) => {
-    console.log(`Apply force to ${entityId}:`, { fx, fy, fz });
+    log3.debug("apply force", { entityId, fx, fy, fz });
   };
   const setVelocity = (vx, vy, vz) => {
-    console.log(`Set velocity for ${entityId}:`, { vx, vy, vz });
+    log3.debug("set velocity", { entityId, vx, vy, vz });
   };
   const setPosition = (x, y, z) => {
-    console.log(`Set position for ${entityId}:`, { x, y, z });
+    log3.debug("set position", { entityId, x, y, z });
   };
   const jump = (force = 10) => {
     applyForce(0, force, 0);
@@ -1352,7 +1354,7 @@ function useRaycaster(options) {
     isWithinCanvas
   };
 }
-var log = createLogger("almadar:eventbus");
+var log4 = createLogger("almadar:eventbus");
 var subLog = createLogger("almadar:eventbus:subscribe");
 var scopeLog = createLogger("almadar:ui:trait-scope");
 function getGlobalEventBus() {
@@ -1372,13 +1374,13 @@ var fallbackEventBus = {
       source
     };
     const handlers = fallbackListeners.get(type);
-    log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
+    log4.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
     if (handlers) {
       handlers.forEach((handler) => {
         try {
           handler(event);
         } catch (error) {
-          console.error(`[EventBus] Error in listener for '${type}':`, error);
+          log4.error("Error in listener", { type, error: error instanceof Error ? error : String(error) });
         }
       });
     }
@@ -1386,7 +1388,7 @@ var fallbackEventBus = {
       try {
         handler(event);
       } catch (error) {
-        console.error(`[EventBus] Error in onAny listener for '${type}':`, error);
+        log4.error("Error in onAny listener", { type, error: error instanceof Error ? error : String(error) });
       }
     });
   },
@@ -2065,6 +2067,7 @@ function FeatureRenderer({
     );
   }) });
 }
+var log5 = createLogger("almadar:ui:game:feature-renderer");
 function detectAssetRoot3(modelUrl) {
   const idx = modelUrl.indexOf("/3d/");
   if (idx !== -1) {
@@ -2214,7 +2217,7 @@ function preloadFeatures(urls) {
       const loader = new GLTFLoader$1();
       loader.setResourcePath(detectAssetRoot3(url));
       loader.load(url, () => {
-        console.log("[FeatureRenderer3D] Preloaded:", url);
+        log5.debug("Preloaded", { url });
       });
     }
   });

package/dist/components/organisms/layout/{MasterDetail.d.ts → MasterDetailLayout.d.ts}

@@ -7,7 +7,7 @@
  * Uses wireframe theme styling (high contrast, sharp edges).
  */
 import React from "react";
-export interface MasterDetailProps {
+export interface MasterDetailLayoutProps {
     /** Master panel content (usually a list) */
     master: React.ReactNode;
     /** Detail panel content */
@@ -28,5 +28,5 @@ export interface MasterDetailProps {
 /**
  * MasterDetail - List + detail split layout
  */
-export declare const MasterDetail: React.FC<MasterDetailProps>;
-export default MasterDetail;
+export declare const MasterDetailLayout: React.FC<MasterDetailLayoutProps>;
+export default MasterDetailLayout;

package/dist/components/organisms/layout/index.d.ts

@@ -4,6 +4,6 @@
  * Export layout pattern components for adaptive UI.
  */
 export { SplitPane, type SplitPaneProps } from './SplitPane';
-export { MasterDetail, type MasterDetailProps } from './MasterDetail';
+export { MasterDetailLayout, type MasterDetailLayoutProps } from './MasterDetailLayout';
 export { DashboardGrid, type DashboardGridProps, type DashboardGridCell } from './DashboardGrid';
 export { TabbedContainer, type TabbedContainerProps, type TabDefinition } from './TabbedContainer';

package/dist/context/index.cjs

@@ -4,7 +4,7 @@ var react = require('react');
 var logger = require('@almadar/logger');
 var jsxRuntime = require('react/jsx-runtime');
 
-var slotLog = logger.createLogger("almadar:ui:useUISlots");
+var log = logger.createLogger("almadar:ui:ui-slots");
 var DEFAULT_SOURCE_KEY = "__default__";
 var MULTI_SOURCE_STACK_TRAIT = "__multi_source_stack__";
 var ALL_SLOTS = [
@@ -86,7 +86,7 @@ function useUISlotManager() {
       try {
         callback(slot, content);
       } catch (error) {
-        console.error("[UISlots] Subscriber error:", error);
+        log.error("Subscriber error", { error: error instanceof Error ? error : String(error) });
       }
     });
   }, []);
@@ -98,7 +98,7 @@ function useUISlotManager() {
         try {
           callback(content);
         } catch (error) {
-          console.error(`[UISlots] Trait subscriber error (${traitName}):`, error);
+          log.error("Trait subscriber error", { traitName, error: error instanceof Error ? error : String(error) });
         }
       });
     },
@@ -149,9 +149,12 @@ function useUISlotManager() {
         const slotSources = prev[config.target] ?? {};
         const existing = slotSources[sourceKey];
         if (existing && existing.priority > content.priority) {
-          console.warn(
-            `[UISlots] Slot "${config.target}" source "${sourceKey}" already has higher priority content (${existing.priority} > ${content.priority})`
-          );
+          log.warn("Slot already has higher priority content", {
+            slot: config.target,
+            sourceKey,
+            existingPriority: existing.priority,
+            newPriority: content.priority
+          });
           return prev;
         }
         const nextSources = {
@@ -163,7 +166,7 @@ function useUISlotManager() {
           indexTraitRender(content.sourceTrait, content);
           notifyTraitSubscribers(content.sourceTrait, content);
         }
-        slotLog.info("slot:written", {
+        log.info("slot:written", {
           slot: config.target,
           sourceKey,
           sourceTrait: content.sourceTrait,
@@ -208,7 +211,7 @@ function useUISlotManager() {
       setSources((prev) => {
         const slotSources = prev[slot];
         if (!slotSources || !(sourceKey in slotSources)) {
-          slotLog.debug("slot:clear-noop", { slot, sourceTrait, reason: !slotSources ? "no-slot" : "no-source" });
+          log.debug("slot:clear-noop", { slot, sourceTrait, reason: !slotSources ? "no-slot" : "no-source" });
           return prev;
         }
         const content = slotSources[sourceKey];
@@ -224,7 +227,7 @@ function useUISlotManager() {
         }
         const nextSources = { ...slotSources };
         delete nextSources[sourceKey];
-        slotLog.info("slot:cleared", { slot, sourceTrait, lastPatternType: content.pattern });
+        log.info("slot:cleared", { slot, sourceTrait, lastPatternType: content.pattern });
         notifySubscribers(slot, aggregateSlot(nextSources));
         return { ...prev, [slot]: nextSources };
       });
@@ -366,6 +369,7 @@ function useSlotHasContent(slot) {
   const { hasContent } = useUISlots();
   return hasContent(slot);
 }
+var log2 = logger.createLogger("almadar:ui:theme");
 var BUILT_IN_THEMES = [
   {
     name: "wireframe",
@@ -555,9 +559,10 @@ var ThemeProvider = ({
           localStorage.setItem(THEME_STORAGE_KEY, newTheme);
         }
       } else {
-        console.warn(
-          `Theme "${newTheme}" not found. Available: ${availableThemes.map((t) => t.name).join(", ")}`
-        );
+        log2.warn("Theme not found", {
+          theme: newTheme,
+          available: availableThemes.map((t) => t.name)
+        });
       }
     },
     [availableThemes]

package/dist/context/index.js

@@ -2,7 +2,7 @@ import { createContext, useMemo, useContext, useState, useEffect, useCallback, u
 import { createLogger } from '@almadar/logger';
 import { jsx } from 'react/jsx-runtime';
 
-var slotLog = createLogger("almadar:ui:useUISlots");
+var log = createLogger("almadar:ui:ui-slots");
 var DEFAULT_SOURCE_KEY = "__default__";
 var MULTI_SOURCE_STACK_TRAIT = "__multi_source_stack__";
 var ALL_SLOTS = [
@@ -84,7 +84,7 @@ function useUISlotManager() {
       try {
         callback(slot, content);
       } catch (error) {
-        console.error("[UISlots] Subscriber error:", error);
+        log.error("Subscriber error", { error: error instanceof Error ? error : String(error) });
       }
     });
   }, []);
@@ -96,7 +96,7 @@ function useUISlotManager() {
         try {
           callback(content);
         } catch (error) {
-          console.error(`[UISlots] Trait subscriber error (${traitName}):`, error);
+          log.error("Trait subscriber error", { traitName, error: error instanceof Error ? error : String(error) });
         }
       });
     },
@@ -147,9 +147,12 @@ function useUISlotManager() {
         const slotSources = prev[config.target] ?? {};
         const existing = slotSources[sourceKey];
         if (existing && existing.priority > content.priority) {
-          console.warn(
-            `[UISlots] Slot "${config.target}" source "${sourceKey}" already has higher priority content (${existing.priority} > ${content.priority})`
-          );
+          log.warn("Slot already has higher priority content", {
+            slot: config.target,
+            sourceKey,
+            existingPriority: existing.priority,
+            newPriority: content.priority
+          });
           return prev;
         }
         const nextSources = {
@@ -161,7 +164,7 @@ function useUISlotManager() {
           indexTraitRender(content.sourceTrait, content);
           notifyTraitSubscribers(content.sourceTrait, content);
         }
-        slotLog.info("slot:written", {
+        log.info("slot:written", {
           slot: config.target,
           sourceKey,
           sourceTrait: content.sourceTrait,
@@ -206,7 +209,7 @@ function useUISlotManager() {
       setSources((prev) => {
         const slotSources = prev[slot];
         if (!slotSources || !(sourceKey in slotSources)) {
-          slotLog.debug("slot:clear-noop", { slot, sourceTrait, reason: !slotSources ? "no-slot" : "no-source" });
+          log.debug("slot:clear-noop", { slot, sourceTrait, reason: !slotSources ? "no-slot" : "no-source" });
           return prev;
         }
         const content = slotSources[sourceKey];
@@ -222,7 +225,7 @@ function useUISlotManager() {
         }
         const nextSources = { ...slotSources };
         delete nextSources[sourceKey];
-        slotLog.info("slot:cleared", { slot, sourceTrait, lastPatternType: content.pattern });
+        log.info("slot:cleared", { slot, sourceTrait, lastPatternType: content.pattern });
         notifySubscribers(slot, aggregateSlot(nextSources));
         return { ...prev, [slot]: nextSources };
       });
@@ -364,6 +367,7 @@ function useSlotHasContent(slot) {
   const { hasContent } = useUISlots();
   return hasContent(slot);
 }
+var log2 = createLogger("almadar:ui:theme");
 var BUILT_IN_THEMES = [
   {
     name: "wireframe",
@@ -553,9 +557,10 @@ var ThemeProvider = ({
           localStorage.setItem(THEME_STORAGE_KEY, newTheme);
         }
       } else {
-        console.warn(
-          `Theme "${newTheme}" not found. Available: ${availableThemes.map((t) => t.name).join(", ")}`
-        );
+        log2.warn("Theme not found", {
+          theme: newTheme,
+          available: availableThemes.map((t) => t.name)
+        });
       }
     },
     [availableThemes]

package/dist/docs/index.cjs

@@ -2540,7 +2540,7 @@ var fallbackEventBus = {
         try {
           handler(event);
         } catch (error) {
-          console.error(`[EventBus] Error in listener for '${type}':`, error);
+          log.error("Error in listener", { type, error: error instanceof Error ? error : String(error) });
         }
       });
     }
@@ -2548,7 +2548,7 @@ var fallbackEventBus = {
       try {
         handler(event);
       } catch (error) {
-        console.error(`[EventBus] Error in onAny listener for '${type}':`, error);
+        log.error("Error in onAny listener", { type, error: error instanceof Error ? error : String(error) });
       }
     });
   },

package/dist/docs/index.js

@@ -2516,7 +2516,7 @@ var fallbackEventBus = {
         try {
           handler(event);
         } catch (error) {
-          console.error(`[EventBus] Error in listener for '${type}':`, error);
+          log.error("Error in listener", { type, error: error instanceof Error ? error : String(error) });
         }
       });
     }
@@ -2524,7 +2524,7 @@ var fallbackEventBus = {
       try {
         handler(event);
       } catch (error) {
-        console.error(`[EventBus] Error in onAny listener for '${type}':`, error);
+        log.error("Error in onAny listener", { type, error: error instanceof Error ? error : String(error) });
       }
     });
   },