vanilla-agent 1.19.0 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vanilla-agent",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "description": "Themeable, plugable streaming agent widget for websites, in plain JS with support for voice input and reasoning / tool output.",
   "type": "module",
   "main": "dist/index.cjs",

package/src/defaults.ts

@@ -48,6 +48,7 @@ export const DEFAULT_WIDGET_CONFIG: Partial<AgentWidgetConfig> = {
     agentIconText: "💬",
     position: "bottom-right",
     width: "min(400px, calc(100vw - 24px))",
+    heightOffset: 0,
     autoExpand: false,
     callToActionIconHidden: false,
     agentIconSize: "40px",

package/src/types.ts

@@ -217,6 +217,14 @@ export type AgentWidgetLauncherConfig = {
    * @default "420px"
    */
   sidebarWidth?: string;
+  /**
+   * Offset (in pixels) to subtract from the calculated panel height.
+   * Useful for adjusting the panel height when there are other fixed elements on the page.
+   * Only applies when not in fullHeight or sidebarMode.
+   * 
+   * @default 0
+   */
+  heightOffset?: number;
   callToActionIconText?: string;
   callToActionIconName?: string;
   callToActionIconColor?: string;

package/src/ui.ts

@@ -1592,9 +1592,11 @@ export const createAgentExperience = (
     if (!fullHeight) {
       const viewportHeight = window.innerHeight;
       const verticalMargin = 64; // leave space for launcher's offset
+      const heightOffset = config.launcher?.heightOffset ?? 0;
       const available = Math.max(200, viewportHeight - verticalMargin);
       const clamped = Math.min(640, available);
-      panel.style.height = `${clamped}px`;
+      const finalHeight = Math.max(200, clamped - heightOffset);
+      panel.style.height = `${finalHeight}px`;
     }
   };