@almadar/ui 4.44.0 → 4.45.0

package/dist/avl/index.js

@@ -2,7 +2,7 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { OrbitControls as OrbitControls$1, Grid as Grid$1, Stars, Sparkles, Html, RoundedBox } from '@react-three/drei';
 import * as React147 from 'react';
 import React147__default, { createContext, useState, useEffect, useMemo, useContext, useRef, useCallback, Suspense, useLayoutEffect, useReducer, lazy, useId, forwardRef, useImperativeHandle, Component } from 'react';
-import { createLogger } from '@almadar/logger';
+import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import ELK from 'elkjs/lib/elk.bundled.js';
 import { MarkerType, Handle, Position, getBezierPath, EdgeLabelRenderer, BaseEdge, ReactFlowProvider, useNodesState, useEdgesState, useReactFlow, ReactFlow, Controls, Background, BackgroundVariant } from '@xyflow/react';
 import * as LucideIcons from 'lucide-react';
@@ -3302,24 +3302,24 @@ function captureSubscriberTag(listener) {
   }
   return "unknown";
 }
-function EventBusProvider({ children, debug: debug2 = false }) {
+function EventBusProvider({ children }) {
   const listenersRef = useRef(/* @__PURE__ */ new Map());
   const anyListenersRef = useRef(/* @__PURE__ */ new Set());
   const deprecationWarningShown = useRef(false);
   const getSelectedEntity = useCallback(() => {
     if (!deprecationWarningShown.current) {
-      console.warn(
-        "[EventBus] getSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
-      );
+      busLog.warn("deprecated:getSelectedEntity", {
+        migration: "Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
+      });
       deprecationWarningShown.current = true;
     }
     return null;
   }, []);
   const clearSelectedEntity = useCallback(() => {
     if (!deprecationWarningShown.current) {
-      console.warn(
-        "[EventBus] clearSelectedEntity is deprecated. Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
-      );
+      busLog.warn("deprecated:clearSelectedEntity", {
+        migration: "Use SelectionProvider and useSelection hook instead. See SelectionProvider.tsx for migration guide."
+      });
       deprecationWarningShown.current = true;
     }
   }, []);
@@ -3333,12 +3333,8 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     const listeners6 = listenersRef.current.get(type);
     const listenerCount = (listeners6?.size ?? 0) + anyListenersRef.current.size;
     busLog.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount });
-    if (debug2) {
-      if (listenerCount > 0) {
-        console.log(`[EventBus] Emit: ${type} \u2192 ${listenerCount} listener(s)`, payload);
-      } else {
-        console.warn(`[EventBus] Emit: ${type} (NO LISTENERS - event may be lost!)`, payload);
-      }
+    if (listenerCount === 0) {
+      busLog.warn("emit:no-listeners", { type });
     }
     if (listeners6) {
       const listenersCopy = Array.from(listeners6);
@@ -3353,7 +3349,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
         try {
           listener(event);
         } catch (error) {
-          console.error(`[EventBus] Error in listener for '${type}':`, error);
+          busLog.error("listener-threw", { type, error: error instanceof Error ? error : String(error) });
         }
       }
     }
@@ -3369,10 +3365,10 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       try {
         listener(event);
       } catch (error) {
-        console.error(`[EventBus] Error in onAny listener for '${type}':`, error);
+        busLog.error("onAny-listener-threw", { type, error: error instanceof Error ? error : String(error) });
       }
     }
-  }, [debug2]);
+  }, []);
   const on = useCallback((type, listener) => {
     if (!listenersRef.current.has(type)) {
       listenersRef.current.set(type, /* @__PURE__ */ new Set());
@@ -3381,19 +3377,14 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     listeners6.add(listener);
     if (!listenerTags.has(listener)) listenerTags.set(listener, captureSubscriberTag(listener));
     subLog.debug("subscribe", { type, totalListeners: listeners6.size, tag: listenerTags.get(listener) });
-    if (debug2) {
-      console.log(`[EventBus] Subscribed to '${type}', total: ${listeners6.size}`);
-    }
     return () => {
       listeners6.delete(listener);
-      if (debug2) {
-        console.log(`[EventBus] Unsubscribed from '${type}', remaining: ${listeners6.size}`);
-      }
+      subLog.debug("unsubscribe", { type, remaining: listeners6.size });
       if (listeners6.size === 0) {
         listenersRef.current.delete(type);
       }
     };
-  }, [debug2]);
+  }, []);
   const once = useCallback((type, listener) => {
     const wrappedListener = (event) => {
       listenersRef.current.get(type)?.delete(wrappedListener);
@@ -3409,16 +3400,11 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     anyListenersRef.current.add(listener);
     if (!listenerTags.has(listener)) listenerTags.set(listener, captureSubscriberTag(listener));
     subLog.debug("subscribe:any", { totalAnyListeners: anyListenersRef.current.size, tag: listenerTags.get(listener) });
-    if (debug2) {
-      console.log(`[EventBus] onAny subscribed, total: ${anyListenersRef.current.size}`);
-    }
     return () => {
       anyListenersRef.current.delete(listener);
-      if (debug2) {
-        console.log(`[EventBus] onAny unsubscribed, remaining: ${anyListenersRef.current.size}`);
-      }
+      subLog.debug("unsubscribe:any", { remaining: anyListenersRef.current.size });
     };
-  }, [debug2]);
+  }, []);
   const contextValue = useMemo(
     () => ({
       emit,
@@ -3578,7 +3564,7 @@ var init_useEventBus = __esm({
             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) });
             }
           });
         }
@@ -3586,7 +3572,7 @@ var init_useEventBus = __esm({
           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) });
           }
         });
       },
@@ -4898,7 +4884,7 @@ var init_ModuleCard = __esm({
     ModuleCard.displayName = "ModuleCard";
   }
 });
-var SWIM_GUTTER, CENTER_W, BehaviorView;
+var log2, SWIM_GUTTER, CENTER_W, BehaviorView;
 var init_BehaviorView = __esm({
   "components/molecules/avl/BehaviorView.tsx"() {
     "use client";
@@ -4907,6 +4893,7 @@ var init_BehaviorView = __esm({
     init_AvlSwimLane();
     init_types();
     init_avl_elk_layout();
+    log2 = createLogger("almadar:ui:avl:behavior-view");
     SWIM_GUTTER = 120;
     CENTER_W = 360;
     BehaviorView = ({ data }) => {
@@ -4916,7 +4903,7 @@ var init_BehaviorView = __esm({
       const dataKey = useMemo(() => JSON.stringify(traitData), [traitData]);
       useEffect(() => {
         if (!traitData) return;
-        computeTraitLayout(traitData).then(setLayout).catch(console.error);
+        computeTraitLayout(traitData).then(setLayout).catch((err) => log2.error("compute-trait-layout-failed", { error: err instanceof Error ? err : String(err) }));
       }, [dataKey]);
       if (!traitData) {
         return /* @__PURE__ */ jsx("div", { className: "rounded-lg border border-[var(--color-border)] bg-[var(--color-card)] p-4 text-center text-[var(--color-muted-foreground)] text-sm", children: "No trait data" });
@@ -5042,10 +5029,11 @@ function useTheme() {
   }
   return context;
 }
-var BUILT_IN_THEMES, ThemeContext, THEME_STORAGE_KEY, MODE_STORAGE_KEY, ThemeProvider;
+var log3, BUILT_IN_THEMES, ThemeContext, THEME_STORAGE_KEY, MODE_STORAGE_KEY, ThemeProvider;
 var init_ThemeContext = __esm({
   "context/ThemeContext.tsx"() {
     "use client";
+    log3 = createLogger("almadar:ui:theme");
     BUILT_IN_THEMES = [
       {
         name: "wireframe",
@@ -5225,9 +5213,10 @@ var init_ThemeContext = __esm({
               localStorage.setItem(THEME_STORAGE_KEY, newTheme);
             }
           } else {
-            console.warn(
-              `Theme "${newTheme}" not found. Available: ${availableThemes.map((t) => t.name).join(", ")}`
-            );
+            log3.warn("Theme not found", {
+              theme: newTheme,
+              available: availableThemes.map((t) => t.name)
+            });
           }
         },
         [availableThemes]
@@ -5363,7 +5352,7 @@ function useUISlotManager() {
       try {
         callback(slot, content);
       } catch (error) {
-        console.error("[UISlots] Subscriber error:", error);
+        log5.error("Subscriber error", { error: error instanceof Error ? error : String(error) });
       }
     });
   }, []);
@@ -5375,7 +5364,7 @@ function useUISlotManager() {
         try {
           callback(content);
         } catch (error) {
-          console.error(`[UISlots] Trait subscriber error (${traitName}):`, error);
+          log5.error("Trait subscriber error", { traitName, error: error instanceof Error ? error : String(error) });
         }
       });
     },
@@ -5426,9 +5415,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})`
-          );
+          log5.warn("Slot already has higher priority content", {
+            slot: config.target,
+            sourceKey,
+            existingPriority: existing.priority,
+            newPriority: content.priority
+          });
           return prev;
         }
         const nextSources = {
@@ -5440,7 +5432,7 @@ function useUISlotManager() {
           indexTraitRender(content.sourceTrait, content);
           notifyTraitSubscribers(content.sourceTrait, content);
         }
-        slotLog.info("slot:written", {
+        log5.info("slot:written", {
           slot: config.target,
           sourceKey,
           sourceTrait: content.sourceTrait,
@@ -5485,7 +5477,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" });
+          log5.debug("slot:clear-noop", { slot, sourceTrait, reason: !slotSources ? "no-slot" : "no-source" });
           return prev;
         }
         const content = slotSources[sourceKey];
@@ -5501,7 +5493,7 @@ function useUISlotManager() {
         }
         const nextSources = { ...slotSources };
         delete nextSources[sourceKey];
-        slotLog.info("slot:cleared", { slot, sourceTrait, lastPatternType: content.pattern });
+        log5.info("slot:cleared", { slot, sourceTrait, lastPatternType: content.pattern });
         notifySubscribers(slot, aggregateSlot(nextSources));
         return { ...prev, [slot]: nextSources };
       });
@@ -5620,11 +5612,11 @@ function useUISlotManager() {
     updateTraitContent
   };
 }
-var slotLog, DEFAULT_SOURCE_KEY, MULTI_SOURCE_STACK_TRAIT, ALL_SLOTS, DEFAULT_SLOTS, DEFAULT_SOURCES, idCounter;
+var log5, DEFAULT_SOURCE_KEY, MULTI_SOURCE_STACK_TRAIT, ALL_SLOTS, DEFAULT_SLOTS, DEFAULT_SOURCES, idCounter;
 var init_useUISlots = __esm({
   "hooks/useUISlots.ts"() {
     "use client";
-    slotLog = createLogger("almadar:ui:useUISlots");
+    log5 = createLogger("almadar:ui:ui-slots");
     DEFAULT_SOURCE_KEY = "__default__";
     MULTI_SOURCE_STACK_TRAIT = "__multi_source_stack__";
     ALL_SLOTS = [
@@ -6528,10 +6520,10 @@ function refId(obj) {
   refIds.set(obj, id);
   return id;
 }
-var slotLog2, refIds, nextRefId;
+var slotLog, refIds, nextRefId;
 var init_slot_types = __esm({
   "runtime/ui/slot-types.ts"() {
-    slotLog2 = createLogger("almadar:ui:slot-render");
+    slotLog = createLogger("almadar:ui:slot-render");
     refIds = /* @__PURE__ */ new WeakMap();
     nextRefId = 1;
   }
@@ -12176,6 +12168,7 @@ function getAllPages(schema) {
 var init_navigation = __esm({
   "renderer/navigation.tsx"() {
     "use client";
+    createLogger("almadar:ui:navigation");
     createContext(null);
   }
 });
@@ -14653,7 +14646,7 @@ function recordTransition(trace) {
     ...trace,
     id: `t-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`
   };
-  log2.info("transition:recorded", { trait: trace.traitName, from: trace.from, to: trace.to, event: trace.event, effectCount: trace.effects.length });
+  log7.debug("transition:recorded", { trait: trace.traitName, from: trace.from, to: trace.to, event: trace.event, effectCount: trace.effects.length });
   getState().transitions.push(entry);
   if (getState().transitions.length > MAX_TRANSITIONS) {
     getState().transitions.shift();
@@ -14752,7 +14745,7 @@ function getTraitSnapshots() {
     try {
       snapshots.push(getter());
     } catch (err) {
-      log2.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
+      log7.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
     }
   }
   return snapshots;
@@ -14800,12 +14793,12 @@ function waitForTransition(event, timeoutMs = 1e4) {
 }
 function bindEventBus(eventBus) {
   if (typeof window === "undefined") return;
-  log2.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
+  log7.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
     window.__orbitalVerification.sendEvent = (event, payload, traitScope) => {
       const prefixed = event.startsWith("UI:") ? event : traitScope ? `UI:${traitScope}.${event}` : `UI:${event}`;
-      log2.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
+      log7.debug("sendEvent", { event: prefixed, traitScope, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -14868,10 +14861,10 @@ function updateAssetStatus(url, status) {
     window.__orbitalVerification.assetStatus[url] = status;
   }
 }
-var log2, MAX_TRANSITIONS;
+var log7, MAX_TRANSITIONS;
 var init_verificationRegistry = __esm({
   "lib/verificationRegistry.ts"() {
-    log2 = createLogger("almadar:bridge");
+    log7 = createLogger("almadar:bridge");
     MAX_TRANSITIONS = 500;
     exposeOnWindow();
   }
@@ -16432,7 +16425,7 @@ function computeFoldRegions(code) {
   }
   return regions.sort((a, b) => a.start - b.start);
 }
-var orbStyleOverrides, orbStyle, loloStyleOverrides, loloStyle, LINE_PROPS_FN, HIDDEN_LINE_NUMBERS, CodeBlock;
+var orbStyleOverrides, orbStyle, loloStyleOverrides, loloStyle, log8, LINE_PROPS_FN, HIDDEN_LINE_NUMBERS, CodeBlock;
 var init_CodeBlock = __esm({
   "components/molecules/markdown/CodeBlock.tsx"() {
     init_Box();
@@ -16509,6 +16502,7 @@ var init_CodeBlock = __esm({
       "lolo-op-async": { color: ORB_COLORS.dark.async }
     };
     loloStyle = { ...dark, ...loloStyleOverrides };
+    log8 = createLogger("almadar:ui:markdown-code");
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
     CodeBlock = React147__default.memo(
@@ -16707,7 +16701,7 @@ var init_CodeBlock = __esm({
             eventBus.emit("UI:COPY_CODE", { language, success: true });
             setTimeout(() => setCopied(false), 2e3);
           } catch (err) {
-            console.error("Failed to copy code:", err);
+            log8.error("Failed to copy code", { error: err instanceof Error ? err : String(err) });
             eventBus.emit("UI:COPY_CODE", { language, success: false });
           }
         };
@@ -20269,13 +20263,14 @@ function useSafeEventBus2() {
     } };
   }
 }
-var ButtonGroup;
+var log9, ButtonGroup;
 var init_ButtonGroup = __esm({
   "components/molecules/ButtonGroup.tsx"() {
     "use client";
     init_cn();
     init_atoms();
     init_useEventBus();
+    log9 = createLogger("almadar:ui:button-group");
     ButtonGroup = ({
       children,
       primary,
@@ -20348,7 +20343,7 @@ var init_ButtonGroup = __esm({
           {
             variant: "ghost",
             onClick: () => {
-              console.log(`Filter clicked: ${filter.field}`);
+              log9.debug("Filter clicked", { field: filter.field });
             },
             children: filter.label
           },
@@ -26365,31 +26360,56 @@ var init_InputGroup = __esm({
     InputGroup.displayName = "InputGroup";
   }
 });
-
-// lib/debug.ts
+function gateEnabled(level, ns = NAMESPACE) {
+  return isLogLevelEnabled(level, ns);
+}
 function isDebugEnabled() {
-  if (DEBUG_ENABLED) return true;
-  return typeof window !== "undefined" && window.__ALMADAR_DEBUG_VERIFY__ === true;
+  return gateEnabled("DEBUG");
 }
 function debug(...args) {
-  if (isDebugEnabled()) {
-    console.log("[DEBUG]", ...args);
+  if (!gateEnabled("DEBUG")) return;
+  const [first, ...rest] = args;
+  const message = typeof first === "string" ? first : "<debug>";
+  if (rest.length === 0 && typeof first === "string") {
+    log10.debug(message);
+  } else {
+    log10.debug(message, { args: rest.length > 0 ? formatArgs(rest) : formatArgs([first]) });
   }
 }
 function debugGroup(label) {
-  if (isDebugEnabled()) {
-    console.group(`[DEBUG] ${label}`);
-  }
+  if (gateEnabled("DEBUG")) console.group(`[${NAMESPACE}] ${label}`);
 }
 function debugGroupEnd() {
-  if (isDebugEnabled()) {
-    console.groupEnd();
+  if (gateEnabled("DEBUG")) console.groupEnd();
+}
+function formatArgs(values) {
+  if (values.length === 1) return toLogMetaValue(values[0]);
+  return values.map(toLogMetaValue);
+}
+function toLogMetaValue(v) {
+  if (v === null || v === void 0) return v;
+  if (v instanceof Error) return v;
+  const t = typeof v;
+  if (t === "string" || t === "number" || t === "boolean") return v;
+  if (Array.isArray(v)) return v.map(toLogMetaValue);
+  if (t === "object") {
+    const out = {};
+    for (const [k, val] of Object.entries(v)) {
+      out[k] = toLogMetaValue(val);
+    }
+    return out;
   }
+  return String(v);
 }
-var DEBUG_ENABLED;
+var NAMESPACE, log10;
 var init_debug = __esm({
   "lib/debug.ts"() {
-    DEBUG_ENABLED = typeof window !== "undefined" && (localStorage.getItem("debug") === "true" || process.env.NODE_ENV === "development");
+    NAMESPACE = "almadar:ui:debug";
+    log10 = createLogger(NAMESPACE);
+    createLogger("almadar:ui:debug:input");
+    createLogger("almadar:ui:debug:collision");
+    createLogger("almadar:ui:debug:physics");
+    createLogger("almadar:ui:debug:game-state");
   }
 });
 var isRelationsDebugEnabled, RelationSelect;
@@ -42362,7 +42382,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log4, setLog] = React147.useState([]);
+  const [log18, setLog] = React147.useState([]);
   const prevStatesRef = React147.useRef(/* @__PURE__ */ new Map());
   React147.useEffect(() => {
     for (const trait of traits2) {
@@ -42426,9 +42446,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Other Events (not available from current state)" }),
       /* @__PURE__ */ jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log4.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log18.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
       /* @__PURE__ */ jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Recent Transitions" }),
-      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log4.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log18.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -46798,10 +46818,11 @@ var init_Canvas3DErrorBoundary = __esm({
   "components/organisms/game/three/components/Canvas3DErrorBoundary.css"() {
   }
 });
-var Canvas3DErrorBoundary;
+var log11, Canvas3DErrorBoundary;
 var init_Canvas3DErrorBoundary2 = __esm({
   "components/organisms/game/three/components/Canvas3DErrorBoundary.tsx"() {
     init_Canvas3DErrorBoundary();
+    log11 = createLogger("almadar:ui:game:canvas3d:error-boundary");
     Canvas3DErrorBoundary = class extends Component {
       constructor(props) {
         super(props);
@@ -46829,8 +46850,8 @@ var init_Canvas3DErrorBoundary2 = __esm({
       componentDidCatch(error, errorInfo) {
         this.setState({ errorInfo });
         this.props.onError?.(error, errorInfo);
-        console.error("[Canvas3DErrorBoundary] Error caught:", error);
-        console.error("[Canvas3DErrorBoundary] Component stack:", errorInfo.componentStack);
+        log11.error("Error caught", { error });
+        log11.error("Component stack", { componentStack: errorInfo.componentStack ?? "<none>" });
       }
       render() {
         if (this.state.hasError) {
@@ -46893,7 +46914,7 @@ function useGLTFModel(url, resourceBasePath) {
       setState({ model: null, isLoading: false, error: null });
       return;
     }
-    console.log("[ModelLoader] Loading:", url);
+    log12.debug("Loading", { url });
     setState((prev) => ({ ...prev, isLoading: true, error: null }));
     const assetRoot = resourceBasePath || detectAssetRoot(url);
     const loader = new GLTFLoader();
@@ -46901,7 +46922,7 @@ function useGLTFModel(url, resourceBasePath) {
     loader.load(
       url,
       (gltf) => {
-        console.log("[ModelLoader] Loaded:", url);
+        log12.debug("Loaded", { url });
         setState({
           model: gltf.scene,
           isLoading: false,
@@ -46910,8 +46931,7 @@ function useGLTFModel(url, resourceBasePath) {
       },
       void 0,
       (err) => {
-        const errorMsg = err instanceof Error ? err.message : String(err);
-        console.warn("[ModelLoader] Failed:", url, errorMsg);
+        log12.warn("Failed", { url, error: err instanceof Error ? err : String(err) });
         setState({
           model: null,
           isLoading: false,
@@ -47027,9 +47047,11 @@ function ModelLoader({
     }
   );
 }
+var log12;
 var init_ModelLoader = __esm({
   "components/organisms/game/three/components/ModelLoader.tsx"() {
     "use client";
+    log12 = createLogger("almadar:ui:game:model-loader");
   }
 });
 function PhysicsObject3D({
@@ -47120,13 +47142,13 @@ function PhysicsObject3D({
 }
 function usePhysics3DController(entityId) {
   const applyForce = (fx, fy, fz) => {
-    console.log(`Apply force to ${entityId}:`, { fx, fy, fz });
+    log13.debug("apply force", { entityId, fx, fy, fz });
   };
   const setVelocity = (vx, vy, vz) => {
-    console.log(`Set velocity for ${entityId}:`, { vx, vy, vz });
+    log13.debug("set velocity", { entityId, vx, vy, vz });
   };
   const setPosition = (x, y, z) => {
-    console.log(`Set position for ${entityId}:`, { x, y, z });
+    log13.debug("set position", { entityId, x, y, z });
   };
   const jump = (force = 10) => {
     applyForce(0, force, 0);
@@ -47138,10 +47160,12 @@ function usePhysics3DController(entityId) {
     jump
   };
 }
+var log13;
 var init_PhysicsObject3D = __esm({
   "components/organisms/game/three/components/PhysicsObject3D.tsx"() {
     "use client";
     init_ModelLoader();
+    log13 = createLogger("almadar:ui:game:physics");
   }
 });
 function detectAssetRoot2(modelUrl) {
@@ -48727,14 +48751,16 @@ function preloadFeatures(urls) {
       const loader = new GLTFLoader();
       loader.setResourcePath(detectAssetRoot3(url));
       loader.load(url, () => {
-        console.log("[FeatureRenderer3D] Preloaded:", url);
+        log14.debug("Preloaded", { url });
       });
     }
   });
 }
+var log14;
 var init_FeatureRenderer3D = __esm({
   "components/organisms/game/three/renderers/FeatureRenderer3D.tsx"() {
     "use client";
+    log14 = createLogger("almadar:ui:game:feature-renderer");
   }
 });
 
@@ -52821,7 +52847,7 @@ function MaybeTraitScope({
   const schemaCtx = useEntitySchemaOptional();
   const orbital = sourceTrait !== void 0 && schemaCtx !== null ? schemaCtx.orbitalsByTrait.get(sourceTrait) : void 0;
   const wrap = sourceTrait !== void 0 && orbital !== void 0;
-  scopeWrapLog.info("decide", {
+  scopeWrapLog.debug("decide", {
     sourceTrait,
     schemaCtxPresent: schemaCtx !== null,
     orbitalsByTraitSize: schemaCtx?.orbitalsByTrait.size ?? 0,
@@ -53216,7 +53242,7 @@ function SlotContentRenderer({
 }) {
   const entityProp = content.props.entity;
   if (content.pattern === "form-section") {
-    slotLog2.debug("SlotContentRenderer:form-section-render", {
+    slotLog.debug("SlotContentRenderer:form-section-render", {
       contentId: content.id,
       sourceTrait: content.sourceTrait,
       entityRefId: refId(entityProp),
@@ -56262,6 +56288,7 @@ init_EventBusProvider();
 
 // providers/SelectionProvider.tsx
 init_useEventBus();
+var log4 = createLogger("almadar:ui:selection");
 var SelectionContext = createContext(null);
 var defaultCompareEntities = (a, b) => {
   if (a === b) return true;
@@ -56284,7 +56311,10 @@ function SelectionProvider({
     (entity) => {
       setSelectedState(entity);
       if (debug2) {
-        console.log("[SelectionProvider] Selection set:", entity);
+        log4.debug("Selection set", () => ({
+          hasEntity: entity !== null && entity !== void 0,
+          entityId: entity && typeof entity === "object" ? String(entity.id ?? "") : ""
+        }));
       }
     },
     [debug2]
@@ -56292,7 +56322,7 @@ function SelectionProvider({
   const clearSelection = useCallback(() => {
     setSelectedState(null);
     if (debug2) {
-      console.log("[SelectionProvider] Selection cleared");
+      log4.debug("Selection cleared");
     }
   }, [debug2]);
   const isSelected = useCallback(
@@ -56307,14 +56337,17 @@ function SelectionProvider({
       if (row) {
         setSelected(row);
         if (debug2) {
-          console.log(`[SelectionProvider] ${event.type} received:`, row);
+          log4.debug("event received", () => ({
+            type: event.type,
+            rowId: row && typeof row === "object" ? String(row.id ?? "") : ""
+          }));
         }
       }
     };
     const handleDeselect = (event) => {
       clearSelection();
       if (debug2) {
-        console.log(`[SelectionProvider] ${event.type} received - clearing selection`);
+        log4.debug("event received - clearing selection", { type: event.type });
       }
     };
     const unsubView = eventBus.on("UI:VIEW", handleSelect);
@@ -56345,7 +56378,7 @@ init_UISlotRenderer();
 // providers/VerificationProvider.tsx
 init_useEventBus();
 init_verificationRegistry();
-var log3 = createLogger("almadar:verify");
+var log15 = createLogger("almadar:verify");
 var DISPATCH_SUFFIX = ":DISPATCH";
 var SUCCESS_SUFFIX = ":SUCCESS";
 var ERROR_SUFFIX = ":ERROR";
@@ -56391,7 +56424,7 @@ function VerificationProvider({
     const verificationProviderLifecycleListener = (evt) => {
       const parsed = parseLifecycleEvent(evt.type);
       if (!parsed) return;
-      log3.debug("lifecycle:event", { kind: parsed.kind, traitName: parsed.traitName, event: parsed.event, type: evt.type });
+      log15.debug("lifecycle:event", { kind: parsed.kind, traitName: parsed.traitName, event: parsed.event, type: evt.type });
       const payload = evt.payload ?? {};
       if (parsed.kind === "dispatch") {
         const key = `${parsed.traitName}:${String(payload["event"] ?? "")}`;
@@ -56446,7 +56479,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
-        log3.info("transition:success", { trait: parsed.traitName, event: parsed.event, from: pending?.from, to: newState, effectCount: effects.length });
+        log15.debug("transition:success", { trait: parsed.traitName, event: parsed.event, from: pending?.from, to: newState, effectCount: effects.length });
       } else if (parsed.kind === "error" && parsed.event) {
         const key = `${parsed.traitName}:${parsed.event}`;
         const pending = pendingRef.current.get(key);
@@ -56476,7 +56509,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
-        log3.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
+        log15.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
       }
     };
     Object.defineProperty(verificationProviderLifecycleListener, "name", {
@@ -56629,7 +56662,11 @@ function useResolvedSchema(schema, pageName) {
       };
     }
     const page = getPage(ir, pageName);
-    console.log("[useResolvedSchema] Resolved page:", page?.name, "| path:", page?.path, "| traits:", page?.traits.length);
+    resolvedSchemaLog.debug("Resolved page", () => ({
+      name: page?.name,
+      path: page?.path,
+      traits: page?.traits.length
+    }));
     const traits2 = page?.traits || [];
     const entities = /* @__PURE__ */ new Map();
     if (page) {
@@ -56832,8 +56869,7 @@ function convertFnFormLambdasInProps(props) {
 // hooks/index.ts
 init_useEventBus();
 var ALMADAR_DND_MIME = "application/x-almadar-dnd";
-
-// runtime/createClientEffectHandlers.ts
+var log16 = createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
   const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
@@ -56842,10 +56878,10 @@ function createClientEffectHandlers(options) {
       eventBus.emit(prefixedEvent, payload);
     },
     persist: async () => {
-      console.warn("[ClientEffectHandlers] persist is server-side only, ignored on client");
+      log16.warn("persist is server-side only, ignored on client");
     },
     set: () => {
-      console.warn("[ClientEffectHandlers] set is server-side only, ignored on client");
+      log16.warn("set is server-side only, ignored on client");
     },
     callService: async (service, action, params) => {
       if (callService) return callService(service, action, params);
@@ -56874,10 +56910,10 @@ function createClientEffectHandlers(options) {
       slotSetter.addPattern(slot, pattern, props);
     },
     navigate: navigate ?? ((path) => {
-      console.warn("[ClientEffectHandlers] No navigate handler, ignoring:", path);
+      log16.warn("No navigate handler, ignoring", { path });
     }),
     notify: notify ?? ((msg, type) => {
-      console.log(`[ClientEffectHandlers] notify (${type}):`, msg);
+      log16.debug("notify", { type, message: msg });
     })
   };
 }
@@ -56944,7 +56980,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       const slots = uiSlotsRef.current;
       const embedded = embeddedTraitsRef.current;
       if (patterns.length === 0) {
-        flushLog.info("clear", { traitName, slot });
+        flushLog.debug("clear", { traitName, slot });
         slots.clearBySource(slot, traitName);
         return;
       }
@@ -56959,7 +56995,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       const props = convertFnFormLambdasInProps(rawProps);
       const isEmbedded = embedded?.has(traitName) ?? false;
       if (isEmbedded) {
-        flushLog.info("embed-route", {
+        flushLog.debug("embed-route", {
           traitName,
           slot,
           patternType: typeof patternType === "string" ? patternType : void 0,
@@ -56973,12 +57009,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         });
         return;
       }
-      flushLog.info("slot-render", {
+      flushLog.debug("slot-render", () => ({
         traitName,
         slot,
         patternType: typeof patternType === "string" ? patternType : void 0,
         embedded: Array.from(embedded ?? [])
-      });
+      }));
       slots.render({
         target: slot,
         pattern: patternType,
@@ -57072,10 +57108,9 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       });
       snapshotUnregs.push(unreg);
     }
-    console.log(
-      "[TraitStateMachine] Reset states for page navigation:",
-      Array.from(newManager.getAllStates().keys()).join(", ")
-    );
+    stateLog.debug("reset-states-for-nav", () => ({
+      traits: Array.from(newManager.getAllStates().keys()).join(", ")
+    }));
     return () => {
       for (const unreg of snapshotUnregs) unreg();
     };
@@ -57162,13 +57197,13 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const normalizedEvent = normalizeEventKey(eventKey);
     const bindings = traitBindingsRef.current;
     const currentManager = managerRef.current;
-    console.log("[TraitStateMachine] Processing event:", normalizedEvent, "payload:", payload);
-    crossTraitLog.debug("processEvent:enter", {
+    crossTraitLog.debug("processEvent:enter", () => ({
       event: normalizedEvent,
+      payload: JSON.stringify(payload ?? null),
       traitCount: bindings.length,
       traitNames: bindings.map((b) => b.trait.name).join(","),
       orbitalsByTrait: JSON.stringify(orbitalsByTrait ?? null)
-    });
+    }));
     const bindingMap = new Map(bindings.map((b) => [b.trait.name, b]));
     const entityByTrait = {};
     for (const [name, fields] of traitFieldStatesRef.current) {
@@ -57223,18 +57258,13 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         }
       }
       if (result.executed && result.effects.length > 0) {
-        console.log(
-          "[TraitStateMachine] Executing",
-          result.effects.length,
-          "effects for",
+        stateLog.debug("executing-effects", () => ({
+          effectCount: result.effects.length,
           traitName,
-          "| linkedEntity:",
-          binding.linkedEntity,
-          "| transition:",
-          `${result.previousState} -> ${result.newState}`,
-          "| effects:",
-          JSON.stringify(result.effects)
-        );
+          linkedEntity: binding.linkedEntity,
+          transition: `${result.previousState} -> ${result.newState}`,
+          effects: JSON.stringify(result.effects)
+        }));
         const linkedEntity = binding.linkedEntity || "";
         const entityId = payload?.entityId;
         const pendingSlots = /* @__PURE__ */ new Map();
@@ -57354,7 +57384,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         const executor = new EffectExecutor({ handlers: trackingHandlers, bindings: bindingCtx, context: effectContext });
         try {
           await executor.executeAll(result.effects);
-          stateLog.info("transition:render-ui-dispatched", {
+          stateLog.debug("transition:render-ui-dispatched", () => ({
             traitName,
             fromState: result.previousState,
             toState: result.newState,
@@ -57363,7 +57393,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
             patternTypes: Array.from(pendingSlots.entries()).map(
               ([slot, patterns]) => `${slot}:[${patterns.map((p2) => p2.pattern?.type ?? "null").join(",")}]`
             ).join(";")
-          });
+          }));
           void slotSource;
           for (const [slot, patterns] of pendingSlots) {
             flushSlot(traitName, slot, patterns);
@@ -57380,30 +57410,25 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         }
       } else if (!result.executed) {
         if (result.guardResult === false) {
-          console.log(
-            "[TraitStateMachine] Guard blocked transition:",
+          stateLog.debug("guard-blocked-transition", {
             traitName,
-            result.previousState,
-            "->",
-            result.transition?.to
-          );
+            from: result.previousState,
+            to: result.transition?.to
+          });
         } else if (!result.transition) {
           if (isCircuitEvent(normalizedEvent)) {
-            console.warn(
-              `[CLOSED CIRCUIT VIOLATION] Trait "${traitName}" in state "${traitState.currentState}" received event "${normalizedEvent}" but has no transition to handle it.
-   This is likely a schema issue. To fix, add a transition:
-   { from: "${traitState.currentState}", to: "<target_state>", event: "${normalizedEvent}", effects: [...] }
-   Or ensure the previous action (that opened this UI) properly transitions back before emitting this event.`
-            );
+            stateLog.warn("closed-circuit-violation", {
+              traitName,
+              currentState: traitState.currentState,
+              event: normalizedEvent,
+              remediation: `Add transition { from: "${traitState.currentState}", to: "<target_state>", event: "${normalizedEvent}", effects: [...] } \u2014 or ensure the previous action (that opened this UI) transitions back before emitting.`
+            });
           } else {
-            console.log(
-              "[TraitStateMachine] No transition for",
+            stateLog.debug("no-transition", {
               traitName,
-              "from state:",
-              traitState.currentState,
-              "on event:",
-              normalizedEvent
-            );
+              from: traitState.currentState,
+              event: normalizedEvent
+            });
           }
         }
       }
@@ -57511,7 +57536,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         allEvents.add(transition.event);
       }
     }
-    console.log("[TraitStateMachine] Subscribing to events:", Array.from(allEvents));
+    stateLog.debug("subscribing-to-events", () => ({ events: Array.from(allEvents) }));
     const unsubscribes = [];
     const subscribedBusKeys = /* @__PURE__ */ new Set();
     for (const binding of traitBindings) {
@@ -57532,7 +57557,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
             crossTraitLog.debug("self:fire-skipped-bridge-echo", { traitName, busKey: selfBusKey, eventKey });
             return;
           }
-          crossTraitLog.info("self:fire", { traitName, busKey: selfBusKey, eventKey });
+          crossTraitLog.debug("self:fire", { traitName, busKey: selfBusKey, eventKey });
           enqueueAndDrain(eventKey, event.payload);
         });
         unsubscribes.push(() => {
@@ -57558,7 +57583,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         const busKey = `UI:${sourceOrbital}.${sourceTrait}.${listen.event}`;
         crossTraitLog.debug("listen:subscribed", { busKey, targetTrait: binding.trait.name, sourceOrbital, sourceTrait, listenEvent: listen.event, triggers: listen.triggers });
         const unsub = eventBus.on(busKey, (event) => {
-          crossTraitLog.info("listen:fired", { busKey, targetTrait: binding.trait.name, triggers: listen.triggers });
+          crossTraitLog.debug("listen:fired", { busKey, targetTrait: binding.trait.name, triggers: listen.triggers });
           enqueueAndDrain(listen.triggers, event.payload);
         });
         unsubscribes.push(() => {
@@ -57589,6 +57614,7 @@ init_EntitySchemaContext();
 // runtime/ServerBridge.tsx
 init_useEventBus();
 var xOrbitalLog = createLogger("almadar:runtime:cross-orbital");
+var serverBridgeLog = createLogger("almadar:ui:server-bridge");
 function createHttpTransport(serverUrl) {
   return {
     register: async (schema) => {
@@ -57601,7 +57627,7 @@ function createHttpTransport(serverUrl) {
         const result = await res.json();
         return !!result.success;
       } catch (err) {
-        console.error("[ServerBridge] Registration failed:", err);
+        serverBridgeLog.error("Registration failed", { error: err instanceof Error ? err : String(err) });
         return false;
       }
     },
@@ -57864,7 +57890,7 @@ function applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits) {
       };
       const props = convertFnFormLambdasInProps(rawProps);
       if (isEmbedded) {
-        xOrbitalLog2.info("slot:embed-routed", {
+        xOrbitalLog2.debug("slot:embed-routed", {
           sourceTrait,
           slot: eff.slot,
           patternType: typeof patternType === "string" ? patternType : void 0
@@ -57876,7 +57902,7 @@ function applyServerEffects(effects, uiSlots, onNavigate, embeddedTraits) {
           animation: "fade"
         });
       } else {
-        xOrbitalLog2.info("slot-write", {
+        xOrbitalLog2.debug("slot-write", {
           slot: eff.slot,
           sourceTrait,
           patternType: typeof patternType === "string" ? patternType : void 0
@@ -57899,12 +57925,12 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   const onEventProcessed = useCallback(async (event, payload, dispatchedOrbitals) => {
     if (!bridge.connected || !orbitalNames?.length) return;
     const targets = dispatchedOrbitals && dispatchedOrbitals.size > 0 ? orbitalNames.filter((n) => dispatchedOrbitals.has(n)) : orbitalNames;
-    xOrbitalLog2.info("TraitInitializer:fanout", {
+    xOrbitalLog2.debug("TraitInitializer:fanout", () => ({
       event,
       sentTo: targets,
       skipped: orbitalNames.filter((n) => !targets.includes(n)),
       dispatchedOrbitalsSize: dispatchedOrbitals?.size ?? 0
-    });
+    }));
     for (const name of targets) {
       const { effects, meta } = await bridge.sendEvent(name, event, payload);
       recordServerResponse(name, event, meta);
@@ -57917,7 +57943,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
   useEffect(() => {
     const traitNames = traits2.map((b) => b.trait?.name ?? "").filter(Boolean).sort().join(",");
     if (prevTraitNamesRef.current && prevTraitNamesRef.current !== traitNames) {
-      navLog.info("page:trait-set-changed", {
+      navLog.debug("page:trait-set-changed", {
         from: prevTraitNamesRef.current,
         to: traitNames,
         action: "clearAll-slots"
@@ -58184,11 +58210,11 @@ function OrbPreview({
   }, [initialPageName, currentPage]);
   const handleNavigate = useCallback((path) => {
     const match = pages.find(({ page }) => page.path === path);
-    navLog.info("handleNavigate", {
+    navLog.debug("handleNavigate", () => ({
       path,
       matched: match?.page.name ?? null,
       availablePaths: pages.map((p2) => p2.page.path)
-    });
+    }));
     if (match) {
       setCurrentPage(match.page.name);
       if (typeof window !== "undefined") {
@@ -58210,19 +58236,19 @@ function OrbPreview({
     const el = containerRef.current;
     if (!el) return;
     if (pages.length <= 1) {
-      navLog.info("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
+      navLog.debug("interceptor:skipped", { reason: "single-page schema", pageCount: pages.length });
       return;
     }
     const handler = (e) => {
       const anchor = e.target.closest("a");
       if (!anchor) return;
       const href = anchor.getAttribute("href") ?? anchor.getAttribute("to") ?? "";
-      navLog.info("click:intercepted", {
+      navLog.debug("click:intercepted", {
         href,
         anchorText: anchor.textContent?.trim().slice(0, 40)
       });
       if (!href || href.startsWith("http") || href.startsWith("mailto:") || href.startsWith("#")) {
-        navLog.info("click:skipped", { href, reason: "external/empty/hash" });
+        navLog.debug("click:skipped", { href, reason: "external/empty/hash" });
         return;
       }
       e.preventDefault();
@@ -59682,11 +59708,11 @@ function FlowCanvasInner({
   const EDGE_TYPES_LOCAL = useMemo(() => ({
     eventFlow: EventFlowEdge
   }), []);
-  flowCanvasLog.info("node-type-registry:render", {
+  flowCanvasLog.debug("node-type-registry:render", () => ({
     registered: Object.keys(NODE_TYPES2),
     preview: typeof OrbPreviewNode,
     previewIsValid: typeof OrbPreviewNode === "function" || typeof OrbPreviewNode === "object" && OrbPreviewNode !== null
-  });
+  }));
   const parsedSchema = useMemo(() => {
     if (typeof schemaProp === "string") return JSON.parse(schemaProp);
     return schemaProp;
@@ -60105,6 +60131,7 @@ init_AvlTransitionLane();
 init_AvlSwimLane();
 init_types();
 init_avl_elk_layout();
+var log17 = createLogger("almadar:ui:avl:trait-scene");
 var SWIM_GUTTER2 = 120;
 var CENTER_W2 = 360;
 var AvlTraitScene = ({
@@ -60115,7 +60142,9 @@ var AvlTraitScene = ({
   const [layout, setLayout] = useState(null);
   const dataKey = useMemo(() => JSON.stringify(data), [data]);
   useEffect(() => {
-    computeTraitLayout(data).then(setLayout).catch(console.error);
+    computeTraitLayout(data).then(setLayout).catch((error) => {
+      log17.error("computeTraitLayout failed", { error: error instanceof Error ? error : String(error) });
+    });
   }, [dataKey]);
   if (!layout) {
     return /* @__PURE__ */ jsx("g", { children: /* @__PURE__ */ jsx("text", { x: 300, y: 200, textAnchor: "middle", fill: color, fontSize: 12, opacity: 0.5, children: "Computing layout..." }) });