@almadar/ui 5.84.0 → 5.86.0

package/package.json

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

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/CanvasEffect.d.ts

@@ -1,70 +0,0 @@
-/**
- * CanvasEffect Component
- *
- * Renders animated visual effects using a `<canvas>` element with
- * sprite-based particles, frame-sequence animations, and overlays.
- * This is a render-ui pattern that can be placed in any slot —
- * it renders on top of whatever occupies that slot.
- *
- * Pattern: canvas-effect
- *
- * When an EffectAssetManifest is provided (via assetManifest prop),
- * the component uses the full particle engine with tinted sprites.
- * Without a manifest, it falls back to emoji-based rendering.
- *
- * **State categories (closed-circuit compliant):**
- * - Configuration (actionType, position, duration, manifest) → received via props
- * - Animation state (particles, shake, flash, RAF loop, phase timers) → local only
- * - Completion event → emitted via `useEventBus()` for trait integration
- *
- * This is an **ephemeral fire-and-forget** animation component.  All
- * internal state is rendering-only (particle physics, screen shake decay,
- * flash alpha, emoji phase timers).  No game logic lives here.
- *
- * @packageDocumentation
- */
-import * as React from 'react';
-import type { AssetUrl, EventEmit } from '@almadar/core';
-import type { CombatActionType, EffectAssetManifest } from '../../shared/effects';
-import type { UiError } from '../../../core/atoms/types';
-export type { CombatActionType } from '../../shared/effects';
-export type { EffectAssetManifest } from '../../shared/effects';
-export interface CanvasEffectProps {
-    /** The type of combat action to visualise */
-    actionType: CombatActionType;
-    /** Screen-space X position (center of the effect) */
-    x: number;
-    /** Screen-space Y position (center of the effect) */
-    y: number;
-    /** Duration in ms before auto-dismiss (default 2000 for canvas, 800 for emoji) */
-    duration?: number;
-    /** Optional intensity multiplier (1 = normal, 2 = double size/brightness) */
-    intensity?: number;
-    /** Callback when the effect animation completes */
-    onComplete?: () => void;
-    /** Declarative event: emits UI:{completeEvent} when the effect animation completes */
-    completeEvent?: EventEmit<Record<string, never>>;
-    /** Additional CSS classes */
-    className?: string;
-    /** Loading state indicator */
-    isLoading?: boolean;
-    /** Error state */
-    error?: UiError | null;
-    /** Sprite URL for the effect (emoji fallback mode).
-     *  When set without assetManifest, renders this image instead of emoji. */
-    effectSpriteUrl?: AssetUrl;
-    /** Base URL for remote assets. Prepended to relative effectSpriteUrl paths. */
-    assetBaseUrl?: AssetUrl;
-    /** Full effect asset manifest for the sprite particle engine.
-     *  When provided, enables the canvas-based particle system. */
-    assetManifest?: EffectAssetManifest;
-    /** Canvas width (default 400) */
-    width?: number;
-    /** Canvas height (default 300) */
-    height?: number;
-}
-export declare function CanvasEffect({ effectSpriteUrl, assetBaseUrl, ...props }: CanvasEffectProps): React.JSX.Element | null;
-export declare namespace CanvasEffect {
-    var displayName: string;
-}
-export default CanvasEffect;

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

@@ -1,45 +0,0 @@
-import React from 'react';
-import type { Asset, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** Manifest of per-card sprite map (UI value DTO). */
-type CardBattlerAssetManifest = {
-    cards?: Record<string, Asset>;
-};
-/** One card as carried on the entity / passed as a prop. */
-export interface CardBattlerCard {
-    id: string;
-    iconKey?: string;
-    title?: string;
-    cost?: number;
-    attack?: number;
-    defense?: number;
-}
-export interface CardBattlerBoardProps extends DisplayStateProps {
-    entity?: EntityRow | readonly EntityRow[];
-    /** Cards remaining in the draw deck (count-only view). */
-    deck?: CardBattlerCard[];
-    /** Cards currently in the player's hand. */
-    hand?: CardBattlerCard[];
-    /** Cards played onto the board this match. */
-    board?: CardBattlerCard[];
-    mana?: number;
-    maxMana?: number;
-    turn?: number;
-    result?: 'none' | 'won' | 'lost';
-    /** Base-url + per-iconKey card sprite map (organism owns asset choice). */
-    assetManifest?: CardBattlerAssetManifest;
-    playCardEvent?: EventEmit<{
-        cardId: string;
-    }>;
-    endTurnEvent?: EventEmit<Record<string, never>>;
-    playAgainEvent?: EventEmit<Record<string, never>>;
-    gameEndEvent?: EventEmit<{
-        result: 'won' | 'lost';
-    }>;
-    className?: string;
-}
-export declare function CardBattlerBoard({ entity, deck: propDeck, hand: propHand, board: propBoard, mana: propMana, maxMana: propMaxMana, turn: propTurn, result: propResult, assetManifest: propAssetManifest, playCardEvent, endTurnEvent, playAgainEvent, gameEndEvent, className, }: CardBattlerBoardProps): React.JSX.Element;
-export declare namespace CardBattlerBoard {
-    var displayName: string;
-}
-export default CardBattlerBoard;

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 './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;

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

@@ -1,58 +0,0 @@
-/**
- * SimulatorBoard
- *
- * Parameter-slider game board. The player adjusts two parameters (A and B)
- * and observes the machine-derived output. Correct parameter values must
- * bring the output within tolerance of the target to win.
- *
- * Good for: physics, economics, system design stories.
- *
- * Controlled-only: params, output, attempts, and result are owned by the
- * gameplay machine and read off the bound entity. Slider/check/play-again
- * interactions are emitted as events; the machine recomputes and re-renders.
- */
-import React from 'react';
-import type { EventEmit, EntityRow, Asset } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** A tunable simulation parameter slider descriptor (UI value DTO read off the entity). */
-export interface SimulatorParameter {
-    id: string;
-    label: string;
-    unit: string;
-    min: number;
-    max: number;
-    step: number;
-    initial: number;
-    correct: number;
-    tolerance: number;
-}
-export interface SimulatorBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads the
-     *  `parameters` slider descriptors plus the machine-owned `paramA`/`paramB`/
-     *  `output`/`target`/`tolerance`/`attempts`/`result` fields off the row. */
-    entity?: EntityRow | readonly EntityRow[];
-    completeEvent?: EventEmit<{
-        success: boolean;
-        attempts: number;
-    }>;
-    /** Emits UI:{setAEvent} with { value } when parameter A's slider changes. */
-    setAEvent?: EventEmit<{
-        value: number;
-    }>;
-    /** Emits UI:{setBEvent} with { value } when parameter B's slider changes. */
-    setBEvent?: EventEmit<{
-        value: number;
-    }>;
-    /** Emits UI:{checkEvent} with {} on simulate / check. */
-    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/play/reset). */
-    assetManifest?: {
-        ui?: Record<string, Asset>;
-    };
-}
-export declare function SimulatorBoard({ entity, completeEvent, setAEvent, setBEvent, checkEvent, playAgainEvent, assetManifest, className, }: SimulatorBoardProps): React.JSX.Element | null;
-export declare namespace SimulatorBoard {
-    var displayName: string;
-}

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

@@ -1,61 +0,0 @@
-/**
- * StateArchitectBoard Organism
- *
- * Contains ALL game logic for the State Architect tier (ages 13+).
- * Kids design state machines via a visual graph editor, then run
- * them to see if the behavior matches the puzzle goal.
- *
- * @packageDocumentation
- */
-import React from 'react';
-import type { EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** A kid-built transition in the visual graph editor (UI value DTO). */
-export interface StateArchitectTransition {
-    id: string;
-    from: string;
-    to: string;
-    event: string;
-    guardHint?: string;
-}
-/** A puzzle test case (UI value DTO). */
-export interface TestCase {
-    /** Sequence of events to fire */
-    events: string[];
-    /** Expected final state */
-    expectedState: string;
-    /** Description */
-    label: string;
-}
-export interface StateArchitectBoardProps extends DisplayStateProps {
-    /** Puzzle board-state entity (single row or array). The board reads
-     *  `variables` / `states` / `transitions` / `testCases` etc. off the row. */
-    entity?: EntityRow | readonly EntityRow[];
-    /** Playback speed */
-    stepDurationMs?: number;
-    /** Emits UI:{testEvent} */
-    testEvent?: EventEmit<Record<string, never>>;
-    /** Emits UI:{completeEvent} with { success, passedTests } */
-    completeEvent?: EventEmit<{
-        success: boolean;
-        passedTests: number;
-    }>;
-    /** Emits UI:{addTransitionEvent} — lolo handles ADD_TRANSITION */
-    addTransitionEvent?: EventEmit<{
-        id: string;
-        from: string;
-        to: string;
-        event: string;
-    }>;
-    /** Emits UI:{removeTransitionEvent} — lolo handles REMOVE_TRANSITION */
-    removeTransitionEvent?: EventEmit<{
-        id: string;
-    }>;
-    /** Emits UI:{playAgainEvent} — lolo handles PLAY_AGAIN */
-    playAgainEvent?: EventEmit<Record<string, never>>;
-}
-export declare function StateArchitectBoard({ entity, stepDurationMs, testEvent, completeEvent, addTransitionEvent, removeTransitionEvent, playAgainEvent, className, }: StateArchitectBoardProps): React.JSX.Element | null;
-export declare namespace StateArchitectBoard {
-    var displayName: string;
-}
-export default StateArchitectBoard;

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

@@ -1,44 +0,0 @@
-import React from 'react';
-import type { Asset, EventEmit, EntityRow } from '@almadar/core';
-import type { DisplayStateProps } from '../../../core/organisms/types';
-/** Manifest of per-key scene + portrait maps (UI value DTO). */
-type VisualNovelAssetManifest = {
-    backgrounds?: Record<string, Asset>;
-    portraits?: Record<string, Asset>;
-};
-export interface VisualNovelChoice {
-    label: string;
-    nextId: string;
-}
-export interface VisualNovelNode {
-    id: string;
-    speaker: string;
-    text: string;
-    backgroundKey?: string;
-    portraitKey?: string;
-    choices?: VisualNovelChoice[];
-}
-export interface VisualNovelBoardProps extends DisplayStateProps {
-    entity?: EntityRow | readonly EntityRow[];
-    /** Full dialogue graph. */
-    nodes?: VisualNovelNode[];
-    /** Id of the node currently displayed. */
-    currentNodeId?: string;
-    /** Asset base-url + scene/portrait sprite maps (organism owns asset choice). */
-    assetManifest?: VisualNovelAssetManifest;
-    /** Typewriter speed in ms per character (0 = instant). */
-    typewriterSpeed?: number;
-    /** Portrait draw-size multiplier. */
-    portraitScale?: number;
-    chooseEvent?: EventEmit<{
-        choiceIndex: number;
-    }>;
-    advanceEvent?: EventEmit<Record<string, never>>;
-    restartEvent?: EventEmit<Record<string, never>>;
-    className?: string;
-}
-export declare function VisualNovelBoard({ entity, nodes: propNodes, currentNodeId: propCurrentNodeId, assetManifest: propAssetManifest, typewriterSpeed, portraitScale, chooseEvent, advanceEvent, restartEvent, className, }: VisualNovelBoardProps): React.JSX.Element;
-export declare namespace VisualNovelBoard {
-    var displayName: string;
-}
-export default VisualNovelBoard;