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

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"}

package/package.json

@@ -1,16 +1,26 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.0.0-beta.9",
+  "version": "10.0.0-beta.90",
   "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,
@@ -64,6 +74,7 @@
     "lit": "^3.0.0",
     "mocha": "^11.0.0",
     "prettier": "^3.0.0",
+    "puppeteer": "^24.39.1",
     "rimraf": "^6.0.0",
     "rollup": "^4.0.0",
     "should": "^13.2.3",