@almadar/ui 4.44.1 → 4.45.0

package/dist/runtime/index.js

@@ -1,7 +1,7 @@
 import * as React135 from 'react';
 import React135__default, { createContext, useContext, useMemo, useRef, useEffect, useCallback, Suspense, useState, useLayoutEffect, lazy, useId } from 'react';
 import { EventBusContext, useTraitScope, OrbitalProvider, TraitScopeProvider, VerificationProvider } from '@almadar/ui/providers';
-import { createLogger } from '@almadar/logger';
+import { createLogger, isLogLevelEnabled } from '@almadar/logger';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import { clsx } from 'clsx';
 import { twMerge } from 'tailwind-merge';
@@ -171,7 +171,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) });
             }
           });
         }
@@ -179,7 +179,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) });
           }
         });
       },
@@ -4182,6 +4182,7 @@ var BUILT_IN_THEMES, ThemeContext;
 var init_ThemeContext = __esm({
   "context/ThemeContext.tsx"() {
     "use client";
+    createLogger("almadar:ui:theme");
     BUILT_IN_THEMES = [
       {
         name: "wireframe",
@@ -7683,6 +7684,7 @@ function getAllPages(schema) {
 var init_navigation = __esm({
   "renderer/navigation.tsx"() {
     "use client";
+    createLogger("almadar:ui:navigation");
     createContext(null);
   }
 });
@@ -10160,7 +10162,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();
@@ -10259,7 +10261,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;
@@ -10343,10 +10345,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 = createLogger("almadar:bridge");
+    log5 = createLogger("almadar:bridge");
     MAX_TRANSITIONS = 500;
     exposeOnWindow();
   }
@@ -12374,7 +12376,7 @@ var init_avl_elk_layout = __esm({
     elk = new ELK();
   }
 });
-var SWIM_GUTTER, CENTER_W, BehaviorView;
+var log6, SWIM_GUTTER, CENTER_W, BehaviorView;
 var init_BehaviorView = __esm({
   "components/molecules/avl/BehaviorView.tsx"() {
     "use client";
@@ -12383,6 +12385,7 @@ var init_BehaviorView = __esm({
     init_AvlSwimLane();
     init_types();
     init_avl_elk_layout();
+    log6 = createLogger("almadar:ui:avl:behavior-view");
     SWIM_GUTTER = 120;
     CENTER_W = 360;
     BehaviorView = ({ data }) => {
@@ -12392,7 +12395,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) => log6.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" });
@@ -12737,7 +12740,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();
@@ -12814,6 +12817,7 @@ var init_CodeBlock = __esm({
       "lolo-op-async": { color: ORB_COLORS.dark.async }
     };
     loloStyle = { ...dark, ...loloStyleOverrides };
+    log7 = createLogger("almadar:ui:markdown-code");
     LINE_PROPS_FN = (n) => ({ "data-line": String(n - 1) });
     HIDDEN_LINE_NUMBERS = { display: "none" };
     CodeBlock = React135__default.memo(
@@ -13012,7 +13016,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 });
           }
         };
@@ -16524,13 +16528,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 = createLogger("almadar:ui:button-group");
     ButtonGroup = ({
       children,
       primary,
@@ -16603,7 +16608,7 @@ var init_ButtonGroup = __esm({
           {
             variant: "ghost",
             onClick: () => {
-              console.log(`Filter clicked: ${filter.field}`);
+              log8.debug("Filter clicked", { field: filter.field });
             },
             children: filter.label
           },
@@ -22475,31 +22480,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") {
+    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 = 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;
@@ -38737,7 +38767,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log3, setLog] = React135.useState([]);
+  const [log11, setLog] = React135.useState([]);
   const prevStatesRef = React135.useRef(/* @__PURE__ */ new Map());
   React135.useEffect(() => {
     for (const trait of traits2) {
@@ -38801,9 +38831,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)) })
     ] }),
-    log3.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log11.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: log3.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log11.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 }),
@@ -44351,8 +44381,7 @@ var init_UISlotRenderer = __esm({
 
 // hooks/index.ts
 init_useEventBus();
-
-// runtime/createClientEffectHandlers.ts
+var log2 = createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
   const { eventBus, slotSetter, navigate, notify, callService } = options;
   return {
@@ -44361,10 +44390,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);
@@ -44393,10 +44422,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 });
     })
   };
 }
@@ -44699,10 +44728,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();
     };
@@ -44789,9 +44817,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)
@@ -44850,18 +44878,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();
@@ -45007,30 +45030,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
+            });
           }
         }
       }
@@ -45138,7 +45156,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) {
@@ -45273,7 +45291,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) {
@@ -45300,6 +45322,7 @@ function clearSchemaCache() {
 
 // runtime/index.ts
 init_EntitySchemaContext();
+var log10 = createLogger("almadar:ui:trait-provider");
 var TraitContext = createContext(null);
 function TraitProvider({
   traits: traitBindings,
@@ -45316,7 +45339,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(
@@ -45444,6 +45471,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) => {
@@ -45456,7 +45484,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;
       }
     },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "4.44.1",
+  "version": "4.45.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -131,9 +131,9 @@
   "dependencies": {
     "@almadar/core": ">=7.13.0",
     "@almadar/evaluator": ">=2.9.2",
-    "@almadar/logger": ">=1.1.0",
+    "@almadar/logger": "^1.3.0",
     "@almadar/patterns": "^2.26.0",
-    "@almadar/runtime": ">=6.4.0",
+    "@almadar/runtime": "^6.4.1",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",
     "@xyflow/react": "12.10.1",