@bison-lab/payload-core 0.1.0 → 3.8.0

package/dist/theme.mjs

@@ -0,0 +1,39 @@
+import { r as themeConfigFromDoc, t as THEME_SLUG } from "./types-DWwL-JEr.mjs";
+import { fontFaceCss, fontPreloads } from "@bison-lab/fonts";
+import { buildThemeCss, themeFontIds } from "@bison-lab/tokens";
+//#region src/theme/published.ts
+/**
+* The published Theme, or `seed` when nothing has been published. A newer
+* draft never reaches the public site (`draft: false`). Access is
+* overridden so a logged-out request still gets the published colours.
+*/
+async function getPublishedTheme(payload, seed) {
+	return themeConfigFromDoc(await payload.findGlobal({
+		slug: "theme",
+		draft: false,
+		depth: 0,
+		overrideAccess: true
+	}) ?? {}, seed);
+}
+//#endregion
+//#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
+export { THEME_SLUG, getPublishedTheme, themeConfigFromDoc, themeHead };
+
+//# sourceMappingURL=theme.mjs.map

package/dist/theme.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.mjs","names":[],"sources":["../src/theme/published.ts","../src/theme/head.ts"],"sourcesContent":["import type { ThemeConfig } from \"@bison-lab/tokens\";\n\nimport { themeConfigFromDoc } from \"./map\";\nimport { THEME_SLUG } from \"./types\";\nimport type { ThemeDoc } from \"./types\";\n\nexport interface ThemePayload {\n  findGlobal: (args: {\n    slug: string;\n    draft?: boolean;\n    depth?: number;\n    overrideAccess?: boolean;\n  }) => Promise<ThemeDoc | null | undefined>;\n}\n\n/**\n * The published Theme, or `seed` when nothing has been published. A newer\n * draft never reaches the public site (`draft: false`). Access is\n * overridden so a logged-out request still gets the published colours.\n */\nexport async function getPublishedTheme(payload: ThemePayload, seed: ThemeConfig): Promise<ThemeConfig> {\n  const doc = await payload.findGlobal({\n    slug: THEME_SLUG,\n    draft: false,\n    depth: 0,\n    overrideAccess: true,\n  });\n  return themeConfigFromDoc(doc ?? {}, seed);\n}\n","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"],"mappings":";;;;;;;;;AAoBA,eAAsB,kBAAkB,SAAuB,MAAyC;AAOtG,QAAO,mBANK,MAAM,QAAQ,WAAW;EACnC,MAAA;EACA,OAAO;EACP,OAAO;EACP,gBAAgB;EACjB,CAAC,IAC+B,EAAE,EAAE,KAAK;;;;;;;;;;AChB5C,SAAgB,UAAU,QAAqB,UAA4B,EAAE,EAAa;CACxF,MAAM,eAAe,QAAQ,gBAAgB;CAC7C,MAAM,MAAM,aAAa,OAAO;CAChC,MAAM,QAAQ,YAAY,KAAK,aAAa;CAC5C,MAAM,QAAQ,cAAc,QAAQ,EAAE,WAAW,QAAQ,WAAW,CAAC;AACrE,QAAO;EACL,KAAK,QAAQ,GAAG,MAAM,MAAM,UAAU;EACtC,UAAU,aAAa,KAAK,aAAa;EAC1C"}

package/dist/{title-Wut0nzJQ.d.mts → title-B2-gWQZd.d.mts}

@@ -52,4 +52,4 @@ declare function documentTitle(siteName: string, pageTitle: string): string;
 declare function titleTemplate(siteName: string): string;
 //#endregion
 export { SeoImageSize as a, SeoImageDoc as i, titleTemplate as n, SeoImageValue as o, MediaId as r, SeoMeta as s, documentTitle as t };
-//# sourceMappingURL=title-Wut0nzJQ.d.mts.map
+//# sourceMappingURL=title-B2-gWQZd.d.mts.map

package/dist/{title-Wut0nzJQ.d.mts.map → title-B2-gWQZd.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"title-Wut0nzJQ.d.mts","names":[],"sources":["../src/seo/types.ts","../src/seo/title.ts"],"mappings":";;KACY,OAAA;;UAGK,YAAA;EACf,GAAA;EACA,KAAA;EACA,MAAA;AAAA;;;;;;;;AAWF;UAAiB,WAAA;EACf,GAAA;EACA,GAAA;EACA,KAAA;EACA,MAAA;EACA,KAAA;IAAA,CAAW,IAAA,WAAe,YAAA;EAAA;AAAA;;KAIhB,aAAA,GAAgB,OAAA,GAAU,WAAA;;AAAtC;;;UAMiB,OAAA;EACf,KAAA;EACA,WAAA;EACA,KAAA,GAAQ,aAAA;EACR,OAAA;AAAA;;;;AApCF;;;;;iBCKgB,aAAA,CAAc,QAAA,UAAkB,SAAA;;;;;iBAQhC,aAAA,CAAc,QAAA"}
+{"version":3,"file":"title-B2-gWQZd.d.mts","names":[],"sources":["../src/seo/types.ts","../src/seo/title.ts"],"mappings":";;KACY,OAAA;;UAGK,YAAA;EACf,GAAA;EACA,KAAA;EACA,MAAA;AAAA;;;;;;;;AAWF;UAAiB,WAAA;EACf,GAAA;EACA,GAAA;EACA,KAAA;EACA,MAAA;EACA,KAAA;IAAA,CAAW,IAAA,WAAe,YAAA;EAAA;AAAA;;KAIhB,aAAA,GAAgB,OAAA,GAAU,WAAA;;AAAtC;;;UAMiB,OAAA;EACf,KAAA;EACA,WAAA;EACA,KAAA,GAAQ,aAAA;EACR,OAAA;AAAA;;;;AApCF;;;;;iBCKgB,aAAA,CAAc,QAAA,UAAkB,SAAA;;;;;iBAQhC,aAAA,CAAc,QAAA"}

package/dist/types-DWwL-JEr.mjs

@@ -0,0 +1,76 @@
+import { isThemeHex } from "@bison-lab/tokens";
+//#region src/theme/fields.ts
+const THEME_COLOR_FIELD = "@bison-lab/payload-core/admin#ColorField";
+const THEME_FONT_FIELD = "@bison-lab/payload-core/admin#FontField";
+const THEME_CONTRAST_REPORT = "@bison-lab/payload-core/admin#ContrastReport";
+function headingSelectValue(heading) {
+	return heading ?? "";
+}
+//#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
+		}
+	};
+}
+function validateThemeHex(value) {
+	if (!isThemeHex(value)) return "Enter a six-digit hex colour like #1e3a5f";
+	return true;
+}
+//#endregion
+//#region src/theme/types.ts
+const THEME_SLUG = "theme";
+//#endregion
+export { THEME_COLOR_FIELD as a, headingSelectValue as c, validateThemeHex as i, docFromConfig as n, THEME_CONTRAST_REPORT as o, themeConfigFromDoc as r, THEME_FONT_FIELD as s, THEME_SLUG as t };
+
+//# sourceMappingURL=types-DWwL-JEr.mjs.map

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

@@ -0,0 +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   * 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-pFpmDeSA.d.mts

@@ -0,0 +1,91 @@
+import { FontEntry } from "@bison-lab/fonts";
+import { ThemeConfig } from "@bison-lab/tokens";
+import { Access } from "payload";
+
+//#region src/theme/types.d.ts
+/**
+ * The Theme document a site's generated types will describe. Optional and
+ * nullable, no index signature: a generated Global is assignable to this,
+ * never the reverse.
+ */
+interface ThemeDoc {
+  brand?: {
+    primary?: string | null;
+    secondary?: string | null;
+    accent?: string | null;
+    highlight?: string | null;
+    success?: string | null;
+  } | null;
+  greyScale?: ThemeConfig["greyScale"] | null;
+  radius?: ThemeConfig["radius"] | null;
+  shadow?: ThemeConfig["shadow"] | null;
+  motion?: ThemeConfig["motion"] | null;
+  density?: ThemeConfig["density"] | null;
+  defaultTheme?: ThemeConfig["defaultTheme"] | null;
+  fonts?: {
+    body?: string | null;
+    heading?: string | null;
+  } | null;
+  logo?: number | string | ThemeUploadDoc | null;
+  logoMark?: number | string | ThemeUploadDoc | null;
+  _status?: "draft" | "published" | null;
+}
+interface ThemeUploadDoc {
+  id?: number | string | null;
+  url?: string | null;
+  alt?: string | null;
+}
+/**
+ * What an editor can change. `darkSelector` and `fontWeights` stay on the
+ * seed — they mean nothing in the admin — and `themeConfigFromDoc` puts
+ * them back.
+ */
+type EditableTheme = Omit<ThemeConfig, "darkSelector" | "fontWeights">;
+interface CreateThemeOptions {
+  /**
+   * Required, no default. Predicates live in each site's `src/platform`
+   * until BIS-43; pass `canManageBrand` as `update` (and typically
+   * `isAuthenticated` as `read`). `readVersions` / draft visibility follow
+   * `update`, so only a brand manager sees unpublished edits.
+   */
+  access: {
+    read: Access;
+    update: Access;
+  };
+  /** The site's `bison.config.json`. Every field's `defaultValue`, and the fallback `getPublishedTheme` returns. */
+  seed: ThemeConfig;
+  /** Default: the whole catalogue. */
+  fonts?: readonly FontEntry[];
+  /** Where the site's `serveFont` route answers, for the picker's specimens. Default `"/fonts"`. */
+  fontsBaseUrl?: string;
+  /** Body-text target the contrast report judges against. Default `4.5`. */
+  contrastTarget?: number;
+  /**
+   * 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. */
+  logo?: {
+    collection: string;
+  };
+  /** Fires from `afterChange` on a published save only, not an autosaved draft. */
+  onPublish?: (theme: ThemeConfig, doc: ThemeDoc) => void | Promise<void>;
+}
+interface ThemeHeadOptions {
+  fontsBaseUrl?: string;
+  attribute?: "class" | "data-theme";
+}
+interface ThemeHead {
+  css: string;
+  preloads: {
+    href: string;
+    type: "font/woff2";
+  }[];
+}
+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-pFpmDeSA.d.mts.map

package/dist/types-pFpmDeSA.d.mts.map

@@ -0,0 +1 @@
+{"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,7 +1,7 @@
 {
   "name": "@bison-lab/payload-core",
-  "version": "0.1.0",
-  "description": "Site-agnostic Payload CMS configuration for Bison Lab sites: the SEO tab on a collection and the metadata reader for the pages it describes",
+  "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": {
     "type": "git",
@@ -22,21 +22,70 @@
     "./metadata": {
       "import": "./dist/metadata.mjs",
       "types": "./dist/metadata.d.mts"
+    },
+    "./theme": {
+      "import": "./dist/theme.mjs",
+      "types": "./dist/theme.d.mts"
+    },
+    "./admin": {
+      "import": "./dist/admin.mjs",
+      "types": "./dist/admin.d.mts"
+    },
+    "./react": {
+      "import": "./dist/react.mjs",
+      "types": "./dist/react.d.mts"
     }
   },
   "files": [
     "dist"
   ],
   "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",
-    "payload": "^3.0.0"
+    "@payloadcms/ui": "^3.0.0",
+    "payload": "^3.0.0",
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@bison-lab/fonts": {
+      "optional": true
+    },
+    "@bison-lab/tokens": {
+      "optional": true
+    },
+    "@bison-lab/ui": {
+      "optional": true
+    },
+    "@payloadcms/live-preview-react": {
+      "optional": true
+    },
+    "@payloadcms/ui": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
   },
   "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",
+    "@testing-library/react": "^16.3.2",
+    "@types/react": "^19.2.14",
+    "jsdom": "^29.0.1",
     "payload": "^3.88.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
     "tsdown": "^0.21.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.2",
+    "@bison-lab/tokens": "3.7.0",
+    "@bison-lab/ui": "3.7.0",
+    "@bison-lab/fonts": "3.6.0"
   },
   "publishConfig": {
     "access": "public"