@jetprint/editor-sdk 1.0.0

package/dist/components/Editor/composables/useEditorShortcuts.d.ts

@@ -0,0 +1,80 @@
+import { type Ref } from 'vue';
+import type { Canvas } from 'fabric';
+import type { EditorShortcutActionId } from '../utils/editorShortcutIds';
+/** 供快捷键设置 Modal 绑定 */
+export interface EditorShortcutsController {
+    recordingActionId: Ref<EditorShortcutActionId | null>;
+    conflictMessage: Ref<string>;
+    getEffectiveChord: (id: EditorShortcutActionId) => string | null;
+    clearBinding: (id: EditorShortcutActionId) => void;
+    restoreDefaults: () => void;
+    startRecording: (id: EditorShortcutActionId) => void;
+    cancelRecording: () => void;
+}
+export declare function useEditorShortcuts(options: {
+    storageKey: string;
+    getBlocked: () => boolean;
+    getReadOnly: () => boolean;
+    getCanvas: () => Canvas | null;
+    /** 快捷键面板是否打开（打开时不触发画布动作，录制中除外） */
+    getPanelOpen: () => boolean;
+    onAction: (id: EditorShortcutActionId) => boolean | void;
+}): {
+    custom: Ref<{
+        layer_crop?: string | undefined;
+        duplicate_layer?: string | undefined;
+        delete_selected_layer?: string | undefined;
+        layer_top?: string | undefined;
+        layer_bottom?: string | undefined;
+        layer_up?: string | undefined;
+        layer_down?: string | undefined;
+        undo?: string | undefined;
+        redo?: string | undefined;
+        nudge_up?: string | undefined;
+        nudge_down?: string | undefined;
+        nudge_left?: string | undefined;
+        nudge_right?: string | undefined;
+        add_text?: string | undefined;
+        clear_canvas?: string | undefined;
+        clear_guides?: string | undefined;
+        zoom_in?: string | undefined;
+        zoom_out?: string | undefined;
+        fit_canvas?: string | undefined;
+        export_png?: string | undefined;
+    }, Partial<Record<"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", string>> | {
+        layer_crop?: string | undefined;
+        duplicate_layer?: string | undefined;
+        delete_selected_layer?: string | undefined;
+        layer_top?: string | undefined;
+        layer_bottom?: string | undefined;
+        layer_up?: string | undefined;
+        layer_down?: string | undefined;
+        undo?: string | undefined;
+        redo?: string | undefined;
+        nudge_up?: string | undefined;
+        nudge_down?: string | undefined;
+        nudge_left?: string | undefined;
+        nudge_right?: string | undefined;
+        add_text?: string | undefined;
+        clear_canvas?: string | undefined;
+        clear_guides?: string | undefined;
+        zoom_in?: string | undefined;
+        zoom_out?: string | undefined;
+        fit_canvas?: string | undefined;
+        export_png?: string | undefined;
+    }>;
+    disabled: Ref<("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")[], ("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")[]>;
+    recordingActionId: Ref<"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" | null, "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" | null>;
+    conflictMessage: Ref<string, string>;
+    hydrate: () => void;
+    getEffectiveChord: (id: EditorShortcutActionId) => string | null;
+    setCustomChord: (id: EditorShortcutActionId, chord: string) => boolean;
+    clearBinding: (id: EditorShortcutActionId) => void;
+    restoreDefaults: () => void;
+    startRecording: (id: EditorShortcutActionId) => void;
+    cancelRecording: () => void;
+    tryCommitRecording: (e: KeyboardEvent) => boolean;
+    install: () => void;
+    uninstall: () => void;
+};
+export type UseEditorShortcutsReturn = ReturnType<typeof useEditorShortcuts>;

package/dist/components/Editor/composables/useEditorTopbarContext.d.ts

@@ -0,0 +1,3 @@
+import type { EditorTopbarContext } from '../../../types';
+export declare function useEditorTopbarContext(): EditorTopbarContext;
+export declare function useEditorTopbarContextOptional(): EditorTopbarContext | undefined;

package/dist/components/Editor/composables/useEditorWatchers.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Editor 统一 Watchers Composable
+ * 集中管理产品/模板/刀板/尺寸/颜色等响应式联动
+ */
+import { type Ref } from 'vue';
+export interface UseEditorWatchersOptions {
+    props: {
+        options?: {
+            enableGrid?: boolean;
+        };
+        basicInfo?: any;
+        diecutData?: any;
+        deformationData?: any;
+        fileToken?: string | null;
+    };
+    showGrid: Ref<boolean>;
+    activeTab: Ref<string>;
+    getCanvas: () => any;
+    syncImageToolState: (active?: any, autoSwitchTab?: boolean) => void;
+    syncLayerToolState: (active?: any) => void;
+    syncTextToolState: (active?: any, autoSwitchTab?: boolean) => void;
+    selectedProductIndex: Ref<number>;
+    productItems: Ref<any[]>;
+    selectedProduct: Ref<any>;
+    isListMode: Ref<boolean>;
+    doResetForProduct: () => void;
+    loadProductDetails: (id: number | string) => Promise<void>;
+    sizeOptions: Ref<any[]>;
+    selectedSize: Ref<string>;
+    sizeOptionsFromDeformation: Ref<string[]>;
+    selectedColor: Ref<string>;
+    effectiveDeformationData: Ref<any>;
+    isNewDeformationFormat: Ref<boolean>;
+    colorOptions: Ref<string[]>;
+    templateItems: Ref<any[]>;
+    selectedTemplateIndex: Ref<number>;
+    previewTemplateIndex: Ref<number>;
+    templateModeOptions: Ref<any[]>;
+    selectedMode: Ref<string>;
+    diecutOptions: Ref<Array<{
+        id: string;
+    }>>;
+    selectedDiecutId: Ref<string>;
+    applyTemplateToCanvas: (template: any) => void;
+    buildInitialPreviewRenderData: (opts?: {
+        commitHd?: boolean;
+        useCachedSplitScreenshotsOnly?: boolean;
+    }) => Promise<void>;
+    saveCanvasState: (id: string, sizeOverride?: string) => Promise<void>;
+    restoreCanvasState: (id: string) => any;
+    restoreCanvasStateAsync?: (id: string) => Promise<boolean>;
+    /** 是否「多尺码不同设计版」(SIZE_SPECIFIC)：决定切尺码是否需要按尺码 落盘/还原 画布 */
+    getIsPerSizeDesign?: () => boolean;
+    /** 切尺码后：为当前尺码所有已设计的非激活分片用保存状态离屏生成截图（补齐效果图） */
+    warmDesignedPieces?: () => Promise<void>;
+    onAfterCanvasRestored?: (diecutId: string) => void;
+    resetCanvasForTemplate: () => void;
+    setZoom: (v: number) => void;
+    zoom: Ref<number>;
+    /** Classic ↔ Zone 切换时恢复对应模式的视口缩放/平移 */
+    switchTemplateViewportMode?: (mode: string) => void;
+    /** 首次绑定当前模板模式（fitCanvas 后写入该模式默认视口） */
+    initTemplateViewportMode?: (mode: string) => void;
+    /** 换产品时重置两种模式的视口记忆 */
+    resetTemplateViewportByMode?: () => void;
+    /** 统一应用引导层（单片优先分片可拖动蒙版）；COMPLETE 时 fallback 为整模板引导资源；SPLIT 仅刀版 Guideline+SPLIT */
+    applyEditorGuideLayers: (fallbackTemplateGuideResources?: any[]) => Promise<void>;
+    generateDiecutScreenshot: (id: string, snapshotOpts?: any, precapturedBaseBlob?: Blob | null) => Promise<void>;
+    /**
+     * 在切换分片前同步截取主画布当前像素,用于喂给 fire-and-forget generateDiecutScreenshot,
+     * 避免内部 getCanvasBaseScreenshot 的 idleCallback 让 capture 推迟到 restore 完成后,
+     * 截到下一分片的像素污染 prev 分片 cache。
+     */
+    captureMainBaseBlob?: () => Promise<Blob | null>;
+    loadTemplateJson: (url: string, resources?: any[]) => Promise<void>;
+    getModeConfig: () => {
+        jsonURL?: string;
+        resources?: any[];
+    } | null;
+    setExternalFileToken: (token: string | null) => void;
+    onTemplateReady?: () => void | Promise<void>;
+    /** 刀板切换流程中置 true，用于暂停 queuePreviewUpdate，避免 restore 时 object:added 触发预览 loading */
+    diecutSwitchInProgress: Ref<boolean>;
+    /**
+     * 切换刀板前取消预览 debounce（与 saveCanvasState(prev) 配合）。
+     * 否则 timer 可能在 selectedDiecutId 已指向新分片后才执行，把画布误存到新分片的 stateMap。
+     */
+    clearPendingPreviewUpdate?: () => void;
+    /**
+     * Dirty 标记查询 / 消费。
+     * 切换分片时,如果 prev 分片自上次截图后用户没改过(not dirty),跳过 generateDiecutScreenshot —
+     * inverseMaskBlob 仍然有效,不需要重新生成。这是 Classic 模式切换分片慢的最大优化点
+     * (实测 shotPrev 占总切换时间 95%+,单次 360-2500ms)。
+     * 缺省(未传)时退化为旧行为:每次切换都截图,等价于"总是 dirty"。
+     */
+    isDiecutDirty?: (id: string) => boolean;
+    consumeDiecutDirty?: (id: string) => void;
+}
+export declare function useEditorWatchers(options: UseEditorWatchersOptions): void;

package/dist/components/Editor/composables/useEventHandlers.d.ts

@@ -0,0 +1,13 @@
+import type { Canvas } from 'fabric';
+export interface EventHandlersOptions {
+    onObjectModified?: (fabricData: Record<string, unknown>) => void;
+    syncLayers?: () => void;
+    updateActive?: () => void;
+    syncToolStates?: (obj: any) => void;
+    queuePreviewUpdate?: (reason: string) => void;
+}
+export declare function useEventHandlers(getCanvas: () => Canvas | null, options?: EventHandlersOptions): {
+    setupCanvasEvents: () => void;
+    removeCanvasEvents: () => void;
+    setupKeyboardEvents: () => () => void;
+};

package/dist/components/Editor/composables/useFontLoader.d.ts

@@ -0,0 +1,8 @@
+export declare function loadFont(fontFamily: string): Promise<void>;
+export declare function preloadAllFonts(): Promise<void>;
+export declare function useFontLoader(): {
+    loadingFont: import("vue").Ref<string | null, string | null>;
+    loadFont: typeof loadFont;
+    loadedFonts: Set<string>;
+    preloadAllFonts: typeof preloadAllFonts;
+};

package/dist/components/Editor/composables/useGuideResources.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 引导资源渲染（MASK / DOTTED_LINE 等）
+ * 抽离 clearGuideResources / renderGuideResources，并维护 maskOverlay/maskClipPath 引用
+ */
+import { Image as FabricImage } from 'fabric';
+import type { Canvas } from 'fabric';
+type FabricImageInstance = InstanceType<typeof FabricImage> & {
+    customData?: Record<string, unknown>;
+};
+export declare function useGuideResources(options: {
+    getCanvas: () => Canvas | null;
+    guideResourceRole: string;
+    isGuideResource: (res: any) => boolean;
+    bringObjectToFront: (obj: any) => void;
+    scaleResourceToCanvas: (img: any, resource: any) => void;
+    loadFabricImage: (src: string, callback: (img: FabricImageInstance) => void, opts?: {
+        crossOrigin?: string;
+    }) => void;
+    getGuideRect?: () => any;
+    /** 拉取 Guideline JSON（与 fileToken 代理一致） */
+    toProxyUrl: (url: string) => string;
+    /**
+     * 若已存在内存中的 Guideline（如拖动分片后写回 templateJsonByUrlKey），
+     * tryRender 优先使用其而非重新 fetch，使岛外压暗 / 蒙版位置与 bounds 一致。
+     */
+    getCachedSplitGuidelineJson?: (templateJsonUrl: string) => Record<string, unknown> | null | undefined;
+    /** tryRender 解析出 psdJson 后写回缓存，供后续拖动与导出共用 */
+    setCachedSplitGuidelineJson?: (templateJsonUrl: string, json: Record<string, unknown>) => void;
+}): {
+    clearGuideResources: () => void;
+    renderGuideResources: (resources?: any[]) => void;
+    tryRenderCompleteSplitPieceMaskGuides: (diecutData: any, selectedSize?: string | string[], restrictToGroupId?: string | null, overridePsdJson?: Record<string, unknown> | null) => Promise<boolean>;
+    syncCompleteSplitZoneDimToViewport: () => boolean;
+    restoreGuideStackOrder: () => void;
+    getMaskClipPath: () => any;
+    getMaskOverlay: () => any;
+};
+export {};

package/dist/components/Editor/composables/useImageHandler.d.ts

@@ -0,0 +1,10 @@
+import type { Canvas } from 'fabric';
+export declare function useImageHandler(getCanvas: () => Canvas | null, syncLayers: () => void, syncToolState: (obj?: any) => void): {
+    handleUpload: (event: any) => Promise<void>;
+    addImageFromUrl: (url: string) => Promise<void>;
+    addRect: () => void;
+    addCircle: () => void;
+    loadFabricImage: (src: string, callback: (img: any) => void, options?: {
+        crossOrigin?: string;
+    }) => Promise<void>;
+};

package/dist/components/Editor/composables/useLayerOperations.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 图层操作管理 Composable
+ * 负责图层的选择、移动、复制、删除、变换等操作
+ */
+import type { Canvas } from 'fabric';
+import type { Ref } from 'vue';
+export interface UseLayerOperationsOptions {
+    getCanvas: () => Canvas | null;
+    layers: Ref<any[]>;
+    activeLayerId: Ref<string | number | undefined>;
+    activeTab: Ref<string>;
+    objectIndex: Ref<number>;
+    incrementObjectIndex: () => void;
+    isLayerToolTarget: (obj: any) => boolean;
+    syncLayers: () => void;
+    syncImageToolState: (active?: any, autoSwitchTab?: boolean) => void;
+    syncLayerToolState: (active?: any) => void;
+    syncTextToolState: (active?: any, autoSwitchTab?: boolean) => void;
+    queuePreviewUpdate: (reason: string, meta?: {
+        immediate?: boolean;
+    }) => void;
+    /** 与 handleObjectModified 中 notify 一致，用于不经过 Fabric 事件时仍通知父组件设计已变更 */
+    notifyDesignChanged?: () => void;
+    /** 复制等：置于用户层最顶、仍低于引导/遮罩 */
+    insertBelowGuideLayersTopMost: (obj: any) => void;
+    bringGuideLayersToFront: () => void;
+    /** 排序后恢复蒙版在底、压暗/虚线在上（避免 bringGuideLayersToFront 把半透明蒙版盖在设计上） */
+    restoreGuideStackOrder: () => void;
+    /** 平铺层缩放（与「平铺缩放」滑块同源） */
+    updateImagePatternScale?: (value: number) => void | Promise<void>;
+}
+export declare function useLayerOperations(options: UseLayerOperationsOptions): {
+    moveLayerInStack: (obj: any, direction: any) => boolean;
+    selectLayer: (layer: any) => void;
+    removeSelected: () => void;
+    deleteLayerById: (layer: any) => void;
+    deleteSelectedLayer: () => void;
+    moveLayerById: (layerId: any, direction: any) => Promise<void>;
+    duplicateLayerById: (layerId: any) => Promise<void>;
+    duplicateLayer: () => Promise<void>;
+    moveLayer: (direction: any) => Promise<void>;
+    flipLayer: (axis: any) => void;
+    rotateLayer: (direction?: string) => void;
+    scaleLayer: (direction: any) => void;
+    alignLayer: (position: any) => void;
+    centerLayer: () => void;
+    updateLayerOpacity: (value: any) => void;
+    nudgeSelectedLayer: (dx: number, dy: number, step?: number) => boolean;
+    toggleLayerVisibility: (layer: any) => void;
+    toggleLayerLock: (layer: any) => void;
+    reorderLayersByVisualMove: (fromIdx: number, toIdx: number) => void;
+};

package/dist/components/Editor/composables/useLayerSync.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 图层同步 Composable
+ * 维护 layers / activeLayerId，提供 syncLayers 供 useCanvasStateByDiecut 等使用
+ */
+import { type Ref } from 'vue';
+export interface LayerItem {
+    id: string | number;
+    name: string;
+    object: any;
+    visible: boolean;
+    locked: boolean;
+}
+export interface UseLayerSyncOptions {
+    getCanvas: () => any;
+}
+export declare function useLayerSync(options: UseLayerSyncOptions): {
+    layers: Ref<{
+        id: string | number;
+        name: string;
+        object: any;
+        visible: boolean;
+        locked: boolean;
+    }[], LayerItem[] | {
+        id: string | number;
+        name: string;
+        object: any;
+        visible: boolean;
+        locked: boolean;
+    }[]>;
+    activeLayerId: Ref<string | number | undefined, string | number | undefined>;
+    syncLayers: () => void;
+};

package/dist/components/Editor/composables/useLicense.d.ts

@@ -0,0 +1,11 @@
+import type { LicenseConfig } from '../../../types';
+export interface UseLicenseOptions {
+    /** 是否在成功/刷新时设置 globalThis 与 window 上的 LICENSE_TOKEN、LICENSE_API_URL */
+    setGlobalToken?: boolean;
+}
+export declare function useLicense(licenseConfig?: LicenseConfig, options?: UseLicenseOptions): {
+    licenseReady: import("vue").Ref<boolean, boolean>;
+    licenseError: import("vue").Ref<string | null, string | null>;
+    initializeLicense: () => Promise<void>;
+    cleanup: () => void;
+};

package/dist/components/Editor/composables/useObjectAdder.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 对象添加管理 Composable
+ * 负责图片、文本、图形（矩形、圆形）的添加操作
+ */
+import type { Canvas } from 'fabric';
+import { Image as FabricImage } from 'fabric';
+import type { Ref } from 'vue';
+import { type PsdLayer } from '../utils/dataBuilders';
+export type FabricImageInstance = InstanceType<typeof FabricImage> & {
+    customData?: Record<string, unknown>;
+};
+export interface UseObjectAdderOptions {
+    getCanvas: () => Canvas | null;
+    objectIndex: Ref<number>;
+    incrementObjectIndex: () => void;
+    assignMeta: (obj: any, label: string) => void;
+    loadFabricImage: (src: string, callback: (img: FabricImageInstance) => void, options?: {
+        crossOrigin?: string;
+    }) => Promise<void>;
+    /** 平铺图案从 URL 加载 HTMLImageElement（还原设计时用 savedSrc / patternSource） */
+    loadImage: (url: string) => Promise<HTMLImageElement>;
+    moveLayerInStack: (obj: any, direction: string) => boolean;
+    bringGuideLayersToFront: () => void;
+    syncLayers: () => void;
+    syncImageToolState: (active?: any, autoSwitchTab?: boolean) => void;
+    syncLayerToolState: (active?: any) => void;
+    syncTextToolState: (active?: any, autoSwitchTab?: boolean) => void;
+    updateActive: () => void;
+    insertBelowGuideLayers: (obj: any) => void;
+    textToolState: Ref<{
+        strokeWidth?: number;
+    }>;
+    urlInput?: Ref<string>;
+    /**
+     * 当前模板 PSD（canvasWidth/canvasHeight 等）；返回 null 时新增图片仍按 Fabric 全宽缩放（旧行为）。
+     */
+    getGuidelinePsdCanvasSpec?: () => {
+        layerList?: PsdLayer[] | undefined;
+        psdJson: {
+            canvasWidth?: number;
+            canvasHeight?: number;
+        };
+        targetBounds?: {
+            left: number;
+            top: number;
+            width: number;
+            height: number;
+        };
+        fitMode?: 'maxSideToFragmentWidth';
+    } | null;
+    /** Zone 聚焦后新增对象应落在当前可见视口内；返回 null 时沿用 PSD/画布布局。 */
+    getNewObjectViewportRect?: () => NewObjectLayoutRect | null;
+    onUploadSizeExceeded?: (file: File) => void;
+}
+type FabricJsonObject = Record<string, any>;
+type NewObjectLayoutRect = {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+    fitMode?: 'maxSideToFragmentWidth';
+};
+export declare function useObjectAdder(options: UseObjectAdderOptions): {
+    handleUpload: (event: any) => Promise<void>;
+    addImageFromUrl: (url: any) => Promise<void>;
+    handleUrlPaste: (event: any) => void;
+    addText: () => Promise<void>;
+    addLabel: () => Promise<void>;
+    addRect: () => void;
+    addCircle: () => void;
+    addImageFromJson: (jsonObj: FabricJsonObject) => Promise<FabricImageInstance | null>;
+    addTextFromJson: (jsonObj: FabricJsonObject) => any;
+    addPatternRectFromJson: (jsonObj: FabricJsonObject) => Promise<any>;
+    applyFabricJsonPropsToObject: (target: any, json: FabricJsonObject) => void;
+};
+export {};

package/dist/components/Editor/composables/usePatternHandler.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 图案铺设 Composable
+ * 负责图片平铺/取消平铺、图案缩放等
+ */
+import { getPatternSourceUrl } from '../utils/pattern';
+export type FabricImageInstance = any;
+export interface UsePatternHandlerOptions {
+    getCanvas: () => any;
+    loadImage: (url: string) => Promise<HTMLImageElement>;
+    loadFabricImage: (src: string, callback: (img: FabricImageInstance) => void, options?: {
+        crossOrigin?: string;
+    }) => Promise<void>;
+    syncLayers: () => void;
+    syncImageToolState: (obj?: any, autoSwitchTab?: boolean) => void;
+    updateActive: () => void;
+    insertBelowGuideLayers: (obj: any) => void;
+    bringGuideLayersToFront: () => void;
+    queuePreviewUpdate: (reason: string) => void;
+    /** 平铺 replace 期间跳过 object:added 的 insertBelowGuideLayers，避免栈序被二次打乱 */
+    runWithSuppressedObjectAddedGuideReorder?: (fn: () => void) => void;
+}
+/** 按当前 patternPhase 锚点重算 cover 几何（full 模式：以锚点格中心展开 4×4）并标记重绘 */
+export declare function recenterPatternCoverFromPhase(obj: any): void;
+/** 拖动结束后将 single 模式展开为完整平铺网格 */
+export declare function expandPatternLayerToFullGrid(obj: any): void;
+export declare function usePatternHandler(options: UsePatternHandlerOptions): {
+    applyImagePattern: (mode: any) => Promise<void>;
+    updateImagePatternScale: (value: any) => Promise<void>;
+    refreshPatternRectsForViewport: () => void;
+    getPatternSourceUrl: typeof getPatternSourceUrl;
+};