@bison-lab/payload-core 3.7.0 → 3.8.0

package/README.md

@@ -13,10 +13,12 @@ pnpm add @bison-lab/payload-core @payloadcms/plugin-seo @bison-lab/tokens @bison
 
 Peers: `payload` and `@payloadcms/plugin-seo` are required. `@bison-lab/tokens`
 and `@bison-lab/fonts` are needed to adopt the Theme Global; `@payloadcms/ui`
-and `react` are needed for its admin fields. Pin the plugin to the same
-version as `payload`; Payload releases them in lockstep.
+and `react` are needed for its admin fields; `@bison-lab/ui` and
+`@payloadcms/live-preview-react` are needed for the live theme preview.
+Pin the plugin to the same version as `payload`; Payload releases them in
+lockstep.
 
-## Four entry points, and why
+## Five entry points, and why
 
 | Import                             | Contents                                                                                         | Runs where                                                                 |
 | ---------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------- |
@@ -24,6 +26,7 @@ version as `payload`; Payload releases them in lockstep.
 | `@bison-lab/payload-core/metadata` | `pageMetadata`, the title helpers, the same types                                                | Server. What a page route imports; it does not load the plugin.            |
 | `@bison-lab/payload-core/theme`    | `getPublishedTheme`, `themeConfigFromDoc`, `themeHead`                                           | Server. What a root layout imports; it does not load the plugin or React.  |
 | `@bison-lab/payload-core/admin`    | `ColorField`, `FontField`, `ContrastReport`                                                      | Admin. Referenced by import-map string; `generate:importmap` writes it.    |
+| `@bison-lab/payload-core/react`    | `ThemePreview`                                                                                   | Client. What the theme-preview route imports; it loads ui and live-preview. |
 
 ## What editors get
 
@@ -143,6 +146,7 @@ export default buildConfig({
     createTheme({
       access: { read: isAuthenticated, update: canManageBrand },
       seed: bisonConfig,
+      previewPath: "/theme-preview",
       logo: { collection: "brand-assets" },
       onPublish: async () => {
         revalidateTag("theme");
@@ -192,6 +196,37 @@ If the admin layout renders the same head, the admin panel restyles too.
 `getPublishedTheme` reads `draft: false` and falls back to the seed when
 nothing has been published. A newer draft never reaches the public site.
 
+**5. Own the preview route.** The path is code-owned (in the site's
+`ENDPOINTS`), never a nav link, never in the sitemap, reserved from CMS
+slugs, and gated to an authenticated user. It renders `ThemePreview` with
+no site chrome. `createTheme({ previewPath })` points Payload's live-preview
+pane at that path; omit `previewPath` and the pane stays closed.
+
+```ts
+// app/theme-preview/page.tsx
+import { ThemePreview } from "@bison-lab/payload-core/react";
+import { getPublishedTheme } from "@bison-lab/payload-core/theme";
+import bisonConfig from "../../../bison.config.json";
+
+const theme = await getPublishedTheme(payload, bisonConfig);
+
+return (
+  <ThemePreview
+    theme={theme}
+    seed={bisonConfig}
+    fontsBaseUrl="/fonts"
+    serverURL={absoluteSiteUrl}
+  />
+);
+```
+
+`ThemePreview` rebuilds the stylesheet in the browser from each live-preview
+message. A half-typed hex keeps the last complete theme so the iframe does
+not go blank. The light / dark toggle sets `data-theme` on the preview root,
+not the document. Pages that later grow a live-preview pane should import
+`THEME_PREVIEW_BREAKPOINTS` from `@bison-lab/payload-core` so the toolbars
+match.
+
 ## No generated types
 
 The package cannot import a site's `payload-types`, so the shapes it reads

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { a as SeoImageSize, i as SeoImageDoc, n as titleTemplate, o as SeoImageValue, r as MediaId, s as SeoMeta, t as documentTitle } from "./title-B2-gWQZd.mjs";
-import { i as ThemeDoc, n as EditableTheme, r as THEME_SLUG, s as ThemeUploadDoc, t as CreateThemeOptions } from "./types-B3FC9sdF.mjs";
+import { i as ThemeDoc, n as EditableTheme, r as THEME_SLUG, s as ThemeUploadDoc, t as CreateThemeOptions } from "./types-pFpmDeSA.mjs";
 import { ThemeConfig } from "@bison-lab/tokens";
 import { CheckboxField, CollectionSlug, GlobalConfig, Plugin, UploadCollectionSlug } from "payload";
 
@@ -111,7 +111,7 @@ declare function truncateAtWord(text: string, max?: number): string;
  * (`canManageBrand` for update). Drafts autosave; the public site reads
  * the published version through `getPublishedTheme`.
  *
- * `previewPath` is stored for BIS-61, which wires the live preview pane.
+ * `previewPath` wires `admin.livePreview` when the site has a route.
  */
 declare function createTheme(options: CreateThemeOptions): GlobalConfig;
 //#endregion
@@ -129,10 +129,32 @@ interface SeedThemePayload {
  */
 declare function seedTheme(payload: SeedThemePayload, seed: ThemeConfig): Promise<unknown>;
 //#endregion
+//#region src/theme/preview.d.ts
+/**
+ * Device sizes the Theme (and, later, Pages) live-preview toolbar offers.
+ * One list so the panes match.
+ */
+declare const THEME_PREVIEW_BREAKPOINTS: readonly [{
+  readonly label: "Mobile";
+  readonly name: "mobile";
+  readonly width: 375;
+  readonly height: 667;
+}, {
+  readonly label: "Tablet";
+  readonly name: "tablet";
+  readonly width: 768;
+  readonly height: 1024;
+}, {
+  readonly label: "Desktop";
+  readonly name: "desktop";
+  readonly width: 1440;
+  readonly height: 900;
+}];
+//#endregion
 //#region src/theme/fields.d.ts
 declare const THEME_COLOR_FIELD = "@bison-lab/payload-core/admin#ColorField";
 declare const THEME_FONT_FIELD = "@bison-lab/payload-core/admin#FontField";
 declare const THEME_CONTRAST_REPORT = "@bison-lab/payload-core/admin#ContrastReport";
 //#endregion
-export { type CreateThemeOptions, DESCRIPTION_LENGTH, type EditableTheme, type MediaId, SHARE_IMAGE_SIZE, type SeoDoc, type SeoImageDoc, type SeoImageSize, type SeoImageValue, type SeoMeta, type SeoPluginOptions, THEME_COLOR_FIELD, THEME_CONTRAST_REPORT, THEME_FONT_FIELD, THEME_SLUG, type ThemeDoc, type ThemeUploadDoc, createTheme, documentTitle, firstImageIn, noIndexField, seedTheme, seoPlugin, titleTemplate, truncateAtWord };
+export { type CreateThemeOptions, DESCRIPTION_LENGTH, type EditableTheme, type MediaId, SHARE_IMAGE_SIZE, type SeoDoc, type SeoImageDoc, type SeoImageSize, type SeoImageValue, type SeoMeta, type SeoPluginOptions, THEME_COLOR_FIELD, THEME_CONTRAST_REPORT, THEME_FONT_FIELD, THEME_PREVIEW_BREAKPOINTS, THEME_SLUG, type ThemeDoc, type ThemeUploadDoc, createTheme, documentTitle, firstImageIn, noIndexField, seedTheme, seoPlugin, titleTemplate, truncateAtWord };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/seo/plugin.ts","../src/seo/fields.ts","../src/seo/share-image.ts","../src/seo/text.ts","../src/theme/global.ts","../src/theme/seed.ts","../src/theme/fields.ts"],"mappings":";;;;;;;;;;AAoBA;;UAAiB,MAAA;EACf,KAAA;AAAA;AAAA,UAGe,gBAAA,cAA8B,MAAA,GAAS,MAAA;EAAvB;EAE/B,QAAA;EAF6C;;;;;;EAS7C,MAAA,GAAS,GAAA,EAAK,IAAA;EAiBM;;;;;EAXpB,YAAA,IAAgB,GAAA,EAAK,IAAA;EAbrB;;;;;;EAoBA,QAAA,IAAY,GAAA,EAAK,IAAA,KAAS,OAAA;EAA1B;EAEA,WAAA,GAAc,cAAA;EAFF;EAIZ,iBAAA,GAAoB,oBAAA;AAAA;;;;;;AAetB;;;;;;;iBAAgB,SAAA,cAAuB,MAAA,GAAS,MAAA,CAAA,CAAA;EAC9C,QAAA;EACA,MAAA;EACA,YAAA;EACA,QAAA;EACA,WAAA;EACA;AAAA,GACC,gBAAA,CAAiB,IAAA,IAAQ,MAAA;;;;;;;iBA6BZ,YAAA,CACd,MAAA,WACA,KAAA,YACC,OAAA;;;;;;;;cCjGU,YAAA,EAAc,aAAA;;;;;;;;;ADa3B;;cEVa,gBAAA;;;;;;;;;cCTA,kBAAA;;;;;AHmBb;;iBGXgB,cAAA,CAAe,IAAA,UAAc,GAAA;;;;;;;AHW7C;;;;iBIqEgB,WAAA,CAAY,OAAA,EAAS,kBAAA,GAAqB,YAAA;;;UCnFzC,gBAAA;EACf,YAAA,GAAe,IAAA;IACb,IAAA;IACA,IAAA,EAAM,QAAA;IACN,KAAA;EAAA,MACI,OAAA;AAAA;;;ALaR;;iBKNsB,SAAA,CAAU,OAAA,EAAS,gBAAA,EAAkB,IAAA,EAAM,WAAA,GAAc,OAAA;;;cCdlE,iBAAA;AAAA,cACA,gBAAA;AAAA,cACA,qBAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/seo/plugin.ts","../src/seo/fields.ts","../src/seo/share-image.ts","../src/seo/text.ts","../src/theme/global.ts","../src/theme/seed.ts","../src/theme/preview.ts","../src/theme/fields.ts"],"mappings":";;;;;;;;;;AAoBA;;UAAiB,MAAA;EACf,KAAA;AAAA;AAAA,UAGe,gBAAA,cAA8B,MAAA,GAAS,MAAA;EAAvB;EAE/B,QAAA;EAF6C;;;;;;EAS7C,MAAA,GAAS,GAAA,EAAK,IAAA;EAiBM;;;;;EAXpB,YAAA,IAAgB,GAAA,EAAK,IAAA;EAbrB;;;;;;EAoBA,QAAA,IAAY,GAAA,EAAK,IAAA,KAAS,OAAA;EAA1B;EAEA,WAAA,GAAc,cAAA;EAFF;EAIZ,iBAAA,GAAoB,oBAAA;AAAA;;;;;;AAetB;;;;;;;iBAAgB,SAAA,cAAuB,MAAA,GAAS,MAAA,CAAA,CAAA;EAC9C,QAAA;EACA,MAAA;EACA,YAAA;EACA,QAAA;EACA,WAAA;EACA;AAAA,GACC,gBAAA,CAAiB,IAAA,IAAQ,MAAA;;;;;;;iBA6BZ,YAAA,CACd,MAAA,WACA,KAAA,YACC,OAAA;;;;;;;;cCjGU,YAAA,EAAc,aAAA;;;;;;;;;ADa3B;;cEVa,gBAAA;;;;;;;;;cCTA,kBAAA;;;;;AHmBb;;iBGXgB,cAAA,CAAe,IAAA,UAAc,GAAA;;;;;;;AHW7C;;;;iBIsEgB,WAAA,CAAY,OAAA,EAAS,kBAAA,GAAqB,YAAA;;;UCpFzC,gBAAA;EACf,YAAA,GAAe,IAAA;IACb,IAAA;IACA,IAAA,EAAM,QAAA;IACN,KAAA;EAAA,MACI,OAAA;AAAA;;;ALaR;;iBKNsB,SAAA,CAAU,OAAA,EAAS,gBAAA,EAAkB,IAAA,EAAM,WAAA,GAAc,OAAA;;;;;;;cCdlE,yBAAA;EAAA;;;;;;;;;;;;;;;;;cCAA,iBAAA;AAAA,cACA,gBAAA;AAAA,cACA,qBAAA"}

package/dist/index.mjs

@@ -79,6 +79,32 @@ function firstImageIn(blocks, field = "image") {
 	}
 }
 //#endregion
+//#region src/theme/preview.ts
+/**
+* Device sizes the Theme (and, later, Pages) live-preview toolbar offers.
+* One list so the panes match.
+*/
+const THEME_PREVIEW_BREAKPOINTS = [
+	{
+		label: "Mobile",
+		name: "mobile",
+		width: 375,
+		height: 667
+	},
+	{
+		label: "Tablet",
+		name: "tablet",
+		width: 768,
+		height: 1024
+	},
+	{
+		label: "Desktop",
+		name: "desktop",
+		width: 1440,
+		height: 900
+	}
+];
+//#endregion
 //#region src/theme/global.ts
 function requireAccess(options) {
 	const read = options.access?.read;
@@ -144,7 +170,7 @@ function fontField(name, label, defaultValue, fonts, fontsBaseUrl, sameAsBody) {
 * (`canManageBrand` for update). Drafts autosave; the public site reads
 * the published version through `getPublishedTheme`.
 *
-* `previewPath` is stored for BIS-61, which wires the live preview pane.
+* `previewPath` wires `admin.livePreview` when the site has a route.
 */
 function createTheme(options) {
 	const access = requireAccess(options);
@@ -203,7 +229,11 @@ function createTheme(options) {
 				previewPath,
 				contrastTarget,
 				fontsBaseUrl
-			}
+			},
+			...previewPath ? { livePreview: {
+				url: previewPath,
+				breakpoints: [...THEME_PREVIEW_BREAKPOINTS]
+			} } : {}
 		},
 		versions: { drafts: { autosave: { interval: 800 } } },
 		access: {
@@ -234,6 +264,6 @@ async function seedTheme(payload, seed) {
 	});
 }
 //#endregion
-export { DESCRIPTION_LENGTH, SHARE_IMAGE_SIZE, THEME_COLOR_FIELD, THEME_CONTRAST_REPORT, THEME_FONT_FIELD, THEME_SLUG, createTheme, documentTitle, firstImageIn, noIndexField, seedTheme, seoPlugin, titleTemplate, truncateAtWord };
+export { DESCRIPTION_LENGTH, SHARE_IMAGE_SIZE, THEME_COLOR_FIELD, THEME_CONTRAST_REPORT, THEME_FONT_FIELD, THEME_PREVIEW_BREAKPOINTS, THEME_SLUG, createTheme, documentTitle, firstImageIn, noIndexField, seedTheme, seoPlugin, titleTemplate, truncateAtWord };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["payloadSeoPlugin"],"sources":["../src/seo/fields.ts","../src/seo/text.ts","../src/seo/plugin.ts","../src/theme/global.ts","../src/theme/seed.ts"],"sourcesContent":["import type { CheckboxField } from \"payload\";\n\n/**\n * The index switch, last in the SEO tab. Off by default: a page is public\n * unless an editor says otherwise. `pageMetadata` turns it into\n * `noindex, nofollow`; a site's sitemap should filter on it too.\n */\nexport const noIndexField: CheckboxField = {\n  name: \"noIndex\",\n  type: \"checkbox\",\n  label: \"Hide this page from search engines\",\n  defaultValue: false,\n  admin: {\n    description:\n      \"Search engines will not list this page and the sitemap will leave it out. Anyone with the link can still open it.\",\n  },\n};\n","/** The length a search result shows of a description before it is cut. */\nexport const DESCRIPTION_LENGTH = 155;\n\n/**\n * Prose cut to `max` characters at a word, with an ellipsis, so a generated\n * description does not end mid-syllable. Text that fits is returned trimmed\n * and whole. A first word longer than `max` is cut mid-word, since there is\n * no boundary to cut at.\n */\nexport function truncateAtWord(text: string, max = DESCRIPTION_LENGTH): string {\n  const trimmed = text.trim();\n  if (trimmed.length <= max) return trimmed;\n  const cut = trimmed.slice(0, max);\n  const lastSpace = cut.lastIndexOf(\" \");\n  return `${lastSpace > 0 ? cut.slice(0, lastSpace) : cut}…`;\n}\n","import { seoPlugin as payloadSeoPlugin } from \"@payloadcms/plugin-seo\";\nimport type {\n  GenerateDescription,\n  GenerateImage,\n  GenerateTitle,\n  GenerateURL,\n} from \"@payloadcms/plugin-seo/types\";\nimport type { CollectionSlug, Plugin, UploadCollectionSlug } from \"payload\";\n\nimport { noIndexField } from \"./fields\";\nimport { truncateAtWord } from \"./text\";\nimport { documentTitle } from \"./title\";\nimport type { MediaId } from \"./types\";\n\n/**\n * What the plugin reads off a document: its title, for the generated meta\n * title. The site's generated `Page` is assignable to this; the `urlFor`,\n * `describeFrom` and `imageFor` callbacks read the rest, typed as the site\n * chooses through `TDoc`.\n */\nexport interface SeoDoc {\n  title?: string | null;\n}\n\nexport interface SeoPluginOptions<TDoc extends SeoDoc = SeoDoc> {\n  /** Appended to every generated title: `<page title> | <siteName>`. */\n  siteName: string;\n  /**\n   * The absolute public URL of a document from the form's data, for the\n   * search-result preview and the Generate button beside it. `undefined`\n   * when the document has no address yet (a slug not typed), which leaves\n   * the preview empty rather than pointing at the home page.\n   */\n  urlFor: (doc: TDoc) => string | undefined;\n  /**\n   * Prose to cut a generated description from, the first plain-text field a\n   * page always has near the top (a hero's body, say). Cut at a word near\n   * 155 characters. Without it the Generate button fills in nothing.\n   */\n  describeFrom?: (doc: TDoc) => string | null | undefined;\n  /**\n   * An image already on the page, for the Meta Image Generate button, so an\n   * editor need not upload a second copy of the hero picture. `firstImageIn`\n   * walks block rows for one. The upload chooser stays, so any other media\n   * row can still be picked.\n   */\n  imageFor?: (doc: TDoc) => MediaId | null | undefined;\n  /** Collections that get the SEO tab. Default `['pages']`. */\n  collections?: CollectionSlug[];\n  /** The upload collection the meta image comes from. Default `'media'`. */\n  uploadsCollection?: UploadCollectionSlug;\n}\n\n/**\n * `@payloadcms/plugin-seo` configured the Bison Lab way: an SEO tab beside a\n * Content tab (never below the block editor), holding the overview with its\n * character counts, meta title, description and image with Generate buttons,\n * the search-result preview, and the `noIndex` switch.\n *\n * Every string the tab generates comes from the options, so a site spells\n * its name and its URL scheme once. Pin `@payloadcms/plugin-seo` to the same\n * version as `payload` in the site; the plugin's admin components are\n * resolved from the site's import map, so run `payload generate:importmap`\n * after adding it.\n */\nexport function seoPlugin<TDoc extends SeoDoc = SeoDoc>({\n  siteName,\n  urlFor,\n  describeFrom,\n  imageFor,\n  collections = [\"pages\"],\n  uploadsCollection = \"media\",\n}: SeoPluginOptions<TDoc>): Plugin {\n  const generateTitle: GenerateTitle<TDoc> = ({ doc }) =>\n    doc?.title ? documentTitle(siteName, doc.title) : \"\";\n  const generateDescription: GenerateDescription<TDoc> = ({ doc }) =>\n    truncateAtWord(describeFrom?.(doc) ?? \"\");\n  const generateURL: GenerateURL<TDoc> = ({ doc }) => urlFor(doc) ?? \"\";\n  // Only when the site can name one: the button appears with the function.\n  const generateImage: GenerateImage<TDoc> | undefined = imageFor\n    ? ({ doc }) => imageFor(doc) ?? \"\"\n    : undefined;\n\n  return payloadSeoPlugin({\n    collections,\n    uploadsCollection,\n    tabbedUI: true,\n    generateTitle,\n    generateDescription,\n    generateURL,\n    ...(generateImage ? { generateImage } : {}),\n    fields: ({ defaultFields }) => [...defaultFields, noIndexField],\n  });\n}\n\n/**\n * The first image among some block rows, as a media id, for `imageFor`. Each\n * row is checked for `field` holding either a bare id or a populated upload\n * document; rows without one are skipped. Pass the page's hero and layout\n * together (`[...doc.hero, ...doc.layout]`) to search in reading order.\n */\nexport function firstImageIn(\n  blocks: unknown,\n  field = \"image\",\n): MediaId | undefined {\n  if (!Array.isArray(blocks)) return undefined;\n  for (const block of blocks) {\n    if (typeof block !== \"object\" || block === null) continue;\n    const value = (block as Record<string, unknown>)[field];\n    const id =\n      typeof value === \"object\" && value !== null && \"id\" in value\n        ? (value as { id: unknown }).id\n        : value;\n    if (typeof id === \"number\" || (typeof id === \"string\" && id !== \"\"))\n      return id;\n  }\n  return undefined;\n}\n","import { catalog, type FontEntry } from \"@bison-lab/fonts\";\nimport { presetHints } from \"@bison-lab/tokens\";\nimport type { Field, GlobalConfig, SelectField, TextField } from \"payload\";\n\nimport {\n  SAME_AS_BODY,\n  THEME_COLOR_FIELD,\n  THEME_CONTRAST_REPORT,\n  THEME_FONT_FIELD,\n  headingSelectValue,\n} from \"./fields\";\nimport { themeConfigFromDoc, validateThemeHex } from \"./map\";\nimport { THEME_SLUG, type CreateThemeOptions, type ThemeDoc } from \"./types\";\n\nfunction requireAccess(options: CreateThemeOptions): CreateThemeOptions[\"access\"] {\n  const read = options.access?.read;\n  const update = options.access?.update;\n  if (!read || !update) {\n    throw new Error(\n      \"createTheme requires access.read and access.update. Pass the site's predicates; canManageBrand is the intended update predicate until BIS-43 moves src/platform here.\",\n    );\n  }\n  return { read, update };\n}\n\nfunction hintSelect<K extends string>(\n  name: string,\n  label: string,\n  hints: Record<K, { label: string; hint: string }>,\n  defaultValue: K,\n): SelectField {\n  return {\n    name,\n    type: \"select\",\n    label,\n    required: true,\n    defaultValue,\n    options: (Object.entries(hints) as [K, { label: string; hint: string }][]).map(\n      ([value, { label: optionLabel, hint }]) => ({\n        label: `${optionLabel} — ${hint}`,\n        value,\n      }),\n    ),\n  };\n}\n\nfunction colorField(name: string, label: string, defaultValue: string): TextField {\n  return {\n    name,\n    type: \"text\",\n    label,\n    required: true,\n    defaultValue,\n    validate: validateThemeHex,\n    admin: { components: { Field: THEME_COLOR_FIELD } },\n  };\n}\n\nfunction fontField(\n  name: string,\n  label: string,\n  defaultValue: string,\n  fonts: readonly FontEntry[],\n  fontsBaseUrl: string,\n  sameAsBody: boolean,\n): SelectField {\n  const options = fonts.map((font) => ({ label: font.family, value: font.id }));\n  return {\n    name,\n    type: \"select\",\n    label,\n    required: !sameAsBody,\n    defaultValue,\n    options: sameAsBody ? [{ label: \"Same as body\", value: SAME_AS_BODY }, ...options] : options,\n    admin: {\n      components: { Field: THEME_FONT_FIELD },\n      custom: { fontsBaseUrl, ids: fonts.map((font) => font.id), sameAsBody },\n    },\n  };\n}\n\n/**\n * Settings → Theme: the five brand colours, grey scale, presets, default\n * theme, body and heading fonts, and optional logo. Access is passed in\n * (`canManageBrand` for update). Drafts autosave; the public site reads\n * the published version through `getPublishedTheme`.\n *\n * `previewPath` is stored for BIS-61, which wires the live preview pane.\n */\nexport function createTheme(options: CreateThemeOptions): GlobalConfig {\n  const access = requireAccess(options);\n  const {\n    seed,\n    fonts = catalog,\n    fontsBaseUrl = \"/fonts\",\n    contrastTarget = 4.5,\n    previewPath,\n    logo,\n    onPublish,\n  } = options;\n\n  const fields: Field[] = [\n    {\n      name: \"brand\",\n      type: \"group\",\n      label: \"Brand colours\",\n      fields: [\n        colorField(\"primary\", \"Primary\", seed.brandPrimary),\n        colorField(\"secondary\", \"Secondary\", seed.brandSecondary),\n        colorField(\"accent\", \"Accent\", seed.brandAccent),\n        colorField(\"highlight\", \"Highlight\", seed.brandHighlight),\n        colorField(\"success\", \"Success\", seed.brandSuccess),\n      ],\n    },\n    {\n      name: \"contrast\",\n      type: \"ui\",\n      admin: {\n        components: { Field: THEME_CONTRAST_REPORT },\n        custom: { target: contrastTarget },\n      },\n    },\n    hintSelect(\"greyScale\", \"Grey scale\", presetHints.greyScale, seed.greyScale),\n    hintSelect(\"radius\", \"Radius\", presetHints.radius, seed.radius),\n    hintSelect(\"shadow\", \"Shadow\", presetHints.shadow, seed.shadow),\n    hintSelect(\"motion\", \"Motion\", presetHints.motion, seed.motion),\n    hintSelect(\"density\", \"Density\", presetHints.density, seed.density),\n    hintSelect(\"defaultTheme\", \"Default theme\", presetHints.defaultTheme, seed.defaultTheme),\n    {\n      name: \"fonts\",\n      type: \"group\",\n      label: \"Fonts\",\n      fields: [\n        fontField(\"body\", \"Body\", seed.fontBody, fonts, fontsBaseUrl, false),\n        fontField(\n          \"heading\",\n          \"Heading\",\n          headingSelectValue(seed.fontHeading),\n          fonts,\n          fontsBaseUrl,\n          true,\n        ),\n      ],\n    },\n  ];\n\n  if (logo) {\n    fields.push(\n      {\n        name: \"logo\",\n        type: \"upload\",\n        relationTo: logo.collection,\n        label: \"Logo\",\n      },\n      {\n        name: \"logoMark\",\n        type: \"upload\",\n        relationTo: logo.collection,\n        label: \"Logo mark\",\n      },\n    );\n  }\n\n  return {\n    slug: THEME_SLUG,\n    label: \"Theme\",\n    admin: {\n      group: \"Settings\",\n      custom: { previewPath, contrastTarget, fontsBaseUrl },\n    },\n    versions: { drafts: { autosave: { interval: 800 } } },\n    access: {\n      read: access.read,\n      update: access.update,\n      readVersions: access.update,\n    },\n    fields,\n    hooks: {\n      afterChange: [\n        async ({ doc }) => {\n          if (!onPublish) return;\n          const themeDoc = doc as ThemeDoc;\n          if (themeDoc._status !== \"published\") return;\n          await onPublish(themeConfigFromDoc(themeDoc, seed), themeDoc);\n        },\n      ],\n    },\n  };\n}\n","import type { ThemeConfig } from \"@bison-lab/tokens\";\n\nimport { docFromConfig } from \"./map\";\nimport { THEME_SLUG } from \"./types\";\nimport type { ThemeDoc } from \"./types\";\n\nexport interface SeedThemePayload {\n  updateGlobal: (args: {\n    slug: string;\n    data: ThemeDoc;\n    draft?: boolean;\n  }) => Promise<unknown>;\n}\n\n/**\n * Writes a published Theme from the seed. For a site's migration `up()`,\n * so the row exists on deploy and renders what `bison-theme.css` rendered.\n */\nexport async function seedTheme(payload: SeedThemePayload, seed: ThemeConfig): Promise<unknown> {\n  return payload.updateGlobal({\n    slug: THEME_SLUG,\n    data: docFromConfig(seed),\n    draft: false,\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["payloadSeoPlugin"],"sources":["../src/seo/fields.ts","../src/seo/text.ts","../src/seo/plugin.ts","../src/theme/preview.ts","../src/theme/global.ts","../src/theme/seed.ts"],"sourcesContent":["import type { CheckboxField } from \"payload\";\n\n/**\n * The index switch, last in the SEO tab. Off by default: a page is public\n * unless an editor says otherwise. `pageMetadata` turns it into\n * `noindex, nofollow`; a site's sitemap should filter on it too.\n */\nexport const noIndexField: CheckboxField = {\n  name: \"noIndex\",\n  type: \"checkbox\",\n  label: \"Hide this page from search engines\",\n  defaultValue: false,\n  admin: {\n    description:\n      \"Search engines will not list this page and the sitemap will leave it out. Anyone with the link can still open it.\",\n  },\n};\n","/** The length a search result shows of a description before it is cut. */\nexport const DESCRIPTION_LENGTH = 155;\n\n/**\n * Prose cut to `max` characters at a word, with an ellipsis, so a generated\n * description does not end mid-syllable. Text that fits is returned trimmed\n * and whole. A first word longer than `max` is cut mid-word, since there is\n * no boundary to cut at.\n */\nexport function truncateAtWord(text: string, max = DESCRIPTION_LENGTH): string {\n  const trimmed = text.trim();\n  if (trimmed.length <= max) return trimmed;\n  const cut = trimmed.slice(0, max);\n  const lastSpace = cut.lastIndexOf(\" \");\n  return `${lastSpace > 0 ? cut.slice(0, lastSpace) : cut}…`;\n}\n","import { seoPlugin as payloadSeoPlugin } from \"@payloadcms/plugin-seo\";\nimport type {\n  GenerateDescription,\n  GenerateImage,\n  GenerateTitle,\n  GenerateURL,\n} from \"@payloadcms/plugin-seo/types\";\nimport type { CollectionSlug, Plugin, UploadCollectionSlug } from \"payload\";\n\nimport { noIndexField } from \"./fields\";\nimport { truncateAtWord } from \"./text\";\nimport { documentTitle } from \"./title\";\nimport type { MediaId } from \"./types\";\n\n/**\n * What the plugin reads off a document: its title, for the generated meta\n * title. The site's generated `Page` is assignable to this; the `urlFor`,\n * `describeFrom` and `imageFor` callbacks read the rest, typed as the site\n * chooses through `TDoc`.\n */\nexport interface SeoDoc {\n  title?: string | null;\n}\n\nexport interface SeoPluginOptions<TDoc extends SeoDoc = SeoDoc> {\n  /** Appended to every generated title: `<page title> | <siteName>`. */\n  siteName: string;\n  /**\n   * The absolute public URL of a document from the form's data, for the\n   * search-result preview and the Generate button beside it. `undefined`\n   * when the document has no address yet (a slug not typed), which leaves\n   * the preview empty rather than pointing at the home page.\n   */\n  urlFor: (doc: TDoc) => string | undefined;\n  /**\n   * Prose to cut a generated description from, the first plain-text field a\n   * page always has near the top (a hero's body, say). Cut at a word near\n   * 155 characters. Without it the Generate button fills in nothing.\n   */\n  describeFrom?: (doc: TDoc) => string | null | undefined;\n  /**\n   * An image already on the page, for the Meta Image Generate button, so an\n   * editor need not upload a second copy of the hero picture. `firstImageIn`\n   * walks block rows for one. The upload chooser stays, so any other media\n   * row can still be picked.\n   */\n  imageFor?: (doc: TDoc) => MediaId | null | undefined;\n  /** Collections that get the SEO tab. Default `['pages']`. */\n  collections?: CollectionSlug[];\n  /** The upload collection the meta image comes from. Default `'media'`. */\n  uploadsCollection?: UploadCollectionSlug;\n}\n\n/**\n * `@payloadcms/plugin-seo` configured the Bison Lab way: an SEO tab beside a\n * Content tab (never below the block editor), holding the overview with its\n * character counts, meta title, description and image with Generate buttons,\n * the search-result preview, and the `noIndex` switch.\n *\n * Every string the tab generates comes from the options, so a site spells\n * its name and its URL scheme once. Pin `@payloadcms/plugin-seo` to the same\n * version as `payload` in the site; the plugin's admin components are\n * resolved from the site's import map, so run `payload generate:importmap`\n * after adding it.\n */\nexport function seoPlugin<TDoc extends SeoDoc = SeoDoc>({\n  siteName,\n  urlFor,\n  describeFrom,\n  imageFor,\n  collections = [\"pages\"],\n  uploadsCollection = \"media\",\n}: SeoPluginOptions<TDoc>): Plugin {\n  const generateTitle: GenerateTitle<TDoc> = ({ doc }) =>\n    doc?.title ? documentTitle(siteName, doc.title) : \"\";\n  const generateDescription: GenerateDescription<TDoc> = ({ doc }) =>\n    truncateAtWord(describeFrom?.(doc) ?? \"\");\n  const generateURL: GenerateURL<TDoc> = ({ doc }) => urlFor(doc) ?? \"\";\n  // Only when the site can name one: the button appears with the function.\n  const generateImage: GenerateImage<TDoc> | undefined = imageFor\n    ? ({ doc }) => imageFor(doc) ?? \"\"\n    : undefined;\n\n  return payloadSeoPlugin({\n    collections,\n    uploadsCollection,\n    tabbedUI: true,\n    generateTitle,\n    generateDescription,\n    generateURL,\n    ...(generateImage ? { generateImage } : {}),\n    fields: ({ defaultFields }) => [...defaultFields, noIndexField],\n  });\n}\n\n/**\n * The first image among some block rows, as a media id, for `imageFor`. Each\n * row is checked for `field` holding either a bare id or a populated upload\n * document; rows without one are skipped. Pass the page's hero and layout\n * together (`[...doc.hero, ...doc.layout]`) to search in reading order.\n */\nexport function firstImageIn(\n  blocks: unknown,\n  field = \"image\",\n): MediaId | undefined {\n  if (!Array.isArray(blocks)) return undefined;\n  for (const block of blocks) {\n    if (typeof block !== \"object\" || block === null) continue;\n    const value = (block as Record<string, unknown>)[field];\n    const id =\n      typeof value === \"object\" && value !== null && \"id\" in value\n        ? (value as { id: unknown }).id\n        : value;\n    if (typeof id === \"number\" || (typeof id === \"string\" && id !== \"\"))\n      return id;\n  }\n  return undefined;\n}\n","/**\n * Device sizes the Theme (and, later, Pages) live-preview toolbar offers.\n * One list so the panes match.\n */\nexport const THEME_PREVIEW_BREAKPOINTS = [\n  { label: \"Mobile\", name: \"mobile\", width: 375, height: 667 },\n  { label: \"Tablet\", name: \"tablet\", width: 768, height: 1024 },\n  { label: \"Desktop\", name: \"desktop\", width: 1440, height: 900 },\n] as const;\n","import { catalog, type FontEntry } from \"@bison-lab/fonts\";\nimport { presetHints } from \"@bison-lab/tokens\";\nimport type { Field, GlobalConfig, SelectField, TextField } from \"payload\";\n\nimport {\n  SAME_AS_BODY,\n  THEME_COLOR_FIELD,\n  THEME_CONTRAST_REPORT,\n  THEME_FONT_FIELD,\n  headingSelectValue,\n} from \"./fields\";\nimport { themeConfigFromDoc, validateThemeHex } from \"./map\";\nimport { THEME_PREVIEW_BREAKPOINTS } from \"./preview\";\nimport { THEME_SLUG, type CreateThemeOptions, type ThemeDoc } from \"./types\";\n\nfunction requireAccess(options: CreateThemeOptions): CreateThemeOptions[\"access\"] {\n  const read = options.access?.read;\n  const update = options.access?.update;\n  if (!read || !update) {\n    throw new Error(\n      \"createTheme requires access.read and access.update. Pass the site's predicates; canManageBrand is the intended update predicate until BIS-43 moves src/platform here.\",\n    );\n  }\n  return { read, update };\n}\n\nfunction hintSelect<K extends string>(\n  name: string,\n  label: string,\n  hints: Record<K, { label: string; hint: string }>,\n  defaultValue: K,\n): SelectField {\n  return {\n    name,\n    type: \"select\",\n    label,\n    required: true,\n    defaultValue,\n    options: (Object.entries(hints) as [K, { label: string; hint: string }][]).map(\n      ([value, { label: optionLabel, hint }]) => ({\n        label: `${optionLabel} — ${hint}`,\n        value,\n      }),\n    ),\n  };\n}\n\nfunction colorField(name: string, label: string, defaultValue: string): TextField {\n  return {\n    name,\n    type: \"text\",\n    label,\n    required: true,\n    defaultValue,\n    validate: validateThemeHex,\n    admin: { components: { Field: THEME_COLOR_FIELD } },\n  };\n}\n\nfunction fontField(\n  name: string,\n  label: string,\n  defaultValue: string,\n  fonts: readonly FontEntry[],\n  fontsBaseUrl: string,\n  sameAsBody: boolean,\n): SelectField {\n  const options = fonts.map((font) => ({ label: font.family, value: font.id }));\n  return {\n    name,\n    type: \"select\",\n    label,\n    required: !sameAsBody,\n    defaultValue,\n    options: sameAsBody ? [{ label: \"Same as body\", value: SAME_AS_BODY }, ...options] : options,\n    admin: {\n      components: { Field: THEME_FONT_FIELD },\n      custom: { fontsBaseUrl, ids: fonts.map((font) => font.id), sameAsBody },\n    },\n  };\n}\n\n/**\n * Settings → Theme: the five brand colours, grey scale, presets, default\n * theme, body and heading fonts, and optional logo. Access is passed in\n * (`canManageBrand` for update). Drafts autosave; the public site reads\n * the published version through `getPublishedTheme`.\n *\n * `previewPath` wires `admin.livePreview` when the site has a route.\n */\nexport function createTheme(options: CreateThemeOptions): GlobalConfig {\n  const access = requireAccess(options);\n  const {\n    seed,\n    fonts = catalog,\n    fontsBaseUrl = \"/fonts\",\n    contrastTarget = 4.5,\n    previewPath,\n    logo,\n    onPublish,\n  } = options;\n\n  const fields: Field[] = [\n    {\n      name: \"brand\",\n      type: \"group\",\n      label: \"Brand colours\",\n      fields: [\n        colorField(\"primary\", \"Primary\", seed.brandPrimary),\n        colorField(\"secondary\", \"Secondary\", seed.brandSecondary),\n        colorField(\"accent\", \"Accent\", seed.brandAccent),\n        colorField(\"highlight\", \"Highlight\", seed.brandHighlight),\n        colorField(\"success\", \"Success\", seed.brandSuccess),\n      ],\n    },\n    {\n      name: \"contrast\",\n      type: \"ui\",\n      admin: {\n        components: { Field: THEME_CONTRAST_REPORT },\n        custom: { target: contrastTarget },\n      },\n    },\n    hintSelect(\"greyScale\", \"Grey scale\", presetHints.greyScale, seed.greyScale),\n    hintSelect(\"radius\", \"Radius\", presetHints.radius, seed.radius),\n    hintSelect(\"shadow\", \"Shadow\", presetHints.shadow, seed.shadow),\n    hintSelect(\"motion\", \"Motion\", presetHints.motion, seed.motion),\n    hintSelect(\"density\", \"Density\", presetHints.density, seed.density),\n    hintSelect(\"defaultTheme\", \"Default theme\", presetHints.defaultTheme, seed.defaultTheme),\n    {\n      name: \"fonts\",\n      type: \"group\",\n      label: \"Fonts\",\n      fields: [\n        fontField(\"body\", \"Body\", seed.fontBody, fonts, fontsBaseUrl, false),\n        fontField(\n          \"heading\",\n          \"Heading\",\n          headingSelectValue(seed.fontHeading),\n          fonts,\n          fontsBaseUrl,\n          true,\n        ),\n      ],\n    },\n  ];\n\n  if (logo) {\n    fields.push(\n      {\n        name: \"logo\",\n        type: \"upload\",\n        relationTo: logo.collection,\n        label: \"Logo\",\n      },\n      {\n        name: \"logoMark\",\n        type: \"upload\",\n        relationTo: logo.collection,\n        label: \"Logo mark\",\n      },\n    );\n  }\n\n  return {\n    slug: THEME_SLUG,\n    label: \"Theme\",\n    admin: {\n      group: \"Settings\",\n      custom: { previewPath, contrastTarget, fontsBaseUrl },\n      ...(previewPath\n        ? { livePreview: { url: previewPath, breakpoints: [...THEME_PREVIEW_BREAKPOINTS] } }\n        : {}),\n    },\n    versions: { drafts: { autosave: { interval: 800 } } },\n    access: {\n      read: access.read,\n      update: access.update,\n      readVersions: access.update,\n    },\n    fields,\n    hooks: {\n      afterChange: [\n        async ({ doc }) => {\n          if (!onPublish) return;\n          const themeDoc = doc as ThemeDoc;\n          if (themeDoc._status !== \"published\") return;\n          await onPublish(themeConfigFromDoc(themeDoc, seed), themeDoc);\n        },\n      ],\n    },\n  };\n}\n","import type { ThemeConfig } from \"@bison-lab/tokens\";\n\nimport { docFromConfig } from \"./map\";\nimport { THEME_SLUG } from \"./types\";\nimport type { ThemeDoc } from \"./types\";\n\nexport interface SeedThemePayload {\n  updateGlobal: (args: {\n    slug: string;\n    data: ThemeDoc;\n    draft?: boolean;\n  }) => Promise<unknown>;\n}\n\n/**\n * Writes a published Theme from the seed. For a site's migration `up()`,\n * so the row exists on deploy and renders what `bison-theme.css` rendered.\n */\nexport async function seedTheme(payload: SeedThemePayload, seed: ThemeConfig): Promise<unknown> {\n  return payload.updateGlobal({\n    slug: THEME_SLUG,\n    data: docFromConfig(seed),\n    draft: false,\n  });\n}\n"],"mappings":"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"}

package/dist/react.d.mts

@@ -0,0 +1,32 @@
+
+import { ThemeConfig } from "@bison-lab/tokens";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/react/theme-preview.d.ts
+interface ThemePreviewProps {
+  /** Published theme from `getPublishedTheme`. Shown until a live-preview message arrives. */
+  theme: ThemeConfig;
+  /** The site's `bison.config.json`. Fills fields a live message leaves empty. */
+  seed: ThemeConfig;
+  /** Where the site's `serveFont` route answers. */
+  fontsBaseUrl: string;
+  /** Absolute origin of the Payload server. Required by `useLivePreview`. */
+  serverURL: string;
+  /** Body-text target `ContrastStrip` judges against. Default `4.5`. */
+  contrastTarget?: number;
+}
+/**
+ * The Theme document's preview pane, and the site's design-system page.
+ * Rebuilds `themeHead` in the browser from each live-preview message.
+ * A half-typed hex keeps the last complete stylesheet.
+ */
+declare function ThemePreview({
+  theme,
+  seed,
+  fontsBaseUrl,
+  serverURL,
+  contrastTarget
+}: ThemePreviewProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { ThemePreview, type ThemePreviewProps };
+//# sourceMappingURL=react.d.mts.map

package/dist/react.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.mts","names":[],"sources":["../src/react/theme-preview.tsx"],"mappings":";;;;;UASiB,iBAAA;;EAEf,KAAA,EAAO,WAAA;EAFQ;EAIf,IAAA,EAAM,WAAA;;EAEN,YAAA;EAJA;EAMA,SAAA;EAJA;EAMA,cAAA;AAAA;;;;;AAkBF;iBAAgB,YAAA,CAAA;EACd,KAAA;EACA,IAAA;EACA,YAAA;EACA,SAAA;EACA;AAAA,GACC,iBAAA,GAAiB,kBAAA,CAAA,GAAA,CAAA,OAAA"}

package/dist/react.mjs

@@ -0,0 +1,132 @@
+"use client";
+import { auditTheme, buildThemeCss, isThemeHex, themeFontIds } from "@bison-lab/tokens";
+import { useRef, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { fontFaceCss, fontPreloads } from "@bison-lab/fonts";
+import { useLivePreview } from "@payloadcms/live-preview-react";
+import { ContrastStrip, ThemeShowcase } from "@bison-lab/ui";
+//#region src/theme/head.ts
+/**
+* `@font-face` plus `buildThemeCss` as one stylesheet, and the preload
+* list for the families the config names. A root layout (and the admin
+* layout, if it should restyle too) renders `css` in a `<style>` and
+* each preload as `<link rel="preload" as="font">`.
+*/
+function themeHead(config, options = {}) {
+	const fontsBaseUrl = options.fontsBaseUrl ?? "/fonts";
+	const ids = themeFontIds(config);
+	const faces = fontFaceCss(ids, fontsBaseUrl);
+	const theme = buildThemeCss(config, { attribute: options.attribute });
+	return {
+		css: faces ? `${faces}\n\n${theme}` : theme,
+		preloads: fontPreloads(ids, fontsBaseUrl)
+	};
+}
+//#endregion
+//#region src/theme/map.ts
+function pick(value, fallback) {
+	return value == null ? fallback : value;
+}
+function headingFromDoc(heading, seed) {
+	if (heading === void 0) return seed;
+	if (heading === null || heading === "") return null;
+	return heading;
+}
+/**
+* Nested Theme document → flat `ThemeConfig`. Null or missing editor
+* fields take the seed; `darkSelector` and `fontWeights` always come from
+* the seed.
+*/
+function themeConfigFromDoc(doc, seed) {
+	const brand = doc?.brand;
+	return {
+		brandPrimary: pick(brand?.primary, seed.brandPrimary),
+		brandSecondary: pick(brand?.secondary, seed.brandSecondary),
+		brandAccent: pick(brand?.accent, seed.brandAccent),
+		brandHighlight: pick(brand?.highlight, seed.brandHighlight),
+		brandSuccess: pick(brand?.success, seed.brandSuccess),
+		greyScale: pick(doc?.greyScale, seed.greyScale),
+		radius: pick(doc?.radius, seed.radius),
+		shadow: pick(doc?.shadow, seed.shadow),
+		motion: pick(doc?.motion, seed.motion),
+		density: pick(doc?.density, seed.density),
+		defaultTheme: pick(doc?.defaultTheme, seed.defaultTheme),
+		fontBody: pick(doc?.fonts?.body, seed.fontBody),
+		fontHeading: headingFromDoc(doc?.fonts?.heading, seed.fontHeading),
+		darkSelector: seed.darkSelector,
+		fontWeights: seed.fontWeights
+	};
+}
+/** The document `seedTheme` writes so a fresh Global matches the seed config. */
+function docFromConfig(config) {
+	return {
+		brand: {
+			primary: config.brandPrimary,
+			secondary: config.brandSecondary,
+			accent: config.brandAccent,
+			highlight: config.brandHighlight,
+			success: config.brandSuccess
+		},
+		greyScale: config.greyScale,
+		radius: config.radius,
+		shadow: config.shadow,
+		motion: config.motion,
+		density: config.density,
+		defaultTheme: config.defaultTheme,
+		fonts: {
+			body: config.fontBody,
+			heading: config.fontHeading
+		}
+	};
+}
+//#endregion
+//#region src/react/theme-preview.tsx
+function isRenderableTheme(config) {
+	return isThemeHex(config.brandPrimary) && isThemeHex(config.brandSecondary) && isThemeHex(config.brandAccent) && isThemeHex(config.brandHighlight) && isThemeHex(config.brandSuccess);
+}
+/**
+* The Theme document's preview pane, and the site's design-system page.
+* Rebuilds `themeHead` in the browser from each live-preview message.
+* A half-typed hex keeps the last complete stylesheet.
+*/
+function ThemePreview({ theme, seed, fontsBaseUrl, serverURL, contrastTarget = 4.5 }) {
+	const { data } = useLivePreview({
+		initialData: docFromConfig(theme),
+		serverURL
+	});
+	const mapped = themeConfigFromDoc(data, seed);
+	const last = useRef(theme);
+	if (isRenderableTheme(mapped)) last.current = mapped;
+	const config = last.current;
+	const css = themeHead(config, { fontsBaseUrl }).css;
+	const [mode, setMode] = useState("light");
+	return /* @__PURE__ */ jsxs("div", {
+		role: "region",
+		"aria-label": "Theme preview",
+		"data-theme": mode,
+		className: "bl-theme-preview",
+		children: [
+			/* @__PURE__ */ jsx("style", { children: css }),
+			/* @__PURE__ */ jsxs("div", {
+				className: "bl-theme-preview__bar",
+				children: [/* @__PURE__ */ jsx("button", {
+					type: "button",
+					"aria-pressed": mode === "light",
+					onClick: () => setMode("light"),
+					children: "Light"
+				}), /* @__PURE__ */ jsx("button", {
+					type: "button",
+					"aria-pressed": mode === "dark",
+					onClick: () => setMode("dark"),
+					children: "Dark"
+				})]
+			}),
+			/* @__PURE__ */ jsx(ThemeShowcase, {}),
+			/* @__PURE__ */ jsx(ContrastStrip, { checks: auditTheme(config, { target: contrastTarget }) })
+		]
+	});
+}
+//#endregion
+export { ThemePreview };
+
+//# sourceMappingURL=react.mjs.map

package/dist/react.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.mjs","names":[],"sources":["../src/theme/head.ts","../src/theme/map.ts","../src/react/theme-preview.tsx"],"sourcesContent":["import { fontFaceCss, fontPreloads } from \"@bison-lab/fonts\";\nimport { buildThemeCss, themeFontIds, type ThemeConfig } from \"@bison-lab/tokens\";\n\nimport type { ThemeHead, ThemeHeadOptions } from \"./types\";\n\n/**\n * `@font-face` plus `buildThemeCss` as one stylesheet, and the preload\n * list for the families the config names. A root layout (and the admin\n * layout, if it should restyle too) renders `css` in a `<style>` and\n * each preload as `<link rel=\"preload\" as=\"font\">`.\n */\nexport function themeHead(config: ThemeConfig, options: ThemeHeadOptions = {}): ThemeHead {\n  const fontsBaseUrl = options.fontsBaseUrl ?? \"/fonts\";\n  const ids = themeFontIds(config);\n  const faces = fontFaceCss(ids, fontsBaseUrl);\n  const theme = buildThemeCss(config, { attribute: options.attribute });\n  return {\n    css: faces ? `${faces}\\n\\n${theme}` : theme,\n    preloads: fontPreloads(ids, fontsBaseUrl),\n  };\n}\n","import { isThemeHex, type ThemeConfig } from \"@bison-lab/tokens\";\n\nimport { SAME_AS_BODY } from \"./fields\";\nimport type { ThemeDoc } from \"./types\";\n\nfunction pick<T>(value: T | null | undefined, fallback: T): T {\n  return value == null ? fallback : value;\n}\n\nfunction headingFromDoc(\n  heading: string | null | undefined,\n  seed: ThemeConfig[\"fontHeading\"],\n): string | null {\n  if (heading === undefined) return seed;\n  if (heading === null || heading === SAME_AS_BODY) return null;\n  return heading;\n}\n\n/**\n * Nested Theme document → flat `ThemeConfig`. Null or missing editor\n * fields take the seed; `darkSelector` and `fontWeights` always come from\n * the seed.\n */\nexport function themeConfigFromDoc(doc: ThemeDoc | null | undefined, seed: ThemeConfig): ThemeConfig {\n  const brand = doc?.brand;\n  return {\n    brandPrimary: pick(brand?.primary, seed.brandPrimary),\n    brandSecondary: pick(brand?.secondary, seed.brandSecondary),\n    brandAccent: pick(brand?.accent, seed.brandAccent),\n    brandHighlight: pick(brand?.highlight, seed.brandHighlight),\n    brandSuccess: pick(brand?.success, seed.brandSuccess),\n    greyScale: pick(doc?.greyScale, seed.greyScale),\n    radius: pick(doc?.radius, seed.radius),\n    shadow: pick(doc?.shadow, seed.shadow),\n    motion: pick(doc?.motion, seed.motion),\n    density: pick(doc?.density, seed.density),\n    defaultTheme: pick(doc?.defaultTheme, seed.defaultTheme),\n    fontBody: pick(doc?.fonts?.body, seed.fontBody),\n    fontHeading: headingFromDoc(doc?.fonts?.heading, seed.fontHeading),\n    darkSelector: seed.darkSelector,\n    fontWeights: seed.fontWeights,\n  };\n}\n\n/** The document `seedTheme` writes so a fresh Global matches the seed config. */\nexport function docFromConfig(config: ThemeConfig): ThemeDoc {\n  return {\n    brand: {\n      primary: config.brandPrimary,\n      secondary: config.brandSecondary,\n      accent: config.brandAccent,\n      highlight: config.brandHighlight,\n      success: config.brandSuccess,\n    },\n    greyScale: config.greyScale,\n    radius: config.radius,\n    shadow: config.shadow,\n    motion: config.motion,\n    density: config.density,\n    defaultTheme: config.defaultTheme,\n    fonts: {\n      body: config.fontBody,\n      heading: config.fontHeading,\n    },\n  };\n}\n\nexport function validateThemeHex(value: unknown): true | string {\n  if (!isThemeHex(value)) return \"Enter a six-digit hex colour like #1e3a5f\";\n  return true;\n}\n","import { useLivePreview } from \"@payloadcms/live-preview-react\";\nimport { ContrastStrip, ThemeShowcase } from \"@bison-lab/ui\";\nimport { auditTheme, isThemeHex, type ThemeConfig } from \"@bison-lab/tokens\";\nimport { useRef, useState } from \"react\";\n\nimport { themeHead } from \"../theme/head\";\nimport { docFromConfig, themeConfigFromDoc } from \"../theme/map\";\nimport type { ThemeDoc } from \"../theme/types\";\n\nexport interface ThemePreviewProps {\n  /** Published theme from `getPublishedTheme`. Shown until a live-preview message arrives. */\n  theme: ThemeConfig;\n  /** The site's `bison.config.json`. Fills fields a live message leaves empty. */\n  seed: ThemeConfig;\n  /** Where the site's `serveFont` route answers. */\n  fontsBaseUrl: string;\n  /** Absolute origin of the Payload server. Required by `useLivePreview`. */\n  serverURL: string;\n  /** Body-text target `ContrastStrip` judges against. Default `4.5`. */\n  contrastTarget?: number;\n}\n\nfunction isRenderableTheme(config: ThemeConfig): boolean {\n  return (\n    isThemeHex(config.brandPrimary) &&\n    isThemeHex(config.brandSecondary) &&\n    isThemeHex(config.brandAccent) &&\n    isThemeHex(config.brandHighlight) &&\n    isThemeHex(config.brandSuccess)\n  );\n}\n\n/**\n * The Theme document's preview pane, and the site's design-system page.\n * Rebuilds `themeHead` in the browser from each live-preview message.\n * A half-typed hex keeps the last complete stylesheet.\n */\nexport function ThemePreview({\n  theme,\n  seed,\n  fontsBaseUrl,\n  serverURL,\n  contrastTarget = 4.5,\n}: ThemePreviewProps) {\n  const { data } = useLivePreview<ThemeDoc>({\n    initialData: docFromConfig(theme),\n    serverURL,\n  });\n  const mapped = themeConfigFromDoc(data, seed);\n  const last = useRef(theme);\n  if (isRenderableTheme(mapped)) last.current = mapped;\n  const config = last.current;\n  const css = themeHead(config, { fontsBaseUrl }).css;\n  const [mode, setMode] = useState<\"light\" | \"dark\">(\"light\");\n\n  return (\n    <div role=\"region\" aria-label=\"Theme preview\" data-theme={mode} className=\"bl-theme-preview\">\n      <style>{css}</style>\n      <div className=\"bl-theme-preview__bar\">\n        <button type=\"button\" aria-pressed={mode === \"light\"} onClick={() => setMode(\"light\")}>\n          Light\n        </button>\n        <button type=\"button\" aria-pressed={mode === \"dark\"} onClick={() => setMode(\"dark\")}>\n          Dark\n        </button>\n      </div>\n      <ThemeShowcase />\n      <ContrastStrip checks={auditTheme(config, { target: contrastTarget })} />\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/theme.d.mts

@@ -1,4 +1,4 @@
-import { a as ThemeHead, i as ThemeDoc, n as EditableTheme, o as ThemeHeadOptions, r as THEME_SLUG, s as ThemeUploadDoc, t as CreateThemeOptions } from "./types-B3FC9sdF.mjs";
+import { a as ThemeHead, i as ThemeDoc, n as EditableTheme, o as ThemeHeadOptions, r as THEME_SLUG, s as ThemeUploadDoc, t as CreateThemeOptions } from "./types-pFpmDeSA.mjs";
 import { ThemeConfig } from "@bison-lab/tokens";
 
 //#region src/theme/published.d.ts

package/dist/types-DWwL-JEr.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types-DWwL-JEr.mjs","names":[],"sources":["../src/theme/fields.ts","../src/theme/map.ts","../src/theme/types.ts"],"sourcesContent":["import type { ThemeConfig } from \"@bison-lab/tokens\";\n\nimport type { EditableTheme } from \"./types\";\n\nexport const THEME_COLOR_FIELD = \"@bison-lab/payload-core/admin#ColorField\";\nexport const THEME_FONT_FIELD = \"@bison-lab/payload-core/admin#FontField\";\nexport const THEME_CONTRAST_REPORT = \"@bison-lab/payload-core/admin#ContrastReport\";\n\n/**\n * Document path for each editable `ThemeConfig` key. Locked with `satisfies`\n * so a new config field without a Theme field (or the reverse) fails at\n * compile time. `darkSelector` and `fontWeights` are seed-only.\n */\nexport const THEME_FIELD_PATHS = {\n  brandPrimary: \"brand.primary\",\n  brandSecondary: \"brand.secondary\",\n  brandAccent: \"brand.accent\",\n  brandHighlight: \"brand.highlight\",\n  brandSuccess: \"brand.success\",\n  greyScale: \"greyScale\",\n  defaultTheme: \"defaultTheme\",\n  radius: \"radius\",\n  shadow: \"shadow\",\n  motion: \"motion\",\n  density: \"density\",\n  fontBody: \"fonts.body\",\n  fontHeading: \"fonts.heading\",\n} as const satisfies Record<keyof EditableTheme, string>;\n\nexport type ThemeFieldPath = (typeof THEME_FIELD_PATHS)[keyof typeof THEME_FIELD_PATHS];\n\n/** Empty select value for heading: same family as body. */\nexport const SAME_AS_BODY = \"\";\n\nexport function headingSelectValue(heading: ThemeConfig[\"fontHeading\"]): string {\n  return heading ?? SAME_AS_BODY;\n}\n","import { isThemeHex, type ThemeConfig } from \"@bison-lab/tokens\";\n\nimport { SAME_AS_BODY } from \"./fields\";\nimport type { ThemeDoc } from \"./types\";\n\nfunction pick<T>(value: T | null | undefined, fallback: T): T {\n  return value == null ? fallback : value;\n}\n\nfunction headingFromDoc(\n  heading: string | null | undefined,\n  seed: ThemeConfig[\"fontHeading\"],\n): string | null {\n  if (heading === undefined) return seed;\n  if (heading === null || heading === SAME_AS_BODY) return null;\n  return heading;\n}\n\n/**\n * Nested Theme document → flat `ThemeConfig`. Null or missing editor\n * fields take the seed; `darkSelector` and `fontWeights` always come from\n * the seed.\n */\nexport function themeConfigFromDoc(doc: ThemeDoc | null | undefined, seed: ThemeConfig): ThemeConfig {\n  const brand = doc?.brand;\n  return {\n    brandPrimary: pick(brand?.primary, seed.brandPrimary),\n    brandSecondary: pick(brand?.secondary, seed.brandSecondary),\n    brandAccent: pick(brand?.accent, seed.brandAccent),\n    brandHighlight: pick(brand?.highlight, seed.brandHighlight),\n    brandSuccess: pick(brand?.success, seed.brandSuccess),\n    greyScale: pick(doc?.greyScale, seed.greyScale),\n    radius: pick(doc?.radius, seed.radius),\n    shadow: pick(doc?.shadow, seed.shadow),\n    motion: pick(doc?.motion, seed.motion),\n    density: pick(doc?.density, seed.density),\n    defaultTheme: pick(doc?.defaultTheme, seed.defaultTheme),\n    fontBody: pick(doc?.fonts?.body, seed.fontBody),\n    fontHeading: headingFromDoc(doc?.fonts?.heading, seed.fontHeading),\n    darkSelector: seed.darkSelector,\n    fontWeights: seed.fontWeights,\n  };\n}\n\n/** The document `seedTheme` writes so a fresh Global matches the seed config. */\nexport function docFromConfig(config: ThemeConfig): ThemeDoc {\n  return {\n    brand: {\n      primary: config.brandPrimary,\n      secondary: config.brandSecondary,\n      accent: config.brandAccent,\n      highlight: config.brandHighlight,\n      success: config.brandSuccess,\n    },\n    greyScale: config.greyScale,\n    radius: config.radius,\n    shadow: config.shadow,\n    motion: config.motion,\n    density: config.density,\n    defaultTheme: config.defaultTheme,\n    fonts: {\n      body: config.fontBody,\n      heading: config.fontHeading,\n    },\n  };\n}\n\nexport function validateThemeHex(value: unknown): true | string {\n  if (!isThemeHex(value)) return \"Enter a six-digit hex colour like #1e3a5f\";\n  return true;\n}\n","import type { Access } from \"payload\";\nimport type { FontEntry } from \"@bison-lab/fonts\";\nimport type { ThemeConfig } from \"@bison-lab/tokens\";\n\n/**\n * The Theme document a site's generated types will describe. Optional and\n * nullable, no index signature: a generated Global is assignable to this,\n * never the reverse.\n */\nexport interface ThemeDoc {\n  brand?: {\n    primary?: string | null;\n    secondary?: string | null;\n    accent?: string | null;\n    highlight?: string | null;\n    success?: string | null;\n  } | null;\n  greyScale?: ThemeConfig[\"greyScale\"] | null;\n  radius?: ThemeConfig[\"radius\"] | null;\n  shadow?: ThemeConfig[\"shadow\"] | null;\n  motion?: ThemeConfig[\"motion\"] | null;\n  density?: ThemeConfig[\"density\"] | null;\n  defaultTheme?: ThemeConfig[\"defaultTheme\"] | null;\n  fonts?: {\n    body?: string | null;\n    heading?: string | null;\n  } | null;\n  logo?: number | string | ThemeUploadDoc | null;\n  logoMark?: number | string | ThemeUploadDoc | null;\n  _status?: \"draft\" | \"published\" | null;\n}\n\nexport interface ThemeUploadDoc {\n  id?: number | string | null;\n  url?: string | null;\n  alt?: string | null;\n}\n\n/**\n * What an editor can change. `darkSelector` and `fontWeights` stay on the\n * seed — they mean nothing in the admin — and `themeConfigFromDoc` puts\n * them back.\n */\nexport type EditableTheme = Omit<ThemeConfig, \"darkSelector\" | \"fontWeights\">;\n\nexport interface CreateThemeOptions {\n  /**\n   * Required, no default. Predicates live in each site's `src/platform`\n   * until BIS-43; pass `canManageBrand` as `update` (and typically\n   * `isAuthenticated` as `read`). `readVersions` / draft visibility follow\n   * `update`, so only a brand manager sees unpublished edits.\n   */\n  access: { read: Access; update: Access };\n  /** The site's `bison.config.json`. Every field's `defaultValue`, and the fallback `getPublishedTheme` returns. */\n  seed: ThemeConfig;\n  /** Default: the whole catalogue. */\n  fonts?: readonly FontEntry[];\n  /** Where the site's `serveFont` route answers, for the picker's specimens. Default `\"/fonts\"`. */\n  fontsBaseUrl?: string;\n  /** Body-text target the contrast report judges against. Default `4.5`. */\n  contrastTarget?: number;\n  /**\n   * Stored on `admin.custom` for BIS-61, which wires `admin.livePreview`.\n   * This slice does not open a preview pane.\n   */\n  previewPath?: string;\n  /** Adds `logo` and `logoMark` upload relations when given. */\n  logo?: { collection: string };\n  /** Fires from `afterChange` on a published save only, not an autosaved draft. */\n  onPublish?: (theme: ThemeConfig, doc: ThemeDoc) => void | Promise<void>;\n}\n\nexport interface ThemeHeadOptions {\n  fontsBaseUrl?: string;\n  attribute?: \"class\" | \"data-theme\";\n}\n\nexport interface ThemeHead {\n  css: string;\n  preloads: { href: string; type: \"font/woff2\" }[];\n}\n\nexport const THEME_SLUG = \"theme\";\n"],"mappings":";;AAIA,MAAa,oBAAoB;AACjC,MAAa,mBAAmB;AAChC,MAAa,wBAAwB;AA4BrC,SAAgB,mBAAmB,SAA6C;AAC9E,QAAO,WAAA;;;;AC9BT,SAAS,KAAQ,OAA6B,UAAgB;AAC5D,QAAO,SAAS,OAAO,WAAW;;AAGpC,SAAS,eACP,SACA,MACe;AACf,KAAI,YAAY,KAAA,EAAW,QAAO;AAClC,KAAI,YAAY,QAAQ,YAAA,GAA0B,QAAO;AACzD,QAAO;;;;;;;AAQT,SAAgB,mBAAmB,KAAkC,MAAgC;CACnG,MAAM,QAAQ,KAAK;AACnB,QAAO;EACL,cAAc,KAAK,OAAO,SAAS,KAAK,aAAa;EACrD,gBAAgB,KAAK,OAAO,WAAW,KAAK,eAAe;EAC3D,aAAa,KAAK,OAAO,QAAQ,KAAK,YAAY;EAClD,gBAAgB,KAAK,OAAO,WAAW,KAAK,eAAe;EAC3D,cAAc,KAAK,OAAO,SAAS,KAAK,aAAa;EACrD,WAAW,KAAK,KAAK,WAAW,KAAK,UAAU;EAC/C,QAAQ,KAAK,KAAK,QAAQ,KAAK,OAAO;EACtC,QAAQ,KAAK,KAAK,QAAQ,KAAK,OAAO;EACtC,QAAQ,KAAK,KAAK,QAAQ,KAAK,OAAO;EACtC,SAAS,KAAK,KAAK,SAAS,KAAK,QAAQ;EACzC,cAAc,KAAK,KAAK,cAAc,KAAK,aAAa;EACxD,UAAU,KAAK,KAAK,OAAO,MAAM,KAAK,SAAS;EAC/C,aAAa,eAAe,KAAK,OAAO,SAAS,KAAK,YAAY;EAClE,cAAc,KAAK;EACnB,aAAa,KAAK;EACnB;;;AAIH,SAAgB,cAAc,QAA+B;AAC3D,QAAO;EACL,OAAO;GACL,SAAS,OAAO;GAChB,WAAW,OAAO;GAClB,QAAQ,OAAO;GACf,WAAW,OAAO;GAClB,SAAS,OAAO;GACjB;EACD,WAAW,OAAO;EAClB,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,cAAc,OAAO;EACrB,OAAO;GACL,MAAM,OAAO;GACb,SAAS,OAAO;GACjB;EACF;;AAGH,SAAgB,iBAAiB,OAA+B;AAC9D,KAAI,CAAC,WAAW,MAAM,CAAE,QAAO;AAC/B,QAAO;;;;ACaT,MAAa,aAAa"}
+{"version":3,"file":"types-DWwL-JEr.mjs","names":[],"sources":["../src/theme/fields.ts","../src/theme/map.ts","../src/theme/types.ts"],"sourcesContent":["import type { ThemeConfig } from \"@bison-lab/tokens\";\n\nimport type { EditableTheme } from \"./types\";\n\nexport const THEME_COLOR_FIELD = \"@bison-lab/payload-core/admin#ColorField\";\nexport const THEME_FONT_FIELD = \"@bison-lab/payload-core/admin#FontField\";\nexport const THEME_CONTRAST_REPORT = \"@bison-lab/payload-core/admin#ContrastReport\";\n\n/**\n * Document path for each editable `ThemeConfig` key. Locked with `satisfies`\n * so a new config field without a Theme field (or the reverse) fails at\n * compile time. `darkSelector` and `fontWeights` are seed-only.\n */\nexport const THEME_FIELD_PATHS = {\n  brandPrimary: \"brand.primary\",\n  brandSecondary: \"brand.secondary\",\n  brandAccent: \"brand.accent\",\n  brandHighlight: \"brand.highlight\",\n  brandSuccess: \"brand.success\",\n  greyScale: \"greyScale\",\n  defaultTheme: \"defaultTheme\",\n  radius: \"radius\",\n  shadow: \"shadow\",\n  motion: \"motion\",\n  density: \"density\",\n  fontBody: \"fonts.body\",\n  fontHeading: \"fonts.heading\",\n} as const satisfies Record<keyof EditableTheme, string>;\n\nexport type ThemeFieldPath = (typeof THEME_FIELD_PATHS)[keyof typeof THEME_FIELD_PATHS];\n\n/** Empty select value for heading: same family as body. */\nexport const SAME_AS_BODY = \"\";\n\nexport function headingSelectValue(heading: ThemeConfig[\"fontHeading\"]): string {\n  return heading ?? SAME_AS_BODY;\n}\n","import { isThemeHex, type ThemeConfig } from \"@bison-lab/tokens\";\n\nimport { SAME_AS_BODY } from \"./fields\";\nimport type { ThemeDoc } from \"./types\";\n\nfunction pick<T>(value: T | null | undefined, fallback: T): T {\n  return value == null ? fallback : value;\n}\n\nfunction headingFromDoc(\n  heading: string | null | undefined,\n  seed: ThemeConfig[\"fontHeading\"],\n): string | null {\n  if (heading === undefined) return seed;\n  if (heading === null || heading === SAME_AS_BODY) return null;\n  return heading;\n}\n\n/**\n * Nested Theme document → flat `ThemeConfig`. Null or missing editor\n * fields take the seed; `darkSelector` and `fontWeights` always come from\n * the seed.\n */\nexport function themeConfigFromDoc(doc: ThemeDoc | null | undefined, seed: ThemeConfig): ThemeConfig {\n  const brand = doc?.brand;\n  return {\n    brandPrimary: pick(brand?.primary, seed.brandPrimary),\n    brandSecondary: pick(brand?.secondary, seed.brandSecondary),\n    brandAccent: pick(brand?.accent, seed.brandAccent),\n    brandHighlight: pick(brand?.highlight, seed.brandHighlight),\n    brandSuccess: pick(brand?.success, seed.brandSuccess),\n    greyScale: pick(doc?.greyScale, seed.greyScale),\n    radius: pick(doc?.radius, seed.radius),\n    shadow: pick(doc?.shadow, seed.shadow),\n    motion: pick(doc?.motion, seed.motion),\n    density: pick(doc?.density, seed.density),\n    defaultTheme: pick(doc?.defaultTheme, seed.defaultTheme),\n    fontBody: pick(doc?.fonts?.body, seed.fontBody),\n    fontHeading: headingFromDoc(doc?.fonts?.heading, seed.fontHeading),\n    darkSelector: seed.darkSelector,\n    fontWeights: seed.fontWeights,\n  };\n}\n\n/** The document `seedTheme` writes so a fresh Global matches the seed config. */\nexport function docFromConfig(config: ThemeConfig): ThemeDoc {\n  return {\n    brand: {\n      primary: config.brandPrimary,\n      secondary: config.brandSecondary,\n      accent: config.brandAccent,\n      highlight: config.brandHighlight,\n      success: config.brandSuccess,\n    },\n    greyScale: config.greyScale,\n    radius: config.radius,\n    shadow: config.shadow,\n    motion: config.motion,\n    density: config.density,\n    defaultTheme: config.defaultTheme,\n    fonts: {\n      body: config.fontBody,\n      heading: config.fontHeading,\n    },\n  };\n}\n\nexport function validateThemeHex(value: unknown): true | string {\n  if (!isThemeHex(value)) return \"Enter a six-digit hex colour like #1e3a5f\";\n  return true;\n}\n","import type { Access } from \"payload\";\nimport type { FontEntry } from \"@bison-lab/fonts\";\nimport type { ThemeConfig } from \"@bison-lab/tokens\";\n\n/**\n * The Theme document a site's generated types will describe. Optional and\n * nullable, no index signature: a generated Global is assignable to this,\n * never the reverse.\n */\nexport interface ThemeDoc {\n  brand?: {\n    primary?: string | null;\n    secondary?: string | null;\n    accent?: string | null;\n    highlight?: string | null;\n    success?: string | null;\n  } | null;\n  greyScale?: ThemeConfig[\"greyScale\"] | null;\n  radius?: ThemeConfig[\"radius\"] | null;\n  shadow?: ThemeConfig[\"shadow\"] | null;\n  motion?: ThemeConfig[\"motion\"] | null;\n  density?: ThemeConfig[\"density\"] | null;\n  defaultTheme?: ThemeConfig[\"defaultTheme\"] | null;\n  fonts?: {\n    body?: string | null;\n    heading?: string | null;\n  } | null;\n  logo?: number | string | ThemeUploadDoc | null;\n  logoMark?: number | string | ThemeUploadDoc | null;\n  _status?: \"draft\" | \"published\" | null;\n}\n\nexport interface ThemeUploadDoc {\n  id?: number | string | null;\n  url?: string | null;\n  alt?: string | null;\n}\n\n/**\n * What an editor can change. `darkSelector` and `fontWeights` stay on the\n * seed — they mean nothing in the admin — and `themeConfigFromDoc` puts\n * them back.\n */\nexport type EditableTheme = Omit<ThemeConfig, \"darkSelector\" | \"fontWeights\">;\n\nexport interface CreateThemeOptions {\n  /**\n   * Required, no default. Predicates live in each site's `src/platform`\n   * until BIS-43; pass `canManageBrand` as `update` (and typically\n   * `isAuthenticated` as `read`). `readVersions` / draft visibility follow\n   * `update`, so only a brand manager sees unpublished edits.\n   */\n  access: { read: Access; update: Access };\n  /** The site's `bison.config.json`. Every field's `defaultValue`, and the fallback `getPublishedTheme` returns. */\n  seed: ThemeConfig;\n  /** Default: the whole catalogue. */\n  fonts?: readonly FontEntry[];\n  /** Where the site's `serveFont` route answers, for the picker's specimens. Default `\"/fonts\"`. */\n  fontsBaseUrl?: string;\n  /** Body-text target the contrast report judges against. Default `4.5`. */\n  contrastTarget?: number;\n  /**\n   * Code-owned preview route. When set, `createTheme` wires\n   * `admin.livePreview.url` to it and `THEME_PREVIEW_BREAKPOINTS`.\n   * Omit it and the pane stays closed — a site that has not built the\n   * route does not get an empty iframe.\n   */\n  previewPath?: string;\n  /** Adds `logo` and `logoMark` upload relations when given. */\n  logo?: { collection: string };\n  /** Fires from `afterChange` on a published save only, not an autosaved draft. */\n  onPublish?: (theme: ThemeConfig, doc: ThemeDoc) => void | Promise<void>;\n}\n\nexport interface ThemeHeadOptions {\n  fontsBaseUrl?: string;\n  attribute?: \"class\" | \"data-theme\";\n}\n\nexport interface ThemeHead {\n  css: string;\n  preloads: { href: string; type: \"font/woff2\" }[];\n}\n\nexport const THEME_SLUG = \"theme\";\n"],"mappings":";;AAIA,MAAa,oBAAoB;AACjC,MAAa,mBAAmB;AAChC,MAAa,wBAAwB;AA4BrC,SAAgB,mBAAmB,SAA6C;AAC9E,QAAO,WAAA;;;;AC9BT,SAAS,KAAQ,OAA6B,UAAgB;AAC5D,QAAO,SAAS,OAAO,WAAW;;AAGpC,SAAS,eACP,SACA,MACe;AACf,KAAI,YAAY,KAAA,EAAW,QAAO;AAClC,KAAI,YAAY,QAAQ,YAAA,GAA0B,QAAO;AACzD,QAAO;;;;;;;AAQT,SAAgB,mBAAmB,KAAkC,MAAgC;CACnG,MAAM,QAAQ,KAAK;AACnB,QAAO;EACL,cAAc,KAAK,OAAO,SAAS,KAAK,aAAa;EACrD,gBAAgB,KAAK,OAAO,WAAW,KAAK,eAAe;EAC3D,aAAa,KAAK,OAAO,QAAQ,KAAK,YAAY;EAClD,gBAAgB,KAAK,OAAO,WAAW,KAAK,eAAe;EAC3D,cAAc,KAAK,OAAO,SAAS,KAAK,aAAa;EACrD,WAAW,KAAK,KAAK,WAAW,KAAK,UAAU;EAC/C,QAAQ,KAAK,KAAK,QAAQ,KAAK,OAAO;EACtC,QAAQ,KAAK,KAAK,QAAQ,KAAK,OAAO;EACtC,QAAQ,KAAK,KAAK,QAAQ,KAAK,OAAO;EACtC,SAAS,KAAK,KAAK,SAAS,KAAK,QAAQ;EACzC,cAAc,KAAK,KAAK,cAAc,KAAK,aAAa;EACxD,UAAU,KAAK,KAAK,OAAO,MAAM,KAAK,SAAS;EAC/C,aAAa,eAAe,KAAK,OAAO,SAAS,KAAK,YAAY;EAClE,cAAc,KAAK;EACnB,aAAa,KAAK;EACnB;;;AAIH,SAAgB,cAAc,QAA+B;AAC3D,QAAO;EACL,OAAO;GACL,SAAS,OAAO;GAChB,WAAW,OAAO;GAClB,QAAQ,OAAO;GACf,WAAW,OAAO;GAClB,SAAS,OAAO;GACjB;EACD,WAAW,OAAO;EAClB,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,SAAS,OAAO;EAChB,cAAc,OAAO;EACrB,OAAO;GACL,MAAM,OAAO;GACb,SAAS,OAAO;GACjB;EACF;;AAGH,SAAgB,iBAAiB,OAA+B;AAC9D,KAAI,CAAC,WAAW,MAAM,CAAE,QAAO;AAC/B,QAAO;;;;ACeT,MAAa,aAAa"}

package/dist/{types-B3FC9sdF.d.mts → types-pFpmDeSA.d.mts}

@@ -61,8 +61,10 @@ interface CreateThemeOptions {
   /** Body-text target the contrast report judges against. Default `4.5`. */
   contrastTarget?: number;
   /**
-   * Stored on `admin.custom` for BIS-61, which wires `admin.livePreview`.
-   * This slice does not open a preview pane.
+   * Code-owned preview route. When set, `createTheme` wires
+   * `admin.livePreview.url` to it and `THEME_PREVIEW_BREAKPOINTS`.
+   * Omit it and the pane stays closed — a site that has not built the
+   * route does not get an empty iframe.
    */
   previewPath?: string;
   /** Adds `logo` and `logoMark` upload relations when given. */
@@ -86,4 +88,4 @@ interface ThemeHead {
 declare const THEME_SLUG = "theme";
 //#endregion
 export { ThemeHead as a, ThemeDoc as i, EditableTheme as n, ThemeHeadOptions as o, THEME_SLUG as r, ThemeUploadDoc as s, CreateThemeOptions as t };
-//# sourceMappingURL=types-B3FC9sdF.d.mts.map
+//# sourceMappingURL=types-pFpmDeSA.d.mts.map

package/dist/{types-B3FC9sdF.d.mts.map → types-pFpmDeSA.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-B3FC9sdF.d.mts","names":[],"sources":["../src/theme/types.ts"],"mappings":";;;;;;;AASA;;;UAAiB,QAAA;EACf,KAAA;IACE,OAAA;IACA,SAAA;IACA,MAAA;IACA,SAAA;IACA,OAAA;EAAA;EAEF,SAAA,GAAY,WAAA;EACZ,MAAA,GAAS,WAAA;EACT,MAAA,GAAS,WAAA;EACT,MAAA,GAAS,WAAA;EACT,OAAA,GAAU,WAAA;EACV,YAAA,GAAe,WAAA;EACf,KAAA;IACE,IAAA;IACA,OAAA;EAAA;EAEF,IAAA,qBAAyB,cAAA;EACzB,QAAA,qBAA6B,cAAA;EAC7B,OAAA;AAAA;AAAA,UAGe,cAAA;EACf,EAAA;EACA,GAAA;EACA,GAAA;AAAA;;;;;;KAQU,aAAA,GAAgB,IAAA,CAAK,WAAA;AAAA,UAEhB,kBAAA;EAjBc;;;;AAI/B;;EAoBE,MAAA;IAAU,IAAA,EAAM,MAAA;IAAQ,MAAA,EAAQ,MAAA;EAAA;EAjBhC;EAmBA,IAAA,EAAM,WAAA;EAnBH;EAqBH,KAAA,YAAiB,SAAA;EAbM;EAevB,YAAA;EAf0B;EAiB1B,cAAA;EAfe;;;;EAoBf,WAAA;EAXM;EAaN,IAAA;IAAS,UAAA;EAAA;EAEiD;EAA1D,SAAA,IAAa,KAAA,EAAO,WAAA,EAAa,GAAA,EAAK,QAAA,YAAoB,OAAA;AAAA;AAAA,UAG3C,gBAAA;EACf,YAAA;EACA,SAAA;AAAA;AAAA,UAGe,SAAA;EACf,GAAA;EACA,QAAA;IAAY,IAAA;IAAc,IAAA;EAAA;AAAA;AAAA,cAGf,UAAA"}
+{"version":3,"file":"types-pFpmDeSA.d.mts","names":[],"sources":["../src/theme/types.ts"],"mappings":";;;;;;;AASA;;;UAAiB,QAAA;EACf,KAAA;IACE,OAAA;IACA,SAAA;IACA,MAAA;IACA,SAAA;IACA,OAAA;EAAA;EAEF,SAAA,GAAY,WAAA;EACZ,MAAA,GAAS,WAAA;EACT,MAAA,GAAS,WAAA;EACT,MAAA,GAAS,WAAA;EACT,OAAA,GAAU,WAAA;EACV,YAAA,GAAe,WAAA;EACf,KAAA;IACE,IAAA;IACA,OAAA;EAAA;EAEF,IAAA,qBAAyB,cAAA;EACzB,QAAA,qBAA6B,cAAA;EAC7B,OAAA;AAAA;AAAA,UAGe,cAAA;EACf,EAAA;EACA,GAAA;EACA,GAAA;AAAA;;;;;;KAQU,aAAA,GAAgB,IAAA,CAAK,WAAA;AAAA,UAEhB,kBAAA;EAjBc;;;;AAI/B;;EAoBE,MAAA;IAAU,IAAA,EAAM,MAAA;IAAQ,MAAA,EAAQ,MAAA;EAAA;EAjBhC;EAmBA,IAAA,EAAM,WAAA;EAnBH;EAqBH,KAAA,YAAiB,SAAA;EAbM;EAevB,YAAA;EAf0B;EAiB1B,cAAA;EAfe;;;;;;EAsBf,WAAA;EAIoB;EAFpB,IAAA;IAAS,UAAA;EAAA;EAEwD;EAAjE,SAAA,IAAa,KAAA,EAAO,WAAA,EAAa,GAAA,EAAK,QAAA,YAAoB,OAAA;AAAA;AAAA,UAG3C,gBAAA;EACf,YAAA;EACA,SAAA;AAAA;AAAA,UAGe,SAAA;EACf,GAAA;EACA,QAAA;IAAY,IAAA;IAAc,IAAA;EAAA;AAAA;AAAA,cAGf,UAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bison-lab/payload-core",
-  "version": "3.7.0",
+  "version": "3.8.0",
   "description": "Site-agnostic Payload CMS configuration for Bison Lab sites: the SEO tab, the Theme global, and the metadata and theme readers for the pages they describe",
   "homepage": "https://components.bisonlab.ai",
   "repository": {
@@ -30,6 +30,10 @@
     "./admin": {
       "import": "./dist/admin.mjs",
       "types": "./dist/admin.d.mts"
+    },
+    "./react": {
+      "import": "./dist/react.mjs",
+      "types": "./dist/react.d.mts"
     }
   },
   "files": [
@@ -38,6 +42,8 @@
   "peerDependencies": {
     "@bison-lab/fonts": "^3.0.0",
     "@bison-lab/tokens": "^3.0.0",
+    "@bison-lab/ui": "^3.0.0",
+    "@payloadcms/live-preview-react": "^3.0.0",
     "@payloadcms/plugin-seo": "^3.0.0",
     "@payloadcms/ui": "^3.0.0",
     "payload": "^3.0.0",
@@ -50,6 +56,12 @@
     "@bison-lab/tokens": {
       "optional": true
     },
+    "@bison-lab/ui": {
+      "optional": true
+    },
+    "@payloadcms/live-preview-react": {
+      "optional": true
+    },
     "@payloadcms/ui": {
       "optional": true
     },
@@ -58,6 +70,7 @@
     }
   },
   "devDependencies": {
+    "@payloadcms/live-preview-react": "^3.88.0",
     "@payloadcms/plugin-seo": "^3.88.0",
     "@payloadcms/ui": "^3.88.0",
     "@testing-library/jest-dom": "^6.9.1",
@@ -70,8 +83,9 @@
     "tsdown": "^0.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.1.2",
-    "@bison-lab/fonts": "3.6.0",
-    "@bison-lab/tokens": "3.7.0"
+    "@bison-lab/tokens": "3.7.0",
+    "@bison-lab/ui": "3.7.0",
+    "@bison-lab/fonts": "3.6.0"
   },
   "publishConfig": {
     "access": "public"