@hatiolab/things-scene 10.0.0-beta.10 → 10.0.0-beta.100

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

@@ -0,0 +1,168 @@
+import type { Transferable, TransferOptions } from './types.js';
+export type TransferPhase = 'pending' | 'planning' | 'physical' | 'handoff' | 'committed' | 'rolled-back';
+export interface TransferTimeline {
+    initiatedAt: number;
+    planStartAt?: number;
+    planEndAt?: number;
+    physicalStartAt?: number;
+    physicalEndAt?: number;
+    handoffAt?: number;
+    committedAt?: number;
+}
+export interface TransferReceipt {
+    transferId: string;
+    source: any;
+    target: any;
+    carrier: any;
+    /** Phase G7 — 직렬화 용. live refs 가 GC 되어도 보존되는 식별자. */
+    sourceId?: string;
+    targetId?: string;
+    carrierId?: string;
+    phase: TransferPhase;
+    timeline: TransferTimeline;
+    slotId?: string;
+    rejectReason?: string;
+}
+/**
+ * TransferReceipt 의 직렬화 형태 — live ref 제외, ID 만. JSON.stringify 안전.
+ * Phase G7 의 snapshot/replay 용.
+ */
+export interface TransferReceiptJSON {
+    transferId: string;
+    sourceId?: string;
+    targetId?: string;
+    carrierId?: string;
+    phase: TransferPhase;
+    timeline: TransferTimeline;
+    slotId?: string;
+    rejectReason?: string;
+}
+/**
+ * Receipt 의 plain JSON 변환. live ref 제외, undefined 필드 omit (JSON
+ * round-trip 결정성 보장).
+ */
+export declare function receiptToJSON(receipt: TransferReceipt): TransferReceiptJSON;
+/**
+ * Source 가 physical 단계에서 사용하는 운반 함수. logical-only source
+ * (Conveyor.dispatch 등) 는 noop 으로 즉시 resolve.
+ *
+ * 호출 시점: Transfer 의 physical phase 진입.
+ * 반환: physical 운반 완료 (carrier 가 target.deliveryPose 에 도달) 시 resolve.
+ */
+export type PhysicalRunner = () => Promise<void>;
+export interface TransferLogStats {
+    total: number;
+    byPhase: Record<string, number>;
+    committed: number;
+    rolledBack: number;
+    rejectionRate: number;
+    avgTransferDurationMs: number;
+}
+export interface TransferInit {
+    source: any;
+    target: Transferable;
+    carrier: any;
+    options?: TransferOptions;
+    /** physical 운반자 (RobotArm, AGV 등). 미지정 시 즉시 통과. */
+    physical?: PhysicalRunner;
+}
+/**
+ * Transfer — 한 carrier 의 source → target 이동 사건.
+ *
+ * 사용:
+ *   const t = new Transfer({ source, target, carrier, options })
+ *   const receipt = await t.execute()
+ *
+ * 또는 Transferable.dispatch 가 내부적으로:
+ *   const t = new Transfer({ source: this, target, carrier, options })
+ *   await t.execute()
+ */
+export declare class Transfer {
+    readonly id: string;
+    readonly source: any;
+    readonly target: Transferable;
+    readonly carrier: any;
+    readonly options: TransferOptions;
+    readonly physical: PhysicalRunner | null;
+    private _phase;
+    private _timeline;
+    private _slot;
+    private _rejectReason?;
+    constructor(init: TransferInit);
+    get phase(): TransferPhase;
+    get timeline(): Readonly<TransferTimeline>;
+    /**
+     * 5-phase 실행. 각 phase 진입 시 timeline 갱신, 완료 시 receipt 반환.
+     *
+     * Negotiate / Plan 단계에서 거부 → rolled-back receipt.
+     * Physical 단계에서 throw → rolled-back receipt.
+     * Handoff 이후 throw 는 일관성 깨질 수 있으므로 그대로 propagate.
+     */
+    execute(): Promise<TransferReceipt>;
+    /**
+     * physical / planning 도중 외부 취소. handoff 이후엔 호출 금지 (이미 commit 됨).
+     * 현재 구현은 phase 만 표시하고 carrier 의 상태는 건드리지 않음 — physical
+     * 운반자가 자체 cancel 책임.
+     */
+    rollback(): void;
+    private _buildReceipt;
+}
+/**
+ * 모든 Transfer 의 receipt 를 기록하는 singleton. observability 의 기반.
+ * Phase G7 — JSON snapshot/load 지원으로 외부 도구 (Chrome extension 등) 에서
+ * 라이브 또는 저장된 로그를 동일하게 시각화할 수 있다.
+ */
+declare class TransferLogImpl {
+    private _entries;
+    private _maxEntries;
+    private _listeners;
+    append(receipt: TransferReceipt): void;
+    /** 모든 receipt 반환 (read-only 사본). */
+    entries(): readonly TransferReceipt[];
+    /** carrier 별 transfer 이력. live ref 매칭 우선, fallback 으로 carrierId. */
+    forCarrier(carrier: any): readonly TransferReceipt[];
+    /** carrierId 로 직접 조회 (snapshot 복원 후 등 live ref 가 없을 때). */
+    forCarrierId(carrierId: string): readonly TransferReceipt[];
+    /** sourceId 로 조회 — 특정 vehicle / source 의 transfer 이력. */
+    forSourceId(sourceId: string): readonly TransferReceipt[];
+    /** targetId 로 조회 — 특정 holder 의 receive 이력. */
+    forTargetId(targetId: string): readonly TransferReceipt[];
+    /** phase 별 필터 (e.g. 'rolled-back' 만 — 실패 진단). */
+    forPhase(phase: TransferPhase): readonly TransferReceipt[];
+    /**
+     * sim-time 범위로 필터. transfer 의 initiatedAt 이 [startSimMs, endSimMs] 안에 있는지.
+     * 'overlap' 모드 — initiatedAt..committedAt 윈도우가 query 윈도우와 겹치면 포함.
+     */
+    inTimeRange(startSimMs: number, endSimMs: number, mode?: 'init' | 'overlap'): readonly TransferReceipt[];
+    /** rejectReason 별 그룹화 — 실패 패턴 진단. */
+    groupByRejectReason(): Map<string, readonly TransferReceipt[]>;
+    /** 통계 — 전체 / phase 별 / 거부율 / 평균 transfer 시간 등. */
+    stats(): TransferLogStats;
+    /** 새 receipt 마다 호출되는 listener 등록. */
+    subscribe(listener: (receipt: TransferReceipt) => void): () => void;
+    clear(): void;
+    setMaxEntries(n: number): void;
+    /**
+     * 모든 receipt 를 JSON 안전한 plain object 배열로. live ref 제외, ID 만 포함.
+     * JSON.stringify(transferLog.toJSON()) 안전.
+     */
+    toJSON(): TransferReceiptJSON[];
+    /**
+     * JSON 배열에서 entries 복원 (기존 entries 대체). 외부 viewer (extension) 가
+     * 저장된 로그를 로드해서 시각화할 때 사용.
+     *
+     * 복원된 receipt 는 source/target/carrier 의 live ref 가 undefined — ID 만으로
+     * 추적 (forCarrierId, sourceId, targetId 등). listener 에는 알림 안 함 (load
+     * 는 silent).
+     */
+    fromJSON(json: TransferReceiptJSON[]): void;
+    /**
+     * 저장된 로그를 listener 에게 순서대로 다시 발화 — extension 이 세션 시작 시
+     * 기존 entries 도 받고 싶을 때. listener 가 새 receipt 와 replayed receipt 를
+     * 구분 못 하므로 호출자가 의도적으로 사용.
+     */
+    replayTo(listener: (receipt: TransferReceipt) => void): void;
+}
+export declare const transferLog: TransferLogImpl;
+export {};
+//# sourceMappingURL=transfer.d.ts.map

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

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

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

@@ -0,0 +1,389 @@
+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;
+}
+/**
+ * Quaternion as a plain object {x, y, z, w}. THREE.Quaternion 도 이 인터페이스
+ * 만족 — 호출자는 어느 쪽이든 받을 수 있다.
+ */
+export interface QuatLike {
+    x: number;
+    y: number;
+    z: number;
+    w: number;
+}
+/**
+ * Pose6DOF 의 직렬화 형태 (cross-package 호환). things-scene/math 의
+ * Pose6DOF.toJSON() 결과와 같은 shape.
+ */
+export interface PoseSerialized {
+    position: Vec3;
+    rotation: QuatLike;
+}
+/**
+ * Phase H — carrier 의 진입 정책 (PickupFrame).
+ *
+ * carrier 가 "어떤 도구가 어디로 어떤 각도로 접근하면 들어올릴 수 있다" 를
+ * 선언적으로 표현. holder 측 acceptanceFrame 의 carrier 측 대칭.
+ *
+ *   approach: 도구가 결합 직전 hover 자세 (world Pose6DOF).
+ *   engage:   도구가 결합 시점 자세 (world Pose6DOF). 보통 carrier 의 entry
+ *             surface 에 접한 위치.
+ *   tolerance: trajectory planner 가 활용 — 너무 엄격하면 reroute 빈번.
+ *   priority: 여러 entry 중 source 가 선택 시 hint (낮을수록 우선).
+ *
+ * 예시 — pallet 의 두 fork 진입점:
+ *   { id: 'fork-west', toolType: 'forklift-fork',
+ *     approach: { position: {x: -300, y: 50, z: 0}, rotation: identity },
+ *     engage:   { position: {x:    0, y: 50, z: 0}, rotation: identity },
+ *     tolerance: { positionMm: 50, angleDeg: 5 } }
+ */
+export interface PickupFrame {
+    id: string;
+    toolType: string;
+    approach: PoseSerialized;
+    engage: PoseSerialized;
+    tolerance?: {
+        positionMm?: number;
+        angleDeg?: number;
+    };
+    priority?: number;
+}
+/**
+ * 도구의 자기 소개. carrier 가 pickupFramesFor 로 필터링할 때 활용.
+ */
+export interface PickupRequester {
+    toolType: string;
+    /** 도구의 footprint (forklift fork 길이, gripper 폭 등) — 호환성 검사용. */
+    size?: {
+        width: number;
+        depth: number;
+        height?: number;
+    };
+}
+/**
+ * Pickable — carrier 가 자기 진입 정책을 노출하는 인터페이스.
+ *
+ * 빈 배열 반환 = "들어올릴 수 없음" (예: 부착된 fixture). source 는 명시적
+ * reject 사유 ('un-pickable') 로 응답.
+ *
+ * pickupFramesFor 는 선택. 정의하면 source 가 자기 도구 type 으로 호출 →
+ * carrier 가 그 type 에 맞는 entry 만 반환. 기본 구현은 toolType 으로 단순
+ * filter (Phase H reference 구현이 제공).
+ */
+export interface Pickable {
+    pickupFrames(): PickupFrame[];
+    pickupFramesFor?(requester: PickupRequester): PickupFrame[];
+}
+/**
+ * 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;
+    /**
+     * carrier 가 이 holder 안에서 가져야 할 회전 (parent-local quaternion).
+     * 기본값 identity (carrier 의 들어오는 자세 보존).
+     * 다음을 override 하는 holder 예시:
+     *   - InductStation: belt 진행 방향 = sorter forward 와 일치
+     *   - Sorter carrier: 슬롯의 perimeter tangent
+     *   - Rack cell: grid 정렬 방향
+     */
+    acceptanceRotation?(carrier: any, slot?: SlotDef): {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    } | undefined;
+    /**
+     * canReceive 의 더 풍부한 버전 — 거부 사유까지 명시.
+     * 기본 구현은 findSlot 결과로 ok/reason 분기. drag-over UI 가 사유를 표시할
+     * 수 있게 함.
+     */
+    canAccept?(carrier: any): {
+        ok: true;
+        slot: SlotDef;
+    } | {
+        ok: false;
+        reason: string;
+    };
+    /**
+     * receive 의 새 이름. 동일 동작 — Phase G2 의 contract 명시.
+     * 기존 receive 호출자도 작동 (alias).
+     */
+    accept?(carrier: any, options?: TransferOptions): Promise<void> | void;
+}
+/**
+ * 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":"AAYA,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACtD,MAAM,MAAM,KAAK,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AACpE,MAAM,MAAM,OAAO,GAAG,IAAI,GAAG,KAAK,CAAA;AAIlC;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;AAE1E,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEtD,kEAAkE;AAClE,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,4EAA4E;IAC5E,aAAa,CAAC,EAAE,IAAI,CAAA;IACpB,aAAa,CAAC,EAAE,IAAI,CAAA;IACpB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED,sEAAsE;AACtE,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAID,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAID;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,aAAa,GAAG,aAAa,CAAA;AAI3E,gEAAgE;AAChE,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,OAAO,GAAG,QAAQ,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAA;CAC1B;AAID,MAAM,MAAM,iBAAiB,GACzB,mBAAmB,GACnB,qBAAqB,GACrB,kBAAkB,GAClB,iBAAiB,GACjB,mBAAmB,CAAA;AAEvB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAA;IACvB,SAAS,EAAE,GAAG,CAAA;IACd,SAAS,EAAE,GAAG,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAID,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,IAAI,CAAA;IACd,QAAQ,EAAE,IAAI,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf;AAID;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACV;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAA;IACd,QAAQ,EAAE,QAAQ,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,cAAc,CAAA;IACxB,MAAM,EAAE,cAAc,CAAA;IACtB,SAAS,CAAC,EAAE;QACV,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAA;IAChB,+DAA+D;IAC/D,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CACzD;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,YAAY,IAAI,WAAW,EAAE,CAAA;IAC7B,eAAe,CAAC,CAAC,SAAS,EAAE,eAAe,GAAG,WAAW,EAAE,CAAA;CAC5D;AAID;;;;;;GAMG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI,CAAA;IAEhG,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAA;CACnC;AAID;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAG3B;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAA;IAEnC,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,GAAG,IAAI,CAAA;IAIxC,2EAA2E;IAC3E,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAExE,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;IAI/F;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,GAAG,GAAG,YAAY,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAA;IAEzE;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAAA;IAExD;;;OAGG;IACH,WAAW,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAIlD,wEAAwE;IACxE,cAAc,CAAC,SAAS,EAAE,GAAG,GAAG,kBAAkB,GAAG,IAAI,CAAA;IAWzD;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAE7G;;;;OAIG;IACH,SAAS,CAAC,CAAC,OAAO,EAAE,GAAG,GAAG;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAErF;;;OAGG;IACH,MAAM,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CACvE;AAID;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,YAAY,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,IAAI,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpC,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,WAAW,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnF,IAAI,IAAI,IAAI,CAAA;IACZ,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAA;CAC1D;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE5E;;;OAGG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEvE,gFAAgF;IAChF,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAA;IAElC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,OAAO,CAAA;CAC/C;AAID,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,sBAAsB,GACtB,SAAS,GACT,uBAAuB,GACvB,SAAS,GACT,MAAM,GACN,QAAQ,CAAA;AAEZ,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAA;IACnC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAA;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,gDAAgD;IAChD,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,MAAM,EAAE,aAAa,CAAA;IACrB,qCAAqC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,4EAA4E;IAC5E,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,QAAQ,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAChF,oDAAoD;IACpD,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAA;IAC9C,QAAQ,CAAC,YAAY,EAAE,SAAS,cAAc,EAAE,CAAA;CACjD;AAID;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAA;IACvD,+EAA+E;IAC/E,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,yDAAyD;IACzD,QAAQ,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,CAAA;CAC/B;AAID;;;;GAIG;AACH,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,qEAAqE;IACrE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,CAAA;IAC5D,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,YAAY,EAAE,SAAS,GAAG,OAAO,GAAG,UAAU,CAAA;CACxD;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,YAAY;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAA;IAClC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAChC"}

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

@@ -0,0 +1,97 @@
+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;
+    };
+    /**
+     * 매 frame slerp 후 obj3d.local.quat 을 inv(parent.world.quat) × worldQuatLock 으로
+     * 덮어써서 **world rotation 고정**. transition 동안 부모(예: cross-belt proxy)가
+     * 움직여도 박스의 절대 자세 보존. to3D 에만 지정해도 동작.
+     */
+    worldQuatLock?: any;
+}
+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 unsubscribeTick;
+    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":"AAgBA,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;IAC7C;;;;OAIG;IACH,aAAa,CAAC,EAAE,GAAG,CAAA;CACpB;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,eAAe,CAA4B;IACnD,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;IA8DP,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;IAWpB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,IAAI;IAoEZ,OAAO,CAAC,QAAQ;IAkBhB,OAAO,CAAC,SAAS;CAyBlB"}