@hatiolab/things-scene 10.1.14 → 10.1.16

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

@@ -1,16 +1,54 @@
+/**
+ * 저작한 Figure 에 **능력을 입힌다.**
+ *
+ * 그리는 것만으로는 컨베이어가 컨베이어가 아니다. 물건을 받고 담고 흘려보내는 것은
+ * 씬의 capability mixin 이 하는 일이고, 손으로 쓴 컴포넌트는 클래스 선언 한 줄로 그것을
+ * 지고 있었다(`class Conveyor extends FlowNode(Polygon)`). 저작한 Figure 에는 그 한 줄을
+ * 쓸 자리가 없다 — 형식이 `capabilities: ['FlowNode']` 로 **선언**하고, 등록할 때 여기서
+ * 클래스를 조립한다.
+ *
+ * ## 사다리 셋
+ *
+ *   없음      그리기만 한다. 대부분의 도형이다
+ *   담는다    `Capacity` + `Holdable` — 자리가 있고 물건이 앉는다. 랙·팔레트·작업대
+ *   흐른다    `FlowNode` — 담는 것에 더해 받고 보낸다. 컨베이어·슈트·소터
+ *
+ * `FlowNode` 가 `Capacity`·`Transferable`·`Holdable` 을 스스로 흡수하므로 사다리 윗 칸이
+ * 아랫 칸을 포함한다. **셋을 다 적는 것과 `FlowNode` 만 적는 것이 같아야 한다** — 그래서
+ * 위에서부터 한 번만 적용한다.
+ *
+ * ## 클래스는 타입마다가 아니라 **능력 조합마다** 하나다
+ *
+ * 도형 100 개가 다 `FlowNode` 면 클래스는 하나다. 타입마다 만들면 프로토타입 체인이
+ * 100 벌이 되고, 그 100 벌이 하는 일이 전부 같다.
+ */
+import Component from '../components/component.js';
 import type { SlotDef } from '../transfer/types.js';
 import type { Port } from '../flow/flow-node.js';
 import type { FigureBlueprintAnchor } from './figure-blueprint.js';
 import { type InstanceScale } from './figure-sizing.js';
+import type { FigureCapability } from '@hatiolab/figure-model';
+type Ctor<T = object> = new (...args: any[]) => T;
 /**
- * 저작이 고를 수 있는 능력.
+ * 저작이 고를 수 있는 능력 — **목록은 형식이 갖는다.**
+ *
+ * 한동안 이 목록이 여기에만 있었다. 그래서 figure-model 의 `validate` 가 이름을 못 봤고,
+ * `capabilities: ['hoist']` 가 검증을 지나고 **발행을 지나** 여기 와서 죽었다. 게이트는
+ * 사실이 사는 곳에 있어야 한다(ADR-0051 ④).
  *
- * **씬이 실제로 조립할 수 있는 것만 있다.** `PlacementSurface`·`CarrierLine` 같은 이름은
- * 씬에 metadata 는 있어도 mixin factory 가 없다 — 구현이 있어야 성립하는 계약이라, 저작이
- * 이름만 적어서 지게 하면 「선언은 있는데 동작이 없는」 것이 된다.
+ * 지금은 **형식이 선언하고 씬이 소비한다.** 이 이름으로 다시 내보내는 것은 소비처가 이미
+ * 이 이름을 쓰기 때문이고, 값은 형식의 것 그대로다.
  */
 export declare const FIGURE_CAPABILITIES: readonly ["Capacity", "Holdable", "Transferable", "FlowNode"];
-export type FigureCapabilityName = (typeof FIGURE_CAPABILITIES)[number];
+export type FigureCapabilityName = FigureCapability;
+/**
+ * 이름 → 그 능력을 얹는 mixin. **선언과 구현이 만나는 한 곳이다.**
+ *
+ * 표로 두는 이유는 **양쪽으로 셀 수 있게** 하기 위해서다 — 선언된 이름마다 여기 항목이
+ * 있고, 여기 항목마다 선언이 있다. `if` 로 흩어 두면 한쪽에만 있는 것이 조용히 남는다
+ * (ADR-0036 ③ 개정의 「양방향」).
+ */
+export declare const CAPABILITY_MIXINS: Readonly<Record<FigureCapabilityName, (base: Ctor<Component>) => Ctor<Component>>>;
 /** 저작 화면이 사다리를 그릴 때 쓰는 설명. 모델러의 「능력」 탭이 읽는다. */
 export declare const FIGURE_CAPABILITY_NOTES: Readonly<Record<FigureCapabilityName, string>>;
 /**
@@ -44,4 +82,5 @@ export declare function portsFromAnchors(anchors: readonly FigureBlueprintAnchor
 export declare function figureClassFor(base: unknown, capabilities?: readonly string[], placement?: string): unknown;
 /** 시험을 위해 조립한 클래스를 버린다. */
 export declare function resetFigureClasses(): void;
+export {};
 //# sourceMappingURL=figure-capability.d.ts.map

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":"AAkCA,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;AAInE;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,+DAAgE,CAAA;AAEhG,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,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,CA+B/G;AAiCD,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;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.1.14",
+  "version": "10.1.16",
   "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.19",
+    "@hatiolab/figure-model": "^0.1.21",
     "@wizpanda/super-gif": "^0.0.6",
     "dompurify": "^3.3.1",
     "jsonata": "^1.8.6",