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

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

@@ -0,0 +1,342 @@
+import type { SlotDef, TransferOptions, Transferable, CarrierAttachPoint, ArrangementStrategy } from './types.js';
+import type Component from '../components/component.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<Component>>(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;
+        /**
+         * carrier 의 받아들일 회전 (parent-local quaternion). 기본 identity.
+         * 회전이 필요한 holder (induct = belt 진행 방향, rack cell = grid 정렬 등)
+         * 는 이 메소드만 override 하면 receive() 가 atomic 하게 적용한다.
+         *
+         * 반환값은 plain object {x,y,z,w} — THREE.Quaternion 도 그 인터페이스 만족.
+         */
+        acceptanceRotation(_carrier: any, _slot?: SlotDef): {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        } | undefined;
+        /**
+         * canReceive 의 풍부한 버전. ok 면 slot 동봉, 아니면 reason 명시.
+         * drag-over UI 가 사유 표시하기 위함. canReceive 와 동일 결정 사용.
+         */
+        canAccept(component: any): {
+            ok: true;
+            slot: SlotDef;
+        } | {
+            ok: false;
+            reason: string;
+        };
+        /**
+         * receive 의 alias — Phase G2 contract 의 명시적 이름. 기존 receive 호출자도
+         * 그대로 작동.
+         */
+        accept(component: any, options?: TransferOptions): Promise<void>;
+        /**
+         * Phase G5 — physical mover (robot-arm, AGV docking 등) 가 query 하는
+         * delivery world rotation. carrier 가 holder 에 도달했을 때 가져야 할
+         * world quaternion.
+         *
+         *   delivery.world = holder.world.quat × acceptanceRotation_local
+         *
+         * source 가 이걸 미리 알면 TCP yaw 를 점진적으로 맞춰 carrier 가
+         * acceptance pose 에 도달한 채로 release → handoff 시 zero-delta → 시각적
+         * 점프 없음.
+         *
+         * acceptanceRotation 미정의 OR _realObject 미빌드 시 undefined.
+         */
+        deliveryWorldRotation(carrier: any): {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        } | undefined;
+        /**
+         * Phase G9 — physical mover 가 query 하는 delivery world position.
+         *
+         * carrier 가 holder 에 도달했을 때 가져야 할 world XYZ. position 만 — rotation
+         * 은 deliveryWorldRotation 이 별도로 제공. 두 결과를 합치면 source 의 trajectory
+         * endpoint 가 됨.
+         *
+         * 기본 구현 — receivingSurfaceY 가 있으면 belt 표면 위, 없으면 slot.localPosition,
+         * 둘 다 없으면 holder object3d 원점.
+         *
+         *   surface_world_y = holder.localToWorld((0, receivingSurfaceY - geometricOffsetY, 0)).y
+         *   surface_world_xz = holder.world.xz
+         *
+         * receivingSurfaceY 의 정의가 cz-formula-tuned (= beltTopY + parent.geometricOffsetY)
+         * 라 그 차분 (- parent.geometricOffsetY) 으로 raw local 표면 Y 를 뽑아낸다.
+         *
+         * 호출 전제: holder 의 _realObject 가 빌드돼 있고 obj3d.matrixWorld 가 최신.
+         * 빌드 안 된 상태면 undefined → 호출자가 fallback (예: 2D bounds 기반).
+         */
+        deliveryWorldPosition(_carrier: any): {
+            x: number;
+            y: number;
+            z: number;
+        } | undefined;
+        attachPointFor(component: any): CarrierAttachPoint | null;
+        /** Count children currently assigned to `slotId`. */
+        _countOccupied(slotId: string): number;
+        _app: any;
+        _model: any;
+        _state: any;
+        _delta: any;
+        _animation: any;
+        _animate: any;
+        _parent: any;
+        _disposed: any;
+        _textHidden: any;
+        _text_substitutor: any;
+        _value_substitutor: any;
+        _mappings: any;
+        _realObject: import("../index.js").IRealObject | undefined;
+        _cachedState: any;
+        updatedAt: any;
+        fontSize: any;
+        __cache__: any;
+        created(): void;
+        added(parent: any): void;
+        removed(parent: any): void;
+        ready(): Promise<void>;
+        touch(): void;
+        clearCache(...attrs: any[]): void;
+        removeSelf(completely: any): void;
+        resetAnimation(): void;
+        dispose(): void;
+        get nature(): import("../index.js").ComponentNature;
+        get disposed(): boolean;
+        isLayer(): boolean;
+        isGroup(): boolean;
+        isContainer(): this is import("../types/component.js").Container;
+        isLine(): boolean;
+        isRoot(): boolean;
+        isRootModel(): boolean;
+        is3dish(): boolean;
+        get is3dMode(): boolean;
+        isIn3DSpace(): boolean;
+        isTemplate(): boolean;
+        isHTMLElement(): boolean;
+        isConnectable(): boolean;
+        isIdentifiable(): boolean;
+        isPositionable(): boolean;
+        replaceRefids(replaceMap: any): void;
+        get(property: any): any;
+        set(props: any, propval?: any): any;
+        getState(property: any): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
+        get model(): any;
+        get state(): import("../index.js").State;
+        get hierarchy(): any;
+        get volatile(): never[];
+        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        contains(x: number, y: number): boolean;
+        move(offset: {
+            x: number;
+            y: number;
+        }, ...args: boolean[]): void;
+        symmetryX(x?: number): void;
+        symmetryY(y: number): void;
+        adjustResize(bounds: import("../index.js").BOUNDS, origin_bounds: import("../index.js").BOUNDS, diagonal: boolean): {
+            left: any;
+            top: any;
+            width: any;
+            height: any;
+        };
+        adjustRotation(rotation: number, step: boolean): number;
+        outline(progress: number): any;
+        get bounds(): import("../index.js").BOUNDS;
+        set bounds(b: import("../index.js").BOUNDS);
+        get center(): import("../index.js").POINT;
+        set center(p: import("../index.js").POINT);
+        get location(): import("../index.js").POINT;
+        set location(l: import("../index.js").POINT);
+        get rotate(): import("../index.js").POINT;
+        set rotate(r: import("../index.js").POINT);
+        get dimension(): import("../index.js").DIMENSION;
+        set dimension(d: import("../index.js").DIMENSION);
+        get path(): import("../index.js").POINT[];
+        set path(p: import("../index.js").POINT[]);
+        get drawPath(): import("../index.js").POINT[];
+        get rotatePoint(): import("../index.js").POINT;
+        get mutable(): boolean;
+        get resizable(): boolean;
+        get rotatable(): boolean;
+        buildRealObject(): import("../index.js").IRealObject | undefined;
+        get realObject(): import("../index.js").IRealObject | undefined;
+        draw(context?: import("../index.js").SceneRenderContext): void;
+        prerender(context: import("../index.js").SceneRenderContext): void;
+        render(context: import("../index.js").SceneRenderContext): void;
+        postrender(context: import("../index.js").SceneRenderContext): void;
+        prepare(resolve: (component: Component) => void, reject: (reason: any) => void): void;
+        prepareIf(condition: boolean): void;
+        drawText(context: import("../index.js").SceneRenderContext): void;
+        drawStroke(context: import("../index.js").SceneRenderContext, override?: Record<string, unknown>): void;
+        drawFill(context: import("../index.js").SceneRenderContext, override?: Record<string, unknown>): void;
+        get strokeStyle(): any;
+        set strokeStyle(v: any);
+        get fillStyle(): any;
+        set fillStyle(v: any);
+        get fontColor(): string;
+        set fontColor(v: string);
+        get rotation(): number;
+        set rotation(v: number);
+        get decorators(): string[];
+        get decotag(): string;
+        get hidden(): boolean;
+        set hidden(v: boolean);
+        get tag(): string;
+        set tag(v: string);
+        get appendum(): any;
+        set appendum(v: any);
+        defaultTextSubstitutor(): string;
+        textLines(context?: import("../index.js").SceneRenderContext): any[][];
+        get font(): string;
+        get lineHeight(): number;
+        get textSubstitutor(): () => string;
+        get text(): string;
+        set text(v: string);
+        get textBounds(): import("../index.js").BOUNDS;
+        get textRotation(): number;
+        get textHidden(): boolean;
+        set textHidden(v: boolean);
+        get hasTextProperty(): boolean;
+        animate(opts: import("../index.js").AnimationConfig): any;
+        effect(context: import("../index.js").SceneRenderContext, model: any): void;
+        serialize(...others: any[]): string;
+        trim(): void;
+        closeScene(data: any): void;
+        delta(attr?: string | object, value?: any): any;
+        invalidate(): void;
+        get value(): any;
+        set value(v: any);
+        get data(): any;
+        set data(v: any);
+        set tap(v: any);
+        get mappings(): any[];
+        get retention(): number;
+        get animation(): import("../index.js").AnimationController | undefined;
+        get started(): boolean;
+        set started(v: boolean);
+        get controls(): import("../index.js").Control[] | undefined;
+        findFirst(finder: string | ((c: Component) => boolean), ...others: any[]): Component | undefined;
+        findAll(s: string | ((c: Component) => boolean), ...others: any[]): any[] | undefined;
+        capture(x: number, y: number, except?: (c: Component) => boolean): any;
+        findAnchor(name: string): any;
+        isDescendible(container: Component | any): boolean;
+        getContext(component?: unknown): any;
+        get root(): Component;
+        get rootModel(): Component;
+        get parent(): Component;
+        set parent(v: Component);
+        get anchors(): import("../index.js").Anchor[];
+        get scalable(): boolean;
+        get stuck(): boolean;
+        get capturable(): boolean;
+        get position(): string;
+        get origin(): string;
+        get offset(): import("../index.js").POINT;
+        get app(): import("../index.js").ApplicationContext;
+        drawEffect(context: import("../index.js").SceneRenderContext): void;
+        prepareFill(resolve: Function, reject: Function): void;
+        prepareFillIf(condition: boolean): void;
+        onchangeFill(after: Record<string, any>, before: Record<string, any>): void;
+        drawImage(context: import("../index.js").SceneRenderContext, image: HTMLImageElement, left: number, top: number, width: number, height: number): void;
+        mutateBounds(logic: ((bounds: import("../index.js").BOUNDS) => import("../index.js").BOUNDS | void) | null, context?: any): void;
+        mutatePath(beforeLogic: ((path: import("../index.js").POINT[]) => import("../index.js").POINT[] | void) | null, afterLogic: ((path: import("../index.js").POINT[]) => import("../index.js").POINT[] | void) | null, context?: any): void;
+        access(accessor: string): any;
+        substitute(template: string, data: any): string | undefined;
+        onchangeMappings(after: Record<string, any>, before: Record<string, any>): void;
+        onchangeData(after: Record<string, any>, before: Record<string, any>): void;
+        buildMappings(): void;
+        executeMappings(force?: boolean): void;
+        disposeMappings(): void;
+        ondropfile(transfered: FileList, files: string[]): void;
+        transcoordS2P(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        transcoordP2S(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        transcoordS2T(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordT2P(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordT2S(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2TR(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2O(x: number, y: number, target: Component): import("../index.js").POINT;
+        transcoordC2S(x: number, y: number, top?: Component): import("../index.js").POINT;
+        transcoordS2C(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toParent(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        fromParent(x: number, y: number, rp?: import("../index.js").POINT): import("../index.js").POINT;
+        toScene(x: number, y: number, top?: Component): import("../index.js").POINT;
+        fromScene(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toLocal(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toGlobal(x: number, y: number, top?: Component): import("../index.js").POINT;
+        toOther(x: number, y: number, target: Component): import("../index.js").POINT;
+        on<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        on(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        off<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback?: ((...args: import("../index.js").ComponentEventMap[K]) => void) | undefined, context?: any): /*elided*/ any;
+        off(name?: string | object, callback?: Function, context?: any): /*elided*/ any;
+        once<K extends keyof import("../index.js").ComponentEventMap>(name: K, callback: (...args: import("../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        once(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        trigger<K extends keyof import("../index.js").ComponentEventMap>(name: K, ...args: import("../index.js").ComponentEventMap[K]): /*elided*/ any;
+        trigger(name: string, ...args: any[]): /*elided*/ any;
+        delegate_on(delegator: any): /*elided*/ any;
+        delegate_off(delegator: any): /*elided*/ any;
+        onchange(after: Record<string, any>, before: Record<string, any>): void;
+        calculateBounds?(): void;
+        oncreate_element?(element: HTMLElement): void;
+        removeComponent(component: Component, ghost?: boolean): void;
+        addComponent(component: Component, ghost?: boolean): void;
+        insertComponentAt(component: Component, index: number, ghost?: boolean): void;
+        getOverlay(component: Component): HTMLElement | undefined;
+        findById(id: string): Component | undefined;
+        findByRefid(ref: string | number): Component | undefined;
+        findAllById(id: string): Component[];
+        resize(): void;
+        fit(type?: string): void;
+        get components(): Component[] | undefined;
+        get layout(): any;
+        get auxOverlay(): HTMLElement | undefined;
+        get isReady(): boolean;
+        get unitScale(): number;
+        get selected(): Component[];
+        set selected(_v: Component[]);
+        get focused(): Component | null;
+        set focused(_v: Component | null);
+        get hasSameParentForAllSelected(): boolean;
+        set hasSameParentForAllSelected(_v: boolean);
+        get fitMode(): string | undefined;
+        set fitMode(_v: string | undefined);
+        get element(): HTMLElement | null;
+        set element(_v: HTMLElement | null);
+    };
+} & 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":"AAiBA,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACjH,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AAOvD,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,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK;kBARtC,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;4BAyFjD,GAAG,UAAU,YAAY,YAAW,eAAe,GAAQ,OAAO,CAAC,IAAI,CAAC;0BAoChF,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;QAWtD;;;;;;WAMG;qCAC0B,GAAG,UAAU,OAAO,GAAG;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS;QAI9G;;;WAGG;6BACkB,GAAG,GAAG;YAAE,EAAE,EAAE,IAAI,CAAC;YAAC,IAAI,EAAE,OAAO,CAAA;SAAE,GAAG;YAAE,EAAE,EAAE,KAAK,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE;QAmBtF;;;WAGG;0BACe,GAAG,YAAY,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;QAIhE;;;;;;;;;;;;WAYG;uCAC4B,GAAG,GAAG;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS;QAe/F;;;;;;;;;;;;;;;;;;WAkBG;wCAC6B,GAAG,GAAG;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS;kCAwB3D,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,15 @@
+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, QuatLike, PoseSerialized, PickupFrame, PickupRequester, Pickable } from './types.js';
+export { quatFromYaw, rectangularFootprintFrames, topApproachFrame, filterByToolType, chooseNearestPickupFrame } from './pickup-helpers.js';
+export type { RectangularFootprintOptions, TopApproachOptions } from './pickup-helpers.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';
+export { Transfer, transferLog, receiptToJSON } from './transfer.js';
+export type { TransferPhase, TransferTimeline, TransferReceipt, TransferReceiptJSON, TransferLogStats, PhysicalRunner, TransferInit } from './transfer.js';
+export { ReservationTable, reservationTable, standardYieldPolicy, NavGraph, buildNavGraph, planPathAStar, planToReservations } from '../navigation/index.js';
+export type { LaneGeometry, Lane, ConflictPair, Intersection, NavPolygon, OpenZone, TimeWindow, Reservation, SpeedProfile, PathSegment, PathPlan, PathPlanOptions, Navigable, YieldDecision, YieldPolicy, ReservationEvent, AddResult, Conflict, ConflictRecord, NavNode, NavEdge, BuildNavGraphOptions } from '../navigation/index.js';
+export * from '../types/polygon-path.js';
+export * from '../types/polygon-path-arc.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,EAET,QAAQ,EACR,cAAc,EACd,WAAW,EACX,eAAe,EACf,QAAQ,EACT,MAAM,YAAY,CAAA;AAGnB,OAAO,EACL,WAAW,EACX,0BAA0B,EAC1B,gBAAgB,EAChB,gBAAgB,EAChB,wBAAwB,EACzB,MAAM,qBAAqB,CAAA;AAC5B,YAAY,EAAE,2BAA2B,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAE1F,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;AAItD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACpE,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,YAAY,EACb,MAAM,eAAe,CAAA;AAItB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,QAAQ,EACR,aAAa,EACb,aAAa,EACb,kBAAkB,EACnB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EACV,YAAY,EACZ,IAAI,EACJ,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,eAAe,EACf,SAAS,EACT,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,cAAc,EACd,OAAO,EACP,OAAO,EACP,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAG/B,cAAc,0BAA0B,CAAA;AACxC,cAAc,8BAA8B,CAAA"}

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

@@ -0,0 +1,65 @@
+import type { PickupFrame, PickupRequester, Vec3, QuatLike, PoseSerialized } from './types.js';
+/**
+ * Y 축 (3D vertical) 회전을 quaternion 으로. Three.js 없이 직접 계산 (cross-package
+ * 호환성).
+ *
+ *   q = (0, sin(θ/2), 0, cos(θ/2))
+ */
+export declare function quatFromYaw(yawRad: number): QuatLike;
+export interface RectangularFootprintOptions {
+    /** carrier 의 world pose — entry 들이 이 frame 기준으로 회전/병진된다. */
+    carrierWorld: PoseSerialized;
+    /** carrier 의 가로 (X 방향). */
+    width: number;
+    /** carrier 의 세로 (Z 방향). */
+    depth: number;
+    /** entry 가 carrier 의 어느 높이에 있는가 (carrier-local Y). */
+    entryHeight: number;
+    /** approach 가 engage 에서 얼마나 떨어진 거리. */
+    approachDistance: number;
+    /** 어느 면에 entry 를 둘지. 'east'+'west' = 2-way, 4 개 다 = 4-way. */
+    sides: ReadonlyArray<'east' | 'west' | 'north' | 'south'>;
+    /** entry 의 toolType. 모두 동일하면 string, 면별 다르면 map. */
+    toolType: string | Partial<Record<'east' | 'west' | 'north' | 'south', string>>;
+    /** entry 의 tolerance. */
+    tolerance?: PickupFrame['tolerance'];
+    /** entry 의 priority. */
+    priority?: number;
+}
+/**
+ * 직사각형 carrier 의 N-면 진입 entry 들을 한꺼번에 생성.
+ *
+ * 각 entry 의 engage 는 carrier 의 해당 면 중심 (carrier-local), approach 는
+ * 그 외부 approachDistance 만큼 떨어진 점. 도구는 carrier 쪽을 향한 채 (yaw)
+ * 다가오는 자세.
+ */
+export declare function rectangularFootprintFrames(options: RectangularFootprintOptions): PickupFrame[];
+export interface TopApproachOptions {
+    carrierWorld: PoseSerialized;
+    /** carrier 의 top 표면 Y (carrier-local). */
+    topY: number;
+    /** approach 가 top 에서 얼마나 위에 있는가. */
+    approachDistance: number;
+    toolType: string;
+    tolerance?: PickupFrame['tolerance'];
+    priority?: number;
+    id?: string;
+}
+/**
+ * 위쪽 한 점 진입 (예: vacuum gripper 로 box 집기, 자석으로 철판 들기).
+ *
+ * engage 는 carrier 의 top 표면 중심, approach 는 그 위 approachDistance.
+ * 도구는 carrier 위에서 수직 하강 — yaw 보존 (도구가 회전하지 않음).
+ */
+export declare function topApproachFrame(options: TopApproachOptions): PickupFrame;
+/**
+ * Pickable.pickupFramesFor 의 기본 구현. 도구 type 일치하는 entry 만 통과.
+ * tool footprint 까지 검사하고 싶으면 carrier 가 자체 override.
+ */
+export declare function filterByToolType(frames: PickupFrame[], requester: PickupRequester): PickupFrame[];
+/**
+ * 두 entry 중 source 위치에 더 가까운 것을 고르는 helper. distance 는 approach
+ * pose 위치 기준. priority 가 다르면 priority 우선.
+ */
+export declare function chooseNearestPickupFrame(frames: PickupFrame[], fromWorldPosition: Vec3): PickupFrame | null;
+//# sourceMappingURL=pickup-helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pickup-helpers.d.ts","sourceRoot":"","sources":["../../src/transfer/pickup-helpers.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAI9F;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAQpD;AA2CD,MAAM,WAAW,2BAA2B;IAC1C,4DAA4D;IAC5D,YAAY,EAAE,cAAc,CAAA;IAC5B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,sDAAsD;IACtD,WAAW,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,gBAAgB,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,KAAK,EAAE,aAAa,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,CAAA;IACzD,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/E,yBAAyB;IACzB,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;IACpC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAYD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,2BAA2B,GAAG,WAAW,EAAE,CAiD9F;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,cAAc,CAAA;IAC5B,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAA;IACxB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAoBzE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,WAAW,EAAE,EACrB,SAAS,EAAE,eAAe,GACzB,WAAW,EAAE,CAEf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,WAAW,EAAE,EACrB,iBAAiB,EAAE,IAAI,GACtB,WAAW,GAAG,IAAI,CAkBpB"}

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