@almadar/ui 2.46.1 → 2.47.0

package/dist/components/index.cjs

@@ -39,6 +39,7 @@ var patterns = require('@almadar/patterns');
 var reactRouterDom = require('react-router-dom');
 var reactQuery = require('@tanstack/react-query');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 function _interopNamespace(e) {
@@ -91,6 +92,67 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 function cn(...inputs) {
   return tailwindMerge.twMerge(clsx.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 log3 = (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) => log3("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log3("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log3("WARN", msg, data, cid),
+    error: (msg, data, cid) => log3("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;
@@ -107,6 +169,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 {
@@ -129,6 +192,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) {
@@ -152,6 +216,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };
@@ -11626,6 +11691,7 @@ function GameOverScreen({
 GameOverScreen.displayName = "GameOverScreen";
 
 // lib/verificationRegistry.ts
+createLogger("almadar:bridge");
 function getState() {
   if (typeof window !== "undefined") {
     const w = window;
@@ -29152,6 +29218,7 @@ function calculateDamage(attack, defense, isDefending = false, criticalChance =
 function generateCombatMessage(event) {
   return event.message;
 }
+var storeLog = createLogger("almadar:entity:store");
 var store = /* @__PURE__ */ new Map();
 var storeListeners = /* @__PURE__ */ new Set();
 var watchCallbacks = /* @__PURE__ */ new Map();
@@ -29191,7 +29258,9 @@ function setAll(entityType, records) {
     }
   }
   const prev = store.get(entityType);
-  store.set(entityType, { entities: entities2, ids, version: (prev?.version ?? 0) + 1 });
+  const newVersion = (prev?.version ?? 0) + 1;
+  store.set(entityType, { entities: entities2, ids, version: newVersion });
+  storeLog.debug("setAll", { entityType, recordCount: records.length, version: newVersion });
   notifyListeners(entityType, prev);
 }
 function upsertOne(entityType, record) {
@@ -29203,6 +29272,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) {
@@ -29219,6 +29289,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) {
@@ -29232,6 +29303,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 getSnapshot2(entityType) {
@@ -33386,7 +33458,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log, setLog] = React90__namespace.useState([]);
+  const [log3, setLog] = React90__namespace.useState([]);
   const prevStatesRef = React90__namespace.useRef(/* @__PURE__ */ new Map());
   React90__namespace.useEffect(() => {
     for (const trait of traits2) {
@@ -33450,9 +33522,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: [
+    log3.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: log3.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 }),
@@ -37275,21 +37347,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 log3 = (message, data) => {
     if (options?.debug) {
       console.log(`[useOrbitalMutations:${orbitalName}] ${message}`, data ?? "");
     }
   };
   const createMutation = reactQuery.useMutation({
     mutationFn: async (data) => {
-      log("Creating entity", data);
+      log3("Creating entity", data);
       return sendOrbitalEvent(orbitalName, {
         event: events2.create,
         payload: { data, entityType: entityName }
       });
     },
     onSuccess: (response) => {
-      log("Create succeeded", response);
+      log3("Create succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
     },
     onError: (error) => {
@@ -37301,7 +37373,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       id,
       data
     }) => {
-      log(`Updating entity ${id}`, data);
+      log3(`Updating entity ${id}`, data);
       return sendOrbitalEvent(orbitalName, {
         event: events2.update,
         entityId: id,
@@ -37309,7 +37381,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, variables) => {
-      log("Update succeeded", response);
+      log3("Update succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.invalidateQueries({
         queryKey: entityDataKeys.detail(entityName, variables.id)
@@ -37321,7 +37393,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
   });
   const deleteMutation = reactQuery.useMutation({
     mutationFn: async (id) => {
-      log(`Deleting entity ${id}`);
+      log3(`Deleting entity ${id}`);
       return sendOrbitalEvent(orbitalName, {
         event: events2.delete,
         entityId: id,
@@ -37329,7 +37401,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, id) => {
-      log("Delete succeeded", response);
+      log3("Delete succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.removeQueries({ queryKey: entityDataKeys.detail(entityName, id) });
     },

package/dist/components/index.js

@@ -45,6 +45,67 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 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 log3 = (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) => log3("DEBUG", msg, data, cid),
+    info: (msg, data, cid) => log3("INFO", msg, data, cid),
+    warn: (msg, data, cid) => log3("WARN", msg, data, cid),
+    error: (msg, data, cid) => log3("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;
@@ -61,6 +122,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 {
@@ -83,6 +145,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) {
@@ -106,6 +169,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };
@@ -11580,6 +11644,7 @@ function GameOverScreen({
 GameOverScreen.displayName = "GameOverScreen";
 
 // lib/verificationRegistry.ts
+createLogger("almadar:bridge");
 function getState() {
   if (typeof window !== "undefined") {
     const w = window;
@@ -29106,6 +29171,7 @@ function calculateDamage(attack, defense, isDefending = false, criticalChance =
 function generateCombatMessage(event) {
   return event.message;
 }
+var storeLog = createLogger("almadar:entity:store");
 var store = /* @__PURE__ */ new Map();
 var storeListeners = /* @__PURE__ */ new Set();
 var watchCallbacks = /* @__PURE__ */ new Map();
@@ -29145,7 +29211,9 @@ function setAll(entityType, records) {
     }
   }
   const prev = store.get(entityType);
-  store.set(entityType, { entities: entities2, ids, version: (prev?.version ?? 0) + 1 });
+  const newVersion = (prev?.version ?? 0) + 1;
+  store.set(entityType, { entities: entities2, ids, version: newVersion });
+  storeLog.debug("setAll", { entityType, recordCount: records.length, version: newVersion });
   notifyListeners(entityType, prev);
 }
 function upsertOne(entityType, record) {
@@ -29157,6 +29225,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) {
@@ -29173,6 +29242,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) {
@@ -29186,6 +29256,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 getSnapshot2(entityType) {
@@ -33340,7 +33411,7 @@ function getAllEvents(traits2) {
 }
 function EventDispatcherTab({ traits: traits2, schema }) {
   const eventBus = useEventBus();
-  const [log, setLog] = React90.useState([]);
+  const [log3, setLog] = React90.useState([]);
   const prevStatesRef = React90.useRef(/* @__PURE__ */ new Map());
   React90.useEffect(() => {
     for (const trait of traits2) {
@@ -33404,9 +33475,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: [
+    log3.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: log3.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 }),
@@ -37229,21 +37300,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 log3 = (message, data) => {
     if (options?.debug) {
       console.log(`[useOrbitalMutations:${orbitalName}] ${message}`, data ?? "");
     }
   };
   const createMutation = useMutation({
     mutationFn: async (data) => {
-      log("Creating entity", data);
+      log3("Creating entity", data);
       return sendOrbitalEvent(orbitalName, {
         event: events2.create,
         payload: { data, entityType: entityName }
       });
     },
     onSuccess: (response) => {
-      log("Create succeeded", response);
+      log3("Create succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
     },
     onError: (error) => {
@@ -37255,7 +37326,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       id,
       data
     }) => {
-      log(`Updating entity ${id}`, data);
+      log3(`Updating entity ${id}`, data);
       return sendOrbitalEvent(orbitalName, {
         event: events2.update,
         entityId: id,
@@ -37263,7 +37334,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, variables) => {
-      log("Update succeeded", response);
+      log3("Update succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.invalidateQueries({
         queryKey: entityDataKeys.detail(entityName, variables.id)
@@ -37275,7 +37346,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
   });
   const deleteMutation = useMutation({
     mutationFn: async (id) => {
-      log(`Deleting entity ${id}`);
+      log3(`Deleting entity ${id}`);
       return sendOrbitalEvent(orbitalName, {
         event: events2.delete,
         entityId: id,
@@ -37283,7 +37354,7 @@ function useOrbitalMutations(entityName, orbitalName, options) {
       });
     },
     onSuccess: (response, id) => {
-      log("Delete succeeded", response);
+      log3("Delete succeeded", response);
       queryClient.invalidateQueries({ queryKey: entityDataKeys.list(entityName) });
       queryClient.removeQueries({ queryKey: entityDataKeys.detail(entityName, id) });
     },

package/dist/components/organisms/game/three/index.cjs

@@ -14,6 +14,7 @@ var clsx = require('clsx');
 var tailwindMerge = require('tailwind-merge');
 var postprocessing = require('@react-three/postprocessing');
 
+var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 function _interopNamespace(e) {
@@ -1375,6 +1376,67 @@ function useRaycaster(options) {
     isWithinCanvas
   };
 }
+
+// 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;
@@ -1391,6 +1453,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 {
@@ -1413,6 +1476,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) {
@@ -1436,6 +1500,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };

package/dist/components/organisms/game/three/index.js

@@ -1351,6 +1351,67 @@ function useRaycaster(options) {
     isWithinCanvas
   };
 }
+
+// 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;
@@ -1367,6 +1428,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 {
@@ -1389,6 +1451,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) {
@@ -1412,6 +1475,7 @@ var fallbackEventBus = {
   },
   onAny: (listener) => {
     fallbackAnyListeners.add(listener);
+    subLog.debug("subscribe:any", { totalAnyListeners: fallbackAnyListeners.size });
     return () => {
       fallbackAnyListeners.delete(listener);
     };