customforge 0.1.0-alpha.1 → 0.1.0

package/dist/editor/DesignEditor.d.ts

@@ -1,18 +1,34 @@
-import { Canvas, FabricImage, Textbox } from 'fabric';
-import type { AddImageOptions, AddTextOptions, DesignDocument } from '../core/types';
+import { Canvas } from 'fabric';
+import type { AddImageOptions, AddTextOptions, CanvasBounds, DesignCanvas as DesignCanvasSize, DesignDocument, DesignObject, EditorAppearance, HistoryState, ImageDesignObject, TextDesignObject, UpdateObjectTransformOptions, UpdateTextOptions } from '../core/types';
+import type { UvLayout } from '../core/uv';
 /** 二维编辑器内部初始化配置 */
 interface DesignEditorOptions {
     /** 画布逻辑宽度，单位为像素 */
     width: number;
     /** 画布逻辑高度，单位为像素 */
     height: number;
+    /** 最多保留的撤销步骤数量 */
+    historyLimit: number;
+    /** 编辑画布的无障碍名称 */
+    ariaLabel?: string;
+    /** 未提供内容时添加到画布的默认文字 */
+    defaultText?: string;
+    /** 空文字对象的默认名称 */
+    textObjectName?: string;
+    /** 普通图片对象的默认名称 */
+    imageObjectName?: string;
+    /** 背景图片对象的默认名称 */
+    backgroundObjectName?: string;
+    /** 选择框、对象控制点和 UV 辅助层外观 */
+    appearance?: EditorAppearance;
 }
 type RenderListener = () => void;
-type SelectionListener = (hasSelection: boolean) => void;
+type SelectionListener = (objectIds: string[]) => void;
+type HistoryListener = (state: HistoryState) => void;
 /**
  * 基于 Fabric.js 的二维纹理编辑器
  *
- * 负责基础纹理、文字、图片、对象选择和 PNG 导出
+ * 负责基础纹理、UV 区域辅助层、文字、图片、对象选择和 PNG 导出
  * 显示尺寸可以响应容器变化，内部逻辑尺寸保持不变
  */
 export declare class DesignEditor {
@@ -21,21 +37,48 @@ export declare class DesignEditor {
     private readonly host;
     private readonly width;
     private readonly height;
+    private readonly defaultText;
+    private readonly textObjectName;
+    private readonly imageObjectName;
+    private readonly backgroundObjectName;
+    private readonly appearance;
+    private editableBounds;
     private readonly renderListeners;
     private readonly selectionListeners;
+    private readonly historyListeners;
     private readonly objectIds;
+    private readonly objectsById;
+    private readonly objectNames;
+    private readonly objectLocks;
     private readonly usedObjectIds;
     private readonly imageSources;
+    private readonly imageRoles;
     private readonly resizeObserver;
+    private readonly history;
+    private readonly uvOverlay;
+    private readonly textureRenderer;
+    private readonly textureCanvasElement;
+    private readonly textureContext;
+    private historySignature;
+    private historyTimer?;
+    private historyBusy;
+    private renderingTexture;
     private objectIdSequence;
     /**
      * @param host 二维编辑器挂载容器
-     * @param options 画布逻辑尺寸
+     * @param options 画布逻辑尺寸和历史容量
      */
     constructor(host: HTMLElement, options: DesignEditorOptions);
-    /** 供 Three.js 创建 CanvasTexture 的底层 HTML Canvas */
+    /** 供 Three.js 创建 CanvasTexture 的纯设计画布，不包含选择框和变换控件 */
     get textureCanvas(): HTMLCanvasElement;
-    /** 当前画布中可编辑对象的数量，不包含背景纹理 */
+    /**
+     * 在交互画布上显示目标 Mesh 的 UV 可打印区域，但不写入实时纹理或导出图片
+     *
+     * @param layout 从当前目标 Mesh 提取的 UV 布局
+     * @param flipY 是否按照垂直翻转后的纹理方向显示
+     */
+    setUvLayout(layout: UvLayout, flipY: boolean): void;
+    /** 当前画布中设计对象的数量，不包含产品基础纹理 */
     get objectCount(): number;
     /**
      * 订阅 Fabric Canvas 完成渲染事件
@@ -47,12 +90,135 @@ export declare class DesignEditor {
     /**
      * 订阅画布选中状态变化
      *
-     * @param listener 接收当前是否存在选区的函数
+     * @param listener 接收当前选中对象 ID 的函数
      * @returns 用于取消本次订阅的函数
      */
     onSelectionChange(listener: SelectionListener): () => void;
     /**
-     * 设置铺满画布的基础纹理，不传地址时恢复默认背景色
+     * 订阅撤销与重做可用状态变化
+     *
+     * @param listener 接收最新历史状态的函数
+     * @returns 用于取消本次订阅的函数
+     */
+    onHistoryChange(listener: HistoryListener): () => void;
+    /** 当前是否存在可以撤销的设计快照 */
+    get canUndo(): boolean;
+    /** 当前是否存在可以重做的设计快照 */
+    get canRedo(): boolean;
+    /**
+     * 返回当前对象的独立 Design JSON 快照
+     *
+     * @returns 按画布层级从后到前排列的对象数组
+     */
+    getObjects(): DesignObject[];
+    /** 返回当前逻辑画布尺寸 */
+    getCanvasSize(): DesignCanvasSize;
+    /** 返回当前 UV 可打印区域的独立包围框 */
+    getPrintableBounds(): CanvasBounds;
+    /** 当前选中对象的 ID，按画布层级从后到前排列 */
+    getSelectedObjectIds(): string[];
+    /**
+     * 按稳定 ID 选中一个可见对象
+     *
+     * @param id Design JSON 中的对象 ID
+     * @returns 是否找到并选中了对象
+     */
+    selectObject(id: string): boolean;
+    /**
+     * 按稳定 ID 同时选中多个可见对象
+     *
+     * 所有 ID 都必须有效且对象可见，否则保持原选区不变
+     *
+     * @param ids 对象 ID，空数组表示清除选区
+     * @returns 是否应用了请求的选区
+     */
+    selectObjects(ids: readonly string[]): boolean;
+    /**
+     * 清除当前画布选区，不修改设计内容或历史记录
+     *
+     * @returns 清除前是否存在选中对象
+     */
+    clearSelection(): boolean;
+    /**
+     * 按稳定 ID 删除一个对象
+     *
+     * @param id Design JSON 中的对象 ID
+     * @returns 是否找到并删除了对象
+     */
+    removeObject(id: string): boolean;
+    /**
+     * 将对象移动到指定图层索引
+     *
+     * @param id Design JSON 中的对象 ID
+     * @param index 从 0 开始的索引，0 表示最底层
+     * @returns 对象层级是否发生变化
+     */
+    moveObject(id: string, index: number): boolean;
+    /**
+     * 将现有图片转换为铺满当前 UV 可打印区域的设计背景
+     *
+     * 转换会替换已有设计背景、重置旋转、锁定对象并移动到最底层
+     *
+     * @param id Design JSON 中的图片对象 ID
+     * @returns 是否找到普通图片并完成转换
+     */
+    setImageAsBackground(id: string): boolean;
+    /**
+     * 修改对象在图层面板中的名称
+     *
+     * @param id Design JSON 中的对象 ID
+     * @param name 非空图层名称
+     * @returns 是否找到并更新了对象
+     */
+    renameObject(id: string, name: string): boolean;
+    /**
+     * 修改对象是否参与渲染
+     *
+     * @param id Design JSON 中的对象 ID
+     * @param visible 是否参与二维画布、三维纹理和 PNG 渲染
+     * @returns 是否找到并更新了对象
+     */
+    setObjectVisibility(id: string, visible: boolean): boolean;
+    /**
+     * 修改对象是否允许通过画布控件变换
+     *
+     * @param id Design JSON 中的对象 ID
+     * @param locked 是否锁定移动、缩放、旋转、倾斜和文字编辑
+     * @returns 是否找到并更新了对象
+     */
+    setObjectLocked(id: string, locked: boolean): boolean;
+    /**
+     * 更新对象中心位置、缩放、旋转和翻转
+     *
+     * 对象最终仍会约束在逻辑画布内，连续调用会合并为一个历史步骤
+     *
+     * @param id Design JSON 中的对象 ID
+     * @param options 要更新的变换字段
+     * @returns 约束后的对象快照，找不到对象时返回 undefined
+     * @throws 数值无效或缩放倍数不大于零时抛出错误
+     */
+    updateObjectTransform(id: string, options: UpdateObjectTransformOptions): DesignObject | undefined;
+    /**
+     * 修改已有文字对象的内容和排版样式
+     *
+     * 连续调用会在短暂空闲后合并为一个历史步骤
+     * 字体必须由消费页面提前加载，否则浏览器会使用回退字体
+     *
+     * @param id Design JSON 中的对象 ID
+     * @param options 要修改的文字属性，未传字段保持不变
+     * @returns 是否找到并更新了文字对象
+     * @throws 字号、行高、字距、字重或 CSS 颜色不符合约束时抛出错误
+     */
+    updateText(id: string, options: UpdateTextOptions): boolean;
+    /**
+     * 让一个未锁定文字对象进入画布内联编辑状态
+     *
+     * @param id Design JSON 中的对象 ID
+     * @returns 是否找到文字对象并进入编辑状态
+     */
+    editText(id: string): boolean;
+    /**
+     * 设置铺满画布的基础纹理，不传地址时恢复透明背景
      *
      * 背景纹理不参与对象选择，但会包含在实时纹理和 PNG 导出中
      *
@@ -67,25 +233,26 @@ export declare class DesignEditor {
      * 对象过大时会等比缩小，越界时会自动移回画布
      *
      * @param options 文字内容、位置和样式
-     * @returns 创建的 Fabric Textbox
+     * @returns 创建后的可持久化文字对象快照
      */
-    addText(options?: AddTextOptions): Textbox;
+    addText(options?: AddTextOptions): TextDesignObject;
     /**
      * 加载、添加并选中一个图片对象
      *
+     * role 为 background 时替换已有设计背景、铺满当前 UV 可打印区域并默认锁定在最底层
      * 图片位置使用画布像素坐标，原点位于图片中心
      * 对象过大时会等比缩小，越界时会自动移回画布
      * 远程图片必须提供正确的 CORS 响应头才能安全导出 PNG
      *
      * @param options 图片地址、中心位置和显示宽度
-     * @returns 创建的 FabricImage
+     * @returns 创建后的可持久化图片对象快照
      * @throws 图片加载失败或被 CORS 策略阻止时抛出错误
      */
-    addImage(options: AddImageOptions): Promise<FabricImage>;
+    addImage(options: AddImageOptions): Promise<ImageDesignObject>;
     /**
      * 返回与 Fabric.js 无关的当前设计快照
      *
-     * 文档只包含可编辑对象和逻辑画布尺寸，不包含背景纹理或产品模型配置
+     * 文档包含设计背景等设计对象和逻辑画布尺寸，不包含产品基础纹理或模型配置
      *
      * @returns 可以安全传给 JSON.stringify 的 Design JSON 文档
      * @throws 画布包含不支持的对象或非字符串文字填充时抛出错误
@@ -100,6 +267,21 @@ export declare class DesignEditor {
      * @throws Schema 无效、画布尺寸不匹配或图片无法加载时抛出错误
      */
     loadDesign(value: unknown): Promise<void>;
+    private replaceDesign;
+    /**
+     * 恢复上一个设计快照
+     *
+     * @returns 是否成功恢复了一个历史步骤
+     */
+    undo(): Promise<boolean>;
+    /**
+     * 恢复下一个设计快照
+     *
+     * @returns 是否成功恢复了一个历史步骤
+     */
+    redo(): Promise<boolean>;
+    /** 以当前设计为起点清空撤销与重做历史 */
+    clearHistory(): void;
     /**
      * 删除当前对象或多选选区
      *
@@ -113,17 +295,45 @@ export declare class DesignEditor {
      * @throws 画布被无 CORS 授权的远程图片污染时抛出安全错误
      */
     exportTexture(filename?: string): void;
+    /**
+     * 返回不含选择框和 UV 辅助层的 PNG Data URL
+     *
+     * @returns 与逻辑画布同尺寸的 PNG Data URL
+     * @throws 远程图片污染 Canvas 时抛出安全错误
+     */
+    getTextureDataUrl(): string;
+    /**
+     * 异步返回不含选择框和 UV 辅助层的 PNG Blob
+     *
+     * @returns 与逻辑画布同尺寸的 PNG Blob
+     * @throws 远程图片污染 Canvas 或浏览器无法编码时抛出错误
+     */
+    getTextureBlob(): Promise<Blob>;
     /** 释放 ResizeObserver、事件监听和 Fabric Canvas */
     destroy(): void;
     private addAndSelect;
     private registerObject;
+    private unregisterObject;
     private createObjectId;
     private serializeObject;
     private serializeTransform;
     private createObjectFromDesign;
     private loadImage;
+    private createObjectName;
+    private applyObjectLock;
+    private notifySelectionChange;
+    private removeDesignBackgrounds;
+    private scheduleHistoryCommit;
+    private flushHistoryCommit;
+    private commitHistory;
+    private notifyHistoryChange;
     private constrainObjectToCanvas;
     private resizeDisplay;
+    private applySelection;
+    private objectControlAppearance;
+    private validateTransformOptions;
+    private fitImageToEditableBounds;
+    private renderTextureCanvas;
     private markRenderState;
 }
 export {};

package/dist/editor/DesignEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DesignEditor.d.ts","sourceRoot":"","sources":["../../src/editor/DesignEditor.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,WAAW,EACX,OAAO,EAER,MAAM,QAAQ,CAAA;AAEf,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EAGf,MAAM,eAAe,CAAA;AAOtB,mBAAmB;AACnB,UAAU,mBAAmB;IAC3B,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAA;IAEb,mBAAmB;IACnB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,KAAK,cAAc,GAAG,MAAM,IAAI,CAAA;AAChC,KAAK,iBAAiB,GAAG,CAAC,YAAY,EAAE,OAAO,KAAK,IAAI,CAAA;AAExD;;;;;GAKG;AACH,qBAAa,YAAY;IACvB,4BAA4B;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IAEvB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4B;IAC5D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAA+B;IAClE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqC;IAClE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgB;IAC/C,OAAO,CAAC,gBAAgB,CAAI;IAE5B;;;OAGG;IACH,YAAY,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,mBAAmB,EAgD1D;IAED,kDAAkD;IAClD,IAAI,aAAa,IAAI,iBAAiB,CAErC;IAED,4BAA4B;IAC5B,IAAI,WAAW,IAAI,MAAM,CAExB;IAED;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAG7C;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,iBAAiB,GAAG,MAAM,IAAI,CAGzD;IAED;;;;;;;OAOG;IACG,oBAAoB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBtD;IAED;;;;;;;;OAQG;IACH,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAsB7C;IAED;;;;;;;;;;OAUG;IACG,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAuB7D;IAED;;;;;;;OAOG;IACH,UAAU,IAAI,cAAc,CAM3B;IAED;;;;;;;OAOG;IACG,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C9C;IAED;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAWxB;IAED;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,SAAuB,GAAG,IAAI,CAWnD;IAED,4CAA4C;IAC5C,OAAO,IAAI,IAAI,CAMd;IAED,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,kBAAkB;YAaZ,sBAAsB;IAoCpC,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,uBAAuB;IAwB/B,OAAO,CAAC,aAAa;IAkBrB,OAAO,CAAC,eAAe;CA4BxB"}
+{"version":3,"file":"DesignEditor.d.ts","sourceRoot":"","sources":["../../src/editor/DesignEditor.ts"],"names":[],"mappings":"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"}

package/dist/editor/DesignHistory.d.ts

@@ -0,0 +1,27 @@
+import type { HistoryState } from '../core/types';
+/** 固定容量的设计快照历史 */
+export declare class DesignHistory<T> {
+    private readonly limit;
+    private entries;
+    private index;
+    /**
+     * @param initial 初始设计快照
+     * @param limit 最多保留的撤销步骤数量
+     */
+    constructor(initial: T, limit: number);
+    /** 当前撤销与重做可用状态 */
+    get state(): HistoryState;
+    /** 当前步骤之前的快照 */
+    peekUndo(): T | undefined;
+    /** 当前步骤之后的快照 */
+    peekRedo(): T | undefined;
+    /** 添加新快照并丢弃当前步骤之后的重做分支 */
+    push(snapshot: T): void;
+    /** 在目标快照成功恢复后确认一次撤销 */
+    confirmUndo(): void;
+    /** 在目标快照成功恢复后确认一次重做 */
+    confirmRedo(): void;
+    /** 以当前快照重新开始历史记录 */
+    reset(snapshot: T): void;
+}
+//# sourceMappingURL=DesignHistory.d.ts.map

package/dist/editor/DesignHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesignHistory.d.ts","sourceRoot":"","sources":["../../src/editor/DesignHistory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAEjD,kBAAkB;AAClB,qBAAa,aAAa,CAAC,CAAC;IAQF,OAAO,CAAC,QAAQ,CAAC,KAAK;IAP9C,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,KAAK,CAAI;IAEjB;;;OAGG;IACH,YAAY,OAAO,EAAE,CAAC,EAAmB,KAAK,EAAE,MAAM,EAKrD;IAED,kBAAkB;IAClB,IAAI,KAAK,IAAI,YAAY,CAKxB;IAED,gBAAgB;IAChB,QAAQ,IAAI,CAAC,GAAG,SAAS,CAExB;IAED,gBAAgB;IAChB,QAAQ,IAAI,CAAC,GAAG,SAAS,CAExB;IAED,0BAA0B;IAC1B,IAAI,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAOtB;IAED,uBAAuB;IACvB,WAAW,IAAI,IAAI,CAIlB;IAED,uBAAuB;IACvB,WAAW,IAAI,IAAI,CAIlB;IAED,oBAAoB;IACpB,KAAK,CAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,CAGvB;CACF"}

package/dist/editor/uvBounds.d.ts

@@ -0,0 +1,15 @@
+import type { UvLayout } from '../core/uv';
+import type { ObjectBounds } from './objectBounds';
+/**
+ * 将 UV 三角形的坐标范围转换为逻辑画布包围框
+ *
+ * UV 坐标会限制在 0 到 1 之间；布局为空、无效或退化时回退到整张画布
+ *
+ * @param layout 当前可打印 Mesh 的 UV 布局
+ * @param flipY 是否按照垂直翻转后的纹理方向计算
+ * @param canvasWidth 逻辑画布宽度
+ * @param canvasHeight 逻辑画布高度
+ * @returns 当前 UV 可打印区域在逻辑画布中的轴对齐包围框
+ */
+export declare function calculateUvCanvasBounds(layout: UvLayout, flipY: boolean, canvasWidth: number, canvasHeight: number): ObjectBounds;
+//# sourceMappingURL=uvBounds.d.ts.map

package/dist/editor/uvBounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uvBounds.d.ts","sourceRoot":"","sources":["../../src/editor/uvBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAC1C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAMlD;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,QAAQ,EAChB,KAAK,EAAE,OAAO,EACd,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,GACnB,YAAY,CAmCd"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import './style.css';
 import { ProductCustomizer } from './customizer/ProductCustomizer';
+import type { ProductCustomizerApi } from './core/api';
 import type { CustomizerOptions } from './core/types';
 /**
  * 创建产品定制器实例并完成模型、编辑器和纹理同步初始化
@@ -24,7 +25,8 @@ import type { CustomizerOptions } from './core/types';
  * })
  * ```
  */
-export declare function createCustomizer(options: CustomizerOptions): Promise<ProductCustomizer>;
+export declare function createCustomizer(options: CustomizerOptions): Promise<ProductCustomizerApi>;
 export { ProductCustomizer };
-export type { AddImageOptions, AddTextOptions, CustomizerEventMap, CustomizerOptions, DesignCanvas, DesignDocument, DesignObject, DesignObjectTransform, ImageDesignObject, ProductConfiguration, TextDesignObject, } from './core/types';
+export type { CustomizerEventListener, ProductCustomizerApi, } from './core/api';
+export type { AddImageOptions, AddTextOptions, CanvasBounds, CustomizerAppearance, CustomizerEventMap, CustomizerEventName, CustomizerOptions, CustomizerState, DesignCanvas, DesignDocument, DesignImageRole, DesignObject, DesignObjectState, DesignObjectTransform, ElementTarget, ImageDesignObject, EditorAppearance, HistoryState, ProductConfiguration, ProductViewState, ResolvedProductConfiguration, TextAlignment, TextDesignObject, TextFontStyle, TextFontWeight, UpdateObjectTransformOptions, UpdateTextOptions, Vector3Value, ViewerAppearance, } from './core/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,iBAAiB,CAAC,CAE5B;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA;AAC5B,YAAY,EACV,eAAe,EACf,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,aAAa,CAAA;AACpB,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAErD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAE/B;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAA;AAC5B,YAAY,EACV,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,YAAY,CAAA;AACnB,YAAY,EACV,eAAe,EACf,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,eAAe,EACf,YAAY,EACZ,cAAc,EACd,eAAe,EACf,YAAY,EACZ,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,EAChB,4BAA4B,EAC5B,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,4BAA4B,EAC5B,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,cAAc,CAAA"}