@deepdesk/deepdesk-sdk 19.7.2-beta.0 → 19.7.2-beta.2

package/dist/index.d.mts

@@ -2215,6 +2215,18 @@ interface WidgetOptions {
     openAdminFeedback?: OpenAdminFeedbackHandler;
     knowledgeAssist?: KnowledgeAssistOptions;
     assistantOptions?: Omit<EvaluateInput, 'assistantCode'>;
+    /**
+     * Mount the search overlay (command palette) next to the widget, so the widget's Search
+     * button and CMD+K open a search box inside the widget's own frame.
+     *
+     * Set this only when nothing else on the page already mounts a search box, for example an
+     * iframe whose host page has no Deepdesk SDK. When the host page already mounts one (it
+     * calls `mount()` and receives the widget's `ShowCommandPalette` event), leave it off:
+     * the search would open twice and the copy inside the widget would cover the widget.
+     *
+     * @default false
+     */
+    mountSearchOverlay?: boolean;
 }
 interface KnowledgeAssistantWidgetOptions extends KnowledgeAssistOptions {
     customStyles?: WidgetCustomStyles;
@@ -2243,6 +2255,8 @@ declare class DeepdeskSDK {
     private dialogOverlaysCustomStyles;
     /** OR of includeLoginOverlay across ensureDialogOverlays callers (mount can upgrade widget-only). */
     private dialogOverlaysIncludeLogin;
+    /** True while the rendered widget asked for the shared overlays (`mountSearchOverlay`). */
+    private widgetOwnsDialogOverlays;
     private nicknameDialogUnsubscribe;
     private nicknameDialogFailed;
     private dynamicThunkObject;
@@ -3549,6 +3563,11 @@ declare class DeepdeskSDK {
      */
     private ensureDialogOverlays;
     private disposeDialogOverlays;
+    /**
+     * `mount()` is done with the shared overlays. They go away unless the rendered widget asked
+     * for them (`mountSearchOverlay`); then only what `mount()` added, the login overlay, goes.
+     */
+    private releaseDialogOverlaysFromMount;
     private renderOverlays;
     /**
      * Renders the Deepdesk widget in a container element.
@@ -3560,10 +3579,11 @@ declare class DeepdeskSDK {
      * **Important:** Make sure to set the container element to a fixed or minimum size
      * (height and width) as the widget will grow to fill the container.
      *
-     * Also mounts dialog overlays (search command palette / CMD+K) so iframe-only
-     * integrations that never call {@link mount} still get search. Shared with `mount()` —
-     * only one overlays root exists per SDK instance. Does **not** mount `LoginOverlay`
-     * (iframe apps use their own sign-in); `mount()` still can.
+     * Mounts dialog overlays (search command palette / CMD+K) only when
+     * `options.mountSearchOverlay` is `true`, for iframe-only integrations that never call
+     * {@link mount} and whose host page has no search box. Shared with `mount()` — only one
+     * overlays root exists per SDK instance. Does **not** mount `LoginOverlay` (iframe apps
+     * use their own sign-in); `mount()` still can.
      *
      * **Note:** Only one widget can be rendered per SDK instance.
      *
@@ -3574,6 +3594,7 @@ declare class DeepdeskSDK {
      * @param options.isEmbedded - Whether the widget is embedded in another application
      * @param options.knowledgeAssist - Knowledge assistant configuration
      * @param options.assistantOptions - Assistant evaluation options
+     * @param options.mountSearchOverlay - Mount a search box inside the widget's frame (default: false)
      *
      * @example
      * ```typescript

package/dist/index.d.ts

@@ -2215,6 +2215,18 @@ interface WidgetOptions {
     openAdminFeedback?: OpenAdminFeedbackHandler;
     knowledgeAssist?: KnowledgeAssistOptions;
     assistantOptions?: Omit<EvaluateInput, 'assistantCode'>;
+    /**
+     * Mount the search overlay (command palette) next to the widget, so the widget's Search
+     * button and CMD+K open a search box inside the widget's own frame.
+     *
+     * Set this only when nothing else on the page already mounts a search box, for example an
+     * iframe whose host page has no Deepdesk SDK. When the host page already mounts one (it
+     * calls `mount()` and receives the widget's `ShowCommandPalette` event), leave it off:
+     * the search would open twice and the copy inside the widget would cover the widget.
+     *
+     * @default false
+     */
+    mountSearchOverlay?: boolean;
 }
 interface KnowledgeAssistantWidgetOptions extends KnowledgeAssistOptions {
     customStyles?: WidgetCustomStyles;
@@ -2243,6 +2255,8 @@ declare class DeepdeskSDK {
     private dialogOverlaysCustomStyles;
     /** OR of includeLoginOverlay across ensureDialogOverlays callers (mount can upgrade widget-only). */
     private dialogOverlaysIncludeLogin;
+    /** True while the rendered widget asked for the shared overlays (`mountSearchOverlay`). */
+    private widgetOwnsDialogOverlays;
     private nicknameDialogUnsubscribe;
     private nicknameDialogFailed;
     private dynamicThunkObject;
@@ -3549,6 +3563,11 @@ declare class DeepdeskSDK {
      */
     private ensureDialogOverlays;
     private disposeDialogOverlays;
+    /**
+     * `mount()` is done with the shared overlays. They go away unless the rendered widget asked
+     * for them (`mountSearchOverlay`); then only what `mount()` added, the login overlay, goes.
+     */
+    private releaseDialogOverlaysFromMount;
     private renderOverlays;
     /**
      * Renders the Deepdesk widget in a container element.
@@ -3560,10 +3579,11 @@ declare class DeepdeskSDK {
      * **Important:** Make sure to set the container element to a fixed or minimum size
      * (height and width) as the widget will grow to fill the container.
      *
-     * Also mounts dialog overlays (search command palette / CMD+K) so iframe-only
-     * integrations that never call {@link mount} still get search. Shared with `mount()` —
-     * only one overlays root exists per SDK instance. Does **not** mount `LoginOverlay`
-     * (iframe apps use their own sign-in); `mount()` still can.
+     * Mounts dialog overlays (search command palette / CMD+K) only when
+     * `options.mountSearchOverlay` is `true`, for iframe-only integrations that never call
+     * {@link mount} and whose host page has no search box. Shared with `mount()` — only one
+     * overlays root exists per SDK instance. Does **not** mount `LoginOverlay` (iframe apps
+     * use their own sign-in); `mount()` still can.
      *
      * **Note:** Only one widget can be rendered per SDK instance.
      *
@@ -3574,6 +3594,7 @@ declare class DeepdeskSDK {
      * @param options.isEmbedded - Whether the widget is embedded in another application
      * @param options.knowledgeAssist - Knowledge assistant configuration
      * @param options.assistantOptions - Assistant evaluation options
+     * @param options.mountSearchOverlay - Mount a search box inside the widget's frame (default: false)
      *
      * @example
      * ```typescript