@almadar/ui 5.105.0 → 5.108.0

package/dist/lib/drawable/three/mesh3d.d.ts

@@ -0,0 +1,28 @@
+/**
+ * R3F mesh backends for the neutral drawable atoms — the 3D twin of the atoms'
+ * 2D `paint*` fns. Kept HERE (not in the atom files) so the `three`/`drei`/`fiber`
+ * dependency stays out of the 2D paint path; only the 3D dispatcher `Drawable3D`
+ * (→ used by `GameCanvas3D`, itself in the code-split 3D surface) imports this.
+ * Each mesh consumes the SAME descriptor as its 2D painter, so canvas-2d and
+ * canvas-3d render the same `children`.
+ */
+import React from 'react';
+import type { DrawSpriteProps } from '../../../components/game/atoms/DrawSprite';
+import type { DrawShapeProps } from '../../../components/game/atoms/DrawShape';
+import type { DrawTextProps } from '../../../components/game/atoms/DrawText';
+import type { Projector3D } from '../projector3d';
+/** R3F mesh backend for `draw-sprite`: a GLB via `ModelLoader` when `asset.dimension === '3d'`; else a billboard. */
+export declare function Sprite3D({ node, projector }: {
+    node: DrawSpriteProps;
+    projector: Projector3D;
+}): React.JSX.Element | null;
+/** R3F mesh backend for `draw-shape`: a flat mesh on the ground plane. */
+export declare function Shape3D({ node, projector }: {
+    node: DrawShapeProps;
+    projector: Projector3D;
+}): React.JSX.Element | null;
+/** R3F mesh backend for `draw-text`: a billboarded drei `<Text>` above the scene position. */
+export declare function Text3D({ node, projector }: {
+    node: DrawTextProps;
+    projector: Projector3D;
+}): React.JSX.Element | null;

package/dist/{components/game/shared/index.d.ts → lib/gameShared.d.ts}

@@ -9,10 +9,9 @@ export type { IsometricTile, IsometricUnit, IsometricFeature, CameraState, } fro
 export type { AnimationName, FacingDirection, SpriteDirection, ResolvedFrame, UnitAnimationState, SpriteFrameDims, SpriteSheetUrls, AnimationDef, } from './spriteAnimationTypes';
 export { createInitialGameState, calculateValidMoves, calculateAttackTargets, } from './game';
 export type { Position, GameUnit, UnitTrait, BoardTile, GamePhase, GameState, GameAction, } from './game';
-export * from './effects';
 export * from './boardEntity';
 export * from './makeAsset';
-export { useImageCache } from './useImageCache';
+export { useImageCache } from '../hooks/useImageCache';
 export { isoToScreen, screenToIso, TILE_WIDTH, TILE_HEIGHT, FLOOR_HEIGHT, DIAMOND_TOP_Y, FEATURE_COLORS, } from './isometric';
 export type { TileLayout } from './isometric';
 export { inferDirection, resolveSheetDirection, getCurrentFrame, resolveFrame, createUnitAnimationState, transitionAnimation, tickAnimationState, } from './spriteAnimation';

package/dist/lib/imageCache.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Return the decoded image for `url`, or `null` if it is not ready yet (a load
+ * is kicked off on the first miss). Safe to call every frame — cached after the
+ * first request. SSR-safe: returns `null` without a DOM. `onReady` (optional)
+ * fires once when a pending load resolves so a caller can trigger a re-draw.
+ */
+export declare function getOrLoadImage(url: string, onReady?: () => void): HTMLImageElement | null;
+/** Test/reset hook — clears the module cache. */
+export declare function clearImageCache(): void;

package/dist/lib/painter2d.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Painter2D — the portable 2D draw seam.
+ *
+ * A small verb set that every drawable atom paints through, so a scene stays a
+ * pure descriptor tree with no `CanvasRenderingContext2D` reference of its own.
+ * The web implementation (`createWebPainter`) wraps a `ctx`; a native platform
+ * ships its own implementation of the SAME interface — that is the cross-platform
+ * driver (draw-list over DOM overlays). This file is DOM-free: it is the shared
+ * contract, importable by any target.
+ *
+ * Coordinates are PIXELS in the painter's current transform. Scene→pixel mapping
+ * is the host projector's job (it maps a core `ScenePos` before calling here), so
+ * the painter carries no scene/projection semantics.
+ */
+/** An opaque, painter-owned handle to a resolved texture (web: a decoded image). */
+export interface TextureHandle {
+    readonly width: number;
+    readonly height: number;
+}
+/** Destination rectangle for a blit; `w`/`h` omitted → the source's natural size. */
+export interface BlitDest {
+    x: number;
+    y: number;
+    w?: number;
+    h?: number;
+}
+/** Source sub-rectangle within a texture (an atlas frame). Omitted → whole texture. */
+export interface BlitSrc {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}
+/** A polyline/polygon vertex in pixel space. */
+export interface PainterPoint {
+    x: number;
+    y: number;
+}
+export interface TextStyle {
+    color: string;
+    /** CSS font shorthand (e.g. `"12px sans-serif"`). */
+    font?: string;
+    align?: CanvasTextAlign;
+    baseline?: CanvasTextBaseline;
+}
+/** A drop shadow applied to subsequent draws until cleared. */
+export interface PainterShadow {
+    color: string;
+    blur: number;
+}
+/**
+ * The verb set. Roughly the union of what `Canvas2D`'s draw passes call on a 2D
+ * context, reframed as painter-neutral operations so the same drawable atoms
+ * paint identically on web `ctx` and on a native surface.
+ */
+export interface Painter2D {
+    /** Reset the surface to `width`×`height` logical px at device-pixel-ratio `dpr`. */
+    setViewport(width: number, height: number, dpr: number): void;
+    /** Clear the whole surface. */
+    clear(): void;
+    save(): void;
+    restore(): void;
+    translate(x: number, y: number): void;
+    scale(sx: number, sy: number): void;
+    rotate(radians: number): void;
+    /** Global alpha (0..1) for subsequent draws. */
+    setAlpha(alpha: number): void;
+    /** Drop shadow for subsequent draws; `null` clears it. */
+    setShadow(shadow: PainterShadow | null): void;
+    /** Resolve a texture URL to a handle, or `null` if not loaded yet (load is kicked off). */
+    resolveTexture(url: string): TextureHandle | null;
+    /** Blit a (sub-rect of a) texture to a destination rectangle. */
+    blit(tex: TextureHandle, dest: BlitDest, src?: BlitSrc): void;
+    fillRect(x: number, y: number, w: number, h: number, color: string): void;
+    strokeRect(x: number, y: number, w: number, h: number, color: string, lineWidth?: number): void;
+    fillPoly(points: readonly PainterPoint[], color: string): void;
+    strokePoly(points: readonly PainterPoint[], color: string, lineWidth?: number, closed?: boolean): void;
+    fillEllipse(cx: number, cy: number, rx: number, ry: number, color: string): void;
+    strokeEllipse(cx: number, cy: number, rx: number, ry: number, color: string, lineWidth?: number): void;
+    text(str: string, x: number, y: number, style: TextStyle): void;
+}

package/dist/{components/game/shared/lib → lib}/puzzleObject.d.ts

@@ -4,12 +4,21 @@
  *
  * The puzzle objects the kid configures arrive as `entity.objects` (an array of
  * `EntityRow`). These helpers narrow the weakly-typed fields the panel reads.
- * `RuleDefinition` / `RuleOption` remain plain UI value DTOs (see `RuleEditor`).
+ * `RuleDefinition` / `RuleOption` are plain UI value DTOs, defined below.
  *
  * @packageDocumentation
  */
 import type { EntityWith } from '@almadar/core';
-import type { RuleDefinition, RuleOption } from '../../2d/molecules/RuleEditor';
+/** A single Event-Handler puzzle rule: "when <event> then <action>". Plain value DTO. */
+export type RuleDefinition = {
+    whenEvent: string;
+    thenAction: string;
+};
+/** An option (event or action) selectable in a puzzle rule. Plain value DTO. */
+export interface RuleOption {
+    value: string;
+    label: string;
+}
 type PuzzleObjectRow = EntityWith<{
     name?: string;
     icon?: string;

package/dist/lib/webPainter2d.d.ts

@@ -0,0 +1,7 @@
+import type { Painter2D } from './painter2d';
+/**
+ * Create a {@link Painter2D} backed by a web 2D context. `onAssetLoad` (optional)
+ * fires when a texture requested via `resolveTexture` finishes loading, so a
+ * draw-host can schedule a re-draw.
+ */
+export declare function createWebPainter(ctx: CanvasRenderingContext2D, onAssetLoad?: () => void): Painter2D;

package/dist/marketing/index.cjs

@@ -4633,6 +4633,15 @@ var tagVariantMap = {
   secondary: "secondary",
   accent: "info"
 };
+var backgroundStyles = {
+  dark: "bg-foreground text-background",
+  gradient: [
+    "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),",
+    "radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)]",
+    "bg-background"
+  ].join(" "),
+  subtle: "bg-muted/30"
+};
 var MarketingImage = ({ src, alt, className }) => /* @__PURE__ */ jsxRuntime.jsx(
   Box,
   {
@@ -4774,6 +4783,7 @@ var HeroSection = ({
         "w-full min-h-[60vh] flex items-center justify-center",
         "py-20",
         "relative overflow-hidden",
+        backgroundStyles[background],
         className
       ),
       children: [

package/dist/marketing/index.js

@@ -4612,6 +4612,15 @@ var tagVariantMap = {
   secondary: "secondary",
   accent: "info"
 };
+var backgroundStyles = {
+  dark: "bg-foreground text-background",
+  gradient: [
+    "bg-[radial-gradient(ellipse_at_top,var(--color-primary)/0.08,transparent_60%),",
+    "radial-gradient(ellipse_at_bottom_right,var(--color-accent)/0.06,transparent_50%)]",
+    "bg-background"
+  ].join(" "),
+  subtle: "bg-muted/30"
+};
 var MarketingImage = ({ src, alt, className }) => /* @__PURE__ */ jsx(
   Box,
   {
@@ -4753,6 +4762,7 @@ var HeroSection = ({
         "w-full min-h-[60vh] flex items-center justify-center",
         "py-20",
         "relative overflow-hidden",
+        backgroundStyles[background],
         className
       ),
       children: [

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 '../components/core/atoms/types';
 export type GameAudioContextValue = Pick<GameAudioControls, 'muted' | 'setMuted' | 'masterVolume' | 'setMasterVolume' | 'play' | 'playMusic' | 'stopMusic'>;
 export declare const GameAudioContext: React.Context<GameAudioContextValue | null>;
 /**