@jieyin/editor-sdk 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import type { App } from 'vue';
+import Editor from './components/Editor/index.vue';
+export * from './types';
+export * from './utils/renderService';
+export * from './utils/fileToken';
+export { Editor };
+export declare const install: (app: App) => void;
+declare const _default: {
+    install: (app: App) => void;
+    Editor: import("vue").DefineComponent<{
+        product?: import("./types").ProductItem | null;
+        basicInfo?: import("./types").BasicInfo | null;
+        diecutData?: import("./types").DiecutResponse | null;
+        deformationData?: import("./types").DeformationResponse | null;
+        options?: import("./types").EditorOptions;
+        productListApi?: import("./types").ProductListApi;
+        productDetailApi?: import("./types").ProductDetailApi;
+        productListPageSize?: number;
+        productListInitialPage?: number;
+    }, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+        product?: import("./types").ProductItem | null;
+        basicInfo?: import("./types").BasicInfo | null;
+        diecutData?: import("./types").DiecutResponse | null;
+        deformationData?: import("./types").DeformationResponse | null;
+        options?: import("./types").EditorOptions;
+        productListApi?: import("./types").ProductListApi;
+        productDetailApi?: import("./types").ProductDetailApi;
+        productListPageSize?: number;
+        productListInitialPage?: number;
+    }> & Readonly<{}>, {
+        product: import("./types").ProductItem | null;
+        basicInfo: import("./types").BasicInfo | null;
+        diecutData: import("./types").DiecutResponse | null;
+        deformationData: import("./types").DeformationResponse | null;
+        options: import("./types").EditorOptions;
+    }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+};
+export default _default;

package/dist/types.d.ts

@@ -0,0 +1,70 @@
+export type ProductItem = {
+    id?: number | string;
+    name?: string;
+    description?: string;
+    coverImg?: string;
+};
+export type BasicInfo = {
+    id?: number | string;
+    name?: string;
+    description?: string;
+    sizes?: string[];
+    coverImg?: string;
+};
+export type DiecutResource = {
+    groupId?: string;
+    groupName?: string;
+    fileName?: string;
+    url?: string;
+    type?: string;
+    width?: number;
+    height?: number;
+};
+export type DiecutItem = {
+    jsonURL?: string | null;
+    size?: string;
+    type?: string;
+    resources?: DiecutResource[] | null;
+    sizeMode?: string;
+};
+export type DiecutResponse = {
+    msg?: string;
+    code?: number;
+    data?: DiecutItem[];
+};
+export type DeformationInfo = {
+    name?: string;
+    jsonURL?: string;
+    sort?: number;
+    resources?: Array<{
+        name?: string;
+        url?: string;
+    }>;
+};
+export type DeformationGroup = {
+    size?: string;
+    sizeMode?: string;
+    infos?: DeformationInfo[] | null;
+};
+export type DeformationResponse = {
+    msg?: string;
+    code?: number;
+    data?: DeformationGroup[];
+};
+export type EditorOptions = {
+    showTopbar?: boolean;
+    showSidebar?: boolean;
+    showPreview?: boolean;
+    enableGrid?: boolean;
+};
+export type ProductListResult = {
+    rows: ProductItem[];
+    total?: number;
+};
+export type ProductListApi = (page: number, pageSize: number) => Promise<ProductListResult>;
+export type ProductDetailResult = {
+    basicInfo?: BasicInfo | null;
+    diecutData?: DiecutResponse | null;
+    deformationData?: DeformationResponse | null;
+};
+export type ProductDetailApi = (productId: number | string) => Promise<ProductDetailResult>;

package/dist/utils/encryptJson.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 生成固定密钥
+ * 使用固定的基础字符串，确保每次生成的密钥都相同
+ * 这样加密和解密可以使用相同的密钥
+ */
+export declare function generateFixedKey(): string;
+/**
+ * 获取加密密钥
+ * 优先使用环境变量，如果没有则使用固定密钥
+ */
+export declare function getEncryptionKey(): string;
+/**
+ * 清理 JSON 数据，确保所有 blob URL 都被替换为 base64
+ * @param jsonData - 要处理的 JSON 数据
+ * @returns 处理后的 JSON 数据
+ */
+export declare function cleanBlobUrls(jsonData: unknown): unknown;
+/**
+ * 加密 JSON 数据
+ * @param jsonData - 要加密的 JSON 对象
+ * @param key - 加密密钥（可选，默认使用固定密钥）
+ * @returns 加密后的字符串（Base64 格式）
+ */
+export declare function encryptJsonData(jsonData: unknown, key?: string): string;
+/**
+ * 解密 JSON 数据
+ * @param encryptedData - 加密后的字符串
+ * @param key - 解密密钥（可选，默认使用固定密钥）
+ * @returns 解密后的 JSON 对象
+ */
+export declare function decryptJsonData<T = unknown>(encryptedData: string, key?: string): T;

package/dist/utils/fileToken.d.ts

@@ -0,0 +1,16 @@
+export declare function getFileToken(): string | null;
+export declare function isFileTokenExpired(bufferMs?: number): boolean;
+export declare function clearFileToken(): void;
+type FileTokenFetchers = {
+    fetchFileToken: () => Promise<any>;
+    fetchFileTokenRefresh?: () => Promise<any>;
+};
+export declare function setFileTokenFetchers(fetchers: FileTokenFetchers | null): void;
+export declare function getFileTokenFetchers(): FileTokenFetchers | null;
+export declare function ensureFileToken(): Promise<string | null>;
+export declare function appendFileTokenToUrl(url: string, token?: string | null): string;
+export declare function appendFileTokenIfPresent(url: string): string;
+export declare function stripFileTokenParam(url: string): string;
+export declare function withFileToken(url: string): Promise<string>;
+export declare function fetchWithFileToken(url: string, options?: RequestInit): Promise<Response>;
+export {};

package/dist/utils/renderService/blend.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 转换混合模式（参考 HTML 文件中的 getBlendMode 函数）
+ */
+export declare function convertBlendMode(blendMode?: string): GlobalCompositeOperation;

package/dist/utils/renderService/deform.d.ts

@@ -0,0 +1,21 @@
+import { ISmartObject } from "./types";
+/**
+ * 变形渲染封装函数
+ * @param image - 输入图片，支持 URL、HTMLImageElement 或 ImageBitmap
+ * @param smartObject - 部位数据（智能对象配置）
+ * @param faceId - 面 ID，用于标识 worker（可选，默认为 0）
+ * @returns 变形后的图片 HTMLImageElement
+ */
+export declare function deformImage(image: string | HTMLImageElement | ImageBitmap, smartObject: ISmartObject, faceId?: number, maxImageSize?: number): Promise<HTMLImageElement>;
+/**
+ * 变形渲染封装函数（返回 ImageBitmap）
+ * @param image - 输入图片，支持 URL、HTMLImageElement 或 ImageBitmap
+ * @param smartObject - 部位数据（智能对象配置）
+ * @param faceId - 面 ID，用于标识 worker（可选，默认为 0）
+ * @param canvasSize - 画布尺寸（可选，默认使用 smartObject.size）
+ * @returns 变形后的 ImageBitmap
+ */
+export declare function deformImageBitmap(image: string | HTMLImageElement | ImageBitmap, smartObject: ISmartObject, faceId?: number, canvasSize?: {
+    width: number;
+    height: number;
+}, maxImageSize?: number): Promise<ImageBitmap>;

package/dist/utils/renderService/deform.worker.d.ts

@@ -0,0 +1,189 @@
+/**
+ * deform.worker.ts - 变形 Web Worker
+ *
+ * 包含所有变形算法（透视变换、网格变形、Puppet Warp等）
+ * 独立运行，无需外部依赖
+ */
+interface IPoint {
+    x: number;
+    y: number;
+    type?: number;
+}
+interface IBounds {
+    top: number;
+    left: number;
+    bottom?: number;
+    right?: number;
+    width: number;
+    height: number;
+}
+interface IPuppetShape {
+    originalVertexArray: IPoint[];
+    deformedVertexArray: IPoint[];
+    indexArray: number[];
+}
+interface IFilter {
+    type: string;
+    enabled: boolean;
+    filter?: {
+        puppetShapeList?: IPuppetShape[];
+    };
+}
+interface IVectorKnot {
+    linked: boolean;
+    points: number[];
+}
+interface IVectorPath {
+    open: boolean;
+    knots: IVectorKnot[];
+    fillRule?: string;
+    operation?: string;
+}
+interface IVectorMask {
+    paths: IVectorPath[];
+    points?: IPoint[];
+    invert?: boolean;
+    notLink?: boolean;
+    disable?: boolean;
+    fillStartsWithAllPixels?: boolean;
+}
+interface ISmartObject {
+    name?: string;
+    type?: string;
+    blendMode?: string;
+    transform: number[];
+    meshPoints?: IPoint[];
+    bounds: IBounds;
+    isSmartObject?: boolean;
+    size?: {
+        width: number;
+        height: number;
+    };
+    originalWidth?: number;
+    originalHeight?: number;
+    quiltSliceX?: number[];
+    quiltSliceY?: number[];
+    layerOrder?: number;
+    imagePath?: string;
+    vectorMask?: IVectorMask;
+    placedLayer?: {
+        width: number;
+        height: number;
+    };
+    filterList?: IFilter[];
+}
+interface ITransformPoint {
+    x: number;
+    y: number;
+}
+interface IPerspectiveMatrix {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    e: number;
+    f: number;
+    g: number;
+    h: number;
+    i?: number;
+}
+type RenderType = "bilinear" | "bicubic" | "grid";
+type DeformPayload = {
+    id: number;
+    designBitmap: ImageBitmap;
+    layerData: ISmartObject;
+    canvasSize?: {
+        width: number;
+        height: number;
+    };
+};
+type DeformResult = {
+    id: number;
+    imageBitmap?: ImageBitmap;
+    error?: string;
+    duration?: number;
+};
+/** 获取图像源的宽高 */
+declare function getImageSize(img: CanvasImageSource): {
+    width: number;
+    height: number;
+};
+/**
+ * 数据预处理函数（关键逻辑）
+ */
+declare function dataPreprocessor(layerData: ISmartObject, canvasSize?: {
+    width: number;
+    height: number;
+}): ISmartObject;
+/**
+ * 结果后处理函数（关键逻辑）
+ */
+declare function resultPostprocessor(result: {
+    id: number;
+    imageBitmap?: ImageBitmap;
+    error?: string;
+    duration?: number;
+}): {
+    id: number;
+    imageBitmap?: ImageBitmap;
+    error?: string;
+    duration?: number;
+};
+/**
+ * 应用图像变形功能（核心算法，需要加密）
+ * @param ctx - Canvas 2D 上下文
+ * @param img - 要变形的图片对象
+ * @param layerData - 图层数据对象，包含变形参数
+ * @returns 返回使用的变形方法名称
+ * @encrypt
+ */
+declare function applyImageTransform(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, layerData: ISmartObject): string;
+/**
+ * Puppet Warp 变形算法（核心算法，需要加密）
+ * @encrypt
+ */
+declare function renderPuppetWarp(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, transPts: ITransformPoint[], shapeData: IPuppetShape, _refW: number, _refH: number): void;
+/**
+ * G24 投影网格变形算法（核心算法，需要加密）
+ * @encrypt
+ */
+declare function renderG24ProjectedMesh(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, transPts: ITransformPoint[], meshPts: IPoint[]): void;
+/**
+ * Quilt 投影变形算法（核心算法，需要加密）
+ * @encrypt
+ */
+declare function renderQuiltProjected(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, transPts: ITransformPoint[], meshPts: IPoint[], sliceX: number[], sliceY: number[], refW: number, refH: number): void;
+/**
+ * 自动适配投影网格变形算法（核心算法，需要加密）
+ * @encrypt
+ */
+declare function renderProjectedMeshAutoFit(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, transPts: ITransformPoint[], meshPts: IPoint[]): void;
+/**
+ * 双三次补丁子集变形算法（核心算法，需要加密）
+ * @encrypt
+ */
+declare function renderBicubicPatchSubset(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, pts: ITransformPoint[], uStart: number, uEnd: number, vStart: number, vEnd: number): void;
+/**
+ * 直接透视变形算法（核心算法，需要加密）
+ * @encrypt
+ */
+declare function renderPerspectiveDirect(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, pts: ITransformPoint[]): void;
+declare function renderBicubicDirect(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, pts: IPoint[]): void;
+declare function renderInternal(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, pts: ITransformPoint[] | IPoint[], type: RenderType, gridDim: number, sub: number): void;
+declare function B(i: number, t: number): number;
+declare function getBicubicPoint(u: number, v: number, p: ITransformPoint[]): ITransformPoint;
+declare function getBilinearPoint(u: number, v: number, p: ITransformPoint[]): ITransformPoint;
+declare function getArbitraryMeshPoint(u: number, v: number, pts: IPoint[], dim: number): ITransformPoint;
+/**
+ * 计算透视变换矩阵（核心算法，需要加密）
+ * @encrypt
+ */
+declare function calcPerspectiveMatrix(p: ITransformPoint[]): IPerspectiveMatrix;
+/**
+ * 矩阵求逆算法（核心算法，需要加密）
+ * @encrypt
+ */
+declare function invertHomography(m: IPerspectiveMatrix): IPerspectiveMatrix | null;
+declare function applyInversePerspective(x: number, y: number, m: IPerspectiveMatrix): ITransformPoint;
+declare function applyPerspective(u: number, v: number, m: IPerspectiveMatrix): ITransformPoint;
+declare function drawTri(ctx: CanvasRenderingContext2D | OffscreenCanvasRenderingContext2D, img: CanvasImageSource, t0: ITransformPoint, t1: ITransformPoint, t2: ITransformPoint, p0: ITransformPoint | IPoint, p1: ITransformPoint | IPoint, p2: ITransformPoint | IPoint): void;

package/dist/utils/renderService/image.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 将输入图片转换为 ImageBitmap
+ */
+export declare function toImageBitmap(image: string | HTMLImageElement | ImageBitmap, maxImageSize?: number): Promise<ImageBitmap>;
+/**
+ * 加载图片为 ImageBitmap
+ */
+export declare function loadImageBitmap(url: string, maxImageSize?: number): Promise<ImageBitmap>;

package/dist/utils/renderService/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * renderService - 渲染服务
+ * 按功能拆分到多个文件，本文件仅做统一导出
+ */
+export * from "./types";
+export * from "./psdConverter";
+export * from "./mask";
+export * from "./image";
+export * from "./blend";
+export * from "./workerManager";
+export * from "./deform";
+export * from "./render";

package/dist/utils/renderService/mask.d.ts

@@ -0,0 +1,13 @@
+import { IMaskData, ISmartObject } from "./types";
+/**
+ * 智能获取蒙版数据
+ */
+export declare function getMaskFromData(data: ISmartObject): IMaskData | null;
+/**
+ * 规范化蒙版数据（转换 Vue Proxy 对象为普通对象）
+ */
+export declare function normalizeMaskData(maskData?: IMaskData | null): IMaskData | null;
+/**
+ * 应用矢量蒙版到 canvas
+ */
+export declare function applyVectorMask(ctx: CanvasRenderingContext2D, maskData: IMaskData | null): void;

package/dist/utils/renderService/prepareRenderData.d.ts

@@ -0,0 +1,2 @@
+import type { IRenderByJson } from './types';
+export declare function prepareRenderDataWithFileToken(renderData: IRenderByJson): Promise<IRenderByJson>;

package/dist/utils/renderService/psdConverter.d.ts

@@ -0,0 +1,6 @@
+import { IConvertPsdInput, IConvertPsdOptions, IModelData } from "./types";
+/**
+ * 将 PSD JSON 转换为模型数据（核心算法，需要加密）
+ * @encrypt
+ */
+export declare function convertPsdJsonToModelData(psdJsonList: IConvertPsdInput[], options: IConvertPsdOptions): IModelData;

package/dist/utils/renderService/render.d.ts

@@ -0,0 +1,14 @@
+import { IDeformResult, IRenderByJsonResult, TLayerExtrasByName } from "./types";
+import type { IPsdJsonData, IRenderByJson } from "./types";
+/**
+ * 根据 JSON 和 layerExtrasByName 进行变形（核心算法）
+ */
+export declare function deformByJson(psdJson: IPsdJsonData, layerExtrasByName: TLayerExtrasByName): Promise<IDeformResult[]>;
+/**
+ * 根据 JSON 和 layerExtrasByName 渲染所有图层到 canvas（核心算法）
+ */
+export declare function renderByJson(data: IRenderByJson): Promise<IRenderByJsonResult>;
+/**
+ * 下载 canvas 为图片
+ */
+export declare function downloadCanvas(canvas: HTMLCanvasElement | OffscreenCanvas, filename?: string): Promise<void>;

package/dist/utils/renderService/render.worker.d.ts

@@ -0,0 +1,17 @@
+export type IMaskData = {
+    type: "bezier";
+    paths: Array<{
+        open: boolean;
+        knots: Array<{
+            linked: boolean;
+            points: number[];
+        }>;
+    }>;
+} | {
+    type: "simple";
+    points: Array<{
+        x: number;
+        y: number;
+        type?: number;
+    }>;
+};

package/dist/utils/renderService/types.d.ts

@@ -0,0 +1,216 @@
+export declare enum EPartType {
+    Drawing = 0,// 可绘制插画
+    Material = 1
+}
+/** 2D顶点,相对于画布的坐标系 */
+export interface IPoint {
+    x: number;
+    y: number;
+    type?: number;
+}
+/** 矢量蒙版节点，包含贝塞尔曲线控制点 */
+export interface IVectorKnot {
+    linked: boolean;
+    points: number[];
+}
+/** 矢量路径 */
+export interface IVectorPath {
+    open: boolean;
+    knots: IVectorKnot[];
+    fillRule?: string;
+    operation?: string;
+}
+/** 矢量蒙版 */
+export interface IVectorMask {
+    paths: IVectorPath[];
+    points?: IPoint[];
+    invert?: boolean;
+    notLink?: boolean;
+    disable?: boolean;
+    fillStartsWithAllPixels?: boolean;
+}
+export interface IBounds {
+    top: number;
+    left: number;
+    bottom?: number;
+    right?: number;
+    width: number;
+    height: number;
+}
+export interface IPuppetShape {
+    originalVertexArray: IPoint[];
+    deformedVertexArray: IPoint[];
+    indexArray: number[];
+}
+export interface IFilter {
+    type: string;
+    enabled: boolean;
+    filter?: {
+        puppetShapeList?: IPuppetShape[];
+    };
+}
+export interface ISmartObject {
+    name?: string;
+    type?: string;
+    blendMode?: string;
+    transform: number[];
+    meshPoints?: IPoint[];
+    bounds: IBounds;
+    isSmartObject?: boolean;
+    size?: {
+        width: number;
+        height: number;
+    };
+    originalWidth?: number;
+    originalHeight?: number;
+    quiltSliceX?: number[];
+    quiltSliceY?: number[];
+    layerOrder?: number;
+    imagePath?: string;
+    vectorMask?: IVectorMask;
+    placedLayer?: {
+        width: number;
+        height: number;
+    };
+    filterList?: IFilter[];
+    opacity?: number;
+    clipping?: boolean;
+}
+/** 裁片部位数据 */
+export interface IPart {
+    id: number;
+    name: string;
+    url?: string;
+    designArea?: string;
+    pureUrl?: string;
+    width?: number;
+    height?: number;
+    partType?: EPartType;
+}
+export declare enum EPsdDataType {
+    Group = 0,// 部件组
+    Layer = 1
+}
+/** psd部位数据 */
+export interface IPsdPartData {
+    id: number;
+    partId?: number;
+    name: string;
+    blendMode?: string;
+    vectorMaskPath?: IPoint[];
+    smartObjects?: ISmartObject[];
+    type: EPsdDataType;
+    url?: string;
+    bounds?: IBounds;
+    opacity?: number;
+    clipping?: boolean;
+    layerOrder?: number;
+}
+/** 模特图数据 */
+export interface IPsdModelData {
+    width: number;
+    height: number;
+    psdPartData?: IPsdPartData[];
+}
+/** 版型数据 */
+export interface IModelData {
+    parts: IPart[];
+    models: IPsdModelData[];
+}
+export type PsdLayerType = "Layer" | "Group";
+export interface IPsdJsonLayer {
+    name: string;
+    type: PsdLayerType;
+    blendMode?: string;
+    bounds?: IBounds;
+    layerOrder?: number;
+    imagePath?: string;
+    vectorMask?: IVectorMask;
+    children?: IPsdJsonLayer[];
+    isSmartObject?: boolean;
+    size?: {
+        width: number;
+        height: number;
+    };
+    placedLayer?: {
+        width: number;
+        height: number;
+    };
+    originalWidth?: number;
+    originalHeight?: number;
+    meshPoints?: IPoint[];
+    transform?: number[];
+    quiltSliceX?: number[];
+    quiltSliceY?: number[];
+    filterList?: IFilter[];
+    id?: number;
+    opacity?: number;
+    clipping?: boolean;
+}
+export interface IPsdJsonData {
+    canvasWidth: number;
+    canvasHeight: number;
+    layerList: IPsdJsonLayer[];
+}
+export interface ILayerExtras {
+    id?: number;
+    partId?: number;
+    url?: string;
+    /** 变形部位对应的设计图片（URL、HTMLImageElement 或 ImageBitmap） */
+    designImage?: string | HTMLImageElement | ImageBitmap;
+}
+export interface IConvertPsdOptions {
+    parts: IPart[];
+    defaultIdStart?: number;
+}
+export interface IConvertPsdInput {
+    psdJson: IPsdJsonData;
+    layerExtrasByName?: Record<string, ILayerExtras>;
+}
+/** 蒙版数据类型 */
+export type IMaskData = {
+    type: "bezier";
+    paths: IVectorPath[];
+} | {
+    type: "simple";
+    points: IPoint[];
+};
+/** 图层额外信息类型（包含变形图片） */
+export interface ILayerExtrasWithImage {
+    id?: number;
+    partId?: number;
+    url?: string;
+    designImage?: string | HTMLImageElement | ImageBitmap;
+}
+/** layerExtrasByName 类型 */
+export type TLayerExtrasByName = Record<string, ILayerExtrasWithImage>;
+/** 变形结果 */
+export interface IDeformResult {
+    layerName: string;
+    partId?: number;
+    imageBitmap: ImageBitmap;
+}
+/** 渲染结果 */
+export interface IRenderByJsonResult {
+    canvas: HTMLCanvasElement | OffscreenCanvas;
+    width: number;
+    height: number;
+}
+export interface IMaterial {
+    layerName: string;
+    url: string;
+    sourceName?: string;
+}
+export interface IFabricScreenshot {
+    id: number;
+    url: string;
+}
+export interface IRenderByJson {
+    psdJson: IPsdJsonData;
+    materialList: IMaterial[];
+    fabricScreenshotList: IFabricScreenshot[];
+    width?: number;
+    height?: number;
+    /** 可选：图片资源的基准 URL，用于解析相对路径 */
+    baseUrl?: string;
+}