@hatiolab/things-scene 10.0.0-beta.9 → 10.0.0-beta.91

package/dist-types/threed/three-dimensional-container.d.ts

@@ -4,6 +4,5 @@ export interface ThreeDimensionalContainer {
     get scene3d(): Scene | undefined;
     get renderer3d(): WebGLRenderer | undefined;
     get mixer(): AnimationMixer | undefined;
-    get zoom(): number | undefined;
 }
 //# sourceMappingURL=three-dimensional-container.d.ts.map

package/dist-types/threed/three-dimensional-container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"three-dimensional-container.d.ts","sourceRoot":"","sources":["../../src/threed/three-dimensional-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAEjE,MAAM,WAAW,yBAAyB;IACxC,aAAa,IAAI,OAAO,CAAA;IACxB,IAAI,OAAO,IAAI,KAAK,GAAG,SAAS,CAAA;IAChC,IAAI,UAAU,IAAI,aAAa,GAAG,SAAS,CAAA;IAC3C,IAAI,KAAK,IAAI,cAAc,GAAG,SAAS,CAAA;IACvC,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAAA;CAC/B"}
+{"version":3,"file":"three-dimensional-container.d.ts","sourceRoot":"","sources":["../../src/threed/three-dimensional-container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAEjE,MAAM,WAAW,yBAAyB;IACxC,aAAa,IAAI,OAAO,CAAA;IACxB,IAAI,OAAO,IAAI,KAAK,GAAG,SAAS,CAAA;IAChC,IAAI,UAAU,IAAI,aAAa,GAAG,SAAS,CAAA;IAC3C,IAAI,KAAK,IAAI,cAAc,GAAG,SAAS,CAAA;CACxC"}

package/dist-types/threed/utils/anchor.d.ts

@@ -0,0 +1,33 @@
+import * as THREE from 'three';
+import type Component from '../../components/component.js';
+export type AnchorPin = 'top' | 'center' | 'bottom';
+export interface AnchorOffset {
+    x?: number;
+    y?: number;
+    z?: number;
+}
+/**
+ * 3D 공간 내 컴포넌트에 대한 앵커 월드 좌표를 해석한다.
+ *
+ *   - `'center'`: object3d 의 matrixWorld translation (월드 원점)
+ *   - `'top'` / `'bottom'`: object3d bbox 의 `max.y` / `min.y` 에 위치한
+ *     중앙점 — mesh 가 차지하는 실제 영역의 위/아래 끝
+ *   - bbox 가 비어있을 때 (line/anchorless 등): matrixWorld translation 으로 fallback
+ *
+ * 반환된 Vector3 에 `offset.{x,y,z}` 를 더한다. target 에 `_realObject.object3d`
+ * 가 없거나 결과 좌표가 non-finite 면 `null` 을 반환.
+ *
+ * 사용 예 (Tooltip3D / Popup3D 공통):
+ * ```ts
+ * const anchor = resolveAnchorWorldPosition(target, 'top', { y: 50 })
+ * if (!anchor) return  // skip render
+ * const screenPt = projectToScreen(target, anchor.x, anchor.y)  // or pass as world coord
+ * ```
+ *
+ * @param target  앵커를 잡을 컴포넌트
+ * @param pin     앵커 위치 (default 'top')
+ * @param offset  월드 좌표 추가 오프셋 (default {})
+ * @param out     결과를 담을 Vector3 (default 새 Vector3) — GC 회피용
+ */
+export declare function resolveAnchorWorldPosition(target: Component, pin?: AnchorPin, offset?: AnchorOffset, out?: THREE.Vector3): THREE.Vector3 | null;
+//# sourceMappingURL=anchor.d.ts.map

package/dist-types/threed/utils/anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.d.ts","sourceRoot":"","sources":["../../../src/threed/utils/anchor.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,SAAS,MAAM,+BAA+B,CAAA;AAE1D,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEnD,MAAM,WAAW,YAAY;IAC3B,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;IACV,CAAC,CAAC,EAAE,MAAM,CAAA;CACX;AAKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,GAAG,GAAE,SAAiB,EACtB,MAAM,GAAE,YAAiB,EACzB,GAAG,GAAE,KAAK,CAAC,OAA6B,GACvC,KAAK,CAAC,OAAO,GAAG,IAAI,CA8BtB"}

package/dist-types/threed/utils/dispose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispose.d.ts","sourceRoot":"","sources":["../../../src/threed/utils/dispose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAwB9B,wBAAgB,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,QAQlD"}
+{"version":3,"file":"dispose.d.ts","sourceRoot":"","sources":["../../../src/threed/utils/dispose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAwB9B,wBAAgB,eAAe,CAAC,GAAG,EAAE,KAAK,CAAC,QAAQ,QAmBlD"}

package/dist-types/threed/utils/tether.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Tether — 3D 앵커와 화면상 패널 사이를 잇는 곡선 SVG 연결선.
+ *
+ * Tooltip3D / Popup (3D-anchor) 공통 자산. 사용 흐름:
+ *
+ * 1. `buildTether(host)` — SVG + path + halo + dot 생성, host 에 append
+ * 2. 매 redraw (또는 위치 변경 시):
+ *    `updateTether(elements, ax, ay, panelLeft, panelTop, panelW, panelH, color, alpha, viewW, viewH)`
+ *    - 앵커 (ax, ay) 와 패널 영역에서 가장 가까운 모서리 중앙을 잇는 베지어 곡선
+ *    - halo (앵커 주변 흐릿한 원), dot (앵커 점) 포함
+ * 3. 앵커 화면 밖 / 비활성화 시: `clearTether(elements)`
+ * 4. 컴포넌트 dispose 시: `disposeTether(elements)`
+ *
+ * 모든 좌표는 같은 좌표계 (host element 의 viewport 픽셀) 라고 가정.
+ * SVG viewBox 는 `0 0 viewW viewH` 로 매 호출마다 재설정 → 호스트 크기 변동에
+ * 자동 적응.
+ */
+export interface TetherElements {
+    svg: SVGSVGElement;
+    path: SVGPathElement;
+    halo: SVGCircleElement;
+    dot: SVGCircleElement;
+}
+/**
+ * SVG 연결선 요소를 생성하고 host 에 append. host 는 panel/캔버스와 같은 좌표계의
+ * always-visible 컨테이너 (예: `layer.target`).
+ *
+ * 초기 opacity=0 + CSS transition 을 걸어두어 caller 가 다음 RAF tick 에 opacity=1
+ * 로 set 하면 자연스럽게 fade-in. 닫을 때 svg.style.opacity='0' 으로 set 하면 같은
+ * transition 으로 fade-out. popup 의 fadeIn / fadeOut (200ms) 와 매칭.
+ */
+export declare function buildTether(host: HTMLElement): TetherElements;
+/**
+ * 곡선 + 마커를 갱신. 앵커 (ax, ay) 와 패널 영역에서 가장 가까운 모서리 중앙을
+ * 베지어 곡선으로 연결. 모든 좌표 단위: viewport 픽셀.
+ */
+export declare function updateTether(elements: TetherElements, anchorX: number, anchorY: number, panelLeft: number, panelTop: number, panelWidth: number, panelHeight: number, color: string, alpha: number, viewWidth: number, viewHeight: number): void;
+/**
+ * 곡선/마커를 시각적으로 비활성화. 요소 자체는 보존 (재활성화 가능).
+ */
+export declare function clearTether(elements: TetherElements): void;
+/**
+ * 요소 자체를 DOM 에서 제거 (컴포넌트 dispose 시).
+ */
+export declare function disposeTether(elements: TetherElements): void;
+//# sourceMappingURL=tether.d.ts.map

package/dist-types/threed/utils/tether.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tether.d.ts","sourceRoot":"","sources":["../../../src/threed/utils/tether.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,aAAa,CAAA;IAClB,IAAI,EAAE,cAAc,CAAA;IACpB,IAAI,EAAE,gBAAgB,CAAA;IACtB,GAAG,EAAE,gBAAgB,CAAA;CACtB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,CA0B7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,IAAI,CAkCN;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAI1D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAE5D"}

package/dist-types/transfer/centering-slot-strategy.d.ts

@@ -0,0 +1,8 @@
+import type { ArrangementStrategy, SlotDef, Vec3 } from './types.js';
+export declare class CenteringSlotStrategy implements ArrangementStrategy {
+    private readonly owner;
+    constructor(owner: any);
+    positionAt(index: number, slotDef: SlotDef, _occupantCount: number, component?: any): Vec3 | null;
+    capacity(slotDef: SlotDef): number;
+}
+//# sourceMappingURL=centering-slot-strategy.d.ts.map

package/dist-types/transfer/centering-slot-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"centering-slot-strategy.d.ts","sourceRoot":"","sources":["../../src/transfer/centering-slot-strategy.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEpE,qBAAa,qBAAsB,YAAW,mBAAmB;IACnD,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,GAAG;IAEvC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IAejG,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;CAGnC"}

package/dist-types/transfer/container-capacity.d.ts

@@ -0,0 +1,42 @@
+import type { SlotDef, TransferOptions, Transferable, CarrierAttachPoint, ArrangementStrategy } from './types.js';
+/** Key used to store the current slot assignment on a child component. */
+export declare const TRANSFER_SLOT_KEY = "_transferSlotId";
+type Constructor<T = object> = new (...args: any[]) => T;
+/**
+ * Mixin that adds Transferable capacity to any ContainerAbstract subclass.
+ *
+ * The mixed-in class provides concrete implementations of all Transferable methods.
+ * Subclasses must implement `get slots(): SlotDef[]`; everything else has sensible defaults.
+ */
+export declare function ContainerCapacity<TBase extends Constructor>(Base: TBase): {
+    new (...args: any[]): {
+        /** Declare the slot topology of this container. */
+        get slots(): SlotDef[];
+        /**
+         * ArrangementStrategy used when `slots` is empty or slotDef has no arrangement.
+         * Override in subclass to supply richer strategies (Stack, Queue, Grid, etc.).
+         */
+        get arrangementStrategy(): ArrangementStrategy;
+        canReceive(component: any): boolean;
+        findSlot(component: any): SlotDef | null;
+        receive(component: any, options?: TransferOptions): Promise<void>;
+        dispatch(component: any, target: Transferable, options?: TransferOptions): Promise<void>;
+        route(_component: any): Transferable | null | Promise<Transferable | null>;
+        /**
+         * WCS resolves a pending route by providing the confirmed target.
+         * Subclasses that implement PendingPolicy must override this to
+         * unblock the waiting promise in route().
+         */
+        resolveRoute(_component: any, _target: Transferable): void;
+        /**
+         * WCS rejects or times out a pending route.
+         * Fires 'transfer-rejected'; subclasses may trigger fallback routing.
+         */
+        rejectRoute(component: any, reason?: string): void;
+        attachPointFor(component: any): CarrierAttachPoint | null;
+        /** Count children currently assigned to `slotId`. */
+        _countOccupied(slotId: string): number;
+    };
+} & TBase;
+export {};
+//# sourceMappingURL=container-capacity.d.ts.map

package/dist-types/transfer/container-capacity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container-capacity.d.ts","sourceRoot":"","sources":["../../src/transfer/container-capacity.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAGjH,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,oBAAoB,CAAA;AAElD,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAExD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,WAAW,EAAE,IAAI,EAAE,KAAK;kBAR3B,GAAG,EAAE;QAa9C,mDAAmD;qBACtC,OAAO,EAAE;QAItB;;;WAGG;mCACwB,mBAAmB;8BAMxB,GAAG,GAAG,OAAO;4BAKf,GAAG,GAAG,OAAO,GAAG,IAAI;2BAsBf,GAAG,YAAW,eAAe,GAAQ,OAAO,CAAC,IAAI,CAAC;4BA+DjD,GAAG,UAAU,YAAY,YAAW,eAAe,GAAQ,OAAO,CAAC,IAAI,CAAC;0BAuBhF,GAAG,GAAG,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;QAI1E;;;;WAIG;iCACsB,GAAG,WAAW,YAAY,GAAG,IAAI;QAI1D;;;WAGG;+BACoB,GAAG,oBAAwB,IAAI;kCAS5B,GAAG,GAAG,kBAAkB,GAAG,IAAI;QAgBzD,qDAAqD;+BAC9B,MAAM,GAAG,MAAM;;UAMzC"}

package/dist-types/transfer/fixed-slot-strategy.d.ts

@@ -0,0 +1,8 @@
+import type { ArrangementStrategy, SlotDef, Vec3 } from './types.js';
+export declare class FixedSlotStrategy implements ArrangementStrategy {
+    positionAt(index: number, slotDef: SlotDef, _occupantCount: number): Vec3 | null;
+    capacity(_slotDef: SlotDef): number;
+}
+/** Singleton — FixedSlotStrategy is stateless. */
+export declare const fixedSlotStrategy: FixedSlotStrategy;
+//# sourceMappingURL=fixed-slot-strategy.d.ts.map

package/dist-types/transfer/fixed-slot-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixed-slot-strategy.d.ts","sourceRoot":"","sources":["../../src/transfer/fixed-slot-strategy.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEpE,qBAAa,iBAAkB,YAAW,mBAAmB;IAC3D,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAKhF,QAAQ,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM;CAGpC;AAED,kDAAkD;AAClD,eAAO,MAAM,iBAAiB,mBAA0B,CAAA"}

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

@@ -0,0 +1,7 @@
+export type { Vec3, Size3, Bounds3, SlotArrangement, GridShape, SlotDef, SlotAssignment, TransferOptions, StaticPolicy, DynamicPolicy, PendingPolicy, ConnectionPolicy, Port, TransferEventType, TransferEvent, CarrierAttachPoint, ArrangementStrategy, Transferable, NavigationTarget, NavigationOptions, Movable, ArticulatedCapability, MissionStatus, VehicleMission, MissionExecutor, SensorPoint, SpawnPoint, SinkPoint } from './types.js';
+export { FixedSlotStrategy, fixedSlotStrategy } from './fixed-slot-strategy.js';
+export { CenteringSlotStrategy } from './centering-slot-strategy.js';
+export { ContainerCapacity, TRANSFER_SLOT_KEY } from './container-capacity.js';
+export type { SimulationClock } from './simulation-clock.js';
+export { globalSimClock } from './simulation-clock.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transfer/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,IAAI,EACJ,KAAK,EACL,OAAO,EACP,eAAe,EACf,SAAS,EACT,OAAO,EACP,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,IAAI,EACJ,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,OAAO,EACP,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,eAAe,EACf,WAAW,EACX,UAAU,EACV,SAAS,EACV,MAAM,YAAY,CAAA;AAEnB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAA;AACpE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAC9E,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA"}

package/dist-types/transfer/simulation-clock.d.ts

@@ -0,0 +1,45 @@
+export interface SimulationClock {
+    /**
+     * Simulated time elapsed since clock creation (ms).
+     * Advances only when speed > 0 and the clock is running.
+     */
+    readonly now: number;
+    /**
+     * Time scale factor.
+     *   1.0 = real-time
+     *   2.0 = double speed
+     *   0   = paused (tick() returns 0, now stays fixed)
+     * Setting speed resumes a paused clock.
+     */
+    speed: number;
+    readonly isPaused: boolean;
+    pause(): void;
+    resume(): void;
+    /**
+     * Called from a requestAnimationFrame loop with the real wall-clock delta.
+     * Returns the scaled simulation delta that components should use for physics.
+     *
+     * If paused (speed === 0), returns 0 and does not advance `now`.
+     * Clamps realDeltaMs to 200 ms to prevent spiral-of-death on tab resume.
+     */
+    tick(realDeltaMs: number): number;
+    /**
+     * Advance the clock by exactly `dt` simulation milliseconds, bypassing speed.
+     * Intended for unit tests and deterministic replay — do NOT call from RAF.
+     */
+    step(dt: number): void;
+    /** Register a listener called after each tick / step with the scaled delta. */
+    onTick(listener: (dt: number) => void): () => void;
+}
+/**
+ * The scene-wide SimulationClock instance.
+ *
+ * ConveyanceContainer, Mover and all time-dependent mixins call:
+ *   const dt = globalSimClock.tick(realDeltaMs)
+ *
+ * Tests use:
+ *   globalSimClock.step(100) // advance 100 ms deterministically
+ *   globalSimClock.speed = 5 // run at 5× for the next tick
+ */
+export declare const globalSimClock: SimulationClock;
+//# sourceMappingURL=simulation-clock.d.ts.map

package/dist-types/transfer/simulation-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation-clock.d.ts","sourceRoot":"","sources":["../../src/transfer/simulation-clock.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IAEpB;;;;;;OAMG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAE1B,KAAK,IAAI,IAAI,CAAA;IACb,MAAM,IAAI,IAAI,CAAA;IAEd;;;;;;OAMG;IACH,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAA;IAEjC;;;OAGG;IACH,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtB,+EAA+E;IAC/E,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAAA;CACnD;AAyDD;;;;;;;;;GASG;AACH,eAAO,MAAM,cAAc,EAAE,eAAwC,CAAA"}

package/dist-types/transfer/types.d.ts

@@ -0,0 +1,285 @@
+export type Vec3 = {
+    x: number;
+    y: number;
+    z: number;
+};
+export type Size3 = {
+    width: number;
+    height: number;
+    depth: number;
+};
+export type Bounds3 = Vec3 & Size3;
+/**
+ * How items are arranged within a slot.
+ *  'single'   — one item, fixed position (fork tip, TCP, simple cell)
+ *  'stack-y'  — items stacked along +Y (crane forks, pallet stack)
+ *  'queue-z'  — items queued along +Z / belt axis (conveyor)
+ *  'grid-xz'  — items arranged in an XZ grid (AGV deck, pallet)
+ */
+export type SlotArrangement = 'single' | 'stack-y' | 'queue-z' | 'grid-xz';
+/** Optional grid dimensions for 'grid-xz' arrangement. */
+export type GridShape = {
+    cols: number;
+    rows: number;
+};
+/** Describes one logical slot within a Transferable container. */
+export interface SlotDef {
+    id: string;
+    /** Local position of the slot origin within the container (scene units). */
+    localPosition?: Vec3;
+    localRotation?: Vec3;
+    /** Component types that may occupy this slot. Empty = any type allowed. */
+    allowedTypes?: string[];
+    /** Maximum occupant count (default 1). */
+    maxCount?: number;
+    arrangement?: SlotArrangement;
+    gridShape?: GridShape;
+}
+/** Runtime assignment — which slot a component currently occupies. */
+export interface SlotAssignment {
+    slotId: string;
+    index: number;
+}
+export interface TransferOptions {
+    slotId?: string;
+    animated?: boolean;
+    duration?: number;
+    ease?: string;
+}
+/**
+ * Pre-wired to a fixed component reference; resolved at design time.
+ * Used for static conveyors and fixed-route connections.
+ */
+export interface StaticPolicy {
+    kind: 'static';
+    targetRef: string;
+}
+/**
+ * Target resolved at runtime by evaluating an expression against the board model.
+ * Used for dynamic routing (sorter lane logic, WCS-driven divert).
+ */
+export interface DynamicPolicy {
+    kind: 'dynamic';
+    resolverExpr: string;
+}
+/**
+ * Transfer is suspended until an external signal (WCS/MES event) resolves.
+ * The component waits at the port; a timeout fires fallback after `timeoutMs`.
+ */
+export interface PendingPolicy {
+    kind: 'pending';
+    timeoutMs?: number;
+    fallbackRef?: string;
+}
+export type ConnectionPolicy = StaticPolicy | DynamicPolicy | PendingPolicy;
+/** Directional connection point on a Transferable component. */
+export interface Port {
+    id: string;
+    direction: 'input' | 'output';
+    slotId?: string;
+    policy?: ConnectionPolicy;
+}
+export type TransferEventType = 'transfer-received' | 'transfer-dispatched' | 'transfer-pending' | 'transfer-routed' | 'transfer-rejected';
+export interface TransferEvent {
+    type: TransferEventType;
+    component: any;
+    container: any;
+    slotId?: string;
+    target?: any;
+    reason?: string;
+}
+/** The 3D attach frame that a carrier exposes for its payload. */
+export interface CarrierAttachPoint {
+    position: Vec3;
+    rotation: Vec3;
+    slotId: string;
+}
+/**
+ * Determines WHERE within a slot a new item should be placed, and how
+ * existing items are laid out as occupancy changes.
+ *
+ * Implementations live in scene-base (FixedSlot, Stack, Queue, Grid, Shelf, Gravity).
+ * things-scene ships a minimal FixedSlotStrategy as the default.
+ */
+export interface ArrangementStrategy {
+    /**
+     * Returns the local position (left/top/z) for the item within the container.
+     * `component` is the item being placed — strategies may use its state.width/height
+     * to compute dimension-aware positions (e.g. centering).
+     * Returns null if no position should be applied (use current/world-preserved position).
+     */
+    positionAt(index: number, slotDef: SlotDef, occupantCount: number, component?: any): Vec3 | null;
+    /** Maximum number of items this strategy can hold in one slot. */
+    capacity(slotDef: SlotDef): number;
+}
+/**
+ * The central abstraction for anything that can receive and dispatch components.
+ *
+ * ALL domain-specific verbs (pick/place, induct/eject, store/retrieve, fetch/deposit)
+ * are aliases that ultimately delegate to `receive()` and `dispatch()`.
+ *
+ * Implementors must be ContainerAbstract subclasses so that `reparent()` is available.
+ */
+export interface Transferable {
+    /**
+     * Pure, synchronous capacity check.
+     * Must NOT mutate state — called on every drag-over frame.
+     */
+    canReceive(component: any): boolean;
+    /** Returns the best available SlotDef for `component`, or null if none. */
+    findSlot(component: any): SlotDef | null;
+    /** Reparent `component` into this container. Fires 'transfer-received'. */
+    receive(component: any, options?: TransferOptions): Promise<void> | void;
+    /** Move `component` to `target.receive()`. Fires 'transfer-dispatched'. */
+    dispatch(component: any, target: Transferable, options?: TransferOptions): Promise<void> | void;
+    /**
+     * Determine the next target for `component`.
+     * Returns null → triggers 'transfer-pending' event.
+     * May be async for WCS-driven (pending) routing.
+     */
+    route(component: any): Transferable | null | Promise<Transferable | null>;
+    /**
+     * WCS / MES resolves a previously pending route by providing the target.
+     * Call path: WCS event → scene.findById(id).resolveRoute(component, target)
+     */
+    resolveRoute(component: any, target: Transferable): void;
+    /**
+     * WCS / MES rejects or times out a pending route.
+     * Triggers fallback ref (PendingPolicy.fallbackRef) or 'transfer-rejected'.
+     */
+    rejectRoute(component: any, reason?: string): void;
+    /** Returns the 3D attach frame for a payload held in this container. */
+    attachPointFor(component: any): CarrierAttachPoint | null;
+}
+/**
+ * The destination a Movable navigates toward.
+ * - component: dock beside another Transferable (e.g. conveyor input port)
+ * - point:     absolute scene-unit coordinate
+ * - node:      named node in a pre-defined graph (AGV / OHT)
+ */
+export type NavigationTarget = {
+    kind: 'component';
+    ref: Transferable;
+} | {
+    kind: 'point';
+    pos: Vec3;
+} | {
+    kind: 'node';
+    nodeId: string;
+};
+export interface NavigationOptions {
+    speed?: number;
+    arriveThreshold?: number;
+}
+/**
+ * Self-navigation capability for vehicles (Forklift, AGV, AMR, OHT).
+ * The vehicle's whole body moves to the destination, then Transfer happens.
+ *
+ * Contrast with ArticulatedCapability where only the internal mechanism moves.
+ */
+export interface Movable {
+    navigate(destination: NavigationTarget, options?: NavigationOptions): Promise<void>;
+    stop(): void;
+    readonly position: Vec3;
+    readonly isMoving: boolean;
+    /** Determines which NavigationStrategy is used. */
+    readonly navigationMode: 'graph' | 'free' | 'constrained';
+}
+/**
+ * Capability for devices whose internal mechanism (arm, mast, fork carriage)
+ * extends to reach a pickup/dropoff point — without moving the device body.
+ *
+ * Used by: RobotArm (6-DOF IK), ASRSCrane (XY rail), BridgeCrane (XYZ gantry),
+ *          Lift/Hoist (Y-axis), linear Manipulator.
+ *
+ * Contrast with Movable where the whole vehicle navigates to the destination.
+ */
+export interface ArticulatedCapability {
+    /**
+     * Extend the internal mechanism so the end-effector reaches `target`.
+     * Resolves when the end-effector arrives at the target position.
+     */
+    reach(target: Transferable | Vec3, options?: TransferOptions): Promise<void>;
+    /**
+     * Retract the mechanism to its safe / home position.
+     * `home: true` returns to the configured homePosition / homeJoints state.
+     */
+    retract(options?: {
+        home?: boolean;
+        duration?: number;
+    }): Promise<void>;
+    /** Current end-effector position (TCP, hook, fork tip) in scene coordinates. */
+    readonly endEffectorPosition: Vec3;
+    /** Kinematic workspace check — false means reach() would fail or collide. */
+    canReach(target: Transferable | Vec3): boolean;
+}
+export type MissionStatus = 'queued' | 'navigating-to-pickup' | 'picking' | 'navigating-to-dropoff' | 'placing' | 'done' | 'failed';
+export interface VehicleMission {
+    readonly id: string;
+    readonly pickupTarget: Transferable;
+    readonly dropoffTarget: Transferable;
+    readonly priority: number;
+    /** Filled after a successful pick (receive). */
+    payload?: any;
+    status: MissionStatus;
+    /** simClock.now at mission start. */
+    readonly startedAt?: number;
+    readonly completedAt?: number;
+    readonly failReason?: string;
+}
+/**
+ * Manages an ordered queue of VehicleMissions for a single vehicle.
+ * Missions execute one at a time; the queue is drained in priority order.
+ */
+export interface MissionExecutor {
+    /** Add a mission to the queue. Resolves when the mission reaches 'done'. */
+    enqueue(mission: Omit<VehicleMission, 'id' | 'status'>): Promise<VehicleMission>;
+    /** Cancel a queued or in-progress mission by ID. */
+    cancel(missionId: string): void;
+    readonly currentMission: VehicleMission | null;
+    readonly missionQueue: readonly VehicleMission[];
+}
+/**
+ * A virtual sensor mounted on a Transferable container (conveyor, rack gate, etc.).
+ * When a component passes through its detection zone, it fires a scene event
+ * that WCS uses to make routing decisions (→ resolveRoute / rejectRoute).
+ *
+ * Common use: sorter entry sensor triggers PendingPolicy, WCS decides lane.
+ */
+export interface SensorPoint {
+    readonly id: string;
+    /** Local position within the parent container (scene units). */
+    readonly localPosition: Vec3;
+    readonly sensorType: 'presence' | 'identity' | 'weight';
+    /** Detection radius (scene units). Default: component bounding-box overlap. */
+    readonly detectionRadius?: number;
+    /** Called when a component enters the detection zone. */
+    onDetect(component: any): void;
+}
+/**
+ * SpawnPoint: where cargo enters the simulation.
+ * Creates components and injects them into the connected Transferable chain.
+ * Examples: production line end, receiving dock, WCS inject command.
+ */
+export interface SpawnPoint extends Transferable {
+    /** Create a new component of `type` and route it into the system. */
+    spawn(type: string, initialState?: Record<string, any>): any;
+    /** Components generated per simulated minute. */
+    readonly spawnRate: number;
+    readonly spawnPattern: 'uniform' | 'burst' | 'schedule';
+}
+/**
+ * SinkPoint: where cargo leaves the simulation.
+ * Calling receive() on a SinkPoint removes the component from the scene
+ * and increments throughput counters.
+ * Examples: shipping dock, quality-pass exit, virtual out-gate.
+ */
+export interface SinkPoint extends Transferable {
+    /** Total components consumed since simulation start. */
+    readonly throughput: number;
+    /** Components per simulated hour (rolling average). */
+    readonly throughputPerHour: number;
+    /** simClock.now of the last received component. */
+    readonly lastReceivedAt: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist-types/transfer/types.d.ts.map

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

package/dist-types/transition/transition-effect.d.ts

@@ -0,0 +1,91 @@
+interface WorldState {
+    x: number;
+    y: number;
+    rotation: number;
+    width: number;
+    height: number;
+}
+interface State3D {
+    pos: any;
+    quat: any;
+    fromScale?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    toScale?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+interface ReparentState {
+    fromWorld?: WorldState;
+    toWorld?: WorldState;
+    from3D?: State3D;
+    to3D?: State3D;
+    duration: number;
+    startTime: number;
+    progress: number;
+    keepSuppressed?: boolean;
+}
+/**
+ * TransitionEffect — reparent 전환의 모든 것을 소유한다.
+ *
+ * - 상태: Map<Component, ReparentState>
+ * - 타이밍: 자체 RAF loop
+ * - 2D 렌더링: transition canvas (lazy 생성/제거)
+ * - 3D 보간: object3d position/quaternion 직접 조작
+ * - 정리: suppressTransform 해제, canvas 제거
+ */
+export default class TransitionEffect {
+    private active;
+    private rafId;
+    private root;
+    private _canvas;
+    private _ctx;
+    constructor(root: any);
+    isReparenting(component: any): boolean;
+    getState(component: any): ReparentState | null;
+    begin(component: any, options: {
+        fromWorld?: WorldState;
+        toWorld?: WorldState;
+        from3D?: State3D;
+        to3D?: State3D;
+        duration: number;
+        ease?: string;
+        /**
+         * When true, cleanup3D() will NOT reset suppressTransform to false and will
+         * NOT call realObj.update(). Use this when the caller's own tick loop takes
+         * over position control after the transition.
+         */
+        keepSuppressed?: boolean;
+    }): void;
+    cancel(component: any): void;
+    /**
+     * 2D transition canvas에 렌더링 — postrender()에서 호출
+     */
+    renderComponent(component: any, modelLayer: any): void;
+    /**
+     * draw cycle 시작 시 호출 — canvas clear
+     */
+    beginDraw(): void;
+    /**
+     * draw cycle 종료 시 호출 — canvas restore
+     */
+    endDraw(): void;
+    /**
+     * model-layer resize 시 호출 — canvas 크기 동기화
+     */
+    resize(): void;
+    dispose(): void;
+    private ensureCanvas;
+    private removeCanvas;
+    private startLoop;
+    private stopLoop;
+    private tick;
+    private complete;
+    private cleanup3D;
+}
+export {};
+//# sourceMappingURL=transition-effect.d.ts.map

package/dist-types/transition/transition-effect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-effect.d.ts","sourceRoot":"","sources":["../../src/transition/transition-effect.ts"],"names":[],"mappings":"AAcA,UAAU,UAAU;IAClB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED,UAAU,OAAO;IACf,GAAG,EAAE,GAAG,CAAA;IACR,IAAI,EAAE,GAAG,CAAA;IACT,SAAS,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAC/C,OAAO,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9C;AAED,UAAU,aAAa;IACrB,SAAS,CAAC,EAAE,UAAU,CAAA;IACtB,OAAO,CAAC,EAAE,UAAU,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,IAAI,CAAK;IAGjB,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,IAAI,CAAwC;gBAExC,IAAI,EAAE,GAAG;IAMrB,aAAa,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO;IAItC,QAAQ,CAAC,SAAS,EAAE,GAAG,GAAG,aAAa,GAAG,IAAI;IAI9C,KAAK,CACH,SAAS,EAAE,GAAG,EACd,OAAO,EAAE;QACP,SAAS,CAAC,EAAE,UAAU,CAAA;QACtB,OAAO,CAAC,EAAE,UAAU,CAAA;QACpB,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,QAAQ,EAAE,MAAM,CAAA;QAChB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb;;;;WAIG;QACH,cAAc,CAAC,EAAE,OAAO,CAAA;KACzB,GACA,IAAI;IAgDP,MAAM,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;IAK5B;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,GAAG,IAAI;IAoCtD;;OAEG;IACH,SAAS,IAAI,IAAI;IAQjB;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,MAAM,IAAI,IAAI;IASd,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,IAAI;IAoDZ,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,SAAS;CAalB"}

package/dist-types/types/bounding.d.ts

@@ -1,4 +1,4 @@
-export type Position = 'static' | 'absolute' | 'relative';
+export type Position = 'static' | 'absolute' | 'relative' | 'popup';
 export interface Bounds {
     left: number;
     top: number;

package/dist-types/types/bounding.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounding.d.ts","sourceRoot":"","sources":["../../src/types/bounding.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAA;AAEzD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GACd,UAAU,GACV,aAAa,GACb,aAAa,GACb,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,GACX,cAAc,GACd,cAAc,CAAA;AAElB;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,EAAE,CAAA;AAE1B;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IAEd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IAEf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IAEf,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;IAEd,kCAAkC;IAClC,MAAM,EAAE,KAAK,CAAA;IAEb,yDAAyD;IACzD,IAAI,CAAC,EAAE,IAAI,CAAA;IAEX,kFAAkF;IAClF,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAElC,6BAA6B;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3C,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAEjC,4DAA4D;IAC5D,aAAa,IAAI,MAAM,CAAA;IAEvB,yDAAyD;IACzD,qBAAqB,CAAC,IAAI,MAAM,CAAA;CACjC"}
+{"version":3,"file":"bounding.d.ts","sourceRoot":"","sources":["../../src/types/bounding.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAA;AAEnE,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GACd,UAAU,GACV,aAAa,GACb,aAAa,GACb,YAAY,GACZ,eAAe,GACf,eAAe,GACf,WAAW,GACX,cAAc,GACd,cAAc,CAAA;AAElB;;GAEG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,KAAK,EAAE,CAAA;AAE1B;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAA;IAEd,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IAEf,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IAEf,uEAAuE;IACvE,MAAM,EAAE,MAAM,CAAA;IAEd,kCAAkC;IAClC,MAAM,EAAE,KAAK,CAAA;IAEb,yDAAyD;IACzD,IAAI,CAAC,EAAE,IAAI,CAAA;IAEX,kFAAkF;IAClF,MAAM,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAElC,6BAA6B;IAC7B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3C,+EAA+E;IAC/E,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAEjC,4DAA4D;IAC5D,aAAa,IAAI,MAAM,CAAA;IAEvB,yDAAyD;IACzD,qBAAqB,CAAC,IAAI,MAAM,CAAA;CACjC"}