@almadar/ui 5.111.0 → 5.113.0

package/dist/lib/isometric.d.ts

@@ -1,121 +0,0 @@
-/**
- * Isometric Coordinate Utilities
- *
- * Pure functions for 2:1 diamond isometric coordinate conversion.
- * No React dependencies — usable in any context.
- *
- * @packageDocumentation
- */
-/** Base tile width in pixels (before scale) */
-export declare const TILE_WIDTH = 256;
-/** Base tile height in pixels (before scale) — full sprite image height (Kenney 256×512) */
-export declare const TILE_HEIGHT = 512;
-/** Floor diamond height — the "walkable surface" portion of the tile (TILE_WIDTH / 2 for 2:1 ratio) */
-export declare const FLOOR_HEIGHT = 128;
-/**
- * Measured Y offset from sprite top to the diamond top vertex within a Kenney
- * 256×512 tile sprite.  The code previously assumed `TILE_HEIGHT - FLOOR_HEIGHT = 384`,
- * but the actual diamond (dirt_E.png) begins at y = 374 because the 3D side walls
- * occupy 10 extra pixels above the pure 128 px diamond.
- *
- * Use `DIAMOND_TOP_Y * scale` for highlight positioning, unit groundY, feature
- * placement, and hit-testing — NOT `(TILE_HEIGHT - FLOOR_HEIGHT) * scale`.
- * `FLOOR_HEIGHT` remains 128 for the isoToScreen spacing formula (2:1 ratio).
- */
-export declare const DIAMOND_TOP_Y = 374;
-/**
- * Feature type → fallback color mapping (when sprites not loaded).
- */
-export declare const FEATURE_COLORS: Record<string, string>;
-/** Tile fallback color by terrain (Canvas2D 973–975 / 983–985). */
-export declare const TERRAIN_COLORS: Record<string, string>;
-/** Unit fallback + movement-ghost color by team (Canvas2D 1155–1156 / 1220–1221). */
-export declare const TEAM_COLORS: Record<string, string>;
-/** Unit drop-shadow color by team (Canvas2D 1188 / 1212). */
-export declare const TEAM_SHADOW_COLORS: Record<string, string>;
-/** Cell highlight fill by intent (Canvas2D 1016 / 1019–1020). */
-export declare const HIGHLIGHT_COLORS: {
-    hover: string;
-    validMove: string;
-    attack: string;
-};
-/** Selection ring stroke (Canvas2D 1168). */
-export declare const SELECTION_RING_COLOR = "rgba(0,200,255,0.8)";
-/** Tile grid stroke (Canvas2D 977 / 993). */
-export declare const GRID_STROKE_COLOR = "rgba(0,0,0,0.2)";
-/** Solid background fallback (Canvas2D 929). */
-export declare const BACKGROUND_FALLBACK_COLOR = "#1a1a2e";
-/** Minimap tile color by terrain (Canvas2D 873). */
-export declare const MINIMAP_TERRAIN_COLORS: Record<string, string>;
-/** Minimap unit color by team (Canvas2D 882). */
-export declare const MINIMAP_UNIT_COLORS: Record<string, string>;
-/** Unit DOM name-label background by team (Canvas2D 1609). */
-export declare const UNIT_LABEL_BG_COLORS: Record<string, string>;
-/** Side-scroller palette (Canvas2D SideView 229–259). */
-export declare const SIDE_PLATFORM_COLORS: Record<string, string>;
-export declare const SIDE_PLAYER_COLOR = "#3498db";
-export declare const SIDE_PLAYER_EYE_COLOR = "#ffffff";
-export declare const SIDE_SKY_GRADIENT_TOP = "#1a1a2e";
-export declare const SIDE_SKY_GRADIENT_BOTTOM = "#16213e";
-export declare const SIDE_GRID_COLOR = "rgba(255, 255, 255, 0.03)";
-export declare const SIDE_FX_COLOR = "#ffe066";
-export declare const SIDE_PLATFORM_BEVEL_COLOR = "rgba(255,255,255,0.15)";
-export declare const SIDE_PLATFORM_SHADOW_COLOR = "rgba(0,0,0,0.3)";
-export declare const SIDE_HAZARD_STRIPE_COLOR = "#e74c3c";
-export declare const SIDE_GOAL_GLOW_COLOR = "rgba(241, 196, 15, 0.5)";
-/** Default grid-path board background (Canvas2D bgColor default 634). */
-export declare const DEFAULT_BG_COLOR = "#5c94fc";
-/**
- * Tile layout mode. 'isometric' = 2:1 diamond projection (default).
- * 'hex' = pointy-top offset-row hex grid.
- * 'flat' = orthographic top-down square grid (sokoban/tanks/sports/etc.).
- *
- * Hex constants (at scale=1):
- *   w = TILE_WIDTH (256)   — horizontal cell width
- *   h = FLOOR_HEIGHT (128) — vertical row stride (= w/2; hex row-to-row = h*0.75 = 96)
- * Forward:  screenX = col*w + (row&1)*(w/2) + baseOffsetX
- *           screenY = row * (h * 0.75)
- * Inverse: row = round(screenY / (h*0.75)); col = round((screenX - (row&1)*(w/2) - baseOffsetX) / w)
- *
- * Flat constants (at scale=1):
- *   cellW = TILE_WIDTH (256) — horizontal cell pitch
- *   cellH = FLOOR_HEIGHT (128) — vertical cell pitch (= cellW/2; keeps same visual scale as hex rows)
- * Forward:  screenX = col*cellW + baseOffsetX
- *           screenY = row * cellH
- * Inverse:  col = round((screenX - baseOffsetX) / cellW); row = round(screenY / cellH)
- */
-export type TileLayout = 'isometric' | 'hex' | 'flat';
-/**
- * Convert tile grid coordinates to screen pixel coordinates.
- *
- * For 'isometric' (default): 2:1 diamond projection.
- * For 'hex': pointy-top offset-row projection (odd rows shifted right by w/2).
- * For 'flat': orthographic top-down square grid; col maps to X, row maps to Y.
- *
- * @param tileX - Grid X (col) coordinate
- * @param tileY - Grid Y (row) coordinate
- * @param scale - Render scale factor
- * @param baseOffsetX - Horizontal offset to center the grid
- * @param layout - Tile layout mode (default: 'isometric')
- * @returns Screen position { x, y } of the tile's top-left corner
- */
-export declare function isoToScreen(tileX: number, tileY: number, scale: number, baseOffsetX: number, layout?: TileLayout): {
-    x: number;
-    y: number;
-};
-/**
- * Convert screen pixel coordinates back to tile grid coordinates.
- *
- * Inverse of isoToScreen. Snaps to nearest integer tile position.
- *
- * @param screenX - Screen X in pixels
- * @param screenY - Screen Y in pixels
- * @param scale - Render scale factor
- * @param baseOffsetX - Horizontal offset used in isoToScreen
- * @param layout - Tile layout mode (default: 'isometric')
- * @returns Snapped grid position { x, y }
- */
-export declare function screenToIso(screenX: number, screenY: number, scale: number, baseOffsetX: number, layout?: TileLayout): {
-    x: number;
-    y: number;
-};

package/dist/lib/isometricTypes.d.ts

@@ -1,141 +0,0 @@
-import type { Asset } from '@almadar/core';
-import type { AnimationName } from './spriteAnimationTypes';
-import type { UnitTrait } from './game';
-/**
- * Isometric Game Types
- *
- * Type definitions for isometric grid rendering: tiles, units, features.
- * Used by IsometricCanvas and game hooks.
- *
- * @packageDocumentation
- */
-/** An active visual effect on the board. x,y are grid tile coords; ttl = remaining ticks. */
-export interface ActiveEffect {
-    /** Unique key — matched against assetManifest.effects for sprite lookup */
-    key: string;
-    /** Grid x coordinate */
-    x: number;
-    /** Grid y coordinate */
-    y: number;
-    /** Remaining ticks — used as a fade/scale hint (alpha = min(1, ttl/4)) */
-    ttl: number;
-}
-/** A single isometric tile on the grid */
-export interface IsometricTile {
-    /** Optional unique identifier (required for 3D rendering) */
-    id?: string;
-    /** Grid x coordinate */
-    x: number;
-    /** Grid y coordinate (2D) */
-    y: number;
-    /** Grid z coordinate (3D alternative to y) */
-    z?: number;
-    /** Terrain type key (e.g., 'grass', 'stone', 'water') - 2D */
-    terrain?: string;
-    /** Tile type for visual rendering (3D) */
-    type?: string;
-    /** Direct sprite URL override (bypasses getTerrainSprite resolver) */
-    terrainSprite?: Asset;
-    /** Fallback/override fill color (2D + 3D) — bypasses the terrain color map. `.lolo`-computed. */
-    color?: string;
-    /** Whether units can traverse this tile (default true) */
-    passable?: boolean;
-    /** Movement cost for pathfinding (default 1) */
-    movementCost?: number;
-    /** Optional tile type for visual variants */
-    tileType?: string;
-    /** Elevation offset for 3D rendering */
-    elevation?: number;
-    /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
-    modelUrl?: Asset;
-    /** Y-axis rotation in degrees (3D) — orients directional pieces (track corners, road bends) */
-    rotation?: number;
-}
-/** A unit positioned on the isometric grid */
-export type IsometricUnit = {
-    /** Unique unit identifier */
-    id: string;
-    /** Current grid position (2D format) */
-    position?: {
-        x: number;
-        y: number;
-    };
-    /** Grid x coordinate (3D format) */
-    x?: number;
-    /** Grid y coordinate (3D format) */
-    y?: number;
-    /** Grid z coordinate (3D format) */
-    z?: number;
-    /** Static sprite URL (used when no sprite sheet animation) */
-    sprite?: Asset;
-    /** Sprite-sheet atlas JSON URL (e.g. `.../guardian-sprite-sheet.json`).
-     *  When set, the canvas loads the atlas and crops/animates a single frame
-     *  by animation state instead of drawing the whole sheet. */
-    spriteSheet?: Asset;
-    /** 3D model URL (GLB format) for GameCanvas3D — rendered via ModelLoader with box fallback */
-    modelUrl?: Asset;
-    /** Unit archetype key for sprite resolution */
-    unitType?: string;
-    /** Hero identifier for sprite sheet lookup */
-    heroId?: string;
-    /** Display name rendered below the unit */
-    name?: string;
-    /** Team affiliation for coloring */
-    team?: 'player' | 'enemy' | 'neutral';
-    /** Faction for 3D rendering (player/enemy/neutral) */
-    faction?: 'player' | 'enemy' | 'neutral';
-    /** Fallback/override tint color (2D + 3D) — bypasses the team/faction color map. `.lolo`-computed. */
-    tint?: string;
-    /** Current health */
-    health?: number;
-    /** Maximum health */
-    maxHealth?: number;
-    /** Trait attachments for state display */
-    traits?: UnitTrait[];
-    /** Previous position for movement trail ghost */
-    previousPosition?: {
-        x: number;
-        y: number;
-    };
-    /** Elevation offset for 3D rendering */
-    elevation?: number;
-    /** Animation name — driven by the LOLO state machine; renderer defaults to 'idle' */
-    animation?: AnimationName;
-    /** Frame index within the animation — driven by the LOLO state machine; renderer defaults to 0 */
-    frame?: number;
-    /** Y-axis heading in radians (3D) — travel/facing direction. Orients the unit model and
-     *  drives the `chase` camera (behind + above, looking along heading). Driving boards set this. */
-    heading?: number;
-};
-/** A map feature (resource, building, portal, etc.) */
-export type IsometricFeature = {
-    /** Optional unique identifier (required for 3D rendering) */
-    id?: string;
-    /** Grid x coordinate */
-    x: number;
-    /** Grid y coordinate (2D) */
-    y: number;
-    /** Grid z coordinate (3D alternative to y) */
-    z?: number;
-    /** Feature type key (e.g., 'goldMine', 'castle', 'portal') */
-    type: string;
-    /** Direct sprite URL override (bypasses getFeatureSprite resolver) */
-    sprite?: Asset;
-    /** 3D model URL (GLB format) for GameCanvas3D */
-    assetUrl?: Asset;
-    /** Color override for 3D rendering */
-    color?: string;
-    /** Elevation offset for 3D rendering */
-    elevation?: number;
-    /** Y-axis rotation in radians (3D) — orients directional features (arches, signs, docks). */
-    rotation?: number;
-};
-/** Camera state for pan/zoom */
-export interface CameraState {
-    /** Camera X offset in pixels */
-    x: number;
-    /** Camera Y offset in pixels */
-    y: number;
-    /** Zoom level (1.0 = 100%) */
-    zoom: number;
-}

package/dist/lib/jazari/index.d.ts

@@ -1,5 +0,0 @@
-export { computeJazariLayout } from './layout.js';
-export type { LayoutState, LayoutTransition, LayoutInput } from './layout.js';
-export { gearTeethPath, lockIconPath, brainIconPath, pipeIconPath, eightPointedStarPath, arrowheadPath, } from './svg-paths.js';
-export type { JazariLayout, JazariGearLayout, JazariArmLayout, JazariGuardInfo, JazariEffectInfo, } from './types.js';
-export { JAZARI_COLORS } from './types.js';

package/dist/lib/jazari/layout.d.ts

@@ -1,31 +0,0 @@
-/**
- * Layout algorithm for the Al-Jazari state machine visualization.
- * Pure TypeScript — zero React/DOM dependencies.
- *
- * 1. BFS from initial state to order states by graph distance.
- * 2. Horizontal distribution of gears along the golden axis.
- * 3. Transition arm routing: forward arcs above, backward arcs below, self-loops above.
- * 4. Guard icons at 30% along arm, effect icons at 70%.
- */
-import type { FieldValue } from '@almadar/core';
-import type { JazariLayout } from './types.js';
-export interface LayoutState {
-    name: string;
-    isInitial?: boolean;
-    isTerminal?: boolean;
-    isFinal?: boolean;
-}
-export interface LayoutTransition {
-    from: string;
-    to: string;
-    event: string;
-    guard?: FieldValue;
-    effects?: FieldValue[];
-}
-export interface LayoutInput {
-    states: LayoutState[];
-    transitions: LayoutTransition[];
-    entityFields?: string[];
-    direction?: 'ltr' | 'rtl';
-}
-export declare function computeJazariLayout(input: LayoutInput): JazariLayout;

package/dist/lib/jazari/svg-paths.d.ts

@@ -1,61 +0,0 @@
-/**
- * SVG path generators for the Al-Jazari state machine visualization.
- * Pure TypeScript — zero React/DOM dependencies.
- *
- * Generates paths for gear teeth, arabesque borders, pipe shapes, and lock icons.
- */
-/**
- * Generate an SVG path for gear teeth around a circle.
- *
- * @param cx - Center X
- * @param cy - Center Y
- * @param innerRadius - Inner radius (base circle)
- * @param outerRadius - Outer radius (tip of teeth)
- * @param numTeeth - Number of teeth around the gear
- * @returns SVG path d attribute string
- */
-export declare function gearTeethPath(cx: number, cy: number, innerRadius: number, outerRadius: number, numTeeth: number): string;
-/**
- * Generate an SVG path for a small gear-shaped lock icon.
- *
- * @param cx - Center X
- * @param cy - Center Y
- * @param size - Overall size of the lock icon
- * @returns SVG path d attribute for the lock body + shackle
- */
-export declare function lockIconPath(cx: number, cy: number, size: number): string;
-/**
- * Generate a simple brain-like icon path.
- *
- * @param cx - Center X
- * @param cy - Center Y
- * @param size - Overall size
- * @returns SVG path d attribute
- */
-export declare function brainIconPath(cx: number, cy: number, size: number): string;
-/**
- * Generate a simple pipe/tube icon path.
- *
- * @param cx - Center X
- * @param cy - Center Y
- * @param size - Overall size
- * @returns SVG path d attribute
- */
-export declare function pipeIconPath(cx: number, cy: number, size: number): string;
-/**
- * Generate a single 8-pointed star path for the arabesque border pattern.
- *
- * @param cx - Center X
- * @param cy - Center Y
- * @param outerR - Outer radius (star tips)
- * @param innerR - Inner radius (star valleys)
- * @returns SVG path d attribute
- */
-export declare function eightPointedStarPath(cx: number, cy: number, outerR: number, innerR: number): string;
-/**
- * Generate a simple arrowhead path for transition arm endpoints.
- *
- * @param size - Arrow size
- * @returns SVG path d attribute
- */
-export declare function arrowheadPath(size: number): string;

package/dist/lib/jazari/types.d.ts

@@ -1,91 +0,0 @@
-/**
- * Shared types for the Al-Jazari state machine visualization.
- * Pure TypeScript — zero React/DOM dependencies.
- */
-/** Layout for a single gear (state node) */
-export interface JazariGearLayout {
-    /** State name */
-    name: string;
-    /** Center X coordinate */
-    cx: number;
-    /** Center Y coordinate */
-    cy: number;
-    /** Gear outer radius */
-    radius: number;
-    /** Whether this is the initial state */
-    isInitial: boolean;
-    /** Whether this is a terminal state */
-    isTerminal: boolean;
-}
-/** Guard info attached to an arm */
-export interface JazariGuardInfo {
-    /** Position X along the arm (30% point) */
-    x: number;
-    /** Position Y along the arm (30% point) */
-    y: number;
-    /** Whether this is an AI guard (call-service) vs deterministic */
-    isAI: boolean;
-}
-/** Effect info attached to an arm */
-export interface JazariEffectInfo {
-    /** Position X along the arm (70% point) */
-    x: number;
-    /** Position Y along the arm (70% point) */
-    y: number;
-    /** Number of effects */
-    count: number;
-    /** Effect labels for tooltip display */
-    names: string[];
-}
-/** Layout for a single transition arm */
-export interface JazariArmLayout {
-    /** Source state name */
-    from: string;
-    /** Target state name */
-    to: string;
-    /** Event name label */
-    event: string;
-    /** SVG path d attribute for the arm curve */
-    path: string;
-    /** Label position X (midpoint of arm) */
-    labelX: number;
-    /** Label position Y (midpoint of arm) */
-    labelY: number;
-    /** Guard info if transition has guards */
-    guard: JazariGuardInfo | null;
-    /** Effect info if transition has effects */
-    effect: JazariEffectInfo | null;
-    /** Whether this is a self-loop */
-    isSelfLoop: boolean;
-}
-/** Complete layout result for an entire state machine diagram */
-export interface JazariLayout {
-    /** Total SVG width */
-    width: number;
-    /** Total SVG height */
-    height: number;
-    /** All gear positions */
-    gears: JazariGearLayout[];
-    /** All transition arm paths */
-    arms: JazariArmLayout[];
-    /** Golden axis Y position */
-    axisY: number;
-    /** Golden axis start X */
-    axisStartX: number;
-    /** Golden axis end X */
-    axisEndX: number;
-    /** Entity field labels to display on the axis */
-    entityFields: string[];
-    /** Text direction */
-    direction: 'ltr' | 'rtl';
-}
-/** Al-Jazari color palette constants */
-export declare const JAZARI_COLORS: {
-    readonly brass: "#B87333";
-    readonly gold: "#C8A951";
-    readonly sky: "#0EA5E9";
-    readonly crimson: "#DC2626";
-    readonly lapis: "#1E40AF";
-    readonly ivory: "#FFFBEB";
-    readonly darkBg: "#1a1a2e";
-};

package/dist/lib/makeAsset.d.ts

@@ -1,5 +0,0 @@
-import type { Asset, EntityRole } from '@almadar/core';
-/** Build an Asset from a url + the slot's role. Slot-fixed defaults by role. */
-export declare function makeAsset(url: string, role: EntityRole, overrides?: Partial<Asset>): Asset;
-/** Map a name→url record to name→Asset. */
-export declare function makeAssetMap(record: Record<string, string>, role: EntityRole, overrides?: Partial<Asset>): Record<string, Asset>;

package/dist/lib/mechanics.d.ts

@@ -1,4 +0,0 @@
-import type { PhysicsPreset } from './physicsTypes';
-export declare const projectileMotion: PhysicsPreset;
-export declare const pendulum: PhysicsPreset;
-export declare const springOscillator: PhysicsPreset;