@hatiolab/things-scene 10.0.0-beta.13 → 10.0.0-beta.131

package/dist-types/interfaces/real-object.d.ts

@@ -4,9 +4,16 @@ import type { Properties } from './types.js';
  * Component의 3D 표현을 담당하는 객체가 구현해야 하는 계약.
  * 실제 구현은 src/threed/real-object.ts에서 제공.
  *
- * Three.js 의존성 없음 — THREE 관련 멤버는 IThreeRealObject(src/threed/interfaces.ts)에서 확장.
+ * Three.js 직접 import 의존성은 없지만, 모든 실 구현(RealObject<T extends THREE.Object3D>)이
+ * object3d 를 갖기 때문에 인터페이스에도 노출. 타입은 any — 명시 타입이 필요한
+ * 곳은 IThreeRealObject(src/threed/interfaces.ts) 또는 구체 구현 클래스로 좁혀 사용.
  */
 export interface IRealObject {
+    /**
+     * THREE.Object3D 인스턴스. THREE 의존성 회피를 위해 any 로 노출.
+     * 명시 THREE.Object3D 타입이 필요하면 IThreeRealObject 로 narrow.
+     */
+    object3d?: any;
     /** 3D 오브젝트 업데이트 (build + dimension + transform + 외관) */
     update(): void;
     /** 리소스 해제 */

package/dist-types/interfaces/real-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"real-object.d.ts","sourceRoot":"","sources":["../../src/interfaces/real-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAE1B,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAA;IACd,aAAa;IACb,OAAO,IAAI,IAAI,CAAA;IAGf,0CAA0C;IAC1C,eAAe,IAAI,IAAI,CAAA;IACvB,oDAAoD;IACpD,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,cAAc,IAAI,IAAI,CAAA;IAGtB,gBAAgB;IAChB,WAAW,IAAI,IAAI,CAAA;IACnB,eAAe;IACf,YAAY,IAAI,IAAI,CAAA;IACpB,iBAAiB;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,iBAAiB,IAAI,IAAI,CAAA;IACzB,gBAAgB;IAChB,UAAU,IAAI,IAAI,CAAA;IAGlB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IAGrD,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAA;CACjB"}
+{"version":3,"file":"real-object.d.ts","sourceRoot":"","sources":["../../src/interfaces/real-object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,GAAG,CAAA;IAGd,wDAAwD;IACxD,MAAM,IAAI,IAAI,CAAA;IACd,aAAa;IACb,OAAO,IAAI,IAAI,CAAA;IAGf,0CAA0C;IAC1C,eAAe,IAAI,IAAI,CAAA;IACvB,oDAAoD;IACpD,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,cAAc,IAAI,IAAI,CAAA;IAGtB,gBAAgB;IAChB,WAAW,IAAI,IAAI,CAAA;IACnB,eAAe;IACf,YAAY,IAAI,IAAI,CAAA;IACpB,iBAAiB;IACjB,eAAe,IAAI,IAAI,CAAA;IACvB,eAAe;IACf,iBAAiB,IAAI,IAAI,CAAA;IACzB,gBAAgB;IAChB,UAAU,IAAI,IAAI,CAAA;IAGlB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,CAAA;IAGrD,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAA;CACjB"}

package/dist-types/interfaces/rendering.d.ts

@@ -12,59 +12,131 @@ export interface DrawOptions {
     override?: Record<string, any>;
 }
 /**
- * 스타일 옵션을 정의하는 인터페이스
+ * 스타일 옵션 — gradient / pattern 타입 fillStyle 의 공통 베이스.
+ *
+ * 주의: 'solid' 채우기는 객체가 아니라 단순 색상 문자열이다 (`state.fillStyle = '#ff0000'`).
+ * 이 인터페이스는 객체 형태일 때만 (gradient / pattern) 적용된다.
  */
 export interface StyleOptions {
     type?: string;
-    gradientType?: string;
+    gradientType?: 'linear' | 'radial';
     rotation?: number;
     color?: string;
-    colors?: string[];
-    stops?: number[];
+    /** 인덱스 시그니처 — pattern 의 fitPattern / align / offsetX / offsetY 등 자유 필드 허용. */
     [key: string]: any;
 }
 /**
- * 채우기 스타일을 정의하는 인터페이스
+ * 채우기 스타일 — `state.fillStyle` 타입.
+ *
+ * 실제 형식 (drawer/fill.ts 검증):
+ *   - **solid**: 그냥 색상 문자열 — 객체 아님. e.g., `state.fillStyle = '#ff0000'` 또는 `'rgba(...)'`.
+ *   - **gradient**: 객체 — `{ type: 'gradient', gradientType, colorStops: [{position, color}], rotation, ... }`
+ *   - **pattern**: 객체 — `{ type: 'pattern', image, fitPattern?, noRepeat?, align?, offsetX?, offsetY?, width?, height?, color? }`
+ *   - **none**: `undefined` 또는 `null`.
+ *
+ * 따라서 `state.fillStyle` 의 실제 타입은 `string | FillStyle | undefined`.
  */
+export type FillStyleValue = string | FillStyle | undefined;
 export interface FillStyle extends StyleOptions {
-    type: 'solid' | 'gradient' | 'pattern' | 'image';
-    color?: string;
+    type: 'gradient' | 'pattern';
+    /** gradient: 색상-위치 stops. drawer/fill.ts:79 가 사용. */
+    colorStops?: Array<{
+        position: number;
+        color: string;
+    }>;
+    /** pattern: 이미지 URL 또는 asset 참조. */
+    image?: string;
+    /** pattern: 영역에 맞춰 비율 조정. */
+    fitPattern?: boolean;
+    /** pattern: 반복 안 함 (1회만). */
+    noRepeat?: boolean;
+    /** pattern: 영역 내 정렬. */
+    align?: 'center' | 'left-top' | 'left-bottom' | 'right-top' | 'right-bottom' | 'left' | 'right' | 'top' | 'bottom';
+    /** pattern: fitPattern=false 일 때 영역 내 위치. */
+    offsetX?: number;
+    offsetY?: number;
+    /** pattern: 패턴 크기 (기본은 이미지 원본 크기). */
+    width?: number;
+    height?: number;
+    /** 컴포넌트 alpha 와 별개 — gradient/pattern 의 자체 투명도. */
     opacity?: number;
 }
 /**
- * 선 스타일을 정의하는 인터페이스
+ * 선 / 테두리 스타일 — **state 에 top-level flat 으로 저장되는 필드들**.
+ *
+ * 실제 형식 (drawer/stroke.ts:6 destructure 검증):
+ *   `{ strokeStyle, lineDash, lineWidth, lineCap, lineJoin, alpha } = component.state`
+ *
+ * - `state.strokeStyle`: 색상 문자열 (Canvas API 의 strokeStyle 직접 대입)
+ * - `state.lineWidth`: number
+ * - `state.lineDash`: STRING preset 이름 — 'solid' / 'round-dot' / 'square-dot' /
+ *   'dash' / 'dash-dot' / 'long-dash' / 'long-dash-dot' / 'long-dash-dot-dot'
+ * - `state.lineCap`: 'butt' | 'round' | 'square'
+ * - `state.lineJoin`: 'miter' | 'round' | 'bevel'
+ *
+ * 이 인터페이스는 historic 한 객체 구조 — 실제로는 사용 안 됨. 참고용.
+ * 새 코드는 state 의 top-level 필드를 직접 사용할 것.
  */
 export interface StrokeStyle {
+    /** @deprecated 실제로는 `state.lineWidth` (top-level). */
     width?: number;
+    /** @deprecated 실제로는 `state.strokeStyle` (string color). */
     color?: string;
+    /** @deprecated 실제로는 컴포넌트 `state.alpha` 가 stroke 에도 적용. */
     opacity?: number;
+    /** @deprecated 실제로는 `state.lineCap`. */
     lineCap?: CanvasLineCap;
+    /** @deprecated 실제로는 `state.lineJoin`. */
     lineJoin?: CanvasLineJoin;
-    lineDash?: number[];
+    /** @deprecated 실제로는 `state.lineDash` — number[] 가 아닌 STRING preset 이름. */
+    lineDash?: string;
+    /** @deprecated 미사용. */
     lineDashOffset?: number;
 }
 /**
- * 텍스트 스타일을 정의하는 인터페이스
+ * 텍스트 / 폰트 스타일 — **state 에 top-level flat 으로 저장**.
+ *
+ *   `state.fontFamily / fontSize / fontStyle / fontWeight / fontColor /
+ *    textAlign / textBaseline / lineHeight`
+ *
+ * 이 인터페이스는 필드 이름 reference 용 — 객체로 묶어 저장하지 않는다.
  */
 export interface TextStyle {
-    font?: string;
-    fontSize?: number;
-    fontColor?: string;
     fontFamily?: string;
+    fontSize?: number;
     fontStyle?: string;
     fontWeight?: string;
+    fontColor?: string;
     textAlign?: CanvasTextAlign;
     textBaseline?: CanvasTextBaseline;
     lineHeight?: number;
+    /** @deprecated 사용처 없음. */
+    font?: string;
 }
 /**
- * 그림자 효과를 정의하는 인터페이스
+ * 그림자 효과 — `state.shadow` 객체 형식.
+ *
+ * Canonical 이름 (CSS box-shadow / Canvas API 와 일치):
+ *   `{ offsetX, offsetY, blur, color } = state.shadow`
+ *
+ * Backwards compatibility — 옛 이름 (`left`, `top`, `blurSize`) 도 drawer 가
+ * fallback 으로 읽음. 영속된 옛 데이터는 마이그레이션 없이 그대로 렌더링.
+ * 새 코드는 canonical 이름 사용.
  */
 export interface Shadow {
     color?: string;
+    /** Horizontal offset (CSS box-shadow 의 offset-x, Canvas 의 shadowOffsetX). */
     offsetX?: number;
+    /** Vertical offset (CSS box-shadow 의 offset-y, Canvas 의 shadowOffsetY). */
     offsetY?: number;
+    /** Blur radius (CSS box-shadow 의 blur-radius, Canvas 의 shadowBlur). */
     blur?: number;
+    /** @deprecated `offsetX` 사용. drawer 가 fallback 으로 읽음 — 옛 데이터 호환용. */
+    left?: number;
+    /** @deprecated `offsetY` 사용. drawer 가 fallback 으로 읽음 — 옛 데이터 호환용. */
+    top?: number;
+    /** @deprecated `blur` 사용. drawer 가 fallback 으로 읽음 — 옛 데이터 호환용. */
+    blurSize?: number;
 }
 /** Fill drawer — 그라디언트, 패턴, 이미지 채우기 */
 export interface IFillDrawer {

package/dist-types/interfaces/rendering.d.ts.map

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

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

@@ -8,8 +8,27 @@ export type Class = {
 export type Properties = {
     [key: string]: any;
 };
-export type State = Properties;
 export type Style = Properties;
+/**
+ * Component state — 임의 필드를 갖는 동적 객체.
+ *
+ * 컴포넌트별로 자기 state 형태를 선언하고 싶으면 이 인터페이스를 extends 하여
+ * 필드를 추가하고, 컴포넌트 클래스에서 `declare state: MyState` 로 좁히면 된다:
+ *
+ *   interface MyState extends State {
+ *     mySpecificField: number
+ *     myStatus: 'idle' | 'busy'
+ *   }
+ *   class MyComponent extends RectPath(Shape) {
+ *     declare state: MyState  // 타입 narrowing — 런타임 영향 없음
+ *   }
+ *
+ * 기존 `state.foo` 접근 코드는 인덱스 시그니처로 호환된다.
+ * 추후 단계적으로 공통 필드(left/top/width/height/...)를 명시적으로 추가할 수 있다.
+ */
+export interface State {
+    [key: string]: any;
+}
 /**
  * 좌표, 위치, 크기 관련 타입
  */

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

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

package/dist-types/items/arrangement/centering-queue-strategy.d.ts

@@ -0,0 +1,10 @@
+import type { ArrangementStrategy, SlotDef, Vec3 } from '../../transfer/types.js';
+export declare class CenteringQueueStrategy implements ArrangementStrategy {
+    private readonly owner;
+    private readonly itemSpacing;
+    private readonly axis;
+    constructor(owner: any, itemSpacing?: number, axis?: 'horizontal' | 'vertical');
+    positionAt(index: number, slotDef: SlotDef, _occupantCount: number, component?: any): Vec3 | null;
+    capacity(slotDef: SlotDef): number;
+}
+//# sourceMappingURL=centering-queue-strategy.d.ts.map

package/dist-types/items/arrangement/centering-queue-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"centering-queue-strategy.d.ts","sourceRoot":"","sources":["../../../src/items/arrangement/centering-queue-strategy.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,mBAAmB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AAEjF,qBAAa,sBAAuB,YAAW,mBAAmB;IAE9D,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAFJ,KAAK,EAAE,GAAG,EACV,WAAW,SAAI,EACf,IAAI,GAAE,YAAY,GAAG,UAAyB;IAGjE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,GAAG,IAAI,GAAG,IAAI;IA0BjG,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM;CAGnC"}

package/dist-types/items/arrangement/index.d.ts

@@ -0,0 +1,2 @@
+export { CenteringQueueStrategy } from './centering-queue-strategy.js';
+//# sourceMappingURL=index.d.ts.map

package/dist-types/items/arrangement/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/items/arrangement/index.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA"}

package/dist-types/items/capacity-mixin.d.ts

@@ -0,0 +1,303 @@
+import type { SlotDef, CarrierAttachPoint, ArrangementStrategy, CarrierDims, PlacementContext, SeatingPose } from '../transfer/types.js';
+import type Component from '../components/component.js';
+type Constructor<T = object> = new (...args: any[]) => T;
+/**
+ * Capacity (keep) 믹스인. subclass 는 `get slots()` 만 override; 나머지 default.
+ */
+export declare function Capacity<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, _ctx?: {
+            slotId?: string;
+        }): boolean;
+        findSlot(component: any): SlotDef | null;
+        /**
+         * carrier 의 받아들일 회전 (parent-local quaternion). 기본 identity.
+         * 회전이 필요한 holder (induct = belt 진행 방향, rack cell = grid 정렬 등)
+         * 는 이 메소드만 override 하면 receive() 가 atomic 하게 적용한다.
+         */
+        acceptanceRotation(_carrier: any, _slot?: SlotDef): {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        } | undefined;
+        /**
+         * Phase G5 — physical mover 가 query 하는 delivery world rotation.
+         *   delivery.world = holder.world.quat × acceptanceRotation_local
+         */
+        deliveryWorldRotation(carrier: any): {
+            x: number;
+            y: number;
+            z: number;
+            w: number;
+        } | undefined;
+        /**
+         * Phase G9 — physical mover 가 query 하는 delivery world position.
+         * receivingSurfaceY 가 있으면 belt 표면 위, 없으면 holder origin.
+         */
+        deliveryWorldPosition(_carrier: any): {
+            x: number;
+            y: number;
+            z: number;
+        } | undefined;
+        attachPointFor(component: any): CarrierAttachPoint | null;
+        /**
+         * Phase PS — PlacementSurface contract 의 default 구현.
+         * 기존 합성 경로와 *수치 동일* 한 안착 pose 를 holder object3d local frame 으로 반환 (I5).
+         */
+        placementFor(carrier: CarrierDims | any, ctx?: PlacementContext): SeatingPose | null;
+        /**
+         * Phase PS P3a — SeatingPose.position.y (holder object3d local) → state.zPos 역산.
+         * 받침면도 slot.localPosition.z 도 없는 holder 는 null (zPos 보존 semantics).
+         */
+        _zPosFromSeatY(seatY: number, carrierDepth: any, slot: SlotDef): number | null;
+        /**
+         * 받침면의 직관적 local Y — raw `receivingSurfaceY` 에서 상쇄분 제거. null = 받침면 명세 없음.
+         */
+        _receivingSurfaceLocalY(): number | null;
+        /**
+         * Count children currently assigned to `slotId`. 자식이 `parent === this` 일 때만 count.
+         */
+        _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>;
+        _readyInvoked: boolean;
+        invokeReady(): void | 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 refid(): any;
+        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);
+    };
+    __hasCapacity: boolean;
+} & TBase;
+export {};
+//# sourceMappingURL=capacity-mixin.d.ts.map

package/dist-types/items/capacity-mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity-mixin.d.ts","sourceRoot":"","sources":["../../src/items/capacity-mixin.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,WAAW,EACX,gBAAgB,EAChB,WAAW,EACZ,MAAM,sBAAsB,CAAA;AAC7B,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AAMvD,KAAK,WAAW,CAAC,CAAC,GAAG,MAAM,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAYxD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK;kBAf7B,GAAG,EAAE;QAsB9C,mDAAmD;qBACtC,OAAO,EAAE;QAItB;;;WAGG;mCACwB,mBAAmB;8BAMxB,GAAG,SAAS;YAAE,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO;4BAa3C,GAAG,GAAG,OAAO,GAAG,IAAI;QAoCxC;;;;WAIG;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;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;;;WAGG;wCAC6B,GAAG,GAAG;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,SAAS;kCAoB3D,GAAG,GAAG,kBAAkB,GAAG,IAAI;QAczD;;;WAGG;8BACmB,WAAW,GAAG,GAAG,QAAO,gBAAgB,GAAQ,WAAW,GAAG,IAAI;QAyDxF;;;WAGG;8BACmB,MAAM,gBAAgB,GAAG,QAAQ,OAAO,GAAG,MAAM,GAAG,IAAI;QAa9E;;WAEG;mCACwB,MAAM,GAAG,IAAI;QASxC;;WAEG;+BACoB,MAAM,GAAG,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAazC"}

package/dist-types/items/capacity.d.ts

@@ -0,0 +1,53 @@
+import type Component from '../components/component.js';
+/**
+ * Capacity contract — Holder 가 자기 보유 한도를 노출.
+ *
+ * 모든 method optional — 기본 fallback: SlottedHolder 의 slotIds().length / emptySlotIds().length.
+ */
+export interface Capacity {
+    /** 최대 capacity. -1 또는 Infinity 이면 무한. */
+    capacity(): number;
+    /** 남은 자리. capacity() - 점유된 수. */
+    available(): number;
+    /** capacity 도달 여부. available() === 0. */
+    isFull(): boolean;
+    /** 자리 생김 event listener — Producer 의 resume trigger. */
+    onAvailable?(listener: () => void): () => void;
+    /** capacity 도달 event listener — Producer 의 pause trigger. */
+    onFull?(listener: () => void): () => void;
+}
+/** duck-type. */
+export declare function hasCapacity(x: any): x is Capacity;
+/**
+ * 일반 helper — Capacity capability 미구현 컴포넌트도 SlottedHolder 라면 default 추론.
+ */
+export declare function inferCapacity(component: Component | any): {
+    capacity: number;
+    available: number;
+    isFull: boolean;
+};
+/**
+ * Capacity event emitter — Holder 가 자기 status 변경 시 호출하는 helper.
+ * setState({ data }) / reparent 후 호출. 변화 없으면 비용 0.
+ */
+export declare class CapacityEventTracker {
+    private wasFull;
+    private availableListeners;
+    private fullListeners;
+    /**
+     * Holder 의 현 capacity 상태 확인 + 변화 시 listener 호출.
+     * `current` = 현재 available count. 0 이면 full.
+     */
+    notify(currentAvailable: number): void;
+    onAvailable(listener: () => void): () => void;
+    onFull(listener: () => void): () => void;
+    dispose(): void;
+}
+/**
+ * Auto-wire — Producer ↔ Holder 의 자동 back-pressure.
+ *
+ * Holder 가 full 되면 producer.pauseEmit / 자리 생기면 resumeEmit.
+ * 반환: cleanup function — 양 listener 모두 해제.
+ */
+export declare function autoWireBackPressure(producer: any, holder: Capacity | any): () => void;
+//# sourceMappingURL=capacity.d.ts.map

package/dist-types/items/capacity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacity.d.ts","sourceRoot":"","sources":["../../src/items/capacity.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,SAAS,MAAM,4BAA4B,CAAA;AAEvD;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,yCAAyC;IACzC,QAAQ,IAAI,MAAM,CAAA;IAElB,iCAAiC;IACjC,SAAS,IAAI,MAAM,CAAA;IAEnB,yCAAyC;IACzC,MAAM,IAAI,OAAO,CAAA;IAEjB,wDAAwD;IACxD,WAAW,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;IAE9C,6DAA6D;IAC7D,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAA;CAC1C;AAED,iBAAiB;AACjB,wBAAgB,WAAW,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,QAAQ,CAMjD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,GAAG,GAAG,GAAG;IACzD,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,OAAO,CAAA;CAChB,CAuBA;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,kBAAkB,CAAwB;IAClD,OAAO,CAAC,aAAa,CAAwB;IAE7C;;;OAGG;IACH,MAAM,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAetC,WAAW,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQ7C,MAAM,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAQxC,OAAO,IAAI,IAAI;CAIhB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,GAAG,EACb,MAAM,EAAE,QAAQ,GAAG,GAAG,GACrB,MAAM,IAAI,CAiBZ"}

package/dist-types/items/index.d.ts

@@ -0,0 +1,7 @@
+export * from './capacity.js';
+export * from './arrangement/index.js';
+export * from './stacking/index.js';
+export type { SlotRecord } from './slot-record.js';
+export { ItemsDataBinding } from './items-data-binding.js';
+export { Capacity } from './capacity-mixin.js';
+//# sourceMappingURL=index.d.ts.map

package/dist-types/items/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/items/index.ts"],"names":[],"mappings":"AAOA,cAAc,eAAe,CAAA;AAC7B,cAAc,wBAAwB,CAAA;AAEtC,cAAc,qBAAqB,CAAA;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAG1D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA"}