@bison-lab/payload-core 3.11.0 → 3.12.0

package/dist/identity-DZOb3_Gk.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"identity-DZOb3_Gk.mjs","names":[],"sources":["../src/theme/fields.ts","../src/theme/map.ts","../src/theme/types.ts","../src/theme/library.ts","../src/theme/looks.ts","../src/theme/look-field.ts","../src/theme/identity.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_COLOR_SCALE_FIELD = \"@bison-lab/payload-core/admin#ColorScaleField\";\nexport const THEME_LIBRARY_FIELD = \"@bison-lab/payload-core/admin#LibraryField\";\nexport const THEME_FONT_FIELD = \"@bison-lab/payload-core/admin#FontField\";\nexport const THEME_PAIRING_FIELD = \"@bison-lab/payload-core/admin#PairingField\";\nexport const THEME_APPEARANCE_FIELD = \"@bison-lab/payload-core/admin#AppearanceField\";\nexport const THEME_GREY_SCALE_FIELD = \"@bison-lab/payload-core/admin#GreyScaleField\";\nexport const THEME_CONTRAST_REPORT = \"@bison-lab/payload-core/admin#ContrastReport\";\nexport const THEME_SECTION_HEADING = \"@bison-lab/payload-core/admin#SectionHeading\";\nexport const THEME_PUBLISH_FIELD = \"@bison-lab/payload-core/admin#PublishChild\";\nexport const THEME_SAVE_BUTTON = \"@bison-lab/payload-core/admin#HiddenSaveButton\";\nexport const THEME_DOCUMENT_CONTROLS = \"@bison-lab/payload-core/admin#ThemeDocumentControls\";\nexport const THEME_IDENTITY_FALLBACK = \"@bison-lab/payload-core/admin#IdentityFallback\";\nexport const LOOK_FIELD = \"@bison-lab/payload-core/admin#LookField\";\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: \"colors.brand.primary.hex\",\n  brandSecondary: \"colors.brand.secondary.hex\",\n  brandAccent: \"colors.brand.accent.hex\",\n  brandHighlight: \"colors.brand.highlight.hex\",\n  brandSuccess: \"colors.brand.success.hex\",\n  brandDestructive: \"colors.brand.destructive.hex\",\n  greyScale: \"colors.greyScale\",\n  defaultTheme: \"appearance.defaultTheme\",\n  radius: \"appearance.radius\",\n  shadow: \"appearance.shadow\",\n  motion: \"appearance.motion\",\n  density: \"appearance.density\",\n  fontBody: \"typography.body\",\n  fontHeading: \"typography.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 {\n  createColorScale,\n  DESTRUCTIVE_SCALE_HEX,\n  generateColorScale,\n  isThemeHex,\n  SHADE_STEPS,\n  type ColorScale,\n  type ColorScaleInclude,\n  type ColorScaleState,\n  type ShadeStep,\n  type ThemeConfig,\n} from \"@bison-lab/tokens\";\n\nimport { SAME_AS_BODY } from \"./fields\";\nimport type { ThemeColorDoc, 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\nfunction hexFromColor(value: ThemeColorDoc | string | null | undefined, fallback: string): string {\n  if (typeof value === \"string\") return value || fallback;\n  return pick(value?.hex, fallback);\n}\n\nexport function colorDocFromHex(hex: string, sourceStep: ShadeStep = 500): ThemeColorDoc {\n  return colorDocFromState(createColorScale(hex, sourceStep));\n}\n\nexport function colorDocFromState(state: ColorScaleState): ThemeColorDoc {\n  return {\n    hex: state.hex,\n    sourceStep: state.sourceStep,\n    scale: state.scale,\n    stale: state.stale,\n    include: Array.isArray(state.include) ? \"custom\" : state.include,\n    includedSteps: Array.isArray(state.include) ? [...state.include] : undefined,\n  };\n}\n\nexport function stateFromColorDoc(\n  doc: ThemeColorDoc | null | undefined,\n  fallbackHex = \"#000000\",\n): ColorScaleState {\n  const hex = isThemeHex(doc?.hex) ? doc.hex : fallbackHex;\n  const sourceStep = (Number(doc?.sourceStep) || 500) as ShadeStep;\n  const include = includeFromDoc(doc, sourceStep);\n  const scale =\n    doc?.scale && typeof doc.scale === \"object\" ? (doc.scale as ColorScale) : generateColorScale(hex, sourceStep);\n  return { hex, sourceStep, scale, stale: Boolean(doc?.stale), include };\n}\n\nfunction includeFromDoc(doc: ThemeColorDoc | null | undefined, sourceStep: ShadeStep): ColorScaleInclude {\n  if (doc?.include === \"source\") return \"source\";\n  if (doc?.include === \"custom\" && Array.isArray(doc.includedSteps)) {\n    const steps = doc.includedSteps.map(Number).filter((step): step is ShadeStep => SHADE_STEPS.includes(step as ShadeStep));\n    if (!steps.includes(sourceStep)) steps.push(sourceStep);\n    return steps;\n  }\n  return \"all\";\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. Reads the BIS-87 groups and the pre-BIS-87 flat fields.\n */\nexport function themeConfigFromDoc(doc: ThemeDoc | null | undefined, seed: ThemeConfig): ThemeConfig {\n  const brand = doc?.colors?.brand ?? doc?.brand;\n  const typography = doc?.typography ?? doc?.fonts;\n  const appearance = doc?.appearance;\n  return {\n    brandPrimary: hexFromColor(brand?.primary, seed.brandPrimary),\n    brandSecondary: hexFromColor(brand?.secondary, seed.brandSecondary),\n    brandAccent: hexFromColor(brand?.accent, seed.brandAccent),\n    brandHighlight: hexFromColor(brand?.highlight, seed.brandHighlight),\n    brandSuccess: hexFromColor(brand?.success, seed.brandSuccess),\n    brandDestructive:\n      hexFromColor(brand?.destructive, seed.brandDestructive ?? DESTRUCTIVE_SCALE_HEX) ||\n      seed.brandDestructive ||\n      DESTRUCTIVE_SCALE_HEX,\n    greyScale: pick(doc?.colors?.greyScale ?? doc?.greyScale, seed.greyScale),\n    radius: pick(appearance?.radius ?? doc?.radius, seed.radius),\n    shadow: pick(appearance?.shadow ?? doc?.shadow, seed.shadow),\n    motion: pick(appearance?.motion ?? doc?.motion, seed.motion),\n    density: pick(appearance?.density ?? doc?.density, seed.density),\n    defaultTheme: pick(appearance?.defaultTheme ?? doc?.defaultTheme, seed.defaultTheme),\n    fontBody: pick(typography?.body, seed.fontBody),\n    fontHeading: headingFromDoc(typography?.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, destructive?: string): ThemeDoc {\n  const destructiveHex = destructive ?? config.brandDestructive ?? DESTRUCTIVE_SCALE_HEX;\n  return {\n    colors: {\n      brand: {\n        primary: colorDocFromHex(config.brandPrimary),\n        secondary: colorDocFromHex(config.brandSecondary),\n        accent: colorDocFromHex(config.brandAccent),\n        highlight: colorDocFromHex(config.brandHighlight),\n        success: colorDocFromHex(config.brandSuccess),\n        destructive: colorDocFromHex(destructiveHex),\n      },\n      library: [],\n      greyScale: config.greyScale,\n    },\n    typography: {\n      body: config.fontBody,\n      heading: config.fontHeading,\n    },\n    appearance: {\n      defaultTheme: config.defaultTheme,\n      radius: config.radius,\n      shadow: config.shadow,\n      motion: config.motion,\n      density: config.density,\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\nexport function validateSourceIncluded(\n  value: unknown,\n  { siblingData }: { siblingData?: { sourceStep?: unknown; include?: unknown } },\n): true | string {\n  const include = siblingData?.include;\n  if (include === \"all\" || include === \"source\") return true;\n  const source = Number(siblingData?.sourceStep);\n  const steps = Array.isArray(value) ? value.map(Number) : [];\n  if (!SHADE_STEPS.includes(source as ShadeStep)) return true;\n  if (!steps.includes(source)) return \"The source step cannot be excluded\";\n  return true;\n}\n","import type { Access } from \"payload\";\nimport type { FontEntry } from \"@bison-lab/fonts\";\nimport type { ColorScale, ColorScaleInclude, ShadeStep, ThemeConfig } from \"@bison-lab/tokens\";\n\nimport type { ResolvedThemeIdentity, ThemeIdentityFallback } from \"./identity\";\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 *\n * Legacy flat `brand.*` hexes, `fonts`, and preset fields at the root stay\n * readable so `getPublishedTheme` still maps a pre-BIS-87 row.\n */\nexport interface ThemeColorDoc {\n  hex?: string | null;\n  sourceStep?: ShadeStep | string | null;\n  scale?: ColorScale | null;\n  stale?: boolean | null;\n  include?: ColorScaleInclude | \"custom\" | null;\n  includedSteps?: ShadeStep[] | string[] | null;\n}\n\nexport interface ThemeLibraryColorDoc extends ThemeColorDoc {\n  key?: string | null;\n  label?: string | null;\n}\n\nexport interface ThemeDoc {\n  colors?: {\n    brand?: {\n      primary?: ThemeColorDoc | string | null;\n      secondary?: ThemeColorDoc | string | null;\n      accent?: ThemeColorDoc | string | null;\n      highlight?: ThemeColorDoc | string | null;\n      success?: ThemeColorDoc | string | null;\n      destructive?: ThemeColorDoc | string | null;\n    } | null;\n    library?: ThemeLibraryColorDoc[] | null;\n    greyScale?: ThemeConfig[\"greyScale\"] | null;\n  } | null;\n  typography?: {\n    body?: string | null;\n    heading?: string | null;\n  } | null;\n  appearance?: {\n    defaultTheme?: ThemeConfig[\"defaultTheme\"] | null;\n    radius?: ThemeConfig[\"radius\"] | null;\n    shadow?: ThemeConfig[\"shadow\"] | null;\n    motion?: ThemeConfig[\"motion\"] | null;\n    density?: ThemeConfig[\"density\"] | null;\n  } | null;\n  /** @deprecated Pre-BIS-87 flat brand hexes. */\n  brand?: {\n    primary?: ThemeColorDoc | string | null;\n    secondary?: ThemeColorDoc | string | null;\n    accent?: ThemeColorDoc | string | null;\n    highlight?: ThemeColorDoc | string | null;\n    success?: ThemeColorDoc | string | null;\n    destructive?: ThemeColorDoc | string | null;\n  } | null;\n  /** @deprecated Pre-BIS-87; now `colors.greyScale`. */\n  greyScale?: ThemeConfig[\"greyScale\"] | null;\n  /** @deprecated Pre-BIS-87; now `appearance.*`. */\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  /** @deprecated Pre-BIS-87; now `typography`. */\n  fonts?: {\n    body?: string | null;\n    heading?: string | null;\n  } | null;\n  logo?: number | string | ThemeUploadDoc | null;\n  favicon?: number | string | ThemeUploadDoc | null;\n  logoMark?: number | string | ThemeUploadDoc | 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`).\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  /**\n   * Destructive seed hex. Falls back to `seed.brandDestructive`, then\n   * the library's `DESTRUCTIVE_SCALE_HEX` (`#ef4444`).\n   */\n  destructive?: string;\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  /** Fill + automatic label target. Default `7`. Warnings never block save. */\n  contrastTarget?: number;\n  /**\n   * @deprecated Theme has no preview pane (SPI-56 canceled). Kept so a\n   * site that still passes it does not fail to boot.\n   */\n  previewPath?: string;\n  /**\n   * Adds the Identity page (logo, favicon, mobile-menu mark) when given.\n   * Pass `BRAND_ASSETS_SLUG` (or the slug you gave `createBrandAssets`).\n   * Save on that page writes only those uploads onto the stored Theme row.\n   */\n  logo?: { collection: string };\n  /**\n   * Fallback art when logo, favicon, or mobile-menu mark is empty. The\n   * site passes today's files; `--color-primary-mark` is not a Theme field.\n   */\n  identity?: { fallback?: ThemeIdentityFallback };\n  /** Fires from `afterChange` on every save — Theme has no draft mode. */\n  onPublish?: (theme: ThemeConfig, doc: ThemeDoc) => void | Promise<void>;\n}\n\nexport interface ThemeHeadOptions {\n  fontsBaseUrl?: string;\n  attribute?: \"class\" | \"data-theme\";\n  identity?: ResolvedThemeIdentity;\n  /**\n   * Custom Colors rows. `themeHead` emits their 50–950 variables and\n   * `[data-look]` bindings so a picker key paints without a package bump.\n   */\n  library?: ThemeLibraryColorDoc[] | null;\n}\n\nexport interface ThemeHead {\n  css: string;\n  preloads: { href: string; type: \"font/woff2\" }[];\n  identity?: ResolvedThemeIdentity;\n}\n\nexport const THEME_SLUG = \"theme\";\nexport const THEME_COLORS_SLUG = \"theme-colors\";\nexport const THEME_TYPOGRAPHY_SLUG = \"theme-typography\";\nexport const THEME_APPEARANCE_SLUG = \"theme-appearance\";\nexport const THEME_IDENTITY_SLUG = \"theme-identity\";\n\nexport const SYSTEM_COLOR_KEYS = [\n  \"primary\",\n  \"secondary\",\n  \"accent\",\n  \"highlight\",\n  \"success\",\n  \"destructive\",\n] as const;\n\nexport type SystemColorKey = (typeof SYSTEM_COLOR_KEYS)[number];\n","import { SHADE_STEPS, type ShadeStep } from \"@bison-lab/tokens\";\n\nimport { SYSTEM_COLOR_KEYS, type ThemeDoc, type ThemeLibraryColorDoc } from \"./types\";\n\n/**\n * Payload's array form state stores the row count (`0`, `2`, …), not the\n * rows. A custom Field that treats that number as the list will throw\n * `rows.filter is not a function` on an empty Theme library.\n */\nexport function asLibraryRows(value: unknown): ThemeLibraryColorDoc[] {\n  return Array.isArray(value) ? value : [];\n}\n\nconst STEP_SET = new Set<number>(SHADE_STEPS);\n\n/**\n * Page editors pick `coral-400`, never a raw hex. Rewrite every use of\n * `fromKey` onto `toKey` at the same step: `coral-400` → `highlight-400`.\n * A bare key (`coral`) becomes `toKey`. Anything else is left alone.\n */\nexport function rewriteColorToken(token: string, fromKey: string, toKey: string): string {\n  if (token === fromKey) return toKey;\n  const dash = token.lastIndexOf(\"-\");\n  if (dash <= 0) return token;\n  const key = token.slice(0, dash);\n  const step = Number(token.slice(dash + 1));\n  if (key !== fromKey || !STEP_SET.has(step)) return token;\n  return `${toKey}-${step as ShadeStep}`;\n}\n\nexport function themeColorKeys(doc: ThemeDoc | null | undefined): string[] {\n  const custom = asLibraryRows(doc?.colors?.library)\n    .map((row) => row.key?.trim())\n    .filter((key): key is string => Boolean(key));\n  return [...SYSTEM_COLOR_KEYS, ...custom];\n}\n\n/**\n * Remove a custom color. Unused: omit `replacement` and the row is gone.\n * In use: pass another system or custom key; the caller rewrites page\n * tokens with `rewriteColorToken`. After this, no library row still\n * has `key`.\n */\nexport function deleteLibraryColor(doc: ThemeDoc, key: string, replacement?: string): ThemeDoc {\n  const library = [...asLibraryRows(doc.colors?.library)];\n  const index = library.findIndex((row) => row.key === key);\n  if (index === -1) {\n    throw new Error(`No custom color named ${JSON.stringify(key)}`);\n  }\n  library.splice(index, 1);\n  const next: ThemeDoc = {\n    ...doc,\n    colors: { ...doc.colors, library },\n  };\n  if (replacement !== undefined) {\n    if (replacement === key) {\n      throw new Error(\"Replacement must be a different color\");\n    }\n    if (!themeColorKeys(next).includes(replacement)) {\n      throw new Error(`Replacement ${JSON.stringify(replacement)} is not a system or remaining custom color`);\n    }\n  }\n  return next;\n}\n","import { includedShadeSteps, type ShadeStep } from \"@bison-lab/tokens\";\n\nimport { stateFromColorDoc } from \"./map\";\nimport { THEME_SLUG, type ThemeColorDoc, type ThemeDoc, type ThemeLibraryColorDoc } from \"./types\";\n\n/**\n * System colors Color Settings offers as page-editor fills. Success and\n * Destructive stay off this list — they are theme chrome only.\n */\nexport const PAGE_EDITOR_SYSTEM_KEYS = [\"primary\", \"secondary\", \"accent\", \"highlight\"] as const;\n\nexport type PageEditorSystemKey = (typeof PAGE_EDITOR_SYSTEM_KEYS)[number];\n\nexport interface LookOption {\n  label: string;\n  value: string;\n}\n\nconst SYSTEM_LABELS: Record<PageEditorSystemKey, string> = {\n  primary: \"Primary\",\n  secondary: \"Secondary\",\n  accent: \"Accent\",\n  highlight: \"Highlight\",\n};\n\nfunction brandColor(doc: ThemeDoc | null | undefined, key: PageEditorSystemKey): ThemeColorDoc | null {\n  const brand = doc?.colors?.brand ?? doc?.brand;\n  const value = brand?.[key];\n  if (typeof value === \"string\" || value == null) return value == null ? null : { hex: value };\n  return value;\n}\n\nexport function themeLibraryFromDoc(doc: ThemeDoc | null | undefined): ThemeLibraryColorDoc[] {\n  return Array.isArray(doc?.colors?.library) ? doc.colors.library : [];\n}\n\nfunction libraryRows(doc: ThemeDoc | null | undefined): ThemeLibraryColorDoc[] {\n  return themeLibraryFromDoc(doc);\n}\n\nfunction titleCase(key: string): string {\n  return key.charAt(0).toUpperCase() + key.slice(1);\n}\n\nfunction stepsFor(color: ThemeColorDoc | null | undefined, fallbackHex: string): ShadeStep[] {\n  return includedShadeSteps(stateFromColorDoc(color, fallbackHex));\n}\n\n/**\n * Family keys a `lookField()` may offer: the page-editor system scales\n * plus every custom color on Colors. Adding Coral on Theme makes `coral`\n * appear here with no `@bison-lab/*` release.\n */\nexport function pageEditorLooks(doc: ThemeDoc | null | undefined): LookOption[] {\n  const system = PAGE_EDITOR_SYSTEM_KEYS.map((value) => ({\n    label: SYSTEM_LABELS[value],\n    value,\n  }));\n  const custom = libraryRows(doc)\n    .map((row) => {\n      const value = row.key?.trim();\n      if (!value) return null;\n      return { label: row.label?.trim() || titleCase(value), value };\n    })\n    .filter((option): option is LookOption => option !== null);\n  return [...system, ...custom];\n}\n\n/**\n * Included steps as `coral-400`. Excluded steps do not appear. System\n * scales with no stored include list offer the full 50–950 ramp.\n */\nexport function pageEditorTokens(doc: ThemeDoc | null | undefined): LookOption[] {\n  const tokens: LookOption[] = [];\n  for (const key of PAGE_EDITOR_SYSTEM_KEYS) {\n    const label = SYSTEM_LABELS[key];\n    for (const step of stepsFor(brandColor(doc, key), \"#000000\")) {\n      tokens.push({ label: `${label} ${step}`, value: `${key}-${step}` });\n    }\n  }\n  for (const row of libraryRows(doc)) {\n    const key = row.key?.trim();\n    if (!key) continue;\n    const label = row.label?.trim() || titleCase(key);\n    for (const step of stepsFor(row, row.hex ?? \"#000000\")) {\n      tokens.push({ label: `${label} ${step}`, value: `${key}-${step}` });\n    }\n  }\n  return tokens;\n}\n\nexport async function themeDocFromRequest(req: {\n  payload?: {\n    findGlobal?: (args: {\n      slug: string;\n      depth?: number;\n      overrideAccess?: boolean;\n    }) => Promise<ThemeDoc | null | undefined>;\n  };\n}): Promise<ThemeDoc | null> {\n  try {\n    const doc = await req.payload?.findGlobal?.({\n      slug: THEME_SLUG,\n      depth: 0,\n      overrideAccess: true,\n    });\n    return doc ?? null;\n  } catch {\n    return null;\n  }\n}\n","import type { StaticLabel, TextField, TextFieldSingleValidation } from \"payload\";\n\nimport { LOOK_FIELD } from \"./fields\";\nimport { pageEditorLooks, pageEditorTokens, themeDocFromRequest } from \"./looks\";\n\nexport interface LookFieldOptions {\n  name?: string;\n  label?: StaticLabel;\n  required?: boolean;\n  admin?: TextField[\"admin\"];\n  validate?: TextFieldSingleValidation;\n}\n\nexport type LookFieldMode = \"look\" | \"token\";\n\nexport const validateLook: TextFieldSingleValidation = async (value, { req }) => {\n  if (value == null || value === \"\") return true;\n  if (typeof value !== \"string\") return \"Pick a look from Theme → Colors\";\n  const doc = await themeDocFromRequest(req);\n  if (pageEditorLooks(doc).some((look) => look.value === value)) return true;\n  return \"Pick a look from Theme → Colors\";\n};\n\nexport const validateColorToken: TextFieldSingleValidation = async (value, { req }) => {\n  if (value == null || value === \"\") return true;\n  if (typeof value !== \"string\") return \"Pick an included step from Theme → Colors\";\n  const doc = await themeDocFromRequest(req);\n  if (pageEditorTokens(doc).some((token) => token.value === value)) return true;\n  return \"Pick an included step from Theme → Colors\";\n};\n\nfunction pickerField(\n  defaults: { name: string; label: string; mode: LookFieldMode; validate: TextFieldSingleValidation },\n  overrides: LookFieldOptions,\n): TextField {\n  const { name = defaults.name, label = defaults.label, admin, required, validate = defaults.validate } = overrides;\n  return {\n    name,\n    type: \"text\",\n    label,\n    required,\n    validate,\n    admin: {\n      ...admin,\n      components: { Field: LOOK_FIELD, ...admin?.components },\n      custom: { mode: defaults.mode, ...admin?.custom },\n    },\n  };\n}\n\n/**\n * A picker any collection or global can offer. Options come from the\n * published Theme at request time: page-editor system scales plus custom\n * Colors. Payload select options are a static list, so this is a text\n * field with an admin picker — adding Coral does not need a schema change.\n */\nexport function lookField(overrides: LookFieldOptions = {}): TextField {\n  return pickerField({ name: \"look\", label: \"Look\", mode: \"look\", validate: validateLook }, overrides);\n}\n\n/**\n * Included steps as `coral-400`. Excluded steps do not appear.\n */\nexport function colorTokenField(overrides: LookFieldOptions = {}): TextField {\n  return pickerField(\n    { name: \"color\", label: \"Color\", mode: \"token\", validate: validateColorToken },\n    overrides,\n  );\n}\n","import type { ThemeDoc, ThemeUploadDoc } from \"./types\";\n\nexport interface ThemeIdentityAsset {\n  url: string;\n  alt: string;\n}\n\nexport interface ThemeIdentityFallback {\n  lockup?: ThemeIdentityAsset;\n  mark?: ThemeIdentityAsset;\n  favicon?: ThemeIdentityAsset;\n}\n\nexport interface ResolvedThemeIdentity {\n  lockup: ThemeIdentityAsset | null;\n  mark: ThemeIdentityAsset | null;\n  favicon: ThemeIdentityAsset | null;\n}\n\nfunction fromUpload(value: ThemeDoc[\"logo\"], fallback?: ThemeIdentityAsset): ThemeIdentityAsset | null {\n  if (value && typeof value === \"object\") {\n    const upload = value as ThemeUploadDoc;\n    if (upload.url) {\n      return { url: upload.url, alt: upload.alt ?? fallback?.alt ?? \"\" };\n    }\n  }\n  return fallback ?? null;\n}\n\n/**\n * Uploaded logo, favicon, and mobile-menu mark, or the fallback the site\n * passed into `createTheme`. Empty fields keep the fallback;\n * `--color-primary-mark` is not a Theme field.\n */\nexport function resolveThemeIdentity(\n  doc: ThemeDoc | null | undefined,\n  fallback?: ThemeIdentityFallback,\n): ResolvedThemeIdentity {\n  return {\n    lockup: fromUpload(doc?.logo, fallback?.lockup),\n    mark: fromUpload(doc?.logoMark, fallback?.mark),\n    favicon: fromUpload(doc?.favicon, fallback?.favicon),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"identity-DZOb3_Gk.mjs","names":[],"sources":["../src/theme/fields.ts","../src/theme/map.ts","../src/theme/types.ts","../src/theme/library.ts","../src/theme/looks.ts","../src/theme/look-field.ts","../src/theme/identity.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_COLOR_SCALE_FIELD = \"@bison-lab/payload-core/admin#ColorScaleField\";\nexport const THEME_LIBRARY_FIELD = \"@bison-lab/payload-core/admin#LibraryField\";\nexport const THEME_FONT_FIELD = \"@bison-lab/payload-core/admin#FontField\";\nexport const THEME_PAIRING_FIELD = \"@bison-lab/payload-core/admin#PairingField\";\nexport const THEME_APPEARANCE_FIELD = \"@bison-lab/payload-core/admin#AppearanceField\";\nexport const THEME_GREY_SCALE_FIELD = \"@bison-lab/payload-core/admin#GreyScaleField\";\nexport const THEME_CONTRAST_REPORT = \"@bison-lab/payload-core/admin#ContrastReport\";\nexport const THEME_SECTION_HEADING = \"@bison-lab/payload-core/admin#SectionHeading\";\nexport const THEME_PUBLISH_FIELD = \"@bison-lab/payload-core/admin#PublishChild\";\nexport const THEME_SAVE_BUTTON = \"@bison-lab/payload-core/admin#HiddenSaveButton\";\nexport const THEME_DOCUMENT_CONTROLS = \"@bison-lab/payload-core/admin#ThemeDocumentControls\";\nexport const THEME_IDENTITY_FALLBACK = \"@bison-lab/payload-core/admin#IdentityFallback\";\nexport const LOOK_FIELD = \"@bison-lab/payload-core/admin#LookField\";\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: \"colors.brand.primary.hex\",\n  brandSecondary: \"colors.brand.secondary.hex\",\n  brandAccent: \"colors.brand.accent.hex\",\n  brandHighlight: \"colors.brand.highlight.hex\",\n  brandSuccess: \"colors.brand.success.hex\",\n  brandDestructive: \"colors.brand.destructive.hex\",\n  greyScale: \"colors.greyScale\",\n  defaultTheme: \"appearance.defaultTheme\",\n  radius: \"appearance.radius\",\n  shadow: \"appearance.shadow\",\n  motion: \"appearance.motion\",\n  density: \"appearance.density\",\n  fontBody: \"typography.body\",\n  fontHeading: \"typography.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 {\n  createColorScale,\n  DESTRUCTIVE_SCALE_HEX,\n  generateColorScale,\n  isThemeHex,\n  SHADE_STEPS,\n  type ColorScale,\n  type ColorScaleInclude,\n  type ColorScaleState,\n  type ShadeStep,\n  type ThemeConfig,\n} from \"@bison-lab/tokens\";\n\nimport { SAME_AS_BODY } from \"./fields\";\nimport type { ThemeColorDoc, 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\nfunction hexFromColor(value: ThemeColorDoc | string | null | undefined, fallback: string): string {\n  if (typeof value === \"string\") return value || fallback;\n  return pick(value?.hex, fallback);\n}\n\nexport function colorDocFromHex(hex: string, sourceStep: ShadeStep = 500): ThemeColorDoc {\n  return colorDocFromState(createColorScale(hex, sourceStep));\n}\n\nexport function colorDocFromState(state: ColorScaleState): ThemeColorDoc {\n  return {\n    hex: state.hex,\n    sourceStep: state.sourceStep,\n    scale: state.scale,\n    stale: state.stale,\n    include: Array.isArray(state.include) ? \"custom\" : state.include,\n    includedSteps: Array.isArray(state.include) ? [...state.include] : undefined,\n  };\n}\n\nexport function stateFromColorDoc(\n  doc: ThemeColorDoc | null | undefined,\n  fallbackHex = \"#000000\",\n): ColorScaleState {\n  const hex = isThemeHex(doc?.hex) ? doc.hex : fallbackHex;\n  const sourceStep = (Number(doc?.sourceStep) || 500) as ShadeStep;\n  const include = includeFromDoc(doc, sourceStep);\n  const scale =\n    doc?.scale && typeof doc.scale === \"object\" ? (doc.scale as ColorScale) : generateColorScale(hex, sourceStep);\n  return { hex, sourceStep, scale, stale: Boolean(doc?.stale), include };\n}\n\nfunction includeFromDoc(doc: ThemeColorDoc | null | undefined, sourceStep: ShadeStep): ColorScaleInclude {\n  if (doc?.include === \"source\") return \"source\";\n  if (doc?.include === \"custom\" && Array.isArray(doc.includedSteps)) {\n    const steps = doc.includedSteps.map(Number).filter((step): step is ShadeStep => SHADE_STEPS.includes(step as ShadeStep));\n    if (!steps.includes(sourceStep)) steps.push(sourceStep);\n    return steps;\n  }\n  return \"all\";\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. Reads the BIS-87 groups and the pre-BIS-87 flat fields.\n */\nexport function themeConfigFromDoc(doc: ThemeDoc | null | undefined, seed: ThemeConfig): ThemeConfig {\n  const brand = doc?.colors?.brand ?? doc?.brand;\n  const typography = doc?.typography ?? doc?.fonts;\n  const appearance = doc?.appearance;\n  return {\n    brandPrimary: hexFromColor(brand?.primary, seed.brandPrimary),\n    brandSecondary: hexFromColor(brand?.secondary, seed.brandSecondary),\n    brandAccent: hexFromColor(brand?.accent, seed.brandAccent),\n    brandHighlight: hexFromColor(brand?.highlight, seed.brandHighlight),\n    brandSuccess: hexFromColor(brand?.success, seed.brandSuccess),\n    brandDestructive:\n      hexFromColor(brand?.destructive, seed.brandDestructive ?? DESTRUCTIVE_SCALE_HEX) ||\n      seed.brandDestructive ||\n      DESTRUCTIVE_SCALE_HEX,\n    greyScale: pick(doc?.colors?.greyScale ?? doc?.greyScale, seed.greyScale),\n    radius: pick(appearance?.radius ?? doc?.radius, seed.radius),\n    shadow: pick(appearance?.shadow ?? doc?.shadow, seed.shadow),\n    motion: pick(appearance?.motion ?? doc?.motion, seed.motion),\n    density: pick(appearance?.density ?? doc?.density, seed.density),\n    defaultTheme: pick(appearance?.defaultTheme ?? doc?.defaultTheme, seed.defaultTheme),\n    fontBody: pick(typography?.body, seed.fontBody),\n    fontHeading: headingFromDoc(typography?.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, destructive?: string): ThemeDoc {\n  const destructiveHex = destructive ?? config.brandDestructive ?? DESTRUCTIVE_SCALE_HEX;\n  return {\n    colors: {\n      brand: {\n        primary: colorDocFromHex(config.brandPrimary),\n        secondary: colorDocFromHex(config.brandSecondary),\n        accent: colorDocFromHex(config.brandAccent),\n        highlight: colorDocFromHex(config.brandHighlight),\n        success: colorDocFromHex(config.brandSuccess),\n        destructive: colorDocFromHex(destructiveHex),\n      },\n      library: [],\n      greyScale: config.greyScale,\n    },\n    typography: {\n      body: config.fontBody,\n      heading: config.fontHeading,\n    },\n    appearance: {\n      defaultTheme: config.defaultTheme,\n      radius: config.radius,\n      shadow: config.shadow,\n      motion: config.motion,\n      density: config.density,\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\nexport function validateSourceIncluded(\n  value: unknown,\n  { siblingData }: { siblingData?: { sourceStep?: unknown; include?: unknown } },\n): true | string {\n  const include = siblingData?.include;\n  if (include === \"all\" || include === \"source\") return true;\n  const source = Number(siblingData?.sourceStep);\n  const steps = Array.isArray(value) ? value.map(Number) : [];\n  if (!SHADE_STEPS.includes(source as ShadeStep)) return true;\n  if (!steps.includes(source)) return \"The source step cannot be excluded\";\n  return true;\n}\n","import type { Access } from \"payload\";\nimport type { FontEntry } from \"@bison-lab/fonts\";\nimport type { ColorScale, ColorScaleInclude, ShadeStep, ThemeConfig } from \"@bison-lab/tokens\";\n\nimport type { ResolvedThemeIdentity, ThemeIdentityFallback } from \"./identity\";\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 *\n * Legacy flat `brand.*` hexes, `fonts`, and preset fields at the root stay\n * readable so `getPublishedTheme` still maps a pre-BIS-87 row.\n */\nexport interface ThemeColorDoc {\n  hex?: string | null;\n  sourceStep?: ShadeStep | string | null;\n  scale?: ColorScale | null;\n  stale?: boolean | null;\n  include?: ColorScaleInclude | \"custom\" | null;\n  includedSteps?: ShadeStep[] | string[] | null;\n}\n\nexport interface ThemeLibraryColorDoc extends ThemeColorDoc {\n  key?: string | null;\n  label?: string | null;\n}\n\nexport interface ThemeDoc {\n  colors?: {\n    brand?: {\n      primary?: ThemeColorDoc | string | null;\n      secondary?: ThemeColorDoc | string | null;\n      accent?: ThemeColorDoc | string | null;\n      highlight?: ThemeColorDoc | string | null;\n      success?: ThemeColorDoc | string | null;\n      destructive?: ThemeColorDoc | string | null;\n    } | null;\n    library?: ThemeLibraryColorDoc[] | null;\n    greyScale?: ThemeConfig[\"greyScale\"] | null;\n  } | null;\n  typography?: {\n    body?: string | null;\n    heading?: string | null;\n  } | null;\n  appearance?: {\n    defaultTheme?: ThemeConfig[\"defaultTheme\"] | null;\n    radius?: ThemeConfig[\"radius\"] | null;\n    shadow?: ThemeConfig[\"shadow\"] | null;\n    motion?: ThemeConfig[\"motion\"] | null;\n    density?: ThemeConfig[\"density\"] | null;\n  } | null;\n  /** @deprecated Pre-BIS-87 flat brand hexes. */\n  brand?: {\n    primary?: ThemeColorDoc | string | null;\n    secondary?: ThemeColorDoc | string | null;\n    accent?: ThemeColorDoc | string | null;\n    highlight?: ThemeColorDoc | string | null;\n    success?: ThemeColorDoc | string | null;\n    destructive?: ThemeColorDoc | string | null;\n  } | null;\n  /** @deprecated Pre-BIS-87; now `colors.greyScale`. */\n  greyScale?: ThemeConfig[\"greyScale\"] | null;\n  /** @deprecated Pre-BIS-87; now `appearance.*`. */\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  /** @deprecated Pre-BIS-87; now `typography`. */\n  fonts?: {\n    body?: string | null;\n    heading?: string | null;\n  } | null;\n  logo?: number | string | ThemeUploadDoc | null;\n  favicon?: number | string | ThemeUploadDoc | null;\n  logoMark?: number | string | ThemeUploadDoc | 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. Pass `canManageBrand` as `update` (and typically\n   * `isAuthenticated` as `read`). Theme does not read the Roles Global.\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  /**\n   * Destructive seed hex. Falls back to `seed.brandDestructive`, then\n   * the library's `DESTRUCTIVE_SCALE_HEX` (`#ef4444`).\n   */\n  destructive?: string;\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  /** Fill + automatic label target. Default `7`. Warnings never block save. */\n  contrastTarget?: number;\n  /**\n   * @deprecated Theme has no preview pane (SPI-56 canceled). Kept so a\n   * site that still passes it does not fail to boot.\n   */\n  previewPath?: string;\n  /**\n   * Adds the Identity page (logo, favicon, mobile-menu mark) when given.\n   * Pass `BRAND_ASSETS_SLUG` (or the slug you gave `createBrandAssets`).\n   * Save on that page writes only those uploads onto the stored Theme row.\n   */\n  logo?: { collection: string };\n  /**\n   * Fallback art when logo, favicon, or mobile-menu mark is empty. The\n   * site passes today's files; `--color-primary-mark` is not a Theme field.\n   */\n  identity?: { fallback?: ThemeIdentityFallback };\n  /** Fires from `afterChange` on every save — Theme has no draft mode. */\n  onPublish?: (theme: ThemeConfig, doc: ThemeDoc) => void | Promise<void>;\n}\n\nexport interface ThemeHeadOptions {\n  fontsBaseUrl?: string;\n  attribute?: \"class\" | \"data-theme\";\n  identity?: ResolvedThemeIdentity;\n  /**\n   * Custom Colors rows. `themeHead` emits their 50–950 variables and\n   * `[data-look]` bindings so a picker key paints without a package bump.\n   */\n  library?: ThemeLibraryColorDoc[] | null;\n}\n\nexport interface ThemeHead {\n  css: string;\n  preloads: { href: string; type: \"font/woff2\" }[];\n  identity?: ResolvedThemeIdentity;\n}\n\nexport const THEME_SLUG = \"theme\";\nexport const THEME_COLORS_SLUG = \"theme-colors\";\nexport const THEME_TYPOGRAPHY_SLUG = \"theme-typography\";\nexport const THEME_APPEARANCE_SLUG = \"theme-appearance\";\nexport const THEME_IDENTITY_SLUG = \"theme-identity\";\n\nexport const SYSTEM_COLOR_KEYS = [\n  \"primary\",\n  \"secondary\",\n  \"accent\",\n  \"highlight\",\n  \"success\",\n  \"destructive\",\n] as const;\n\nexport type SystemColorKey = (typeof SYSTEM_COLOR_KEYS)[number];\n","import { SHADE_STEPS, type ShadeStep } from \"@bison-lab/tokens\";\n\nimport { SYSTEM_COLOR_KEYS, type ThemeDoc, type ThemeLibraryColorDoc } from \"./types\";\n\n/**\n * Payload's array form state stores the row count (`0`, `2`, …), not the\n * rows. A custom Field that treats that number as the list will throw\n * `rows.filter is not a function` on an empty Theme library.\n */\nexport function asLibraryRows(value: unknown): ThemeLibraryColorDoc[] {\n  return Array.isArray(value) ? value : [];\n}\n\nconst STEP_SET = new Set<number>(SHADE_STEPS);\n\n/**\n * Page editors pick `coral-400`, never a raw hex. Rewrite every use of\n * `fromKey` onto `toKey` at the same step: `coral-400` → `highlight-400`.\n * A bare key (`coral`) becomes `toKey`. Anything else is left alone.\n */\nexport function rewriteColorToken(token: string, fromKey: string, toKey: string): string {\n  if (token === fromKey) return toKey;\n  const dash = token.lastIndexOf(\"-\");\n  if (dash <= 0) return token;\n  const key = token.slice(0, dash);\n  const step = Number(token.slice(dash + 1));\n  if (key !== fromKey || !STEP_SET.has(step)) return token;\n  return `${toKey}-${step as ShadeStep}`;\n}\n\nexport function themeColorKeys(doc: ThemeDoc | null | undefined): string[] {\n  const custom = asLibraryRows(doc?.colors?.library)\n    .map((row) => row.key?.trim())\n    .filter((key): key is string => Boolean(key));\n  return [...SYSTEM_COLOR_KEYS, ...custom];\n}\n\n/**\n * Remove a custom color. Unused: omit `replacement` and the row is gone.\n * In use: pass another system or custom key; the caller rewrites page\n * tokens with `rewriteColorToken`. After this, no library row still\n * has `key`.\n */\nexport function deleteLibraryColor(doc: ThemeDoc, key: string, replacement?: string): ThemeDoc {\n  const library = [...asLibraryRows(doc.colors?.library)];\n  const index = library.findIndex((row) => row.key === key);\n  if (index === -1) {\n    throw new Error(`No custom color named ${JSON.stringify(key)}`);\n  }\n  library.splice(index, 1);\n  const next: ThemeDoc = {\n    ...doc,\n    colors: { ...doc.colors, library },\n  };\n  if (replacement !== undefined) {\n    if (replacement === key) {\n      throw new Error(\"Replacement must be a different color\");\n    }\n    if (!themeColorKeys(next).includes(replacement)) {\n      throw new Error(`Replacement ${JSON.stringify(replacement)} is not a system or remaining custom color`);\n    }\n  }\n  return next;\n}\n","import { includedShadeSteps, type ShadeStep } from \"@bison-lab/tokens\";\n\nimport { stateFromColorDoc } from \"./map\";\nimport { THEME_SLUG, type ThemeColorDoc, type ThemeDoc, type ThemeLibraryColorDoc } from \"./types\";\n\n/**\n * System colors Color Settings offers as page-editor fills. Success and\n * Destructive stay off this list — they are theme chrome only.\n */\nexport const PAGE_EDITOR_SYSTEM_KEYS = [\"primary\", \"secondary\", \"accent\", \"highlight\"] as const;\n\nexport type PageEditorSystemKey = (typeof PAGE_EDITOR_SYSTEM_KEYS)[number];\n\nexport interface LookOption {\n  label: string;\n  value: string;\n}\n\nconst SYSTEM_LABELS: Record<PageEditorSystemKey, string> = {\n  primary: \"Primary\",\n  secondary: \"Secondary\",\n  accent: \"Accent\",\n  highlight: \"Highlight\",\n};\n\nfunction brandColor(doc: ThemeDoc | null | undefined, key: PageEditorSystemKey): ThemeColorDoc | null {\n  const brand = doc?.colors?.brand ?? doc?.brand;\n  const value = brand?.[key];\n  if (typeof value === \"string\" || value == null) return value == null ? null : { hex: value };\n  return value;\n}\n\nexport function themeLibraryFromDoc(doc: ThemeDoc | null | undefined): ThemeLibraryColorDoc[] {\n  return Array.isArray(doc?.colors?.library) ? doc.colors.library : [];\n}\n\nfunction libraryRows(doc: ThemeDoc | null | undefined): ThemeLibraryColorDoc[] {\n  return themeLibraryFromDoc(doc);\n}\n\nfunction titleCase(key: string): string {\n  return key.charAt(0).toUpperCase() + key.slice(1);\n}\n\nfunction stepsFor(color: ThemeColorDoc | null | undefined, fallbackHex: string): ShadeStep[] {\n  return includedShadeSteps(stateFromColorDoc(color, fallbackHex));\n}\n\n/**\n * Family keys a `lookField()` may offer: the page-editor system scales\n * plus every custom color on Colors. Adding Coral on Theme makes `coral`\n * appear here with no `@bison-lab/*` release.\n */\nexport function pageEditorLooks(doc: ThemeDoc | null | undefined): LookOption[] {\n  const system = PAGE_EDITOR_SYSTEM_KEYS.map((value) => ({\n    label: SYSTEM_LABELS[value],\n    value,\n  }));\n  const custom = libraryRows(doc)\n    .map((row) => {\n      const value = row.key?.trim();\n      if (!value) return null;\n      return { label: row.label?.trim() || titleCase(value), value };\n    })\n    .filter((option): option is LookOption => option !== null);\n  return [...system, ...custom];\n}\n\n/**\n * Included steps as `coral-400`. Excluded steps do not appear. System\n * scales with no stored include list offer the full 50–950 ramp.\n */\nexport function pageEditorTokens(doc: ThemeDoc | null | undefined): LookOption[] {\n  const tokens: LookOption[] = [];\n  for (const key of PAGE_EDITOR_SYSTEM_KEYS) {\n    const label = SYSTEM_LABELS[key];\n    for (const step of stepsFor(brandColor(doc, key), \"#000000\")) {\n      tokens.push({ label: `${label} ${step}`, value: `${key}-${step}` });\n    }\n  }\n  for (const row of libraryRows(doc)) {\n    const key = row.key?.trim();\n    if (!key) continue;\n    const label = row.label?.trim() || titleCase(key);\n    for (const step of stepsFor(row, row.hex ?? \"#000000\")) {\n      tokens.push({ label: `${label} ${step}`, value: `${key}-${step}` });\n    }\n  }\n  return tokens;\n}\n\nexport async function themeDocFromRequest(req: {\n  payload?: {\n    findGlobal?: (args: {\n      slug: string;\n      depth?: number;\n      overrideAccess?: boolean;\n    }) => Promise<ThemeDoc | null | undefined>;\n  };\n}): Promise<ThemeDoc | null> {\n  try {\n    const doc = await req.payload?.findGlobal?.({\n      slug: THEME_SLUG,\n      depth: 0,\n      overrideAccess: true,\n    });\n    return doc ?? null;\n  } catch {\n    return null;\n  }\n}\n","import type { StaticLabel, TextField, TextFieldSingleValidation } from \"payload\";\n\nimport { LOOK_FIELD } from \"./fields\";\nimport { pageEditorLooks, pageEditorTokens, themeDocFromRequest } from \"./looks\";\n\nexport interface LookFieldOptions {\n  name?: string;\n  label?: StaticLabel;\n  required?: boolean;\n  admin?: TextField[\"admin\"];\n  validate?: TextFieldSingleValidation;\n}\n\nexport type LookFieldMode = \"look\" | \"token\";\n\nexport const validateLook: TextFieldSingleValidation = async (value, { req }) => {\n  if (value == null || value === \"\") return true;\n  if (typeof value !== \"string\") return \"Pick a look from Theme → Colors\";\n  const doc = await themeDocFromRequest(req);\n  if (pageEditorLooks(doc).some((look) => look.value === value)) return true;\n  return \"Pick a look from Theme → Colors\";\n};\n\nexport const validateColorToken: TextFieldSingleValidation = async (value, { req }) => {\n  if (value == null || value === \"\") return true;\n  if (typeof value !== \"string\") return \"Pick an included step from Theme → Colors\";\n  const doc = await themeDocFromRequest(req);\n  if (pageEditorTokens(doc).some((token) => token.value === value)) return true;\n  return \"Pick an included step from Theme → Colors\";\n};\n\nfunction pickerField(\n  defaults: { name: string; label: string; mode: LookFieldMode; validate: TextFieldSingleValidation },\n  overrides: LookFieldOptions,\n): TextField {\n  const { name = defaults.name, label = defaults.label, admin, required, validate = defaults.validate } = overrides;\n  return {\n    name,\n    type: \"text\",\n    label,\n    required,\n    validate,\n    admin: {\n      ...admin,\n      components: { Field: LOOK_FIELD, ...admin?.components },\n      custom: { mode: defaults.mode, ...admin?.custom },\n    },\n  };\n}\n\n/**\n * A picker any collection or global can offer. Options come from the\n * published Theme at request time: page-editor system scales plus custom\n * Colors. Payload select options are a static list, so this is a text\n * field with an admin picker — adding Coral does not need a schema change.\n */\nexport function lookField(overrides: LookFieldOptions = {}): TextField {\n  return pickerField({ name: \"look\", label: \"Look\", mode: \"look\", validate: validateLook }, overrides);\n}\n\n/**\n * Included steps as `coral-400`. Excluded steps do not appear.\n */\nexport function colorTokenField(overrides: LookFieldOptions = {}): TextField {\n  return pickerField(\n    { name: \"color\", label: \"Color\", mode: \"token\", validate: validateColorToken },\n    overrides,\n  );\n}\n","import type { ThemeDoc, ThemeUploadDoc } from \"./types\";\n\nexport interface ThemeIdentityAsset {\n  url: string;\n  alt: string;\n}\n\nexport interface ThemeIdentityFallback {\n  lockup?: ThemeIdentityAsset;\n  mark?: ThemeIdentityAsset;\n  favicon?: ThemeIdentityAsset;\n}\n\nexport interface ResolvedThemeIdentity {\n  lockup: ThemeIdentityAsset | null;\n  mark: ThemeIdentityAsset | null;\n  favicon: ThemeIdentityAsset | null;\n}\n\nfunction fromUpload(value: ThemeDoc[\"logo\"], fallback?: ThemeIdentityAsset): ThemeIdentityAsset | null {\n  if (value && typeof value === \"object\") {\n    const upload = value as ThemeUploadDoc;\n    if (upload.url) {\n      return { url: upload.url, alt: upload.alt ?? fallback?.alt ?? \"\" };\n    }\n  }\n  return fallback ?? null;\n}\n\n/**\n * Uploaded logo, favicon, and mobile-menu mark, or the fallback the site\n * passed into `createTheme`. Empty fields keep the fallback;\n * `--color-primary-mark` is not a Theme field.\n */\nexport function resolveThemeIdentity(\n  doc: ThemeDoc | null | undefined,\n  fallback?: ThemeIdentityFallback,\n): ResolvedThemeIdentity {\n  return {\n    lockup: fromUpload(doc?.logo, fallback?.lockup),\n    mark: fromUpload(doc?.logoMark, fallback?.mark),\n    favicon: fromUpload(doc?.favicon, fallback?.favicon),\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,7 +1,8 @@
 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 { A as ThemeIdentityFallback, C as ThemeColorDoc, D as ThemeLibraryColorDoc, O as ThemeUploadDoc, S as THEME_TYPOGRAPHY_SLUG, _ as SystemColorKey, a as pageEditorTokens, b as THEME_IDENTITY_SLUG, c as LookFieldOptions, d as deleteLibraryColor, f as rewriteColorToken, g as SYSTEM_COLOR_KEYS, h as EditableTheme, i as pageEditorLooks, j as resolveThemeIdentity, k as ResolvedThemeIdentity, l as colorTokenField, m as CreateThemeOptions, n as PAGE_EDITOR_SYSTEM_KEYS, o as themeLibraryFromDoc, p as themeColorKeys, r as PageEditorSystemKey, s as LookFieldMode, t as LookOption, u as lookField, v as THEME_APPEARANCE_SLUG, w as ThemeDoc, x as THEME_SLUG, y as THEME_COLORS_SLUG } from "./looks-DsizRfFV.mjs";
+import { A as ThemeIdentityFallback, C as ThemeColorDoc, D as ThemeLibraryColorDoc, O as ThemeUploadDoc, S as THEME_TYPOGRAPHY_SLUG, _ as SystemColorKey, a as pageEditorTokens, b as THEME_IDENTITY_SLUG, c as LookFieldOptions, d as deleteLibraryColor, f as rewriteColorToken, g as SYSTEM_COLOR_KEYS, h as EditableTheme, i as pageEditorLooks, j as resolveThemeIdentity, k as ResolvedThemeIdentity, l as colorTokenField, m as CreateThemeOptions, n as PAGE_EDITOR_SYSTEM_KEYS, o as themeLibraryFromDoc, p as themeColorKeys, r as PageEditorSystemKey, s as LookFieldMode, t as LookOption, u as lookField, v as THEME_APPEARANCE_SLUG, w as ThemeDoc, x as THEME_SLUG, y as THEME_COLORS_SLUG } from "./looks-CLxXwASa.mjs";
 import { ThemeConfig } from "@bison-lab/tokens";
-import { Access, CheckboxField, CollectionConfig, CollectionSlug, GlobalConfig, Plugin, UploadCollectionSlug } from "payload";
+import * as payload from "payload";
+import { Access, Block, CheckboxField, CollectionConfig, CollectionSlug, GlobalConfig, ImageSize, PayloadRequest, Plugin, TextField, UploadCollectionSlug } from "payload";
 
 //#region src/seo/plugin.d.ts
 /**
@@ -123,8 +124,8 @@ interface CreateBrandAssetsOptions {
   /**
    * Required, no default — same shape as `createTheme`. `read` is typically
    * public so the live site can load the lockup; `update` is `canManageBrand`
-   * and covers create, update, delete, and version history. Predicates live
-   * in each site's `src/platform` until BIS-43.
+   * and covers create, update, delete, and version history. This collection
+   * does not read the Roles Global.
    */
   access: {
     read: Access;
@@ -231,5 +232,250 @@ declare const THEME_DOCUMENT_CONTROLS = "@bison-lab/payload-core/admin#ThemeDocu
 declare const THEME_IDENTITY_FALLBACK = "@bison-lab/payload-core/admin#IdentityFallback";
 declare const LOOK_FIELD = "@bison-lab/payload-core/admin#LookField";
 //#endregion
-export { BRAND_ASSETS_MIME_TYPES, BRAND_ASSETS_SLUG, type CreateBrandAssetsOptions, type CreateThemeOptions, DESCRIPTION_LENGTH, type EditableTheme, LOOK_FIELD, type LookFieldMode, type LookFieldOptions, type LookOption, type MediaId, PAGE_EDITOR_SYSTEM_KEYS, type PageEditorSystemKey, type ResolvedThemeIdentity, SHARE_IMAGE_SIZE, SYSTEM_COLOR_KEYS, type SeoDoc, type SeoImageDoc, type SeoImageSize, type SeoImageValue, type SeoMeta, type SeoPluginOptions, type SystemColorKey, THEME_APPEARANCE_FIELD, THEME_APPEARANCE_SLUG, THEME_COLORS_SLUG, THEME_COLOR_FIELD, THEME_COLOR_SCALE_FIELD, THEME_CONTRAST_REPORT, THEME_DOCUMENT_CONTROLS, THEME_FONT_FIELD, THEME_GREY_SCALE_FIELD, THEME_IDENTITY_FALLBACK, THEME_IDENTITY_SLUG, THEME_LIBRARY_FIELD, THEME_PAIRING_FIELD, THEME_PREVIEW_BREAKPOINTS, THEME_PUBLISH_FIELD, THEME_SAVE_BUTTON, THEME_SECTION_HEADING, THEME_SLUG, THEME_TYPOGRAPHY_SLUG, type ThemeChild, type ThemeColorDoc, type ThemeDoc, type ThemeIdentityFallback, type ThemeLibraryColorDoc, type ThemeUploadDoc, colorTokenField, createBrandAssets, createTheme, deleteLibraryColor, documentTitle, firstImageIn, lookField, noIndexField, pageEditorLooks, pageEditorTokens, persistThemeChild, publishThemeChild, resolveThemeIdentity, rewriteColorToken, sanitizeSvg, seedTheme, seoPlugin, themeColorKeys, themeLibraryFromDoc, titleTemplate, truncateAtWord };
+//#region src/roles/global.d.ts
+/**
+ * Settings → Roles. Rank is the array order (Payload's drag handle). Ticks
+ * are Content, Brand, Publish, Users. The API tab is not a column.
+ */
+declare function createRoles(): GlobalConfig;
+//#endregion
+//#region src/roles/types.d.ts
+/**
+ * The Roles Global a site's generated types will describe. Optional and
+ * nullable, no index signature: a generated Global is assignable to this,
+ * never the reverse.
+ */
+declare const ROLES: readonly ["developer", "admin", "designer", "author"];
+type Role = (typeof ROLES)[number];
+declare const ROLE_LABELS: Record<Role, string>;
+declare const CAPABILITIES: readonly ["content", "brand", "publish", "users"];
+type Capability = (typeof CAPABILITIES)[number];
+interface RoleRow {
+  id?: string | null;
+  role: Role;
+  content: boolean;
+  brand: boolean;
+  publish: boolean;
+  users: boolean;
+}
+interface RolesDoc {
+  roles?: RoleRow[] | null;
+}
+/**
+ * `req.user` as Payload hands it over. Structural so this module never
+ * imports a site's generated `User`. `roles` is optional because a row
+ * that predates the field must come back powerless.
+ */
+type MaybeUser = {
+  id?: string | number;
+  roles?: readonly string[] | null;
+} | null | undefined;
+declare function isRole(value: unknown): value is Role;
+//#endregion
+//#region src/roles/seed.d.ts
+interface SeedRolesPayload {
+  updateGlobal: (args: {
+    slug: string;
+    data: RolesDoc;
+  }) => Promise<unknown>;
+}
+/**
+ * Writes the default matrix. For a site's migration `up()`. Never writes a
+ * user row — seeding `developer` on a person stays a site concern.
+ */
+declare function seedRoles(payload: SeedRolesPayload): Promise<unknown>;
+//#endregion
+//#region src/roles/fields.d.ts
+declare const ROLES_MATRIX_FIELD = "@bison-lab/payload-core/admin#RolesMatrixField";
+declare const ROLES_FIELD = "@bison-lab/payload-core/admin#RolesField";
+//#endregion
+//#region src/collections/pages.d.ts
+interface PagesOptions {
+  /**
+   * What a page may open with. One row, so this is the site's hero variants,
+   * not a list a page picks several from.
+   */
+  heroBlocks: Block[];
+  /** The sections a page body can be built out of. */
+  layoutBlocks: Block[];
+  /**
+   * True when a slug is not the CMS's to hand out — a path the app already
+   * serves from code, or one the framework reserves.
+   */
+  isReservedSlug: (slug: string) => boolean;
+  /**
+   * Public path of a page from its stored slug — the site's own route helper.
+   * Drives the page preview overlay's iframe.
+   */
+  previewPath: (slug: string) => string;
+  /**
+   * Component path for Payload's native Preview button, as a key into the
+   * site's committed `importMap.js`. Omit it for Payload's own button.
+   */
+  previewButton?: string;
+}
+/**
+ * CMS-managed pages: one required hero, then a reorderable body of sections.
+ * The CMS owns copy and the order of sections; what a section looks like is
+ * code-owned, which is why the blocks are an argument.
+ */
+declare function createPages({
+  heroBlocks,
+  isReservedSlug,
+  layoutBlocks,
+  previewPath,
+  previewButton
+}: PagesOptions): CollectionConfig;
+//#endregion
+//#region src/collections/users.d.ts
+/** Refuses the save that would remove Users from the only privileged user. */
+declare const LAST_ADMIN_DEMOTE_MESSAGE = "Make another user an admin before removing it from this one.";
+/** Refuses the delete that would remove the only privileged user. */
+declare const LAST_ADMIN_DELETE_MESSAGE = "Make another user an admin before deleting this one.";
+interface UsersOptions {
+  /**
+   * Whether the auth cookie is marked Secure. Passed in rather than read from
+   * the environment here: which env var means "served over HTTPS" is the
+   * host's business, not the CMS's.
+   */
+  secureCookies: boolean;
+  /**
+   * Component path for the roles field, as a key into the site's committed
+   * `importMap.js`. Defaults to the package checklist. A value nothing
+   * resolves renders the field as nothing.
+   */
+  rolesField?: string;
+}
+declare function createUsers({
+  secureCookies,
+  rolesField
+}: UsersOptions): CollectionConfig;
+//#endregion
+//#region src/collections/media.d.ts
+interface MediaOptions {
+  /** Where uploads land, relative to the app root. */
+  staticDir?: string;
+  mimeTypes?: string[];
+  /**
+   * Renditions sharp cuts on upload, each served at its own URL under
+   * `sizes.<name>` on the document. Which sizes a site needs is the site's
+   * call. A file uploaded before a size was added has no rendition for it.
+   */
+  imageSizes?: ImageSize[];
+}
+/**
+ * Uploads, readable by anyone: the public site serves these files. Writing is
+ * an editorial action, deleting is not — removing an asset a live page
+ * references breaks that page.
+ */
+declare function createMedia({
+  staticDir,
+  mimeTypes,
+  imageSizes
+}?: MediaOptions): CollectionConfig;
+//#endregion
+//#region src/fields/slug.d.ts
+interface SlugFieldOptions {
+  /** The collection the field sits on — what the duplicate check searches. */
+  collection: CollectionSlug;
+  /**
+   * True when a slug belongs to something the CMS does not own: a path the app
+   * already serves from code, or one reserved for the framework. Which paths
+   * those are is knowable only to the site, so it arrives as an option.
+   */
+  isReserved: (slug: string) => boolean;
+}
+/**
+ * A stored slug from whatever was typed: lowercased, with any run of
+ * whitespace and slashes stripped from either end in one pass, so `/ about-us /`
+ * does not keep the inner spaces a trim-then-strip would leave.
+ */
+declare function normalizeSlug(value: string): string;
+/**
+ * The path a document is published at, normalised on the way in. Unique
+ * across the collection. `validate` is the message under the field;
+ * `beforeChange` is the enforcement on a draft save, where Payload skips
+ * field validation.
+ */
+declare function slugField({
+  collection,
+  isReserved
+}: SlugFieldOptions): TextField;
+//#endregion
+//#region src/plugins/admin-only-api-tab.d.ts
+/**
+ * Gates the document API tab to Developer, config-wide. After plugins that
+ * use `definePlugin` order (MCP is 10), so a collection those plugins
+ * register is still covered.
+ */
+declare const adminOnlyApiTab: () => payload.Plugin;
+//#endregion
+//#region src/roles/matrix.d.ts
+declare const ROLES_SLUG = "roles";
+/**
+ * Default rank and ticks. Brand is Designer only. The API tab is not a
+ * column — it is locked to Developer in `isDeveloper`.
+ */
+declare const DEFAULT_ROLE_MATRIX: readonly RoleRow[];
+declare const DEVELOPER_DESCRIPTION = "Everything Admin can do, plus the document API tab.";
+declare const LAST_USERS_TICK_MESSAGE = "Keep Users ticked on at least one of Admin or Developer.";
+declare function defaultRolesFieldValue(): RoleRow[];
+declare function parseRolesMatrix(value: unknown): {
+  ok: true;
+  rows: RoleRow[];
+} | {
+  ok: false;
+  message: string;
+};
+declare function validateRolesMatrix(value: unknown): true | string;
+/**
+ * Developer is exclusive. Admin does not swallow Designer: both store.
+ */
+declare function normalizeStoredRoles(value: unknown): Role[];
+declare function roleSelectOptions(matrix?: readonly RoleRow[]): {
+  label: string;
+  value: "developer" | "admin" | "designer" | "author";
+}[];
+/** Capability copy only. Developer names the API tab; nothing about MCP or seed. */
+declare function roleDescription(role: Role, matrix?: readonly RoleRow[]): string;
+//#endregion
+//#region src/roles/access.d.ts
+type AccessArgs = {
+  req: {
+    user?: MaybeUser;
+    payload?: Pick<NonNullable<PayloadRequest["payload"]>, "findGlobal">;
+  };
+};
+type CapabilityPredicate = {
+  (user: MaybeUser, matrix?: readonly RoleRow[]): boolean;
+  (args: AccessArgs): boolean | Promise<boolean>;
+};
+declare function storedRoles(user: MaybeUser): readonly string[];
+declare function hasRole(user: MaybeUser, role: Role): boolean;
+/** Not a tick. True only when `developer` is stored on the row. */
+declare function isDeveloper(user: MaybeUser): boolean;
+declare function hasCapability(user: MaybeUser, capability: Capability, matrix?: readonly RoleRow[]): boolean;
+/**
+ * Reads the saved Roles Global, falling back to the seed when the row is
+ * empty, missing, or unreadable. Always override-access so a Designer
+ * evaluating Theme does not have to read Settings → Roles.
+ */
+declare function getRolesMatrix(req?: AccessArgs["req"]): Promise<RoleRow[]>;
+declare const canManageContent: CapabilityPredicate;
+declare const canManageBrand: CapabilityPredicate;
+declare const canPublish: CapabilityPredicate;
+/** Users tick on any held role. */
+declare const isAdmin: CapabilityPredicate;
+/** This role id currently has the Users tick. */
+declare function isPrivilegedRole(role: unknown, matrix?: readonly RoleRow[]): boolean;
+declare function isAuthenticated(user: MaybeUser): boolean;
+declare function isAuthenticated(args: AccessArgs): boolean;
+declare const isAdminOrSelf: Access;
+declare const authenticatedOrPublished: Access;
+/** API tab condition: Developer only, not the Users tick. */
+declare function isDeveloperTab({
+  req
+}: AccessArgs): boolean;
+//#endregion
+export { BRAND_ASSETS_MIME_TYPES, BRAND_ASSETS_SLUG, CAPABILITIES, type Capability, type CreateBrandAssetsOptions, type CreateThemeOptions, DEFAULT_ROLE_MATRIX, DESCRIPTION_LENGTH, DEVELOPER_DESCRIPTION, type EditableTheme, LAST_ADMIN_DELETE_MESSAGE, LAST_ADMIN_DEMOTE_MESSAGE, LAST_USERS_TICK_MESSAGE, LOOK_FIELD, type LookFieldMode, type LookFieldOptions, type LookOption, type MaybeUser, type MediaId, type MediaOptions, PAGE_EDITOR_SYSTEM_KEYS, type PageEditorSystemKey, type PagesOptions, ROLES, ROLES_FIELD, ROLES_MATRIX_FIELD, ROLES_SLUG, ROLE_LABELS, type ResolvedThemeIdentity, type Role, type RoleRow, type RolesDoc, SHARE_IMAGE_SIZE, SYSTEM_COLOR_KEYS, type SeoDoc, type SeoImageDoc, type SeoImageSize, type SeoImageValue, type SeoMeta, type SeoPluginOptions, type SlugFieldOptions, type SystemColorKey, THEME_APPEARANCE_FIELD, THEME_APPEARANCE_SLUG, THEME_COLORS_SLUG, THEME_COLOR_FIELD, THEME_COLOR_SCALE_FIELD, THEME_CONTRAST_REPORT, THEME_DOCUMENT_CONTROLS, THEME_FONT_FIELD, THEME_GREY_SCALE_FIELD, THEME_IDENTITY_FALLBACK, THEME_IDENTITY_SLUG, THEME_LIBRARY_FIELD, THEME_PAIRING_FIELD, THEME_PREVIEW_BREAKPOINTS, THEME_PUBLISH_FIELD, THEME_SAVE_BUTTON, THEME_SECTION_HEADING, THEME_SLUG, THEME_TYPOGRAPHY_SLUG, type ThemeChild, type ThemeColorDoc, type ThemeDoc, type ThemeIdentityFallback, type ThemeLibraryColorDoc, type ThemeUploadDoc, type UsersOptions, adminOnlyApiTab, authenticatedOrPublished, canManageBrand, canManageContent, canPublish, colorTokenField, createBrandAssets, createMedia, createPages, createRoles, createTheme, createUsers, defaultRolesFieldValue, deleteLibraryColor, documentTitle, firstImageIn, getRolesMatrix, hasCapability, hasRole, isAdmin, isAdminOrSelf, isAuthenticated, isDeveloper, isDeveloperTab, isPrivilegedRole, isRole, lookField, noIndexField, normalizeSlug, normalizeStoredRoles, pageEditorLooks, pageEditorTokens, parseRolesMatrix, persistThemeChild, publishThemeChild, resolveThemeIdentity, rewriteColorToken, roleDescription, roleSelectOptions, sanitizeSvg, seedRoles, seedTheme, seoPlugin, slugField, storedRoles, themeColorKeys, themeLibraryFromDoc, titleTemplate, truncateAtWord, validateRolesMatrix };
 //# 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/brand-assets/collection.ts","../src/brand-assets/sanitize.ts","../src/theme/seed.ts","../src/theme/preview.ts","../src/theme/publish.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;;;;iBIkWgB,WAAA,CAAY,OAAA,EAAS,kBAAA,GAAqB,YAAA;;;cClX7C,iBAAA;;cAGA,uBAAA;AAAA,UAOI,wBAAA;;ALMjB;;;;;EKCE,MAAA;IAAU,IAAA,EAAM,MAAA;IAAQ,MAAA,EAAQ,MAAA;EAAA;ELGsB;EKDtD,IAAA;AAAA;;;;;;iBAmBc,iBAAA,CAAkB,OAAA,EAAS,wBAAA,GAA2B,gBAAA;;;;;;;;;iBClCtD,WAAA,CAAY,MAAA;;;UCFX,gBAAA;EACf,YAAA,GAAe,IAAA;IACb,IAAA;IACA,IAAA,EAAM,QAAA;IACN,KAAA;EAAA,MACI,OAAA;AAAA;;;APaR;;iBONsB,SAAA,CAAU,OAAA,EAAS,gBAAA,EAAkB,IAAA,EAAM,WAAA,GAAc,OAAA;;;;;;;cCdlE,yBAAA;EAAA;;;;;;;;;;;;;;;;;cCFA,cAAA;AAAA,KAED,UAAA,WAAqB,cAAA;;;;ATgBjC;;;;iBSPgB,iBAAA,CAAkB,MAAA,EAAQ,QAAA,EAAU,QAAA,EAAU,QAAA,EAAU,KAAA,EAAO,UAAA,GAAa,QAAA;AAAA,UAmC3E,iBAAA;EACf,UAAA,GAAa,IAAA;IACX,IAAA;IACA,KAAA;IACA,KAAA;IACA,cAAA;EAAA,MACI,OAAA,CAAQ,QAAA;EACd,YAAA,GAAe,IAAA;IAAQ,IAAA;IAAc,IAAA,EAAM,QAAA;IAAU,KAAA;EAAA,MAAsB,OAAA;AAAA;;;;;iBAOvD,iBAAA,CACpB,OAAA,EAAS,iBAAA,EACT,QAAA,EAAU,QAAA,EACV,KAAA,EAAO,UAAA,GACN,OAAA,CAAQ,QAAA;;;cC9DE,iBAAA;AAAA,cACA,uBAAA;AAAA,cACA,mBAAA;AAAA,cACA,gBAAA;AAAA,cACA,mBAAA;AAAA,cACA,sBAAA;AAAA,cACA,sBAAA;AAAA,cACA,qBAAA;AAAA,cACA,qBAAA;AAAA,cACA,mBAAA;AAAA,cACA,iBAAA;AAAA,cACA,uBAAA;AAAA,cACA,uBAAA;AAAA,cACA,UAAA"}
+{"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/brand-assets/collection.ts","../src/brand-assets/sanitize.ts","../src/theme/seed.ts","../src/theme/preview.ts","../src/theme/publish.ts","../src/theme/fields.ts","../src/roles/global.ts","../src/roles/types.ts","../src/roles/seed.ts","../src/roles/fields.ts","../src/collections/pages.ts","../src/collections/users.ts","../src/collections/media.ts","../src/fields/slug.ts","../src/plugins/admin-only-api-tab.ts","../src/roles/matrix.ts","../src/roles/access.ts"],"mappings":";;;;;;;;;;;;AAoBA;UAAiB,MAAA;EACf,KAAA;AAAA;AAAA,UAGe,gBAAA,cAA8B,MAAA,GAAS,MAAA;EAAvC;EAEf,QAAA;EAF+B;;;;;;EAS/B,MAAA,GAAS,GAAA,EAAK,IAAA;EAeA;;;;;EATd,YAAA,IAAgB,GAAA,EAAK,IAAA;EAfiC;;;;;;EAsBtD,QAAA,IAAY,GAAA,EAAK,IAAA,KAAS,OAAA;EAPV;EAShB,WAAA,GAAc,cAAA;EAFG;EAIjB,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;;;iBIkWgB,WAAA,CAAY,OAAA,EAAS,kBAAA,GAAqB,YAAA;;;cClX7C,iBAAA;;cAGA,uBAAA;AAAA,UAOI,wBAAA;;;ALMjB;;;;EKCE,MAAA;IAAU,IAAA,EAAM,MAAA;IAAQ,MAAA,EAAQ,MAAA;EAAA;ELGa;EKD7C,IAAA;AAAA;;;;;;iBAmBc,iBAAA,CAAkB,OAAA,EAAS,wBAAA,GAA2B,gBAAA;;;;;;;;;iBClCtD,WAAA,CAAY,MAAA;;;UCFX,gBAAA;EACf,YAAA,GAAe,IAAA;IACb,IAAA;IACA,IAAA,EAAM,QAAA;IACN,KAAA;EAAA,MACI,OAAA;AAAA;;;;APaR;iBONsB,SAAA,CAAU,OAAA,EAAS,gBAAA,EAAkB,IAAA,EAAM,WAAA,GAAc,OAAA;;;;;;;cCdlE,yBAAA;EAAA;;;;;;;;;;;;;;;;;cCFA,cAAA;AAAA,KAED,UAAA,WAAqB,cAAA;;;;;ATgBjC;;;iBSPgB,iBAAA,CAAkB,MAAA,EAAQ,QAAA,EAAU,QAAA,EAAU,QAAA,EAAU,KAAA,EAAO,UAAA,GAAa,QAAA;AAAA,UAmC3E,iBAAA;EACf,UAAA,GAAa,IAAA;IACX,IAAA;IACA,KAAA;IACA,KAAA;IACA,cAAA;EAAA,MACI,OAAA,CAAQ,QAAA;EACd,YAAA,GAAe,IAAA;IAAQ,IAAA;IAAc,IAAA,EAAM,QAAA;IAAU,KAAA;EAAA,MAAsB,OAAA;AAAA;;;;;iBAOvD,iBAAA,CACpB,OAAA,EAAS,iBAAA,EACT,QAAA,EAAU,QAAA,EACV,KAAA,EAAO,UAAA,GACN,OAAA,CAAQ,QAAA;;;cC9DE,iBAAA;AAAA,cACA,uBAAA;AAAA,cACA,mBAAA;AAAA,cACA,gBAAA;AAAA,cACA,mBAAA;AAAA,cACA,sBAAA;AAAA,cACA,sBAAA;AAAA,cACA,qBAAA;AAAA,cACA,qBAAA;AAAA,cACA,mBAAA;AAAA,cACA,iBAAA;AAAA,cACA,uBAAA;AAAA,cACA,uBAAA;AAAA,cACA,UAAA;;;;;;;iBCNG,WAAA,CAAA,GAAe,YAAA;;;;;;;;cCLlB,KAAA;AAAA,KAED,IAAA,WAAe,KAAA;AAAA,cAEd,WAAA,EAAa,MAAA,CAAO,IAAA;AAAA,cAOpB,YAAA;AAAA,KAED,UAAA,WAAqB,YAAA;AAAA,UAEhB,OAAA;EACf,EAAA;EACA,IAAA,EAAM,IAAA;EACN,OAAA;EACA,KAAA;EACA,OAAA;EACA,KAAA;AAAA;AAAA,UAGe,QAAA;EACf,KAAA,GAAQ,OAAA;AAAA;;;;;;KAQE,SAAA;EAAc,EAAA;EAAsB,KAAA;AAAA;AAAA,iBAEhC,MAAA,CAAO,KAAA,YAAiB,KAAA,IAAS,IAAA;;;UCtChC,gBAAA;EACf,YAAA,GAAe,IAAA;IAAQ,IAAA;IAAc,IAAA,EAAM,QAAA;EAAA,MAAe,OAAA;AAAA;AbgB5D;;;;AAAA,iBaTsB,SAAA,CAAU,OAAA,EAAS,gBAAA,GAAmB,OAAA;;;cCX/C,kBAAA;AAAA,cACA,WAAA;;;UCII,YAAA;;;;;EAKf,UAAA,EAAY,KAAA;EfUG;EeRf,YAAA,EAAc,KAAA;;;;AfYhB;EePE,cAAA,GAAiB,IAAA;EfOc;;;;EeF/B,WAAA,GAAc,IAAA;EfwBG;;;;EenBjB,aAAA;AAAA;;;;;;iBAQc,WAAA,CAAA;EACd,UAAA;EACA,cAAA;EACA,YAAA;EACA,WAAA;EACA;AAAA,GACC,YAAA,GAAe,gBAAA;;;;cCfL,yBAAA;;cAEA,yBAAA;AAAA,UA0DI,YAAA;;AhBlEjB;;;;EgBwEE,aAAA;EhBpEe;;;;;EgB0Ef,UAAA;AAAA;AAAA,iBAGc,WAAA,CAAA;EAAc,aAAA;EAAe;AAAA,GAAc,YAAA,GAAe,gBAAA;;;UCjGzD,YAAA;;EAEf,SAAA;EACA,SAAA;;;AjBaF;;;EiBPE,UAAA,GAAa,SAAA;AAAA;AjBWf;;;;;AAAA,iBiBHgB,WAAA,CAAA;EACd,SAAA;EACA,SAAA;EACA;AAAA,IACC,YAAA,GAAoB,gBAAA;;;UChBN,gBAAA;;EAEf,UAAA,EAAY,cAAA;;;;AlBSd;;EkBHE,UAAA,GAAa,IAAA;AAAA;;AlBOf;;;;iBkBMgB,aAAA,CAAc,KAAA;;;;;;;iBA4Cd,SAAA,CAAA;EAAY,UAAA;EAAY;AAAA,GAAc,gBAAA,GAAmB,SAAA;;;;;;;;cCxC5D,eAAA,QAQX,OAAA,CAR0B,MAAA;;;cChCf,UAAA;;;;;cAMA,mBAAA,WAA8B,OAAA;AAAA,cAO9B,qBAAA;AAAA,cAEA,uBAAA;AAAA,iBAUG,sBAAA,CAAA,GAA0B,OAAA;AAAA,iBAI1B,gBAAA,CACd,KAAA;EACG,EAAA;EAAU,IAAA,EAAM,OAAA;AAAA;EAAgB,EAAA;EAAW,OAAA;AAAA;AAAA,iBAgChC,mBAAA,CAAoB,KAAA;;;;iBAUpB,oBAAA,CAAqB,KAAA,YAAiB,IAAA;AAAA,iBAOtC,iBAAA,CAAkB,MAAA,YAAiB,OAAA;;;;;iBAKnC,eAAA,CAAgB,IAAA,EAAM,IAAA,EAAM,MAAA,YAAiB,OAAA;;;KChFxD,UAAA;EACH,GAAA;IACE,IAAA,GAAO,SAAA;IACP,OAAA,GAAU,IAAA,CAAK,WAAA,CAAY,cAAA;EAAA;AAAA;AAAA,KAI1B,mBAAA;EAAA,CACF,IAAA,EAAM,SAAA,EAAW,MAAA,YAAkB,OAAA;EAAA,CACnC,IAAA,EAAM,UAAA,aAAuB,OAAA;AAAA;AAAA,iBAOhB,WAAA,CAAY,IAAA,EAAM,SAAA;AAAA,iBAIlB,OAAA,CAAQ,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,IAAA;;iBAK/B,WAAA,CAAY,IAAA,EAAM,SAAA;AAAA,iBAIlB,aAAA,CACd,IAAA,EAAM,SAAA,EACN,UAAA,EAAY,UAAA,EACZ,MAAA,YAAiB,OAAA;;;;;;iBAaG,cAAA,CAAe,GAAA,GAAK,UAAA,UAAyB,OAAA,CAAQ,OAAA;AAAA,cA+B9D,gBAAA,EAAgB,mBAAA;AAAA,cAChB,cAAA,EAAc,mBAAA;AAAA,cACd,UAAA,EAAU,mBAAA;;cAGV,OAAA,EAAO,mBAAA;;iBAGJ,gBAAA,CACd,IAAA,WACA,MAAA,YAAiB,OAAA;AAAA,iBAKH,eAAA,CAAgB,IAAA,EAAM,SAAA;AAAA,iBACtB,eAAA,CAAgB,IAAA,EAAM,UAAA;AAAA,cAMzB,aAAA,EAAe,MAAA;AAAA,cAMf,wBAAA,EAA0B,MAAA;;iBAMvB,cAAA,CAAA;EAAiB;AAAA,GAAO,UAAA"}