@veltdev/react 5.0.0-beta.1 → 5.0.0-beta.3

package/esm/types/components/VeltCommentComposer/VeltCommentComposer.d.ts

@@ -10,6 +10,8 @@ export interface IVeltCommentComposerProps extends React.DetailedHTMLProps<React
     locationId?: string;
     documentId?: string;
     folderId?: string;
+    placeholder?: string;
+    targetElementId?: string;
 }
 declare const VeltCommentComposer: React.FC<IVeltCommentComposerProps>;
 export default VeltCommentComposer;

package/esm/types/components/VeltCommentDialog/VeltCommentDialog.d.ts

@@ -6,6 +6,7 @@ export interface IVeltCommentDialogProps extends React.DetailedHTMLProps<React.H
     commentPinSelected?: boolean;
     fullExpanded?: boolean;
     shadowDom?: boolean;
+    placeholder?: string;
 }
 declare const VeltCommentDialog: React.FC<IVeltCommentDialogProps>;
 export default VeltCommentDialog;

package/esm/types/components/VeltCommentDialog/VeltCommentDialogComposer/VeltCommentDialogComposer.d.ts

@@ -11,6 +11,7 @@ export interface IVeltCommentDialogComposerProps extends React.DetailedHTMLProps
     commentplaceholder?: string;
     replyplaceholder?: string;
     editplaceholder?: string;
+    targetElementId?: string;
 }
 declare const VeltCommentDialogComposer: React.FC<IVeltCommentDialogComposerProps>;
 export default VeltCommentDialogComposer;

package/esm/types/constants.d.ts

@@ -1,5 +1,5 @@
 /// <reference types="react" />
-export declare const VELT_SDK_VERSION = "5.0.0-beta.1";
+export declare const VELT_SDK_VERSION = "5.0.0-beta.3";
 export declare const VELT_SDK_INIT_EVENT = "onVeltInit";
 export declare const VELT_TAB_ID = "veltTabId";
 export declare const INTEGRITY_MAP: Record<string, string>;

package/esm/types/loadSnippyly.d.ts

@@ -1,2 +1,28 @@
-declare const loadVelt: (callback: Function, version?: string, staging?: boolean, develop?: boolean, proxyDomain?: string, integrity?: boolean, integrityValue?: string) => void;
+/**
+ * Loads the Velt script dynamically and calls the callback when ready.
+ * Returns a cleanup function to remove the event listener if component unmounts.
+ *
+ * ## Issue (Rapid Mount/Unmount with Slow Network)
+ *
+ * When VeltProvider is rapidly mounted/unmounted (e.g., conditional rendering,
+ * React Strict Mode, or route changes) while the Velt script is still loading
+ * over a slow network, multiple issues can occur:
+ *
+ * 1. First component mount creates the script tag and starts loading
+ * 2. Component unmounts before script loads (script tag remains in DOM)
+ * 3. Second component mount finds existing script tag
+ * 4. OLD BEHAVIOR: Immediately triggered callback assuming script was loaded
+ * 5. PROBLEM: Script wasn't actually loaded yet (still loading due to network delay)
+ * 6. This caused initVelt to run with window.Velt = undefined
+ *
+ * ## Fix
+ *
+ * 1. Check if window.Velt exists before triggering callback for existing scripts
+ * 2. If script tag exists but window.Velt doesn't, attach a new load event listener
+ * 3. Return a cleanup function that removes the event listener when component unmounts
+ * 4. This prevents orphaned callbacks from firing on destroyed component instances
+ *
+ * @returns Cleanup function to remove event listener (call on component unmount)
+ */
+declare const loadVelt: (callback: Function, version?: string, staging?: boolean, develop?: boolean, proxyDomain?: string, integrity?: boolean, integrityValue?: string) => (() => void);
 export default loadVelt;

package/index.d.ts

@@ -795,6 +795,8 @@ interface IVeltCommentComposerProps extends React$1.DetailedHTMLProps<React$1.HT
     locationId?: string;
     documentId?: string;
     folderId?: string;
+    placeholder?: string;
+    targetElementId?: string;
 }
 declare const VeltCommentComposer: React$1.FC<IVeltCommentComposerProps>;
 
@@ -822,6 +824,7 @@ interface IVeltCommentDialogProps extends React$1.DetailedHTMLProps<React$1.HTML
     commentPinSelected?: boolean;
     fullExpanded?: boolean;
     shadowDom?: boolean;
+    placeholder?: string;
 }
 declare const VeltCommentDialog: React$1.FC<IVeltCommentDialogProps>;
 
@@ -1675,6 +1678,7 @@ interface IVeltCommentDialogComposerProps$1 extends React$1.DetailedHTMLProps<Re
     commentplaceholder?: string;
     replyplaceholder?: string;
     editplaceholder?: string;
+    targetElementId?: string;
 }
 declare const VeltCommentDialogComposer: React$1.FC<IVeltCommentDialogComposerProps$1>;
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@veltdev/react",
-    "version": "5.0.0-beta.1",
+    "version": "5.0.0-beta.3",
     "description": "Velt is an SDK to add collaborative features to your product within minutes. Example: Comments like Figma, Frame.io, Google docs or sheets, Recording like Loom, Huddles like Slack and much more.",
     "homepage": "https://velt.dev",
     "keywords": [