@almadar/ui 2.46.0 → 2.47.0

package/dist/providers/index.cjs

@@ -38,6 +38,7 @@ var langToml = require('react-syntax-highlighter/dist/esm/languages/prism/toml')
 var langGo = require('react-syntax-highlighter/dist/esm/languages/prism/go');
 var langGraphql = require('react-syntax-highlighter/dist/esm/languages/prism/graphql');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 function _interopNamespace(e) {
@@ -317,6 +318,64 @@ var ThemeProvider = ({
   );
   return /* @__PURE__ */ jsxRuntime.jsx(ThemeContext.Provider, { value: contextValue2, children });
 };
+
+// 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 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 storeLog = createLogger("almadar:entity:store");
 var store = /* @__PURE__ */ new Map();
 var storeListeners = /* @__PURE__ */ new Set();
 var watchCallbacks = /* @__PURE__ */ new Map();
@@ -356,7 +415,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) {
@@ -368,6 +429,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) {
@@ -384,6 +446,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) {
@@ -397,6 +460,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) {
@@ -479,6 +543,8 @@ function useEntityStore() {
 function EntityStoreProvider({ children }) {
   return /* @__PURE__ */ jsxRuntime.jsx(EntityStoreContext.Provider, { value: contextValue, children });
 }
+var log = createLogger("almadar:eventbus");
+var subLog = createLogger("almadar:eventbus:subscribe");
 function setGlobalEventBus(bus) {
   if (typeof window !== "undefined") {
     window.__kflowEventBus = bus;
@@ -500,6 +566,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 {
@@ -522,6 +589,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) {
@@ -545,6 +613,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };
@@ -554,6 +623,8 @@ function useEventBus() {
   const context = React114.useContext(providers.EventBusContext);
   return context ?? getGlobalEventBus() ?? fallbackEventBus;
 }
+var busLog = createLogger("almadar:eventbus");
+var subLog2 = createLogger("almadar:eventbus:subscribe");
 var EventBusContext2 = React114.createContext(null);
 function EventBusProvider({ children, debug: debug2 = false }) {
   const listenersRef = React114.useRef(/* @__PURE__ */ new Map());
@@ -583,7 +654,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);
@@ -616,6 +688,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}`);
     }
@@ -642,6 +715,7 @@ function EventBusProvider({ children, debug: debug2 = false }) {
   }, []);
   const onAny = React114.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}`);
     }
@@ -923,6 +997,7 @@ var Box = React114__namespace.default.forwardRef(
     action,
     actionPayload,
     hoverEvent,
+    maxWidth,
     onClick,
     onMouseEnter,
     onMouseLeave,
@@ -987,6 +1062,7 @@ var Box = React114__namespace.default.forwardRef(
         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
       }
@@ -3124,6 +3200,7 @@ var defaultIcon = L__default.default.icon({
 L__default.default.Marker.prototype.options.icon = defaultIcon;
 
 // lib/verificationRegistry.ts
+var log2 = createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
   if (typeof window !== "undefined") {
@@ -3156,6 +3233,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();
@@ -3257,10 +3335,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 = [];
@@ -3721,6 +3801,7 @@ function SuspenseConfigProvider({
   );
 }
 SuspenseConfigProvider.displayName = "SuspenseConfigProvider";
+var log3 = createLogger("almadar:verify");
 var DISPATCH_SUFFIX = ":DISPATCH";
 var SUCCESS_SUFFIX = ":SUCCESS";
 var ERROR_SUFFIX = ":ERROR";
@@ -3766,6 +3847,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"] ?? "")}`;
@@ -3818,6 +3900,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);
@@ -3847,6 +3930,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
+        log3.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
       }
     });
     registerCheck(

package/dist/providers/index.js

@@ -271,6 +271,64 @@ var ThemeProvider = ({
   );
   return /* @__PURE__ */ jsx(ThemeContext.Provider, { value: contextValue2, children });
 };
+
+// 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)
+  };
+}
+var storeLog = createLogger("almadar:entity:store");
 var store = /* @__PURE__ */ new Map();
 var storeListeners = /* @__PURE__ */ new Set();
 var watchCallbacks = /* @__PURE__ */ new Map();
@@ -310,7 +368,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) {
@@ -322,6 +382,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) {
@@ -338,6 +399,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) {
@@ -351,6 +413,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) {
@@ -433,6 +496,8 @@ function useEntityStore() {
 function EntityStoreProvider({ children }) {
   return /* @__PURE__ */ jsx(EntityStoreContext.Provider, { value: contextValue, children });
 }
+var log = createLogger("almadar:eventbus");
+var subLog = createLogger("almadar:eventbus:subscribe");
 function setGlobalEventBus(bus) {
   if (typeof window !== "undefined") {
     window.__kflowEventBus = bus;
@@ -454,6 +519,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 {
@@ -476,6 +542,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) {
@@ -499,6 +566,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };
@@ -508,6 +576,8 @@ function useEventBus() {
   const context = useContext(EventBusContext);
   return context ?? getGlobalEventBus() ?? fallbackEventBus;
 }
+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());
@@ -537,7 +607,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);
@@ -570,6 +641,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}`);
     }
@@ -596,6 +668,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}`);
     }
@@ -877,6 +950,7 @@ var Box = React114__default.forwardRef(
     action,
     actionPayload,
     hoverEvent,
+    maxWidth,
     onClick,
     onMouseEnter,
     onMouseLeave,
@@ -941,6 +1015,7 @@ var Box = React114__default.forwardRef(
         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
       }
@@ -3078,6 +3153,7 @@ var defaultIcon = L.icon({
 L.Marker.prototype.options.icon = defaultIcon;
 
 // lib/verificationRegistry.ts
+var log2 = createLogger("almadar:bridge");
 var MAX_TRANSITIONS = 500;
 function getState() {
   if (typeof window !== "undefined") {
@@ -3110,6 +3186,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();
@@ -3211,10 +3288,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 = [];
@@ -3675,6 +3754,7 @@ function SuspenseConfigProvider({
   );
 }
 SuspenseConfigProvider.displayName = "SuspenseConfigProvider";
+var log3 = createLogger("almadar:verify");
 var DISPATCH_SUFFIX = ":DISPATCH";
 var SUCCESS_SUFFIX = ":SUCCESS";
 var ERROR_SUFFIX = ":ERROR";
@@ -3720,6 +3800,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"] ?? "")}`;
@@ -3772,6 +3853,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);
@@ -3801,6 +3883,7 @@ function VerificationProvider({
           },
           timestamp: Date.now()
         });
+        log3.warn("transition:error", { trait: parsed.traitName, event: parsed.event, from: fromState, error: errorMsg });
       }
     });
     registerCheck(