@robot-admin/naive-ui-components 0.12.1 → 0.13.1

package/dist/useEdgeInteraction.d.ts

@@ -27,7 +27,7 @@ interface ERTable {
 }
 interface ERRelation {
   id: string;
-  type: "foreign-key" | "one-to-one" | "one-to-many" | "many-to-many";
+  type: 'foreign-key' | 'one-to-one' | 'one-to-many' | 'many-to-many';
   sourceTable: string;
   sourceField: string;
   targetTable: string;
@@ -41,7 +41,7 @@ interface ERDiagramData {
 }
 interface BPMNNode {
   id: string;
-  type: "start" | "end" | "task" | "gateway" | "event";
+  type: 'start' | 'end' | 'task' | 'gateway' | 'event';
   name: string;
   position: Position;
   properties: Record<string, any>;
@@ -60,13 +60,13 @@ interface BPMNDiagramData {
 interface UMLAttribute {
   name: string;
   type: string;
-  visibility: "public" | "private" | "protected";
+  visibility: 'public' | 'private' | 'protected';
   isStatic?: boolean;
 }
 interface UMLMethod {
   name: string;
   returnType: string;
-  visibility: "public" | "private" | "protected";
+  visibility: 'public' | 'private' | 'protected';
   parameters?: string[];
   isStatic?: boolean;
   isAbstract?: boolean;
@@ -81,7 +81,7 @@ interface UMLClass {
 }
 interface UMLRelation {
   id: string;
-  type: "inheritance" | "composition" | "aggregation" | "association" | "dependency";
+  type: 'inheritance' | 'implementation' | 'composition' | 'aggregation' | 'association' | 'dependency';
   source: string;
   target: string;
   name?: string;
@@ -92,7 +92,7 @@ interface UMLDiagramData {
   relations: UMLRelation[];
 }
 type DiagramData = ERDiagramData | BPMNDiagramData | UMLDiagramData;
-type DiagramType = "er" | "bpmn" | "uml";
+type DiagramType = 'er' | 'bpmn' | 'uml';
 interface DiagramConfig {
   type: DiagramType;
   data?: DiagramData;
@@ -100,16 +100,16 @@ interface DiagramConfig {
   height?: string | number;
   readonly?: boolean;
   showToolbar?: boolean;
-  theme?: "light" | "dark";
+  theme?: 'light' | 'dark';
 }
-type ToolbarAction = "new" | "open" | "save" | "save-as" | "import" | "export" | "undo" | "redo" | "copy" | "paste" | "delete" | "select-all" | "clear" | "zoom-in" | "zoom-out" | "zoom-fit" | "center" | "layout" | "align";
-type ExportFormat = "png" | "jpg" | "svg" | "pdf" | "json";
+type ToolbarAction = 'new' | 'open' | 'save' | 'save-as' | 'import' | 'export' | 'undo' | 'redo' | 'copy' | 'paste' | 'delete' | 'select-all' | 'clear' | 'zoom-in' | 'zoom-out' | 'zoom-fit' | 'center' | 'layout' | 'align';
+type ExportFormat = 'png' | 'jpg' | 'svg' | 'pdf' | 'json';
 interface MenuItem {
   label: string;
   key: string;
   icon?: string;
   shortcut?: string;
-  type?: "divider";
+  type?: 'divider';
 }
 interface ValidationResult {
   valid: boolean;
@@ -124,8 +124,8 @@ interface GraphEvents {
   selectionChange: (selectedIds: string[]) => void;
 }
 interface LayoutOptions {
-  type: "auto" | "hierarchical" | "force" | "grid" | "circular";
-  direction?: "TB" | "BT" | "LR" | "RL";
+  type: 'auto' | 'hierarchical' | 'force' | 'grid' | 'circular';
+  direction?: 'TB' | 'BT' | 'LR' | 'RL';
   spacing?: number;
   nodeSpacing?: number;
   layerSpacing?: number;
@@ -161,7 +161,7 @@ interface GraphExportOptions {
 }
 interface GridConfig {
   visible: boolean;
-  type: "dot" | "fixedDot" | "mesh" | "doubleMesh";
+  type: 'dot' | 'fixedDot' | 'mesh' | 'doubleMesh';
   size: number;
   color: string;
   thickness?: number;
@@ -241,28 +241,28 @@ interface GraphConfig {
 //#endregion
 //#region src/components/C_AntV/index.vue.d.ts
 interface Props extends DiagramConfig {
-  type: "er" | "bpmn" | "uml";
+  type: 'er' | 'bpmn' | 'uml';
   data?: DiagramData;
   width?: string | number;
   height?: string | number;
   readonly?: boolean;
   showToolbar?: boolean;
-  theme?: "light" | "dark";
+  theme?: 'light' | 'dark';
 }
 declare const __VLS_export: vue.DefineComponent<Props, {
   getGraph: () => any;
   getData: () => any;
 }, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {} & {
-  ready: (graph: any) => any;
+  ready: (graph: Graph) => any;
   "data-change": (data: DiagramData) => any;
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
-  onReady?: ((graph: any) => any) | undefined;
+  onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
-  width: string | number;
   height: string | number;
-  theme: "light" | "dark";
+  width: string | number;
   readonly: boolean;
+  theme: "light" | "dark";
   showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/useFullscreen.d.cts

@@ -9,11 +9,11 @@ type __VLS_Props = {
   autoPreview?: boolean;
 };
 declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  preview: (file: string | File) => any;
   download: (file: string | File) => any;
+  preview: (file: string | File) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onPreview?: ((file: string | File) => any) | undefined;
   onDownload?: ((file: string | File) => any) | undefined;
+  onPreview?: ((file: string | File) => any) | undefined;
 }>, {
   fileName: string;
   autoPreview: boolean;
@@ -25,10 +25,10 @@ declare const _default: typeof __VLS_export;
  * C_FilePreview 文件预览组件类型定义
  */
 /** 支持的文件类型 */
-type FilePreviewType = "pdf" | "word" | "excel" | "unknown";
+type FilePreviewType = 'pdf' | 'word' | 'excel' | 'unknown';
 /** 文件类型配置 */
 interface FileConfig {
-  tagType: string;
+  tagType: 'default' | 'primary' | 'info' | 'success' | 'warning' | 'error';
   icon: string;
   color: string;
 }
@@ -105,8 +105,8 @@ interface UseFilePreviewOptions {
  * @param emit - 组件事件发射器
  */
 declare function useFilePreview(options: UseFilePreviewOptions, emit: {
-  (e: "preview", file: File | string): void;
-  (e: "download", file: File | string): void;
+  (e: 'preview', file: File | string): void;
+  (e: 'download', file: File | string): void;
 }): {
   loading: Ref<boolean, boolean>;
   error: Ref<string, string>;

package/dist/useFullscreen.d.ts

@@ -9,11 +9,11 @@ type __VLS_Props = {
   autoPreview?: boolean;
 };
 declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  preview: (file: string | File) => any;
   download: (file: string | File) => any;
+  preview: (file: string | File) => any;
 }, string, vue.PublicProps, Readonly<__VLS_Props> & Readonly<{
-  onPreview?: ((file: string | File) => any) | undefined;
   onDownload?: ((file: string | File) => any) | undefined;
+  onPreview?: ((file: string | File) => any) | undefined;
 }>, {
   fileName: string;
   autoPreview: boolean;
@@ -25,10 +25,10 @@ declare const _default: typeof __VLS_export;
  * C_FilePreview 文件预览组件类型定义
  */
 /** 支持的文件类型 */
-type FilePreviewType = "pdf" | "word" | "excel" | "unknown";
+type FilePreviewType = 'pdf' | 'word' | 'excel' | 'unknown';
 /** 文件类型配置 */
 interface FileConfig {
-  tagType: string;
+  tagType: 'default' | 'primary' | 'info' | 'success' | 'warning' | 'error';
   icon: string;
   color: string;
 }
@@ -105,8 +105,8 @@ interface UseFilePreviewOptions {
  * @param emit - 组件事件发射器
  */
 declare function useFilePreview(options: UseFilePreviewOptions, emit: {
-  (e: "preview", file: File | string): void;
-  (e: "download", file: File | string): void;
+  (e: 'preview', file: File | string): void;
+  (e: 'download', file: File | string): void;
 }): {
   loading: Ref<boolean, boolean>;
   error: Ref<string, string>;

package/dist/useInfiniteScroll.d.cts

@@ -89,9 +89,9 @@ declare const __VLS_base: vue.DefineComponent<WaterFallProps, WaterFallExpose, {
   "onImage-loaded"?: ((item: WaterFallItem) => any) | undefined;
   "onImage-error"?: ((item: WaterFallItem) => any) | undefined;
 }>, {
+  gap: number;
   loading: boolean;
   columns: number;
-  gap: number;
   lazy: boolean;
   infinite: boolean;
   skeleton: boolean;
@@ -162,7 +162,7 @@ declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readon
     readonly height: number;
   }[]>>;
   containerHeight: Readonly<Ref<number, number>>;
-  cacheImageHeight: (id: string | number, realHeight: number) => void;
+  cacheImageHeight: (id: string | number, realHeight: number, basisWidth?: number, src?: string) => void;
   relayout: () => void;
 };
 //#endregion

package/dist/useInfiniteScroll.d.ts

@@ -89,9 +89,9 @@ declare const __VLS_base: vue.DefineComponent<WaterFallProps, WaterFallExpose, {
   "onImage-loaded"?: ((item: WaterFallItem) => any) | undefined;
   "onImage-error"?: ((item: WaterFallItem) => any) | undefined;
 }>, {
+  gap: number;
   loading: boolean;
   columns: number;
-  gap: number;
   lazy: boolean;
   infinite: boolean;
   skeleton: boolean;
@@ -162,7 +162,7 @@ declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readon
     readonly height: number;
   }[]>>;
   containerHeight: Readonly<Ref<number, number>>;
-  cacheImageHeight: (id: string | number, realHeight: number) => void;
+  cacheImageHeight: (id: string | number, realHeight: number, basisWidth?: number, src?: string) => void;
   relayout: () => void;
 };
 //#endregion

package/dist/useQRCode.d.cts

@@ -50,16 +50,16 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  showBorder: boolean;
-  label: string;
-  showLabel: boolean;
+  size: number;
   mode: RenderMode;
+  label: string;
   color: string;
-  size: number;
+  margin: number;
   bgColor: string;
   errorCorrectionLevel: ErrorCorrectionLevel;
-  margin: number;
   logo: LogoOptions;
+  showBorder: boolean;
+  showLabel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
@@ -79,6 +79,7 @@ interface UseQRCodeOptions {
  */
 declare function useQRCode(canvasRef: Ref<HTMLCanvasElement | null>, options: UseQRCodeOptions): {
   svgHtml: Ref<string, string>;
+  svgTrusted: Ref<boolean, boolean>;
   error: Ref<Error | null, Error | null>;
   loading: Ref<boolean, boolean>;
   render: () => Promise<void>;

package/dist/useQRCode.d.ts

@@ -50,16 +50,16 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  showBorder: boolean;
-  label: string;
-  showLabel: boolean;
+  size: number;
   mode: RenderMode;
+  label: string;
   color: string;
-  size: number;
+  margin: number;
   bgColor: string;
   errorCorrectionLevel: ErrorCorrectionLevel;
-  margin: number;
   logo: LogoOptions;
+  showBorder: boolean;
+  showLabel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion
@@ -79,6 +79,7 @@ interface UseQRCodeOptions {
  */
 declare function useQRCode(canvasRef: Ref<HTMLCanvasElement | null>, options: UseQRCodeOptions): {
   svgHtml: Ref<string, string>;
+  svgTrusted: Ref<boolean, boolean>;
   error: Ref<Error | null, Error | null>;
   loading: Ref<boolean, boolean>;
   render: () => Promise<void>;

package/dist/useSearchState.d.cts

@@ -93,9 +93,9 @@ declare const __VLS_export: vue.DefineComponent<FormSearchProps, {
   onReset?: (() => any) | undefined;
   "onChange-params"?: ((params: SearchFormParams) => any) | undefined;
 }>, {
-  loading: boolean;
   size: "small" | "medium" | "large";
   bordered: boolean;
+  loading: boolean;
   formItemList: SearchFormItem[];
   formParams: SearchFormParams;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -164,6 +164,7 @@ declare function useSearchState(emits: {
     rules?: {
       type?: async_validator0.RuleType | undefined;
       required?: boolean | undefined;
+      message?: string | ((a?: string) => string) | undefined;
       options?: {
         suppressWarning?: boolean | undefined;
         suppressValidatorError?: boolean | undefined;
@@ -219,9 +220,9 @@ declare function useSearchState(emits: {
         keys?: string[] | undefined;
         error?: ((rule: async_validator0.InternalRuleItem, message: string) => async_validator0.ValidateError) | undefined;
       } | undefined;
-      max?: number | undefined;
       pattern?: (RegExp | string) | undefined;
       min?: number | undefined;
+      max?: number | undefined;
       len?: number | undefined;
       enum?: Array<string | number | boolean | null | undefined> | undefined;
       whitespace?: boolean | undefined;
@@ -368,7 +369,6 @@ declare function useSearchState(emits: {
         validator?: ((rule: async_validator0.InternalRuleItem, value: async_validator0.Value, callback: (error?: string | Error) => void, source: async_validator0.Values, options: async_validator0.ValidateOption) => async_validator0.SyncValidateResult | void) | undefined;
       }[] | undefined;
       transform?: ((value: async_validator0.Value) => async_validator0.Value) | undefined;
-      message?: string | ((a?: string) => string) | undefined;
       key?: string | undefined;
       trigger?: (naive_ui_es_form_src_interface0.ValidationTrigger | string | Array<naive_ui_es_form_src_interface0.ValidationTrigger | string>) | undefined;
       validator?: naive_ui_es_form_src_interface0.FormItemRuleValidator | undefined;
@@ -395,6 +395,7 @@ declare function useSearchState(emits: {
     rules?: {
       type?: async_validator0.RuleType | undefined;
       required?: boolean | undefined;
+      message?: string | ((a?: string) => string) | undefined;
       options?: {
         suppressWarning?: boolean | undefined;
         suppressValidatorError?: boolean | undefined;
@@ -450,9 +451,9 @@ declare function useSearchState(emits: {
         keys?: string[] | undefined;
         error?: ((rule: async_validator0.InternalRuleItem, message: string) => async_validator0.ValidateError) | undefined;
       } | undefined;
-      max?: number | undefined;
       pattern?: (RegExp | string) | undefined;
       min?: number | undefined;
+      max?: number | undefined;
       len?: number | undefined;
       enum?: Array<string | number | boolean | null | undefined> | undefined;
       whitespace?: boolean | undefined;
@@ -599,7 +600,6 @@ declare function useSearchState(emits: {
         validator?: ((rule: async_validator0.InternalRuleItem, value: async_validator0.Value, callback: (error?: string | Error) => void, source: async_validator0.Values, options: async_validator0.ValidateOption) => async_validator0.SyncValidateResult | void) | undefined;
       }[] | undefined;
       transform?: ((value: async_validator0.Value) => async_validator0.Value) | undefined;
-      message?: string | ((a?: string) => string) | undefined;
       key?: string | undefined;
       trigger?: (naive_ui_es_form_src_interface0.ValidationTrigger | string | Array<naive_ui_es_form_src_interface0.ValidationTrigger | string>) | undefined;
       validator?: naive_ui_es_form_src_interface0.FormItemRuleValidator | undefined;
@@ -638,6 +638,7 @@ declare function useSearchState(emits: {
     rules?: {
       type?: async_validator0.RuleType | undefined;
       required?: boolean | undefined;
+      message?: string | ((a?: string) => string) | undefined;
       options?: {
         suppressWarning?: boolean | undefined;
         suppressValidatorError?: boolean | undefined;
@@ -693,9 +694,9 @@ declare function useSearchState(emits: {
         keys?: string[] | undefined;
         error?: ((rule: async_validator0.InternalRuleItem, message: string) => async_validator0.ValidateError) | undefined;
       } | undefined;
-      max?: number | undefined;
       pattern?: (RegExp | string) | undefined;
       min?: number | undefined;
+      max?: number | undefined;
       len?: number | undefined;
       enum?: Array<string | number | boolean | null | undefined> | undefined;
       whitespace?: boolean | undefined;
@@ -842,7 +843,6 @@ declare function useSearchState(emits: {
         validator?: ((rule: async_validator0.InternalRuleItem, value: async_validator0.Value, callback: (error?: string | Error) => void, source: async_validator0.Values, options: async_validator0.ValidateOption) => async_validator0.SyncValidateResult | void) | undefined;
       }[] | undefined;
       transform?: ((value: async_validator0.Value) => async_validator0.Value) | undefined;
-      message?: string | ((a?: string) => string) | undefined;
       key?: string | undefined;
       trigger?: (naive_ui_es_form_src_interface0.ValidationTrigger | string | Array<naive_ui_es_form_src_interface0.ValidationTrigger | string>) | undefined;
       validator?: naive_ui_es_form_src_interface0.FormItemRuleValidator | undefined;

package/dist/useSearchState.d.ts

@@ -92,9 +92,9 @@ declare const __VLS_export: vue.DefineComponent<FormSearchProps, {
   onReset?: (() => any) | undefined;
   "onChange-params"?: ((params: SearchFormParams) => any) | undefined;
 }>, {
-  loading: boolean;
   size: "small" | "medium" | "large";
   bordered: boolean;
+  loading: boolean;
   formItemList: SearchFormItem[];
   formParams: SearchFormParams;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -273,6 +273,7 @@ declare function useSearchState(emits: {
     rules?: {
       type?: RuleType | undefined;
       required?: boolean | undefined;
+      message?: string | ((a?: string) => string) | undefined;
       options?: {
         suppressWarning?: boolean | undefined;
         suppressValidatorError?: boolean | undefined;
@@ -328,9 +329,9 @@ declare function useSearchState(emits: {
         keys?: string[] | undefined;
         error?: ((rule: InternalRuleItem, message: string) => ValidateError) | undefined;
       } | undefined;
-      max?: number | undefined;
       pattern?: (RegExp | string) | undefined;
       min?: number | undefined;
+      max?: number | undefined;
       len?: number | undefined;
       enum?: Array<string | number | boolean | null | undefined> | undefined;
       whitespace?: boolean | undefined;
@@ -477,7 +478,6 @@ declare function useSearchState(emits: {
         validator?: ((rule: InternalRuleItem, value: Value, callback: (error?: string | Error) => void, source: Values, options: ValidateOption) => SyncValidateResult | void) | undefined;
       }[] | undefined;
       transform?: ((value: Value) => Value) | undefined;
-      message?: string | ((a?: string) => string) | undefined;
       key?: string | undefined;
       trigger?: (naive_ui_es_form_src_interface0.ValidationTrigger | string | Array<naive_ui_es_form_src_interface0.ValidationTrigger | string>) | undefined;
       validator?: naive_ui_es_form_src_interface0.FormItemRuleValidator | undefined;
@@ -504,6 +504,7 @@ declare function useSearchState(emits: {
     rules?: {
       type?: RuleType | undefined;
       required?: boolean | undefined;
+      message?: string | ((a?: string) => string) | undefined;
       options?: {
         suppressWarning?: boolean | undefined;
         suppressValidatorError?: boolean | undefined;
@@ -559,9 +560,9 @@ declare function useSearchState(emits: {
         keys?: string[] | undefined;
         error?: ((rule: InternalRuleItem, message: string) => ValidateError) | undefined;
       } | undefined;
-      max?: number | undefined;
       pattern?: (RegExp | string) | undefined;
       min?: number | undefined;
+      max?: number | undefined;
       len?: number | undefined;
       enum?: Array<string | number | boolean | null | undefined> | undefined;
       whitespace?: boolean | undefined;
@@ -708,7 +709,6 @@ declare function useSearchState(emits: {
         validator?: ((rule: InternalRuleItem, value: Value, callback: (error?: string | Error) => void, source: Values, options: ValidateOption) => SyncValidateResult | void) | undefined;
       }[] | undefined;
       transform?: ((value: Value) => Value) | undefined;
-      message?: string | ((a?: string) => string) | undefined;
       key?: string | undefined;
       trigger?: (naive_ui_es_form_src_interface0.ValidationTrigger | string | Array<naive_ui_es_form_src_interface0.ValidationTrigger | string>) | undefined;
       validator?: naive_ui_es_form_src_interface0.FormItemRuleValidator | undefined;
@@ -747,6 +747,7 @@ declare function useSearchState(emits: {
     rules?: {
       type?: RuleType | undefined;
       required?: boolean | undefined;
+      message?: string | ((a?: string) => string) | undefined;
       options?: {
         suppressWarning?: boolean | undefined;
         suppressValidatorError?: boolean | undefined;
@@ -802,9 +803,9 @@ declare function useSearchState(emits: {
         keys?: string[] | undefined;
         error?: ((rule: InternalRuleItem, message: string) => ValidateError) | undefined;
       } | undefined;
-      max?: number | undefined;
       pattern?: (RegExp | string) | undefined;
       min?: number | undefined;
+      max?: number | undefined;
       len?: number | undefined;
       enum?: Array<string | number | boolean | null | undefined> | undefined;
       whitespace?: boolean | undefined;
@@ -951,7 +952,6 @@ declare function useSearchState(emits: {
         validator?: ((rule: InternalRuleItem, value: Value, callback: (error?: string | Error) => void, source: Values, options: ValidateOption) => SyncValidateResult | void) | undefined;
       }[] | undefined;
       transform?: ((value: Value) => Value) | undefined;
-      message?: string | ((a?: string) => string) | undefined;
       key?: string | undefined;
       trigger?: (naive_ui_es_form_src_interface0.ValidationTrigger | string | Array<naive_ui_es_form_src_interface0.ValidationTrigger | string>) | undefined;
       validator?: naive_ui_es_form_src_interface0.FormItemRuleValidator | undefined;

package/dist/useSignatureHistory.d.cts

@@ -3,9 +3,9 @@ import { Ref } from "vue";
 
 //#region src/components/C_Signature/types.d.ts
 /** 画笔模式 */
-type PenMode = "pen" | "eraser";
+type PenMode = 'pen' | 'eraser';
 /** 导出格式 */
-type SignatureExportFormat = "png" | "jpeg" | "svg" | "blob";
+type SignatureExportFormat = 'png' | 'jpeg' | 'svg' | 'blob';
 /** 画笔配置 */
 interface PenConfig {
   color: string;
@@ -22,7 +22,7 @@ interface WatermarkConfig {
   text: string;
   fontSize: number;
   color: string;
-  position: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+  position: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 }
 /** 导出配置 */
 interface ExportOptions {
@@ -80,19 +80,21 @@ interface SignatureExpose {
 }
 /** 组件事件 */
 interface SignatureEmits {
-  "start-draw": [];
+  'start-draw': [];
   drawing: [point: SignaturePoint];
-  "end-draw": [stroke: SignatureStroke];
+  'end-draw': [stroke: SignatureStroke];
   clear: [];
   undo: [];
   redo: [];
   change: [data: SignatureStroke[]];
+  error: [error: Error];
 }
 //#endregion
 //#region src/components/C_Signature/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<SignatureProps, SignatureExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   clear: () => any;
   change: (data: SignatureStroke[]) => any;
+  error: (error: Error) => any;
   "start-draw": () => any;
   drawing: (point: SignaturePoint) => any;
   "end-draw": (stroke: SignatureStroke) => any;
@@ -101,15 +103,16 @@ declare const __VLS_export: vue.DefineComponent<SignatureProps, SignatureExpose,
 }, string, vue.PublicProps, Readonly<SignatureProps> & Readonly<{
   onClear?: (() => any) | undefined;
   onChange?: ((data: SignatureStroke[]) => any) | undefined;
+  onError?: ((error: Error) => any) | undefined;
   "onStart-draw"?: (() => any) | undefined;
   onDrawing?: ((point: SignaturePoint) => any) | undefined;
   "onEnd-draw"?: ((stroke: SignatureStroke) => any) | undefined;
   onUndo?: (() => any) | undefined;
   onRedo?: (() => any) | undefined;
 }>, {
-  width: number | string;
-  height: number | string;
   disabled: boolean;
+  height: number | string;
+  width: number | string;
   readonly: boolean;
   showToolbar: boolean;
   maxHistory: number;
@@ -122,10 +125,15 @@ interface UseSignatureCanvasOptions {
   penConfig: Ref<PenConfig>;
   mode: Ref<PenMode>;
   disabled: Ref<boolean>;
+  backgroundImage?: Ref<HTMLImageElement | null>;
+  importedImage?: Ref<HTMLImageElement | null>;
   onStrokeComplete: (stroke: SignatureStroke) => void;
   onDrawStart: () => void;
   onDrawing: (point: SignaturePoint) => void;
 }
+type StrokeView = Omit<SignatureStroke, 'points'> & {
+  readonly points: readonly SignaturePoint[];
+};
 /**
  *
  */
@@ -134,7 +142,7 @@ declare function useSignatureCanvas(options: UseSignatureCanvasOptions): {
   initCanvas: () => void;
   bindEvents: () => void;
   unbindEvents: () => void;
-  redrawStrokes: (strokes: SignatureStroke[]) => void;
+  redrawStrokes: (strokes: readonly StrokeView[]) => void;
   clearCanvas: () => void;
 };
 //#endregion

package/dist/useSignatureHistory.d.ts

@@ -3,9 +3,9 @@ import { Ref } from "vue";
 
 //#region src/components/C_Signature/types.d.ts
 /** 画笔模式 */
-type PenMode = "pen" | "eraser";
+type PenMode = 'pen' | 'eraser';
 /** 导出格式 */
-type SignatureExportFormat = "png" | "jpeg" | "svg" | "blob";
+type SignatureExportFormat = 'png' | 'jpeg' | 'svg' | 'blob';
 /** 画笔配置 */
 interface PenConfig {
   color: string;
@@ -22,7 +22,7 @@ interface WatermarkConfig {
   text: string;
   fontSize: number;
   color: string;
-  position: "top-left" | "top-right" | "bottom-left" | "bottom-right";
+  position: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
 }
 /** 导出配置 */
 interface ExportOptions {
@@ -80,19 +80,21 @@ interface SignatureExpose {
 }
 /** 组件事件 */
 interface SignatureEmits {
-  "start-draw": [];
+  'start-draw': [];
   drawing: [point: SignaturePoint];
-  "end-draw": [stroke: SignatureStroke];
+  'end-draw': [stroke: SignatureStroke];
   clear: [];
   undo: [];
   redo: [];
   change: [data: SignatureStroke[]];
+  error: [error: Error];
 }
 //#endregion
 //#region src/components/C_Signature/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<SignatureProps, SignatureExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   clear: () => any;
   change: (data: SignatureStroke[]) => any;
+  error: (error: Error) => any;
   "start-draw": () => any;
   drawing: (point: SignaturePoint) => any;
   "end-draw": (stroke: SignatureStroke) => any;
@@ -101,15 +103,16 @@ declare const __VLS_export: vue.DefineComponent<SignatureProps, SignatureExpose,
 }, string, vue.PublicProps, Readonly<SignatureProps> & Readonly<{
   onClear?: (() => any) | undefined;
   onChange?: ((data: SignatureStroke[]) => any) | undefined;
+  onError?: ((error: Error) => any) | undefined;
   "onStart-draw"?: (() => any) | undefined;
   onDrawing?: ((point: SignaturePoint) => any) | undefined;
   "onEnd-draw"?: ((stroke: SignatureStroke) => any) | undefined;
   onUndo?: (() => any) | undefined;
   onRedo?: (() => any) | undefined;
 }>, {
-  width: number | string;
-  height: number | string;
   disabled: boolean;
+  height: number | string;
+  width: number | string;
   readonly: boolean;
   showToolbar: boolean;
   maxHistory: number;
@@ -122,10 +125,15 @@ interface UseSignatureCanvasOptions {
   penConfig: Ref<PenConfig>;
   mode: Ref<PenMode>;
   disabled: Ref<boolean>;
+  backgroundImage?: Ref<HTMLImageElement | null>;
+  importedImage?: Ref<HTMLImageElement | null>;
   onStrokeComplete: (stroke: SignatureStroke) => void;
   onDrawStart: () => void;
   onDrawing: (point: SignaturePoint) => void;
 }
+type StrokeView = Omit<SignatureStroke, 'points'> & {
+  readonly points: readonly SignaturePoint[];
+};
 /**
  *
  */
@@ -134,7 +142,7 @@ declare function useSignatureCanvas(options: UseSignatureCanvasOptions): {
   initCanvas: () => void;
   bindEvents: () => void;
   unbindEvents: () => void;
-  redrawStrokes: (strokes: SignatureStroke[]) => void;
+  redrawStrokes: (strokes: readonly StrokeView[]) => void;
   clearCanvas: () => void;
 };
 //#endregion