zyf-model-engine 0.0.1 → 0.1.0

package/types/components/UtilsMenu/components/ModelTree/interface/index.d.ts

@@ -0,0 +1,19 @@
+import { TreeProps, TreeNodeData } from 'element-plus/es/components/tree-v2/src/types';
+import { Group } from 'three';
+import { CardProp } from '../../../interface/index';
+import { default as Viewer } from '../../../../..';
+export type TabType = "model" | "floor" | "category";
+type MutableOptionalTreeConfig = Partial<Mutable<TreeProps>>;
+export interface ModelTreeProps extends CardProp {
+    viewer?: Viewer;
+    tabs?: TabType[];
+    jsonFileUrl?: string;
+    model?: Group;
+    loadCallback?: () => any;
+    nodeCheckCallback?: (data: TreeNodeData, checked: boolean) => any;
+    nodeClickCallback?: (data: any) => any;
+    treeConfig?: MutableOptionalTreeConfig;
+    hiddenMeshGuids?: string[];
+    changeTabSaveHiddenMesh?: boolean;
+}
+export {};

package/types/components/UtilsMenu/components/ModelTree/utils/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 加载 JSON 格式的模型树。
+ * @param url - JSON 文件的 URL
+ * @param loaded - 加载完成后的回调函数
+ * @param hiddenMeshGuids - 隐藏构件的guid
+ */
+export declare function loadTreeJson(url: string, name: string, hiddenMeshGuids?: string[], changeTabSaveHiddenMesh?: boolean): Promise<{
+    category: any;
+    floor: any;
+    model: any;
+    secondUuids: any[];
+    hiddenSecondIds: Record<string, string>;
+}>;

package/types/components/UtilsMenu/components/Roam/index.vue.d.ts

@@ -0,0 +1,125 @@
+import { RoamChildProp } from '../../interface/index';
+type __VLS_Props = RoamChildProp & {
+    state: "fly" | "person";
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {
+    getCardDOMRect: () => any;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    CardRef: {
+        $: import('vue').ComponentInternalInstance;
+        $data: {};
+        $props: Partial<{
+            size: {
+                width?: string;
+                height?: string;
+            };
+            close: boolean;
+            drag: boolean;
+            resize: boolean;
+            position: {
+                left?: string;
+                right?: string;
+                top?: string;
+                bottom?: string;
+            };
+            z: number;
+        }> & Omit<{
+            readonly title?: string;
+            readonly render?: import('vue').Component;
+            readonly z?: number;
+            readonly size?: {
+                width?: string;
+                height?: string;
+            };
+            readonly position?: {
+                left?: string;
+                right?: string;
+                top?: string;
+                bottom?: string;
+            };
+            readonly resize?: boolean;
+            readonly resizeCallback?: (rect: DOMRect) => void;
+            readonly drag?: boolean;
+            readonly dragCallback?: (rect: DOMRect) => void;
+            readonly close?: boolean;
+            readonly closeCallback?: (rect?: DOMRect | undefined) => void;
+        } & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps, "size" | "close" | "drag" | "resize" | "position" | "z">;
+        $attrs: {
+            [x: string]: unknown;
+        };
+        $refs: {
+            [x: string]: unknown;
+        } & {
+            basePanel: HTMLDivElement;
+        };
+        $slots: Readonly<{
+            [name: string]: import('vue').Slot<any>;
+        }>;
+        $root: import('vue').ComponentPublicInstance | null;
+        $parent: import('vue').ComponentPublicInstance | null;
+        $host: Element | null;
+        $emit: (event: string, ...args: any[]) => void;
+        $el: HTMLDivElement;
+        $options: import('vue').ComponentOptionsBase<Readonly<import('../../interface/index').CardProp> & Readonly<{}>, {
+            getBoundingClientRect: () => DOMRect;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, {
+            size: {
+                width?: string;
+                height?: string;
+            };
+            close: boolean;
+            drag: boolean;
+            resize: boolean;
+            position: {
+                left?: string;
+                right?: string;
+                top?: string;
+                bottom?: string;
+            };
+            z: number;
+        }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & {
+            beforeCreate?: (() => void) | (() => void)[];
+            created?: (() => void) | (() => void)[];
+            beforeMount?: (() => void) | (() => void)[];
+            mounted?: (() => void) | (() => void)[];
+            beforeUpdate?: (() => void) | (() => void)[];
+            updated?: (() => void) | (() => void)[];
+            activated?: (() => void) | (() => void)[];
+            deactivated?: (() => void) | (() => void)[];
+            beforeDestroy?: (() => void) | (() => void)[];
+            beforeUnmount?: (() => void) | (() => void)[];
+            destroyed?: (() => void) | (() => void)[];
+            unmounted?: (() => void) | (() => void)[];
+            renderTracked?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            renderTriggered?: ((e: import('vue').DebuggerEvent) => void) | ((e: import('vue').DebuggerEvent) => void)[];
+            errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
+        };
+        $forceUpdate: () => void;
+        $nextTick: typeof import('vue').nextTick;
+        $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
+    } & Readonly<{
+        size: {
+            width?: string;
+            height?: string;
+        };
+        close: boolean;
+        drag: boolean;
+        resize: boolean;
+        position: {
+            left?: string;
+            right?: string;
+            top?: string;
+            bottom?: string;
+        };
+        z: number;
+    }> & Omit<Readonly<import('../../interface/index').CardProp> & Readonly<{}>, "getBoundingClientRect" | ("size" | "close" | "drag" | "resize" | "position" | "z")> & import('vue').ShallowUnwrapRef<{
+        getBoundingClientRect: () => DOMRect;
+    }> & {} & import('vue').ComponentCustomProperties & {} & {
+        $slots: {
+            header?(_: {}): any;
+            default?(_: {}): any;
+            footer?(_: {}): any;
+        };
+    };
+}, HTMLDivElement>;
+export default _default;

package/types/components/UtilsMenu/components/SubMenu/index.vue.d.ts

@@ -0,0 +1,18 @@
+import { BaseProp } from '../../interface/index';
+interface Prop {
+    leave?: number;
+    utils: {
+        [key: string]: BaseProp;
+    };
+    keyPath?: string[];
+    currentActive?: Record<string, BaseProp | undefined>;
+}
+declare const _default: import('vue').DefineComponent<Prop, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    handleSelect: (...args: any[]) => void;
+}, string, import('vue').PublicProps, Readonly<Prop> & Readonly<{
+    onHandleSelect?: (...args: any[]) => any;
+}>, {
+    leave: number;
+    keyPath: string[];
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/types/components/UtilsMenu/index.vue.d.ts

@@ -0,0 +1,15 @@
+import { BaseProp, UtilsMenuProps } from './interface/index';
+declare function batchDeselectAll(): void;
+declare const _default: import('vue').DefineComponent<UtilsMenuProps, {
+    handleSelect: (key: string | string[], keyPath?: string[]) => void;
+    currentActive: import('vue').Ref<Record<string, BaseProp>, Record<string, BaseProp>>;
+    treeRef: import('vue').Ref<any, any>;
+    measureRef: import('vue').Ref<any, any>;
+    comInfoRef: import('vue').Ref<any, any>;
+    cuttingRef: import('vue').Ref<any, any>;
+    baseInfoRef: import('vue').Ref<any, any>;
+    configRef: import('vue').Ref<any, any>;
+    RoamRef: import('vue').Ref<any, any>;
+    batchDeselectAll: typeof batchDeselectAll;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<UtilsMenuProps> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/types/components/UtilsMenu/interface/index.d.ts

@@ -0,0 +1,129 @@
+import { default as Viewer } from '../../..';
+import { Component } from 'vue';
+import { TreeProps, TreeNodeData } from 'element-plus/es/components/tree-v2/src/types';
+import { Group } from 'three';
+export interface BaseValue {
+    label: string;
+    value: any;
+    [key: string]: any;
+}
+export interface BaseProp {
+    name: string;
+    icon: string;
+    active?: boolean;
+    show?: boolean;
+    children?: Record<string, BaseProp>;
+    conflictKey?: string[];
+    activeCallback?: (...arg: any[]) => any;
+    [key: string]: any;
+}
+export interface CardProp {
+    title?: string;
+    render?: Component;
+    z?: number;
+    size?: {
+        width?: string;
+        height?: string;
+    };
+    position?: {
+        left?: string;
+        right?: string;
+        top?: string;
+        bottom?: string;
+    };
+    resize?: boolean;
+    resizeCallback?: (rect: DOMRect) => void;
+    drag?: boolean;
+    dragCallback?: (rect: DOMRect) => void;
+    close?: boolean;
+    closeCallback?: (rect?: DOMRect | undefined) => void;
+}
+export type TabType = "model" | "floor" | "category";
+type MutableOptionalTreeConfig = Partial<Mutable<TreeProps>>;
+export interface ModelTreeProps {
+    tabs?: TabType[];
+    jsonFileUrl: string;
+    model: Group;
+    loadCallback?: () => any;
+    nodeCheckCallback?: (data: TreeNodeData, checked: boolean) => any;
+    nodeClickCallback?: (data: any) => any;
+    treeConfig?: MutableOptionalTreeConfig;
+    hiddenMeshGuids?: string[];
+    changeTabSaveHiddenMesh?: boolean;
+}
+export interface Tree {
+    viewer: Viewer;
+    config: ModelTreeProps;
+    cardConfig: CardProp;
+}
+interface Cutting {
+    children: {
+        global: BaseProp & {
+            cardConfig?: CardProp;
+        };
+        local: BaseProp & {
+            cardConfig?: CardProp;
+        };
+    };
+}
+interface Screenshot {
+    config?: {
+        download?: boolean;
+        imgName?: string;
+        type?: "image/png" | "image/jpeg" | "image/jpg";
+        quality?: number;
+        screenshotCallback?: (data: string) => any;
+    };
+}
+export interface Measure {
+    viewer: Viewer;
+    cardConfig?: CardProp;
+}
+export interface BaseInfo {
+    viewer: Viewer;
+    cardConfig?: CardProp;
+    otherInfo?: BaseValue[];
+}
+export interface ComInfo {
+    viewer: Viewer;
+    cardConfig?: CardProp;
+    otherInfo?: Record<string, any>;
+}
+export interface Config {
+    viewer: Viewer;
+    cardConfig?: CardProp;
+    otherInfo?: {
+        modelLine?: boolean;
+        sectionLine?: boolean;
+        bgColor?: string[];
+    };
+}
+export interface RoamChildProp {
+    viewer: Viewer;
+    cardConfig?: CardProp;
+}
+interface Roam {
+    children?: {
+        fly?: BaseProp & RoamChildProp;
+        person?: BaseProp & RoamChildProp;
+    };
+}
+export interface UtilsProp {
+    review?: BaseProp;
+    tree?: Tree & BaseProp;
+    roam?: Roam & BaseProp;
+    screenshot?: Screenshot & BaseProp;
+    cutting?: Cutting & BaseProp;
+    measure?: Measure & BaseProp;
+    comInfo?: ComInfo & BaseProp;
+    fullScreen?: BaseProp;
+    baseInfo?: BaseInfo & BaseProp;
+    config?: ComInfo & BaseProp;
+    [key: string]: BaseProp;
+}
+export interface UtilsMenuProps {
+    show?: boolean;
+    viewer: Viewer;
+    options?: UtilsProp;
+}
+export {};

package/types/index-dxf.vue.d.ts

@@ -0,0 +1,15 @@
+import { DxfViewer } from './workbench/DxfViewer';
+type __VLS_Props = {
+    url: string;
+    showTools?: boolean;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {
+    viewer: () => DxfViewer;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    url: string;
+    showTools: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    dxfTools: HTMLDivElement;
+    viewerDom: HTMLCanvasElement;
+}, HTMLDivElement>;
+export default _default;

package/types/index.d.ts

@@ -0,0 +1,209 @@
+import { Box3, BufferGeometry, Clock, Group, LineSegments, Mesh, Object3D, OrthographicCamera, PerspectiveCamera, Scene, Vector3, WebGLRenderer } from 'three';
+import { OrbitControls } from 'three/examples/jsm/controls/OrbitControls.js';
+import { FlyControls } from './vendor/controls/FlyControls';
+import { FirstPersonControls } from './vendor/controls/FirstPersonControls';
+import { CSS2DObject } from 'three/examples/jsm/renderers/CSS2DRenderer';
+import { controlParams, ViewerOptions } from './libs/types';
+import { default as LightManager } from './manager/lightManager';
+import { default as HighLightMeshManager } from './manager/highLightMeshManager';
+import { default as RayCasterManager } from './manager/rayCasterManager';
+import { default as WorkerPool } from './vendor/worker/index';
+/**
+ * Viewer 类：用于管理和渲染 Three.js 场景。
+ * 提供了加载模型、控制相机、添加灯光、处理用户交互等功能。
+ */
+export default class Viewer {
+    allMesh: {
+        [k: string]: Object3D;
+    };
+    workerPool: WorkerPool;
+    readonly clock: Clock;
+    readonly time = 0;
+    private animationFrameId;
+    private person;
+    private cubeCamera;
+    private cubeScene;
+    private tempFileUrls;
+    lightManager: LightManager;
+    highLightMeshManager: HighLightMeshManager;
+    rayCasterManager: RayCasterManager;
+    perspectiveCamera: PerspectiveCamera;
+    orthographicCamera: OrthographicCamera;
+    floorGroup: Group;
+    orbitControl: OrbitControls;
+    flyControl: FlyControls;
+    firstControl: FirstPersonControls;
+    renderer: WebGLRenderer;
+    camera: PerspectiveCamera | OrthographicCamera;
+    scene: Scene;
+    element: HTMLCanvasElement;
+    objs: {
+        [k: string]: Object3D;
+    };
+    objects: {
+        [k: string]: Mesh | LineSegments;
+    };
+    resizeFlag: boolean;
+    containerGroup: Group;
+    controlType: string;
+    flag: boolean;
+    stopRender: boolean;
+    options: ViewerOptions;
+    initOptions: ViewerOptions;
+    utilsMenuRef: any;
+    /**
+     * 构造函数：初始化 Viewer 对象。
+     * @param dom - 绑定的 Canvas 元素
+     * @param options - 配置选项，包括是否显示 ViewCube 和背景透明度等
+     */
+    constructor(dom: HTMLCanvasElement, options?: ViewerOptions);
+    setOptions(options: ViewerOptions, callback: () => any): void;
+    /**
+     * 初始化场景：设置相机、渲染器、灯光等。
+     * @param options - 配置选项
+     */
+    private init;
+    /**
+     * 初始化 ViewCube。
+     * @returns 初始化的 ViewCube 对象
+     */
+    private initCube;
+    /**
+     * 渲染场景。
+     */
+    renderScene(): void;
+    /**
+     * 添加第一人称控制器。
+     * @param cube - 可选的 ViewCube 对象
+     */
+    private addPerson;
+    /**
+     * 控制器参数
+     * @param type[string] orbit fly person
+     * @param params[controlParams] 控制器的相应参数
+     */
+    setControl(type: string, params: controlParams): void;
+    /**
+     * 截图方法
+     * @param type 截图生成图片的格式
+     * @param quality 图片质量
+     * @returns base64 图片数据
+     */
+    screenShoot(type?: "image/png" | "image/jpeg" | "image/jpg", quality?: number): string;
+    lookingDownEntity(uuids: string[], up: Vector3): void;
+    /**
+     * 初始化控制器：轨道控制器、飞行控制器、第一人称控制器。
+     */
+    private initControl;
+    /**
+     * 添加实体到场景中  （以obj的uuid为索引记录到objs中 并添加到场景对象上）。
+     * @param obj - 要添加的 Object3D 对象
+     */
+    addObject(obj: Object3D): void;
+    /**
+     * 添加射线检测对象到容器组中。
+     * @param obj - 要添加的 Object3D 对象
+     */
+    addRays(obj: Object3D): void;
+    /**
+     * 调整场景大小。
+     * @param width - 新的宽度
+     * @param height - 新的高度
+     */
+    resize(width: number, height: number): void;
+    /**
+     * 创建并返回一个新的 Group 对象  调用该函数时 自动将group加入到场景对象中  并将调用mesh对象的uuid作为key值记录到this.objs中。
+     * @returns 创建的 Group 对象
+     */
+    private _createGroup;
+    /**
+     * 创建并添加 2D 标签到场景中。
+     * @param html - 标签的 HTML 内容
+     * @param position - 标签的位置
+     * @param callback - 点击标签时的回调函数
+     * @returns 创建的 CSS2DObject 对象
+     */
+    create2DLabel(html: string, position: {
+        x: number;
+        y: number;
+        z: number;
+    }, callback?: () => void): CSS2DObject;
+    /**
+     * 加载 ZIP 格式的模型文件。
+     * @param zipData - ZIP 文件的二进制数据
+     * @param id - 模型的 ID
+     * @param loaded - 加载完成后的回调函数
+     * @returns 加载的模型对象
+     */
+    loadZipModel(url: string, id: string, loadend: (utilsMenuRef: any) => void, loadError?: (error: any) => any): Promise<any>;
+    loadMultipleGlbModel(urls: string[], id: string, loadend: (utilsMenuRef: any) => void, loadError?: (error: any) => any): Promise<unknown>;
+    /**
+     * 加载模型并处理构件树。
+     * @param url - 模型文件的 URL
+     * @param images - 模型所需的图片
+     * @param loaded - 加载完成后的回调函数
+     * @param jsonUrl - 可选的 JSON 文件 URL
+     * @returns 加载的模型对象
+     */
+    loadModel(modelUrls: string[], images: {
+        [k: string]: string;
+    } | null, loaded: (model: Group, jsonUrl?: string) => void): Object3D;
+    loadModelCallBack(model: Group, jsonUrl?: string, loadend?: (utilsMenuRef: any) => void): void;
+    /**
+     * 加载单个 GLB 文件。
+     * @param url - GLB 文件的 URL
+     * @param images - 模型所需的图片
+     * @param group - 模型组
+     * @param loaded - 加载完成后的回调函数
+     */
+    private _loadGlbByUrl;
+    /**
+     * 设置第一人称控制器的拾取面信息。
+     * @param meshs - 需要拾取的 Mesh 对象
+     */
+    setControlRays(meshs: Array<Mesh> | Mesh): void;
+    /**
+     * 重置视角。
+     * @param time - 重置动画的时间
+     */
+    resetView(time?: number): void;
+    /**
+     * 设置指定构件的颜色。
+     * @param guids - 需要设置颜色的构件的 UUID 数组
+     * @param color - 颜色值
+     */
+    setColorGroup(guids: string[], color: number): void;
+    hiddenObjectPartsByHiddenMeshGuids(): void;
+    setObjectPartsToBeVisibleAndHiddenByGuid(geometry: BufferGeometry, guid: string, visible: boolean): boolean;
+    /**
+     * 播放相机动画。
+     * @param position - 相机目标位置
+     * @param target - 相机注视点
+     * @param up - 相机的上方向
+     * @param time - 动画时间
+     */
+    animate(position: Vector3, target: Vector3, up?: Vector3, time?: number): void;
+    /**
+     * 切换相机类型。
+     * @param type - 相机类型：orthogonal | perspective
+     */
+    toggleCamera(type: "orthogonal" | "perspective"): void;
+    /**
+     * 获取所有对象的包围盒。
+     * @returns 所有对象的包围盒
+     */
+    getAllObjectBox(): Box3;
+    /**
+     * 设置相机和控制器的位置。
+     * @param position - 相机位置
+     * @param target - 相机注视点
+     */
+    setCameraAndControl(position: Vector3, target: Vector3): void;
+    mergeBufferGeometries(geos: any, callback?: (geos: BufferGeometry | undefined) => any): void;
+    focusOnTheMesh(mesh: Mesh): void;
+    setAllMaterialsTransparent(opacity: number): void;
+    /**
+     * 销毁场景：释放资源并停止渲染。
+     */
+    destroy(isInit?: boolean): void;
+}

package/types/index.vue.d.ts

@@ -0,0 +1,18 @@
+import { ViewerOptions } from './libs/types';
+export interface viewerProps {
+    url: string | string[];
+    options?: ViewerOptions;
+    loadZipModelCallback?: (ref: any) => any;
+    loadCallback?: (model: any) => any;
+    errorCallback?: (error: any) => any;
+}
+declare function loadModel(): Promise<void>;
+declare const _default: import('vue').DefineComponent<viewerProps, {
+    viewer: any;
+    menuUtilsRef: any;
+    model: any;
+    loadModel: typeof loadModel;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<viewerProps> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    viewerDom: HTMLCanvasElement;
+}, HTMLDivElement>;
+export default _default;

package/types/libs/CFace.d.ts

@@ -0,0 +1,16 @@
+import { Mesh, Vector3 } from 'three';
+/**
+ * 构建二维平面
+ * @param points Vector3点数组
+ * @param type 是否选择纯透明的面材质
+ * @returns Mesh
+ */
+export declare function createTwoFace(points: Vector3[], type?: boolean): Mesh;
+/**
+ * @description 构建三维多边形面：对 points[0] 与后续每两点构成的三角形做三角剖分，
+ * 生成 BufferGeometry + 橙色半透明材质的 Mesh（type=true 时用纯透明材质）
+ * @param points Vector3 数组，至少 3 个点
+ * @param type true=透明面, false=面积面（默认 false）
+ * @returns Mesh
+ */
+export declare const createThreeFace: (points: Vector3[], type?: boolean) => Mesh;

package/types/libs/CLabel.d.ts

@@ -0,0 +1,13 @@
+import { Vector3 } from 'three';
+import { CSS2DObject } from 'three/examples/jsm/renderers/CSS2DRenderer';
+/**
+ *
+ * @param {string} text 文本内容
+ * @param {Vector3} position 文本位置
+ * @param {string} size 文字大小  fontSize
+ * @param {string} color 文字颜色
+ * @param {string} bacColor 背景颜色
+ * @param {boolean} visible 是否可见
+ * @returns
+ */
+export declare function createLabel(text: string, position?: Vector3, size?: string, color?: string, bacColor?: string, visible?: boolean): CSS2DObject;

package/types/libs/CLine.d.ts

@@ -0,0 +1,49 @@
+import { Vector3 } from 'three';
+import { Line2 } from 'three/examples/jsm/lines/Line2';
+import { LineGeometry } from 'three/examples/jsm/lines/LineGeometry';
+import { LineMaterial } from 'three/examples/jsm/lines/LineMaterial';
+/**
+ *   多个顶点组成的连续直线
+ *   封装 three.js Line2 + LineGeometry + LineMaterial，支持实线/虚线、
+ *   颜色/线宽/透明度/状态（default/selected/highlight）、自动创建顶点小球等配置
+ */
+type CLineAttrs = {
+    vertexs?: Array<Vector3> | Array<Array<number>> | Array<number>;
+    dashed?: boolean;
+    color?: number;
+    lineWidth?: number;
+    transparent?: boolean;
+    opacity?: number;
+    uuid?: string;
+    dashSize?: number;
+    gapSize?: number;
+    state?: "default" | "selected" | "highlight";
+    multistage?: boolean;
+    renderOrder?: number;
+    name?: string;
+    createPoints?: boolean;
+    constraint?: any;
+    marks?: any;
+    data?: any;
+};
+export declare class CLine extends Line2 {
+    name: string;
+    geometry: LineGeometry;
+    material: LineMaterial;
+    constructor(attrs?: CLineAttrs);
+    initUI(attrs?: CLineAttrs): void;
+    /**
+     * 设置顶点
+     * @param vertexs  [vector3 , vector3 ...]  |  [ [a1,b1,c1 ] ,[ a2,b2,c2] ...]  |  [a,b,c,d...]
+     */
+    setVertexs(vertexs: Array<Vector3> | Array<Array<number>> | Array<number>): CLine;
+    getVertexs(): Vector3[];
+    setDashed(dashed: boolean): void;
+    setDashSize(size: number): void;
+    setGapSize(size: number): void;
+    setLineWidth(linewidth?: number): void;
+    setTransparent(transparent: boolean): void;
+    setOpacity(opacity?: number): void;
+    setColor(color?: number): void;
+}
+export {};

package/types/libs/CText.d.ts

@@ -0,0 +1,17 @@
+import { Sprite } from 'three';
+import { textType } from './types';
+/**
+ * @description 创建带圆角背景的文字 Sprite：通过 Canvas2D 绘制文字 + 背景圆角矩形，
+ * 再贴到 CanvasTexture → SpriteMaterial，返回一个始终面向相机的 Sprite
+ * @param attrs.text 显示文字, hPxText 字号（默认 50px）, fgColor 字色,
+ *   fontFamily 字体, bold 是否粗体, italic 是否斜体, bgColor 背景色
+ * @returns Sprite 或 undefined
+ */
+export declare const createText: (attrs: textType) => Sprite | undefined;
+/**
+ * @description 创建高度标注文字 Sprite（比 createText 字号大、支持文字对齐 textAlign），
+ * 用于标高测量结果的三维标签
+ * @param attrs 同 createText，额外支持 hWorldAll（世界坐标下的高度）
+ * @returns Sprite 或 undefined
+ */
+export declare const createHeightText: (attrs: textType) => Sprite | undefined;