@almadar/ui 5.85.0 → 5.86.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@almadar/ui",
-  "version": "5.85.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/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/shared/canvasEffects.d.ts

@@ -1,50 +0,0 @@
-/**
- * Canvas Effect Engine
- *
- * Pure functions for spawning, updating, and drawing canvas effects.
- * No React dependencies — called from the RAF loop via useCanvasEffects hook.
- *
- * Ported from trait-wars and generalized for any almadar-ui client.
- */
-import type { CanvasParticle, CanvasSequence, CanvasOverlay, CanvasEffectState, ParticleEmitterConfig, SequenceConfig, OverlayConfig } from './effects';
-/**
- * Draw a sprite tinted with an RGB color onto the main canvas.
- * Uses offscreen canvas with `source-atop` compositing to recolor
- * white-on-transparent sprites.
- */
-export declare function drawTintedImage(ctx: CanvasRenderingContext2D, img: HTMLImageElement | ImageBitmap, x: number, y: number, w: number, h: number, tint: {
-    r: number;
-    g: number;
-    b: number;
-}, alpha: number, blendMode?: GlobalCompositeOperation): void;
-/**
- * Spawn a burst of particles from an emitter config.
- */
-export declare function spawnParticles(config: ParticleEmitterConfig, animTime: number): CanvasParticle[];
-/**
- * Spawn a frame sequence animation.
- */
-export declare function spawnSequence(config: SequenceConfig, animTime: number): CanvasSequence;
-/**
- * Spawn an overlay effect.
- */
-export declare function spawnOverlay(config: OverlayConfig, animTime: number): CanvasOverlay;
-/**
- * Advance effect state by one frame. Returns new state with expired effects removed.
- */
-export declare function updateEffectState(state: CanvasEffectState, animTime: number, deltaMs: number): CanvasEffectState;
-type GetImageFn = (url: string) => HTMLImageElement | undefined;
-/**
- * Draw all active effects onto the canvas.
- */
-export declare function drawEffectState(ctx: CanvasRenderingContext2D, state: CanvasEffectState, animTime: number, getImage: GetImageFn): void;
-export declare function hasActiveEffects(state: CanvasEffectState): boolean;
-/**
- * Collect all sprite URLs from an EffectAssetManifest for preloading.
- */
-export declare function getAllEffectSpriteUrls(manifest: {
-    baseUrl: string;
-    particles?: Record<string, string[] | string | undefined>;
-    animations?: Record<string, string[] | undefined>;
-}): string[];
-export {};

package/dist/components/game/shared/combatPresets.d.ts

@@ -1,15 +0,0 @@
-/**
- * Combat Presets
- *
- * Maps combat actions to composed effect layers (particles + sequences + overlays).
- * Each preset factory takes a screen-space origin and returns a CombatPreset.
- *
- * Generalized from trait-wars: uses EffectAssetManifest instead of TraitWarsAssetManifest.
- */
-import type { CombatActionType, CombatPreset, EffectAssetManifest } from './effects';
-type PresetFactory = (originX: number, originY: number) => CombatPreset;
-/**
- * Create combat preset factories from an effect asset manifest.
- */
-export declare function createCombatPresets(manifest: EffectAssetManifest): Record<CombatActionType, PresetFactory>;
-export {};

package/dist/components/game/shared/hooks/useCanvasEffects.d.ts

@@ -1,27 +0,0 @@
-import type { AssetUrl } from '@almadar/core';
-import type { CombatActionType, EffectAssetManifest } from '../effects';
-export interface UseCanvasEffectsOptions {
-    /** Effect asset manifest (baseUrl + particles + animations) */
-    manifest: EffectAssetManifest;
-}
-export interface UseCanvasEffectsResult {
-    /** All effect sprite URLs for preloading via useImageCache */
-    effectSpriteUrls: AssetUrl[];
-    /** Spawn a combat effect at the given screen position */
-    spawnEffect: (type: CombatActionType, screenX: number, screenY: number) => void;
-    /** Draw all active effects — call inside draw() after units, before ctx.restore() */
-    drawEffects: (ctx: CanvasRenderingContext2D, animTime: number, getImage: (url: string) => HTMLImageElement | undefined) => void;
-    /** Whether there are active effects (keeps RAF alive) */
-    hasActiveEffects: boolean;
-    /** Screen shake offset to apply to container transform */
-    screenShake: {
-        x: number;
-        y: number;
-    };
-    /** Screen flash overlay (null = no flash) */
-    screenFlash: {
-        color: string;
-        alpha: number;
-    } | null;
-}
-export declare function useCanvasEffects({ manifest, }: UseCanvasEffectsOptions): UseCanvasEffectsResult;