@almadar/ui 5.51.0 → 5.53.0

package/dist/avl/index.cjs

@@ -31382,6 +31382,7 @@ function PlatformerCanvas({
   const canvasRef = React90.useRef(null);
   const eventBus = useEventBus();
   const keysRef = React90.useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = React90.useRef(-1);
   const imageCache = React90.useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = React90.useState(/* @__PURE__ */ new Set());
   const loadImage = React90.useCallback((url) => {
@@ -31537,6 +31538,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -31662,13 +31675,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = logger.createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -46605,14 +46619,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = React90.useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -46691,6 +46711,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -46701,6 +46722,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = logger.createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });
@@ -57351,7 +57373,7 @@ function convertFnFormLambdasInProps(props) {
 }
 var log10 = logger.createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify, callService } = options;
+  const { eventBus, slotSetter, navigate, notify, callService, liveEntity } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -57360,8 +57382,12 @@ function createClientEffectHandlers(options) {
     persist: async () => {
       log10.warn("persist is server-side only, ignored on client");
     },
-    set: () => {
-      log10.warn("set is server-side only, ignored on client");
+    set: (_entityId, field, value) => {
+      if (!liveEntity) {
+        log10.warn("set is server-side only, ignored on client (no live entity)");
+        return;
+      }
+      liveEntity[field] = value;
     },
     callService: async (service, action, params) => {
       if (callService) return callService(service, action, params);
@@ -57629,6 +57655,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const traitName = binding.trait.name;
     const linkedEntity = binding.linkedEntity || "";
     const entityId = payload?.entityId;
+    let liveEntity = traitFieldStatesRef.current.get(traitName);
+    if (!liveEntity) {
+      liveEntity = {};
+      traitFieldStatesRef.current.set(traitName, liveEntity);
+    }
     const effects = syncOnly ? params.effects.filter(
       (e) => Array.isArray(e) && SYNC_TICK_OPERATORS.has(String(e[0]))
     ) : params.effects;
@@ -57651,7 +57682,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       },
       navigate: optionsRef.current?.navigate,
       notify: optionsRef.current?.notify,
-      callService: optionsRef.current?.callService
+      callService: optionsRef.current?.callService,
+      // The canonical client `set` writes `(set @entity.X)` straight into
+      // the trait's one live store — the same object bound below. This is
+      // what makes a [runtime] entity's set (from ticks AND events) reach
+      // the render-ui + next tick + guards.
+      liveEntity
     });
     const persistence = syncOnly ? void 0 : optionsRef.current?.persistence;
     let handlers = clientHandlers;
@@ -57662,7 +57698,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         // uses below. `@payload.*` resolves from `payload` separately,
         // so dropping the prior `payload as EntityRow` cast loses
         // nothing — it just stops mislabelling the payload as an entity.
-        entity: traitFieldStatesRef.current.get(traitName) ?? {},
+        entity: liveEntity,
         payload: payload || {},
         state: previousState
       };
@@ -57702,24 +57738,17 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     handlers = {
       ...handlers,
       set: async (targetId, field, value) => {
-        let fieldState = traitFieldStatesRef.current.get(traitName);
-        if (!fieldState) {
-          fieldState = {};
-          traitFieldStatesRef.current.set(traitName, fieldState);
-        }
-        fieldState[field] = value;
+        if (baseSet) await baseSet(targetId, field, value);
         log15.debug("set:write", {
           traitName,
           field,
           value: JSON.stringify(value),
           transition: `${previousState}->${newState}`
         });
-        if (baseSet) await baseSet(targetId, field, value);
       }
     };
-    const entityForBinding = traitFieldStatesRef.current.get(traitName) ?? {};
     const bindingCtx = {
-      entity: entityForBinding,
+      entity: liveEntity,
       payload: payload || {},
       state: previousState
     };

package/dist/avl/index.js

@@ -31335,6 +31335,7 @@ function PlatformerCanvas({
   const canvasRef = useRef(null);
   const eventBus = useEventBus();
   const keysRef = useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = useRef(-1);
   const imageCache = useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = useState(/* @__PURE__ */ new Set());
   const loadImage = useCallback((url) => {
@@ -31490,6 +31491,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -31615,13 +31628,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -46558,14 +46572,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -46644,6 +46664,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -46654,6 +46675,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });
@@ -57304,7 +57326,7 @@ function convertFnFormLambdasInProps(props) {
 }
 var log10 = createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify, callService } = options;
+  const { eventBus, slotSetter, navigate, notify, callService, liveEntity } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -57313,8 +57335,12 @@ function createClientEffectHandlers(options) {
     persist: async () => {
       log10.warn("persist is server-side only, ignored on client");
     },
-    set: () => {
-      log10.warn("set is server-side only, ignored on client");
+    set: (_entityId, field, value) => {
+      if (!liveEntity) {
+        log10.warn("set is server-side only, ignored on client (no live entity)");
+        return;
+      }
+      liveEntity[field] = value;
     },
     callService: async (service, action, params) => {
       if (callService) return callService(service, action, params);
@@ -57582,6 +57608,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const traitName = binding.trait.name;
     const linkedEntity = binding.linkedEntity || "";
     const entityId = payload?.entityId;
+    let liveEntity = traitFieldStatesRef.current.get(traitName);
+    if (!liveEntity) {
+      liveEntity = {};
+      traitFieldStatesRef.current.set(traitName, liveEntity);
+    }
     const effects = syncOnly ? params.effects.filter(
       (e) => Array.isArray(e) && SYNC_TICK_OPERATORS.has(String(e[0]))
     ) : params.effects;
@@ -57604,7 +57635,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       },
       navigate: optionsRef.current?.navigate,
       notify: optionsRef.current?.notify,
-      callService: optionsRef.current?.callService
+      callService: optionsRef.current?.callService,
+      // The canonical client `set` writes `(set @entity.X)` straight into
+      // the trait's one live store — the same object bound below. This is
+      // what makes a [runtime] entity's set (from ticks AND events) reach
+      // the render-ui + next tick + guards.
+      liveEntity
     });
     const persistence = syncOnly ? void 0 : optionsRef.current?.persistence;
     let handlers = clientHandlers;
@@ -57615,7 +57651,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         // uses below. `@payload.*` resolves from `payload` separately,
         // so dropping the prior `payload as EntityRow` cast loses
         // nothing — it just stops mislabelling the payload as an entity.
-        entity: traitFieldStatesRef.current.get(traitName) ?? {},
+        entity: liveEntity,
         payload: payload || {},
         state: previousState
       };
@@ -57655,24 +57691,17 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     handlers = {
       ...handlers,
       set: async (targetId, field, value) => {
-        let fieldState = traitFieldStatesRef.current.get(traitName);
-        if (!fieldState) {
-          fieldState = {};
-          traitFieldStatesRef.current.set(traitName, fieldState);
-        }
-        fieldState[field] = value;
+        if (baseSet) await baseSet(targetId, field, value);
         log15.debug("set:write", {
           traitName,
           field,
           value: JSON.stringify(value),
           transition: `${previousState}->${newState}`
         });
-        if (baseSet) await baseSet(targetId, field, value);
       }
     };
-    const entityForBinding = traitFieldStatesRef.current.get(traitName) ?? {};
     const bindingCtx = {
-      entity: entityForBinding,
+      entity: liveEntity,
       payload: payload || {},
       state: previousState
     };

package/dist/components/index.cjs

@@ -29178,6 +29178,7 @@ function PlatformerCanvas({
   const canvasRef = React76.useRef(null);
   const eventBus = useEventBus();
   const keysRef = React76.useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = React76.useRef(-1);
   const imageCache = React76.useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = React76.useState(/* @__PURE__ */ new Set());
   const loadImage = React76.useCallback((url) => {
@@ -29333,6 +29334,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -29458,13 +29471,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = logger.createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -45267,14 +45281,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = React76.useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -45353,6 +45373,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -45363,6 +45384,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = logger.createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });

package/dist/components/index.js

@@ -29132,6 +29132,7 @@ function PlatformerCanvas({
   const canvasRef = useRef(null);
   const eventBus = useEventBus();
   const keysRef = useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = useRef(-1);
   const imageCache = useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = useState(/* @__PURE__ */ new Set());
   const loadImage = useCallback((url) => {
@@ -29287,6 +29288,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -29412,13 +29425,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -45221,14 +45235,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -45307,6 +45327,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -45317,6 +45338,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });

package/dist/providers/index.cjs

@@ -28774,6 +28774,7 @@ function PlatformerCanvas({
   const canvasRef = React82.useRef(null);
   const eventBus = useEventBus();
   const keysRef = React82.useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = React82.useRef(-1);
   const imageCache = React82.useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = React82.useState(/* @__PURE__ */ new Set());
   const loadImage = React82.useCallback((url) => {
@@ -28929,6 +28930,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -29054,13 +29067,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = logger.createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -44406,14 +44420,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = React82.useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -44492,6 +44512,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -44502,6 +44523,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = logger.createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });

package/dist/providers/index.js

@@ -28727,6 +28727,7 @@ function PlatformerCanvas({
   const canvasRef = useRef(null);
   const eventBus = useEventBus();
   const keysRef = useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = useRef(-1);
   const imageCache = useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = useState(/* @__PURE__ */ new Set());
   const loadImage = useCallback((url) => {
@@ -28882,6 +28883,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -29007,13 +29020,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -44359,14 +44373,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -44445,6 +44465,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -44455,6 +44476,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });

package/dist/runtime/createClientEffectHandlers.d.ts

@@ -5,7 +5,7 @@
  *
  * @packageDocumentation
  */
-import type { EventPayload, ServiceParams } from '@almadar/core';
+import type { EventPayload, EntityRow, ServiceParams } from '@almadar/core';
 import type { EffectHandlers } from '@almadar/runtime';
 export interface ClientEventBus {
     emit: (type: string, payload?: EventPayload) => void;
@@ -19,6 +19,17 @@ export interface CreateClientEffectHandlersOptions {
     slotSetter: SlotSetter;
     navigate?: (path: string, params?: Record<string, unknown>) => void;
     notify?: (message: string, type: 'success' | 'error' | 'warning' | 'info') => void;
+    /**
+     * Live client-entity write target for `[runtime]` entities. `(set
+     * @entity.<field> value)` runs entirely in the browser for in-memory
+     * entities (game boards, wizards): there is no server row to persist to,
+     * so the canonical client `set` must mutate THIS object — the same object
+     * `EffectExecutor` reads `@entity.*` from for the current `executeAll` and
+     * the next tick seeds from. When omitted, `set` is a no-op (bridge mode:
+     * the server owns persistence). One store, read live by render-ui, guards,
+     * and ticks — no guard-vs-render split.
+     */
+    liveEntity?: EntityRow;
     /**
      * Optional consumer-supplied call-service handler. When set, it runs
      * instead of the default mock fallback — use to wire the playground

package/dist/runtime/index.cjs

@@ -28472,6 +28472,7 @@ function PlatformerCanvas({
   const canvasRef = React81.useRef(null);
   const eventBus = useEventBus();
   const keysRef = React81.useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = React81.useRef(-1);
   const imageCache = React81.useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = React81.useState(/* @__PURE__ */ new Set());
   const loadImage = React81.useCallback((url) => {
@@ -28627,6 +28628,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -28752,13 +28765,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = logger.createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -44104,14 +44118,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = React81.useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -44190,6 +44210,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -44200,6 +44221,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = logger.createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });
@@ -51279,7 +51301,7 @@ var init_UISlotRenderer = __esm({
 });
 var log = logger.createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify, callService } = options;
+  const { eventBus, slotSetter, navigate, notify, callService, liveEntity } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -51288,8 +51310,12 @@ function createClientEffectHandlers(options) {
     persist: async () => {
       log.warn("persist is server-side only, ignored on client");
     },
-    set: () => {
-      log.warn("set is server-side only, ignored on client");
+    set: (_entityId, field, value) => {
+      if (!liveEntity) {
+        log.warn("set is server-side only, ignored on client (no live entity)");
+        return;
+      }
+      liveEntity[field] = value;
     },
     callService: async (service, action, params) => {
       if (callService) return callService(service, action, params);
@@ -51683,6 +51709,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const traitName = binding.trait.name;
     const linkedEntity = binding.linkedEntity || "";
     const entityId = payload?.entityId;
+    let liveEntity = traitFieldStatesRef.current.get(traitName);
+    if (!liveEntity) {
+      liveEntity = {};
+      traitFieldStatesRef.current.set(traitName, liveEntity);
+    }
     const effects = syncOnly ? params.effects.filter(
       (e) => Array.isArray(e) && SYNC_TICK_OPERATORS.has(String(e[0]))
     ) : params.effects;
@@ -51705,7 +51736,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       },
       navigate: optionsRef.current?.navigate,
       notify: optionsRef.current?.notify,
-      callService: optionsRef.current?.callService
+      callService: optionsRef.current?.callService,
+      // The canonical client `set` writes `(set @entity.X)` straight into
+      // the trait's one live store — the same object bound below. This is
+      // what makes a [runtime] entity's set (from ticks AND events) reach
+      // the render-ui + next tick + guards.
+      liveEntity
     });
     const persistence = syncOnly ? void 0 : optionsRef.current?.persistence;
     let handlers = clientHandlers;
@@ -51716,7 +51752,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         // uses below. `@payload.*` resolves from `payload` separately,
         // so dropping the prior `payload as EntityRow` cast loses
         // nothing — it just stops mislabelling the payload as an entity.
-        entity: traitFieldStatesRef.current.get(traitName) ?? {},
+        entity: liveEntity,
         payload: payload || {},
         state: previousState
       };
@@ -51756,24 +51792,17 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     handlers = {
       ...handlers,
       set: async (targetId, field, value) => {
-        let fieldState = traitFieldStatesRef.current.get(traitName);
-        if (!fieldState) {
-          fieldState = {};
-          traitFieldStatesRef.current.set(traitName, fieldState);
-        }
-        fieldState[field] = value;
+        if (baseSet) await baseSet(targetId, field, value);
         log14.debug("set:write", {
           traitName,
           field,
           value: JSON.stringify(value),
           transition: `${previousState}->${newState}`
         });
-        if (baseSet) await baseSet(targetId, field, value);
       }
     };
-    const entityForBinding = traitFieldStatesRef.current.get(traitName) ?? {};
     const bindingCtx = {
-      entity: entityForBinding,
+      entity: liveEntity,
       payload: payload || {},
       state: previousState
     };

package/dist/runtime/index.js

@@ -28425,6 +28425,7 @@ function PlatformerCanvas({
   const canvasRef = useRef(null);
   const eventBus = useEventBus();
   const keysRef = useRef(/* @__PURE__ */ new Set());
+  const lastPlatCountRef = useRef(-1);
   const imageCache = useRef(/* @__PURE__ */ new Map());
   const [loadedImages, setLoadedImages] = useState(/* @__PURE__ */ new Set());
   const loadImage = useCallback((url) => {
@@ -28580,6 +28581,18 @@ function PlatformerCanvas({
         camX = Math.max(0, Math.min(px - cw / 2, ww - cw));
         camY = Math.max(0, Math.min(py - ch / 2 - 50, wh - ch));
       }
+      if (plats.length !== lastPlatCountRef.current) {
+        lastPlatCountRef.current = plats.length;
+        canvasLog.debug("draw:platforms", {
+          platformCount: plats.length,
+          camX,
+          camY,
+          player: { x: px, y: py },
+          worldWidth: ww,
+          canvasWidth: cw,
+          followCamera: fc
+        });
+      }
       const bgImage = bgImg ? loadImage(bgImg) : null;
       if (bgImage) {
         ctx.drawImage(bgImage, 0, 0, cw, ch);
@@ -28705,13 +28718,14 @@ function PlatformerCanvas({
     }
   );
 }
-var PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
+var canvasLog, PLATFORM_COLORS, PLAYER_COLOR, PLAYER_EYE_COLOR, SKY_GRADIENT_TOP, SKY_GRADIENT_BOTTOM, GRID_COLOR;
 var init_PlatformerCanvas = __esm({
   "components/game/molecules/PlatformerCanvas.tsx"() {
     init_cn();
     init_useEventBus();
     init_verificationRegistry();
     init_useRenderInterpolation();
+    canvasLog = createLogger("almadar:ui:game:platformer-canvas");
     PLATFORM_COLORS = {
       ground: "#4a7c59",
       platform: "#7c6b4a",
@@ -44057,14 +44071,20 @@ function PlatformerBoard({
     grounded: false,
     facingRight: true
   };
-  const entityPlatforms = Array.isArray(row["platforms"]) ? row["platforms"] : void 0;
-  const platforms = propPlatforms ?? entityPlatforms ?? [
+  const platforms = propPlatforms ?? [
     { x: 0, y: 368, width: 800, height: 32, type: "ground" },
     { x: 150, y: 280, width: 160, height: 16, type: "platform" },
     { x: 420, y: 220, width: 160, height: 16, type: "platform" },
     { x: 580, y: 300, width: 80, height: 16, type: "hazard" },
     { x: 700, y: 340, width: 64, height: 28, type: "goal" }
   ];
+  boardLog.debug("platforms-resolve", {
+    propPlatformsCount: Array.isArray(propPlatforms) ? propPlatforms.length : null,
+    usedFallback: propPlatforms === void 0,
+    finalCount: platforms.length,
+    player: { x: player.x, y: player.y, vx: player.vx, vy: player.vy, grounded: player.grounded },
+    result
+  });
   const handleRestart = useCallback(() => {
     if (playAgainEvent) {
       eventBus.emit(`UI:${playAgainEvent}`, {});
@@ -44143,6 +44163,7 @@ function PlatformerBoard({
     }
   );
 }
+var boardLog;
 var init_PlatformerBoard = __esm({
   "components/game/organisms/PlatformerBoard.tsx"() {
     "use client";
@@ -44153,6 +44174,7 @@ var init_PlatformerBoard = __esm({
     init_Typography();
     init_Stack();
     init_PlatformerCanvas();
+    boardLog = createLogger("almadar:ui:game:platformer-board");
     PlatformerBoard.displayName = "PlatformerBoard";
   }
 });
@@ -51232,7 +51254,7 @@ var init_UISlotRenderer = __esm({
 });
 var log = createLogger("almadar:ui:effects:client-handlers");
 function createClientEffectHandlers(options) {
-  const { eventBus, slotSetter, navigate, notify, callService } = options;
+  const { eventBus, slotSetter, navigate, notify, callService, liveEntity } = options;
   return {
     emit: (event, payload) => {
       const prefixedEvent = event.startsWith("UI:") ? event : `UI:${event}`;
@@ -51241,8 +51263,12 @@ function createClientEffectHandlers(options) {
     persist: async () => {
       log.warn("persist is server-side only, ignored on client");
     },
-    set: () => {
-      log.warn("set is server-side only, ignored on client");
+    set: (_entityId, field, value) => {
+      if (!liveEntity) {
+        log.warn("set is server-side only, ignored on client (no live entity)");
+        return;
+      }
+      liveEntity[field] = value;
     },
     callService: async (service, action, params) => {
       if (callService) return callService(service, action, params);
@@ -51636,6 +51662,11 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     const traitName = binding.trait.name;
     const linkedEntity = binding.linkedEntity || "";
     const entityId = payload?.entityId;
+    let liveEntity = traitFieldStatesRef.current.get(traitName);
+    if (!liveEntity) {
+      liveEntity = {};
+      traitFieldStatesRef.current.set(traitName, liveEntity);
+    }
     const effects = syncOnly ? params.effects.filter(
       (e) => Array.isArray(e) && SYNC_TICK_OPERATORS.has(String(e[0]))
     ) : params.effects;
@@ -51658,7 +51689,12 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
       },
       navigate: optionsRef.current?.navigate,
       notify: optionsRef.current?.notify,
-      callService: optionsRef.current?.callService
+      callService: optionsRef.current?.callService,
+      // The canonical client `set` writes `(set @entity.X)` straight into
+      // the trait's one live store — the same object bound below. This is
+      // what makes a [runtime] entity's set (from ticks AND events) reach
+      // the render-ui + next tick + guards.
+      liveEntity
     });
     const persistence = syncOnly ? void 0 : optionsRef.current?.persistence;
     let handlers = clientHandlers;
@@ -51669,7 +51705,7 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
         // uses below. `@payload.*` resolves from `payload` separately,
         // so dropping the prior `payload as EntityRow` cast loses
         // nothing — it just stops mislabelling the payload as an entity.
-        entity: traitFieldStatesRef.current.get(traitName) ?? {},
+        entity: liveEntity,
         payload: payload || {},
         state: previousState
       };
@@ -51709,24 +51745,17 @@ function useTraitStateMachine(traitBindings, uiSlots, options) {
     handlers = {
       ...handlers,
       set: async (targetId, field, value) => {
-        let fieldState = traitFieldStatesRef.current.get(traitName);
-        if (!fieldState) {
-          fieldState = {};
-          traitFieldStatesRef.current.set(traitName, fieldState);
-        }
-        fieldState[field] = value;
+        if (baseSet) await baseSet(targetId, field, value);
         log14.debug("set:write", {
           traitName,
           field,
           value: JSON.stringify(value),
           transition: `${previousState}->${newState}`
         });
-        if (baseSet) await baseSet(targetId, field, value);
       }
     };
-    const entityForBinding = traitFieldStatesRef.current.get(traitName) ?? {};
     const bindingCtx = {
-      entity: entityForBinding,
+      entity: liveEntity,
       payload: payload || {},
       state: previousState
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.51.0",
+  "version": "5.53.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [