@hatiolab/things-scene 10.1.28 → 10.1.29

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

@@ -12,6 +12,7 @@ export * from './figure-palette.js';
 export * from './figure-registry.js';
 export * from './v3/figure-v3-registry.js';
 export { acquireV3Geometry, releaseV3Geometry, buildV3Geometry } from './v3/figure-v3-geometry.js';
+export * from './v3/figure-v3-part-component.js';
 export * from './figure-real-object.js';
 export * from './figure-shape.js';
 export * from './figure-sizing.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/figure/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAA;AAKpC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AAMrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AAMpC,cAAc,4BAA4B,CAAA;AAK1C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAClG,cAAc,yBAAyB,CAAA;AASvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/figure/index.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,cAAc,sBAAsB,CAAA;AAKpC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AAMrC,cAAc,wBAAwB,CAAA;AACtC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AAMpC,cAAc,4BAA4B,CAAA;AAK1C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAClG,cAAc,kCAAkC,CAAA;AAChD,cAAc,yBAAyB,CAAA;AASvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA"}

package/dist-types/figure/v3/figure-v3-part-component.d.ts

@@ -0,0 +1,305 @@
+import * as THREE from 'three';
+import Component from '../../components/component.js';
+import Shape from '../../components/shape.js';
+import type { SceneRenderContext } from '../../interfaces/rendering.js';
+import type { IRealObject } from '../../interfaces/real-object.js';
+import type { ComponentNature, Properties } from '../../interfaces/types.js';
+import { RealObject } from '../../threed/real-object.js';
+/** The shape figure-model evaluated for this body. */
+export interface FigureV3PartShape {
+    provider: string;
+    dimensions: Record<string, number>;
+    profile?: Array<{
+        id?: string;
+        x: number;
+        y: number;
+    }>;
+}
+export interface FigureV3PartState {
+    shape?: FigureV3PartShape;
+    segments?: number;
+    /** The body's colour, resolved by the modeller. */
+    color?: string;
+    preset?: string;
+    transparent?: boolean;
+    /** Glow: its colour and intensity (0 to 5). */
+    glow?: {
+        color: string;
+        intensity: number;
+    };
+}
+/**
+ * The body's geometry, centred on its bounding box and brought to a unit box, with the box's extents. Geometry with
+ * no extent on an axis (a flat face) keeps 1 there so nothing divides by zero.
+ */
+export declare function unitV3PartGeometry(shape: FigureV3PartShape, segments?: number): {
+    geometry: THREE.BufferGeometry;
+    extent: THREE.Vector3;
+    centre: THREE.Vector3;
+} | null;
+export declare class FigureV3PartRealObject extends RealObject {
+    private mesh?;
+    build(): void;
+    clear(): THREE.Object3D<THREE.Object3DEventMap>;
+    onchange(after: Properties, before: Properties): void;
+    /** The unit geometry is scaled to the component's size: width along X, depth along Y (up), height along Z. */
+    updateDimension(): void;
+    private material;
+}
+declare const FigureV3Part_base: {
+    new (...args: any[]): {
+        contains(x: number, y: number): boolean;
+        get path(): {
+            x: any;
+            y: any;
+        }[];
+        set path(path: {
+            x: any;
+            y: any;
+        }[]);
+        get anchors(): {
+            name: string;
+            position: {
+                x: any;
+                y: any;
+            };
+        }[];
+        get bounds(): any;
+        set bounds(bounds: any);
+        render(ctx: CanvasRenderingContext2D): void;
+        _app: any;
+        _model: any;
+        _state: any;
+        _delta: any;
+        _animation: any;
+        _animate: any;
+        _parent: any;
+        _disposed: any;
+        _textHidden: any;
+        _text_substitutor: any;
+        _value_substitutor: any;
+        _mappings: any;
+        _realObject: IRealObject | undefined;
+        _cachedState: any;
+        updatedAt: any;
+        fontSize: any;
+        __cache__: any;
+        created(): 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: string[]): void;
+        removeSelf(completely?: boolean): 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: Record<string, string>): void;
+        get(property: string): any;
+        set(props: any, propval?: 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(): string[];
+        _applyProps(target: Record<string, any>, props: Record<string, any>, options: import("../../components/component.js").ApplyPropsOptions): /*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?: SceneRenderContext): void;
+        prerender(context: SceneRenderContext): void;
+        postrender(context: SceneRenderContext): void;
+        prepare(resolve: (component: Component) => void, reject: (reason: any) => void): void;
+        prepareIf(condition: boolean): void;
+        drawText(context: SceneRenderContext): void;
+        drawStroke(context: SceneRenderContext, override?: Record<string, unknown>): void;
+        drawFill(context: 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?: 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: SceneRenderContext, model: any): void;
+        serialize(...others: any[]): string;
+        trim(): void;
+        closeScene(data: any): void;
+        delta(attr?: string | object, value?: any): any;
+        invalidate(): void;
+        get value(): any;
+        set value(v: any);
+        get data(): any;
+        set data(v: any);
+        set tap(v: any);
+        get mappings(): any[];
+        get retention(): number;
+        get animation(): import("../../index.js").AnimationController | undefined;
+        get started(): boolean;
+        set started(v: boolean);
+        get controls(): import("../../index.js").Control[] | undefined;
+        findFirst(finder: string | ((c: Component) => boolean), ...others: any[]): Component | undefined;
+        findAll(s: string | ((c: Component) => boolean), ...others: any[]): any[] | undefined;
+        capture(x: number, y: number, except?: (c: Component) => boolean): any;
+        findAnchor(name: string): any;
+        isDescendible(container: Component | any): boolean;
+        getContext(component?: unknown): any;
+        get root(): Component;
+        get rootModel(): Component;
+        get parent(): Component;
+        set parent(v: Component);
+        get scalable(): boolean;
+        get stuck(): boolean;
+        get capturable(): boolean;
+        get position(): string;
+        get origin(): string;
+        get offset(): import("../../index.js").POINT;
+        get app(): import("../../index.js").ApplicationContext;
+        drawEffect(context: SceneRenderContext): void;
+        prepareFill(resolve: Function, reject: Function): void;
+        prepareFillIf(condition: boolean): void;
+        onchangeFill(after: Record<string, any>, before: Record<string, any>): void;
+        drawImage(context: SceneRenderContext, image: HTMLImageElement, left: number, top: number, width: number, height: number): void;
+        mutateBounds(logic: ((bounds: import("../../index.js").BOUNDS) => import("../../index.js").BOUNDS | void) | null, context?: any): void;
+        mutatePath(beforeLogic: ((path: import("../../index.js").POINT[]) => import("../../index.js").POINT[] | void) | null, afterLogic: ((path: import("../../index.js").POINT[]) => import("../../index.js").POINT[] | void) | null, context?: any): void;
+        access(accessor: string): any;
+        substitute(template: string, data: any): string | undefined;
+        onchangeMappings(after: Record<string, any>, before: Record<string, any>): void;
+        onchangeData(after: Record<string, any>, before: Record<string, any>): void;
+        buildMappings(): void;
+        executeMappings(force?: boolean): void;
+        disposeMappings(): void;
+        ondropfile(transfered: FileList, files: string[]): void;
+        transcoordS2P(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
+        transcoordP2S(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
+        transcoordS2T(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        transcoordT2P(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        transcoordT2S(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        transcoordS2TR(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        transcoordS2O(x: number, y: number, target: Component): import("../../index.js").POINT;
+        transcoordC2S(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        transcoordS2C(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        toParent(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
+        fromParent(x: number, y: number, rp?: import("../../index.js").POINT): import("../../index.js").POINT;
+        toScene(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        fromScene(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        toLocal(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        toGlobal(x: number, y: number, top?: Component): import("../../index.js").POINT;
+        toOther(x: number, y: number, target: Component): import("../../index.js").POINT;
+        on<K extends keyof import("../../index.js").ComponentEventMap>(name: K, callback: (...args: import("../../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        on(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        off<K extends keyof import("../../index.js").ComponentEventMap>(name: K, callback?: ((...args: import("../../index.js").ComponentEventMap[K]) => void) | undefined, context?: any): /*elided*/ any;
+        off(name?: string | object, callback?: Function, context?: any): /*elided*/ any;
+        once<K extends keyof import("../../index.js").ComponentEventMap>(name: K, callback: (...args: import("../../index.js").ComponentEventMap[K]) => void, context?: any): /*elided*/ any;
+        once(name: string | object, callback: Function, context?: any): /*elided*/ any;
+        trigger<K extends keyof import("../../index.js").ComponentEventMap>(name: K, ...args: import("../../index.js").ComponentEventMap[K]): /*elided*/ any;
+        trigger(name: string, ...args: any[]): /*elided*/ any;
+        delegate_on(delegator: any): /*elided*/ any;
+        delegate_off(delegator: any): /*elided*/ any;
+        onchange(after: Record<string, any>, before: Record<string, any>): void;
+        calculateBounds?(): void;
+        oncreate_element?(element: HTMLElement): void;
+        removeComponent(component: Component, ghost?: boolean): void;
+        addComponent(component: Component, ghost?: boolean): void;
+        insertComponentAt(component: Component, index: number, ghost?: boolean): void;
+        getOverlay(component: Component): HTMLElement | undefined;
+        findById(id: string): Component | undefined;
+        findByRefid(ref: string | number): Component | undefined;
+        findAllById(id: string): Component[];
+        resize(): void;
+        fit(type?: string): void;
+        get components(): Component[] | undefined;
+        get layout(): any;
+        get auxOverlay(): HTMLElement | undefined;
+        get isReady(): boolean;
+        get unitScale(): number;
+        get selected(): Component[];
+        set selected(_v: Component[]);
+        get focused(): Component | null;
+        set focused(_v: Component | null);
+        get hasSameParentForAllSelected(): boolean;
+        set hasSameParentForAllSelected(_v: boolean);
+        get fitMode(): string | undefined;
+        set fitMode(_v: string | undefined);
+        get element(): HTMLElement | null;
+        set element(_v: HTMLElement | null);
+    };
+} & typeof Shape;
+export declare class FigureV3Part extends FigureV3Part_base {
+    static registerType(): void;
+    get hasTextProperty(): boolean;
+    is3dish(): boolean;
+    get nature(): ComponentNature;
+    buildRealObject(): IRealObject | undefined;
+    /** From above: the body's footprint as its box, in its colour. */
+    render(ctx: SceneRenderContext): void;
+}
+export {};
+//# sourceMappingURL=figure-v3-part-component.d.ts.map

package/dist-types/figure/v3/figure-v3-part-component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"figure-v3-part-component.d.ts","sourceRoot":"","sources":["../../../src/figure/v3/figure-v3-part-component.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAE9B,OAAO,SAAS,MAAM,+BAA+B,CAAA;AACrD,OAAO,KAAK,MAAM,2BAA2B,CAAA;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE5E,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AAmCxD,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,+CAA+C;IAC/C,IAAI,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAC5C;AAOD;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,iBAAiB,EACxB,QAAQ,CAAC,EAAE,MAAM,GAChB;IAAE,QAAQ,EAAE,KAAK,CAAC,cAAc,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC;IAAC,MAAM,EAAE,KAAK,CAAC,OAAO,CAAA;CAAE,GAAG,IAAI,CAoBzF;AAED,qBAAa,sBAAuB,SAAQ,UAAU;IACpD,OAAO,CAAC,IAAI,CAAC,CAAY;IAEzB,KAAK;IAaL,KAAK;IAOI,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI;IAU9D,8GAA8G;IAC9G,eAAe,IAAI,IAAI;IAKvB,OAAO,CAAC,QAAQ;CAqBjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAED,qBAAa,YAAa,SAAQ,iBAAe;IAC/C,MAAM,CAAC,YAAY,IAAI,IAAI;IAI3B,IAAI,eAAe,IAAI,OAAO,CAE7B;IAED,OAAO,IAAI,OAAO;IAIlB,IAAI,MAAM,IAAI,eAAe,CAE5B;IAED,eAAe,IAAI,WAAW,GAAG,SAAS;IAI1C,kEAAkE;IAClE,MAAM,CAAC,GAAG,EAAE,kBAAkB;CAO/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hatiolab/things-scene",
-  "version": "10.1.28",
+  "version": "10.1.29",
   "description": "A high-performance 2D/3D scene graph library for building interactive visual editors, combining HTML5 Canvas and Three.js to enable facility visualization, data-driven animations, and real-time monitoring dashboards",
   "main": "things-scene-min.js",
   "module": "things-scene.mjs",