@pipelex/mthds-form 0.29.0 → 0.31.0

package/dist/brand/index.d.ts

@@ -1,54 +1,6 @@
+import { C as ColorTokenName, B as BrandManifest } from '../styles-BoXPBjF4.js';
+export { A as APP_STYLES, a as APP_STYLE_IDS, b as ActionShadow, c as AppStyle, d as AppStyleId, e as BRAND_CONTRACT, f as BodyTypefaceId, g as COLOR_TOKEN_NAMES, h as CONTRAST_PAIRS, i as ContractToken, j as ContractTokenType, k as ContrastPair, M as MIN_CONTRAST, l as MIN_CONTROL_CONTRAST, P as PanelRoles, R as RoleColor, S as StyleRoles, T as TYPEFACES, m as Typeface, n as TypefaceId, o as brandManifestSchema, p as contractVariable, q as deriveStyleRoles, r as isAppStyle, s as isColorTokenName, t as isTypeface, u as resolveRoleColor } from '../styles-BoXPBjF4.js';
 import { z } from 'zod';
-import { B as BrandManifest } from '../manifest-DUeAWeqa.js';
-export { b as brandManifestSchema } from '../manifest-DUeAWeqa.js';
-
-/**
- * The brand contract, as data: which token of a brand's `tokens.json` sets
- * which custom property, and what that property paints.
- *
- * It is the theme contract seen from the other side. `src/styles/theme.css`
- * states it as a working default and `docs/theming.md` in prose; this is the
- * same list as a table a build can read, and a brand is exactly these tokens
- * and no others - the validator refuses a file that adds one, because a token
- * nothing consumes is a value with no way to be looked at.
- *
- * The colour and radius rows are not a second list kept beside `theme.css`:
- * they are held to it, by `__tests__/contract.test.ts` over the source and by
- * `scripts/assert-bundle.mjs` over the build. The two typography rows are the
- * exception, and on purpose. `--font-sans` and `--font-mono` are the names of
- * Tailwind's own theme variables, which the prebuilt sheet already declares,
- * so `theme.css` does not define them: it is unlayered, and a value there
- * would override the typeface of every host that loads it. The stock
- * typeface is therefore the host's own, and only a brand's scope sets these
- * two. See docs/brand.md.
- */
-type ContractTokenType = 'color' | 'dimension' | 'fontFamily';
-interface ContractToken {
-    /** The DTCG token id, `color.background`. */
-    id: string;
-    /** The custom property it sets, `--background`. */
-    variable: string;
-    type: ContractTokenType;
-    /** What the property paints, in the words a producer is told. */
-    paints: string;
-}
-/** The colour tokens, in the order `theme.css` states them. */
-declare const COLOR_TOKEN_NAMES: readonly ["background", "foreground", "card", "card-foreground", "popover", "popover-foreground", "primary", "primary-foreground", "secondary", "secondary-foreground", "muted", "muted-foreground", "accent", "accent-foreground", "destructive", "destructive-foreground", "border", "input", "ring"];
-type ColorTokenName = (typeof COLOR_TOKEN_NAMES)[number];
-declare function isColorTokenName(name: string): name is ColorTokenName;
-declare const BRAND_CONTRACT: readonly ContractToken[];
-/**
- * The pairs that must clear WCAG AA in both modes, as they render: the canvas
- * opaque, the ink blended over it by its alpha.
- */
-declare const CONTRAST_PAIRS: readonly {
-    foreground: ColorTokenName;
-    background: ColorTokenName;
-}[];
-/** The minimum contrast ratio those pairs must reach: WCAG 2 AA for normal text. */
-declare const MIN_CONTRAST = 4.5;
-/** The custom property a token sets, or a loud failure for a token the contract does not name. */
-declare function contractVariable(id: string): string;
 
 declare const srgbColorSchema: z.ZodObject<{
     colorSpace: z.ZodLiteral<"srgb">;
@@ -284,55 +236,6 @@ declare function compileBrand(tokens: BrandTokens, scope: string): string;
 /** Every custom property a compiled brand sets on its scope, in contract order. */
 declare const BRAND_VARIABLES: readonly string[];
 
-/**
- * Up to three seed colours in, the colour roles a page paints with out.
- *
- * A team brands its pages with at most three colours, each optional, each a
- * `#rrggbb` a person picked: the button colour (`action`), the accent
- * (`accent`) and the header band (`header`). A person picks a colour for how
- * it looks, never for how text reads on it, so nothing here assumes a seed is
- * readable. What this derives is everything a page needs around the seeds,
- * with every text role readable by construction:
- *
- * - **Fills are the seeds, exactly.** `action`, `accent` and `header` come
- *   back as they were given, in lower case, so the button and the band are the
- *   colours the person chose.
- * - **Text on a fill is pure black or pure white**, whichever contrasts more
- *   (`onAction`, `onHeader`). One of the two reaches at least 4.58:1 on any
- *   colour, so every label clears WCAG AA. Only the two extremes carry that
- *   guarantee: a warm near-black or an off-white falls below 4.5:1 on some
- *   mid-tone, so no other colour is ever returned for text.
- * - **The accent as text is ink** (`accentInk`): the accent darkened on a
- *   light page or lightened on a dark one, keeping its hue and saturation,
- *   just until it reads at 4.5:1 on the page and on the pale accent fill, the
- *   two backgrounds a host draws accent text on. An accent that already reads
- *   is its own ink.
- * - **The pale accent fill** (`accentFill`) is the accent laid over the page
- *   at a low strength: a pale tint on a light page, a deep one on a dark page.
- *
- * **An unset seed produces no role.** The roles a seed paints are present
- * when it is set and absent when it is not, so a host keeps its own token for
- * whatever the team left unset: the team's colours where it chose some, and
- * the host's palette everywhere else. The one seed that reaches further is the
- * button colour, which the accent follows when the accent is unset, so a red
- * button never sits beside links in another hue. With no seed at all, there
- * is no colour role to return.
- *
- * The page colour is an argument because every text role is measured against
- * it: a host renders a light and a dark theme, and it calls this once per
- * theme with that theme's page colour and that theme's seeds. Which seeds a
- * theme uses is the host's to decide; `resolveDarkSeeds` is the rule for a
- * dark set that falls back, colour by colour, to the light one.
- *
- * It returns roles, never custom property names: each host maps the roles onto
- * its own tokens. See docs/brand.md § "Three seed colours".
- */
-/**
- * The contrast a control's outline needs against what surrounds it: WCAG 2's
- * level for a user interface component (1.4.11). A button colour below it
- * against the page is a button whose shape is hard to see.
- */
-declare const MIN_CONTROL_CONTRAST = 3;
 /**
  * Up to three seed colours, each `#rrggbb` in any case, or unset. `null` and
  * `undefined` both mean unset, so a host can pass a team's stored colours as
@@ -361,7 +264,10 @@ interface AccentRoles {
     accent: string;
     /** A pale accent fill (deep on a dark page), behind accent ink: a pill, a badge. */
     accentFill: string;
-    /** The accent as text, reading at 4.5:1 or more on the page and on `accentFill`. */
+    /**
+     * The accent as text, reading at 4.5:1 or more on the page, on `accentFill`
+     * and on every other surface the host named (`deriveBrandRoles`' `surfaces`).
+     */
     accentInk: string;
 }
 /** The header band's roles, present when the header is set. */
@@ -385,8 +291,18 @@ type BrandRoles = (ActionRoles | Absent<ActionRoles>) & (AccentRoles | Absent<Ac
  * The roles a page paints with, from up to three seeds and the colour of the
  * page they render on. Throws when a seed or the page is not a `#rrggbb`
  * colour: a host validates what a person typed before it reaches here.
+ *
+ * `surfaces` are the other colours accent text sits on besides the page and
+ * the pale fill, each `#rrggbb`: a style's panel and the fields inside it
+ * (`resolveRoleColor` turns a style's role colour into one), or a canvas
+ * behind the page. The ink is moved until it reads on all of them, and an
+ * accent that already reads on every one is its own ink. When there is an
+ * accent to derive and no shade of it reads on the page, the pale fill and
+ * every surface at once, which a surface on the far side of the page's
+ * lightness can cause, it throws, naming them. With no accent, no ink is
+ * derived, and the surfaces are only parsed.
  */
-declare function deriveBrandRoles(seeds: BrandSeeds | null | undefined, page: string): BrandRoles;
+declare function deriveBrandRoles(seeds: BrandSeeds | null | undefined, page: string, surfaces?: readonly string[]): BrandRoles;
 /**
  * Whether the button colour sits below 3:1 against the page, so a button may
  * be hard to see in that theme. Only a colour the person set is judged: with
@@ -395,11 +311,12 @@ declare function deriveBrandRoles(seeds: BrandSeeds | null | undefined, page: st
 declare function isActionFaint(seeds: BrandSeeds | null | undefined, page: string): boolean;
 /**
  * Whether the accent had to be darkened or lightened to become ink on the
- * page, so links read in a shade of it rather than in the colour itself. Only
+ * page (and on the `surfaces`, as `deriveBrandRoles` takes them), so links read
+ * in a shade of it rather than in the colour itself. Only
  * a colour the person set is judged, and the accent counts as set when it
  * follows a button colour the person set: with neither, the answer is `false`.
  */
-declare function isAccentAdjusted(seeds: BrandSeeds | null | undefined, page: string): boolean;
+declare function isAccentAdjusted(seeds: BrandSeeds | null | undefined, page: string, surfaces?: readonly string[]): boolean;
 /**
  * The seeds a dark theme uses: each dark colour where one is set, and the
  * light one where it is not. Colour by colour, before the accent follows the
@@ -411,4 +328,4 @@ declare function resolveDarkSeeds(colors: BrandSeeds | null | undefined, darkCol
 /** Pure black or pure white, whichever reads better on a `#rrggbb` fill. */
 declare function readableTextOn(fill: string): TextOnFill;
 
-export { type AssembleResult, type AssembledBrand, BRAND_CONTRACT, BRAND_PRODUCERS, BRAND_VARIABLES, BrandManifest, type BrandProducer, type BrandProvenance, type BrandRoles, type BrandSeeds, type BrandSource, type BrandTokens, COLOR_TOKEN_NAMES, CONTRAST_PAIRS, type ColorMode, type ColorToken, type ColorTokenName, type ColorValue, type ContractToken, type ContractTokenType, type DimensionToken, type FontFamilyToken, MIN_CONTRAST, MIN_CONTROL_CONTRAST, type SrgbColor, type StatedFacts, type TextOnFill, type TokensValidation, assembleBrand, brandProducerId, brandProvenanceSchema, brandScope, colorHex, colorIsHex, compileBrand, contractVariable, contrastRatio, deriveBrandRoles, isAccentAdjusted, isActionFaint, isColorTokenName, readableTextOn, resolveColor, resolveDarkSeeds, srgbColorSchema, statedFactProblems, statedFactsSchema, validateBrandTokens };
+export { type AssembleResult, type AssembledBrand, BRAND_PRODUCERS, BRAND_VARIABLES, BrandManifest, type BrandProducer, type BrandProvenance, type BrandRoles, type BrandSeeds, type BrandSource, type BrandTokens, type ColorMode, type ColorToken, ColorTokenName, type ColorValue, type DimensionToken, type FontFamilyToken, type SrgbColor, type StatedFacts, type TextOnFill, type TokensValidation, assembleBrand, brandProducerId, brandProvenanceSchema, brandScope, colorHex, colorIsHex, compileBrand, contrastRatio, deriveBrandRoles, isAccentAdjusted, isActionFaint, readableTextOn, resolveColor, resolveDarkSeeds, srgbColorSchema, statedFactProblems, statedFactsSchema, validateBrandTokens };

package/dist/brand/index.js

@@ -1,270 +1,7 @@
-import { httpUrl, brandManifestSchema } from '../chunk-QFX332LE.js';
-export { brandManifestSchema } from '../chunk-QFX332LE.js';
+import { httpUrl, BRAND_CONTRACT, resolveColor, colorIsHex, colorHex, COLOR_TOKEN_NAMES, modeValue, aliasTarget, asWritten, isControlCharacter, brandManifestSchema, validateBrandTokens } from '../chunk-UZNRJWN5.js';
+export { APP_STYLES, APP_STYLE_IDS, BRAND_CONTRACT, COLOR_TOKEN_NAMES, CONTRAST_PAIRS, MIN_CONTRAST, MIN_CONTROL_CONTRAST, TYPEFACES, brandManifestSchema, colorHex, colorIsHex, contractVariable, contrastRatio, deriveBrandRoles, deriveStyleRoles, isAccentAdjusted, isActionFaint, isAppStyle, isColorTokenName, isTypeface, readableTextOn, resolveColor, resolveDarkSeeds, resolveRoleColor, srgbColorSchema, validateBrandTokens } from '../chunk-UZNRJWN5.js';
 import { z } from 'zod';
 
-// src/brand/contract.ts
-var COLOR_TOKEN_NAMES = [
-  "background",
-  "foreground",
-  "card",
-  "card-foreground",
-  "popover",
-  "popover-foreground",
-  "primary",
-  "primary-foreground",
-  "secondary",
-  "secondary-foreground",
-  "muted",
-  "muted-foreground",
-  "accent",
-  "accent-foreground",
-  "destructive",
-  "destructive-foreground",
-  "border",
-  "input",
-  "ring"
-];
-function isColorTokenName(name) {
-  return COLOR_TOKEN_NAMES.includes(name);
-}
-var COLOR_PAINTS = {
-  background: "The page canvas.",
-  foreground: "Text on the canvas.",
-  card: "A raised surface on the canvas: the rail's panel, a list's rows. May be translucent.",
-  "card-foreground": "Text on a card.",
-  popover: "A floating surface: a select's menu, a tooltip. Opaque.",
-  "popover-foreground": "Text on a popover.",
-  primary: "The accent: the run button, a selected pill, a section number, a highlight.",
-  "primary-foreground": "Text on the accent.",
-  secondary: "A quiet filled surface: a secondary button, an unselected segment.",
-  "secondary-foreground": "Text on a secondary surface.",
-  muted: "A subdued fill: a table's header band, an inactive tab strip.",
-  "muted-foreground": "Secondary text: descriptions, hints, a summary row's label. Most of the text on the page that is not a heading or a value.",
-  accent: "A hover fill: a menu item under the pointer.",
-  "accent-foreground": "Text on an accent fill.",
-  destructive: "The error colour: an invalid mark, a remove button.",
-  "destructive-foreground": "Text on the destructive colour.",
-  border: "The hairline: every border and divider.",
-  input: "The control surface, a field's own fill - a step off the canvas, so fields read as one family.",
-  ring: "The focus ring."
-};
-var BRAND_CONTRACT = [
-  ...COLOR_TOKEN_NAMES.map((name) => ({
-    id: `color.${name}`,
-    variable: `--${name}`,
-    type: "color",
-    paints: COLOR_PAINTS[name]
-  })),
-  {
-    id: "radius.base",
-    variable: "--radius",
-    type: "dimension",
-    paints: "The corner radius of a control; cards take one and a half of it."
-  },
-  {
-    id: "font.sans",
-    variable: "--font-sans",
-    type: "fontFamily",
-    paints: "The typeface of everything on the page."
-  },
-  {
-    id: "font.mono",
-    variable: "--font-mono",
-    type: "fontFamily",
-    paints: "Tags, numbers, the receipt."
-  }
-];
-var CONTRAST_PAIRS = [
-  { foreground: "foreground", background: "background" },
-  { foreground: "muted-foreground", background: "background" }
-];
-var MIN_CONTRAST = 4.5;
-var byId = new Map(BRAND_CONTRACT.map((token) => [token.id, token]));
-function contractVariable(id) {
-  const token = byId.get(id);
-  if (!token) throw new Error(`The brand contract has no token ${id}.`);
-  return token.variable;
-}
-var component = z.number().min(0).max(1);
-var srgbColorSchema = z.strictObject({
-  colorSpace: z.literal("srgb"),
-  components: z.tuple([component, component, component]),
-  alpha: z.number().min(0).max(1),
-  hex: z.string().regex(/^#[0-9a-f]{6}$/i, "a hex colour is #rrggbb").optional()
-});
-var colorAliasSchema = z.string().regex(/^\{color\.[a-z][a-z-]*\}$/, 'an alias is "{color.<name>}"');
-var colorValueSchema = z.union([srgbColorSchema, colorAliasSchema]);
-var description = z.string().min(1, "every token carries a $description");
-function isControlCharacter(char) {
-  const code = char.codePointAt(0);
-  return code < 32 || code === 127;
-}
-var colorTokenSchema = z.strictObject({
-  $value: colorValueSchema,
-  $description: description,
-  $extensions: z.strictObject({
-    mode: z.strictObject({ dark: colorValueSchema })
-  }).optional()
-}).refine((token) => token.$extensions !== void 0 || typeof token.$value === "string", {
-  message: "a colour carries $extensions.mode.dark; only an alias may stand for both modes",
-  path: ["$extensions"]
-});
-var dimensionTokenSchema = z.strictObject({
-  $value: z.strictObject({ value: z.number().min(0), unit: z.enum(["rem", "px"]) }),
-  $description: description
-});
-var fontFamilyTokenSchema = z.strictObject({
-  $value: z.array(
-    z.string().min(1).refine((name) => ![...name].some(isControlCharacter), {
-      message: "a family name holds no control characters"
-    })
-  ).min(1),
-  $description: description
-});
-var brandTokensSchema = z.strictObject({
-  color: z.strictObject({
-    $type: z.literal("color"),
-    ...Object.fromEntries(COLOR_TOKEN_NAMES.map((name) => [name, colorTokenSchema]))
-  }),
-  radius: z.strictObject({ $type: z.literal("dimension"), base: dimensionTokenSchema }),
-  font: z.strictObject({
-    $type: z.literal("fontFamily"),
-    sans: fontFamilyTokenSchema,
-    mono: fontFamilyTokenSchema
-  })
-});
-function aliasTarget(value) {
-  return typeof value === "string" ? value.slice("{color.".length, -1) : null;
-}
-function darkValue(token) {
-  return token.$extensions?.mode.dark ?? token.$value;
-}
-function modeValue(token, mode) {
-  return mode === "light" ? token.$value : darkValue(token);
-}
-function colorHex(color) {
-  return `#${color.components.map(
-    (channel) => Math.round(channel * 255).toString(16).padStart(2, "0")
-  ).join("")}`;
-}
-function colorIsHex(color, hex) {
-  return colorHex(color) === hex.toLowerCase();
-}
-function asWritten(color) {
-  const alpha = Number(Math.min(color.alpha, 1).toFixed(3));
-  return {
-    colorSpace: "srgb",
-    components: color.components.map((channel) => Math.round(channel * 255) / 255),
-    alpha
-  };
-}
-function checkHexAgreement(name, mode, value, problems) {
-  if (typeof value === "string" || !value.hex) return;
-  if (!colorIsHex(value, value.hex)) {
-    problems.push(
-      `color.${name} (${mode}): hex ${value.hex} does not agree with components [${value.components.join(", ")}]`
-    );
-  }
-}
-function checkAliases(tokens, mode, problems) {
-  for (const name of COLOR_TOKEN_NAMES) {
-    const seen = /* @__PURE__ */ new Set([name]);
-    let current = name;
-    for (; ; ) {
-      const target = aliasTarget(modeValue(tokens.color[current], mode));
-      if (target === null) break;
-      if (!isColorTokenName(target)) {
-        problems.push(
-          `color.${name} (${mode}): aliases {color.${target}}, which the contract has no token for`
-        );
-        break;
-      }
-      if (seen.has(target)) {
-        problems.push(`color.${name} (${mode}): alias cycle through {color.${target}}`);
-        break;
-      }
-      seen.add(target);
-      current = target;
-    }
-  }
-}
-function resolveColor(tokens, name, mode) {
-  const seen = /* @__PURE__ */ new Set();
-  let current = name;
-  for (; ; ) {
-    if (seen.has(current)) return null;
-    seen.add(current);
-    const value = modeValue(tokens.color[current], mode);
-    const target = aliasTarget(value);
-    if (target === null) return value;
-    if (!isColorTokenName(target)) return null;
-    current = target;
-  }
-}
-function luminance(color) {
-  const [r, g, b] = color.components.map(
-    (channel) => channel <= 0.04045 ? channel / 12.92 : ((channel + 0.055) / 1.055) ** 2.4
-  );
-  return 0.2126 * r + 0.7152 * g + 0.0722 * b;
-}
-function contrastRatio(a, b) {
-  const la = luminance(a);
-  const lb = luminance(b);
-  const [light, dark] = la > lb ? [la, lb] : [lb, la];
-  return (light + 0.05) / (dark + 0.05);
-}
-function composite(color, over) {
-  const components = color.components.map(
-    (channel, index) => channel * color.alpha + over.components[index] * (1 - color.alpha)
-  );
-  return { colorSpace: "srgb", components, alpha: 1 };
-}
-function checkContrast(tokens, mode, problems) {
-  for (const pair of CONTRAST_PAIRS) {
-    const foreground = resolveColor(tokens, pair.foreground, mode);
-    const background = resolveColor(tokens, pair.background, mode);
-    if (!foreground || !background) continue;
-    if (background.alpha < 1) {
-      problems.push(
-        `color.${pair.background} (${mode}): alpha ${background.alpha}, but text is measured against it, so it must be opaque (alpha 1)`
-      );
-      continue;
-    }
-    const canvas = asWritten(background);
-    const ratio = contrastRatio(composite(asWritten(foreground), canvas), canvas);
-    if (ratio < MIN_CONTRAST) {
-      problems.push(
-        `color.${pair.foreground} on color.${pair.background} (${mode}): contrast ${ratio.toFixed(2)}, expected ${MIN_CONTRAST} (WCAG AA)`
-      );
-    }
-  }
-}
-function validateBrandTokens(doc) {
-  const parsed = brandTokensSchema.safeParse(doc);
-  if (!parsed.success) {
-    return {
-      ok: false,
-      problems: parsed.error.issues.map((issue) => {
-        const where = issue.path.map(String).join(".") || "(root)";
-        return `${where}: ${issue.message}`;
-      })
-    };
-  }
-  const tokens = parsed.data;
-  const problems = [];
-  for (const name of COLOR_TOKEN_NAMES) {
-    const token = tokens.color[name];
-    checkHexAgreement(name, "light", token.$value, problems);
-    checkHexAgreement(name, "dark", darkValue(token), problems);
-  }
-  checkAliases(tokens, "light", problems);
-  checkAliases(tokens, "dark", problems);
-  if (problems.length === 0) {
-    checkContrast(tokens, "light", problems);
-    checkContrast(tokens, "dark", problems);
-  }
-  return problems.length === 0 ? { ok: true, tokens } : { ok: false, problems };
-}
 var statedHex = z.string().regex(/^#[0-9a-f]{6}$/i, "a stated accent is #rrggbb");
 var statedFactsSchema = z.strictObject({
   /** The accent per mode, `#rrggbb`: what `color.primary` resolves to in that mode. */
@@ -274,8 +11,10 @@ var statedFactsSchema = z.strictObject({
   }).optional(),
   /**
    * The logo for a canvas: `logo.onLight` or `logo.onDark` in the manifest,
-   * which the brand must carry exactly, so it obeys the manifest's rule (http
-   * or https) or no brand could ever honour it.
+   * which the brand must carry exactly. It is held to the http(s) half of the
+   * manifest's logo rule, so a manifest can always carry it; the manifest's
+   * other half, a root-relative path, names a file on the host serving the
+   * page, which means nothing as a fact stated beside another site's URL.
    */
   logo: z.strictObject({
     onLight: httpUrl.optional(),
@@ -392,8 +131,8 @@ function compileBrand(tokens, scope) {
   return [`.${scope} {`, ...light, "}", "", `.dark .${scope} {`, ...dark, "}", ""].join("\n");
 }
 var BRAND_VARIABLES = BRAND_CONTRACT.map((token) => token.variable);
-function declaration(description2, property, value) {
-  return [`  /* ${commentText(description2)} */`, `  ${property}: ${value};`];
+function declaration(description, property, value) {
+  return [`  /* ${commentText(description)} */`, `  ${property}: ${value};`];
 }
 function commentText(text) {
   return text.replace(/\s+/g, " ").replace(/\*\//g, "* /").replace(/<\//g, "< /").trim();
@@ -482,118 +221,6 @@ function assembleBrand(source) {
   };
 }
 
-// src/brand/seed-roles.ts
-var MIN_CONTROL_CONTRAST = 3;
-var ACCENT_FILL_STRENGTH = 0.12;
-var SEARCH_STEPS = 32;
-function deriveBrandRoles(seeds, page) {
-  const canvas = parseHex(page, "The page colour");
-  const action = seeds?.action == null ? null : parseHex(seeds.action, "The action seed");
-  const accent = seeds?.accent == null ? action : parseHex(seeds.accent, "The accent seed");
-  const header = seeds?.header == null ? null : parseHex(seeds.header, "The header seed");
-  const actionRoles = action === null ? {} : { action: colorHex(action), onAction: textOn(action) };
-  const accentRoles = accent === null ? {} : accentRolesOf(accent, canvas);
-  const headerRoles = header === null ? {} : { header: colorHex(header), onHeader: textOn(header) };
-  return { ...actionRoles, ...accentRoles, ...headerRoles };
-}
-function accentRolesOf(accent, canvas) {
-  const extreme = textOn(canvas) === "#000000" ? BLACK : WHITE;
-  const accentFill = paleFill(accent, canvas, extreme);
-  const accentInk = inkFor(accent, [canvas, accentFill], extreme);
-  return {
-    accent: colorHex(accent),
-    accentFill: colorHex(accentFill),
-    accentInk: colorHex(accentInk)
-  };
-}
-function isActionFaint(seeds, page) {
-  const canvas = parseHex(page, "The page colour");
-  if (seeds?.action == null) return false;
-  return contrastRatio(parseHex(seeds.action, "The action seed"), canvas) < MIN_CONTROL_CONTRAST;
-}
-function isAccentAdjusted(seeds, page) {
-  const roles = deriveBrandRoles(seeds, page);
-  return roles.accentInk !== void 0 && roles.accentInk !== roles.accent;
-}
-function resolveDarkSeeds(colors, darkColors) {
-  return {
-    action: darkColors?.action ?? colors?.action ?? null,
-    accent: darkColors?.accent ?? colors?.accent ?? null,
-    header: darkColors?.header ?? colors?.header ?? null
-  };
-}
-function readableTextOn(fill) {
-  return textOn(parseHex(fill, "The fill"));
-}
-var BLACK = { components: [0, 0, 0]};
-var WHITE = { components: [1, 1, 1]};
-function textOn(fill) {
-  return contrastRatio(BLACK, fill) >= contrastRatio(WHITE, fill) ? "#000000" : "#ffffff";
-}
-function parseHex(value, what) {
-  if (typeof value !== "string" || !/^#[0-9a-f]{6}$/i.test(value)) {
-    throw new Error(`${what} must be a #rrggbb colour, not ${JSON.stringify(value)}.`);
-  }
-  const channel = (at) => parseInt(value.slice(at, at + 2), 16) / 255;
-  return { colorSpace: "srgb", components: [channel(1), channel(3), channel(5)], alpha: 1 };
-}
-function snapped(components) {
-  const [r, g, b] = components.map(
-    (channel) => Math.round(Math.min(1, Math.max(0, channel)) * 255) / 255
-  );
-  return { colorSpace: "srgb", components: [r, g, b], alpha: 1 };
-}
-function paleFill(accent, page, extreme) {
-  const at = (strength) => snapped(
-    page.components.map(
-      (channel, index) => channel + (accent.components[index] - channel) * strength
-    )
-  );
-  const nominal = at(ACCENT_FILL_STRENGTH);
-  if (contrastRatio(extreme, nominal) >= MIN_CONTRAST) return nominal;
-  let enough = 0;
-  let short = ACCENT_FILL_STRENGTH;
-  for (let step = 0; step < SEARCH_STEPS; step++) {
-    const middle = (enough + short) / 2;
-    if (contrastRatio(extreme, at(middle)) >= MIN_CONTRAST) enough = middle;
-    else short = middle;
-  }
-  return at(enough);
-}
-function inkFor(accent, backgrounds, extreme) {
-  const reads = (color) => backgrounds.every((background) => contrastRatio(color, background) >= MIN_CONTRAST);
-  if (reads(accent)) return accent;
-  const [hue, saturation, lightness] = toHsl(accent.components);
-  const at = (value) => snapped(fromHsl(hue, saturation, value));
-  let short = lightness;
-  let enough = extreme === BLACK ? 0 : 1;
-  for (let step = 0; step < SEARCH_STEPS; step++) {
-    const middle = (short + enough) / 2;
-    if (reads(at(middle))) enough = middle;
-    else short = middle;
-  }
-  return at(enough);
-}
-function toHsl(components) {
-  const [r, g, b] = components;
-  const max = Math.max(r, g, b);
-  const min = Math.min(r, g, b);
-  const lightness = (max + min) / 2;
-  const chroma = max - min;
-  if (chroma === 0) return [0, 0, lightness];
-  const saturation = chroma / (1 - Math.abs(2 * lightness - 1));
-  const sector = max === r ? ((g - b) / chroma + 6) % 6 : max === g ? (b - r) / chroma + 2 : (r - g) / chroma + 4;
-  return [sector * 60, Math.min(1, saturation), lightness];
-}
-function fromHsl(hue, saturation, lightness) {
-  const chroma = (1 - Math.abs(2 * lightness - 1)) * saturation;
-  const sector = hue / 60;
-  const second = chroma * (1 - Math.abs(sector % 2 - 1));
-  const [r, g, b] = sector < 1 ? [chroma, second, 0] : sector < 2 ? [second, chroma, 0] : sector < 3 ? [0, chroma, second] : sector < 4 ? [0, second, chroma] : sector < 5 ? [second, 0, chroma] : [chroma, 0, second];
-  const offset = lightness - chroma / 2;
-  return [r + offset, g + offset, b + offset];
-}
-
-export { BRAND_CONTRACT, BRAND_PRODUCERS, BRAND_VARIABLES, COLOR_TOKEN_NAMES, CONTRAST_PAIRS, MIN_CONTRAST, MIN_CONTROL_CONTRAST, assembleBrand, brandProducerId, brandProvenanceSchema, brandScope, colorHex, colorIsHex, compileBrand, contractVariable, contrastRatio, deriveBrandRoles, isAccentAdjusted, isActionFaint, isColorTokenName, readableTextOn, resolveColor, resolveDarkSeeds, srgbColorSchema, statedFactProblems, statedFactsSchema, validateBrandTokens };
+export { BRAND_PRODUCERS, BRAND_VARIABLES, assembleBrand, brandProducerId, brandProvenanceSchema, brandScope, compileBrand, statedFactProblems, statedFactsSchema };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map