@select-org/select-post-builder 1.2.6 → 1.2.8

package/dist/index.d.ts

@@ -54,7 +54,17 @@ declare type BaseProps = {
     hideGroupSelector?: boolean;
     isSubmitting?: boolean;
     clearOnSuccess?: boolean;
-    onCreatePost: (params: CreatePostCallbackPayload) => void;
+    onCreatePost: (params: CreatePostCallbackPayload, 
+    /**
+     * Present only when the submit fails and the host wants to refill the
+     * editor with what was just submitted. `restoreContent()` re-injects the
+     * exact submitted content into the current live editor instance (resolved
+     * at call time, so it still works if this editor instance was destroyed
+     * and recreated in the meantime).
+     */
+    meta?: {
+        restoreContent: () => void;
+    }) => void;
     onVoiceComment?: (params: {
         voiceUrl: string;
         voiceTime: number;
@@ -263,6 +273,14 @@ export declare interface PostBuilderConfig {
     unauthenticatedMode?: boolean;
 }
 
+/**
+ * Imperative controls handed to the host once via `onReady`. Safe to hold for
+ * the component's entire lifetime: every method resolves the live editor (and
+ * the tab it belongs to) at call time, so the controls keep working across the
+ * internal editor re-creates caused by mount and Post/Blog/Poll tab switches.
+ * When no live editor exists, `getContent` returns null and the mutating
+ * methods no-op — none of them throw.
+ */
 export declare interface PostBuilderControls {
     saveDraft: () => void;
     discardDraft: () => void;
@@ -465,6 +483,17 @@ declare module 'axios' {
 }
 
 
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        poll: {
+            insertPoll: (attrs: {
+                choices: PollChoiceItem[];
+            }) => ReturnType;
+        };
+    }
+}
+
+
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         media: {
@@ -493,17 +522,6 @@ declare module '@tiptap/core' {
 }
 
 
-declare module '@tiptap/core' {
-    interface Commands<ReturnType> {
-        poll: {
-            insertPoll: (attrs: {
-                choices: PollChoiceItem[];
-            }) => ReturnType;
-        };
-    }
-}
-
-
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         customLink: {
@@ -532,6 +550,22 @@ declare module '@tiptap/core' {
 }
 
 
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        iframe: {
+            /**
+             * Insert an iframe node into the document
+             */
+            setIframe: (options: {
+                src: string;
+                width?: string;
+                height?: string;
+            }) => ReturnType;
+        };
+    }
+}
+
+
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         smartMediaUpload: {
@@ -591,19 +625,3 @@ declare module '@tiptap/core' {
         };
     }
 }
-
-
-declare module '@tiptap/core' {
-    interface Commands<ReturnType> {
-        iframe: {
-            /**
-             * Insert an iframe node into the document
-             */
-            setIframe: (options: {
-                src: string;
-                width?: string;
-                height?: string;
-            }) => ReturnType;
-        };
-    }
-}