@printine/designer 0.1.0

package/dist/engine/editor.d.ts

@@ -0,0 +1,186 @@
+import fabric from './fabric';
+import '../fabric-types';
+import { Loading, type LoadingOptions } from './utils/loading';
+import { type DesignerEventBus } from './events';
+import { ImageProcessor } from './processors/image';
+import { TemplateProcessor } from './processors/template';
+import { TextProcessor } from './processors/text';
+import { ResizeManager } from './managers/resize';
+import { WorkspaceManager, type WorkspaceManagerOptions } from './managers/workspace';
+import type { Size, TransformBox } from './types';
+import type { Mockup } from '../contracts/api-design';
+export interface EditorOptions {
+    /** Ratio of the shortest canvas edge that the mockup overlay occupies. */
+    overlayScale?: number;
+    /** Packaged asset overrides so a host can serve the spinner from its own CDN. */
+    loading?: LoadingOptions;
+    /** Transparent-pattern asset and DPI overrides for the printable workspace. */
+    workspace?: WorkspaceManagerOptions;
+    /** Editor-scoped event bus. Defaults to the package bus, never a host singleton. */
+    events?: DesignerEventBus;
+}
+/**
+ * Portable Fabric editor for one product placement.
+ *
+ * This is the full editor previously bound to the Printine Next.js app. All
+ * host coupling (routing, aliases, global stores) is replaced by constructor
+ * options, while the Fabric JSON it reads and writes is unchanged.
+ */
+export declare class Editor {
+    canvas: fabric.Canvas;
+    imageProcessor: ImageProcessor;
+    textProcessor: TextProcessor;
+    templateProcessor: TemplateProcessor;
+    resizeManager: ResizeManager;
+    workspaceManager: WorkspaceManager;
+    readonly events: DesignerEventBus;
+    private overlayBorderHandler?;
+    private imageCache;
+    private overlayCache;
+    private overlayScale;
+    private readonly loadingOptions;
+    constructor(container: HTMLCanvasElement, size: Size, target: HTMLDivElement, options?: EditorOptions | number);
+    /** Builds a loading indicator that already carries the package asset configuration. */
+    createLoading(dimension: TransformBox): Loading;
+    /**
+     * 统一拦截图片创建：优先从会话缓存复用已加载的 HTMLImageElement，避免视图切换或导出时重复请求远程图片
+     */
+    private setupImageCacheInterceptor;
+    /**
+     * 渲染 overlayImage（SVG）
+     * @param mockup 模板信息
+     * @param changeView 是否切换视图，如果为 true，则需要重新设置画布和背景图
+     */
+    renderOverlayImage(mockup: Mockup, changeView?: boolean): Promise<void>;
+    /**
+     * 获取 overlay 图：优先使用会话级缓存，避免重复网络请求
+     * 会返回深拷贝，确保不同视图间互不影响
+     */
+    private getOverlayImage;
+    /**
+     * 绘制可设计区域边框，优先使用 clipPath 的真实形状
+     */
+    private setupOverlayBorders;
+    /**
+     * 设置背景遮罩
+     */
+    setBackgroundMask(maskImageUrl: string): Promise<void>;
+    /**
+     * 设置背景颜色、透明图案
+     */
+    setBackground(color: string): Promise<void>;
+    /**
+     * 获取当前选中的对象
+     */
+    get activeObject(): fabric.Object | null;
+    /**
+     * 获取对象经过画布转换后的实际尺寸
+     */
+    getObjectActualSize(obj: fabric.Object): {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+        centerX: number;
+        centerY: number;
+    };
+    /**
+     * 添加对象
+     */
+    addObject(obj: fabric.Object, active?: boolean): void;
+    /**
+     * 恢复对象
+     */
+    restoreObject(obj: any): Promise<fabric.Object[]>;
+    /**
+     * 清理图片 blob URL（只清理不在缓存中的临时 blob）
+     */
+    revokeImgBlobLink(obj: fabric.Object): void;
+    /**
+     * 删除对象，默认是当前选中的对象
+     */
+    deleteObject: (id?: string) => void;
+    /**
+     * 修改对象的属性
+     */
+    updateObject(id: string, obj: Record<string, any>): void;
+    /**
+     * 对象缩放
+     */
+    updateObjectScale(obj: fabric.Object, scale: number): void;
+    /**
+     * 修改画布上的对象的选中状态和事件状态
+     */
+    updateObjectsEvents(status: boolean): void;
+    /**
+     * 获取当前可选择的对象，不包括背景图、裁剪区域
+     */
+    getLayerList(): fabric.Object[];
+    /**
+     * 设置当前选中的对象
+     */
+    setActiveObject(id: string): void;
+    /**
+     * 同时选中多个对象
+     */
+    setActiveObjects(objects: fabric.Object[]): void;
+    /**
+     * 以画布中心点缩放画布
+     */
+    zoomToCenter(zoom: number): void;
+    /**
+     * 获取当前画布上渲染的对象
+     */
+    getRenderedObjects(): Record<string, any>;
+    /**
+     * 清空当前画布
+     */
+    clearCanvas(): void;
+    /**
+     * 将图片对象的 clipPath 重新关联到画布上的对象
+     */
+    relinkClipPaths(): void;
+    /**
+     * 切换视图，重新渲染画布
+     */
+    switchView(mockup: Mockup, color: string, state: Record<string, any> | undefined): Promise<void>;
+    /**
+     * 根据 workspace 尺寸变化，按比例缩放所有对象
+     */
+    private _scaleObjectsToWorkspace;
+    /**
+     * 计算对象相对于画布的全局变换矩阵（包括父组的影响）
+     */
+    private getGlobalTransformMatrix;
+    /**
+     * 判断对象是否位于 activeSelection 中
+     */
+    private isInActiveSelection;
+    /**
+     * 注册图片到缓存（会话级缓存，整个编辑期间保持）
+     */
+    registerImageCache(src: string, img: fabric.Image, blobUrl?: string): void;
+    /**
+     * 清除整个图片缓存（在关闭编辑器时调用）
+     */
+    clearImageCache(): void;
+    /**
+     * 销毁编辑器，释放所有资源
+     */
+    destroy(): void;
+    /**
+     * 按需生成图片 dataURL（不缓存，减少内存占用）
+     */
+    private getCachedDataURL;
+    /**
+     * 从缓存克隆图片，避免重复下载
+     */
+    private cloneImageFromCache;
+    /**
+     * 导出 clipPath 区域内容（按打印区域原始尺寸）
+     * @param embedImages 是否将图片转为 dataURL 内嵌
+     * @param color 背景颜色
+     */
+    export(embedImages?: boolean, color?: string): Promise<string | ImageBitmap>;
+}
+export default Editor;