@almadar/ui 5.112.0 → 5.113.0

package/dist/avl/index.cjs

@@ -13258,14 +13258,16 @@ function Canvas2D({
   cameraPos,
   bgColor
 }) {
+  const instanceId = React90.useMemo(() => Math.random().toString(36).slice(2, 8), []);
+  function isDrawableLayer(node) {
+    return node.type === "draw-sprite-layer" || node.type === "draw-shape-layer" || node.type === "draw-text-layer";
+  }
   const layerSummaries = drawables?.map((d) => {
-    if (!d || typeof d !== "object") return d;
-    const rec = d;
-    return { type: rec.type, itemsLen: Array.isArray(rec.items) ? rec.items.length : void 0, firstItem: Array.isArray(rec.items) ? rec.items[0] : void 0 };
+    if (!isDrawableLayer(d)) return { type: d.type };
+    return { type: d.type, itemsLen: d.items.length, firstItem: d.items[0] };
   });
-  console.error("[debug:Canvas2D] " + JSON.stringify({ projection, scale, cameraMode: camera, cameraPos, drawablesCount: drawables?.length, layerSummaries }));
+  canvas2DLog.debug("Canvas2D render", { instanceId, projection, scale, cameraMode: camera, cameraPos: cameraPos ? JSON.stringify(cameraPos) : void 0, drawablesCount: drawables?.length, layerSummaries: layerSummaries ? JSON.stringify(layerSummaries) : void 0 });
   const backgroundImage = normalizeBackdrop(backgroundImageRaw);
-  const instanceId = React90.useMemo(() => Math.random().toString(36).slice(2, 8), []);
   const isFree = projection === "free";
   const squareGrid = projection === "flat" || isFree || projection === "side";
   const layout = projection === "side" ? "free" : projection;
@@ -13400,7 +13402,7 @@ function Canvas2D({
     }
     const containerRect = containerRef.current?.getBoundingClientRect();
     const canvasRect = canvas.getBoundingClientRect();
-    console.error("[debug:Canvas2D:draw:" + instanceId + "] " + JSON.stringify({ viewportSize, baseOffsetX, cam: { x: cam.x, y: cam.y, zoom: cam.zoom }, cameraPos, containerRect: containerRect ? { width: containerRect.width, height: containerRect.height } : null, canvasRect: canvasRect ? { width: canvasRect.width, height: canvasRect.height } : null }));
+    canvas2DLog.debug("Canvas2D draw", { instanceId, viewportSize, baseOffsetX, cam: { x: cam.x, y: cam.y, zoom: cam.zoom }, cameraPos: cameraPos ? JSON.stringify(cameraPos) : void 0, containerRect: containerRect ? { width: containerRect.width, height: containerRect.height } : null, canvasRect: canvasRect ? { width: canvasRect.width, height: canvasRect.height } : null });
     const painter = createWebPainter(ctx, bumpAtlas);
     painter.save();
     painter.translate(viewportSize.width / 2, viewportSize.height / 2);
@@ -13612,6 +13614,7 @@ function Canvas2D({
     }
   );
 }
+var canvas2DLog;
 var init_Canvas2D = __esm({
   "components/game/molecules/Canvas2D.tsx"() {
     "use client";
@@ -13633,6 +13636,7 @@ var init_Canvas2D = __esm({
     init_paintDispatch();
     init_hitTest();
     init_isometric();
+    canvas2DLog = logger.createLogger("almadar:ui:game-canvas");
     Canvas2D.displayName = "Canvas2D";
   }
 });
@@ -13671,7 +13675,7 @@ function Canvas({
   keyMap,
   keyUpMap
 }) {
-  console.error("[debug:Canvas] " + JSON.stringify({ mode, drawablesCount: drawables?.length, projection, camera }));
+  canvasLog.debug("Canvas render", { mode, drawablesCount: drawables?.length, projection, camera: camera ? JSON.stringify(camera) : void 0 });
   const zoom = camera?.zoom;
   if (mode === "3d") {
     const props3d = {
@@ -13724,7 +13728,7 @@ function Canvas({
     }
   );
 }
-var Canvas3DHost;
+var Canvas3DHost, canvasLog;
 var init_Canvas = __esm({
   "components/game/molecules/Canvas.tsx"() {
     "use client";
@@ -13732,6 +13736,7 @@ var init_Canvas = __esm({
     Canvas3DHost = React90.lazy(
       () => import('@almadar/ui/components/molecules/game/three').then((m) => ({ default: m.Canvas3DHost }))
     );
+    canvasLog = logger.createLogger("almadar:ui:game-canvas");
     Canvas.displayName = "Canvas";
   }
 });
@@ -50194,6 +50199,8 @@ var flushLog = logger.createLogger("almadar:ui:slot-flush");
 var stateLog = logger.createLogger("almadar:ui:state-transitions");
 var tickLog = logger.createLogger("almadar:ui:tick-effects");
 logger.setNamespaceLevel("almadar:ui:tick-effects", "WARN");
+var sharedEntityLog = logger.createLogger("almadar:ui:shared-entity");
+logger.setNamespaceLevel("almadar:ui:shared-entity", "WARN");
 var SYNC_TICK_OPERATORS = /* @__PURE__ */ new Set([
   "set",
   "emit",
@@ -50288,7 +50295,7 @@ function createSharedEntityWriter(binding, tick, traitStatesRef, emit) {
 function getBindingConfig(binding) {
   const raw = binding.config;
   const normalized = runtime.normalizeCallSiteConfigToValues(raw);
-  console.log("[debug:getBindingConfig]", binding.trait.name, "raw keys=", raw ? Object.keys(raw) : "undefined", "has tiles=", raw ? "tiles" in raw : false);
+  sharedEntityLog.debug("getBindingConfig", { traitName: binding.trait.name, rawKeys: raw ? Object.keys(raw) : void 0, hasTiles: raw ? "tiles" in raw : false });
   return normalized;
 }
 function evalFieldDefault(value) {
@@ -50303,7 +50310,7 @@ function evalFieldDefault(value) {
   }
 }
 function useTraitStateMachine(traitBindings, uiSlots, options) {
-  console.log("[debug:useTraitStateMachine] start, traitBindings count=", traitBindings.length, "names=", traitBindings.map((b) => b.trait.name).join(","));
+  sharedEntityLog.debug("useTraitStateMachine start", { traitBindingsCount: traitBindings.length, traitNames: traitBindings.map((b) => b.trait.name) });
   const eventBus = useEventBus();
   const { entities } = providers.useEntitySchema();
   const traitConfigsByName = options?.traitConfigsByName;
@@ -50322,10 +50329,15 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       if (!group) {
         let defaults;
         for (const field of entityDef.fields) {
-          if (field.default !== void 0) {
+          if (field.default !== void 0 && field.default !== null) {
             const evaluated = evalFieldDefault(field.default);
             if (field.name === "tiles") {
-              console.log(`[debug:seed] ${linkedEntityName}.tiles seed type=`, typeof evaluated, Array.isArray(evaluated) ? "len=" + evaluated?.length : "", "head=", Array.isArray(evaluated) && evaluated.length > 0 ? JSON.stringify(evaluated[0]).slice(0, 80) : "n/a");
+              sharedEntityLog.debug("seed tiles", {
+                linkedEntityName,
+                type: typeof evaluated,
+                length: Array.isArray(evaluated) ? evaluated?.length : void 0,
+                head: Array.isArray(evaluated) && evaluated.length > 0 ? JSON.stringify(evaluated[0]).slice(0, 80) : void 0
+              });
             }
             (defaults ?? (defaults = {}))[field.name] = evaluated;
           }
@@ -50342,7 +50354,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   for (const group of sharedGroups.values()) {
     if (group.defaults) {
       sharedEntityStore.seed(group.storeKey, group.defaults);
-      console.log("[debug:shared-seed]", group.storeKey, "writers=", group.writerBindings.map((b) => b.trait.name).join(","), "renderers=", group.renderBindings.map((b) => b.trait.name).join(","), "defaults.tiles=", Array.isArray(group.defaults.tiles) ? group.defaults.tiles.length : group.defaults.tiles);
+      sharedEntityLog.debug("shared-seed", {
+        storeKey: group.storeKey,
+        writers: group.writerBindings.map((b) => b.trait.name),
+        renderers: group.renderBindings.map((b) => b.trait.name),
+        tilesLength: Array.isArray(group.defaults.tiles) ? group.defaults.tiles.length : group.defaults.tiles
+      });
     }
   }
   const sharedKeyByTraitNameRef = React90.useRef(/* @__PURE__ */ new Map());
@@ -50353,7 +50370,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       for (const binding of group.renderBindings) map.set(binding.trait.name, group.storeKey);
     }
     sharedKeyByTraitNameRef.current = map;
-    console.log("[debug:shared-map]", Array.from(map.entries()).map(([k, v]) => `${k}->${v}`).join(","));
+    sharedEntityLog.debug("shared-map", { map: Array.from(map.entries()).map(([k, v]) => `${k}->${v}`) });
   }, [sharedGroups]);
   const manager = React90.useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
@@ -50543,7 +50560,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const entityId = payload?.entityId;
     const sharedKey = sharedKeyByTraitNameRef.current.get(traitName);
     if (traitName === "Hero" || traitName === "Authority") {
-      console.log(`[debug:executeTransitionEffects] ${traitName} sharedKey=`, sharedKey, "store tiles=", sharedKey ? sharedEntityStore.getSnapshot(sharedKey).tiles?.length : "n/a");
+      sharedEntityLog.debug("executeTransitionEffects sharedKey", { traitName, sharedKey, storeTilesLength: sharedKey ? sharedEntityStore.getSnapshot(sharedKey).tiles?.length : void 0 });
     }
     let liveEntity;
     if (sharedKey !== void 0) {
@@ -50570,10 +50587,15 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         addPattern: (slot, pattern, props) => {
           if (traitName === "Hero" && slot === "main" && props && typeof props === "object") {
             const canvasChild = Array.isArray(props.children) ? props.children[0] : null;
-            const grandChildren = canvasChild && typeof canvasChild === "object" ? canvasChild.children : null;
+            const grandChildren = canvasChild && typeof canvasChild === "object" && !Array.isArray(canvasChild) ? canvasChild.children : null;
             const firstLayer = Array.isArray(grandChildren) && grandChildren.length > 0 ? grandChildren[0] : null;
-            const firstLayerItems = firstLayer && typeof firstLayer === "object" ? firstLayer.items : null;
-            console.log(`[debug:render-ui] ${traitName} slot=${slot} canvasChild=`, canvasChild ? canvasChild.type : "none", "firstLayerItems=", Array.isArray(firstLayerItems) ? firstLayerItems.length : firstLayerItems);
+            const firstLayerItems = firstLayer && typeof firstLayer === "object" && !Array.isArray(firstLayer) ? firstLayer.items : null;
+            sharedEntityLog.debug("render-ui main slot", {
+              traitName,
+              slot,
+              canvasChildType: canvasChild && typeof canvasChild === "object" && !Array.isArray(canvasChild) ? canvasChild.type : "none",
+              firstLayerItemsLength: Array.isArray(firstLayerItems) ? firstLayerItems.length : firstLayerItems
+            });
           }
           const existing = pendingSlots.get(slot) || [];
           existing.push({ pattern, props: props || {} });
@@ -50665,7 +50687,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       };
     }
     if (traitName === "Authority" || traitName === "Hero") {
-      console.log(`[debug:executeTransitionEffects] ${traitName} config tiles type=`, typeof bindingCtx.config?.tiles, Array.isArray(bindingCtx.config?.tiles) ? "len=" + bindingCtx.config?.tiles?.length : "", "keys=", bindingCtx.config ? Object.keys(bindingCtx.config) : "none");
+      sharedEntityLog.debug("executeTransitionEffects config tiles", {
+        traitName,
+        tilesType: typeof bindingCtx.config?.tiles,
+        tilesLength: Array.isArray(bindingCtx.config?.tiles) ? bindingCtx.config?.tiles?.length : void 0,
+        configKeys: bindingCtx.config ? Object.keys(bindingCtx.config) : void 0
+      });
     }
     const effectContext = {
       traitName,
@@ -50684,13 +50711,23 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
     };
     if (traitName === "Hero") {
-      console.log(`[debug:executeTransitionEffects] ${traitName} effects count=${effects.length} hasRenderUI=${typeof handlers.renderUI === "function"} effect heads=${effects.map((e) => Array.isArray(e) ? String(e[0]) : "??").join(",")}`);
+      sharedEntityLog.debug("executeTransitionEffects effects summary", {
+        traitName,
+        effectsCount: effects.length,
+        hasRenderUI: typeof handlers.renderUI === "function",
+        effectHeads: effects.map((e) => Array.isArray(e) ? String(e[0]) : "??")
+      });
     }
     const executor = new runtime.EffectExecutor({ handlers: trackingHandlers, bindings: bindingCtx, context: effectContext });
     try {
       await executor.executeAll(effects);
       if (traitName === "Authority" || traitName === "Hero") {
-        console.log(`[debug:executeTransitionEffects] ${traitName} after executeAll liveEntity.tiles type=`, typeof liveEntity.tiles, Array.isArray(liveEntity.tiles) ? "len=" + liveEntity.tiles?.length : "", "firstTilePos=", Array.isArray(liveEntity.tiles) && liveEntity.tiles.length > 0 ? JSON.stringify(liveEntity.tiles[0]).slice(0, 120) : "n/a");
+        sharedEntityLog.debug("executeTransitionEffects after executeAll", {
+          traitName,
+          tilesType: typeof liveEntity.tiles,
+          tilesLength: Array.isArray(liveEntity.tiles) ? liveEntity.tiles?.length : void 0,
+          firstTilePos: Array.isArray(liveEntity.tiles) && liveEntity.tiles.length > 0 ? JSON.stringify(liveEntity.tiles[0]).slice(0, 120) : void 0
+        });
       }
       if (sharedKey !== void 0) {
         sharedEntityStore.commit(sharedKey, liveEntity);
@@ -51438,6 +51475,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
       hadPrev: prevTraitsRef.current !== void 0
     }));
     if (refChanged) {
+      navLog.info("page:traits-reset", { traitsCount: Array.isArray(traits2) ? traits2.length : -1 });
       uiSlots.clearAll();
       initSentRef.current = false;
     }

package/dist/avl/index.js

@@ -13212,14 +13212,16 @@ function Canvas2D({
   cameraPos,
   bgColor
 }) {
+  const instanceId = useMemo(() => Math.random().toString(36).slice(2, 8), []);
+  function isDrawableLayer(node) {
+    return node.type === "draw-sprite-layer" || node.type === "draw-shape-layer" || node.type === "draw-text-layer";
+  }
   const layerSummaries = drawables?.map((d) => {
-    if (!d || typeof d !== "object") return d;
-    const rec = d;
-    return { type: rec.type, itemsLen: Array.isArray(rec.items) ? rec.items.length : void 0, firstItem: Array.isArray(rec.items) ? rec.items[0] : void 0 };
+    if (!isDrawableLayer(d)) return { type: d.type };
+    return { type: d.type, itemsLen: d.items.length, firstItem: d.items[0] };
   });
-  console.error("[debug:Canvas2D] " + JSON.stringify({ projection, scale, cameraMode: camera, cameraPos, drawablesCount: drawables?.length, layerSummaries }));
+  canvas2DLog.debug("Canvas2D render", { instanceId, projection, scale, cameraMode: camera, cameraPos: cameraPos ? JSON.stringify(cameraPos) : void 0, drawablesCount: drawables?.length, layerSummaries: layerSummaries ? JSON.stringify(layerSummaries) : void 0 });
   const backgroundImage = normalizeBackdrop(backgroundImageRaw);
-  const instanceId = useMemo(() => Math.random().toString(36).slice(2, 8), []);
   const isFree = projection === "free";
   const squareGrid = projection === "flat" || isFree || projection === "side";
   const layout = projection === "side" ? "free" : projection;
@@ -13354,7 +13356,7 @@ function Canvas2D({
     }
     const containerRect = containerRef.current?.getBoundingClientRect();
     const canvasRect = canvas.getBoundingClientRect();
-    console.error("[debug:Canvas2D:draw:" + instanceId + "] " + JSON.stringify({ viewportSize, baseOffsetX, cam: { x: cam.x, y: cam.y, zoom: cam.zoom }, cameraPos, containerRect: containerRect ? { width: containerRect.width, height: containerRect.height } : null, canvasRect: canvasRect ? { width: canvasRect.width, height: canvasRect.height } : null }));
+    canvas2DLog.debug("Canvas2D draw", { instanceId, viewportSize, baseOffsetX, cam: { x: cam.x, y: cam.y, zoom: cam.zoom }, cameraPos: cameraPos ? JSON.stringify(cameraPos) : void 0, containerRect: containerRect ? { width: containerRect.width, height: containerRect.height } : null, canvasRect: canvasRect ? { width: canvasRect.width, height: canvasRect.height } : null });
     const painter = createWebPainter(ctx, bumpAtlas);
     painter.save();
     painter.translate(viewportSize.width / 2, viewportSize.height / 2);
@@ -13566,6 +13568,7 @@ function Canvas2D({
     }
   );
 }
+var canvas2DLog;
 var init_Canvas2D = __esm({
   "components/game/molecules/Canvas2D.tsx"() {
     "use client";
@@ -13587,6 +13590,7 @@ var init_Canvas2D = __esm({
     init_paintDispatch();
     init_hitTest();
     init_isometric();
+    canvas2DLog = createLogger("almadar:ui:game-canvas");
     Canvas2D.displayName = "Canvas2D";
   }
 });
@@ -13625,7 +13629,7 @@ function Canvas({
   keyMap,
   keyUpMap
 }) {
-  console.error("[debug:Canvas] " + JSON.stringify({ mode, drawablesCount: drawables?.length, projection, camera }));
+  canvasLog.debug("Canvas render", { mode, drawablesCount: drawables?.length, projection, camera: camera ? JSON.stringify(camera) : void 0 });
   const zoom = camera?.zoom;
   if (mode === "3d") {
     const props3d = {
@@ -13678,7 +13682,7 @@ function Canvas({
     }
   );
 }
-var Canvas3DHost;
+var Canvas3DHost, canvasLog;
 var init_Canvas = __esm({
   "components/game/molecules/Canvas.tsx"() {
     "use client";
@@ -13686,6 +13690,7 @@ var init_Canvas = __esm({
     Canvas3DHost = lazy(
       () => import('@almadar/ui/components/molecules/game/three').then((m) => ({ default: m.Canvas3DHost }))
     );
+    canvasLog = createLogger("almadar:ui:game-canvas");
     Canvas.displayName = "Canvas";
   }
 });
@@ -50148,6 +50153,8 @@ var flushLog = createLogger("almadar:ui:slot-flush");
 var stateLog = createLogger("almadar:ui:state-transitions");
 var tickLog = createLogger("almadar:ui:tick-effects");
 setNamespaceLevel("almadar:ui:tick-effects", "WARN");
+var sharedEntityLog = createLogger("almadar:ui:shared-entity");
+setNamespaceLevel("almadar:ui:shared-entity", "WARN");
 var SYNC_TICK_OPERATORS = /* @__PURE__ */ new Set([
   "set",
   "emit",
@@ -50242,7 +50249,7 @@ function createSharedEntityWriter(binding, tick, traitStatesRef, emit) {
 function getBindingConfig(binding) {
   const raw = binding.config;
   const normalized = normalizeCallSiteConfigToValues(raw);
-  console.log("[debug:getBindingConfig]", binding.trait.name, "raw keys=", raw ? Object.keys(raw) : "undefined", "has tiles=", raw ? "tiles" in raw : false);
+  sharedEntityLog.debug("getBindingConfig", { traitName: binding.trait.name, rawKeys: raw ? Object.keys(raw) : void 0, hasTiles: raw ? "tiles" in raw : false });
   return normalized;
 }
 function evalFieldDefault(value) {
@@ -50257,7 +50264,7 @@ function evalFieldDefault(value) {
   }
 }
 function useTraitStateMachine(traitBindings, uiSlots, options) {
-  console.log("[debug:useTraitStateMachine] start, traitBindings count=", traitBindings.length, "names=", traitBindings.map((b) => b.trait.name).join(","));
+  sharedEntityLog.debug("useTraitStateMachine start", { traitBindingsCount: traitBindings.length, traitNames: traitBindings.map((b) => b.trait.name) });
   const eventBus = useEventBus();
   const { entities } = useEntitySchema();
   const traitConfigsByName = options?.traitConfigsByName;
@@ -50276,10 +50283,15 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       if (!group) {
         let defaults;
         for (const field of entityDef.fields) {
-          if (field.default !== void 0) {
+          if (field.default !== void 0 && field.default !== null) {
             const evaluated = evalFieldDefault(field.default);
             if (field.name === "tiles") {
-              console.log(`[debug:seed] ${linkedEntityName}.tiles seed type=`, typeof evaluated, Array.isArray(evaluated) ? "len=" + evaluated?.length : "", "head=", Array.isArray(evaluated) && evaluated.length > 0 ? JSON.stringify(evaluated[0]).slice(0, 80) : "n/a");
+              sharedEntityLog.debug("seed tiles", {
+                linkedEntityName,
+                type: typeof evaluated,
+                length: Array.isArray(evaluated) ? evaluated?.length : void 0,
+                head: Array.isArray(evaluated) && evaluated.length > 0 ? JSON.stringify(evaluated[0]).slice(0, 80) : void 0
+              });
             }
             (defaults ?? (defaults = {}))[field.name] = evaluated;
           }
@@ -50296,7 +50308,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
   for (const group of sharedGroups.values()) {
     if (group.defaults) {
       sharedEntityStore.seed(group.storeKey, group.defaults);
-      console.log("[debug:shared-seed]", group.storeKey, "writers=", group.writerBindings.map((b) => b.trait.name).join(","), "renderers=", group.renderBindings.map((b) => b.trait.name).join(","), "defaults.tiles=", Array.isArray(group.defaults.tiles) ? group.defaults.tiles.length : group.defaults.tiles);
+      sharedEntityLog.debug("shared-seed", {
+        storeKey: group.storeKey,
+        writers: group.writerBindings.map((b) => b.trait.name),
+        renderers: group.renderBindings.map((b) => b.trait.name),
+        tilesLength: Array.isArray(group.defaults.tiles) ? group.defaults.tiles.length : group.defaults.tiles
+      });
     }
   }
   const sharedKeyByTraitNameRef = useRef(/* @__PURE__ */ new Map());
@@ -50307,7 +50324,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       for (const binding of group.renderBindings) map.set(binding.trait.name, group.storeKey);
     }
     sharedKeyByTraitNameRef.current = map;
-    console.log("[debug:shared-map]", Array.from(map.entries()).map(([k, v]) => `${k}->${v}`).join(","));
+    sharedEntityLog.debug("shared-map", { map: Array.from(map.entries()).map(([k, v]) => `${k}->${v}`) });
   }, [sharedGroups]);
   const manager = useMemo(() => {
     const traitDefs = traitBindings.map(toTraitDefinition);
@@ -50497,7 +50514,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const entityId = payload?.entityId;
     const sharedKey = sharedKeyByTraitNameRef.current.get(traitName);
     if (traitName === "Hero" || traitName === "Authority") {
-      console.log(`[debug:executeTransitionEffects] ${traitName} sharedKey=`, sharedKey, "store tiles=", sharedKey ? sharedEntityStore.getSnapshot(sharedKey).tiles?.length : "n/a");
+      sharedEntityLog.debug("executeTransitionEffects sharedKey", { traitName, sharedKey, storeTilesLength: sharedKey ? sharedEntityStore.getSnapshot(sharedKey).tiles?.length : void 0 });
     }
     let liveEntity;
     if (sharedKey !== void 0) {
@@ -50524,10 +50541,15 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         addPattern: (slot, pattern, props) => {
           if (traitName === "Hero" && slot === "main" && props && typeof props === "object") {
             const canvasChild = Array.isArray(props.children) ? props.children[0] : null;
-            const grandChildren = canvasChild && typeof canvasChild === "object" ? canvasChild.children : null;
+            const grandChildren = canvasChild && typeof canvasChild === "object" && !Array.isArray(canvasChild) ? canvasChild.children : null;
             const firstLayer = Array.isArray(grandChildren) && grandChildren.length > 0 ? grandChildren[0] : null;
-            const firstLayerItems = firstLayer && typeof firstLayer === "object" ? firstLayer.items : null;
-            console.log(`[debug:render-ui] ${traitName} slot=${slot} canvasChild=`, canvasChild ? canvasChild.type : "none", "firstLayerItems=", Array.isArray(firstLayerItems) ? firstLayerItems.length : firstLayerItems);
+            const firstLayerItems = firstLayer && typeof firstLayer === "object" && !Array.isArray(firstLayer) ? firstLayer.items : null;
+            sharedEntityLog.debug("render-ui main slot", {
+              traitName,
+              slot,
+              canvasChildType: canvasChild && typeof canvasChild === "object" && !Array.isArray(canvasChild) ? canvasChild.type : "none",
+              firstLayerItemsLength: Array.isArray(firstLayerItems) ? firstLayerItems.length : firstLayerItems
+            });
           }
           const existing = pendingSlots.get(slot) || [];
           existing.push({ pattern, props: props || {} });
@@ -50619,7 +50641,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       };
     }
     if (traitName === "Authority" || traitName === "Hero") {
-      console.log(`[debug:executeTransitionEffects] ${traitName} config tiles type=`, typeof bindingCtx.config?.tiles, Array.isArray(bindingCtx.config?.tiles) ? "len=" + bindingCtx.config?.tiles?.length : "", "keys=", bindingCtx.config ? Object.keys(bindingCtx.config) : "none");
+      sharedEntityLog.debug("executeTransitionEffects config tiles", {
+        traitName,
+        tilesType: typeof bindingCtx.config?.tiles,
+        tilesLength: Array.isArray(bindingCtx.config?.tiles) ? bindingCtx.config?.tiles?.length : void 0,
+        configKeys: bindingCtx.config ? Object.keys(bindingCtx.config) : void 0
+      });
     }
     const effectContext = {
       traitName,
@@ -50638,13 +50665,23 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       }
     };
     if (traitName === "Hero") {
-      console.log(`[debug:executeTransitionEffects] ${traitName} effects count=${effects.length} hasRenderUI=${typeof handlers.renderUI === "function"} effect heads=${effects.map((e) => Array.isArray(e) ? String(e[0]) : "??").join(",")}`);
+      sharedEntityLog.debug("executeTransitionEffects effects summary", {
+        traitName,
+        effectsCount: effects.length,
+        hasRenderUI: typeof handlers.renderUI === "function",
+        effectHeads: effects.map((e) => Array.isArray(e) ? String(e[0]) : "??")
+      });
     }
     const executor = new EffectExecutor({ handlers: trackingHandlers, bindings: bindingCtx, context: effectContext });
     try {
       await executor.executeAll(effects);
       if (traitName === "Authority" || traitName === "Hero") {
-        console.log(`[debug:executeTransitionEffects] ${traitName} after executeAll liveEntity.tiles type=`, typeof liveEntity.tiles, Array.isArray(liveEntity.tiles) ? "len=" + liveEntity.tiles?.length : "", "firstTilePos=", Array.isArray(liveEntity.tiles) && liveEntity.tiles.length > 0 ? JSON.stringify(liveEntity.tiles[0]).slice(0, 120) : "n/a");
+        sharedEntityLog.debug("executeTransitionEffects after executeAll", {
+          traitName,
+          tilesType: typeof liveEntity.tiles,
+          tilesLength: Array.isArray(liveEntity.tiles) ? liveEntity.tiles?.length : void 0,
+          firstTilePos: Array.isArray(liveEntity.tiles) && liveEntity.tiles.length > 0 ? JSON.stringify(liveEntity.tiles[0]).slice(0, 120) : void 0
+        });
       }
       if (sharedKey !== void 0) {
         sharedEntityStore.commit(sharedKey, liveEntity);
@@ -51392,6 +51429,7 @@ function TraitInitializer({ traits: traits2, orbitalNames, onNavigate, onLocalFa
       hadPrev: prevTraitsRef.current !== void 0
     }));
     if (refChanged) {
+      navLog.info("page:traits-reset", { traitsCount: Array.isArray(traits2) ? traits2.length : -1 });
       uiSlots.clearAll();
       initSentRef.current = false;
     }