@hatiolab/things-scene 10.1.59 → 10.1.61

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

@@ -24,7 +24,7 @@
  */
 import Component from '../components/component.js';
 import type { SlotDef } from '../transfer/types.js';
-import type { FigureCapability, V3BindingDeclaration } from '@hatiolab/figure-model';
+import type { FigureCapability, FigureBindingDeclaration } from '@hatiolab/figure-model';
 type Ctor<T = object> = new (...args: any[]) => T;
 /**
  * 저작이 고를 수 있는 능력 — **목록은 형식이 갖는다.**
@@ -49,10 +49,10 @@ export declare const CAPABILITY_MIXINS: Readonly<Record<FigureCapabilityName, (b
 /** 저작 화면이 사다리를 그릴 때 쓰는 설명. 모델러의 「능력」 탭이 읽는다. */
 export declare const FIGURE_CAPABILITY_NOTES: Readonly<Record<FigureCapabilityName, string>>;
 /**
- * A V3 figure's places (`capabilities.bindings`, a seat or a grip) as the scene's `SlotDef`. What a place takes is
- * always named in V3, so `allowedTypes` is always written; how many it holds is its capacity.
+ * A figure's places (`capabilities.bindings`, a seat or a grip) as the scene's `SlotDef`. What a place takes is
+ * always named, so `allowedTypes` is always written; how many it holds is its capacity.
  */
-export declare function slotsFromBindings(bindings: readonly V3BindingDeclaration[]): SlotDef[];
+export declare function slotsFromBindings(bindings: readonly FigureBindingDeclaration[]): SlotDef[];
 /**
  * 선언한 능력으로 클래스를 조립한다. 같은 조합이면 같은 클래스를 돌려준다.
  *

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;AAGnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAGpF,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,oBAAoB,EAAE,GAAG,OAAO,EAAE,CAEtF;AAqCD;;;;;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;AAKlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAGnD,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,wBAAwB,EAAE,GAAG,OAAO,EAAE,CAE1F;AAqCD;;;;;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"}

package/dist-types/figure/{v3/figure-v3-compile-cache.d.ts → figure-compile-cache.d.ts}

@@ -1,29 +1,29 @@
-import { type V3Appearance, type V3Asset, type V3CompiledAsset, type V3CompiledCapabilities } from '@hatiolab/figure-model';
+import { type FigureAppearance, type FigureAsset, type FigureCompiledAsset, type FigureCompiledCapabilities } from '@hatiolab/figure-model';
 /** FNV-1a over the canonical JSON, twice with different seeds, as 16 hex characters. Content only, no identity. */
-export declare function fingerprintV3Asset(asset: V3Asset): string;
-export interface CompiledV3 {
+export declare function fingerprintFigureAsset(asset: FigureAsset): string;
+export interface CompiledFigure {
     key: string;
     fingerprint: string;
     kernel: string;
-    /** The asset compiled at its stored inputs: what `compileV3Asset` gives, validated as a whole. */
-    compiled: V3CompiledAsset;
+    /** The asset compiled at its stored inputs: what `compileFigureAsset` gives, validated as a whole. */
+    compiled: FigureCompiledAsset;
     /**
      * The document compiled on its own, evaluated with **every** input (size and state) per instance. The asset
      * level fixes the design inputs at compile time, which is right for storage and wrong for a board where one
      * asset stands at many sizes; the document level is what the renderer evaluates.
      */
-    document: V3CompiledCapabilities;
+    document: FigureCompiledCapabilities;
     /** Appearance by placing node id (a `place@1` id or a repeated `member@1` id). */
-    looks: Map<string, V3Appearance>;
+    looks: Map<string, FigureAppearance>;
     /** Value reference → the node that writes it, for mapping a repeated copy's `key` to its member. */
     writers: Map<string, string>;
     /** A frozen copy of the source the result was compiled from; the caller's object may go on changing. */
-    asset: V3Asset;
+    asset: FigureAsset;
 }
 /** The cache key for an asset with this kernel: fingerprint and kernel version, nothing about the instance. */
-export declare function v3CompileKey(asset: V3Asset): string;
-/** The compiled asset for this content under this kernel, compiled once. Throws what `compileV3Asset` throws. */
-export declare function compiledV3Of(asset: V3Asset): CompiledV3;
-export declare function v3CompileCacheSize(): number;
-export declare function resetV3CompileCache(): void;
-//# sourceMappingURL=figure-v3-compile-cache.d.ts.map
+export declare function figureCompileKey(asset: FigureAsset): string;
+/** The compiled asset for this content under this kernel, compiled once. Throws what `compileFigureAsset` throws. */
+export declare function compiledFigureOf(asset: FigureAsset): CompiledFigure;
+export declare function figureCompileCacheSize(): number;
+export declare function resetFigureCompileCache(): void;
+//# sourceMappingURL=figure-compile-cache.d.ts.map

package/dist-types/figure/figure-compile-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-compile-cache.d.ts","sourceRoot":"","sources":["../../src/figure/figure-compile-cache.ts"],"names":[],"mappings":"AAcA,OAAO,EAAoE,KAAK,gBAAgB,EAAE,KAAK,WAAW,EAAE,KAAK,mBAAmB,EAAE,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAe7M,mHAAmH;AACnH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAWjE;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,sGAAsG;IACtG,QAAQ,EAAE,mBAAmB,CAAA;IAC7B;;;;OAIG;IACH,QAAQ,EAAE,0BAA0B,CAAA;IACpC,kFAAkF;IAClF,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;IACpC,oGAAoG;IACpG,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,wGAAwG;IACxG,KAAK,EAAE,WAAW,CAAA;CACnB;AAKD,+GAA+G;AAC/G,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAE3D;AAED,qHAAqH;AACrH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CA0BnE;AAED,wBAAgB,sBAAsB,IAAI,MAAM,CAE/C;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C"}

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

@@ -0,0 +1,11 @@
+import * as THREE from 'three';
+import type { FigureShape } from '@hatiolab/figure-model';
+/** The shared geometry for a body. Call `releaseFigureGeometry` with the same shape when the mesh goes away. */
+export declare function acquireFigureGeometry(shape: FigureShape, segments?: number): THREE.BufferGeometry;
+export declare function releaseFigureGeometry(geometry: THREE.BufferGeometry): void;
+/** How many distinct bodies are held. For tests and for the maturity numbers. */
+export declare function figureGeometryCount(): number;
+export declare function resetFigureGeometry(): void;
+/** Builds a body centred in its own frame, as the contract defines it. Not cached; use `acquireFigureGeometry`. */
+export declare function buildFigureGeometry(shape: FigureShape, segments?: number): THREE.BufferGeometry;
+//# sourceMappingURL=figure-geometry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-geometry.d.ts","sourceRoot":"","sources":["../../src/figure/figure-geometry.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAiBzD,gHAAgH;AAChH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,GAAE,MAAyB,GAAG,KAAK,CAAC,cAAc,CAWnH;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAS1E;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAG1C;AAED,mHAAmH;AACnH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,GAAE,MAAyB,GAAG,KAAK,CAAC,cAAc,CA6DjH"}

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

@@ -251,7 +251,7 @@ declare const FigureInstance_base: {
 } & typeof Shape;
 export declare class FigureInstance extends FigureInstance_base {
     /**
-     * Registers FigureInstance as what draws this type. `registerFigureV3()` calls it, so registering the asset and
+     * Registers FigureInstance as what draws this type. `registerFigure()` calls it, so registering the asset and
      * registering the component type always happen together and a board that names only `type` stands up.
      */
     static registerType(type: string, capabilities?: readonly string[], placement?: string): void;
@@ -262,12 +262,17 @@ export declare class FigureInstance extends FigureInstance_base {
      * `classFields` 로 보인다(`types/capability.ts`). 같은 낱말·같은 자리에 두어 그쪽이 읽을 수
      * 있게 한다(ADR-0045).
      *
-     * What draws uses `FigureV3RealObject.effectiveZPos`, which reads the asset itself; this is where **the outside can
+     * What draws uses `FigureRealObject.effectiveZPos`, which reads the asset itself; this is where **the outside can
      * ask**.
      */
     static placement?: string;
     get hasTextProperty(): boolean;
     is3dish(): boolean;
+    /**
+     * The component's properties: the design values the figure publishes, as one map (ADR-0096) -- \`state.designInputs\`,
+     * edited by the general \`number-map\` editor, each value with its name, unit, range and the figure's own value. A
+     * figure that publishes none has no properties of its own.
+     */
     get nature(): ComponentNature;
     buildRealObject(): IRealObject | undefined;
     render(ctx: SceneRenderContext): void;

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":"AAIA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7D,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,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAkC9B,OAAO,CAAC,IAAI,CAAC,CAAsC;IAEnD;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAkBf,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":"AAIA,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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA+B7D,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;;;;OAIG;IACH,IAAI,MAAM,IAAI,eAAe,CAU5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAkC9B,OAAO,CAAC,IAAI,CAAC,CAAsC;IAEnD;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAkBf,uEAAuE;IACvE,OAAO,CAAC,WAAW;IAiBnB;;;;OAIG;IACM,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAGvD;AAMD,eAAe,cAAc,CAAA"}

package/dist-types/figure/{v3/figure-v3-part-component.d.ts → figure-part-component.d.ts}

@@ -1,12 +1,12 @@
 import * as THREE from 'three';
-import Component from '../../components/component.js';
-import Shape from '../../components/shape.js';
-import type { SceneRenderContext } from '../../interfaces/rendering.js';
-import type { IRealObject } from '../../interfaces/real-object.js';
-import type { ComponentNature, Properties } from '../../interfaces/types.js';
-import { RealObject } from '../../threed/real-object.js';
+import Component from '../components/component.js';
+import Shape from '../components/shape.js';
+import type { SceneRenderContext } from '../interfaces/rendering.js';
+import type { IRealObject } from '../interfaces/real-object.js';
+import type { ComponentNature, Properties } from '../interfaces/types.js';
+import { RealObject } from '../threed/real-object.js';
 /** The shape figure-model evaluated for this body. */
-export interface FigureV3PartShape {
+export interface FigurePartShape {
     provider: string;
     dimensions: Record<string, number>;
     profile?: Array<{
@@ -15,8 +15,8 @@ export interface FigureV3PartShape {
         y: number;
     }>;
 }
-export interface FigureV3PartState {
-    shape?: FigureV3PartShape;
+export interface FigurePartState {
+    shape?: FigurePartShape;
     segments?: number;
     /** The body's colour, resolved by the modeller. */
     color?: string;
@@ -32,12 +32,12 @@ export interface FigureV3PartState {
  * The body's geometry, centred on its bounding box and brought to a unit box, with the box's extents. Geometry with
  * no extent on an axis (a flat face) keeps 1 there so nothing divides by zero.
  */
-export declare function unitV3PartGeometry(shape: FigureV3PartShape, segments?: number): {
+export declare function unitFigurePartGeometry(shape: FigurePartShape, segments?: number): {
     geometry: THREE.BufferGeometry;
     extent: THREE.Vector3;
     centre: THREE.Vector3;
 } | null;
-export declare class FigureV3PartRealObject extends RealObject {
+export declare class FigurePartRealObject extends RealObject {
     private mesh?;
     build(): void;
     clear(): THREE.Object3D<THREE.Object3DEventMap>;
@@ -46,7 +46,7 @@ export declare class FigureV3PartRealObject extends RealObject {
     updateDimension(): void;
     private material;
 }
-declare const FigureV3Part_base: {
+declare const FigurePart_base: {
     new (...args: any[]): {
         contains(x: number, y: number): boolean;
         get path(): {
@@ -85,8 +85,8 @@ declare const FigureV3Part_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: import("../../types/component.js").Container): void;
-        removed(parent: import("../../types/component.js").Container): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
@@ -99,7 +99,7 @@ declare const FigureV3Part_base: {
         get disposed(): boolean;
         isLayer(): boolean;
         isGroup(): boolean;
-        isContainer(): this is import("../../types/component.js").Container;
+        isContainer(): this is import("../types/component.js").Container;
         isLine(): boolean;
         isRoot(): boolean;
         isRootModel(): boolean;
@@ -115,20 +115,20 @@ declare const FigureV3Part_base: {
         get(property: string): any;
         set(props: any, propval?: any): any;
         getState(property: string): any;
-        setState(props: Partial<import("../../index.js").State> | string, propval?: any): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
-        get state(): import("../../index.js").State;
+        get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
         get volatile(): string[];
-        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../../components/component.js").ApplyPropsOptions): /*elided*/ any;
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../components/component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;
         }, ...args: boolean[]): void;
         symmetryX(x?: number): void;
         symmetryY(y: number): void;
-        adjustResize(bounds: import("../../index.js").BOUNDS, origin_bounds: import("../../index.js").BOUNDS, diagonal: boolean): {
+        adjustResize(bounds: import("../index.js").BOUNDS, origin_bounds: import("../index.js").BOUNDS, diagonal: boolean): {
             left: any;
             top: any;
             width: any;
@@ -136,16 +136,16 @@ declare const FigureV3Part_base: {
         };
         adjustRotation(rotation: number, step: boolean): number;
         outline(progress: number): any;
-        get center(): import("../../index.js").POINT;
-        set center(p: import("../../index.js").POINT);
-        get location(): import("../../index.js").POINT;
-        set location(l: import("../../index.js").POINT);
-        get rotate(): import("../../index.js").POINT;
-        set rotate(r: import("../../index.js").POINT);
-        get dimension(): import("../../index.js").DIMENSION;
-        set dimension(d: import("../../index.js").DIMENSION);
-        get drawPath(): import("../../index.js").POINT[];
-        get rotatePoint(): import("../../index.js").POINT;
+        get center(): import("../index.js").POINT;
+        set center(p: import("../index.js").POINT);
+        get location(): import("../index.js").POINT;
+        set location(l: import("../index.js").POINT);
+        get rotate(): import("../index.js").POINT;
+        set rotate(r: import("../index.js").POINT);
+        get dimension(): import("../index.js").DIMENSION;
+        set dimension(d: import("../index.js").DIMENSION);
+        get drawPath(): import("../index.js").POINT[];
+        get rotatePoint(): import("../index.js").POINT;
         get mutable(): boolean;
         get resizable(): boolean;
         get rotatable(): boolean;
@@ -182,12 +182,12 @@ declare const FigureV3Part_base: {
         get textSubstitutor(): () => string;
         get text(): string;
         set text(v: string);
-        get textBounds(): import("../../index.js").BOUNDS;
+        get textBounds(): import("../index.js").BOUNDS;
         get textRotation(): number;
         get textHidden(): boolean;
         set textHidden(v: boolean);
         get hasTextProperty(): boolean;
-        animate(opts: import("../../index.js").AnimationConfig): any;
+        animate(opts: import("../index.js").AnimationConfig): any;
         effect(context: SceneRenderContext, model: any): void;
         serialize(...others: any[]): string;
         trim(): void;
@@ -201,10 +201,10 @@ declare const FigureV3Part_base: {
         set tap(v: any);
         get mappings(): any[];
         get retention(): number;
-        get animation(): import("../../index.js").AnimationController | undefined;
+        get animation(): import("../index.js").AnimationController | undefined;
         get started(): boolean;
         set started(v: boolean);
-        get controls(): import("../../index.js").Control[] | undefined;
+        get controls(): import("../index.js").Control[] | undefined;
         findFirst(finder: string | ((c: Component) => boolean), ...others: any[]): Component | undefined;
         findAll(s: string | ((c: Component) => boolean), ...others: any[]): any[] | undefined;
         capture(x: number, y: number, except?: (c: Component) => boolean): any;
@@ -220,15 +220,15 @@ declare const FigureV3Part_base: {
         get capturable(): boolean;
         get position(): string;
         get origin(): string;
-        get offset(): import("../../index.js").POINT;
-        get app(): import("../../index.js").ApplicationContext;
+        get offset(): import("../index.js").POINT;
+        get app(): import("../index.js").ApplicationContext;
         drawEffect(context: SceneRenderContext): void;
         prepareFill(resolve: Function, reject: Function): void;
         prepareFillIf(condition: boolean): void;
         onchangeFill(after: Record<string, any>, before: Record<string, any>): void;
         drawImage(context: SceneRenderContext, image: HTMLImageElement, left: number, top: number, width: number, height: number): void;
-        mutateBounds(logic: ((bounds: import("../../index.js").BOUNDS) => import("../../index.js").BOUNDS | void) | null, context?: any): void;
-        mutatePath(beforeLogic: ((path: import("../../index.js").POINT[]) => import("../../index.js").POINT[] | void) | null, afterLogic: ((path: import("../../index.js").POINT[]) => import("../../index.js").POINT[] | void) | null, context?: any): void;
+        mutateBounds(logic: ((bounds: import("../index.js").BOUNDS) => import("../index.js").BOUNDS | void) | null, context?: any): void;
+        mutatePath(beforeLogic: ((path: import("../index.js").POINT[]) => import("../index.js").POINT[] | void) | null, afterLogic: ((path: import("../index.js").POINT[]) => import("../index.js").POINT[] | void) | null, context?: any): void;
         access(accessor: string): any;
         substitute(template: string, data: any): string | undefined;
         onchangeMappings(after: Record<string, any>, before: Record<string, any>): void;
@@ -237,29 +237,29 @@ declare const FigureV3Part_base: {
         executeMappings(force?: boolean): void;
         disposeMappings(): void;
         ondropfile(transfered: FileList, files: string[]): void;
-        transcoordS2P(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
-        transcoordP2S(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
-        transcoordS2T(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        transcoordT2P(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        transcoordT2S(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        transcoordS2TR(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        transcoordS2O(x: number, y: number, target: Component): import("../../index.js").POINT;
-        transcoordC2S(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        transcoordS2C(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        toParent(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
-        fromParent(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
-        toScene(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        fromScene(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        toLocal(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        toGlobal(x: number, y: number, top?: Component): import("../../index.js").POINT;
-        toOther(x: number, y: number, target: Component): import("../../index.js").POINT;
-        on<K extends keyof import("../../index.js").ComponentEventMap>(name: K, callback: (...args: import("../../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        transcoordS2P(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        transcoordP2S(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        transcoordS2T(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordT2P(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordT2S(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2TR(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2O(x: number, y: number, target: Component): import("../index.js").POINT;
+        transcoordC2S(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2C(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toParent(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        fromParent(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        toScene(x: number, y: number, top?: Component): import("../index.js").POINT;
+        fromScene(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toLocal(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toGlobal(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toOther(x: number, y: number, target: Component): import("../index.js").POINT;
+        on<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
         on(name: string | object, callback: Function, context?: any): /*elided*/ any;
-        off<K extends keyof import("../../index.js").ComponentEventMap>(name: K, callback?: ((...args: import("../../index.js").ComponentEventMap[K]) => void) | undefined, context?: any): /*elided*/ any;
+        off<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback?: ((...args: import("../index.js").ComponentEventMap[K]) => void) | undefined, context?: any): /*elided*/ any;
         off(name?: string | object, callback?: Function, context?: any): /*elided*/ any;
-        once<K extends keyof import("../../index.js").ComponentEventMap>(name: K, callback: (...args: import("../../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        once<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
         once(name: string | object, callback: Function, context?: any): /*elided*/ any;
-        trigger<K extends keyof import("../../index.js").ComponentEventMap>(name: K, ...args: import("../../index.js").ComponentEventMap[K]): /*elided*/ any;
+        trigger<K extends keyof import("../index.js").ComponentEventMap>(name: K, ...args: import("../index.js").ComponentEventMap[K]): /*elided*/ any;
         trigger(name: string, ...args: any[]): /*elided*/ any;
         delegate_on(delegator: any): /*elided*/ any;
         delegate_off(delegator: any): /*elided*/ any;
@@ -292,7 +292,7 @@ declare const FigureV3Part_base: {
         set element(_v: HTMLElement | null);
     };
 } & typeof Shape;
-export declare class FigureV3Part extends FigureV3Part_base {
+export declare class FigurePart extends FigurePart_base {
     static registerType(): void;
     get hasTextProperty(): boolean;
     is3dish(): boolean;
@@ -302,4 +302,4 @@ export declare class FigureV3Part extends FigureV3Part_base {
     render(ctx: SceneRenderContext): void;
 }
 export {};
-//# sourceMappingURL=figure-v3-part-component.d.ts.map
+//# sourceMappingURL=figure-part-component.d.ts.map

package/dist-types/figure/figure-part-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-part-component.d.ts","sourceRoot":"","sources":["../../src/figure/figure-part-component.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,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,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAkCrD,sDAAsD;AACtD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,EAAE,eAAe,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+CAA+C;IAC/C,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5C;AAOD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,eAAe,EACtB,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CAAE,GAAG,IAAI,CAoBzF;AAED,qBAAa,oBAAqB,SAAQ,UAAU;IAClD,OAAO,CAAC,IAAI,CAAC,CAAY;IAEzB,KAAK;IAaL,KAAK;IAOI,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAU9D,8GAA8G;IAC9G,eAAe,IAAI,IAAI;IAKvB,OAAO,CAAC,QAAQ;CAqBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBAAa,UAAW,SAAQ,eAAe;IAC7C,MAAM,CAAC,YAAY,IAAI,IAAI;IAI3B,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,kEAAkE;IAClE,MAAM,CAAC,GAAG,EAAE,kBAAkB;CAO/B"}

package/dist-types/figure/{v3/figure-v3-real-object.d.ts → figure-real-object.d.ts}

@@ -1,13 +1,15 @@
 import * as THREE from 'three';
-import { RealObject } from '../../threed/real-object.js';
-import type { Properties } from '../../interfaces/types.js';
-import { type RegisteredV3Figure } from './figure-v3-registry.js';
-export declare class FigureV3RealObject extends RealObject<THREE.Group> {
+import { RealObject } from '../threed/real-object.js';
+import type { Properties } from '../interfaces/types.js';
+import { type RegisteredFigureFigure } from './figure-registry.js';
+export declare class FigureRealObject extends RealObject<THREE.Group> {
     private rig;
     private unsubscribe?;
-    get figure(): RegisteredV3Figure | null;
+    get figure(): RegisteredFigureFigure | null;
     protected getObject3dInstance(): THREE.Group;
     build(): void;
+    /** 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. */
     get parameters(): Record<string, number>;
     /** The instance's playback speeds: `state.clips`, clip name → speed, 0 or absent stops the clip. */
@@ -31,7 +33,7 @@ export declare class FigureV3RealObject extends RealObject<THREE.Group> {
     /**
      * The asset frame rises from the floor -- its y = 0 is the bottom of the instance (ADR-0065) -- while the object3d
      * stands at the centre of the instance's box, as every real object does. The rig is lowered by half the instance's
-     * height so the figure stands on the box's bottom. Without it every V3 figure stood half its height in the air, on a
+     * height so the figure stands on the box's bottom. Without it every figure stood half its height in the air, on a
      * board and in the modeller's preview (user, 2026-09-24: 「왜 공중에 떠있는거지? 바닥기반인데」).
      */
     private seat;
@@ -39,7 +41,9 @@ export declare class FigureV3RealObject extends RealObject<THREE.Group> {
      * Where the board asked for a size the figure does not declare, the size it is drawn at instead -- per axis, empty
      * when it is drawn as asked. For a board to say so ("X 4000 → 2000, the largest it declares").
      */
-    get sizeClamps(): import("./figure-v3-rig.js").V3SizeClamp[];
+    get sizeClamps(): import("./figure-rig.js").FigureSizeClamp[];
+    /** Re-reads the design values: the instance is made again with them, once (ADR-0096). */
+    updateDesignInputs(): void;
     /** Re-reads the external state values. Clip times are untouched: a value written or withdrawn does not restart a clip. */
     updateParameters(): void;
     /** Re-reads the speeds. They are read every frame, so this only asks for a redraw once something may move again. */
@@ -76,4 +80,4 @@ export declare class FigureV3RealObject extends RealObject<THREE.Group> {
  * coordinate mode (`zPos` means the bottom in floor mode, the centre in space mode, the top when inverted).
  */
 export declare function ceilingZPos(mode: 'floor' | 'space' | 'inverted', ceiling: number, depth: number): number;
-//# sourceMappingURL=figure-v3-real-object.d.ts.map
+//# sourceMappingURL=figure-real-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-real-object.d.ts","sourceRoot":"","sources":["../../src/figure/figure-real-object.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGxD,OAAO,EAAa,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAG7E,qBAAa,gBAAiB,SAAQ,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAyB;IACpC,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,IAAI,MAAM,IAAI,sBAAsB,GAAG,IAAI,CAE1C;cAEkB,mBAAmB,IAAI,KAAK,CAAC,KAAK;IAI5C,KAAK,IAAI,IAAI;IActB,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;IAO9D,oHAAoH;IACpH,YAAY,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAO1D,IAAa,cAAc,IAAI,MAAM,CASpC;IAED;;;OAGG;IACH,IAAa,aAAa,IAAI,MAAM,CAKnC;IAEQ,eAAe,IAAI,IAAI;IAOhC;;;;;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;IAMnB,OAAO,CAAC,OAAO;IAMf,OAAO,CAAC,YAAY;IAUpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAgBtB,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;QAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;QAAC,aAAa,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAAG,SAAS;IAa7J,KAAK,IAAI,KAAK,CAAC,KAAK;CAO9B;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

@@ -0,0 +1,13 @@
+import { type FigureAsset } from '@hatiolab/figure-model';
+import { type CompiledFigure } from './figure-compile-cache.js';
+export interface RegisteredFigureFigure {
+    type: string;
+    compiled: CompiledFigure;
+}
+/** Registers a asset under a figure type. Compiles it (or reuses the cache) so a bad asset fails here, not on a board. */
+export declare function registerFigure(type: string, asset: FigureAsset): RegisteredFigureFigure;
+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;
+//# sourceMappingURL=figure-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-registry.d.ts","sourceRoot":"","sources":["../../src/figure/figure-registry.ts"],"names":[],"mappings":"AAYA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAE7E,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"}

package/dist-types/figure/{v3/figure-v3-rig.d.ts → figure-rig.d.ts}

@@ -1,7 +1,7 @@
 import * as THREE from 'three';
-import { type V3Asset, type V3AssetEvaluation, type V3Driver } from '@hatiolab/figure-model';
-import { type CompiledV3 } from './figure-v3-compile-cache.js';
-export interface FigureV3RigOptions {
+import { type FigureAsset, type FigureAssetEvaluation, type FigureDriver } from '@hatiolab/figure-model';
+import { type CompiledFigure } from './figure-compile-cache.js';
+export interface FigureRigOptions {
     /**
      * A theme mapping: token → colour, replacing the asset's own snapshot where a token is present (designer's
      * ruling 5). Tokens the mapping does not name keep the asset's default.
@@ -14,15 +14,15 @@ export interface Vec3Like {
     z: number;
 }
 /** One axis a board asked for past what the figure declares it may be placed at, and the size it is drawn at. */
-export interface V3SizeClamp {
+export interface FigureSizeClamp {
     axis: 'x' | 'y' | 'z';
     asked: number;
     used: number;
     bound: 'min' | 'max';
 }
-export declare class FigureV3Rig {
+export declare class FigureRig {
     readonly group: THREE.Group<THREE.Object3DEventMap>;
-    readonly compiled: CompiledV3;
+    readonly compiled: CompiledFigure;
     private readonly meshes;
     /** One instanced mesh per batch of a row's copies, by the batch's key; \`ids\` is the copy drawn at each index. */
     private readonly batches;
@@ -30,6 +30,14 @@ export declare class FigureV3Rig {
     /** One node per place a thing is held (a seat or a grip), made when something first hangs from it. */
     private readonly places;
     private size;
+    /** The design values a board set for this instance, as accepted: public inputs only, within range (ADR-0096). */
+    private design;
+    /** Why the last design values set were not all taken: each value refused and the reason. Empty when all were. */
+    designRefused: Array<{
+        input: string;
+        value: unknown;
+        reason: string;
+    }>;
     /** 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>`). */
@@ -48,9 +56,9 @@ export declare class FigureV3Rig {
      */
     private planned?;
     /** The last evaluation, for readers that want the numbers behind the meshes. */
-    last: V3AssetEvaluation | null;
-    constructor(asset: V3Asset, options?: FigureV3RigOptions);
-    get asset(): V3Asset;
+    last: FigureAssetEvaluation | null;
+    constructor(asset: FigureAsset, options?: FigureRigOptions);
+    get asset(): FigureAsset;
     /** The size the asset was authored at: its stored `size.*` design inputs, or null when it is not resizable. */
     get base(): Vec3Like | null;
     /**
@@ -61,13 +69,21 @@ export declare class FigureV3Rig {
      */
     setSize(size: Vec3Like | null): void;
     /** The axes the last size was drawn at other than asked, empty when it was drawn as asked. */
-    clamped: V3SizeClamp[];
+    clamped: FigureSizeClamp[];
     /** The size it is drawn at: the one asked, within what the figure declares. Null at the authored size. */
     get drawnSize(): Vec3Like | null;
+    /**
+     * The design values a board sets for this instance (ADR-0096, \`state.designInputs\`): only the inputs the figure
+     * publishes, within their range. The whole set is tried first; if the figure cannot be made with it (a row past its
+     * limit), the previous values stay and \`designRefused\` says why. Not a per-frame path: a change re-evaluates once.
+     */
+    setDesignInputs(values: Record<string, unknown>): void;
+    /** The design values this instance evaluates with, as accepted. */
+    get designValues(): Record<string, number>;
     /** External control sources: state values a connector or the board wrote. These win over drivers. */
     setState(values: Record<string, number>): void;
     /** The playback group a driver belongs to, as the asset declares it. The id is opaque; nothing is read out of it. */
-    static clipOf(driver: V3Driver): string;
+    static clipOf(driver: FigureDriver): string;
     /** The asset's clip names, in driver order. */
     get clips(): string[];
     /** Playback time in seconds of one clip. Each driver is evaluated at its own clip's time. */
@@ -85,7 +101,7 @@ export declare class FigureV3Rig {
     /** The external values as last set, for readers that want to know what masks the drivers. */
     get externalState(): Record<string, number>;
     /** Evaluate at the current size, state and time, and bring the meshes up to date. */
-    update(): V3AssetEvaluation;
+    update(): FigureAssetEvaluation;
     /**
      * The node a held thing hangs from at one place (`capabilities.bindings`). It is a child of the group that every
      * update moves to the place's pose, so what hangs from it follows the part it sits on -- through the joints too --
@@ -114,7 +130,7 @@ export declare class FigureV3Rig {
      */
     /** The inputs this rig evaluates at now: the figure's defaults, its drivers and external values, and its size. */
     evaluationInputs(): Record<string, number>;
-    evaluate(): V3AssetEvaluation;
+    evaluate(): FigureAssetEvaluation;
     private colourOf;
     private materialFor;
     /** Meshes by body id, for tests and for bindings that need a part's mesh. */
@@ -123,4 +139,4 @@ export declare class FigureV3Rig {
     drawnIds(): string[];
     dispose(): void;
 }
-//# sourceMappingURL=figure-v3-rig.d.ts.map
+//# sourceMappingURL=figure-rig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-rig.d.ts","sourceRoot":"","sources":["../../src/figure/figure-rig.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAIL,KAAK,WAAW,EAChB,KAAK,qBAAqB,EAE1B,KAAK,YAAY,EAClB,MAAM,wBAAwB,CAAA;AAI/B,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAGjF,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED,iHAAiH;AACjH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,KAAK,GAAG,KAAK,CAAA;CACrB;AAED,qBAAa,SAAS;IACpB,QAAQ,CAAC,KAAK,sCAAoB;IAClC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAA;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,mHAAmH;IACnH,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0F;IAClH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAsB;IACpD,sGAAsG;IACtG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoC;IAC3D,OAAO,CAAC,IAAI,CAAwB;IACpC,iHAAiH;IACjH,OAAO,CAAC,MAAM,CAA6B;IAC3C,iHAAiH;IACjH,aAAa,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAK;IAC5E,8GAA8G;IAC9G,OAAO,CAAC,QAAQ,CAA6B;IAC7C,2GAA2G;IAC3G,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,KAAK,CAAwB;IACrC;;;OAGG;IACH,OAAO,CAAC,SAAS,CAAC,CAAqD;IACvE,+CAA+C;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqD;IAC/E;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAC,CAAwG;IACxH,gFAAgF;IAChF,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAAO;gBAE7B,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,gBAAqB;IAM9D,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,+GAA+G;IAC/G,IAAI,IAAI,IAAI,QAAQ,GAAG,IAAI,CAM1B;IAED;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;IAmBpC,8FAA8F;IAC9F,OAAO,EAAE,eAAe,EAAE,CAAK;IAE/B,0GAA0G;IAC1G,IAAI,SAAS,IAAI,QAAQ,GAAG,IAAI,CAE/B;IAED;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IA2BtD,mEAAmE;IACnE,IAAI,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEzC;IAED,qGAAqG;IACrG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9C,qHAAqH;IACrH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM;IAI3C,+CAA+C;IAC/C,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED,6FAA6F;IAC7F,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIhD,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI9B,qEAAqE;IACrE,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI9B;;;;OAIG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAkBxC,6FAA6F;IAC7F,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE1C;IAED,qFAAqF;IACrF,MAAM,IAAI,qBAAqB;IA2F/B;;;;OAIG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI;IAc5C,OAAO,CAAC,MAAM,CAAC,IAAI;IAKnB,uGAAuG;IACvG,OAAO,CAAC,MAAM;IAcd,uGAAuG;IACvG,OAAO,CAAC,MAAM,CAAC,QAAQ;IAMvB;;;OAGG;IACH,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAUvE,uGAAuG;IACvG,IAAI,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAIjE;IAED;;;OAGG;IACH,kHAAkH;IAClH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAU1C,QAAQ,IAAI,qBAAqB;IAqBjC,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAqBnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS;IAI1C,yHAAyH;IACzH,QAAQ,IAAI,MAAM,EAAE;IAMpB,OAAO,IAAI,IAAI;CAehB"}

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

@@ -10,7 +10,7 @@ import * as THREE from 'three';
  */
 export declare function pushed(shape: THREE.Shape, depth: number, lift: number): THREE.BufferGeometry;
 /**
- * A rounded rectangle whose corners have two semi-axes (V3 `rounded-box@2`, shape-dimension contract §1): each
+ * A rounded rectangle whose corners have two semi-axes (`rounded-box@2`, shape-dimension contract §1): each
  * corner is the quadratic Bézier from the end of one edge to the start of the next with the corner as control
  * point, `roundX` along X and `roundZ` along Z.
  */

package/dist-types/figure/{v3/figure-v3-top-view.d.ts → figure-top-view.d.ts}

@@ -1,4 +1,4 @@
-import type { RegisteredV3Figure } from './figure-v3-registry.js';
+import type { RegisteredFigureFigure } from './figure-registry.js';
 export interface FigureTopShape {
     /** The body it is. */
     id: string;
@@ -26,9 +26,9 @@ export declare function convexHull(points: ReadonlyArray<readonly [number, numbe
  * The figure's plan at a size (mm; null for its authored size). A body the asset does not show, or a shape with no
  * sample points, is left out.
  */
-export declare function figureTopView(figure: RegisteredV3Figure, size: {
+export declare function figureTopView(figure: RegisteredFigureFigure, size: {
     x: number;
     y: number;
     z: number;
 } | null): FigureTopView;
-//# sourceMappingURL=figure-v3-top-view.d.ts.map
+//# sourceMappingURL=figure-top-view.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-top-view.d.ts","sourceRoot":"","sources":["../../src/figure/figure-top-view.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAElE,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,gHAAgH;IAChH,OAAO,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAChC,mFAAmF;IACnF,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;IACrC,6DAA6D;IAC7D,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,gHAAgH;IAChH,IAAI,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CACjD;AAED,wGAAwG;AACxG,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAgBpG;AAKD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,sBAAsB,EAAE,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,GAAG,aAAa,CAoD7H"}