@helpai/elements 0.23.0 → 0.24.0

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 StartConversationResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-D7_pjSGq.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 StartConversationResponse, W as WidgetConfig, d as WidgetConfigPartial, e as WidgetSettings, f as WidgetSettingsPartial } from './deployment-BP2axIFu.js';
 import 'zod';
 
 /**
@@ -579,6 +579,20 @@ interface FormDef {
      * submit endpoint, never onto the always-on context envelope.
      */
     mirrorToContext?: boolean;
+    /**
+     * Skipped marker offers a "Fill out" button that reopens the form (skip is
+     * a deferral, not a refusal). Default `true`. Set `false` when a skip must
+     * be final — e.g. a consent ask that should not be re-surfaced.
+     */
+    reopenable?: boolean;
+    /**
+     * Submitted marker expands in place to a read-only list of the visitor's
+     * answers. Default `true`. Set `false` to keep the marker plain — e.g.
+     * sensitive answers that shouldn't linger on screen (pairs with
+     * `mirrorToContext: false`; the backend should also omit `values` from the
+     * `formSubmissions` echo for such forms).
+     */
+    reviewable?: boolean;
 }
 /** The `forms` block is an ordered list (max 20); order = priority. */
 type FormsOptions = FormDef[];
@@ -595,6 +609,10 @@ interface ResolvedForm {
     frequency: FormFrequency;
     /** Mirror answers into `userContext` (false → PII, endpoint only). */
     mirrorToContext: boolean;
+    /** Skipped marker offers "Fill out" (false → a skip is final). */
+    reopenable: boolean;
+    /** Submitted marker expands to a read-only answers list. */
+    reviewable: boolean;
 }
 /** Fully-resolved forms block: ordered list + an event→forms index. */
 interface ResolvedForms {

package/index.mjs

@@ -680,7 +680,9 @@ function resolveForms(overrides) {
       submitLabel: def.submitLabel,
       skippable: def.skippable ?? false,
       frequency: def.frequency ?? "once",
-      mirrorToContext: def.mirrorToContext ?? true
+      mirrorToContext: def.mirrorToContext ?? true,
+      reopenable: def.reopenable ?? true,
+      reviewable: def.reviewable ?? true
     });
   }
   const byTrigger = {};
@@ -4302,7 +4304,8 @@ function FormDoneMarker({
     "\xB7 ",
     marker.title
   ] }) : null;
-  const values = !skipped && marker.values && Object.keys(marker.values).length > 0 ? marker.values : null;
+  const reviewable = marker.form?.reviewable ?? false;
+  const values = !skipped && reviewable && marker.values && Object.keys(marker.values).length > 0 ? marker.values : null;
   if (values) {
     const labelFor = (name) => marker.form?.fields.find((f) => f.name === name)?.label ?? name;
     return /* @__PURE__ */ jsxs9("details", { class: `${p11}-form-done`, "data-outcome": marker.outcome, "data-testid": TID.formDone, children: [
@@ -4322,7 +4325,7 @@ function FormDoneMarker({
     skipped ? /* @__PURE__ */ jsx11(SkipIcon, {}) : /* @__PURE__ */ jsx11(CheckIcon, {}),
     /* @__PURE__ */ jsx11("span", { children: skipped ? strings.formSkipped : strings.formSubmitted }),
     title,
-    skipped && marker.form && onFill ? /* @__PURE__ */ jsx11("button", { type: "button", class: `${p11}-form-done-fill`, "data-testid": TID.formFill, onClick: onFill, children: strings.formFillOut }) : null
+    skipped && marker.form?.reopenable && onFill ? /* @__PURE__ */ jsx11("button", { type: "button", class: `${p11}-form-done-fill`, "data-testid": TID.formFill, onClick: onFill, children: strings.formFillOut }) : null
   ] });
 }
 

package/package.json

@@ -80,5 +80,5 @@
   ],
   "type": "module",
   "types": "./index.d.ts",
-  "version": "0.23.0"
+  "version": "0.24.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, L as Link, P as PAGE_AREA_SUGGESTIONS, g as PageContext, S as ServerConfig, b as SiteConfig, c as StartConversationResponse, 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 startConversationResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-D7_pjSGq.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 StartConversationResponse, 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 startConversationResponseSchema, u as userContextSchema, v as uuid7Schema, w as widgetConfigPartialSchema, x as widgetConfigSchema, y as widgetSettingsPartialSchema, z as widgetSettingsSchema } from './deployment-BP2axIFu.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>>;
@@ -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";
-    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>;
@@ -544,16 +544,16 @@ type FooterOptions = z.infer<typeof footerSchema>;
 
 declare const fieldTypeSchema: z.ZodEnum<{
     number: "number";
+    select: "select";
+    textarea: "textarea";
+    time: "time";
     text: "text";
+    checkbox: "checkbox";
+    radio: "radio";
     url: "url";
     email: "email";
     tel: "tel";
     date: "date";
-    time: "time";
-    textarea: "textarea";
-    select: "select";
-    radio: "radio";
-    checkbox: "checkbox";
     multiselect: "multiselect";
 }>;
 type FieldType = z.infer<typeof fieldTypeSchema>;
@@ -578,16 +578,16 @@ declare const formFieldSchema: z.ZodObject<{
     label: z.ZodString;
     type: z.ZodEnum<{
         number: "number";
+        select: "select";
+        textarea: "textarea";
+        time: "time";
         text: "text";
+        checkbox: "checkbox";
+        radio: "radio";
         url: "url";
         email: "email";
         tel: "tel";
         date: "date";
-        time: "time";
-        textarea: "textarea";
-        select: "select";
-        radio: "radio";
-        checkbox: "checkbox";
         multiselect: "multiselect";
     }>;
     placeholder: z.ZodOptional<z.ZodString>;
@@ -638,16 +638,16 @@ declare const formDefSchema: z.ZodObject<{
         label: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
+            select: "select";
+            textarea: "textarea";
+            time: "time";
             text: "text";
+            checkbox: "checkbox";
+            radio: "radio";
             url: "url";
             email: "email";
             tel: "tel";
             date: "date";
-            time: "time";
-            textarea: "textarea";
-            select: "select";
-            radio: "radio";
-            checkbox: "checkbox";
             multiselect: "multiselect";
         }>;
         placeholder: z.ZodOptional<z.ZodString>;
@@ -680,6 +680,8 @@ declare const formDefSchema: z.ZodObject<{
         always: "always";
     }>>;
     mirrorToContext: z.ZodDefault<z.ZodBoolean>;
+    reopenable: z.ZodDefault<z.ZodBoolean>;
+    reviewable: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$loose>;
 type FormDef = z.infer<typeof formDefSchema>;
 declare const formsSchema: z.ZodArray<z.ZodObject<{
@@ -696,16 +698,16 @@ declare const formsSchema: z.ZodArray<z.ZodObject<{
         label: z.ZodString;
         type: z.ZodEnum<{
             number: "number";
+            select: "select";
+            textarea: "textarea";
+            time: "time";
             text: "text";
+            checkbox: "checkbox";
+            radio: "radio";
             url: "url";
             email: "email";
             tel: "tel";
             date: "date";
-            time: "time";
-            textarea: "textarea";
-            select: "select";
-            radio: "radio";
-            checkbox: "checkbox";
             multiselect: "multiselect";
         }>;
         placeholder: z.ZodOptional<z.ZodString>;
@@ -738,6 +740,8 @@ declare const formsSchema: z.ZodArray<z.ZodObject<{
         always: "always";
     }>>;
     mirrorToContext: z.ZodDefault<z.ZodBoolean>;
+    reopenable: z.ZodDefault<z.ZodBoolean>;
+    reviewable: z.ZodDefault<z.ZodBoolean>;
 }, z.core.$loose>>;
 type Forms = z.infer<typeof formsSchema>;
 
@@ -777,18 +781,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>>;
@@ -814,9 +818,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/schema.json

@@ -1568,6 +1568,16 @@
                 "default": true,
                 "description": "Mirror the answers into `userContext` so they ride every request. Set `false` for PII (DOB, policy #, symptoms) — those then go only to the submit endpoint.",
                 "type": "boolean"
+              },
+              "reopenable": {
+                "default": true,
+                "description": "Skipped marker offers a \"Fill out\" button that reopens the form. Set `false` when a skip must be final (e.g. a consent ask that should not be re-surfaced).",
+                "type": "boolean"
+              },
+              "reviewable": {
+                "default": true,
+                "description": "Submitted marker expands in place to a read-only list of the visitor's answers. Set `false` for sensitive answers that shouldn't linger on screen.",
+                "type": "boolean"
               }
             },
             "required": [
@@ -1576,7 +1586,9 @@
               "fields",
               "skippable",
               "frequency",
-              "mirrorToContext"
+              "mirrorToContext",
+              "reopenable",
+              "reviewable"
             ],
             "additionalProperties": {}
           },
@@ -3323,6 +3335,16 @@
                     "default": true,
                     "description": "Mirror the answers into `userContext` so they ride every request. Set `false` for PII (DOB, policy #, symptoms) — those then go only to the submit endpoint.",
                     "type": "boolean"
+                  },
+                  "reopenable": {
+                    "default": true,
+                    "description": "Skipped marker offers a \"Fill out\" button that reopens the form. Set `false` when a skip must be final (e.g. a consent ask that should not be re-surfaced).",
+                    "type": "boolean"
+                  },
+                  "reviewable": {
+                    "default": true,
+                    "description": "Submitted marker expands in place to a read-only list of the visitor's answers. Set `false` for sensitive answers that shouldn't linger on screen.",
+                    "type": "boolean"
                   }
                 },
                 "required": [
@@ -3331,7 +3353,9 @@
                   "fields",
                   "skippable",
                   "frequency",
-                  "mirrorToContext"
+                  "mirrorToContext",
+                  "reopenable",
+                  "reviewable"
                 ],
                 "additionalProperties": {}
               },

package/schema.mjs

@@ -429,6 +429,12 @@ var formDefSchema = z12.object({
   frequency: z12.enum(["once", "conversation", "always"]).default("once").describe("`once` (per device, persisted), `conversation` (re-eligible each new conversation), or `always`."),
   mirrorToContext: z12.boolean().default(true).describe(
     "Mirror the answers into `userContext` so they ride every request. Set `false` for PII (DOB, policy #, symptoms) \u2014 those then go only to the submit endpoint."
+  ),
+  reopenable: z12.boolean().default(true).describe(
+    'Skipped marker offers a "Fill out" button that reopens the form. Set `false` when a skip must be final (e.g. a consent ask that should not be re-surfaced).'
+  ),
+  reviewable: z12.boolean().default(true).describe(
+    "Submitted marker expands in place to a read-only list of the visitor's answers. Set `false` for sensitive answers that shouldn't linger on screen."
   )
 }).loose();
 var formsSchema = z12.array(formDefSchema).max(20).describe(

package/web-component.mjs

@@ -665,7 +665,9 @@ function resolveForms(overrides) {
       submitLabel: def.submitLabel,
       skippable: def.skippable ?? false,
       frequency: def.frequency ?? "once",
-      mirrorToContext: def.mirrorToContext ?? true
+      mirrorToContext: def.mirrorToContext ?? true,
+      reopenable: def.reopenable ?? true,
+      reviewable: def.reviewable ?? true
     });
   }
   const byTrigger = {};
@@ -4357,7 +4359,8 @@ function FormDoneMarker({
     "\xB7 ",
     marker.title
   ] }) : null;
-  const values = !skipped && marker.values && Object.keys(marker.values).length > 0 ? marker.values : null;
+  const reviewable = marker.form?.reviewable ?? false;
+  const values = !skipped && reviewable && marker.values && Object.keys(marker.values).length > 0 ? marker.values : null;
   if (values) {
     const labelFor = (name) => marker.form?.fields.find((f) => f.name === name)?.label ?? name;
     return /* @__PURE__ */ jsxs9("details", { class: `${p11}-form-done`, "data-outcome": marker.outcome, "data-testid": TID.formDone, children: [
@@ -4377,7 +4380,7 @@ function FormDoneMarker({
     skipped ? /* @__PURE__ */ jsx11(SkipIcon, {}) : /* @__PURE__ */ jsx11(CheckIcon, {}),
     /* @__PURE__ */ jsx11("span", { children: skipped ? strings.formSkipped : strings.formSubmitted }),
     title,
-    skipped && marker.form && onFill ? /* @__PURE__ */ jsx11("button", { type: "button", class: `${p11}-form-done-fill`, "data-testid": TID.formFill, onClick: onFill, children: strings.formFillOut }) : null
+    skipped && marker.form?.reopenable && onFill ? /* @__PURE__ */ jsx11("button", { type: "button", class: `${p11}-form-done-fill`, "data-testid": TID.formFill, onClick: onFill, children: strings.formFillOut }) : null
   ] });
 }