@helpai/elements 0.6.0 → 0.7.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-DKyrRSGL.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-DhWwzofY.js';
 import 'zod';
 
 /**

package/index.mjs

@@ -884,10 +884,11 @@ function pickInitialPanelSize(mode, size, viewportWidth) {
   }
   return "normal";
 }
-function resolveInitialPanelState(options, viewportWidth, persistedPanelOpen) {
+function resolveInitialPanelState(options, viewportWidth, persistedPanelOpen, persistedPanelSize = null) {
   const isInlineLike = options.mode === "inline" || options.mode === "standalone" || options.mode === "page";
   const panelOpen = isInlineLike || (persistedPanelOpen ?? !options.startMinimized);
-  const panelSize = pickInitialPanelSize(options.mode, options.size, viewportWidth);
+  const honorsPersisted = options.mode !== "standalone" && options.mode !== "page" && options.mode !== "inline";
+  const panelSize = honorsPersisted && persistedPanelSize ? persistedPanelSize : pickInitialPanelSize(options.mode, options.size, viewportWidth);
   return { panelOpen, panelSize };
 }
 function currentViewportWidth() {
@@ -1810,6 +1811,7 @@ function createPersistence(widgetId, storage = defaultStorage) {
   const KEY_CHAT = `${prefix}.sessionId`;
   const KEY_USER_PREFS = `${prefix}.userPrefs`;
   const KEY_PANEL_OPEN = `${prefix}.panelOpen`;
+  const KEY_PANEL_SIZE = `${prefix}.panelSize`;
   const KEY_CALLOUT_DISMISSED = `${prefix}.calloutDismissed`;
   const KEY_SIDEBAR_COLLAPSED = `${prefix}.sidebarCollapsed`;
   const KEY_ACTIVE_MODULE = `${prefix}.activeModule`;
@@ -1864,6 +1866,13 @@ function createPersistence(widgetId, storage = defaultStorage) {
     savePanelOpen(open) {
       storage.set(KEY_PANEL_OPEN, open ? "1" : "0");
     },
+    loadPanelSize() {
+      const raw = storage.get(KEY_PANEL_SIZE);
+      return raw === "normal" || raw === "expanded" || raw === "fullscreen" ? raw : null;
+    },
+    savePanelSize(size) {
+      storage.set(KEY_PANEL_SIZE, size);
+    },
     loadCalloutDismissed(currentText) {
       if (!currentText) return false;
       const dismissedText = storage.get(KEY_CALLOUT_DISMISSED);
@@ -2169,6 +2178,12 @@ var FeedbackBus = class {
   }
 };
 
+// src/ui/error-message.ts
+function errorMessageFor(error, strings) {
+  if (error instanceof StreamError && error.status === 429) return strings.errorRateLimited;
+  return strings.errorGeneric;
+}
+
 // src/ui/launcher.tsx
 import { useEffect, useState } from "preact/hooks";
 
@@ -4585,6 +4600,7 @@ function ArticleRow({ article, nav }) {
 function HelpRoot({ transport, strings, config, nav, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState6("loading");
+  const [errorMsg, setErrorMsg] = useState6(strings.errorGeneric);
   const [items, setItems] = useState6([]);
   const [query, setQuery] = useState6("");
   const [reloadKey, setReloadKey] = useState6(0);
@@ -4598,6 +4614,7 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     }).catch((err) => {
       if (cancelled) return;
       log12.warn("listContent (help) failed", { err });
+      setErrorMsg(errorMessageFor(err, strings));
       setState("error");
     });
     return () => {
@@ -4612,15 +4629,7 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     }
     if (state === "loading") return /* @__PURE__ */ jsx25(ModuleState, { message: strings.helpLoading, strings });
     if (state === "error") {
-      return /* @__PURE__ */ jsx25(
-        ModuleState,
-        {
-          tone: "error",
-          message: strings.errorGeneric,
-          onRetry: () => setReloadKey((k) => k + 1),
-          strings
-        }
-      );
+      return /* @__PURE__ */ jsx25(ModuleState, { tone: "error", message: errorMsg, onRetry: () => setReloadKey((k) => k + 1), strings });
     }
     if (items.length === 0) return /* @__PURE__ */ jsx25(ModuleState, { message: strings.helpEmpty, strings });
     return groupByCategory(items).map(([category, rows]) => /* @__PURE__ */ jsxs20("section", { class: `${p18}-help-group`, children: [
@@ -4770,6 +4779,7 @@ var log14 = logger.scope("news");
 function NewsRoot({ transport, strings, config, nav, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState8("loading");
+  const [errorMsg, setErrorMsg] = useState8(strings.errorGeneric);
   const [items, setItems] = useState8([]);
   const [reloadKey, setReloadKey] = useState8(0);
   useEffect13(() => {
@@ -4782,6 +4792,7 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
     }).catch((err) => {
       if (cancelled) return;
       log14.warn("listContent (news) failed", { err });
+      setErrorMsg(errorMessageFor(err, strings));
       setState("error");
     });
     return () => {
@@ -4791,15 +4802,7 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
   function renderBody() {
     if (state === "loading") return /* @__PURE__ */ jsx28(ModuleState, { message: strings.newsLoading, strings });
     if (state === "error") {
-      return /* @__PURE__ */ jsx28(
-        ModuleState,
-        {
-          tone: "error",
-          message: strings.errorGeneric,
-          onRetry: () => setReloadKey((k) => k + 1),
-          strings
-        }
-      );
+      return /* @__PURE__ */ jsx28(ModuleState, { tone: "error", message: errorMsg, onRetry: () => setReloadKey((k) => k + 1), strings });
     }
     if (items.length === 0) return /* @__PURE__ */ jsx28(ModuleState, { message: strings.newsEmpty, strings });
     return /* @__PURE__ */ jsx28("div", { class: `${p21}-news-list`, children: items.map((item) => /* @__PURE__ */ jsxs22(
@@ -5224,7 +5227,7 @@ function App({ options, hostElement, bus }) {
   const [sessionReady, setSessionReady] = useState11(false);
   const isInlineLike = options.mode === "standalone" || options.mode === "inline";
   const initialPanelRef = useRef8(
-    resolveInitialPanelState(options, currentViewportWidth(), persistence.loadPanelOpen())
+    resolveInitialPanelState(options, currentViewportWidth(), persistence.loadPanelOpen(), persistence.loadPanelSize())
   );
   const [isOpen, setIsOpen] = useState11(initialPanelRef.current.panelOpen);
   const initialPanelApplied = useRef8(false);
@@ -5295,13 +5298,19 @@ function App({ options, hostElement, bus }) {
   }, [feedback, patchAndSync]);
   useEffect17(() => {
     if (initialSizeApplied.current || !options.size.initialSize) return;
-    setPanelSize(pickInitialPanelSize(options.mode, options.size, currentViewportWidth()));
     initialSizeApplied.current = true;
-  }, [options.mode, options.size]);
+    if (persistence.loadPanelSize()) return;
+    setPanelSize(pickInitialPanelSize(options.mode, options.size, currentViewportWidth()));
+  }, [options.mode, options.size, persistence]);
   useEffect17(() => {
     if (!sessionReady || initialPanelApplied.current) return;
     initialPanelApplied.current = true;
-    const state = resolveInitialPanelState(options, currentViewportWidth(), persistence.loadPanelOpen());
+    const state = resolveInitialPanelState(
+      options,
+      currentViewportWidth(),
+      persistence.loadPanelOpen(),
+      persistence.loadPanelSize()
+    );
     setIsOpen(state.panelOpen);
     setPanelSize(state.panelSize);
   }, [sessionReady, options, persistence]);
@@ -5506,7 +5515,7 @@ function App({ options, hostElement, bus }) {
         emitMessage(bus, options, "assistant", assistantText(assistantMsg));
       } catch (error) {
         assistantMsg.status = "error";
-        assistantMsg.errorText = error instanceof StreamError && error.status === 429 ? options.strings.errorRateLimited : options.strings.errorGeneric;
+        assistantMsg.errorText = errorMessageFor(error, options.strings);
         feedback.play("error");
         bus.emit("error", error);
         options.onError?.(error);
@@ -5597,17 +5606,19 @@ function App({ options, hostElement, bus }) {
     if (chatId) homeNav.switchTab(chatId);
   }, [handleClear, homeNav, options]);
   const handleExpand = useCallback8(() => {
-    const next = panelSize !== "expanded";
-    log16.info("expand", { from: panelSize, expanded: next });
-    setPanelSize((s) => s === "expanded" ? "normal" : "expanded");
-    bus.emit("expand", next);
-  }, [bus, panelSize]);
+    const nextSize = panelSize === "expanded" ? "normal" : "expanded";
+    log16.info("expand", { from: panelSize, expanded: nextSize === "expanded" });
+    setPanelSize(nextSize);
+    persistence.savePanelSize(nextSize);
+    bus.emit("expand", nextSize === "expanded");
+  }, [bus, panelSize, persistence]);
   const handleFullscreen = useCallback8(() => {
-    const next = panelSize !== "fullscreen";
-    log16.info("fullscreen", { from: panelSize, fullscreen: next });
-    setPanelSize((s) => s === "fullscreen" ? "normal" : "fullscreen");
-    bus.emit("fullscreen", next);
-  }, [bus, panelSize]);
+    const nextSize = panelSize === "fullscreen" ? "normal" : "fullscreen";
+    log16.info("fullscreen", { from: panelSize, fullscreen: nextSize === "fullscreen" });
+    setPanelSize(nextSize);
+    persistence.savePanelSize(nextSize);
+    bus.emit("fullscreen", nextSize === "fullscreen");
+  }, [bus, panelSize, persistence]);
   const handlePopOut = useCallback8(() => {
     if (!options.popOutUrl) return;
     const url = new URL(options.popOutUrl);
@@ -6174,7 +6185,8 @@ function resolveInitialHostMode(options) {
   const { panelOpen, panelSize } = resolveInitialPanelState(
     options,
     currentViewportWidth(),
-    persistence.loadPanelOpen()
+    persistence.loadPanelOpen(),
+    persistence.loadPanelSize()
   );
   return computeHostMode(options.mode, panelSize, panelOpen);
 }

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.6.0"
+  "version": "0.7.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-DKyrRSGL.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-DhWwzofY.js';
 import { z } from 'zod';
 
 /**
@@ -56,9 +56,9 @@ declare const presentationSchema: z.ZodObject<{
         inset: z.ZodOptional<z.ZodString>;
         initialSize: z.ZodDefault<z.ZodEnum<{
             fullscreen: "fullscreen";
+            expanded: "expanded";
             auto: "auto";
             normal: "normal";
-            expanded: "expanded";
         }>>;
         autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
     }, z.core.$loose>>;
@@ -148,9 +148,9 @@ declare const launcherSizeSchema: z.ZodEnum<{
 }>;
 type LauncherSize = z.infer<typeof launcherSizeSchema>;
 declare const calloutShapeSchema: z.ZodEnum<{
+    callout: "callout";
     pill: "pill";
     bubble: "bubble";
-    callout: "callout";
 }>;
 type CalloutShape = z.infer<typeof calloutShapeSchema>;
 declare const calloutPositionSchema: z.ZodEnum<{
@@ -162,9 +162,9 @@ type CalloutPosition = z.infer<typeof calloutPositionSchema>;
 declare const launcherCalloutSchema: z.ZodObject<{
     text: z.ZodDefault<z.ZodString>;
     shape: z.ZodDefault<z.ZodEnum<{
+        callout: "callout";
         pill: "pill";
         bubble: "bubble";
-        callout: "callout";
     }>>;
     position: z.ZodDefault<z.ZodEnum<{
         auto: "auto";
@@ -195,9 +195,9 @@ declare const launcherOptionsSchema: z.ZodObject<{
     callout: z.ZodOptional<z.ZodObject<{
         text: z.ZodDefault<z.ZodString>;
         shape: z.ZodDefault<z.ZodEnum<{
+            callout: "callout";
             pill: "pill";
             bubble: "bubble";
-            callout: "callout";
         }>>;
         position: z.ZodDefault<z.ZodEnum<{
             auto: "auto";
@@ -240,9 +240,9 @@ type LauncherOptions = z.infer<typeof launcherOptionsSchema>;
 
 declare const initialSizeSchema: z.ZodEnum<{
     fullscreen: "fullscreen";
+    expanded: "expanded";
     auto: "auto";
     normal: "normal";
-    expanded: "expanded";
 }>;
 declare const resizeOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
@@ -269,9 +269,9 @@ declare const sizeOptionsSchema: z.ZodObject<{
     inset: z.ZodOptional<z.ZodString>;
     initialSize: z.ZodDefault<z.ZodEnum<{
         fullscreen: "fullscreen";
+        expanded: "expanded";
         auto: "auto";
         normal: "normal";
-        expanded: "expanded";
     }>>;
     autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
 }, z.core.$loose>;
@@ -321,38 +321,38 @@ type FeatureFlags = z.infer<typeof featureFlagsSchema>;
  */
 
 declare const actionNameSchema: z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
     popOut: "popOut";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     history: "history";
-    clear: "clear";
     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";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
     overflow: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+        close: "close";
         expand: "expand";
         fullscreen: "fullscreen";
         popOut: "popOut";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
 }, z.core.$loose>;
@@ -361,25 +361,25 @@ type HeaderActions = z.infer<typeof headerActionsSchema>;
 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";
-            close: "close";
-            language: "language";
+            clear: "clear";
             theme: "theme";
+            language: "language";
             history: "history";
-            clear: "clear";
             sound: "sound";
         }>>>;
         overflow: z.ZodDefault<z.ZodArray<z.ZodEnum<{
+            close: "close";
             expand: "expand";
             fullscreen: "fullscreen";
             popOut: "popOut";
-            close: "close";
-            language: "language";
+            clear: "clear";
             theme: "theme";
+            language: "language";
             history: "history";
-            clear: "clear";
             sound: "sound";
         }>>>;
     }, z.core.$loose>>;
@@ -396,33 +396,33 @@ type HeaderOptions = z.infer<typeof headerSchema>;
  */
 
 declare const feedbackEventSchema: z.ZodEnum<{
+    voiceStart: "voiceStart";
+    voiceStop: "voiceStop";
     error: "error";
     messageReceived: "messageReceived";
     messageSent: "messageSent";
-    voiceStart: "voiceStart";
-    voiceStop: "voiceStop";
 }>;
 type FeedbackEvent = z.infer<typeof feedbackEventSchema>;
 declare const soundOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     volume: z.ZodDefault<z.ZodNumber>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
 }, z.core.$loose>;
 type SoundOptions = z.infer<typeof soundOptionsSchema>;
 declare const hapticsOptionsSchema: z.ZodObject<{
     enabled: z.ZodDefault<z.ZodBoolean>;
     events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+        voiceStart: "voiceStart";
+        voiceStop: "voiceStop";
         error: "error";
         messageReceived: "messageReceived";
         messageSent: "messageSent";
-        voiceStart: "voiceStart";
-        voiceStop: "voiceStop";
     }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
 }, z.core.$loose>;
 type HapticsOptions = z.infer<typeof hapticsOptionsSchema>;
@@ -431,21 +431,21 @@ declare const feedbackSchema: z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         volume: z.ZodDefault<z.ZodNumber>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>>;
     }, z.core.$loose>>;
     haptics: z.ZodOptional<z.ZodObject<{
         enabled: z.ZodDefault<z.ZodBoolean>;
         events: z.ZodOptional<z.ZodRecord<z.ZodEnum<{
+            voiceStart: "voiceStart";
+            voiceStop: "voiceStop";
             error: "error";
             messageReceived: "messageReceived";
             messageSent: "messageSent";
-            voiceStart: "voiceStart";
-            voiceStop: "voiceStop";
         }> & z.core.$partial, z.ZodUnion<readonly [z.ZodBoolean, z.ZodNumber, z.ZodArray<z.ZodNumber>]>>>;
     }, z.core.$loose>>;
 }, z.core.$loose>;
@@ -607,18 +607,18 @@ type I18nOptions = z.infer<typeof i18nSchema>;
  */
 
 declare const moduleLayoutSchema: z.ZodEnum<{
+    home: "home";
     chat: "chat";
     help: "help";
-    home: "home";
     news: "news";
 }>;
 type ModuleLayout = z.infer<typeof moduleLayoutSchema>;
 declare const moduleSchema: z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -644,9 +644,9 @@ type ModuleOptions = z.infer<typeof moduleSchema>;
 declare const modulesSchema: z.ZodArray<z.ZodObject<{
     label: z.ZodString;
     layout: z.ZodEnum<{
+        home: "home";
         chat: "chat";
         help: "help";
-        home: "home";
         news: "news";
     }>;
     contentTags: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/web-component.mjs

@@ -948,10 +948,11 @@ function pickInitialPanelSize(mode, size, viewportWidth) {
   }
   return "normal";
 }
-function resolveInitialPanelState(options, viewportWidth, persistedPanelOpen) {
+function resolveInitialPanelState(options, viewportWidth, persistedPanelOpen, persistedPanelSize = null) {
   const isInlineLike = options.mode === "inline" || options.mode === "standalone" || options.mode === "page";
   const panelOpen = isInlineLike || (persistedPanelOpen ?? !options.startMinimized);
-  const panelSize = pickInitialPanelSize(options.mode, options.size, viewportWidth);
+  const honorsPersisted = options.mode !== "standalone" && options.mode !== "page" && options.mode !== "inline";
+  const panelSize = honorsPersisted && persistedPanelSize ? persistedPanelSize : pickInitialPanelSize(options.mode, options.size, viewportWidth);
   return { panelOpen, panelSize };
 }
 function currentViewportWidth() {
@@ -1874,6 +1875,7 @@ function createPersistence(widgetId, storage = defaultStorage) {
   const KEY_CHAT = `${prefix}.sessionId`;
   const KEY_USER_PREFS = `${prefix}.userPrefs`;
   const KEY_PANEL_OPEN = `${prefix}.panelOpen`;
+  const KEY_PANEL_SIZE = `${prefix}.panelSize`;
   const KEY_CALLOUT_DISMISSED = `${prefix}.calloutDismissed`;
   const KEY_SIDEBAR_COLLAPSED = `${prefix}.sidebarCollapsed`;
   const KEY_ACTIVE_MODULE = `${prefix}.activeModule`;
@@ -1928,6 +1930,13 @@ function createPersistence(widgetId, storage = defaultStorage) {
     savePanelOpen(open) {
       storage.set(KEY_PANEL_OPEN, open ? "1" : "0");
     },
+    loadPanelSize() {
+      const raw = storage.get(KEY_PANEL_SIZE);
+      return raw === "normal" || raw === "expanded" || raw === "fullscreen" ? raw : null;
+    },
+    savePanelSize(size) {
+      storage.set(KEY_PANEL_SIZE, size);
+    },
     loadCalloutDismissed(currentText) {
       if (!currentText) return false;
       const dismissedText = storage.get(KEY_CALLOUT_DISMISSED);
@@ -2233,6 +2242,12 @@ var FeedbackBus = class {
   }
 };
 
+// src/ui/error-message.ts
+function errorMessageFor(error, strings) {
+  if (error instanceof StreamError && error.status === 429) return strings.errorRateLimited;
+  return strings.errorGeneric;
+}
+
 // src/ui/launcher.tsx
 import { useEffect, useState } from "preact/hooks";
 
@@ -4649,6 +4664,7 @@ function ArticleRow({ article, nav }) {
 function HelpRoot({ transport, strings, config, nav, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState6("loading");
+  const [errorMsg, setErrorMsg] = useState6(strings.errorGeneric);
   const [items, setItems] = useState6([]);
   const [query, setQuery] = useState6("");
   const [reloadKey, setReloadKey] = useState6(0);
@@ -4662,6 +4678,7 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     }).catch((err) => {
       if (cancelled) return;
       log12.warn("listContent (help) failed", { err });
+      setErrorMsg(errorMessageFor(err, strings));
       setState("error");
     });
     return () => {
@@ -4676,15 +4693,7 @@ function HelpRoot({ transport, strings, config, nav, panelProps }) {
     }
     if (state === "loading") return /* @__PURE__ */ jsx25(ModuleState, { message: strings.helpLoading, strings });
     if (state === "error") {
-      return /* @__PURE__ */ jsx25(
-        ModuleState,
-        {
-          tone: "error",
-          message: strings.errorGeneric,
-          onRetry: () => setReloadKey((k) => k + 1),
-          strings
-        }
-      );
+      return /* @__PURE__ */ jsx25(ModuleState, { tone: "error", message: errorMsg, onRetry: () => setReloadKey((k) => k + 1), strings });
     }
     if (items.length === 0) return /* @__PURE__ */ jsx25(ModuleState, { message: strings.helpEmpty, strings });
     return groupByCategory(items).map(([category, rows]) => /* @__PURE__ */ jsxs20("section", { class: `${p18}-help-group`, children: [
@@ -4834,6 +4843,7 @@ var log14 = logger.scope("news");
 function NewsRoot({ transport, strings, config, nav, panelProps }) {
   const tags = config.contentTags;
   const [state, setState] = useState8("loading");
+  const [errorMsg, setErrorMsg] = useState8(strings.errorGeneric);
   const [items, setItems] = useState8([]);
   const [reloadKey, setReloadKey] = useState8(0);
   useEffect13(() => {
@@ -4846,6 +4856,7 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
     }).catch((err) => {
       if (cancelled) return;
       log14.warn("listContent (news) failed", { err });
+      setErrorMsg(errorMessageFor(err, strings));
       setState("error");
     });
     return () => {
@@ -4855,15 +4866,7 @@ function NewsRoot({ transport, strings, config, nav, panelProps }) {
   function renderBody() {
     if (state === "loading") return /* @__PURE__ */ jsx28(ModuleState, { message: strings.newsLoading, strings });
     if (state === "error") {
-      return /* @__PURE__ */ jsx28(
-        ModuleState,
-        {
-          tone: "error",
-          message: strings.errorGeneric,
-          onRetry: () => setReloadKey((k) => k + 1),
-          strings
-        }
-      );
+      return /* @__PURE__ */ jsx28(ModuleState, { tone: "error", message: errorMsg, onRetry: () => setReloadKey((k) => k + 1), strings });
     }
     if (items.length === 0) return /* @__PURE__ */ jsx28(ModuleState, { message: strings.newsEmpty, strings });
     return /* @__PURE__ */ jsx28("div", { class: `${p21}-news-list`, children: items.map((item) => /* @__PURE__ */ jsxs22(
@@ -5288,7 +5291,7 @@ function App({ options, hostElement, bus }) {
   const [sessionReady, setSessionReady] = useState11(false);
   const isInlineLike = options.mode === "standalone" || options.mode === "inline";
   const initialPanelRef = useRef8(
-    resolveInitialPanelState(options, currentViewportWidth(), persistence.loadPanelOpen())
+    resolveInitialPanelState(options, currentViewportWidth(), persistence.loadPanelOpen(), persistence.loadPanelSize())
   );
   const [isOpen, setIsOpen] = useState11(initialPanelRef.current.panelOpen);
   const initialPanelApplied = useRef8(false);
@@ -5359,13 +5362,19 @@ function App({ options, hostElement, bus }) {
   }, [feedback, patchAndSync]);
   useEffect17(() => {
     if (initialSizeApplied.current || !options.size.initialSize) return;
-    setPanelSize(pickInitialPanelSize(options.mode, options.size, currentViewportWidth()));
     initialSizeApplied.current = true;
-  }, [options.mode, options.size]);
+    if (persistence.loadPanelSize()) return;
+    setPanelSize(pickInitialPanelSize(options.mode, options.size, currentViewportWidth()));
+  }, [options.mode, options.size, persistence]);
   useEffect17(() => {
     if (!sessionReady || initialPanelApplied.current) return;
     initialPanelApplied.current = true;
-    const state = resolveInitialPanelState(options, currentViewportWidth(), persistence.loadPanelOpen());
+    const state = resolveInitialPanelState(
+      options,
+      currentViewportWidth(),
+      persistence.loadPanelOpen(),
+      persistence.loadPanelSize()
+    );
     setIsOpen(state.panelOpen);
     setPanelSize(state.panelSize);
   }, [sessionReady, options, persistence]);
@@ -5570,7 +5579,7 @@ function App({ options, hostElement, bus }) {
         emitMessage(bus, options, "assistant", assistantText(assistantMsg));
       } catch (error) {
         assistantMsg.status = "error";
-        assistantMsg.errorText = error instanceof StreamError && error.status === 429 ? options.strings.errorRateLimited : options.strings.errorGeneric;
+        assistantMsg.errorText = errorMessageFor(error, options.strings);
         feedback.play("error");
         bus.emit("error", error);
         options.onError?.(error);
@@ -5661,17 +5670,19 @@ function App({ options, hostElement, bus }) {
     if (chatId) homeNav.switchTab(chatId);
   }, [handleClear, homeNav, options]);
   const handleExpand = useCallback8(() => {
-    const next = panelSize !== "expanded";
-    log16.info("expand", { from: panelSize, expanded: next });
-    setPanelSize((s) => s === "expanded" ? "normal" : "expanded");
-    bus.emit("expand", next);
-  }, [bus, panelSize]);
+    const nextSize = panelSize === "expanded" ? "normal" : "expanded";
+    log16.info("expand", { from: panelSize, expanded: nextSize === "expanded" });
+    setPanelSize(nextSize);
+    persistence.savePanelSize(nextSize);
+    bus.emit("expand", nextSize === "expanded");
+  }, [bus, panelSize, persistence]);
   const handleFullscreen = useCallback8(() => {
-    const next = panelSize !== "fullscreen";
-    log16.info("fullscreen", { from: panelSize, fullscreen: next });
-    setPanelSize((s) => s === "fullscreen" ? "normal" : "fullscreen");
-    bus.emit("fullscreen", next);
-  }, [bus, panelSize]);
+    const nextSize = panelSize === "fullscreen" ? "normal" : "fullscreen";
+    log16.info("fullscreen", { from: panelSize, fullscreen: nextSize === "fullscreen" });
+    setPanelSize(nextSize);
+    persistence.savePanelSize(nextSize);
+    bus.emit("fullscreen", nextSize === "fullscreen");
+  }, [bus, panelSize, persistence]);
   const handlePopOut = useCallback8(() => {
     if (!options.popOutUrl) return;
     const url = new URL(options.popOutUrl);
@@ -5961,7 +5972,8 @@ function resolveInitialHostMode(options) {
   const { panelOpen, panelSize } = resolveInitialPanelState(
     options,
     currentViewportWidth(),
-    persistence.loadPanelOpen()
+    persistence.loadPanelOpen(),
+    persistence.loadPanelSize()
   );
   return computeHostMode(options.mode, panelSize, panelOpen);
 }