@hatiolab/things-scene 10.0.0-beta.9 → 10.0.0-beta.91

package/dist-types/components/mixins/gltf-component.d.ts

@@ -0,0 +1,276 @@
+import type { ComponentNature } from '../../interfaces/types.js';
+import type { IRealObject } from '../../interfaces/real-object.js';
+import type Component from '../component.js';
+import { type GLTFNodeState, type GLTFAnimationState } from '../../threed/real-object-gltf.js';
+type Constructor<T = {}> = new (...args: any[]) => T;
+export declare const GLTF_BASE_URL_ALIAS = "$base_url";
+/**
+ * 공통 NATURE properties — subclass NATURE 에 spread 해서 사용.
+ * gltf-preset / gltf-selector / gltf-info / gltf-fill-targets / gltf-play-targets.
+ *
+ * 같은 5 개를 하드코딩하던 GLTFObject / GenericTransport 가 이걸로 통일.
+ */
+export declare const gltfNatureProperties: any[];
+export default function GltfComponent<T extends Constructor<Component>>(superclass: T): {
+    new (...args: any[]): {
+        /** 2D 렌더용 top-view 스냅샷 캐시 (인스턴스 별 reference). */
+        _topViewSnapshot?: HTMLCanvasElement;
+        /** snapshot 비동기 로드 중복 방지 플래그. lazy render 호출이 매 frame 마다
+         *  GLB 로드를 재시작하지 않도록 한다. */
+        _snapshotLoading: boolean;
+        /** ratioLock 재진입 방지 플래그 — set/setState 안에서 ratio 보정 시 사용. */
+        _ratioLocking: boolean;
+        is3dish(): boolean;
+        get hasTextProperty(): boolean;
+        /** GLB 컴포넌트는 자체 2D 컨트롤 핸들이 없음 (raycast/3D 핸들 위주). */
+        get controls(): never[];
+        render(ctx: CanvasRenderingContext2D): void;
+        onchange(after: Record<string, any>, before: Record<string, any>): void;
+        /** GLB 로드 → top-view 스냅샷 캐시. 동일 src 의 다른 인스턴스는 캐시 재사용.
+         *  중복 호출 보호: 비동기 로드 중인 동안 추가 render() 호출이 들어와도
+         *  GLB 를 다시 받지 않는다. */
+        _ensureTopViewSnapshot(): void;
+        buildRealObject(): IRealObject | undefined;
+        get source(): string | undefined;
+        set source(v: string | undefined);
+        get play(): boolean;
+        set play(value: boolean);
+        get nodes(): Record<string, GLTFNodeState> | undefined;
+        set nodes(value: Record<string, GLTFNodeState> | undefined);
+        get animations(): Record<string, GLTFAnimationState> | undefined;
+        set animations(value: Record<string, GLTFAnimationState> | undefined);
+        get playTargets(): string[] | string | undefined;
+        set playTargets(value: string[] | string | undefined);
+        get fillStyleTargets(): string[] | undefined;
+        set fillStyleTargets(value: string[] | undefined);
+        get nodeNames(): string[];
+        get animationNames(): string[];
+        set dimension(dimension: {
+            width: number;
+            height: number;
+            depth: number;
+        });
+        /**
+         * ratioLock: state.ratioLock=true 일 때 width/height/depth 변경 시
+         * 가장 큰 변화율을 기준으로 나머지 축을 균일 스케일.
+         */
+        _applyRatioLock(props: any): any;
+        set(props: any, propval?: any): any;
+        setState(props: any, propval?: any): any;
+        _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: 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;
+        get is3dMode(): boolean;
+        isIn3DSpace(): boolean;
+        isTemplate(): boolean;
+        isHTMLElement(): boolean;
+        isConnectable(): boolean;
+        isIdentifiable(): boolean;
+        isPositionable(): boolean;
+        replaceRefids(replaceMap: any): void;
+        get(property: any): any;
+        getState(property: any): any;
+        get model(): any;
+        get state(): 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 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;
+        get realObject(): 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);
+        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);
+        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): 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(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        off(name?: string | object, callback?: Function, context?: any): /*elided*/ any;
+        once(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        trigger(name: string, ...args: any[]): /*elided*/ any;
+        delegate_on(delegator: any): /*elided*/ any;
+        delegate_off(delegator: any): /*elided*/ any;
+        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);
+    };
+} & T;
+export {};
+//# sourceMappingURL=gltf-component.d.ts.map

package/dist-types/components/mixins/gltf-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-component.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/gltf-component.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAkB,KAAK,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AAG9G,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAEpD,eAAO,MAAM,mBAAmB,cAAc,CAAA;AAE9C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,GAAG,EA2DrC,CAAA;AAED,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAvE5C,GAAG,EAAE;QAyE1C,iDAAiD;2BAC9B,iBAAiB;QAEpC;oCAC4B;;QAG5B,6DAA6D;;mBAGlD,OAAO;+BAIK,OAAO;QAI9B,qDAAqD;;oBASzC,wBAAwB;wBAiCpB,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;QAShE;;+BAEuB;;2BAsCJ,WAAW,GAAG,SAAS;sBAK5B,MAAM,GAAG,SAAS;sBAGlB,MAAM,GAAG,SAAS;oBAIpB,OAAO;wBAGH,OAAO;qBAIV,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS;yBAGrC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,SAAS;0BAIxC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,SAAS;8BAG1C,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,GAAG,SAAS;2BAIjD,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS;+BAGzB,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS;gCAI5B,MAAM,EAAE,GAAG,SAAS;oCAGhB,MAAM,EAAE,GAAG,SAAS;yBAI/B,MAAM,EAAE;8BAKH,MAAM,EAAE;iCAML;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE;QAMzE;;;WAGG;+BACoB,GAAG,GAAG,GAAG;mBAsBrB,GAAG,YAAY,GAAG;wBAab,GAAG,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAarC"}

package/dist-types/components/mixins/html-element.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-element.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/html-element.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAK5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAEpD,eAAO,MAAM,QAAQ,UAiBpB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAxB/C,GAAG,EAAE;kBA0BxB,WAAW,GAAG,IAAI;;;;;;sCAwBN,GAAG;;gCA2BR,GAAG,GAAG;;;;;;;;;;wBAkEf,GAAG,UAAU,GAAG;;iCAqBP,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAM/B"}
+{"version":3,"file":"html-element.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/html-element.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAK5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAEpD,eAAO,MAAM,QAAQ,UAiBpB,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,gBAAgB,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAxB/C,GAAG,EAAE;kBA0BxB,WAAW,GAAG,IAAI;;;;;;sCAwBN,GAAG;;gCAgCR,GAAG,GAAG;;;;;;;;;;wBA+Ef,GAAG,UAAU,GAAG;;iCA6BP,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAM/B"}

package/dist-types/components/mixins/move-handle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"move-handle.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/move-handle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AASpD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBATzC,GAAG,EAAE;kBAWxB,OAAO;8BAEH,OAAO;4BAIT,wBAAwB;mCAYjB,wBAAwB;oBA2BvC,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BhC"}
+{"version":3,"file":"move-handle.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/move-handle.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAYpD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAZzC,GAAG,EAAE;kBAcxB,OAAO;8BAEH,OAAO;4BAIT,wBAAwB;mCAYjB,wBAAwB;oBA2BvC,MAAM,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BhC"}

package/dist-types/components/mixins/three-d-only.d.ts

@@ -0,0 +1,243 @@
+import type Component from '../component.js';
+type Constructor<T = {}> = new (...args: any[]) => T;
+export default function ThreeDOnly<T extends Constructor<Component>>(superclass: T): {
+    new (...args: any[]): {
+        is3dish(): boolean;
+        get hasTextProperty(): boolean;
+        /** Never selectable in 2D — modeler nor runtime. */
+        get capturable(): boolean;
+        /** No 2D paint of own visual. Container children render via postrender unaffected. */
+        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(): 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;
+        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: any, propval?: any): any;
+        get model(): any;
+        get state(): 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;
+        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);
+        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): 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 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(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        off(name?: string | object, callback?: Function, context?: any): /*elided*/ any;
+        once(name: string | object, callback: Function, context?: any): /*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);
+    };
+    /**
+     * Raycast opt-out by default. Atmospheric / decoration components are
+     * usually larger than the contents placed inside them, so making the
+     * envelope itself raycastable would block selection of those contents.
+     * Subclasses pair this with `createSelectionHandle3D` to supply a small
+     * editor-only handle that's the actual click target. A per-instance
+     * `state.raycastTarget = true` overrides this if the user wants the
+     * envelope itself to be clickable.
+     */
+    raycastTargetDefault: boolean;
+} & T;
+export {};
+//# sourceMappingURL=three-d-only.d.ts.map

package/dist-types/components/mixins/three-d-only.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"three-d-only.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/three-d-only.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAEpD,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAFzC,GAAG,EAAE;;;QAuB1C,oDAAoD;0BAClC,OAAO;QAIzB,sFAAsF;qBACzE,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAzBrC;;;;;;;;OAQG;;MAqBN"}

package/dist-types/components/mixins/value-holder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"value-holder.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/value-holder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAiBpD,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAjB1C,GAAG,EAAE;oBAmBtB,MAAM;qBACL,MAAM;4BACC,GAAG;iCAEN,GAAG,2CAA8B,GAAG;;wBAmC7C,GAAG,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmCnC"}
+{"version":3,"file":"value-holder.d.ts","sourceRoot":"","sources":["../../../src/components/mixins/value-holder.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,SAAS,MAAM,iBAAiB,CAAA;AAE5C,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAA;AAiBpD,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,CAAC,SAAS,WAAW,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC;kBAjB1C,GAAG,EAAE;oBAmBtB,MAAM;qBACL,MAAM;4BACC,GAAG;iCAEN,GAAG,2CAA8B,GAAG;;wBA2C7C,GAAG,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmCnC"}

package/dist-types/components/mutater/path.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/components/mutater/path.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,QAsD5F"}
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../src/components/mutater/path.ts"],"names":[],"mappings":"AAgBA,MAAM,CAAC,OAAO,UAAU,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,QA0D5F"}

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

@@ -0,0 +1,25 @@
+import Container from './container.js';
+import type { ComponentNature } from '../interfaces/types.js';
+/**
+ * PopupContainer — Popup 컴포넌트 (또는 외부 호출) 가 mount 할 template 영역.
+ *
+ * 핵심 동작은 `Container` 와 동일하지만 `state.position` 의 기본값이 `'popup'`
+ * 으로 고정되어 main scene 렌더에서 자동 제외된다 (container-abstract postrender,
+ * three-capability addObject, mixins/html-element onchangePosition 가 'popup'
+ * 분기 가짐).
+ *
+ * Edit mode 에서는 `get_position` (component-hierarchy.ts) 가 항상 `'static'`
+ * 을 반환하므로 modeler 에서는 일반 컨테이너처럼 편집 가능. View mode 에서만
+ * `'popup'` 의미가 발동되어 main 캔버스/3D 씬에서 빠지고 popup chrome 의
+ * mount 를 기다리는 detached 상태가 된다.
+ *
+ * 미래 확장:
+ *   - popup-specific lifecycle hook (onPopupShow/onPopupHide)
+ *   - 모델러에서 시각 구분 (점선 테두리, 'popup' 라벨) — 옵션 C
+ *   - 별도 popup 편집 진입 UX — 옵션 B
+ */
+export default class PopupContainer extends Container {
+    get nature(): ComponentNature;
+    isPopupContainer(): boolean;
+}
+//# sourceMappingURL=popup-container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"popup-container.d.ts","sourceRoot":"","sources":["../../src/components/popup-container.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AA4C7D;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,SAAS;IACnD,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,gBAAgB;CAYjB"}

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

@@ -266,13 +266,43 @@ export default class Popup extends Popup_base {
             label: string;
             name: string;
             property?: undefined;
+            placeholder?: undefined;
         } | {
             type: string;
             label: string;
             name: string;
             property: {
                 options: string[];
+                language?: undefined;
             };
+            placeholder?: undefined;
+        } | {
+            type: string;
+            label: string;
+            name: string;
+            placeholder: string;
+            property?: undefined;
+        } | {
+            type: string;
+            label: string;
+            name: string;
+            property: {
+                language: string;
+                options?: undefined;
+            };
+            placeholder?: undefined;
+        } | {
+            type: string;
+            label: string;
+            name: string;
+            property: {
+                options: {
+                    display: string;
+                    value: string;
+                }[];
+                language?: undefined;
+            };
+            placeholder?: undefined;
         })[];
         help: string;
     };

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

@@ -1 +1 @@
-{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../src/components/popup.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAEtC,OAAO,KAAK,MAAM,YAAY,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkG9B,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,UAAe;IAChD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;IAElB,MAAM,KAAK,KAAK,QAOf;IAIK,KAAK;IAMX,MAAM,CAAC,OAAO,EAAE,wBAAwB;IAOxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAYhE,YAAY,CAAC,KAAK,EAAE,GAAG;IAYvB,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG;IAkBpC,SAAS;IAIT,IAAI,KAAK,QAER;IAED,IAAI,KAAK,CAAC,KAAK,KAAA,EAEd;IAED,IAAI,IAAI,QAEP;IAED,IAAI,IAAI,CAAC,IAAI,KAAA,EAEZ;IAED,IAAI,OAAO,QAEV;IAED,IAAI,OAAO,CAAC,IAAI,KAAA,EAEf;IAED,IAAI,KAAK,QAER;IAED,IAAI,KAAK,CAAC,KAAK,KAAA,EAEd;IAED,IAAI,eAAe,YAElB;IAED,IAAI,MAAM;;;;;;;;;;;;;;;;;;MAET;CACF"}
+{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../../src/components/popup.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,gBAAgB,CAAA;AAEtC,OAAO,KAAK,MAAM,YAAY,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2J9B,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,UAAe;IAChD,MAAM,CAAC,MAAM,EAAE,GAAG,CAAA;IAElB,MAAM,KAAK,KAAK,QAOf;IAIK,KAAK;IAMX,MAAM,CAAC,OAAO,EAAE,wBAAwB;IAOxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAYhE,YAAY,CAAC,KAAK,EAAE,GAAG;IAevB,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG;IAwCpC,SAAS;IAIT,IAAI,KAAK,QAER;IAED,IAAI,KAAK,CAAC,KAAK,KAAA,EAEd;IAED,IAAI,IAAI,QAEP;IAED,IAAI,IAAI,CAAC,IAAI,KAAA,EAEZ;IAED,IAAI,OAAO,QAEV;IAED,IAAI,OAAO,CAAC,IAAI,KAAA,EAEf;IAED,IAAI,KAAK,QAER;IAED,IAAI,KAAK,CAAC,KAAK,KAAA,EAEd;IAED,IAAI,eAAe,YAElB;IAED,IAAI,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAET;CACF"}