@astrojs/starlight 0.41.11 → 0.42.0

package/dist/schemas/hero.d.ts

@@ -0,0 +1,319 @@
+import { z } from "astro/zod";
+import { SchemaContext } from "astro:content";
+//#region src/schemas/hero.d.ts
+declare const HeroSchema: ({ image }: SchemaContext) => z.ZodObject<{
+  title: z.ZodOptional<z.ZodString>;
+  tagline: z.ZodOptional<z.ZodString>;
+  image: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    alt: z.ZodDefault<z.ZodString>;
+    file: any;
+  }, z.core.$strip>, z.ZodObject<{
+    alt: z.ZodDefault<z.ZodString>;
+    dark: any;
+    light: any;
+  }, z.core.$strip>, z.ZodPipe<z.ZodObject<{
+    html: z.ZodString;
+  }, z.core.$strip>, z.ZodTransform<{
+    html: string;
+    alt: string;
+  }, {
+    html: string;
+  }>>]>>;
+  actions: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    text: z.ZodString;
+    link: z.ZodString;
+    variant: z.ZodDefault<z.ZodEnum<{
+      primary: "primary";
+      secondary: "secondary";
+      minimal: "minimal";
+    }>>;
+    icon: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodEnum<{
+      server: "server";
+      external: "external";
+      error: "error";
+      link: "link";
+      "up-caret": "up-caret";
+      "down-caret": "down-caret";
+      "right-caret": "right-caret";
+      "left-caret": "left-caret";
+      "up-arrow": "up-arrow";
+      "down-arrow": "down-arrow";
+      "right-arrow": "right-arrow";
+      "left-arrow": "left-arrow";
+      bars: "bars";
+      translate: "translate";
+      pencil: "pencil";
+      pen: "pen";
+      document: "document";
+      "add-document": "add-document";
+      setting: "setting";
+      "link-alt": "link-alt";
+      download: "download";
+      "cloud-download": "cloud-download";
+      moon: "moon";
+      sun: "sun";
+      clock: "clock";
+      laptop: "laptop";
+      desktop: "desktop";
+      "mobile-android": "mobile-android";
+      window: "window";
+      database: "database";
+      "code-branch": "code-branch";
+      "open-book": "open-book";
+      notes: "notes";
+      information: "information";
+      magnifier: "magnifier";
+      "forward-slash": "forward-slash";
+      close: "close";
+      warning: "warning";
+      "approve-check-circle": "approve-check-circle";
+      "approve-check": "approve-check";
+      "question-circle": "question-circle";
+      question: "question";
+      rocket: "rocket";
+      star: "star";
+      puzzle: "puzzle";
+      "list-format": "list-format";
+      analytics: "analytics";
+      random: "random";
+      padlock: "padlock";
+      comment: "comment";
+      "comment-alt": "comment-alt";
+      heart: "heart";
+      github: "github";
+      gitlab: "gitlab";
+      bitbucket: "bitbucket";
+      forgejo: "forgejo";
+      codePen: "codePen";
+      farcaster: "farcaster";
+      discord: "discord";
+      gitter: "gitter";
+      twitter: "twitter";
+      "x.com": "x.com";
+      mastodon: "mastodon";
+      codeberg: "codeberg";
+      youtube: "youtube";
+      threads: "threads";
+      linkedin: "linkedin";
+      twitch: "twitch";
+      azureDevOps: "azureDevOps";
+      microsoftTeams: "microsoftTeams";
+      instagram: "instagram";
+      stackOverflow: "stackOverflow";
+      telegram: "telegram";
+      whatsApp: "whatsApp";
+      rss: "rss";
+      facebook: "facebook";
+      email: "email";
+      phone: "phone";
+      reddit: "reddit";
+      patreon: "patreon";
+      signal: "signal";
+      slack: "slack";
+      matrix: "matrix";
+      hackerOne: "hackerOne";
+      openCollective: "openCollective";
+      blueSky: "blueSky";
+      discourse: "discourse";
+      zulip: "zulip";
+      pinterest: "pinterest";
+      tiktok: "tiktok";
+      goodreads: "goodreads";
+      hypothesis: "hypothesis";
+      astro: "astro";
+      solidjs: "solidjs";
+      alpine: "alpine";
+      pnpm: "pnpm";
+      biome: "biome";
+      bun: "bun";
+      mdx: "mdx";
+      apple: "apple";
+      linux: "linux";
+      homebrew: "homebrew";
+      nix: "nix";
+      starlight: "starlight";
+      pkl: "pkl";
+      node: "node";
+      cloudflare: "cloudflare";
+      vercel: "vercel";
+      netlify: "netlify";
+      deno: "deno";
+      jsr: "jsr";
+      nostr: "nostr";
+      backstage: "backstage";
+      confluence: "confluence";
+      jira: "jira";
+      storybook: "storybook";
+      vscode: "vscode";
+      jetbrains: "jetbrains";
+      zed: "zed";
+      vim: "vim";
+      figma: "figma";
+      sketch: "sketch";
+      npm: "npm";
+      npmx: "npmx";
+      sourcehut: "sourcehut";
+      substack: "substack";
+      chrome: "chrome";
+      edge: "edge";
+      firefox: "firefox";
+      safari: "safari";
+      "seti:folder": "seti:folder";
+      "seti:bsl": "seti:bsl";
+      "seti:mdo": "seti:mdo";
+      "seti:salesforce": "seti:salesforce";
+      "seti:asm": "seti:asm";
+      "seti:bicep": "seti:bicep";
+      "seti:bazel": "seti:bazel";
+      "seti:c": "seti:c";
+      "seti:c-sharp": "seti:c-sharp";
+      "seti:html": "seti:html";
+      "seti:cpp": "seti:cpp";
+      "seti:clojure": "seti:clojure";
+      "seti:coldfusion": "seti:coldfusion";
+      "seti:config": "seti:config";
+      "seti:crystal": "seti:crystal";
+      "seti:crystal_embedded": "seti:crystal_embedded";
+      "seti:json": "seti:json";
+      "seti:css": "seti:css";
+      "seti:csv": "seti:csv";
+      "seti:xls": "seti:xls";
+      "seti:cu": "seti:cu";
+      "seti:cake": "seti:cake";
+      "seti:cake_php": "seti:cake_php";
+      "seti:d": "seti:d";
+      "seti:word": "seti:word";
+      "seti:elixir": "seti:elixir";
+      "seti:elixir_script": "seti:elixir_script";
+      "seti:hex": "seti:hex";
+      "seti:elm": "seti:elm";
+      "seti:favicon": "seti:favicon";
+      "seti:f-sharp": "seti:f-sharp";
+      "seti:git": "seti:git";
+      "seti:go": "seti:go";
+      "seti:godot": "seti:godot";
+      "seti:gradle": "seti:gradle";
+      "seti:grails": "seti:grails";
+      "seti:graphql": "seti:graphql";
+      "seti:hacklang": "seti:hacklang";
+      "seti:haml": "seti:haml";
+      "seti:mustache": "seti:mustache";
+      "seti:haskell": "seti:haskell";
+      "seti:haxe": "seti:haxe";
+      "seti:jade": "seti:jade";
+      "seti:java": "seti:java";
+      "seti:javascript": "seti:javascript";
+      "seti:jinja": "seti:jinja";
+      "seti:julia": "seti:julia";
+      "seti:karma": "seti:karma";
+      "seti:kotlin": "seti:kotlin";
+      "seti:dart": "seti:dart";
+      "seti:liquid": "seti:liquid";
+      "seti:livescript": "seti:livescript";
+      "seti:lua": "seti:lua";
+      "seti:markdown": "seti:markdown";
+      "seti:argdown": "seti:argdown";
+      "seti:info": "seti:info";
+      "seti:clock": "seti:clock";
+      "seti:maven": "seti:maven";
+      "seti:nim": "seti:nim";
+      "seti:github": "seti:github";
+      "seti:notebook": "seti:notebook";
+      "seti:nunjucks": "seti:nunjucks";
+      "seti:npm": "seti:npm";
+      "seti:ocaml": "seti:ocaml";
+      "seti:odata": "seti:odata";
+      "seti:perl": "seti:perl";
+      "seti:php": "seti:php";
+      "seti:pipeline": "seti:pipeline";
+      "seti:pddl": "seti:pddl";
+      "seti:plan": "seti:plan";
+      "seti:happenings": "seti:happenings";
+      "seti:powershell": "seti:powershell";
+      "seti:prisma": "seti:prisma";
+      "seti:pug": "seti:pug";
+      "seti:puppet": "seti:puppet";
+      "seti:purescript": "seti:purescript";
+      "seti:python": "seti:python";
+      "seti:react": "seti:react";
+      "seti:rescript": "seti:rescript";
+      "seti:R": "seti:R";
+      "seti:ruby": "seti:ruby";
+      "seti:rust": "seti:rust";
+      "seti:sass": "seti:sass";
+      "seti:spring": "seti:spring";
+      "seti:slim": "seti:slim";
+      "seti:smarty": "seti:smarty";
+      "seti:sbt": "seti:sbt";
+      "seti:scala": "seti:scala";
+      "seti:ethereum": "seti:ethereum";
+      "seti:stylus": "seti:stylus";
+      "seti:svelte": "seti:svelte";
+      "seti:swift": "seti:swift";
+      "seti:db": "seti:db";
+      "seti:terraform": "seti:terraform";
+      "seti:tex": "seti:tex";
+      "seti:default": "seti:default";
+      "seti:twig": "seti:twig";
+      "seti:typescript": "seti:typescript";
+      "seti:tsconfig": "seti:tsconfig";
+      "seti:vala": "seti:vala";
+      "seti:vite": "seti:vite";
+      "seti:vue": "seti:vue";
+      "seti:wasm": "seti:wasm";
+      "seti:wat": "seti:wat";
+      "seti:xml": "seti:xml";
+      "seti:yml": "seti:yml";
+      "seti:prolog": "seti:prolog";
+      "seti:zig": "seti:zig";
+      "seti:zip": "seti:zip";
+      "seti:wgt": "seti:wgt";
+      "seti:illustrator": "seti:illustrator";
+      "seti:photoshop": "seti:photoshop";
+      "seti:pdf": "seti:pdf";
+      "seti:font": "seti:font";
+      "seti:image": "seti:image";
+      "seti:svg": "seti:svg";
+      "seti:sublime": "seti:sublime";
+      "seti:code-search": "seti:code-search";
+      "seti:shell": "seti:shell";
+      "seti:video": "seti:video";
+      "seti:audio": "seti:audio";
+      "seti:windows": "seti:windows";
+      "seti:jenkins": "seti:jenkins";
+      "seti:babel": "seti:babel";
+      "seti:bower": "seti:bower";
+      "seti:docker": "seti:docker";
+      "seti:code-climate": "seti:code-climate";
+      "seti:eslint": "seti:eslint";
+      "seti:firebase": "seti:firebase";
+      "seti:firefox": "seti:firefox";
+      "seti:gitlab": "seti:gitlab";
+      "seti:grunt": "seti:grunt";
+      "seti:gulp": "seti:gulp";
+      "seti:ionic": "seti:ionic";
+      "seti:platformio": "seti:platformio";
+      "seti:rollup": "seti:rollup";
+      "seti:stylelint": "seti:stylelint";
+      "seti:yarn": "seti:yarn";
+      "seti:webpack": "seti:webpack";
+      "seti:lock": "seti:lock";
+      "seti:license": "seti:license";
+      "seti:makefile": "seti:makefile";
+      "seti:heroku": "seti:heroku";
+      "seti:todo": "seti:todo";
+      "seti:ignored": "seti:ignored";
+    }>, z.ZodString]>, z.ZodTransform<{
+      readonly type: "icon";
+      readonly name: "server" | "external" | "error" | "link" | "up-caret" | "down-caret" | "right-caret" | "left-caret" | "up-arrow" | "down-arrow" | "right-arrow" | "left-arrow" | "bars" | "translate" | "pencil" | "pen" | "document" | "add-document" | "setting" | "link-alt" | "download" | "cloud-download" | "moon" | "sun" | "clock" | "laptop" | "desktop" | "mobile-android" | "window" | "database" | "code-branch" | "open-book" | "notes" | "information" | "magnifier" | "forward-slash" | "close" | "warning" | "approve-check-circle" | "approve-check" | "question-circle" | "question" | "rocket" | "star" | "puzzle" | "list-format" | "analytics" | "random" | "padlock" | "comment" | "comment-alt" | "heart" | "github" | "gitlab" | "bitbucket" | "forgejo" | "codePen" | "farcaster" | "discord" | "gitter" | "twitter" | "x.com" | "mastodon" | "codeberg" | "youtube" | "threads" | "linkedin" | "twitch" | "azureDevOps" | "microsoftTeams" | "instagram" | "stackOverflow" | "telegram" | "whatsApp" | "rss" | "facebook" | "email" | "phone" | "reddit" | "patreon" | "signal" | "slack" | "matrix" | "hackerOne" | "openCollective" | "blueSky" | "discourse" | "zulip" | "pinterest" | "tiktok" | "goodreads" | "hypothesis" | "astro" | "solidjs" | "alpine" | "pnpm" | "biome" | "bun" | "mdx" | "apple" | "linux" | "homebrew" | "nix" | "starlight" | "pkl" | "node" | "cloudflare" | "vercel" | "netlify" | "deno" | "jsr" | "nostr" | "backstage" | "confluence" | "jira" | "storybook" | "vscode" | "jetbrains" | "zed" | "vim" | "figma" | "sketch" | "npm" | "npmx" | "sourcehut" | "substack" | "chrome" | "edge" | "firefox" | "safari" | "seti:folder" | "seti:bsl" | "seti:mdo" | "seti:salesforce" | "seti:asm" | "seti:bicep" | "seti:bazel" | "seti:c" | "seti:c-sharp" | "seti:html" | "seti:cpp" | "seti:clojure" | "seti:coldfusion" | "seti:config" | "seti:crystal" | "seti:crystal_embedded" | "seti:json" | "seti:css" | "seti:csv" | "seti:xls" | "seti:cu" | "seti:cake" | "seti:cake_php" | "seti:d" | "seti:word" | "seti:elixir" | "seti:elixir_script" | "seti:hex" | "seti:elm" | "seti:favicon" | "seti:f-sharp" | "seti:git" | "seti:go" | "seti:godot" | "seti:gradle" | "seti:grails" | "seti:graphql" | "seti:hacklang" | "seti:haml" | "seti:mustache" | "seti:haskell" | "seti:haxe" | "seti:jade" | "seti:java" | "seti:javascript" | "seti:jinja" | "seti:julia" | "seti:karma" | "seti:kotlin" | "seti:dart" | "seti:liquid" | "seti:livescript" | "seti:lua" | "seti:markdown" | "seti:argdown" | "seti:info" | "seti:clock" | "seti:maven" | "seti:nim" | "seti:github" | "seti:notebook" | "seti:nunjucks" | "seti:npm" | "seti:ocaml" | "seti:odata" | "seti:perl" | "seti:php" | "seti:pipeline" | "seti:pddl" | "seti:plan" | "seti:happenings" | "seti:powershell" | "seti:prisma" | "seti:pug" | "seti:puppet" | "seti:purescript" | "seti:python" | "seti:react" | "seti:rescript" | "seti:R" | "seti:ruby" | "seti:rust" | "seti:sass" | "seti:spring" | "seti:slim" | "seti:smarty" | "seti:sbt" | "seti:scala" | "seti:ethereum" | "seti:stylus" | "seti:svelte" | "seti:swift" | "seti:db" | "seti:terraform" | "seti:tex" | "seti:default" | "seti:twig" | "seti:typescript" | "seti:tsconfig" | "seti:vala" | "seti:vite" | "seti:vue" | "seti:wasm" | "seti:wat" | "seti:xml" | "seti:yml" | "seti:prolog" | "seti:zig" | "seti:zip" | "seti:wgt" | "seti:illustrator" | "seti:photoshop" | "seti:pdf" | "seti:font" | "seti:image" | "seti:svg" | "seti:sublime" | "seti:code-search" | "seti:shell" | "seti:video" | "seti:audio" | "seti:windows" | "seti:jenkins" | "seti:babel" | "seti:bower" | "seti:docker" | "seti:code-climate" | "seti:eslint" | "seti:firebase" | "seti:firefox" | "seti:gitlab" | "seti:grunt" | "seti:gulp" | "seti:ionic" | "seti:platformio" | "seti:rollup" | "seti:stylelint" | "seti:yarn" | "seti:webpack" | "seti:lock" | "seti:license" | "seti:makefile" | "seti:heroku" | "seti:todo" | "seti:ignored";
+      readonly html?: never;
+    } | {
+      readonly type: "raw";
+      readonly html: string;
+      readonly name?: never;
+    }, string>>>;
+    attrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber, z.ZodBoolean]>>>;
+  }, z.core.$strip>>>;
+}, z.core.$strip>;
+//#endregion
+export { HeroSchema };

package/dist/schemas/hero.js

@@ -0,0 +1,73 @@
+import { IconSchema } from "./icon.js";
+import { z } from "astro/zod";
+//#region src/schemas/hero.ts
+const HeroSchema = ({ image }) => z.object({
+	/**
+	* The large title text to show. If not provided, will default to the top-level `title`.
+	* Can include HTML.
+	*/
+	title: z.string().optional(),
+	/**
+	* A short bit of text about your project.
+	* Will be displayed in a smaller size below the title.
+	*/
+	tagline: z.string().optional(),
+	/** The image to use in the hero. You can provide either a relative `file` path or raw `html`. */
+	image: z.union([
+		z.object({
+			/** Alt text for screenreaders and other assistive technologies describing your hero image. */
+			alt: z.string().default(""),
+			/** Relative path to an image file in your repo, e.g. `../../assets/hero.png`. */
+			file: image()
+		}),
+		z.object({
+			/** Alt text for screenreaders and other assistive technologies describing your hero image. */
+			alt: z.string().default(""),
+			/** Relative path to an image file in your repo to use in dark mode, e.g. `../../assets/hero-dark.png`. */
+			dark: image(),
+			/** Relative path to an image file in your repo to use in light mode, e.g. `../../assets/hero-light.png`. */
+			light: image()
+		}),
+		z.object({ 
+		/** Raw HTML string instead of an image file. Useful for inline SVGs or more complex hero content. */
+html: z.string() }).transform(({ html }) => ({
+			html,
+			alt: ""
+		}))
+	]).optional(),
+	/** An array of call-to-action links displayed at the bottom of the hero. */
+	actions: z.object({
+		/** Text label displayed in the link. */
+		text: z.string(),
+		/** Value for the link’s `href` attribute, e.g. `/page` or `https://mysite.com`. */
+		link: z.string(),
+		/** Button style to use. One of `primary` (the default), `secondary`, or `minimal`. */
+		variant: z.enum([
+			"primary",
+			"secondary",
+			"minimal"
+		]).default("primary"),
+		/**
+		* An optional icon to display alongside the link text.
+		* Can be an inline `<svg>` or the name of one of Starlight’s built-in icons.
+		*/
+		icon: z.union([IconSchema(), z.string().startsWith("<svg")]).transform((icon) => {
+			const parsedIcon = IconSchema().safeParse(icon);
+			return parsedIcon.success ? {
+				type: "icon",
+				name: parsedIcon.data
+			} : {
+				type: "raw",
+				html: icon
+			};
+		}).optional(),
+		/** HTML attributes to add to the link */
+		attrs: z.record(z.string(), z.union([
+			z.string(),
+			z.number(),
+			z.boolean()
+		])).optional()
+	}).array().default([])
+});
+//#endregion
+export { HeroSchema };

package/dist/schemas/i18n.d.ts

@@ -0,0 +1,125 @@
+import { z } from "astro/zod";
+//#region src/schemas/i18n.d.ts
+interface i18nSchemaOpts<T extends z.ZodObject = BaseExtendSchema> {
+  /**
+   * Extend Starlight’s i18n schema with additional fields.
+   *
+   * @example
+   * // Add two optional fields to the default schema.
+   * i18nSchema({
+   * 	extend: z
+   * 		.object({
+   * 			'customUi.heading': z.string(),
+   * 			'customUi.text': z.string(),
+   * 		})
+   * 		.partial(),
+   * })
+   */
+  extend?: T;
+}
+declare const defaultI18nSchema: () => z.ZodObject<{
+  'expressiveCode.copyButtonCopied': z.ZodOptional<z.ZodString>;
+  'expressiveCode.copyButtonTooltip': z.ZodOptional<z.ZodString>;
+  'expressiveCode.terminalWindowFallbackTitle': z.ZodOptional<z.ZodString>;
+  'pagefind.clear_search': z.ZodOptional<z.ZodString>;
+  'pagefind.load_more': z.ZodOptional<z.ZodString>;
+  'pagefind.search_label': z.ZodOptional<z.ZodString>;
+  'pagefind.filters_label': z.ZodOptional<z.ZodString>;
+  'pagefind.zero_results': z.ZodOptional<z.ZodString>;
+  'pagefind.many_results': z.ZodOptional<z.ZodString>;
+  'pagefind.one_result': z.ZodOptional<z.ZodString>;
+  'pagefind.alt_search': z.ZodOptional<z.ZodString>;
+  'pagefind.search_suggestion': z.ZodOptional<z.ZodString>;
+  'pagefind.searching': z.ZodOptional<z.ZodString>;
+  'skipLink.label': z.ZodOptional<z.ZodString>;
+  'search.label': z.ZodOptional<z.ZodString>;
+  'search.ctrlKey': z.ZodOptional<z.ZodString>;
+  'search.cancelLabel': z.ZodOptional<z.ZodString>;
+  'search.devWarning': z.ZodOptional<z.ZodString>;
+  'themeSelect.accessibleLabel': z.ZodOptional<z.ZodString>;
+  'themeSelect.dark': z.ZodOptional<z.ZodString>;
+  'themeSelect.light': z.ZodOptional<z.ZodString>;
+  'themeSelect.auto': z.ZodOptional<z.ZodString>;
+  'languageSelect.accessibleLabel': z.ZodOptional<z.ZodString>;
+  'menuButton.accessibleLabel': z.ZodOptional<z.ZodString>;
+  'sidebarNav.accessibleLabel': z.ZodOptional<z.ZodString>;
+  'tableOfContents.onThisPage': z.ZodOptional<z.ZodString>;
+  'tableOfContents.overview': z.ZodOptional<z.ZodString>;
+  'i18n.untranslatedContent': z.ZodOptional<z.ZodString>;
+  'page.editLink': z.ZodOptional<z.ZodString>;
+  'page.lastUpdated': z.ZodOptional<z.ZodString>;
+  'page.previousLink': z.ZodOptional<z.ZodString>;
+  'page.nextLink': z.ZodOptional<z.ZodString>;
+  'page.draft': z.ZodOptional<z.ZodString>;
+  '404.text': z.ZodOptional<z.ZodString>;
+  'aside.tip': z.ZodOptional<z.ZodString>;
+  'aside.note': z.ZodOptional<z.ZodString>;
+  'aside.caution': z.ZodOptional<z.ZodString>;
+  'aside.danger': z.ZodOptional<z.ZodString>;
+  'fileTree.directory': z.ZodOptional<z.ZodString>;
+  'builtWithStarlight.label': z.ZodOptional<z.ZodString>;
+  'heading.anchorLabel': z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Type of Starlight’s default i18n schema, including extensions from Pagefind and Expressive Code. */
+type DefaultI18nSchema = ReturnType<typeof defaultI18nSchema>;
+/**
+ * Based on the the return type of Zod’s `extend()` method. Adds fields from one `z.object()` schema
+ * to another.
+ * Also sets the resulting schema as “loose” as that’s how we use it. In practice whether or not
+ * the types are loose or not doesn’t matter too much.
+ *
+ * @see https://github.com/colinhacks/zod/blob/9712a6707f3d4584f222729965f3b78f076f0435/packages/zod/src/v4/classic/schemas.ts#L1187
+ */
+type MergeSchemas<A extends z.ZodObject, B extends z.ZodObject> = z.ZodObject<z.util.Extend<A['shape'], B['shape']>, z.core.$loose>;
+/** Type that extends Starlight’s default i18n schema with an optional, user-defined schema. */
+type ExtendedSchema<T extends z.ZodObject> = T extends z.ZodObject ? MergeSchemas<DefaultI18nSchema, T> : DefaultI18nSchema;
+/** Type representing an empty Zod object schema used as the default for the `extend` option. */
+type BaseExtendSchema = z.ZodObject<{}>;
+/** Content collection schema for Starlight’s optional `i18n` collection. */
+declare function i18nSchema<T extends z.ZodObject = BaseExtendSchema>({ extend }?: i18nSchemaOpts<T>): ExtendedSchema<T>;
+type i18nSchemaOutput = z.output<ExtendedSchema<BaseExtendSchema>>;
+declare function builtinI18nSchema(): z.ZodObject<{
+  'expressiveCode.copyButtonCopied': z.ZodOptional<z.ZodString>;
+  'expressiveCode.copyButtonTooltip': z.ZodOptional<z.ZodString>;
+  'expressiveCode.terminalWindowFallbackTitle': z.ZodOptional<z.ZodString>;
+  'pagefind.clear_search': z.ZodOptional<z.ZodString>;
+  'pagefind.load_more': z.ZodOptional<z.ZodString>;
+  'pagefind.search_label': z.ZodOptional<z.ZodString>;
+  'pagefind.filters_label': z.ZodOptional<z.ZodString>;
+  'pagefind.zero_results': z.ZodOptional<z.ZodString>;
+  'pagefind.many_results': z.ZodOptional<z.ZodString>;
+  'pagefind.one_result': z.ZodOptional<z.ZodString>;
+  'pagefind.alt_search': z.ZodOptional<z.ZodString>;
+  'pagefind.search_suggestion': z.ZodOptional<z.ZodString>;
+  'pagefind.searching': z.ZodOptional<z.ZodString>;
+  'skipLink.label': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'search.label': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'search.ctrlKey': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'search.cancelLabel': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'search.devWarning': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'themeSelect.accessibleLabel': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'themeSelect.dark': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'themeSelect.light': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'themeSelect.auto': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'languageSelect.accessibleLabel': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'menuButton.accessibleLabel': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'sidebarNav.accessibleLabel': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'tableOfContents.onThisPage': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'tableOfContents.overview': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'i18n.untranslatedContent': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'page.editLink': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'page.lastUpdated': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'page.previousLink': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'page.nextLink': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'page.draft': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  '404.text': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'aside.tip': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'aside.note': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'aside.caution': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'aside.danger': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'fileTree.directory': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'builtWithStarlight.label': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+  'heading.anchorLabel': z.ZodNonOptional<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+//#endregion
+export { builtinI18nSchema, i18nSchema, i18nSchemaOutput };

package/dist/schemas/i18n.js

@@ -0,0 +1,76 @@
+import { z } from "astro/zod";
+//#region src/schemas/i18n.ts
+const defaultI18nSchema = () => z.object({
+	...starlightI18nSchema().shape,
+	...pagefindI18nSchema().shape,
+	...expressiveCodeI18nSchema().shape
+});
+/** Content collection schema for Starlight’s optional `i18n` collection. */
+function i18nSchema({ extend = z.object({}) } = {}) {
+	return z.looseObject({
+		...defaultI18nSchema().shape,
+		...extend.shape
+	});
+}
+function builtinI18nSchema() {
+	return z.object({
+		...z.strictObject({ ...starlightI18nSchema().required().shape }).shape,
+		...pagefindI18nSchema().shape,
+		...expressiveCodeI18nSchema().shape
+	});
+}
+function starlightI18nSchema() {
+	return z.object({
+		"skipLink.label": z.string().meta({ description: "Text displayed in the accessible “Skip link” when a keyboard user first tabs into a page." }),
+		"search.label": z.string().meta({ description: "Text displayed in the search bar." }),
+		"search.ctrlKey": z.string().meta({ description: "Visible representation of the Control key potentially used in the shortcut key to open the search modal." }),
+		"search.cancelLabel": z.string().meta({ description: "Text for the “Cancel” button that closes the search modal." }),
+		"search.devWarning": z.string().meta({ description: "Warning displayed when opening the Search in a dev environment." }),
+		"themeSelect.accessibleLabel": z.string().meta({ description: "Accessible label for the theme selection dropdown." }),
+		"themeSelect.dark": z.string().meta({ description: "Name of the dark color theme." }),
+		"themeSelect.light": z.string().meta({ description: "Name of the light color theme." }),
+		"themeSelect.auto": z.string().meta({ description: "Name of the automatic color theme that syncs with system preferences." }),
+		"languageSelect.accessibleLabel": z.string().meta({ description: "Accessible label for the language selection dropdown." }),
+		"menuButton.accessibleLabel": z.string().meta({ description: "Accessible label for the mobile menu button." }),
+		"sidebarNav.accessibleLabel": z.string().meta({ description: "Accessible label for the main sidebar `<nav>` element to distinguish it from other `<nav>` landmarks on the page." }),
+		"tableOfContents.onThisPage": z.string().meta({ description: "Title for the table of contents component." }),
+		"tableOfContents.overview": z.string().meta({ description: "Label used for the first link in the table of contents, linking to the page title." }),
+		"i18n.untranslatedContent": z.string().meta({ description: "Notice informing users they are on a page that is not yet translated to their language." }),
+		"page.editLink": z.string().meta({ description: "Text for the link to edit a page." }),
+		"page.lastUpdated": z.string().meta({ description: "Text displayed in front of the last updated date in the page footer." }),
+		"page.previousLink": z.string().meta({ description: "Label shown on the “previous page” pagination arrow in the page footer." }),
+		"page.nextLink": z.string().meta({ description: "Label shown on the “next page” pagination arrow in the page footer." }),
+		"page.draft": z.string().meta({ description: "Development-only notice informing users they are on a page that is a draft which will not be included in production builds." }),
+		"404.text": z.string().meta({ description: "Text shown on Starlight’s default 404 page" }),
+		"aside.tip": z.string().meta({ description: "Text shown on the tip aside variant" }),
+		"aside.note": z.string().meta({ description: "Text shown on the note aside variant" }),
+		"aside.caution": z.string().meta({ description: "Text shown on the warning aside variant" }),
+		"aside.danger": z.string().meta({ description: "Text shown on the danger aside variant" }),
+		"fileTree.directory": z.string().meta({ description: "Label for the directory icon in the file tree component." }),
+		"builtWithStarlight.label": z.string().meta({ description: "Label for the “Built with Starlight” badge optionally displayed in the site footer." }),
+		"heading.anchorLabel": z.string().meta({ description: "Label for anchor links in Markdown content." })
+	}).partial();
+}
+function pagefindI18nSchema() {
+	return z.object({
+		"pagefind.clear_search": z.string().meta({ description: "Pagefind UI translation. English default value: `\"Clear\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.load_more": z.string().meta({ description: "Pagefind UI translation. English default value: `\"Load more results\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.search_label": z.string().meta({ description: "Pagefind UI translation. English default value: `\"Search this site\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.filters_label": z.string().meta({ description: "Pagefind UI translation. English default value: `\"Filters\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.zero_results": z.string().meta({ description: "Pagefind UI translation. English default value: `\"No results for [SEARCH_TERM]\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.many_results": z.string().meta({ description: "Pagefind UI translation. English default value: `\"[COUNT] results for [SEARCH_TERM]\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.one_result": z.string().meta({ description: "Pagefind UI translation. English default value: `\"[COUNT] result for [SEARCH_TERM]\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.alt_search": z.string().meta({ description: "Pagefind UI translation. English default value: `\"No results for [SEARCH_TERM]. Showing results for [DIFFERENT_TERM] instead\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.search_suggestion": z.string().meta({ description: "Pagefind UI translation. English default value: `\"No results for [SEARCH_TERM]. Try one of the following searches:\"`. See https://pagefind.app/docs/ui/#translations" }),
+		"pagefind.searching": z.string().meta({ description: "Pagefind UI translation. English default value: `\"Searching for [SEARCH_TERM]...\"`. See https://pagefind.app/docs/ui/#translations" })
+	}).partial();
+}
+function expressiveCodeI18nSchema() {
+	return z.object({
+		"expressiveCode.copyButtonCopied": z.string().meta({ description: "Expressive Code UI translation. English default value: `\"Copied!\"`" }),
+		"expressiveCode.copyButtonTooltip": z.string().meta({ description: "Expressive Code UI translation. English default value: `\"Copy to clipboard\"`" }),
+		"expressiveCode.terminalWindowFallbackTitle": z.string().meta({ description: "Expressive Code UI translation. English default value: `\"Terminal window\"`" })
+	}).partial();
+}
+//#endregion
+export { builtinI18nSchema, i18nSchema };