@sonordev/site-kit 7.1.2 → 7.3.0

package/dist/{chunk-V6FDQLR7.js → chunk-EPT6FJUY.js}

@@ -1,10 +1,11 @@
 'use client';
-import { isFieldVisible, validateField, isFieldComplete } from './chunk-AQSNPZY4.js';
-import { normalizeFormConfig } from './chunk-5SQK3D53.js';
+import { readAgentSubmit, formToolAttributes } from './chunk-Q6E4OPGG.js';
+import { isFieldVisible, validateField, isFieldComplete, unseenControlValues } from './chunk-C2FZBUSS.js';
+import { normalizeFormConfig, DEFAULT_FORM_SUCCESS_MESSAGE } from './chunk-5SQK3D53.js';
 import { DEFAULT_HONEYPOT_FIELD } from './chunk-NJCTQH2P.js';
 import { onPageLeave } from './chunk-L2V5PUFN.js';
 import { uuid } from './chunk-GJWI74ZZ.js';
-import { sonorFetch, sonorBeacon } from './chunk-3SDOQUUF.js';
+import { sonorFetch, sonorBeacon } from './chunk-BEBR4OJD.js';
 import { useRef, useCallback, useEffect, useState, useMemo } from 'react';
 
 // src/forms/field-interactions.ts
@@ -567,7 +568,8 @@ async function submitForm({
   config,
   values,
   honeypotValue,
-  formLoadedAt
+  formLoadedAt,
+  agentInvoked
 }) {
   const { apiUrl, apiKey } = getApiConfig();
   if (!apiKey) {
@@ -606,7 +608,8 @@ async function submitForm({
       // Sub-site host — preserved on form_submissions for lead attribution
       // across multi-site projects. Resolved by SiteKitClientProviders.
       site: typeof window !== "undefined" ? window.__SITE_KIT_SITE__ || window.location.host : void 0,
-      _formLoadedAt: formLoadedAt
+      _formLoadedAt: formLoadedAt,
+      ...agentInvoked ? { agentInvoked: true } : {}
     }
   };
   const response = await sonorFetch(
@@ -800,23 +803,24 @@ function useForm(formIdOrSlug, options = {}) {
     setErrors(newErrors);
     return Object.keys(newErrors).length === 0;
   }, [fields, validateField2]);
-  const validateAll = useCallback(() => {
+  const validateAllFor = useCallback((vals) => {
+    const visible = (field) => isFieldVisible(field, vals);
     const newErrors = {};
     for (const field of allFields) {
-      const error = validateField2(field);
+      const error = validateField(field, vals, visible);
       if (error) newErrors[field.slug] = error;
     }
     setErrors(newErrors);
-    return Object.keys(newErrors).length === 0;
-  }, [allFields, validateField2]);
-  const buildVisibleValues = useCallback(() => {
+    return newErrors;
+  }, [allFields]);
+  const buildVisibleValues = useCallback((vals) => {
     const out = {};
     for (const field of allFields) {
-      if (!isFieldVisible2(field)) continue;
-      if (field.slug in values) out[field.slug] = values[field.slug];
+      if (!isFieldVisible(field, vals)) continue;
+      if (field.slug in vals) out[field.slug] = vals[field.slug];
     }
     return out;
-  }, [allFields, values, isFieldVisible2]);
+  }, [allFields]);
   const setFieldValue = useCallback((key, value) => {
     setValuesState((prev) => ({ ...prev, [key]: value }));
     trackFieldChange(key);
@@ -862,19 +866,25 @@ function useForm(formIdOrSlug, options = {}) {
       trackStepChange(targetStep);
     }
   }, [totalSteps, trackStepChange]);
-  const submit = useCallback(async () => {
-    if (!form) return;
-    if (isSubmittingRef.current) return;
-    if (!validateAll()) return;
+  const submit = useCallback(async (options2) => {
+    if (!form) return { status: "failed", message: "The form is still loading." };
+    if (isSubmittingRef.current) return { status: "busy" };
+    const domFills = options2 && typeof options2 === "object" && options2.domFills && typeof options2.domFills === "object" ? options2.domFills : null;
+    const agentInvoked = !!options2 && typeof options2 === "object" && options2.agentInvoked === true;
+    const vals = domFills && Object.keys(domFills).length > 0 ? { ...values, ...domFills } : values;
+    if (vals !== values) setValuesState(vals);
+    const invalid = validateAllFor(vals);
+    if (Object.keys(invalid).length > 0) return { status: "invalid", errors: invalid };
     isSubmittingRef.current = true;
     setIsSubmitting(true);
     setSubmitError(null);
     try {
       const data = await submitForm({
         config: form,
-        values: buildVisibleValues(),
+        values: buildVisibleValues(vals),
         honeypotValue: "",
-        formLoadedAt: formLoadedAt()
+        formLoadedAt: formLoadedAt(),
+        agentInvoked
       });
       trackComplete();
       setIsComplete(true);
@@ -883,15 +893,35 @@ function useForm(formIdOrSlug, options = {}) {
       if (finalRedirect) {
         window.location.href = finalRedirect;
       }
+      const confirmation = typeof form.success_message === "string" && form.success_message.trim() ? form.success_message.trim() : DEFAULT_FORM_SUCCESS_MESSAGE;
+      return { status: "sent", message: confirmation, submissionId: data.submissionId || void 0 };
     } catch (error) {
       console.error("[useForm] Submission error:", error);
-      setSubmitError("Something went wrong sending your submission. Please try again.");
+      const message = "Something went wrong sending your submission. Please try again.";
+      setSubmitError(message);
       onError?.(error);
+      return { status: "failed", message };
     } finally {
       isSubmittingRef.current = false;
       setIsSubmitting(false);
     }
-  }, [form, validateAll, buildVisibleValues, trackComplete, onSuccess, onError, redirectUrl]);
+  }, [form, values, validateAllFor, buildVisibleValues, trackComplete, onSuccess, onError, redirectUrl]);
+  const handleSubmit = useCallback((event) => {
+    event.preventDefault();
+    const agent = readAgentSubmit(event.nativeEvent);
+    if (form?.is_multi_step && step < totalSteps) {
+      const moved = nextStep();
+      agent.respond(
+        Promise.resolve(
+          moved ? { status: "next_step", step: step + 1, totalSteps } : { status: "invalid", errors: {} }
+        )
+      );
+      return;
+    }
+    const domFills = unseenControlValues(event.currentTarget, allFields, "", values);
+    agent.respond(submit({ agentInvoked: agent.invoked, domFills }));
+  }, [form, step, totalSteps, nextStep, allFields, values, submit]);
+  const toolAttributes = useMemo(() => form ? formToolAttributes(form) : null, [form]);
   const reset = useCallback(() => {
     setValuesState(initialValues);
     setErrors({});
@@ -926,6 +956,8 @@ function useForm(formIdOrSlug, options = {}) {
     validateField: validateField2,
     isFieldVisible: isFieldVisible2,
     submit,
+    handleSubmit,
+    toolAttributes,
     isSubmitting,
     isComplete,
     reset,

package/dist/chunk-HODO5BX5.js

@@ -0,0 +1,28 @@
+// src/chat/echo-config.ts
+var SONOR_PUBLIC_ECHO_DEFAULTS = {
+  signalUrl: "https://signal.sonor.io",
+  welcomeMessage: "Hi! I'm Echo, Sonor's AI assistant. I can answer questions about our platform, help you understand pricing, or get you started with a demo. What would you like to know?",
+  suggestedQuestions: [
+    "What does Sonor do?",
+    "How does Signal AI work?",
+    "What are the pricing plans?",
+    "Can I migrate from HubSpot?",
+    "How does the SEO module work?"
+  ],
+  brandColor: "#2563eb",
+  // blue-600 (~5.2:1 on white, AA); overridden by --sk-primary CSS var or API brand_primary
+  assistantName: "Echo"
+};
+function getEchoWidgetProps(config = SONOR_PUBLIC_ECHO_DEFAULTS) {
+  return {
+    signal_enabled: true,
+    signal_url: config.signalUrl || SONOR_PUBLIC_ECHO_DEFAULTS.signalUrl,
+    welcome_message: config.welcomeMessage || SONOR_PUBLIC_ECHO_DEFAULTS.welcomeMessage,
+    suggested_questions: config.suggestedQuestions || SONOR_PUBLIC_ECHO_DEFAULTS.suggestedQuestions,
+    brand_color: config.brandColor || SONOR_PUBLIC_ECHO_DEFAULTS.brandColor,
+    assistant_name: config.assistantName || SONOR_PUBLIC_ECHO_DEFAULTS.assistantName,
+    assistant_avatar: config.assistantAvatar
+  };
+}
+
+export { SONOR_PUBLIC_ECHO_DEFAULTS, getEchoWidgetProps };

package/dist/chunk-HW7B43E5.js

@@ -0,0 +1,14 @@
+// src/mcp/declarative.ts
+function declarativeToolForm(options) {
+  const attributes = {
+    toolname: options.name,
+    tooldescription: options.description
+  };
+  if (options.autoSubmit) attributes.toolautosubmit = "";
+  return attributes;
+}
+function declarativeToolField(description) {
+  return { toolparamdescription: description };
+}
+
+export { declarativeToolField, declarativeToolForm };

package/dist/{chunk-PGMVL4AB.js → chunk-I2YX3HVD.js}

@@ -1,8 +1,8 @@
 import { toHexColor, normalizeDesignTokens, designTokensHash } from './chunk-IHG36STL.js';
 import { contrastRatio, parseColor, relativeLuminance } from './chunk-S22FSH7C.js';
 import { resolveAnalyticsTarget } from './chunk-43OCZ3JA.js';
-import { sonorFetch } from './chunk-3SDOQUUF.js';
-import { SITE_KIT_VERSION } from './chunk-AH5Q262S.js';
+import { sonorFetch } from './chunk-BEBR4OJD.js';
+import { SITE_KIT_VERSION } from './chunk-56KNHB4U.js';
 
 // src/website/design.ts
 var SITE_DESIGN_PATH = "/api/public/site/design";

package/dist/{chunk-JTU2GOM4.js → chunk-L7U23XI2.js}

@@ -1,5 +1,5 @@
 'use client';
-import { detectTimezone, releaseSlotHold, fetchBookingTypeDetails, fetchBookingTypes, fetchAvailability, createSlotHold, createBooking, formatDuration, formatDate, formatTime, prepareMeeting } from './chunk-M3YEPKP7.js';
+import { detectTimezone, releaseSlotHold, fetchBookingTypeDetails, fetchBookingTypes, fetchAvailability, createSlotHold, createBooking, formatDuration, formatDate, formatTime, prepareMeeting } from './chunk-2ECWEUHP.js';
 import { useState, useRef, useMemo, useCallback, useEffect, useId } from 'react';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 
@@ -163,6 +163,12 @@ function toLocalDateStr(d) {
   const day = String(d.getDate()).padStart(2, "0");
   return `${y}-${m}-${day}`;
 }
+function dayLabel(d) {
+  return d.toLocaleDateString("en-US", { weekday: "long", month: "long", day: "numeric", year: "numeric" });
+}
+function slotLabel(slot, timezone) {
+  return `${formatTime(slot.start, timezone)}, ${formatDate(slot.start, timezone)}`;
+}
 function ChevronLeft() {
   return /* @__PURE__ */ jsx("svg", { width: "20", height: "20", viewBox: "0 0 20 20", fill: "none", xmlns: "http://www.w3.org/2000/svg", children: /* @__PURE__ */ jsx("path", { d: "M12.5 15L7.5 10L12.5 5", stroke: "currentColor", strokeWidth: "1.5", strokeLinecap: "round", strokeLinejoin: "round" }) });
 }
@@ -706,8 +712,8 @@ function BookingWidget({
                   if (!disabled && !busyRef.current) setSelectedDate(date);
                 },
                 disabled,
-                "aria-label": date.toLocaleDateString("en-US", { weekday: "long", month: "long", day: "numeric" }),
-                "aria-pressed": sel || void 0,
+                "aria-label": dayLabel(date),
+                "aria-pressed": Boolean(sel),
                 children: date.getDate()
               },
               date.toISOString()
@@ -965,13 +971,15 @@ function TimeButton({
   timezone,
   loading
 }) {
+  const time = formatTime(slot.start, timezone);
+  const label = slotLabel(slot, timezone);
   if (selected && !confirmed) {
     return /* @__PURE__ */ jsxs("div", { className: "bw-time-btn-wrap selected", children: [
-      /* @__PURE__ */ jsx("span", { className: "bw-time-text", children: formatTime(slot.start, timezone) }),
-      /* @__PURE__ */ jsx("button", { className: "bw-time-confirm", onClick: onConfirm, disabled: loading, children: loading ? /* @__PURE__ */ jsx(SpinnerIcon, {}) : "Confirm" })
+      /* @__PURE__ */ jsx("button", { type: "button", className: "bw-time-text", "aria-label": label, "aria-pressed": "true", onClick, disabled: loading, children: time }),
+      /* @__PURE__ */ jsx("button", { type: "button", className: "bw-time-confirm", "aria-label": `Confirm ${label}`, onClick: onConfirm, disabled: loading, children: loading ? /* @__PURE__ */ jsx(SpinnerIcon, {}) : "Confirm" })
     ] });
   }
-  return /* @__PURE__ */ jsx("button", { className: `bw-time-btn${selected ? " selected" : ""}`, onClick, disabled: loading, children: formatTime(slot.start, timezone) });
+  return /* @__PURE__ */ jsx("button", { type: "button", className: `bw-time-btn${selected ? " selected" : ""}`, "aria-label": label, "aria-pressed": selected, onClick, disabled: loading, children: time });
 }
 var WIDGET_CSS = `
 /* \u2500\u2500 Base \u2500\u2500 */
@@ -1159,7 +1167,11 @@ var WIDGET_CSS = `
 .bw-time-btn-wrap .bw-time-text {
   flex: 1; padding: 10px 12px; font-size: 0.875rem; font-weight: 500; color: var(--sk-text-primary); text-align: center;
   background: var(--sk-primary-light);
+  -webkit-appearance: none; appearance: none; border: none; border-radius: 0; margin: 0;
+  font-family: inherit; line-height: inherit; letter-spacing: inherit; cursor: default;
 }
+/* The wrap clips its children, so focus rings go inside, in the text color. */
+.bw-time-btn-wrap button:focus-visible { outline-color: currentColor; outline-offset: -2px; }
 .bw-time-confirm {
   display: inline-flex; align-items: center; justify-content: center; gap: 4px;
   min-height: 44px; padding: 10px 16px; border: none;

package/dist/{chunk-YEMPUQVU.js → chunk-MKMD2HJW.js}

@@ -3,7 +3,7 @@ import { registerAnalyticsDispatcher } from './chunk-LCDVPAMR.js';
 import { getOrCreateVisitorId, getOrCreateSessionId } from './chunk-24QZEO3Q.js';
 import { onPageLeave } from './chunk-L2V5PUFN.js';
 import { resolveAnalyticsTarget } from './chunk-43OCZ3JA.js';
-import { sonorFetch, sonorBeacon } from './chunk-3SDOQUUF.js';
+import { sonorFetch, sonorBeacon } from './chunk-BEBR4OJD.js';
 import { createContext, useRef, useEffect, useState, useMemo, useCallback, useContext } from 'react';
 import { usePathname } from 'next/navigation';
 import { jsxs, jsx } from 'react/jsx-runtime';
@@ -157,7 +157,7 @@ function WebVitals({
   useEffect(() => {
     let cancelled = false;
     let teardown;
-    import('./web-vitals.attribution-GD6LGLVF.js').then(({ onCLS, onLCP, onTTFB, onINP, onFCP }) => {
+    import('./web-vitals.attribution-N2PCCF4Q.js').then(({ onCLS, onLCP, onTTFB, onINP, onFCP }) => {
       if (cancelled) return;
       const { propApiUrl: propApiUrl2, propApiKey: propApiKey2, propSite: propSite2, allowInFrame: allowInFrame2, allowLocalhost: allowLocalhost2, debug: debug2, visitorId: visitorId2, sessionId: sessionId2, sessionTimeout: sessionTimeout2 } = propsRef.current;
       const sent = /* @__PURE__ */ new Map();

package/dist/{chunk-Q4W23JYM.js → chunk-MRQ2U4LZ.js}

@@ -1,5 +1,5 @@
 'use client';
-import { getSiteDesignTokens, tokensForReport, shouldReportDesign, sendSiteDesign } from './chunk-PGMVL4AB.js';
+import { getSiteDesignTokens, tokensForReport, shouldReportDesign, sendSiteDesign } from './chunk-I2YX3HVD.js';
 import { designTokensHash } from './chunk-IHG36STL.js';
 import { useDeferredActivation } from './chunk-YC7ELZS3.js';
 import { resolveAnalyticsTarget } from './chunk-43OCZ3JA.js';

package/dist/chunk-MVR4FY5R.js

@@ -0,0 +1,187 @@
+'use client';
+import { useDeferredActivation } from './chunk-YC7ELZS3.js';
+import { shellValuesToCarry } from './chunk-C2FZBUSS.js';
+import { normalizeFormConfig } from './chunk-5SQK3D53.js';
+import { DEFAULT_HONEYPOT_FIELD } from './chunk-NJCTQH2P.js';
+import React, { useRef, useEffect, useState, useMemo, useCallback } from 'react';
+import { jsx, jsxs } from 'react/jsx-runtime';
+
+var loadInteractiveForm = () => import('./ManagedForm-JRZAJ7SZ.js').then((m) => m.ManagedForm);
+var REPLAY_WAIT_MS = 8e3;
+function FormEnhancer({
+  formId,
+  initialConfig,
+  className,
+  experience,
+  defaultValues,
+  onSuccess,
+  onError,
+  enter = "fade",
+  defer = true,
+  children
+}) {
+  const idle = useDeferredActivation(defer);
+  const [engaged, setEngaged] = useState(false);
+  const hostRef = useRef(null);
+  const [Interactive, setInteractive] = useState(null);
+  const [carried, setCarried] = useState(null);
+  const pendingSubmitRef = useRef(false);
+  const [enhanced, setEnhanced] = useState(false);
+  const fields = useMemo(() => {
+    if (!initialConfig) return void 0;
+    try {
+      return normalizeFormConfig(initialConfig).fields;
+    } catch {
+      return void 0;
+    }
+  }, [initialConfig]);
+  const honeypotName = initialConfig && typeof initialConfig.honeypot_field === "string" && initialConfig.honeypot_field || DEFAULT_HONEYPOT_FIELD;
+  useEffect(() => {
+    if (Interactive) return;
+    const form = hostRef.current?.querySelector("form");
+    if (!form) return;
+    const onSubmit = (event) => {
+      event.preventDefault();
+      pendingSubmitRef.current = true;
+      setEngaged(true);
+    };
+    const onEngage = () => setEngaged(true);
+    form.addEventListener("submit", onSubmit);
+    form.addEventListener("focusin", onEngage);
+    form.addEventListener("input", onEngage);
+    form.addEventListener("change", onEngage);
+    for (const button of Array.from(form.querySelectorAll("button[data-sk-shell-submit]"))) {
+      button.disabled = false;
+    }
+    return () => {
+      form.removeEventListener("submit", onSubmit);
+      form.removeEventListener("focusin", onEngage);
+      form.removeEventListener("input", onEngage);
+      form.removeEventListener("change", onEngage);
+    };
+  }, [Interactive]);
+  useEffect(() => {
+    if (Interactive || !(idle || engaged)) return;
+    let cancelled = false;
+    loadInteractiveForm().then((Component) => {
+      if (cancelled) return;
+      const form = hostRef.current?.querySelector("form") ?? null;
+      const active = typeof document !== "undefined" ? document.activeElement : null;
+      const focusName = form && active && form.contains(active) ? active.name || null : null;
+      setCarried({ values: shellValuesToCarry(form, fields, honeypotName), focusName });
+      setInteractive(() => Component);
+    }).catch((err) => {
+      console.error("[Forms] Enhancement failed to load; keeping the form as rendered:", err);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [Interactive, idle, engaged, fields, honeypotName]);
+  const onEnhancedMount = useCallback(() => {
+    setEnhanced(true);
+    const host = hostRef.current;
+    if (!host) return;
+    const focusName = carried?.focusName;
+    if (focusName) {
+      const target = Array.from(host.querySelectorAll("input, select, textarea")).find(
+        (el) => el.name === focusName
+      );
+      target?.focus({ preventScroll: true });
+    }
+    if (!pendingSubmitRef.current) return;
+    pendingSubmitRef.current = false;
+    const started = Date.now();
+    const tryReplay = () => {
+      const form = hostRef.current?.querySelector("form");
+      if (form) {
+        form.requestSubmit();
+        return;
+      }
+      if (Date.now() - started < REPLAY_WAIT_MS) requestAnimationFrame(tryReplay);
+    };
+    requestAnimationFrame(tryReplay);
+  }, [carried]);
+  const seededValues = useMemo(
+    () => carried && Object.keys(carried.values).length > 0 ? { ...defaultValues || {}, ...carried.values } : defaultValues,
+    [carried, defaultValues]
+  );
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      ref: hostRef,
+      "data-sk-form-mount": enhanced ? "enhanced" : "shell",
+      "data-sk-part": "form-mount",
+      "data-sk-carried": carried && Object.keys(carried.values).length > 0 ? "true" : void 0,
+      style: enter === "fade" ? FADE_HOST : void 0,
+      children: [
+        enter === "fade" && /* @__PURE__ */ jsx(EnterStyles, {}),
+        Interactive ? /* @__PURE__ */ jsx(Enhanced, { onMount: onEnhancedMount, fallback: children, children: /* @__PURE__ */ jsx(
+          Interactive,
+          {
+            formId,
+            initialConfig,
+            className,
+            experience,
+            defaultValues: seededValues,
+            onSuccess,
+            onError
+          }
+        ) }) : children
+      ]
+    }
+  );
+}
+var Enhanced = class extends React.Component {
+  constructor() {
+    super(...arguments);
+    this.state = { failed: false };
+  }
+  static getDerivedStateFromError() {
+    return { failed: true };
+  }
+  componentDidCatch(err) {
+    console.error("[Forms] Enhancement failed; keeping the native form:", err);
+  }
+  componentDidMount() {
+    if (!this.state.failed) this.props.onMount();
+  }
+  render() {
+    if (this.state.failed) return this.props.fallback;
+    return /* @__PURE__ */ jsx(FrameTag, { children: this.props.children });
+  }
+};
+function FrameTag({ children }) {
+  const ref = useRef(null);
+  useEffect(() => {
+    const el = ref.current;
+    if (!el) return;
+    el.setAttribute("data-sk-enter", "");
+    const id = requestAnimationFrame(() => el.removeAttribute("data-sk-enter"));
+    return () => cancelAnimationFrame(id);
+  }, []);
+  return /* @__PURE__ */ jsx("div", { ref, style: { display: "contents" }, children });
+}
+var FADE_HOST = {
+  transition: "opacity var(--sk-form-enter-duration, 320ms) var(--sk-form-enter-easing, cubic-bezier(.22,1,.36,1))"
+};
+function EnterStyles() {
+  return /* @__PURE__ */ jsx(
+    "style",
+    {
+      dangerouslySetInnerHTML: {
+        __html: `
+[data-sk-part="form-mount"][data-sk-form-mount="shell"]{opacity:.55}
+[data-sk-part="form-mount"][data-sk-form-mount="enhanced"]{opacity:1}
+[data-sk-part="form-mount"] [data-sk-enter]{opacity:0;transform:translateY(var(--sk-form-enter-distance,6px))}
+[data-sk-part="form-mount"] [data-sk-enter] *{transition:none!important}
+@media (prefers-reduced-motion: reduce){
+[data-sk-part="form-mount"]{transition:none!important}
+[data-sk-part="form-mount"][data-sk-form-mount="shell"]{opacity:1}
+[data-sk-part="form-mount"] [data-sk-enter]{opacity:1;transform:none}
+}`
+      }
+    }
+  );
+}
+
+export { FormEnhancer };

package/dist/{chunk-VGH4MDTU.js → chunk-NI2XNEMR.js}

@@ -1,5 +1,5 @@
 import { secretsMatch, readCappedBody } from './chunk-XTRZGXB2.js';
-import { SITE_KIT_VERSION } from './chunk-AH5Q262S.js';
+import { SITE_KIT_VERSION } from './chunk-56KNHB4U.js';
 
 // src/llms/revalidate.ts
 function createLlmsRevalidateHandler(secret, options) {

package/dist/{chunk-4Y5FWDPM.js → chunk-NZ4RXN3G.js}

@@ -16,14 +16,64 @@ var MANAGED_LLM_SCHEMA_KNOWN_KEYS = /* @__PURE__ */ new Set([
   "speakable",
   "additionalType"
 ]);
+var SENTENCE_SHARE = 0.4;
+var ELLIPSIS = "\u2026";
+var CLOSERS = /* @__PURE__ */ new Set(['"', "'", ")", "]", "\u201D", "\u2019", "\xBB"]);
+var ABBREVIATIONS = /* @__PURE__ */ new Set([
+  "mr",
+  "mrs",
+  "ms",
+  "dr",
+  "prof",
+  "st",
+  "mt",
+  "ft",
+  "jr",
+  "sr",
+  "inc",
+  "ltd",
+  "co",
+  "corp",
+  "vs",
+  "no"
+]);
+var TRAILING_SEPARATORS = /[\s.,;:\-\u2013\u2014/&([{]+$/;
+function clipAtWordBoundary(text, max) {
+  const flat = text.replace(/\s+/g, " ").trim();
+  if (flat.length <= max) return flat;
+  if (max < 2) return flat.slice(0, Math.max(0, max));
+  const floor = Math.floor(max * (1 - SENTENCE_SHARE));
+  for (let end = max; end > floor; end--) {
+    if (endsSentence(flat, end)) return flat.slice(0, end);
+  }
+  const room = max - 1;
+  const space = flat.lastIndexOf(" ", room);
+  if (space <= 0) return `${flat.slice(0, room)}${ELLIPSIS}`;
+  if (endsSentence(flat, space)) return flat.slice(0, space);
+  const head = flat.slice(0, space).replace(TRAILING_SEPARATORS, "");
+  return `${head || flat.slice(0, room)}${ELLIPSIS}`;
+}
+function endsSentence(flat, end) {
+  if (flat[end] !== " ") return false;
+  let i = end - 1;
+  while (i > 0 && CLOSERS.has(flat[i])) i--;
+  const terminator = flat[i];
+  if (terminator === "!" || terminator === "?") return true;
+  return terminator === "." && !isAbbreviation(flat, i);
+}
+function isAbbreviation(flat, dot) {
+  let start = dot;
+  while (start > 0 && flat[start - 1] !== " ") start--;
+  const token = flat.slice(start, dot).replace(/^[("'[\u201c\u2018]+/, "").toLowerCase();
+  if (token.includes(".") || /^[a-z]$/.test(token)) return true;
+  return ABBREVIATIONS.has(token);
+}
 function sanitizeLlmsPublicSummary(raw) {
   if (raw === null || raw === void 0) return null;
   if (typeof raw !== "string") return null;
   let s = raw.trim().replace(/\s+/g, " ");
   s = s.replace(/[\[\]\r\n]/g, " ").replace(/\s+/g, " ").trim();
-  if (s.length > LLMS_PUBLIC_SUMMARY_MAX_LENGTH) {
-    s = `${s.slice(0, LLMS_PUBLIC_SUMMARY_MAX_LENGTH - 1).trimEnd()}\u2026`;
-  }
+  s = clipAtWordBoundary(s, LLMS_PUBLIC_SUMMARY_MAX_LENGTH);
   if (/\b[\w.%+-]+@[\w.-]+\.[A-Za-z]{2,}\b/.test(s)) return null;
   if (/\b\+?\d[\d\s().-]{8,}\b/.test(s)) return null;
   if (s.length < 8) return null;
@@ -34,9 +84,7 @@ function sanitizeLlmsDisclaimerLine(raw) {
   if (typeof raw !== "string") return null;
   let s = raw.trim().replace(/\s+/g, " ");
   s = s.replace(/[\[\]\r\n]/g, " ").replace(/\s+/g, " ").trim();
-  if (s.length > LLMS_DISCLAIMER_MAX_LENGTH) {
-    s = `${s.slice(0, LLMS_DISCLAIMER_MAX_LENGTH - 1).trimEnd()}\u2026`;
-  }
+  s = clipAtWordBoundary(s, LLMS_DISCLAIMER_MAX_LENGTH);
   if (/\b[\w.%+-]+@[\w.-]+\.[A-Za-z]{2,}\b/.test(s)) return null;
   if (/\b\+?\d[\d\s().-]{8,}\b/.test(s)) return null;
   if (s.length < 3) return null;
@@ -94,4 +142,4 @@ function pickManagedLlmSchemaForJsonLd(schema) {
   return Object.keys(out).length ? out : null;
 }
 
-export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag };
+export { LLMS_DISCLAIMER_MAX_LENGTH, LLMS_PUBLIC_SUMMARY_MAX_LENGTH, LLM_GEO_CONTRACT_VERSION, MANAGED_LLM_SCHEMA_KNOWN_KEYS, clipAtWordBoundary, isEmittableReviewNode, pickManagedLlmSchemaForJsonLd, sanitizeLlmsDisclaimerLine, sanitizeLlmsPublicSummary, sanitizePrimaryLanguageTag };

package/dist/{chunk-RHNWA34F.js → chunk-O5RGXTWU.js}

@@ -1,9 +1,10 @@
 'use client';
+import { VISUAL_VIEWPORT_GAP_PROPERTY } from './chunk-6T6CQVNL.js';
 import { GlassStyles } from './chunk-JE4A5S4F.js';
-import { chatLauncherStyles } from './chunk-NDF4A5JM.js';
-import { useForm } from './chunk-V6FDQLR7.js';
+import { DEFAULT_WIDGET_Z_INDEX } from './chunk-27FISYK4.js';
+import { useForm } from './chunk-EPT6FJUY.js';
 import { parseColor, relativeLuminance, DARK_LUMINANCE, contrastRatio } from './chunk-S22FSH7C.js';
-import { sonorFetch } from './chunk-3SDOQUUF.js';
+import { sonorFetch } from './chunk-BEBR4OJD.js';
 import { useState, useEffect, useRef, useLayoutEffect, useCallback, Fragment as Fragment$1 } from 'react';
 import { lexer } from 'marked';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
@@ -144,7 +145,7 @@ function Markdown({ children, components }) {
   return /* @__PURE__ */ jsx(Fragment, { children: blocks(lexer(children, { gfm: true }), components) });
 }
 
-// src/engage/brand-color.ts
+// src/chat/brand-color.ts
 var TEXT_CONTRAST = 4.5;
 var RESTING_TINT = 0.082;
 var UNREADABLE_BRAND_SHARE = 40;
@@ -454,7 +455,40 @@ function EchoUiActions({ actions, primaryColor, primaryRgb, brandText, onSuggest
   ] });
 }
 
-// src/engage/chat-messages.ts
+// src/chat/launcher-placement.ts
+var DEFAULT_LAUNCHER_OFFSET_BOTTOM = "20px";
+var LAUNCHER_OFFSET_PROPERTY = "--sk-echo-offset-bottom";
+var SIDE_GUTTER = "20px";
+var POPUP_ABOVE_LAUNCHER = "70px";
+var POPUP_VERTICAL_RESERVE = "100px";
+function toCssLength(value) {
+  if (typeof value === "number") return Number.isFinite(value) ? `${value}px` : void 0;
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : void 0;
+}
+function chatLauncherStyles({ position, offsetBottom, zIndex } = {}) {
+  const side = position === "bottom-left" ? { left: SIDE_GUTTER } : { right: SIDE_GUTTER };
+  const offset = toCssLength(offsetBottom) ?? DEFAULT_LAUNCHER_OFFSET_BOTTOM;
+  const layer = typeof zIndex === "number" && Number.isFinite(zIndex) ? zIndex : DEFAULT_WIDGET_Z_INDEX;
+  const clearance = `var(${LAUNCHER_OFFSET_PROPERTY}, ${offset}) + env(safe-area-inset-bottom, 0px) + var(${VISUAL_VIEWPORT_GAP_PROPERTY}, 0px)`;
+  return {
+    launcher: {
+      ...side,
+      bottom: `calc(${clearance})`
+    },
+    popup: {
+      ...side,
+      bottom: `calc(${clearance} + ${POPUP_ABOVE_LAUNCHER})`,
+      maxHeight: `calc(100dvh - (${clearance}) - ${POPUP_VERTICAL_RESERVE})`
+    },
+    // One beneath the launcher. At 0 or below, the same layer instead: -1
+    // would paint the popup behind the page's own content, and at a shared
+    // layer the launcher, which renders after the popup, still paints on top.
+    zIndex: { launcher: layer, popup: layer > 0 ? layer - 1 : layer }
+  };
+}
+
+// src/chat/chat-messages.ts
 function userRequestedHandoff(text) {
   const lower = text.toLowerCase().trim();
   const patterns = [
@@ -839,7 +873,7 @@ function EchoChat({ projectId, widgetConfig, config, apiUrl: propApiUrl, signalU
         socketRef.current.disconnect();
         socketRef.current = null;
       }
-      const { createSocket } = await import('./socket-loader-R24ZSRSQ.js');
+      const { createSocket } = await import('./socket-loader-CGIPEG74.js');
       const namespaceUrl = `${baseUrl.replace(/\/$/, "")}/engage/chat`;
       const socket = await createSocket(namespaceUrl, {
         query: { projectId, visitorId, sessionId: currentSessionId },
@@ -1800,4 +1834,4 @@ function EchoChat({ projectId, widgetConfig, config, apiUrl: propApiUrl, signalU
   ] });
 }
 
-export { ChatWidget, EchoChat, isChatEnabled };
+export { ChatWidget, DEFAULT_LAUNCHER_OFFSET_BOTTOM, EchoChat, chatLauncherStyles, isChatEnabled };