@hatiolab/things-scene 10.0.0-beta.11 → 10.0.0-beta.110

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

@@ -1,178 +1,7 @@
-import { Bounds, Point } from './bounding';
-import type { Event } from './event';
-import type { ApplicationContext } from '../interfaces/providers';
-import type { LAYOUT } from '../interfaces/layout';
-export type { ApplicationContext };
-/**
- * Represents a visual or logical unit inside a container.
- * Each component may either participate in layout (static)
- * or manage its own position (absolute).
- *
- * This interface matches the actual Component class API
- * (including declaration-merged members from component modules).
- */
-export interface Component extends Event {
-    /**
-     * Determines if the component is static (participates in layout)
-     * or absolute (self-positioned).
-     */
-    position: string;
-    /** Whether the component is hidden (excluded from rendering). */
-    hidden?: boolean;
-    /**
-     * Whether the component is scalable.
-     */
-    scalable?: boolean;
-    /**
-     * The application context that the component belongs to.
-     * This provides access to application-specific resources and services.
-     */
-    app: ApplicationContext;
-    /**
-     * The model object associated with the component.
-     */
-    model: any;
-    /**
-     * The root component of the entire scene graph.
-     */
-    root: Component;
-    /**
-     * The root model component in the logical structure.
-     */
-    rootModel: Component;
-    /** Gets a named state value. */
-    getState<T = any>(key: string): T | undefined;
-    /** Sets one or more named state values. */
-    setState<T = any>(key: string, value: T): void;
-    setState(state: Record<string, any>): void;
-    /** The data object associated with the component. */
-    data: any;
-    /** The rectangular bounds. */
-    bounds: Bounds;
-    /** Center point of the bounds. */
-    center: Point;
-    /** The text bounds. */
-    textBounds: Bounds;
-    /** Whether the component is a container. */
-    isContainer(): boolean;
-    /** Whether the component is an HTML element. */
-    isHTMLElement(): boolean;
-    /** Retrieves a model property by key. */
-    get(key: string): any;
-    /** Invalidates the component for re-rendering. */
-    invalidate(): void;
-    /** The parent component. */
-    parent: Component;
-    /** Array of child components (if container). */
-    components?: Component[];
-    /** Repositions an HTML element overlay. */
-    reposition?(): void;
-    /** Converts a local point to parent container space. */
-    toParent(x: number, y: number): Point;
-    /** Converts a parent-space point into local space. */
-    fromParent(x: number, y: number): Point;
-    /** Converts a local point into scene-wide global space. */
-    toScene(x: number, y: number): Point;
-    /** Converts a scene-space point into local space. */
-    fromScene(x: number, y: number): Point;
-    /** Converts screen (DOM event) coordinates into local space. */
-    toLocal(x: number, y: number): Point;
-    /** Converts a local-space point into screen coordinates. */
-    toGlobal(x: number, y: number): Point;
-    /** Converts a point from this component's local space to another component's local space. */
-    toOther(x: number, y: number, target: Component): Point;
-    /** Gets the HTML overlay element for the component. */
-    getOverlay?(component: Component | {
-        scalable: boolean;
-    }): HTMLElement;
-    /** The auxiliary overlay element. */
-    auxOverlay?: HTMLElement;
-    /** Selected components (root container). */
-    selected?: Component[];
-    /** Focused component (root container). */
-    focused?: Component | null;
-    /** Whether all selected components share the same parent. */
-    hasSameParentForAllSelected?: boolean;
-    /** Fit mode for the scene (root container). */
-    fitMode?: string;
-    /** Unit scale (root container). */
-    unitScale?: number;
-    /** Resize handler. */
-    resize?(): void;
-    /** Fit handler (root container). */
-    fit?(): void;
-    /** The HTML element associated with this component. */
-    element?: HTMLElement | null;
-}
-/**
- * Represents a layout container that holds and arranges components.
- */
-export interface Container extends Component {
-    /** List of child components managed by the layout. */
-    components: Component[];
-    /** The layout strategy used to arrange child components. */
-    layout: LAYOUT;
-    /** (Optional) Retrieves the component at the specified index. */
-    getAt?(index: number): Component | undefined;
-    /**
-     * Applies a function to each component in the container.
-     */
-    forEach(callback: (component: Component, index: number) => void, thisArg?: any): void;
-    /** Adds a child component to this container. */
-    addComponent(component: Component, ghost?: boolean): void;
-    /** Removes a child component from this container. */
-    removeComponent(component: Component, ghost?: boolean): void;
-    /** Inserts a child component at a specific index. */
-    insertComponentAt(component: Component, index: number, ghost?: boolean): void;
-    /** Adds one or more components (convenience method). */
-    add(comp: Component | Component[], ghost?: boolean): Container;
-    /** Removes one or more components (convenience method). */
-    remove(comp: Component | Component[], ghost?: boolean): Container;
-    /** Traverses the container tree depth-first. */
-    traverse(fn: (component: Component) => void, context?: any): void;
-    /** Returns the index of the given component within this container's children. */
-    indexOf(item: Component): number;
-    /** Returns the number of child components. */
-    size(): number;
-    /** Always returns true for containers. */
-    isContainer(): true;
-    /** Checks if the given component can be added to this container. */
-    containable(component: Component): boolean;
-    /** Triggers layout reflow on this container and its sub-containers. */
-    reflow(): void;
-    /** Finds a component by its id within the scene. */
-    findById?(id: string): Component | undefined;
-    /** Finds a component by its refid within the scene. */
-    findByRefid?(ref: string | number): Component | undefined;
-}
-/**
- * A layout strategy defines how a container arranges its child components.
- * Only components with `position: 'static'` should be affected by layout.
- */
-export interface Layout {
-    /**
-     * Recalculates the positions and sizes of child components.
-     */
-    reflow(container: Container, component?: Component): void;
-    /**
-     * Returns components that are eligible for interaction.
-     */
-    capturables(container: Container): Component[];
-    /**
-     * Returns components that should be rendered.
-     */
-    drawables(container: Container): Component[];
-    /**
-     * Determines whether the given component is "stuck" in its layout position.
-     */
-    isStuck(component: Component): boolean;
-    /**
-     * (Optional) Key navigation handler for keyboard interaction within the layout.
-     */
-    keyNavigate?(container: Container, component: Component, e: KeyboardEvent): Component | undefined;
-    /**
-     * (Optional) Whether the layout joins component types.
-     */
-    joinType?: boolean;
-}
+import type ComponentClass from '../components/component.js';
+import type ContainerClass from '../components/container.js';
+export type Component = ComponentClass;
+export type Container = ContainerClass;
+export type { ApplicationContext } from '../interfaces/providers.js';
+export type { Layout } from '../interfaces/layout.js';
 //# sourceMappingURL=component.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/types/component.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/types/component.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAA;AAC5D,OAAO,KAAK,cAAc,MAAM,4BAA4B,CAAA;AAE5D,MAAM,MAAM,SAAS,GAAG,cAAc,CAAA;AACtC,MAAM,MAAM,SAAS,GAAG,cAAc,CAAA;AAEtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AACpE,YAAY,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA"}

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

@@ -1,9 +1,66 @@
+import type { TransferEvent } from '../transfer/types.js';
 export type Constructor<T = {}> = new (...args: any[]) => T;
 export type EventCallback = (...args: any[]) => void;
+/**
+ * Component 가 발생/구독할 수 있는 이벤트 이름 → 페이로드 튜플 매핑.
+ *
+ * 새 이벤트 추가 방법:
+ *   declare module '@hatiolab/things-scene' {
+ *     interface ComponentEventMap {
+ *       'my-event': [payload: { foo: string }]
+ *       'another': [a: number, b: number]
+ *     }
+ *   }
+ *
+ * 매핑되지 않은 이름은 string 폴백으로 여전히 사용 가능 (느슨한 타입).
+ * 매핑된 이름은 페이로드 타입 검증 + 자동완성.
+ */
+export interface ComponentEventMap {
+    'change': [after: Record<string, any>, before: Record<string, any>, hint?: any];
+    'add': [component: any, parent: any];
+    'added': [component: any, parent: any];
+    'remove': [component: any];
+    'removed': [component: any];
+    'redraw': [];
+    'dimension': [component: any];
+    'click': [event: any];
+    'mouseenter': [event: any];
+    'mouseleave': [event: any];
+    'mouseover': [event: any];
+    'mouseout': [event: any];
+    'selected': [components: any[]];
+    'value': [value: any];
+    'mode': [mode: string];
+    'addstart': [];
+    'addstop': [];
+    'stylepastestart': [];
+    'stylepastestop': [];
+    'databindpastestart': [];
+    'databindpastestop': [];
+    'undo': [hint?: any];
+    'redo': [hint?: any];
+    'execute': [command: any];
+    'command-reset': [];
+    'gizmoattach': [component: any];
+    'gizmomode': [mode: string];
+    'tag': [info: any];
+    'tagreset': [];
+    'deco': [info: any];
+    'decoreset': [];
+    'transfer-received': [event: TransferEvent];
+    'transfer-dispatched': [event: TransferEvent];
+    'transfer-pending': [event: TransferEvent];
+    'transfer-routed': [event: TransferEvent];
+    'transfer-rejected': [event: TransferEvent];
+}
 export interface Event {
+    on<K extends keyof ComponentEventMap>(name: K, callback: (...args: ComponentEventMap[K]) => void, context?: object): void;
     on(name: string, callback: EventCallback, context?: object): void;
+    off<K extends keyof ComponentEventMap>(name: K, callback: (...args: ComponentEventMap[K]) => void, context?: object): void;
     off(name: string, callback: EventCallback, context?: object): void;
+    once<K extends keyof ComponentEventMap>(name: K, callback: (...args: ComponentEventMap[K]) => void, context?: object): void;
     once(name: string, callback: EventCallback, context?: object): void;
+    trigger<K extends keyof ComponentEventMap>(name: K, ...args: ComponentEventMap[K]): void;
     trigger(name: string, ...others: any[]): void;
 }
 //# sourceMappingURL=event.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/types/event.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAE3D,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;AAEpD,MAAM,WAAW,KAAK;IACpB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAClE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACnE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAA;CAC9C"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/types/event.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,16 +1,26 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.0.0-beta.11",
+  "version": "10.0.0-beta.110",
   "description": "A high-performance 2D/3D scene graph library for building interactive visual editors, combining HTML5 Canvas and Three.js to enable facility visualization, data-driven animations, and real-time monitoring dashboards",
   "main": "things-scene-min.js",
   "module": "things-scene.mjs",
   "browser": "things-scene.mjs",
   "types": "dist-types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist-types/index.d.ts",
+      "node": "./things-scene-transfer.mjs",
+      "import": "./things-scene.mjs",
+      "require": "./things-scene-min.js",
+      "default": "./things-scene-min.js"
+    }
+  },
   "files": [
     "things-scene-min.js",
     "things-scene-min.js.map",
     "things-scene.mjs",
     "things-scene.mjs.map",
+    "things-scene-transfer.mjs",
     "dist-types/"
   ],
   "sideEffects": false,
@@ -32,7 +42,7 @@
     "scene-editor"
   ],
   "scripts": {
-    "test": "mocha --require should --require ./test/setup.js --node-option import=tsx test/**/test-*.js",
+    "test": "mocha --exit --require should --require ./test/setup.js --node-option import=tsx test/**/test-*.js",
     "test:case": "mocha --require should --require ./test/setup.js --node-option import=tsx",
     "clean": "rimraf dist-types things-scene*.js *.js.map",
     "build": "yarn clean && yarn build:types && yarn build:rollup:prod",
@@ -64,6 +74,7 @@
     "lit": "^3.0.0",
     "mocha": "^11.0.0",
     "prettier": "^3.0.0",
+    "puppeteer": "^24.39.1",
     "rimraf": "^6.0.0",
     "rollup": "^4.0.0",
     "should": "^13.2.3",