@hatiolab/things-scene 10.0.0-beta.139 → 10.0.0-beta.140

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

@@ -31,14 +31,14 @@ export default function ValueHolder<T extends Constructor<Component>>(superclass
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../../types/component.js").Container): void;
+        removed(parent: import("../../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         get nature(): import("../../index.js").ComponentNature;
         get disposed(): boolean;
@@ -56,17 +56,17 @@ export default function ValueHolder<T extends Constructor<Component>>(superclass
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../component.js").ApplyPropsOptions): /*elided*/ any;
         contains(x: number, y: number): boolean;
         move(offset: {
             x: number;

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

@@ -29,14 +29,14 @@ declare const Node_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -54,17 +54,17 @@ declare const Node_base: {
         isHTMLElement(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;

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

@@ -39,14 +39,14 @@ declare const Popup_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -65,17 +65,17 @@ declare const Popup_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;

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

@@ -29,14 +29,14 @@ declare const Rect_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -54,17 +54,17 @@ declare const Rect_base: {
         isHTMLElement(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;
@@ -278,14 +278,14 @@ declare const Rect_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -304,17 +304,17 @@ declare const Rect_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;

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

@@ -39,14 +39,14 @@ declare const Ruler_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -65,17 +65,17 @@ declare const Ruler_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;

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

@@ -40,14 +40,14 @@ declare const ServiceComponent_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -66,17 +66,17 @@ declare const ServiceComponent_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;

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

@@ -38,14 +38,14 @@ declare const Text_base: {
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -64,17 +64,17 @@ declare const Text_base: {
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("./component.js").ApplyPropsOptions): /*elided*/ any;
         move(offset: {
             x: number;
             y: number;

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

@@ -84,14 +84,14 @@ export declare function Capacity<TBase extends Constructor<Component>>(Base: TBa
         fontSize: any;
         __cache__: any;
         created(): void;
-        added(parent: any): void;
-        removed(parent: any): void;
+        added(parent: import("../types/component.js").Container): void;
+        removed(parent: import("../types/component.js").Container): void;
         ready(): Promise<void>;
         _readyInvoked: boolean;
         invokeReady(): void | Promise<void>;
         touch(): void;
-        clearCache(...attrs: any[]): void;
-        removeSelf(completely: any): void;
+        clearCache(...attrs: string[]): void;
+        removeSelf(completely?: boolean): void;
         resetAnimation(): void;
         dispose(): void;
         get nature(): import("../index.js").ComponentNature;
@@ -110,17 +110,17 @@ export declare function Capacity<TBase extends Constructor<Component>>(Base: TBa
         isConnectable(): boolean;
         isIdentifiable(): boolean;
         isPositionable(): boolean;
-        replaceRefids(replaceMap: any): void;
-        get(property: any): any;
+        replaceRefids(replaceMap: Record<string, string>): void;
+        get(property: string): any;
         set(props: any, propval?: any): any;
-        getState(property: any): any;
+        getState(property: string): any;
         setState(props: Partial<import("../index.js").State> | string, propval?: any): any;
         get model(): any;
         get state(): import("../index.js").State;
         get refid(): any;
         get hierarchy(): any;
-        get volatile(): never[];
-        _applyProps(target: any, props: any, options: any): /*elided*/ any;
+        get volatile(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../components/component.js").ApplyPropsOptions): /*elided*/ any;
         contains(x: number, y: number): boolean;
         move(offset: {
             x: number;

package/dist-types/things-scene/api/clipboard.d.ts

@@ -1,4 +1,4 @@
 export declare function copy(this: any): string | undefined;
 export declare function cut(this: any): string | undefined;
-export declare function paste(this: any, copied: string): void;
+export declare function paste(this: any, copied?: string): void;
 //# sourceMappingURL=clipboard.d.ts.map

package/dist-types/things-scene/api/clipboard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/clipboard.ts"],"names":[],"mappings":"AAWA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,sBAU7B;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,sBAO5B;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,QAS9C"}
+{"version":3,"file":"clipboard.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/clipboard.ts"],"names":[],"mappings":"AAWA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,sBAU7B;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,sBAO5B;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,QAS/C"}

package/dist-types/things-scene/api/listener.d.ts

@@ -1,4 +1,4 @@
 export declare function on(this: any, event: string, listener: any, context?: any): void;
 export declare function once(this: any, event: string, listener: any, context?: any): void;
-export declare function off(this: any, event: string, listener: any, context?: any): void;
+export declare function off(this: any, event?: string, listener?: any, context?: any): void;
 //# sourceMappingURL=listener.d.ts.map

package/dist-types/things-scene/api/listener.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/listener.ts"],"names":[],"mappings":"AAmBA,wBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAExE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAE1E;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAEzE"}
+{"version":3,"file":"listener.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/listener.ts"],"names":[],"mappings":"AAmBA,wBAAgB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAExE;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAE1E;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,QAE3E"}

package/dist-types/things-scene/api/to-data-url.d.ts

@@ -1,2 +1,2 @@
-export declare function toDataURL(this: any, type: string, encoderOptions: any, width: number, height: number): Promise<unknown>;
+export declare function toDataURL(this: any, type?: string, encoderOptions?: any, width?: number, height?: number): Promise<unknown>;
 //# sourceMappingURL=to-data-url.d.ts.map

package/dist-types/things-scene/api/to-data-url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"to-data-url.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/to-data-url.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,oBA8EpG"}
+{"version":3,"file":"to-data-url.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/to-data-url.ts"],"names":[],"mappings":"AASA,wBAAgB,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,oBA8ExG"}

package/dist-types/things-scene/api/zorder.d.ts

@@ -1,3 +1,3 @@
-export declare function move(this: any, component: any, to_container: any, to_index: number): void;
+export declare function move(this: any, component?: any, to_container?: any, to_index?: number): void;
 export declare function zorder(this: any, type: string): void;
 //# sourceMappingURL=zorder.d.ts.map

package/dist-types/things-scene/api/zorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zorder.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/zorder.ts"],"names":[],"mappings":"AAQA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,QAYlF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,QAsD7C"}
+{"version":3,"file":"zorder.d.ts","sourceRoot":"","sources":["../../../src/things-scene/api/zorder.ts"],"names":[],"mappings":"AAQA,wBAAgB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,EAAE,YAAY,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,QAYrF;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,QAsD7C"}

package/dist-types/things-scene/create.d.ts

@@ -56,5 +56,29 @@ export interface SceneCreateOptions {
     /** Loading monitor options */
     loading?: LoadingOptions;
 }
+/**
+ * Create and mount a {@link Scene} — the primary entry point of the library.
+ *
+ * Instantiates the root container, application context, and (when a `target` is given)
+ * renders the board into that DOM element. The returned scene manages the full lifecycle;
+ * call {@link Scene.dispose} when done to release resources.
+ *
+ * @param options - See {@link SceneCreateOptions}. `target` may be omitted for headless
+ *   (off-screen / SSR) rendering.
+ * @returns A mounted {@link Scene} instance.
+ * @throws If `target` is a string that resolves to no element, or to a non-empty element.
+ *
+ * @example
+ * ```ts
+ * import { create, SCENE_MODE } from '@hatiolab/things-scene'
+ *
+ * const scene = create({
+ *   target: document.getElementById('board'),
+ *   model: JSON.parse(boardJson),
+ *   mode: SCENE_MODE.VIEW,
+ * })
+ * scene.data = { sensor1: { value: 42 } } // live data binding
+ * ```
+ */
 export default function create({ target, model, style, layers, handlers, mode, refProvider, dataSubscriptionProvider, dataStorage, baseUrl, fitMode, postprocessing, logarithmicDepth, loading: loadingOptions }: SceneCreateOptions): Scene;
 //# sourceMappingURL=create.d.ts.map

package/dist-types/things-scene/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/things-scene/create.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACpH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC7B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC3B,0EAA0E;IAC1E,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EAAE,CAAA;IAC5D,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,uEAAuE;IACvE,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;IACnD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAUD,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAC7B,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAW,EACX,QAAa,EACb,IAAsB,EACtB,WAAW,EACX,wBAAwB,EACxB,WAAkC,EAClC,OAAO,EACP,OAAO,EACP,cAAqB,EACrB,gBAAgB,EAChB,OAAO,EAAE,cAAc,EACxB,EAAE,kBAAkB,SAkDpB"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/things-scene/create.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AACpH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAEnD,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,mEAAmE;IACnE,MAAM,CAAC,EAAE,WAAW,GAAG,MAAM,CAAA;IAC7B,+DAA+D;IAC/D,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAC3B,0EAA0E;IAC1E,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAE,EAAE,CAAA;IAC5D,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,4EAA4E;IAC5E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,iBAAiB,CAAA;IAC/B,uEAAuE;IACvE,wBAAwB,CAAC,EAAE,wBAAwB,CAAA;IACnD,6DAA6D;IAC7D,WAAW,CAAC,EAAE,qBAAqB,CAAA;IACnC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,+EAA+E;IAC/E,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,8BAA8B;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAUD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,EAC7B,MAAM,EACN,KAAK,EACL,KAAK,EACL,MAAW,EACX,QAAa,EACb,IAAsB,EACtB,WAAW,EACX,wBAAwB,EACxB,WAAkC,EAClC,OAAO,EACP,OAAO,EACP,cAAqB,EACrB,gBAAgB,EAChB,OAAO,EAAE,cAAc,EACxB,EAAE,kBAAkB,SAkDpB"}

package/dist-types/things-scene/scene.d.ts

@@ -59,11 +59,19 @@ declare class Scene {
      * @param {RootContainer} container - Root container
      */
     constructor(container: any);
+    /**
+     * Add one or more component models to the scene (undoable).
+     * @param models - A model or array of models to add.
+     * @param boundsOrOffset - Optional target bounds, or an `{x, y}` offset.
+     * @param onto - Optional target container to add into.
+     */
     add(models: any, boundsOrOffset?: any, onto?: any): void;
+    /** Duplicate the current selection (undoable). */
     duplicate(): void;
+    /** Remove the current selection (undoable). */
     remove(): void;
     animate(config: Parameters<typeof animate>[0]): import("./index.js").AnimationController;
-    fullscreen(fit?: any): void;
+    fullscreen(fit?: string): void;
     get target(): any;
     set target(target: any);
     get scale(): any;
@@ -79,11 +87,23 @@ declare class Scene {
     get screen(): any;
     set screen(size: any);
     resize(): void;
+    /** Alias for {@link dispose}. */
     release(): void;
+    /**
+     * Tear down the scene and release all resources — container, commander, overlays,
+     * tracker, 3D GLTF caches, and the global transfer log. Call this on board switch or
+     * unmount to avoid leaks. The scene must not be used after disposal.
+     */
     dispose(): void;
+    /** The currently selected components, as a snapshot array (safe to iterate/mutate). */
     get selected(): any;
     set selected(selected: any);
-    select(selector: any, ...others: any[]): any;
+    /**
+     * Select all components matching a selector, replacing the current selection.
+     * @param selector - A CSS-like selector (by type, id, class, etc.).
+     * @returns The resulting selection.
+     */
+    select(selector: string, ...others: any[]): any;
     get commander(): any;
     undo(): void;
     undoable(): any;
@@ -93,35 +113,47 @@ declare class Scene {
     hasUnpreservedChanges(): any;
     cut(): string | undefined;
     copy(): string | undefined;
-    paste(copied?: any): void;
+    paste(copied?: string): void;
     undoableChange(changeFunc?: any): void;
-    change(selector: any, value?: any, self?: any): any;
+    change(selector: string, value?: any, self?: any): any;
+    /**
+     * The scene's model as a plain, serializable component tree (volatile props stripped,
+     * numbers rounded). Assigning a new model rebuilds the entire scene content.
+     */
     get model(): any;
     set model(model: any);
     get rootContainer(): any;
     get root(): any;
-    findAll(selector: any, ...others: any[]): any;
-    findFirst(selector: any, ...others: any[]): any;
-    findById(id: any): any;
-    findAllById(id: any): any;
+    /** Find all components matching a CSS-like selector. */
+    findAll(selector: string, ...others: any[]): any;
+    /** Find the first component matching a CSS-like selector, or `undefined`. */
+    findFirst(selector: string, ...others: any[]): any;
+    /** Find the first component with the given `id`. */
+    findById(id: string): any;
+    /** Find all components sharing the given `id`. */
+    findAllById(id: string): any;
     serialize(): any;
-    align(type: any): void;
-    place(type: any): void;
-    distribute(type: any): void;
-    move(component?: any, to_container?: any, to_index?: any): void;
-    zorder(type: any): void;
+    align(type: string): void;
+    place(type: string): void;
+    distribute(type: string): void;
+    move(component?: any, to_container?: any, to_index?: number): void;
+    zorder(type: string): void;
     symmetryX(): void;
     symmetryY(): void;
-    on(event: any, listener: any, context?: any): void;
-    once(event: any, listener: any, context?: any): void;
-    off(event?: any, listener?: any, context?: any): any;
-    centerTo(component: any, animated?: any): any;
+    on(event: string, listener: any, context?: any): void;
+    once(event: string, listener: any, context?: any): void;
+    off(event?: string, listener?: any, context?: any): any;
+    centerTo(component: any, animated?: boolean): any;
     /**
      * 영구 추적 모듈. 단일 추적 — 한 번에 하나의 id 만 추적. 트리에서 매칭 컴포넌트가
      * dispose/재등장 사이클을 타도 자동 재부착. 2D 는 deco-border, 3D 는 outline 으로
      * 같은 색깔 시각화. 자세한 사용법은 Tracker 클래스 참고.
      */
     get tracker(): Tracker;
+    /**
+     * Scene mode: `MODE_VIEW` (0) for monitoring / runtime, `MODE_EDIT` (1) for the modeller.
+     * Switching mode changes interaction (selection, gizmos) and rendering behavior.
+     */
     get mode(): any;
     set mode(mode: any);
     /**
@@ -143,21 +175,40 @@ declare class Scene {
      * 밖이라 별도로 훑어 재적용한다. 재빌드 없이 opacity 스케일만 — 해당 채널을 가진 컴포넌트에만.
      */
     private _reapplyModelingFaint;
-    toDataURL(type?: any, encoderOptions?: any, width?: any, height?: any): Promise<unknown>;
+    toDataURL(type?: string, encoderOptions?: any, width?: number, height?: number): Promise<unknown>;
     group(): void;
     ungroup(): void;
-    fit(type?: any): void;
+    fit(type?: string): void;
     get fitMode(): any;
+    /** All component `id`s in the scene, as a snapshot array. */
     get ids(): {
         key: any;
         value: any;
     }[];
+    /**
+     * Live data binding — the core mechanism for driving a scene from real-time data.
+     *
+     * Assigning a map propagates values into components by their `id`; each component's
+     * data mappings then update its visual state (color, text, animation, etc.). This is
+     * the primary way a monitoring dashboard reflects sensor / device data.
+     *
+     * @example
+     * ```ts
+     * scene.data = { conveyor1: { running: true }, gauge2: { value: 73 } }
+     * ```
+     */
     get data(): any;
     set data(data: any);
+    /** Like {@link data}, but keyed by component `refid` instead of `id`. */
     get dataByRefid(): any;
     set dataByRefid(data: any);
+    /**
+     * Per-component scalar values keyed by `id` — the simple form of data binding
+     * (a single value per component, vs. the structured map used by {@link data}).
+     */
     get values(): any;
     set values(values: any);
+    /** Like {@link values}, but keyed by component `refid` instead of `id`. */
     get valuesByRefid(): any;
     set valuesByRefid(values: any);
     get baseUrl(): any;