@jetprint/editor-sdk 1.0.0

package/dist/components/Editor/liveRender/types.d.ts

@@ -0,0 +1,130 @@
+export declare enum EPartType {
+    Drawing = 0,
+    Material = 1
+}
+export interface IPart {
+    id: number;
+    name: string;
+    url?: string;
+    designArea?: string;
+    pureUrl?: string;
+    width?: number;
+    height?: number;
+    partType?: EPartType;
+}
+export interface IPoint {
+    x: number;
+    y: number;
+    type?: number;
+}
+export interface IPuppetShape {
+    originalVertexArray: IPoint[];
+    deformedVertexArray: IPoint[];
+    indexArray: number[];
+}
+export interface IFilter {
+    type?: string;
+    enabled?: boolean;
+    filter?: {
+        puppetShapeList?: IPuppetShape[];
+    };
+    puppetShapeList?: IPuppetShape[];
+}
+export interface ISmartObject {
+    transform: number[];
+    meshPoints?: IPoint[];
+    bounds: IBounds;
+    quiltSliceX?: number[];
+    quiltSliceY?: number[];
+    size?: {
+        width: number;
+        height: number;
+    };
+    imagePath?: string;
+    filterList?: IFilter[];
+    puppet?: IFilter;
+}
+export interface IPsdPartData {
+    id: number;
+    partId?: number;
+    name: string;
+    vectorMaskPath?: IPoint[];
+    smartObjects?: ISmartObject[];
+    type: EPsdDataType;
+    width?: number;
+    height?: number;
+    x?: number;
+    y?: number;
+    url?: string;
+    blendMode?: string;
+    opacity?: number;
+    clipping?: boolean;
+}
+export interface IBounds {
+    top: number;
+    left: number;
+    bottom: number;
+    right: number;
+    width: number;
+    height: number;
+}
+export declare enum EPsdDataType {
+    Group = 0,
+    Layer = 1
+}
+export interface IPsdModelData {
+    width: number;
+    height: number;
+    psdPartData?: IPsdPartData[];
+}
+export interface IModelData {
+    parts: IPart[];
+    models: IPsdModelData[];
+}
+/** 与 dataAdapter.ts 中 INewData 一致，供 ThreeRenderViewer 使用 */
+export interface INewData {
+    name: string;
+    jsonURL: string;
+    sort: number;
+    resources: {
+        name: string;
+        url: string;
+    }[];
+}
+export interface IDeformationLayer {
+    name: string;
+    type: string;
+    bounds: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+    opacity?: number;
+    imagePath?: string;
+    layerOrder?: number;
+    id?: number;
+    children?: IDeformationLayer[];
+    isSmartObject?: boolean;
+    transform?: number[];
+    meshPoints?: {
+        x: number;
+        y: number;
+    }[];
+    quiltSliceX?: number[];
+    quiltSliceY?: number[];
+    size?: {
+        width: number;
+        height: number;
+    };
+    vectorMask?: any;
+    blendMode?: string;
+    clipping?: boolean;
+    filterList?: IFilter[];
+    puppet?: IFilter;
+}
+export interface IDeformationData {
+    canvasWidth: number;
+    canvasHeight: number;
+    layerList: IDeformationLayer[];
+}

package/dist/components/Editor/utils/blob.d.ts

@@ -0,0 +1,5 @@
+export declare const readBlobAsDataUrl: (blob: Blob) => Promise<string>;
+export declare const loadImageFromBlob: (blob: Blob) => Promise<HTMLImageElement>;
+/** 将 PNG/JPEG 等 data URL 转为 Blob（供 Fabric toDataURL 结果上传或调试） */
+export declare const dataUrlToBlob: (dataUrl: string) => Blob;
+export declare const canvasToBlob: (canvasEl: HTMLCanvasElement, type?: string, quality?: number) => Promise<Blob>;

package/dist/components/Editor/utils/buildSplitPieceDesignClipBlobs.d.ts

@@ -0,0 +1,75 @@
+/**
+ * 主画布（无引导层）按 Guideline bounds 裁切 + MASK destination-in 抠格栅。
+ * DOTTED_LINE 仅供编辑器叠层示意，导出 Blob 不叠虚线，避免成品带绿线/稿线。
+ * 仅 DOTTED_LINE、无 MASK 时用其 alpha 做 destination-in 抠图（不叠画线）。
+ * 供单片预览 fabricScreenshotList 与调试导出共用。
+ * 导出主画布时 useIdentityViewport：优先离屏克隆 + 单位视口 toBlob（fabricMainCanvasSnapshot），
+ * 裁切用 mapGuidelineBoundsToTargetRect，与 Guideline 一致且不闪主画布。
+ */
+import type { Canvas } from 'fabric';
+import { type SplitMaskSliceEntry } from './dataBuilders';
+export type SplitPieceDesignClipBlob = {
+    id: number;
+    name: string;
+    blob: Blob;
+};
+type PsdJson = {
+    canvasWidth?: number;
+    canvasHeight?: number;
+    layerList?: unknown[];
+};
+/** 分片抠图主画布 Fabric toBlob 倍率上限（平铺等场景提高清晰度，代价为体积/内存/耗时） */
+export declare const SPLIT_PIECE_EXPORT_MULTIPLIER_MAX = 1;
+/**
+ * 将分片导出倍率限制在 [1, SPLIT_PIECE_EXPORT_MULTIPLIER_MAX]。
+ * 未传或非法时默认用上限，以在可接受成本内尽量减轻平铺糊边。
+ */
+export declare function clampSplitPieceExportMultiplier(n?: number): number;
+export declare function splitSlicesReadyForClips(splitCfg: {
+    slicesByGroupId: Map<string, SplitMaskSliceEntry>;
+}, childrenWithBounds: Array<{
+    id: number;
+    name: string;
+    bounds: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+}>): boolean;
+/**
+ * 在已有主画布位图（与逻辑画布比例一致，如 Fabric toBlob）上按 SPLIT 配置生成每片 PNG Blob。
+ */
+export declare function buildSplitPieceDesignClipBlobsFromBaseBitmap(baseBitmap: ImageBitmap, options: {
+    loadImage: (url: string) => Promise<HTMLImageElement>;
+    toProxyUrl: (url: string) => string;
+    psdJson: PsdJson;
+    layerList: unknown[];
+    childrenWithBounds: Array<{
+        id: number;
+        name: string;
+        bounds: {
+            left: number;
+            top: number;
+            width: number;
+            height: number;
+        };
+    }>;
+    slicesByGroupId: Map<string, SplitMaskSliceEntry>;
+}): Promise<SplitPieceDesignClipBlob[]>;
+/**
+ * 从当前 Fabric 画布导出：隐藏引导层整图 PNG → 按 SPLIT + Guideline 生成每片抠图 Blob。
+ */
+export declare function buildSplitPieceDesignClipBlobs(options: {
+    canvas: Canvas;
+    diecutData: any;
+    selectedSize?: string;
+    toProxyUrl: (url: string) => string;
+    loadImage: (url: string) => Promise<HTMLImageElement>;
+    guideResourceRole?: string;
+    /** 主画布导出倍率，默认 {@link SPLIT_PIECE_EXPORT_MULTIPLIER_MAX}，上限同常量 */
+    exportMultiplier?: number;
+    /** 已编辑的 Guideline 全量对象（与 templateJsonByUrlKey 同源）；传入则不再 fetch jsonURL */
+    splitGuidelineJson?: Record<string, unknown> | null;
+}): Promise<SplitPieceDesignClipBlob[]>;
+export {};

package/dist/components/Editor/utils/colorLabels.d.ts

@@ -0,0 +1,6 @@
+import type { BasicInfo } from '../../../types';
+/**
+ * 根据 basicInfo 中的 colors / colorNamesEn 下标解析展示用中文名。
+ * option 的 value 仍使用英文 color key（与 deformation 一致）。
+ */
+export declare function resolveBasicInfoColorLabel(colorKey: string, basic: BasicInfo | null | undefined): string;

package/dist/components/Editor/utils/dataBuilders.d.ts

@@ -0,0 +1,108 @@
+import type { IMaterial } from '../../../utils/renderService';
+export declare const normalizeLayerName: (name: string) => string;
+export declare const buildMaterialList: (resources?: any[]) => IMaterial[];
+export type MaskResource = {
+    groupId?: string;
+    groupName?: string;
+    url?: string;
+    type?: string;
+    width?: number;
+    height?: number;
+};
+export type MaskGroup = {
+    id: string;
+    name: string;
+    mask?: MaskResource;
+};
+export declare const buildMaskGroups: (diecutData: any, selectedSize?: string | string[]) => MaskGroup[];
+export type PsdLayer = {
+    id?: number;
+    name?: string;
+    type?: string;
+    children?: PsdLayer[];
+    bounds?: {
+        left?: number;
+        top?: number;
+        width?: number;
+        height?: number;
+    };
+};
+export declare const collectGroupIdByName: (layersList: PsdLayer[], map?: Map<string, number>) => Map<string, number>;
+/**
+ * 单片（COMPLETE）模式下将 layerList 转为与多片一致的结构：把 split 的 children 提到顶层，去掉 complete 组
+ * 这样 psdJsonLayers 会得到 bg + Front/Left-1/Left-2/Back/Right 等顶层 Group，与多片一致
+ */
+export declare const normalizeLayerListForComplete: (layerList: PsdLayer[] | undefined) => PsdLayer[];
+/** 从刀板数据中取 COMPLETE 类型：jsonURL 用于拉取 PSD；用 MASK 资源做遮罩内部取图（与多图一致），DOTTED_LINE 仅作尺寸参考。多尺码时传 selectedSize 以匹配当前尺码的 groupId */
+export declare const getCompleteDottedLine: (diecutData: any, selectedSize?: string | string[]) => {
+    jsonURL: string;
+    maskImageUrl: string;
+    maskWidth: number;
+    maskHeight: number;
+} | null;
+/** Guideline / 模板 JSON 的 PSD 画布尺寸（与单片预览裁切一致） */
+export declare const getGuidelinePsdCanvasSize: (layerList: PsdLayer[] | undefined, psdJson: {
+    canvasWidth?: number;
+    canvasHeight?: number;
+}) => {
+    psdW: number;
+    psdH: number;
+};
+export type GuidelineBounds = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+/**
+ * 将 Guideline 的 PSD 画布 (psdW×psdH) 等比装入目标矩形 (contain)，返回统一缩放与居中偏移，
+ * 避免目标画布宽高比与 PSD 不一致时对坐标各向异性拉伸。
+ */
+export declare const getGuidelineContainTransform: (psdW: number, psdH: number, targetW: number, targetH: number) => {
+    scale: number;
+    offsetX: number;
+    offsetY: number;
+};
+/** 将 PSD 坐标系下的 bounds 映射到目标画布上的轴对齐矩形（与分片蒙版 / 裁切同源） */
+export declare const mapGuidelineBoundsToTargetRect: (bounds: GuidelineBounds, psdW: number, psdH: number, targetW: number, targetH: number) => {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+/** 在 layerList 中找 name 为 "split" 的 Group，返回其 children（有 id 的 Group）及每个的有效 bounds */
+export declare const getSplitChildrenWithBounds: (layerList: PsdLayer[] | undefined, layerName?: string) => Array<{
+    id: number;
+    name: string;
+    bounds: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    };
+}>;
+/** SPLIT 条目中按 groupId 聚合的蒙版/虚线资源，供单片预览按分片 destination-in（无整片 COMPLETE MASK 时） */
+export type SplitMaskSliceEntry = {
+    groupId: string;
+    groupName: string;
+    maskUrl: string;
+    maskWidth: number;
+    maskHeight: number;
+    dottedLineUrl?: string;
+    dottedLineWidth?: number;
+    dottedLineHeight?: number;
+};
+/**
+ * 从刀板 data 中取 SPLIT：jsonURL 与 Guideline 一致；每 groupId 至少 MASK（含宽高）或 DOTTED_LINE（含 url，宽高可与 MASK 同源）之一。
+ * 若 SPLIT 缺失或任一组两者皆无有效尺寸，返回 null（调用方可回退为 COMPLETE 整图引导资源）。
+ */
+export declare const getSplitMaskSlicesConfig: (diecutData: any, selectedSize?: string | string[]) => {
+    jsonURL: string;
+    slicesByGroupId: Map<string, SplitMaskSliceEntry>;
+} | null;
+/** Fabric 画布左上 → Guideline PSD 坐标（宽/高保持 PSD 不变，与 mapGuidelineBoundsToTargetRect 互逆） */
+export declare function fabricTopLeftToGuidelinePsdBounds(fabricLeft: number, fabricTop: number, canvasW: number, canvasH: number, psdW: number, psdH: number, widthPsd: number, heightPsd: number): GuidelineBounds;
+/**
+ * 按当前分片蒙版在 Fabric 上的 left/top，回写 Guideline JSON 中对应 group 的 PSD bounds（与 getSplitChildrenWithBounds 同源）
+ */
+export declare function updateSplitPieceChildBoundsInPsdJson(psdJson: Record<string, unknown>, groupId: number, fabricLeft: number, fabricTop: number, canvasW: number, canvasH: number, splitLayerName?: string): boolean;

package/dist/components/Editor/utils/designRestoreScale.d.ts

@@ -0,0 +1,42 @@
+export type GuidelineContainTransform = {
+    scale: number;
+    offsetX: number;
+    offsetY: number;
+};
+export type MaskAnchorRect = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+export declare function isPatternRectObject(obj: any): boolean;
+/** 平铺层：同步 patternPhase / patternScale / gap（与 useCanvasViewport 窗口 resize 同源） */
+export declare function scalePatternLayerContentForContainResize(obj: any, oldT: GuidelineContainTransform, newT: GuidelineContainTransform, scaleRatio: number): boolean;
+export declare function scalePatternLayerContentForMaskRectResize(obj: any, rect0: MaskAnchorRect, rect1: MaskAnchorRect, scaleRatio: number): boolean;
+/** PatternLayer 用 width/height 定尺寸，还原时需与 phase 一并缩放覆盖矩形 */
+export declare function applyMaskRectAnchoredPatternLayerGeometryRestore(obj: any, rect0: MaskAnchorRect, rect1: MaskAnchorRect): void;
+export declare function applyPsdContainAwarePatternLayerGeometryRestore(obj: any, t0: GuidelineContainTransform, t1: GuidelineContainTransform): void;
+export declare function scalePatternLayerContentForLogicalAxesResize(obj: any, sx: number, sy: number): boolean;
+export declare function applyDesignRestoreLogicalAxesPatternLayerGeometryRestore(obj: any, sx: number, sy: number): void;
+/** SPLIT 蒙版锚点：平铺内容与覆盖矩形一并映射 */
+export declare function restorePatternLayerForMaskRectResize(obj: any, rect0: MaskAnchorRect, rect1: MaskAnchorRect): void;
+/** PSD contain：平铺内容与覆盖矩形一并映射 */
+export declare function restorePatternLayerForPsdContain(obj: any, t0: GuidelineContainTransform, t1: GuidelineContainTransform): void;
+/** 逻辑画布宽高比变化：平铺内容与覆盖矩形一并映射 */
+export declare function restorePatternLayerForLogicalAxes(obj: any, sx: number, sy: number): void;
+/**
+ * 与分片蒙版/虚线同源：用 PSD 在「保存时画布」与「当前画布」上的 contain 变换 (T0→T1)，
+ * 将用户对象的 left/top 与 scale 从保存坐标系映射到当前坐标系，避免仅用 W 比例导致与 mapGuidelineBoundsToTargetRect 不一致。
+ */
+export declare function applyPsdContainAwareUserRestore(obj: any, t0: GuidelineContainTransform, t1: GuidelineContainTransform): void;
+/**
+ * SPLIT 单片蒙版路径：与 `mapGuidelineBoundsToTargetRect` 得到的图稿区矩形 rect0（保存画布）→ rect1（当前画布）对齐。
+ * 以矩形左上角为锚做统一缩放，避免整 PSD 的 contain 与分片 `psdW×psdH` contain 不一致导致与刀线/绿线差一截。
+ */
+export declare function applyMaskRectAnchoredUserRestore(obj: any, rect0: MaskAnchorRect, rect1: MaskAnchorRect): void;
+/**
+ * 按保存时逻辑画布 → 当前逻辑画布映射还原对象。
+ * - 位置：left×sx、top×sy（宽高比与画布一致时 sy 常为 1）。
+ * - 缩放：scaleX/scaleY **同乘 sx**（以逻辑宽比为统一倍率），避免 sx≠sy 时对 X/Y 分别乘 scale 把原等比内容拉成扁条。
+ */
+export declare function applyDesignRestoreLogicalAxesScale(obj: any, sx: number, sy: number): void;

package/dist/components/Editor/utils/editorShortcutChord.d.ts

@@ -0,0 +1,9 @@
+/** 与 Ctrl/Cmd 统一为 Mod，便于跨平台存储与匹配 */
+export declare const CHORD_MOD = "Mod";
+/** 从 KeyboardEvent 生成稳定弦（顺序：Alt、Mod、Shift、code） */
+export declare function chordFromKeyboardEvent(e: KeyboardEvent): string;
+export declare function isModifierOnlyCode(code: string): boolean;
+/** 将 Physical key code 转为展示用短标签 */
+export declare function formatCodeToken(code: string): string;
+/** 和弦展示：Win 为 Ctrl，Mac 为 ⌘ */
+export declare function formatChordForDisplay(chord: string | null | undefined, isMac: boolean): string;

package/dist/components/Editor/utils/editorShortcutIds.d.ts

@@ -0,0 +1,2 @@
+export declare const EDITOR_SHORTCUT_ACTION_IDS: readonly ["layer_crop", "duplicate_layer", "delete_selected_layer", "layer_top", "layer_bottom", "layer_up", "layer_down", "undo", "redo", "nudge_up", "nudge_down", "nudge_left", "nudge_right", "add_text", "clear_canvas", "clear_guides", "zoom_in", "zoom_out", "fit_canvas", "export_png"];
+export type EditorShortcutActionId = (typeof EDITOR_SHORTCUT_ACTION_IDS)[number];

package/dist/components/Editor/utils/editorShortcutRegistry.d.ts

@@ -0,0 +1,15 @@
+import type { EditorShortcutActionId } from './editorShortcutIds';
+export type ShortcutRegistryItem = {
+    id: EditorShortcutActionId;
+    /** i18n：与 en/zh 等共用同一 key */
+    labelKey: string;
+    defaultChord: string;
+    aliasChords?: string[];
+};
+export type ShortcutRegistryCategory = {
+    /** i18n category title */
+    categoryKey: string;
+    items: ShortcutRegistryItem[];
+};
+export declare const EDITOR_SHORTCUT_REGISTRY: ShortcutRegistryCategory[];
+export declare function getDefaultChordById(): Record<EditorShortcutActionId, string>;

package/dist/components/Editor/utils/editorSizeOptions.d.ts

@@ -0,0 +1,27 @@
+/** 编辑器尺码：与刀板里的 "default" 占位一致，大小写不敏感 */
+/** theme1 产品面板「全部」选项值（颜色 / 尺码共用） */
+export declare const SKU_ALL_VALUE = "all";
+export declare function isDefaultSizeLabel(s: string): boolean;
+/** 与 isDefaultSizeLabel 同义，供颜色 SKU 复用 */
+export declare const isDefaultSkuLabel: typeof isDefaultSizeLabel;
+export declare function countConcreteSkuOptions(options: string[]): number;
+/** 存在 ≥2 个具体 SKU（排除 default）时展示「全部」 */
+export declare function shouldShowSkuAllOption(options: string[]): boolean;
+export declare function appendSkuAllOptionIfNeeded(options: string[]): string[];
+/** 解析为可用于 deformation / 刀版 / 预览 的具体 SKU；选中 all 时取第一个具体项 */
+export declare function resolveConcreteSkuOption(selected: string, options: string[]): string;
+/** 刀版 / SPLIT 筛选：选中「全部」尺码时不按 size 字段过滤 */
+export declare function skuSizeFilterForDiecut(selectedSize?: string): string | undefined;
+/** 刀版 data 项是否匹配当前尺码筛选（支持多选数组） */
+export declare function skuMatchesDiecutFilter(selectedSize?: string | string[], itemSize?: string | null): boolean;
+/** 多选列表展开「全部」为具体 SKU 值（不含 all 占位） */
+export declare function normalizeSkuMultiSelection(selected: string[], allOptions: string[]): string[];
+/** 复选框是否勾选 */
+export declare function isSkuMultiOptionChecked(selected: string[], option: string, allOptions: string[]): boolean;
+/** 切换复选项；至少保留一项 */
+export declare function toggleSkuMultiSelection(selected: string[], option: string, allOptions: string[]): string[];
+export declare function isValidSkuSelection(selected: string, options: string[]): boolean;
+/** 存在具体尺码时从下拉/联动列表中移除 default，避免与 S、M 等并列 */
+export declare function filterSizesHideDefaultWhenConcrete(sizes: string[]): string[];
+/** 初始或修正选中值：有具体尺码时优先第一个具体尺码，否则保留 default 或首项 */
+export declare function pickPreferredEditorSize(sizes: string[]): string;

package/dist/components/Editor/utils/fabricMainCanvasSnapshot.d.ts

@@ -0,0 +1,48 @@
+import type { Canvas } from 'fabric';
+export type ExportJsonStateToBlobOptions = {
+    /** 带 file token 的图片加载（与主编辑器一致）；未提供则用默认 crossOrigin 加载 */
+    loadImage?: (url: string) => Promise<HTMLImageElement>;
+    /** 为 true 时不铺 Fabric 画布底色，导出 PNG 带透明通道（分片截图 / 预览贴图） */
+    transparentBackground?: boolean;
+};
+/**
+ * 从序列化的 JSON 状态离屏导出 PNG Blob（不修改主画布）。
+ * 用于复制到其他分片后，为目标分片生成独立的截图。
+ */
+export declare function exportJsonStateToBlob(json: any, options?: ExportJsonStateToBlobOptions): Promise<Blob | null>;
+export type FabricMainCanvasSnapshotOptions = {
+    guideResourceRole?: string;
+    /** 小于 1 时缩小导出，用于拖中轻预览以降低主线程耗时 */
+    multiplier?: number;
+    /**
+     * 为 true 时：优先离屏 StaticCanvas 克隆非引导层对象 + 单位视口 toBlob（不闪主画布）；
+     * 失败时回退为临时 setViewportTransform([1,0,0,1,0,0]) 再导出并恢复。
+     */
+    useIdentityViewport?: boolean;
+    /** 为 true 时不铺 Fabric 画布底色，导出 PNG/WebP 蒙版外区域透明（分片截图、3D 预览） */
+    transparentBackground?: boolean;
+};
+/** 离屏 StaticCanvas 背景：分片导出透明，否则与主画布白底一致便于编辑区导出 */
+export declare function resolveStaticCanvasBackgroundColor(srcAny: {
+    backgroundColor?: string | null;
+}, transparentBackground?: boolean): string | undefined;
+/** 设计导出在画布坐标系中的外接矩形（可含负 left/top），宽/高为 max−min */
+export type DesignExportLogicalSize = {
+    minL: number;
+    minT: number;
+    maxR: number;
+    maxB: number;
+    width: number;
+    height: number;
+};
+/**
+ * 离屏导出 / Zone 裁切共用的逻辑外接框：包含画布 [0,cw)×[0,ch)，并包住非引导层、背景、分片蒙版/虚线；
+ * 支持对象在负坐标（如蒙版移到画布左侧），此时 width = maxR−minL，与离屏 viewport 平移一致。
+ */
+export declare function computeDesignExportLogicalSize(source: Canvas, guideRole?: string): DesignExportLogicalSize;
+/**
+ * 从当前 Fabric 主画布导出 PNG Blob。
+ * 优先使用 Fabric 7 {@link StaticCanvas#toBlob} 的 `filter`，在离屏 canvas 上渲染（不修改引导层 visible），避免闪屏。
+ * 若运行环境无 `toBlob`，回退为临时隐藏引导层 + lowerCanvas `toBlob`。
+ */
+export declare function exportMainFabricCanvasToPngBlob(canvas: Canvas, options?: FabricMainCanvasSnapshotOptions): Promise<Blob | null>;

package/dist/components/Editor/utils/fabricRulerMath.d.ts

@@ -0,0 +1,35 @@
+import type { Canvas } from 'fabric';
+/** 主刻度在屏幕上的目标间距（px） */
+export declare const RULER_TARGET_MAJOR_PX = 72;
+export declare function pickNiceStep(ideal: number): number;
+/**
+ * 将场景坐标映射到 upper canvas 元素内的 CSS 像素（相对元素左上角，左上为 0）。
+ */
+export declare function sceneToCssOnUpperCanvas(canvas: Canvas, sceneX: number, sceneY: number): {
+    x: number;
+    y: number;
+};
+export declare function getSceneXRange(canvas: Canvas): {
+    min: number;
+    max: number;
+};
+export declare function getSceneYRange(canvas: Canvas): {
+    min: number;
+    max: number;
+};
+export declare function formatRulerLabel(n: number): string;
+/**
+ * 用文档客户端坐标映射到场景坐标（可落在视口外）。
+ * 从标尺拖参考线时指针常在标尺条上，须用真实 clientX/Y，勿夹到画布边角。
+ */
+export declare function documentClientToSceneOnCanvas(canvas: Canvas, clientX: number, clientY: number): {
+    x: number;
+    y: number;
+} | null;
+/**
+ * 将视口客户端坐标转为 Fabric 场景坐标（点在 upper canvas 外时先夹到画布内，便于拖参考线到边缘）。
+ */
+export declare function clientToSceneOnUpperCanvas(canvas: Canvas, clientX: number, clientY: number): {
+    x: number;
+    y: number;
+} | null;

package/dist/components/Editor/utils/fabricScreenshotToBlob.d.ts

@@ -0,0 +1,7 @@
+import type { IFabricScreenshot } from '../../../utils/renderService';
+/**
+ * 将预览管线中的 fabricScreenshot 转为可持久化的 Blob。
+ * 顺序：inverseMask 高清缓存 → 可 fetch 的 url → designImage（极速预览兜底）。
+ */
+export declare function fabricScreenshotToBlob(fs: IFabricScreenshot, getInverseMaskBlob?: (groupId: string) => Blob | undefined): Promise<Blob | null>;
+export declare function isPersistableFabricScreenshotUrl(url: string | undefined): boolean;

package/dist/components/Editor/utils/imageLoader.d.ts

@@ -0,0 +1,10 @@
+type CreateImageLoaderOptions = {
+    getFileBaseUrl?: () => string;
+};
+export declare function createImageLoader(options?: CreateImageLoaderOptions): {
+    toProxyUrl: (url: string) => string;
+    resolveImageUrl: (url: string) => Promise<string>;
+    loadImage: (url: string) => Promise<HTMLImageElement>;
+    dispose: () => void;
+};
+export {};

package/dist/components/Editor/utils/objectUtils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 画布对象判断与过滤工具
+ */
+export declare const GUIDE_RESOURCE_ROLE = "guide-resource";
+export declare const GUIDE_ROLE = "guide";
+export declare const GRID_ROLE = "grid";
+export declare function isTextObject(obj: any): boolean;
+/** 普通图片或平铺 pattern 矩形 */
+export declare function isImageLikeObject(obj: any): boolean;
+export declare function isLayerToolTarget(obj: any, guideResourceRole?: string, guideRole?: string): boolean;
+export declare function isCopyableJsonObject(obj: any, guideResourceRole?: string, guideRole?: string, gridRole?: string): boolean;

package/dist/components/Editor/utils/pattern.d.ts

@@ -0,0 +1,56 @@
+import { Pattern } from 'fabric';
+export declare const normalizePatternScale: (value: number) => number;
+export declare const normalizePatternMode: (mode: string) => string;
+export declare const getPatternSourceSize: (source: any) => {
+    width: any;
+    height: any;
+} | null;
+/** 还原/重建平铺层时优先用保存的画布 tile 尺寸，避免用原图像素宽覆盖 patternTileWidth */
+export declare function resolveSavedPatternTileSize(customData: Record<string, unknown> | undefined, sourceSize: {
+    width: number;
+    height: number;
+} | null, runtime?: {
+    patternTileWidth?: number;
+    patternTileHeight?: number;
+}): {
+    tw: number;
+    th: number;
+};
+export type PatternCoverRect = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+};
+/** 平铺层单帧最多绘制的重复块数量，避免小图案/低缩放时一次渲染过多 tile */
+export declare const MAX_PATTERN_TILE_COUNT = 400;
+/**
+ * 将覆盖矩形缩小到不超过 maxTiles 个平铺块，保持原矩形中心不变。
+ */
+export declare function clampPatternCoverRectToMaxTiles(cover: PatternCoverRect, scaledTileW: number, scaledTileH: number, maxTiles?: number): PatternCoverRect;
+/** 当前视口在场景坐标系下的可见矩形 */
+export declare function getViewportVisibleSceneRect(canvas: any): PatternCoverRect | null;
+/** 按当前视口可见区域生成平铺覆盖矩形，并在四周至少扩展 extraTiles 个缩放后的 tile */
+export declare function getPatternViewportCoverRect(canvas: any, tileWidth: number, tileHeight: number, scale: number, extraTiles?: number): PatternCoverRect | null;
+export declare const setPatternCenterOffset: (pattern: any, rectW: number, rectH: number, tileWidth: number, tileHeight: number, scale: number) => void;
+/**
+ * 还原：优先沿用 JSON / 画布对象 fill 上的 offsetX/Y（与普通图层几何一致）；仅新建或无有效 offset 时按画布居中。
+ */
+export declare const applyPatternOffsetFromSavedOrCenter: (pattern: any, canvasW: number, canvasH: number, tileWidth: number, tileHeight: number, scale: number, savedFill: any) => void;
+export declare const buildPatternSource: (img: HTMLImageElement | HTMLCanvasElement, mode: string) => HTMLImageElement | HTMLCanvasElement;
+export declare const createFabricPattern: (source: any, scale: number) => Pattern;
+/** 默认图片加载（离屏导出等无 token 代理场景） */
+export declare function loadImageElement(url: string): Promise<HTMLImageElement | null>;
+/**
+ * loadFromJSON 后 PatternLayer 的 patternElement 会丢失，需从 customData.patternSource 重建。
+ * 主画布切换分片、离屏 JSON 导出截图共用。
+ */
+export declare function rebuildPatternRectsOnCanvas(canvas: any, loadImageFn?: (url: string) => Promise<HTMLImageElement>): Promise<void>;
+/** 从对象获取图案源 URL（图案矩形或图片的 savedSrc/src） */
+export declare function getPatternSourceUrl(obj: any): string;
+/**
+ * 克隆对象用于截图：对图案矩形会重建独立 Pattern；对普通图片若提供 resolveImageToDataUrl 则用 data URL 替换源，避免跨域污染 canvas（如加载设计后画布为 http 图）
+ */
+export declare function cloneObjectForScreenshot(obj: any, loadImage: (url: string) => Promise<HTMLImageElement>, _canvasW: number, _canvasH: number, 
+/** 仅截图路径使用：将 http(s) 图片转为 data URL，避免 tainted canvas */
+resolveImageToDataUrl?: (url: string) => Promise<string>): Promise<any>;

package/dist/components/Editor/utils/scaleSplitClassicGridVisual.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 经典模式（SPLIT）下模板里带 customData.role === 'grid' 的分片格视觉缩放。
+ * 整网以包围盒中心为基准缩小，避免逐格缩放导致错位。
+ */
+export declare const SPLIT_CLASSIC_GRID_VISUAL_SCALE = 0.82;
+/**
+ * 对当前画布上的 grid 层做一次视觉缩放（可重复调用：已打标则跳过）。
+ */
+export declare function applySplitClassicGridVisualScale(canvas: any, scale?: number): void;

package/dist/components/Editor/utils/screenshot.d.ts

@@ -0,0 +1,8 @@
+import type { MaskResource } from './dataBuilders';
+export declare function buildScaledBlob(source: HTMLCanvasElement, maxEdge?: number, canvasToBlobFn?: (c: HTMLCanvasElement, type: string) => Promise<Blob>): Promise<{
+    blob: Blob;
+    width: number;
+    height: number;
+} | null>;
+export declare function buildMaskedScreenshotCanvas(baseSource: string | Blob, mask: MaskResource, canvasW: number, canvasH: number, loadImage: (src: string | Blob) => Promise<HTMLImageElement>): Promise<HTMLCanvasElement | null>;
+export declare function buildMaskedScreenshotBlob(baseSource: string | Blob, mask: MaskResource, canvasW: number, canvasH: number, loadImage: (src: string | Blob) => Promise<HTMLImageElement>, canvasToBlobFn?: (c: HTMLCanvasElement, type: string) => Promise<Blob>): Promise<Blob | null>;

package/dist/components/Editor/utils/selectionVisual.d.ts

@@ -0,0 +1,7 @@
+/** 用户可编辑图层选中框控制点样式（与 Fabric 默认 ~13px 区分） */
+export declare const OBJECT_SELECTION_BORDER_SCALE_FACTOR = 3;
+export declare const OBJECT_SELECTION_CORNER_SIZE = 30;
+export declare const OBJECT_SELECTION_TOUCH_CORNER_SIZE = 36;
+export declare function applyObjectSelectionVisual(obj: any): void;
+/** 平铺层：隐藏 cover 外框与缩放/旋转控制点，仅保留 _render 内单格虚线提示 */
+export declare function applyPatternLayerSelectionVisual(obj: any): void;

package/dist/components/Editor/utils/tintMaskWithColor.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 将带 alpha 的 mask 图像染成纯色（保留轮廓），供填充工具生成 Fabric Image。
+ */
+export declare function tintMaskWithColor(srcEl: HTMLImageElement | HTMLCanvasElement, color: string): HTMLCanvasElement | null;

package/dist/components/Editor/utils/uploadLimit.d.ts

@@ -0,0 +1,4 @@
+export declare const MAX_IMAGE_UPLOAD_SIZE_MB = 20;
+export declare const MAX_IMAGE_UPLOAD_BYTES: number;
+export declare function isImageFileTooLarge(file: File | null | undefined): file is File;
+export declare function formatImageUploadSizeLimit(): string;