customforge 0.1.0-alpha.2 → 0.1.0

package/dist/viewer/ProductViewer.d.ts

@@ -1,5 +1,8 @@
 import { type CanvasTexture } from 'three';
 import type { NormalizedProductConfiguration } from '../core/config';
+import type { ProductViewState, ViewerAppearance } from '../core/types';
+import type { UvLayout } from '../core/uv';
+type ViewChangeListener = (state: ProductViewState) => void;
 /**
  * 基于 Three.js 的三维产品查看器
  *
@@ -18,17 +21,22 @@ export declare class ProductViewer {
     private surface?;
     private texture?;
     private animationFrame;
+    private readonly viewChangeListeners;
+    private readonly handleControlsChange;
     /**
      * @param host 三维查看器挂载容器
+     * @param ariaLabel 三维产品画布的无障碍名称
+     * @param appearance WebGL 画布清屏颜色等外观配置
      */
-    constructor(host: HTMLElement);
+    constructor(host: HTMLElement, ariaLabel?: string, appearance?: ViewerAppearance);
     /**
-     * 加载远程模型或创建内置演示模型
+     * 加载远程模型或随包提供的默认 GLB 模型
      *
      * @param product 已完成默认值补全的产品配置
-     * @throws 模型加载失败或找不到目标 Mesh 时抛出错误
+     * @returns 目标 Mesh 第一个材质槽使用的 UV 三角形布局
+     * @throws 模型加载失败、找不到目标 Mesh 或目标 Mesh 缺少有效 UV 时抛出错误
      */
-    loadProduct(product: NormalizedProductConfiguration): Promise<void>;
+    loadProduct(product: NormalizedProductConfiguration): Promise<UvLayout>;
     /**
      * 保存并绑定二维编辑器生成的实时纹理
      *
@@ -39,10 +47,29 @@ export declare class ProductViewer {
     setTexture(texture: CanvasTexture): void;
     /** 根据当前模型包围盒恢复默认相机位置 */
     resetView(): void;
+    /** 返回当前相机位置和轨道控制目标点的独立快照 */
+    getViewState(): ProductViewState;
+    /**
+     * 恢复相机位置和轨道控制目标点
+     *
+     * @param state 要恢复的三维观察视角
+     * @returns 应用后的独立视角快照
+     * @throws 坐标不是有限数值或相机与目标点重合时抛出错误
+     */
+    setViewState(state: ProductViewState): ProductViewState;
+    /**
+     * 订阅三维视角变化
+     *
+     * 用户旋转、缩放、平移以及 API 恢复视角时都会触发
+     *
+     * @param listener 接收独立视角快照的监听函数
+     * @returns 用于取消本次订阅的函数
+     */
+    onViewChange(listener: ViewChangeListener): () => void;
     /** 释放动画帧、相机控制、模型材质和 WebGLRenderer */
     destroy(): void;
-    private addEnvironment;
-    private createDemoProduct;
+    private addStudioLighting;
+    private prepareBundledProduct;
     /**
      * 按名称查找接收实时纹理的 Mesh
      *
@@ -56,9 +83,13 @@ export declare class ProductViewer {
      */
     private attachTexture;
     private fitCamera;
+    private defaultCameraDirection;
+    private vectorToValue;
+    private validateViewState;
     private removeProduct;
     private resize;
     private render;
     private markRenderState;
 }
+export {};
 //# sourceMappingURL=ProductViewer.d.ts.map

package/dist/viewer/ProductViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProductViewer.d.ts","sourceRoot":"","sources":["../../src/viewer/ProductViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAoBL,KAAK,aAAa,EAEnB,MAAM,OAAO,CAAA;AAGd,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AAEpE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,WAAW,CAAC,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,cAAc,CAAI;IAE1B;;OAEG;IACH,YAAY,IAAI,EAAE,WAAW,EA6B5B;IAED;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBxE;IAED;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAKvC;IAED,wBAAwB;IACxB,SAAS,IAAI,IAAI,CAIhB;IAED,qCAAqC;IACrC,OAAO,IAAI,IAAI,CAOd;IAED,OAAO,CAAC,cAAc;IAuBtB,OAAO,CAAC,iBAAiB;IA4CzB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,SAAS;IAejB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,MAAM;IAQd,OAAO,CAAC,MAAM,CAKb;IAED,OAAO,CAAC,eAAe;CAqCxB"}
+{"version":3,"file":"ProductViewer.d.ts","sourceRoot":"","sources":["../../src/viewer/ProductViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAcL,KAAK,aAAa,EAEnB,MAAM,OAAO,CAAA;AAGd,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAW1C,KAAK,kBAAkB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;AAE3D;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,WAAW,CAAC,CAAU;IAC9B,OAAO,CAAC,OAAO,CAAC,CAAM;IACtB,OAAO,CAAC,OAAO,CAAC,CAAe;IAC/B,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgC;IACpE,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGpC;IAED;;;;OAIG;IACH,YACE,IAAI,EAAE,WAAW,EACjB,SAAS,SAAmC,EAC5C,UAAU,GAAE,gBAAqB,EAgClC;IAED;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,8BAA8B,GAAG,OAAO,CAAC,QAAQ,CAAC,CA0B5E;IAED;;;;;;OAMG;IACH,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAKvC;IAED,wBAAwB;IACxB,SAAS,IAAI,IAAI,CAIhB;IAED,4BAA4B;IAC5B,YAAY,IAAI,gBAAgB,CAK/B;IAED;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,gBAAgB,GAAG,gBAAgB,CAWtD;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,QAAQ,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAGrD;IAED,qCAAqC;IACrC,OAAO,IAAI,IAAI,CASd;IAED,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,qBAAqB;IA8B7B;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAQnB;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAyBrB,OAAO,CAAC,SAAS;IAmDjB,OAAO,CAAC,sBAAsB;IAS9B,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,aAAa;IAoBrB,OAAO,CAAC,MAAM;IAad,OAAO,CAAC,MAAM,CAKb;IAED,OAAO,CAAC,eAAe;CAqCxB"}

package/dist/viewer/uvLayout.d.ts

@@ -0,0 +1,11 @@
+import { Mesh } from 'three';
+import type { UvLayout } from '../core/uv';
+/**
+ * 提取目标 Mesh 第一个材质槽使用的 UV 三角形
+ *
+ * @param mesh 接收实时纹理的目标 Mesh
+ * @returns 保持模型原始 V 方向的 UV 三角形和外边界布局
+ * @throws Mesh 缺少 UV、面数据无效或第一个材质槽没有三角形时抛出错误
+ */
+export declare function extractUvLayout(mesh: Mesh): UvLayout;
+//# sourceMappingURL=uvLayout.d.ts.map

package/dist/viewer/uvLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uvLayout.d.ts","sourceRoot":"","sources":["../../src/viewer/uvLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAA;AAC5B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AA0D1C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,QAAQ,CAqDpD"}

package/dist/workbench/CustomForgeWorkbench.d.ts

@@ -1,5 +1,5 @@
-import { ProductCustomizer } from '../customizer/ProductCustomizer';
-import type { WorkbenchFeatureName, WorkbenchLayoutName, WorkbenchOptions, WorkbenchStatusMode } from './types';
+import type { ProductCustomizerApi } from '../core/api';
+import type { CustomForgeWorkbenchApi, WorkbenchExtensionButton, WorkbenchFeatureName, WorkbenchFeatures, WorkbenchLayout, WorkbenchLayoutName, WorkbenchOptions, WorkbenchStatusMode, WorkbenchTheme } from './types';
 /**
  * 提供可配置默认界面的产品定制工作台
  *
@@ -7,9 +7,9 @@ import type { WorkbenchFeatureName, WorkbenchLayoutName, WorkbenchOptions, Workb
  * 底层 ProductCustomizer 仍通过 customizer 属性提供完整公共 API
  * 不再使用实例时必须调用 destroy
  */
-export declare class CustomForgeWorkbench {
+export declare class CustomForgeWorkbench implements CustomForgeWorkbenchApi {
     /** Workbench 使用的底层无界面定制器 */
-    readonly customizer: ProductCustomizer;
+    readonly customizer: ProductCustomizerApi;
     /** Workbench 根元素 */
     readonly element: HTMLElement;
     private readonly host;
@@ -18,32 +18,51 @@ export declare class CustomForgeWorkbench {
     private readonly unsubscribe;
     private readonly features;
     private readonly layout;
+    private theme;
     private readonly labels;
     private readonly icons;
     private readonly textPresets;
+    private readonly fontFamilies;
     private readonly backgrounds;
     private readonly elements;
+    private readonly extensions;
+    private readonly pendingExtensions;
+    private readonly formatError;
     private readonly layerList;
     private readonly deleteButton;
     private readonly undoButton;
     private readonly redoButton;
+    private readonly layersToggle;
     private readonly statusLabel;
-    private readonly objectCountLabel;
     private readonly imageInput;
     private readonly designInput;
     private readonly loadDesignButton;
     private readonly textDialog;
     private readonly textForm;
+    private readonly textToolbar;
+    private readonly imageToolbar;
+    private readonly textOptions;
+    private readonly textFontFamily;
+    private readonly textFontSize;
+    private readonly textColor;
+    private readonly textBackgroundColor;
+    private readonly textLineHeight;
+    private readonly textLetterSpacing;
     private readonly imageDialog;
     private readonly imageForm;
     private readonly imageSubmitButton;
     private readonly productDialog;
     private readonly remoteForm;
     private readonly submitProductButton;
+    private readonly modelFileInput;
+    private readonly modelUrlInput;
     private selectedObjectIds;
     private selectedTextPresetId?;
     private selectedImage?;
     private activeImageTab;
+    private productSourceMode;
+    private activeProductObjectUrl?;
+    private layersExpanded;
     private layerSignature;
     private draggedObjectId?;
     private destroyed;
@@ -56,6 +75,8 @@ export declare class CustomForgeWorkbench {
      * @throws 挂载容器无效或产品初始化失败时清理已创建界面并继续抛出错误
      */
     static create(options: WorkbenchOptions): Promise<CustomForgeWorkbench>;
+    /** 返回当前默认功能控件开关的独立快照 */
+    getFeatures(): WorkbenchFeatures;
     /**
      * 在运行时显示或隐藏某项内置功能控件
      *
@@ -65,6 +86,8 @@ export declare class CustomForgeWorkbench {
      * @param enabled 是否显示并启用对应控件
      */
     setFeature(feature: WorkbenchFeatureName, enabled: boolean): void;
+    /** 返回当前默认布局区域开关的独立快照 */
+    getLayout(): WorkbenchLayout;
     /**
      * 在运行时显示或隐藏 Workbench 布局区域
      *
@@ -72,8 +95,31 @@ export declare class CustomForgeWorkbench {
      * @param visible 是否显示该区域
      */
     setLayout(section: WorkbenchLayoutName, visible: boolean): void;
+    /** 返回当前完整主题的独立快照 */
+    getTheme(): WorkbenchTheme;
     /**
-     * 更新底部状态栏内容
+     * 合并并立即应用当前 Workbench 实例的主题变量
+     *
+     * @param theme 要覆盖的主题字段
+     * @returns 合并后的完整主题独立快照
+     */
+    setTheme(theme: Partial<WorkbenchTheme>): WorkbenchTheme;
+    /** 返回当前已注册扩展按钮的独立配置快照 */
+    getExtensions(): WorkbenchExtensionButton[];
+    /**
+     * 注册扩展按钮并立即渲染到声明位置
+     *
+     * @param extension 扩展按钮配置
+     * @returns 仅在该注册仍为当前同 ID 项时将其移除的清理函数
+     * @throws ID、位置、文案、图标或回调配置无效以及 ID 重复时抛出错误
+     */
+    registerExtension(extension: WorkbenchExtensionButton): () => void;
+    /** 按稳定 ID 移除扩展按钮并返回是否存在该注册 */
+    removeExtension(id: string): boolean;
+    /** 使用最新核心状态重新计算所有扩展按钮 */
+    refreshExtensions(): void;
+    /**
+     * 更新三维预览区域内的运行状态
      *
      * @param message 状态文字
      * @param mode 状态样式，默认为 ready
@@ -85,18 +131,44 @@ export declare class CustomForgeWorkbench {
     private handleRootClick;
     private handleHistoryShortcut;
     private handleImageTabShortcut;
+    private extensionSlot;
+    private extensionsAt;
+    private renderExtensionSlots;
+    private renderRegisteredExtensions;
+    private createExtensionButton;
+    private resolveExtensionPredicate;
+    private extensionExecutionKey;
+    private updateLayerActionWidths;
+    private runExtension;
     private action;
     private showDialog;
     private closeDialog;
     private clearDialogClose;
     private applyVisibility;
+    private updateRegionVisibility;
     private toolGroup;
     private updateObjectCount;
+    private toggleLayers;
     private updateHistoryButtons;
     private localizeStatus;
     private runHistory;
     private saveDesign;
-    private exportTexture;
+    private renderTextFontOptions;
+    private ensureTextFontOption;
+    private selectedTextObjects;
+    private selectedImageObject;
+    private updateImageToolbar;
+    private setSelectedImageAsBackground;
+    private commonTextValue;
+    private updateTextToolbar;
+    private setNumberControl;
+    private setColorControl;
+    private renderTextColorPresets;
+    private updateTextColorPresetState;
+    private setPressedState;
+    private updateSelectedText;
+    private toggleSelectedTextStyle;
+    private toggleSelectedTextBackground;
     private renderLayers;
     private createLayerItem;
     private createLayerButton;
@@ -122,7 +194,12 @@ export declare class CustomForgeWorkbench {
     private resetImageSelection;
     private releaseImageSelection;
     private loadSelectedDesign;
+    private setProductSourceMode;
+    private updateSelectedProductFile;
+    private validateProductForm;
+    private setProductLoading;
+    private replaceActiveProductObjectUrl;
     private loadDemoProduct;
-    private loadRemoteProduct;
+    private loadProductFromDialog;
 }
 //# sourceMappingURL=CustomForgeWorkbench.d.ts.map

package/dist/workbench/CustomForgeWorkbench.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CustomForgeWorkbench.d.ts","sourceRoot":"","sources":["../../src/workbench/CustomForgeWorkbench.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CustomForgeWorkbench.d.ts","sourceRoot":"","sources":["../../src/workbench/CustomForgeWorkbench.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAkBvD,OAAO,KAAK,EACV,uBAAuB,EAGvB,wBAAwB,EAGxB,oBAAoB,EACpB,iBAAiB,EAGjB,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EAEnB,cAAc,EACf,MAAM,SAAS,CAAA;AAqIhB;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,uBAAuB;IAClE,4BAA4B;IAC5B,QAAQ,CAAC,UAAU,EAAE,oBAAoB,CAAA;IAEzC,oBAAoB;IACpB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAE7B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAuC;IACzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsC;IAC5D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAuB;IACnD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA4C;IACzE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGxB;IACH,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAG/B;IACH,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA2C;IACvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAmB;IAC9C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAa;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAa;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAoB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAkB;IACtD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAkB;IACpD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmB;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAmB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAmB;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkB;IAChD,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,oBAAoB,CAAC,CAAQ;IACrC,OAAO,CAAC,aAAa,CAAC,CAAe;IACrC,OAAO,CAAC,cAAc,CAAqB;IAC3C,OAAO,CAAC,iBAAiB,CAA4B;IACrD,OAAO,CAAC,sBAAsB,CAAC,CAAQ;IACvC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,eAAe,CAAC,CAAQ;IAChC,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,eAwEN;IAED;;;;;;OAMG;IACH,OAAa,MAAM,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoC5E;IAED,wBAAwB;IACxB,WAAW,IAAI,iBAAiB,CAE/B;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,OAAO,EAAE,oBAAoB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAqBhE;IAED,wBAAwB;IACxB,SAAS,IAAI,eAAe,CAE3B;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAK9D;IAED,oBAAoB;IACpB,QAAQ,IAAI,cAAc,CAEzB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAKvD;IAED,yBAAyB;IACzB,aAAa,IAAI,wBAAwB,EAAE,CAK1C;IAED;;;;;;OAMG;IACH,iBAAiB,CAAC,SAAS,EAAE,wBAAwB,GAAG,MAAM,IAAI,CAYjE;IAED,8BAA8B;IAC9B,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAcnC;IAED,yBAAyB;IACzB,iBAAiB,IAAI,IAAI,CAyDxB;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,mBAA6B,GAAG,IAAI,CAIpE;IAED,qCAAqC;IACrC,OAAO,IAAI,IAAI,CAed;IAED,OAAO,CAAC,UAAU;IAkNlB,OAAO,CAAC,eAAe;IAiIvB,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,0BAA0B;IAKlC,OAAO,CAAC,qBAAqB;IA+C7B,OAAO,CAAC,yBAAyB;IAejC,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,uBAAuB;YAyBjB,YAAY;IAiE1B,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,eAAe;IA6CvB,OAAO,CAAC,sBAAsB;IAkC9B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,iBAAiB;IASzB,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,oBAAoB;IAK5B,OAAO,CAAC,cAAc;YAoBR,UAAU;IAgCxB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,qBAAqB;IA0B7B,OAAO,CAAC,oBAAoB;IAe5B,OAAO,CAAC,mBAAmB;IAgB3B,OAAO,CAAC,mBAAmB;IAa3B,OAAO,CAAC,kBAAkB;IAW1B,OAAO,CAAC,4BAA4B;IAQpC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,iBAAiB;IAkFzB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,eAAe;IAgBvB,OAAO,CAAC,sBAAsB;IAoB9B,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,eAAe;IAUvB,OAAO,CAAC,kBAAkB;IAc1B,OAAO,CAAC,uBAAuB;IAyB/B,OAAO,CAAC,4BAA4B;IAWpC,OAAO,CAAC,YAAY;IAoCpB,OAAO,CAAC,eAAe;IAiGvB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,iBAAiB;IAkCzB,OAAO,CAAC,iBAAiB;IAmDzB,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,oBAAoB;IAkB5B,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,kBAAkB;IAqB1B,OAAO,CAAC,iBAAiB;IAkCzB,OAAO,CAAC,kBAAkB;IAK1B,OAAO,CAAC,gBAAgB;IAiCxB,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,WAAW;IAyBnB,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,iBAAiB;YAgBX,kBAAkB;IAuBhC,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,qBAAqB;YAMf,kBAAkB;IAmBhC,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,yBAAyB;IAejC,OAAO,CAAC,mBAAmB;IAgC3B,OAAO,CAAC,iBAAiB;IAazB,OAAO,CAAC,6BAA6B;YAOvB,eAAe;YAef,qBAAqB;CA2CpC"}

package/dist/workbench/config.d.ts

@@ -1,4 +1,4 @@
-import type { WorkbenchAsset, WorkbenchFeatures, WorkbenchIconConfiguration, WorkbenchLabels, WorkbenchLayout, WorkbenchOptions, WorkbenchTextPreset, WorkbenchTheme } from './types';
+import type { WorkbenchAsset, WorkbenchExtensionButton, WorkbenchExtensionPredicate, WorkbenchExtensionVariant, WorkbenchFeatures, WorkbenchFontFamily, WorkbenchIconConfiguration, WorkbenchLabels, WorkbenchLayout, WorkbenchOptions, WorkbenchTextPreset, WorkbenchTheme } from './types';
 /** Workbench 内部使用的完整品牌配置 */
 export interface NormalizedWorkbenchBranding {
     /** 品牌 Logo 地址 */
@@ -18,6 +18,8 @@ export interface NormalizedWorkbenchBranding {
 }
 /** Workbench 内部使用的完整配置 */
 export interface NormalizedWorkbenchOptions {
+    /** 添加到 Workbench 根元素的 CSS 类名 */
+    classNames: string[];
     /** 二维编辑画布的逻辑宽度 */
     editorWidth: number;
     /** 二维编辑画布的逻辑高度 */
@@ -26,6 +28,8 @@ export interface NormalizedWorkbenchOptions {
     historyLimit: number;
     /** 初始化产品配置 */
     product: WorkbenchOptions['product'];
+    /** 二维编辑器与三维查看器外观配置 */
+    appearance: WorkbenchOptions['appearance'];
     /** 完整功能开关 */
     features: WorkbenchFeatures;
     /** 完整布局开关 */
@@ -40,11 +44,48 @@ export interface NormalizedWorkbenchOptions {
     icons: Required<WorkbenchIconConfiguration>;
     /** 可用文字排版预设 */
     textPresets: WorkbenchTextPreset[];
+    /** 字体选择器条目 */
+    fontFamilies: WorkbenchFontFamily[];
     /** 可用背景素材 */
     backgrounds: WorkbenchAsset[];
     /** 可用装饰元素 */
     elements: WorkbenchAsset[];
+    /** 完成校验和默认值补全的扩展按钮 */
+    extensions: NormalizedWorkbenchExtensionButton[];
+    /** 用户可见异常文案格式化函数 */
+    formatError: NonNullable<WorkbenchOptions['formatError']>;
 }
+/** Workbench 内部使用的完整扩展按钮配置 */
+export interface NormalizedWorkbenchExtensionButton extends Omit<WorkbenchExtensionButton, 'className' | 'iconUrl' | 'showLabel' | 'variant' | 'order' | 'visible' | 'disabled'> {
+    /** 清理空白后的可选图标地址 */
+    iconUrl?: string;
+    /** 是否在图标旁显示文案 */
+    showLabel: boolean;
+    /** 按钮视觉语义 */
+    variant: WorkbenchExtensionVariant;
+    /** 同一位置内的升序排列值 */
+    order: number;
+    /** 添加到按钮元素的宿主 CSS 类名 */
+    classNames: string[];
+    /** 固定或动态可见条件 */
+    visible: boolean | WorkbenchExtensionPredicate;
+    /** 固定或动态禁用条件 */
+    disabled: boolean | WorkbenchExtensionPredicate;
+}
+/**
+ * 校验并补全单个 Workbench 扩展按钮配置
+ *
+ * @param extension 外部扩展按钮配置
+ * @returns 可直接渲染的内部配置
+ */
+export declare function normalizeWorkbenchExtension(extension: WorkbenchExtensionButton): NormalizedWorkbenchExtensionButton;
+/**
+ * 校验 Workbench 扩展按钮集合并拒绝重复 ID
+ *
+ * @param extensions 外部扩展按钮集合
+ * @returns 保持声明顺序的完整内部配置
+ */
+export declare function normalizeWorkbenchExtensions(extensions: readonly WorkbenchExtensionButton[]): NormalizedWorkbenchExtensionButton[];
 /**
  * 补全并校验 Workbench 默认配置
  *

package/dist/workbench/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/workbench/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,cAAc,EAEd,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,cAAc,EACf,MAAM,SAAS,CAAA;AAEhB,4BAA4B;AAC5B,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB;IACjB,OAAO,EAAE,MAAM,CAAA;IAEf,mBAAmB;IACnB,OAAO,EAAE,MAAM,CAAA;IAEf,kBAAkB;IAClB,QAAQ,EAAE,OAAO,CAAA;IAEjB,WAAW;IACX,KAAK,EAAE,MAAM,CAAA;IAEb,eAAe;IACf,SAAS,EAAE,OAAO,CAAA;IAElB,YAAY;IACZ,QAAQ,EAAE,MAAM,CAAA;IAEhB,gBAAgB;IAChB,YAAY,EAAE,OAAO,CAAA;CACtB;AAED,0BAA0B;AAC1B,MAAM,WAAW,0BAA0B;IACzC,kBAAkB;IAClB,WAAW,EAAE,MAAM,CAAA;IAEnB,kBAAkB;IAClB,YAAY,EAAE,MAAM,CAAA;IAEpB,kBAAkB;IAClB,YAAY,EAAE,MAAM,CAAA;IAEpB,cAAc;IACd,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IAEpC,aAAa;IACb,QAAQ,EAAE,iBAAiB,CAAA;IAE3B,aAAa;IACb,MAAM,EAAE,eAAe,CAAA;IAEvB,aAAa;IACb,QAAQ,EAAE,2BAA2B,CAAA;IAErC,aAAa;IACb,MAAM,EAAE,eAAe,CAAA;IAEvB,aAAa;IACb,KAAK,EAAE,cAAc,CAAA;IAErB,aAAa;IACb,KAAK,EAAE,QAAQ,CAAC,0BAA0B,CAAC,CAAA;IAE3C,eAAe;IACf,WAAW,EAAE,mBAAmB,EAAE,CAAA;IAElC,aAAa;IACb,WAAW,EAAE,cAAc,EAAE,CAAA;IAE7B,aAAa;IACb,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC3B;AAyMD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gBAAgB,GACxB,0BAA0B,CAyB5B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/workbench/config.ts"],"names":[],"mappings":"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"}

package/dist/workbench/icons.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/workbench/icons.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,SAAS,CAAA;AAEhB,gCAAgC;AAChC,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAClD,IAAI,CAkEN"}
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../../src/workbench/icons.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EACV,0BAA0B,EAE3B,MAAM,SAAS,CAAA;AAEhB,gCAAgC;AAChC,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,aAAa,EAAE,QAAQ,CAAC,0BAA0B,CAAC,GAClD,IAAI,CA8EN"}

package/dist/workbench/index.d.ts

@@ -1,5 +1,5 @@
 import { CustomForgeWorkbench } from './CustomForgeWorkbench';
-import type { WorkbenchOptions } from './types';
+import type { CustomForgeWorkbenchApi, WorkbenchOptions } from './types';
 /**
  * 创建带默认界面的产品定制工作台
  *
@@ -19,7 +19,7 @@ import type { WorkbenchOptions } from './types';
  * })
  * ```
  */
-export declare function createWorkbench(options: WorkbenchOptions): Promise<CustomForgeWorkbench>;
+export declare function createWorkbench(options: WorkbenchOptions): Promise<CustomForgeWorkbenchApi>;
 export { CustomForgeWorkbench };
-export type { WorkbenchAsset, WorkbenchAssetLibrary, WorkbenchBranding, WorkbenchFeatureName, WorkbenchFeatures, WorkbenchIconConfiguration, WorkbenchIconName, WorkbenchLabels, WorkbenchLayout, WorkbenchLayoutName, WorkbenchOptions, WorkbenchStatusMode, WorkbenchTextPreset, WorkbenchTheme, } from './types';
+export type { CustomForgeWorkbenchApi, WorkbenchAsset, WorkbenchAssetLibrary, WorkbenchBranding, WorkbenchFeatureName, WorkbenchFeatures, WorkbenchErrorFormatter, WorkbenchExtensionAction, WorkbenchExtensionActionContext, WorkbenchExtensionButton, WorkbenchExtensionPlacement, WorkbenchExtensionPredicate, WorkbenchExtensionStateContext, WorkbenchExtensionVariant, WorkbenchFontFamily, WorkbenchIconConfiguration, WorkbenchIconName, WorkbenchLabels, WorkbenchLayout, WorkbenchLayoutName, WorkbenchOptions, WorkbenchStatusMode, WorkbenchTextPreset, WorkbenchTheme, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/workbench/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workbench/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAC/B,YAAY,EACV,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/workbench/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAElC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA;AAC/B,YAAY,EACV,uBAAuB,EACvB,cAAc,EACd,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,uBAAuB,EACvB,wBAAwB,EACxB,+BAA+B,EAC/B,wBAAwB,EACxB,2BAA2B,EAC3B,2BAA2B,EAC3B,8BAA8B,EAC9B,yBAAyB,EACzB,mBAAmB,EACnB,0BAA0B,EAC1B,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,GACf,MAAM,SAAS,CAAA"}

package/dist/workbench/template.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/workbench/template.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,wBAAgB,sBAAsB,IAAI,WAAW,CAyOpD"}
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/workbench/template.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,wBAAgB,sBAAsB,IAAI,WAAW,CAkWpD"}