@hatiolab/things-scene 10.0.0-beta.12 → 10.0.0-beta.120

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

@@ -0,0 +1,424 @@
+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;
+}
+/** 안착 산술의 carrier 입력 — 치수만. width/height = 2D footprint, depth = 3D 높이. */
+export interface CarrierDims {
+    width: number;
+    height: number;
+    depth: number;
+}
+/** placementFor 의 ctx — 모두 선택. 미지정 시 holder 가 현재 점유 기준 기본값 결정. */
+export interface PlacementContext {
+    /** 대상 slot — 미지정 시 첫 가용 slot. */
+    slot?: SlotDef;
+    /** ArrangementStrategy 위임용 점유 index — 미지정 시 현재 점유 수. */
+    index?: number;
+    /** 점유 총원 — 미지정 시 index 와 동일 (receive 의 호출 형태 미러). */
+    occupantCount?: number;
+    /** line / slide 형 holder 의 경로 진행도 [0, 1]. */
+    t?: number;
+}
+/** 안착 pose — holder RealObject object3d local frame. */
+export interface SeatingPose {
+    /** carrier *중심* 위치 (holder object3d local). */
+    position: Vec3;
+    /** holder-local 자세. undefined = carrier 의 들어오는 자세 보존. */
+    rotation?: QuatLike;
+}
+/**
+ * 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;
+    /**
+     * Phase PS — carrier 가 이 holder 의 ctx 지점에 안착할 때의 pose.
+     * holder RealObject object3d local frame, 순수 함수. null = 이 ctx 에 안착
+     * 정의 없음 (호출자가 현재 위치 보존 fallback).
+     *
+     * `carrier` 는 치수 객체 또는 component (state.width/height/depth 보유) —
+     * component 를 주면 dimension-aware ArrangementStrategy 가 그대로 활용.
+     * 기본 구현은 ContainerCapacity 가 제공 (기존 receivingSurfaceY +
+     * ArrangementStrategy + acceptanceRotation 합성과 수치 동일 — I5).
+     */
+    placementFor?(carrier: CarrierDims | any, ctx?: PlacementContext): SeatingPose | 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":"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"}

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

@@ -0,0 +1,117 @@
+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;
+    ease?: string;
+}
+/**
+ * TransitionEffect — reparent 전환의 모든 것을 소유한다.
+ *
+ * - 상태: Map<Component, ReparentState>
+ * - 타이밍: 자체 RAF loop
+ * - 2D 렌더링: transition canvas (lazy 생성/제거)
+ * - 3D 보간: object3d position/quaternion 직접 조작
+ * - 정리: suppressTransform 해제, canvas 제거
+ */
+export default class TransitionEffect {
+    private active;
+    /**
+     * Live-overlay 컴포넌트 — discrete transition(active) 과 달리 *연속 이동* 중
+     * 매 프레임 자기 현재 world pose 로 최상단 transition canvas 에 렌더. 용도:
+     * 컨베이어 seam 을 가로지르는 carrier 가 이웃 컴포넌트 본체에 가려지지 않게
+     * (부모 클리핑/그리기 순서를 벗어나 최상단에). caller(컨베이어/joint)가 매 틱
+     * setLiveOverlay 로 등록/해제. lerp 없음 — toScene/누적회전으로 live pose 산출.
+     */
+    private _liveOverlay;
+    private unsubscribeTick;
+    private root;
+    private _canvas;
+    private _ctx;
+    constructor(root: any);
+    isReparenting(component: any): boolean;
+    /**
+     * 연속 이동 carrier 를 최상단 overlay 렌더로 등록/해제. enable=true 면 매 프레임
+     * live world pose 로 transition canvas 에 그려져 이웃 본체에 안 가려진다. caller 가
+     * seam 구간에서만 켜고 그 외엔 끄면 surgical (그 외엔 기존 in-parent 렌더).
+     */
+    setLiveOverlay(component: any, enable: boolean): void;
+    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 종료 시 호출 — overlay 컴포넌트를 *여기서 직접* 렌더 후 canvas restore.
+     *
+     * 과거엔 container.postrender 가 isReparenting(m) 마다 renderComponent 를 위임했지만,
+     * 그러면 *컴포넌트 트리의 drawable* 만 렌더 가능했다(소터 파셀처럼 트리 밖 carrier
+     * 는 누락). 이제 TransitionEffect 가 active transition + live-overlay 전체를 자체
+     * 패스로 렌더 → 트리 무관하게 overlay 렌더. container 는 in-parent 그리기만 skip.
+     */
+    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;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,OAAO,CAAC,MAAM,CAAgC;IAC9C;;;;;;OAMG;IACH,OAAO,CAAC,YAAY,CAAiB;IACrC,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;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAcrD,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;IA+DP,MAAM,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI;IAK5B;;OAEG;IACH,eAAe,CAAC,SAAS,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,GAAG,IAAI;IAgEtD;;OAEG;IACH,SAAS,IAAI,IAAI;IAQjB;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;IAsBf;;OAEG;IACH,MAAM,IAAI,IAAI;IASd,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,YAAY;IAyBpB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,IAAI;IAoEZ,OAAO,CAAC,QAAQ;IAmBhB,OAAO,CAAC,SAAS;CAyBlB"}

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/dist-types/types/capability.d.ts

@@ -0,0 +1,59 @@
+export declare function capability<S extends string>(...names: readonly S[]): ClassDecorator;
+/**
+ * Capability 자체의 정적 metadata — 이름 / 설명 / interface 의 메서드 목록 /
+ * 부속 data model. 도구가 capability 의 *정의 / 사용 방법* 을 자동 가시화하는 데
+ * 사용. capability interface 가 정의된 파일이 자기 metadata 를 1회 register.
+ *
+ * 예 (carrier-line-capability.ts 끝):
+ *   registerCapabilityMeta({
+ *     name: 'CarrierLine',
+ *     description: 'carrier 가 동일 line 안 multi-position 이동...',
+ *     methods: ['canReserveAtJoinPoint', 'reserveAtJoinPoint', ...],
+ *     models: ['CarrierReservation', 'CarrierSlotState', 'JoinPoint'],
+ *     sourceFile: 'src/transfer/carrier-line-capability.ts'
+ *   })
+ */
+export interface CapabilityMeta {
+    readonly name: string;
+    readonly description: string;
+    readonly methods?: readonly string[];
+    readonly models?: readonly string[];
+    /**
+     * 이 capability 가 사용하는 컴포넌트 *인스턴스 state* field 이름들. Monitor 가
+     * 자동으로 component.state[field] 의 현재 값을 함께 표시.
+     *
+     * 예: Placeable.stateFields = ['depth', 'zPos']
+     */
+    readonly stateFields?: readonly string[];
+    /**
+     * 이 capability 가 사용하는 *클래스 static* field 이름들. Monitor 가 자동으로
+     * component.constructor[field] 의 값을 함께 표시.
+     *
+     * 예: Placeable.classFields = ['placement']  // archetype = 'floor' | 'ceiling' | ...
+     *
+     * archetype 같은 *컴포넌트 타입 차원의 약속* 이 여기 들어감 (인스턴스마다 다르지
+     * 않음). state 와 분리해 *변하지 않는 정의* 임을 명시.
+     */
+    readonly classFields?: readonly string[];
+    readonly sourceFile?: string;
+}
+export declare function registerCapabilityMeta(meta: CapabilityMeta): void;
+export declare function getCapabilityMeta(name: string): CapabilityMeta | undefined;
+export declare function getAllCapabilityMeta(): readonly CapabilityMeta[];
+/**
+ * 컴포넌트가 자기 capability 특화 (정책 / 설정 / runtime 통계) 를 자기 입으로
+ * 보고하는 optional 메서드 — duck-typing.
+ *
+ * 예 (LoopConveyor):
+ *   describeCapability(name: string) {
+ *     if (name !== 'CarrierLine') return undefined
+ *     return { policies: { topology: 'loop' }, runtimeStats: { activeCarriers: ... } }
+ *   }
+ */
+export interface CapabilityDescription {
+    policies?: Readonly<Record<string, unknown>>;
+    config?: Readonly<Record<string, unknown>>;
+    runtimeStats?: Readonly<Record<string, unknown>>;
+    notes?: string;
+}
+//# sourceMappingURL=capability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/types/capability.ts"],"names":[],"mappings":"AAoBA,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,cAAc,CAcnF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACpC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC;;;;;;;;OAQG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAC7B;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEjE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE1E;AAED,wBAAgB,oBAAoB,IAAI,SAAS,cAAc,EAAE,CAEhE;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5C,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAC1C,YAAY,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;IAChD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf"}