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

package/dist-types/threed/factories/backdrop.d.ts

@@ -0,0 +1,535 @@
+import type { ComponentNature } from '../../interfaces/types.js';
+import type { IRealObject } from '../../interfaces/real-object.js';
+import Shape from '../../components/shape.js';
+import { RealObjectGroup } from '../real-object-group.js';
+export declare class Backdrop3D extends RealObjectGroup {
+    /** 대형 배경 평면 — 가장 뒤로 푸시 (z-fight 시 다른 컴포넌트가 항상 위에 보이게) */
+    get zPriority(): number;
+    /**
+     * Pin the envelope's PLAN position (x, z) to world origin when
+     * fitToBoard is active, regardless of state.left/top — this puts the
+     * box's center at the board's center horizontally. The Y axis is
+     * preserved from `super.position` so the scene-level placement
+     * (`floor` → +depth/2, `space` → 0, `inverted` → -depth/2 via the
+     * base class's `geometricOffsetY`) decides whether the envelope
+     * sits ON the floor (bottom at zPos), CENTERED in space, or HANGS
+     * from the ceiling (top at zPos).
+     *
+     * Forcing y=0 here would collapse all three placement modes into
+     * "centered" — that's wrong for `floor` and `inverted`.
+     */
+    get position(): {
+        x: number;
+        y: number;
+        z: number;
+    };
+    build(): void;
+    private _resolveFace;
+    updateDimension(): void;
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+    updateAlpha(): void;
+}
+declare const Backdrop_base: {
+    new (...args: any[]): {
+        is3dish(): boolean;
+        get hasTextProperty(): boolean;
+        get capturable(): boolean;
+        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: 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;
+        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;
+        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(): IRealObject | undefined;
+        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: import("../../index.js").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: import("../../index.js").Component) => boolean), ...others: any[]): import("../../index.js").Component | undefined;
+        findAll(s: string | ((c: import("../../index.js").Component) => boolean), ...others: any[]): any[] | undefined;
+        capture(x: number, y: number, except?: (c: import("../../index.js").Component) => boolean): any;
+        findAnchor(name: string): any;
+        isDescendible(container: import("../../index.js").Component | any): boolean;
+        getContext(component?: unknown): any;
+        get root(): import("../../index.js").Component;
+        get rootModel(): import("../../index.js").Component;
+        get parent(): import("../../index.js").Component;
+        set parent(v: import("../../index.js").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?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordT2P(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordT2S(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordS2TR(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordS2O(x: number, y: number, target: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordC2S(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordS2C(x: number, y: number, top?: import("../../index.js").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?: import("../../index.js").Component): import("../../index.js").POINT;
+        fromScene(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        toLocal(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        toGlobal(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        toOther(x: number, y: number, target: import("../../index.js").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: import("../../index.js").Component, ghost?: boolean): void;
+        addComponent(component: import("../../index.js").Component, ghost?: boolean): void;
+        insertComponentAt(component: import("../../index.js").Component, index: number, ghost?: boolean): void;
+        getOverlay(component: import("../../index.js").Component): HTMLElement | undefined;
+        findById(id: string): import("../../index.js").Component | undefined;
+        findByRefid(ref: string | number): import("../../index.js").Component | undefined;
+        findAllById(id: string): import("../../index.js").Component[];
+        resize(): void;
+        fit(type?: string): void;
+        get components(): import("../../index.js").Component[] | undefined;
+        get layout(): any;
+        get auxOverlay(): HTMLElement | undefined;
+        get isReady(): boolean;
+        get unitScale(): number;
+        get selected(): import("../../index.js").Component[];
+        set selected(_v: import("../../index.js").Component[]);
+        get focused(): import("../../index.js").Component | null;
+        set focused(_v: import("../../index.js").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);
+    };
+    raycastTargetDefault: boolean;
+} & {
+    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: 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(): IRealObject | undefined;
+        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: import("../../index.js").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: import("../../index.js").Component) => boolean), ...others: any[]): import("../../index.js").Component | undefined;
+        findAll(s: string | ((c: import("../../index.js").Component) => boolean), ...others: any[]): any[] | undefined;
+        capture(x: number, y: number, except?: (c: import("../../index.js").Component) => boolean): any;
+        findAnchor(name: string): any;
+        isDescendible(container: import("../../index.js").Component | any): boolean;
+        getContext(component?: unknown): any;
+        get root(): import("../../index.js").Component;
+        get rootModel(): import("../../index.js").Component;
+        get parent(): import("../../index.js").Component;
+        set parent(v: import("../../index.js").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?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordT2P(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordT2S(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordS2TR(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordS2O(x: number, y: number, target: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordC2S(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        transcoordS2C(x: number, y: number, top?: import("../../index.js").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?: import("../../index.js").Component): import("../../index.js").POINT;
+        fromScene(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        toLocal(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        toGlobal(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
+        toOther(x: number, y: number, target: import("../../index.js").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: import("../../index.js").Component, ghost?: boolean): void;
+        addComponent(component: import("../../index.js").Component, ghost?: boolean): void;
+        insertComponentAt(component: import("../../index.js").Component, index: number, ghost?: boolean): void;
+        getOverlay(component: import("../../index.js").Component): HTMLElement | undefined;
+        findById(id: string): import("../../index.js").Component | undefined;
+        findByRefid(ref: string | number): import("../../index.js").Component | undefined;
+        findAllById(id: string): import("../../index.js").Component[];
+        resize(): void;
+        fit(type?: string): void;
+        get components(): import("../../index.js").Component[] | undefined;
+        get layout(): any;
+        get auxOverlay(): HTMLElement | undefined;
+        get isReady(): boolean;
+        get unitScale(): number;
+        get selected(): import("../../index.js").Component[];
+        set selected(_v: import("../../index.js").Component[]);
+        get focused(): import("../../index.js").Component | null;
+        set focused(_v: import("../../index.js").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;
+export declare class Backdrop extends Backdrop_base {
+    /** Bound listener for root model state changes (only attached when
+     *  state.fitToBoard is true). Rebuilds the 3D mesh on board resize. */
+    private _onRootChange?;
+    buildRealObject(): IRealObject | undefined;
+    get nature(): ComponentNature;
+    added(parent: any): void;
+    ready(): Promise<void>;
+    removed(parent: any): void;
+    dispose(): void;
+    onchange(after: Record<string, unknown>, before: Record<string, unknown>): void;
+    /**
+     * Copy the root model's plan geometry (left, top, width, height) onto
+     * this backdrop.
+     *
+     * `seedDepth`:
+     *   - `true`  (creation / fitToBoard OFF→ON) — also set depth =
+     *     min(width, height) as a sensible initial vertical extent.
+     *   - `false` (board resize) — leave depth alone. The user's manual
+     *     depth edits via the property panel must stick; routine resize
+     *     syncs shouldn't trample them.
+     *
+     * Skips fields that already match to avoid empty onchange round-trips.
+     */
+    private _syncFromRoot;
+    private _attachRootListener;
+    private _detachRootListener;
+}
+export {};
+//# sourceMappingURL=backdrop.d.ts.map

package/dist-types/threed/factories/backdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backdrop.d.ts","sourceRoot":"","sources":["../../../src/threed/factories/backdrop.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,MAAM,2BAA2B,CAAA;AAK7C,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAuHzD,qBAAa,UAAW,SAAQ,eAAe;IAC7C,yDAAyD;IACzD,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;;;;;;;;;;;OAYG;IACH,IAAa,QAAQ;;;;MAMpB;IAQD,KAAK;IAwFL,OAAO,CAAC,YAAY;IAqBpB,eAAe;IAEf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASxE,WAAW;CACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkBD,qBACa,QAAS,SAAQ,aAA2B;IACvD;2EACuE;IACvE,OAAO,CAAC,aAAa,CAAC,CAAsC;IAE5D,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,KAAK,CAAC,MAAM,EAAE,GAAG;IAgBX,KAAK;IAOX,OAAO,CAAC,MAAM,EAAE,GAAG;IAKnB,OAAO;IAKP,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAYxE;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,mBAAmB;CAM5B"}

package/dist-types/threed/factories/banner.d.ts

@@ -4,9 +4,11 @@ import type { IRealObject } from '../../interfaces/real-object.js';
 import Shape from '../../components/shape.js';
 import { RealObject } from '../real-object.js';
 export declare class Banner3D extends RealObject {
+    /** 배너 — 벽/바닥에 부착하는 사인 면, 데칼 layer */
+    get zPriority(): number;
     build(): void;
     createCube(w: number, h: number, d: number): THREE.Mesh<THREE.BoxGeometry, THREE.MeshStandardMaterial, THREE.Object3DEventMap>;
-    createTextureBoard(w: number, h: number): THREE.Mesh<THREE.PlaneGeometry, any, THREE.Object3DEventMap>;
+    createTextureBoard(w: number, h: number): THREE.Mesh<THREE.PlaneGeometry, THREE.MeshStandardMaterial, THREE.Object3DEventMap>;
     updateMaterial3d(): void;
 }
 declare const Banner_base: {
@@ -76,9 +78,9 @@ declare const Banner_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;
@@ -147,7 +149,7 @@ declare const Banner_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;
@@ -161,7 +163,7 @@ declare const Banner_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;
@@ -169,7 +171,7 @@ declare const Banner_base: {
         findAll(s: string | ((c: import("../../index.js").Component) => boolean), ...others: any[]): any[] | undefined;
         capture(x: number, y: number, except?: (c: import("../../index.js").Component) => boolean): any;
         findAnchor(name: string): any;
-        isDescendible(container: import("../../index.js").Component): boolean;
+        isDescendible(container: import("../../index.js").Component | any): boolean;
         getContext(component?: unknown): any;
         get root(): import("../../index.js").Component;
         get rootModel(): import("../../index.js").Component;
@@ -213,9 +215,13 @@ declare const Banner_base: {
         toLocal(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
         toGlobal(x: number, y: number, top?: import("../../index.js").Component): import("../../index.js").POINT;
         toOther(x: number, y: number, target: import("../../index.js").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;
@@ -249,6 +255,7 @@ declare const Banner_base: {
     };
 } & typeof Shape;
 export declare class Banner extends Banner_base {
+    get hasTextProperty(): boolean;
     is3dish(): boolean;
     get nature(): ComponentNature;
     buildRealObject(): IRealObject | undefined;

package/dist-types/threed/factories/banner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../src/threed/factories/banner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,MAAM,2BAA2B,CAAA;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAmB9C,qBAAa,QAAS,SAAQ,UAAU;IACtC,KAAK;IAYL,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAqB1C,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAkCvC,gBAAgB;CAmBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBACa,MAAO,SAAQ,WAAe;IACzC,OAAO;IAIP,IAAI,MAAM,oBAET;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;CAG3C"}
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../../src/threed/factories/banner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,MAAM,2BAA2B,CAAA;AAG7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAoB9C,qBAAa,QAAS,SAAQ,UAAU;IACtC,qCAAqC;IACrC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,KAAK;IAYL,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAe1C,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;IAkBvC,gBAAgB;CAgBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBACa,MAAO,SAAQ,WAAe;IACzC,IAAI,eAAe,YAAmB;IACtC,OAAO;IAIP,IAAI,MAAM,oBAET;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;CAG3C"}