@picsart/react-photo-editor 1.0.0 → 1.0.2

package/dist/index.d.ts

@@ -1,180 +1,120 @@
-import * as react from 'react';
-import { CSSProperties } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { CSSProperties, ReactNode } from 'react';
 
-declare class Picsart {
-    constructor(settings: any);
-    settings: any;
-    provideShapesData: {
-        data: ({
-            id: number;
-            shapeURL: string;
-            previewURL: string;
-            shapeData: {};
-            height: number;
-            width: number;
-            meta_data?: undefined;
-        } | {
-            id: number;
-            shapeURL: string;
-            previewURL: string;
-            meta_data: {};
-            height: number;
-            width: number;
-            shapeData?: undefined;
-        })[];
+type PicsartTheme = 'dark' | 'light';
+type PicsartExportType = 'base64' | 'blob' | 'buffer';
+interface PicsartOpenOptions {
+    replayUrl?: string;
+    templateId?: string;
+    imageUrl?: string;
+    videoUrl?: string;
+    subtitleUrl?: string;
+}
+interface PicsartExportOutput {
+    templateId?: string;
+    data: {
+        replayData?: Blob | ArrayBuffer | string;
+        imageData?: string | Blob;
+        printData?: string | Blob;
+        previewPdfData?: string | Blob;
+        pdfData?: string | Blob;
+        previewsData?: Array<string | Blob>;
+        videoData?: unknown;
+        videoUrl?: string;
     };
-    isEditorReady: boolean;
-    onExportCb: () => void;
-    messageListener: ({ data, origin }: {
-        data: any;
-        origin: any;
-    }) => void;
-    isMessageListenerAttached: boolean;
-    log(...args: any[]): void;
-    onOpen(callback: any): this;
-    openCallBack: any;
-    renderNew(src: any): void;
-    iframe: HTMLIFrameElement | null | undefined;
-    render(src: any): void;
-    close(): this;
-    hide(): void;
-    callCloseHandlers(): void;
-    resetTempData(): void;
-    tempOnClose: any;
-    tempOnExport: any;
-    tempExportType: any;
-    tempExportSettings: any;
-    onClose(cb?: () => void): this;
-    cbClose: (() => void) | undefined;
-    /**
-     * @param {(payload: any) => void} [cb]
-     */
-    onError(cb?: (payload: any) => void): this;
-    cbError: ((payload: any) => void) | undefined;
-    clear(): this;
-    applySettings(settings: any): void;
-    isIframeLoaded(): boolean | null | undefined;
-    onReady(cb?: () => void): this;
-    exportData(payload: any, cb: any): Promise<void>;
-    handleUpload(data: any): void;
-    onUpload(handler: any): void;
-    /**
-     * @param {(result: any) => void} [cb]
-     */
-    onExport(cb?: (result: any) => void): this;
-    export(): void;
-    getEditorSettings(params: any): any;
-    open(params?: {}): this;
-    openOld(params?: {}): this;
-    sendMessage(type: any, data: any): void;
-    attachMessageListener(): void;
-    detachMessageListener(): void;
-    handleMessage({ data, origin }: {
-        data: any;
-        origin: any;
-    }): void;
-    handleEditorReady(): void;
-    flushPendingData(): void;
-    getFetch(url: any): Promise<any>;
-    getCategoriesData(data: any): Promise<any[]>;
-    provideTemplates({ data, dataURL }: {
-        data: any;
-        dataURL: any;
-    }): Promise<this | undefined>;
-    provideTemplatesData: {
-        data: any;
-        dataURL: any;
-    } | undefined;
-    provideShapes({ data, dataURL }: {
-        data: any;
-        dataURL: any;
-    }): Promise<this | undefined>;
-    provideStickerShapes(): Promise<this>;
-    provideTexts({ data, dataURL }: {
-        data: any;
-        dataURL: any;
-    }): Promise<this | undefined>;
-    provideTextsData: {
-        data: any;
-        dataURL: any;
-    } | undefined;
-    provideColors(data: any): this | undefined;
-    provideColorsData: any;
-    providePhotos({ data, dataURL }: {
-        data: any;
-        dataURL: any;
-    }): Promise<this | undefined>;
-    providePhotosData: {
-        data: any;
-        dataURL: any;
-    } | undefined;
-    provideStickers({ data, dataURL }: {
-        data: any;
-        dataURL: any;
-    }): Promise<this | undefined>;
-    provideStickersData: {
-        data: any;
-        dataURL: any;
-    } | undefined;
-    provideFonts({ data, dataURL }: {
-        data: any;
-        dataURL: any;
-    }): Promise<this | undefined>;
-    provideFontsData: {
-        data: any;
-        dataURL: any;
-    } | undefined;
-    provideCanvasSizes({ data, dataURL }: {
-        data: any;
-        dataURL: any;
-    }): Promise<this | undefined>;
-    provideCanvasSizesData: {
-        data: any;
-        dataURL: any;
-    } | undefined;
-    provideLabels(data: any): this | undefined;
-    provideLabelsData: any;
-    provideExportSettings(): void;
+}
+type PicsartUploadHandler = (file: Blob | ArrayBuffer | Uint8Array, mimeType: string) => Promise<{
+    url: string;
+    status: string;
+    progress: number;
+    error: unknown;
+}>;
+interface PicsartInstance {
+    onError(cb: (error: unknown) => void): PicsartInstance;
+    onExport(cb: (output: PicsartExportOutput) => void): PicsartInstance;
+    onClose(cb?: () => void): PicsartInstance;
+    open(options?: PicsartOpenOptions): PicsartInstance;
+    close(): PicsartInstance;
+}
+interface PicsartConstructorOptions {
+    apiKey: string;
+    customerId: string;
+    propertyId: string;
+    containerId: string;
+    exportType?: PicsartExportType;
+    theme?: PicsartTheme;
+    title?: string;
+    selectedCategory?: string;
+    canvasSize?: string;
+    templatesTitleText?: string;
+    templatesSubTitle?: string;
+    replayUrl?: string;
+    videoUrl?: string;
+    imageUrl?: string;
+    subtitleUrl?: string;
+    templateId?: string;
+    stickerText?: string;
+    stickerImageUrl?: string;
+    templatesFilters?: Record<string, unknown>;
+    onUpload?: PicsartUploadHandler;
+}
+interface PicsartConstructor {
+    new (options: PicsartConstructorOptions): PicsartInstance;
+}
+declare global {
+    interface Window {
+        Picsart?: PicsartConstructor;
+    }
 }
 
-type PhotoEditorOpenParams = Record<string, unknown>;
-type PhotoEditorProps = {
+/** Matches Picsart quick-start: apiKey, customerId, propertyId, containerId, title. */
+interface PicsartEditorProps {
+    /** From Picsart signup / dashboard. */
     apiKey: string;
+    /** From Picsart signup / dashboard. */
     customerId: string;
-    propertyId?: string;
+    /** From Picsart signup / dashboard (required for the standard SDK flow). */
+    propertyId: string;
     /**
-     * Full editor entry URL used as the iframe `src` origin (before `?query`).
-     * Use the value from your Picsart onboarding / docs for your SDK version.
+     * Must match the inner editor container’s `id`. If omitted, a stable unique id is generated
+     * and passed to the SDK for you (same as embedding a div with that id).
      */
-    editorDomain?: string;
+    containerId?: string;
     /**
-     * Origin the editor uses as the embedding parent (query `parentDomain`).
-     * **Important:** `http://localhost` often fails SDK origin / postMessage checks.
-     * For local dev use an HTTPS tunnel (ngrok, etc.) and set this to that `https://…` origin,
-     * or set env `NEXT_PUBLIC_PICSART_PARENT_DOMAIN` / `VITE_PICSART_PARENT_DOMAIN`.
+     * Editor chrome title when supported. Defaults to **Photo Print Designer** (Picsart docs default).
      */
-    parentDomain?: string;
+    title?: string;
+    sdkScriptUrl?: string;
     className?: string;
     style?: CSSProperties;
-    title?: string;
+    children?: ReactNode;
+    exportType?: PicsartExportType;
+    theme?: PicsartTheme;
+    selectedCategory?: string;
+    canvasSize?: string;
+    templatesTitleText?: string;
+    templatesSubTitle?: string;
+    templatesFilters?: Record<string, unknown>;
+    replayUrl?: string;
+    videoUrl?: string;
     imageUrl?: string;
-    /** When true (default), merges the bundled CMS-style defaults from `cmsSettings`. */
-    cms?: boolean;
-    debug?: boolean;
-    onExport?: (result: unknown) => void;
-    onError?: (payload: unknown) => void;
+    subtitleUrl?: string;
+    templateId?: string;
+    stickerText?: string;
+    stickerImageUrl?: string;
+    onUpload?: PicsartUploadHandler;
+    onExport?: (output: PicsartExportOutput) => void;
+    onError?: (error: unknown) => void;
     onClose?: () => void;
-    onOpen?: () => void;
-    /** Merged into the Picsart constructor (advanced). */
-    picsartSettings?: Record<string, unknown>;
-    /** Merged into the `.open()` call after mount. */
-    openParams?: PhotoEditorOpenParams;
-};
-type PhotoEditorHandle = {
-    picsart: InstanceType<typeof Picsart> | null;
-    open: (params?: PhotoEditorOpenParams) => InstanceType<typeof Picsart>;
-    close: () => InstanceType<typeof Picsart>;
-};
-declare const PhotoEditor: react.ForwardRefExoticComponent<PhotoEditorProps & react.RefAttributes<PhotoEditorHandle>>;
+    /** When false, `open()` is called with no asset (blank editor). Default true. */
+    autoOpen?: boolean;
+    /** Override initial `open()` payload when autoOpen is true. */
+    openOptions?: PicsartOpenOptions;
+}
+declare function PicsartEditor({ apiKey, customerId, propertyId, containerId: containerIdProp, title, sdkScriptUrl, className, style, children, exportType, theme, selectedCategory, canvasSize, templatesTitleText, templatesSubTitle, templatesFilters, replayUrl, videoUrl, imageUrl, subtitleUrl, templateId, stickerText, stickerImageUrl, onUpload, onExport, onError, onClose, autoOpen, openOptions, }: PicsartEditorProps): react_jsx_runtime.JSX.Element;
+
+declare function loadPicsartSdk(scriptUrl?: string): Promise<void>;
+
+declare function createDefaultVideoUpload(apiKey: string): PicsartUploadHandler;
 
-export { PhotoEditor, type PhotoEditorHandle, type PhotoEditorOpenParams, type PhotoEditorProps, Picsart };
+export { type PicsartConstructorOptions, PicsartEditor, type PicsartEditorProps, type PicsartExportOutput, type PicsartExportType, type PicsartInstance, type PicsartOpenOptions, type PicsartTheme, type PicsartUploadHandler, createDefaultVideoUpload, loadPicsartSdk };