@helpai/elements 0.12.0 → 0.12.1

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-B4_b3Sjy.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, L as Link, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-JVnkJNsR.js';
 import 'zod';
 
 /**
@@ -284,32 +284,28 @@ interface WelcomeOptions {
     speed?: number;
 }
 /**
- * Identifiers for every header action the widget can render. Order in
- * `HeaderActionsOption.main` / `.overflow` lists is preserved in the UI.
+ * Identifiers for every header action the widget can render.
  *
- * - `clear`       — Start a new conversation (trash icon).
+ * `history` + `close` render as dedicated header buttons; the rest appear in
+ * the ⋯ overflow menu. The enabled set is a flat {@link ActionList}; order is
+ * irrelevant (the menu has a fixed layout). Unlisted actions are hidden.
+ *
+ * - `clear`       — Start a new conversation (compose icon).
  * - `expand`      — Toggle `normal` ↔ `expanded` (1.5× panel).
  * - `fullscreen`  — Toggle `normal` ↔ `fullscreen` (viewport fill).
  * - `popOut`      — Open the conversation in a new browser tab.
  * - `sound`       — Toggle notification sounds + haptics on/off (switch-style).
- * - `language`    — Open a dropdown to switch the UI locale at runtime.
- * - `theme`       — Open a dropdown to switch between `auto` / `light` / `dark`.
+ * - `language`    — Switch the UI locale at runtime.
+ * - `theme`       — Cycle `auto` / `light` / `dark`.
  * - `close`       — Close the floating panel.
  */
 type ActionName = "clear" | "expand" | "fullscreen" | "popOut" | "sound" | "history" | "language" | "theme" | "close";
 /**
- * Which actions appear in the panel header, and where.
- *
- * - `main`     — rendered as icon buttons in the header bar, left-to-right.
- * - `overflow` — rendered as icon + label rows under the 3-dot menu.
- *
- * Unlisted actions are **hidden**. Order is preserved. Per-mode defaults
- * (`DEFAULT_ACTIONS_BY_MODE`) pick sensible placements for each mode.
+ * The header's enabled actions. Unlisted actions are hidden; order is
+ * irrelevant. Per-mode defaults (`DEFAULT_ACTIONS_BY_MODE`) pick a sensible
+ * set for each mode; a deployment can replace the whole list.
  */
-interface HeaderActionsOption {
-    main?: ActionName[];
-    overflow?: ActionName[];
-}
+type ActionList = ActionName[];
 
 /**
  * Composer + features. The send-button skin, attachment limits, voice
@@ -677,11 +673,11 @@ interface BehaviorOptions {
     popOutUrl?: string;
 }
 /**
- * Section: panel header actions — which appear in the main row and
- * which under the ⋯ overflow menu.
+ * Section: panel header actions — the enabled set (`history`/`close` buttons +
+ * ⋯ menu). Unlisted actions are hidden.
  */
 interface HeaderOptions {
-    actions?: HeaderActionsOption;
+    actions?: ActionList;
 }
 /**
  * Section: locale resolution + per-instance string overrides.
@@ -914,11 +910,11 @@ interface ResolvedOptions {
     locale: string;
     /**
      * Locales offered in the language switcher. Empty array hides the
-     * switcher even when the `language` action is in `actions.main`.
+     * language action even when it's enabled.
      */
     availableLocales: string[];
     startMinimized: boolean;
-    actions: Required<HeaderActionsOption>;
+    actions: ActionList;
     size: SizeOptions;
     launcher: Required<Omit<LauncherOptions, "callout" | "label">> & {
         /** Label is optional even after resolution (`circle` variant has no label). */

package/index.mjs

@@ -322,30 +322,12 @@ var DEFAULT_LAUNCHER = {
   hidden: false
 };
 var DEFAULT_ACTIONS_BY_MODE = {
-  floating: {
-    main: ["theme", "history", "close"],
-    overflow: ["clear", "expand", "fullscreen", "popOut", "sound", "language"]
-  },
-  inline: {
-    main: ["theme", "history", "close"],
-    overflow: ["clear", "fullscreen", "popOut", "sound", "language"]
-  },
-  standalone: {
-    main: ["theme", "history"],
-    overflow: ["clear", "sound", "language"]
-  },
-  page: {
-    main: ["theme", "history"],
-    overflow: ["clear", "sound", "language"]
-  },
-  modal: {
-    main: ["theme", "history", "close"],
-    overflow: ["clear", "fullscreen", "popOut", "sound", "language"]
-  },
-  drawer: {
-    main: ["theme", "history", "close"],
-    overflow: ["clear", "fullscreen", "popOut", "sound", "language"]
-  }
+  floating: ["theme", "history", "close", "clear", "expand", "fullscreen", "popOut", "sound", "language"],
+  inline: ["theme", "history", "close", "clear", "fullscreen", "popOut", "sound", "language"],
+  standalone: ["theme", "history", "clear", "sound", "language"],
+  page: ["theme", "history", "clear", "sound", "language"],
+  modal: ["theme", "history", "close", "clear", "fullscreen", "popOut", "sound", "language"],
+  drawer: ["theme", "history", "close", "clear", "fullscreen", "popOut", "sound", "language"]
 };
 var DEFAULT_SOUND = {
   enabled: true,
@@ -434,11 +416,7 @@ function resolveDefaultLocale(input) {
   return typeof navigator !== "undefined" && navigator.language ? navigator.language : "en";
 }
 function resolveActions(mode, overrides) {
-  const defaults = DEFAULT_ACTIONS_BY_MODE[mode];
-  return {
-    main: overrides?.main ?? defaults.main,
-    overflow: overrides?.overflow ?? defaults.overflow
-  };
+  return overrides ?? DEFAULT_ACTIONS_BY_MODE[mode];
 }
 function resolveSound(overrides) {
   return {
@@ -2759,7 +2737,7 @@ function isActionVisible(name, mode, panelSize, ctx) {
 }
 function canShowClose(mode, panelSize, actions) {
   if (!isActionVisible("close", mode, panelSize)) return false;
-  return actions.main.includes("close") || actions.overflow.includes("close");
+  return actions.includes("close");
 }
 function resolveCloseAction(mode, panelSize) {
   if (mode === "inline" && panelSize === "fullscreen") return "exit-fullscreen";
@@ -3459,7 +3437,7 @@ function HeaderActions({ panelProps, variant }) {
   const mode = options.mode;
   const isChat = variant === "chat";
   const muted = useComputed(() => feedback.mutedSig.value).value;
-  const enabled = /* @__PURE__ */ new Set([...options.actions.main, ...options.actions.overflow]);
+  const enabled = new Set(options.actions);
   const has = (name) => enabled.has(name);
   const visible = (name) => isActionVisible(name, mode, panelSize, { popOutUrl: options.popOutUrl });
   const themeMode = options.themeMode;

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.12.0"
+  "version": "0.12.1"
 }

package/schema.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startSessionResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-B4_b3Sjy.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartSessionResponse, U as UserContext, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial, h as assetSchema, i as blocksConfigSchema, j as connectionConfigPartialSchema, k as connectionConfigSchema, l as cssColorSchema, m as cssLengthSchema, n as endpointsSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, t as startSessionResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-JVnkJNsR.js';
 import { z } from 'zod';
 
 /**
@@ -310,14 +310,15 @@ declare const featureFlagsSchema: z.ZodObject<{
 type FeatureFlags = z.infer<typeof featureFlagsSchema>;
 
 /**
- * Header section schemas — which actions appear in the panel's top
- * bar and where (main row of icons vs. the ⋯ overflow menu).
+ * Header section schema — which actions the panel header exposes.
  *
+ * `history` + `close` render as dedicated buttons; everything else lives in the
+ * ⋯ overflow menu (fixed layout, so list order is irrelevant — it's a set).
  * Per-mode defaults live in `core/config/defaults.ts`
  * (`DEFAULT_ACTIONS_BY_MODE`). The `isActionVisible(...)` helper in
- * `ui/action-visibility.ts` filters at render time so a listed action
- * can still be hidden in a state where it would no-op (e.g. `close`
- * in inline-normal, `popOut` in standalone).
+ * `ui/action-visibility.ts` filters at render time so a listed action can still
+ * be hidden in a state where it would no-op (e.g. `close` in inline-normal,
+ * `popOut` in standalone).
  */
 
 declare const actionNameSchema: z.ZodEnum<{
@@ -332,19 +333,21 @@ declare const actionNameSchema: z.ZodEnum<{
     sound: "sound";
 }>;
 type ActionName = z.infer<typeof actionNameSchema>;
-declare const headerActionsSchema: z.ZodObject<{
-    main: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-        close: "close";
-        expand: "expand";
-        fullscreen: "fullscreen";
-        popOut: "popOut";
-        clear: "clear";
-        theme: "theme";
-        language: "language";
-        history: "history";
-        sound: "sound";
-    }>>>;
-    overflow: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+declare const headerActionsSchema: z.ZodArray<z.ZodEnum<{
+    close: "close";
+    expand: "expand";
+    fullscreen: "fullscreen";
+    popOut: "popOut";
+    clear: "clear";
+    theme: "theme";
+    language: "language";
+    history: "history";
+    sound: "sound";
+}>>;
+type HeaderActions = z.infer<typeof headerActionsSchema>;
+/** Section wrapper — `actions` list wrapped under `header` in the dashboard form. */
+declare const headerSchema: z.ZodObject<{
+    actions: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         close: "close";
         expand: "expand";
         fullscreen: "fullscreen";
@@ -356,34 +359,6 @@ declare const headerActionsSchema: z.ZodObject<{
         sound: "sound";
     }>>>;
 }, z.core.$loose>;
-type HeaderActions = z.infer<typeof headerActionsSchema>;
-/** Section wrapper — same shape, wrapped under `header` in the dashboard form. */
-declare const headerSchema: z.ZodObject<{
-    actions: z.ZodOptional<z.ZodObject<{
-        main: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-            close: "close";
-            expand: "expand";
-            fullscreen: "fullscreen";
-            popOut: "popOut";
-            clear: "clear";
-            theme: "theme";
-            language: "language";
-            history: "history";
-            sound: "sound";
-        }>>>;
-        overflow: z.ZodDefault<z.ZodArray<z.ZodEnum<{
-            close: "close";
-            expand: "expand";
-            fullscreen: "fullscreen";
-            popOut: "popOut";
-            clear: "clear";
-            theme: "theme";
-            language: "language";
-            history: "history";
-            sound: "sound";
-        }>>>;
-    }, z.core.$loose>>;
-}, z.core.$loose>;
 type HeaderOptions = z.infer<typeof headerSchema>;
 
 /**

package/schema.json

@@ -707,114 +707,43 @@
           "type": "object",
           "properties": {
             "actions": {
-              "description": "Action layout — main row vs. ⋯ overflow menu.",
-              "type": "object",
-              "properties": {
-                "main": {
-                  "default": [],
-                  "description": "Actions rendered as icon buttons in the panel's top bar (left-to-right). Always visible. Order is preserved. Pick from: `clear`, `expand`, `fullscreen`, `popOut`, `sound`, `history`, `language`, `theme`, `close`. Anything not listed in `main` or `overflow` is hidden.",
-                  "examples": [
-                    [
-                      "theme",
-                      "history",
-                      "close"
-                    ],
-                    [
-                      "language",
-                      "theme",
-                      "close"
-                    ],
-                    [
-                      "close"
-                    ]
-                  ],
-                  "maxItems": 8,
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "enum": [
-                      "clear",
-                      "expand",
-                      "fullscreen",
-                      "popOut",
-                      "sound",
-                      "history",
-                      "language",
-                      "theme",
-                      "close"
-                    ]
-                  }
-                },
-                "overflow": {
-                  "default": [],
-                  "description": "Actions tucked under the 3-dot ⋯ menu (icon + label rows). Same list of ids as `main`. Promote items to `main` to make them always-visible icons; demote them back here to hide them behind the menu.",
-                  "examples": [
-                    [
-                      "clear",
-                      "expand",
-                      "fullscreen",
-                      "popOut",
-                      "sound",
-                      "language"
-                    ],
-                    [
-                      "clear",
-                      "popOut",
-                      "sound"
-                    ],
-                    []
-                  ],
-                  "maxItems": 8,
-                  "type": "array",
-                  "items": {
-                    "type": "string",
-                    "enum": [
-                      "clear",
-                      "expand",
-                      "fullscreen",
-                      "popOut",
-                      "sound",
-                      "history",
-                      "language",
-                      "theme",
-                      "close"
-                    ]
-                  }
-                }
+              "description": "Which header actions are enabled (history/✕ buttons + ⋯ menu).",
+              "maxItems": 9,
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": [
+                  "clear",
+                  "expand",
+                  "fullscreen",
+                  "popOut",
+                  "sound",
+                  "history",
+                  "language",
+                  "theme",
+                  "close"
+                ]
               },
-              "required": [
-                "main",
-                "overflow"
-              ],
-              "additionalProperties": {},
               "examples": [
-                {
-                  "main": [
-                    "theme",
-                    "history",
-                    "close"
-                  ],
-                  "overflow": [
-                    "clear",
-                    "fullscreen",
-                    "popOut",
-                    "sound",
-                    "language"
-                  ]
-                },
-                {
-                  "main": [
-                    "close"
-                  ],
-                  "overflow": [
-                    "clear",
-                    "theme"
-                  ]
-                },
-                {
-                  "main": [],
-                  "overflow": []
-                }
+                [
+                  "theme",
+                  "history",
+                  "close",
+                  "clear",
+                  "fullscreen",
+                  "popOut",
+                  "sound",
+                  "language"
+                ],
+                [
+                  "theme",
+                  "history",
+                  "clear",
+                  "language"
+                ],
+                [
+                  "close"
+                ]
               ]
             }
           },
@@ -822,17 +751,13 @@
           "description": "Panel-header configuration.",
           "examples": [
             {
-              "actions": {
-                "main": [
-                  "theme",
-                  "history",
-                  "close"
-                ],
-                "overflow": [
-                  "clear",
-                  "fullscreen"
-                ]
-              }
+              "actions": [
+                "theme",
+                "history",
+                "close",
+                "clear",
+                "fullscreen"
+              ]
             }
           ]
         },
@@ -2179,114 +2104,43 @@
               "type": "object",
               "properties": {
                 "actions": {
-                  "description": "Action layout — main row vs. ⋯ overflow menu.",
-                  "type": "object",
-                  "properties": {
-                    "main": {
-                      "default": [],
-                      "description": "Actions rendered as icon buttons in the panel's top bar (left-to-right). Always visible. Order is preserved. Pick from: `clear`, `expand`, `fullscreen`, `popOut`, `sound`, `history`, `language`, `theme`, `close`. Anything not listed in `main` or `overflow` is hidden.",
-                      "examples": [
-                        [
-                          "theme",
-                          "history",
-                          "close"
-                        ],
-                        [
-                          "language",
-                          "theme",
-                          "close"
-                        ],
-                        [
-                          "close"
-                        ]
-                      ],
-                      "maxItems": 8,
-                      "type": "array",
-                      "items": {
-                        "type": "string",
-                        "enum": [
-                          "clear",
-                          "expand",
-                          "fullscreen",
-                          "popOut",
-                          "sound",
-                          "history",
-                          "language",
-                          "theme",
-                          "close"
-                        ]
-                      }
-                    },
-                    "overflow": {
-                      "default": [],
-                      "description": "Actions tucked under the 3-dot ⋯ menu (icon + label rows). Same list of ids as `main`. Promote items to `main` to make them always-visible icons; demote them back here to hide them behind the menu.",
-                      "examples": [
-                        [
-                          "clear",
-                          "expand",
-                          "fullscreen",
-                          "popOut",
-                          "sound",
-                          "language"
-                        ],
-                        [
-                          "clear",
-                          "popOut",
-                          "sound"
-                        ],
-                        []
-                      ],
-                      "maxItems": 8,
-                      "type": "array",
-                      "items": {
-                        "type": "string",
-                        "enum": [
-                          "clear",
-                          "expand",
-                          "fullscreen",
-                          "popOut",
-                          "sound",
-                          "history",
-                          "language",
-                          "theme",
-                          "close"
-                        ]
-                      }
-                    }
+                  "description": "Which header actions are enabled (history/✕ buttons + ⋯ menu).",
+                  "maxItems": 9,
+                  "type": "array",
+                  "items": {
+                    "type": "string",
+                    "enum": [
+                      "clear",
+                      "expand",
+                      "fullscreen",
+                      "popOut",
+                      "sound",
+                      "history",
+                      "language",
+                      "theme",
+                      "close"
+                    ]
                   },
-                  "required": [
-                    "main",
-                    "overflow"
-                  ],
-                  "additionalProperties": {},
                   "examples": [
-                    {
-                      "main": [
-                        "theme",
-                        "history",
-                        "close"
-                      ],
-                      "overflow": [
-                        "clear",
-                        "fullscreen",
-                        "popOut",
-                        "sound",
-                        "language"
-                      ]
-                    },
-                    {
-                      "main": [
-                        "close"
-                      ],
-                      "overflow": [
-                        "clear",
-                        "theme"
-                      ]
-                    },
-                    {
-                      "main": [],
-                      "overflow": []
-                    }
+                    [
+                      "theme",
+                      "history",
+                      "close",
+                      "clear",
+                      "fullscreen",
+                      "popOut",
+                      "sound",
+                      "language"
+                    ],
+                    [
+                      "theme",
+                      "history",
+                      "clear",
+                      "language"
+                    ],
+                    [
+                      "close"
+                    ]
                   ]
                 }
               },
@@ -2294,17 +2148,13 @@
               "description": "Panel-header configuration.",
               "examples": [
                 {
-                  "actions": {
-                    "main": [
-                      "theme",
-                      "history",
-                      "close"
-                    ],
-                    "overflow": [
-                      "clear",
-                      "fullscreen"
-                    ]
-                  }
+                  "actions": [
+                    "theme",
+                    "history",
+                    "close",
+                    "clear",
+                    "fullscreen"
+                  ]
                 }
               ]
             },

package/schema.mjs

@@ -247,30 +247,19 @@ var actionNameSchema = z8.enum([
   "theme",
   "close"
 ]);
-var headerActionsSchema = z8.object({
-  main: z8.array(actionNameSchema).max(8).default([]).describe(
-    "Actions rendered as icon buttons in the panel's top bar (left-to-right). Always visible. Order is preserved. Pick from: `clear`, `expand`, `fullscreen`, `popOut`, `sound`, `history`, `language`, `theme`, `close`. Anything not listed in `main` or `overflow` is hidden."
-  ).meta({
-    examples: [["theme", "history", "close"], ["language", "theme", "close"], ["close"]]
-  }),
-  overflow: z8.array(actionNameSchema).max(8).default([]).describe(
-    "Actions tucked under the 3-dot \u22EF menu (icon + label rows). Same list of ids as `main`. Promote items to `main` to make them always-visible icons; demote them back here to hide them behind the menu."
-  ).meta({
-    examples: [["clear", "expand", "fullscreen", "popOut", "sound", "language"], ["clear", "popOut", "sound"], []]
-  })
-}).loose().describe(
-  "Which actions appear in the panel header and where. `main` = always-visible icon buttons; `overflow` = items under the \u22EF menu. Anything not listed is hidden. Per-mode defaults live in `DEFAULT_ACTIONS_BY_MODE`."
+var headerActionsSchema = z8.array(actionNameSchema).max(9).describe(
+  "Which actions the header exposes. `history` + `close` are dedicated buttons; the rest appear in the \u22EF menu. Unlisted actions are hidden; order is irrelevant. Pick from: `clear`, `expand`, `fullscreen`, `popOut`, `sound`, `history`, `language`, `theme`, `close`. Per-mode defaults live in `DEFAULT_ACTIONS_BY_MODE`."
 ).meta({
   examples: [
-    { main: ["theme", "history", "close"], overflow: ["clear", "fullscreen", "popOut", "sound", "language"] },
-    { main: ["close"], overflow: ["clear", "theme"] },
-    { main: [], overflow: [] }
+    ["theme", "history", "close", "clear", "fullscreen", "popOut", "sound", "language"],
+    ["theme", "history", "clear", "language"],
+    ["close"]
   ]
 });
 var headerSchema = z8.object({
-  actions: headerActionsSchema.optional().describe("Action layout \u2014 main row vs. \u22EF overflow menu.")
+  actions: headerActionsSchema.optional().describe("Which header actions are enabled (history/\u2715 buttons + \u22EF menu).")
 }).loose().describe("Panel-header configuration.").meta({
-  examples: [{ actions: { main: ["theme", "history", "close"], overflow: ["clear", "fullscreen"] } }]
+  examples: [{ actions: ["theme", "history", "close", "clear", "fullscreen"] }]
 });
 
 // src/schema/widget/feedback.ts