@almadar/ui 4.44.1 → 4.45.0

package/dist/runtime/index.cjs

@@ -217,7 +217,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) });
             }
           });
         }
@@ -225,7 +225,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) });
           }
         });
       },
@@ -4228,6 +4228,7 @@ var BUILT_IN_THEMES, ThemeContext;
 var init_ThemeContext = __esm({
   "context/ThemeContext.tsx"() {
     "use client";
+    logger.createLogger("almadar:ui:theme");
     BUILT_IN_THEMES = [
       {
         name: "wireframe",
@@ -7729,6 +7730,7 @@ function getAllPages(schema) {
 var init_navigation = __esm({
   "renderer/navigation.tsx"() {
     "use client";
+    logger.createLogger("almadar:ui:navigation");
     React135.createContext(null);
   }
 });
@@ -10206,7 +10208,7 @@ function recordTransition(trace) {
     ...trace,
     id: `t-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`
   };
-  log2.debug("transition:recorded", { trait: trace.traitName, from: trace.from, to: trace.to, event: trace.event, effectCount: trace.effects.length });
+  log5.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();
@@ -10305,7 +10307,7 @@ function getTraitSnapshots() {
     try {
       snapshots.push(getter());
     } catch (err) {
-      log2.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
+      log5.error("traitSnapshot getter failed", { trait: traitName, err: String(err) });
     }
   }
   return snapshots;
@@ -10389,10 +10391,10 @@ function updateAssetStatus(url, status) {
     window.__orbitalVerification.assetStatus[url] = status;
   }
 }
-var log2, MAX_TRANSITIONS;
+var log5, MAX_TRANSITIONS;
 var init_verificationRegistry = __esm({
   "lib/verificationRegistry.ts"() {
-    log2 = logger.createLogger("almadar:bridge");
+    log5 = logger.createLogger("almadar:bridge");
     MAX_TRANSITIONS = 500;
     exposeOnWindow();
   }
@@ -12420,7 +12422,7 @@ var init_avl_elk_layout = __esm({
     elk = new ELK__default.default();
   }
 });
-var SWIM_GUTTER, CENTER_W, BehaviorView;
+var log6, SWIM_GUTTER, CENTER_W, BehaviorView;
 var init_BehaviorView = __esm({
   "components/molecules/avl/BehaviorView.tsx"() {
     "use client";
@@ -12429,6 +12431,7 @@ var init_BehaviorView = __esm({
     init_AvlSwimLane();
     init_types();
     init_avl_elk_layout();
+    log6 = logger.createLogger("almadar:ui:avl:behavior-view");
     SWIM_GUTTER = 120;
     CENTER_W = 360;
     BehaviorView = ({ data }) => {
@@ -12438,7 +12441,7 @@ var init_BehaviorView = __esm({
       const dataKey = React135.useMemo(() => JSON.stringify(traitData), [traitData]);
       React135.useEffect(() => {
         if (!traitData) return;
-        computeTraitLayout(traitData).then(setLayout).catch(console.error);
+        computeTraitLayout(traitData).then(setLayout).catch((err) => log6.error("compute-trait-layout-failed", { error: err instanceof Error ? err : String(err) }));
       }, [dataKey]);
       if (!traitData) {
         return /* @__PURE__ */ jsxRuntime.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" });
@@ -12783,7 +12786,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, log7, LINE_PROPS_FN, HIDDEN_LINE_NUMBERS, CodeBlock;
 var init_CodeBlock = __esm({
   "components/molecules/markdown/CodeBlock.tsx"() {
     init_Box();
@@ -12860,6 +12863,7 @@ var init_CodeBlock = __esm({
       "lolo-op-async": { color: syntax.ORB_COLORS.dark.async }
     };
     loloStyle = { ...dark__default.default, ...loloStyleOverrides };
+    log7 = logger.createLogger("almadar:ui:markdown-code");
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
     CodeBlock = React135__namespace.default.memo(
@@ -13058,7 +13062,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);
+            log7.error("Failed to copy code", { error: err instanceof Error ? err : String(err) });
             eventBus.emit("UI:COPY_CODE", { language, success: false });
           }
         };
@@ -16570,13 +16574,14 @@ function useSafeEventBus2() {
     } };
   }
 }
-var ButtonGroup;
+var log8, ButtonGroup;
 var init_ButtonGroup = __esm({
   "components/molecules/ButtonGroup.tsx"() {
     "use client";
     init_cn();
     init_atoms();
     init_useEventBus();
+    log8 = logger.createLogger("almadar:ui:button-group");
     ButtonGroup = ({
       children,
       primary,
@@ -16649,7 +16654,7 @@ var init_ButtonGroup = __esm({
           {
             variant: "ghost",
             onClick: () => {
-              console.log(`Filter clicked: ${filter.field}`);
+              log8.debug("Filter clicked", { field: filter.field });
             },
             children: filter.label
           },
@@ -22521,31 +22526,56 @@ var init_InputGroup = __esm({
     InputGroup.displayName = "InputGroup";
   }
 });
-
-// lib/debug.ts
+function gateEnabled(level, ns = NAMESPACE) {
+  return logger.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") {
+    log9.debug(message);
+  } else {
+    log9.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, log9;
 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";
+    log9 = logger.createLogger(NAMESPACE);
+    logger.createLogger("almadar:ui:debug:input");
+    logger.createLogger("almadar:ui:debug:collision");
+    logger.createLogger("almadar:ui:debug:physics");
+    logger.createLogger("almadar:ui:debug:game-state");
   }
 });
 var isRelationsDebugEnabled, RelationSelect;
@@ -38783,7 +38813,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log3, setLog] = React135__namespace.useState([]);
+  const [log11, setLog] = React135__namespace.useState([]);
   const prevStatesRef = React135__namespace.useRef(/* @__PURE__ */ new Map());
   React135__namespace.useEffect(() => {
     for (const trait of traits2) {
@@ -38847,9 +38877,9 @@ function EventDispatcherTab({ traits: traits2, schema }) {
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Other Events (not available from current state)" }),
       /* @__PURE__ */ jsxRuntime.jsx("div", { className: "flex flex-wrap gap-1", children: unavailableEvents.map((event) => /* @__PURE__ */ jsxRuntime.jsx(Badge, { variant: "default", size: "sm", className: "opacity-50", children: event }, event)) })
     ] }),
-    log3.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+    log11.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
       /* @__PURE__ */ jsxRuntime.jsx(Typography, { variant: "small", weight: "medium", className: "text-gray-500 mb-1", children: "Recent Transitions" }),
-      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log3.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log11.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-purple-400", children: entry.traitName }),
         " ",
         /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-gray-500", children: entry.from }),
@@ -44397,8 +44427,7 @@ var init_UISlotRenderer = __esm({
 
 // hooks/index.ts
 init_useEventBus();
-
-// runtime/createClientEffectHandlers.ts
+var log2 = logger.createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
   const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
@@ -44407,10 +44436,10 @@ function createClientEffectHandlers(options) {
       eventBus.emit(prefixedEvent, payload);
     },
     persist: async () => {
-      console.warn("[ClientEffectHandlers] persist is server-side only, ignored on client");
+      log2.warn("persist is server-side only, ignored on client");
     },
     set: () => {
-      console.warn("[ClientEffectHandlers] set is server-side only, ignored on client");
+      log2.warn("set is server-side only, ignored on client");
     },
     callService: async (service, action, params) => {
       if (callService) return callService(service, action, params);
@@ -44439,10 +44468,10 @@ function createClientEffectHandlers(options) {
       slotSetter.addPattern(slot, pattern, props);
     },
     navigate: navigate ?? ((path) => {
-      console.warn("[ClientEffectHandlers] No navigate handler, ignoring:", path);
+      log2.warn("No navigate handler, ignoring", { path });
     }),
     notify: notify ?? ((msg, type) => {
-      console.log(`[ClientEffectHandlers] notify (${type}):`, msg);
+      log2.debug("notify", { type, message: msg });
     })
   };
 }
@@ -44745,10 +44774,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();
     };
@@ -44835,9 +44863,9 @@ 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", () => ({
       event: normalizedEvent,
+      payload: JSON.stringify(payload ?? null),
       traitCount: bindings.length,
       traitNames: bindings.map((b) => b.trait.name).join(","),
       orbitalsByTrait: JSON.stringify(orbitalsByTrait ?? null)
@@ -44896,18 +44924,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();
@@ -45053,30 +45076,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 (core.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
+            });
           }
         }
       }
@@ -45184,7 +45202,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) {
@@ -45319,7 +45337,11 @@ function useResolvedSchema(schema, pageName) {
       };
     }
     const page = core.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) {
@@ -45346,6 +45368,7 @@ function clearSchemaCache() {
 
 // runtime/index.ts
 init_EntitySchemaContext();
+var log10 = logger.createLogger("almadar:ui:trait-provider");
 var TraitContext = React135.createContext(null);
 function TraitProvider({
   traits: traitBindings,
@@ -45362,7 +45385,11 @@ function TraitProvider({
         currentState: stateName,
         availableEvents: trait.transitions.filter((t) => t.from === stateName).map((t) => t.event),
         dispatch: (eventKey, payload) => {
-          console.log(`[TraitProvider] Dispatch to ${trait.name}: ${eventKey}`, payload);
+          log10.debug("Dispatch", () => ({
+            trait: trait.name,
+            event: eventKey,
+            payloadKeys: payload ? Object.keys(payload) : []
+          }));
         },
         canDispatch: (eventKey) => {
           return trait.transitions.some(
@@ -45490,6 +45517,7 @@ init_EntitySchemaContext();
 // runtime/ServerBridge.tsx
 init_useEventBus();
 var xOrbitalLog = logger.createLogger("almadar:runtime:cross-orbital");
+var serverBridgeLog = logger.createLogger("almadar:ui:server-bridge");
 function createHttpTransport(serverUrl) {
   return {
     register: async (schema) => {
@@ -45502,7 +45530,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;
       }
     },