@getquick/content 0.1.0 → 0.2.0

package/README.md

@@ -2,8 +2,8 @@
 
 The configured content runtime for WordPress HTML and WPGraphQL. This slice
 provides pure helpers, the configured WordPress client, durable delivery and
-installed SQL migrations, and event/refresh HTTP handlers. This is not a
-completed or published 0.1.0 release pair.
+installed SQL migrations, and event/refresh HTTP handlers. It is released as a
+pair with the Composer package `getquick/gq-content`, at the same version and tag.
 
 ```ts
 import { renderWordPressBlocks, htmlLang } from "@getquick/content";
@@ -37,8 +37,8 @@ manual redirects and an eight-second deadline; failed reads return unavailable,
 confirmed absence returns missing, and successful reads return found.
 
 The root entry contains pure helpers and public structural types. The server
-entry exports `createContentRuntime`, `ContentConfig`, `ContentBindings`,
-`ContentRuntime` and `WordPressClient`. Runtime properties contain languages,
+entry exports `createContentRuntime`, `ContentConfig`, `ContentExtension`,
+`ExtensionNode`, `ContentBindings`, `ContentRuntime` and `WordPressClient`. Runtime properties contain languages,
 routing functions and the WordPress methods; credentials/configuration are kept
 in closures. Language configuration retains the source's normalization policy,
 and routing returns the same language objects held in that instance's array.
@@ -62,7 +62,8 @@ untracked. The npm tarball allowlist contains only compiled output, the five ori
 separate consent database migrations and package metadata (npm also includes this README).
 
 The public delivery methods are `publishedHome(siteOrigin?, language?)`,
-`publishedEntry(path, siteOrigin?)` and `pageChrome(siteOrigin?)`. Supply a
+`publishedEntry(path, siteOrigin?)`, `pageChrome(siteOrigin?)` and
+`designPresets()`. Supply a
 `PUBLICATION_DB` structural binding to serve durable publications. Stored reads
 need no event or refresh secret and retain last-known-good content without an
 age limit. Cold entry lookups read the CMS once, preserving missing versus
@@ -72,6 +73,42 @@ Production without a store returns unavailable (chrome returns null). Only
 activates that fallback. All public reads guard server context before bindings
 or transport.
 
+`designPresets()` returns the stored design presets for a page that isn't a
+publication (live only in explicit development, null otherwise), and
+`internalOrigins(siteOrigin?)` the origins `menuItemHref` treats as this Site's.
+`blockPresetStyles(spacing, colors, scope?)` scopes the preset classes to a
+container (`.prose-wp` by default); `presetRootStyle(spacing, colors)` declares
+the presets on `:root`.
+
+## A Site's own content
+
+A Site whose WordPress plugin adds fields to its pages and posts declares them
+as an `extension`. The runtime reads them with each front page, page and post
+(with its blocks), stores the Site's value with the publication and serves it,
+typed, through outages:
+
+```ts
+const content = createContentRuntime<SiteBlocks>({
+  // …the configuration above…
+  extension: {
+    fields: { page: "wpBlocksJson pageBackgroundColor", post: "wpBlocksJson" },
+    // The Site's value for a node WordPress returned, or undefined for none.
+    read: ({ kind, fields }) => siteBlocks(fields.wpBlocksJson, fields.pageBackgroundColor),
+    // The stored value (JSON) read back, or undefined when it can't be served.
+    parse: (stored) => storedSiteBlocks.safeParse(stored).data,
+  },
+});
+const page = await content.publishedEntry("/about/");
+if (page.kind === "found" && page.content.entry.extension) {
+  // Render page.content.entry.extension (SiteBlocks); the front page's is
+  // home.page.extension.
+}
+```
+
+Rows stored before the Site declared it serve without it; a refresh stores it.
+A read throwing fails as WordPress's answer not matching the schema, and a read
+without its blocks stores nothing, so the stored page stays served. See ADR 0004.
+
 Infrastructure imports the Node-only migration entry separately:
 
 ```ts

package/dist/consent-astro.js

@@ -1,6 +1,6 @@
 import { S as SERVICE_CATALOG, T as copyLanguage, c as grantedCategories, d as promptReason, f as readConsentCookie, x as OPTIONAL_CATEGORIES } from "./state-BYWc5TUB.js";
 import { a as CONSENT_COPY, c as legalRevisions, r as escapeHtml } from "./embeds-p9SyGNZI.js";
-import { t as CONSENT_UI_VERSION } from "./version-Dn6VLZJO.js";
+import { t as CONSENT_UI_VERSION } from "./version-DyyNhsuU.js";
 import { t as CONSENT_CONFIG_ID } from "./client-config-B3LNSOxl.js";
 import { t as CONSENT_PATH } from "./paths-Cmzzof3v.js";
 //#region frontend/src/consent/astro.ts

package/dist/consent.js

@@ -1,5 +1,5 @@
 import { C as SERVICE_IDS, D as hostMatches, E as embedService, O as hostService, S as SERVICE_CATALOG, T as copyLanguage, _ as consentConfiguration, a as consentCookie, b as COPY_LANGUAGES, c as grantedCategories, d as promptReason, f as readConsentCookie, g as MEASUREMENT_ID, h as CONSENT_COPY_REVISION, i as DECISION_VALIDITY_MS, k as isServiceId, l as isConsentId, m as serviceGranted, n as CONSENT_COOKIE, o as decide, p as serializeConsentState, r as CONSENT_COOKIE_MAX_AGE_SECONDS, s as denyAll, t as CONSENT_ACTIONS, u as parseConsentState, v as needsBanner, w as catalogService, x as OPTIONAL_CATEGORIES, y as CONSENT_CATEGORIES } from "./state-BYWc5TUB.js";
 import { a as parseConsentRecordRequest, i as isRecordToken, n as consentRecordRequest, r as isLegalRoleName, t as MAX_RECORD_BYTES } from "./records-Dumrz759.js";
 import { a as CONSENT_COPY, c as legalRevisions, i as rewriteEmbeds, l as parseLegalLanguage, n as embedPlaceholder, o as LEGAL_ROLES, r as escapeHtml, s as REQUIRED_LEGAL_ROLES, t as blockedPlaceholder } from "./embeds-p9SyGNZI.js";
-import { t as CONSENT_UI_VERSION } from "./version-Dn6VLZJO.js";
+import { t as CONSENT_UI_VERSION } from "./version-DyyNhsuU.js";
 export { CONSENT_ACTIONS, CONSENT_CATEGORIES, CONSENT_COOKIE, CONSENT_COOKIE_MAX_AGE_SECONDS, CONSENT_COPY, CONSENT_COPY_REVISION, CONSENT_UI_VERSION, COPY_LANGUAGES, DECISION_VALIDITY_MS, LEGAL_ROLES, MAX_RECORD_BYTES, MEASUREMENT_ID, OPTIONAL_CATEGORIES, REQUIRED_LEGAL_ROLES, SERVICE_CATALOG, SERVICE_IDS, blockedPlaceholder, catalogService, consentConfiguration, consentCookie, consentRecordRequest, copyLanguage, decide, denyAll, embedPlaceholder, embedService, escapeHtml, grantedCategories, hostMatches, hostService, isConsentId, isLegalRoleName, isRecordToken, isServiceId, legalRevisions, needsBanner, parseConsentRecordRequest, parseConsentState, parseLegalLanguage, promptReason, readConsentCookie, rewriteEmbeds, serializeConsentState, serviceGranted };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { A as Unavailable, B as routeLanguage, C as EntryContent, D as PublishedEntry, E as Missing, F as SiteLanguage, I as WordPressLanguages, L as htmlLang, M as WordPressMenuItem, N as WordPressPost, O as SiteChrome, P as WordPressSettings, R as isLanguageHome, S as DesignPresets, T as HomeContent, V as siteLanguages, _ as SqlDatabase, b as CmsFailureReason, c as EntryDelivery, d as HomeDelivery, f as HomePage, g as ContentBindings, h as NotServed, i as ContentRuntime, j as WordPressImage, k as Translation, l as EntryPage, m as Moved, n as ContentConfig, o as Alternate, p as HomePublication, r as ContentConsentConfig, s as DeliveryFailureReason, t as WordPressClient, u as EntryPublication, v as SqlStatement, w as Found, x as Delivery, y as CmsFailure, z as languageSubject } from "./wordpress-CPL40-vq.js";
+import { A as PublishedEntry, B as htmlLang, C as Delivery, D as Found, E as Extended, F as WordPressMenuItem, H as languageSubject, I as WordPressPost, L as WordPressSettings, M as Translation, N as Unavailable, O as HomeContent, P as WordPressImage, R as SiteLanguage, S as CmsFailureReason, T as EntryContent, U as routeLanguage, V as isLanguageHome, W as siteLanguages, _ as NotServed, a as ContentRuntime, b as SqlStatement, c as Alternate, d as EntryPage, f as EntryPublication, g as Moved, h as HomePublication, i as ContentExtension, j as SiteChrome, k as Missing, l as DeliveryFailureReason, m as HomePage, n as ContentConfig, o as ExtensionNode, p as HomeDelivery, r as ContentConsentConfig, t as WordPressClient, u as EntryDelivery, v as ContentBindings, w as DesignPresets, x as CmsFailure, y as SqlDatabase, z as WordPressLanguages } from "./wordpress-CUFb6YZZ.js";
 //#region frontend/src/wp-block-styles.d.ts
 export interface Preset {
   slug: string;
@@ -13,8 +13,19 @@ export interface BlockPresetStyles {
   vars: Record<string, string>;
   colorRules: string;
 }
-/** WordPress preset classes need the CMS palette as well as CSS variables. */
-export declare function blockPresetStyles(spacingSizes: SpacingPreset[], colors: ColorPreset[]): BlockPresetStyles;
+/**
+ * WordPress preset classes need the CMS palette as well as CSS variables.
+ * `scope` is the content's container (`.prose-wp` by default; another for
+ * content a Site renders itself).
+ */
+export declare function blockPresetStyles(spacingSizes: SpacingPreset[], colors: ColorPreset[], scope?: string): BlockPresetStyles;
+/**
+ * The design presets as WordPress defines them, on `:root`, for styles that
+ * read the palette and spacing from these variables outside the content's
+ * container. Presets with an invalid slug, or a value that could end the
+ * rule, are left out; "" without any.
+ */
+export declare function presetRootStyle(spacingSizes: SpacingPreset[], colors: ColorPreset[]): string;
 //#endregion
 //#region frontend/src/wp-block-renderer.d.ts
 export interface WordPressBlock {
@@ -61,4 +72,4 @@ export declare function stripHtml(value: string): string;
 export declare function formatDate(value: string, lang?: string): string;
 export declare function routeOf(path: string): string;
 //#endregion
-export { Alternate, CmsFailure, CmsFailureReason, ContentBindings, type ContentConfig, type ContentConsentConfig, type ContentRuntime, Delivery, DeliveryFailureReason, DesignPresets, EntryContent, EntryDelivery, EntryPage, EntryPublication, Found, HomeContent, HomeDelivery, HomePage, HomePublication, Missing, Moved, NotServed, PublishedEntry, SiteChrome, SiteLanguage, SqlDatabase, SqlStatement, Translation, Unavailable, type WordPressClient, WordPressImage, WordPressLanguages, WordPressMenuItem, WordPressPost, WordPressSettings, htmlLang, isLanguageHome, languageSubject, routeLanguage, siteLanguages };
+export { Alternate, CmsFailure, CmsFailureReason, ContentBindings, type ContentConfig, type ContentConsentConfig, type ContentExtension, type ContentRuntime, Delivery, DeliveryFailureReason, DesignPresets, EntryContent, EntryDelivery, EntryPage, EntryPublication, Extended, type ExtensionNode, Found, HomeContent, HomeDelivery, HomePage, HomePublication, Missing, Moved, NotServed, PublishedEntry, SiteChrome, SiteLanguage, SqlDatabase, SqlStatement, Translation, Unavailable, type WordPressClient, WordPressImage, WordPressLanguages, WordPressMenuItem, WordPressPost, WordPressSettings, htmlLang, isLanguageHome, languageSubject, routeLanguage, siteLanguages };

package/dist/index.js

@@ -1,20 +1,39 @@
 import { _ as youtubeVideoId, a as routeOf, c as htmlLang, d as routeLanguage, f as siteLanguages, g as renderWordPressBlocks, h as parseWordPressBlocks, i as responseStatus, l as isLanguageHome, m as hasVideoHero, n as formatDate, o as stripHtml, p as VIDEO_HERO_BLOCK, r as menuItemHref, s as uriPath, t as cmsTime, u as languageSubject, v as containerChildLayoutHtml, y as containerLayoutHtml } from "./formatting-wOk2jz6J.js";
 //#region frontend/src/wp-block-styles.ts
 const validSlug = (slug) => /^[a-z0-9][a-z0-9-]*$/.test(slug);
-/** WordPress preset classes need the CMS palette as well as CSS variables. */
-function blockPresetStyles(spacingSizes, colors) {
+/** A CSS value safe inside a stylesheet: a color or length, nothing that ends a rule. */
+const safeValue = (value) => /^[#(),.%\w\s-]+$/.test(value);
+/** A selector for the content's container: classes, ids, elements and descendants. */
+const validScope = (scope) => /^[.#]?[A-Za-z][\w-]*(?:[ .#>][A-Za-z][\w-]*)*$/.test(scope);
+/**
+* WordPress preset classes need the CMS palette as well as CSS variables.
+* `scope` is the content's container (`.prose-wp` by default; another for
+* content a Site renders itself).
+*/
+function blockPresetStyles(spacingSizes, colors, scope = ".prose-wp") {
+	if (!validScope(scope)) throw new Error(`${JSON.stringify(scope)} isn't a container selector`);
 	const vars = {};
 	const colorRules = [];
 	for (const { slug, size } of spacingSizes) if (validSlug(slug)) vars[`--wp--preset--spacing--${slug}`] = size;
 	for (const { slug, color } of colors) {
 		if (!validSlug(slug)) continue;
 		vars[`--wp--preset--color--${slug}`] = color;
-		colorRules.push(`.prose-wp .has-${slug}-color{color:var(--wp--preset--color--${slug})}`, `.prose-wp .has-${slug}-background-color{background-color:var(--wp--preset--color--${slug})}`, `.prose-wp .has-${slug}-color.has-link-color a{color:var(--wp--preset--color--${slug})}`);
+		colorRules.push(`${scope} .has-${slug}-color{color:var(--wp--preset--color--${slug})}`, `${scope} .has-${slug}-background-color{background-color:var(--wp--preset--color--${slug})}`, `${scope} .has-${slug}-color.has-link-color a{color:var(--wp--preset--color--${slug})}`);
 	}
 	return {
 		vars,
 		colorRules: colorRules.join("\n")
 	};
 }
+/**
+* The design presets as WordPress defines them, on `:root`, for styles that
+* read the palette and spacing from these variables outside the content's
+* container. Presets with an invalid slug, or a value that could end the
+* rule, are left out; "" without any.
+*/
+function presetRootStyle(spacingSizes, colors) {
+	const declarations = [...spacingSizes.filter(({ slug, size }) => validSlug(slug) && safeValue(size)).map(({ slug, size }) => `--wp--preset--spacing--${slug}:${size}`), ...colors.filter(({ slug, color }) => validSlug(slug) && safeValue(color)).map(({ slug, color }) => `--wp--preset--color--${slug}:${color}`)];
+	return declarations.length ? `:root{${declarations.join(";")}}` : "";
+}
 //#endregion
-export { VIDEO_HERO_BLOCK, blockPresetStyles, cmsTime, containerChildLayoutHtml, containerLayoutHtml, formatDate, hasVideoHero, htmlLang, isLanguageHome, languageSubject, menuItemHref, parseWordPressBlocks, renderWordPressBlocks, responseStatus, routeLanguage, routeOf, siteLanguages, stripHtml, uriPath, youtubeVideoId };
+export { VIDEO_HERO_BLOCK, blockPresetStyles, cmsTime, containerChildLayoutHtml, containerLayoutHtml, formatDate, hasVideoHero, htmlLang, isLanguageHome, languageSubject, menuItemHref, parseWordPressBlocks, presetRootStyle, renderWordPressBlocks, responseStatus, routeLanguage, routeOf, siteLanguages, stripHtml, uriPath, youtubeVideoId };

package/dist/server.d.ts

@@ -1,2 +1,2 @@
-import { a as createContentRuntime, g as ContentBindings, i as ContentRuntime, n as ContentConfig, r as ContentConsentConfig, t as WordPressClient } from "./wordpress-CPL40-vq.js";
-export { type ContentBindings, ContentConfig, ContentConsentConfig, ContentRuntime, type WordPressClient, createContentRuntime };
+import { a as ContentRuntime, i as ContentExtension, n as ContentConfig, o as ExtensionNode, r as ContentConsentConfig, s as createContentRuntime, t as WordPressClient, v as ContentBindings } from "./wordpress-CUFb6YZZ.js";
+export { type ContentBindings, ContentConfig, ContentConsentConfig, ContentExtension, ContentRuntime, ExtensionNode, type WordPressClient, createContentRuntime };

package/dist/server.js

@@ -3550,6 +3550,7 @@ ZodOptional.create;
 ZodNullable.create;
 ZodEffects.createWithPreprocess;
 ZodPipeline.create;
+const NEVER = INVALID;
 /** The store couldn't be read or written. Says nothing about the content. */
 var StoreFailure = class extends Error {};
 const eventOf = (row) => ({
@@ -4743,6 +4744,29 @@ function configuredDelivery(config, languages, wordpress, transformHtml) {
 		slug: stringType(),
 		color: stringType()
 	}));
+	/**
+	* The Site's extension of a page or post, as its `parse` reads it back. A
+	* row stored without one (before the Site declared it) still serves; an
+	* extension stored without the Site declaring one now is left out.
+	*/
+	const extension = config.extension;
+	const extended = extension ? { extension: unknownType().optional().transform((value, context) => {
+		if (value === void 0) return void 0;
+		let parsed;
+		try {
+			parsed = extension.parse(value);
+		} catch {
+			parsed = void 0;
+		}
+		if (parsed === void 0) {
+			context.addIssue({
+				code: "custom",
+				message: "the Site can't serve this extension"
+			});
+			return NEVER;
+		}
+		return parsed;
+	}) } : {};
 	const homePublication = objectType({
 		settings: objectType({
 			title: stringType(),
@@ -4751,7 +4775,8 @@ function configuredDelivery(config, languages, wordpress, transformHtml) {
 		page: objectType({
 			title: stringType(),
 			content: stringType(),
-			hasVideoHero: booleanType()
+			hasVideoHero: booleanType(),
+			...extended
 		}),
 		spacingSizes,
 		colors
@@ -4772,7 +4797,8 @@ function configuredDelivery(config, languages, wordpress, transformHtml) {
 		featuredImage: image,
 		hasVideoHero: booleanType(),
 		spacingSizes,
-		colors
+		colors,
+		...extended
 	});
 	const legalRole = objectType({
 		role: stringType(),
@@ -5126,6 +5152,27 @@ function configuredDelivery(config, languages, wordpress, transformHtml) {
 		}
 	}
 	/**
+	* The design presets for a page that isn't a publication: the stored ones
+	* when there is a store, else a live read in explicit development. Null
+	* when neither has them; the page is then served without them.
+	*/
+	async function pageDesign() {
+		if (!config.isServer()) return null;
+		const store = await boundStore();
+		if (!store) {
+			if (!config.development) return null;
+			const design = await getDesignPresets();
+			return design.kind === "found" ? design.content : null;
+		}
+		try {
+			return sharedDesign(await store.read(DESIGN, parseDesign));
+		} catch (error) {
+			if (!(error instanceof StoreFailure)) throw error;
+			console.error(`Delivery: the design presets can't be served (store): ${error.message}`);
+			return null;
+		}
+	}
+	/**
 	* Refreshes the whole Site, the explicit preparation of its store: each
 	* language's front page and chrome, the shared design presets, and every
 	* entry WordPress lists as published or the store already holds (so one
@@ -5599,14 +5646,28 @@ function configuredDelivery(config, languages, wordpress, transformHtml) {
 		isAuthorized,
 		publishedHome: (siteOrigin, language) => safely(async () => html.home(await publishedHome(siteOrigin, language), language), () => notServed("the front page", "store", "The publication store couldn't be loaded")),
 		publishedEntry: (path, siteOrigin) => safely(async () => html.entry(await publishedEntry(path, siteOrigin), routeLanguage$1(routeOf(path))), () => notServed("the entry", "store", "The publication store couldn't be loaded")),
-		pageChrome: (siteOrigin) => safely(() => pageChrome(siteOrigin), () => null)
+		pageChrome: (siteOrigin) => safely(() => pageChrome(siteOrigin), () => null),
+		designPresets: () => safely(() => pageDesign(), () => null)
 	};
 }
 //#endregion
 //#region frontend/src/wordpress.ts
+/** The origins a link into this Site may use: WordPress's, and the Frontend's when given. */
+function internalOrigins(config, siteOrigin) {
+	return [new URL(config.graphqlEndpoint).origin, ...siteOrigin ? [siteOrigin] : []];
+}
 function configuredWordPress(config, languages) {
 	const defaultLanguage = languages[0];
 	const multilingual = languages.length > 1;
+	const extension = config.extension;
+	/**
+	* The Site's extension fields on a kind of node, read with the blocks (left
+	* out with them when WordPress fails on them).
+	*/
+	const extensionFields = (kind) => {
+		const fields = extension?.fields[kind]?.trim();
+		return fields ? `\n... @include(if: $withBlocks) {\n${fields}\n}` : "";
+	};
 	const image = objectType({
 		sourceUrl: stringType(),
 		altText: stringType().nullable()
@@ -5634,7 +5695,7 @@ function configuredWordPress(config, languages) {
 			title: stringType().nullable(),
 			content: stringType().nullable(),
 			blocks: unknownType().optional()
-		}), objectType({ __typename: stringType().refine((typename) => typename !== "Page") })]).nullable(),
+		}).passthrough(), objectType({ __typename: stringType().refine((typename) => typename !== "Page") })]).nullable(),
 		designTokens
 	});
 	const pageEntry = objectType({
@@ -5647,7 +5708,7 @@ function configuredWordPress(config, languages) {
 		modifiedGmt: stringType().nullable().optional(),
 		featuredImage: imageEdge,
 		blocks: unknownType().optional()
-	});
+	}).passthrough();
 	const postEntry = pageEntry.extend({
 		excerpt: stringType().nullable(),
 		date: stringType().nullable()
@@ -5745,7 +5806,7 @@ function configuredWordPress(config, languages) {
           content
           blocks(attributes: true, htmlContent: true, dynamicContent: true, postTemplate: false)
             @include(if: $withBlocks)
-          isFrontPage
+          isFrontPage${extensionFields("page")}
         }
       }
       designTokens {
@@ -5774,7 +5835,7 @@ function configuredWordPress(config, languages) {
           content
           blocks(attributes: true, htmlContent: true, dynamicContent: true, postTemplate: false)
             @include(if: $withBlocks)
-          isFrontPage
+          isFrontPage${extensionFields("page")}
         }
       }
       designTokens {
@@ -5860,7 +5921,7 @@ function configuredWordPress(config, languages) {
           sourceUrl
           altText
         }
-      }
+      }${extensionFields("post")}
     }
     pageBy(uri: $uri) {
       id
@@ -5877,7 +5938,7 @@ function configuredWordPress(config, languages) {
           sourceUrl
           altText
         }
-      }
+      }${extensionFields("page")}
     }
   }
 `;
@@ -5946,6 +6007,27 @@ function configuredWordPress(config, languages) {
 	function describeIssues(error) {
 		return error.issues.map((issue) => `${issue.path.join(".") || "data"}: ${issue.message}`).join("; ");
 	}
+	/**
+	* `{ extension }` with the Site's value for a node WordPress returned, or
+	* nothing: without an extension, fields for its kind, or a value, and when
+	* the blocks (and with them the fields) were left out.
+	*/
+	function extended(kind, node, blocksOmitted) {
+		if (!extension || !extensionFields(kind) || blocksOmitted) return {};
+		let value;
+		try {
+			value = extension.read({
+				kind,
+				fields: node
+			});
+		} catch (error) {
+			throw new CmsFailureError({
+				reason: "schema",
+				message: `WordPress's ${kind} doesn't match the Site's extension: ${error instanceof Error ? error.message : String(error)}`
+			}, { cause: error });
+		}
+		return value === void 0 ? {} : { extension: value };
+	}
 	async function query(schema, queryText, variables) {
 		let response;
 		let credentials = [];
@@ -6105,7 +6187,8 @@ function configuredWordPress(config, languages) {
 					page: {
 						title: node.title ?? "",
 						content: containsVideoHero ? renderWordPressBlocks(blocks) : node.content ?? "",
-						hasVideoHero: containsVideoHero
+						hasVideoHero: containsVideoHero,
+						...extended("page", node, blocksOmitted)
 					},
 					blocksOmitted,
 					spacingSizes: data.designTokens.spacingSizes,
@@ -6137,7 +6220,8 @@ function configuredWordPress(config, languages) {
 					modifiedAt: cmsTime(post.modifiedGmt),
 					spacingSizes: data.designTokens.spacingSizes,
 					colors: data.designTokens.colors,
-					...multilingual ? languageOf(post) : {}
+					...multilingual ? languageOf(post) : {},
+					...extended(data.postBy ? "post" : "page", post, blocksOmitted)
 				}
 			};
 		});
@@ -6265,7 +6349,7 @@ function configuredWordPress(config, languages) {
 				location,
 				language: language.code
 			}), config.consent?.cmsSettings ? consentSettings(language) : null]);
-			const origins = [new URL(config.graphqlEndpoint).origin, ...siteOrigin ? [siteOrigin] : []];
+			const origins = internalOrigins(config, siteOrigin);
 			return {
 				kind: "found",
 				content: {
@@ -6297,6 +6381,7 @@ function configuredWordPress(config, languages) {
 function createContentRuntime(input) {
 	const site = input.site.trim();
 	if (!site) throw new Error("A nonempty Site identity is required");
+	for (const [kind, fields] of Object.entries(input.extension?.fields ?? {})) if (fields !== void 0 && !fields.trim()) throw new Error(`The extension's ${kind} fields are empty; leave them out instead`);
 	const config = {
 		...input,
 		site,
@@ -6353,6 +6438,18 @@ function createContentRuntime(input) {
 		publishedEntry: delivery.publishedEntry,
 		pageChrome: delivery.pageChrome,
 		/**
+		* The design presets every page shares (GQ Design's spacing sizes and
+		* colors), for a page that isn't a publication: the stored ones when there
+		* is a store, else (in explicit development) a live read. Null when
+		* neither has them.
+		*/
+		designPresets: delivery.designPresets,
+		/**
+		* The origins a link into this Site may use: WordPress's, and the
+		* Frontend's when given. `menuItemHref` turns links at them into paths.
+		*/
+		internalOrigins: (siteOrigin) => internalOrigins(config, siteOrigin),
+		/**
 		* The Site's consent configuration for a page served with this chrome:
 		* declared services, GA4 when gq-config's toggle is on, and the
 		* controller from the Legal Contract. Null when consent isn't configured.

package/dist/{version-Dn6VLZJO.js → version-DyyNhsuU.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.1.0`;
+const CONSENT_UI_VERSION = `gq-content@0.2.0`;
 //#endregion
 export { CONSENT_UI_VERSION as t };

package/dist/{wordpress-CPL40-vq.d.ts → wordpress-CUFb6YZZ.d.ts}

@@ -47,7 +47,7 @@ declare function languageSubject(language: SiteLanguage, what: string): string;
 /** Whether a route is a language's home (/, /en/): served as a home, never as an entry. */
 declare function isLanguageHome(route: string, among: readonly SiteLanguage[]): boolean;
 declare namespace content_types_d_exports {
-  export { CmsFailure, CmsFailureReason, Delivery, DesignPresets, EntryContent, Found, HomeContent, Missing, PublishedEntry, SiteChrome, Translation, Unavailable, WordPressImage, WordPressMenuItem, WordPressPost, WordPressSettings };
+  export { CmsFailure, CmsFailureReason, Delivery, DesignPresets, EntryContent, Extended, Found, HomeContent, Missing, PublishedEntry, SiteChrome, Translation, Unavailable, WordPressImage, WordPressMenuItem, WordPressPost, WordPressSettings };
 }
 interface WordPressImage {
   sourceUrl: string;
@@ -84,7 +84,15 @@ interface DesignPresets {
     color: string;
   }>;
 }
-interface HomeContent extends DesignPresets {
+/**
+ * A page or post's own content as the Site's extension read it
+ * (ContentConfig's `extension`): present only when the Site declares one and
+ * its read returned a value for that page or post.
+ */
+interface Extended<X = unknown> {
+  extension?: X;
+}
+interface HomeContent<X = unknown> extends DesignPresets {
   /** The front page's WordPress entry (WPGraphQL's global id), if WordPress gave it. */
   nodeId: string | null;
   settings: WordPressSettings;
@@ -92,7 +100,7 @@ interface HomeContent extends DesignPresets {
     title: string;
     content: string;
     hasVideoHero: boolean;
-  };
+  } & Extended<X>;
   /** WordPress failed on the blocks, so this is the page without them. */
   blocksOmitted: boolean;
 }
@@ -101,7 +109,7 @@ interface Translation {
   uri: string;
   language: string;
 }
-interface EntryContent extends WordPressPost, DesignPresets {
+interface EntryContent<X = unknown> extends WordPressPost, DesignPresets, Extended<X> {
   /** Its language's slug, on a multilingual Site. */
   language?: string;
   /** Its published translations into the site's other languages, on a multilingual Site. */
@@ -192,9 +200,9 @@ interface ContentBindings {
 //#endregion
 //#region frontend/src/page-types.d.ts
 /** The front page as stored: what WordPress delivered, without read details. */
-type HomePublication = Omit<HomeContent, "blocksOmitted" | "nodeId">;
+type HomePublication<X = unknown> = Omit<HomeContent<X>, "blocksOmitted" | "nodeId">;
 /** A published page or post as stored, with the design presets it was read with. */
-type EntryPublication = Omit<EntryContent, "blocksOmitted" | "modifiedAt">;
+type EntryPublication<X = unknown> = Omit<EntryContent<X>, "blocksOmitted" | "modifiedAt">;
 /**
  * A page in another language that a visitor of this one may switch to: its
  * published translation (`translation`), or else that language's home.
@@ -204,14 +212,14 @@ interface Alternate {
   route: string;
   translation: boolean;
 }
-interface HomePage {
-  home: HomePublication;
+interface HomePage<X = unknown> {
+  home: HomePublication<X>;
   chrome: SiteChrome;
   /** The other languages' homes that are served; none on a monolingual Site. */
   alternates: Alternate[];
 }
-interface EntryPage {
-  entry: EntryPublication;
+interface EntryPage<X = unknown> {
+  entry: EntryPublication<X>;
   chrome: SiteChrome;
   /** Where its readers may switch language; none on a monolingual Site. */
   alternates: Alternate[];
@@ -234,15 +242,15 @@ interface NotServed {
     message: string;
   };
 }
-type HomeDelivery = Found<HomePage> | (Missing & {
+type HomeDelivery<X = unknown> = Found<HomePage<X>> | (Missing & {
   chrome: SiteChrome | null;
 }) | NotServed;
-type EntryDelivery = Found<EntryPage> | (Missing & {
+type EntryDelivery<X = unknown> = Found<EntryPage<X>> | (Missing & {
   chrome: SiteChrome | null;
 }) | Moved | NotServed;
 //#endregion
 //#region frontend/src/server.d.ts
-interface ContentConfig {
+interface ContentConfig<X = never> {
   site: string;
   graphqlEndpoint: string;
   cmsOrigin: string;
@@ -258,6 +266,52 @@ interface ContentConfig {
    * delivery; absent, bodies are delivered as published.
    */
   consent?: ContentConsentConfig;
+  /**
+   * 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
+   * the publication and served as its `extension`.
+   */
+  extension?: ContentExtension<X>;
+}
+/**
+ * A Site's own content on its pages and posts, beyond what the runtime reads:
+ * fields a plugin adds to WPGraphQL (a block tree, a page setting), read with
+ * every front page, page and post, stored with it, and served with it through
+ * outages, as the rest of it is.
+ */
+interface ContentExtension<X> {
+  /**
+   * GraphQL selections added to each kind of node the runtime reads: `page`
+   * to front pages and pages, `post` to posts (e.g. `wpBlocksJson`). They are
+   * read with the blocks: a read WordPress can only complete without its
+   * blocks leaves them out too, and isn't stored. A kind without fields has
+   * no extension.
+   */
+  fields: {
+    page?: string;
+    post?: string;
+  };
+  /**
+   * The Site's value for a node WordPress returned (its fields, the runtime's
+   * among them), or undefined when it has none (`extension` is then left
+   * out). It is stored as JSON, so it must survive JSON. Throwing fails the
+   * read as WordPress answering with the wrong schema: what is stored stays
+   * served.
+   */
+  read(node: ExtensionNode): X | undefined;
+  /**
+   * The value read back from the store, or from a read about to be stored
+   * (JSON), or undefined when the Site can't serve it. A stored row whose
+   * extension doesn't parse is unusable, as any body that doesn't; one stored
+   * without an extension (before the Site declared it) still serves, without.
+   * Return a valid value as it is: reconciliation compares it with new reads.
+   */
+  parse(stored: unknown): X | undefined;
+}
+/** A front page, page or post as WordPress returned it, for a Site's extension. */
+interface ExtensionNode {
+  kind: "page" | "post";
+  fields: Readonly<Record<string, unknown>>;
 }
 interface ContentConsentConfig {
   /** The catalog services the Site declares in code (e.g. "youtube", "google_maps"). */
@@ -274,22 +328,34 @@ interface ContentConsentConfig {
    */
   cmsSettings?: boolean;
 }
-declare function createContentRuntime(input: ContentConfig): {
+declare function createContentRuntime<X = never>(input: ContentConfig<X>): {
   languages: SiteLanguage[];
   defaultLanguage: SiteLanguage;
   multilingual: boolean;
   routeLanguage: (route: string) => SiteLanguage;
   isLanguageHome: (route: string) => boolean;
-  wordpress: WordPressClient;
+  wordpress: WordPressClient<X>;
   handleEvent: (request: Request, context?: {
     siteOrigin?: string;
   }) => Promise<Response>;
   handleRefresh: (request: Request, context?: {
     siteOrigin?: string;
   }) => Promise<Response>;
-  publishedHome: (siteOrigin?: string, language?: SiteLanguage) => Promise<HomeDelivery>;
-  publishedEntry: (path: string, siteOrigin?: string) => Promise<EntryDelivery>;
+  publishedHome: (siteOrigin?: string, language?: SiteLanguage) => Promise<HomeDelivery<X>>;
+  publishedEntry: (path: string, siteOrigin?: string) => Promise<EntryDelivery<X>>;
   pageChrome: (siteOrigin?: string) => Promise<SiteChrome | null>;
+  /**
+   * The design presets every page shares (GQ Design's spacing sizes and
+   * colors), for a page that isn't a publication: the stored ones when there
+   * is a store, else (in explicit development) a live read. Null when
+   * neither has them.
+   */
+  designPresets: () => Promise<DesignPresets | null>;
+  /**
+   * The origins a link into this Site may use: WordPress's, and the
+   * Frontend's when given. `menuItemHref` turns links at them into paths.
+   */
+  internalOrigins: (siteOrigin?: string) => string[];
   /**
    * The Site's consent configuration for a page served with this chrome:
    * declared services, GA4 when gq-config's toggle is on, and the
@@ -297,12 +363,12 @@ declare function createContentRuntime(input: ContentConfig): {
    */
   consentConfiguration: (chrome?: SiteChrome | null) => ConsentConfiguration | null;
 };
-type ContentRuntime = ReturnType<typeof createContentRuntime>;
+type ContentRuntime<X = never> = ReturnType<typeof createContentRuntime<X>>;
 //#endregion
 //#region frontend/src/wordpress.d.ts
-interface WordPressClient {
-  getHomeContent(this: void, language?: SiteLanguage): Promise<Delivery<HomeContent>>;
-  getEntryByUri(this: void, uri: string): Promise<Delivery<EntryContent>>;
+interface WordPressClient<X = unknown> {
+  getHomeContent(this: void, language?: SiteLanguage): Promise<Delivery<HomeContent<X>>>;
+  getEntryByUri(this: void, uri: string): Promise<Delivery<EntryContent<X>>>;
   getDesignPresets(this: void): Promise<Found<DesignPresets> | Unavailable>;
   getPublishedEntries(this: void): Promise<Found<{
     entries: PublishedEntry[];
@@ -315,4 +381,4 @@ interface WordPressClient {
   }): Promise<Found<SiteChrome> | Unavailable>;
 }
 //#endregion
-export { Unavailable as A, routeLanguage as B, EntryContent as C, PublishedEntry as D, Missing as E, SiteLanguage as F, WordPressLanguages as I, htmlLang as L, WordPressMenuItem as M, WordPressPost as N, SiteChrome as O, WordPressSettings as P, isLanguageHome as R, DesignPresets as S, HomeContent as T, siteLanguages as V, SqlDatabase as _, createContentRuntime as a, CmsFailureReason as b, EntryDelivery as c, HomeDelivery as d, HomePage as f, ContentBindings as g, NotServed as h, ContentRuntime as i, WordPressImage as j, Translation as k, EntryPage as l, Moved as m, ContentConfig as n, Alternate as o, HomePublication as p, ContentConsentConfig as r, DeliveryFailureReason as s, WordPressClient as t, EntryPublication as u, SqlStatement as v, Found as w, Delivery as x, CmsFailure as y, languageSubject as z };
+export { PublishedEntry as A, htmlLang as B, Delivery as C, Found as D, Extended as E, WordPressMenuItem as F, languageSubject as H, WordPressPost as I, WordPressSettings as L, Translation as M, Unavailable as N, HomeContent as O, WordPressImage as P, SiteLanguage as R, CmsFailureReason as S, EntryContent as T, routeLanguage as U, isLanguageHome as V, siteLanguages as W, NotServed as _, ContentRuntime as a, SqlStatement as b, Alternate as c, EntryPage as d, EntryPublication as f, Moved as g, HomePublication as h, ContentExtension as i, SiteChrome as j, Missing as k, DeliveryFailureReason as l, HomePage as m, ContentConfig as n, ExtensionNode as o, HomeDelivery as p, ContentConsentConfig as r, createContentRuntime as s, WordPressClient as t, EntryDelivery as u, ContentBindings as v, DesignPresets as w, CmsFailure as x, SqlDatabase as y, WordPressLanguages as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getquick/content",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "UNLICENSED",
   "files": [
     "dist",