@levo-so/site-runtime 0.3.11 → 0.3.13

package/{PopupBody-BI-MJqmd-DW3qWKam.js → PopupBody-BI-MJqmd-DgTQEzda.js}

@@ -60,7 +60,7 @@ var Q = [
 		...r,
 		children: a
 	}) : null;
-}, te = /* @__PURE__ */ O({ PopupBody: () => oe }), ne = B(() => import("./dist-BdNHqoWi.js").then((e) => e.t).then((e) => ({ default: e.CollectionFormBuilder }))), re = E({ baseSpacing: ".625rem" }), ie = { style: a({ form: { gap: "1rem" } }) }, ae = {
+}, te = /* @__PURE__ */ O({ PopupBody: () => oe }), ne = B(() => import("./dist-CEdznbFW.js").then((e) => e.t).then((e) => ({ default: e.CollectionFormBuilder }))), re = E({ baseSpacing: ".625rem" }), ie = { style: a({ form: { gap: "1rem" } }) }, ae = {
 	left: D,
 	center: M,
 	right: A

package/{PopupRenderer-D66Gx63H-BnOmWsyj.js → PopupRenderer-D66Gx63H-Cd9xJv33.js}

@@ -103,7 +103,7 @@ var se = (e) => (e ?? "16:9").replace(":", " / "), ce = (e) => {
 		...a,
 		children: r
 	}), n[15] = r, n[16] = a, n[17] = p, n[18] = m) : m = n[18], m;
-}, de = I(() => import("./PopupBody-BI-MJqmd-DW3qWKam.js").then((e) => e.n).then((e) => ({ default: e.PopupBody }))), fe = (e) => {
+}, de = I(() => import("./PopupBody-BI-MJqmd-DgTQEzda.js").then((e) => e.n).then((e) => ({ default: e.PopupBody }))), fe = (e) => {
 	let t = A(7), { size: n } = e, r = n ?? "medium", i;
 	t[0] === r ? i = t[1] : (i = k({ size: r }), t[0] = r, t[1] = i);
 	let a, o, s;

package/blog-content.d.ts

@@ -0,0 +1,31 @@
+export declare interface ILevoBlogContentProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "content"> {
+    /**
+     * A blog post's `content`, or a collection field the dashboard edits with the rich-text
+     * editor — exactly as the API returns it. Every shape the platform has ever stored is
+     * accepted; see {@link LevoBlogContent}.
+     */
+    content: unknown;
+}
+
+/**
+ * Render a stored Levo editor DOCUMENT — a blog post's body, or a collection field the
+ * dashboard edits with the rich-text editor.
+ *
+ * Narrow on purpose: this is for the `{ json: { type: "doc", … } }` value those two fields
+ * hold, NOT for text in general. Plain strings — excerpts, descriptions, headings, anything
+ * a `<p>` can hold — render as ordinary JSX; reaching for this component there pulls the
+ * whole editor node set onto the page for nothing. Where it IS the right call there is no
+ * alternative: `String(post.content)` prints `[object Object]` and `dangerouslySetInnerHTML`
+ * has nothing to insert.
+ *
+ * Renders the same node set the Levo editor writes and Levo-hosted pages show — headings,
+ * lists, code blocks, images, bookmarks, buttons, embedded collections — server-side, so the
+ * article is in the SSR HTML where crawlers read it.
+ *
+ * Typography comes from the shared prose theme in `@levo-so/site-runtime/setup.css` (already
+ * loaded by the site shell). Style the wrapper through `className` as usual; content the field
+ * doesn't contain renders nothing, so an empty body is an empty region, never a crash.
+ */
+export declare const LevoBlogContent: React.FC<ILevoBlogContentProps>;
+
+export { }

package/{rich-text.js → blog-content.js}

@@ -1,8 +1,8 @@
 "use client";
-import { r as e } from "./dist-BdNHqoWi.js";
+import { r as e } from "./dist-CEdznbFW.js";
 import { t } from "./LevoProvider-Bsjkcwc8.js";
 import { t as n } from "./inlineBaseTheme-BB9e6h5f.js";
-import { t as r } from "./dist-Cl_sKk9y.js";
+import { t as r } from "./dist-6AIgW_iB.js";
 import { _ as i, a, c as o, d as s, f as c, g as l, h as u, i as d, l as f, m as p, n as m, o as h, p as g, r as _, s as v, t as y, u as b, v as x } from "./react-Cj_U6VZQ.js";
 import { i as S, n as C, r as w, t as T } from "./content.cssm-XdMsTGIB.js";
 import { t as E } from "./RteThemeProvider-BQmfSXSl.js";
@@ -1641,4 +1641,4 @@ var Yt = "_10kj0ro0", Xt = "_10kj0ro1", Zt = "_10kj0ro2", Qt = (e) => e ? typeof
 	}) : null;
 };
 //#endregion
-export { _n as LevoRichText };
+export { _n as LevoBlogContent };

package/{dist-Cl_sKk9y.js → dist-6AIgW_iB.js}

@@ -14,7 +14,7 @@ var v = /* @__PURE__ */ e({
 }), y = async (e, t) => {
 	let n = {};
 	return t?.site_id && (n.site_id = t.site_id), t?.locale && (n.locale = t.locale), t?.country && (n.country = t.country), (await e.url("/v1/studio/popup/list-active").query(n).get().json())?.content?.data ?? [];
-}, b = p(() => import("./PopupRenderer-D66Gx63H-BnOmWsyj.js").then((e) => e.t).then((e) => ({ default: e.PopupRenderer }))), x = (e) => {
+}, b = p(() => import("./PopupRenderer-D66Gx63H-Cd9xJv33.js").then((e) => e.t).then((e) => ({ default: e.PopupRenderer }))), x = (e) => {
 	let n = u(9), { siteId: r, pageId: i } = e, { fetch: a, logger: s } = t(), [c, l] = g(null), p = h(!1), v, x;
 	if (n[0] !== a || n[1] !== s || n[2] !== r ? (v = () => {
 		if (p.current) return;

package/{dist-BdNHqoWi.js → dist-CEdznbFW.js}

@@ -2321,14 +2321,14 @@ var zr = ((e) => (t) => t ? Rr(e, t) : e)({
 }, ai = (e) => {
 	localStorage.removeItem(`${e}-${ni.FORM_VALUES}`);
 }, oi = ({ schema: e, originalSchema: t, onSubmitSuccess: n, onSubmitError: r, onInit: i, setFormErrorAfterSubmit: a = !0 }) => {
-	let o = oe(() => e, [e]), s = oe(() => t || o, [t, o]), c = g(), { toastConfig: l, onSuccess: u, onError: f, isLoggedIn: p, isDisabled: m, externalInitialValues: h = {}, account: _, preview: v } = ei(), [y, b] = Q({
+	let o = oe(() => e, [e]), s = oe(() => t || o, [t, o]), c = g(), { toastConfig: l, onSuccess: u, onError: f, isLoggedIn: p, isDisabled: m, externalInitialValues: h = {}, account: _, preview: v, uiConfig: y } = ei(), [b, x] = Q({
 		contentId: null,
 		publishedId: null
-	}), [x, S] = Q(!1), [C, w] = Q(!1), [T, E] = Q(!1), D = se({}), O = se({}), k = (e) => {
+	}), [S, C] = Q(!1), [w, T] = Q(!1), [E, D] = Q(!1), O = se({}), k = se({}), A = (e) => {
 		if (!o?.sections) return null;
 		for (let t of o.sections) for (let n of t?.fields ?? []) if (n?.key === e) return n?.kind ?? null;
 		return null;
-	}, A = () => {
+	}, M = () => {
 		let e = {};
 		try {
 			if (typeof window < "u") {
@@ -2336,7 +2336,7 @@ var zr = ((e) => (t) => t ? Rr(e, t) : e)({
 				for (let [n, r] of t.entries()) {
 					let [t, i] = n.split("-");
 					if (t === "lf" && i && r) try {
-						let t = JSON.parse(r), n = k(i);
+						let t = JSON.parse(r), n = A(i);
 						e[i] = typeof t == "number" && !(n === "number" || n === "currency") ? r : t;
 					} catch {
 						e[i] = r;
@@ -2351,112 +2351,117 @@ var zr = ((e) => (t) => t ? Rr(e, t) : e)({
 			...n,
 			...e
 		};
-		D.current = {
+		O.current = {
 			...t,
 			...r,
-			...D.current
+			...O.current
 		};
-	}, M = V({
+	}, N = V({
 		mode: "onTouched",
 		disabled: m
-	}), { formState: N } = M, P = (e) => {
-		D.current = {
-			...D.current || {},
+	}), { formState: F } = N, I = (e) => {
+		O.current = {
+			...O.current || {},
 			...e
 		};
 	};
 	return ae(() => {
 		if (o && c?.collection) {
-			if (A(), !y.contentId && !y.publishedId && !v) {
+			if (M(), !b.contentId && !b.publishedId && !v) {
 				let e = o?.allow_multiple === !1;
 				if (o?.allow_draft) {
 					if (p) {
-						S(!0), c?.collection?.getDraftEntry(o?.key).then((t) => {
+						C(!0), c?.collection?.getDraftEntry(o?.key).then((t) => {
 							let n = t?.content?.data;
 							if (n === null) {
-								w(!0);
+								T(!0);
 								return;
 							}
-							w(!1);
+							T(!1);
 							let r = e && Array.isArray(n) && n?.find((e) => e?._status === "published") || null;
-							if (r?._id) D.current = {
-								...D.current || {},
+							if (r?._id) O.current = {
+								...O.current || {},
 								...r
-							}, b({
+							}, x({
 								contentId: null,
 								publishedId: r._id
 							});
 							else {
 								let e = Array.isArray(n) ? n?.filter((e) => e?._status === "draft") : [], t = e?.[e.length - 1] || null;
-								t?._id && (D.current = {
-									...D.current || {},
+								t?._id && (O.current = {
+									...O.current || {},
 									...t
-								}, b({
+								}, x({
 									contentId: t._id,
 									publishedId: null
 								}));
 							}
 						}).catch((e) => (c?.logger?.error("Failed to get draft entry", { exception: e }), null)).finally(() => {
-							O.current = { ...D.current }, M.reset({ ...D?.current }), i?.(D.current), S(!1);
+							k.current = { ...O.current }, N.reset({ ...O?.current }), i?.(O.current), C(!1);
 						});
 						return;
 					}
 					let t = ri(o?.key);
-					t && (D.current = {
-						...D.current || {},
+					t && (O.current = {
+						...O.current || {},
 						...t
 					});
 				}
 			}
-			O.current = { ...D.current }, M.reset({ ...D?.current }), i?.(D.current);
+			k.current = { ...O.current }, N.reset({ ...O?.current }), i?.(O.current);
 		}
 	}, [o, p]), ae(() => {
-		let { isSubmitSuccessful: e, isValid: t } = N;
-		e && t && (O.current = { ...D.current }, M.reset({
-			...D?.current,
+		let { isSubmitSuccessful: e, isValid: t } = F;
+		e && t && (k.current = { ...O.current }, N.reset({
+			...O?.current,
 			__captcha: "verified"
-		}), i?.(D.current));
-	}, [N]), ae(() => {
-		o && (y.contentId || y.publishedId) && ai(o?.key);
-	}, [y]), {
-		methods: M,
-		isLoading: x,
-		isError: C,
-		contentId: y.contentId,
-		publishedId: y.publishedId,
-		allFormValues: D.current,
+		}), i?.(O.current));
+	}, [F]), ae(() => {
+		o && (b.contentId || b.publishedId) && ai(o?.key);
+	}, [b]), {
+		methods: N,
+		isLoading: S,
+		isError: w,
+		contentId: b.contentId,
+		publishedId: b.publishedId,
+		allFormValues: O.current,
 		handleContentId: (e) => {
-			e && e !== y.contentId && !y.publishedId && b({
+			e && e !== b.contentId && !b.publishedId && x({
 				contentId: e,
 				publishedId: null
 			});
 		},
-		appendFormValues: P,
+		appendFormValues: I,
 		submitToRemote: async (e) => {
-			if (P(e), !(v || !c?.collection || !s)) try {
-				let e = et(D?.current, s, O.current), t = null;
-				if (t = y.publishedId ? await c?.collection?.editDraftEntry(s?.key, y.publishedId, e) : y.contentId ? await c?.collection?.submitDraftEntry(s?.key, e) : await c?.collection?.saveCollectionData({
+			if (I(e), !(v || !c?.collection || !s)) try {
+				let e = et(O?.current, s, k.current), t = null;
+				if (t = b.publishedId ? await c?.collection?.editDraftEntry(s?.key, b.publishedId, e) : b.contentId ? await c?.collection?.submitDraftEntry(s?.key, e) : await c?.collection?.saveCollectionData({
 					collection_id: s?.id,
 					data: e
 				}), t?.content?.data) {
 					let e = t?.content?.meta?.booking_config?.enabled;
-					l?.showSuccessToast && !(l?.suppressOnBooking && e) && d(l.successToastText || "Form submitted successfully."), D.current = {}, A(), ai(s?.key), b({
+					l?.showSuccessToast && !(l?.suppressOnBooking && e) && d(l.successToastText || "Form submitted successfully."), O.current = {}, M(), ai(s?.key), x({
 						contentId: null,
 						publishedId: null
-					}), E(!0), u && u({
-						schemaId: s?.id,
-						response: t?.content?.data,
-						meta: t?.content?.meta
-					}), n && n();
+					}), y?.hideSuccessScreen || D(!0);
+					try {
+						u && u({
+							schemaId: s?.id,
+							response: t?.content?.data,
+							meta: t?.content?.meta
+						}), n && n();
+					} catch (e) {
+						c?.logger?.error("Form success callback threw after a saved entry", { exception: P(e) });
+					}
 					return;
 				}
 				throw Error("Failed to save form details, API response invalid");
 			} catch (e) {
-				Xt(e), e instanceof j ? (e?.hasFieldErrors && a && ti(e?.fieldErrors, M.setError), r && r(e.fieldErrors || []), f && f(e)) : f && f(e?.response?.data || e);
+				Xt(e), e instanceof j ? (e?.hasFieldErrors && a && ti(e?.fieldErrors, N.setError), r && r(e.fieldErrors || []), f && f(e)) : f && f(e?.response?.data || e);
 			}
 		},
-		showSuccessOverlay: T,
-		dismissSuccessOverlay: () => E(!1)
+		showSuccessOverlay: E,
+		dismissSuccessOverlay: () => D(!1)
 	};
 }, si = "_1jed92w2", ci = "_1jed92w3 _1jed92w1", li = "_1jed92w4 _1jed92w1", ui = "_1jed92w5 _1jed92w1", di = "_1jed92w6 _1jed92w1", fi = () => {
 	let e = W(1), t;
@@ -3625,15 +3630,15 @@ var ka = (e) => {
 	let t = W(17), n, r, i, a;
 	t[0] === e ? (n = t[1], r = t[2], i = t[3], a = t[4]) : ({collection_id: n, hiddenFields: r, enableVerification: a, ...i} = e, t[0] = e, t[1] = n, t[2] = r, t[3] = i, t[4] = a);
 	let o = a === void 0 ? !0 : a, { collection: s } = g(), [c, l] = Q(!0), [u, d] = Q(null), f;
-	t[5] !== s || t[6] !== n || t[7] !== r || t[8] !== i?.workspace_id ? (f = () => {
-		n ? s?.getCollectionByIDExpanded(n, { headers: { "Levo-Workspace": i?.workspace_id } }).then((e) => {
+	t[5] !== s || t[6] !== n || t[7] !== r || t[8] !== i ? (f = () => {
+		n ? s?.getCollectionByIDExpanded(n, { headers: { "Levo-Workspace": i.workspace_id } }).then((e) => {
 			let t = e?.content?.data;
 			if (t) t.sections = t?.sections?.map((e) => (e.fields = e?.fields?.map((e) => (r?.includes(e?.key) && (e.hidden = !0), e)), e)), d(t);
 			else throw Error(`API response invalid: ${t}`);
 		}).catch(ja).finally(() => {
 			l(!1);
 		}) : (console.error("[CollectionFormBuilder] Collection ID or Workspace ID is missing."), l(!1));
-	}, t[5] = s, t[6] = n, t[7] = r, t[8] = i?.workspace_id, t[9] = f) : f = t[9];
+	}, t[5] = s, t[6] = n, t[7] = r, t[8] = i, t[9] = f) : f = t[9];
 	let p;
 	t[10] === n ? p = t[11] : (p = [n], t[10] = n, t[11] = p), ae(f, p);
 	let m;

package/index.d.ts

@@ -2,6 +2,7 @@ import { ILemaCollection } from '@levo-so/core';
 import { ILevoClient } from '@levo-so/core';
 import { ILevoInsights } from '@levo-so/insights';
 import { ILevoMembership } from '@levo-so/core';
+import { IMediaObject } from '@levo-so/core';
 import { JSX } from 'react/jsx-runtime';
 import { LevoQuery } from '@levo-so/core';
 
@@ -117,7 +118,7 @@ export declare const createSiteClient: (config?: ILevoSiteConfig) => ILevoClient
  *      anything the client sends, so collection lookups and profile conditions are evaluated
  *      where they can be trusted.
  */
-export declare const decideAccess: ({ rules, invalid, pageId, hasClient, isReady, isLoggedIn, check, }: IAccessDecisionInput) => IAccessDecision;
+export declare const decideAccess: ({ rules, invalid, pageId, hasClient, isReady, isLoggedIn, check, preview, }: IAccessDecisionInput) => IAccessDecision;
 
 /**
  * Main entry: extract visitor country + language preferences.
@@ -171,6 +172,8 @@ export declare interface IAccessDecisionInput {
         isSuccess: boolean;
         data: IAccessCheckResponse | null;
     };
+    /** A stage forced from the Studio editor, or null. Client-only, never set on a real visit. */
+    preview?: ILevoAccessPreviewStage | null;
 }
 
 /**
@@ -254,6 +257,16 @@ export declare type IEditorToPreview = {
 } | {
     type: "set-text-edit";
     enabled: boolean;
+}
+/**
+* Force a page's access gate to a given outcome, or `null` to decide normally. The only
+* message here that isn't about inspecting — it rides this channel because this channel IS
+* "the editor is driving this preview", and a gated page is otherwise uneditable. Re-sent
+* on every `ready`, like the two mode flags above.
+*/
+| {
+    type: "set-access-preview";
+    stage: ILevoAccessPreviewStage | null;
 } | {
     type: "clear-selection";
 } | {
@@ -418,6 +431,21 @@ export declare interface ILevoAccessGatingOptions {
     hidden?: string[];
 }
 
+/**
+ * A gate outcome forced from the Studio editor, so someone can work on a page they have no
+ * account for — and design the blocked screens without arranging a matching account.
+ *
+ * Editor-only: it arrives over the editor's postMessage channel and is never persisted, so
+ * a real visit has no way to be in one of these states. `granted` is the one that fails
+ * OPEN, which is the whole point of it — see `decideAccess`, and the note there on what
+ * that does and does not expose.
+ *
+ * A stage whose rule the page doesn't configure is IGNORED rather than forced: a page with
+ * no `gating` rule has no entry form to show, and inventing one would preview a screen the
+ * real site can never render.
+ */
+export declare type ILevoAccessPreviewStage = "granted" | "signed_out" | "entry_missing" | "entry_under_review" | "profile_incomplete";
+
 /**
  * `kind: "profile"` — account access: signed in AND the visitor's OWN membership account
  * satisfies `condition`. There is no collection here (the membership account is resolved
@@ -627,19 +655,35 @@ export declare interface ILevoFormProps {
     /** Field keys to hide from the rendered form (matched against field key/id, recursively into nested fields). */
     hiddenFields?: string[];
     /** Layout: all fields at once, one-at-a-time (Typeform), or stepped by section. */
-    formVariant?: "default" | "single-field" | "steps" | "steps-2";
+    formVariant?: ILevoFormVariant;
     /** Success-screen copy + the post-submit action (show a message, let them submit another, or redirect). */
-    successConfig?: {
-        title?: string;
-        message?: string;
-        action?: {
-            type: "none" | "submit_another" | "redirect";
-            value?: string;
-        };
-    };
+    successConfig?: ILevoFormSuccessConfig;
     /** Brand the form. Optional — defaults to the site theme; only override the few colors you want to diverge. */
     theme?: ILevoFormTheme;
     className?: string;
+    /**
+     * Values the form opens with, keyed by collection field key. Merged over the collection's
+     * own field defaults and under anything the URL supplies, so a `?plan=pro` link still wins.
+     * Keys the collection doesn't have are dropped at submit. Read ONCE when the schema
+     * resolves — a later change to this object does not re-seed a form the visitor is filling in.
+     */
+    defaultValues?: Record<string, unknown>;
+    /** Render every field read-only (a confirmation view, or a form gated behind another step). */
+    disabled?: boolean;
+    /**
+     * Show the built-in thank-you screen after a submission. Default `true`. Turn it off ONLY
+     * alongside an `onSuccess` that does something visible (navigates, reveals your own
+     * confirmation) — otherwise a successful submit looks like it did nothing. The form submits
+     * and resets either way; it just stays on screen instead of being replaced.
+     */
+    showSuccessScreen?: boolean;
+    /** Fires after the entry is saved — navigate, track a conversion, reveal your own confirmation. */
+    onSuccess?: (result: ILevoFormSubmitResult) => void;
+    /**
+     * Fires when a submission fails. Field-level validation errors are already shown on the
+     * fields themselves; use this for page-level messaging or tracking, not to re-render errors.
+     */
+    onError?: (error: unknown) => void;
 }
 
 export declare interface ILevoFormResult {
@@ -653,6 +697,26 @@ export declare interface ILevoFormResult {
     };
 }
 
+/** What a successful submission produced. */
+export declare interface ILevoFormSubmitResult {
+    /** The collection the entry landed in. */
+    schemaId: string;
+    /** The created record, exactly as the API returned it. */
+    record: unknown;
+    /** Submission metadata (booking config, payment intent, …) when the collection emits any. */
+    meta?: unknown;
+}
+
+/** Success-screen copy + what happens after a submission. */
+export declare interface ILevoFormSuccessConfig {
+    title?: string;
+    message?: string;
+    action?: {
+        type: "none" | "submit_another" | "redirect";
+        value?: string;
+    };
+}
+
 /**
  * The bridge between the collection form renderer's color contract and the generated site's
  * semantic theme tokens. Shared by every form the runtime renders — the page's `<LevoForm>`,
@@ -687,6 +751,9 @@ export declare interface ILevoFormTheme {
     gap?: string;
 }
 
+/** How the form lays its fields out. */
+export declare type ILevoFormVariant = "default" | "single-field" | "steps" | "steps-2";
+
 export declare interface ILevoLoginActions {
     /**
      * Send a verification code. `identifier` is the email address (medium `"email"`) or the
@@ -835,6 +902,15 @@ export declare interface ILevoRecordConfig {
     module: ILevoSourceModule;
     /** What the module's `identifier` names — see {@link ILevoSourceModule}. Round-tripped; the event single endpoint is flat (slug only). */
     identifier: string;
+    /**
+     * Route param this binding's slug comes from — `"slug"` on `/blog/$slug`, `"events"` on
+     * `/legal-events/$events`. Every generated record binding carries it: it is the mapping a
+     * multi-param route needs, since with two variable segments nothing else in the file says
+     * which binding fills which slot. Round-tripped through the editor binding like the rest.
+     *
+     * Optional only for the pages written before it existed — see {@link recordSlug}.
+     */
+    param?: string;
     /**
      * Reserved for field projection. The slug endpoints return the whole record today, so
      * this is round-tripped through the binding but not yet sent to the API.
@@ -851,6 +927,45 @@ export declare interface ILevoRecordResult<T = Record<string, unknown>> {
     };
 }
 
+/** What the platform's search index knows a result to be. */
+export declare type ILevoSearchKind = "page" | "collection" | "blog" | "event" | "community";
+
+/** One hit. `url` is ready to link to — the index stores the visitor-facing path. */
+export declare interface ILevoSearchResult {
+    content_type: ILevoSearchKind;
+    content_id: string;
+    title: string | null;
+    /** A short snippet. May contain HTML from a rich-text body — render it as TEXT. */
+    description: string | null;
+    url: string;
+    thumbnail: IMediaObject | null;
+    /** Relevance, 0–1. Results arrive sorted, so this is only worth showing if you want to. */
+    score: number;
+}
+
+export declare interface ILevoSearchState {
+    /** The live input value — bind straight to the field. */
+    query: string;
+    setQuery: (value: string) => void;
+    /** Hits for the settled query. Empty until one has been searched. */
+    results: ILevoSearchResult[];
+    /** A request is in flight. Previous results stay on screen while it is, so nothing flickers. */
+    isLoading: boolean;
+    /** Human-readable failure, or null. */
+    error: string | null;
+    /** The query was searched and came back with nothing — the "no results" case, specifically. */
+    isEmpty: boolean;
+    /** The query is long enough to search (2+ characters, the server's own floor). */
+    isSearchable: boolean;
+    /** Clear the query, the results, and the error. */
+    reset: () => void;
+    /** Dialog open state, and ⌘K if `hotkey` is on. Ignore it for an on-page search. */
+    isOpen: boolean;
+    setOpen: (open: boolean) => void;
+    open: () => void;
+    close: () => void;
+}
+
 /** Site-level Levo config — the scaffold shim fills this from Vite env. */
 export declare interface ILevoSiteConfig {
     /** Origin of the Levo public API / proxy the site's data calls go through. */
@@ -1530,6 +1645,18 @@ export declare interface IUseLevoOtpInputParams {
     disabled?: boolean;
 }
 
+export declare interface IUseLevoSearchOptions {
+    /** Max results per request (server caps at 50). Default 20. */
+    limit?: number;
+    /** Milliseconds of typing quiet before a request goes out. Default 300. */
+    debounceMs?: number;
+    /**
+     * Bind ⌘K / Ctrl+K to toggle `isOpen`. Default true — turn it off for a search that lives
+     * ON the page (a /search route) rather than in a dialog.
+     */
+    hotkey?: boolean;
+}
+
 /** Every method a page may list in `options.methods`. */
 export declare const LEVO_AUTH_METHODS: ILevoAuthMethod[];
 
@@ -1609,6 +1736,11 @@ export declare const LevoEventRegister: ({ eventID, title, external, buttonText,
  * (from its SSR-prefetched schema) and submits entries into that collection. The AI drops it
  * in and never rebuilds the form engine.
  *
+ * `source` alone is a finished form: it collects, validates, submits, handles spam, and shows
+ * a thank-you screen with nothing else wired up. The props below the divider exist for the
+ * minority of forms that are a step in a flow rather than the end of one — a value prefilled
+ * from the route, a redirect on submit, a confirmation the page renders itself.
+ *
  * Colors follow the site theme (`src/styles/theme.css`) by default, so a form matches the
  * brand out of the box; `theme` overrides per form. `CollectionFormRenderer` resolves its
  * client via `@levo-so/react`'s `useLevo()` — the same context `LevoSiteProvider` mounts at
@@ -1659,6 +1791,20 @@ export declare const LevoProfileForm: React.FC<ILevoProfileFormProps>;
  */
 export declare const LevoSiteProvider: React.FC<{
     site?: ISiteJson;
+    /**
+     * Send analytics. Pass `import.meta.env.PROD` from the site's own shim: a preview is the
+     * dev server and a published site is a built bundle, so that flag is the only thing that
+     * can tell them apart — this package is built ONCE as a library, long before either
+     * exists, so it cannot read its own `import.meta.env` and get an answer about the site.
+     *
+     * False does NOT tear analytics out. Trackers and identity still run with zero network
+     * (see below), because popup triggers and every other store-only consumer wait on
+     * `$isIdentityContextReady`, and a preview with dead popups is a worse preview.
+     *
+     * Defaults to true: a site whose shim predates this prop keeps the behaviour it shipped
+     * with, rather than silently losing analytics in production.
+     */
+    analytics?: boolean;
     children: React.ReactNode;
 }>;
 
@@ -1794,7 +1940,7 @@ export declare const prefetchLevoSources: ({ queryClient, config, sources, param
     config: ILevoSiteConfig | undefined;
     /** The page's `dataSources` export (undefined = page has none). */
     sources: ILevoDataSources | undefined;
-    /** Route params; record bindings read `params.slug`. */
+    /** Route params; each record binding reads the one its `param` names, else the sole segment. */
     params?: Record<string, string>;
 }) => Promise<Record<string, unknown>>;
 
@@ -1952,6 +2098,26 @@ export declare const useLevoOtpInput: ({ value, onChange, length, onComplete, au
  */
 export declare const useLevoRecord: <T = Record<string, unknown>>(config: ILevoRecordConfig, slug: string | undefined) => ILevoRecordResult<T>;
 
+/**
+ * Site-wide search — everything except the look.
+ *
+ * ```tsx
+ * const search = useLevoSearch();
+ * <input value={search.query} onChange={(e) => search.setQuery(e.target.value)} />
+ * {search.results.map((hit) => <a href={hit.url} key={hit.content_id}>{hit.title}</a>)}
+ * ```
+ *
+ * What it searches is the platform's index of this SITE: blog posts, collection records,
+ * events and forum posts in full, and pages by title and description. A v3 page's body copy
+ * lives in its route file, which the indexer never reads — so a page is found by what its
+ * meta says it is, not by a phrase buried in its markup.
+ *
+ * Client-only and self-throttling: nothing is requested during SSR, below two characters, or
+ * on a site with no backend. Results are cached per query, so re-opening the dialog and
+ * retyping the same thing costs nothing.
+ */
+export declare const useLevoSearch: (options?: IUseLevoSearchOptions) => ILevoSearchState;
+
 /**
  * The site's Levo client, or `null` when the site isn't wired to a Levo backend yet
  * (no `api_url` in `site.json` — e.g. not stamped at provision). Consumers no-op on null.