@sonordev/site-kit 4.0.1 → 4.1.0

package/dist/fleet/index.mjs

@@ -1,10 +1,10 @@
 'use client';
-export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-XCCW4Y3B.mjs';
-import '../chunk-ZVBLXXNJ.mjs';
+export { FLEET_HEARTBEAT_PATH, FleetHeartbeat, detectNextVersion, sendFleetHeartbeat } from '../chunk-VPBLW4ZN.mjs';
 export { FLEET_CONTRACT_VERSION, FLEET_MODULES, FLEET_MODULES_MAX, FLEET_SITE_MAX_LENGTH, FLEET_VERSION_MAX_LENGTH, FLEET_VERSION_PATTERN, buildFleetHeartbeatPayload, isFleetModule, normalizeFleetModules, normalizeFleetSite, sanitizeFleetVersion } from '../chunk-ZPLN537Q.mjs';
-import '../chunk-5GPFPMDQ.mjs';
-import '../chunk-JGTIVQIN.mjs';
-import '../chunk-6GFEJH4F.mjs';
+import '../chunk-ZVBLXXNJ.mjs';
+import '../chunk-UDHQNYBD.mjs';
+import '../chunk-7CYSA5EN.mjs';
+import '../chunk-PKCEJWLD.mjs';
 import '../chunk-BEXTDHO4.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/forms/FileField.d.ts

@@ -0,0 +1,31 @@
+/**
+ * File upload field — the one field type that cannot render on the server.
+ *
+ * It holds upload state and reads the browser-published credential globals, so
+ * it lives here rather than in FormField.tsx. Pulling it out is what lets
+ * FormField drop its `'use client'` directive and render inside a Server
+ * Component (see StaticForm.tsx); a form WITHOUT a file field now ships no
+ * field-rendering JavaScript at all.
+ *
+ * Uploads the chosen file to the Sonor API, which stores it and returns a
+ * public URL — that URL becomes the field value, so large files never touch
+ * the JSON submission body. The value stays empty until the upload succeeds,
+ * so a required file field correctly blocks submission until the upload
+ * completes (rather than submitting a useless bare filename).
+ *
+ * Note: forms containing a file field are NOT native-POST eligible (see
+ * native-fallback.tsx) — a form-encoded POST cannot run this upload — so the
+ * server shell renders a plain disabled-looking file input and the real
+ * control arrives with the enhancement.
+ */
+import React from 'react';
+import type { FormField as FormFieldType } from './types';
+export interface FileFieldProps {
+    field: FormFieldType;
+    inputId: string;
+    classPrefix: string;
+    baseInputStyle: React.CSSProperties;
+    onChange: (value: unknown) => void;
+}
+export declare function FileField({ field, inputId, classPrefix, baseInputStyle, onChange, }: FileFieldProps): React.JSX.Element;
+//# sourceMappingURL=FileField.d.ts.map

package/dist/forms/FileField.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileField.d.ts","sourceRoot":"","sources":["../../src/forms/FileField.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAGzD,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,aAAa,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,cAAc,EAAE,KAAK,CAAC,aAAa,CAAA;IACnC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;CACnC;AAED,wBAAgB,SAAS,CAAC,EACxB,KAAK,EACL,OAAO,EACP,WAAW,EACX,cAAc,EACd,QAAQ,GACT,EAAE,cAAc,qBA6ChB"}

package/dist/forms/FormClient.d.ts

@@ -12,6 +12,15 @@ interface FormClientProps {
     onSuccess?: (submission: FormSubmission) => void;
     onError?: (error: Error) => void;
     customRender?: (props: FormRenderProps) => React.ReactNode;
+    /**
+     * Pre-fill field values by slug. For context the page already has and the
+     * visitor should not retype: an email captured earlier in a conversation,
+     * the service they were reading about, an estimate the assistant just
+     * produced. Applied ON TOP of each field's configured default_value.
+     *
+     * Unknown slugs are ignored, so a stale key cannot break the form.
+     */
+    defaultValues?: Record<string, unknown>;
     /**
      * Which rendering the form gets. Defaults to the form's `layout` config
      * (`layout: 'stage'` in Sonor flips a form to stage with no site deploy),
@@ -21,6 +30,6 @@ interface FormClientProps {
     /** Absolute page URL for the no-JS 303 to land on (see native-fallback). */
     nativeReturnTo?: string;
 }
-export declare function FormClient({ config, className, onSuccess, onError, customRender, experience, nativeReturnTo, }: FormClientProps): React.JSX.Element;
+export declare function FormClient({ config, className, onSuccess, onError, customRender, experience, nativeReturnTo, defaultValues, }: FormClientProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=FormClient.d.ts.map

package/dist/forms/FormClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormClient.d.ts","sourceRoot":"","sources":["../../src/forms/FormClient.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAA4D,MAAM,OAAO,CAAA;AAIhF,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAA;AAMhB,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,SAAS,CAAA;AAEpE,UAAU,eAAe;IACvB,MAAM,EAAE,iBAAiB,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAA;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAA;IAC1D;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,SAAS,EACT,SAAS,EACT,OAAO,EACP,YAAY,EACZ,UAAU,EACV,cAAc,GACf,EAAE,eAAe,qBAmnBjB"}
+{"version":3,"file":"FormClient.d.ts","sourceRoot":"","sources":["../../src/forms/FormClient.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAA4D,MAAM,OAAO,CAAA;AAIhF,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EACf,cAAc,EACf,MAAM,SAAS,CAAA;AAOhB,OAAO,KAAK,EAAyB,cAAc,EAAE,MAAM,SAAS,CAAA;AAEpE,UAAU,eAAe;IACvB,MAAM,EAAE,iBAAiB,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAA;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,KAAK,CAAC,SAAS,CAAA;IAC1D;;;;;;;OAOG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC;;;;OAIG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,SAAS,EACT,SAAS,EACT,OAAO,EACP,YAAY,EACZ,UAAU,EACV,cAAc,EACd,aAAa,GACd,EAAE,eAAe,qBA6nBjB"}

package/dist/forms/FormEnhancer.d.ts

@@ -0,0 +1,72 @@
+/**
+ * FormEnhancer — the only client code a managed form needs up front.
+ *
+ * Renders the server-rendered shell (<StaticForm>, passed as `children`) until
+ * an idle/first-interaction gate fires, then lazy-imports the interactive form
+ * and swaps it in. Everything expensive — validation, conditional logic,
+ * spotlight/stage, celebration, momentum — lives behind that dynamic import,
+ * so a page ships this boundary and nothing else in its initial chunk set.
+ *
+ * The shell is a REAL form the whole time (native action + signed token), so
+ * the progression is:
+ *
+ *   no JS at all      -> shell, submits natively. Works.
+ *   JS, pre-idle      -> shell, submits natively. Works.
+ *   JS, post-idle     -> enhanced form, submits over JSON. Works, with delight.
+ *   chunk 404s        -> shell stays. Works. (Never left blank.)
+ *
+ * That last line is the invariant to protect: the shell is only removed once
+ * the enhancement has actually rendered. Do not "hide the shell then load" —
+ * a CDN hiccup would leave a visitor staring at an empty box where the form
+ * used to be.
+ *
+ * ── Entrance animation ──────────────────────────────────────────────────
+ *
+ * Above-the-fold forms upgrade while the visitor is looking at them, so the
+ * swap must not pop. The wrapper carries `data-sk-form-mount="shell"` and
+ * flips to `"enhanced"`, and the enhanced form gets `data-sk-enter` for one
+ * frame, so a site can style the transition entirely in CSS:
+ *
+ *   [data-sk-form-mount] { transition: opacity .35s ease }
+ *   [data-sk-form-mount="shell"] { opacity: .6 }
+ *
+ * Defaults ship as CSS variables rather than hard-coded values:
+ *
+ *   --sk-form-enter-duration  (default 320ms)
+ *   --sk-form-enter-easing    (default cubic-bezier(.22,1,.36,1))
+ *   --sk-form-enter-distance  (default 6px)
+ *
+ * `enter="none"` opts out entirely; `enter="custom"` emits the data
+ * attributes but no site-kit styles, leaving the animation to the site.
+ * Every default is collapsed by prefers-reduced-motion.
+ */
+import React from 'react';
+import type { FormExperience, FormSubmission } from './types';
+export type FormEnterAnimation = 'fade' | 'none' | 'custom';
+export interface FormEnhancerProps {
+    formId: string;
+    /** Server-fetched raw config — hands the enhancement its fields instantly. */
+    initialConfig?: Record<string, unknown> | null;
+    className?: string;
+    nativeReturnTo?: string;
+    experience?: FormExperience;
+    /** Pre-fill field values by slug. See ManagedForm.defaultValues. */
+    defaultValues?: Record<string, unknown>;
+    onSuccess?: (submission: FormSubmission) => void;
+    onError?: (error: Error) => void;
+    /**
+     * How the enhanced form arrives. 'fade' (default) crossfades and lifts it
+     * into place; 'none' swaps instantly; 'custom' emits the data attributes
+     * and no styles so the site owns the animation.
+     */
+    enter?: FormEnterAnimation;
+    /**
+     * Set false to enhance immediately instead of waiting for idle. Only worth
+     * it for a form that is the entire point of the page AND above the fold.
+     */
+    defer?: boolean;
+    /** The server-rendered <StaticForm>. Shown until the enhancement mounts. */
+    children: React.ReactNode;
+}
+export declare function FormEnhancer({ formId, initialConfig, className, nativeReturnTo, experience, defaultValues, onSuccess, onError, enter, defer, children, }: FormEnhancerProps): React.JSX.Element;
+//# sourceMappingURL=FormEnhancer.d.ts.map

package/dist/forms/FormEnhancer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FormEnhancer.d.ts","sourceRoot":"","sources":["../../src/forms/FormEnhancer.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAEH,OAAO,KAAsD,MAAM,OAAO,CAAA;AAE1E,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAO7D,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE3D,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,oEAAoE;IACpE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAA;IAChD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;IAChC;;;;OAIG;IACH,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,4EAA4E;IAC5E,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B;AAED,wBAAgB,YAAY,CAAC,EAC3B,MAAM,EACN,aAAa,EACb,SAAS,EACT,cAAc,EACd,UAAU,EACV,aAAa,EACb,SAAS,EACT,OAAO,EACP,KAAc,EACd,KAAY,EACZ,QAAQ,GACT,EAAE,iBAAiB,qBAiCnB"}

package/dist/forms/FormField.d.ts

@@ -29,12 +29,35 @@ interface FormFieldProps {
     /** Render the valid-state tick (touched + validated). Text-like fields only. */
     showValid?: boolean;
     field: FormFieldType;
-    value: unknown;
+    value?: unknown;
     error?: string;
-    onChange: (value: unknown) => void;
+    /**
+     * Omit to render STATIC mode: uncontrolled native controls with
+     * `defaultValue`, no React state, no event handlers. That is what lets a
+     * Server Component render a complete, submittable form with zero client
+     * JavaScript (see StaticForm.tsx). Pass a handler for the usual controlled
+     * behaviour once the enhancement hydrates.
+     *
+     * The two modes MUST emit the same element/class structure — the
+     * enhancement replaces the shell in place, and a mismatch shows up as a
+     * visible jump. field-parity.test.tsx pins this.
+     */
+    onChange?: (value: unknown) => void;
     /** Optional class name prefix for custom styling */
     classPrefix?: string;
+    /**
+     * Client-only controls, injected by FormClient. DatePicker and FileField
+     * carry hooks; importing them here would pull them into this module's chunk
+     * and the build would stamp the whole thing `'use client'`, so a Server
+     * Component rendering one text input would ship the date picker too.
+     * Injection keeps this file hook-free and therefore server-renderable.
+     * Absent = static mode falls back to the native control.
+     */
+    controls?: {
+        Date?: React.ComponentType<any>;
+        File?: React.ComponentType<any>;
+    };
 }
-export declare function FormField({ field, value, error, onChange, classPrefix, showValid }: FormFieldProps): React.JSX.Element;
+export declare function FormField({ field, value, error, onChange, classPrefix, showValid, controls }: FormFieldProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=FormField.d.ts.map

package/dist/forms/FormField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../src/forms/FormField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAIzD,UAAU,cAAc;IACtB,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AA4BD,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAuB,EAAG,SAAS,EAAE,EAAE,cAAc,qBA8S/G"}
+{"version":3,"file":"FormField.d.ts","sourceRoot":"","sources":["../../src/forms/FormField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAEzD,UAAU,cAAc;IACtB,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,KAAK,EAAE,aAAa,CAAA;IACpB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACnC,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;QAC/B,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;KAChC,CAAA;CACF;AA4BD,wBAAgB,SAAS,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAuB,EAAG,SAAS,EAAE,QAAQ,EAAE,EAAE,cAAc,qBA4WzH"}

package/dist/forms/FormSpotlight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormSpotlight.d.ts","sourceRoot":"","sources":["../../src/forms/FormSpotlight.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAA;AAWhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AA+BhF;;6BAE6B;AAC7B,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,GAAG,IAAI,CAuEf;AAgID,wBAAgB,UAAU,sBAEzB;AAsBD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,MAAM,EACN,eAAe,EACf,QAAQ,GACT,EAAE,qBAAqB,qBA2kBvB"}
+{"version":3,"file":"FormSpotlight.d.ts","sourceRoot":"","sources":["../../src/forms/FormSpotlight.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAA;AAYhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AA+BhF;;6BAE6B;AAC7B,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAeR;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,aAAa,EAAE,EACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,GAAG,IAAI,CAuEf;AAgID,wBAAgB,UAAU,sBAEzB;AAsBD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,MAAM,EACN,eAAe,EACf,QAAQ,GACT,EAAE,qBAAqB,qBA+kBvB"}

package/dist/forms/FormStage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormStage.d.ts","sourceRoot":"","sources":["../../src/forms/FormStage.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAA;AAYhF,OAAO,KAAK,EAAE,qBAAqB,EAA8B,MAAM,SAAS,CAAA;AAKhF,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,MAAM,EACN,eAAe,EACf,QAAQ,GACT,EAAE,qBAAqB,qBAwevB"}
+{"version":3,"file":"FormStage.d.ts","sourceRoot":"","sources":["../../src/forms/FormStage.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAA4D,MAAM,OAAO,CAAA;AAahF,OAAO,KAAK,EAAE,qBAAqB,EAA8B,MAAM,SAAS,CAAA;AAKhF,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,MAAM,EACN,MAAM,EACN,OAAO,EACP,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,eAAe,EACf,eAAe,EACf,MAAM,EACN,eAAe,EACf,QAAQ,GACT,EAAE,qBAAqB,qBA2evB"}

package/dist/forms/HoneypotField.d.ts

@@ -23,8 +23,14 @@
 import React from 'react';
 export interface HoneypotFieldProps {
     name: string;
-    value: string;
-    onChange: (value: string) => void;
+    value?: string;
+    /**
+     * Omit for STATIC mode — an uncontrolled trap a Server Component can render.
+     * The trap's whole job is server-side (the value is read off the submission
+     * and stripped), so it needs no client state to work; the controlled form is
+     * only so the hydrated JSON path can read it back out of React state.
+     */
+    onChange?: (value: string) => void;
 }
 export declare function HoneypotField({ name, value, onChange }: HoneypotFieldProps): React.JSX.Element;
 //# sourceMappingURL=HoneypotField.d.ts.map

package/dist/forms/HoneypotField.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HoneypotField.d.ts","sourceRoot":"","sources":["../../src/forms/HoneypotField.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,kBAAkB,qBAoC1E"}
+{"version":3,"file":"HoneypotField.d.ts","sourceRoot":"","sources":["../../src/forms/HoneypotField.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACnC;AAED,wBAAgB,aAAa,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,EAAE,kBAAkB,qBAyC1E"}

package/dist/forms/ManagedForm.d.ts

@@ -4,5 +4,5 @@
  * Fetches form config from Portal API and renders fields with validation
  */
 import type { ManagedFormProps } from './types';
-export declare function ManagedForm({ formId, projectId, className, onSuccess, onError, initialConfig, experience, nativeReturnTo, children, }: ManagedFormProps): import("react").JSX.Element;
+export declare function ManagedForm({ formId, projectId, className, onSuccess, onError, initialConfig, experience, nativeReturnTo, defaultValues, children, }: ManagedFormProps): import("react").JSX.Element;
 //# sourceMappingURL=ManagedForm.d.ts.map

package/dist/forms/ManagedForm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManagedForm.d.ts","sourceRoot":"","sources":["../../src/forms/ManagedForm.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,aAAa,EACb,UAAU,EACV,cAAc,EACd,QAAQ,GACT,EAAE,gBAAgB,+BA0ClB"}
+{"version":3,"file":"ManagedForm.d.ts","sourceRoot":"","sources":["../../src/forms/ManagedForm.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAQ/C,wBAAgB,WAAW,CAAC,EAC1B,MAAM,EACN,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,aAAa,EACb,UAAU,EACV,cAAc,EACd,aAAa,EACb,QAAQ,GACT,EAAE,gBAAgB,+BA2ClB"}

package/dist/forms/ServerForm.d.ts

@@ -0,0 +1,73 @@
+/**
+ * ServerForm — the managed form as a Server Component. This is the one to use.
+ *
+ * ```tsx
+ * import { ServerForm } from '@sonordev/site-kit/forms/server'
+ *
+ * export default function ContactPage() {
+ *   return <ServerForm formId="contact" returnTo="https://example.com/contact/" />
+ * }
+ * ```
+ *
+ * That single line fetches the config on the server, renders a complete
+ * working `<form>` into the HTML, and upgrades it to the interactive
+ * experience at idle. No `'use client'` in the page, no config flash, no
+ * "Loading form...", and no forms runtime in the initial chunk set.
+ *
+ * What each layer is for:
+ *
+ *   getFormConfig  — server fetch, ISR-cached. No client round trip.
+ *   StaticForm     — real HTML form: fields, honeypot, signed native token.
+ *                    Submits without JavaScript.
+ *   FormEnhancer   — ~1 KB client boundary. Lazy-loads the interactive form
+ *                    at idle and swaps it in over the shell.
+ *
+ * Set `enhance={false}` for a form that should never load JavaScript at all —
+ * the native POST handles it, and the page ships zero form script.
+ *
+ * The client `ManagedForm` from `@sonordev/site-kit/forms` still exists and
+ * still works; reach for it only when the form must live inside an existing
+ * client component (a modal, a chat panel) where a Server Component cannot go.
+ */
+import React from 'react';
+import { type FormEnterAnimation } from './FormEnhancer';
+import { type GetFormConfigOptions } from './server';
+import type { FormExperience } from './types';
+export interface ServerFormProps {
+    /** Form slug or id from Sonor. */
+    formId: string;
+    /**
+     * Absolute URL the no-JS submission should return to — normally the page
+     * hosting the form. Without it sonor-api falls back to the Referer origin,
+     * which lands the visitor on the site's homepage rather than back here.
+     */
+    returnTo?: string;
+    className?: string;
+    /** Rendering experience once enhanced. Defaults to the Sonor form config. */
+    experience?: FormExperience;
+    /** Entrance animation for the idle upgrade. See FormEnhancer. */
+    enter?: FormEnterAnimation;
+    /**
+     * false = ship no form JavaScript at all. The static form still submits via
+     * the native endpoint; you lose inline validation, the experiences, and the
+     * celebration. Good for a footer newsletter field, wrong for a long form.
+     */
+    enhance?: boolean;
+    /**
+     * false = enhance on mount instead of at idle. Only for a form that is the
+     * entire purpose of the page.
+     */
+    defer?: boolean;
+    /**
+     * Pre-fill field values by slug — context the page already has at render
+     * time (the service this page is about, a campaign source). Applied on top
+     * of each field's configured default_value.
+     */
+    defaultValues?: Record<string, unknown>;
+    /** Pre-fetched config, if the page already has it. Skips the fetch. */
+    initialConfig?: Record<string, unknown> | null;
+    /** Passed through to getFormConfig (api key / url / revalidate). */
+    configOptions?: GetFormConfigOptions;
+}
+export declare function ServerForm({ formId, returnTo, className, experience, enter, enhance, defer, initialConfig, configOptions, defaultValues, }: ServerFormProps): Promise<React.JSX.Element>;
+//# sourceMappingURL=ServerForm.d.ts.map

package/dist/forms/ServerForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerForm.d.ts","sourceRoot":"","sources":["../../src/forms/ServerForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAiB,KAAK,oBAAoB,EAAE,MAAM,UAAU,CAAA;AAEnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAE7C,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAA;IACd;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,cAAc,CAAA;IAC3B,iEAAiE;IACjE,KAAK,CAAC,EAAE,kBAAkB,CAAA;IAC1B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAA;IACf;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACvC,uEAAuE;IACvE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC9C,oEAAoE;IACpE,aAAa,CAAC,EAAE,oBAAoB,CAAA;CACrC;AAED,wBAAsB,UAAU,CAAC,EAC/B,MAAM,EACN,QAAQ,EACR,SAAS,EACT,UAAU,EACV,KAAc,EACd,OAAc,EACd,KAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,GACd,EAAE,eAAe,8BA0BjB"}

package/dist/forms/StaticForm.d.ts

@@ -0,0 +1,50 @@
+/**
+ * StaticForm — a complete, submittable managed form with ZERO client JavaScript.
+ *
+ * No `'use client'`. This renders in a Server Component, and what it emits is
+ * a real `<form>`: every field, the honeypot, the signed native token, and a
+ * submit button. With JavaScript disabled, off, or still downloading, the
+ * browser performs an ordinary form-encoded POST to
+ * `/api/public/forms/submit-native`, sonor-api runs the honeypot +
+ * render-timestamp + quarantine stack, and the lead lands. 4.0.1 built that
+ * endpoint; this is what finally puts it under every form by default.
+ *
+ * ── Why this exists ─────────────────────────────────────────────────────
+ *
+ * ManagedForm was a client component for historical reasons that no longer
+ * hold: it used to fetch its own config (getFormConfig removed that) and it
+ * could only submit via JSON (the native endpoint removed that). Nobody moved
+ * the boundary afterward, so every site that rendered a form paid for the
+ * whole forms runtime — validation, spotlight, celebration, momentum — as an
+ * INITIAL script, on the LCP-critical path.
+ *
+ * Measured on upforge.io's homepage: 48 KB of form code in the initial chunk
+ * set cost 6 Lighthouse points (88 -> 82, LCP 3.8s -> 4.7s). Deferring the
+ * client component recovered the score but deleted the form from the HTML,
+ * taking the no-JS floor and crawlable fields with it. Neither half was
+ * acceptable; a server-rendered form is what makes both true at once.
+ *
+ * Pair it with <FormEnhancer> to upgrade this markup at idle. Alone, it is
+ * still a working form — that is the point. Never make this file `'use
+ * client'`, and never import a hook into it.
+ */
+import React from 'react';
+import type { ManagedFormConfig } from './types';
+export interface StaticFormProps {
+    /**
+     * RAW /api/public/forms/config payload from `getFormConfig`, or an
+     * already-normalized config. Normalized here through the SAME function the
+     * client fetch uses, so the shell and the enhancement cannot disagree about
+     * field order, step count, or success copy.
+     */
+    config: Record<string, unknown> | ManagedFormConfig | null | undefined;
+    className?: string;
+    /**
+     * Absolute URL the no-JS 303 should return to (usually the page hosting the
+     * form). Without it the API falls back to the Referer origin — right site,
+     * wrong page.
+     */
+    nativeReturnTo?: string;
+}
+export declare function StaticForm({ config: raw, className, nativeReturnTo }: StaticFormProps): React.JSX.Element | null;
+//# sourceMappingURL=StaticForm.d.ts.map

package/dist/forms/StaticForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StaticForm.d.ts","sourceRoot":"","sources":["../../src/forms/StaticForm.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAMzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,GAAG,IAAI,GAAG,SAAS,CAAA;IACtE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAgBD,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,EAAE,eAAe,4BA2CrF"}

package/dist/forms/field-controls.d.ts

@@ -0,0 +1,7 @@
+import type { FormField as FormFieldType } from './types';
+export interface FieldControls {
+    Date?: React.ComponentType<any>;
+    File?: React.ComponentType<any>;
+}
+export declare function useFieldControls(fields: FormFieldType[] | undefined): FieldControls;
+//# sourceMappingURL=field-controls.d.ts.map

package/dist/forms/field-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-controls.d.ts","sourceRoot":"","sources":["../../src/forms/field-controls.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,SAAS,CAAA;AAEzD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;IAC/B,IAAI,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAA;CAChC;AAKD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,SAAS,GAAG,aAAa,CA+CnF"}

package/dist/forms/index.d.ts

@@ -100,6 +100,13 @@ export type { Form, FormField, FormStep, FormType, FieldType, CreateFormInput, U
 export { useForm } from './useForm';
 export type { UseFormOptions, UseFormReturn } from './useForm';
 export { ManagedForm } from './ManagedForm';
+/**
+ * Client boundary that upgrades a server-rendered <StaticForm> at idle.
+ * Most sites want ServerForm from '@sonordev/site-kit/forms/server' instead,
+ * which wires this up for them.
+ */
+export { FormEnhancer } from './FormEnhancer';
+export type { FormEnhancerProps, FormEnterAnimation } from './FormEnhancer';
 export { FormClient } from './FormClient';
 export { FormCelebration } from './FormCelebration';
 export type { FormCelebrationProps } from './FormCelebration';

package/dist/forms/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAGH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5F,YAAY,EACV,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAG7D,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,SAAS,IAAI,eAAe,GAC7B,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/forms/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgGG;AAGH,OAAO,EAAE,QAAQ,EAAE,iBAAiB,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAC5F,YAAY,EACV,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAA;AAGnB,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAG9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,YAAY,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AAC7D,OAAO,EAAE,SAAS,IAAI,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAG7D,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAG7C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAGnD,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,SAAS,IAAI,eAAe,GAC7B,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAGtE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA"}