@gcode-viewer/plugins 0.3.0

package/dist/types/measurements/BaseMeasureDrawable.d.ts

@@ -0,0 +1,28 @@
+import { THREE, Drawable } from "@gcode-viewer/core";
+import { MeasurementType } from "./BaseMeasurement";
+import type { MeasurementData } from "./BaseMeasurement";
+export declare abstract class BaseMeasureDrawable extends Drawable {
+    type: MeasurementType;
+    static readonly MAJOR_COLOR = "rgba(249, 157, 11, 0.9)";
+    static readonly MINOR_COLOR = "rgb(255, 255, 255)";
+    static readonly AREA_FILL_COLOR = "rgba(249, 157, 11, 0.3)";
+    static readonly LINE_WIDTH = 2;
+    static readonly POINT_RADIUS = 5;
+    static readonly LABEL_FONT_SIZE = 14;
+    label?: string;
+    labelPositon?: THREE.Vector2;
+    labelBounds: THREE.Box2;
+    drawing: boolean;
+    constructor(id: string, points: THREE.Vector3[]);
+    setDrawingState(isDrawing: boolean): void;
+    drawSelect(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    drawPoints(ctx: CanvasRenderingContext2D, camera: THREE.Camera, points: THREE.Vector3[]): void;
+    drawText(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    drawRoundRect(ctx: CanvasRenderingContext2D, x: number, y: number, width: number, height: number, radius: number): void;
+    getVertexes(): THREE.Vector3[];
+    update(points: THREE.Vector3[]): this;
+    getData(): MeasurementData;
+    setData(data: MeasurementData): void;
+    isPointInPath(p: THREE.Vector3, raycaster?: THREE.Raycaster): boolean;
+    getUnitString(): string;
+}

package/dist/types/measurements/BaseMeasurement.d.ts

@@ -0,0 +1,123 @@
+import { THREE, type BaseViewer, DrawableData, DrawableList, type MobileTouchHelperDrawable, type OSnapHelper, EventInfo, InputManager, Event as EventDispatcher } from "@gcode-viewer/core";
+import { Tooltip } from "@gcode-viewer/ui";
+import { type BaseMeasureDrawable } from "./BaseMeasureDrawable";
+/**
+ * Measurement type. e.g. distance measurement, area measurement, etc.
+ */
+export declare enum MeasurementType {
+    Distance = "Distance",
+    Area = "Area",
+    Angle = "Angle",
+    /**
+     * @hidden
+     */
+    Coordinate = "Coordinate"
+}
+/**
+ * Serializable measurement data
+ */
+export type MeasurementData = DrawableData;
+/**
+ * Measurement events.
+ */
+type MeasurementEvents = {
+    /**
+     * Triggered when clicked on a measurement drawable.
+     */
+    onclick: BaseMeasureDrawable;
+    /**
+     * Triggered when a measurement is completed.
+     * At this time, user may continue to do another measurement.
+     */
+    complete: BaseMeasureDrawable;
+    /**
+     * Triggered when measurement is deactivated.
+     */
+    deactivate: MeasurementType;
+    /**
+     * Triggered when the first point is drawn.
+     * We need this event to unselect a selected drawable, etc.
+     */
+    firstpointpicked: BaseMeasureDrawable;
+    /**
+     * Triggered before a drawable is added.
+     */
+    beforeadd: BaseMeasureDrawable;
+    /**
+     * Triggered when a drawable is updated.
+     */
+    update: BaseMeasureDrawable;
+    /**
+     * Triggered before a drawable is removed.
+     */
+    beforeremove: BaseMeasureDrawable;
+};
+/**
+ * BaseMeasurement class
+ */
+export declare abstract class BaseMeasurement extends EventDispatcher<MeasurementEvents> {
+    protected type: MeasurementType;
+    protected viewer: BaseViewer;
+    protected drawList: DrawableList;
+    protected osnapHelper: OSnapHelper;
+    protected actived: boolean;
+    protected mouseMoved: boolean;
+    protected mouseDowned: boolean;
+    protected touchDowned: boolean;
+    protected lastMoveEvent?: EventInfo;
+    protected lastMouseDownPosition?: THREE.Vector3;
+    protected mouseDownPositionX: number;
+    protected mouseDownPositionY: number;
+    protected currentMeasureDrawable?: BaseMeasureDrawable;
+    protected drawingPoints?: THREE.Vector3[];
+    protected lastClickTime?: number;
+    protected tooltip?: Tooltip;
+    protected snapPoint?: THREE.Vector3 | undefined;
+    protected completed?: boolean;
+    protected clickedOnMeasurementDrawable?: BaseMeasureDrawable;
+    protected mobileTouchHelper?: MobileTouchHelperDrawable;
+    protected exitButton?: HTMLButtonElement;
+    protected firstPickedListener?: () => void;
+    protected completedListener?: () => void;
+    constructor(type: MeasurementType, viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
+    get overlayRender(): import("@gcode-viewer/core").CanvasRender;
+    get renderer(): THREE.WebGLRenderer;
+    /**
+     * If measurement is active.
+     * Here let's use raycaster to identify whether this measurement is active.
+     */
+    get isActive(): boolean;
+    /**
+     * If it started to measure, but a measruement action is not completed yet.
+     */
+    get isMeasuring(): boolean;
+    setTouchHelper(mobileTouchHelper: MobileTouchHelperDrawable): void;
+    protected createMobileExitButton(): HTMLButtonElement;
+    activate(): void;
+    deactivate(): void;
+    protected removeDrawable(drawable: BaseMeasureDrawable): void;
+    clearClickedDrawable(): void;
+    touchstart: (e: EventInfo) => void;
+    touchmove: (e: EventInfo) => void;
+    touchend: (e: EventInfo) => void;
+    mousedown: (e: EventInfo) => void;
+    mousemove: (e: EventInfo) => void;
+    mouseup: (e: EventInfo) => void;
+    dblclick: () => void;
+    protected onMouseClick(e: EventInfo): void;
+    protected selectMeasurementByEvent(e: EventInfo): void;
+    keydown: (e: EventInfo) => void;
+    abstract exitDrawing(): void;
+    abstract cancel(): void;
+    protected abstract complete(): void;
+    protected abstract setTooltipContent(): void;
+    protected abstract createMeasureDrawable(): BaseMeasureDrawable | undefined;
+    protected onMouseMove(position: THREE.Vector3): void;
+    protected createOrUpdateMeasureDrawable(position?: THREE.Vector3): void;
+    /**
+     * The closest intersection
+     * @param e
+     */
+    getIntersections: (e: EventInfo) => THREE.Intersection[];
+}
+export {};

package/dist/types/measurements/CoordinateMeasureDrawable.d.ts

@@ -0,0 +1,10 @@
+import { THREE } from "@gcode-viewer/core";
+import { BaseMeasureDrawable } from "./BaseMeasureDrawable";
+import { MeasurementType } from "./BaseMeasurement";
+export declare class CoordinateMeasureDrawable extends BaseMeasureDrawable {
+    type: MeasurementType;
+    constructor(id: string, points: THREE.Vector3[]);
+    draw(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    drawText(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    getClassType(): string;
+}

package/dist/types/measurements/CoordinateMeasurement.d.ts

@@ -0,0 +1,12 @@
+import { type BaseViewer, DrawableList, OSnapHelper, EventInfo, InputManager } from "@gcode-viewer/core";
+import { BaseMeasurement } from "./BaseMeasurement";
+import { CoordinateMeasureDrawable } from "./CoordinateMeasureDrawable";
+export declare class CoordinateMeasurement extends BaseMeasurement {
+    constructor(viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
+    protected createMeasureDrawable(): CoordinateMeasureDrawable | undefined;
+    protected onMouseClick(e: EventInfo): void;
+    exitDrawing(): void;
+    protected complete(): void;
+    cancel(): void;
+    protected setTooltipContent(): void;
+}

package/dist/types/measurements/DistanceMeasureDrawable.d.ts

@@ -0,0 +1,13 @@
+import { THREE } from "@gcode-viewer/core";
+import { BaseMeasureDrawable } from "./BaseMeasureDrawable";
+import { MeasurementType } from "./BaseMeasurement";
+export declare class DistanceMeasureDrawable extends BaseMeasureDrawable {
+    static readonly SHORT_LINE_LENGTH = 12;
+    scale?: number;
+    type: MeasurementType;
+    constructor(id: string, points: THREE.Vector3[], scale?: number);
+    draw(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    drawText(ctx: CanvasRenderingContext2D, camera: THREE.Camera): void;
+    getClassType(): string;
+    setScale(scale: number): void;
+}

package/dist/types/measurements/DistanceMeasurement.d.ts

@@ -0,0 +1,21 @@
+import { type BaseViewer, EventInfo, InputManager, OSnapHelper, DrawableList } from "@gcode-viewer/core";
+import { BaseMeasurement } from "./BaseMeasurement";
+import { DistanceMeasureDrawable } from "./DistanceMeasureDrawable";
+export declare class DistanceMeasurement extends BaseMeasurement {
+    constructor(viewer: BaseViewer, input: InputManager, drawList: DrawableList, osnapHelper: OSnapHelper);
+    protected createMeasureDrawable(): DistanceMeasureDrawable | undefined;
+    protected onMouseClick(e: EventInfo): void;
+    exitDrawing(): void;
+    protected complete(): void;
+    cancel(): void;
+    deactivate(): void;
+    protected setTooltipContent(): void;
+    /**
+     * Gets the scale value.
+     */
+    getScale(): number | undefined;
+    /**
+     * Sets the scale value.
+     */
+    setScale(scale: number): void;
+}

package/dist/types/measurements/Locale.d.ts

@@ -0,0 +1,13 @@
+import { i18n } from "@gcode-viewer/core";
+export declare const en: {
+    measure: string;
+    areaMeasurement: string;
+};
+export declare const zh: {
+    measure: string;
+    areaMeasurement: string;
+};
+export declare const MEASUREMENT_I18N_NAMESPACE: "measurement";
+export { i18n };
+export type MeasurementTranslationKey = keyof typeof en;
+export declare function t(key: MeasurementTranslationKey): string;

package/dist/types/measurements/MeasurementPlugin.d.ts

@@ -0,0 +1,102 @@
+import { PluginConfig, THREE } from "@gcode-viewer/core";
+import { type BaseViewer, Plugin } from "@gcode-viewer/core";
+import { BaseMeasureDrawable } from "./BaseMeasureDrawable";
+import { MeasurementData, MeasurementType } from "./BaseMeasurement";
+/**
+ * Measurement plugin config.
+ */
+export type MeasurementPluginConfig = Partial<PluginConfig>;
+export declare class MeasurementPlugin extends Plugin {
+    static readonly DEFAULT_ID = "MeasurementPlugin";
+    selectedDrawable: BaseMeasureDrawable | undefined;
+    constructor(viewer: BaseViewer, cfg?: MeasurementPluginConfig);
+    protected get canvas(): HTMLCanvasElement;
+    protected get raycaster(): THREE.Raycaster;
+    add(drawable: BaseMeasureDrawable, needFireEvent?: boolean): void;
+    create(data: MeasurementData): BaseMeasureDrawable;
+    remove(drawable: BaseMeasureDrawable, needFireEvent?: boolean): void;
+    /**
+     * Set osnap tolerance in pixcel size. The pixcel size will be converted to a size in world coordinate and pass to OSnapHelper.
+     */
+    setSnapTolerance(toleranceInPixel: number): void;
+    /**
+     * Activates distance, area, or angle measurement according to `type`.
+     * @param type Measurement mode to start.
+     */
+    activate(type: MeasurementType): void;
+    /** Deactivates the current measurement mode and restores selection settings. */
+    deactivate(): void;
+    getActiveMeasurementType(): MeasurementType | undefined;
+    /**
+     *
+     * @returns {boolean}
+     * @description Is measure plugin active
+     */
+    isActive(): boolean;
+    /**
+     *
+     * @returns {boolean} Is measuring now
+     */
+    isMeasuring(): boolean;
+    /** Returns all persisted measurement records from the drawable list. */
+    getData(): MeasurementData[];
+    /**
+     * Aborts the in-progress measurement stroke without leaving measurement mode (user can start again).
+     */
+    cancel(): void;
+    /**
+     * Replaces measurements from serialized `MeasurementData` entries (undo-aware batch).
+     * @param dataArray Records to materialize as drawables.
+     */
+    setData(dataArray: MeasurementData[]): void;
+    /**
+     * Sets a measurement drawable's visibility by id.
+     * @param id
+     * @param visible
+     * @returns
+     * @description Sets a measurement's visibility.
+     */
+    setVisibleById(id: string, visible: boolean): boolean;
+    /**
+     * Sets all measurement drawables' visibilities.
+     */
+    setVisibilities(visible: boolean): void;
+    /** Clears all measurement drawables after exiting any active draw. */
+    clear(): void;
+    /**
+     * Gets a measurement drawable by id.
+     */
+    getById(id: string): BaseMeasureDrawable;
+    removeById(id: string): void;
+    /**
+     * Selects a measurement drawable by id.
+     * @param {string} id
+     * @description Selects a measurement by id
+     */
+    selectById(id: string): void;
+    /**
+     * Selects a measurement drawable.
+     */
+    select(drawable: BaseMeasureDrawable): void;
+    /**
+     *
+     * @param renderEnabled If need render measurement
+     * @description Unselects a measurement.
+     */
+    unselect(renderEnabled?: boolean): void;
+    /**
+     * Gets the scale value.
+     * Scale is the ratio of real world value and the value in three.js(pdf, a map, etc.).
+     * e.g., Real world distance is 1000, and the value in three.js is 1, then scale is 1000.
+     * We should display 1000 rather than 1 while measuring.
+     */
+    getScale(): number | undefined;
+    /**
+     * Sets the scale value.
+     */
+    setScale(scale: number | undefined): void;
+    /**
+     * @description Destroy measure plugin
+     */
+    destroy(): void;
+}

package/dist/types/measurements/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./BaseMeasureDrawable";
+export * from "./BaseMeasurement";
+export * from "./MeasurementPlugin";

package/dist/types/measurements/undo/AddMeasurementCommand.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "@gcode-viewer/core";
+import { MeasurementData } from "../BaseMeasurement";
+import { type MeasurementPlugin } from "../MeasurementPlugin";
+export declare class AddMeasurementCommand extends Command {
+    private manager;
+    private data;
+    constructor(manager: MeasurementPlugin, data: MeasurementData);
+    undo(): boolean;
+    redo(): boolean;
+}

package/dist/types/measurements/undo/RemoveMeasurementCommand.d.ts

@@ -0,0 +1,10 @@
+import { Command } from "@gcode-viewer/core";
+import { MeasurementData } from "../BaseMeasurement";
+import { type MeasurementPlugin } from "../MeasurementPlugin";
+export declare class RemoveMeasurementCommand extends Command {
+    private manager;
+    private data;
+    constructor(manager: MeasurementPlugin, data: MeasurementData);
+    undo(): boolean;
+    redo(): boolean;
+}

package/dist/types/plate/PlatePlugin.d.ts

@@ -0,0 +1,85 @@
+import { THREE, BaseViewer, Plugin, PluginConfig } from "@gcode-viewer/core";
+/**
+ * Print-bed / build-plate plugin config.
+ * Units are millimeters (scene units), XY plane, Z-up.
+ */
+export interface PlatePluginConfig extends Partial<PluginConfig> {
+    /** Visible by default. */
+    visible?: boolean;
+    /** Printable width along X (mm). Default `600`. */
+    sizeX?: number;
+    /** Printable depth along Y (mm). Default `600`. */
+    sizeY?: number;
+    /**
+     * Minor grid spacing in mm.
+     * Default `10` — common FDM / slicer convention (1 cm cells).
+     */
+    cellSize?: number;
+    /**
+     * Draw a stronger line every N minor cells.
+     * Default `5` → 50 mm majors when `cellSize` is 10.
+     */
+    majorEvery?: number;
+    /** World Z of the plate top surface. Default `0`. */
+    height?: number;
+    /**
+     * Where world XY `(0,0)` sits on the plate.
+     * - `corner` (default): plate covers `[0, sizeX] × [0, sizeY]` (printer-style).
+     * - `center`: plate is centered on the origin.
+     */
+    origin?: "corner" | "center";
+    /** Plate fill color. Default dark charcoal. */
+    plateColor?: number;
+    /** Minor grid line color. */
+    gridColor?: number;
+    /** Major grid line color. */
+    majorGridColor?: number;
+    /** Plate edge outline color. */
+    edgeColor?: number;
+    /**
+     * Labeled scale marks along the origin edges, in mm from the plate min corner.
+     * Default `[100, 200, 300]`. Pass `[]` to disable. Marks are drawn outside the plate.
+     */
+    scaleMarks?: number[];
+}
+/**
+ * Finite build-plate with a dark surface and anti-aliased light gray grid.
+ * Inspired by Bambu Studio’s engineering plate look (no logos / tabs).
+ */
+export declare class PlatePlugin extends Plugin {
+    static readonly DEFAULT_ID = "PlatePlugin";
+    protected readonly NAME = "BUILD_PLATE";
+    protected cfg: Required<Pick<PlatePluginConfig, "visible" | "sizeX" | "sizeY" | "cellSize" | "majorEvery" | "height" | "origin" | "plateColor" | "gridColor" | "majorGridColor" | "edgeColor" | "scaleMarks">> & PlatePluginConfig;
+    protected root?: THREE.Group;
+    protected plateMesh?: THREE.Mesh;
+    constructor(viewer: BaseViewer, cfg?: PlatePluginConfig);
+    getSize(): {
+        sizeX: number;
+        sizeY: number;
+    };
+    /**
+     * World-space AABB of the printable plate (thin volume at plate height).
+     * Used by camera fit when the scene has no loaded models.
+     */
+    getWorldBBox(): THREE.Box3;
+    setSize(sizeX: number, sizeY: number): void;
+    getCellSize(): number;
+    setCellSize(cellSize: number): void;
+    getHeight(): number;
+    setHeight(height: number): void;
+    setOrigin(origin: "corner" | "center"): void;
+    setVisible(visible: boolean): void;
+    isVisible(): boolean;
+    /** Rebuild geometry from the current config. */
+    rebuild(): void;
+    protected normalizedScaleMarks(sizeX: number, sizeY: number): number[];
+    protected addScaleLabels(root: THREE.Group, marks: number[], minX: number, minY: number, z: number): void;
+    /** Flat label mesh on the XY plane (not a camera-facing sprite). */
+    protected createScaleLabelMesh(text: string): THREE.Mesh;
+    protected plateBounds(): {
+        minX: number;
+        minY: number;
+    };
+    protected disposeMeshes(): void;
+    destroy(): void;
+}

package/dist/types/plate/index.d.ts

@@ -0,0 +1 @@
+export * from "./PlatePlugin";

package/dist/types/property/AnimationPanel.d.ts

@@ -0,0 +1,3 @@
+import { THREE, type Viewer3d } from "@gcode-viewer/core";
+/** Read-only animation clip list for the CAD Editor Node panel. */
+export declare function appendAnimationSection(container: HTMLElement, viewer: Viewer3d, target?: THREE.Object3D): void;

package/dist/types/property/CameraEditor.d.ts

@@ -0,0 +1,3 @@
+import { THREE } from "@gcode-viewer/core";
+/** Appends perspective / orthographic camera fields under {@link container}. */
+export declare function appendCameraEditor(container: HTMLElement, camera: THREE.Camera, enableRender: () => void): void;

package/dist/types/property/EnvironmentPanel.d.ts

@@ -0,0 +1,3 @@
+import { Viewer3d } from "@gcode-viewer/core";
+/** Renders global PBR / renderer environment controls into {@link container}. */
+export declare function renderEnvironmentPanel(container: HTMLElement, viewer: Viewer3d): void;

package/dist/types/property/LightEditor.d.ts

@@ -0,0 +1,3 @@
+import { THREE } from "@gcode-viewer/core";
+/** Appends light-specific fields under {@link container}. */
+export declare function appendLightEditor(container: HTMLElement, light: THREE.Light, enableRender: () => void): void;

package/dist/types/property/Locale.d.ts

@@ -0,0 +1,83 @@
+import { i18n } from "@gcode-viewer/core";
+export declare const en: {
+    property: string;
+    tabMaterial: string;
+    tabNode: string;
+    nothingSelected: string;
+    propertyNoUserData: string;
+    propertyNoneVisible: string;
+    propertyAddNameRequired: string;
+    propertyAddNameDuplicate: string;
+    duplicateMaterial: string;
+    duplicateGeometry: string;
+    recalculateNormalsOutside: string;
+    recalculateNormalsInside: string;
+    regenerateSmartUv: string;
+    meshTools: string;
+    applyTransform: string;
+    flipFaces: string;
+    flipNormals: string;
+    generateTangents: string;
+    originToGeometryCenter: string;
+    geometryCenterToOrigin: string;
+    originToGeometryBottom: string;
+    geometryBottomToOrigin: string;
+    exposure: string;
+    toneMapping: string;
+    background: string;
+    skyWhite: string;
+    skyBlack: string;
+    skyGray: string;
+    skyGradient1: string;
+    environmentMap: string;
+    envDefault: string;
+    envCity: string;
+    envGrass: string;
+    envSunset: string;
+    animations: string;
+    noAnimations: string;
+    tabEnvironment: string;
+};
+export declare const zh: {
+    property: string;
+    tabMaterial: string;
+    tabNode: string;
+    nothingSelected: string;
+    propertyNoUserData: string;
+    propertyNoneVisible: string;
+    propertyAddNameRequired: string;
+    propertyAddNameDuplicate: string;
+    duplicateMaterial: string;
+    duplicateGeometry: string;
+    recalculateNormalsOutside: string;
+    recalculateNormalsInside: string;
+    regenerateSmartUv: string;
+    meshTools: string;
+    applyTransform: string;
+    flipFaces: string;
+    flipNormals: string;
+    generateTangents: string;
+    originToGeometryCenter: string;
+    geometryCenterToOrigin: string;
+    originToGeometryBottom: string;
+    geometryBottomToOrigin: string;
+    exposure: string;
+    toneMapping: string;
+    background: string;
+    skyWhite: string;
+    skyBlack: string;
+    skyGray: string;
+    skyGradient1: string;
+    environmentMap: string;
+    envDefault: string;
+    envCity: string;
+    envGrass: string;
+    envSunset: string;
+    animations: string;
+    noAnimations: string;
+    tabEnvironment: string;
+};
+export declare const PROPERTY_I18N_NAMESPACE: "property";
+export { i18n };
+export type PropertyTranslationKey = keyof typeof en;
+export declare function t(key: PropertyTranslationKey): string;

package/dist/types/property/MaterialEditor.d.ts

@@ -0,0 +1,9 @@
+import { THREE } from "@gcode-viewer/core";
+type EnableRender = () => void;
+/**
+ * Appends gltfeditor-style material sections (general + type-specific) under {@link container}.
+ * Caller supplies identity fields (name / UUID) separately if needed.
+ * {@link refreshPanel} is called after texture replace/remove so the panel re-renders with the new state.
+ */
+export declare function appendMaterialTypeEditor(container: HTMLElement, mat: THREE.Material, enableRender: EnableRender, refreshPanel?: () => void): void;
+export {};

package/dist/types/property/PropertyPanelUi.d.ts

@@ -0,0 +1,34 @@
+/**
+ * DOM helpers and static UI assets for {@link PropertyPlugin}.
+ * Keeps the plugin file focused on viewer / tab orchestration.
+ */
+export type PropertyUserDataType = "string" | "number" | "boolean" | "json";
+/** Trash can (stroke), used for userData row delete and UV attribute delete. */
+export declare const PROPERTY_ICON_DELETE_TRASH = "<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path d=\"M19 7l-1 12a2 2 0 01-2 2H8a2 2 0 01-2-2L5 7m5-3V4a1 1 0 011-1h4a1 1 0 011 1v0M3 7h18\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/><path d=\"M10 11v5M14 11v5\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"/></svg>";
+/** Plus (stroke), used for adding a userData property. */
+export declare const PROPERTY_ICON_ADD_PLUS = "<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path d=\"M12 5v14M5 12h14\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\"/></svg>";
+/** Refresh / sync (filled), used for smart UV regenerate. */
+export declare const PROPERTY_ICON_UV_REFRESH = "<svg viewBox=\"0 0 1024 1024\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path fill=\"currentColor\" d=\"M783.568 328C724.571 241.095 624.953 184 512 184c-181.15 0-328 146.85-328 328h-72c0-220.914 179.086-400 400-400 135.738 0 255.685 67.611 328 170.994V128c0-8.837 7.163-16 16-16h48a8 8 0 0 1 8 8v248c0 17.673-14.327 32-32 32H632a8 8 0 0 1-8-8v-48c0-8.837 7.163-16 16-16h143.568zM240.432 696C299.429 782.905 399.047 840 512 840c181.15 0 328-146.85 328-328h72c0 220.914-179.086 400-400 400-135.738 0-255.685-67.611-328-170.994V896c0 8.837-7.163 16-16 16h-48a8 8 0 0 1-8-8V656c0-17.673 14.327-32 32-32h248a8 8 0 0 1 8 8v48c0 8.837-7.163 16-16 16H240.432z\"/></svg>";
+/** Eye (stroke), used for viewing geometry attribute values. */
+export declare const PROPERTY_ICON_VIEW_EYE = "<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><path d=\"M2 12s3.5-7 10-7 10 7 10 7-3.5 7-10 7-10-7-10-7z\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/><circle cx=\"12\" cy=\"12\" r=\"3\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\"/></svg>";
+/** Duplicate / copy (stroke), used for material instance copy. */
+export declare const PROPERTY_ICON_DUPLICATE = "<svg viewBox=\"0 0 24 24\" width=\"14\" height=\"14\" aria-hidden=\"true\"><rect x=\"9\" y=\"9\" width=\"11\" height=\"11\" rx=\"1\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\"/><path d=\"M5 15H4a2 2 0 01-2-2V4a2 2 0 012-2h9a2 2 0 012 2v1\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\"/></svg>";
+export declare function createFormInputRow(labelText: string, fieldEl: HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement): HTMLDivElement;
+export declare function createCheckRow(labelText: string, checkbox: HTMLInputElement): HTMLDivElement;
+/** Collapsible block for Node tab sections (Transform, Geometry, Animations, …). */
+export declare function createCollapsibleNodeSection(panel: HTMLElement, titleText: string, options?: {
+    defaultCollapsed?: boolean;
+    initiallyHidden?: boolean;
+}): {
+    section: HTMLDivElement;
+    body: HTMLDivElement;
+};
+export interface IconActionButtonOptions {
+    className: string;
+    title: string;
+    svg: string;
+}
+export declare function createIconActionButton(opts: IconActionButtonOptions): HTMLButtonElement;
+/** Opens a plain popup window to inspect raw geometry buffer values (similar to gltfeditor.com). */
+export declare function openGeometryDataViewer(title: string, content: string): void;
+export declare function createDefaultPropertyValue(type: PropertyUserDataType): string | number | boolean | object;