endset_three_editor 0.1.4 → 0.1.5

package/dist/App.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/BottomBar.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/DrawingBoard.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/PropertyPanel.vue.d.ts

@@ -0,0 +1,36 @@
+import { Object3D } from 'three';
+type __VLS_Props = {
+    /** 变换数据对象，包含 position, rotation, scale */
+    transform: {
+        position: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        rotation: {
+            x: number;
+            y: number;
+            z: number;
+        };
+        scale: {
+            x: number;
+            y: number;
+            z: number;
+        };
+    } | null;
+    /** 顶层物体列表 */
+    treeData: Object3D[];
+    /** 当前选中的物体 */
+    selectedObject: Object3D | null;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    propertyChange: () => any;
+    treeSelect: (obj: Object3D<import('three').Object3DEventMap>) => any;
+    treeDelete: (obj: Object3D<import('three').Object3DEventMap>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onPropertyChange?: (() => any) | undefined;
+    onTreeSelect?: ((obj: Object3D<import('three').Object3DEventMap>) => any) | undefined;
+    onTreeDelete?: ((obj: Object3D<import('three').Object3DEventMap>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/TopBar.vue.d.ts

@@ -0,0 +1,9 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    addModel: (type: string) => any;
+    importModel: (file: File) => any;
+}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{
+    onAddModel?: ((type: string) => any) | undefined;
+    onImportModel?: ((file: File) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/TreeItem.vue.d.ts

@@ -0,0 +1,18 @@
+import { Object3D } from 'three';
+type __VLS_Props = {
+    /** 当前节点对应的 Three.js 物体 */
+    node: Object3D;
+    /** 当前选中的物体（外部传入） */
+    selectedObject: Object3D | null;
+    /** 版本号，用于强制重新计算子节点列表 */
+    version: number;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    select: (obj: Object3D<import('three').Object3DEventMap>) => any;
+    delete: (obj: Object3D<import('three').Object3DEventMap>) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onSelect?: ((obj: Object3D<import('three').Object3DEventMap>) => any) | undefined;
+    onDelete?: ((obj: Object3D<import('three').Object3DEventMap>) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/composables/useTreeExpand.d.ts

@@ -0,0 +1,10 @@
+import { Ref } from 'vue';
+import { Object3D } from 'three';
+/**
+ * @param selectedObject - 响应式的当前选中物体（Ref）
+ * @returns 包含展开集合和切换方法的对象
+ */
+export declare function useTreeExpand(selectedObject: Ref<Object3D | null>): {
+    expandedSet: Ref<Set<string> & Omit<Set<string>, keyof Set<any>>, Set<string> | (Set<string> & Omit<Set<string>, keyof Set<any>>)>;
+    toggleExpand: (uuid: string) => void;
+};

package/dist/index.d.ts

@@ -1 +1,8 @@
-export {}
+export { default as DrawingBoard } from './components/DrawingBoard.vue';
+export { default as PropertyPanel } from './components/PropertyPanel.vue';
+export { default as TopBar } from './components/TopBar.vue';
+export { default as BottomBar } from './components/BottomBar.vue';
+export { default as TreeItem } from './components/TreeItem.vue';
+export * from './three';
+export * from './three/addHandle';
+export { useTreeExpand } from './composables/useTreeExpand';

package/dist/three/addHandle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 提供添加基础几何体（正方体、球体）以及导入外部模型文件的功能
+ * 所有模型均自动标记为可移动（isMovable = true）
+ */
+import * as THREE from "three";
+/** 添加一个蓝色的正方体，位置在地面上方 0.5 单位 */
+export declare function addBox(): THREE.Mesh<THREE.BoxGeometry, THREE.MeshStandardMaterial, THREE.Object3DEventMap>;
+/** 添加一个橙色的球体，位置在地面上方 0.6 单位 */
+export declare function addSphere(): THREE.Mesh<THREE.SphereGeometry, THREE.MeshStandardMaterial, THREE.Object3DEventMap>;
+/**
+ * 从 File 对象导入 3D 模型（支持 .obj, .gltf, .glb）
+ * 导入后自动标记所有节点为可移动，并居中放置
+ * @param file - 模型文件
+ * @returns Promise 解析为模型根对象
+ */
+export declare function importModelFromFile(file: File): Promise<THREE.Object3D>;
+/**
+ * 根据类型字符串添加对应的基础模型
+ * @param type - 'box' 或 'sphere'
+ */
+export declare function addModelByType(type: string): void;

package/dist/three/index.d.ts

@@ -0,0 +1,57 @@
+import { Object3D } from 'three';
+import { SelectedChangeCallback, TransformChangeCallback, SceneObjectsChangeCallback } from './types';
+/**
+ * 3D 模型编辑器核心模块
+ * 提供场景管理、物体增删、选中/变换控制、树形数据同步等功能
+ * 采用单例模式管理所有 Three.js 相关状态
+ */
+import * as THREE from "three";
+/**
+ * 初始化编辑器，挂载到指定 DOM 容器
+ * @param container - 编辑器挂载的 DOM 元素
+ */
+export declare function initEditor(container: HTMLElement): void;
+/**
+ * 选中场景中的一个物体，将其附着到变换控制器并显示平移轴
+ * @param obj - 要选中的物体
+ */
+export declare function selectObject(obj: Object3D): void;
+/**
+ * 向场景添加一个模型（Object3D 及其子节点）
+ * @param model - 要添加的模型对象
+ * @param selected - 是否添加后立即选中
+ */
+export declare function addModel(model: Object3D, selected?: boolean): void;
+/**
+ * 从场景中移除一个模型及其子节点
+ * @param model - 要移除的模型对象
+ */
+export declare function removeModel(model: Object3D): void;
+/**
+ * 根据 UUID 删除场景中的物体
+ * @param uuid - 物体的唯一标识符
+ */
+export declare function removeModelById(uuid: string): void;
+/**
+ * 注册选中物体变化的回调
+ * @param cb - 回调函数，参数为当前选中的物体或 null
+ */
+export declare function setSelectedObjectCallback(cb: SelectedChangeCallback): void;
+/**
+ * 注册变换过程中（拖拽）的回调
+ * @param cb - 回调函数，参数为正在变换的物体
+ */
+export declare function setTransformChangeCallback(cb: TransformChangeCallback): void;
+/**
+ * 注册场景物体列表变化的回调
+ * @param cb - 回调函数，参数为当前顶层物体列表
+ */
+export declare function onSceneObjectsChangeCallback(cb: SceneObjectsChangeCallback): void;
+/**
+ * 获取当前顶层物体列表
+ * @returns 顶层物体数组
+ */
+export declare function getSceneObjects(): THREE.Object3D<THREE.Object3DEventMap>[];
+export declare function getScene(): THREE.Scene<THREE.Object3DEventMap> | null;
+export declare function getCamera(): THREE.PerspectiveCamera | null;
+export declare function getRenderer(): THREE.WebGLRenderer | null;

package/dist/three/types.d.ts

@@ -0,0 +1,7 @@
+import { Object3D } from 'three';
+/** 选中对象变化时的回调函数类型 */
+export type SelectedChangeCallback = (obj: Object3D | null) => void;
+/** 变换过程中（拖拽时）的回调函数类型 */
+export type TransformChangeCallback = (obj: Object3D) => void;
+/** 场景物体列表变化时的回调函数类型 */
+export type SceneObjectsChangeCallback = (objects: Object3D[]) => void;

package/dist/views/Home.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import('vue').DefineComponent<{}, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "endset_three_editor",
   "private": false,
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A 3D model editor built with Three.js and Vue 3",
   "type": "module",
   "main": "dist/three-editor.cjs.js",