@getvitops/generator 1.0.0 → 2.1.0

package/dist/index.d.mts

@@ -7,31 +7,31 @@ declare const DesignSystemSchema: z.ZodMiniObject<{
   meta: z.ZodMiniOptional<z.ZodMiniObject<{
     name: z.ZodMiniOptional<z.ZodMiniString<string>>;
     description: z.ZodMiniOptional<z.ZodMiniString<string>>;
-  }, z.z.core.$strip>>;
+  }, 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>]>>;
+    }, 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.$strip>]>>;
+    }, z.z.core.$strict>]>>;
     utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-      fill: "fill";
       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<{
@@ -45,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>;
@@ -58,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>>>;
@@ -75,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
@@ -108,31 +108,31 @@ declare const jsonSchema: {
     meta: z.ZodMiniOptional<z.ZodMiniObject<{
       name: z.ZodMiniOptional<z.ZodMiniString<string>>;
       description: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    }, z.z.core.$strip>>;
+    }, 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>]>>;
+      }, 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.$strip>]>>;
+      }, z.z.core.$strict>]>>;
       utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-        fill: "fill";
         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<{
@@ -146,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>;
@@ -159,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>>>;
@@ -176,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;
@@ -299,6 +299,96 @@ declare const ContactObjectSchema: z.ZodMiniObject<{
 }, 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>;
+/**
+ * What `vitops notify` needs to tell search engines a deploy happened.
+ *
+ * Scoped by what search engines actually accept, which is narrower than it looks:
+ * Google exposes **no** "request indexing" API (the Search Console button is not in
+ * its API, and URL Inspection is read-only), and it removed the sitemap ping
+ * endpoint in 2023. So the sanctioned set is: an accurate sitemap, a Search Console
+ * sitemap resubmit, an IndexNow ping — which Google does *not* honour but Bing,
+ * Yandex, Naver, Seznam and Yep do — and a read-only inspection pass to find out
+ * what Google actually did.
+ *
+ * Facts only, the same rule the legal block follows: this records what the site has
+ * (a key, a property, which pages matter), never what to say about it.
+ */
+declare const IndexNowSchema: z.ZodMiniObject<{
+  key: z.ZodMiniString<string>;
+  keyLocation: z.ZodMiniOptional<z.ZodMiniURL>;
+  endpoint: z.ZodMiniOptional<z.ZodMiniURL>;
+}, z.z.core.$strip>;
+declare const SearchConsoleSchema: z.ZodMiniObject<{
+  siteUrl: z.ZodMiniString<string>;
+  resubmitSitemap: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+}, z.z.core.$strip>;
+declare const IndexingSchema: z.ZodMiniObject<{
+  sitemapUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+  indexNow: z.ZodMiniOptional<z.ZodMiniObject<{
+    key: z.ZodMiniString<string>;
+    keyLocation: z.ZodMiniOptional<z.ZodMiniURL>;
+    endpoint: z.ZodMiniOptional<z.ZodMiniURL>;
+  }, z.z.core.$strip>>;
+  searchConsole: z.ZodMiniOptional<z.ZodMiniObject<{
+    siteUrl: z.ZodMiniString<string>;
+    resubmitSitemap: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+  }, z.z.core.$strip>>;
+  priorityUrls: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniURL>>;
+}, z.z.core.$strip>;
 /**
  * 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
@@ -475,106 +565,108 @@ 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>>>;
-    meta: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-      name: z.ZodMiniOptional<z.ZodMiniString<string>>;
-      description: z.ZodMiniOptional<z.ZodMiniString<string>>;
-    }, z.z.core.$strip>>>;
-    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.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
-        hue: z.ZodMiniString<string>;
-        kind: z.ZodMiniOptional<z.ZodMiniEnum<{
-          surface: "surface";
-          chromatic: "chromatic";
-        }>>;
-      }, z.z.core.$strip>]>>>;
-      utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-        fill: "fill";
-        bg: "bg";
-        text: "text";
-        icon: "icon";
-        border: "border";
-        outline: "outline";
-        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<{
@@ -670,9 +762,9 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
         number: "number";
         date: "date";
         file: "file";
+        text: "text";
         email: "email";
         url: "url";
-        text: "text";
         tel: "tel";
         password: "password";
         textarea: "textarea";
@@ -740,11 +832,30 @@ declare const SiteConfigSchema: z.ZodMiniObject<{
         height: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
       }, z.z.core.$strip>]>>;
     }, z.z.core.$strip>>;
+    indexing: z.ZodMiniOptional<z.ZodMiniObject<{
+      sitemapUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+      indexNow: z.ZodMiniOptional<z.ZodMiniObject<{
+        key: z.ZodMiniString<string>;
+        keyLocation: z.ZodMiniOptional<z.ZodMiniURL>;
+        endpoint: z.ZodMiniOptional<z.ZodMiniURL>;
+      }, z.z.core.$strip>>;
+      searchConsole: z.ZodMiniOptional<z.ZodMiniObject<{
+        siteUrl: z.ZodMiniString<string>;
+        resubmitSitemap: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+      }, z.z.core.$strip>>;
+      priorityUrls: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniURL>>;
+    }, z.z.core.$strip>>;
   }, z.z.core.$strip>>;
   analytics: z.ZodMiniOptional<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>;
@@ -809,6 +920,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>>>;
@@ -818,7 +931,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>>;
@@ -835,6 +949,14 @@ 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>;
+/** The `seo.indexing` block — what `vitops notify` reads. */
+type SiteIndexing = z.infer<typeof IndexingSchema>;
+/** IndexNow submission settings. The `key` is public by design. */
+type SiteIndexNow = z.infer<typeof IndexNowSchema>;
+/** Google Search Console property settings. The credential is never in the config. */
+type SiteSearchConsole = z.infer<typeof SearchConsoleSchema>;
 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: {
@@ -1005,106 +1127,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>>>;
-      meta: z.ZodMiniOptional<z.ZodMiniOptional<z.ZodMiniObject<{
-        name: z.ZodMiniOptional<z.ZodMiniString<string>>;
-        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
-      }, z.z.core.$strip>>>;
-      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.ZodMiniUnion<readonly [z.ZodMiniString<string>, z.ZodMiniObject<{
-          hue: z.ZodMiniString<string>;
-          kind: z.ZodMiniOptional<z.ZodMiniEnum<{
-            surface: "surface";
-            chromatic: "chromatic";
-          }>>;
-        }, z.z.core.$strip>]>>>;
-        utilities: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniEnum<{
-          fill: "fill";
-          bg: "bg";
-          text: "text";
-          icon: "icon";
-          border: "border";
-          outline: "outline";
-          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<{
@@ -1200,9 +1324,9 @@ declare const siteJsonSchema: {
           number: "number";
           date: "date";
           file: "file";
+          text: "text";
           email: "email";
           url: "url";
-          text: "text";
           tel: "tel";
           password: "password";
           textarea: "textarea";
@@ -1270,11 +1394,30 @@ declare const siteJsonSchema: {
           height: z.ZodMiniOptional<z.ZodMiniNumber<number>>;
         }, z.z.core.$strip>]>>;
       }, z.z.core.$strip>>;
+      indexing: z.ZodMiniOptional<z.ZodMiniObject<{
+        sitemapUrl: z.ZodMiniOptional<z.ZodMiniURL>;
+        indexNow: z.ZodMiniOptional<z.ZodMiniObject<{
+          key: z.ZodMiniString<string>;
+          keyLocation: z.ZodMiniOptional<z.ZodMiniURL>;
+          endpoint: z.ZodMiniOptional<z.ZodMiniURL>;
+        }, z.z.core.$strip>>;
+        searchConsole: z.ZodMiniOptional<z.ZodMiniObject<{
+          siteUrl: z.ZodMiniString<string>;
+          resubmitSitemap: z.ZodMiniOptional<z.ZodMiniBoolean<boolean>>;
+        }, z.z.core.$strip>>;
+        priorityUrls: z.ZodMiniOptional<z.ZodMiniArray<z.ZodMiniURL>>;
+      }, z.z.core.$strip>>;
     }, z.z.core.$strip>>;
     analytics: z.ZodMiniOptional<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>;
@@ -1339,6 +1482,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>>>;
@@ -1348,7 +1493,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>>;
@@ -1464,12 +1610,61 @@ 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. */
@@ -1540,8 +1735,22 @@ type Format = 'bricks' | 'css' | 'tailwind' | 'design';
  */
 type StylesheetFormat = Exclude<Format, 'design'>;
 interface GenerateOptions {
-  /** Path to a design-system.json, OR an already-parsed config object. */
-  input: string | DesignSystem;
+  /**
+   * 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'. */
@@ -1549,14 +1758,34 @@ interface GenerateOptions {
   /** Override the framework asset root (advanced/testing). */
   assetsDir?: string;
   /**
-   * Optional site config (path, or already-parsed) enabling legal-document
-   * output into `<outDir>/legal/*.html`.
+   * 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`.
    *
-   * Separate from `input` because it is a different config kind: `input` is a
-   * `design-system.json`, this is a `SiteConfig`. Nothing else in `generate`
-   * reads it, and omitting it emits no legal files.
+   * 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;
@@ -1594,6 +1823,242 @@ declare function generate(options: GenerateOptions): Promise<GenerateResult>;
  */
 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
@@ -1610,10 +2075,9 @@ declare function generateDocs(ds: DesignSystem, assetsDir: string): Record<strin
  * 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.
+ * 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.
  */
@@ -1715,6 +2179,26 @@ declare const KNOWN_PROCESSORS: {
     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;
@@ -1914,5 +2398,5 @@ declare function generateLegal(site: SiteConfig, opts?: GenerateLegalOptions): R
  */
 declare function defaultConfig(): DesignSystem;
 //#endregion
-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, 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 RoleKind, type RoleSpec, SCHEMA_URL, SITE_SCHEMA_URL, type SiteConfig, SiteConfigSchema, type SiteValidationResult, type Span, type StylesheetFormat, TEMPLATES, TW_CLASH, type ValidationResult, deepMerge, defaultConfig, derivePolicyVars, detectProcessorKeys, enabledDocs, expandPalette, functionalRole, generate, generateDocs, generateLegal, jsonSchema, parseMarkdown, renderMarkdown, renderNodes, resolvePrivacyContact, resolveProcessors, resolveSiteConfig, resolveTheme, roleColorUtilities, roleHue, roleKind, siteJsonSchema, stripNulls, toContentNodes, toHtmlFragment, toPortableText, tokenClass, tokenVar, 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 SiteIndexNow, type SiteIndexing, type SiteSearchConsole, 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