@almadar/ui 5.85.0 → 5.87.0

package/package.json

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

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