@worm-vue3-print/canvas 1.2.2 → 1.3.0

package/dist/composables/useDocumentFontFace.d.ts

@@ -0,0 +1,2 @@
+import { type MaybeRefOrGetter } from 'vue';
+export declare function useDocumentFontFace(css: MaybeRefOrGetter<string>): void;

package/dist/composables/useFontCatalog.d.ts

@@ -0,0 +1,30 @@
+import { type ComputedRef, type MaybeRefOrGetter } from 'vue';
+import type { PrintFontDeclaration } from '@worm-vue3-print/core';
+/** 下拉候选项：family 写入模板，label 仅用于界面展示 */
+export interface FontOption {
+    family: string;
+    label?: string;
+}
+/** 空目录：宿主未声明字体时的兜底 */
+export declare const EMPTY_FONT_CATALOG: ComputedRef<readonly FontOption[]>;
+/**
+ * 由 PrintDesigner 调用：把模板字体声明整理为下拉候选项。
+ * 去空白、丢空值、族名大小写不敏感去重，保留声明顺序（顺序即宿主期望的优先级）。
+ */
+export declare function useFontCatalog(declarations?: MaybeRefOrGetter<readonly PrintFontDeclaration[] | undefined>): {
+    catalog: ComputedRef<readonly FontOption[]>;
+};
+/** 由深层组件调用（属性面板）：未注入时回退空目录，组件可独立挂载 */
+export declare function useInjectedFontCatalog(): ComputedRef<readonly FontOption[]>;
+/** 在目录中按族名查找（大小写不敏感） */
+export declare function findFontOption(fonts: readonly FontOption[], family?: string): FontOption | undefined;
+/** 下拉选项文案：有展示名时补上真实族名（写入模板的值） */
+export declare function fontOptionLabel(option: FontOption): string;
+/** 匹配用键：小写并去掉全部空白，使用户输入 `ya hei` 与 `yahei` 等价 */
+export declare function normalizeFontQuery(value: string): string;
+/**
+ * 模糊过滤字体目录：完全相等 > 前缀 > 子串 > 子序列，同档保持目录原有顺序
+ * （目录顺序由宿主声明决定，过滤不应打乱）。
+ * 族名与展示名（label）都参与匹配，设计者按业务名搜也能命中。
+ */
+export declare function filterFontOptions(fonts: readonly FontOption[], query: string): FontOption[];

package/dist/composables/useHistory.d.ts

@@ -2,6 +2,10 @@ import type { TemplateData } from '@worm-vue3-print/core/designer';
 export interface HistoryState {
     elements: any[];
     templateData?: TemplateData;
+    /** 多页面快照：整份页面数组（深拷贝） */
+    pages?: TemplateData[];
+    /** 多页面快照：录制时的激活页索引 */
+    activePageIndex?: number;
 }
 export interface UseHistoryOptions {
     /** 历史记录上限，默认 50 步 */

package/dist/composables/useHostAdapter.d.ts

@@ -1,4 +1,9 @@
 import type { ComputedRef, InjectionKey } from 'vue';
-import type { UploadImageFn } from '@worm-vue3-print/core/designer';
+import type { UploadDesignBackgroundFn, UploadImageFn } from '@worm-vue3-print/core/designer';
+import type { FontOption } from './useFontCatalog';
 /** 图片上传适配器：PrintDesigner provide，ImageContentUpload inject */
 export declare const UPLOAD_IMAGE_KEY: InjectionKey<ComputedRef<UploadImageFn | undefined>>;
+/** 设计背景上传适配器：PrintDesigner provide，DesignBackgroundConfig inject */
+export declare const UPLOAD_DESIGN_BACKGROUND_KEY: InjectionKey<ComputedRef<UploadDesignBackgroundFn | undefined>>;
+/** 字体目录（模板声明字体）：PrintDesigner provide，属性面板 inject */
+export declare const FONT_CATALOG_KEY: InjectionKey<ComputedRef<readonly FontOption[]>>;

package/dist/composables/useShrinkFit.d.ts

@@ -0,0 +1,6 @@
+import { type Ref } from 'vue';
+/**
+ * @param root 元素根节点（元素级缩小挂在根上，单元格级挂在根的后代上）
+ * @param trigger 依赖采集：字号/尺寸/内容/模式变化时重新适配
+ */
+export declare function useShrinkFit(root: Ref<HTMLElement | null>, trigger: () => unknown): void;