@hatiolab/things-scene 10.1.84 → 10.1.86

package/dist-types/components/data/evaluator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../../src/components/data/evaluator.ts"],"names":[],"mappings":"AAuFA,iBAAS,cAAc,CAAC,MAAM,KAAA,QAM7B;AAED,OAAO,EAAE,cAAc,EAAE,CAAA;AAMzB,QAAA,MAAM,gBAAgB,UAIrB,CAAA;AACD,QAAA,MAAM,WAAW,OAAqD,CAAA;AAEtE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAA;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,KAA0D,CAAA;AAEpF,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,GACnB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,GAAG,CAQ3C;AAwBD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAAO,KAAA,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA,UAlBpC,GAAG,SAAS,GAAG,WAAW,GAAG,SAmChE"}
+{"version":3,"file":"evaluator.d.ts","sourceRoot":"","sources":["../../../src/components/data/evaluator.ts"],"names":[],"mappings":"AAwEA,iBAAS,cAAc,CAAC,MAAM,KAAA,QAM7B;AAED,OAAO,EAAE,cAAc,EAAE,CAAA;AAMzB,QAAA,MAAM,gBAAgB,UAIrB,CAAA;AACD,QAAA,MAAM,WAAW,OAAqD,CAAA;AAEtE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,CAAA;AAExC;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,KAA0D,CAAA;AAEpF,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvD;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAAE,GACnB,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,EAAE,KAAK,GAAG,CAQ3C;AAwBD,MAAM,CAAC,OAAO,UAAU,cAAc,CAAC,OAAO,KAAA,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA,EAAE,KAAK,KAAA,EAAE,IAAI,KAAA,UAlBpC,GAAG,SAAS,GAAG,WAAW,GAAG,SAqChE"}

package/dist-types/components/data/legend.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Legend = a table from a value, read as text, to what it shows -- a colour, a label, a clip. `default` is what a value
+ * the table does not name shows.
+ *
+ *   { idle: '#888', running: '#0F0', error: '#F00', default: '#888' }
+ *   { true: '#0F0', false: '#888' }
+ *
+ * The one lookup of a code in a table: a mapping's `map` rule, a component's legends (`Legendable`) and a figure's status
+ * template all read it here (ADR-0051 §8, the architect's ruling of 2026-10-14).
+ */
+export type Legend<T = unknown> = Record<string, T> & {
+    default?: T;
+};
+/** A value through a legend: its own entry, else `default`, else undefined. The value is read as text (`true` → `'true'`). */
+export declare function resolveLegend<T>(value: unknown, legend: Legend<T> | null | undefined): T | undefined;
+/**
+ * One entry of a table of values and intervals: an exact value it shows `result` for, or an interval `min <= v < max`
+ * (either end left open). A board's legend component stores its ranges this way; a mapping's `range` rule writes its
+ * intervals as keys and is read into these.
+ */
+export interface LegendEntry<T = unknown> {
+    value?: unknown;
+    min?: number | string | null;
+    max?: number | string | null;
+    result: T;
+}
+/**
+ * A value through a table of values and intervals -- the one matching of a value against intervals: an exact value
+ * first (any entry, compared as it is), then the first interval holding it, `min` included and `max` not, then
+ * `fallback`. An entry with neither end is no interval. No value (null, undefined) is in no interval.
+ */
+export declare function resolveLegendEntries<T>(value: unknown, entries: readonly LegendEntry<T>[], fallback?: T): T | undefined;
+//# sourceMappingURL=legend.d.ts.map

package/dist-types/components/data/legend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legend.d.ts","sourceRoot":"","sources":["../../../src/components/data/legend.ts"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAErE,8HAA8H;AAC9H,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,GAAG,CAAC,GAAG,SAAS,CAMpG;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,CAAC,CAAA;CACV;AAID;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAavH"}

package/dist-types/components/mixins/holdable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"holdable.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/holdable.ts"],"names":[],"mappings":"AAgBA,OAAO,SAAS,MAAM,iBAAiB,CAAA;AAuBvC,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAK,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,GAAG,CA4Q7F"}
+{"version":3,"file":"holdable.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/holdable.ts"],"names":[],"mappings":"AAgBA,OAAO,SAAS,MAAM,iBAAiB,CAAA;AAuBvC,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,KAAK,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,KAAK,GAAG,GAAG,CA4R7F"}

package/dist-types/figure/figure-capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-capability.d.ts","sourceRoot":"","sources":["../../src/figure/figure-capability.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAKlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAInD,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAGxF,KAAK,IAAI,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,+DAAqB,CAAA;AAErD,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAM7G,CAAA;AAEJ,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAKjF,CAAA;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,CAE/H;AAuCD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAqC/G;AA4DD,2BAA2B;AAC3B,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}
+{"version":3,"file":"figure-capability.d.ts","sourceRoot":"","sources":["../../src/figure/figure-capability.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAOlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAInD,OAAO,KAAK,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAGxF,KAAK,IAAI,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAEjD;;;;;;;;;GASG;AACH,eAAO,MAAM,mBAAmB,+DAAqB,CAAA;AAErD,MAAM,MAAM,oBAAoB,GAAG,gBAAgB,CAAA;AAEnD;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAM7G,CAAA;AAEJ,gDAAgD;AAChD,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAKjF,CAAA;AAEF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,wBAAwB,EAAE,IAAI,GAAG,UAAU,GAAG,SAAS,CAAC,EAAE,GAAG,OAAO,EAAE,CAE/H;AA8FD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAqC/G;AA8DD,2BAA2B;AAC3B,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist-types/figure/figure-data-reading.d.ts

@@ -0,0 +1,64 @@
+import type { FigureDataPlan, FigureDataValue, FigureDataValueIssue } from '@hatiolab/figure-model';
+/** One item as the data gives it: its id, and what the binding's element fields say of it. */
+export interface FigureItemRecord {
+    id: string;
+    type?: string;
+    place?: string;
+    stack?: number;
+    status?: string;
+}
+/** What the data moves, behavior by behavior. */
+export interface FigureDataResult {
+    states: Record<string, {
+        value: number;
+        sourceMode: 'observed' | 'commanded';
+    }>;
+    palette: Record<string, string>;
+    motion: Record<string, {
+        clip?: string;
+        speed?: number;
+        paused?: boolean;
+    }>;
+    /** Each status port's code, as the data gave it; the template that shows it is the consumer's. */
+    status: Record<string, string>;
+    /** The instance's position (mm) and heading (degrees), each with the seconds it takes to get there. */
+    pose: Partial<Record<'x' | 'y' | 'z' | 'heading', {
+        value: number;
+        seconds: number;
+    }>>;
+    /** The items each items binding gives, in the binding's order: what stacks below what. */
+    items: Array<{
+        binding: string;
+        slot?: string;
+        records: FigureItemRecord[];
+    }>;
+}
+/** Where the value a binding read came from: the live data, the board's saved value, the schema's default, or nowhere. */
+export type FigureDataSource = 'live' | 'manual' | 'default' | 'absent';
+export declare const EMPTY_FIGURE_DATA: FigureDataResult;
+/** A plan made ready to read: each binding's accessor and evaluator built once. */
+export declare class FigureDataReader {
+    readonly plan: FigureDataPlan;
+    private readonly bindings;
+    constructor(plan: FigureDataPlan);
+    /**
+     * What the data moves, from the live data first, then the board's saved values (by accessor), then the schema's
+     * defaults; a binding with none reads nothing and its behavior is left as it is. Items come from the live data only.
+     * Issues of the live data and of the saved values are returned apart, and the caller refuses each whole.
+     */
+    read(given: {
+        live?: unknown;
+        manual?: Record<string, unknown> | null;
+    }): {
+        result: FigureDataResult;
+        values: Record<string, {
+            value: FigureDataValue | undefined;
+            source: FigureDataSource;
+        }>;
+        liveIssues: FigureDataValueIssue[];
+        manualIssues: FigureDataValueIssue[];
+    };
+    /** The items an items binding gives: each element of a list by its id field, or one value as the id. */
+    private records;
+}
+//# sourceMappingURL=figure-data-reading.d.ts.map

package/dist-types/figure/figure-data-reading.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-data-reading.d.ts","sourceRoot":"","sources":["../../src/figure/figure-data-reading.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAqC,cAAc,EAA0B,eAAe,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAE9J,8FAA8F;AAC9F,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,iDAAiD;AACjD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAAA;KAAE,CAAC,CAAA;IAC/E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAC3E,kGAAkG;IAClG,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC9B,uGAAuG;IACvG,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,SAAS,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IACtF,0FAA0F;IAC1F,KAAK,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC,CAAA;CAC9E;AAED,0HAA0H;AAC1H,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEvE,eAAO,MAAM,iBAAiB,EAAE,gBAA8H,CAAA;AAoE9J,mFAAmF;AACnF,qBAAa,gBAAgB;IAGf,QAAQ,CAAC,IAAI,EAAE,cAAc;IAFzC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE,cAAc;IAezC;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;KAAE,GAAG;QACxE,MAAM,EAAE,gBAAgB,CAAA;QACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;YAAC,MAAM,EAAE,gBAAgB,CAAA;SAAE,CAAC,CAAA;QACxF,UAAU,EAAE,oBAAoB,EAAE,CAAA;QAClC,YAAY,EAAE,oBAAoB,EAAE,CAAA;KACrC;IAsCD,wGAAwG;IACxG,OAAO,CAAC,OAAO;CA+BhB"}

package/dist-types/figure/figure-inputs.d.ts

@@ -0,0 +1,62 @@
+import { type FigureAsset, type FigureDataPlan, type FigureDataValue, type FigureDataValueIssue, type FigureMotionPlan, type FigureMotionSettingResolved } from '@hatiolab/figure-model';
+import { type FigureDataResult, type FigureDataSource } from './figure-data-reading.js';
+/** Why something given to the figure was not taken: the code and reason, and the values it named. */
+export interface FigureRuntimeIssue {
+    /** Which input it came from: the live data, the saved values, or the saved motion settings. */
+    source: 'live' | 'manual' | 'motion';
+    code: 'DATA_INTERFACE' | 'DATA_VALUE' | 'MOTION_SETTING';
+    reason: string;
+    issues?: FigureDataValueIssue[];
+    group?: string;
+}
+/** What a call did: taken, refused with why, or skipped as older than what was already taken. */
+export interface FigureApplyResult {
+    accepted: boolean;
+    skipped?: boolean;
+    issues: FigureRuntimeIssue[];
+}
+export declare class FigureInputs {
+    readonly asset: FigureAsset;
+    readonly dataPlan: FigureDataPlan | null;
+    readonly motionPlan: FigureMotionPlan;
+    private readonly reader;
+    private live;
+    private liveEpoch;
+    private manualValues;
+    private manualMotion;
+    private result;
+    private values;
+    private motionSettings;
+    private refused;
+    constructor(asset: FigureAsset);
+    /**
+     * The component's data, whole. `null` or `undefined` lets go of it. Data with any value the figure cannot take is
+     * refused whole and the last good result stays. A figure that declares no data takes none and says nothing of it:
+     * `data` is the component's, and a board may hold anything there. `epoch`, when given, refuses nothing older than the
+     * last taken (a late answer).
+     */
+    setData(data: unknown, epoch?: number): FigureApplyResult;
+    /**
+     * The saved values and motion settings, as the board holds them. A set the figure cannot take is refused and the one
+     * before stays; the other of the two is still taken.
+     */
+    setManual(settings: {
+        figureValues?: unknown;
+        motion?: unknown;
+    }): FigureApplyResult;
+    /** What the figure's data moves now. */
+    get data(): FigureDataResult;
+    /** Each binding's value now and where it came from, by binding id. */
+    get dataValues(): Readonly<Record<string, {
+        value: FigureDataValue | undefined;
+        source: FigureDataSource;
+    }>>;
+    /** Each motion group's clip, speed and pause now, and whether the data or the board chose them. */
+    get motion(): Readonly<Record<string, FigureMotionSettingResolved>>;
+    /** Why the last things given were refused; empty when all were taken. */
+    diagnostics(): readonly FigureRuntimeIssue[];
+    private refuse;
+    private clear;
+    private recompute;
+}
+//# sourceMappingURL=figure-inputs.d.ts.map

package/dist-types/figure/figure-inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-inputs.d.ts","sourceRoot":"","sources":["../../src/figure/figure-inputs.ts"],"names":[],"mappings":"AAkBA,OAAO,EAKL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EAErB,KAAK,2BAA2B,EACjC,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAuC,KAAK,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE5H,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,+FAA+F;IAC/F,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpC,IAAI,EAAE,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,CAAA;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,oBAAoB,EAAE,CAAA;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAC7B;AAID,qBAAa,YAAY;IAaX,QAAQ,CAAC,KAAK,EAAE,WAAW;IAZvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAA;IACxC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAA;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,YAAY,CAAmD;IACvE,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,MAAM,CAAuF;IACrG,OAAO,CAAC,cAAc,CAAkD;IACxE,OAAO,CAAC,OAAO,CAA2B;gBAErB,KAAK,EAAE,WAAW;IAOvC;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,iBAAiB;IAmBzD;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,iBAAiB;IA4BpF,wCAAwC;IACxC,IAAI,IAAI,IAAI,gBAAgB,CAE3B;IAED,sEAAsE;IACtE,IAAI,UAAU,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,eAAe,GAAG,SAAS,CAAC;QAAC,MAAM,EAAE,gBAAgB,CAAA;KAAE,CAAC,CAAC,CAE3G;IAED,mGAAmG;IACnG,IAAI,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAElE;IAED,yEAAyE;IACzE,WAAW,IAAI,SAAS,kBAAkB,EAAE;IAI5C,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,SAAS;CAQlB"}

package/dist-types/figure/figure-instance.d.ts

@@ -3,6 +3,7 @@ import Shape from '../components/shape.js';
 import type { SceneRenderContext } from '../interfaces/rendering.js';
 import type { IRealObject } from '../interfaces/real-object.js';
 import type { ComponentNature } from '../interfaces/types.js';
+import { FigureInputs } from './figure-inputs.js';
 declare const FigureInstance_base: {
     new (...args: any[]): {
         contains(x: number, y: number): boolean;
@@ -274,10 +275,21 @@ export declare class FigureInstance extends FigureInstance_base {
      *   figure's own value;
      * - its state values, the joints and other moving inputs -- \`state.parameters\`, with unit, range and the figure's
      *   resting value;
-     * - its clips -- \`state.clips\`, clip name → playback speed 0–3 (as the figure modeller plays it), 0 or empty stopped.
+     * - its clips in no motion group -- \`state.clips\`, clip name → playback speed 0–3 (as the figure modeller plays it),
+     *   0 or empty stopped;
+     * - the values its data bindings read, set by hand -- \`state.figureValues\`, by accessor, a number, a checkbox or a
+     *   choice each (ADR-0051 §8);
+     * - its motion groups -- \`state.motion\`, per group the clip, the speed 0–3 and a pause (ADR-0051 §3.2).
      * A map the figure has nothing for is not offered.
      */
     get nature(): ComponentNature;
+    private _inputs?;
+    /**
+     * What this figure is given to run by: its \`data\`, the saved values and motion settings, and what they move
+     * (\`FigureInputs\`). One per instance and registered asset; another release of the type starts it again from the
+     * component's state, so a late answer for the asset before is not taken.
+     */
+    get figureInputs(): FigureInputs | undefined;
     buildRealObject(): IRealObject | undefined;
     render(ctx: SceneRenderContext): void;
     private _top?;

package/dist-types/figure/figure-instance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-instance.d.ts","sourceRoot":"","sources":["../../src/figure/figure-instance.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,KAAK,MAAM,wBAAwB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8C7D,qBAAa,cAAe,SAAQ,mBAAe;IACjD;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBjG;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAEzB,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB;;;;;;;;OAQG;IACH,IAAI,MAAM,IAAI,eAAe,CAuB5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAkC9B,OAAO,CAAC,IAAI,CAAC,CAAsC;IAEnD;;;OAGG;IACH,OAAO,CAAC,OAAO;IAQf,sDAAsD;IACtD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAQD,YAAY,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO;;;;;;IAkBjH,KAAK,CAAC,MAAM,EAAE,GAAG;IAKjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAShE,4EAA4E;IAC5E,OAAO,CAAC,cAAc;IAgBtB,uEAAuE;IACvE,OAAO,CAAC,WAAW;IAiBnB;;;;OAIG;IACM,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAGvD;AAMD,eAAe,cAAc,CAAA"}
+{"version":3,"file":"figure-instance.d.ts","sourceRoot":"","sources":["../../src/figure/figure-instance.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,4BAA4B,CAAA;AAClD,OAAO,KAAK,MAAM,wBAAwB,CAAA;AAE1C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAQ7D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCjD,qBAAa,cAAe,SAAQ,mBAAe;IACjD;;;OAGG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAwBjG;;;;;;;;;OASG;IACH,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAEzB,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB;;;;;;;;;;;;OAYG;IACH,IAAI,MAAM,IAAI,eAAe,CA2C5B;IAED,OAAO,CAAC,OAAO,CAAC,CAA+C;IAE/D;;;;OAIG;IACH,IAAI,YAAY,IAAI,YAAY,GAAG,SAAS,CAU3C;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAkC9B,OAAO,CAAC,IAAI,CAAC,CAAsC;IAEnD;;;OAGG;IACH,OAAO,CAAC,OAAO;IAUf,sDAAsD;IACtD,IAAI,UAAU,IAAI,MAAM,GAAG,SAAS,CAGnC;IAQD,YAAY,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO;;;;;;IAkBjH,KAAK,CAAC,MAAM,EAAE,GAAG;IAKjB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAchE,4EAA4E;IAC5E,OAAO,CAAC,cAAc;IAgBtB,uEAAuE;IACvE,OAAO,CAAC,WAAW;IAiBnB;;;;OAIG;IACM,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAGvD;AAMD,eAAe,cAAc,CAAA"}

package/dist-types/figure/figure-real-object.d.ts

@@ -1,8 +1,28 @@
 import * as THREE from 'three';
 import { RealObject } from '../threed/real-object.js';
 import type { Properties } from '../interfaces/types.js';
-import { type FigureRenderLevel } from '@hatiolab/figure-model';
+import { type FigureItemSeat, type FigureRenderLevel } from '@hatiolab/figure-model';
 import { type RegisteredFigureFigure } from './figure-registry.js';
+import type { FigureRuntimeIssue } from './figure-inputs.js';
+/** Where a thing held at a place hangs, as \`attachPointFor\` answers a holder. */
+export interface FigurePlaceAttachment {
+    attach: THREE.Object3D;
+    localPosition: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    localRotation?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    carryPolicy?: string;
+    /** A uniform scale only for showing it inside its slot; never its size. */
+    displayScale?: number;
+    /** For a slot of the layout: where it is shown and what its slot says of it at full size. */
+    seat?: FigureItemSeat;
+}
 export declare class FigureRealObject extends RealObject<THREE.Group> {
     private rig;
     private unsubscribe?;
@@ -16,6 +36,33 @@ export declare class FigureRealObject extends RealObject<THREE.Group> {
     get figure(): RegisteredFigureFigure | null;
     protected getObject3dInstance(): THREE.Group;
     build(): void;
+    /** What the component's inputs give, handed to the rig: the data's state values and colours, each group's setting. */
+    private applyInputs;
+    /**
+     * Where the data says the figure stands (a pose binding, ADR-0051 §8): on the board's plan its centre at x and z, its
+     * rotation at the heading, its height at y -- in the board's units, which a figure's box shares with its mm. Each axis
+     * goes from where it stands now to the new value over the binding's seconds; a new value part-way starts again from
+     * where it is, as a site's position reports arrive. Zero seconds puts it there at once.
+     */
+    private poseRuns;
+    private aimPose;
+    /** The figure's pose now, from its component: plan centre, rotation in degrees, height. */
+    private poseNow;
+    private writePose;
+    /** One frame of every pose axis on its way; whether one moved. */
+    private advancePose;
+    /** Why the last data or settings given were not taken; empty when all were. */
+    get inputIssues(): readonly FigureRuntimeIssue[];
+    /** Each motion group as it plays here: its clip, time, speed, pause, and whether a change is blending. */
+    get motionRuns(): Record<string, {
+        clip: string;
+        time: number;
+        speed: number;
+        paused: boolean;
+        blending: boolean;
+    }>;
+    /** The group's clip from its time 0 again, blending from where it stands. Not saved: a board's button, not its value. */
+    restartMotion(group: string): boolean;
     /** The instance's design values: \`state.designInputs\`, input → value, for the inputs the figure publishes (ADR-0096). */
     get designInputs(): Record<string, unknown>;
     /** The instance's external state values: `state.parameters`, name → value in the input's unit. */
@@ -81,15 +128,23 @@ export declare class FigureRealObject extends RealObject<THREE.Group> {
      */
     placeAttachment(id: string, carrier?: {
         state?: Record<string, unknown>;
-    }): {
-        attach: THREE.Object3D;
-        localPosition: {
-            x: number;
-            y: number;
-            z: number;
-        };
-    } | undefined;
+    }): FigurePlaceAttachment | undefined;
+    /**
+     * A thing in a slot of the layout, seated by figure-model's one rule (\`figureItemSeatsOf\`): stacked on what the slot
+     * holds under it, turned with the slot, shrunk only to be shown inside it -- the verdict, at full size, goes with it as
+     * \`seat\`. A thing whose size, or the size of one under it, is not known stands at the slot's face, said unconfirmed.
+     * The thing's size is its state: width along x, depth up, height along z -- the figure's X, Y and Z.
+     */
+    private slotAttachment;
     clear(): THREE.Group;
+    /** Every held thing's object hanging inside the rig, moved onto this object where it stands: kept through a rebuild. */
+    private keepHeld;
+    /**
+     * Every thing the component holds seated again on this rig's places, through the one seating the component does
+     * (\`seatHeldItem\`). A thing whose place is not there any more stays where it stood, held and unplaced -- not dropped,
+     * not moved to another place.
+     */
+    private reseatHeld;
 }
 /**
  * The zPos of a figure hung from the ceiling: the number that puts the top of its box at the ceiling, in the scene's

package/dist-types/figure/figure-real-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-real-object.d.ts","sourceRoot":"","sources":["../../src/figure/figure-real-object.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"figure-real-object.d.ts","sourceRoot":"","sources":["../../src/figure/figure-real-object.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,EAAgF,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAmB,MAAM,wBAAwB,CAAA;AAEnL,OAAO,EAAa,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAI7E,OAAO,KAAK,EAAgB,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAO1E,mFAAmF;AACnF,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAA;IACtB,aAAa,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAClD,aAAa,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IACnD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,6FAA6F;IAC7F,IAAI,CAAC,EAAE,cAAc,CAAA;CACtB;AAED,qBAAa,gBAAiB,SAAQ,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,WAAW,CAAC,CAAa;IACjC,OAAO,CAAC,QAAQ,CAAI;IAEpB,IAAI,WAAW,IAAI,iBAAiB,CAEnC;IACD,IAAI,WAAW,IAAI,MAAM,CAExB;IACD,IAAI,mBAAmB,IAAI,MAAM,CAEhC;IACD,IAAI,QAAQ,IAAI,MAAM,GAAG,SAAS,CAEjC;IACD,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI;IAKzC,cAAc,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO;IAIjD,IAAI,MAAM,IAAI,sBAAsB,GAAG,IAAI,CAE1C;cAEkB,mBAAmB,IAAI,KAAK,CAAC,KAAK;IAI5C,KAAK,IAAI,IAAI;IAkBtB,sHAAsH;IACtH,OAAO,CAAC,WAAW;IAoBnB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,CAAsF;IAEtG,OAAO,CAAC,OAAO;IAkBf,2FAA2F;IAC3F,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,SAAS;IAYjB,kEAAkE;IAClE,OAAO,CAAC,WAAW;IAanB,+EAA+E;IAC/E,IAAI,WAAW,IAAI,SAAS,kBAAkB,EAAE,CAE/C;IAED,0GAA0G;IAC1G,IAAI,UAAU;;;;;;OAEb;IAED,yHAAyH;IACzH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAMrC,2HAA2H;IAC3H,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAG1C;IAED,kGAAkG;IAClG,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGvC;IAED,oGAAoG;IACpG,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAGvC;IAED,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAIrB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAc9D;;;OAGG;IACH,OAAO,CAAC,OAAO;IASf,sGAAsG;IACtG,YAAY,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI1D,kEAAkE;IAClE,IAAa,cAAc,IAAI,MAAM,CAEpC;IAED;;;OAGG;IACH,IAAa,aAAa,IAAI,MAAM,CAKnC;IAEQ,eAAe,IAAI,IAAI;IAOhC,oGAAoG;IACpG,OAAO,CAAC,IAAI;IAOZ;;;;;OAKG;IACH,OAAO,CAAC,IAAI;IAuBZ;;;OAGG;IACH,IAAI,UAAU,gDAEb;IAED,yFAAyF;IACzF,kBAAkB,IAAI,IAAI;IAM1B,0HAA0H;IAC1H,gBAAgB,IAAI,IAAI;IAMxB,oHAAoH;IACpH,WAAW,IAAI,IAAI;IAUnB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,YAAY;IAUpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAmBtB,OAAO,CAAC,OAAO;IAIf;;;;;OAKG;IACH,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,qBAAqB,GAAG,SAAS;IAgB7G;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAwBb,KAAK,IAAI,KAAK,CAAC,KAAK;IAa7B,wHAAwH;IACxH,OAAO,CAAC,QAAQ;IAUhB;;;;OAIG;IACH,OAAO,CAAC,UAAU;CAQnB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAUxG"}

package/dist-types/figure/figure-registry.d.ts

@@ -10,4 +10,9 @@ export declare function getFigure(type: string): RegisteredFigureFigure | null;
 export declare function hasFigure(type: string): boolean;
 export declare function unregisterFigure(type: string): boolean;
 export declare function resetFigures(): void;
+/**
+ * The component type that makes an item of a type a site's data names (ADR-0051 §8): a registered type of that name,
+ * else the registered figure whose carrier declaration (ADR-0123) says that code. Null when neither.
+ */
+export declare function figureTypeForItem(code: unknown): string | null;
 //# sourceMappingURL=figure-registry.d.ts.map

package/dist-types/figure/figure-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-registry.d.ts","sourceRoot":"","sources":["../../src/figure/figure-registry.ts"],"names":[],"mappings":"AAYA,OAAO,EAA8C,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAErG,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAEjF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,cAAc,CAAA;CACzB;AAID,0HAA0H;AAC1H,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,sBAAsB,CAOvF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAErE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}
+{"version":3,"file":"figure-registry.d.ts","sourceRoot":"","sources":["../../src/figure/figure-registry.ts"],"names":[],"mappings":"AAYA,OAAO,EAAoE,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAE3H,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAEjF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,cAAc,CAAA;CACzB;AAID,0HAA0H;AAC1H,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,sBAAsB,CAOvF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAErE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAM9D"}

package/dist-types/figure/figure-rig.d.ts

@@ -1,6 +1,6 @@
 import * as THREE from 'three';
 import { type FigureRenderLevel } from '@hatiolab/figure-model';
-import { type FigureAsset, type FigureAssetEvaluation, type FigureCapabilityChangesEvaluator, type FigureAssetGeometry, type FigureDriver } from '@hatiolab/figure-model';
+import { type FigureAsset, type FigureAssetEvaluation, type FigureCapabilityChangesEvaluator, type FigureAssetGeometry, type FigureDriver, type FigureMotionPlan, type FigureMotionSetting } from '@hatiolab/figure-model';
 import { type CompiledFigure } from './figure-compile-cache.js';
 /** The rig's own evaluator: one that tells an evaluation as its changes (figure-model docs/evaluation-changes-design.md). */
 type RigEvaluator = FigureCapabilityChangesEvaluator;
@@ -110,8 +110,21 @@ export declare class FigureRig {
     }>;
     /** External control sources, kept apart from what drivers compute: a connector's values, never a driver's. */
     private external;
-    /** Playback seconds per clip. A driver belongs to the clip its id starts with (`<clip>/<part>/<path>`). */
+    /** Playback seconds per clip in no motion group. A driver belongs to the clip it declares. */
     private clipTimes;
+    /**
+     * Each motion group as it plays here (ADR-0051 §3.2, detail design §5.2): the selected clip and its time, its speed and
+     * pause, and -- while a change of clip blends -- the pose it left and how long the blend has run. The asset's groups
+     * say which clips; which one plays, and when, is this instance's.
+     */
+    private readonly groupRuns;
+    /** The state values the figure's data interface gives, and whether each applies at once or travels there. */
+    private dataStates;
+    /** Where each commanded state stands on its way to its target: it moves at the input's sweep, from where it was. */
+    private readonly commanded;
+    /** Colours the data interface gives this instance by token; they win over the theme and the asset. */
+    private paletteOverrides;
+    private motionPlanOf?;
     private theme;
     private readonly merge;
     /**
@@ -203,6 +216,75 @@ export declare class FigureRig {
     static clipOf(driver: FigureDriver): string;
     /** The asset's clip names, in driver order. */
     get clips(): string[];
+    /** The asset's motion, ready to sample: its groups and the clips in none. Made once; the asset does not change under a rig. */
+    get motionPlan(): FigureMotionPlan;
+    /** The clips in no motion group: each plays on its own clock, at the board's speed for it (\`state.clips\`). */
+    get independentClips(): readonly string[];
+    /**
+     * Each motion group's setting, as resolved from the board and the data (\`resolveFigureMotionSettings\`). The first
+     * setting starts the group at its clip's time 0. Another clip starts at its time 0 and blends from the pose the group
+     * stands in now, over the group's transition; a change of clip during a blend blends from the blend. The same clip
+     * again changes nothing -- a restart is \`restartMotion\`. Speed and pause never touch the time.
+     */
+    setMotionSettings(settings: Record<string, FigureMotionSetting>): void;
+    /** The group's clip from its time 0 again, blending from where it stands. */
+    restartMotion(group: string): boolean;
+    /** The selected clip and time of each group, as it plays here. */
+    get motionRuns(): Record<string, {
+        clip: string;
+        time: number;
+        speed: number;
+        paused: boolean;
+        blending: boolean;
+    }>;
+    /**
+     * The state values the data interface gives (\`evaluateFigureDataInterface\`). An observed one applies at once; a
+     * commanded one travels from where the state stands now to its target at the input's sweep (\`advanceStateValue\`),
+     * and a new target part-way continues from where it is.
+     */
+    setDataStates(states: Record<string, {
+        value: number;
+        sourceMode: 'observed' | 'commanded';
+    }>): void;
+    /**
+     * One frame of what the rig moves by time itself: each playing group's clip and blend, and each commanded state on its
+     * way. A paused group or one at speed 0 holds its time and its blend. The clips in no group are the caller's (\`setClipTime\`).
+     * Whether anything moved.
+     */
+    advance(dtSeconds: number): boolean;
+    /** Whether time moves anything here now: a group playing, or a commanded state not yet at its target. */
+    get moving(): boolean;
+    /**
+     * What the clips give now: every clip in no group at its own time, every group's selected clip at its time -- a state of
+     * the group the clip does not write at its default -- and a group in the middle of a change blended from the pose it
+     * left, straight by the share of its transition run (figure-model's \`sampleFigureMotion\`, \`blendFigureMotion\`).
+     */
+    private drivenValues;
+    /**
+     * This instance's colours by token, from its data (ADR-0051 §2.2): the whole map, a token left out back to the theme's
+     * or the asset's. The meshes take a material of the new colour from the bank; the shared material of the old one is
+     * not changed, so no other instance changes colour with this one.
+     */
+    setPaletteOverrides(colours: Record<string, string>): void;
+    /**
+     * Effects a status gives parts of this instance (status-template design §6): a part blinks -- shown dark half of each
+     * cycle -- or glows in its colour. The whole map; a part left out shows plainly again.
+     */
+    setPartEffects(effects: Record<string, {
+        kind: 'blink' | 'glow';
+        hz?: number;
+    } | null | undefined>): void;
+    private partEffects;
+    private effectClock;
+    private blinkDark;
+    /** The effect on the part a body draws: by the part's id, its copies too (the id and a mark after it). */
+    private effectOf;
+    /** One frame of the blinking: dark in the second half of each cycle. Whether it turned. */
+    private advanceEffects;
+    /** The colours this instance draws with by token: the asset's, under its data's. */
+    get palette(): Record<string, string>;
+    /** Every drawn mesh takes the material its body is drawn with now. A body standing in for a mesh file keeps it hidden. */
+    private repaint;
     /** Playback time in seconds of one clip. Each driver is evaluated at its own clip's time. */
     setClipTime(clip: string, seconds: number): void;
     /** The playback time of one clip, 0 before it has moved. */
@@ -210,9 +292,9 @@ export declare class FigureRig {
     /** One time for every clip, for readers that have a single clock. */
     setTime(seconds: number): void;
     /**
-     * The state overrides for this moment: each driver at its clip's time, then the external values over them. One
-     * active source per state: an external value masks the driver, and the clip's time keeps its own count, so when
-     * the external value is withdrawn the driver's value at the clip's current time shows again.
+     * The state overrides for this moment: the clips at their times, the data over them, the external values over both.
+     * One active source per state: an external value masks the data and the clips, and the clips' times keep their own
+     * count, so when the external value is withdrawn the next source's value at this moment shows again, at once.
      */
     stateOverrides(): Record<string, number>;
     private inputsRead;

package/dist-types/figure/figure-rig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-rig.d.ts","sourceRoot":"","sources":["../../src/figure/figure-rig.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"figure-rig.d.ts","sourceRoot":"","sources":["../../src/figure/figure-rig.ts"],"names":[],"mappings":"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"}

package/dist-types/figure/figure-status.d.ts

@@ -0,0 +1,32 @@
+import type { FigureStatusPort } from '@hatiolab/figure-model';
+import { type Legend } from '../components/data/legend.js';
+/** An effect a status gives its port's parts. `hz`: how often a blink turns on, 1 when not said. */
+export interface FigureStatusEffect {
+    kind: 'blink' | 'glow';
+    hz?: number;
+}
+/** What one status looks like: a colour, an effect, either or both. `effect: null` is none. */
+export interface FigureStatusLook {
+    color?: string;
+    effect?: FigureStatusEffect | null;
+}
+/** A status template: each code's look, and `default` for a code it does not name. */
+export interface FigureStatusTemplate {
+    states: Legend<FigureStatusLook>;
+}
+/** A consumer's own way to look up a status: a look, or undefined to leave it to the next. */
+export type FigureStatusResolver = (asked: {
+    component: any;
+    port: FigureStatusPort;
+    code: string;
+}) => FigureStatusLook | undefined;
+/** A consumer's resolver, asked before the board's templates. Returns what takes it away again. */
+export declare function registerFigureStatusResolver(resolver: FigureStatusResolver): () => void;
+/**
+ * The template a placement shows a port's status by: the one it chose (`state.statusTemplate`, a template or the name of
+ * one of the board's `statusTemplates`), else the board's default (`statusTemplate` on the board), else none.
+ */
+export declare function figureStatusTemplateOf(component: any): FigureStatusTemplate | undefined;
+/** A port's code as it shows: a consumer's resolver first, then the placement's template, then the board's. */
+export declare function resolveFigureStatus(component: any, port: FigureStatusPort, code: string): FigureStatusLook | undefined;
+//# sourceMappingURL=figure-status.d.ts.map

package/dist-types/figure/figure-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-status.d.ts","sourceRoot":"","sources":["../../src/figure/figure-status.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAiB,KAAK,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAEzE,oGAAoG;AACpG,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAA;IACtB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AACD,+FAA+F;AAC/F,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAA;CACnC;AACD,sFAAsF;AACtF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;CACjC;AAED,8FAA8F;AAC9F,MAAM,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE;IAAE,SAAS,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KAAK,gBAAgB,GAAG,SAAS,CAAA;AAIpI,mGAAmG;AACnG,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAMvF;AAID;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,GAAG,GAAG,oBAAoB,GAAG,SAAS,CAIvF;AAED,+GAA+G;AAC/G,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAOtH"}

package/dist-types/figure/figure-top-view.d.ts

@@ -12,5 +12,5 @@ export declare function figureTopView(figure: RegisteredFigureFigure, size: {
     x: number;
     y: number;
     z: number;
-} | null, scale?: number): FigureTopView;
+} | null, scale?: number, colours?: Record<string, string>): FigureTopView;
 //# sourceMappingURL=figure-top-view.d.ts.map

package/dist-types/figure/figure-top-view.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"figure-top-view.d.ts","sourceRoot":"","sources":["../../src/figure/figure-top-view.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAqB,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAGrH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAElE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AAE7C,kGAAkG;AAClG,eAAO,MAAM,UAAU,yBAAmB,CAAA;AAE1C;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAChD,KAAK,SAAI,GACR,aAAa,CAcf"}
+{"version":3,"file":"figure-top-view.d.ts","sourceRoot":"","sources":["../../src/figure/figure-top-view.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAqB,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAGrH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAElE,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,CAAA;AAE7C,kGAAkG;AAClG,eAAO,MAAM,UAAU,yBAAmB,CAAA;AAE1C;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,EAChD,KAAK,SAAI,EACT,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAM,GACnC,aAAa,CAef"}

package/dist-types/figure/index.d.ts

@@ -5,6 +5,9 @@
  * seam as it loads, so the instance is read first.
  */
 export * from './figure-instance.js';
+export * from './figure-inputs.js';
+export * from './figure-data-reading.js';
+export * from './figure-status.js';
 export * from './figure-capability.js';
 export * from './figure-palette.js';
 export * from './figure-component.js';

package/dist-types/figure/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/figure/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAA;AAKpC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,cAAc,sBAAsB,CAAA;AAKpC,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AACxG,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC1H,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/figure/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,0BAA0B,CAAA;AACxC,cAAc,oBAAoB,CAAA;AAKlC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AAErC,cAAc,sBAAsB,CAAA;AAKpC,OAAO,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAA;AACxG,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAC1H,OAAO,EAAE,cAAc,EAAE,2BAA2B,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAA"}

package/dist-types/items/items-data-binding.d.ts

@@ -13,6 +13,16 @@ interface FlowNodeShape {
 }
 export declare function ItemsDataBinding<TBase extends Ctor<FlowNodeShape>>(Base: TBase): {
     new (...args: any[]): {
+        /**
+         * Whether the records come from the component's `data` itself (a FlowNode: `data` is its records), or are given
+         * by the holder (`_reconcileItems` called with records it worked out -- a figure whose items its data bindings read,
+         * ADR-0051 §8). When not from `data`, `data` is left to the component and its getter and setter are not touched.
+         */
+        _itemsFromData(): boolean;
+        /** The key a held item is matched by: its slot by default, as `_recordKey` reads a record's. */
+        _currentKeyOf(carrier: any): string | null;
+        /** Items matched by id rather than by slot: an item keeps itself while it changes slot, and may move between holders. */
+        _keyedById(): boolean;
         /**
          * 로드 시 model.data(records) → _items materialize.
          *
@@ -52,6 +62,8 @@ export declare function ItemsDataBinding<TBase extends Ctor<FlowNodeShape>>(Base
          */
         set data(records: ReadonlyArray<SlotRecord> | any);
         _reconcileItems(records: ReadonlyArray<SlotRecord>): void;
+        /** The held items put in the records' order, slot by slot, and each seated again where that order stands it. */
+        _orderItemsAs(keys: string[]): void;
         _exportSlotRecords(): SlotRecord[];
         /**
          * record 정체성 key — default = `slotId`. holder 가 carrier ID 기반 추적 원하면