@almadar/ui 5.147.0 → 5.149.0

package/dist/{paintDispatch-Cb_hQj4Y.d.cts → paintDispatch-CxdLjHQq.d.ts}

@@ -1,22 +1,6 @@
 import { ScenePos, Asset } from '@almadar/core';
+import { P as Point, R as Rect } from './types-B3nHgnMG.js';
 
-/** Source sub-rectangle within a texture (an atlas frame). Omitted → whole texture. */
-interface BlitSrc {
-    x: number;
-    y: number;
-    w: number;
-    h: number;
-}
-/** A polyline/polygon vertex in pixel space. */
-interface PainterPoint {
-    x: number;
-    y: number;
-}
-/** A drop shadow applied to subsequent draws until cleared. */
-interface PainterShadow {
-    color: string;
-    blur: number;
-}
 /** One color stop of a {@link PainterGradient}; `offset` is 0..1 along the gradient. */
 interface PainterGradientStop {
     offset: number;
@@ -57,50 +41,6 @@ interface DrawableBase {
     id?: string;
 }
 
-/**
- * `draw-sprite` — the neutral image/atlas-frame drawable atom (dimension-agnostic).
- *
- * ONE descriptor (`DrawSpriteProps`, grounded in core `ScenePos` + `Asset`) with
- * TWO backends: `paintSprite` (2D, here — via the portable `Painter2D` seam) and
- * an R3F mesh (`Sprite3D` in `lib/drawable/mesh3d`, kept OUT of this file so the
- * 2D paint path never pulls `three`/`drei` into an app bundle — the codebase
- * code-splits R3F). The canvas host picks the backend by `mode`; that is what
- * makes canvas-2d and canvas-3d the same `children` interface. Genre uses (tile,
- * unit body, feature, effect, movement ghost, background cover) are all this atom
- * with different `anchor`/`size`/`frame`/`flip`/`shadow` — composed in `.lolo`,
- * not here. The React component renders `null` (a drawable is painted by the host,
- * not the DOM); it exists so the pattern pipeline registers a `draw-sprite`
- * pattern and standalone pages stay inspectable.
- */
-
-interface DrawSpriteProps extends DrawableBase {
-    type: 'draw-sprite';
-    /** Logical scene position; the projector maps it to pixels / world. */
-    position: ScenePos;
-    /** The image / atlas reference to blit. */
-    asset: Asset;
-    /** How the sprite aligns to its projected position. Default `'top-left'`. */
-    anchor?: DrawableAnchor;
-    /** Draw width in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
-    width?: number;
-    /** Draw height in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
-    height?: number;
-    /** Explicit atlas sub-rect override (px); omitted → resolved from `asset.atlas`/`asset.sprite`. */
-    frame?: BlitSrc;
-    /** Animation to play. 3D backend: a named GLB clip (matched case-insensitively). 2D painter: when `asset.atlas` resolves to a `SpriteSheetAtlas` manifest, the canonical row of that name (idle/walk/attack/hit/death) plays off the host paint clock; an explicit `frame` rect overrides. */
-    animation?: string;
-    /** Override the sheet row's loop flag. The paint clock is wall-time, so one-shot rows hold their final frame — preview pages set `true` to cycle attack/hit/death continuously. */
-    loop?: boolean;
-    /** Mirror horizontally (facing). */
-    flipX?: boolean;
-    /** Rotation in radians about the sprite's center. */
-    rotation?: number;
-    /** 0..1 opacity. */
-    opacity?: number;
-    /** Drop shadow (e.g. a team-colored glow). */
-    shadow?: PainterShadow;
-}
-
 /**
  * `draw-shape` — the neutral vector-fill/stroke drawable atom (dimension-agnostic).
  *
@@ -128,11 +68,11 @@ type DrawShapeGradientStop = PainterGradientStop;
 interface DrawShapeGradient {
     kind: 'linear' | 'radial' | 'conic';
     /** Linear start point in world units. */
-    from?: PainterPoint;
+    from?: Point;
     /** Linear end point in world units. */
-    to?: PainterPoint;
+    to?: Point;
     /** Radial/conic center in world units. */
-    center?: PainterPoint;
+    center?: Point;
     /** Radial radius in world units. */
     radius?: number;
     /** Conic start angle in radians. */
@@ -216,7 +156,7 @@ interface DrawShapeProps extends DrawableBase {
     offsetX?: number;
     offsetY?: number;
     /** Poly vertices as world-unit offsets relative to the cell's projected top-left. */
-    points?: PainterPoint[];
+    points?: Point[];
     /** SVG path data in world units relative to the cell's projected top-left — same coordinate convention as `points`. */
     d?: string;
     fill?: string;
@@ -239,7 +179,7 @@ interface DrawShapeProps extends DrawableBase {
     /** Rotation in radians (painter units, same as `draw-group`), about `pivot`. */
     rotate?: number;
     /** Rotation pivot in world units relative to the cell's projected top-left; default `{x:0.5, y:0.5}` (cell center). */
-    pivot?: PainterPoint;
+    pivot?: Point;
     /** Soft glow / drop-shadow behind the shape; `blur` in world units. */
     shadow?: DrawShapeShadow;
     /** Keyframe animation over this shape's props; the host runs a paint clock while present. */
@@ -248,6 +188,50 @@ interface DrawShapeProps extends DrawableBase {
     opacity?: number;
 }
 
+/**
+ * `draw-sprite` — the neutral image/atlas-frame drawable atom (dimension-agnostic).
+ *
+ * ONE descriptor (`DrawSpriteProps`, grounded in core `ScenePos` + `Asset`) with
+ * TWO backends: `paintSprite` (2D, here — via the portable `Painter2D` seam) and
+ * an R3F mesh (`Sprite3D` in `lib/drawable/mesh3d`, kept OUT of this file so the
+ * 2D paint path never pulls `three`/`drei` into an app bundle — the codebase
+ * code-splits R3F). The canvas host picks the backend by `mode`; that is what
+ * makes canvas-2d and canvas-3d the same `children` interface. Genre uses (tile,
+ * unit body, feature, effect, movement ghost, background cover) are all this atom
+ * with different `anchor`/`size`/`frame`/`flip`/`shadow` — composed in `.lolo`,
+ * not here. The React component renders `null` (a drawable is painted by the host,
+ * not the DOM); it exists so the pattern pipeline registers a `draw-sprite`
+ * pattern and standalone pages stay inspectable.
+ */
+
+interface DrawSpriteProps extends DrawableBase {
+    type: 'draw-sprite';
+    /** Logical scene position; the projector maps it to pixels / world. */
+    position: ScenePos;
+    /** The image / atlas reference to blit. */
+    asset: Asset;
+    /** How the sprite aligns to its projected position. Default `'top-left'`. */
+    anchor?: DrawableAnchor;
+    /** Draw width in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
+    width?: number;
+    /** Draw height in world units (fractions of `projector.tileWidth`). Omitted → one cell on tile grids (`flat`/`iso`/`hex`); native source px on `free`/`side`. */
+    height?: number;
+    /** Explicit atlas sub-rect override (px); omitted → resolved from `asset.atlas`/`asset.sprite`. */
+    frame?: Rect;
+    /** Animation to play. 3D backend: a named GLB clip (matched case-insensitively). 2D painter: when `asset.atlas` resolves to a `SpriteSheetAtlas` manifest, the canonical row of that name (idle/walk/attack/hit/death) plays off the host paint clock; an explicit `frame` rect overrides. */
+    animation?: string;
+    /** Override the sheet row's loop flag. The paint clock is wall-time, so one-shot rows hold their final frame — preview pages set `true` to cycle attack/hit/death continuously. */
+    loop?: boolean;
+    /** Mirror horizontally (facing). */
+    flipX?: boolean;
+    /** Rotation in radians about the sprite's center. */
+    rotation?: number;
+    /** 0..1 opacity. */
+    opacity?: number;
+    /** Drop shadow (e.g. a team-colored glow). */
+    shadow?: DrawShapeShadow;
+}
+
 /**
  * `draw-text` — the neutral text drawable atom (dimension-agnostic).
  *
@@ -258,6 +242,16 @@ interface DrawShapeProps extends DrawableBase {
  * component renders `null` (a drawable is painted by the host, not the DOM).
  */
 
+/**
+ * Mirrors DOM lib.dom.d.ts `CanvasTextAlign` by value (used directly instead
+ * of the ambient global so the pattern-sync scanner — which only indexes
+ * `components/**` and can't see ambient TS-lib types — resolves this to a
+ * concrete enum instead of `json`). Structurally identical; `node.align`
+ * still flows straight into `Painter2D.text`'s `TextStyle.align`.
+ */
+type DrawTextAlign = 'center' | 'end' | 'left' | 'right' | 'start';
+/** Mirrors DOM `CanvasTextBaseline` by value — see {@link DrawTextAlign}. */
+type DrawTextBaseline = 'alphabetic' | 'bottom' | 'hanging' | 'ideographic' | 'middle' | 'top';
 interface DrawTextProps extends DrawableBase {
     type: 'draw-text';
     text: string;
@@ -268,8 +262,8 @@ interface DrawTextProps extends DrawableBase {
     offsetY?: number;
     color: string;
     font?: string;
-    align?: CanvasTextAlign;
-    baseline?: CanvasTextBaseline;
+    align?: DrawTextAlign;
+    baseline?: DrawTextBaseline;
     opacity?: number;
 }
 
@@ -525,4 +519,4 @@ interface DrawTextLayerProps extends DrawableBase {
 /** Every drawable descriptor. The host's `children` are a `DrawableNode[]`. */
 type DrawableNode = DrawSpriteProps | DrawShapeProps | DrawTextProps | DrawGroupProps | DrawMeshProps | DrawSpriteLayerProps | DrawShapeLayerProps | DrawTextLayerProps;
 
-export type { DrawableNode as D };
+export type { DrawableNode as D, MeshShapeKind as M, MeshMaterial as a, DrawGroupProps as b, DrawTextProps as c, DrawMeshProps as d };