@almadar/ui 6.13.0 → 6.15.0

package/dist/{paintDispatch-CK5uwYEq.d.cts → paintDispatch-Dh1pgljl.d.cts}

@@ -540,6 +540,84 @@ interface DrawGroupProps extends DrawableBase {
     items: DrawableNode[];
 }
 
+interface SkinWeight {
+    /** Index into the drawable's `bones` array. */
+    bone: number;
+    w: number;
+}
+interface SkinVertex {
+    x: number;
+    y: number;
+    /** Normalized 0..1 texture coordinates. */
+    u: number;
+    v: number;
+    weights: SkinWeight[];
+}
+interface SkinMesh {
+    vertices: SkinVertex[];
+    triangles: [number, number, number][];
+}
+interface BoneDef {
+    name: string;
+    parent: string | null;
+    /** Rotation pivot in local space (the joint the bone turns about). */
+    pivot: [number, number];
+    /** Bone end point in local space (render/inspect hint; no skinning role). */
+    tip: [number, number];
+}
+/** Bone name → rotation in degrees relative to the bind pose. */
+type Pose = Record<string, number>;
+
+/**
+ * `draw-skinned-mesh` — the skeletal-mesh drawable atom: a bind-pose triangle
+ * mesh deformed by linear blend skinning and painted per-triangle from a texture.
+ *
+ * The general-purpose primitive for animated 2D characters (puppet rigs): a pose
+ * rotates each bone about its pivot (degrees, relative to bind), `lib/skinning`
+ * computes the deformed vertices, and each triangle is blit through the affine
+ * mapping its UV tri → its painted tri (clipped to the tri, so seams don't bleed).
+ * Mesh + bones + UVs come from the bundle exporter (inline `mesh` or a fetched
+ * `meshUrl`); animation is `clip.frames[frame % len]`, driven by the host like
+ * any other drawable frame counter. `weightsOverlay` swaps the texture for a
+ * per-bone categorical fill (rig inspection); `ghost` paints an onion-skin pass
+ * of another clip frame underneath. The React component renders `null` (the host
+ * paints it); it exists so the pattern pipeline registers a `draw-skinned-mesh`
+ * pattern and JSX children register through the drawable registry.
+ */
+
+interface DrawSkinnedMeshProps extends DrawableBase {
+    type: 'draw-skinned-mesh';
+    /** Logical scene position; mesh local coords are world units relative to its projected top-left. */
+    position: ScenePos;
+    /** The texture the mesh UVs cut into. */
+    asset: Asset;
+    /** Inline bind mesh; wins over `meshUrl`. */
+    mesh?: SkinMesh;
+    /** URL of a JSON `SkinMesh` (fetched + cached); used when `mesh` is absent. */
+    meshUrl?: string;
+    /** The skeleton (bind pose; FK chain via `parent` names). Falls back to the rigbundle's `bones` when empty. */
+    bones: BoneDef[];
+    /** Static pose (bone name → degrees relative to bind). Overridden by `clip` + `frame`. */
+    pose?: Pose;
+    /** Pose animation clip; with `frame`, pose = `frames[frame % frames.length]`. */
+    clip?: {
+        frames: Pose[];
+    };
+    /** Named clip inside the rigbundle at `meshUrl` (`clips[clipName].frames`); used when `clip` is absent. Empty/unknown = no clip. */
+    clipName?: string;
+    /** Clip frame counter (host-driven paint clock frame). */
+    frame?: number;
+    /** 0..1 opacity. */
+    opacity?: number;
+    /** Paint per-triangle dominant-bone colors instead of the texture (rig inspection). */
+    weightsOverlay?: boolean;
+    /** Onion skin: render the mesh at this clip frame underneath, at this opacity. */
+    ghost?: {
+        frame: number;
+        opacity: number;
+    };
+}
+
 /**
  * `draw-sprite-layer` — batch multiple sprites in one descriptor for O(layers) rendering.
  *
@@ -776,6 +854,6 @@ interface DrawFxLayerProps extends DrawableBase {
  */
 
 /** Every drawable descriptor. The host's `children` are a `DrawableNode[]`. */
-type DrawableNode = DrawSpriteProps | DrawShapeProps | DrawTextProps | DrawGroupProps | DrawMeshProps | DrawSpriteLayerProps | DrawShapeLayerProps | DrawTextLayerProps | DrawFxLayerProps;
+type DrawableNode = DrawSpriteProps | DrawShapeProps | DrawTextProps | DrawGroupProps | DrawMeshProps | DrawSkinnedMeshProps | DrawSpriteLayerProps | DrawShapeLayerProps | DrawTextLayerProps | DrawFxLayerProps;
 
 export type { ColorToken as C, DrawableNode as D, FxOverlayItem as F, ImageSource as I, LinkAction as L, MeshShapeKind as M, Point as P, Rect as R, UiError as U, Projector as a, MeshMaterial as b, DrawGroupProps as c, DrawTextProps as d, DrawMeshProps as e, FxOverlayKind as f };

package/dist/{paintDispatch-CK5uwYEq.d.ts → paintDispatch-Dh1pgljl.d.ts}

@@ -540,6 +540,84 @@ interface DrawGroupProps extends DrawableBase {
     items: DrawableNode[];
 }
 
+interface SkinWeight {
+    /** Index into the drawable's `bones` array. */
+    bone: number;
+    w: number;
+}
+interface SkinVertex {
+    x: number;
+    y: number;
+    /** Normalized 0..1 texture coordinates. */
+    u: number;
+    v: number;
+    weights: SkinWeight[];
+}
+interface SkinMesh {
+    vertices: SkinVertex[];
+    triangles: [number, number, number][];
+}
+interface BoneDef {
+    name: string;
+    parent: string | null;
+    /** Rotation pivot in local space (the joint the bone turns about). */
+    pivot: [number, number];
+    /** Bone end point in local space (render/inspect hint; no skinning role). */
+    tip: [number, number];
+}
+/** Bone name → rotation in degrees relative to the bind pose. */
+type Pose = Record<string, number>;
+
+/**
+ * `draw-skinned-mesh` — the skeletal-mesh drawable atom: a bind-pose triangle
+ * mesh deformed by linear blend skinning and painted per-triangle from a texture.
+ *
+ * The general-purpose primitive for animated 2D characters (puppet rigs): a pose
+ * rotates each bone about its pivot (degrees, relative to bind), `lib/skinning`
+ * computes the deformed vertices, and each triangle is blit through the affine
+ * mapping its UV tri → its painted tri (clipped to the tri, so seams don't bleed).
+ * Mesh + bones + UVs come from the bundle exporter (inline `mesh` or a fetched
+ * `meshUrl`); animation is `clip.frames[frame % len]`, driven by the host like
+ * any other drawable frame counter. `weightsOverlay` swaps the texture for a
+ * per-bone categorical fill (rig inspection); `ghost` paints an onion-skin pass
+ * of another clip frame underneath. The React component renders `null` (the host
+ * paints it); it exists so the pattern pipeline registers a `draw-skinned-mesh`
+ * pattern and JSX children register through the drawable registry.
+ */
+
+interface DrawSkinnedMeshProps extends DrawableBase {
+    type: 'draw-skinned-mesh';
+    /** Logical scene position; mesh local coords are world units relative to its projected top-left. */
+    position: ScenePos;
+    /** The texture the mesh UVs cut into. */
+    asset: Asset;
+    /** Inline bind mesh; wins over `meshUrl`. */
+    mesh?: SkinMesh;
+    /** URL of a JSON `SkinMesh` (fetched + cached); used when `mesh` is absent. */
+    meshUrl?: string;
+    /** The skeleton (bind pose; FK chain via `parent` names). Falls back to the rigbundle's `bones` when empty. */
+    bones: BoneDef[];
+    /** Static pose (bone name → degrees relative to bind). Overridden by `clip` + `frame`. */
+    pose?: Pose;
+    /** Pose animation clip; with `frame`, pose = `frames[frame % frames.length]`. */
+    clip?: {
+        frames: Pose[];
+    };
+    /** Named clip inside the rigbundle at `meshUrl` (`clips[clipName].frames`); used when `clip` is absent. Empty/unknown = no clip. */
+    clipName?: string;
+    /** Clip frame counter (host-driven paint clock frame). */
+    frame?: number;
+    /** 0..1 opacity. */
+    opacity?: number;
+    /** Paint per-triangle dominant-bone colors instead of the texture (rig inspection). */
+    weightsOverlay?: boolean;
+    /** Onion skin: render the mesh at this clip frame underneath, at this opacity. */
+    ghost?: {
+        frame: number;
+        opacity: number;
+    };
+}
+
 /**
  * `draw-sprite-layer` — batch multiple sprites in one descriptor for O(layers) rendering.
  *
@@ -776,6 +854,6 @@ interface DrawFxLayerProps extends DrawableBase {
  */
 
 /** Every drawable descriptor. The host's `children` are a `DrawableNode[]`. */
-type DrawableNode = DrawSpriteProps | DrawShapeProps | DrawTextProps | DrawGroupProps | DrawMeshProps | DrawSpriteLayerProps | DrawShapeLayerProps | DrawTextLayerProps | DrawFxLayerProps;
+type DrawableNode = DrawSpriteProps | DrawShapeProps | DrawTextProps | DrawGroupProps | DrawMeshProps | DrawSkinnedMeshProps | DrawSpriteLayerProps | DrawShapeLayerProps | DrawTextLayerProps | DrawFxLayerProps;
 
 export type { ColorToken as C, DrawableNode as D, FxOverlayItem as F, ImageSource as I, LinkAction as L, MeshShapeKind as M, Point as P, Rect as R, UiError as U, Projector as a, MeshMaterial as b, DrawGroupProps as c, DrawTextProps as d, DrawMeshProps as e, FxOverlayKind as f };