@getvitops/generator 0.9.0 → 2.0.0

package/dist/index.d.mts

@@ -1,25 +1,37 @@
 import * as z from "zod/mini";
+import { ContentNode } from "@getvitops/utils";
 
 //#region src/schema.d.ts
 declare const DesignSystemSchema: z.ZodMiniObject<{
   $schema: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  meta: z.ZodMiniOptional<z.ZodMiniObject<{
+    name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  }, z.z.core.$strict>>;
   colors: z.ZodMiniObject<{
     palette: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniObject<{
       seed: z.ZodMiniString<string>;
       anchors: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-    }, z.z.core.$strip>, z.ZodMiniObject<{
+    }, z.z.core.$strict>, z.ZodMiniObject<{
       tones: z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniString<string>>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>;
-    }, z.z.core.$strip>]>>;
-    roles: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+    }, z.z.core.$strict>]>>;
+    roles: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
+      hue: z.ZodMiniString<string>;
+      kind: z.ZodMiniOptional<z.ZodMiniEnum<{
+        surface: "surface";
+        chromatic: "chromatic";
+      }>>;
+    }, z.z.core.$strict>]>>;
     utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
       bg: "bg";
       text: "text";
+      icon: "icon";
       border: "border";
       outline: "outline";
       fill: "fill";
       stroke: "stroke";
     }>>>;
-  }, z.z.core.$strip>;
+  }, z.z.core.$strict>;
   shadows: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
   fonts: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
   typeScale: z.ZodMiniOptional<z.ZodMiniObject<{
@@ -33,8 +45,8 @@ declare const DesignSystemSchema: z.ZodMiniObject<{
       minVw: z.ZodMiniString<string>;
       maxVw: z.ZodMiniString<string>;
       minRatio: z.ZodMiniNumber<number>;
-    }, z.z.core.$strip>>;
-  }, z.z.core.$strip>>;
+    }, z.z.core.$strict>>;
+  }, z.z.core.$strict>>;
   spaceScale: z.ZodMiniOptional<z.ZodMiniObject<{
     base: z.ZodMiniString<string>;
     ratio: z.ZodMiniNumber<number>;
@@ -46,8 +58,8 @@ declare const DesignSystemSchema: z.ZodMiniObject<{
       minVw: z.ZodMiniString<string>;
       maxVw: z.ZodMiniString<string>;
       minRatio: z.ZodMiniNumber<number>;
-    }, z.z.core.$strip>>;
-  }, z.z.core.$strip>>;
+    }, z.z.core.$strict>>;
+  }, z.z.core.$strict>>;
   patterns: z.ZodMiniOptional<z.ZodMiniObject<{
     defaults: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
     radii: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
@@ -63,25 +75,25 @@ declare const DesignSystemSchema: z.ZodMiniObject<{
       base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
       states: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>>;
       roles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-    }, z.z.core.$strip>>>;
-  }, z.z.core.$strip>>;
+    }, z.z.core.$strict>>>;
+  }, z.z.core.$strict>>;
   typography: z.ZodMiniOptional<z.ZodMiniObject<{
     families: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
     roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
     headings: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-  }, z.z.core.$strip>>;
+  }, z.z.core.$strict>>;
   animations: z.ZodMiniOptional<z.ZodMiniObject<{
     effects: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
       kf: z.ZodMiniString<string>;
       css: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
       vars: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
-    }, z.z.core.$strip>>>;
+    }, z.z.core.$strict>>>;
     journeys: z.ZodMiniOptional<z.ZodMiniObject<{
       base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
       compose: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniArray<z.ZodMiniString<string>>>>;
-    }, z.z.core.$strip>>;
-  }, z.z.core.$strip>>;
-}, z.z.core.$strip>;
+    }, z.z.core.$strict>>;
+  }, z.z.core.$strict>>;
+}, z.z.core.$strict>;
 type DesignSystem = z.infer<typeof DesignSystemSchema>;
 /**
  * Stable URL of the published JSON Schema. Resolves once `@getvitops/generator` is on
@@ -93,23 +105,34 @@ declare const SCHEMA_URL = "https://unpkg.com/@getvitops/generator/schema.json";
 declare const jsonSchema: {
   "~standard": z.z.core.ZodStandardSchemaWithJSON<z.ZodMiniObject<{
     $schema: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    meta: z.ZodMiniOptional<z.ZodMiniObject<{
+      name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.z.core.$strict>>;
     colors: z.ZodMiniObject<{
       palette: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniObject<{
         seed: z.ZodMiniString<string>;
         anchors: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-      }, z.z.core.$strip>, z.ZodMiniObject<{
+      }, z.z.core.$strict>, z.ZodMiniObject<{
         tones: z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniString<string>>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>;
-      }, z.z.core.$strip>]>>;
-      roles: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>;
+      }, z.z.core.$strict>]>>;
+      roles: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
+        hue: z.ZodMiniString<string>;
+        kind: z.ZodMiniOptional<z.ZodMiniEnum<{
+          surface: "surface";
+          chromatic: "chromatic";
+        }>>;
+      }, z.z.core.$strict>]>>;
       utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
         bg: "bg";
         text: "text";
+        icon: "icon";
         border: "border";
         outline: "outline";
         fill: "fill";
         stroke: "stroke";
       }>>>;
-    }, z.z.core.$strip>;
+    }, z.z.core.$strict>;
     shadows: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
     fonts: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
     typeScale: z.ZodMiniOptional<z.ZodMiniObject<{
@@ -123,8 +146,8 @@ declare const jsonSchema: {
         minVw: z.ZodMiniString<string>;
         maxVw: z.ZodMiniString<string>;
         minRatio: z.ZodMiniNumber<number>;
-      }, z.z.core.$strip>>;
-    }, z.z.core.$strip>>;
+      }, z.z.core.$strict>>;
+    }, z.z.core.$strict>>;
     spaceScale: z.ZodMiniOptional<z.ZodMiniObject<{
       base: z.ZodMiniString<string>;
       ratio: z.ZodMiniNumber<number>;
@@ -136,8 +159,8 @@ declare const jsonSchema: {
         minVw: z.ZodMiniString<string>;
         maxVw: z.ZodMiniString<string>;
         minRatio: z.ZodMiniNumber<number>;
-      }, z.z.core.$strip>>;
-    }, z.z.core.$strip>>;
+      }, z.z.core.$strict>>;
+    }, z.z.core.$strict>>;
     patterns: z.ZodMiniOptional<z.ZodMiniObject<{
       defaults: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
       radii: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
@@ -153,25 +176,25 @@ declare const jsonSchema: {
         base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
         states: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>>;
         roles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-      }, z.z.core.$strip>>>;
-    }, z.z.core.$strip>>;
+      }, z.z.core.$strict>>>;
+    }, z.z.core.$strict>>;
     typography: z.ZodMiniOptional<z.ZodMiniObject<{
       families: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
       roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
       headings: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-    }, z.z.core.$strip>>;
+    }, z.z.core.$strict>>;
     animations: z.ZodMiniOptional<z.ZodMiniObject<{
       effects: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
         kf: z.ZodMiniString<string>;
         css: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
         vars: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
-      }, z.z.core.$strip>>>;
+      }, z.z.core.$strict>>>;
       journeys: z.ZodMiniOptional<z.ZodMiniObject<{
         base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
         compose: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniArray<z.ZodMiniString<string>>>>;
-      }, z.z.core.$strip>>;
-    }, z.z.core.$strip>>;
-  }, z.z.core.$strip>>;
+      }, z.z.core.$strict>>;
+    }, z.z.core.$strict>>;
+  }, z.z.core.$strict>>;
   $schema?: "https://json-schema.org/draft/2020-12/schema" | "http://json-schema.org/draft-07/schema#" | "http://json-schema.org/draft-04/schema#";
   $id: string;
   $anchor?: string;
@@ -254,142 +277,91 @@ type ValidationResult = {
  */
 declare function validate(input: unknown): ValidationResult;
 //#endregion
-//#region src/tokens.d.ts
-declare const NUMERIC_STEPS: readonly ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
-type NumStep = (typeof NUMERIC_STEPS)[number];
-interface ExpandedHue {
-  /** Numeric steps (sparse for fixed-tone kits). */
-  numeric: Partial<Record<NumStep, string>>;
-  /** True when only authored tones + endpoints exist (no interpolation). */
-  sparse?: boolean;
-}
-/** Expand every palette hue into its numeric scale. */
-declare function expandPalette(raw: Record<string, unknown>): Record<string, ExpandedHue>;
-interface FunctionalRole {
-  role: string;
-  hue: string;
-  /** token → CSS value, per appearance. */
-  light: Record<string, string>;
-  dark: Record<string, string>;
-}
-/** Resolve the functional token set for one role over its hue. */
-declare function functionalRole(role: string, hueName: string, hue: ExpandedHue): FunctionalRole;
-//#endregion
-//#region src/generate.d.ts
-type Format = 'bricks' | 'css' | 'tailwind';
-interface GenerateOptions {
-  /** Path to a design-system.json, OR an already-parsed config object. */
-  input: string | DesignSystem;
-  /** Output target. Default: 'bricks'. */
-  format?: Format;
-  /** Directory to write outputs into. Default: 'dist'. */
-  outDir?: string;
-  /** Override the framework asset root (advanced/testing). */
-  assetsDir?: string;
-}
-interface GenerateResult {
-  format: Format;
-  outDir: string;
-  written: string[];
-}
-interface ColorUtility {
-  /** Class name, without the leading dot. */
-  cls: string;
-  /** CSS property the class sets. */
-  prop: string;
-  /** `var(--…)` reference the class resolves to. */
-  value: string;
-  /** Which of the two axes below produced it. */
-  axis: 'plane' | 'stop';
-}
-/**
- * Every role colour utility, each class name emitted EXACTLY once.
- *
- * Two axes share the `<family>-<role>-<modifier>` namespace: the functional
- * background/text/border **planes** (`--<role>-bg-muted`) and the
- * appearance-relative emphasis **stops** (`--color-<role>-muted`). Where both
- * would produce the same class the plane wins.
- *
- * That precedence used to be implicit — the css path emitted the stop matrix,
- * then the planes, and relied on the CSS minifier dropping the shadowed
- * earlier rule. The tailwind path never ran the stop half at all, so the two
- * formats shipped different vocabularies (87 role classes existed in css and
- * not in tailwind) with nothing to catch it. Deciding it here, once, is what
- * keeps all three formats in step; `format-parity.test.ts` holds them there.
- *
- * Order is stops-then-planes to match the css bundle's historical rule order.
- */
-declare function roleColorUtilities(roles: readonly FunctionalRole[], utilities: readonly string[]): ColorUtility[];
-declare function generate(options: GenerateOptions): Promise<GenerateResult>;
-//#endregion
-//#region src/docs.d.ts
-/**
- * Build the OKF docs bundle for a config. Returns a `{ relPath: content }` map;
- * the caller writes it wherever the bundle should live (e.g. `<outDir>/docs`).
- */
-declare function generateDocs(ds: DesignSystem, assetsDir: string): Record<string, string>;
-//#endregion
-//#region src/shared.d.ts
-/**
- * Data shared between the generator (`generate.ts`) and the docs bundle
- * (`docs.ts`). Lives in its own module because `generate.ts` imports `docs.ts` —
- * importing back the other way would be a cycle.
- */
-/**
- * Selector the dark functional-token flip hangs off.
- *
- * `data-brx-theme` is Bricks' own attribute — Bricks sets it, so it's what the
- * WordPress target needs. Nothing sets it anywhere else, which meant the dark
- * flip was unreachable outside Bricks: the shipped `<color-scheme-toggle>` web
- * component writes `documentElement.dataset.theme` (i.e. `data-theme`), so
- * clicking "Dark" changed an attribute no rule matched. Matching both makes the
- * component work on every target without changing what Bricks already does.
- *
- * Note this covers the explicit choice only — there is deliberately no
- * `prefers-color-scheme` block, so the toggle's "System" position currently
- * resolves to light. Adding one would flip every existing consumer site dark for
- * dark-OS users, which is a product decision, not a bug fix.
- *
- * Shared so the docs quote the selector the generator actually emits.
- */
-declare const DARK_SEL = ":root[data-brx-theme=\"dark\"], :root[data-theme=\"dark\"]";
-/**
- * Roles the shipped CSS partials reference with NO fallback, so a config that
- * omits one leaves those rules resolving to nothing — an invalid declaration,
- * not a graceful degrade.
- *
- * `colors.roles` is an open record: any name works and generates a full token
- * set, utilities and dark flip. But the framework's own component CSS is
- * written against these six, so "roles are arbitrary" is only half true — they
- * are *extensible*, over a required core. `validate()` warns when one is
- * missing; `required-roles.test.ts` re-derives this list from the partials so
- * it cannot drift as components are added.
- *
- * Kept as a constant rather than scanned at call time because `validate()` is
- * a pure function — the CLI, the Vite plugin and `toJSONSchema` all import it,
- * and none of them should touch the filesystem to answer "is this config ok?".
- */
-declare const REQUIRED_ROLES: readonly string[];
-/**
- * The functional-token and emphasis-stop suffixes a role resolves to. Shared so
- * the required-roles drift test greps for exactly what the generator emits.
- */
-declare const ROLE_TOKEN_SUFFIXES: readonly string[];
-/**
- * Pattern base geometry props → per-pattern override-hook shorthand. Each hook
- * wraps the authored value (`padding: var(--p-btn, 0.4em 0.8em)`) so a
- * consumer restyles one pattern by setting one variable. The hook is named after
- * the pattern's key, not its class.
- */
-declare const BASE_HOOK: Record<string, string>;
+//#region src/site.d.ts
+declare const PostalAddressSchema: z.ZodMiniObject<{
+  streetAddress: z.ZodMiniString<string>;
+  addressLocality: z.ZodMiniString<string>;
+  addressRegion: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  addressCountry: z.ZodMiniString<string>;
+}, z.z.core.$strip>;
+declare const ContactObjectSchema: z.ZodMiniObject<{
+  name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  email: z.ZodMiniOptional<z.ZodMiniEmail>;
+  phone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+  address: z.ZodMiniOptional<z.ZodMiniObject<{
+    streetAddress: z.ZodMiniString<string>;
+    addressLocality: z.ZodMiniString<string>;
+    addressRegion: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    addressCountry: z.ZodMiniString<string>;
+  }, z.z.core.$strip>>;
+}, z.z.core.$strip>;
+type PostalAddress = z.infer<typeof PostalAddressSchema>;
+type ContactObject = z.infer<typeof ContactObjectSchema>;
+declare const SiteFontSchema: z.ZodMiniObject<{
+  name: z.ZodMiniString<string>;
+  provider: z.ZodMiniEnum<{
+    google: "google";
+    fontsource: "fontsource";
+    adobe: "adobe";
+    bunny: "bunny";
+    fontshare: "fontshare";
+    googleicons: "googleicons";
+    npm: "npm";
+    local: "local";
+  }>;
+  cssVariable: z.ZodMiniString<string>;
+  weights: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniUnion<readonly [z.ZodMiniNumber<number>, z.ZodMiniString<string>]>>>;
+  styles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
+    normal: "normal";
+    italic: "italic";
+  }>>>;
+  subsets: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  fallbacks: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  optimizedFallbacks: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+  display: z.ZodMiniOptional<z.ZodMiniEnum<{
+    optional: "optional";
+    auto: "auto";
+    block: "block";
+    swap: "swap";
+    fallback: "fallback";
+  }>>;
+  formats: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  unicodeRange: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  variants: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+    src: z.ZodMiniArray<z.ZodMiniString<string>>;
+    weight: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniNumber<number>, z.ZodMiniString<string>]>>;
+    style: z.ZodMiniOptional<z.ZodMiniEnum<{
+      normal: "normal";
+      italic: "italic";
+    }>>;
+    unicodeRange: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    display: z.ZodMiniOptional<z.ZodMiniEnum<{
+      optional: "optional";
+      auto: "auto";
+      block: "block";
+      swap: "swap";
+      fallback: "fallback";
+    }>>;
+  }, z.z.core.$strip>>>;
+  preload: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniBoolean<boolean>, z.ZodMiniArray<z.ZodMiniObject<{
+    weight: z.ZodMiniUnion<readonly [z.ZodMiniNumber<number>, z.ZodMiniString<string>]>;
+    style: z.ZodMiniOptional<z.ZodMiniEnum<{
+      normal: "normal";
+      italic: "italic";
+    }>>;
+  }, z.z.core.$strip>>]>>;
+}, z.z.core.$strip>;
 /**
- * Framework utility classes whose names collide with Tailwind's own defaults.
- * The `tailwind` format strips any rule targeting these — Tailwind provides
- * them, so consumers use Tailwind's utilities for these names instead.
+ * Which template set the generated legal documents are written against. This is
+ * a closed enum rather than a free string because an unrecognised value would
+ * otherwise silently fall back to the wrong body of law; `validateSite` rejects
+ * anything without a registered template. Add a member here and a matching entry
+ * in `legal/templates/index.ts` — the two are checked against each other.
  */
-declare const TW_CLASH: ReadonlySet<string>;
-//#endregion
-//#region src/site.d.ts
+declare const JURISDICTIONS: readonly ["ca"];
+type Jurisdiction = (typeof JURISDICTIONS)[number];
 declare const SiteConfigSchema: z.ZodMiniObject<{
   defaultLocale: z.ZodMiniString<string>;
   locales: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
@@ -557,124 +529,137 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
       overrides: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
     }, z.z.core.$strip>>>;
   }, z.z.core.$strip>>;
-  designSystem: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
-    $schema: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
-    shadows: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
-    fonts: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
-    typeScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-      base: z.ZodMiniString<string>;
-      ratio: z.ZodMiniNumber<number>;
-      steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-      names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-      baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-      baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
-      fluid: z.ZodMiniOptional<z.ZodMiniObject<{
-        minVw: z.ZodMiniString<string>;
-        maxVw: z.ZodMiniString<string>;
-        minRatio: z.ZodMiniNumber<number>;
-      }, z.z.core.$strip>>;
-    }, z.z.core.$strip>>>;
-    spaceScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-      base: z.ZodMiniString<string>;
-      ratio: z.ZodMiniNumber<number>;
-      steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-      names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-      baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-      baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
-      fluid: z.ZodMiniOptional<z.ZodMiniObject<{
-        minVw: z.ZodMiniString<string>;
-        maxVw: z.ZodMiniString<string>;
-        minRatio: z.ZodMiniNumber<number>;
-      }, z.z.core.$strip>>;
-    }, z.z.core.$strip>>>;
-    patterns: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-      defaults: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-      radii: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-      groups: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
-      z: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniNumber<number>>>;
-      items: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
-        group: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        overrides: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-        element: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        class: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        fill: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-        default_role: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-        states: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>>;
-        roles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-      }, z.z.core.$strip>>>;
-    }, z.z.core.$strip>>>;
-    typography: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-      families: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-      roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
-      headings: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-    }, z.z.core.$strip>>>;
-    animations: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-      effects: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
-        kf: z.ZodMiniString<string>;
-        css: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
-        vars: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
-      }, z.z.core.$strip>>>;
-      journeys: z.ZodMiniOptional<z.ZodMiniObject<{
-        base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
-        compose: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniArray<z.ZodMiniString<string>>>>;
-      }, z.z.core.$strip>>;
-    }, z.z.core.$strip>>>;
-    colors: z.ZodMiniOptional<z.ZodMiniObject<{
-      palette: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniObject<{
-        seed: z.ZodMiniString<string>;
-        anchors: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-      }, z.z.core.$strip>, z.ZodMiniObject<{
-        tones: z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniString<string>>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>;
-      }, z.z.core.$strip>]>>>;
-      roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-      utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-        bg: "bg";
-        text: "text";
-        border: "border";
-        outline: "outline";
-        fill: "fill";
-        stroke: "stroke";
-      }>>>;
-    }, z.z.core.$strip>>;
-    displayName: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>>;
-    extends: z.ZodMiniOptional<z.ZodMiniString<string>>;
-  }, z.z.core.$strip>>;
-  defaultTheme: z.ZodMiniOptional<z.ZodMiniString<string>>;
-  defaultColorScheme: z.ZodMiniOptional<z.ZodMiniEnum<{
-    light: "light";
-    dark: "dark";
-  }>>;
-  respectSystemPreference: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-  fonts: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
-    name: z.ZodMiniString<string>;
-    provider: z.ZodMiniEnum<{
-      google: "google";
-      fontsource: "fontsource";
-      adobe: "adobe";
-      bunny: "bunny";
-      fontshare: "fontshare";
-      googleicons: "googleicons";
-      npm: "npm";
-      local: "local";
-    }>;
-    cssVariable: z.ZodMiniString<string>;
-    weights: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniUnion<readonly [z.ZodMiniNumber<number>, z.ZodMiniString<string>]>>>;
-    styles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-      normal: "normal";
-      italic: "italic";
-    }>>>;
-    subsets: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-    fallbacks: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-    optimizedFallbacks: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-    display: z.ZodMiniOptional<z.ZodMiniEnum<{
-      optional: "optional";
-      auto: "auto";
-      block: "block";
-      swap: "swap";
-      fallback: "fallback";
-    }>>;
-    formats: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  designSystem: z.ZodMiniObject<{
+    themes: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+      $schema: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
+      meta: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      }, z.z.core.$strict>>>;
+      shadows: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
+      fonts: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
+      typeScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+        base: z.ZodMiniString<string>;
+        ratio: z.ZodMiniNumber<number>;
+        steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        fluid: z.ZodMiniOptional<z.ZodMiniObject<{
+          minVw: z.ZodMiniString<string>;
+          maxVw: z.ZodMiniString<string>;
+          minRatio: z.ZodMiniNumber<number>;
+        }, z.z.core.$strict>>;
+      }, z.z.core.$strict>>>;
+      spaceScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+        base: z.ZodMiniString<string>;
+        ratio: z.ZodMiniNumber<number>;
+        steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+        baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        fluid: z.ZodMiniOptional<z.ZodMiniObject<{
+          minVw: z.ZodMiniString<string>;
+          maxVw: z.ZodMiniString<string>;
+          minRatio: z.ZodMiniNumber<number>;
+        }, z.z.core.$strict>>;
+      }, z.z.core.$strict>>>;
+      patterns: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+        defaults: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+        radii: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+        groups: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
+        z: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniNumber<number>>>;
+        items: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+          group: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          overrides: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+          element: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          class: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          fill: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+          default_role: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+          states: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>>;
+          roles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+        }, z.z.core.$strict>>>;
+      }, z.z.core.$strict>>>;
+      typography: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+        families: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+        roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
+        headings: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+      }, z.z.core.$strict>>>;
+      animations: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+        effects: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+          kf: z.ZodMiniString<string>;
+          css: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
+          vars: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
+        }, z.z.core.$strict>>>;
+        journeys: z.ZodMiniOptional<z.ZodMiniObject<{
+          base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
+          compose: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniArray<z.ZodMiniString<string>>>>;
+        }, z.z.core.$strict>>;
+      }, z.z.core.$strict>>>;
+      colors: z.ZodMiniOptional<z.ZodMiniObject<{
+        palette: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+          seed: z.ZodMiniString<string>;
+          anchors: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+        }, z.z.core.$strict>, z.ZodMiniObject<{
+          tones: z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniString<string>>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>;
+        }, z.z.core.$strict>]>>>;
+        roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
+          hue: z.ZodMiniString<string>;
+          kind: z.ZodMiniOptional<z.ZodMiniEnum<{
+            surface: "surface";
+            chromatic: "chromatic";
+          }>>;
+        }, z.z.core.$strict>]>>>;
+        utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
+          bg: "bg";
+          text: "text";
+          icon: "icon";
+          border: "border";
+          outline: "outline";
+          fill: "fill";
+          stroke: "stroke";
+        }>>>;
+      }, z.z.core.$strict>>;
+      displayName: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>>;
+      extends: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    }, z.z.core.$strict>>;
+    defaultTheme: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    defaultColorScheme: z.ZodMiniOptional<z.ZodMiniEnum<{
+      light: "light";
+      dark: "dark";
+      system: "system";
+    }>>;
+  }, z.z.core.$strict>;
+  fonts: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+    name: z.ZodMiniString<string>;
+    provider: z.ZodMiniEnum<{
+      google: "google";
+      fontsource: "fontsource";
+      adobe: "adobe";
+      bunny: "bunny";
+      fontshare: "fontshare";
+      googleicons: "googleicons";
+      npm: "npm";
+      local: "local";
+    }>;
+    cssVariable: z.ZodMiniString<string>;
+    weights: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniUnion<readonly [z.ZodMiniNumber<number>, z.ZodMiniString<string>]>>>;
+    styles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
+      normal: "normal";
+      italic: "italic";
+    }>>>;
+    subsets: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    fallbacks: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    optimizedFallbacks: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+    display: z.ZodMiniOptional<z.ZodMiniEnum<{
+      optional: "optional";
+      auto: "auto";
+      block: "block";
+      swap: "swap";
+      fallback: "fallback";
+    }>>;
+    formats: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     unicodeRange: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     variants: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
       src: z.ZodMiniArray<z.ZodMiniString<string>>;
@@ -816,6 +801,12 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
     googleAnalyticsId: z.ZodMiniOptional<z.ZodMiniString<string>>;
     plausibleDomain: z.ZodMiniOptional<z.ZodMiniString<string>>;
     googleTagManagerId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    clarityId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    matomo: z.ZodMiniOptional<z.ZodMiniObject<{
+      url: z.ZodMiniString<string>;
+      siteId: z.ZodMiniString<string>;
+      cookies: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+    }, z.z.core.$strip>>;
   }, z.z.core.$strip>>;
   notifications: z.ZodMiniOptional<z.ZodMiniObject<{
     email: z.ZodMiniOptional<z.ZodMiniEmail>;
@@ -830,15 +821,38 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
     }, z.z.core.$strip>>;
   }, z.z.core.$strip>>;
   legal: z.ZodMiniOptional<z.ZodMiniObject<{
+    jurisdiction: z.ZodMiniOptional<z.ZodMiniEnum<{
+      ca: "ca";
+    }>>;
     privacyPolicy: z.ZodMiniOptional<z.ZodMiniObject<{
       enabled: z.ZodMiniBoolean<boolean>;
       url: z.ZodMiniOptional<z.ZodMiniURL>;
       lastUpdated: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      privacyOfficer: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
+        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        email: z.ZodMiniOptional<z.ZodMiniEmail>;
+        phone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        address: z.ZodMiniOptional<z.ZodMiniObject<{
+          streetAddress: z.ZodMiniString<string>;
+          addressLocality: z.ZodMiniString<string>;
+          addressRegion: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          addressCountry: z.ZodMiniString<string>;
+        }, z.z.core.$strip>>;
+      }, z.z.core.$strip>]>>;
+      retention: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      processors: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+        purpose: z.ZodMiniString<string>;
+        country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        privacyUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+      }, z.z.core.$strip>>>;
     }, z.z.core.$strip>>;
     termsOfService: z.ZodMiniOptional<z.ZodMiniObject<{
       enabled: z.ZodMiniBoolean<boolean>;
       url: z.ZodMiniOptional<z.ZodMiniURL>;
       lastUpdated: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+      governingLaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
     }, z.z.core.$strip>>;
     cookieConsent: z.ZodMiniOptional<z.ZodMiniObject<{
       enabled: z.ZodMiniBoolean<boolean>;
@@ -857,6 +871,8 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
   icons: z.ZodMiniOptional<z.ZodMiniObject<{
     ui: z.ZodMiniOptional<z.ZodMiniString<string>>;
     brand: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    weight: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    sprite: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
     semantic: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     'fa7-solid': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     'fa7-regular': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
@@ -866,7 +882,8 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
     'simple-icons': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     'material-symbols': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
     lucide: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-  }, z.z.core.$strip>>;
+    ph: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+  }, z.z.core.$loose>>;
   favicon: z.ZodMiniOptional<z.ZodMiniObject<{
     source: z.ZodMiniString<string>;
     lowResSource: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -883,6 +900,8 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
   }, z.z.core.$strip>>;
 }, z.z.core.$strip>;
 type SiteConfig = z.infer<typeof SiteConfigSchema>;
+/** One `fonts[]` entry — a serialisable projection of an Astro Fonts API family. */
+type SiteFont = z.infer<typeof SiteFontSchema>;
 declare const SITE_SCHEMA_URL = "https://unpkg.com/@getvitops/generator/site.schema.json";
 /** The published JSON Schema (draft-2020-12), derived from the zod schema. */
 declare const siteJsonSchema: {
@@ -1053,95 +1072,108 @@ declare const siteJsonSchema: {
         overrides: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>;
       }, z.z.core.$strip>>>;
     }, z.z.core.$strip>>;
-    designSystem: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
-      $schema: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
-      shadows: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
-      fonts: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
-      typeScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-        base: z.ZodMiniString<string>;
-        ratio: z.ZodMiniNumber<number>;
-        steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-        names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-        baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-        baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        fluid: z.ZodMiniOptional<z.ZodMiniObject<{
-          minVw: z.ZodMiniString<string>;
-          maxVw: z.ZodMiniString<string>;
-          minRatio: z.ZodMiniNumber<number>;
-        }, z.z.core.$strip>>;
-      }, z.z.core.$strip>>>;
-      spaceScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-        base: z.ZodMiniString<string>;
-        ratio: z.ZodMiniNumber<number>;
-        steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-        names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-        baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
-        baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        fluid: z.ZodMiniOptional<z.ZodMiniObject<{
-          minVw: z.ZodMiniString<string>;
-          maxVw: z.ZodMiniString<string>;
-          minRatio: z.ZodMiniNumber<number>;
-        }, z.z.core.$strip>>;
-      }, z.z.core.$strip>>>;
-      patterns: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-        defaults: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-        radii: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-        groups: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
-        z: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniNumber<number>>>;
-        items: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
-          group: z.ZodMiniOptional<z.ZodMiniString<string>>;
-          overrides: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-          element: z.ZodMiniOptional<z.ZodMiniString<string>>;
-          class: z.ZodMiniOptional<z.ZodMiniString<string>>;
-          fill: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
-          default_role: z.ZodMiniOptional<z.ZodMiniString<string>>;
-          base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-          states: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>>;
-          roles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-        }, z.z.core.$strip>>>;
-      }, z.z.core.$strip>>>;
-      typography: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-        families: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-        roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
-        headings: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-      }, z.z.core.$strip>>>;
-      animations: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-        effects: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
-          kf: z.ZodMiniString<string>;
-          css: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
-          vars: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
-        }, z.z.core.$strip>>>;
-        journeys: z.ZodMiniOptional<z.ZodMiniObject<{
-          base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
-          compose: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniArray<z.ZodMiniString<string>>>>;
-        }, z.z.core.$strip>>;
-      }, z.z.core.$strip>>>;
-      colors: z.ZodMiniOptional<z.ZodMiniObject<{
-        palette: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniObject<{
-          seed: z.ZodMiniString<string>;
-          anchors: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-        }, z.z.core.$strip>, z.ZodMiniObject<{
-          tones: z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniString<string>>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>;
-        }, z.z.core.$strip>]>>>;
-        roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
-        utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-          bg: "bg";
-          text: "text";
-          border: "border";
-          outline: "outline";
-          fill: "fill";
-          stroke: "stroke";
-        }>>>;
-      }, z.z.core.$strip>>;
-      displayName: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>>;
-      extends: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    }, z.z.core.$strip>>;
-    defaultTheme: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    defaultColorScheme: z.ZodMiniOptional<z.ZodMiniEnum<{
-      light: "light";
-      dark: "dark";
-    }>>;
-    respectSystemPreference: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+    designSystem: z.ZodMiniObject<{
+      themes: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+        $schema: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniString<string>>>;
+        meta: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+          name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        }, z.z.core.$strict>>>;
+        shadows: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
+        fonts: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
+        typeScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+          base: z.ZodMiniString<string>;
+          ratio: z.ZodMiniNumber<number>;
+          steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+          names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+          baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+          baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          fluid: z.ZodMiniOptional<z.ZodMiniObject<{
+            minVw: z.ZodMiniString<string>;
+            maxVw: z.ZodMiniString<string>;
+            minRatio: z.ZodMiniNumber<number>;
+          }, z.z.core.$strict>>;
+        }, z.z.core.$strict>>>;
+        spaceScale: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+          base: z.ZodMiniString<string>;
+          ratio: z.ZodMiniNumber<number>;
+          steps: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+          names: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+          baseStep: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
+          baseline: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          fluid: z.ZodMiniOptional<z.ZodMiniObject<{
+            minVw: z.ZodMiniString<string>;
+            maxVw: z.ZodMiniString<string>;
+            minRatio: z.ZodMiniNumber<number>;
+          }, z.z.core.$strict>>;
+        }, z.z.core.$strict>>>;
+        patterns: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+          defaults: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+          radii: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+          groups: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>>;
+          z: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniNumber<number>>>;
+          items: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+            group: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            overrides: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+            element: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            class: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            fill: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+            default_role: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+            states: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnknown>>>;
+            roles: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+          }, z.z.core.$strict>>>;
+        }, z.z.core.$strict>>>;
+        typography: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+          families: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+          roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
+          headings: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+        }, z.z.core.$strict>>>;
+        animations: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
+          effects: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+            kf: z.ZodMiniString<string>;
+            css: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
+            vars: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>;
+          }, z.z.core.$strict>>>;
+          journeys: z.ZodMiniOptional<z.ZodMiniObject<{
+            base: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniNumber<number>]>>>>;
+            compose: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniArray<z.ZodMiniString<string>>>>;
+          }, z.z.core.$strict>>;
+        }, z.z.core.$strict>>>;
+        colors: z.ZodMiniOptional<z.ZodMiniObject<{
+          palette: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+            seed: z.ZodMiniString<string>;
+            anchors: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>>;
+          }, z.z.core.$strict>, z.ZodMiniObject<{
+            tones: z.ZodMiniUnion<readonly [z.ZodMiniArray<z.ZodMiniString<string>>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>;
+          }, z.z.core.$strict>]>>>;
+          roles: z.ZodMiniOptional<z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
+            hue: z.ZodMiniString<string>;
+            kind: z.ZodMiniOptional<z.ZodMiniEnum<{
+              surface: "surface";
+              chromatic: "chromatic";
+            }>>;
+          }, z.z.core.$strict>]>>>;
+          utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
+            bg: "bg";
+            text: "text";
+            icon: "icon";
+            border: "border";
+            outline: "outline";
+            fill: "fill";
+            stroke: "stroke";
+          }>>>;
+        }, z.z.core.$strict>>;
+        displayName: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniString<string>>]>>;
+        extends: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      }, z.z.core.$strict>>;
+      defaultTheme: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      defaultColorScheme: z.ZodMiniOptional<z.ZodMiniEnum<{
+        light: "light";
+        dark: "dark";
+        system: "system";
+      }>>;
+    }, z.z.core.$strict>;
     fonts: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
       name: z.ZodMiniString<string>;
       provider: z.ZodMiniEnum<{
@@ -1312,6 +1344,12 @@ declare const siteJsonSchema: {
       googleAnalyticsId: z.ZodMiniOptional<z.ZodMiniString<string>>;
       plausibleDomain: z.ZodMiniOptional<z.ZodMiniString<string>>;
       googleTagManagerId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      clarityId: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      matomo: z.ZodMiniOptional<z.ZodMiniObject<{
+        url: z.ZodMiniString<string>;
+        siteId: z.ZodMiniString<string>;
+        cookies: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+      }, z.z.core.$strip>>;
     }, z.z.core.$strip>>;
     notifications: z.ZodMiniOptional<z.ZodMiniObject<{
       email: z.ZodMiniOptional<z.ZodMiniEmail>;
@@ -1326,15 +1364,38 @@ declare const siteJsonSchema: {
       }, z.z.core.$strip>>;
     }, z.z.core.$strip>>;
     legal: z.ZodMiniOptional<z.ZodMiniObject<{
+      jurisdiction: z.ZodMiniOptional<z.ZodMiniEnum<{
+        ca: "ca";
+      }>>;
       privacyPolicy: z.ZodMiniOptional<z.ZodMiniObject<{
         enabled: z.ZodMiniBoolean<boolean>;
         url: z.ZodMiniOptional<z.ZodMiniURL>;
         lastUpdated: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        privacyOfficer: z.ZodMiniOptional<z.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
+          name: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          email: z.ZodMiniOptional<z.ZodMiniEmail>;
+          phone: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          address: z.ZodMiniOptional<z.ZodMiniObject<{
+            streetAddress: z.ZodMiniString<string>;
+            addressLocality: z.ZodMiniString<string>;
+            addressRegion: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            postalCode: z.ZodMiniOptional<z.ZodMiniString<string>>;
+            addressCountry: z.ZodMiniString<string>;
+          }, z.z.core.$strip>>;
+        }, z.z.core.$strip>]>>;
+        retention: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        processors: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniObject<{
+          name: z.ZodMiniString<string>;
+          purpose: z.ZodMiniString<string>;
+          country: z.ZodMiniOptional<z.ZodMiniString<string>>;
+          privacyUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+        }, z.z.core.$strip>>>;
       }, z.z.core.$strip>>;
       termsOfService: z.ZodMiniOptional<z.ZodMiniObject<{
         enabled: z.ZodMiniBoolean<boolean>;
         url: z.ZodMiniOptional<z.ZodMiniURL>;
         lastUpdated: z.ZodMiniOptional<z.ZodMiniNullable<z.ZodMiniString<string>>>;
+        governingLaw: z.ZodMiniOptional<z.ZodMiniString<string>>;
       }, z.z.core.$strip>>;
       cookieConsent: z.ZodMiniOptional<z.ZodMiniObject<{
         enabled: z.ZodMiniBoolean<boolean>;
@@ -1353,6 +1414,8 @@ declare const siteJsonSchema: {
     icons: z.ZodMiniOptional<z.ZodMiniObject<{
       ui: z.ZodMiniOptional<z.ZodMiniString<string>>;
       brand: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      weight: z.ZodMiniOptional<z.ZodMiniString<string>>;
+      sprite: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
       semantic: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
       'fa7-solid': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
       'fa7-regular': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
@@ -1362,7 +1425,8 @@ declare const siteJsonSchema: {
       'simple-icons': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
       'material-symbols': z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
       lucide: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
-    }, z.z.core.$strip>>;
+      ph: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniString<string>>>;
+    }, z.z.core.$loose>>;
     favicon: z.ZodMiniOptional<z.ZodMiniObject<{
       source: z.ZodMiniString<string>;
       lowResSource: z.ZodMiniOptional<z.ZodMiniString<string>>;
@@ -1455,6 +1519,15 @@ type SiteValidationResult = {
  * These live only here — the published JSON Schema enforces shape, not integrity.
  */
 declare function validateSite(input: unknown): SiteValidationResult;
+/**
+ * Resolve who privacy requests go to: the explicit privacy officer, else the
+ * site contact, else the primary location, else the organization itself.
+ *
+ * Exported because `validateSite` and the legal-document derivation must agree
+ * on it exactly — a config that validates must be one the policy can render, and
+ * two copies of this precedence would drift into a policy with a blank address.
+ */
+declare function resolvePrivacyContact(cfg: SiteConfig): ContactObject | undefined;
 type DesignSystemEntryT = Partial<DesignSystem> & {
   displayName?: unknown;
   extends?: string;
@@ -1469,17 +1542,786 @@ declare function resolveTheme(designSystem: Record<string, DesignSystemEntryT>,
 /**
  * Resolve a raw (already-parsed) config into a validated `SiteConfig`:
  *  1. strip YAML nulls,
- *  2. apply the active A/B variant's `overrides` (by `siteEnv`),
- *  3. normalise a bare-`DesignSystem` `designSystem` shorthand to `{ default: … }`,
+ *  2. normalise the `designSystem` shorthands to `{ themes: … }`,
+ *  3. apply the active A/B variant's `overrides` (by `siteEnv`),
  *  4. validate (shape + cross-field).
  * Pure — no YAML/env access. A loader supplies `siteEnv`.
+ *
+ * Steps 2 and 3 are in this order deliberately. Normalising first means an
+ * `abTesting` override always addresses the canonical shape
+ * (`designSystem.themes.<name>`), whatever shorthand the base config used. With
+ * the merge first, an override's key path depended on how the base happened to be
+ * written — so the same patch hit a different place in two configs that were
+ * otherwise equivalent.
  */
 declare function resolveSiteConfig(input: unknown, siteEnv?: string): SiteConfig;
+/**
+ * Is this raw config a `SiteConfig` rather than a bare `design-system.json`?
+ *
+ * The discriminator is **total**, not a heuristic, and both halves are load-
+ * bearing: `SiteConfigSchema` cannot validate without a `designSystem` (a config
+ * lacking one fails `validateSite` with `themes must include a "default" entry`),
+ * and `DesignSystemSchema` is strict, so a `designSystem` key in a design system
+ * is an `unrecognized_keys` error. No document can be read as both, and no
+ * document that is neither reaches here without failing validation anyway.
+ *
+ * Deliberately shape-based rather than filename-based: consumers name this file
+ * whatever suits them (`company.json`, `site.json`, `vitops.config.json`), and a
+ * rule keyed to a name would silently stop working the moment someone renamed it.
+ */
+declare function isSiteConfig(raw: unknown): boolean;
+/** What a config file turned out to hold. */
+interface ResolvedInput {
+  /** The design system to build from — a resolved theme, if the input was a `SiteConfig`. */
+  designSystem: DesignSystem;
+  /** The site config, when that is what the input was. */
+  site?: SiteConfig;
+  /** Which `themes` key was selected. Absent for a bare `design-system.json`. */
+  theme?: string;
+}
+/**
+ * Resolve a raw config of either kind into the design system to build from.
+ *
+ * Every entry point that used to take a `design-system.json` goes through this,
+ * so a consumer who keeps their tokens inside the larger site config points the
+ * same option at that file instead of maintaining a second one. The site config
+ * is handed back too, because the parts of generation that depend on site-level
+ * facts (`designSystem.defaultColorScheme`, the legal documents, the icon
+ * sprite) would otherwise need the same path declared a second time.
+ *
+ * The returned `designSystem` is **not** validated here — the caller does that,
+ * so it can say which file and which theme the errors belong to. Validation of
+ * the site config itself has already happened (`resolveSiteConfig` throws).
+ */
+declare function resolveInput(raw: unknown, opts?: {
+  theme?: string;
+  siteEnv?: string;
+}): ResolvedInput;
 /** Strip nulls (YAML `~`/`null`) → undefined so optional fields validate. */
 declare function stripNulls(obj: unknown): unknown;
 /** Deep-merge `source` into `target` (in place). Arrays replace wholesale. */
 declare function deepMerge(target: Record<string, unknown>, source: Record<string, unknown>): void;
 //#endregion
+//#region src/tokens.d.ts
+declare const NUMERIC_STEPS: readonly ["50", "100", "200", "300", "400", "500", "600", "700", "800", "900", "950"];
+type NumStep = (typeof NUMERIC_STEPS)[number];
+interface ExpandedHue {
+  /** Numeric steps (sparse for fixed-tone kits). */
+  numeric: Partial<Record<NumStep, string>>;
+  /** True when only authored tones + endpoints exist (no interpolation). */
+  sparse?: boolean;
+  /**
+   * Steps the author pinned, and how far each sits from the ladder's lightness.
+   * A pinned colour is reproduced exactly, so a large value here is legal — but
+   * it means this hue reads heavier or lighter than its siblings at that step,
+   * which the generator surfaces as a warning.
+   */
+  deviations?: Partial<Record<NumStep, number>>;
+}
+/** Expand every palette hue into its numeric scale. */
+declare function expandPalette(raw: Record<string, unknown>): Record<string, ExpandedHue>;
+/** Which shape of token set a role gets. */
+type RoleKind = 'surface' | 'chromatic';
+/**
+ * Map a token key to its CSS custom property for a given role.
+ *
+ * `on` is the one irregular case: the foreground for a filled surface reads
+ * `--color-text-on-<role>`, with the role *after* `on`, because it names what it
+ * sits on rather than what it is.
+ *
+ * The utility class name is this minus the `--color-` prefix, which is why the
+ * emitter and the linter can both derive their vocabulary from one function.
+ */
+declare function tokenVar(role: string, key: string): string;
+/** The class name a token key produces for a role (`bg-danger-solid`, …). */
+declare const tokenClass: (role: string, key: string) => string;
+interface FunctionalRole {
+  role: string;
+  hue: string;
+  kind: RoleKind;
+  /** token key → CSS value, per appearance. */
+  light: Record<string, string>;
+  dark: Record<string, string>;
+}
+/** Resolve the token set for one role over its hue. */
+declare function functionalRole(role: string, hueName: string, hue: ExpandedHue, kind?: RoleKind): FunctionalRole;
+/**
+ * APCA targets. `TEXT` is the body-text bar; `SECONDARY` covers text on a
+ * non-primary surface and de-emphasised text. `NON_TEXT` is the icon/boundary
+ * tier — the APCA analogue of WCAG's 3:1, where a glyph may run more vivid than
+ * text because shape carries meaning alongside contrast.
+ */
+declare const CONTRAST: {
+  readonly TEXT: 75;
+  readonly SECONDARY: 60;
+  readonly NON_TEXT: 45;
+};
+//#endregion
+//#region src/generate.d.ts
+type Format = 'bricks' | 'css' | 'tailwind' | 'design';
+/**
+ * Formats that emit a stylesheet. `design` is the odd one out — it emits a
+ * single `DESIGN.md` brief and no CSS at all — so anything that expects to
+ * import the generator's output (the Vite plugin's injected stylesheet, the
+ * Astro integration) types against this narrower set.
+ */
+type StylesheetFormat = Exclude<Format, 'design'>;
+interface GenerateOptions {
+  /**
+   * The config to build from — a path, or an already-parsed object.
+   *
+   * **Either kind is accepted.** A bare `design-system.json`, or the larger
+   * `SiteConfig` that embeds one (commonly `company.json` / `site.json`), in
+   * which case the design system is `designSystem.themes[theme]` with its
+   * `extends` chain resolved. The two are told apart by shape, not by filename —
+   * see `isSiteConfig`.
+   *
+   * Passing a site config here also supplies `site`, so the site-level facts
+   * generation depends on (`designSystem.defaultColorScheme`, the legal
+   * documents, the icon sprite) don't need the same path declared twice. Each of
+   * those is still gated on a field in that config, so nothing new appears
+   * unless the config asks for it.
+   */
+  input: string | DesignSystem | SiteConfig;
+  /** Output target. Default: 'bricks'. */
+  format?: Format;
+  /** Directory to write outputs into. Default: 'dist'. */
+  outDir?: string;
+  /** Override the framework asset root (advanced/testing). */
+  assetsDir?: string;
+  /**
+   * Which `designSystem.themes` entry to build. Default: the config's
+   * `defaultTheme`, else `default`. An error on a bare `design-system.json`,
+   * which holds one design system and no themes map.
+   */
+  theme?: string;
+  /**
+   * Environment whose A/B variant applies to the site config, wherever it came
+   * from (`input` or `site`). Default: `'production'`.
+   */
+  siteEnv?: string;
+  /**
+   * The site config, when it is a *different* file from `input` — enabling
+   * legal-document output into `<outDir>/legal/*.html` and supplying
+   * `designSystem.defaultColorScheme`.
+   *
+   * Redundant when `input` is already a site config; set both and this one wins.
+   */
+  site?: string | SiteConfig;
+  /**
+   * Emit the `prefers-color-scheme: dark` block (see `BuildOptions`).
+   *
+   * Normally this comes from the site config's `designSystem.defaultColorScheme: "system"`, which
+   * is where the fact belongs. This is the escape hatch for consumers with a
+   * `design-system.json` and no site config at all: requiring a whole
+   * `SiteConfig` — which must carry a full `designSystem` — to set one boolean
+   * would be out of proportion. Set explicitly, it wins over the site config.
+   */
+  systemColorScheme?: boolean;
+}
+interface GenerateResult {
+  format: Format;
+  outDir: string;
+  written: string[];
+}
+interface ColorUtility {
+  /** Class name, without the leading dot. */
+  cls: string;
+  /** CSS property the class sets. */
+  prop: string;
+  /** `var(--…)` reference the class resolves to. */
+  value: string;
+}
+/**
+ * Every role colour utility, each class name emitted EXACTLY once.
+ *
+ * There is now a single axis. The target lives *inside* the token name, so
+ * `bg-danger-muted` and `text-danger-muted` are different tokens and the
+ * collision the old plane/stop precedence rule existed to arbitrate cannot
+ * arise. Both the css/bricks and tailwind paths render from this one list, which
+ * is what keeps the three formats in step; `format-parity.test.ts` holds them
+ * there.
+ *
+ * The class name IS the token name minus `--color-`, so there is no separate
+ * naming rule to drift — see `tokenClass` in tokens.ts.
+ */
+declare function roleColorUtilities(roles: readonly FunctionalRole[], utilities: readonly string[]): ColorUtility[];
+declare function generate(options: GenerateOptions): Promise<GenerateResult>;
+//#endregion
+//#region src/docs.d.ts
+/**
+ * Build the OKF docs bundle for a config. Returns a `{ relPath: content }` map;
+ * the caller writes it wherever the bundle should live (e.g. `<outDir>/docs`).
+ */
+declare function generateDocs(ds: DesignSystem, assetsDir: string): Record<string, string>;
+//#endregion
+//#region ../../node_modules/.pnpm/@iconify+types@2.0.0/node_modules/@iconify/types/types.d.ts
+/**
+ * Icon dimensions.
+ *
+ * Used in:
+ *  icon (as is)
+ *  alias (overwrite icon's properties)
+ *  root of JSON file (default values)
+ */
+interface IconifyDimenisons {
+  // Left position of viewBox.
+  // Defaults to 0.
+  left?: number; // Top position of viewBox.
+  // Defaults to 0.
+  top?: number; // Width of viewBox.
+  // Defaults to 16.
+  width?: number; // Height of viewBox.
+  // Defaults to 16.
+  height?: number;
+}
+/**
+ * Icon transformations.
+ *
+ * Used in:
+ *  icon (as is)
+ *  alias (merged with icon's properties)
+ */
+interface IconifyTransformations {
+  // Number of 90 degrees rotations.
+  // 0 = 0, 1 = 90deg and so on.
+  // Defaults to 0.
+  // When merged (such as alias + icon), result is icon.rotation + alias.rotation.
+  rotate?: number; // Horizontal flip.
+  // Defaults to false.
+  // When merged, result is icon.hFlip !== alias.hFlip
+  hFlip?: boolean; // Vertical flip. (see hFlip comments)
+  vFlip?: boolean;
+}
+/**
+ * Combination of dimensions and transformations.
+ */
+interface IconifyOptional extends IconifyDimenisons, IconifyTransformations { //
+}
+/**
+ * Alias.
+ */
+interface IconifyAlias extends IconifyOptional {
+  // Parent icon index without prefix, required.
+  parent: string; // IconifyOptional properties.
+  // Alias should have only properties that it overrides.
+  // Transformations are merged, not overridden. See IconifyTransformations comments.
+}
+/**
+ * Icon.
+ */
+interface IconifyIcon extends IconifyOptional {
+  // Icon body: <path d="..." />, required.
+  body: string; // IconifyOptional properties.
+  // If property is missing in JSON file, look in root object for default value.
+}
+/**
+ * Icon with optional parameters that are provided by API and affect only search
+ */
+interface APIIconAttributes {
+  // True if icon is hidden.
+  // Used in icon sets to keep icons that no longer exist, but should still be accessible
+  // from API, preventing websites from breaking when icon is removed by developer.
+  hidden?: boolean;
+}
+interface ExtendedIconifyIcon extends IconifyIcon, APIIconAttributes {}
+interface ExtendedIconifyAlias extends IconifyAlias, APIIconAttributes {}
+/**
+ * "icons" field of JSON file.
+ */
+interface IconifyIcons {
+  // Index is name of icon, without prefix. Value is ExtendedIconifyIcon object.
+  [index: string]: ExtendedIconifyIcon;
+}
+/**
+ * "aliases" field of JSON file.
+ */
+interface IconifyAliases {
+  // Index is name of icon, without prefix. Value is ExtendedIconifyAlias object.
+  [index: string]: ExtendedIconifyAlias;
+}
+/**
+ * Icon set information block.
+ */
+interface IconifyInfo {
+  // Icon set name.
+  name: string; // Total number of icons.
+  total?: number; // Version string.
+  version?: string; // Author information.
+  author: {
+    // Author name.
+    name: string; // Link to author's website or icon set website.
+    url?: string;
+  }; // License
+  license: {
+    // Human readable license.
+    title: string; // SPDX license identifier.
+    spdx?: string; // License URL.
+    url?: string;
+  }; // Array of icons that should be used for samples in icon sets list.
+  samples?: string[]; // Icon grid: number or array of numbers.
+  height?: number | number[]; // Display height for samples: 16 - 24
+  displayHeight?: number; // Category on Iconify collections list.
+  category?: string; // List of tags to group similar icon sets.
+  tags?: string[]; // Palette status. True if icons have predefined color scheme, false if icons use currentColor.
+  // Ideally, icon set should not mix icons with and without palette to simplify search.
+  palette?: boolean; // If true, icon set should not appear in icon sets list.
+  hidden?: boolean;
+}
+/**
+ * Optional themes, old format.
+ *
+ * Deprecated because format is unnecessary complicated. Key is meaningless, suffixes and prefixes are mixed together.
+ */
+interface LegacyIconifyThemes {
+  // Key is unique string.
+  [index: string]: {
+    // Theme title.
+    title: string; // Icon prefix or suffix, including dash. All icons that start with prefix and end with suffix belong to theme.
+    prefix?: string; // Example: 'baseline-'
+    suffix?: string; // Example: '-filled'
+  };
+}
+/**
+ * Characters used in font.
+ */
+interface IconifyChars {
+  // Index is character, such as "f000".
+  // Value is icon name.
+  [index: string]: string;
+}
+/**
+ * Icon categories
+ */
+interface IconifyCategories {
+  // Index is category title, such as "Weather".
+  // Value is array of icons that belong to that category.
+  // Each icon can belong to multiple categories or no categories.
+  [index: string]: string[];
+}
+/**
+ * Meta data stored in JSON file, used for browsing icon set.
+ */
+interface IconifyMetaData {
+  // Icon set information block. Used for public icon sets, can be skipped for private icon sets.
+  info?: IconifyInfo; // Characters used in font. Used for searching by character for icon sets imported from font, exporting icon set to font.
+  chars?: IconifyChars; // Categories. Used for filtering icons.
+  categories?: IconifyCategories; // Optional themes (old format).
+  themes?: LegacyIconifyThemes; // Optional themes (new format). Key is prefix or suffix, value is title.
+  prefixes?: Record<string, string>;
+  suffixes?: Record<string, string>;
+}
+/**
+ * JSON structure, contains only icon data
+ */
+interface IconifyJSONIconsData extends IconifyDimenisons {
+  // Prefix for icons in JSON file, required.
+  prefix: string; // API provider, optional.
+  provider?: string; // List of icons, required.
+  icons: IconifyIcons; // Optional aliases.
+  aliases?: IconifyAliases; // IconifyDimenisons properties that are used as default viewbox for icons when icon is missing value.
+  // If viewbox exists in both icon and root, use value from icon.
+  // This is used to reduce duplication.
+}
+/**
+ * JSON structure.
+ *
+ * All optional values can exist in root of JSON file, used as defaults.
+ */
+interface IconifyJSON extends IconifyJSONIconsData, IconifyMetaData {
+  // Last modification time of icons. Unix time stamp in seconds.
+  // Time is calculated only for icon data, ignoring metadata.
+  // Used to invalidate icons cache in components.
+  lastModified?: number; // Optional list of missing icons. Returned by Iconify API when querying for icons that do not exist.
+  not_found?: string[];
+}
+//#endregion
+//#region src/icons-sprite.d.ts
+interface IconSpriteOptions {
+  /** Exactly `generateIconInclude()`'s shape: collection → icon names. */
+  include: Record<string, string[]>;
+  /**
+   * Extra ids pointing at an already-included icon, e.g. `{ 'icon-menu': 'ph:list' }`,
+   * so a consumer can reference a semantic name without knowing the set.
+   */
+  aliases?: Record<string, string>;
+  /**
+   * Directory to resolve `@iconify-json/*` from. Defaults to `process.cwd()`.
+   *
+   * Load-bearing: the collections are the CONSUMER's dependency, not this
+   * package's, so a bare `import('@iconify-json/ph/…')` from inside the
+   * generator resolves against the generator's own node_modules and misses them
+   * entirely — which reads as "not installed" on a project that has them.
+   */
+  resolveFrom?: string;
+  /** Injected in tests so the emitter can run without any @iconify-json/* installed. */
+  loadSet?: (prefix: string) => Promise<IconifyJSON | null>;
+}
+interface IconSpriteResult {
+  svg: string;
+  /** Every `<symbol>` id emitted, in order. */
+  ids: string[];
+  /** `prefix:name` entries that were asked for but not found. */
+  missing: string[];
+}
+/**
+ * `ph:caret-down` → `ph--caret-down`.
+ *
+ * The one place this grammar lives. `Icon.astro` mirrors it and `icon.test.ts`
+ * guards the pair, because a drift here resolves `<use>` to nothing and renders
+ * as an empty box rather than an error.
+ */
+declare function spriteId(qualified: string): string;
+declare function buildIconSprite(o: IconSpriteOptions): Promise<IconSpriteResult>;
+/**
+ * One icon's renderable parts, for inlining into markup.
+ *
+ * Exists because `<Icon />` cannot go through astro-icon: its `./components`
+ * entry is a TypeScript file that Vite must transform, so it can only be
+ * reached by a statically-analysable import — and a static import is exactly
+ * what made the optional peer mandatory for anyone rendering Popover, Details
+ * or Drawer. Reading the collection directly sidesteps the peer entirely and
+ * shares this file's loader with the sprite, so both paths draw the same glyph.
+ */
+declare function loadIconSvg(qualified: string, opts?: {
+  resolveFrom?: string;
+  loadSet?: (prefix: string) => Promise<IconifyJSON | null>;
+}): Promise<{
+  viewBox: string;
+  body: string;
+} | null>;
+//#endregion
+//#region src/shared.d.ts
+/**
+ * Data shared between the generator (`generate.ts`) and the docs bundle
+ * (`docs.ts`). Lives in its own module because `generate.ts` imports `docs.ts` —
+ * importing back the other way would be a cycle.
+ */
+/**
+ * Selector the dark functional-token flip hangs off.
+ *
+ * `data-brx-theme` is Bricks' own attribute — Bricks sets it, so it's what the
+ * WordPress target needs. Nothing sets it anywhere else, which meant the dark
+ * flip was unreachable outside Bricks: the shipped `<color-scheme-toggle>` web
+ * component writes `documentElement.dataset.theme` (i.e. `data-theme`), so
+ * clicking "Dark" changed an attribute no rule matched. Matching both makes the
+ * component work on every target without changing what Bricks already does.
+ *
+ * This covers the EXPLICIT choice. The OS preference is a second, opt-in block —
+ * see `SYSTEM_DARK_SEL` — because turning it on flips a site dark for dark-OS
+ * users, which is the site's decision rather than the design system's.
+ *
+ * Shared so the docs quote the selector the generator actually emits.
+ */
+declare const DARK_SEL = ":root[data-brx-theme=\"dark\"], :root[data-theme=\"dark\"]";
+/**
+ * Roles the shipped CSS partials reference with NO fallback, so a config that
+ * omits one leaves those rules resolving to nothing — an invalid declaration,
+ * not a graceful degrade.
+ *
+ * `colors.roles` is an open record: any name works and generates a full token
+ * set, utilities and dark flip. But the framework's own component CSS is
+ * written against these six, so "roles are arbitrary" is only half true — they
+ * are *extensible*, over a required core. `validate()` warns when one is
+ * missing; `required-roles.test.ts` re-derives this list from the partials so
+ * it cannot drift as components are added.
+ *
+ * Kept as a constant rather than scanned at call time because `validate()` is
+ * a pure function — the CLI, the Vite plugin and `toJSONSchema` all import it,
+ * and none of them should touch the filesystem to answer "is this config ok?".
+ */
+declare const REQUIRED_ROLES: readonly string[];
+/**
+ * Every token key a role can resolve to, across both role kinds. Shared so the
+ * required-roles drift test greps for exactly what the generator emits.
+ *
+ * These are *keys*, not var names: the role sits in the middle of the property
+ * (`--color-bg-danger-muted`), so compose them with `tokenVar()` from `tokens.ts`
+ * rather than concatenating by hand.
+ */
+declare const ROLE_TOKEN_KEYS: readonly string[];
+/** How a role is authored in `colors.roles`: a bare hue, or a hue plus its kind. */
+type RoleSpec = string | {
+  hue: string;
+  kind?: 'surface' | 'chromatic' | undefined;
+};
+/** The palette hue a role points at, through either authoring form. */
+declare const roleHue: (spec: RoleSpec) => string;
+/**
+ * A role's kind. The bare-string shorthand means `chromatic`, because signal
+ * colours are the common case and surfaces are the two or three you name once.
+ */
+declare const roleKind: (spec: RoleSpec) => "surface" | "chromatic";
+/**
+ * Pattern base geometry props → per-pattern override-hook shorthand. Each hook
+ * wraps the authored value (`padding: var(--p-btn, 0.4em 0.8em)`) so a
+ * consumer restyles one pattern by setting one variable. The hook is named after
+ * the pattern's key, not its class.
+ */
+declare const BASE_HOOK: Record<string, string>;
+/**
+ * Framework utility classes whose names collide with Tailwind's own defaults.
+ * The `tailwind` format strips any rule targeting these — Tailwind provides
+ * them, so consumers use Tailwind's utilities for these names instead.
+ */
+declare const TW_CLASH: ReadonlySet<string>;
+//#endregion
+//#region src/legal/providers.d.ts
+interface Processor {
+  /** The provider as a reader would recognise it. */
+  name: string;
+  /** Reads after "for": "…to Stripe for payment processing". */
+  purpose: string;
+  /** Reads inside a sentence: "…including the United States". */
+  country?: string | undefined;
+  privacyUrl?: string | undefined;
+  /**
+   * Cookies this provider sets. An empty array is meaningful and not the same as
+   * `undefined`: it asserts the provider is cookieless (Plausible), which the
+   * cookie notice states positively rather than omitting.
+   */
+  cookies?: string[] | undefined;
+  /** A user-facing opt-out, when the provider offers one. */
+  optOut?: string | undefined;
+}
+/**
+ * The providers the config can imply. Keyed for testability — a test can assert
+ * a given config resolves to a given key without matching on prose.
+ */
+declare const KNOWN_PROCESSORS: {
+  googleAnalytics: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: string[];
+    optOut: string;
+  };
+  googleTagManager: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: never[];
+  };
+  plausible: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: never[];
+  };
+  clarity: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: string[];
+    optOut: string;
+  };
+  matomo: {
+    name: string;
+    purpose: string;
+    privacyUrl: string;
+    cookies: string[];
+  };
+  matomoCookieless: {
+    name: string;
+    purpose: string;
+    privacyUrl: string;
+    cookies: never[];
+  };
+  turnstile: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: string[];
+  };
+  cloudflare: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: never[];
+  };
+  vercel: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: never[];
+  };
+  netlify: {
+    name: string;
+    purpose: string;
+    country: string;
+    privacyUrl: string;
+    cookies: never[];
+  };
+};
+type KnownProcessorKey = keyof typeof KNOWN_PROCESSORS;
+/**
+ * Which known providers this config implies, in a stable order (analytics →
+ * security → hosting) so the rendered sentence doesn't churn between builds.
+ *
+ * Returns keys rather than processors so a caller can test the detection
+ * independently of the prose attached to it.
+ */
+declare function detectProcessorKeys(site: SiteConfig): KnownProcessorKey[];
+/**
+ * Every processor this policy must disclose: the ones implied by the config,
+ * then the ones the consumer declared.
+ *
+ * Consumer entries come last and are never deduplicated against the built-ins —
+ * an explicit declaration is a statement of fact we have no grounds to drop.
+ */
+declare function resolveProcessors(site: SiteConfig): Processor[];
+//#endregion
+//#region src/legal/derive.d.ts
+/**
+ * The facts every legal template renders from.
+ *
+ * List-shaped fields are `string[]`, not pre-joined strings, because they land
+ * in bullet positions: a template that splices an empty string into a list emits
+ * a stray `-` bullet, and that is exactly the kind of silent breakage a
+ * published policy must not have.
+ */
+interface PolicyVars {
+  businessName: string;
+  url: string;
+  /** Reads after "at": "…contact our Privacy Officer at <this>." */
+  mailingAddress: string;
+  lastUpdated: string | undefined;
+  /** Extra retention sentence, when the consumer stated one. */
+  retention: string | undefined;
+  /** A consumer-supplied governing-law phrase, which wins over the two below. */
+  governingLaw: string | undefined;
+  /** Province/territory, spelled out — "Ontario", never "ON". */
+  governingProvince: string | undefined;
+  governingCountry: string;
+  /** Circumstances in which personal information is collected. */
+  collectionReasons: string[];
+  /** Categories of personal information collected. */
+  piiCollected: string[];
+  /** What the browser sends automatically. */
+  techInfo: string[];
+  /** Why that technical information is used. */
+  techInfoPurposes: string[];
+  /** What cookies track. */
+  cookieTracked: string[];
+  /** Why cookies are used. */
+  cookiePurposes: string[];
+  /** A sentence about the consent tool, or `undefined` when there is none. */
+  cookieTool: string | undefined;
+  /** How collected information is used. */
+  usePurposes: string[];
+  /** Choices a visitor has. */
+  optOutOptions: string[];
+  /** The subset of `optOutOptions` about cookies — an e-mail unsubscribe link is
+   * not a cookie choice, and listing it in a cookie notice reads as padding. */
+  cookieOptOutOptions: string[];
+  processors: Processor[];
+  /** Reads after "including": "…the United States and the European Union". */
+  countries: string | undefined;
+  consentModel: 'opt-in' | 'opt-out' | 'none';
+  cookieCategories: string[];
+}
+declare function derivePolicyVars(site: SiteConfig): PolicyVars;
+//#endregion
+//#region src/legal/templates/cookies.ca.d.ts
+declare function cookiesCa(v: PolicyVars): string;
+//#endregion
+//#region src/legal/templates/privacy.ca.d.ts
+declare function privacyCa(v: PolicyVars): string;
+//#endregion
+//#region src/legal/templates/terms.ca.d.ts
+declare function termsCa(v: PolicyVars): string;
+//#endregion
+//#region src/legal/templates/index.d.ts
+type LegalDoc = 'privacy' | 'terms' | 'cookies';
+type DocSet = Record<LegalDoc, (v: PolicyVars) => string>;
+declare const TEMPLATES: {
+  ca: {
+    privacy: typeof privacyCa;
+    terms: typeof termsCa;
+    cookies: typeof cookiesCa;
+  };
+};
+/** Stable output order, independent of which docs a given config enables. */
+declare const DOC_ORDER: LegalDoc[];
+/** Output filename stem per document — also the Bricks shortcode's allowlist. */
+declare const DOC_SLUGS: Record<LegalDoc, string>;
+//#endregion
+//#region src/legal/render.d.ts
+interface Span {
+  text: string;
+  strong?: boolean;
+  code?: boolean;
+}
+type Block = {
+  kind: 'heading';
+  level: 1 | 2 | 3;
+  spans: Span[];
+} | {
+  kind: 'paragraph';
+  spans: Span[];
+} | {
+  kind: 'list';
+  items: Span[][];
+} | {
+  kind: 'quote';
+  spans: Span[];
+};
+/** Markdown (our subset) → blocks. Throws on anything it does not model. */
+declare function parseMarkdown(md: string): Block[];
+/**
+ * Blocks → `ContentNode[]`, the framework-agnostic tree the site config already
+ * uses for `templates` of type `nodes` and `NodeRenderer.astro` already renders.
+ */
+declare function toContentNodes(blocks: Block[]): ContentNode[];
+declare function toHtmlFragment(blocks: Block[]): string;
+/**
+ * Blocks → EmDash Portable Text, matching the shape already seeded in
+ * `packages/create/templates/emdash/seed/seed.json`.
+ *
+ * Two deliberate mappings:
+ *  - the `# ` heading is **dropped** — in EmDash the page title is a field
+ *    (`data.title`), and repeating it as the first content block renders twice;
+ *  - the review blockquote becomes a `vitops.banner` with `tone: "warning"`,
+ *    which is exactly the block the hand-written placeholder pages used.
+ *
+ * `_key`s are derived from position rather than randomness, so regenerating an
+ * unchanged config produces an identical seed and a clean diff.
+ */
+declare function toPortableText(blocks: Block[], prefix: string): unknown[];
+//#endregion
+//#region src/legal/index.d.ts
+type LegalOutput = 'md' | 'html' | 'portable-text';
+interface GenerateLegalOptions {
+  /** Which documents to render. Defaults to those enabled in the config. */
+  docs?: LegalDoc[];
+  /** Output format. Default `md`. */
+  output?: LegalOutput;
+}
+/** Which documents the config asks for, in a stable order. */
+declare function enabledDocs(site: SiteConfig): LegalDoc[];
+/** Render one document to markdown. The other outputs derive from this. */
+declare function renderMarkdown(site: SiteConfig, doc: LegalDoc, vars?: PolicyVars): string;
+/**
+ * Render one document as a `ContentNode` tree — the framework-agnostic shape the
+ * site config already uses for `templates` of type `nodes`, so an Astro consumer
+ * can hand it to `NodeRenderer` instead of injecting a string of HTML.
+ */
+declare function renderNodes(site: SiteConfig, doc: LegalDoc): ContentNode[];
+/**
+ * Every enabled legal document, keyed by output path.
+ *
+ * Documents are keyed by filename (`privacy-policy.md`) rather than by document
+ * id so a caller can write the map verbatim.
+ */
+declare function generateLegal(site: SiteConfig, opts?: GenerateLegalOptions): Record<string, string>;
+//#endregion
 //#region src/index.d.ts
 /**
  * A minimal but complete starter design system, used by `vitops init`. It
@@ -1488,5 +2330,5 @@ declare function deepMerge(target: Record<string, unknown>, source: Record<strin
  */
 declare function defaultConfig(): DesignSystem;
 //#endregion
-export { BASE_HOOK, type ColorUtility, DARK_SEL, type DesignSystem, DesignSystemSchema, type ExpandedHue, type Format, type FunctionalRole, type GenerateOptions, type GenerateResult, REQUIRED_ROLES, ROLE_TOKEN_SUFFIXES, SCHEMA_URL, SITE_SCHEMA_URL, type SiteConfig, SiteConfigSchema, type SiteValidationResult, TW_CLASH, type ValidationResult, deepMerge, defaultConfig, expandPalette, functionalRole, generate, generateDocs, jsonSchema, resolveSiteConfig, resolveTheme, roleColorUtilities, siteJsonSchema, stripNulls, validate, validateSite };
+export { BASE_HOOK, type Block, CONTRAST, type ColorUtility, type ContactObject, DARK_SEL, DOC_ORDER, DOC_SLUGS, type DesignSystem, DesignSystemSchema, type DocSet, type ExpandedHue, type Format, type FunctionalRole, type GenerateLegalOptions, type GenerateOptions, type GenerateResult, type IconSpriteOptions, type IconSpriteResult, JURISDICTIONS, type Jurisdiction, KNOWN_PROCESSORS, type KnownProcessorKey, type LegalDoc, type LegalOutput, NUMERIC_STEPS, type PolicyVars, type PostalAddress, type Processor, REQUIRED_ROLES, ROLE_TOKEN_KEYS, type ResolvedInput, type RoleKind, type RoleSpec, SCHEMA_URL, SITE_SCHEMA_URL, type SiteConfig, SiteConfigSchema, type SiteFont, SiteFontSchema, type SiteValidationResult, type Span, type StylesheetFormat, TEMPLATES, TW_CLASH, type ValidationResult, buildIconSprite, deepMerge, defaultConfig, derivePolicyVars, detectProcessorKeys, enabledDocs, expandPalette, functionalRole, generate, generateDocs, generateLegal, isSiteConfig, jsonSchema, loadIconSvg, parseMarkdown, renderMarkdown, renderNodes, resolveInput, resolvePrivacyContact, resolveProcessors, resolveSiteConfig, resolveTheme, roleColorUtilities, roleHue, roleKind, siteJsonSchema, spriteId, stripNulls, toContentNodes, toHtmlFragment, toPortableText, tokenClass, tokenVar, validate, validateSite };
 //# sourceMappingURL=index.d.mts.map