@almadar/ui 5.68.0 → 5.70.0

package/dist/components/game/organisms/SpaceShmupBoard.d.ts

@@ -1,19 +1,36 @@
 import React from 'react';
-import type { AssetUrl } from '@almadar/core';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from './types/isometric';
 import type { DisplayStateProps } from '../../core/organisms/types';
+import type { IsometricCanvasProps } from '../molecules/IsometricCanvas';
 export interface SpaceShmupBoardProps extends DisplayStateProps {
-    /** Background image URL (starfield / space scene) */
-    backgroundImage?: AssetUrl;
-    /** Base URL prefix for asset URLs */
+    /** Space terrain tiles filling the grid */
+    tiles?: IsometricTile[];
+    /** Player ship and enemy ships on the board */
+    units?: IsometricUnit[];
+    /** Features (asteroids, power-ups, etc.) on the board */
+    features?: IsometricFeature[];
+    /** Asset sprite manifest (same shape as IsometricCanvas.assetManifest) */
+    assetManifest?: IsometricCanvasProps['assetManifest'];
+    /** Base URL prepended to manifest sprite paths */
     assetBaseUrl?: AssetUrl;
-    /** Canvas width in pixels */
-    width?: number;
-    /** Canvas height in pixels */
-    height?: number;
-    /** Target frames per second */
-    fps?: number;
+    /** Render scale */
+    scale?: number;
+    /** Show minimap overlay */
+    showMinimap?: boolean;
+    /** Enable camera pan/zoom controls */
+    enableCamera?: boolean;
+    /** Declarative event: emits UI:{tileClickEvent} with { x, y } on tile click */
+    tileClickEvent?: EventEmit<{
+        x: number;
+        y: number;
+    }>;
+    /** Declarative event: emits UI:{unitClickEvent} with { unitId } on unit click */
+    unitClickEvent?: EventEmit<{
+        unitId: string;
+    }>;
 }
-export declare function SpaceShmupBoard({ backgroundImage, assetBaseUrl, width, height, fps, isLoading, error, className, }: SpaceShmupBoardProps): React.ReactElement;
+export declare function SpaceShmupBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: SpaceShmupBoardProps): React.ReactElement;
 export declare namespace SpaceShmupBoard {
     var displayName: string;
 }

package/dist/components/index.cjs

@@ -10419,7 +10419,13 @@ function IsometricCanvas({
       const img = unitSpriteUrl ? getImage(unitSpriteUrl) : null;
       const unitDrawH = scaledFloorHeight * spriteHeightRatio * unitScale;
       const maxUnitW = scaledTileWidth * spriteMaxWidthRatio * unitScale;
-      const ar = img ? img.naturalWidth / img.naturalHeight : 0.5;
+      const SHEET_ROWS = 5;
+      const sheetFrameW = img ? img.naturalWidth / exports.SHEET_COLUMNS : 0;
+      const sheetFrameH = img ? img.naturalHeight / SHEET_ROWS : 0;
+      const imgIsSheet = img ? img.naturalWidth % exports.SHEET_COLUMNS === 0 && img.naturalHeight % SHEET_ROWS === 0 && Math.abs(sheetFrameW - sheetFrameH) < 2 : false;
+      const frameW = imgIsSheet ? sheetFrameW : img?.naturalWidth ?? 1;
+      const frameH = imgIsSheet ? sheetFrameH : img?.naturalHeight ?? 1;
+      const ar = frameW / (frameH || 1);
       let drawH = unitDrawH;
       let drawW = unitDrawH * ar;
       if (drawW > maxUnitW) {
@@ -10433,7 +10439,11 @@ function IsometricCanvas({
         ctx.save();
         ctx.globalAlpha = 0.25;
         if (img) {
-          ctx.drawImage(img, ghostCenterX - drawW / 2, ghostGroundY - drawH, drawW, drawH);
+          if (imgIsSheet) {
+            ctx.drawImage(img, 0, 0, sheetFrameW, sheetFrameH, ghostCenterX - drawW / 2, ghostGroundY - drawH, drawW, drawH);
+          } else {
+            ctx.drawImage(img, ghostCenterX - drawW / 2, ghostGroundY - drawH, drawW, drawH);
+          }
         } else {
           const color = unit.team === "player" ? "#3b82f6" : unit.team === "enemy" ? "#ef4444" : "#6b7280";
           ctx.beginPath();
@@ -10477,14 +10487,21 @@ function IsometricCanvas({
         ctx.restore();
       } else if (img) {
         const spriteY = groundY - drawH - breatheOffset;
+        const drawUnit = (x) => {
+          if (imgIsSheet) {
+            ctx.drawImage(img, 0, 0, sheetFrameW, sheetFrameH, x, spriteY, drawW, drawH);
+          } else {
+            ctx.drawImage(img, x, spriteY, drawW, drawH);
+          }
+        };
         if (unit.team) {
           ctx.save();
           ctx.shadowColor = unit.team === "player" ? "rgba(0, 150, 255, 0.6)" : "rgba(255, 50, 50, 0.6)";
           ctx.shadowBlur = 12 * scale;
-          ctx.drawImage(img, centerX - drawW / 2, spriteY, drawW, drawH);
+          drawUnit(centerX - drawW / 2);
           ctx.restore();
         } else {
-          ctx.drawImage(img, centerX - drawW / 2, spriteY, drawW, drawH);
+          drawUnit(centerX - drawW / 2);
         }
       } else {
         const color = unit.team === "player" ? "#3b82f6" : unit.team === "enemy" ? "#ef4444" : "#6b7280";
@@ -10777,6 +10794,7 @@ var init_IsometricCanvas = __esm({
     init_useUnitSpriteAtlas();
     init_verificationRegistry();
     init_isometric();
+    init_spriteSheetConstants();
     IsometricCanvas.displayName = "IsometricCanvas";
     IsometricCanvas_default = IsometricCanvas;
   }
@@ -45772,35 +45790,44 @@ var init_HexStrategyBoard = __esm({
   }
 });
 function HolidayRunnerBoard({
-  backgroundImage,
+  tiles,
+  units,
+  features,
+  assetManifest,
   assetBaseUrl,
-  width = 800,
-  height = 400,
-  fps = 60,
+  scale = 0.45,
+  showMinimap = false,
+  enableCamera = true,
+  tileClickEvent,
+  unitClickEvent,
   isLoading,
   error,
   className
 }) {
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cn("holiday-runner-board relative w-full h-full", className), children: [
-    isLoading && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-black/40 z-10", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-white text-sm", children: "Loading\u2026" }) }),
-    error && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-black/60 z-10", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-red-400 text-sm", children: error.message }) }),
-    /* @__PURE__ */ jsxRuntime.jsx(
-      GameCanvas2D,
-      {
-        width,
-        height,
-        fps,
-        backgroundImage: backgroundImage ?? "",
-        assetBaseUrl
-      }
-    )
-  ] });
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("holiday-runner-board relative w-full h-full", className), children: /* @__PURE__ */ jsxRuntime.jsx(
+    IsometricCanvas_default,
+    {
+      tileLayout: "flat",
+      tiles,
+      units,
+      features,
+      assetManifest,
+      assetBaseUrl,
+      scale,
+      showMinimap,
+      enableCamera,
+      tileClickEvent,
+      unitClickEvent,
+      isLoading,
+      error
+    }
+  ) });
 }
 var init_HolidayRunnerBoard = __esm({
   "components/game/organisms/HolidayRunnerBoard.tsx"() {
     "use client";
     init_cn();
-    init_GameCanvas2D();
+    init_IsometricCanvas();
     HolidayRunnerBoard.displayName = "HolidayRunnerBoard";
   }
 });
@@ -47626,25 +47653,36 @@ var init_PricingPageTemplate = __esm({
   }
 });
 function RacingBoard({
-  backgroundImage,
+  tiles,
+  units,
+  features,
+  assetManifest,
   assetBaseUrl,
-  width = 800,
-  height = 600,
-  fps = 60,
-  tickEvent,
-  drawEvent,
+  scale = 0.45,
+  showMinimap = true,
+  enableCamera = true,
+  tileClickEvent,
+  unitClickEvent,
+  isLoading,
+  error,
   className
 }) {
   return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("racing-board relative w-full h-full", className), children: /* @__PURE__ */ jsxRuntime.jsx(
-    GameCanvas2D,
+    IsometricCanvas_default,
     {
-      backgroundImage,
+      tileLayout: "flat",
+      tiles,
+      units,
+      features,
+      assetManifest,
       assetBaseUrl,
-      width,
-      height,
-      fps,
-      tickEvent: typeof tickEvent === "string" ? tickEvent : void 0,
-      drawEvent: typeof drawEvent === "string" ? drawEvent : void 0
+      scale,
+      showMinimap,
+      enableCamera,
+      tileClickEvent,
+      unitClickEvent,
+      isLoading,
+      error
     }
   ) });
 }
@@ -47652,7 +47690,7 @@ var init_RacingBoard = __esm({
   "components/game/organisms/RacingBoard.tsx"() {
     "use client";
     init_cn();
-    init_GameCanvas2D();
+    init_IsometricCanvas();
     RacingBoard.displayName = "RacingBoard";
   }
 });
@@ -50951,35 +50989,44 @@ var init_SokobanBoard = __esm({
   }
 });
 function SpaceShmupBoard({
-  backgroundImage,
+  tiles,
+  units,
+  features,
+  assetManifest,
   assetBaseUrl,
-  width = 800,
-  height = 600,
-  fps = 60,
+  scale = 0.45,
+  showMinimap = false,
+  enableCamera = true,
+  tileClickEvent,
+  unitClickEvent,
   isLoading,
   error,
   className
 }) {
-  return /* @__PURE__ */ jsxRuntime.jsxs("div", { className: cn("space-shmup-board relative w-full h-full", className), children: [
-    isLoading && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-black/60 z-10", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-white text-sm", children: "Loading\u2026" }) }),
-    error && /* @__PURE__ */ jsxRuntime.jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-red-900/60 z-10", children: /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-white text-sm", children: error.message }) }),
-    /* @__PURE__ */ jsxRuntime.jsx(
-      GameCanvas2D,
-      {
-        backgroundImage,
-        assetBaseUrl,
-        width,
-        height,
-        fps
-      }
-    )
-  ] });
+  return /* @__PURE__ */ jsxRuntime.jsx("div", { className: cn("space-shmup-board relative w-full h-full", className), children: /* @__PURE__ */ jsxRuntime.jsx(
+    IsometricCanvas_default,
+    {
+      tileLayout: "flat",
+      tiles,
+      units,
+      features,
+      assetManifest,
+      assetBaseUrl,
+      scale,
+      showMinimap,
+      enableCamera,
+      tileClickEvent,
+      unitClickEvent,
+      isLoading,
+      error
+    }
+  ) });
 }
 var init_SpaceShmupBoard = __esm({
   "components/game/organisms/SpaceShmupBoard.tsx"() {
     "use client";
     init_cn();
-    init_GameCanvas2D();
+    init_IsometricCanvas();
     SpaceShmupBoard.displayName = "SpaceShmupBoard";
   }
 });

package/dist/components/index.js

@@ -10373,7 +10373,13 @@ function IsometricCanvas({
       const img = unitSpriteUrl ? getImage(unitSpriteUrl) : null;
       const unitDrawH = scaledFloorHeight * spriteHeightRatio * unitScale;
       const maxUnitW = scaledTileWidth * spriteMaxWidthRatio * unitScale;
-      const ar = img ? img.naturalWidth / img.naturalHeight : 0.5;
+      const SHEET_ROWS = 5;
+      const sheetFrameW = img ? img.naturalWidth / SHEET_COLUMNS : 0;
+      const sheetFrameH = img ? img.naturalHeight / SHEET_ROWS : 0;
+      const imgIsSheet = img ? img.naturalWidth % SHEET_COLUMNS === 0 && img.naturalHeight % SHEET_ROWS === 0 && Math.abs(sheetFrameW - sheetFrameH) < 2 : false;
+      const frameW = imgIsSheet ? sheetFrameW : img?.naturalWidth ?? 1;
+      const frameH = imgIsSheet ? sheetFrameH : img?.naturalHeight ?? 1;
+      const ar = frameW / (frameH || 1);
       let drawH = unitDrawH;
       let drawW = unitDrawH * ar;
       if (drawW > maxUnitW) {
@@ -10387,7 +10393,11 @@ function IsometricCanvas({
         ctx.save();
         ctx.globalAlpha = 0.25;
         if (img) {
-          ctx.drawImage(img, ghostCenterX - drawW / 2, ghostGroundY - drawH, drawW, drawH);
+          if (imgIsSheet) {
+            ctx.drawImage(img, 0, 0, sheetFrameW, sheetFrameH, ghostCenterX - drawW / 2, ghostGroundY - drawH, drawW, drawH);
+          } else {
+            ctx.drawImage(img, ghostCenterX - drawW / 2, ghostGroundY - drawH, drawW, drawH);
+          }
         } else {
           const color = unit.team === "player" ? "#3b82f6" : unit.team === "enemy" ? "#ef4444" : "#6b7280";
           ctx.beginPath();
@@ -10431,14 +10441,21 @@ function IsometricCanvas({
         ctx.restore();
       } else if (img) {
         const spriteY = groundY - drawH - breatheOffset;
+        const drawUnit = (x) => {
+          if (imgIsSheet) {
+            ctx.drawImage(img, 0, 0, sheetFrameW, sheetFrameH, x, spriteY, drawW, drawH);
+          } else {
+            ctx.drawImage(img, x, spriteY, drawW, drawH);
+          }
+        };
         if (unit.team) {
           ctx.save();
           ctx.shadowColor = unit.team === "player" ? "rgba(0, 150, 255, 0.6)" : "rgba(255, 50, 50, 0.6)";
           ctx.shadowBlur = 12 * scale;
-          ctx.drawImage(img, centerX - drawW / 2, spriteY, drawW, drawH);
+          drawUnit(centerX - drawW / 2);
           ctx.restore();
         } else {
-          ctx.drawImage(img, centerX - drawW / 2, spriteY, drawW, drawH);
+          drawUnit(centerX - drawW / 2);
         }
       } else {
         const color = unit.team === "player" ? "#3b82f6" : unit.team === "enemy" ? "#ef4444" : "#6b7280";
@@ -10731,6 +10748,7 @@ var init_IsometricCanvas = __esm({
     init_useUnitSpriteAtlas();
     init_verificationRegistry();
     init_isometric();
+    init_spriteSheetConstants();
     IsometricCanvas.displayName = "IsometricCanvas";
     IsometricCanvas_default = IsometricCanvas;
   }
@@ -45726,35 +45744,44 @@ var init_HexStrategyBoard = __esm({
   }
 });
 function HolidayRunnerBoard({
-  backgroundImage,
+  tiles,
+  units,
+  features,
+  assetManifest,
   assetBaseUrl,
-  width = 800,
-  height = 400,
-  fps = 60,
+  scale = 0.45,
+  showMinimap = false,
+  enableCamera = true,
+  tileClickEvent,
+  unitClickEvent,
   isLoading,
   error,
   className
 }) {
-  return /* @__PURE__ */ jsxs("div", { className: cn("holiday-runner-board relative w-full h-full", className), children: [
-    isLoading && /* @__PURE__ */ jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-black/40 z-10", children: /* @__PURE__ */ jsx("span", { className: "text-white text-sm", children: "Loading\u2026" }) }),
-    error && /* @__PURE__ */ jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-black/60 z-10", children: /* @__PURE__ */ jsx("span", { className: "text-red-400 text-sm", children: error.message }) }),
-    /* @__PURE__ */ jsx(
-      GameCanvas2D,
-      {
-        width,
-        height,
-        fps,
-        backgroundImage: backgroundImage ?? "",
-        assetBaseUrl
-      }
-    )
-  ] });
+  return /* @__PURE__ */ jsx("div", { className: cn("holiday-runner-board relative w-full h-full", className), children: /* @__PURE__ */ jsx(
+    IsometricCanvas_default,
+    {
+      tileLayout: "flat",
+      tiles,
+      units,
+      features,
+      assetManifest,
+      assetBaseUrl,
+      scale,
+      showMinimap,
+      enableCamera,
+      tileClickEvent,
+      unitClickEvent,
+      isLoading,
+      error
+    }
+  ) });
 }
 var init_HolidayRunnerBoard = __esm({
   "components/game/organisms/HolidayRunnerBoard.tsx"() {
     "use client";
     init_cn();
-    init_GameCanvas2D();
+    init_IsometricCanvas();
     HolidayRunnerBoard.displayName = "HolidayRunnerBoard";
   }
 });
@@ -47580,25 +47607,36 @@ var init_PricingPageTemplate = __esm({
   }
 });
 function RacingBoard({
-  backgroundImage,
+  tiles,
+  units,
+  features,
+  assetManifest,
   assetBaseUrl,
-  width = 800,
-  height = 600,
-  fps = 60,
-  tickEvent,
-  drawEvent,
+  scale = 0.45,
+  showMinimap = true,
+  enableCamera = true,
+  tileClickEvent,
+  unitClickEvent,
+  isLoading,
+  error,
   className
 }) {
   return /* @__PURE__ */ jsx("div", { className: cn("racing-board relative w-full h-full", className), children: /* @__PURE__ */ jsx(
-    GameCanvas2D,
+    IsometricCanvas_default,
     {
-      backgroundImage,
+      tileLayout: "flat",
+      tiles,
+      units,
+      features,
+      assetManifest,
       assetBaseUrl,
-      width,
-      height,
-      fps,
-      tickEvent: typeof tickEvent === "string" ? tickEvent : void 0,
-      drawEvent: typeof drawEvent === "string" ? drawEvent : void 0
+      scale,
+      showMinimap,
+      enableCamera,
+      tileClickEvent,
+      unitClickEvent,
+      isLoading,
+      error
     }
   ) });
 }
@@ -47606,7 +47644,7 @@ var init_RacingBoard = __esm({
   "components/game/organisms/RacingBoard.tsx"() {
     "use client";
     init_cn();
-    init_GameCanvas2D();
+    init_IsometricCanvas();
     RacingBoard.displayName = "RacingBoard";
   }
 });
@@ -50905,35 +50943,44 @@ var init_SokobanBoard = __esm({
   }
 });
 function SpaceShmupBoard({
-  backgroundImage,
+  tiles,
+  units,
+  features,
+  assetManifest,
   assetBaseUrl,
-  width = 800,
-  height = 600,
-  fps = 60,
+  scale = 0.45,
+  showMinimap = false,
+  enableCamera = true,
+  tileClickEvent,
+  unitClickEvent,
   isLoading,
   error,
   className
 }) {
-  return /* @__PURE__ */ jsxs("div", { className: cn("space-shmup-board relative w-full h-full", className), children: [
-    isLoading && /* @__PURE__ */ jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-black/60 z-10", children: /* @__PURE__ */ jsx("span", { className: "text-white text-sm", children: "Loading\u2026" }) }),
-    error && /* @__PURE__ */ jsx("div", { className: "absolute inset-0 flex items-center justify-center bg-red-900/60 z-10", children: /* @__PURE__ */ jsx("span", { className: "text-white text-sm", children: error.message }) }),
-    /* @__PURE__ */ jsx(
-      GameCanvas2D,
-      {
-        backgroundImage,
-        assetBaseUrl,
-        width,
-        height,
-        fps
-      }
-    )
-  ] });
+  return /* @__PURE__ */ jsx("div", { className: cn("space-shmup-board relative w-full h-full", className), children: /* @__PURE__ */ jsx(
+    IsometricCanvas_default,
+    {
+      tileLayout: "flat",
+      tiles,
+      units,
+      features,
+      assetManifest,
+      assetBaseUrl,
+      scale,
+      showMinimap,
+      enableCamera,
+      tileClickEvent,
+      unitClickEvent,
+      isLoading,
+      error
+    }
+  ) });
 }
 var init_SpaceShmupBoard = __esm({
   "components/game/organisms/SpaceShmupBoard.tsx"() {
     "use client";
     init_cn();
-    init_GameCanvas2D();
+    init_IsometricCanvas();
     SpaceShmupBoard.displayName = "SpaceShmupBoard";
   }
 });