@almadar/ui 2.46.1 → 2.47.0

package/dist/docs/index.cjs

@@ -4,6 +4,7 @@ var React4 = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 var LucideIcons = require('lucide-react');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 function _interopNamespace(e) {
@@ -2506,9 +2507,70 @@ var twMerge = /* @__PURE__ */ createTailwindMerge(getDefaultConfig);
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
+
+// 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 = ({ 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];
+}
+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 log2 = (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) => log2("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log2("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log2("WARN", msg, data, cid),
+    error: (msg, data, cid) => log2("ERROR", msg, data, cid)
+  };
+}
+createLogger("almadar:eventbus");
+createLogger("almadar:eventbus:subscribe");
 var EventBusContext = React4.createContext(null);
 
 // hooks/useEventBus.ts
+var log = createLogger("almadar:eventbus");
+var subLog2 = createLogger("almadar:eventbus:subscribe");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -2525,6 +2587,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 {
@@ -2547,6 +2610,7 @@ var fallbackEventBus = {
       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) {
@@ -2570,6 +2634,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog2.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };

package/dist/docs/index.js

@@ -2482,9 +2482,70 @@ var twMerge = /* @__PURE__ */ createTailwindMerge(getDefaultConfig);
 function cn(...inputs) {
   return twMerge(clsx(inputs));
 }
+
+// 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 log2 = (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) => log2("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log2("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log2("WARN", msg, data, cid),
+    error: (msg, data, cid) => log2("ERROR", msg, data, cid)
+  };
+}
+createLogger("almadar:eventbus");
+createLogger("almadar:eventbus:subscribe");
 var EventBusContext = createContext(null);
 
 // hooks/useEventBus.ts
+var log = createLogger("almadar:eventbus");
+var subLog2 = createLogger("almadar:eventbus:subscribe");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -2501,6 +2562,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 {
@@ -2523,6 +2585,7 @@ var fallbackEventBus = {
       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) {
@@ -2546,6 +2609,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog2.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };

package/dist/hooks/index.cjs

@@ -5,6 +5,7 @@ var providers = require('@almadar/ui/providers');
 require('react/jsx-runtime');
 var reactQuery = require('@tanstack/react-query');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var React2__default = /*#__PURE__*/_interopDefault(React2);
@@ -872,6 +873,67 @@ function useDeepAgentGeneration() {
     submitInterruptDecisions
   };
 }
+
+// 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 = ({ 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];
+}
+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 log2 = (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) => log2("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log2("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log2("WARN", msg, data, cid),
+    error: (msg, data, cid) => log2("ERROR", msg, data, cid)
+  };
+}
+
+// hooks/useEventBus.ts
+var log = createLogger("almadar:eventbus");
+var subLog = createLogger("almadar:eventbus:subscribe");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -888,6 +950,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 {
@@ -910,6 +973,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) {
@@ -933,6 +997,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };
@@ -1611,21 +1676,21 @@ function useOrbitalMutations(entityName, orbitalName, options) {
     update: options?.events?.update || ENTITY_EVENTS.UPDATE,
     delete: options?.events?.delete || ENTITY_EVENTS.DELETE
   };
-  const log = (message, data) => {
+  const log2 = (message, data) => {
     if (options?.debug) {
       console.log(`[useOrbitalMutations:${orbitalName}] ${message}`, data ?? "");
     }
   };
   const createMutation = reactQuery.useMutation({
     mutationFn: async (data) => {
-      log("Creating entity", data);
+      log2("Creating entity", data);
       return sendOrbitalEvent(orbitalName, {
         event: events.create,
         payload: { data, entityType: entityName }
       });
     },
     onSuccess: (response) => {
-      log("Create succeeded", response);
+      log2("Create succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
     },
     onError: (error) => {
@@ -1637,7 +1702,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       id,
       data
     }) => {
-      log(`Updating entity ${id}`, data);
+      log2(`Updating entity ${id}`, data);
       return sendOrbitalEvent(orbitalName, {
         event: events.update,
         entityId: id,
@@ -1645,7 +1710,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, variables) => {
-      log("Update succeeded", response);
+      log2("Update succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.invalidateQueries({
         queryKey: entityDataKeys.detail(entityName, variables.id)
@@ -1657,7 +1722,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
   });
   const deleteMutation = reactQuery.useMutation({
     mutationFn: async (id) => {
-      log(`Deleting entity ${id}`);
+      log2(`Deleting entity ${id}`);
       return sendOrbitalEvent(orbitalName, {
         event: events.delete,
         entityId: id,
@@ -1665,7 +1730,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, id) => {
-      log("Delete succeeded", response);
+      log2("Delete succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.removeQueries({ queryKey: entityDataKeys.detail(entityName, id) });
     },

package/dist/hooks/index.js

@@ -866,6 +866,67 @@ function useDeepAgentGeneration() {
     submitInterruptDecisions
   };
 }
+
+// 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 log2 = (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) => log2("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log2("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log2("WARN", msg, data, cid),
+    error: (msg, data, cid) => log2("ERROR", msg, data, cid)
+  };
+}
+
+// hooks/useEventBus.ts
+var log = createLogger("almadar:eventbus");
+var subLog = createLogger("almadar:eventbus:subscribe");
 function getGlobalEventBus() {
   if (typeof window !== "undefined") {
     return window.__kflowEventBus ?? null;
@@ -882,6 +943,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 {
@@ -904,6 +966,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) {
@@ -927,6 +990,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };
@@ -1605,21 +1669,21 @@ function useOrbitalMutations(entityName, orbitalName, options) {
     update: options?.events?.update || ENTITY_EVENTS.UPDATE,
     delete: options?.events?.delete || ENTITY_EVENTS.DELETE
   };
-  const log = (message, data) => {
+  const log2 = (message, data) => {
     if (options?.debug) {
       console.log(`[useOrbitalMutations:${orbitalName}] ${message}`, data ?? "");
     }
   };
   const createMutation = useMutation({
     mutationFn: async (data) => {
-      log("Creating entity", data);
+      log2("Creating entity", data);
       return sendOrbitalEvent(orbitalName, {
         event: events.create,
         payload: { data, entityType: entityName }
       });
     },
     onSuccess: (response) => {
-      log("Create succeeded", response);
+      log2("Create succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
     },
     onError: (error) => {
@@ -1631,7 +1695,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       id,
       data
     }) => {
-      log(`Updating entity ${id}`, data);
+      log2(`Updating entity ${id}`, data);
       return sendOrbitalEvent(orbitalName, {
         event: events.update,
         entityId: id,
@@ -1639,7 +1703,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, variables) => {
-      log("Update succeeded", response);
+      log2("Update succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.invalidateQueries({
         queryKey: entityDataKeys.detail(entityName, variables.id)
@@ -1651,7 +1715,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
   });
   const deleteMutation = useMutation({
     mutationFn: async (id) => {
-      log(`Deleting entity ${id}`);
+      log2(`Deleting entity ${id}`);
       return sendOrbitalEvent(orbitalName, {
         event: events.delete,
         entityId: id,
@@ -1659,7 +1723,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, id) => {
-      log("Delete succeeded", response);
+      log2("Delete succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.removeQueries({ queryKey: entityDataKeys.detail(entityName, id) });
     },

package/dist/lib/index.cjs

@@ -3,6 +3,7 @@
 var clsx = require('clsx');
 var tailwindMerge = require('tailwind-merge');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function cn(...inputs) {
   return tailwindMerge.twMerge(clsx.clsx(inputs));
 }
@@ -427,7 +428,69 @@ function clearTraits() {
   notifyListeners4();
 }
 
+// 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 = ({ 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];
+}
+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 log2 = (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) => log2("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log2("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log2("WARN", msg, data, cid),
+    error: (msg, data, cid) => log2("ERROR", msg, data, cid)
+  };
+}
+var _cidCounter = 0;
+function generateCorrelationId() {
+  return `evt-${Date.now()}-${++_cidCounter}`;
+}
+
 // lib/verificationRegistry.ts
+var log = createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
   if (typeof window !== "undefined") {
@@ -471,6 +534,7 @@ function recordTransition(trace) {
     ...trace,
     id: `t-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`
   };
+  log.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();
@@ -620,10 +684,12 @@ function waitForTransition(event, timeoutMs = 1e4) {
 }
 function bindEventBus(eventBus) {
   if (typeof window === "undefined") return;
+  log.info("bindEventBus", { hasOnAny: !!eventBus.onAny });
   exposeOnWindow();
   if (window.__orbitalVerification) {
     window.__orbitalVerification.sendEvent = (event, payload) => {
       const prefixed = event.startsWith("UI:") ? event : `UI:${event}`;
+      log.debug("sendEvent", { event: prefixed, payloadKeys: payload ? Object.keys(payload) : [] });
       eventBus.emit(prefixed, payload);
     };
     const eventLog = [];
@@ -1461,6 +1527,7 @@ exports.clearTicks = clearTicks;
 exports.clearTraits = clearTraits;
 exports.clearVerification = clearVerification;
 exports.cn = cn;
+exports.createLogger = createLogger;
 exports.debug = debug;
 exports.debugCollision = debugCollision;
 exports.debugError = debugError;
@@ -1477,6 +1544,7 @@ exports.extractOutputsFromTransitions = extractOutputsFromTransitions;
 exports.extractStateMachine = extractStateMachine;
 exports.formatGuard = formatGuard;
 exports.formatNestedFieldLabel = formatNestedFieldLabel;
+exports.generateCorrelationId = generateCorrelationId;
 exports.getAllChecks = getAllChecks;
 exports.getAllTicks = getAllTicks;
 exports.getAllTraits = getAllTraits;

package/dist/lib/index.d.ts

@@ -16,3 +16,4 @@ export * from './verificationRegistry';
 export * from './getNestedValue';
 export * from './visualizer';
 export * from './parseContentSegments';
+export * from './logger';