@almadar/ui 5.104.0 → 5.107.0

package/dist/components/game/molecules/DrawShapeLayer.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `draw-shape-layer` — batch of shapes in one descriptor for O(layers) perf.
+ *
+ * Composes the `draw-shape` atom; drawable-by-composition (its `items` are
+ * `draw-shape` descriptors, each grounded in core `ScenePos`). The React
+ * component renders `null` (a drawable is painted by the host, not the DOM).
+ */
+import type React from 'react';
+import type { DrawableBase, PaintFn } from '../../../lib/drawable/contract';
+import { type DrawShapeProps } from '../atoms/DrawShape';
+export interface DrawShapeLayerProps extends DrawableBase {
+    type: 'draw-shape-layer';
+    items: DrawShapeProps[];
+}
+/** Paint a {@link DrawShapeLayerProps}. */
+export declare const paintShapeLayer: PaintFn<DrawShapeLayerProps>;
+/** Registry/standalone stub — the host paints this molecule; the DOM renders nothing. */
+export declare function DrawShapeLayer(_props: DrawShapeLayerProps): React.JSX.Element | null;
+export default DrawShapeLayer;

package/dist/components/game/molecules/DrawSpriteLayer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `draw-sprite-layer` — batch multiple sprites in one descriptor for O(layers) rendering.
+ *
+ * Composes the `draw-sprite` atom; the layer itself carries no `position` — each
+ * item does. It is drawable-by-composition: its `items` are `draw-sprite`
+ * descriptors (each grounded in core `ScenePos`), which is what stamps the layer
+ * `drawable` at pattern-sync time.
+ */
+import type React from 'react';
+import type { DrawableBase, PaintFn } from '../../../lib/drawable/contract';
+import { type DrawSpriteProps } from '../atoms/DrawSprite';
+export interface DrawSpriteLayerProps extends DrawableBase {
+    type: 'draw-sprite-layer';
+    /** Sprites painted in array order; z-ordering is the caller's responsibility. */
+    items: DrawSpriteProps[];
+}
+/** Paint a {@link DrawSpriteLayerProps}. Renders all sprites in order; never throws. */
+export declare const paintSpriteLayer: PaintFn<DrawSpriteLayerProps>;
+/** Registry/standalone stub — the host paints this molecule; the DOM renders nothing. */
+export declare function DrawSpriteLayer(_props: DrawSpriteLayerProps): React.JSX.Element | null;
+export default DrawSpriteLayer;

package/dist/components/game/molecules/DrawTextLayer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * `draw-text-layer` — batch of text labels in one descriptor for O(layers) perf.
+ *
+ * Composes the `draw-text` atom; drawable-by-composition (its `items` are
+ * `draw-text` descriptors, each grounded in core `ScenePos`). Covers the batched
+ * world-space text pass — fx messages, damage numbers, unit labels — that a
+ * board maps from an entity array (`items: (array/map @entity.fx (fn ...))`),
+ * which a literal `children` array can't express. The React component renders
+ * `null` (a drawable is painted by the host, not the DOM).
+ */
+import type React from 'react';
+import type { DrawableBase, PaintFn } from '../../../lib/drawable/contract';
+import { type DrawTextProps } from '../atoms/DrawText';
+export interface DrawTextLayerProps extends DrawableBase {
+    type: 'draw-text-layer';
+    items: DrawTextProps[];
+}
+/** Paint a {@link DrawTextLayerProps}. */
+export declare const paintTextLayer: PaintFn<DrawTextLayerProps>;
+/** Registry/standalone stub — the host paints this molecule; the DOM renders nothing. */
+export declare function DrawTextLayer(_props: DrawTextLayerProps): React.JSX.Element | null;
+export default DrawTextLayer;

package/dist/components/game/{2d/molecules → molecules}/GameHud.d.ts

@@ -1,7 +1,7 @@
 import * as React from "react";
 import { type StatBadgeProps } from "./StatBadge";
 import type { Asset } from "@almadar/core";
-import type { IconInput } from "../../../core/atoms/index";
+import type { IconInput } from "../../core/atoms/index";
 export interface GameHudStat extends Omit<StatBadgeProps, "size"> {
     /** Data source entity name */
     source?: string;

package/dist/components/game/{2d/molecules → molecules}/InventoryGrid.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { EventEmit, Asset } from '@almadar/core';
-import type { IconInput } from '../../../core/atoms/index';
+import type { IconInput } from '../../core/atoms/index';
 export interface InventoryGridItem {
     id: string;
     icon?: IconInput;

package/dist/components/game/{2d/molecules → molecules}/ResourceBar.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { Asset } from '@almadar/core';
-import type { IconInput } from '../../../core/atoms/index';
+import type { IconInput } from '../../core/atoms/index';
 export interface ResourceBarResource {
     /** Icon for the resource */
     icon?: IconInput;

package/dist/components/game/{2d/molecules → molecules}/StatBadge.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { type IconInput } from '../../../core/atoms/Icon';
+import { type IconInput } from '../../core/atoms/Icon';
 import type { Asset } from '@almadar/core';
 /**
  * StatBadge — game stat display molecule (distinct from core Badge atom).

package/dist/components/game/{2d/molecules → molecules}/StateNode.d.ts

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import { type Point } from '../../../core/atoms/index';
+import { type Point } from '../../core/atoms/index';
 export interface StateNodeProps {
     /** State name */
     name: string;

package/dist/components/game/{2d/molecules → molecules}/TraitSlot.d.ts

@@ -20,7 +20,7 @@
 import React from 'react';
 import type { Asset, EventEmit } from '@almadar/core';
 import { type TraitStateMachineDefinition } from './TraitStateViewer';
-import type { UiError } from '../../../core/atoms/types';
+import type { UiError } from '../../core/atoms/types';
 /** Data shape for a slot's equipped item */
 export type SlotItemData = {
     id: string;

package/dist/components/game/{2d/molecules → molecules}/TraitStateViewer.d.ts

@@ -11,7 +11,7 @@
  */
 import React from 'react';
 import { type StateStyle } from '../atoms/StateIndicator';
-import type { UiError } from '../../../core/atoms/types';
+import type { UiError } from '../../core/atoms/types';
 export type TraitTransition = {
     from: string;
     to: string;

package/dist/components/game/{2d/molecules → molecules}/TransitionArrow.d.ts

@@ -7,7 +7,7 @@
  * @packageDocumentation
  */
 import React from 'react';
-import type { Point } from '../../../core/atoms/types';
+import type { Point } from '../../core/atoms/types';
 export interface TransitionArrowProps {
     /** Start position (center of from-node) */
     from: Point;

package/dist/components/game/{2d/molecules → molecules}/index.d.ts

@@ -6,7 +6,7 @@
  *
  * @packageDocumentation
  */
-export * from '../../shared/index';
+export * from '../lib/index';
 export { GameCard, type GameCardProps } from '../atoms/GameCard';
 export { HealthBar, type HealthBarProps } from '../atoms/HealthBar';
 export { ScoreDisplay, type ScoreDisplayProps } from '../atoms/ScoreDisplay';
@@ -34,33 +34,26 @@ export { GameHud, type GameHudProps, type GameHudStat, type GameHudElement } fro
 export { GameMenu, type GameMenuProps, type MenuOption } from './GameMenu';
 export { StateGraph, type StateGraphProps, type StateGraphTransition } from './StateGraph';
 export { Canvas2D, type Canvas2DProps, type Projection, type CameraMode, type Platform, type SidePlayer, type TileCoord, } from './Canvas2D';
-export { useUnitSpriteAtlas } from '../../shared/hooks/useUnitSpriteAtlas';
-export { GameAudioProvider, GameAudioContext, useGameAudioContext, type GameAudioProviderProps, type GameAudioContextValue, } from '../../shared/providers/GameAudioProvider';
+export { Canvas, type CanvasProps, type CanvasMode } from './Canvas';
+export { useUnitSpriteAtlas } from '../hooks/useUnitSpriteAtlas';
+export { GameAudioProvider, GameAudioContext, useGameAudioContext, type GameAudioProviderProps, type GameAudioContextValue, } from '../providers/GameAudioProvider';
 export { GameAudioToggle, type GameAudioToggleProps, } from '../atoms/GameAudioToggle';
-export { useGameAudio, type AudioManifest, type SoundEntry, type GameAudioControls, type UseGameAudioOptions, } from '../../shared/hooks/useGameAudio';
-export { useCamera } from '../../shared/hooks/useCamera';
+export { useGameAudio, type AudioManifest, type SoundEntry, type GameAudioControls, type UseGameAudioOptions, } from '../hooks/useGameAudio';
+export { useCamera } from '../hooks/useCamera';
 export { TraitStateViewer, type TraitStateViewerProps, type TraitStateMachineDefinition, type TraitTransition, } from './TraitStateViewer';
 export { TraitSlot, type TraitSlotProps, type SlotItemData, } from './TraitSlot';
-export { CollapsibleSection, EditorSlider, EditorSelect, EditorCheckbox, EditorTextInput, StatusBar, TerrainPalette, EditorToolbar, TERRAIN_COLORS, FEATURE_TYPES, type EditorMode, type CollapsibleSectionProps, type EditorSliderProps, type EditorSelectProps, type EditorCheckboxProps, type EditorTextInputProps, type StatusBarProps, type TerrainPaletteProps, type EditorToolbarProps, } from '../../shared/lib/editorUtils';
+export { CollapsibleSection, EditorSlider, EditorSelect, EditorCheckbox, EditorTextInput, StatusBar, TerrainPalette, EditorToolbar, TERRAIN_COLORS, FEATURE_TYPES, type EditorMode, type CollapsibleSectionProps, type EditorSliderProps, type EditorSelectProps, type EditorCheckboxProps, type EditorTextInputProps, type StatusBarProps, type TerrainPaletteProps, type EditorToolbarProps, } from '../lib/editorUtils';
 export { ActionTile, type ActionTileProps } from './ActionTile';
 export { ActionPalette, type ActionPaletteProps } from './ActionPalette';
 export { SequenceBar, type SequenceBarProps } from './SequenceBar';
-export { SequencerBoard, type SequencerBoardProps } from '../organisms/SequencerBoard';
 export { RuleEditor, type RuleEditorProps, type RuleDefinition } from './RuleEditor';
 export { EventLog, type EventLogProps, type EventLogEntry } from './EventLog';
 export { ObjectRulePanel, type ObjectRulePanelProps } from './ObjectRulePanel';
-export { EventHandlerBoard, type EventHandlerBoardProps } from '../organisms/EventHandlerBoard';
-export * from '../../shared/lib/puzzleObject';
+export * from '../lib/puzzleObject';
 export { StateNode, type StateNodeProps } from './StateNode';
 export { TransitionArrow, type TransitionArrowProps } from './TransitionArrow';
 export { VariablePanel, type VariablePanelProps } from './VariablePanel';
 export { StateJsonView, type StateJsonViewProps } from './StateJsonView';
-export { StateArchitectBoard, type StateArchitectBoardProps, type StateArchitectTransition, type TestCase, } from '../organisms/StateArchitectBoard';
-export { SimulatorBoard, type SimulatorBoardProps, type SimulatorParameter } from '../organisms/SimulatorBoard';
-export { ClassifierBoard, type ClassifierBoardProps, type ClassifierItem, type ClassifierCategory } from '../organisms/ClassifierBoard';
-export { BuilderBoard, type BuilderBoardProps, type BuilderComponent, type BuilderSlot } from '../organisms/BuilderBoard';
-export { DebuggerBoard, type DebuggerBoardProps, type DebuggerLine } from '../organisms/DebuggerBoard';
-export { NegotiatorBoard, type NegotiatorBoardProps, type NegotiatorAction, type PayoffEntry } from '../organisms/NegotiatorBoard';
-export { projectileMotion, pendulum, springOscillator, ALL_PRESETS } from '../../shared/lib/physicsPresets';
+export { projectileMotion, pendulum, springOscillator, ALL_PRESETS } from '../lib/physicsPresets';
 export { GameTemplate, type GameTemplateProps } from '../templates/GameTemplate';
 export { GameShell, type GameShellProps } from '../templates/GameShell';

package/dist/components/game/patterns.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Curated list of the neutral DRAWABLE render-ui pattern components — the
+ * dimension-agnostic primitives a canvas draw-host paints under its `children`.
+ *
+ * These atoms/molecules are R3F-free (the 3D mesh backends live in
+ * `lib/drawable/mesh3d`, pulled in only by the code-split 3D host), so they are
+ * safe to admit to the public pattern surface. `pattern-sync` discovers
+ * `patterns.ts` files by walking the tree and admits exactly the names listed
+ * here, taking each one's tier from its source path (atoms / molecules) — so the
+ * dispatch/painter infra co-located under `lib/` never leaks in as a pattern.
+ * Move this file anywhere under `components/` and the scanner still finds it.
+ *
+ * @packageDocumentation
+ */
+export { DrawSprite } from './atoms/DrawSprite';
+export { DrawShape } from './atoms/DrawShape';
+export { DrawText } from './atoms/DrawText';
+export { DrawSpriteLayer } from './molecules/DrawSpriteLayer';
+export { DrawShapeLayer } from './molecules/DrawShapeLayer';
+export { DrawTextLayer } from './molecules/DrawTextLayer';

package/dist/components/game/{shared/providers → providers}/GameAudioProvider.d.ts

@@ -18,7 +18,7 @@
  */
 import React from 'react';
 import { type AudioManifest, type GameAudioControls } from '../hooks/useGameAudio';
-import type { UiError } from '../../../core/atoms/types';
+import type { UiError } from '../../core/atoms/types';
 export type GameAudioContextValue = Pick<GameAudioControls, 'muted' | 'setMuted' | 'masterVolume' | 'setMasterVolume' | 'play' | 'playMusic' | 'stopMusic'>;
 export declare const GameAudioContext: React.Context<GameAudioContextValue | null>;
 /**

package/dist/components/game/{2d/templates → templates}/GameTemplate.d.ts

@@ -7,7 +7,7 @@
  */
 import React from "react";
 import type { Asset } from "@almadar/core";
-import type { TemplateProps } from "../../../core/templates/types";
+import type { TemplateProps } from "../../core/templates/types";
 export interface GameControls {
     onPlay?: () => void;
     onPause?: () => void;

package/dist/components/game/three/atoms/SpriteBillboard3D.d.ts

@@ -0,0 +1,18 @@
+/**
+ * SpriteBillboard3D
+ *
+ * Billboarded sprite-sheet plane for a unit. Loads the atlas's PNG sheet as a
+ * texture and crops a SINGLE frame via UV `repeat`/`offset`, advancing per
+ * animation state. Mirrors the 2D canvas: one frame, never the whole sheet.
+ *
+ * @packageDocumentation
+ */
+import React from 'react';
+import type { ResolvedFrame } from '../../lib/spriteAnimationTypes';
+export interface SpriteBillboard3DProps {
+    sheetUrl: string;
+    resolveFrame: () => ResolvedFrame | null;
+    height?: number;
+}
+export declare function SpriteBillboard3D({ sheetUrl, resolveFrame, height, }: SpriteBillboard3DProps): React.JSX.Element | null;
+export default SpriteBillboard3D;

package/dist/components/game/three/game3dTheme.d.ts

@@ -0,0 +1,55 @@
+/**
+ * game3dTheme
+ *
+ * Single source of truth for the 3D game renderer's DEFAULT palettes + sizing.
+ * These were previously baked (and in several cases duplicated) inside
+ * `GameCanvas3D.tsx`'s inline sub-renderers. The decomposed mesh components
+ * (`TileMesh3D`, `UnitMesh3D`, `FeatureMesh3D`, `EventMarker3D`, `SideScene3D`)
+ * read these as DEFAULTS so the renderer stays "dumb": every color/size can be
+ * overridden per-item via the descriptor data (`tile.color`, `unit.tint`, …)
+ * that `.lolo` computes. No React deps — pure constants, usable anywhere.
+ *
+ * Values are the exact literals that lived inline in GameCanvas3D before the
+ * decomposition, so a board that supplies no overrides renders identically.
+ *
+ * @packageDocumentation
+ */
+/** Tile fallback color by terrain kind (DefaultTile 555–560). */
+export declare const TERRAIN_COLORS_3D: Record<string, number>;
+/** Tile emissive tint by highlight state (DefaultTile 562–566). */
+export declare const HIGHLIGHT_EMISSIVE_3D: Record<string, number>;
+/** Unit fallback color by faction/team (DefaultUnit 624). */
+export declare const FACTION_COLORS_3D: Record<string, number>;
+/** Selection ring color (DefaultUnit 644). */
+export declare const SELECTION_RING_COLOR_3D = "#ffff00";
+/** Health-bar palette + geometry (DefaultUnit 690–716). */
+export declare const HEALTHBAR_3D: {
+    bg: number;
+    /** fill color thresholds: fraction > key → color */
+    high: number;
+    mid: number;
+    low: number;
+    width: number;
+};
+/** Resolve the health-bar fill color for a health fraction (0..1). */
+export declare function healthbarFill3D(fraction: number): number;
+/** Procedural tree colors (DefaultFeature 753–760). */
+export declare const TREE_COLORS_3D: {
+    trunk: number;
+    foliage: number;
+};
+/** Procedural rock color (DefaultFeature 765). */
+export declare const ROCK_COLOR_3D = 8421504;
+/** Floating event/feedback label color by event type (EventMarker 487–498). */
+export declare const EVENT_COLORS_3D: Record<string, number>;
+/** Side-scroller platform palette (SideScene SIDE_PLATFORM_COLORS 356–362). */
+export declare const SIDE_PLATFORM_COLORS_3D: Record<string, number>;
+/** Side-scroller player fallback capsule color (SideScene 470). */
+export declare const SIDE_PLAYER_COLOR_3D = "#4488ff";
+/** Grid line colors for the drei `<Grid>` (GameCanvas3D 1245/1248). */
+export declare const GRID_COLORS_3D: {
+    cell: string;
+    section: string;
+};
+/** Default scene background (GameCanvas3DProps.backgroundColor default, line 114). */
+export declare const DEFAULT_BACKGROUND_3D = "#1a1a2e";

package/dist/components/game/{shared → three}/hooks/useGameCanvas3DEvents.d.ts

@@ -1,11 +1,12 @@
 import type { EventEmit } from '@almadar/core';
-import type { IsometricTile, IsometricUnit, IsometricFeature } from '../isometricTypes';
+import type { IsometricTile, IsometricUnit, IsometricFeature } from '../../lib/isometricTypes';
 export interface GameCanvas3DEventConfig {
-    /** Event name for tile clicks */
+    /** Event name for tile clicks. `tileId` is optional — the neutral draw-host emits
+     *  only the scene coordinate `{ x, z }` (the FSM keys off the cell, not an id). */
     tileClickEvent?: EventEmit<{
-        tileId: string;
         x: number;
         z: number;
+        tileId?: string;
         type?: string;
         terrain?: string;
         elevation?: number;