@almadar/ui 2.46.0 → 2.47.0

package/dist/avl/index.cjs

@@ -47,6 +47,7 @@ var core = require('@almadar/core');
 require('@tanstack/react-query');
 var runtime = require('@almadar/runtime');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 function _interopNamespace(e) {
@@ -2864,6 +2865,68 @@ var init_Avl3DLabel = __esm({
     Avl3DLabel.displayName = "Avl3DLabel";
   }
 });
+
+// lib/logger.ts
+function getViteEnv(key) {
+  try {
+    const meta = ({ url: (typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('index.cjs', document.baseURI).href)) });
+    return meta?.env?.[key];
+  } catch {
+    return void 0;
+  }
+}
+function envGet(key, viteKey) {
+  return ENV[key] ?? (viteKey ? getViteEnv(viteKey) : void 0) ?? VITE_ENV[viteKey ?? key];
+}
+function matchesNamespace(namespace) {
+  if (DEBUG_FILTER.length === 0) return true;
+  return DEBUG_FILTER.some((pattern) => {
+    if (pattern === "*" || pattern === "almadar:*") return true;
+    if (pattern.endsWith(":*")) return namespace.startsWith(pattern.slice(0, -1));
+    return namespace === pattern;
+  });
+}
+function createLogger(namespace) {
+  const nsAllowed = matchesNamespace(namespace);
+  const log4 = (level, message, data, correlationId) => {
+    if (LEVEL_PRIORITY[level] < MIN_PRIORITY) return;
+    if (level === "DEBUG" && !nsAllowed) return;
+    const prefix = `[${namespace}]`;
+    const logData = correlationId ? { ...data, cid: correlationId } : data;
+    switch (level) {
+      case "DEBUG":
+        console.debug(prefix, message, logData ?? "");
+        break;
+      case "INFO":
+        console.info(prefix, message, logData ?? "");
+        break;
+      case "WARN":
+        console.warn(prefix, message, logData ?? "");
+        break;
+      case "ERROR":
+        console.error(prefix, message, logData ?? "");
+        break;
+    }
+  };
+  return {
+    debug: (msg, data, cid) => log4("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log4("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log4("WARN", msg, data, cid),
+    error: (msg, data, cid) => log4("ERROR", msg, data, cid)
+  };
+}
+var LEVEL_PRIORITY, ENV, VITE_ENV, NODE_ENV, CONFIGURED_LEVEL, MIN_PRIORITY, DEBUG_FILTER;
+var init_logger = __esm({
+  "lib/logger.ts"() {
+    LEVEL_PRIORITY = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
+    ENV = typeof process !== "undefined" && process.env ? process.env : {};
+    VITE_ENV = typeof globalThis !== "undefined" && globalThis.__vite_env__ ? globalThis.__vite_env__ : {};
+    NODE_ENV = envGet("NODE_ENV", "VITE_NODE_ENV") ?? "development";
+    CONFIGURED_LEVEL = (envGet("LOG_LEVEL", "VITE_LOG_LEVEL") ?? (NODE_ENV === "production" ? "info" : "debug")).toUpperCase();
+    MIN_PRIORITY = LEVEL_PRIORITY[CONFIGURED_LEVEL] ?? 0;
+    DEBUG_FILTER = (envGet("ALMADAR_DEBUG", "VITE_ALMADAR_DEBUG") ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  }
+});
 function EventBusProvider({ children, debug: debug2 = false }) {
   const listenersRef = React125.useRef(/* @__PURE__ */ new Map());
   const anyListenersRef = React125.useRef(/* @__PURE__ */ new Set());
@@ -2892,7 +2955,8 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       timestamp: Date.now()
     };
     const listeners6 = listenersRef.current.get(type);
-    const listenerCount = listeners6?.size ?? 0;
+    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);
@@ -2925,6 +2989,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     }
     const listeners6 = listenersRef.current.get(type);
     listeners6.add(listener);
+    subLog.debug("subscribe", { type, totalListeners: listeners6.size });
     if (debug2) {
       console.log(`[EventBus] Subscribed to '${type}', total: ${listeners6.size}`);
     }
@@ -2951,6 +3016,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
   }, []);
   const onAny = React125.useCallback((listener) => {
     anyListenersRef.current.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: anyListenersRef.current.size });
     if (debug2) {
       console.log(`[EventBus] onAny subscribed, total: ${anyListenersRef.current.size}`);
     }
@@ -2981,11 +3047,14 @@ function EventBusProvider({ children, debug: debug2 = false }) {
   }, [contextValue2]);
   return /* @__PURE__ */ jsxRuntime.jsx(EventBusContext.Provider, { value: contextValue2, children });
 }
-var EventBusContext;
+var busLog, subLog, EventBusContext;
 var init_EventBusProvider = __esm({
   "providers/EventBusProvider.tsx"() {
     "use client";
     init_useEventBus();
+    init_logger();
+    busLog = createLogger("almadar:eventbus");
+    subLog = createLogger("almadar:eventbus:subscribe");
     EventBusContext = React125.createContext(null);
   }
 });
@@ -3027,11 +3096,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var fallbackListeners, fallbackAnyListeners, fallbackEventBus;
+var log, subLog2, fallbackListeners, fallbackAnyListeners, fallbackEventBus;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_EventBusProvider();
+    init_logger();
+    log = createLogger("almadar:eventbus");
+    subLog2 = createLogger("almadar:eventbus:subscribe");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -3042,6 +3114,7 @@ var init_useEventBus = __esm({
           timestamp: Date.now()
         };
         const handlers = fallbackListeners.get(type);
+        log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
         if (handlers) {
           handlers.forEach((handler) => {
             try {
@@ -3064,6 +3137,7 @@ var init_useEventBus = __esm({
           fallbackListeners.set(type, /* @__PURE__ */ new Set());
         }
         fallbackListeners.get(type).add(listener);
+        subLog2.debug("subscribe", { type, totalListeners: fallbackListeners.get(type).size });
         return () => {
           const handlers = fallbackListeners.get(type);
           if (handlers) {
@@ -3087,6 +3161,7 @@ var init_useEventBus = __esm({
       },
       onAny: (listener) => {
         fallbackAnyListeners.add(listener);
+        subLog2.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
         return () => {
           fallbackAnyListeners.delete(listener);
         };
@@ -3225,6 +3300,7 @@ var init_Box = __esm({
         action,
         actionPayload,
         hoverEvent,
+        maxWidth,
         onClick,
         onMouseEnter,
         onMouseLeave,
@@ -3289,6 +3365,7 @@ var init_Box = __esm({
             onClick: isClickable ? handleClick : void 0,
             onMouseEnter: hoverEvent || onMouseEnter ? handleMouseEnter : void 0,
             onMouseLeave: hoverEvent || onMouseLeave ? handleMouseLeave : void 0,
+            style: maxWidth ? { maxWidth, ...rest.style } : rest.style,
             ...rest,
             children
           }
@@ -13336,6 +13413,10 @@ function useTheme() {
   }
   return context;
 }
+
+// providers/EntityStoreProvider.tsx
+init_logger();
+var storeLog = createLogger("almadar:entity:store");
 var store = /* @__PURE__ */ new Map();
 var storeListeners = /* @__PURE__ */ new Set();
 var watchCallbacks = /* @__PURE__ */ new Map();
@@ -13375,7 +13456,9 @@ function setAll(entityType, records) {
     }
   }
   const prev = store.get(entityType);
-  store.set(entityType, { entities, ids, version: (prev?.version ?? 0) + 1 });
+  const newVersion = (prev?.version ?? 0) + 1;
+  store.set(entityType, { entities, ids, version: newVersion });
+  storeLog.debug("setAll", { entityType, recordCount: records.length, version: newVersion });
   notifyListeners(entityType, prev);
 }
 function upsertOne(entityType, record) {
@@ -13387,6 +13470,7 @@ function upsertOne(entityType, record) {
   if (!snapshot.ids.includes(id)) snapshot.ids.push(id);
   snapshot.version++;
   store.set(entityType, snapshot);
+  storeLog.debug("upsertOne", { entityType, id, version: snapshot.version });
   notifyListeners(entityType, prev);
 }
 function addOne(entityType, record) {
@@ -13403,6 +13487,7 @@ function updateOne(entityType, id, changes) {
   snapshot.entities.set(id, { ...snapshot.entities.get(id), ...changes });
   snapshot.version++;
   store.set(entityType, snapshot);
+  storeLog.debug("updateOne", { entityType, id, changedFields: Object.keys(changes), version: snapshot.version });
   notifyListeners(entityType, prev);
 }
 function removeOne(entityType, id) {
@@ -13416,6 +13501,7 @@ function removeOne(entityType, id) {
   snapshot.entities.delete(id);
   snapshot.version++;
   store.set(entityType, snapshot);
+  storeLog.debug("removeOne", { entityType, id, remainingCount: snapshot.ids.length, version: snapshot.version });
   notifyListeners(entityType, prev);
 }
 function getSnapshot(entityType) {
@@ -20211,6 +20297,8 @@ var LoadingState = ({
 LoadingState.displayName = "LoadingState";
 
 // lib/verificationRegistry.ts
+init_logger();
+var log2 = createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
   if (typeof window !== "undefined") {
@@ -20243,6 +20331,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 });
   getState().transitions.push(entry);
   if (getState().transitions.length > MAX_TRANSITIONS) {
     getState().transitions.shift();
@@ -20374,10 +20463,12 @@ function waitForTransition(event, timeoutMs = 1e4) {
 }
 function bindEventBus(eventBus) {
   if (typeof window === "undefined") return;
+  log2.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
     window.__orbitalVerification.sendEvent = (event, payload) => {
       const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
+      log2.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -41427,7 +41518,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log, setLog] = React125__namespace.useState([]);
+  const [log4, setLog] = React125__namespace.useState([]);
   const prevStatesRef = React125__namespace.useRef(/* @__PURE__ */ new Map());
   React125__namespace.useEffect(() => {
     for (const trait of traits2) {
@@ -41491,9 +41582,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)) })
     ] }),
-    log.length > 0 && /* @__PURE__ */ jsxRuntime.jsxs("div", { children: [
+    log4.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: log.map((entry, i) => /* @__PURE__ */ jsxRuntime.jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsxRuntime.jsx(Stack, { gap: "xs", children: log4.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 }),
@@ -46119,6 +46210,8 @@ UISlotRenderer.displayName = "UISlotRenderer";
 
 // providers/VerificationProvider.tsx
 init_useEventBus();
+init_logger();
+var log3 = createLogger("almadar:verify");
 var DISPATCH_SUFFIX = ":DISPATCH";
 var SUCCESS_SUFFIX = ":SUCCESS";
 var ERROR_SUFFIX = ":ERROR";
@@ -46164,6 +46257,7 @@ function VerificationProvider({
     const unsub = eventBus.onAny((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 });
       const payload = evt.payload ?? {};
       if (parsed.kind === "dispatch") {
         const key = `${parsed.traitName}:${String(payload["event"] ?? "")}`;
@@ -46216,6 +46310,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
+        log3.info("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);
@@ -46245,6 +46340,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
+        log3.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
       }
     });
     registerCheck(

package/dist/avl/index.js

@@ -2817,6 +2817,68 @@ var init_Avl3DLabel = __esm({
     Avl3DLabel.displayName = "Avl3DLabel";
   }
 });
+
+// lib/logger.ts
+function getViteEnv(key) {
+  try {
+    const meta = import.meta;
+    return meta?.env?.[key];
+  } catch {
+    return void 0;
+  }
+}
+function envGet(key, viteKey) {
+  return ENV[key] ?? (viteKey ? getViteEnv(viteKey) : void 0) ?? VITE_ENV[viteKey ?? key];
+}
+function matchesNamespace(namespace) {
+  if (DEBUG_FILTER.length === 0) return true;
+  return DEBUG_FILTER.some((pattern) => {
+    if (pattern === "*" || pattern === "almadar:*") return true;
+    if (pattern.endsWith(":*")) return namespace.startsWith(pattern.slice(0, -1));
+    return namespace === pattern;
+  });
+}
+function createLogger(namespace) {
+  const nsAllowed = matchesNamespace(namespace);
+  const log4 = (level, message, data, correlationId) => {
+    if (LEVEL_PRIORITY[level] < MIN_PRIORITY) return;
+    if (level === "DEBUG" && !nsAllowed) return;
+    const prefix = `[${namespace}]`;
+    const logData = correlationId ? { ...data, cid: correlationId } : data;
+    switch (level) {
+      case "DEBUG":
+        console.debug(prefix, message, logData ?? "");
+        break;
+      case "INFO":
+        console.info(prefix, message, logData ?? "");
+        break;
+      case "WARN":
+        console.warn(prefix, message, logData ?? "");
+        break;
+      case "ERROR":
+        console.error(prefix, message, logData ?? "");
+        break;
+    }
+  };
+  return {
+    debug: (msg, data, cid) => log4("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log4("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log4("WARN", msg, data, cid),
+    error: (msg, data, cid) => log4("ERROR", msg, data, cid)
+  };
+}
+var LEVEL_PRIORITY, ENV, VITE_ENV, NODE_ENV, CONFIGURED_LEVEL, MIN_PRIORITY, DEBUG_FILTER;
+var init_logger = __esm({
+  "lib/logger.ts"() {
+    LEVEL_PRIORITY = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
+    ENV = typeof process !== "undefined" && process.env ? process.env : {};
+    VITE_ENV = typeof globalThis !== "undefined" && globalThis.__vite_env__ ? globalThis.__vite_env__ : {};
+    NODE_ENV = envGet("NODE_ENV", "VITE_NODE_ENV") ?? "development";
+    CONFIGURED_LEVEL = (envGet("LOG_LEVEL", "VITE_LOG_LEVEL") ?? (NODE_ENV === "production" ? "info" : "debug")).toUpperCase();
+    MIN_PRIORITY = LEVEL_PRIORITY[CONFIGURED_LEVEL] ?? 0;
+    DEBUG_FILTER = (envGet("ALMADAR_DEBUG", "VITE_ALMADAR_DEBUG") ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+  }
+});
 function EventBusProvider({ children, debug: debug2 = false }) {
   const listenersRef = useRef(/* @__PURE__ */ new Map());
   const anyListenersRef = useRef(/* @__PURE__ */ new Set());
@@ -2845,7 +2907,8 @@ function EventBusProvider({ children, debug: debug2 = false }) {
       timestamp: Date.now()
     };
     const listeners6 = listenersRef.current.get(type);
-    const listenerCount = listeners6?.size ?? 0;
+    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);
@@ -2878,6 +2941,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     }
     const listeners6 = listenersRef.current.get(type);
     listeners6.add(listener);
+    subLog.debug("subscribe", { type, totalListeners: listeners6.size });
     if (debug2) {
       console.log(`[EventBus] Subscribed to '${type}', total: ${listeners6.size}`);
     }
@@ -2904,6 +2968,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
   }, []);
   const onAny = useCallback((listener) => {
     anyListenersRef.current.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: anyListenersRef.current.size });
     if (debug2) {
       console.log(`[EventBus] onAny subscribed, total: ${anyListenersRef.current.size}`);
     }
@@ -2934,11 +2999,14 @@ function EventBusProvider({ children, debug: debug2 = false }) {
   }, [contextValue2]);
   return /* @__PURE__ */ jsx(EventBusContext.Provider, { value: contextValue2, children });
 }
-var EventBusContext;
+var busLog, subLog, EventBusContext;
 var init_EventBusProvider = __esm({
   "providers/EventBusProvider.tsx"() {
     "use client";
     init_useEventBus();
+    init_logger();
+    busLog = createLogger("almadar:eventbus");
+    subLog = createLogger("almadar:eventbus:subscribe");
     EventBusContext = createContext(null);
   }
 });
@@ -2980,11 +3048,14 @@ function useEmitEvent() {
     [eventBus]
   );
 }
-var fallbackListeners, fallbackAnyListeners, fallbackEventBus;
+var log, subLog2, fallbackListeners, fallbackAnyListeners, fallbackEventBus;
 var init_useEventBus = __esm({
   "hooks/useEventBus.ts"() {
     "use client";
     init_EventBusProvider();
+    init_logger();
+    log = createLogger("almadar:eventbus");
+    subLog2 = createLogger("almadar:eventbus:subscribe");
     fallbackListeners = /* @__PURE__ */ new Map();
     fallbackAnyListeners = /* @__PURE__ */ new Set();
     fallbackEventBus = {
@@ -2995,6 +3066,7 @@ var init_useEventBus = __esm({
           timestamp: Date.now()
         };
         const handlers = fallbackListeners.get(type);
+        log.debug("emit", { type, payloadKeys: payload ? Object.keys(payload).length : 0, listenerCount: (handlers?.size ?? 0) + fallbackAnyListeners.size });
         if (handlers) {
           handlers.forEach((handler) => {
             try {
@@ -3017,6 +3089,7 @@ var init_useEventBus = __esm({
           fallbackListeners.set(type, /* @__PURE__ */ new Set());
         }
         fallbackListeners.get(type).add(listener);
+        subLog2.debug("subscribe", { type, totalListeners: fallbackListeners.get(type).size });
         return () => {
           const handlers = fallbackListeners.get(type);
           if (handlers) {
@@ -3040,6 +3113,7 @@ var init_useEventBus = __esm({
       },
       onAny: (listener) => {
         fallbackAnyListeners.add(listener);
+        subLog2.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
         return () => {
           fallbackAnyListeners.delete(listener);
         };
@@ -3178,6 +3252,7 @@ var init_Box = __esm({
         action,
         actionPayload,
         hoverEvent,
+        maxWidth,
         onClick,
         onMouseEnter,
         onMouseLeave,
@@ -3242,6 +3317,7 @@ var init_Box = __esm({
             onClick: isClickable ? handleClick : void 0,
             onMouseEnter: hoverEvent || onMouseEnter ? handleMouseEnter : void 0,
             onMouseLeave: hoverEvent || onMouseLeave ? handleMouseLeave : void 0,
+            style: maxWidth ? { maxWidth, ...rest.style } : rest.style,
             ...rest,
             children
           }
@@ -13289,6 +13365,10 @@ function useTheme() {
   }
   return context;
 }
+
+// providers/EntityStoreProvider.tsx
+init_logger();
+var storeLog = createLogger("almadar:entity:store");
 var store = /* @__PURE__ */ new Map();
 var storeListeners = /* @__PURE__ */ new Set();
 var watchCallbacks = /* @__PURE__ */ new Map();
@@ -13328,7 +13408,9 @@ function setAll(entityType, records) {
     }
   }
   const prev = store.get(entityType);
-  store.set(entityType, { entities, ids, version: (prev?.version ?? 0) + 1 });
+  const newVersion = (prev?.version ?? 0) + 1;
+  store.set(entityType, { entities, ids, version: newVersion });
+  storeLog.debug("setAll", { entityType, recordCount: records.length, version: newVersion });
   notifyListeners(entityType, prev);
 }
 function upsertOne(entityType, record) {
@@ -13340,6 +13422,7 @@ function upsertOne(entityType, record) {
   if (!snapshot.ids.includes(id)) snapshot.ids.push(id);
   snapshot.version++;
   store.set(entityType, snapshot);
+  storeLog.debug("upsertOne", { entityType, id, version: snapshot.version });
   notifyListeners(entityType, prev);
 }
 function addOne(entityType, record) {
@@ -13356,6 +13439,7 @@ function updateOne(entityType, id, changes) {
   snapshot.entities.set(id, { ...snapshot.entities.get(id), ...changes });
   snapshot.version++;
   store.set(entityType, snapshot);
+  storeLog.debug("updateOne", { entityType, id, changedFields: Object.keys(changes), version: snapshot.version });
   notifyListeners(entityType, prev);
 }
 function removeOne(entityType, id) {
@@ -13369,6 +13453,7 @@ function removeOne(entityType, id) {
   snapshot.entities.delete(id);
   snapshot.version++;
   store.set(entityType, snapshot);
+  storeLog.debug("removeOne", { entityType, id, remainingCount: snapshot.ids.length, version: snapshot.version });
   notifyListeners(entityType, prev);
 }
 function getSnapshot(entityType) {
@@ -20164,6 +20249,8 @@ var LoadingState = ({
 LoadingState.displayName = "LoadingState";
 
 // lib/verificationRegistry.ts
+init_logger();
+var log2 = createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
   if (typeof window !== "undefined") {
@@ -20196,6 +20283,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 });
   getState().transitions.push(entry);
   if (getState().transitions.length > MAX_TRANSITIONS) {
     getState().transitions.shift();
@@ -20327,10 +20415,12 @@ function waitForTransition(event, timeoutMs = 1e4) {
 }
 function bindEventBus(eventBus) {
   if (typeof window === "undefined") return;
+  log2.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
     window.__orbitalVerification.sendEvent = (event, payload) => {
       const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
+      log2.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -41380,7 +41470,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log, setLog] = React125.useState([]);
+  const [log4, setLog] = React125.useState([]);
   const prevStatesRef = React125.useRef(/* @__PURE__ */ new Map());
   React125.useEffect(() => {
     for (const trait of traits2) {
@@ -41444,9 +41534,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)) })
     ] }),
-    log.length > 0 && /* @__PURE__ */ jsxs("div", { children: [
+    log4.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: log.map((entry, i) => /* @__PURE__ */ jsxs(Typography, { variant: "small", className: "font-mono text-xs", children: [
+      /* @__PURE__ */ jsx(Stack, { gap: "xs", children: log4.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 }),
@@ -46072,6 +46162,8 @@ UISlotRenderer.displayName = "UISlotRenderer";
 
 // providers/VerificationProvider.tsx
 init_useEventBus();
+init_logger();
+var log3 = createLogger("almadar:verify");
 var DISPATCH_SUFFIX = ":DISPATCH";
 var SUCCESS_SUFFIX = ":SUCCESS";
 var ERROR_SUFFIX = ":ERROR";
@@ -46117,6 +46209,7 @@ function VerificationProvider({
     const unsub = eventBus.onAny((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 });
       const payload = evt.payload ?? {};
       if (parsed.kind === "dispatch") {
         const key = `${parsed.traitName}:${String(payload["event"] ?? "")}`;
@@ -46169,6 +46262,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
+        log3.info("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);
@@ -46198,6 +46292,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
+        log3.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
       }
     });
     registerCheck(

package/dist/components/atoms/Box.d.ts

@@ -49,6 +49,10 @@ export interface BoxProps extends React.HTMLAttributes<HTMLDivElement> {
     actionPayload?: Record<string, unknown>;
     /** Declarative hover event — emits UI:{hoverEvent} with { hovered: true/false } on mouseEnter/mouseLeave */
     hoverEvent?: string;
+    /** Maximum width (CSS value, e.g., "550px", "80rem") */
+    maxWidth?: string;
+    /** Children elements */
+    children?: React.ReactNode;
 }
 /**
  * Box - Versatile container component with design tokens