@almadar/ui 5.101.0 → 5.104.0

package/dist/hooks/index.cjs

@@ -3,6 +3,7 @@
 var react = require('react');
 var logger = require('@almadar/logger');
 var providers = require('@almadar/ui/providers');
+var core = require('@almadar/core');
 var reactQuery = require('@tanstack/react-query');
 
 var log = logger.createLogger("almadar:ui:orbital-history");
@@ -1405,6 +1406,72 @@ function useTraitListens(dispatch, listens, eventBusInstance) {
     };
   }, [eventBus, dispatch, stableListens]);
 }
+var log12 = logger.createLogger("almadar:ui:shared-entity-store");
+var EMPTY_ENTITY_STATE = {};
+function createSharedEntityStore() {
+  const states = /* @__PURE__ */ new Map();
+  const subscribers = /* @__PURE__ */ new Map();
+  const getSnapshot = (entityId) => states.get(entityId) ?? EMPTY_ENTITY_STATE;
+  const subscribe = (entityId, callback) => {
+    let set = subscribers.get(entityId);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      subscribers.set(entityId, set);
+    }
+    set.add(callback);
+    return () => {
+      const current = subscribers.get(entityId);
+      if (!current) return;
+      current.delete(callback);
+      if (current.size === 0) {
+        subscribers.delete(entityId);
+      }
+    };
+  };
+  const commit = (entityId, nextState) => {
+    states.set(entityId, nextState);
+    const set = subscribers.get(entityId);
+    if (!set) return;
+    set.forEach((callback) => {
+      try {
+        callback();
+      } catch (error) {
+        log12.error("Shared entity subscriber error", {
+          entityId,
+          error: error instanceof Error ? error : String(error)
+        });
+      }
+    });
+  };
+  const seed = (entityId, initialState) => {
+    if (!states.has(entityId)) {
+      states.set(entityId, initialState);
+    }
+  };
+  return { getSnapshot, subscribe, commit, seed };
+}
+function useSharedEntityStore() {
+  const storeRef = react.useRef(null);
+  if (storeRef.current === null) {
+    storeRef.current = createSharedEntityStore();
+  }
+  return storeRef.current;
+}
+function useSharedEntitySnapshot(store, entityId) {
+  return react.useSyncExternalStore(
+    (onStoreChange) => store.subscribe(entityId, onStoreChange),
+    () => store.getSnapshot(entityId)
+  );
+}
+function runTickFrame(entityId, orderedWriters, store) {
+  let scratch = store.getSnapshot(entityId);
+  for (const writer of orderedWriters) {
+    const writes = writer(scratch);
+    scratch = core.mergeEntityFrame(scratch, writes);
+  }
+  store.commit(entityId, scratch);
+  return scratch;
+}
 var queryStores = /* @__PURE__ */ new Map();
 function getOrCreateStore(query) {
   if (!queryStores.has(query)) {
@@ -2740,8 +2807,10 @@ function useGitHubBranches(owner, repo, enabled = true) {
 exports.ALMADAR_DND_MIME = ALMADAR_DND_MIME;
 exports.DEFAULT_SLOTS = DEFAULT_SLOTS;
 exports.I18nProvider = I18nProvider;
+exports.createSharedEntityStore = createSharedEntityStore;
 exports.createTranslate = createTranslate;
 exports.parseQueryBinding = parseQueryBinding;
+exports.runTickFrame = runTickFrame;
 exports.useAgentChat = useAgentChat;
 exports.useAuthContext = useAuthContext;
 exports.useCanvasGestures = useCanvasGestures;
@@ -2769,6 +2838,8 @@ exports.usePreview = usePreview;
 exports.usePullToRefresh = usePullToRefresh;
 exports.useQuerySingleton = useQuerySingleton;
 exports.useRenderInterpolation = useRenderInterpolation;
+exports.useSharedEntitySnapshot = useSharedEntitySnapshot;
+exports.useSharedEntityStore = useSharedEntityStore;
 exports.useSwipeGesture = useSwipeGesture;
 exports.useTapReveal = useTapReveal;
 exports.useTraitListens = useTraitListens;

package/dist/hooks/index.d.ts

@@ -16,6 +16,7 @@ export type { BusEvent, BusEventSource, BusEventListener, Unsubscribe, EventBusC
 export type { BusEventListener as EventListener } from '../types/event-bus-types';
 export { useUISlotManager, DEFAULT_SLOTS, type UISlot, type SlotAnimation, type SlotContent, type SlotRenderConfig, type SlotChangeCallback, type UISlotManager, } from './useUISlots';
 export { useUIEvents, useTraitListens, type TraitListenSpec } from './useUIEvents';
+export { createSharedEntityStore, useSharedEntityStore, useSharedEntitySnapshot, runTickFrame, type SharedEntityStore, type SharedEntitySubscriber, type SharedEntityWriter, } from './useSharedEntityStore';
 export { useQuerySingleton, parseQueryBinding, type QueryState, type QuerySingletonEntity, type QuerySingletonResult, type QuerySingletonState, } from './useQuerySingleton';
 export { useTranslate, I18nProvider, createTranslate, type TranslateFunction, type I18nContextValue, } from './useTranslate';
 export { useAuthContext, type AuthUser, type AuthContextValue, } from './useAuthContext';

package/dist/hooks/index.js

@@ -1,6 +1,7 @@
-import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef } from 'react';
+import { createContext, useCallback, useState, useEffect, useMemo, useContext, useRef, useSyncExternalStore } from 'react';
 import { createLogger } from '@almadar/logger';
 import { EventBusContext, useTraitScope } from '@almadar/ui/providers';
+import { mergeEntityFrame } from '@almadar/core';
 import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
 
 var log = createLogger("almadar:ui:orbital-history");
@@ -1403,6 +1404,72 @@ function useTraitListens(dispatch, listens, eventBusInstance) {
     };
   }, [eventBus, dispatch, stableListens]);
 }
+var log12 = createLogger("almadar:ui:shared-entity-store");
+var EMPTY_ENTITY_STATE = {};
+function createSharedEntityStore() {
+  const states = /* @__PURE__ */ new Map();
+  const subscribers = /* @__PURE__ */ new Map();
+  const getSnapshot = (entityId) => states.get(entityId) ?? EMPTY_ENTITY_STATE;
+  const subscribe = (entityId, callback) => {
+    let set = subscribers.get(entityId);
+    if (!set) {
+      set = /* @__PURE__ */ new Set();
+      subscribers.set(entityId, set);
+    }
+    set.add(callback);
+    return () => {
+      const current = subscribers.get(entityId);
+      if (!current) return;
+      current.delete(callback);
+      if (current.size === 0) {
+        subscribers.delete(entityId);
+      }
+    };
+  };
+  const commit = (entityId, nextState) => {
+    states.set(entityId, nextState);
+    const set = subscribers.get(entityId);
+    if (!set) return;
+    set.forEach((callback) => {
+      try {
+        callback();
+      } catch (error) {
+        log12.error("Shared entity subscriber error", {
+          entityId,
+          error: error instanceof Error ? error : String(error)
+        });
+      }
+    });
+  };
+  const seed = (entityId, initialState) => {
+    if (!states.has(entityId)) {
+      states.set(entityId, initialState);
+    }
+  };
+  return { getSnapshot, subscribe, commit, seed };
+}
+function useSharedEntityStore() {
+  const storeRef = useRef(null);
+  if (storeRef.current === null) {
+    storeRef.current = createSharedEntityStore();
+  }
+  return storeRef.current;
+}
+function useSharedEntitySnapshot(store, entityId) {
+  return useSyncExternalStore(
+    (onStoreChange) => store.subscribe(entityId, onStoreChange),
+    () => store.getSnapshot(entityId)
+  );
+}
+function runTickFrame(entityId, orderedWriters, store) {
+  let scratch = store.getSnapshot(entityId);
+  for (const writer of orderedWriters) {
+    const writes = writer(scratch);
+    scratch = mergeEntityFrame(scratch, writes);
+  }
+  store.commit(entityId, scratch);
+  return scratch;
+}
 var queryStores = /* @__PURE__ */ new Map();
 function getOrCreateStore(query) {
   if (!queryStores.has(query)) {
@@ -2735,4 +2802,4 @@ function useGitHubBranches(owner, repo, enabled = true) {
   });
 }
 
-export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, createTranslate, parseQueryBinding, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };
+export { ALMADAR_DND_MIME, DEFAULT_SLOTS, I18nProvider, createSharedEntityStore, createTranslate, parseQueryBinding, runTickFrame, useAgentChat, useAuthContext, useCanvasGestures, useCompile, useConnectGitHub, useDeepAgentGeneration, useDisconnectGitHub, useDragReorder, useDraggable, useDropZone, useEmitEvent, useEventBus, useEventListener, useExtensions, useFileEditor, useFileSystem, useGitHubBranches, useGitHubRepo, useGitHubRepos, useGitHubStatus, useInfiniteScroll, useLongPress, useOrbitalHistory, usePreview, usePullToRefresh, useQuerySingleton, useRenderInterpolation, useSharedEntitySnapshot, useSharedEntityStore, useSwipeGesture, useTapReveal, useTraitListens, useTranslate, useUIEvents, useUISlotManager, useValidation };

package/dist/hooks/useGitHub.d.ts

@@ -25,7 +25,7 @@ export interface GitHubRepo {
 /**
  * Hook to get GitHub connection status
  */
-export declare function useGitHubStatus(): import("@tanstack/react-query").UseQueryResult<GitHubStatus, Error>;
+export declare function useGitHubStatus(): import("@tanstack/react-query").UseQueryResult<NoInfer<GitHubStatus>, Error>;
 /**
  * Hook to connect GitHub (initiate OAuth flow)
  */
@@ -39,20 +39,20 @@ export declare function useDisconnectGitHub(): import("@tanstack/react-query").U
 /**
  * Hook to list GitHub repositories
  */
-export declare function useGitHubRepos(page?: number, perPage?: number): import("@tanstack/react-query").UseQueryResult<{
+export declare function useGitHubRepos(page?: number, perPage?: number): import("@tanstack/react-query").UseQueryResult<NoInfer<{
     repos: GitHubRepo[];
     page: number;
     perPage: number;
-}, Error>;
+}>, Error>;
 /**
  * Hook to get repository details
  */
-export declare function useGitHubRepo(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<{
+export declare function useGitHubRepo(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<NoInfer<{
     repo: GitHubRepo;
-}, Error>;
+}>, Error>;
 /**
  * Hook to list repository branches
  */
-export declare function useGitHubBranches(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<{
+export declare function useGitHubBranches(owner: string, repo: string, enabled?: boolean): import("@tanstack/react-query").UseQueryResult<NoInfer<{
     branches: string[];
-}, Error>;
+}>, Error>;

package/dist/hooks/useSharedEntityStore.d.ts

@@ -0,0 +1,53 @@
+import type { EntityFieldWrite, EntityFrameState } from '@almadar/core';
+/** Notification callback fired after a `commit()` for the subscribed entity id. */
+export type SharedEntitySubscriber = () => void;
+/**
+ * One writer trait's per-frame step: reads the live running scratch
+ * (reflecting every earlier writer's writes this frame) and returns its own
+ * field writes. Pure — writers never call `store.commit`; only `runTickFrame`
+ * does, once per frame.
+ */
+export type SharedEntityWriter = (scratch: EntityFrameState) => readonly EntityFieldWrite[];
+/** Manager surface, keyed by entity id. */
+export interface SharedEntityStore {
+    getSnapshot: (entityId: string) => EntityFrameState;
+    subscribe: (entityId: string, callback: SharedEntitySubscriber) => () => void;
+    commit: (entityId: string, nextState: EntityFrameState) => void;
+    /**
+     * Set the initial state for an entity id, but ONLY if nothing is committed
+     * yet — idempotent, and (unlike `commit`) does NOT notify subscribers, so it
+     * is safe to call during render. Both execution paths seed from the entity's
+     * declared field defaults at init, so frame 0 reads the defaults on both.
+     */
+    seed: (entityId: string, initialState: EntityFrameState) => void;
+}
+/**
+ * Create a standalone shared-entity store. Plain factory — no React — so a
+ * clock owner (the interpreter's TickScheduler, or a codegen rAF
+ * `useEffect`) can hold one instance and pass it to `runTickFrame` without
+ * going through a hook.
+ */
+export declare function createSharedEntityStore(): SharedEntityStore;
+/**
+ * React hook: one stable `SharedEntityStore` instance for this component's
+ * lifetime (useUISlotManager's ref-backed-instance pattern — no re-creation
+ * across re-renders). Callers own one store per running orbital instance and
+ * thread it to each writer trait plus the render trait via `runTickFrame` /
+ * `useSharedEntitySnapshot`.
+ */
+export declare function useSharedEntityStore(): SharedEntityStore;
+/**
+ * Bridge one entity's snapshot into React via `useSyncExternalStore` (the
+ * codebase's established store->React bridge, see `lib/perf.ts`). The render
+ * trait re-renders exactly when `runTickFrame` commits this entity — never on
+ * an intermediate per-writer write, since those never call `store.commit`.
+ */
+export declare function useSharedEntitySnapshot(store: SharedEntityStore, entityId: string): EntityFrameState;
+/**
+ * Run one frame for `entityId`: fold each writer's writes into a running
+ * scratch in binding order via `mergeEntityFrame` (field-level, so writer
+ * k+1 reads writer k's same-frame writes), then commit the merged result
+ * exactly ONCE. Clock-agnostic — the caller (a TickScheduler tick or a
+ * codegen rAF loop) invokes this once per frame; it owns no timer itself.
+ */
+export declare function runTickFrame(entityId: string, orderedWriters: readonly SharedEntityWriter[], store: SharedEntityStore): EntityFrameState;

package/dist/hooks/useTraitStateMachine.d.ts

@@ -16,7 +16,9 @@
  *
  * @packageDocumentation
  */
-import type { EventPayload, ServiceParams } from '@almadar/core';
+import { type MutableRefObject } from 'react';
+import { type SharedEntityWriter } from './index';
+import type { ResolvedTraitTick, EventPayload, SExpr, ServiceParams, ResolvedTrait } from '@almadar/core';
 import { type TraitState } from '@almadar/runtime';
 import type { ResolvedTraitBinding } from '../types/runtime-types';
 import type { useUISlots } from '../providers/UISlotContext';
@@ -31,6 +33,35 @@ export interface TraitStateMachineResult {
     /** Check if a trait can handle an event from its current state */
     canHandleEvent: (traitName: string, eventKey: string) => boolean;
 }
+/** Effect head-operator that writes a field onto a shared entity. */
+export declare const SHARED_ENTITY_WRITE_OPS: ReadonlySet<string>;
+/** Effect head-operators that paint a shared entity's merged state. */
+export declare const SHARED_ENTITY_RENDER_OPS: ReadonlySet<string>;
+/** Every tick + transition effect a trait declares, flattened for a structural scan. */
+export declare function collectAllTraitEffects(trait: ResolvedTrait): SExpr[];
+/**
+ * Does ANY effect in this list call one of `ops` anywhere in its (possibly
+ * `do`/`if`/`when`/`let`-nested) tree? Reuses `@almadar/core`'s canonical
+ * `walkSExpr` rather than a bespoke recursive walk, and looks only at the
+ * effect's head operator — a structural presence check, no name-matching.
+ */
+export declare function effectsCallOp(effects: SExpr[], ops: ReadonlySet<string>): boolean;
+/**
+ * Build one writer trait's tick into a synchronous `SharedEntityWriter`
+ * (`(scratch) => writes[]`) so `runTickFrame` can fold several writer ticks
+ * into one merged commit, in binding order.
+ *
+ * `runTickFrame`'s writer contract is synchronous, but `@almadar/runtime`'s
+ * `EffectExecutor` is inherently async (`executeAll`'s `for...of await`
+ * sequencing only guarantees the FIRST top-level effect lands before a
+ * fire-and-forget caller reads the result back — everything after the first
+ * `await` boundary would be silently dropped). `@almadar/evaluator`'s
+ * `executeEffects` is fully synchronous end-to-end (its `set`/`do`/`if`/
+ * `when`/`let` dispatch never awaits), so it — not `EffectExecutor` — is the
+ * correct tool here; `ctx.mutateEntity` captures each write instead of
+ * applying it through a handler.
+ */
+export declare function createSharedEntityWriter(binding: ResolvedTraitBinding, tick: ResolvedTraitTick, traitStatesRef: MutableRefObject<Map<string, TraitState>>, emit: (event: string, payload?: EventPayload) => void): SharedEntityWriter;
 export interface UseTraitStateMachineOptions {
     /**
      * Callback invoked after each event is processed (for server forwarding).

package/dist/marketing/index.cjs

@@ -26,7 +26,7 @@ function _interopNamespace(e) {
 var React12__namespace = /*#__PURE__*/_interopNamespace(React12);
 var LucideIcons2__namespace = /*#__PURE__*/_interopNamespace(LucideIcons2);
 
-// node_modules/clsx/dist/clsx.mjs
+// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f3, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -41,7 +41,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);

package/dist/marketing/index.js

@@ -5,7 +5,7 @@ import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 import * as LucideIcons2 from 'lucide-react';
 import { Loader2, X } from 'lucide-react';
 
-// node_modules/clsx/dist/clsx.mjs
+// node_modules/.pnpm/clsx@2.1.1/node_modules/clsx/dist/clsx.mjs
 function r(e) {
   var t, f3, n = "";
   if ("string" == typeof e || "number" == typeof e) n += e;
@@ -20,7 +20,7 @@ function clsx() {
   return n;
 }
 
-// node_modules/tailwind-merge/dist/bundle-mjs.mjs
+// node_modules/.pnpm/tailwind-merge@2.6.1/node_modules/tailwind-merge/dist/bundle-mjs.mjs
 var CLASS_PART_SEPARATOR = "-";
 var createClassGroupUtils = (config) => {
   const classMap = createClassMap(config);

package/dist/providers/EventBusProvider.d.ts

@@ -43,5 +43,5 @@ interface EventBusProviderProps {
      */
     isolated?: boolean;
 }
-export declare function EventBusProvider({ children, isolated }: EventBusProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function EventBusProvider({ children, isolated }: EventBusProviderProps): React.JSX.Element;
 export type { EventBusContextType };

package/dist/providers/SelectionProvider.d.ts

@@ -50,7 +50,7 @@ interface SelectionProviderProps {
  * }
  * ```
  */
-export declare function SelectionProvider({ children, debug, compareEntities, }: SelectionProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function SelectionProvider({ children, debug, compareEntities, }: SelectionProviderProps): React.JSX.Element;
 /**
  * Hook to access selection state.
  *

package/dist/providers/ServerBridge.d.ts

@@ -98,5 +98,5 @@ export interface ServerBridgeProviderProps {
     transport?: ServerBridgeTransport;
     children: ReactNode;
 }
-export declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, children, }: ServerBridgeProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function ServerBridgeProvider({ schema, serverUrl, transport: customTransport, children, }: ServerBridgeProviderProps): import("react").JSX.Element;
 export {};

package/dist/providers/index.cjs

@@ -10248,6 +10248,9 @@ var init_useUnitSpriteAtlas = __esm({
     init_spriteAnimation();
   }
 });
+function normalizeBackdrop(bg) {
+  return typeof bg === "string" ? { url: bg, role: "decoration", category: "background" } : bg;
+}
 function SideView({
   player,
   platforms,
@@ -10257,7 +10260,7 @@ function SideView({
   canvasHeight,
   follow,
   bgColor,
-  backgroundImage,
+  backgroundImage: backgroundImageRaw,
   playerSprite,
   tileSprites,
   effects,
@@ -10265,6 +10268,7 @@ function SideView({
   keyUpMap,
   className
 }) {
+  const backgroundImage = normalizeBackdrop(backgroundImageRaw);
   const canvasRef = React98.useRef(null);
   const eventBus = useEventBus();
   const keysRef = React98.useRef(/* @__PURE__ */ new Set());
@@ -10556,7 +10560,7 @@ function Canvas2D({
   effects: _effectsPropRaw = [],
   platforms,
   player,
-  backgroundImage,
+  backgroundImage: backgroundImageRaw,
   // Interaction state
   selectedUnitId = null,
   validMoves = [],
@@ -10597,6 +10601,7 @@ function Canvas2D({
   // Remote asset loading
   assetManifest
 }) {
+  const backgroundImage = normalizeBackdrop(backgroundImageRaw);
   const isSide = projection === "side";
   const isFree = projection === "free";
   const flatLike = projection === "hex" || projection === "flat" || isFree;
@@ -17790,9 +17795,9 @@ var init_BiologyCanvas = __esm({
   }
 });
 
-// node_modules/katex/dist/katex.min.css
+// node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css
 var init_katex_min = __esm({
-  "node_modules/katex/dist/katex.min.css"() {
+  "node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css"() {
   }
 });
 var Tabs;
@@ -29998,8 +30003,9 @@ var init_LineChart = __esm({
       const safeData = data ?? [];
       const sortedData = React98.useMemo(() => {
         if (safeData.length === 0) return [];
+        if (!safeData.some((d) => d.date != null)) return [...safeData];
         return [...safeData].sort(
-          (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()
+          (a, b) => new Date(a.date ?? 0).getTime() - new Date(b.date ?? 0).getTime()
         );
       }, [safeData]);
       const points = React98.useMemo(() => {

package/dist/providers/index.css

@@ -1,4 +1,4 @@
-/* node_modules/katex/dist/katex.min.css */
+/* node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css */
 @font-face {
   font-display: block;
   font-family: KaTeX_AMS;
@@ -214,11 +214,11 @@
   border-color: currentColor;
 }
 .katex .katex-version:after {
-  content: "0.16.45";
+  content: "0.16.47";
 }
 .katex .katex-mathml {
-  clip: rect(1px, 1px, 1px, 1px);
   border: 0;
+  clip-path: inset(50%);
   height: 1px;
   overflow: hidden;
   padding: 0;

package/dist/providers/index.js

@@ -10203,6 +10203,9 @@ var init_useUnitSpriteAtlas = __esm({
     init_spriteAnimation();
   }
 });
+function normalizeBackdrop(bg) {
+  return typeof bg === "string" ? { url: bg, role: "decoration", category: "background" } : bg;
+}
 function SideView({
   player,
   platforms,
@@ -10212,7 +10215,7 @@ function SideView({
   canvasHeight,
   follow,
   bgColor,
-  backgroundImage,
+  backgroundImage: backgroundImageRaw,
   playerSprite,
   tileSprites,
   effects,
@@ -10220,6 +10223,7 @@ function SideView({
   keyUpMap,
   className
 }) {
+  const backgroundImage = normalizeBackdrop(backgroundImageRaw);
   const canvasRef = useRef(null);
   const eventBus = useEventBus();
   const keysRef = useRef(/* @__PURE__ */ new Set());
@@ -10511,7 +10515,7 @@ function Canvas2D({
   effects: _effectsPropRaw = [],
   platforms,
   player,
-  backgroundImage,
+  backgroundImage: backgroundImageRaw,
   // Interaction state
   selectedUnitId = null,
   validMoves = [],
@@ -10552,6 +10556,7 @@ function Canvas2D({
   // Remote asset loading
   assetManifest
 }) {
+  const backgroundImage = normalizeBackdrop(backgroundImageRaw);
   const isSide = projection === "side";
   const isFree = projection === "free";
   const flatLike = projection === "hex" || projection === "flat" || isFree;
@@ -17745,9 +17750,9 @@ var init_BiologyCanvas = __esm({
   }
 });
 
-// node_modules/katex/dist/katex.min.css
+// node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css
 var init_katex_min = __esm({
-  "node_modules/katex/dist/katex.min.css"() {
+  "node_modules/.pnpm/katex@0.16.47/node_modules/katex/dist/katex.min.css"() {
   }
 });
 var Tabs;
@@ -29953,8 +29958,9 @@ var init_LineChart = __esm({
       const safeData = data ?? [];
       const sortedData = useMemo(() => {
         if (safeData.length === 0) return [];
+        if (!safeData.some((d) => d.date != null)) return [...safeData];
         return [...safeData].sort(
-          (a, b) => new Date(a.date).getTime() - new Date(b.date).getTime()
+          (a, b) => new Date(a.date ?? 0).getTime() - new Date(b.date ?? 0).getTime()
         );
       }, [safeData]);
       const points = useMemo(() => {