@almadar/ui 5.105.0 → 5.107.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.105.0",
+  "version": "5.107.0",
   "description": "React UI components, hooks, and providers for Almadar",
   "type": "module",
   "sideEffects": [
@@ -52,22 +52,22 @@
       "require": "./dist/lib/index.cjs"
     },
     "./components/organisms/game/three": {
-      "types": "./dist/components/game/3d/index.d.ts",
-      "import": "./dist/components/game/3d/index.js",
-      "require": "./dist/components/game/3d/index.cjs"
+      "types": "./dist/components/game/three/index.d.ts",
+      "import": "./dist/components/game/three/index.js",
+      "require": "./dist/components/game/three/index.cjs"
     },
     "./components/molecules/game/three": {
-      "types": "./dist/components/game/3d/index.d.ts",
-      "import": "./dist/components/game/3d/index.js",
-      "require": "./dist/components/game/3d/index.cjs"
+      "types": "./dist/components/game/three/index.d.ts",
+      "import": "./dist/components/game/three/index.js",
+      "require": "./dist/components/game/three/index.cjs"
     },
     "./components/organisms/game/TraitStateViewer": {
-      "import": "./components/game/2d/TraitStateViewer.tsx",
-      "types": "./components/game/2d/TraitStateViewer.tsx"
+      "import": "./components/game/molecules/TraitStateViewer.tsx",
+      "types": "./components/game/molecules/TraitStateViewer.tsx"
     },
     "./components/organisms/game/TraitSlot": {
-      "import": "./components/game/2d/TraitSlot.tsx",
-      "types": "./components/game/2d/TraitSlot.tsx"
+      "import": "./components/game/molecules/TraitSlot.tsx",
+      "types": "./components/game/molecules/TraitSlot.tsx"
     },
     "./templates": {
       "import": "./templates/index.ts",
@@ -117,10 +117,10 @@
     "access": "public"
   },
   "dependencies": {
-    "@almadar/core": "^10.16.0",
+    "@almadar/core": "^10.20.0",
     "@almadar/evaluator": ">=2.9.2",
     "@almadar/logger": "^1.3.0",
-    "@almadar/patterns": ">=2.35.0",
+    "@almadar/patterns": ">=2.97.0",
     "@almadar/runtime": "^6.21.0",
     "@almadar/std": ">=6.4.1",
     "@almadar/syntax": ">=1.3.1",

package/dist/components/game/2d/molecules/Canvas2D.d.ts

@@ -1,175 +0,0 @@
-/**
- * Canvas2D
- *
- * The unified 2D game renderer (GR-6 consolidation). One canvas, a `projection`
- * axis, layered render passes, opt-in clock. Absorbs IsometricCanvas (iso/hex/flat),
- * GameCanvas2D (→ `projection:'free'`, pixel-direct draw) and PlatformerCanvas
- * (→ `projection:'side'` + `platforms[]`).
- *
- * Pure renderer: every game datum arrives via props; only view state (viewport,
- * camera, sprite cache) is local. The clock is LOLO-driven by default — `animate`
- * opts a board into an internal RAF, but the default is OFF.
- *
- * Projection modes:
- * - `isometric | hex | flat`: 2:1 diamond / pointy-top hex / orthographic square,
- *   all via `isoToScreen` — identical to IsometricCanvas.
- * - `free`: tile/unit/feature x,y are SCREEN PIXELS drawn directly (no diamond),
- *   reusing the same sprite-drawing passes.
- * - `side`: side-view pixel space with `platforms[]` (AABB) + follow-camera +
- *   keyboard input — an isolated branch ported from PlatformerCanvas.
- *
- * @packageDocumentation
- */
-import * as React from 'react';
-import type { Asset, AssetUrl, EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature, ActiveEffect } from '../../shared/isometricTypes';
-import type { ResolvedFrame } from '../../shared/spriteAnimationTypes';
-import type { UiError } from '../../../core/atoms/types';
-export interface TileCoord {
-    x: number;
-    y: number;
-}
-/** Projection axis. iso/hex/flat use `isoToScreen`; `free` is pixel-direct; `side`
- *  is side-view pixel space with platforms (gravity lives in the LOLO model). */
-export type Projection = 'isometric' | 'hex' | 'flat' | 'free' | 'side';
-/** Camera behavior. `pan-zoom` = user drag+wheel; `follow` = track the player/
- *  selected unit; `fixed` = no camera motion. */
-export type CameraMode = 'pan-zoom' | 'follow' | 'fixed';
-/** A side-view platform (AABB rect). `side` projection only. */
-export interface Platform {
-    x: number;
-    y: number;
-    width: number;
-    height: number;
-    type?: 'ground' | 'platform' | 'hazard' | 'goal';
-}
-/** A side-view player. The model owns physics; Canvas2D only interpolates+draws. */
-export interface SidePlayer {
-    x: number;
-    y: number;
-    width?: number;
-    height?: number;
-    vx?: number;
-    vy?: number;
-    grounded?: boolean;
-    facingRight?: boolean;
-    /** Animation state name — driven by the LOLO state machine (e.g. "idle", "walk", "jump"). */
-    animation?: string;
-    /** Frame index within the animation — driven by the LOLO state machine. */
-    frame?: number;
-}
-export interface Canvas2DProps {
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Projection axis (default 'isometric'). Replaces the old `tileLayout`. */
-    projection?: Projection;
-    /** Tiles to render */
-    tiles?: IsometricTile[];
-    /** Units on the board */
-    units?: IsometricUnit[];
-    /** Features (resources, portals, buildings, etc.) */
-    features?: IsometricFeature[];
-    /** Active visual effects, drawn after units */
-    effects?: ActiveEffect[];
-    /** Side-view platforms (AABB). `projection:'side'` only. */
-    platforms?: Platform[];
-    /** Side-view player. `projection:'side'` only. */
-    player?: SidePlayer;
-    /** Background image (tiled behind iso/hex/flat/free; stretched in side).
-     * A bare URL string is accepted as shorthand for a standalone backdrop. */
-    backgroundImage?: AssetUrl | Asset;
-    /** Currently selected unit ID */
-    selectedUnitId?: string | null;
-    /** Valid move positions (pulsing green highlights) */
-    validMoves?: TileCoord[];
-    /** Attack target positions (pulsing red highlights) */
-    attackTargets?: TileCoord[];
-    /** Hovered tile position */
-    hoveredTile?: TileCoord | null;
-    /** Emits UI:{tileClickEvent} with { x, y } on tile click */
-    tileClickEvent?: EventEmit<{
-        x: number;
-        y: number;
-    }>;
-    /** Emits UI:{unitClickEvent} with { unitId } on unit click */
-    unitClickEvent?: EventEmit<{
-        unitId: string;
-    }>;
-    /** Emits UI:{tileHoverEvent} with { x, y } on tile hover */
-    tileHoverEvent?: EventEmit<{
-        x: number;
-        y: number;
-    }>;
-    /** Emits UI:{tileLeaveEvent} with {} on tile leave */
-    tileLeaveEvent?: EventEmit<Record<string, never>>;
-    /** Maps a keydown `e.code` → the board's SEMANTIC event, e.g. `{ ArrowLeft: "LEFT", KeyA: "LEFT", Space: "JUMP" }`.
-     *  The input layer emits `UI:<event>` so the FSM stays device-agnostic — keyboard and d-pad converge on the same events. */
-    keyMap?: Record<string, string>;
-    /** Maps a keyup `e.code` → the board's SEMANTIC event, e.g. `{ ArrowLeft: "STOP" }`. Omit a key to ignore its release (e.g. jump). */
-    keyUpMap?: Record<string, string>;
-    /** Camera behavior (default 'pan-zoom'). */
-    camera?: CameraMode;
-    /** Render scale (0.4 = 40% zoom). */
-    scale?: number;
-    /** Extra scale multiplier for unit draw size. 1 = default. */
-    unitScale?: number;
-    /** Toggle minimap overlay. */
-    showMinimap?: boolean;
-    /** Opt-in internal RAF clock. DEFAULT OFF — the LOLO state machine drives the clock. */
-    animate?: {
-        fps: number;
-    };
-    /**
-     * Opt-in: smooth-interpolate unit positions between LOLO tick snapshots
-     * via a `requestAnimationFrame` loop (same fixed-timestep technique
-     * `SideCanvas2D` already uses for the player), instead of the default
-     * tick-rate-cadence redraw. DEFAULT OFF — for continuous-movement boards
-     * only; tile-snapped boards see no behavior change.
-     */
-    interpolateUnits?: boolean;
-    /** Show debug grid lines and coordinates. */
-    debug?: boolean;
-    /** Ratio of unit draw height to scaledFloorHeight. Default 1.5. */
-    spriteHeightRatio?: number;
-    /** Max unit draw width as a ratio of scaledTileWidth. Default 0.6. */
-    spriteMaxWidthRatio?: number;
-    /** Override for the diamond-top Y offset within the tile sprite. */
-    diamondTopY?: number;
-    /** Resolve terrain sprite from terrain key — a bare URL or an Asset (atlas sub-texture ref). */
-    getTerrainSprite?: (terrain: string) => string | Asset | undefined;
-    /** Resolve feature sprite from feature type key — a bare URL or an Asset. */
-    getFeatureSprite?: (featureType: string) => string | Asset | undefined;
-    /** Resolve unit static sprite — a bare URL or an Asset. */
-    getUnitSprite?: (unit: IsometricUnit) => string | Asset | undefined;
-    /** Resolve animated sprite sheet frame for a unit */
-    resolveUnitFrame?: (unitId: string) => ResolvedFrame | null;
-    /** Additional sprite URLs to preload (e.g., effect sprites) */
-    effectSpriteUrls?: string[];
-    /** Draw canvas effects after units (canvas-specific: cannot be declarative) */
-    onDrawEffects?: (ctx: CanvasRenderingContext2D, animTime: number, getImage: (url: string) => HTMLImageElement | undefined) => void;
-    /** Player sprite URL for `side`. */
-    playerSprite?: Asset;
-    /** Platform-type → tile sprite URL map for `side`. */
-    tileSprites?: Record<string, Asset>;
-    /** Background color for `side` (when no backgroundImage). */
-    bgColor?: string;
-    /** World dimensions for `side` follow-camera clamp. */
-    worldWidth?: number;
-    worldHeight?: number;
-    /** Manifest mapping entity keys to resolved Asset objects (fallback resolution). */
-    assetManifest?: {
-        terrains?: Record<string, Asset>;
-        units?: Record<string, Asset>;
-        features?: Record<string, Asset>;
-        effects?: Record<string, Asset>;
-    };
-}
-export declare function Canvas2D({ className, isLoading, error, projection, tiles: _tilesPropRaw, units: _unitsPropRaw, features: _featuresPropRaw, effects: _effectsPropRaw, platforms, player, backgroundImage: backgroundImageRaw, selectedUnitId, validMoves, attackTargets, hoveredTile, tileClickEvent, unitClickEvent, tileHoverEvent, tileLeaveEvent, keyMap, keyUpMap, camera, scale, unitScale, showMinimap, animate, interpolateUnits, debug, spriteHeightRatio, spriteMaxWidthRatio, diamondTopY: diamondTopYProp, getTerrainSprite, getFeatureSprite, getUnitSprite, resolveUnitFrame, effectSpriteUrls, onDrawEffects, playerSprite, tileSprites, bgColor, worldWidth, worldHeight, assetManifest, }: Canvas2DProps): React.JSX.Element;
-export declare namespace Canvas2D {
-    var displayName: string;
-}
-export default Canvas2D;

package/dist/components/game/2d/molecules/SideCanvas2D.d.ts

@@ -1,36 +0,0 @@
-/**
- * SideCanvas2D
- *
- * Side-view platformer renderer — extracted from Canvas2D's private `SideView` branch.
- * Physics is NOT here (it lives in the LOLO model); this only interpolates+draws the
- * authoritative `player`/`platforms` props and translates keyboard input into the
- * board's semantic events via keyMap/keyUpMap.
- *
- * @packageDocumentation
- */
-import * as React from 'react';
-import type { Asset, AssetUrl } from '@almadar/core';
-import type { ActiveEffect } from '../../shared/isometricTypes';
-import type { Platform, SidePlayer } from './Canvas2D';
-export interface SideCanvas2DProps {
-    player?: SidePlayer;
-    platforms: Platform[];
-    worldWidth: number;
-    worldHeight: number;
-    canvasWidth: number;
-    canvasHeight: number;
-    follow: boolean;
-    bgColor: string;
-    backgroundImage?: AssetUrl | Asset;
-    playerSprite?: Asset;
-    tileSprites?: Record<string, Asset>;
-    effects: ActiveEffect[];
-    keyMap?: Record<string, string>;
-    keyUpMap?: Record<string, string>;
-    className?: string;
-}
-export declare function SideCanvas2D({ player, platforms, worldWidth, worldHeight, canvasWidth, canvasHeight, follow, bgColor, backgroundImage: backgroundImageRaw, playerSprite, tileSprites, effects, keyMap, keyUpMap, className, }: SideCanvas2DProps): React.JSX.Element;
-export declare namespace SideCanvas2D {
-    var displayName: string;
-}
-export default SideCanvas2D;

package/dist/components/game/2d/organisms/BuilderBoard.d.ts

@@ -1,60 +0,0 @@
-/**
- * BuilderBoard
- *
- * Component-snapping game board. The player places components
- * onto slots in a blueprint. Correct placement completes the build.
- *
- * Good for: architecture, circuits, molecules, system design stories.
- *
- * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
- */
-import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow, Asset } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** A draggable build component (UI value DTO read off the entity). */
-export interface BuilderComponent {
-    id: string;
-    label: string;
-    description?: string;
-    iconEmoji?: string;
-    /** Image URL icon (takes precedence over iconEmoji) */
-    iconUrl?: AssetUrl;
-    category?: string;
-}
-/** A blueprint slot accepting a component (UI value DTO read off the entity).
- *  Mirrors the state machine's `BuilderBoardSlotsItem`: the required component
- *  and the currently placed component both live on the entity. */
-export interface BuilderSlot {
-    id: string;
-    label?: string;
-    description?: string;
-    requiredComponentId: string;
-    placedComponentId?: string;
-}
-export interface BuilderBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `components` / `slots` arrays plus `attempts` / `result` off the row —
-     *  the state machine is the single source of truth for placements. */
-    entity?: EntityRow | readonly EntityRow[];
-    completeEvent?: EventEmit<{
-        success: boolean;
-        attempts: number;
-    }>;
-    /** Emits UI:{placeEvent} with { slotId, componentId } on component placement. */
-    placeEvent?: EventEmit<{
-        slotId: string;
-        componentId: string;
-    }>;
-    /** Emits UI:{checkEvent} with {} when the player checks the build. */
-    checkEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{playAgainEvent} with {} on play again / reset. */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-    /** Optional per-semantic-key asset overrides for icons (correct/incorrect/reset/build). */
-    assetManifest?: {
-        ui?: Record<string, Asset>;
-    };
-}
-export declare function BuilderBoard({ entity, completeEvent, placeEvent, checkEvent, playAgainEvent, assetManifest, className, }: BuilderBoardProps): React.JSX.Element | null;
-export declare namespace BuilderBoard {
-    var displayName: string;
-}

package/dist/components/game/2d/organisms/ClassifierBoard.d.ts

@@ -1,66 +0,0 @@
-/**
- * ClassifierBoard
- *
- * Drag-and-drop classification game. The player sorts items
- * into the correct category buckets. All items must be correctly
- * classified to win.
- *
- * Good for: taxonomy, pattern recognition, sorting stories.
- *
- * Gameplay events are emitted onto the bus so the bound Orbital trait
- * (ui-classifier-board.lolo: menu -> playing -> complete) owns the state:
- * assignEvent (ASSIGN), checkEvent (CHECK), playAgainEvent (PLAY_AGAIN),
- * plus completeEvent (default UI:PUZZLE_COMPLETE). When the entity carries
- * per-item `assignedCategory` / `result` / `attempts`, the board renders
- * from those; otherwise it self-manages with local state.
- */
-import React from 'react';
-import type { AssetUrl, EventEmit, EntityRow, Asset } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** A sortable item (UI value DTO read off the entity). */
-export interface ClassifierItem {
-    id: string;
-    label: string;
-    description?: string;
-    correctCategory: string;
-    /** Category the player has assigned (entity-provided; machine-owned). */
-    assignedCategory?: string;
-    /** Image URL icon for story-specific visual skin */
-    iconUrl?: AssetUrl;
-}
-/** A category bucket (UI value DTO read off the entity). */
-export interface ClassifierCategory {
-    id: string;
-    label: string;
-    color?: string;
-    /** Image URL for story-specific category header */
-    imageUrl?: AssetUrl;
-}
-export interface ClassifierBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `items` / `categories` arrays plus title/description/hint off the row.
-     *  Items may carry `assignedCategory`; the row may carry `result` and
-     *  `attempts` — all machine-owned. */
-    entity?: EntityRow | readonly EntityRow[];
-    completeEvent?: EventEmit<{
-        success: boolean;
-        attempts: number;
-    }>;
-    /** Emits UI:{assignEvent} with { itemId, categoryId } when an item is sorted. */
-    assignEvent?: EventEmit<{
-        itemId: string;
-        categoryId: string;
-    }>;
-    /** Emits UI:{checkEvent} with {} when the player submits/checks. */
-    checkEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{playAgainEvent} with {} on reset / play again. */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-    /** Optional per-semantic-key asset overrides for icons (correct/incorrect/reset/send). */
-    assetManifest?: {
-        ui?: Record<string, Asset>;
-    };
-}
-export declare function ClassifierBoard({ entity, completeEvent, assignEvent, checkEvent, playAgainEvent, assetManifest, className, }: ClassifierBoardProps): React.JSX.Element | null;
-export declare namespace ClassifierBoard {
-    var displayName: string;
-}

package/dist/components/game/2d/organisms/DebuggerBoard.d.ts

@@ -1,61 +0,0 @@
-/**
- * DebuggerBoard
- *
- * Error-finding game board. The player reviews a code/system
- * listing and identifies lines or elements that contain bugs.
- *
- * Good for: programming, logic, troubleshooting stories.
- *
- * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
- */
-import React from 'react';
-import type { EventEmit, EntityRow, EntityWith, Asset } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** A reviewable code line (UI value DTO read off the entity). */
-export interface DebuggerLine {
-    id: string;
-    content: string;
-    isBug: boolean;
-    isFlagged?: boolean;
-    explanation?: string;
-}
-export interface DebuggerBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `lines` array (each with `isFlagged`), `result`, `attempts`, plus
-     *  title/description/bugCount/hint off the row. */
-    entity?: EntityWith<{
-        lines?: DebuggerLine[];
-        result?: string;
-        attempts?: number;
-        title?: string;
-        description?: string;
-        bugCount?: number;
-        hint?: string;
-        headerImage?: string;
-        theme?: {
-            background?: string;
-            accentColor?: string;
-        };
-        successMessage?: string;
-    }> | readonly EntityRow[];
-    completeEvent?: EventEmit<{
-        success: boolean;
-        attempts: number;
-    }>;
-    /** Emits UI:{toggleFlagEvent} with { lineId } when a line's bug-flag is toggled. */
-    toggleFlagEvent?: EventEmit<{
-        lineId: string;
-    }>;
-    /** Emits UI:{checkEvent} with {} when the player checks/submits. */
-    checkEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{playAgainEvent} with {} on play again / reset. */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-    /** Optional per-semantic-key asset overrides for icons (correct/incorrect/reset/bug/send). */
-    assetManifest?: {
-        ui?: Record<string, Asset>;
-    };
-}
-export declare function DebuggerBoard({ entity, completeEvent, toggleFlagEvent, checkEvent, playAgainEvent, assetManifest, className, }: DebuggerBoardProps): React.JSX.Element | null;
-export declare namespace DebuggerBoard {
-    var displayName: string;
-}

package/dist/components/game/2d/organisms/EventHandlerBoard.d.ts

@@ -1,42 +0,0 @@
-/**
- * EventHandlerBoard Organism
- *
- * Contains ALL game logic for the Event Handler tier (ages 9-12).
- * Kids click on world objects, set WHEN/THEN rules, and watch
- * event chains cascade during playback.
- *
- * Encourages experimentation: on failure, resets to editing so the kid
- * can try different rules. After 3 failures, shows a progressive hint.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-import type { RuleDefinition } from '../molecules/RuleEditor';
-export interface EventHandlerBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `objects` / `triggerEvents` / `goalEvent` etc. off the row; the editable
-     *  puzzle objects are themselves `EntityRow`s carried under `objects`. */
-    entity?: EntityRow | readonly EntityRow[];
-    /** Playback speed in ms per event */
-    stepDurationMs?: number;
-    /** Emits UI:{playEvent} */
-    playEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{completeEvent} with { success } */
-    completeEvent?: EventEmit<{
-        success: boolean;
-    }>;
-    /** Emits UI:{editRuleEvent} with { objectId, rules } — model updates @entity.objects */
-    editRuleEvent?: EventEmit<{
-        objectId: string;
-        rules: RuleDefinition[];
-    }>;
-    /** Emits UI:{playAgainEvent} to reset the model */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-}
-export declare function EventHandlerBoard({ entity, stepDurationMs, playEvent, completeEvent, editRuleEvent, playAgainEvent, className, }: EventHandlerBoardProps): React.JSX.Element | null;
-export declare namespace EventHandlerBoard {
-    var displayName: string;
-}
-export default EventHandlerBoard;

package/dist/components/game/2d/organisms/NegotiatorBoard.d.ts

@@ -1,56 +0,0 @@
-/**
- * NegotiatorBoard
- *
- * Turn-based decision matrix game. The player makes choices
- * over multiple rounds against an AI opponent. Each round
- * both sides pick an action, and payoffs are determined by
- * the combination.
- *
- * Good for: ethics, business, game theory, economics stories.
- *
- * Events emitted via completeEvent (default UI:PUZZLE_COMPLETE).
- */
-import React from 'react';
-import type { EventEmit, EntityRow, Asset } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** A selectable round action (UI value DTO read off the entity). */
-export interface NegotiatorAction {
-    id: string;
-    label: string;
-    description?: string;
-}
-/** A payoff-matrix cell (UI value DTO read off the entity). */
-export interface PayoffEntry {
-    playerAction: string;
-    opponentAction: string;
-    playerPayoff: number;
-    opponentPayoff: number;
-}
-export interface NegotiatorBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `score` / `round` / `result` / `targetScore` / `maxRounds` plus the
-     *  `actions` / `payoffMatrix` arrays and title/description/hint off the row.
-     *  Score accumulation + win/lose are owned by the gameplay machine. */
-    entity?: EntityRow | readonly EntityRow[];
-    completeEvent?: EventEmit<{
-        success: boolean;
-        score: number;
-    }>;
-    /** Emits UI:{playRoundEvent} with the picked action + the UI-resolved payoff. */
-    playRoundEvent?: EventEmit<{
-        playerAction: string;
-        payoff: number;
-    }>;
-    /** Emits UI:{finishEvent} with {} when all rounds are spent. */
-    finishEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{playAgainEvent} with {} on play again / reset. */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-    /** Optional per-semantic-key asset overrides for icons (correct/arrow). */
-    assetManifest?: {
-        ui?: Record<string, Asset>;
-    };
-}
-export declare function NegotiatorBoard({ entity, completeEvent, playRoundEvent, finishEvent, playAgainEvent, assetManifest, className, }: NegotiatorBoardProps): React.JSX.Element | null;
-export declare namespace NegotiatorBoard {
-    var displayName: string;
-}

package/dist/components/game/2d/organisms/SequencerBoard.d.ts

@@ -1,69 +0,0 @@
-/**
- * SequencerBoard Organism
- *
- * Contains ALL game logic for the Sequencer tier (ages 5-8).
- * Manages the action sequence, validates it, and animates Kekec
- * executing each step on the puzzle scene.
- *
- * Feedback-first UX:
- * - On failure: slots stay in place, each slot gets a green or red
- *   ring showing exactly which steps are correct and which need to change.
- * - Modifying a slot clears its individual feedback so the kid can re-try.
- * - After 3 failures a persistent hint appears above the sequence bar.
- * - "Reset" clears everything including attempts / hint.
- *
- * TraitStateViewer states use indexed labels ("1. Walk", "2. Jump") so that
- * repeated actions are correctly highlighted during playback.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-export interface SequencerBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `availableActions` / `maxSlots` / `solutions` etc. off the row.
-     *  `availableActions` carries `SlotItemData[]` (a UI drag-DTO, not entity
-     *  data — it holds a non-FieldValue `stateMachine` member). */
-    entity?: EntityRow | readonly EntityRow[];
-    /** Category → color mapping */
-    categoryColors?: Record<string, {
-        bg: string;
-        border: string;
-    }>;
-    /** Playback speed in ms per step */
-    stepDurationMs?: number;
-    /** Emits UI:{playEvent} with { sequence: string[] } */
-    playEvent?: EventEmit<{
-        sequence: string[];
-    }>;
-    /** Emits UI:{completeEvent} with { success: boolean } */
-    completeEvent?: EventEmit<{
-        success: boolean;
-        sequence: string[];
-    }>;
-    /** Emits UI:{placeEvent} with { slotIndex, actionId } when an action is dropped into a slot */
-    placeEvent?: EventEmit<{
-        slotIndex: number;
-        actionId: string;
-    }>;
-    /** Emits UI:{removeEvent} with { slotIndex } when an action is removed from a slot */
-    removeEvent?: EventEmit<{
-        slotIndex: number;
-    }>;
-    /** Emits UI:{checkEvent} with { sequence } when the player submits the sequence */
-    checkEvent?: EventEmit<{
-        sequence: string[];
-    }>;
-    /** Emits UI:{playAgainEvent} with {} on reset */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{stepEvent} with { step } during playback animation advancement */
-    stepEvent?: EventEmit<{
-        step: number;
-    }>;
-}
-export declare function SequencerBoard({ entity, categoryColors, stepDurationMs, playEvent, completeEvent, placeEvent, removeEvent, checkEvent, playAgainEvent, stepEvent, className, }: SequencerBoardProps): React.JSX.Element | null;
-export declare namespace SequencerBoard {
-    var displayName: string;
-}
-export default SequencerBoard;