@hatiolab/things-scene 10.1.18 → 10.1.20

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

@@ -28,13 +28,16 @@
  * `depth` 가 높이다. 환산은 `figure-real-object.ts` 의 `updateDimension` 한 곳에서만
  * 한다 — 그 밖에서는 청사진의 축을 그대로 three 에 넘긴다(three 도 y 가 위다).
  */
-import type { AnchorRule, AnimationChannel, AnimationClip, ChannelPath, BlueprintGroup, BlueprintLabel, BlueprintAnchor, BlueprintMember, BlueprintClip, BlueprintParameter, EmissiveSpec, FigureBlueprint as Blueprint, MaterialSlot, PartAnchor, PartMaterial, PartShape, PartTransform, PrimitiveKind, SizingRule, Vec3 } from '@hatiolab/figure-model';
+import type { AnchorRule, AnimationChannel, AnimationClip, ChannelPath, BlueprintGroup, BlueprintLabel, BlueprintAnchor, BlueprintMember, BlueprintClip, BlueprintJoint, BlueprintParameter, JointChannel, PartChannel, EmissiveSpec, FigureBlueprint as Blueprint, MaterialSlot, PartAnchor, PartMaterial, PartShape, PartTransform, PrimitiveKind, SizingRule, Vec3 } from '@hatiolab/figure-model';
 export type FigurePrimitiveKind = PrimitiveKind;
 export type FigureMaterialSlot = MaterialSlot;
 export type FigureSizingRule = SizingRule;
 export type FigureAnchorRule = AnchorRule;
 export type FigurePartAnchor = PartAnchor;
 export type FigureAnimationChannel = AnimationChannel;
+export type FigurePartChannel = PartChannel;
+export type FigureJointChannel = JointChannel;
+export type FigureBlueprintJoint = BlueprintJoint;
 export type FigureAnimationClip = AnimationClip;
 export type FigureChannelPath = ChannelPath;
 export type FigureVec3 = Vec3;

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

@@ -1 +1 @@
-{"version":3,"file":"figure-blueprint.d.ts","sourceRoot":"","sources":["../../src/figure/figure-blueprint.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,YAAY,EACZ,eAAe,IAAI,SAAS,EAC5B,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,UAAU,EACV,IAAI,EACL,MAAM,wBAAwB,CAAA;AAM/B,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC7C,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AACzC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AACzC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AACzC,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAA;AACrD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAC3C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAA;AAC7B,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC7C,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC7C,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AACvC,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAA;AACnD,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAA;AACnD,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAA;AACjD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAA;AACzD,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAA;AACjD,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AAOvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"figure-blueprint.d.ts","sourceRoot":"","sources":["../../src/figure/figure-blueprint.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,eAAe,EACf,eAAe,EACf,aAAa,EACb,cAAc,EACd,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,IAAI,SAAS,EAC5B,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,SAAS,EACT,aAAa,EACb,aAAa,EACb,UAAU,EACV,IAAI,EACL,MAAM,wBAAwB,CAAA;AAM/B,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC7C,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AACzC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AACzC,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAA;AACzC,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,CAAA;AACrD,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAC3C,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC7C,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAA;AACjD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAC3C,MAAM,MAAM,UAAU,GAAG,IAAI,CAAA;AAC7B,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC7C,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAA;AAC7C,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AACvC,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAA;AACnD,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAA;AACnD,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAA;AACjD,MAAM,MAAM,mBAAmB,GAAG,aAAa,CAAA;AAC/C,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,CAAA;AACzD,MAAM,MAAM,oBAAoB,GAAG,cAAc,CAAA;AACjD,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AAOvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA"}

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

@@ -68,11 +68,19 @@ export declare function slotsFromAnchors(anchors: readonly FigureBlueprintAnchor
 /**
  * 청사진의 문을 씬의 `Port` 로. 자리와 달리 위치가 곧 뜻이므로 그대로 옮긴다.
  *
+ * **관절에 달린 문은 그 관절을 따라간다**(ADR-0066 결정 4). 문의 자리는 부를 때마다 묻는
+ * 값이지 세울 때 쥐어 두는 값이 아니다 — `posed` 가 지금 어디인지를 답하고, 없으면 청사진의
+ * 휴지 자세다. 그래서 관절이 돌았다는 통지를 따로 낼 일이 없다.
+ *
  * **한 부품이 자리와 문을 함께 맡을 수 있다.** AGV 의 상판이 그렇고, 그때 같은 이름이 자리
  * 목록과 문 목록에 함께 나온다. 씬의 `SlotDef.id` 와 `Port.id` 는 서로 다른 이름 공간이므로
  * 겹쳐도 문제가 없다.
  */
-export declare function portsFromAnchors(anchors: readonly FigureBlueprintAnchor[], role: 'port-in' | 'port-out'): Port[];
+export declare function portsFromAnchors(anchors: readonly FigureBlueprintAnchor[], role: 'port-in' | 'port-out', posed?: (anchor: FigureBlueprintAnchor) => {
+    x: number;
+    y: number;
+    z: number;
+} | undefined): Port[];
 /**
  * 선언한 능력으로 클래스를 조립한다. 같은 조합이면 같은 클래스를 돌려준다.
  *

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;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,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;AA4BF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,EAAE,CAaX;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EAAE,IAAI,EAAE,SAAS,GAAG,UAAU,GAAG,IAAI,EAAE,CAIhH;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;AAKlD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAClE,OAAO,EAAc,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE9D,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;AA4BF;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,KAAK,EAAE,aAAa,EACpB,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,EAAE,CAaX;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,IAAI,EAAE,SAAS,GAAG,UAAU,EAC5B,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GACzF,IAAI,EAAE,CAIR;AAoED;;;;;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/figure-clip.d.ts

@@ -1,4 +1,4 @@
-import type { FigureAnimationChannel, FigureVec3 } from './figure-blueprint.js';
+import type { FigureAnimationChannel, FigureJointChannel, FigurePartChannel, FigureVec3 } from './figure-blueprint.js';
 /**
  * 표집할 수 있는 것 — **채널 묶음이면 된다.**
  *
@@ -31,7 +31,7 @@ export declare function durationOf(clip: Sampleable): number;
  * `step` 은 다음 키 **직전까지** 앞 값을 유지한다. 계단이 그런 것이고, 그렇지 않으면
  * 마지막 구간만 보간한 것처럼 보인다.
  */
-export declare function sampleChannel(channel: FigureAnimationChannel, at: number): FigureVec3;
+export declare function sampleChannel(channel: FigurePartChannel, at: number): FigureVec3;
 /**
  * clip 전체를 한 시각에서 읽는다. 부품 이름 → 그 부품이 받는 것.
  *
@@ -39,6 +39,21 @@ export declare function sampleChannel(channel: FigureAnimationChannel, at: numbe
  * 이고, 여기서 섞으면 저작자가 적은 것과 다른 값이 나온다.
  */
 export declare function poseAt(clip: Sampleable, at: number): Map<string, PartPose>;
+/** A channel that moves a part property, as opposed to one that drives a joint (ADR-0066). */
+export declare function isPartChannel(channel: FigureAnimationChannel): channel is FigurePartChannel;
+/**
+ * A joint channel read at one position: the joint coordinate, degrees or millimetres.
+ *
+ * Same rules as `sampleChannel`: outside the keys the end value holds, and `step` keeps the earlier key
+ * until the next one.
+ */
+export declare function sampleJoint(channel: FigureJointChannel, at: number): number;
+/**
+ * Every joint a clip drives, read at one position: joint name → coordinate.
+ *
+ * Two channels on one joint in the same clip: the later one wins, as with part channels.
+ */
+export declare function jointValuesAt(clip: Sampleable, at: number): Map<string, number>;
 /**
  * 도는 clip 을 지금 어느 시각에서 읽나. **시각이 흐른다.**
  *

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

@@ -1 +1 @@
-{"version":3,"file":"figure-clip.d.ts","sourceRoot":"","sources":["../../src/figure/figure-clip.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,sBAAsB,EAAqB,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAElG;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAC7C;AAED,uCAAuC;AACvC,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAID;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAQnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,sBAAsB,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CA0BrF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAgB1E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAK9F"}
+{"version":3,"file":"figure-clip.d.ts","sourceRoot":"","sources":["../../src/figure/figure-clip.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EACV,sBAAsB,EAEtB,kBAAkB,EAClB,iBAAiB,EACjB,UAAU,EACX,MAAM,uBAAuB,CAAA;AAE9B;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAA;CAC7C;AAED,uCAAuC;AACvC,MAAM,WAAW,QAAQ;IACvB,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,EAAE,UAAU,CAAA;IACrB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB;AAID;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAQnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,CA0BhF;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAkB1E;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,IAAI,iBAAiB,CAE3F;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAiB3E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAO/E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAGlE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAK9F"}

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

@@ -3,7 +3,7 @@ import { RealObject } from '../threed/real-object.js';
 import type { TopOutline } from '../interfaces/real-object.js';
 import type { Properties } from '../interfaces/types.js';
 import type { PreparedFigure } from './figure-registry.js';
-import type { FigureBlueprintMember, FigureBlueprintParameter } from './figure-blueprint.js';
+import type { FigureBlueprintAnchor, FigureBlueprintMember, FigureBlueprintParameter, FigureVec3 } from './figure-blueprint.js';
 /**
  * 저작한 Figure 의 3D 표현.
  *
@@ -124,6 +124,16 @@ export declare class FigureRealObject extends RealObject {
      */
     private _moved;
     private _unsubscribeTick?;
+    /** Joint name → node. Empty for a figure without joints, which then builds exactly as before. */
+    private _joints;
+    /** Undoes the instance scale so joint nodes are rigid. Only exists when the figure has joints. */
+    private _rigid?;
+    /** Part name → the joint frame it moves in. */
+    private _frameByName;
+    /** Merged meshes that sit in a joint frame. Their position and scale follow the instance size. */
+    private _framedMeshes;
+    /** The instance scale the joint frames were last laid out for. */
+    private _jointScale;
     get figure(): PreparedFigure | null;
     /**
      * 어느 램프가 켜져 있나. 부품 이름 → 켜짐.
@@ -185,6 +195,59 @@ export declare class FigureRealObject extends RealObject {
     updateParameterDurations(): void;
     onchange(after: Properties, before: Properties): void;
     build(): void;
+    /**
+     * Builds a node per joint, parents first (the blueprint lists them that way), under a root that undoes
+     * the instance scale. Positions are laid out by `layoutJoints` whenever the instance size changes.
+     */
+    private buildJoints;
+    /**
+     * Lays out the joint frames for an instance scale (ADR-0066 decision 3).
+     *
+     * Sizing is solved in the rest pose first: each origin moves with the part it is attached to
+     * (`jointOriginPosition`), and the nodes take those positions in unscaled millimetres. A merged mesh in a
+     * frame then carries the instance scale itself and is offset by the frame origin, so at joint value 0
+     * every vertex lands where it lands without joints.
+     */
+    private layoutJoints;
+    /**
+     * Where an anchor sits **right now** -- a slot or a port follows the joint its part hangs from
+     * (ADR-0066 decision 4).
+     *
+     * The blueprint writes the rest position. When the anchor names a joint frame, the frame's nodes say
+     * where that point has travelled: the point enters the frame the way a framed mesh does (scaled by the
+     * instance, with the frame origin taken off), rides the chain of joint nodes, and comes back out in
+     * figure millimetres -- the same measure the blueprint uses, so the caller sees one unit either way.
+     */
+    anchorPosition(anchor: FigureBlueprintAnchor): FigureVec3;
+    /**
+     * 물건이 이 자리에 매달릴 곳 — **관절 노드와 그 안에서의 자리**(ADR-0066 결정 4).
+     *
+     * 따라가게 하는 일은 장면 그래프가 한다. `handoverIn` 이 물건의 object3d 를 이 노드에
+     * 옮겨 달면 관절이 도는 대로 따라간다 — 프레임마다 좌표를 다시 셈하는 코드를 두지 않는다.
+     * 노드는 인스턴스 배율을 되돌린 뿌리 아래라, 매달린 물건이 figure 의 배율로 찌그러지지
+     * 않는다.
+     *
+     * 물건은 **anchor** 로 놓는다 — 닻의 자리에 앉힌다. 집힌 자리를 그대로 두는 `world-preserve`
+     * 도 있고 손으로 쓴 로봇팔이 그것을 쓰지만, 그것은 그 컴포넌트의 시각적 선택이다. 형식에서
+     * slot 은 물건이 앉는 정해진 곳이라, 물건이 닻 밖에 있으면 그 figure 의 자리 선언과 그림이
+     * 다른 말을 하게 된다. slot 의 뜻을 grip 과 seat 로 가르는 칸은 형식에 없다 — 그 구분이
+     * 실제로 필요한 figure 가 나오면 그때 세운다.
+     *
+     * 관절 틀 밖의 자리는 **없음**을 낸다 — 부르는 쪽이 지금까지 하던 대로 표면에 앉힌다.
+     */
+    anchorAttachment(anchor: FigureBlueprintAnchor): {
+        attach: THREE.Object3D;
+        localPosition: FigureVec3;
+    } | undefined;
+    /**
+     * Sets every joint node to a joint value: degrees about the axis for revolute and continuous,
+     * millimetres along the axis for prismatic. A joint nobody drives is at 0, its rest pose.
+     *
+     * Prismatic travel scales with the instance per axis, the same as a part translation does, since that
+     * is added inside the instance-scaled frame. Two kinds of moving in one figure must not behave
+     * differently (ADR-0066 decision 3).
+     */
+    private applyJoints;
     /**
      * 이 자산의 clip 들을 세운다. **`build()` 끝에서 한 번.**
      *

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":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAK9B,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAMrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAGxD,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,sBAAsB,CAAA;AACzE,OAAO,KAAK,EACV,qBAAqB,EAGrB,qBAAqB,EAErB,wBAAwB,EACxB,UAAU,EACX,MAAM,uBAAuB,CAAA;AAsB9B;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAuBzF;AAED;;;;;;;;GAQG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAY/F;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,qBAAqB,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CAuBjG;AAuDD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC,cAAc,GAAG,IAAI,CA0CnG;AAwKD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAKrH;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,OAAO,EAAE;IAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAInG;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,wBAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAQlG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,SAAS,EAAE,wBAAwB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,CAKlG;AA6GD,qBAAa,gBAAiB,SAAQ,UAAU;IAC9C,2CAA2C;IAC3C,OAAO,CAAC,WAAW,CAAgC;IACnD,6CAA6C;IAC7C,OAAO,CAAC,MAAM,CAAkB;IAChC,iDAAiD;IACjD,OAAO,CAAC,aAAa,CAA2C;IAChE,kDAAkD;IAClD,OAAO,CAAC,MAAM,CAAoB;IAClC,yCAAyC;IACzC,OAAO,CAAC,WAAW,CAAyB;IAC5C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,gBAAgB,CAAC,CAAa;IACtC,iGAAiG;IACjG,OAAO,CAAC,OAAO,CAA+B;IAC9C,kGAAkG;IAClG,OAAO,CAAC,MAAM,CAAC,CAAgB;IAC/B,+CAA+C;IAC/C,OAAO,CAAC,YAAY,CAA4B;IAChD,kGAAkG;IAClG,OAAO,CAAC,aAAa,CAA4C;IACjE,kEAAkE;IAClE,OAAO,CAAC,WAAW,CAA6B;IAEhD,IAAI,MAAM,IAAI,cAAc,GAAG,IAAI,CAElC;IAED;;;;;;OAMG;IACH,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/C;IAED;;;;;OAKG;IACH,WAAW,IAAI,IAAI;IAgBnB;;;;;;;;OAQG;IACH,IAAI,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAE9C;IAED;;;;OAIG;IACH,WAAW,IAAI,IAAI;IASnB;;;;;;;;OAQG;IACH,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAEnD;IAED;;;;;;OAMG;IACH,IAAI,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAE3D;IAED;;;;;OAKG;IACH,gBAAgB,IAAI,IAAI;IAQxB,wCAAwC;IACxC,wBAAwB,IAAI,IAAI;IAOvB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAQ9D,KAAK;IAoDL;;;OAGG;IACH,OAAO,CAAC,WAAW;IAkBnB;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;;;;;;OAQG;IACH,cAAc,CAAC,MAAM,EAAE,qBAAqB,GAAG,UAAU;IAqBzD;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,CAAC,MAAM,EAAE,qBAAqB,GAAG;QAAE,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC;QAAC,aAAa,EAAE,UAAU,CAAA;KAAE,GAAG,SAAS;IAiBlH;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;IAoBnB;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAqBjB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,cAAc;IAsBtB;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IA8EpB;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,OAAO,CAAC,YAAY;IA4DpB;;;;;;OAMG;IACH,OAAO,CAAC,OAAO;IAqCf;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAKtB;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IA6CjB;;;;;;;;OAQG;IACH,OAAO,CAAC,UAAU;IA2BlB;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IA8DnB;;;;;;;;;OASG;IACH,IAAa,cAAc,IAAI,MAAM,CAepC;IAED;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IAAa,aAAa,IAAI,MAAM,CAsBnC;IAED;;;;;;;;;;;OAWG;IACH,eAAe,IAAI,IAAI;IA0BvB;;;;OAIG;IACM,UAAU,IAAI,UAAU,GAAG,IAAI;IAIxC,KAAK;CAgBN"}

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

@@ -1,3 +1,3 @@
-export { anchorOf, REPEAT_LIMIT, needsOwnMesh, repeatOffset, repeatPlan, rotatedExtent, sizingPosition, sizingScale, stretchAxis, type InstanceScale } from '@hatiolab/figure-model';
+export { anchorOf, jointOriginPosition, REPEAT_LIMIT, needsOwnMesh, repeatOffset, repeatPlan, rotatedExtent, sizingPosition, sizingScale, stretchAxis, type InstanceScale } from '@hatiolab/figure-model';
 export type { SizingAxis as FigureAxis } from '@hatiolab/figure-model';
 //# sourceMappingURL=figure-sizing.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"figure-sizing.d.ts","sourceRoot":"","sources":["../../src/figure/figure-sizing.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EAAE,UAAU,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAA"}
+{"version":3,"file":"figure-sizing.d.ts","sourceRoot":"","sources":["../../src/figure/figure-sizing.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,QAAQ,EACR,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,aAAa,EACb,cAAc,EACd,WAAW,EACX,WAAW,EACX,KAAK,aAAa,EACnB,MAAM,wBAAwB,CAAA;AAE/B,YAAY,EAAE,UAAU,IAAI,UAAU,EAAE,MAAM,wBAAwB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.1.18",
+  "version": "10.1.20",
   "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",
@@ -90,7 +90,7 @@
   },
   "homepage": "https://github.com/hatiolab/things-scene#readme",
   "dependencies": {
-    "@hatiolab/figure-model": "^0.1.22",
+    "@hatiolab/figure-model": "^0.1.23",
     "@wizpanda/super-gif": "^0.0.6",
     "dompurify": "^3.3.1",
     "jsonata": "^1.8.6",