@hatiolab/things-scene 10.0.0-beta.92 → 10.0.0-beta.94

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

@@ -94,6 +94,79 @@ export interface CarrierAttachPoint {
     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.
@@ -150,6 +223,37 @@ export interface Transferable {
     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.

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

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

package/dist-types/types/polygon-path-arc.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Polygon path arc-length / sampling.
+ *
+ * Phase L 의 PolygonPathPoint(per-vertex radius + bulge) 를 polyline 으로 평탄화하여
+ * 전체 길이 계산과 임의 위치(s ∈ [0, L)) 의 좌표·접선각 sampling 을 제공한다.
+ *
+ * 평탄화 로직은 `PolygonExtrude.shape` 의 corner round(quadratic Bezier) + bulge arc
+ * 처리와 동일 — 시각(extruded mesh)과 시뮬(carrier 위치)이 어긋나지 않는다.
+ *
+ * 사용자(loop-conveyor 등): path 가 변하지 않는 동안 결과를 캐시하여 매 carrier sample
+ * 마다 재계산을 피한다.
+ */
+import { type PolygonPathPoint } from './polygon-path.js';
+/** Path sampling 옵션. */
+export interface PathArcOptions {
+    /** Closed loop (path[N-1] → path[0] 자동 연결, 모든 vertex 에 corner round 적용 가능). default true. */
+    closed?: boolean;
+    /** per-vertex radius 가 없을 때 fallback (state.round). default 0. */
+    round?: number;
+    /** corner round (quadratic Bezier) / bulge arc 의 segment 당 sub-division 수. default 24. */
+    divisions?: number;
+}
+/** Path 위 한 점의 sample. */
+export interface PathSample {
+    x: number;
+    y: number;
+    /** 진행 방향 접선각(라디안). atan2(dy, dx). */
+    theta: number;
+}
+/**
+ * 평탄화된 polygon path. 길이/sample 의 cache 컨테이너.
+ *
+ * `path` 가 변하면 인스턴스를 다시 만들어야 한다 (mutation 추적 X).
+ */
+export declare class PolygonPathPolyline {
+    /** 평탄화된 점들. closed 면 마지막 점 = 첫 점. */
+    readonly points: ReadonlyArray<{
+        x: number;
+        y: number;
+    }>;
+    /** points[i] 까지의 누적 arc length. cumulative[0] = 0. */
+    readonly cumulative: ReadonlyArray<number>;
+    /** 전체 arc length. closed 면 폐루프 한 바퀴 길이. */
+    readonly length: number;
+    /** closed 여부 (sample 시 wraparound 결정). */
+    readonly closed: boolean;
+    constructor(points: {
+        x: number;
+        y: number;
+    }[], closed: boolean);
+    /**
+     * Path 위 거리 `s` 에서의 좌표 + 접선각.
+     * closed 면 s 는 자동 modulo wrap. open 이면 [0, length] 로 clamp.
+     */
+    sample(s: number): PathSample;
+}
+/**
+ * Polygon path 를 polyline 으로 평탄화. PolygonExtrude.shape 와 동일 sampling 로직.
+ *
+ * - corner round: quadratic Bezier (p1, cursor, p2) 를 `divisions` 분할
+ * - bulge arc: computeArcParams 의 (cx, cy, r, startAngle, endAngle, clockwise) 를
+ *   `divisions` 분할 (clockwise 부호에 맞춰 angle 진행)
+ * - closed=true: 마지막 점에서 첫 점까지 segment 로 닫음
+ * - closed=false: path[0] 와 path[N-1] 은 corner round 적용 안 함 (한쪽 변뿐)
+ */
+export declare function flattenPolygonPath(path: PolygonPathPoint[], options?: PathArcOptions): PolygonPathPolyline;
+/**
+ * Polygon path 의 전체 arc length. 짧은 한 줄 helper.
+ * 반복 호출 시 `flattenPolygonPath` 결과를 캐시하라 (이 함수는 매번 평탄화한다).
+ */
+export declare function polygonPathLength(path: PolygonPathPoint[], options?: PathArcOptions): number;
+//# sourceMappingURL=polygon-path-arc.d.ts.map

package/dist-types/types/polygon-path-arc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polygon-path-arc.d.ts","sourceRoot":"","sources":["../../src/types/polygon-path-arc.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;GAWG;AAEH,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,mBAAmB,CAAA;AAE1B,wBAAwB;AACxB,MAAM,WAAW,cAAc;IAC7B,6FAA6F;IAC7F,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0BAA0B;AAC1B,MAAM,WAAW,UAAU;IACzB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;IACT,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAA;CACd;AAQD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;IACxD,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC1C,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,0CAA0C;IAC1C,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;gBAEZ,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,MAAM,EAAE,OAAO;IAa/D;;;OAGG;IACH,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU;CAkC9B;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,gBAAgB,EAAE,EACxB,OAAO,GAAE,cAAmB,GAC3B,mBAAmB,CAiHrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAE5F"}

package/dist-types/types/polygon-path.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Polygon-style path point.
+ *
+ * 폐루프(폴리곤) 모델링에서 per-vertex 코너 라운드, 호, 3D 높이까지 표현하기 위한 확장 좌표.
+ *
+ * - x, y: 평면 좌표 (2D 캔버스, 동시에 3D 의 x, z 평면)
+ * - z: 3D 에서의 높이 (component base 로부터의 Y 오프셋). 2D 코드는 무시.
+ * - radius: per-vertex 코너 라운드 반지름. 미지정 시 state.round 로 fallback.
+ * - bulge: 다음 세그먼트에 적용할 sagitta(호의 화살 높이).
+ *          부호로 볼록/오목 결정 — 양수=화면 위쪽, 음수=화면 아래쪽.
+ *          항상 작은 호로 그려진다 (큰 호 / sweep flip 없음).
+ *          |bulge| < BULGE_EPSILON 이면 직선으로 자동 취급.
+ *
+ * 모든 필드가 옵셔널이므로 기존 `{ x, y }[]` path 와 100% 호환.
+ */
+export interface PolygonPathPoint {
+    x: number;
+    y: number;
+    z?: number;
+    radius?: number;
+    bulge?: number;
+}
+export type PolygonPath = PolygonPathPoint[];
+/**
+ * 호로 취급하는 최소 sagitta. 부동소수점 노이즈로 의도한 직선이
+ * 미세 호로 잘못 해석되는 것을 막고, 핸들 드래그에서 line ↔ arc 자동 전환의 기준이 된다.
+ */
+export declare const BULGE_EPSILON = 0.5;
+/**
+ * 다음 세그먼트가 호로 그려지는지 여부 — |bulge| >= BULGE_EPSILON 일 때만 true.
+ */
+export declare function hasArc(point: PolygonPathPoint): boolean;
+export interface ArcParams {
+    cx: number;
+    cy: number;
+    radius: number;
+    startAngle: number;
+    endAngle: number;
+    clockwise: boolean;
+}
+/**
+ * 두 점 + sagitta(=bulge) 으로부터 호 파라미터 계산.
+ *   - chord  = |p2 - p1|
+ *   - radius r = (chord² + 4·sagitta²) / (8·|sagitta|)
+ *   - 중심은 chord 중점에서 chord 에 수직 방향으로 (r - |sagitta|) 만큼 이동
+ *   - bulge 부호로 수직 방향(볼록/오목) 이 결정된다 — 항상 작은 호.
+ *
+ * 컨벤션 (캔버스 좌표계, y down): perp = (uy, -ux), 핸들 = mid + perp * bulge.
+ * 호는 핸들과 같은 쪽으로 부풀고, 중심은 그 반대편.
+ *
+ * cw:
+ *   - bulge>0 → 중심이 perp 반대편 → angle 증가가 작은 호 (cw=false)
+ *   - bulge<0 → 중심이 perp 같은 편 → angle 감소가 작은 호 (cw=true)
+ */
+export declare function computeArcParams(p1: {
+    x: number;
+    y: number;
+}, p2: {
+    x: number;
+    y: number;
+}, bulge: number): ArcParams | null;
+/**
+ * Bulge 핸들 ◇ 의 화면 위치.
+ *
+ * mid + perp * (bulge or displayMin). bulge=0 일 때도 핸들이 보이도록 displayMin 으로 보정.
+ */
+export declare function bulgeHandlePosition(p1: {
+    x: number;
+    y: number;
+}, p2: {
+    x: number;
+    y: number;
+}, bulge?: number, displayMin?: number): {
+    x: number;
+    y: number;
+    perpX: number;
+    perpY: number;
+} | null;
+/**
+ * 드래그 좌표 → 새 bulge 값. perp 축 투영. |proj| < BULGE_EPSILON 이면 0 (line).
+ * chord 길이를 초과하지 않도록 클램프.
+ */
+export declare function bulgeFromDrag(p1: {
+    x: number;
+    y: number;
+}, p2: {
+    x: number;
+    y: number;
+}, dragPoint: {
+    x: number;
+    y: number;
+}): number;
+/**
+ * 효과적 코너 반지름 — per-vertex `radius` 가 있으면 사용, 없으면 fallback.
+ * 음수/NaN 방어.
+ */
+export declare function effectiveCornerRadius(point: PolygonPathPoint, fallbackRound: number): number;
+/**
+ * 코너 라운드 핸들의 화면 위치 계산.
+ *
+ * cursor 에서 두 변(prev→cursor, cursor→next) 의 angle bisector(내각 이등분) 방향으로
+ * `dist` 만큼 이동한 점. `dist` 는 현재 라운드 값이거나, 너무 작으면 displayMin 으로 보정
+ * (radius=0 일 때도 핸들이 보이도록).
+ *
+ * 직선(180도) 코너는 bisector 가 0 → null 반환.
+ */
+export declare function cornerHandlePosition(prev: {
+    x: number;
+    y: number;
+}, cursor: {
+    x: number;
+    y: number;
+}, next: {
+    x: number;
+    y: number;
+}, effectiveR: number, displayMin?: number): {
+    x: number;
+    y: number;
+    bisectorX: number;
+    bisectorY: number;
+} | null;
+/**
+ * 드래그 좌표 → 새 corner radius 값 계산.
+ *
+ * 드래그 점을 angle bisector 축에 투영한 거리. 음수(반대편 방향)면 0 으로 클램프.
+ * 인접 변 길이의 절반을 초과하지 않도록 상한 적용.
+ */
+export declare function cornerRadiusFromDrag(prev: {
+    x: number;
+    y: number;
+}, cursor: {
+    x: number;
+    y: number;
+}, next: {
+    x: number;
+    y: number;
+}, dragPoint: {
+    x: number;
+    y: number;
+}): number;
+/**
+ * Path 의 모든 점이 동일한 z 를 갖는지 확인.
+ *
+ * 균일 z 인 경우: 전체 폴리곤이 평면 (수평) 폐루프 — `state.zPos` 만으로 표현 가능.
+ * 비균일 z 인 경우: 램프/뱅킹/엘리베이션 — 별도 BufferGeometry 빌더 필요 (Phase L.2b).
+ *
+ * 반환:
+ *   - 모든 점에 z 가 없으면 0 (기본 평면)
+ *   - 모든 점이 동일 z 를 갖으면 그 z 값
+ *   - 점마다 z 가 다르면 null (variable z, 향후 처리)
+ */
+export declare function uniformZ(path: PolygonPathPoint[]): number | null;
+//# sourceMappingURL=polygon-path.d.ts.map

package/dist-types/types/polygon-path.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.0.0-beta.92",
+  "version": "10.0.0-beta.94",
   "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",