@almadar/ui 5.138.0 → 5.140.0

package/dist/lib/drawable/three/index.cjs

@@ -184,12 +184,18 @@ function collectDrawnItems(nodes) {
   for (const n of nodes) {
     switch (n.type) {
       case "draw-sprite":
+        if (isValidScenePos(n.position)) out.push({ pos: n.position, id: n.id, anchor: n.anchor, width: n.width, height: n.height });
+        break;
       case "draw-shape":
       case "draw-text":
       case "draw-group":
         if (isValidScenePos(n.position)) out.push({ pos: n.position, id: n.id });
         break;
       case "draw-sprite-layer":
+        for (const it of n.items) {
+          if (isValidScenePos(it.position)) out.push({ pos: it.position, id: it.id, anchor: it.anchor, width: it.width, height: it.height });
+        }
+        break;
       case "draw-shape-layer":
       case "draw-text-layer":
         for (const it of n.items) {

package/dist/lib/drawable/three/index.d.cts

@@ -3,7 +3,7 @@ import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import { ScenePos, EventEmit, JsonObject, OrbitalSchema } from '@almadar/core';
 import * as THREE from 'three';
 import { QuadraticBezierCurve3 } from 'three';
-import { D as DrawableNode } from '../../../paintDispatch-DXygiK7M.cjs';
+import { D as DrawableNode } from '../../../paintDispatch-B5pPeSEp.cjs';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-B8Onmfsu.cjs';
 export { U as UnitAnimationState } from '../../../avl-schema-parser-B8Onmfsu.cjs';

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

@@ -3,7 +3,7 @@ import React__default, { Component, ReactNode, ErrorInfo } from 'react';
 import { ScenePos, EventEmit, JsonObject, OrbitalSchema } from '@almadar/core';
 import * as THREE from 'three';
 import { QuadraticBezierCurve3 } from 'three';
-import { D as DrawableNode } from '../../../paintDispatch-DXygiK7M.js';
+import { D as DrawableNode } from '../../../paintDispatch-B5pPeSEp.js';
 import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
 import { I as IsometricTile, a as IsometricUnit, b as IsometricFeature, A as ApplicationLevelData, O as OrbitalLevelData, T as TraitLevelData, c as TransitionLevelData } from '../../../avl-schema-parser-B8Onmfsu.js';
 export { U as UnitAnimationState } from '../../../avl-schema-parser-B8Onmfsu.js';

package/dist/lib/drawable/three/index.js

@@ -160,12 +160,18 @@ function collectDrawnItems(nodes) {
   for (const n of nodes) {
     switch (n.type) {
       case "draw-sprite":
+        if (isValidScenePos(n.position)) out.push({ pos: n.position, id: n.id, anchor: n.anchor, width: n.width, height: n.height });
+        break;
       case "draw-shape":
       case "draw-text":
       case "draw-group":
         if (isValidScenePos(n.position)) out.push({ pos: n.position, id: n.id });
         break;
       case "draw-sprite-layer":
+        for (const it of n.items) {
+          if (isValidScenePos(it.position)) out.push({ pos: it.position, id: it.id, anchor: it.anchor, width: it.width, height: it.height });
+        }
+        break;
       case "draw-shape-layer":
       case "draw-text-layer":
         for (const it of n.items) {

package/dist/lib/index.d.cts

@@ -1,7 +1,7 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-CL0kdshO.cjs';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-DkGYzPOg.cjs';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
-import '../paintDispatch-DXygiK7M.cjs';
+import '../paintDispatch-B5pPeSEp.cjs';
 import 'clsx';
 
 /**

package/dist/lib/index.d.ts

@@ -1,7 +1,7 @@
-export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-CCaph5o9.js';
+export { C as ContentSegment, D as DEFAULT_CONFIG, a as DomEntityBox, b as DomLayoutData, c as DomOutputsBox, d as DomStateNode, e as DomTransitionLabel, f as DomTransitionPath, E as EntityDefinition, R as RenderOptions, S as StateDefinition, g as StateMachineDefinition, T as TraitSnapshotGetter, h as TransitionDefinition, V as VisualizerConfig, i as bindCanvasCapture, j as bindEventBus, k as bindLastDrawables, l as bindTraitStateGetter, m as clearVerification, n as cn, o as extractOutputsFromTransitions, p as extractStateMachine, q as formatGuard, r as getAllChecks, s as getBridgeHealth, t as getEffectSummary, u as getSnapshot, v as getSummary, w as getTraitSnapshots, x as getTransitions, y as getTransitionsForTrait, z as parseContentSegments, A as parseMarkdownWithCodeBlocks, B as recordServerResponse, F as recordTransition, G as registerCheck, H as registerTraitSnapshot, I as renderStateMachineToDomData, J as renderStateMachineToSvg, K as subscribeToVerification, L as updateAssetStatus, M as updateBridgeHealth, N as updateCheck, O as waitForTransition } from '../cn-Do5Ra3l3.js';
 import { FieldValue, EntityRow, EventPayload } from '@almadar/core';
 export { AssetLoadStatus, BridgeHealth, CheckStatus, EffectTrace, EventLogEntry, OrbitalVerificationAPI, ServerResponseTrace, TraitStateSnapshot, TransitionTrace, VerificationCheck, VerificationSnapshot, VerificationSummary } from '@almadar/core';
-import '../paintDispatch-DXygiK7M.js';
+import '../paintDispatch-B5pPeSEp.js';
 import 'clsx';
 
 /**

package/dist/{paintDispatch-DXygiK7M.d.cts → paintDispatch-B5pPeSEp.d.cts}

@@ -17,6 +17,11 @@ interface PainterShadow {
     color: string;
     blur: number;
 }
+/** One color stop of a {@link PainterGradient}; `offset` is 0..1 along the gradient. */
+interface PainterGradientStop {
+    offset: number;
+    color: string;
+}
 
 /**
  * Drawable contract — the shared vocabulary every neutral drawable primitive
@@ -110,6 +115,64 @@ interface DrawSpriteProps extends DrawableBase {
  */
 
 type ShapeKind = 'cell' | 'rect' | 'ellipse' | 'poly' | 'path';
+/** One gradient color stop; `offset` is 0..1 along the gradient axis. */
+type DrawShapeGradientStop = PainterGradientStop;
+/**
+ * A gradient fill in world units relative to the cell's projected top-left —
+ * same coordinate convention as `points` and `d`. Overrides `fill` when present.
+ */
+interface DrawShapeGradient {
+    kind: 'linear' | 'radial';
+    /** Linear start point in world units. */
+    from?: PainterPoint;
+    /** Linear end point in world units. */
+    to?: PainterPoint;
+    /** Radial center in world units. */
+    center?: PainterPoint;
+    /** Radial radius in world units. */
+    radius?: number;
+    /** Ordered color stops. */
+    stops: DrawShapeGradientStop[];
+}
+/** A soft glow / drop-shadow behind the shape; `blur` is in world units. */
+interface DrawShapeShadow {
+    color: string;
+    blur: number;
+}
+/**
+ * One keyframe of a {@link DrawShapeAnimation}: `at` is the 0..1 position in
+ * the cycle; every other field overrides the shape's base prop at that moment.
+ */
+interface DrawShapeKeyframe {
+    at: number;
+    offsetX?: number;
+    offsetY?: number;
+    rotate?: number;
+    opacity?: number;
+    radiusX?: number;
+    radiusY?: number;
+    width?: number;
+    height?: number;
+    strokeWidth?: number;
+    fill?: string;
+    stroke?: string;
+    shadow?: DrawShapeShadow;
+}
+/**
+ * Declarative keyframe animation for a drawable. The host runs a paint clock
+ * while any drawable declares one; numeric tracks lerp between keyframes,
+ * string tracks hold the previous keyframe's value, `shadow` lerps `blur` and
+ * holds `color`. A track starts from the shape's base prop until its first
+ * keyframe defines it.
+ */
+interface DrawShapeAnimation {
+    /** One cycle length in ms. */
+    durationMs: number;
+    /** Loop the cycle (default true); false plays once and holds the final keyframes. */
+    loop?: boolean;
+    /** Keyframes ordered by `at` (0..1). */
+    keyframes: DrawShapeKeyframe[];
+}
 interface DrawShapeProps extends DrawableBase {
     type: 'draw-shape';
     shape: ShapeKind;
@@ -125,7 +188,7 @@ interface DrawShapeProps extends DrawableBase {
     radiusX?: number;
     /** Ellipse vertical radius in world units; omitted → `radiusX` (a circle). */
     radiusY?: number;
-    /** Fine nudge from the anchor point in world units. */
+    /** Fine nudge in world units — applies to every shape kind except `cell` (rect/ellipse from their anchor point; poly/path from the projected top-left). */
     offsetX?: number;
     offsetY?: number;
     /** Poly vertices as world-unit offsets relative to the cell's projected top-left. */
@@ -133,8 +196,18 @@ interface DrawShapeProps extends DrawableBase {
     /** SVG path data in world units relative to the cell's projected top-left — same coordinate convention as `points`. */
     d?: string;
     fill?: string;
+    /** Gradient fill in world units; overrides `fill` when present. */
+    gradient?: DrawShapeGradient;
     stroke?: string;
     strokeWidth?: number;
+    /** 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;
+    /** 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. */
+    animation?: DrawShapeAnimation;
     /** 0..1 opacity. */
     opacity?: number;
 }

package/dist/{paintDispatch-DXygiK7M.d.ts → paintDispatch-B5pPeSEp.d.ts}

@@ -17,6 +17,11 @@ interface PainterShadow {
     color: string;
     blur: number;
 }
+/** One color stop of a {@link PainterGradient}; `offset` is 0..1 along the gradient. */
+interface PainterGradientStop {
+    offset: number;
+    color: string;
+}
 
 /**
  * Drawable contract — the shared vocabulary every neutral drawable primitive
@@ -110,6 +115,64 @@ interface DrawSpriteProps extends DrawableBase {
  */
 
 type ShapeKind = 'cell' | 'rect' | 'ellipse' | 'poly' | 'path';
+/** One gradient color stop; `offset` is 0..1 along the gradient axis. */
+type DrawShapeGradientStop = PainterGradientStop;
+/**
+ * A gradient fill in world units relative to the cell's projected top-left —
+ * same coordinate convention as `points` and `d`. Overrides `fill` when present.
+ */
+interface DrawShapeGradient {
+    kind: 'linear' | 'radial';
+    /** Linear start point in world units. */
+    from?: PainterPoint;
+    /** Linear end point in world units. */
+    to?: PainterPoint;
+    /** Radial center in world units. */
+    center?: PainterPoint;
+    /** Radial radius in world units. */
+    radius?: number;
+    /** Ordered color stops. */
+    stops: DrawShapeGradientStop[];
+}
+/** A soft glow / drop-shadow behind the shape; `blur` is in world units. */
+interface DrawShapeShadow {
+    color: string;
+    blur: number;
+}
+/**
+ * One keyframe of a {@link DrawShapeAnimation}: `at` is the 0..1 position in
+ * the cycle; every other field overrides the shape's base prop at that moment.
+ */
+interface DrawShapeKeyframe {
+    at: number;
+    offsetX?: number;
+    offsetY?: number;
+    rotate?: number;
+    opacity?: number;
+    radiusX?: number;
+    radiusY?: number;
+    width?: number;
+    height?: number;
+    strokeWidth?: number;
+    fill?: string;
+    stroke?: string;
+    shadow?: DrawShapeShadow;
+}
+/**
+ * Declarative keyframe animation for a drawable. The host runs a paint clock
+ * while any drawable declares one; numeric tracks lerp between keyframes,
+ * string tracks hold the previous keyframe's value, `shadow` lerps `blur` and
+ * holds `color`. A track starts from the shape's base prop until its first
+ * keyframe defines it.
+ */
+interface DrawShapeAnimation {
+    /** One cycle length in ms. */
+    durationMs: number;
+    /** Loop the cycle (default true); false plays once and holds the final keyframes. */
+    loop?: boolean;
+    /** Keyframes ordered by `at` (0..1). */
+    keyframes: DrawShapeKeyframe[];
+}
 interface DrawShapeProps extends DrawableBase {
     type: 'draw-shape';
     shape: ShapeKind;
@@ -125,7 +188,7 @@ interface DrawShapeProps extends DrawableBase {
     radiusX?: number;
     /** Ellipse vertical radius in world units; omitted → `radiusX` (a circle). */
     radiusY?: number;
-    /** Fine nudge from the anchor point in world units. */
+    /** Fine nudge in world units — applies to every shape kind except `cell` (rect/ellipse from their anchor point; poly/path from the projected top-left). */
     offsetX?: number;
     offsetY?: number;
     /** Poly vertices as world-unit offsets relative to the cell's projected top-left. */
@@ -133,8 +196,18 @@ interface DrawShapeProps extends DrawableBase {
     /** SVG path data in world units relative to the cell's projected top-left — same coordinate convention as `points`. */
     d?: string;
     fill?: string;
+    /** Gradient fill in world units; overrides `fill` when present. */
+    gradient?: DrawShapeGradient;
     stroke?: string;
     strokeWidth?: number;
+    /** 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;
+    /** 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. */
+    animation?: DrawShapeAnimation;
     /** 0..1 opacity. */
     opacity?: number;
 }