@almadar/ui 2.46.1 → 2.47.0

package/dist/runtime/index.js

@@ -44,6 +44,67 @@ import langGraphql from 'react-syntax-highlighter/dist/esm/languages/prism/graph
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// lib/logger.ts
+var LEVEL_PRIORITY = { DEBUG: 0, INFO: 1, WARN: 2, ERROR: 3 };
+var ENV = typeof process !== "undefined" && process.env ? process.env : {};
+var VITE_ENV = typeof globalThis !== "undefined" && globalThis.__vite_env__ ? globalThis.__vite_env__ : {};
+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];
+}
+var NODE_ENV = envGet("NODE_ENV", "VITE_NODE_ENV") ?? "development";
+var CONFIGURED_LEVEL = (envGet("LOG_LEVEL", "VITE_LOG_LEVEL") ?? (NODE_ENV === "production" ? "info" : "debug")).toUpperCase();
+var MIN_PRIORITY = LEVEL_PRIORITY[CONFIGURED_LEVEL] ?? 0;
+var DEBUG_FILTER = (envGet("ALMADAR_DEBUG", "VITE_ALMADAR_DEBUG") ?? "").split(",").map((s) => s.trim()).filter(Boolean);
+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)
+  };
+}
+
+// hooks/useEventBus.ts
+var log = createLogger("almadar:eventbus");
+var subLog = createLogger("almadar:eventbus:subscribe");
 function setGlobalEventBus(bus) {
   if (typeof window !== "undefined") {
     window.__kflowEventBus = bus;
@@ -65,6 +126,7 @@ var fallbackEventBus = {
       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 {
@@ -87,6 +149,7 @@ var fallbackEventBus = {
       fallbackListeners.set(type, /* @__PURE__ */ new Set());
     }
     fallbackListeners.get(type).add(listener);
+    subLog.debug("subscribe", { type, totalListeners: fallbackListeners.get(type).size });
     return () => {
       const handlers = fallbackListeners.get(type);
       if (handlers) {
@@ -110,6 +173,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };
@@ -768,6 +832,7 @@ function subscribeToTraitChanges(listener) {
 }
 
 // lib/verificationRegistry.ts
+var log2 = createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
   if (typeof window !== "undefined") {
@@ -800,6 +865,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();
@@ -931,10 +997,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 = [];
@@ -2086,6 +2154,7 @@ function useTheme() {
   }
   return context;
 }
+var storeLog = createLogger("almadar:entity:store");
 var store = /* @__PURE__ */ new Map();
 var storeListeners = /* @__PURE__ */ new Set();
 var watchCallbacks = /* @__PURE__ */ new Map();
@@ -2125,7 +2194,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 });
   notifyListeners3(entityType, prev);
 }
 function upsertOne(entityType, record) {
@@ -2137,6 +2208,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 });
   notifyListeners3(entityType, prev);
 }
 function addOne(entityType, record) {
@@ -2153,6 +2225,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 });
   notifyListeners3(entityType, prev);
 }
 function removeOne(entityType, id) {
@@ -2166,6 +2239,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 });
   notifyListeners3(entityType, prev);
 }
 function getSnapshot3(entityType) {
@@ -2214,6 +2288,8 @@ function useEntityStore() {
 function EntityStoreProvider({ children }) {
   return /* @__PURE__ */ jsx(EntityStoreContext.Provider, { value: contextValue, children });
 }
+var busLog = createLogger("almadar:eventbus");
+var subLog2 = createLogger("almadar:eventbus:subscribe");
 var EventBusContext2 = createContext(null);
 function EventBusProvider({ children, debug: debug2 = false }) {
   const listenersRef = useRef(/* @__PURE__ */ new Map());
@@ -2243,7 +2319,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);
@@ -2276,6 +2353,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
     }
     const listeners6 = listenersRef.current.get(type);
     listeners6.add(listener);
+    subLog2.debug("subscribe", { type, totalListeners: listeners6.size });
     if (debug2) {
       console.log(`[EventBus] Subscribed to '${type}', total: ${listeners6.size}`);
     }
@@ -2302,6 +2380,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
   }, []);
   const onAny = useCallback((listener) => {
     anyListenersRef.current.add(listener);
+    subLog2.debug("subscribe:any", { totalAnyListeners: anyListenersRef.current.size });
     if (debug2) {
       console.log(`[EventBus] onAny subscribed, total: ${anyListenersRef.current.size}`);
     }
@@ -28446,7 +28525,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log, setLog] = React117.useState([]);
+  const [log4, setLog] = React117.useState([]);
   const prevStatesRef = React117.useRef(/* @__PURE__ */ new Map());
   React117.useEffect(() => {
     for (const trait of traits2) {
@@ -28510,9 +28589,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 }),
@@ -33051,6 +33130,7 @@ function UISlotRenderer({
   return wrapped;
 }
 UISlotRenderer.displayName = "UISlotRenderer";
+var log3 = createLogger("almadar:verify");
 var DISPATCH_SUFFIX = ":DISPATCH";
 var SUCCESS_SUFFIX = ":SUCCESS";
 var ERROR_SUFFIX = ":ERROR";
@@ -33096,6 +33176,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"] ?? "")}`;
@@ -33148,6 +33229,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);
@@ -33177,6 +33259,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
+        log3.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
       }
     });
     registerCheck(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "2.46.1",
+  "version": "2.47.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "main": "./dist/components/index.js",