@getquick/content 0.3.1 → 0.4.0

package/dist/state-CsMFLUUO.d.ts

@@ -0,0 +1,66 @@
+//#region frontend/src/forms/copy.d.ts
+type FormsCopyLanguage = "en" | "pt-PT";
+type FormErrorCode = "required" | "email" | "email-mismatch" | "number" | "range" | "url" | "choice" | "too-long";
+interface FormsCopy {
+  required: string;
+  requiredFields: string;
+  errorSummary: string;
+  errors: Record<FormErrorCode, string>;
+  /** The submission was refused before reaching the CMS, or the CMS failed. */
+  failed: string;
+  /** Turnstile failed or was missing. */
+  verification: string;
+  /** A submission arrived too fast or too often. */
+  tooMany: string;
+  sent: string;
+  unavailable: string;
+  submit: string;
+  privacyPolicy: string;
+  /** Visible to assistive technology only, on the honeypot (Gravity Forms' wording). */
+  honeypot: string;
+  /** With Turnstile and no JavaScript. */
+  needsJavaScript: string;
+}
+declare const FORMS_COPY: Record<FormsCopyLanguage, FormsCopy>;
+/** The copy language for a page's `lang`: Portuguese for `pt*`, else English. */
+declare function formsCopyLanguage(language: string | null | undefined): FormsCopyLanguage;
+//#endregion
+//#region frontend/src/forms/state.d.ts
+type FormStatus = "sent" | "invalid" | "failed" | "verification" | "too-many";
+interface FormState {
+  formId: number;
+  status: FormStatus;
+  /** Field errors by field id: the descriptor check's codes. */
+  errors: Record<number, FormErrorCode>;
+  /** Gravity Forms' own messages by field id, when it refused the submission. */
+  messages: Record<number, string>;
+  /** What the visitor typed, by input name (left out when too large to keep). */
+  values: Record<string, string>;
+  /** Gravity Forms' confirmation message as text, after a submission it accepted. */
+  confirmation?: string;
+}
+/** The query parameter that marks the redirect back after a post. */
+declare const FORM_STATE_PARAM = "gq-form";
+/** Seconds the outcome is kept for the page after the redirect. */
+declare const FORM_STATE_MAX_AGE = 300;
+declare const formStateCookieName: (formId: number) => string;
+/** The Set-Cookie header that carries a form's outcome to the page. */
+declare function formStateCookie(state: FormState, options: {
+  secure: boolean;
+}): string;
+/** The Set-Cookie header that removes a form's outcome once the page has shown it. */
+declare function clearFormStateCookie(formId: number, options: {
+  secure: boolean;
+}): string;
+/**
+ * A form's outcome for the page: present only on the redirect back after a
+ * post to it (`?gq-form=<id>`), from its cookie. Null otherwise.
+ */
+declare function readFormState(request: {
+  url: string | URL;
+  cookie: string | null | undefined;
+}, formId: number): FormState | null;
+/** Where the handler sends the visitor back to: the page, marked for the form. */
+declare function formStateLocation(source: string, formId: number): string;
+//#endregion
+export { clearFormStateCookie as a, formStateLocation as c, FormErrorCode as d, FormsCopy as f, FormStatus as i, readFormState as l, formsCopyLanguage as m, FORM_STATE_PARAM as n, formStateCookie as o, FormsCopyLanguage as p, FormState as r, formStateCookieName as s, FORM_STATE_MAX_AGE as t, FORMS_COPY as u };

package/dist/validate-wRgYUNxN.js

@@ -0,0 +1,130 @@
+//#region frontend/src/forms/validate.ts
+/** No single value is longer (characters). */
+const MAX_VALUE_LENGTH = 1e4;
+const EMAIL = /^[^\s@<>()[\]\\,;:"]+@[^\s@<>()[\]\\,;:"]+\.[^\s@<>()[\]\\,;:"]+$/;
+function webAddress(value) {
+	try {
+		const url = new URL(value);
+		return (url.protocol === "https:" || url.protocol === "http:") && url.hostname.includes(".");
+	} catch {
+		return false;
+	}
+}
+/**
+* A number as visitors type it in either convention (1234.5, 1,234.5, 1.234,5,
+* 1 234,5): the last separator is the decimal one when both appear. NaN when
+* it isn't one; Gravity Forms checks its own number format again.
+*/
+function parseNumber(value) {
+	let text = value.replace(/[\s\u00a0']/g, "");
+	const dot = text.lastIndexOf(".");
+	const comma = text.lastIndexOf(",");
+	if (dot >= 0 && comma >= 0) text = dot > comma ? text.replaceAll(",", "") : text.replaceAll(".", "").replace(",", ".");
+	else if (comma >= 0) text = text.indexOf(",") === comma ? text.replace(",", ".") : text.replaceAll(",", "");
+	else if ((text.match(/\./g) ?? []).length > 1) text = text.replaceAll(".", "");
+	return /^-?\d+(\.\d+)?$/.test(text) ? Number(text) : NaN;
+}
+/** A posted value, without surrounding whitespace, bounded. */
+function read(values, name) {
+	return (values.get(name) ?? "").trim().slice(0, MAX_VALUE_LENGTH);
+}
+function check(field, values, input, shown) {
+	const take = (name) => {
+		const value = read(values, name);
+		input[name] = value;
+		if (field.visibility === "visible" && field.type !== "hidden") shown[name] = value;
+		return value;
+	};
+	const first = field.inputs[0];
+	switch (field.type) {
+		case "html":
+		case "section": return null;
+		case "hidden": {
+			if (!first) return null;
+			const value = values.get(first.name) === null ? field.defaultValue ?? "" : take(first.name);
+			input[first.name] = value;
+			return null;
+		}
+		case "checkbox": {
+			const chosen = field.inputs.filter((each) => {
+				const value = read(values, each.name);
+				if (value === "") return false;
+				input[each.name] = value;
+				shown[each.name] = value;
+				return true;
+			});
+			if (chosen.some((each) => read(values, each.name) !== each.value)) return "choice";
+			return field.required && chosen.length === 0 ? "required" : null;
+		}
+		case "consent": {
+			if (!first) return null;
+			const checked = read(values, first.name) === "1";
+			if (field.required && !checked) return "required";
+			if (checked) {
+				input[first.name] = "1";
+				shown[first.name] = "1";
+				const [, label, revision] = field.inputs;
+				if (label) input[label.name] = field.consent?.checkboxLabel ?? "";
+				if (revision) input[revision.name] = field.consent?.revisionId ?? "";
+			}
+			return null;
+		}
+		case "name": {
+			const given = field.inputs.map((each) => ({
+				each,
+				value: take(each.name)
+			}));
+			if (!field.required) return null;
+			const essential = given.filter(({ each }) => given.length === 1 || /\.(3|6)$/.test(each.id));
+			return (essential.length ? essential : given).some(({ value }) => value === "") ? "required" : null;
+		}
+		default: {
+			if (!first) return null;
+			const value = take(first.name);
+			if (value === "") {
+				if (field.type === "email" && field.inputs[1]) take(field.inputs[1].name);
+				return field.required ? "required" : null;
+			}
+			if (field.maxLength !== void 0 && Array.from(value).length > field.maxLength) return "too-long";
+			if (field.type === "email") {
+				if (!EMAIL.test(value)) return "email";
+				const confirmation = field.inputs[1];
+				if (confirmation && take(confirmation.name) !== value) return "email-mismatch";
+			}
+			if (field.type === "website" && !webAddress(value)) return "url";
+			if (field.type === "number") {
+				const number = parseNumber(value);
+				if (!Number.isFinite(number)) return "number";
+				if (field.range?.min !== void 0 && number < field.range.min || field.range?.max !== void 0 && number > field.range.max) return "range";
+			}
+			if ((field.type === "select" || field.type === "radio") && !(field.choices ?? []).some((choice) => choice.value === value)) return "choice";
+			return null;
+		}
+	}
+}
+/**
+* Checks a submission against the descriptor: required fields, formats,
+* choices and lengths. Only the descriptor's inputs are kept; the honeypot is
+* passed through, empty, for Gravity Forms' own check.
+*/
+function validateSubmission(descriptor, values) {
+	const input = {};
+	const shown = {};
+	const errors = {};
+	for (const field of descriptor.fields) {
+		const error = check(field, values, input, shown);
+		if (error) errors[field.id] = error;
+	}
+	if (descriptor.honeypot) input[descriptor.honeypot.name] = "";
+	return {
+		input,
+		errors,
+		values: shown
+	};
+}
+/** Whether the honeypot was filled in: a bot. Such a submission never reaches the CMS. */
+function honeypotFilled(descriptor, values) {
+	return descriptor.honeypot !== null && (values.get(descriptor.honeypot.name) ?? "") !== "";
+}
+//#endregion
+export { honeypotFilled as n, validateSubmission as r, MAX_VALUE_LENGTH as t };

package/dist/{version-ChwS3fUu.js → version-D81MsCZU.js}

@@ -1,6 +1,6 @@
 //#endregion
 //#region frontend/src/consent/version.ts
 /** The UI/adapter version recorded with each decision (CN-R7). */
-const CONSENT_UI_VERSION = `gq-content@0.3.1`;
+const CONSENT_UI_VERSION = `gq-content@0.4.0`;
 //#endregion
 export { CONSENT_UI_VERSION as t };

package/dist/video-hero-D8AcMR4q.js

@@ -0,0 +1,69 @@
+/** Object-fit geometry for a 16:9 YouTube frame in the actual authored media box.
+* Adapters must size the iframe itself; object-fit cannot crop its document.
+* The intrinsic frame size matches the player's 560 × 315 embedding dimensions.
+*/
+function videoHeroFrameGeometry(box, fit = "cover", position = {
+	x: .5,
+	y: .5
+}) {
+	const contain = Math.min(box.width / 560, box.height / 315);
+	const scale = fit === "cover" ? Math.max(box.width / 560, box.height / 315) : fit === "contain" ? contain : fit === "scale-down" ? Math.min(1, contain) : 1;
+	const width = fit === "fill" ? box.width : 560 * scale;
+	const height = fit === "fill" ? box.height : 315 * scale;
+	return {
+		width,
+		height,
+		left: (box.width - width) * position.x || 0,
+		top: (box.height - height) * position.y || 0
+	};
+}
+/** Canonical structural CSS for every Video Hero adapter; presentation stays in the shared model. */
+function videoHeroStyleSheet() {
+	return `.wp-block-getquick-design-video-hero {
+  position: relative;
+  display: grid;
+  box-sizing: border-box;
+  isolation: isolate;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media {
+  position: absolute;
+  z-index: 0;
+  overflow: hidden;
+  inset: 0;
+  background: inherit;
+  pointer-events: none;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media > .gqd-video-hero__video,
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media > .gqd-video-hero__poster {
+  position: absolute;
+  width: 100%;
+  height: 100%;
+  inset: 0;
+  object-fit: cover;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__media > iframe.gqd-video-hero__video {
+  inset: auto;
+  border: 0;
+}
+
+.wp-block-getquick-design-video-hero > .gqd-video-hero__content {
+  position: relative;
+  z-index: 1;
+  display: flex;
+  min-width: 0;
+  box-sizing: border-box;
+  flex-direction: column;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .wp-block-getquick-design-video-hero > .gqd-video-hero__media > .gqd-video-hero__video {
+    visibility: hidden;
+  }
+}
+`;
+}
+//#endregion
+export { videoHeroStyleSheet as n, videoHeroFrameGeometry as t };

package/dist/{wordpress-D_HG2rEt.d.ts → wordpress-BvkTDMA0.d.ts}

@@ -1,5 +1,232 @@
 import { r as ConsentConfiguration, t as AnalyticsSettings } from "./configuration-C_JGygQI.js";
 import { r as LegalLanguage } from "./legal-C5Xiq59W.js";
+import { o as FormDescriptor } from "./descriptor-B-e7gHi1.js";
+//#endregion
+//#region frontend/src/design-text.d.ts
+/** Already loaded, authorized values. No lookup, fetching or query selection.
+ * Site title and description are plain text, as returned by WP settings. */
+interface DesignTextContext {
+  site?: {
+    title?: string;
+    description?: string;
+    url?: string;
+  };
+  post?: {
+    uri?: string;
+    /** Caller selects/formats the requested date using the block's format,
+     * date source and Site timezone; this adapter never guesses them. */
+    date?: {
+      text: string;
+      dateTime: string;
+    };
+    /** Supplied inline rich text, not a generated/truncated post body. */
+    excerpt?: string;
+  };
+}
+/** Restore source-only native text. Saved, producer-sanitized shells stay with
+ * the caller; childrenHtml contains HTML already rendered by that same caller.
+ * undefined means this adapter cannot supply the block, never placeholder text.
+ * Presentation validation and all styling belong to the shared renderer. */
+declare function renderDesignText(name: string, attributes: Record<string, unknown>, childrenHtml?: string, context?: DesignTextContext): string | undefined;
+/** Small shared source-rich-text boundary; also suitable for Image captions.
+ * Rebuild parsed HTML, preserving safe inline formatting without executable
+ * attributes, embedded documents, foreign namespaces or source CSS. */
+declare function safeDesignRichText(value: string): string;
+//#endregion
+//#region frontend/src/design-query.d.ts
+/** Authorized, synchronously preloaded content; supplied by the caller's data layer. */
+interface DesignPostContext {
+  id: number | string;
+  /** Plain text, escaped when rendered as a native Post Title. */
+  title: string;
+  blocks: DesignBlock[];
+  uri?: string;
+  featuredImage?: {
+    sourceUrl: string;
+    altText: string;
+  } | null;
+}
+/** A producer-selected identity, not permission to fetch an arbitrary post. */
+interface DesignQueryItem {
+  id: number | string;
+  type?: string;
+  slug?: string;
+  uri?: string;
+}
+interface DesignQueryResolverOptions {
+  /** Map lookup or other synchronous lookup of already authorized, loaded posts. */
+  resolvePost?: (item: DesignQueryItem) => DesignPostContext | null | undefined;
+}
+interface DesignQueryRenderContext extends DesignQueryResolverOptions {
+  post?: DesignPostContext;
+  /** Use the same renderer and Site overrides recursively, under this post context. */
+  render: (blocks: DesignBlock[], post?: DesignPostContext) => string;
+  /** Optional Site URL normalization, followed by the shared safe-link boundary. */
+  href?: (url: unknown) => string;
+}
+/** Repeat the delivered template once per delivered item, without selecting again.
+ * Returns undefined for other blocks. No Query or synced-pattern shell is added.
+ */
+declare function renderDesignQuery(block: DesignBlock, context: DesignQueryRenderContext): string | undefined;
+/** Native post-dependent blocks and already-resolved synced references.
+ * Call only after Site renderer overrides have had precedence.
+ */
+declare function renderDesignPostBlock(block: DesignBlock, context: DesignQueryRenderContext): string | undefined;
+/** Find identities already selected by producers, including resolved patterns.
+ * This never interprets query arguments or requests content. */
+declare function designQueryItems(pattern: {
+  blocks: DesignBlock[];
+} | DesignBlock[] | null | undefined): DesignQueryItem[];
+interface DesignPostRecord {
+  id: string | number;
+  databaseId?: number;
+  title: string;
+  uri: string;
+  designBlocks?: DesignBlock[];
+  featuredImage?: {
+    sourceUrl: string;
+    altText: string;
+  } | null;
+}
+/** Convert an existing authorized publication; absent neutral delivery is explicit. */
+declare function designPostContext(record: DesignPostRecord): DesignPostContext | null;
+interface DesignPreloadedPosts extends DesignQueryResolverOptions {
+  posts: ReadonlyMap<string, DesignPostContext>;
+  resolvePost: (item: DesignQueryItem) => DesignPostContext | null;
+}
+/** Preload producer-selected URIs through a caller's existing publication loader.
+ * Selection/order stay with the producer; nested contexts use the same boundary. */
+declare function preloadDesignQueryPosts(pattern: {
+  blocks: DesignBlock[];
+} | DesignBlock[] | null | undefined, load: (item: DesignQueryItem) => Promise<DesignPostRecord | null>): Promise<DesignPreloadedPosts>;
+//#endregion
+/** Neutral resolved dimensions; palette identities and dark governance stay in DesignTokens. */
+interface DesignTheme {
+  spacing: string;
+  breakpoints: Record<"sm" | "md" | "lg" | "xl" | "2xl", string>;
+  colors: Record<string, string>;
+  fontFamilies: Record<string, string>;
+  fontSizes: Record<string, string>;
+  fontSizeLineHeights: Record<string, string>;
+  fontWeights: Record<string, string>;
+  letterSpacings: Record<string, string>;
+  lineHeights: Record<string, string>;
+  radii: Record<string, string>;
+  maxWidths: Record<string, string>;
+}
+type DesignThemeOverrides = { [K in keyof DesignTheme]?: DesignTheme[K] extends string ? string : Partial<DesignTheme[K]>; };
+/** The same bounded override vocabulary PHP and JSON Schema validate. */
+declare function resolveDesignTheme(overrides?: unknown): DesignTheme;
+/** Complete theme declarations for every supported value, independent of CMS content scanning. */
+declare function designThemeVariables(overrides?: DesignThemeOverrides): Record<string, string>;
+/** Scoped Preflight; the Gutenberg canvas retains native and authored spacing. */
+declare function designThemeStyleSheet(overrides?: DesignThemeOverrides, scope?: string): string;
+/** Color/font extension for the shared presentation parser; never raw utility strings. */
+declare function resolvePresentationToken(kind: string, value: unknown): string | undefined;
+//#endregion
+type PresentationBreakpoint = "base" | "sm" | "md" | "lg" | "xl" | "2xl";
+interface PresentationModel {
+  baseline: string;
+  breakpoints: Record<PresentationBreakpoint, string | null>;
+  properties: Record<string, Property>;
+  capabilities: Record<string, string[]>;
+  targets?: Record<string, PresentationTargets>;
+  selectors?: Record<string, string>;
+  nativeSupports?: Record<string, string[][]>;
+  shorthands?: Record<string, string[]>;
+  defaultDisplay?: Record<string, string>;
+  variablesFrom?: Record<string, Record<string, {
+    path: string[];
+    values: Record<string, string>;
+    default?: string;
+  }>>;
+  defaults: Record<string, Record<string, string | number>>;
+  /**
+   * Frontend flow rhythm: listed blocks space themselves from a preceding
+   * sibling; layout blocks only from a preceding flow block in body content.
+   */
+  flow?: {
+    blocks: string[];
+    layout?: string[];
+    gap: string;
+  };
+}
+interface PresentationTargets {
+  selector?: string;
+  elements?: Record<string, string[]>;
+  properties?: Record<string, string>;
+  cssProperties?: Record<string, string[]>;
+  styles?: Record<string, Record<string, string>>;
+  conditionalStyles?: {
+    property: string;
+    target: string;
+    declarations: Record<string, string>;
+  }[];
+  /** Native structural baselines; authored presentation has higher priority. */
+  rules?: {
+    target: string;
+    important?: boolean;
+    declarations: Record<string, string>;
+    media?: {
+      minWidth?: string;
+      maxWidth?: string;
+    };
+  }[];
+}
+interface PresentationExtension {
+  /** Existing canonical properties only; extensions never define CSS values. */
+  properties: readonly string[];
+  /** A single wrapper class. Defaults to the conventional WordPress block class. */
+  selector?: string;
+  /** Optional descendant/child class paths, keyed by declared property. */
+  targets?: Readonly<Record<string, string>>;
+  /** Native wrapper mode restored by Display Auto/reset and editor hidden preview. */
+  defaultDisplay?: string;
+}
+type PresentationExtensions = Readonly<Record<string, PresentationExtension>>;
+/** Explicit Site additions reuse the canonical vocabulary without changing core capabilities. */
+declare function createPresentationModel(extensions?: PresentationExtensions): PresentationModel;
+/** One bounded catalog shared by controls, producers and Site adapters. */
+declare const presentationModel: PresentationModel;
+type Presentation = Partial<Record<PresentationBreakpoint, Record<string, string | number | {
+  x: number;
+  y: number;
+} | {
+  palette: string;
+} | {
+  theme: string;
+} | {
+  literal: string;
+}>>>;
+type PresentationTheme = DesignThemeOverrides;
+type Property = {
+  label: string;
+  valueType?: string;
+  scale?: string;
+  themeToken?: string;
+  valueSchema?: Record<string, unknown>;
+  cssProperty: string;
+  companionCssProperty?: string;
+  reset: string;
+  values: {
+    value: string | number;
+    css: string;
+    label: string;
+    editorCss?: string;
+    companionCss?: string;
+  }[];
+};
+/** Invalid or unsupported settings fail explicitly; omission never means Auto/reset. */
+declare function presentationVariables(name: string, presentation?: unknown, options?: {
+  editor?: boolean;
+  attributes?: Record<string, unknown>;
+  model?: PresentationModel;
+}): Record<string, string>;
+/** Static, complete CSS: content first authored after a production build still works. */
+declare function presentationStyleSheet(theme?: PresentationTheme, options?: {
+  model?: PresentationModel;
+  editor?: boolean;
+}): string;
 declare namespace content_types_d_exports {
   export { Archives, CmsFailure, CmsFailureReason, CollectionMembership, CollectionTerm, Delivery, DesignPresets, EntryContent, Extended, Found, HomeContent, Missing, PublishedEntry, SiteChrome, Translation, Unavailable, WordPressImage, WordPressMenuItem, WordPressPost, WordPressSettings };
 }
@@ -8,6 +235,13 @@ interface WordPressImage {
   altText: string;
 }
 interface WordPressPost {
+  databaseId?: number;
+  designBlocks?: DesignBlock[];
+  /**
+   * The public descriptors of the Gravity Forms forms it references, on a
+   * Site with `forms` (ADR 0009): what `gravityforms/form` blocks render.
+   */
+  forms?: FormDescriptor[];
   id: string;
   title: string;
   excerpt: string;
@@ -29,6 +263,8 @@ interface WordPressSettings {
   description: string;
 }
 interface DesignPresets {
+  /** Resolved CMS theme; absent in publications written before theme delivery. */
+  theme?: DesignTheme;
   spacingSizes: Array<{
     slug: string;
     size: string;
@@ -54,6 +290,10 @@ interface HomeContent<X = unknown> extends DesignPresets {
     title: string;
     content: string;
     hasVideoHero: boolean;
+    databaseId?: number;
+    designBlocks?: DesignBlock[];
+    /** Its Gravity Forms forms' descriptors, on a Site with `forms`. */
+    forms?: FormDescriptor[];
   } & Extended<X>;
   /** WordPress failed on the blocks, so this is the page without them. */
   blocksOmitted: boolean;
@@ -176,12 +416,16 @@ declare function parseDesignBlocks(value: unknown): DesignBlock[] | undefined;
 declare function escapeHtml(value: string): string;
 /** What a block renderer is given besides its block. */
 interface DesignRenderContext {
+  colorScheme?: "light" | "dark";
+  siteTitle?: string;
+  /** Current preloaded post when rendering a Query item or a post body. */
+  post?: DesignPostContext;
   /** The block's children, rendered in order by the same renderers (when read). */
   children: string;
   /** The blocks it is inside, outermost first. */
   ancestors: DesignBlock[];
   /** Renders other blocks (a subset of the children, say) by the same renderers. */
-  render(this: void, blocks: DesignBlock[]): string;
+  render(this: void, blocks: DesignBlock[], post?: DesignPostContext): string;
   /**
    * A link from CMS data as the Frontend serves it: one into this Site (the
    * CMS or the Site origin) becomes its path, another http(s) link stays
@@ -196,7 +440,17 @@ interface DesignRenderContext {
  * CMS supplied (`escapeHtml`) and pass links through `context.href`.
  */
 type DesignBlockRenderer = (block: DesignBlock, context: DesignRenderContext) => string;
-interface DesignRenderOptions {
+interface DesignRenderOptions extends DesignQueryResolverOptions {
+  /** Explicit surface scheme for the canonical Branding logo selection. */
+  colorScheme?: "light" | "dark";
+  /** Preloaded native Site text sources; no lookup occurs during rendering. */
+  textContext?: DesignTextContext;
+  /** Explicit Site-added capability model, shared with its stylesheet. */
+  presentationModel?: PresentationModel;
+  /** Gate generated media before composing already-delivered child HTML. */
+  mediaHtml?: (html: string) => string;
+  /** Preloaded context for native Post Title/Post Content outside a Query. */
+  post?: DesignPostContext;
   /**
    * The Site's renderers, by block name: its own blocks (such as
    * `getquick/header-navigation`), and any core block it renders itself.
@@ -414,6 +668,36 @@ type CollectionTermListing = {
   kind: "found";
   terms: CollectionTermCount[];
 } | NotServed;
+/** Search public content already delivered to this Site's publication store. */
+interface SearchQuery {
+  /** Text to find in titles, excerpts or bodies, ignoring case and accents. Blank finds nothing. */
+  search: string;
+  /** Page from 1; defaults to 1. URL strings are accepted. */
+  page?: number | string;
+  /** Results per page, 1–100; defaults to 12. URL strings are accepted. */
+  perPage?: number | string;
+  /** Configured language slug; defaults to the Site's default language. */
+  language?: string;
+}
+interface SearchItem {
+  /** Canonical path on this Site. */
+  uri: string;
+  /** Plain text, suitable for escaped text rendering. */
+  title: string;
+  /** Plain text excerpt, or a bounded body-text fallback. */
+  excerpt: string;
+  /** Configured language slug, including on monolingual Sites. */
+  language: string;
+}
+interface SearchPage {
+  items: SearchItem[];
+  total: number;
+  page: number;
+  perPage: number;
+  /** Zero when nothing matches. */
+  totalPages: number;
+}
+type SearchDelivery = Found<SearchPage> | NotServed;
 //#endregion
 //#region frontend/src/server.d.ts
 interface ContentConfig<X = never> {
@@ -438,6 +722,14 @@ interface ContentConfig<X = never> {
    * delivery; absent, bodies are delivered as published.
    */
   consent?: ContentConsentConfig;
+  /**
+   * Headless Gravity Forms (ADR 0009). True, each front page, page, post and
+   * item is read with the public descriptors of the forms it references
+   * (gq-content's CMS forms module, active with Gravity Forms), stored with it
+   * as `forms`, and `publishedForm` finds them for the form endpoint. Absent,
+   * reads and stored bodies are unchanged.
+   */
+  forms?: boolean;
   /**
    * The Site's own content on its pages and posts: GraphQL fields the runtime
    * reads with each of them, and the value the Site makes of them, stored with
@@ -537,6 +829,15 @@ declare function createContentRuntime<X = never>(input: ContentConfig<X>): {
   }) => Promise<Response>;
   publishedHome: (siteOrigin?: string, language?: SiteLanguage) => Promise<HomeDelivery<X>>;
   publishedEntry: (path: string, siteOrigin?: string) => Promise<EntryDelivery<X>>;
+  /**
+   * A Gravity Forms form's descriptor as published with the page at a path
+   * (the publication store's, as the page is served), for the form endpoint
+   * (`createFormsServer`'s `descriptor`). Null when the page isn't served,
+   * doesn't reference the form, or the Site doesn't opt in to `forms`.
+   */
+  publishedForm: (path: string, formId: number, siteOrigin?: string) => Promise<FormDescriptor | null>;
+  /** Site-wide text search over delivered public content; never reads WordPress. */
+  search: (query: SearchQuery) => Promise<SearchDelivery>;
   /**
    * A page of a collection's items, from the publication store alone (never
    * WordPress), newest first: those with the given terms and text, in the
@@ -562,6 +863,8 @@ declare function createContentRuntime<X = never>(input: ContentConfig<X>): {
    * `renderDesignPattern`), with links into the CMS or `siteOrigin` served
    * as this Site's paths.
    */
+  /** Preload selected standard Post/Page records through the existing store reader. */
+  preloadDesignQueryPosts: (pattern: DesignPattern | DesignBlock[] | null | undefined, siteOrigin?: string) => Promise<DesignPreloadedPosts>;
   renderDesignPattern: (pattern: DesignPattern | DesignBlock[] | null | undefined, options?: DesignRenderOptions & {
     siteOrigin?: string;
   }) => string;
@@ -603,4 +906,4 @@ interface WordPressClient<X = unknown> {
   }): Promise<Found<SiteChrome> | Unavailable>;
 }
 //#endregion
-export { Found as $, htmlLang as A, designMenuItems as B, Moved as C, SqlStatement as D, SqlDatabase as E, DesignBlock as F, CmsFailure as G, parseDesignBlocks as H, DesignBlockRenderer as I, CollectionTerm as J, CmsFailureReason as K, DesignPattern as L, languageSubject as M, routeLanguage as N, SiteLanguage as O, siteLanguages as P, Extended as Q, DesignRenderContext as R, HomePublication as S, ContentBindings as T, renderDesignPattern as U, escapeHtml as V, Archives as W, DesignPresets as X, Delivery as Y, EntryContent as Z, EntryDelivery as _, ContentExtension as a, Unavailable as at, HomeDelivery as b, createContentRuntime as c, WordPressPost as ct, CollectionListing as d, HomeContent as et, CollectionPage as f, DeliveryFailureReason as g, CollectionTermListing as h, ContentConsentConfig as i, Translation as it, isLanguageHome as j, WordPressLanguages as k, Alternate as l, WordPressSettings as lt, CollectionTermCount as m, CollectionConfig as n, PublishedEntry as nt, ContentRuntime as o, WordPressImage as ot, CollectionQuery as p, CollectionMembership as q, ContentConfig as r, SiteChrome as rt, ExtensionNode as s, WordPressMenuItem as st, WordPressClient as t, Missing as tt, CollectionItem as u, EntryPage as v, NotServed as w, HomePage as x, EntryPublication as y, DesignRenderOptions as z };
+export { Delivery as $, SqlDatabase as A, DesignPostContext as At, DesignBlockRenderer as B, renderDesignQuery as Bt, Moved as C, presentationVariables as Ct, SearchPage as D, designThemeVariables as Dt, SearchItem as E, designThemeStyleSheet as Et, isLanguageHome as F, DesignQueryResolverOptions as Ft, escapeHtml as G, DesignRenderContext as H, renderDesignText as Ht, languageSubject as I, designPostContext as It, Archives as J, parseDesignBlocks as K, routeLanguage as L, designQueryItems as Lt, SiteLanguage as M, DesignPreloadedPosts as Mt, WordPressLanguages as N, DesignQueryItem as Nt, SearchQuery as O, resolveDesignTheme as Ot, htmlLang as P, DesignQueryRenderContext as Pt, CollectionTerm as Q, siteLanguages as R, preloadDesignQueryPosts as Rt, HomePublication as S, presentationStyleSheet as St, SearchDelivery as T, DesignThemeOverrides as Tt, DesignRenderOptions as U, safeDesignRichText as Ut, DesignPattern as V, DesignTextContext as Vt, designMenuItems as W, CmsFailureReason as X, CmsFailure as Y, CollectionMembership as Z, EntryDelivery as _, PresentationTargets as _t, ContentExtension as a, Missing as at, HomeDelivery as b, createPresentationModel as bt, createContentRuntime as c, Translation as ct, CollectionListing as d, WordPressMenuItem as dt, DesignPresets as et, CollectionPage as f, WordPressPost as ft, DeliveryFailureReason as g, PresentationModel as gt, CollectionTermListing as h, PresentationBreakpoint as ht, ContentConsentConfig as i, HomeContent as it, SqlStatement as j, DesignPostRecord as jt, ContentBindings as k, resolvePresentationToken as kt, Alternate as l, Unavailable as lt, CollectionTermCount as m, Presentation as mt, CollectionConfig as n, Extended as nt, ContentRuntime as o, PublishedEntry as ot, CollectionQuery as p, WordPressSettings as pt, renderDesignPattern as q, ContentConfig as r, Found as rt, ExtensionNode as s, SiteChrome as st, WordPressClient as t, EntryContent as tt, CollectionItem as u, WordPressImage as ut, EntryPage as v, PresentationTheme as vt, NotServed as w, DesignTheme as wt, HomePage as x, presentationModel as xt, EntryPublication as y, Property as yt, DesignBlock as z, renderDesignPostBlock as zt };