customforge 0.1.0-alpha.1 → 0.1.0-alpha.2

package/dist/workbench/CustomForgeWorkbench.d.ts

@@ -0,0 +1,128 @@
+import { ProductCustomizer } from '../customizer/ProductCustomizer';
+import type { WorkbenchFeatureName, WorkbenchLayoutName, WorkbenchOptions, WorkbenchStatusMode } from './types';
+/**
+ * 提供可配置默认界面的产品定制工作台
+ *
+ * 功能和布局开关只控制 Workbench 自带界面
+ * 底层 ProductCustomizer 仍通过 customizer 属性提供完整公共 API
+ * 不再使用实例时必须调用 destroy
+ */
+export declare class CustomForgeWorkbench {
+    /** Workbench 使用的底层无界面定制器 */
+    readonly customizer: ProductCustomizer;
+    /** Workbench 根元素 */
+    readonly element: HTMLElement;
+    private readonly host;
+    private readonly abortController;
+    private readonly dialogCloseTimers;
+    private readonly unsubscribe;
+    private readonly features;
+    private readonly layout;
+    private readonly labels;
+    private readonly icons;
+    private readonly textPresets;
+    private readonly backgrounds;
+    private readonly elements;
+    private readonly layerList;
+    private readonly deleteButton;
+    private readonly undoButton;
+    private readonly redoButton;
+    private readonly statusLabel;
+    private readonly objectCountLabel;
+    private readonly imageInput;
+    private readonly designInput;
+    private readonly loadDesignButton;
+    private readonly textDialog;
+    private readonly textForm;
+    private readonly imageDialog;
+    private readonly imageForm;
+    private readonly imageSubmitButton;
+    private readonly productDialog;
+    private readonly remoteForm;
+    private readonly submitProductButton;
+    private selectedObjectIds;
+    private selectedTextPresetId?;
+    private selectedImage?;
+    private activeImageTab;
+    private layerSignature;
+    private draggedObjectId?;
+    private destroyed;
+    private constructor();
+    /**
+     * 创建 Workbench 并完成底层定制器初始化
+     *
+     * @param options 挂载容器、产品资源、功能、外观和素材配置
+     * @returns 初始化完成的 Workbench
+     * @throws 挂载容器无效或产品初始化失败时清理已创建界面并继续抛出错误
+     */
+    static create(options: WorkbenchOptions): Promise<CustomForgeWorkbench>;
+    /**
+     * 在运行时显示或隐藏某项内置功能控件
+     *
+     * 该方法不限制通过 customizer 属性直接调用对应核心 API
+     *
+     * @param feature 功能名称
+     * @param enabled 是否显示并启用对应控件
+     */
+    setFeature(feature: WorkbenchFeatureName, enabled: boolean): void;
+    /**
+     * 在运行时显示或隐藏 Workbench 布局区域
+     *
+     * @param section 布局区域名称
+     * @param visible 是否显示该区域
+     */
+    setLayout(section: WorkbenchLayoutName, visible: boolean): void;
+    /**
+     * 更新底部状态栏内容
+     *
+     * @param message 状态文字
+     * @param mode 状态样式，默认为 ready
+     */
+    setStatus(message: string, mode?: WorkbenchStatusMode): void;
+    /** 释放 DOM 事件、核心实例和 Workbench 挂载内容 */
+    destroy(): void;
+    private bindEvents;
+    private handleRootClick;
+    private handleHistoryShortcut;
+    private handleImageTabShortcut;
+    private action;
+    private showDialog;
+    private closeDialog;
+    private clearDialogClose;
+    private applyVisibility;
+    private toolGroup;
+    private updateObjectCount;
+    private updateHistoryButtons;
+    private localizeStatus;
+    private runHistory;
+    private saveDesign;
+    private exportTexture;
+    private renderLayers;
+    private createLayerItem;
+    private createLayerButton;
+    private handleLayerAction;
+    private handleLayerRename;
+    private moveLayerBy;
+    private handleLayerDragStart;
+    private handleLayerDragOver;
+    private handleLayerDrop;
+    private clearLayerDragState;
+    private renderTextPresets;
+    private openTextDialog;
+    private selectTextPreset;
+    private updateTextPreviews;
+    private addTextFromDialog;
+    private renderAssetPresets;
+    private renderAssetGroup;
+    private openImageDialog;
+    private setImageTab;
+    private selectUploadedImage;
+    private selectPresetAsset;
+    private addImageFromDialog;
+    private resetImageSelection;
+    private releaseImageSelection;
+    private loadSelectedDesign;
+    private loadDemoProduct;
+    private loadRemoteProduct;
+}
+//# sourceMappingURL=CustomForgeWorkbench.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CustomForgeWorkbench.d.ts","sourceRoot":"","sources":["../../src/workbench/CustomForgeWorkbench.ts"],"names":[],"mappings":"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"}

package/dist/workbench/assets/catalog.d.ts

@@ -0,0 +1,8 @@
+import type { WorkbenchAssetLibrary } from '../types';
+/**
+ * Workbench 随包提供的图片素材目录
+ *
+ * 新素材文件应分别放入 backgrounds 或 elements 目录，并在此处使用 import 后注册
+ */
+export declare const builtInAssetLibrary: Required<WorkbenchAssetLibrary>;
+//# sourceMappingURL=catalog.d.ts.map

package/dist/workbench/assets/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/workbench/assets/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAGrD;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,qBAAqB,CAU/D,CAAA"}

package/dist/workbench/config.d.ts

@@ -0,0 +1,55 @@
+import type { WorkbenchAsset, WorkbenchFeatures, WorkbenchIconConfiguration, WorkbenchLabels, WorkbenchLayout, WorkbenchOptions, WorkbenchTextPreset, WorkbenchTheme } from './types';
+/** Workbench 内部使用的完整品牌配置 */
+export interface NormalizedWorkbenchBranding {
+    /** 品牌 Logo 地址 */
+    logoUrl: string;
+    /** 品牌 Logo 替代文字 */
+    logoAlt: string;
+    /** 是否显示品牌 Logo */
+    showLogo: boolean;
+    /** 品牌标题 */
+    title: string;
+    /** 是否显示品牌标题 */
+    showTitle: boolean;
+    /** 品牌副标题 */
+    subtitle: string;
+    /** 是否显示品牌副标题 */
+    showSubtitle: boolean;
+}
+/** Workbench 内部使用的完整配置 */
+export interface NormalizedWorkbenchOptions {
+    /** 二维编辑画布的逻辑宽度 */
+    editorWidth: number;
+    /** 二维编辑画布的逻辑高度 */
+    editorHeight: number;
+    /** 最多保留的撤销步骤数量 */
+    historyLimit: number;
+    /** 初始化产品配置 */
+    product: WorkbenchOptions['product'];
+    /** 完整功能开关 */
+    features: WorkbenchFeatures;
+    /** 完整布局开关 */
+    layout: WorkbenchLayout;
+    /** 完整品牌配置 */
+    branding: NormalizedWorkbenchBranding;
+    /** 完整界面文案 */
+    labels: WorkbenchLabels;
+    /** 完整主题配置 */
+    theme: WorkbenchTheme;
+    /** 完整图标配置 */
+    icons: Required<WorkbenchIconConfiguration>;
+    /** 可用文字排版预设 */
+    textPresets: WorkbenchTextPreset[];
+    /** 可用背景素材 */
+    backgrounds: WorkbenchAsset[];
+    /** 可用装饰元素 */
+    elements: WorkbenchAsset[];
+}
+/**
+ * 补全并校验 Workbench 默认配置
+ *
+ * @param options 外部 Workbench 配置
+ * @returns 不包含挂载容器的完整内部配置
+ */
+export declare function normalizeWorkbenchOptions(options: WorkbenchOptions): NormalizedWorkbenchOptions;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +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"}

package/dist/workbench/icons.d.ts

@@ -0,0 +1,4 @@
+import type { WorkbenchIconConfiguration } from './types';
+/** 渲染 Workbench 内置图标并应用调用方覆盖 */
+export declare function renderWorkbenchIcons(root: HTMLElement, configuration: Required<WorkbenchIconConfiguration>): void;
+//# sourceMappingURL=icons.d.ts.map

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

@@ -0,0 +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"}

package/dist/workbench/index.d.ts

@@ -0,0 +1,25 @@
+import { CustomForgeWorkbench } from './CustomForgeWorkbench';
+import type { WorkbenchOptions } from './types';
+/**
+ * 创建带默认界面的产品定制工作台
+ *
+ * 使用 `features` 控制具体功能控件，使用 `layout` 控制顶部栏、工具栏、图层面板等区域
+ * 不再使用返回的实例时必须调用 `destroy()`
+ *
+ * @param options 挂载容器、产品资源、功能和布局开关
+ * @returns 初始化完成的 Workbench
+ * @throws 挂载容器无效、模型加载失败或目标 Mesh 不存在时抛出错误
+ *
+ * @example
+ * ```ts
+ * const workbench = await createWorkbench({
+ *   container: '#app',
+ *   features: { addText: false },
+ *   layout: { header: false },
+ * })
+ * ```
+ */
+export declare function createWorkbench(options: WorkbenchOptions): Promise<CustomForgeWorkbench>;
+export { CustomForgeWorkbench };
+export type { WorkbenchAsset, WorkbenchAssetLibrary, WorkbenchBranding, WorkbenchFeatureName, WorkbenchFeatures, WorkbenchIconConfiguration, WorkbenchIconName, WorkbenchLabels, WorkbenchLayout, WorkbenchLayoutName, WorkbenchOptions, WorkbenchStatusMode, WorkbenchTextPreset, WorkbenchTheme, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/workbench/template.d.ts

@@ -0,0 +1,3 @@
+/** 创建 Workbench 使用的静态 DOM 结构 */
+export declare function createWorkbenchElement(): HTMLElement;
+//# sourceMappingURL=template.d.ts.map

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

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

package/dist/workbench/types.d.ts

@@ -0,0 +1,294 @@
+import type { ElementTarget, ProductConfiguration } from '../core/types';
+/** Workbench 可显示的功能控件 */
+export interface WorkbenchFeatures {
+    /** 是否显示添加文字控件，默认为 true */
+    addText: boolean;
+    /** 是否显示添加图片控件，默认为 true */
+    addImage: boolean;
+    /** 是否显示撤销和重做控件，默认为 true */
+    undoRedo: boolean;
+    /** 是否显示删除选中对象控件，默认为 true */
+    deleteSelection: boolean;
+    /** 是否显示保存 Design JSON 控件，默认为 true */
+    saveDesign: boolean;
+    /** 是否显示加载 Design JSON 控件，默认为 true */
+    loadDesign: boolean;
+    /** 是否显示远程产品加载控件，默认为 true */
+    loadRemoteProduct: boolean;
+    /** 是否显示 PNG 导出控件，默认为 true */
+    exportTexture: boolean;
+    /** 是否显示三维视角重置控件，默认为 true */
+    resetView: boolean;
+    /** 是否允许通过图层面板调整对象顺序，默认为 true */
+    reorderObjects: boolean;
+    /** 是否允许通过图层面板切换对象可见性，默认为 true */
+    toggleObjectVisibility: boolean;
+    /** 是否允许通过图层面板锁定对象，默认为 true */
+    lockObjects: boolean;
+    /** 是否允许通过图层面板重命名对象，默认为 true */
+    renameObjects: boolean;
+    /** 是否在图片 Dialog 中显示预设背景，默认为 true */
+    presetBackgrounds: boolean;
+    /** 是否在图片 Dialog 中显示预设装饰元素，默认为 true */
+    presetElements: boolean;
+}
+/** Workbench 可显示的布局区域 */
+export interface WorkbenchLayout {
+    /** 是否显示包含品牌和全局操作的顶部栏，默认为 true */
+    header: boolean;
+    /** 是否显示二维编辑器标题栏，默认为 true */
+    editorHeader: boolean;
+    /** 是否显示三维查看器标题栏，默认为 true */
+    viewerHeader: boolean;
+    /** 是否显示二维编辑工具栏，默认为 true */
+    toolbar: boolean;
+    /** 是否显示对象图层面板，默认为 true */
+    layers: boolean;
+    /** 是否显示底部运行状态栏，默认为 true */
+    status: boolean;
+}
+/** Workbench 顶部栏品牌信息 */
+export interface WorkbenchBranding {
+    /** 品牌 Logo 地址，默认为包内 CustomForge Logo */
+    logoUrl?: string;
+    /** 品牌 Logo 替代文字，默认为 CustomForge */
+    logoAlt?: string;
+    /** 是否显示品牌 Logo，默认为 true */
+    showLogo?: boolean;
+    /** 品牌标题，默认为 CustomForge */
+    title?: string;
+    /** 是否显示品牌标题，默认为 true */
+    showTitle?: boolean;
+    /** 品牌副标题，默认为 Product customization studio */
+    subtitle?: string;
+    /** 是否显示品牌副标题，默认为 true */
+    showSubtitle?: boolean;
+}
+/** Workbench 可覆盖的界面文案 */
+export interface WorkbenchLabels {
+    /** Workbench 无障碍名称 */
+    workbench: string;
+    /** 二维编辑区域标题 */
+    editorTitle: string;
+    /** 三维查看区域标题 */
+    viewerTitle: string;
+    /** 图层面板标题 */
+    layers: string;
+    /** 空图层列表提示 */
+    noObjects: string;
+    /** 添加文字命令 */
+    addText: string;
+    /** 添加图片命令 */
+    addImage: string;
+    /** 撤销命令 */
+    undo: string;
+    /** 重做命令 */
+    redo: string;
+    /** 保存设计命令 */
+    saveDesign: string;
+    /** 加载设计命令 */
+    loadDesign: string;
+    /** 删除选中对象命令 */
+    deleteSelection: string;
+    /** 加载产品命令 */
+    loadProduct: string;
+    /** 导出 PNG 命令 */
+    exportTexture: string;
+    /** 重置三维视角命令 */
+    resetView: string;
+    /** 文字图层类型名称 */
+    textObject: string;
+    /** 图片图层类型名称 */
+    imageObject: string;
+    /** 设计背景图层类型名称 */
+    backgroundObject: string;
+    /** 显示图层命令 */
+    showLayer: string;
+    /** 隐藏图层命令 */
+    hideLayer: string;
+    /** 锁定图层命令 */
+    lockLayer: string;
+    /** 解锁图层命令 */
+    unlockLayer: string;
+    /** 图层前移命令 */
+    moveLayerForward: string;
+    /** 图层后移命令 */
+    moveLayerBackward: string;
+    /** 删除图层命令 */
+    deleteLayer: string;
+    /** 文字 Dialog 辅助标题 */
+    textDialogEyebrow: string;
+    /** 文字 Dialog 标题 */
+    textDialogTitle: string;
+    /** 文字输入字段标签 */
+    textInputLabel: string;
+    /** 文字输入占位文案 */
+    textInputPlaceholder: string;
+    /** 文字排版预设区域标题 */
+    textPresets: string;
+    /** 文字颜色字段标签 */
+    textColor: string;
+    /** 确认添加文字命令 */
+    addTextConfirm: string;
+    /** 图片 Dialog 辅助标题 */
+    imageDialogEyebrow: string;
+    /** 图片 Dialog 标题 */
+    imageDialogTitle: string;
+    /** 上传图片页签 */
+    uploadImageTab: string;
+    /** 预设背景页签 */
+    backgroundsTab: string;
+    /** 装饰元素页签 */
+    elementsTab: string;
+    /** 选择本地图片命令 */
+    chooseImage: string;
+    /** 尚未选择本地图片时的状态 */
+    noImageSelected: string;
+    /** 未提供预设素材时的状态 */
+    noPresetAssets: string;
+    /** 确认添加图片命令 */
+    addImageConfirm: string;
+    /** 关闭 Dialog 命令 */
+    close: string;
+    /** 取消命令 */
+    cancel: string;
+    /** 远程产品 Dialog 辅助标题 */
+    productDialogEyebrow: string;
+    /** 远程产品 Dialog 标题 */
+    productDialogTitle: string;
+    /** 模型地址字段标签 */
+    modelUrl: string;
+    /** 基础纹理地址字段标签 */
+    textureUrl: string;
+    /** 可定制 Mesh 字段标签 */
+    surfaceMesh: string;
+    /** 垂直翻转纹理字段标签 */
+    flipTexture: string;
+    /** 使用内置演示产品命令 */
+    useDemo: string;
+    /** 初始状态文案 */
+    starting: string;
+    /** 产品就绪状态文案 */
+    productReady: string;
+    /** 设计保存成功状态文案 */
+    designSaved: string;
+    /** 设计加载成功状态文案 */
+    designLoaded: string;
+    /** 撤销完成状态文案 */
+    undoComplete: string;
+    /** 重做完成状态文案 */
+    redoComplete: string;
+    /** 单个对象数量格式，其中 {count} 会被替换 */
+    objectCountOne: string;
+    /** 多个对象数量格式，其中 {count} 会被替换 */
+    objectCountMany: string;
+}
+/** Workbench 可覆盖的主题变量 */
+export interface WorkbenchTheme {
+    /** 主要文字颜色 */
+    ink: string;
+    /** 次要文字颜色 */
+    muted: string;
+    /** 边框颜色 */
+    border: string;
+    /** 主表面颜色 */
+    surface: string;
+    /** 次级表面颜色 */
+    surfaceMuted: string;
+    /** 编辑与三维舞台背景颜色 */
+    stage: string;
+    /** 品牌强调色 */
+    accent: string;
+    /** 品牌强调色悬停状态 */
+    accentHover: string;
+    /** 强调色上的文字颜色 */
+    accentContrast: string;
+    /** 危险操作颜色 */
+    danger: string;
+    /** Workbench 字体族 CSS 值，默认加载包内 Nunito Sans 并回退到系统无衬线字体 */
+    fontFamily: string;
+    /** 控件圆角 CSS 值，默认为 7px */
+    controlRadius: string;
+}
+/** Workbench 可覆盖的图标语义名称 */
+export type WorkbenchIconName = 'addImage' | 'addText' | 'backgroundObject' | 'close' | 'deleteSelection' | 'exportTexture' | 'hideLayer' | 'imageObject' | 'layers' | 'loadDesign' | 'loadProduct' | 'lock' | 'moveBackward' | 'moveForward' | 'redo' | 'resetView' | 'saveDesign' | 'showLayer' | 'textObject' | 'undo' | 'unlock' | 'upload';
+/** Workbench 图标配置 */
+export interface WorkbenchIconConfiguration {
+    /** 是否显示内置和自定义图标，默认为 true */
+    enabled?: boolean;
+    /** 按语义名称提供自定义图片地址，null 表示只隐藏对应图标 */
+    sources?: Partial<Record<WorkbenchIconName, string | null>>;
+}
+/** Workbench 文字排版预设 */
+export interface WorkbenchTextPreset {
+    /** 在当前预设集合内唯一的标识 */
+    id: string;
+    /** 预设选择器中显示的名称 */
+    name: string;
+    /** 预览区域使用的可选示例文字 */
+    previewText?: string;
+    /** 添加到画布时使用的字体族 */
+    fontFamily: string;
+    /** 添加到画布时使用的字体大小，单位为像素 */
+    fontSize: number;
+    /** 添加到画布时使用的文字框宽度，单位为像素 */
+    width: number;
+    /** 添加到画布时使用的 CSS 颜色值 */
+    color: string;
+}
+/** Workbench 图片素材条目 */
+export interface WorkbenchAsset {
+    /** 在对应素材集合内唯一的标识 */
+    id: string;
+    /** 素材选择器中显示的名称 */
+    name: string;
+    /** 添加到设计时加载的图片地址 */
+    url: string;
+    /** 选择器中使用的可选缩略图地址，缺省时使用 url */
+    thumbnailUrl?: string;
+    /** 素材图片的替代文字，缺省时使用 name */
+    alt?: string;
+}
+/** Workbench 可用的预设图片素材 */
+export interface WorkbenchAssetLibrary {
+    /** 铺满画布并锁定在底层的背景素材 */
+    backgrounds?: WorkbenchAsset[];
+    /** 作为普通可编辑图片加入画布的装饰元素 */
+    elements?: WorkbenchAsset[];
+}
+/** Workbench 初始化配置 */
+export interface WorkbenchOptions {
+    /** Workbench 独占使用的挂载元素或 CSS 选择器 */
+    container: ElementTarget;
+    /** 二维编辑画布的逻辑宽度，单位为像素，默认为 1024 */
+    editorWidth?: number;
+    /** 二维编辑画布的逻辑高度，单位为像素，默认为 512 */
+    editorHeight?: number;
+    /** 最多保留的撤销步骤数量，默认为 50 */
+    historyLimit?: number;
+    /** 初始化时加载的产品配置 */
+    product?: ProductConfiguration;
+    /** 功能控件开关，未传字段使用默认值 */
+    features?: Partial<WorkbenchFeatures>;
+    /** 布局区域开关，未传字段使用默认值 */
+    layout?: Partial<WorkbenchLayout>;
+    /** 顶部栏使用的可选品牌信息 */
+    branding?: WorkbenchBranding;
+    /** 可覆盖的界面文案 */
+    labels?: Partial<WorkbenchLabels>;
+    /** 可覆盖的主题变量 */
+    theme?: Partial<WorkbenchTheme>;
+    /** 图标显示与替换配置 */
+    icons?: WorkbenchIconConfiguration;
+    /** 替换内置文字排版预设，空数组表示不显示预设 */
+    textPresets?: WorkbenchTextPreset[];
+    /** 图片 Dialog 使用的背景与装饰素材 */
+    assets?: WorkbenchAssetLibrary;
+}
+/** Workbench 功能控件名称 */
+export type WorkbenchFeatureName = keyof WorkbenchFeatures;
+/** Workbench 布局区域名称 */
+export type WorkbenchLayoutName = keyof WorkbenchLayout;
+/** Workbench 状态提示样式 */
+export type WorkbenchStatusMode = 'ready' | 'busy' | 'error';
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workbench/types.ts"],"names":[],"mappings":"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"}