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

package/dist-types/components/container-abstract.d.ts

@@ -54,9 +54,9 @@ declare const ContainerAbstract_base: {
         get(property: any): any;
         set(props: any, propval?: any): any;
         getState(property: any): any;
-        setState(props: any, propval?: any): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
-        get state(): any;
+        get state(): import("../index.js").State;
         get hierarchy(): any;
         get volatile(): never[];
         _applyProps(target: any, props: any, options: any): /*elided*/ any;
@@ -129,7 +129,7 @@ declare const ContainerAbstract_base: {
         get textHidden(): boolean;
         set textHidden(v: boolean);
         get hasTextProperty(): boolean;
-        animate(opts: import("../animation/interfaces.js").AnimationConfig): any;
+        animate(opts: import("../index.js").AnimationConfig): any;
         effect(context: import("../index.js").SceneRenderContext, model: any): void;
         serialize(...others: any[]): string;
         trim(): void;
@@ -143,7 +143,7 @@ declare const ContainerAbstract_base: {
         set tap(v: any);
         get mappings(): any[];
         get retention(): number;
-        get animation(): import("../animation/interfaces.js").AnimationController | undefined;
+        get animation(): import("../index.js").AnimationController | undefined;
         get started(): boolean;
         set started(v: boolean);
         get controls(): import("../index.js").Control[] | undefined;
@@ -151,7 +151,7 @@ declare const ContainerAbstract_base: {
         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): boolean;
+        isDescendible(container: Component | any): boolean;
         getContext(component?: unknown): any;
         get root(): Component;
         get rootModel(): Component;
@@ -196,9 +196,13 @@ declare const ContainerAbstract_base: {
         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;
@@ -297,9 +301,9 @@ declare const ContainerAbstract_base: {
         get(property: any): any;
         set(props: any, propval?: any): any;
         getState(property: any): any;
-        setState(props: any, propval?: any): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
-        get state(): any;
+        get state(): import("../index.js").State;
         get hierarchy(): any;
         get volatile(): never[];
         _applyProps(target: any, props: any, options: any): /*elided*/ any;
@@ -368,7 +372,7 @@ declare const ContainerAbstract_base: {
         get textHidden(): boolean;
         set textHidden(v: boolean);
         get hasTextProperty(): boolean;
-        animate(opts: import("../animation/interfaces.js").AnimationConfig): any;
+        animate(opts: import("../index.js").AnimationConfig): any;
         effect(context: import("../index.js").SceneRenderContext, model: any): void;
         serialize(...others: any[]): string;
         trim(): void;
@@ -382,7 +386,7 @@ declare const ContainerAbstract_base: {
         set tap(v: any);
         get mappings(): any[];
         get retention(): number;
-        get animation(): import("../animation/interfaces.js").AnimationController | undefined;
+        get animation(): import("../index.js").AnimationController | undefined;
         get started(): boolean;
         set started(v: boolean);
         get controls(): import("../index.js").Control[] | undefined;
@@ -390,7 +394,7 @@ declare const ContainerAbstract_base: {
         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): boolean;
+        isDescendible(container: Component | any): boolean;
         getContext(component?: unknown): any;
         get root(): Component;
         get rootModel(): Component;
@@ -434,9 +438,13 @@ declare const ContainerAbstract_base: {
         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;
@@ -484,7 +492,40 @@ export default class ContainerAbstract extends ContainerAbstract_base {
     get layout(): LAYOUT;
     reflow(): void;
     get hierarchy(): any;
-    addComponent(component: any, ghost?: boolean): void;
+    /**
+     * Reparent: move a component from its current container to this container.
+     *
+     * Uses addComponent({ silent: true }) internally, which triggers:
+     *  - 'add' / 'added' events on the new container/component (for index management)
+     *  - ghost removal on the old container ('remove'/'removed' events SUPPRESSED)
+     *
+     * Event asymmetry note:
+     *  'remove' event is suppressed because ThreeCapability's 'remove' listener calls
+     *  removeObject(), which would destroy 3D objects during reparent.
+     *  Ideally reparent should fire symmetric add/remove events, but this requires
+     *  either a dedicated 'reparent' event or a context-aware 3D listener that skips
+     *  object cleanup during reparent. This is a known design compromise.
+     *  TODO: Consider introducing a 'reparent' event to resolve the asymmetry.
+     *
+     * Parent change is immediate; visual transition is handled by TransitionController.
+     */
+    reparent(component: any, options?: {
+        animated?: boolean;
+        duration?: number;
+        ease?: string;
+        /**
+         * Custom 3D parent to attach the component's object3d to.
+         * Defaults to this container's own _realObject.object3d.
+         * Use this when the target container has a sub-group (e.g. a bodyGroup
+         * rotated for orientation) that items should attach to rather than the
+         * container root.
+         */
+        toParent3D?: any;
+    }): void;
+    addComponent(component: any, options?: boolean | {
+        ghost?: boolean;
+        silent?: boolean;
+    }): void;
     removeComponent(component: any, ghost?: boolean): void;
     insertComponentAt(component: any, index: any, ghost?: boolean): void;
     add(comp: any, ghost?: boolean): any;

package/dist-types/components/container-abstract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container-abstract.d.ts","sourceRoot":"","sources":["../../src/components/container-abstract.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,SAAS,MAAM,gBAAgB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMtC,MAAM,CAAC,OAAO,OAAO,iBAAkB,SAAQ,sBAA+B;IACpE,WAAW,EAAE,SAAS,EAAE,CAAA;gBAEpB,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG;IAOrC,aAAa,CAAC,UAAU,KAAA;IAIxB,IAAI,cAAc,YAEjB;IAED,IAAI,YAAY,YAEf;IAED,OAAO;IAMP,WAAW,IAAI,IAAI,IAAI,SAAS;IAIhC,WAAW,CAAC,SAAS,KAAA;IAIrB,IAAI,eAAe,YAElB;IAED,IAAI,UAAU,gBAEb;IAID,IAAI,SAAS,YAEZ;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,MAAM;IASN,IAAI,SAAS,QASZ;IAED,YAAY,CAAC,SAAS,KAAA,EAAE,KAAK,UAAQ;IAiCrC,eAAe,CAAC,SAAS,KAAA,EAAE,KAAK,UAAQ;IAwBxC,iBAAiB,CAAC,SAAS,KAAA,EAAE,KAAK,KAAA,EAAE,KAAK,UAAQ;IA2BjD,GAAG,CAAC,IAAI,KAAA,EAAE,KAAK,UAAQ;IAYvB,MAAM,CAAC,IAAI,KAAA,EAAE,KAAK,UAAQ;IAc1B,KAAK,CAAC,KAAK,KAAA;IAIX,OAAO,CAAC,EAAE,KAAA,EAAE,OAAO,CAAC,KAAA;IAMpB,QAAQ,CAAC,EAAE,KAAA,EAAE,OAAO,CAAC,KAAA;IAWrB,OAAO,CAAC,IAAI,KAAA;IAIZ,IAAI;IAIJ,WAAW,CAAC,KAAK,KAAA,EAAE,KAAK,KAAA;IAgBxB,gBAAgB,CAAC,KAAK,KAAA;IAQtB,iBAAiB,CAAC,KAAK,KAAA;IAQvB,gBAAgB,CAAC,KAAK,KAAA;IAUtB,eAAe,CAAC,KAAK,KAAA;IAUrB,SAAS,CAAC,CAAC,KAAA;IAiBX,OAAO,CAAC,CAAC,KAAA,EAAE,GAAG,MAAM,OAAA,GAAG,SAAS,EAAE;IAiBlC,SAAS,CAAC,CAAC,KAAA,EAAE,GAAG,MAAM,OAAA,GAAG,SAAS,GAAG,SAAS;IAe9C,QAAQ,CAAC,EAAE,KAAA;IAIX,WAAW,CAAC,GAAG,KAAA;IAIf,QAAQ,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;IAmBb,OAAO,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA,EAAE,MAAM,KAAA;IA2CpB,WAAW,CAAC,IAAI,KAAA,EAAE,OAAO,KAAA;IAqCzB,MAAM,CAAC,OAAO,KAAA;IAad,UAAU,CAAC,OAAO,KAAA;IAiClB,IAAI;CAOL"}
+{"version":3,"file":"container-abstract.d.ts","sourceRoot":"","sources":["../../src/components/container-abstract.ts"],"names":[],"mappings":"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"}

package/dist-types/components/container.d.ts

@@ -67,9 +67,9 @@ declare const Container_base: {
         get(property: any): any;
         set(props: any, propval?: any): any;
         getState(property: any): any;
-        setState(props: any, propval?: any): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
-        get state(): any;
+        get state(): import("../index.js").State;
         get hierarchy(): any;
         get volatile(): never[];
         _applyProps(target: any, props: any, options: any): /*elided*/ any;
@@ -139,7 +139,7 @@ declare const Container_base: {
         set text(v: string);
         get textBounds(): import("../index.js").BOUNDS;
         get textRotation(): number;
-        animate(opts: import("../animation/interfaces.js").AnimationConfig): any;
+        animate(opts: import("../index.js").AnimationConfig): any;
         effect(context: import("../index.js").SceneRenderContext, model: any): void;
         serialize(...others: any[]): string;
         trim(): void;
@@ -153,7 +153,7 @@ declare const Container_base: {
         set tap(v: any);
         get mappings(): any[];
         get retention(): number;
-        get animation(): import("../animation/interfaces.js").AnimationController | undefined;
+        get animation(): import("../index.js").AnimationController | undefined;
         get started(): boolean;
         set started(v: boolean);
         get controls(): import("../index.js").Control[] | undefined;
@@ -205,9 +205,13 @@ declare const Container_base: {
         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;
@@ -244,7 +248,7 @@ export default class Container extends Container_base {
     isPositionable(): boolean;
     setElementProperties(element: any): void;
     get layout(): import("../index.js").LAYOUT | {
-        reflow(container: import("../types/component.js").Container, component?: import("../types/component.js").Component): void;
+        reflow(container: import("../types/component.js").Container, component?: import("../index.js").ComponentInterface): void;
         capturables(container: any): any;
         drawables(container: any): any;
         isStuck(component: any): boolean;

package/dist-types/components/container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/components/container.ts"],"names":[],"mappings":"AAOA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,iBAAiB,MAAM,yBAAyB,CAAA;;;;;;;;;;;gCAkEjD,MAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBX,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAmC;;IAGxE,IAAI,OAAO,WAEV;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,cAAc;IAId,oBAAoB,CAAC,OAAO,EAAE,GAAG;IAEjC,IAAI,MAAM;;;;;;MAET;IAED,UAAU;IA4CV,IAAI,IAAI,CAAC,IAAI;;;OAAA,EAoBZ;IAED,IAAI,IAAI;;;QAqBP;IAED,IAAI,MAAM;;;;;MAWT;IAED,IAAI,MAAM,CAAC,MAAM;;;;;KAAA,EAchB;IAED,cAAc;IA6Cd,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;IA6B1B,KAAK;IAMX,OAAO;IASP,aAAa;IAUb,eAAe;IAyEf,aAAa,GAAI,GAAG,GAAG,UA0CtB;IAED,iBAAiB,aAGhB;IAED,iBAAiB;IAUjB,cAAc,aAEb;CACF"}
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/components/container.ts"],"names":[],"mappings":"AAOA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,iBAAiB,MAAM,yBAAyB,CAAA;;;;;;;;;;;gCA4ElD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeX,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,cAAmC;;IAGxE,IAAI,OAAO,WAEV;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,cAAc;IAId,oBAAoB,CAAC,OAAO,EAAE,GAAG;IAEjC,IAAI,MAAM;;;;;;MAET;IAED,UAAU;IA4CV,IAAI,IAAI,CAAC,IAAI;;;OAAA,EAoBZ;IAED,IAAI,IAAI;;;QAqBP;IAED,IAAI,MAAM;;;;;MAWT;IAED,IAAI,MAAM,CAAC,MAAM;;;;;KAAA,EAchB;IAED,cAAc;IA6Cd,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG;IA6B1B,KAAK;IAMX,OAAO;IASP,aAAa;IAUb,eAAe;IAyEf,aAAa,GAAI,GAAG,GAAG,UA0CtB;IAED,iBAAiB,aAGhB;IAED,iBAAiB;IAUjB,cAAc,aAEb;CACF"}

package/dist-types/components/data/data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/components/data/data.ts"],"names":[],"mappings":"AAeA,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,UAAQ,QA4GvD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAO9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,QAiBtC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,QAGxC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAIlE"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/components/data/data.ts"],"names":[],"mappings":"AA6CA,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,UAAQ,QA0GvD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAU9D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,QAkBtC;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,GAAG,QAGxC;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAIlE"}

package/dist-types/components/drawer/fill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/fill.ts"],"names":[],"mappings":"AAQA,wBAAgB,QAAQ,CAAC,OAAO,KAAA,EAAE,MAAM,KAAA,EAAE,MAAM,KAAA,EAAE,KAAK,KAAA,EAAE,cAAc,KAAA,QAmLtE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QA0D/D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,QAWtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAa9D"}
+{"version":3,"file":"fill.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/fill.ts"],"names":[],"mappings":"AAQA,wBAAgB,QAAQ,CAAC,OAAO,KAAA,EAAE,MAAM,KAAA,EAAE,MAAM,KAAA,EAAE,KAAK,KAAA,EAAE,cAAc,KAAA,QA2LtE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QA0D/D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,QAWtD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,QAa9D"}

package/dist-types/components/drawer/stroke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stroke.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/stroke.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,GAAG,QAuDhG"}
+{"version":3,"file":"stroke.d.ts","sourceRoot":"","sources":["../../../src/components/drawer/stroke.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,OAAO,EAAE,wBAAwB,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,GAAG,QA+DhG"}

package/dist-types/components/ellipse.d.ts

@@ -57,9 +57,9 @@ declare const Ellipse_base: {
         get(property: any): any;
         set(props: any, propval?: any): any;
         getState(property: any): any;
-        setState(props: any, propval?: any): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
-        get state(): any;
+        get state(): import("../index.js").State;
         get hierarchy(): any;
         get volatile(): never[];
         _applyProps(target: any, props: any, options: any): /*elided*/ any;
@@ -132,7 +132,7 @@ declare const Ellipse_base: {
         get textHidden(): boolean;
         set textHidden(v: boolean);
         get hasTextProperty(): boolean;
-        animate(opts: import("../animation/interfaces.js").AnimationConfig): any;
+        animate(opts: import("../index.js").AnimationConfig): any;
         effect(context: import("../index.js").SceneRenderContext, model: any): void;
         serialize(...others: any[]): string;
         trim(): void;
@@ -146,7 +146,7 @@ declare const Ellipse_base: {
         set tap(v: any);
         get mappings(): any[];
         get retention(): number;
-        get animation(): import("../animation/interfaces.js").AnimationController | undefined;
+        get animation(): import("../index.js").AnimationController | undefined;
         get started(): boolean;
         set started(v: boolean);
         get controls(): import("../index.js").Control[] | undefined;
@@ -154,7 +154,7 @@ declare const Ellipse_base: {
         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): boolean;
+        isDescendible(container: Component | any): boolean;
         getContext(component?: unknown): any;
         get root(): Component;
         get rootModel(): Component;
@@ -199,9 +199,13 @@ declare const Ellipse_base: {
         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;

package/dist-types/components/ellipse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../src/components/ellipse.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAGtC,OAAO,KAAK,MAAM,YAAY,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuB7D,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,YAAkB;IACrD,OAAO;IAIP,MAAM,CAAC,OAAO,EAAE,wBAAwB;IAaxC,IAAI,IAAI;;;QAqBP;IAED,IAAI,IAAI,CAAC,IAAI;;;OAAA,EAUZ;IAED,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAS7B,OAAO,CAAC,QAAQ,EAAE,MAAM;IAIxB,IAAI,OAAO;;;;;;QAEV;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;CACF"}
+{"version":3,"file":"ellipse.d.ts","sourceRoot":"","sources":["../../src/components/ellipse.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAGtC,OAAO,KAAK,MAAM,YAAY,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuB7D,MAAM,CAAC,OAAO,OAAO,OAAQ,SAAQ,YAAkB;IACrD,OAAO;IAIP,MAAM,CAAC,OAAO,EAAE,wBAAwB;IAaxC,IAAI,IAAI;;;QAqBP;IAED,IAAI,IAAI,CAAC,IAAI;;;OAAA,EAUZ;IAED,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAS7B,OAAO,CAAC,QAAQ,EAAE,MAAM;IAIxB,IAAI,OAAO;;;;;;QAEV;IAED,IAAI,MAAM,IAAI,eAAe,CAE5B;CACF"}

package/dist-types/components/generic-placeholders.d.ts

@@ -0,0 +1,291 @@
+import Component from './component.js';
+import Shape from './shape.js';
+import type { ComponentNature } from '../interfaces/types.js';
+export interface PlaceholderTheme {
+    /** 옅은 fill 색 */
+    fill: string;
+    /** 점선 stroke 색 */
+    stroke: string;
+    /** 중앙 아이콘 (텍스트 한 줄) */
+    icon: string;
+    /** 사용자에게 보여줄 친화적 라벨 */
+    label: string;
+}
+/**
+ * 도메인 패키지가 자기 generic-* 컴포넌트의 시각을 일관되게 유지하도록 제공하는 표준 theme.
+ */
+export declare const PLACEHOLDER_THEMES: Record<string, PlaceholderTheme>;
+/** 도메인 패키지에서 호출 가능한 NATURE properties 표준 — 일관된 placeholderLabel/Hint UI. */
+export declare const COMMON_PLACEHOLDER_PROPERTIES: {
+    type: string;
+    label: string;
+    name: string;
+    description: string;
+}[];
+/**
+ * 추상 placeholder 의 2D 표현. 도메인 패키지가 자기 generic-* 컴포넌트의 render() 에서
+ * 호출해 things-scene 코어와 동일 시각을 유지한다.
+ */
+export declare function renderPlaceholder(ctx: CanvasRenderingContext2D, bounds: {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}, theme: PlaceholderTheme, customLabel?: string, hint?: string): void;
+declare const Placeholder_base: {
+    new (...args: any[]): {
+        contains(x: number, y: number): boolean;
+        get path(): {
+            x: any;
+            y: any;
+        }[];
+        set path(path: {
+            x: any;
+            y: any;
+        }[]);
+        get anchors(): {
+            name: string;
+            position: {
+                x: any;
+                y: any;
+            };
+        }[];
+        get bounds(): any;
+        set bounds(bounds: any);
+        render(ctx: CanvasRenderingContext2D): void;
+        _app: any;
+        _model: any;
+        _state: any;
+        _delta: any;
+        _animation: any;
+        _animate: any;
+        _parent: any;
+        _disposed: any;
+        _textHidden: any;
+        _text_substitutor: any;
+        _value_substitutor: any;
+        _mappings: any;
+        _realObject: import("../index.js").IRealObject | undefined;
+        _cachedState: any;
+        updatedAt: any;
+        fontSize: any;
+        __cache__: any;
+        created(): void;
+        added(parent: any): void;
+        removed(parent: any): void;
+        ready(): Promise<void>;
+        touch(): void;
+        clearCache(...attrs: any[]): void;
+        removeSelf(completely: any): void;
+        resetAnimation(): void;
+        dispose(): void;
+        get nature(): ComponentNature;
+        get disposed(): boolean;
+        isLayer(): boolean;
+        isGroup(): boolean;
+        isContainer(): this is import("../types/component.js").Container;
+        isLine(): boolean;
+        isRoot(): boolean;
+        isRootModel(): boolean;
+        is3dish(): boolean;
+        get is3dMode(): boolean;
+        isIn3DSpace(): boolean;
+        isTemplate(): boolean;
+        isHTMLElement(): boolean;
+        isConnectable(): boolean;
+        isIdentifiable(): boolean;
+        isPositionable(): boolean;
+        replaceRefids(replaceMap: any): void;
+        get(property: any): any;
+        set(props: any, propval?: any): any;
+        getState(property: any): any;
+        setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
+        get model(): any;
+        get state(): import("../index.js").State;
+        get hierarchy(): any;
+        get volatile(): never[];
+        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        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 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 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;
+        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 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);
+    };
+} & typeof Shape;
+declare class Placeholder extends Placeholder_base {
+    get nature(): ComponentNature;
+    render(ctx: CanvasRenderingContext2D): void;
+}
+export { Placeholder as GenericObject };
+/**
+ * @sync things-factory/packages/board-import/.../converters/generic-to.ts CORE_PLACEHOLDER_TYPES
+ * 서버가 client 를 직접 import 할 수 없으므로 양쪽 독립 정의.
+ * 값을 바꾸면 board-import 도 동시 수정 필수.
+ */
+export declare const CORE_PLACEHOLDER_TYPES: readonly ["placeholder"];
+export type CorePlaceholderType = (typeof CORE_PLACEHOLDER_TYPES)[number];
+export declare function isGenericPlaceholder(type: string | undefined, extraTypes?: ReadonlyArray<string>): boolean;
+//# sourceMappingURL=generic-placeholders.d.ts.map

package/dist-types/components/generic-placeholders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-placeholders.d.ts","sourceRoot":"","sources":["../../src/components/generic-placeholders.ts"],"names":[],"mappings":"AAiBA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAEtC,OAAO,KAAK,MAAM,YAAY,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAI7D,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAQ/D,CAAA;AAED,4EAA4E;AAC5E,eAAO,MAAM,6BAA6B;;;;;GAazC,CAAA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,wBAAwB,EAC7B,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACpE,KAAK,EAAE,gBAAgB,EACvB,WAAW,CAAC,EAAE,MAAM,EACpB,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAkDN;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeD,cAAM,WAAY,SAAQ,gBAAe;IACvC,IAAI,MAAM,oBAET;IAED,MAAM,CAAC,GAAG,EAAE,wBAAwB;CAIrC;AAMD,OAAO,EAAE,WAAW,IAAI,aAAa,EAAE,CAAA;AAEvC;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,0BAA2B,CAAA;AAE9D,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEzE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,UAAU,GAAE,aAAa,CAAC,MAAM,CAAM,GACrC,OAAO,CAIT"}

package/dist-types/components/geometry/snap-guide.d.ts

@@ -0,0 +1,45 @@
+import { BOUNDS } from '../../interfaces/types.js';
+export interface SnapGuideLine {
+    axis: 'x' | 'y';
+    position: number;
+    from: number;
+    to: number;
+}
+export interface SnapResult {
+    dx: number;
+    dy: number;
+    guides: SnapGuideLine[];
+}
+export declare const EMPTY_RESULT: SnapResult;
+/**
+ * 드래그 시작 시 1회 구축하는 스냅 인덱스.
+ * 형제 컴포넌트의 모든 edge를 정렬된 배열로 보관하여
+ * dragmove마다 O(log N) 이진탐색으로 스냅을 계산한다.
+ */
+export declare class SnapIndex {
+    private xEdges;
+    private yEdges;
+    constructor(otherBounds: BOUNDS[]);
+    get empty(): boolean;
+    /**
+     * O(log N) 스냅 계산
+     */
+    calculateSnap(movingBounds: BOUNDS, diffx: number, diffy: number, threshold: number): SnapResult;
+    /**
+     * 정렬된 edge 배열에서 myValues 각각에 대해
+     * threshold 이내 가장 가까운 매칭을 이진탐색으로 찾는다.
+     * O(3 * log N) = O(log N)
+     */
+    private findBestSnap;
+    /**
+     * 이진탐색으로 target에 가장 가까운 edge를 찾고,
+     * threshold 이내이면 같은 값의 모든 edge를 수집한다.
+     */
+    private searchNearest;
+}
+/**
+ * 하위호환: 기존 테스트용 함수형 API.
+ * 내부적으로 SnapIndex를 생성하여 계산한다.
+ */
+export declare function calculateSnap(movingBounds: BOUNDS, otherBounds: BOUNDS[], diffx: number, diffy: number, threshold?: number): SnapResult;
+//# sourceMappingURL=snap-guide.d.ts.map

package/dist-types/components/geometry/snap-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap-guide.d.ts","sourceRoot":"","sources":["../../../src/components/geometry/snap-guide.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAA;AAElD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,GAAG,GAAG,GAAG,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,aAAa,EAAE,CAAA;CACxB;AAED,eAAO,MAAM,YAAY,EAAE,UAAyC,CAAA;AAYpE;;;;GAIG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,MAAM,CAAa;gBAEf,WAAW,EAAE,MAAM,EAAE;IAgCjC,IAAI,KAAK,YAER;IAED;;OAEG;IACH,aAAa,CACX,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,UAAU;IAgEb;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA6BpB;;;OAGG;IACH,OAAO,CAAC,aAAa;CAqDtB;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAU,GACpB,UAAU,CAIZ"}