@helpai/elements 0.30.1 → 0.31.0

package/index.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-rva7dkso.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, H as HandshakeResponse, L as Link, S as ServerConfig, b as SiteConfig, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial } from './deployment-DRGLrW2j.js';
 import 'zod';
 
 /**
@@ -505,6 +505,46 @@ interface FormDef {
      * `/activity` records for such forms).
      */
     reviewable?: boolean;
+    /** BCP-47 locale the top-level strings (title / fields copy) are authored in. */
+    defaultLocale?: string;
+    /**
+     * Per-locale string overrides. The data module trims this to the requested
+     * `?locale=` (≤1 entry); the widget overlays it onto the default copy at
+     * resolve time (`overlayFormDef`). Absent strings fall back to the default.
+     */
+    translations?: FormTranslation[];
+}
+/**
+ * Per-locale overrides of a form's HUMAN-FACING strings only. Structure (field
+ * `name` / `type` / `validation`, option `value`) is shared across locales and
+ * stays canonical, so submissions + validation are locale-independent — a
+ * translation matches the canonical form by the stable `name` (field) / `value`
+ * (option) keys. Absent strings fall back to the top-level (defaultLocale) copy.
+ *
+ * The data module trims `FormDef.translations` to the requested `?locale=` (≤1
+ * entry) on read; the widget overlays that entry onto the default fields. Mirror
+ * of `module-help-ai-data-api` `DynamicFormTranslation`.
+ */
+interface FieldOptionTranslation {
+    /** The canonical option `value` this localizes. */
+    value: string;
+    label?: string;
+    description?: string;
+}
+interface FormFieldTranslation {
+    /** The canonical field `name` this localizes. */
+    name: string;
+    label?: string;
+    placeholder?: string;
+    validationHint?: string;
+    options?: FieldOptionTranslation[];
+}
+interface FormTranslation {
+    locale: string;
+    title?: string;
+    description?: string;
+    submitLabel?: string;
+    fields?: FormFieldTranslation[];
 }
 /** The `forms` block is an ordered list (max 20); order = priority. */
 type FormsOptions = FormDef[];

package/index.mjs

@@ -275,8 +275,8 @@ function resolveStrings(locale, override) {
 function primaryTag(locale) {
   return (locale.split("-")[0] ?? "en").toLowerCase();
 }
-function moduleLabel(strings, label) {
-  return strings[label] ?? label;
+function localizeText(strings, value) {
+  return strings[value] ?? value;
 }
 function isNestedShape(override) {
   if (!override) return false;
@@ -286,6 +286,51 @@ function isNestedShape(override) {
   return false;
 }
 
+// src/i18n/overlay.ts
+function pickTranslation(translations, locale) {
+  if (!translations?.length || !locale) return void 0;
+  return translations.find((t) => t.locale === locale);
+}
+function overlayContent(item, locale) {
+  const { translations, defaultLocale: _defaultLocale, ...base } = item;
+  const tr = pickTranslation(translations, locale);
+  if (!tr) return base;
+  return {
+    ...base,
+    title: tr.title ?? base.title,
+    description: tr.description ?? base.description,
+    content: tr.content ?? base.content
+  };
+}
+function overlayFormDef(def, locale) {
+  const { translations, defaultLocale: _defaultLocale, ...base } = def;
+  const tr = pickTranslation(translations, locale);
+  if (!tr) return base;
+  const fieldTrByName = new Map((tr.fields ?? []).map((f) => [f.name, f]));
+  const fields = base.fields.map((field) => {
+    const ftr = fieldTrByName.get(field.name);
+    if (!ftr) return field;
+    const optionTrByValue = new Map((ftr.options ?? []).map((o) => [o.value, o]));
+    return {
+      ...field,
+      label: ftr.label ?? field.label,
+      placeholder: ftr.placeholder ?? field.placeholder,
+      validationHint: ftr.validationHint ?? field.validationHint,
+      options: field.options?.map((option) => {
+        const otr = optionTrByValue.get(option.value);
+        return otr ? { ...option, label: otr.label ?? option.label, description: otr.description ?? option.description } : option;
+      })
+    };
+  });
+  return {
+    ...base,
+    title: tr.title ?? base.title,
+    description: tr.description ?? base.description,
+    submitLabel: tr.submitLabel ?? base.submitLabel,
+    fields
+  };
+}
+
 // src/core/storage.ts
 var LocalStorageAdapter = class {
   get(key) {
@@ -552,7 +597,7 @@ function resolveOptions(rawOpts) {
       humanInLoop: opts.features?.humanInLoop ?? DEFAULT_FEATURES.humanInLoop,
       tools: opts.features?.tools
     },
-    forms: resolveForms(opts.forms),
+    forms: resolveForms(opts.forms, locale),
     endpoints: {
       upload: opts.endpoints?.upload ?? DEFAULT_ENDPOINTS.upload,
       transcribe: opts.endpoints?.transcribe ?? DEFAULT_ENDPOINTS.transcribe,
@@ -675,13 +720,14 @@ function resolveModules(overrides) {
   const byId = Object.fromEntries(list.map((m) => [m.id, m]));
   return { list, byId };
 }
-function resolveForms(overrides) {
+function resolveForms(overrides, locale) {
   var _a;
   if (!overrides?.length) return DEFAULT_FORMS;
   const list = [];
   const seen = /* @__PURE__ */ new Set();
-  for (const def of overrides) {
-    if (!def?.id || seen.has(def.id)) continue;
+  for (const raw of overrides) {
+    if (!raw?.id || seen.has(raw.id)) continue;
+    const def = overlayFormDef(raw, locale);
     const fields = (def.fields ?? []).filter((f) => Boolean(f && f.name && f.label && f.type));
     const triggers = (Array.isArray(def.on) ? def.on : [def.on]).map(parseTrigger).filter((t) => t !== null);
     if (fields.length === 0 || triggers.length === 0) continue;
@@ -1844,7 +1890,7 @@ var AgentTransport = class {
   }
   /** Fetch content rows by filter. `GET /pai/content` (data-API), TTL-cached. */
   listContent(query = {}) {
-    const key = JSON.stringify(query, Object.keys(query).toSorted());
+    const key = `${this.locale ?? ""}|${JSON.stringify(query, Object.keys(query).toSorted())}`;
     const cached = this.contentCache.get(key);
     if (cached && Date.now() - cached.at < CONTENT_CACHE_TTL_MS) {
       log6.debug("listContent \u2192 cache", query);
@@ -1865,7 +1911,7 @@ var AgentTransport = class {
     }
     log6.debug("listContent \u2192", query);
     const res = await this.getJson(url.toString(), "listContent");
-    const items = res.items ?? [];
+    const items = (res.items ?? []).map((item) => overlayContent(item, this.locale));
     log6.debug("listContent \u2190", { count: items.length, total: res.pagination?.total });
     return { ...res, items };
   }
@@ -3125,7 +3171,7 @@ function mountRawSvg(host, source) {
   } catch {
   }
 }
-function LauncherCallout({ callout, launcherPosition, closeLabel, onDismiss }) {
+function LauncherCallout({ callout, launcherPosition, strings, closeLabel, onDismiss }) {
   const [visible, setVisible] = useState(false);
   useEffect(() => {
     const id = setTimeout(() => setVisible(true), callout.delayMs);
@@ -3147,7 +3193,7 @@ function LauncherCallout({ callout, launcherPosition, closeLabel, onDismiss }) {
       "data-animated": callout.animated ? "true" : void 0,
       "data-testid": TID.callout,
       children: [
-        /* @__PURE__ */ jsx2("span", { children: callout.text }),
+        /* @__PURE__ */ jsx2("span", { children: localizeText(strings, callout.text) }),
         /* @__PURE__ */ jsx2(
           "button",
           {
@@ -5707,9 +5753,16 @@ function createController(depsRef) {
     else if (form.frequency !== "always") depsRef.current.persistence.saveFormDone(form.id);
     depsRef.current.onComplete(form, trigger, values, skipped);
   };
+  const refresh = () => {
+    const active = activeForm.value;
+    if (!active) return;
+    const next = depsRef.current.forms.list.find((f) => f.id === active.form.id);
+    if (next && next !== active.form) activeForm.value = { form: next, trigger: active.trigger };
+  };
   return {
     activeForm,
     fire,
+    refresh,
     complete: (values) => finish(values, false),
     skip: () => finish({}, true)
   };
@@ -6121,7 +6174,7 @@ function HomeRoot(props2) {
   const greeting = resolveGreeting(props2);
   const avatars = config.userAvatars ?? [];
   const status = config.status;
-  const contentTitle = config.contentBlockTitle ? moduleLabel(strings, config.contentBlockTitle) : strings.homeContentTitle;
+  const contentTitle = config.contentBlockTitle ? localizeText(strings, config.contentBlockTitle) : strings.homeContentTitle;
   return /* @__PURE__ */ jsx29("div", { class: `${p25}-module ${p25}-home`, "data-testid": TID.homeView, children: /* @__PURE__ */ jsxs24("div", { class: `${p25}-home-scroll`, children: [
     /* @__PURE__ */ jsxs24("div", { class: `${p25}-home-hero`, children: [
       /* @__PURE__ */ jsxs24("div", { class: `${p25}-home-hero-top`, children: [
@@ -6276,7 +6329,7 @@ function HomeTabBar({ modules, activeTab, strings, unreadCount, onSelect }) {
             /* @__PURE__ */ jsx31(Icon, {}),
             badge ? /* @__PURE__ */ jsx31("span", { class: `${p27}-tab-badge`, "data-testid": TID.tabBadge, children: badge }) : null
           ] }),
-          /* @__PURE__ */ jsx31("span", { class: `${p27}-tab-label`, children: moduleLabel(strings, m.label) })
+          /* @__PURE__ */ jsx31("span", { class: `${p27}-tab-label`, children: localizeText(strings, m.label) })
         ]
       },
       m.id
@@ -6947,7 +7000,7 @@ function App({ options, hostElement, bus }) {
     void (async () => {
       try {
         const res = await dataBootRef.current;
-        setRemoteForms(resolveForms((res ?? { forms: [] }).forms));
+        setRemoteForms(resolveForms((res ?? { forms: [] }).forms, effectiveLocale));
       } catch (err) {
         log17.debug("bootstrap failed \u2014 treating as no forms", { err });
       } finally {
@@ -6965,6 +7018,23 @@ function App({ options, hostElement, bus }) {
       void runResume(handle);
     }
   }, [activated]);
+  const formsLocaleRef = useRef9(null);
+  useEffect17(() => {
+    if (!activated) return;
+    if (formsLocaleRef.current === null) {
+      formsLocaleRef.current = effectiveLocale;
+      return;
+    }
+    if (formsLocaleRef.current === effectiveLocale) return;
+    formsLocaleRef.current = effectiveLocale;
+    let cancelled = false;
+    void transport.bootstrap().then((res) => {
+      if (!cancelled) setRemoteForms(resolveForms((res ?? { forms: [] }).forms, effectiveLocale));
+    }).catch((err) => log17.debug("forms re-localize failed \u2014 keeping current copy", { err }));
+    return () => {
+      cancelled = true;
+    };
+  }, [activated, effectiveLocale, transport]);
   const lastUserSig = useRef9(userSig);
   useEffect17(() => {
     if (!conversationReady || lastUserSig.current === userSig) return;
@@ -7121,6 +7191,9 @@ function App({ options, hostElement, bus }) {
     }
   });
   const activeForm = useComputed7(() => forms.activeForm.value);
+  useEffect17(() => {
+    forms.refresh();
+  }, [effectiveForms, forms]);
   const pageArea = options.pageContext?.area ? String(options.pageContext.area) : void 0;
   const msgCount = useComputed7(() => messagesSig.value.length);
   useEffect17(() => {
@@ -7507,6 +7580,7 @@ function App({ options, hostElement, bus }) {
       {
         callout: calloutToRender,
         launcherPosition: effectiveOptions.position,
+        strings: effectiveOptions.strings,
         closeLabel: effectiveOptions.strings.close,
         onDismiss: dismissCallout
       }

package/package.json

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

package/schema.d.ts

@@ -1,4 +1,4 @@
-export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-rva7dkso.js';
+export { A as Asset, B as BlocksConfig, C as ConnectionConfig, a as ConnectionConfigPartial, E as Endpoints, H as HandshakeResponse, L as Link, P as PAGE_AREA_SUGGESTIONS, f as PageContext, S as ServerConfig, b as SiteConfig, U as UserContext, W as WidgetConfig, c as WidgetConfigPartial, d as WidgetSettings, e as WidgetSettingsPartial, g as assetSchema, h as blocksConfigSchema, i as connectionConfigPartialSchema, j as connectionConfigSchema, k as cssColorSchema, l as cssLengthSchema, m as endpointsSchema, n as handshakeResponseSchema, o as linkSchema, p as localeSchema, q as pageContextSchema, s as serverConfigSchema, r as siteConfigSchema, u as userContextSchema, t as uuid7Schema, w as widgetConfigPartialSchema, v as widgetConfigSchema, x as widgetSettingsPartialSchema, y as widgetSettingsSchema } from './deployment-DRGLrW2j.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";
-            normal: "normal";
             expanded: "expanded";
             auto: "auto";
+            normal: "normal";
         }>>;
         autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
     }, z.core.$loose>>;
@@ -240,9 +240,9 @@ type LauncherOptions = z.infer<typeof launcherOptionsSchema>;
 
 declare const initialSizeSchema: z.ZodEnum<{
     fullscreen: "fullscreen";
-    normal: "normal";
     expanded: "expanded";
     auto: "auto";
+    normal: "normal";
 }>;
 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";
-        normal: "normal";
         expanded: "expanded";
         auto: "auto";
+        normal: "normal";
     }>>;
     autoSizeBreakpoint: z.ZodDefault<z.ZodNumber>;
 }, z.core.$loose>;
@@ -323,43 +323,43 @@ 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";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     sound: "sound";
 }>;
 type ActionName = z.infer<typeof actionNameSchema>;
 declare const headerActionsSchema: z.ZodArray<z.ZodEnum<{
+    close: "close";
     expand: "expand";
     fullscreen: "fullscreen";
     popOut: "popOut";
-    close: "close";
-    language: "language";
+    clear: "clear";
     theme: "theme";
+    language: "language";
     textSize: "textSize";
     history: "history";
-    clear: "clear";
     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";
         popOut: "popOut";
-        close: "close";
-        language: "language";
+        clear: "clear";
         theme: "theme";
+        language: "language";
         textSize: "textSize";
         history: "history";
-        clear: "clear";
         sound: "sound";
     }>>>;
 }, z.core.$loose>;
@@ -375,33 +375,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>;
@@ -410,21 +410,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>;
@@ -624,6 +624,48 @@ declare const formConditionSchema: z.ZodObject<{
     maxMessages: z.ZodOptional<z.ZodNumber>;
 }, z.core.$loose>;
 type FormCondition = z.infer<typeof formConditionSchema>;
+/**
+ * Per-locale overrides of a form's HUMAN-FACING strings only. Structure (field
+ * `name` / `type` / `validation`, option `value`) is shared across locales and
+ * stays canonical — a translation matches the canonical form by the stable
+ * `name` (field) / `value` (option) keys; absent strings fall back to the
+ * top-level (defaultLocale) copy. The data module trims `translations` to the
+ * requested `?locale=` (≤1 entry); the widget overlays it (`overlayFormDef`).
+ */
+declare const fieldOptionTranslationSchema: z.ZodObject<{
+    value: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+declare const formFieldTranslationSchema: z.ZodObject<{
+    name: z.ZodString;
+    label: z.ZodOptional<z.ZodString>;
+    placeholder: z.ZodOptional<z.ZodString>;
+    validationHint: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        value: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+declare const formTranslationSchema: z.ZodObject<{
+    locale: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    submitLabel: z.ZodOptional<z.ZodString>;
+    fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        label: z.ZodOptional<z.ZodString>;
+        placeholder: z.ZodOptional<z.ZodString>;
+        validationHint: z.ZodOptional<z.ZodString>;
+        options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            value: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
+}, z.core.$loose>;
+type FormTranslation = z.infer<typeof formTranslationSchema>;
 declare const formDefSchema: z.ZodObject<{
     id: z.ZodString;
     on: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
@@ -682,6 +724,24 @@ declare const formDefSchema: z.ZodObject<{
     mirrorToContext: z.ZodDefault<z.ZodBoolean>;
     reopenable: z.ZodDefault<z.ZodBoolean>;
     reviewable: z.ZodDefault<z.ZodBoolean>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    translations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        locale: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            validationHint: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
 }, z.core.$loose>;
 type FormDef = z.infer<typeof formDefSchema>;
 declare const formsSchema: z.ZodArray<z.ZodObject<{
@@ -742,6 +802,24 @@ declare const formsSchema: z.ZodArray<z.ZodObject<{
     mirrorToContext: z.ZodDefault<z.ZodBoolean>;
     reopenable: z.ZodDefault<z.ZodBoolean>;
     reviewable: z.ZodDefault<z.ZodBoolean>;
+    defaultLocale: z.ZodOptional<z.ZodString>;
+    translations: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        locale: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        submitLabel: z.ZodOptional<z.ZodString>;
+        fields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            label: z.ZodOptional<z.ZodString>;
+            placeholder: z.ZodOptional<z.ZodString>;
+            validationHint: z.ZodOptional<z.ZodString>;
+            options: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                value: z.ZodString;
+                label: z.ZodOptional<z.ZodString>;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>>>;
+    }, z.core.$loose>>>;
 }, z.core.$loose>>;
 type Forms = z.infer<typeof formsSchema>;
 
@@ -781,18 +859,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>>;
@@ -818,9 +896,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>>;
@@ -902,4 +980,4 @@ declare const ALL_MODES: readonly Mode[];
  */
 declare function emitJsonSchema(): unknown;
 
-export { ALL_MODES, type ActionName, type AttachmentLimits, type Behavior, type CalloutPosition, type CalloutShape, type ComposerOptions, type FeatureFlags, type FeedbackEvent, type FeedbackOptions, type FieldOption, type FieldType, type FieldValidation, type FooterOptions, type FormCondition, type FormDef, type FormField, type Forms, type HapticsOptions, type HeaderActions, type HeaderOptions, type I18nOptions, type LauncherCallout, type LauncherOptions, type LauncherSize, type LauncherVariant, type Mode, type ModuleLayout, type ModuleOptions, type ModulesOptions, type Position, type PoweredBy, type Presentation, type ResizeOptions, type ResponseMode, type SendButtonOptions, type SizeOptions, type SoundOptions, type StringsOverride, type ThemeOverrides, type ThemePreference, type TrackingSettings, type VoiceMode, actionNameSchema, attachmentLimitsSchema, behaviorSchema, calloutPositionSchema, calloutShapeSchema, composerOptionsSchema, emitJsonSchema, featureFlagsSchema, feedbackEventSchema, feedbackSchema, fieldOptionSchema, fieldTypeSchema, fieldValidationSchema, footerSchema, formConditionSchema, formDefSchema, formFieldSchema, formTriggerSchema, formsSchema, hapticsOptionsSchema, headerActionsSchema, headerSchema, i18nSchema, initialSizeSchema, launcherCalloutSchema, launcherOptionsSchema, launcherSizeSchema, launcherVariantSchema, modeSchema, moduleLayoutSchema, moduleSchema, modulesSchema, positionSchema, poweredBySchema, presentationSchema, resizeOptionsSchema, responseModeSchema, sendButtonIconSchema, sendButtonOptionsSchema, sendButtonShapeSchema, sendButtonVariantSchema, sizeOptionsSchema, soundOptionsSchema, stringsOverrideSchema, themeFieldSchema, themeOverridesSchema, themePreferenceSchema, toolRefSchema, trackingSchema, voiceModeSchema, widgetSettingsSchemaForMode };
+export { ALL_MODES, type ActionName, type AttachmentLimits, type Behavior, type CalloutPosition, type CalloutShape, type ComposerOptions, type FeatureFlags, type FeedbackEvent, type FeedbackOptions, type FieldOption, type FieldType, type FieldValidation, type FooterOptions, type FormCondition, type FormDef, type FormField, type FormTranslation, type Forms, type HapticsOptions, type HeaderActions, type HeaderOptions, type I18nOptions, type LauncherCallout, type LauncherOptions, type LauncherSize, type LauncherVariant, type Mode, type ModuleLayout, type ModuleOptions, type ModulesOptions, type Position, type PoweredBy, type Presentation, type ResizeOptions, type ResponseMode, type SendButtonOptions, type SizeOptions, type SoundOptions, type StringsOverride, type ThemeOverrides, type ThemePreference, type TrackingSettings, type VoiceMode, actionNameSchema, attachmentLimitsSchema, behaviorSchema, calloutPositionSchema, calloutShapeSchema, composerOptionsSchema, emitJsonSchema, featureFlagsSchema, feedbackEventSchema, feedbackSchema, fieldOptionSchema, fieldOptionTranslationSchema, fieldTypeSchema, fieldValidationSchema, footerSchema, formConditionSchema, formDefSchema, formFieldSchema, formFieldTranslationSchema, formTranslationSchema, formTriggerSchema, formsSchema, hapticsOptionsSchema, headerActionsSchema, headerSchema, i18nSchema, initialSizeSchema, launcherCalloutSchema, launcherOptionsSchema, launcherSizeSchema, launcherVariantSchema, modeSchema, moduleLayoutSchema, moduleSchema, modulesSchema, positionSchema, poweredBySchema, presentationSchema, resizeOptionsSchema, responseModeSchema, sendButtonIconSchema, sendButtonOptionsSchema, sendButtonShapeSchema, sendButtonVariantSchema, sizeOptionsSchema, soundOptionsSchema, stringsOverrideSchema, themeFieldSchema, themeOverridesSchema, themePreferenceSchema, toolRefSchema, trackingSchema, voiceModeSchema, widgetSettingsSchemaForMode };