gl-draw 0.18.15 → 0.18.17

package/dist/index.d.ts

@@ -99,7 +99,9 @@ export declare class AmbientLightObject extends BaseObject<AmbientLight> {
     constructor(lightOrColor?: AmbientLight | string | number, intensity?: number);
 }
 
-declare function analyzeSceneJsonSize(sceneJson: any): void;
+declare const _analysisCategoryKeys: readonly ["geometries", "materials", "textures", "images"];
+
+declare function analyzeSceneExport(sceneJson: any, exportReport?: SceneExportReport): SceneJsonSizeAnalysis;
 
 declare function applyTextureColorSpace({ node, material, texture, }: ColorCorrectionOptions): void;
 
@@ -1721,6 +1723,13 @@ declare class EventDispatcher {
     dispatchEvent(event: DispatcherEvent): void;
 }
 
+declare interface ExportBaseObjectOptions {
+    checkTextures?: boolean;
+    includeHiddenChildren?: boolean;
+    includeUnusedUnlockedMListMaterials?: boolean;
+    includeAnalysisMeta?: boolean;
+}
+
 /**
  * Custom ExtrudeGeometry extending Three.js ExtrudeGeometry.
  */
@@ -1910,7 +1919,7 @@ export declare class Lead extends Pick_2 {
     setSize(width: number, height: number): void;
     eraseAll(): void;
     private _serializer;
-    exportBaseObject(...args: Parameters<SceneSerializer['exportBaseObject']>): string;
+    exportBaseObject(...args: Parameters<SceneSerializer['exportBaseObject']>): Object3DJSON;
     restoreBaseObject(...args: Parameters<SceneSerializer['restoreBaseObject']>): Promise<BaseObject<Object3D<Object3DEventMap>>>;
     dispose(): void;
 }
@@ -2190,10 +2199,13 @@ declare class MList {
     pencil: Pencil;
     private materials;
     fixBaseObjects: Map<string, BaseObject>;
+    private lockedKeys;
     private materialBaseObjectMap;
     private static _emptyGeometry;
     constructor(pencil: Pencil);
-    add(key: string, material: Material): void;
+    add(key: string, material: Material, ops?: {
+        locked?: boolean;
+    }): void;
     get(key: string): Material | undefined;
     getByName(name: string): Material | undefined;
     getKey(material: Material): string | undefined;
@@ -2213,6 +2225,12 @@ declare class MList {
     addBaseObjectMap(object: BaseObject): void;
     rmBaseObjectMap(object: BaseObject, targetMaterial?: Material | Material[]): void;
     getBaseObjectMap(material: Material): Set<BaseObject<Object3D<Object3DEventMap>>>;
+    setLocked(key: string, locked?: boolean): boolean;
+    lock(key: string): boolean;
+    unlock(key: string): boolean;
+    isLocked(key: string): boolean;
+    isMaterialUsed(key: string): boolean;
+    shouldExportFixBaseObject(key: string, includeUnusedUnlockedMaterials?: boolean): boolean;
     syncChangeMaterial(oldMaterial: Material, material: Material): void;
     dispose(): void;
 }
@@ -2837,6 +2855,155 @@ declare class ScanEffect_2 {
     stop(): void;
 }
 
+declare interface SceneExportReasonStat {
+    code: SceneExportSkipReasonCode;
+    label: string;
+    count: number;
+}
+
+declare interface SceneExportReport {
+    generatedAt: string;
+    summary: {
+        skippedCount: number;
+        skippedObjectCount: number;
+        skippedMaterialCount: number;
+        lockRequiredMaterialCount: number;
+        reasonStats: SceneExportReasonStat[];
+    };
+    objects: SceneExportSkippedObjectReportItem[];
+    materials: SceneExportSkippedMaterialReportItem[];
+    items: SceneExportSkippedReportItem[];
+}
+
+declare interface SceneExportReportAction {
+    type: 'lock-material';
+    label: string;
+    hint: string;
+    key: string;
+    command: string;
+}
+
+declare interface SceneExportReportViewCard {
+    key: string;
+    label: string;
+    value: number;
+    tone?: 'default' | 'warning';
+}
+
+declare interface SceneExportReportViewItem {
+    id: string;
+    title: string;
+    subtitle?: string;
+    reasonLabel: string;
+    reasonDetail: string;
+    tags: string[];
+    action?: SceneExportSkippedReportItem['action'];
+}
+
+declare interface SceneExportReportViewModel {
+    cards: SceneExportReportViewCard[];
+    sections: SceneExportReportViewSection[];
+}
+
+declare interface SceneExportReportViewSection {
+    key: 'objects' | 'materials';
+    title: string;
+    emptyText: string;
+    count: number;
+    items: SceneExportReportViewItem[];
+}
+
+declare interface SceneExportSkippedMaterialReportItem extends SceneExportSkippedReportItemBase {
+    category: 'material';
+    name: string;
+    locked: boolean;
+    used: boolean;
+}
+
+declare interface SceneExportSkippedObjectReportItem extends SceneExportSkippedReportItemBase {
+    category: 'object';
+    name: string;
+    objectType: string;
+    hiddenBy?: {
+        key: string;
+        title: string;
+    };
+}
+
+declare type SceneExportSkippedReportItem = SceneExportSkippedObjectReportItem | SceneExportSkippedMaterialReportItem;
+
+declare interface SceneExportSkippedReportItemBase {
+    id: string;
+    category: 'object' | 'material';
+    key: string;
+    title: string;
+    subtitle?: string;
+    reasonCode: SceneExportSkipReasonCode;
+    reasonLabel: string;
+    reasonDetail: string;
+    action?: SceneExportReportAction;
+}
+
+declare type SceneExportSkipReasonCode = 'node-object' | 'select-hide' | 'hidden-self' | 'hidden-parent' | 'unused-unlocked-material';
+
+declare type SceneJsonAnalysisCategoryKey = (typeof _analysisCategoryKeys)[number];
+
+declare interface SceneJsonAnalysisCategorySummary {
+    key: SceneJsonAnalysisCategoryKey;
+    label: string;
+    count: number;
+    size: SceneJsonSizeInfo;
+    topItems: SceneJsonAnalysisCategoryTopItem[];
+}
+
+declare interface SceneJsonAnalysisCategoryTopItem {
+    uuid: string;
+    type?: string;
+    name?: string;
+    usedBy: string;
+    size: SceneJsonSizeInfo;
+}
+
+declare interface SceneJsonAnalysisEmptyImage {
+    uuid: string;
+    usedBy: string;
+}
+
+declare interface SceneJsonAnalysisExportReportSummary {
+    summary: SceneExportReport['summary'];
+    viewModel: SceneExportReportViewModel;
+}
+
+declare interface SceneJsonAnalysisObjectGraphSummary {
+    structureSize: SceneJsonSizeInfo;
+    options?: SceneJsonAnalysisObjectOptionsSummary;
+}
+
+declare interface SceneJsonAnalysisObjectOptionItem {
+    key: string;
+    type: string;
+    size: SceneJsonSizeInfo;
+}
+
+declare interface SceneJsonAnalysisObjectOptionsSummary {
+    totalSize: SceneJsonSizeInfo;
+    sharedRefCount: number;
+    topItems: SceneJsonAnalysisObjectOptionItem[];
+}
+
+declare interface SceneJsonAnalysisSharedOptionsEntry {
+    index: number;
+    size: SceneJsonSizeInfo;
+}
+
+declare interface SceneJsonAnalysisSharedOptionsPool {
+    count: number;
+    size: SceneJsonSizeInfo;
+    topEntries: SceneJsonAnalysisSharedOptionsEntry[];
+    totalReferences: number;
+    duplicatesEliminated: number;
+}
+
 /**
  * 场景 JSON 引用回溯工具
  * 从 sceneJson 中构建 uuid -> 可读路径 的映射表
@@ -2862,6 +3029,20 @@ declare class SceneJsonRefTracer {
     private _traceTextures;
 }
 
+declare interface SceneJsonSizeAnalysis {
+    total: SceneJsonSizeInfo;
+    exportReport?: SceneJsonAnalysisExportReportSummary;
+    emptyUrlImages: SceneJsonAnalysisEmptyImage[];
+    categories: SceneJsonAnalysisCategorySummary[];
+    sharedOptionsPool?: SceneJsonAnalysisSharedOptionsPool;
+    objectGraph?: SceneJsonAnalysisObjectGraphSummary;
+}
+
+declare interface SceneJsonSizeInfo {
+    bytes: number;
+    mbStr: string;
+}
+
 declare class ScenePages extends OrigonPages<Scene> {
     options: Options_4;
     get scene(): Scene<Object3DEventMap>;
@@ -2883,12 +3064,11 @@ declare class SceneSerializer {
     private get prefabGroup();
     private get mList();
     private get objects();
-    exportCompressBaseObject(root: BaseObject, { checkTextures }?: {
-        checkTextures?: boolean;
-    }): Promise<ArrayBuffer>;
-    exportBaseObject(root: BaseObject, { checkTextures }?: {
-        checkTextures?: boolean;
-    }): string;
+    exportCompressBaseObject(root: BaseObject, options?: ExportBaseObjectOptions): Promise<ArrayBuffer>;
+    exportBaseObject(root: BaseObject, { checkTextures, includeHiddenChildren, includeUnusedUnlockedMListMaterials, includeAnalysisMeta, }?: ExportBaseObjectOptions): Object3DJSON;
+    private _getSkippedObjectReportItem;
+    private _findHiddenAncestor;
+    private _getBaseObjectTitle;
     restoreBaseObject(target: BaseObject, data: string | ArrayBuffer | Object3DJSON, registry?: Record<string, new (...args: any[]) => any>, roomEnvMap?: any, createIfNeeded?: boolean): Promise<BaseObject<Object3D<Object3DEventMap>>>;
     private _restoreFixBaseObjects;
     private _eraseNonCoreObjects;
@@ -2899,6 +3079,15 @@ declare class SceneSerializer {
      * 根据 objectType 和 registry 创建 BaseObject 实例
      */
     private _createInstance;
+    /**
+     * 还原前克隆输入，避免修改调用方持有的数据对象。
+     * 如果 structuredClone 失败，会输出首个不可复制的属性路径。
+     */
+    private _cloneRestoreInput;
+    private _findStructuredCloneFailure;
+    private _appendClonePath;
+    private _cloneObject3dUserData;
+    private _normalizeStructuredCloneInput;
     /**
      * 安全地克隆 options，过滤掉不可序列化的 Three.js 对象
      */
@@ -3058,7 +3247,7 @@ declare class UseMaterial extends PointerEvent_2 {
 
 export declare const utils: {
     applyTextureColorSpace: typeof applyTextureColorSpace;
-    analyzeSceneJsonSize: typeof analyzeSceneJsonSize;
+    analyzeSceneExport: typeof analyzeSceneExport;
     CacheManager: typeof CacheManager;
     cartographicToCartesian: typeof cartographicToCartesian;
     WGS84: {