@almadar/ui 5.65.0 → 5.68.0

package/dist/components/avl/derive-edit-focus.d.ts

@@ -0,0 +1,8 @@
+import type { EditFocus } from '@almadar/core';
+/**
+ * Build an `EditFocus` from a clicked element's `data-orb-*` address (stamped by
+ * UISlotRenderer). The owning orbital is read from the DOM (`data-orb-orbital`,
+ * walking up via `closest` when the clicked node itself doesn't carry it); since
+ * `EditFocus.orbital` is required, returns `null` when it can't be resolved.
+ */
+export declare function deriveEditFocusFromElement(el: HTMLElement): EditFocus | null;

package/dist/components/core/organisms/ChatBar.d.ts

@@ -0,0 +1,31 @@
+/**
+ * ChatBar Organism
+ *
+ * The always-visible bottom chat bar. A single-row input surface for talking
+ * to the agent: status icon, optional context badge, text input, and a
+ * status-driven action button (Send / Pause+Stop / Resume / Retry).
+ *
+ * The agent's activity stream lives in the dedicated Trace tab (see
+ * SubagentTracePanel). ChatBar emits generic EventBus events
+ * (`UI:CHAT_SEND`, `UI:ELEMENT_SELECTED`, plus the declarative `UI:*` actions
+ * the Button atom raises) — it owns no app-specific state.
+ */
+import React from 'react';
+import type { DisplayStateProps } from './types';
+export type ChatBarStatus = 'idle' | 'running' | 'paused' | 'complete' | 'error';
+export interface ChatBarProps extends DisplayStateProps {
+    /** Pipeline status */
+    status?: ChatBarStatus;
+    /** Currently active gate label, e.g. "Gate 2: State machines" */
+    activeGate?: string;
+    /** JEPA validity probability 0-1 */
+    jepaValidity?: number;
+    /** Input placeholder text */
+    placeholder?: string;
+    /** Agent context description */
+    context?: string;
+}
+export declare function ChatBar({ status, activeGate, jepaValidity, placeholder, context, className, }: ChatBarProps): React.ReactElement;
+export declare namespace ChatBar {
+    var displayName: string;
+}

package/dist/components/core/organisms/SubagentTracePanel.d.ts

@@ -0,0 +1,50 @@
+/**
+ * SubagentTracePanel — contextual side panel that surfaces subagent activity.
+ *
+ * Density adapts to disclosure level:
+ *   - L1/L2 (builder/designer): compact mode — name + role badge + last message
+ *   - L3/L4 (architect): full mode — rich per-subagent activity streams
+ *
+ * Atomic design: composes Box / VStack / HStack / Typography / Badge / Icon /
+ * Button / Modal / Accordion / CodeBlock / MarkdownContent from this package.
+ * It reads the agent-trace view-model from `@almadar/core` (Trace* types) and
+ * owns no transport — the consumer feeds it already-mapped view-model props.
+ */
+import React from 'react';
+import type { DisplayStateProps } from './types';
+import type { TraceActivity, TraceSubagent, TraceChatMessage } from '@almadar/core';
+/** Disclosure level driving panel density (builder=1 … architect=4). */
+export type TraceDisclosureLevel = 1 | 2 | 3 | 4;
+export interface SubagentTracePanelProps extends DisplayStateProps {
+    /** All known subagents from the runner. */
+    subagents: TraceSubagent[];
+    /** Current canvas focus orbital — only used by overlay mode. Tab mode ignores this. */
+    focusedOrbital?: string;
+    /** Drives density: 1-2 → compact, 3-4 → full activity embed (when mode='overlay'). */
+    disclosureLevel: TraceDisclosureLevel;
+    /** Whether the panel is visible. Typically auto-opens during generation in overlay mode. */
+    open: boolean;
+    /** Optional dismiss handler. */
+    onClose?: () => void;
+    /** Full coordinator activities (tool calls, results, messages, errors). */
+    coordinatorActivities?: TraceActivity[];
+    /**
+     * Canonical Coordinator conversation — same shape live and on reload. When
+     * present, takes precedence over `coordinatorActivities` for the Coordinator
+     * section.
+     */
+    coordinatorMessages?: readonly TraceChatMessage[];
+    /**
+     * Rendering mode.
+     * - `'overlay'` (default): floating side panel positioned absolutely over the
+     *   canvas. Density follows `disclosureLevel` (compact L1/L2, rich L3+). The
+     *   `open` flag actually hides the panel when false.
+     * - `'tab'`: full-width content for a dedicated 'trace' supplemental tab.
+     *   Always renders rich (regardless of disclosure level), always visible (the
+     *   `open` flag is ignored), and includes an empty state when no subagents
+     *   are present so users see the surface even before generation starts.
+     */
+    mode?: 'overlay' | 'tab';
+}
+export declare const SubagentTracePanel: React.FC<SubagentTracePanelProps>;
+export default SubagentTracePanel;

package/dist/components/core/organisms/index.d.ts

@@ -28,3 +28,6 @@ export { TeamOrganism, type TeamOrganismProps, } from "../../marketing/organisms
 export { CaseStudyOrganism, type CaseStudyOrganismProps, } from "../../marketing/organisms/CaseStudyOrganism";
 export { CodeRunnerPanel, type CodeRunnerPanelProps, type CodeSimulationOutput, } from './CodeRunnerPanel';
 export { SegmentRenderer, type SegmentRendererProps, } from './SegmentRenderer';
+export { ChatBar, type ChatBarProps, type ChatBarStatus } from './ChatBar';
+export { ELEMENT_SELECTED_EVENT, parseEditFocus, } from './trace-edit-focus';
+export { SubagentTracePanel, type SubagentTracePanelProps, type TraceDisclosureLevel, } from './SubagentTracePanel';

package/dist/components/core/organisms/trace-edit-focus.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Edit Focus — the contextual-edit selection contract for the trace chat bar.
+ *
+ * A canvas element-pick emits `UI:ELEMENT_SELECTED` on the EventBus carrying an
+ * `EditFocus`. This module names that event and narrows the bus payload back
+ * into a typed `EditFocus` for `ChatBar`'s focus chip. It depends only on
+ * `@almadar/core` types; the DOM→focus build lives at the emitting canvas
+ * (`avl/derive-edit-focus`), not here.
+ */
+import type { EditFocus, EventPayloadValue } from '@almadar/core';
+/** The dedicated bus event a canvas element-pick emits. */
+export declare const ELEMENT_SELECTED_EVENT = "UI:ELEMENT_SELECTED";
+/** Narrow a `UI:ELEMENT_SELECTED` payload value back into an `EditFocus`. */
+export declare function parseEditFocus(value: EventPayloadValue | undefined): EditFocus | null;

package/dist/components/game/atoms/ChoiceButton.d.ts

@@ -1,8 +1,14 @@
+import { type IconInput } from '../../core/atoms/Icon';
+import type { AssetUrl } from '@almadar/core';
 export interface ChoiceButtonProps {
     /** Choice text content */
     text: string;
     /** Choice index number (displayed as prefix) */
     index?: number;
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
+    /** Icon displayed before the text */
+    icon?: IconInput;
     /** Whether the choice is disabled */
     disabled?: boolean;
     /** Whether the choice is currently selected */
@@ -12,7 +18,7 @@ export interface ChoiceButtonProps {
     /** Additional CSS classes */
     className?: string;
 }
-export declare function ChoiceButton({ text, index, disabled, selected, onClick, className, }: ChoiceButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChoiceButton({ text, index, assetUrl, icon, disabled, selected, onClick, className, }: ChoiceButtonProps): import("react/jsx-runtime").JSX.Element;
 export declare namespace ChoiceButton {
     var displayName: string;
 }

package/dist/components/game/molecules/HealthPanel.d.ts

@@ -1,6 +1,9 @@
 import type { IconInput } from '../../core/atoms';
+import type { AssetUrl } from '@almadar/core';
 export interface HealthEffect {
     icon: IconInput;
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     label?: string;
     variant?: 'buff' | 'debuff' | 'neutral';
 }

package/dist/components/game/molecules/IsometricCanvas.d.ts

@@ -80,7 +80,7 @@ export interface IsometricCanvasProps {
     }>;
     /** Declarative event: emits UI:{tileLeaveEvent} with {} on tile leave */
     tileLeaveEvent?: EventEmit<Record<string, never>>;
-    /** Tile layout projection: 'isometric' (default 2:1 diamond) or 'hex' (pointy-top offset rows) */
+    /** Tile layout projection: 'isometric' (default 2:1 diamond), 'hex' (pointy-top offset rows), or 'flat' (orthographic top-down square grid) */
     tileLayout?: TileLayout;
     /** Render scale (0.4 = 40% zoom) */
     scale?: number;

package/dist/components/game/molecules/PowerupSlots.d.ts

@@ -1,7 +1,10 @@
 import type { IconInput } from '../../core/atoms';
+import type { AssetUrl } from '@almadar/core';
 export interface ActivePowerup {
     /** Unique powerup ID */
     id: string;
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Icon component or emoji */
     icon?: IconInput;
     /** Powerup label */

package/dist/components/game/molecules/TurnPanel.d.ts

@@ -1,7 +1,10 @@
 import type { IconInput } from '../../core/atoms';
+import type { AssetUrl } from '@almadar/core';
 export interface TurnPanelAction {
     /** Action button label */
     label: string;
+    /** Sprite image URL — takes precedence over icon when provided */
+    assetUrl?: AssetUrl;
     /** Icon for the button */
     icon?: IconInput;
     /** Event name to emit when clicked */

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

@@ -2845,9 +2845,9 @@ var GameCanvas3D = React11.forwardRef(
         const color = unit.faction === "player" ? 4491519 : unit.faction === "enemy" ? 16729156 : 16777028;
         const hasAtlas = unitAtlasUrl(unit) !== null;
         const initialFrame = hasAtlas ? resolveUnitFrame(unit.id) : null;
-        const modelScale = UNIT_BASE_MODEL_SCALE * unitScale;
-        const billboardHeight = UNIT_BASE_BILLBOARD_HEIGHT * unitScale;
-        const primitiveRadius = UNIT_BASE_PRIMITIVE_RADIUS * unitScale;
+        const modelScale = UNIT_BASE_MODEL_SCALE * unitScale * gridConfig.cellSize;
+        const billboardHeight = UNIT_BASE_BILLBOARD_HEIGHT * unitScale * gridConfig.cellSize;
+        const primitiveRadius = UNIT_BASE_PRIMITIVE_RADIUS * unitScale * gridConfig.cellSize;
         return /* @__PURE__ */ jsxRuntime.jsxs(
           "group",
           {
@@ -2894,7 +2894,7 @@ var GameCanvas3D = React11.forwardRef(
                   /* @__PURE__ */ jsxRuntime.jsx("meshStandardMaterial", { color })
                 ] })
               ] }),
-              unit.health !== void 0 && unit.maxHealth !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs("group", { position: [0, 1.2, 0], children: [
+              unit.health !== void 0 && unit.maxHealth !== void 0 && /* @__PURE__ */ jsxRuntime.jsxs("group", { position: [0, billboardHeight, 0], children: [
                 /* @__PURE__ */ jsxRuntime.jsxs("mesh", { position: [-0.25, 0, 0], children: [
                   /* @__PURE__ */ jsxRuntime.jsx("planeGeometry", { args: [0.5, 0.05] }),
                   /* @__PURE__ */ jsxRuntime.jsx("meshBasicMaterial", { color: 3355443 })
@@ -2923,7 +2923,7 @@ var GameCanvas3D = React11.forwardRef(
           }
         );
       },
-      [selectedUnitId, handleUnitClick, resolveUnitFrame, unitScale]
+      [selectedUnitId, handleUnitClick, resolveUnitFrame, unitScale, gridConfig]
     );
     const DefaultFeatureRenderer = React11.useCallback(
       ({
@@ -3011,7 +3011,7 @@ var GameCanvas3D = React11.forwardRef(
           {
             ref: containerRef,
             className: cn("game-canvas-3d relative w-full overflow-hidden", className),
-            style: { height: "85vh" },
+            style: { flex: "1 1 0", minHeight: "400px" },
             "data-orientation": orientation,
             "data-camera-mode": cameraMode,
             "data-overlay": overlay,

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

@@ -2821,9 +2821,9 @@ var GameCanvas3D = forwardRef(
         const color = unit.faction === "player" ? 4491519 : unit.faction === "enemy" ? 16729156 : 16777028;
         const hasAtlas = unitAtlasUrl(unit) !== null;
         const initialFrame = hasAtlas ? resolveUnitFrame(unit.id) : null;
-        const modelScale = UNIT_BASE_MODEL_SCALE * unitScale;
-        const billboardHeight = UNIT_BASE_BILLBOARD_HEIGHT * unitScale;
-        const primitiveRadius = UNIT_BASE_PRIMITIVE_RADIUS * unitScale;
+        const modelScale = UNIT_BASE_MODEL_SCALE * unitScale * gridConfig.cellSize;
+        const billboardHeight = UNIT_BASE_BILLBOARD_HEIGHT * unitScale * gridConfig.cellSize;
+        const primitiveRadius = UNIT_BASE_PRIMITIVE_RADIUS * unitScale * gridConfig.cellSize;
         return /* @__PURE__ */ jsxs(
           "group",
           {
@@ -2870,7 +2870,7 @@ var GameCanvas3D = forwardRef(
                   /* @__PURE__ */ jsx("meshStandardMaterial", { color })
                 ] })
               ] }),
-              unit.health !== void 0 && unit.maxHealth !== void 0 && /* @__PURE__ */ jsxs("group", { position: [0, 1.2, 0], children: [
+              unit.health !== void 0 && unit.maxHealth !== void 0 && /* @__PURE__ */ jsxs("group", { position: [0, billboardHeight, 0], children: [
                 /* @__PURE__ */ jsxs("mesh", { position: [-0.25, 0, 0], children: [
                   /* @__PURE__ */ jsx("planeGeometry", { args: [0.5, 0.05] }),
                   /* @__PURE__ */ jsx("meshBasicMaterial", { color: 3355443 })
@@ -2899,7 +2899,7 @@ var GameCanvas3D = forwardRef(
           }
         );
       },
-      [selectedUnitId, handleUnitClick, resolveUnitFrame, unitScale]
+      [selectedUnitId, handleUnitClick, resolveUnitFrame, unitScale, gridConfig]
     );
     const DefaultFeatureRenderer = useCallback(
       ({
@@ -2987,7 +2987,7 @@ var GameCanvas3D = forwardRef(
           {
             ref: containerRef,
             className: cn("game-canvas-3d relative w-full overflow-hidden", className),
-            style: { height: "85vh" },
+            style: { flex: "1 1 0", minHeight: "400px" },
             "data-orientation": orientation,
             "data-camera-mode": cameraMode,
             "data-overlay": overlay,

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

@@ -0,0 +1,37 @@
+import React from 'react';
+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 BoardgameBoardProps extends DisplayStateProps {
+    /** Board squares (flat top-down grid tiles) */
+    tiles?: IsometricTile[];
+    /** Tokens/units on the board */
+    units?: IsometricUnit[];
+    /** Features (markers, structures, etc.) on the board */
+    features?: IsometricFeature[];
+    /** Asset sprite manifest (same shape as IsometricCanvas.assetManifest) */
+    assetManifest?: IsometricCanvasProps['assetManifest'];
+    /** Base URL prepended to asset paths */
+    assetBaseUrl?: AssetUrl;
+    /** 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 BoardgameBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: BoardgameBoardProps): React.ReactElement;
+export declare namespace BoardgameBoard {
+    var displayName: string;
+}
+export default BoardgameBoard;

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

@@ -0,0 +1,33 @@
+import React from 'react';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { DisplayStateProps } from '../../core/organisms/types';
+export interface FishingBoardProps extends DisplayStateProps {
+    /** Background image URL for the fishing scene */
+    backgroundImage?: AssetUrl;
+    /** Base URL prepended to asset paths */
+    assetBaseUrl?: AssetUrl;
+    /** Render scale */
+    scale?: number;
+    /** Show minimap overlay */
+    showMinimap?: boolean;
+    /** Enable camera pan/zoom controls */
+    enableCamera?: boolean;
+    /** Canvas width in pixels */
+    width?: number;
+    /** Canvas height in pixels */
+    height?: number;
+    /** 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 FishingBoard({ backgroundImage, assetBaseUrl, scale, showMinimap, enableCamera, width, height, isLoading, error, className, }: FishingBoardProps): React.ReactElement;
+export declare namespace FishingBoard {
+    var displayName: string;
+}
+export default FishingBoard;

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

@@ -0,0 +1,35 @@
+import React from 'react';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { DisplayStateProps } from '../../core/organisms/types';
+export interface HolidayRunnerBoardProps extends DisplayStateProps {
+    /** Background image URL for the runner level */
+    backgroundImage?: AssetUrl;
+    /** Base URL prefix for asset URLs */
+    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:{tickEvent} with { dt, frame } each tick */
+    tickEvent?: EventEmit<{
+        dt: number;
+        frame: number;
+    }>;
+    /** Declarative event: emits UI:{drawEvent} with { frame } each draw frame */
+    drawEvent?: EventEmit<{
+        frame: number;
+    }>;
+}
+export declare function HolidayRunnerBoard({ backgroundImage, assetBaseUrl, width, height, fps, isLoading, error, className, }: HolidayRunnerBoardProps): React.ReactElement;
+export declare namespace HolidayRunnerBoard {
+    var displayName: string;
+}
+export default HolidayRunnerBoard;

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

@@ -0,0 +1,37 @@
+import React from 'react';
+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 MatchPuzzleBoardProps extends DisplayStateProps {
+    /** Grid tiles for the match puzzle board */
+    tiles?: IsometricTile[];
+    /** Units on the board */
+    units?: IsometricUnit[];
+    /** Gem/feature items 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;
+    /** 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 MatchPuzzleBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: MatchPuzzleBoardProps): React.ReactElement;
+export declare namespace MatchPuzzleBoard {
+    var displayName: string;
+}
+export default MatchPuzzleBoard;

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

@@ -0,0 +1,37 @@
+import React from 'react';
+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 MinigolfBoardProps extends DisplayStateProps {
+    /** Isometric grid tiles */
+    tiles?: IsometricTile[];
+    /** Units on the board */
+    units?: IsometricUnit[];
+    /** Features (holes, obstacles, 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;
+    /** 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 MinigolfBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: MinigolfBoardProps): React.ReactElement;
+export declare namespace MinigolfBoard {
+    var displayName: string;
+}
+export default MinigolfBoard;

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

@@ -0,0 +1,35 @@
+import React from 'react';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { DisplayStateProps } from '../../core/organisms/types';
+export interface PinballBoardProps extends DisplayStateProps {
+    /** Playfield tiles */
+    tiles?: unknown[];
+    /** Ball units on the board */
+    units?: unknown[];
+    /** Features (bumpers, paddles, etc.) on the board */
+    features?: unknown[];
+    /** Asset sprite manifest */
+    assetManifest?: string;
+    /** Base URL prepended to manifest sprite paths */
+    assetBaseUrl?: AssetUrl;
+    /** 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 PinballBoard({ tiles: _tiles, units: _units, features: _features, assetManifest: _assetManifest, assetBaseUrl, scale, showMinimap: _showMinimap, enableCamera: _enableCamera, tileClickEvent: _tileClickEvent, unitClickEvent: _unitClickEvent, isLoading, error, className, }: PinballBoardProps): React.ReactElement;
+export declare namespace PinballBoard {
+    var displayName: string;
+}
+export default PinballBoard;

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

@@ -0,0 +1,37 @@
+import React from 'react';
+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 PirateBoardProps extends DisplayStateProps {
+    /** Sea/island grid tiles */
+    tiles?: IsometricTile[];
+    /** Ship and crew units on the board */
+    units?: IsometricUnit[];
+    /** Features (ports, treasures, 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;
+    /** 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 PirateBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: PirateBoardProps): React.ReactElement;
+export declare namespace PirateBoard {
+    var displayName: string;
+}
+export default PirateBoard;

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

@@ -0,0 +1,29 @@
+import React from 'react';
+import type { AssetUrl, EventEmit } from '@almadar/core';
+import type { DisplayStateProps } from '../../core/organisms/types';
+export interface RacingBoardProps extends DisplayStateProps {
+    /** Race track background image URL */
+    backgroundImage?: AssetUrl;
+    /** Base URL prepended to asset paths */
+    assetBaseUrl?: AssetUrl;
+    /** Canvas width in pixels */
+    width?: number;
+    /** Canvas height in pixels */
+    height?: number;
+    /** Target frames per second */
+    fps?: number;
+    /** Declarative event: emits UI:{tickEvent} with { dt, frame } each tick */
+    tickEvent?: EventEmit<{
+        dt: number;
+        frame: number;
+    }>;
+    /** Declarative event: emits UI:{drawEvent} with { frame } each draw frame */
+    drawEvent?: EventEmit<{
+        frame: number;
+    }>;
+}
+export declare function RacingBoard({ backgroundImage, assetBaseUrl, width, height, fps, tickEvent, drawEvent, className, }: RacingBoardProps): React.ReactElement;
+export declare namespace RacingBoard {
+    var displayName: string;
+}
+export default RacingBoard;

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

@@ -0,0 +1,37 @@
+import React from 'react';
+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 SokobanBoardProps extends DisplayStateProps {
+    /** Grid tiles (floor, wall, target) */
+    tiles?: IsometricTile[];
+    /** Units on the board (the pusher character) */
+    units?: IsometricUnit[];
+    /** Features (crates) 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;
+    /** 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 SokobanBoard({ tiles, units, features, assetManifest, assetBaseUrl, scale, showMinimap, enableCamera, tileClickEvent, unitClickEvent, isLoading, error, className, }: SokobanBoardProps): React.ReactElement;
+export declare namespace SokobanBoard {
+    var displayName: string;
+}
+export default SokobanBoard;

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import type { AssetUrl } from '@almadar/core';
+import type { DisplayStateProps } from '../../core/organisms/types';
+export interface SpaceShmupBoardProps extends DisplayStateProps {
+    /** Background image URL (starfield / space scene) */
+    backgroundImage?: AssetUrl;
+    /** Base URL prefix for asset URLs */
+    assetBaseUrl?: AssetUrl;
+    /** Canvas width in pixels */
+    width?: number;
+    /** Canvas height in pixels */
+    height?: number;
+    /** Target frames per second */
+    fps?: number;
+}
+export declare function SpaceShmupBoard({ backgroundImage, assetBaseUrl, width, height, fps, isLoading, error, className, }: SpaceShmupBoardProps): React.ReactElement;
+export declare namespace SpaceShmupBoard {
+    var displayName: string;
+}
+export default SpaceShmupBoard;