@hatiolab/things-scene 10.0.0-beta.88 → 10.0.0-beta.89

package/dist-types/components/container-abstract.d.ts

@@ -505,6 +505,14 @@ export default class ContainerAbstract extends ContainerAbstract_base {
         animated?: boolean;
         duration?: number;
         ease?: string;
+        /**
+         * Custom 3D parent to attach the component's object3d to.
+         * Defaults to this container's own _realObject.object3d.
+         * Use this when the target container has a sub-group (e.g. a bodyGroup
+         * rotated for orientation) that items should attach to rather than the
+         * container root.
+         */
+        toParent3D?: any;
     }): void;
     addComponent(component: any, options?: boolean | {
         ghost?: boolean;

package/dist-types/components/container-abstract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-abstract.d.ts","sourceRoot":"","sources":["../../src/components/container-abstract.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"container-abstract.d.ts","sourceRoot":"","sources":["../../src/components/container-abstract.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,SAAS,MAAM,gBAAgB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMtC,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,sBAA+B;IACpE,WAAW,EAAE,SAAS,EAAE,CAAA;gBAEpB,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG;IAOrC,aAAa,CAAC,UAAU,KAAA;IAIxB,IAAI,cAAc,YAEjB;IAED,IAAI,YAAY,YAEf;IAED,OAAO;IAMP,WAAW,IAAI,IAAI,IAAI,SAAS;IAIhC,WAAW,CAAC,SAAS,KAAA;IAIrB,IAAI,eAAe,YAElB;IAED,IAAI,UAAU,gBAEb;IAID,IAAI,SAAS,YAEZ;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,MAAM;IASN,IAAI,SAAS,QAQZ;IAED;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CACN,SAAS,EAAE,GAAG,EACd,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb;;;;;;WAMG;QACH,UAAU,CAAC,EAAE,GAAG,CAAA;KACZ;IAuHR,YAAY,CAAC,SAAS,KAAA,EAAE,OAAO,GAAE,OAAO,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAU;IAsDxF,eAAe,CAAC,SAAS,KAAA,EAAE,KAAK,UAAQ;IAwBxC,iBAAiB,CAAC,SAAS,KAAA,EAAE,KAAK,KAAA,EAAE,KAAK,UAAQ;IA2BjD,GAAG,CAAC,IAAI,KAAA,EAAE,KAAK,UAAQ;IAYvB,MAAM,CAAC,IAAI,KAAA,EAAE,KAAK,UAAQ;IAc1B,KAAK,CAAC,KAAK,KAAA;IAIX,OAAO,CAAC,EAAE,KAAA,EAAE,OAAO,CAAC,KAAA;IAMpB,QAAQ,CAAC,EAAE,KAAA,EAAE,OAAO,CAAC,KAAA;IAWrB,OAAO,CAAC,IAAI,KAAA;IAIZ,IAAI;IAIJ,WAAW,CAAC,KAAK,KAAA,EAAE,KAAK,KAAA;IAgBxB,gBAAgB,CAAC,KAAK,KAAA;IAQtB,iBAAiB,CAAC,KAAK,KAAA;IAQvB,gBAAgB,CAAC,KAAK,KAAA;IAUtB,eAAe,CAAC,KAAK,KAAA;IAUrB,SAAS,CAAC,CAAC,KAAA;IAiBX,OAAO,CAAC,CAAC,KAAA,EAAE,GAAG,MAAM,OAAA,GAAG,SAAS,EAAE;IAiBlC,SAAS,CAAC,CAAC,KAAA,EAAE,GAAG,MAAM,OAAA,GAAG,SAAS,GAAG,SAAS;IAe9C,QAAQ,CAAC,EAAE,KAAA;IAIX,WAAW,CAAC,GAAG,KAAA;IAIf,QAAQ,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;IAmBb,OAAO,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA,EAAE,MAAM,KAAA;IA2CpB,WAAW,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA;IAqCzB,MAAM,CAAC,OAAO,KAAA;IAkBd,UAAU,CAAC,OAAO,KAAA;IAiDlB,IAAI;CAOL"}

package/dist-types/components/mixins/move-handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"move-handle.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/move-handle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AASpD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBATzC,GAAG,EAAE;kBAWxB,OAAO;8BAEH,OAAO;4BAIT,wBAAwB;mCAYjB,wBAAwB;oBA2BvC,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BhC"}
+{"version":3,"file":"move-handle.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/move-handle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAYpD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAZzC,GAAG,EAAE;kBAcxB,OAAO;8BAEH,OAAO;4BAIT,wBAAwB;mCAYjB,wBAAwB;oBA2BvC,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BhC"}

package/dist-types/things-scene/index.d.ts

@@ -27,6 +27,8 @@ export type { SceneRenderContext, DrawOptions, StyleOptions, FillStyle, StrokeSt
 export type { LinkEnd } from '../decorator/decorators/link-decorator.js';
 export type { LAYOUT, LayoutRegistry } from '../interfaces/layout.js';
 export type { IRealObject } from '../interfaces/real-object.js';
+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, SimulationClock } from '../transfer/index.js';
+export { FixedSlotStrategy, CenteringSlotStrategy, ContainerCapacity, TRANSFER_SLOT_KEY, globalSimClock } from '../transfer/index.js';
 export { default as ReferenceMap } from '../core/reference-map.js';
 export { default as ScriptLoader } from '../core/script-loader.js';
 export * from '../core/logger.js';

package/dist-types/things-scene/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/things-scene/index.ts"],"names":[],"mappings":"AAIA,OAAO,mBAAmB,CAAA;AAE1B,OAAO,QAAQ,MAAM,qBAAqB,CAAA;AAC1C,OAAO,UAAU,MAAM,uBAAuB,CAAA;AAC9C,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,KAAK,IAAI,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAEzE,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAA;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,MAAM,WAAW,KAAK;IACpB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACnB;AAED,yBAAiB,KAAK,CAAC;IACd,MAAM,OAAO,iBAAW,CAAA;IACxB,MAAM,SAAS,mBAAa,CAAA;IAC5B,MAAM,MAAM,gBAAU,CAAA;IACtB,MAAM,KAAK,eAAS,CAAA;CAC5B;AAED,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AAE/D,cAAc,aAAa,CAAA;AAE3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AAGjC,YAAY,EACV,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,OAAO,EACxE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EACzE,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACpH,YAAY,EACV,kBAAkB,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EACxF,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,YAAY,EACtE,MAAM,4BAA4B,CAAA;AACnC,YAAY,EAAE,OAAO,EAAE,MAAM,2CAA2C,CAAA;AACxE,YAAY,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAE/D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAClE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAElE,cAAc,mBAAmB,CAAA;AAEjC,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,YAAY,CAAA;AAE7C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,cAAc,EAAE,MAAM,UAAU,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAC5D,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAA;AAClH,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAA;AACnE,YAAY,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,oCAAoC,CAAA;AACxG,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAA;AAElE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,oCAAoC,CAAA;AAGhF,cAAc,oBAAoB,CAAA;AAGlC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/things-scene/index.ts"],"names":[],"mappings":"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"}

package/dist-types/threed/html/elements.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../../src/threed/html/elements.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,WAAW,QAWpB,CAAA;AAEJ,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAS7E"}
+{"version":3,"file":"elements.d.ts","sourceRoot":"","sources":["../../../src/threed/html/elements.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,WAAW,QAAsB,CAAA;AAE9C,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAS7E"}

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

@@ -51,6 +51,15 @@ export declare abstract class RealObject<T extends THREE.Object3D = THREE.Object
     get cx(): number;
     get cy(): number;
     get cz(): number;
+    /**
+     * 이 컨테이너가 아이템을 받는 표면의 Y (자신의 object3d local space 기준).
+     * 서브클래스에서 오버라이드하면 ContainerCapacity.receive()가 수용된 아이템의
+     * zPos를 0으로 설정하고, cz 계산 시 이 값만큼 자동으로 보정된다.
+     * 결과: 수용된 아이템의 zPos=0 이 "이 표면 위에 놓임"을 의미하게 됨.
+     *
+     * 반환값: object3d local Y에서 표면의 위치. 0 = 표면 없음(기본값).
+     */
+    get receivingSurfaceY(): number;
     /**
      * 실제 사용되는 zPos 값. depth의 effectiveDepth와 짝을 이루는 NaN-safe getter.
      *

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

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

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

@@ -27,6 +27,7 @@ interface ReparentState {
     duration: number;
     startTime: number;
     progress: number;
+    keepSuppressed?: boolean;
 }
 /**
  * TransitionEffect — reparent 전환의 모든 것을 소유한다.
@@ -53,6 +54,12 @@ export default class TransitionEffect {
         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;
     /**

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

@@ -1 +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;CACjB;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;KACd,GACA,IAAI;IA+CP,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;CAWlB"}
+{"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/package.json

@@ -1,16 +1,26 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.0.0-beta.88",
+  "version": "10.0.0-beta.89",
   "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",
   "browser": "things-scene.mjs",
   "types": "dist-types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist-types/index.d.ts",
+      "node": "./things-scene-transfer.mjs",
+      "import": "./things-scene.mjs",
+      "require": "./things-scene-min.js",
+      "default": "./things-scene-min.js"
+    }
+  },
   "files": [
     "things-scene-min.js",
     "things-scene-min.js.map",
     "things-scene.mjs",
     "things-scene.mjs.map",
+    "things-scene-transfer.mjs",
     "dist-types/"
   ],
   "sideEffects": false,