@hatiolab/things-scene 10.1.22 → 10.1.24

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;AAO7D,OAAO,EAAyD,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4E9G,qBAAa,cAAe,SAAQ,mBAAe;IACjD;;;;;OAKG;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;;;;;OAKG;IACH,IAAI,aAAa,IAAI,aAAa,CAUjC;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,0CAA0C;IAC1C,IAAI,MAAM,yDAET;IAED,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAoC9B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS;IAuDjB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IA2ChB,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IAgFlB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;;;OAKG;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;AAS7D,OAAO,EAAyD,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4E9G,qBAAa,cAAe,SAAQ,mBAAe;IACjD;;;;;OAKG;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;;;;;OAKG;IACH,IAAI,aAAa,IAAI,aAAa,CAUjC;IAED,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAM1C,0CAA0C;IAC1C,IAAI,MAAM,yDAET;IAED,MAAM,CAAC,GAAG,EAAE,kBAAkB;IAoC9B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;;;;;;;;;;;OAcG;IACH,OAAO,CAAC,SAAS;IAuDjB;;;;;OAKG;IACH,OAAO,CAAC,QAAQ;IA2ChB,0DAA0D;IAC1D,OAAO,CAAC,UAAU;IAgFlB;;;OAGG;IACH,OAAO,CAAC,aAAa;IAiBrB;;;;;OAKG;IACM,UAAU,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI;CAGvD;AAMD,eAAe,cAAc,CAAA"}

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

@@ -366,7 +366,7 @@ export declare class FigureRealObject extends RealObject {
      *
      * 청사진의 `placement` 는 좌표를 뒤집으라는 말이 아니라 **어느 면에 붙느냐**다. 컨베이어는
      * 바닥에 서고 OHT 는 천장에 매달린다. 높이 값 자체는 도형이 모르고 현장이 안다
-     * (`sceneHeights`). ADR-0045(`operato-twin/design/04-decisions.md`).
+     * (`sceneHeights`). ADR-0045(`operato-application/adr/ADR-0045.md`).
      *
      * 한동안 이 길이 없었다. `compile()` 이 `blueprint.placement` 를 적는데 이 폴더 전체에서
      * 그 낱말을 읽는 곳이 0 건이었고, 천정 기준으로 저작한 OHT 를 도면에 놓으면 바닥에 섰다.

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

@@ -53,6 +53,12 @@ export declare function registerFigure(blueprint: FigureBlueprint): PreparedFigu
  *
  * 팔레트가 바뀌었으면 색을 다시 푼 것을 돌려준다.
  */
+/**
+ * Registers the component type for a figure with its capability names and placement, through the class
+ * `useFigureComponent` supplied. `registerFigure` does this for a V2 blueprint; the V3 registry does it for a V3
+ * asset. One seam, two callers (ADR-0087 decision 5).
+ */
+export declare function registerFigureType(type: string, capabilities?: readonly string[], placement?: string): void;
 export declare function getFigure(type: string): PreparedFigure | null;
 /** 등록된 Figure 타입 이름들. */
 export declare function figureTypes(): string[];

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":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAI9B;;;;;;;;;;;GAWG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,qBAAqB,CAAA;IAC7B,KAAK,EAAE,oBAAoB,CAAA;IAC3B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,oBAAoB,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,eAAe,CAAA;IAC1B;;;;;;;;OAQG;IACH,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,wBAAwB;IACxB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAA;CACvB;AAUD,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEvD;AA4BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,eAAe,GAAG,cAAc,CAyBzE;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAW7D;AAED,yBAAyB;AACzB,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,qBAAqB;AACrB,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}
+{"version":3,"file":"figure-registry.d.ts","sourceRoot":"","sources":["../../src/figure/figure-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,uBAAuB,CAAA;AAI9B;;;;;;;;;;;GAWG;AAEH,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,qBAAqB,CAAA;IAC7B,KAAK,EAAE,oBAAoB,CAAA;IAC3B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,oBAAoB,CAAA;IAC3B,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,eAAe,CAAA;IAC1B;;;;;;;;OAQG;IACH,UAAU,EAAE,YAAY,EAAE,CAAA;IAC1B,wBAAwB;IACxB,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,+BAA+B;IAC/B,cAAc,EAAE,MAAM,CAAA;CACvB;AAUD,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAEvD;AA4BD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,eAAe,GAAG,cAAc,CAyBzE;AAED;;;;GAIG;AACH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,GAAE,SAAS,MAAM,EAAO,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAM/G;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAW7D;AAED,yBAAyB;AACzB,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,qBAAqB;AACrB,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

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

@@ -26,6 +26,16 @@ export interface FigureProfile {
  * 하나라는 규약을 지켜야 한다.
  */
 export declare function profileGeometry(profile: FigureProfile): THREE.BufferGeometry | null;
+/**
+ * 단면을 세워서 민다.
+ *
+ * `rotateX(+90°)` 는 (x, y, zz) → (x, −zz, y) 이므로 단면의 y 가 world z 로 가고
+ * (평면도가 맞다), 밀린 두께는 −Y 로 간다 — 즉 [−depth, 0] 에 놓인다.
+ *
+ * `lift` 는 그것을 어디로 올릴지다. 통짜는 반만 올려 가운데를 맞추고, 속을 판 것은
+ * 바닥과 벽을 따로 올려 포갠다.
+ */
+export declare function pushed(shape: THREE.Shape, depth: number, lift: number): THREE.BufferGeometry;
 /** 바깥 테. **부품 중심을 원점으로** 만든다 — 자리는 부르는 쪽이 든다. */
 export declare function outlineOf(profile: FigureProfile): THREE.Shape | null;
 /**
@@ -37,6 +47,12 @@ export declare function outlineOf(profile: FigureProfile): THREE.Shape | null;
  * 속을 판 것의 안쪽 테도 이것으로 만든다 — 같은 식으로 만들어야 바깥과 안쪽 모서리가
  * 같은 모양으로 따라온다.
  */
+/**
+ * A rounded rectangle whose corners have two semi-axes (V3 `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. `roundedRect` is the equal case.
+ */
+export declare function roundedRectXZ(width: number, depth: number, roundX: number, roundZ: number): THREE.Shape | null;
 export declare function roundedRect(width: number, depth: number, round: number): THREE.Shape | null;
 /**
  * 안쪽 테 — 바깥 테에서 벽 두께만큼 안으로 들어온 선.

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

@@ -1 +1 @@
-{"version":3,"file":"figure-shape.d.ts","sourceRoot":"","sources":["../../src/figure/figure-shape.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,SAAS;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1C,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CA2BnF;AAkBD,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAYpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CA4B3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CA+C3F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAa9E"}
+{"version":3,"file":"figure-shape.d.ts","sourceRoot":"","sources":["../../src/figure/figure-shape.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,eAAe;IACf,KAAK,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,IAAI,CAAC,EAAE,SAAS;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAA;IAC1C,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CA2BnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,CAK5F;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CAYpE;AAED;;;;;;;;GAQG;AACH;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CA0B9G;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,KAAK,GAAG,IAAI,CA4B3F;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,GAAG,IAAI,CA+C3F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,IAAI,CAa9E"}

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

@@ -0,0 +1,29 @@
+import { type V3Appearance, type V3Asset, type V3CompiledAsset, type V3CompiledCapabilities } 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 {
+    key: string;
+    fingerprint: string;
+    kernel: string;
+    /** The asset compiled at its stored inputs: what `compileV3Asset` gives, validated as a whole. */
+    compiled: V3CompiledAsset;
+    /**
+     * 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;
+    /** Appearance by placing node id (a `place@1` id or a repeated `member@1` id). */
+    looks: Map<string, V3Appearance>;
+    /** 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;
+}
+/** 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

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-v3-compile-cache.d.ts","sourceRoot":"","sources":["../../../src/figure/v3/figure-v3-compile-cache.ts"],"names":[],"mappings":"AAcA,OAAO,EAAwD,KAAK,YAAY,EAAE,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAejL,mHAAmH;AACnH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAWzD;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAA;IACX,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,kGAAkG;IAClG,QAAQ,EAAE,eAAe,CAAA;IACzB;;;;OAIG;IACH,QAAQ,EAAE,sBAAsB,CAAA;IAChC,kFAAkF;IAClF,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAChC,oGAAoG;IACpG,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,wGAAwG;IACxG,KAAK,EAAE,OAAO,CAAA;CACf;AAKD,+GAA+G;AAC/G,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,iHAAiH;AACjH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CA0BvD;AAED,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-v3-geometry.d.ts","sourceRoot":"","sources":["../../../src/figure/v3/figure-v3-geometry.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAiBrD,4GAA4G;AAC5G,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAyB,GAAG,KAAK,CAAC,cAAc,CAW3G;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,KAAK,CAAC,cAAc,GAAG,IAAI,CAStE;AAED,iFAAiF;AACjF,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED,wBAAgB,eAAe,IAAI,IAAI,CAGtC;AAED,+GAA+G;AAC/G,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,GAAE,MAAyB,GAAG,KAAK,CAAC,cAAc,CA6DzG"}

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

@@ -0,0 +1,41 @@
+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> {
+    private rig;
+    private unsubscribe?;
+    get figure(): RegisteredV3Figure | null;
+    protected getObject3dInstance(): THREE.Group;
+    build(): void;
+    /** 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. */
+    get clipSpeeds(): Record<string, number>;
+    /** The playback time of one clip in seconds, as the rig holds it. */
+    clipTime(clip: string): number;
+    onchange(after: Properties, before: Properties): void;
+    /** The instance size in mm from the component's bounds and depth, or the authored size when it is not resizable. */
+    instanceSize(): {
+        x: number;
+        y: number;
+        z: number;
+    } | null;
+    get effectiveDepth(): number;
+    updateDimension(): 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. */
+    updateClips(): void;
+    private refresh;
+    private startTicking;
+    /**
+     * One frame: every playing clip's time advances once by dt milliseconds × its speed, then the rig evaluates each
+     * driver at its clip's time. Nothing the drivers compute is written back as external state. Public so a test can
+     * step frames without the frame clock.
+     */
+    tick(dt: number): void;
+    private advance;
+    clear(): THREE.Group;
+}
+//# sourceMappingURL=figure-v3-real-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-v3-real-object.d.ts","sourceRoot":"","sources":["../../../src/figure/v3/figure-v3-real-object.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAe,KAAK,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAG9E,qBAAa,kBAAmB,SAAQ,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC;IAC7D,OAAO,CAAC,GAAG,CAA2B;IACtC,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,IAAI,MAAM,IAAI,kBAAkB,GAAG,IAAI,CAEtC;cAEkB,mBAAmB,IAAI,KAAK,CAAC,KAAK;IAI5C,KAAK,IAAI,IAAI;IAYtB,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;IAM9D,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;IAEQ,eAAe,IAAI,IAAI;IAMhC,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;IAIN,KAAK,IAAI,KAAK,CAAC,KAAK;CAO9B"}

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

@@ -0,0 +1,13 @@
+import { type V3Asset } from '@hatiolab/figure-model';
+import { type CompiledV3 } from './figure-v3-compile-cache.js';
+export interface RegisteredV3Figure {
+    type: string;
+    compiled: CompiledV3;
+}
+/** Registers a V3 asset under a figure type. Compiles it (or reuses the cache) so a bad asset fails here, not on a board. */
+export declare function registerFigureV3(type: string, asset: V3Asset): RegisteredV3Figure;
+export declare function getFigureV3(type: string): RegisteredV3Figure | null;
+export declare function hasFigureV3(type: string): boolean;
+export declare function unregisterFigureV3(type: string): boolean;
+export declare function resetFiguresV3(): void;
+//# sourceMappingURL=figure-v3-registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-v3-registry.d.ts","sourceRoot":"","sources":["../../../src/figure/v3/figure-v3-registry.ts"],"names":[],"mappings":"AAaA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAErE,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAE5E,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,UAAU,CAAA;CACrB;AAID,6HAA6H;AAC7H,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,kBAAkB,CAOjF;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAEnE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,cAAc,IAAI,IAAI,CAErC"}

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

@@ -0,0 +1,67 @@
+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 {
+    /**
+     * 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.
+     */
+    theme?: Record<string, string>;
+}
+export interface Vec3Like {
+    x: number;
+    y: number;
+    z: number;
+}
+export declare class FigureV3Rig {
+    readonly group: THREE.Group<THREE.Object3DEventMap>;
+    readonly compiled: CompiledV3;
+    private readonly meshes;
+    private size;
+    /** 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>`). */
+    private clipTimes;
+    private theme;
+    /** The last evaluation, for readers that want the numbers behind the meshes. */
+    last: V3AssetEvaluation | null;
+    constructor(asset: V3Asset, options?: FigureV3RigOptions);
+    get asset(): V3Asset;
+    /** The size the asset was authored at: its stored `size.*` design inputs, or null when it is not resizable. */
+    get base(): Vec3Like | null;
+    /** The instance size in mm; null returns to the authored size. */
+    setSize(size: Vec3Like | null): void;
+    /** External control sources: state values a connector or the board wrote. These win over drivers. */
+    setState(values: Record<string, number>): void;
+    /** The clip a driver belongs to: the first segment of its id. */
+    static clipOf(driver: V3Driver): 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. */
+    setClipTime(clip: string, seconds: number): void;
+    /** The playback time of one clip, 0 before it has moved. */
+    clipTime(clip: string): number;
+    /** 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.
+     */
+    stateOverrides(): Record<string, number>;
+    /** 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;
+    /**
+     * The evaluation only, without touching meshes. The document is compiled once per content and kernel; the
+     * instance's size and state are inputs to the evaluation, never a reason to compile again.
+     */
+    evaluate(): V3AssetEvaluation;
+    private colourOf;
+    private materialFor;
+    /** Meshes by body id, for tests and for bindings that need a part's mesh. */
+    meshOf(id: string): THREE.Mesh | undefined;
+    dispose(): void;
+}
+//# sourceMappingURL=figure-v3-rig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figure-v3-rig.d.ts","sourceRoot":"","sources":["../../../src/figure/v3/figure-v3-rig.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,EAGL,KAAK,OAAO,EACZ,KAAK,iBAAiB,EAEtB,KAAK,QAAQ,EACd,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAG5E,MAAM,WAAW,kBAAkB;IACjC;;;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,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,sCAAoB;IAClC,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAA;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,IAAI,CAAwB;IACpC,8GAA8G;IAC9G,OAAO,CAAC,QAAQ,CAA6B;IAC7C,2GAA2G;IAC3G,OAAO,CAAC,SAAS,CAA4B;IAC7C,OAAO,CAAC,KAAK,CAAwB;IACrC,gFAAgF;IAChF,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAO;gBAEzB,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB;IAM5D,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED,+GAA+G;IAC/G,IAAI,IAAI,IAAI,QAAQ,GAAG,IAAI,CAM1B;IAED,kEAAkE;IAClE,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;IAIpC,qGAAqG;IACrG,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAI9C,iEAAiE;IACjE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,MAAM;IAIvC,+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;IAYxC,6FAA6F;IAC7F,IAAI,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE1C;IAED,qFAAqF;IACrF,MAAM,IAAI,iBAAiB;IAsC3B;;;OAGG;IACH,QAAQ,IAAI,iBAAiB;IAoB7B,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAqBnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAAC,IAAI,GAAG,SAAS;IAI1C,OAAO,IAAI,IAAI;CAOhB"}

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

@@ -225,7 +225,7 @@ export declare abstract class RealObject<T extends THREE.Object3D = THREE.Object
      * 부착면의 **높이** — 씬(현장)의 사실이다.
      *
      * 도형은 「나는 천장에 매달린다」까지만 안다. 그 천장이 3m 인지 6m 인지는 도형이 알 수
-     * 없고 현장이 안다. ADR-0045(`operato-twin/design/04-decisions.md`) — archetype 은 청사진의
+     * 없고 현장이 안다. ADR-0045(`operato-application/adr/ADR-0045.md`) — archetype 은 청사진의
      * 사실이고 높이 값은 씬의 사실이라, 둘을 갈라서 나른다.
      *
      * **여기는 자리(slot)이고 값은 공급자가 댄다.** things-scene 은 figure 가 쓰는 둘만 안다 —

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.1.22",
+  "version": "10.1.24",
   "description": "A high-performance 2D/3D scene graph library for building interactive visual editors, combining HTML5 Canvas and Three.js to enable facility visualization, data-driven animations, and real-time monitoring dashboards",
   "main": "things-scene-min.js",
   "module": "things-scene.mjs",
@@ -45,6 +45,7 @@
   ],
   "scripts": {
     "test": "mocha --exit --require should --require ./test/setup.js --node-option import=tsx test/**/test-*.js",
+    "test:figure-v3": "TSX_TSCONFIG_PATH=./test/tsconfig.figure-model-src.json mocha --exit --require should --require ./test/setup.js --node-option import=./test/resolve-figure-model.mjs test/v3/figure-v3-rig.check.js",
     "test:case": "mocha --require should --require ./test/setup.js --node-option import=tsx",
     "clean": "rimraf dist-types things-scene*.js *.js.map",
     "build": "yarn clean && yarn build:types && yarn build:rollup:prod",
@@ -90,7 +91,7 @@
   },
   "homepage": "https://github.com/hatiolab/things-scene#readme",
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.24",
+    "@hatiolab/figure-model": "^0.1.36",
     "@wizpanda/super-gif": "^0.0.6",
     "dompurify": "^3.3.1",
     "jsonata": "^1.8.6",