@astrojs/starlight 0.41.11 → 0.42.0

package/dist/schema.d.ts

@@ -0,0 +1,426 @@
+import { LinkHTMLAttributes } from "./schemas/sidebar.js";
+import { i18nSchema } from "./schemas/i18n.js";
+import { DeepMergedSchema } from "./utils/zodDeepMerge.js";
+import { z } from "astro/zod";
+import { SchemaContext } from "astro:content";
+//#region src/schema.d.ts
+/** Default content collection schema for Starlight’s `docs` collection. */
+declare const StarlightFrontmatterSchema: (context: SchemaContext) => z.ZodObject<{
+  title: z.ZodString;
+  description: z.ZodOptional<z.ZodString>;
+  editUrl: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodURL, z.ZodBoolean]>>>;
+  head: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    tag: z.ZodEnum<{
+      base: "base";
+      link: "link";
+      meta: "meta";
+      noscript: "noscript";
+      script: "script";
+      style: "style";
+      template: "template";
+      title: "title";
+    }>;
+    attrs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodBoolean, z.ZodUndefined]>>>;
+    content: z.ZodOptional<z.ZodString>;
+  }, z.core.$strip>>>;
+  tableOfContents: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+    minHeadingLevel: z.ZodDefault<z.ZodOptional<z.ZodInt>>;
+    maxHeadingLevel: z.ZodDefault<z.ZodOptional<z.ZodInt>>;
+  }, z.core.$strip>, z.ZodPipe<z.ZodBoolean, z.ZodTransform<false | {
+    minHeadingLevel: number;
+    maxHeadingLevel: number;
+  }, boolean>>]>>;
+  template: z.ZodDefault<z.ZodEnum<{
+    doc: "doc";
+    splash: "splash";
+  }>>;
+  hero: z.ZodOptional<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>>;
+  lastUpdated: z.ZodOptional<z.ZodUnion<readonly [z.ZodDate, z.ZodBoolean]>>;
+  prev: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString, z.ZodObject<{
+    link: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>]>>;
+  next: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString, z.ZodObject<{
+    link: z.ZodOptional<z.ZodString>;
+    label: z.ZodOptional<z.ZodString>;
+  }, z.core.$strict>]>>;
+  sidebar: z.ZodPrefault<z.ZodObject<{
+    order: z.ZodOptional<z.ZodNumber>;
+    label: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+    badge: z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+      text: z.ZodString;
+      variant: z.ZodDefault<z.ZodEnum<{
+        default: "default";
+        success: "success";
+        note: "note";
+        tip: "tip";
+        caution: "caution";
+        danger: "danger";
+      }>>;
+      class: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>]>, z.ZodTransform<{
+      text: string;
+      variant: "default" | "success" | "note" | "tip" | "caution" | "danger";
+      class?: string | undefined;
+    }, string | {
+      text: string;
+      variant: "default" | "success" | "note" | "tip" | "caution" | "danger";
+      class?: string | undefined;
+    }>>>;
+    attrs: z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+  }, z.core.$strip>>;
+  banner: z.ZodOptional<z.ZodObject<{
+    content: z.ZodString;
+  }, z.core.$strip>>;
+  pagefind: z.ZodDefault<z.ZodBoolean>;
+  draft: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/** Type of Starlight’s default frontmatter schema. */
+type DefaultSchema = ReturnType<typeof StarlightFrontmatterSchema>;
+/** Base subset of Zod types that we support passing to the `extend` option. */
+type BaseObjectSchema = z.ZodObject<z.ZodRawShape, z.core.$ZodObjectConfig>;
+type BaseSchema = BaseObjectSchema | z.ZodUnion<readonly BaseObjectSchema[]>;
+/** Type that extends Starlight’s default schema with an optional, user-defined schema. */
+type ExtendedSchema<T extends BaseSchema = never> = [T] extends [never] ? DefaultSchema : DeepMergedSchema<DefaultSchema, T>;
+interface DocsSchemaOpts<T extends BaseSchema> {
+  /**
+   * Extend Starlight’s schema with additional fields.
+   *
+   * @example
+   * // Extend the built-in schema with a Zod schema.
+   * docsSchema({
+   * 	extend: z.object({
+   * 		// Add a new field to the schema.
+   * 		category: z.enum(['tutorial', 'guide', 'reference']).optional(),
+   * 	}),
+   * })
+   *
+   * // Use the Astro image helper.
+   * docsSchema({
+   * 	extend: ({ image }) => {
+   * 		return z.object({
+   * 			cover: image(),
+   * 		});
+   * 	},
+   * })
+   */
+  extend?: T | ((context: SchemaContext) => T);
+}
+/** Content collection schema for Starlight’s `docs` collection. */
+declare function docsSchema<T extends BaseSchema = never>(...args: [DocsSchemaOpts<T>?]): (context: SchemaContext) => ExtendedSchema<T>;
+//#endregion
+export { docsSchema, i18nSchema };

package/dist/schema.js

@@ -0,0 +1,103 @@
+import { HeadConfigSchema } from "./schemas/head.js";
+import { BadgeConfigSchema } from "./schemas/badge.js";
+import { SidebarLinkItemHTMLAttributesSchema } from "./schemas/sidebar.js";
+import { FrontmatterTableOfContentsSchema } from "./schemas/tableOfContents.js";
+import { i18nSchema } from "./schemas/i18n.js";
+import { PrevNextLinkConfigSchema } from "./schemas/prevNextLink.js";
+import { HeroSchema } from "./schemas/hero.js";
+import { deepMergeSchemas } from "./utils/zodDeepMerge.js";
+import { z } from "astro/zod";
+//#region src/schema.ts
+/** Default content collection schema for Starlight’s `docs` collection. */
+const StarlightFrontmatterSchema = (context) => z.object({
+	/** The title of the current page. Required. */
+	title: z.string(),
+	/**
+	* A short description of the current page’s content. Optional, but recommended.
+	* A good description is 150–160 characters long and outlines the key content
+	* of the page in a clear and engaging way.
+	*/
+	description: z.string().optional(),
+	/**
+	* Custom URL where a reader can edit this page.
+	* Overrides the `editLink.baseUrl` global config if set.
+	*
+	* Can also be set to `false` to disable showing an edit link on this page.
+	*/
+	editUrl: z.union([z.url(), z.boolean()]).optional().default(true),
+	/** Set custom `<head>` tags just for this page. */
+	head: HeadConfigSchema({ source: "content" }),
+	/** Override global table of contents configuration for this page. */
+	tableOfContents: FrontmatterTableOfContentsSchema(),
+	/**
+	* Set the layout style for this page.
+	* Can be `'doc'` (the default) or `'splash'` for a wider layout without any sidebars.
+	*/
+	template: z.enum(["doc", "splash"]).default("doc"),
+	/** Display a hero section on this page. */
+	hero: HeroSchema(context).optional(),
+	/**
+	* The last update date of the current page.
+	* Overrides the `lastUpdated` global config or the date generated from the Git history.
+	*/
+	lastUpdated: z.union([z.date(), z.boolean()]).optional(),
+	/**
+	* The previous navigation link configuration.
+	* Overrides the `pagination` global config or the link text and/or URL.
+	*/
+	prev: PrevNextLinkConfigSchema(),
+	/**
+	* The next navigation link configuration.
+	* Overrides the `pagination` global config or the link text and/or URL.
+	*/
+	next: PrevNextLinkConfigSchema(),
+	sidebar: z.object({
+		/**
+		* The order of this page in the navigation.
+		* Pages are sorted by this value in ascending order. Then by slug.
+		* If not provided, pages will be sorted alphabetically by slug.
+		* If two pages have the same order value, they will be sorted alphabetically by slug.
+		*/
+		order: z.number().optional(),
+		/**
+		* The label for this page in the navigation.
+		* Defaults to the page `title` if not set.
+		*/
+		label: z.string().optional(),
+		/**
+		* Prevents this page from being included in autogenerated sidebar groups.
+		*/
+		hidden: z.boolean().default(false),
+		/**
+		* Adds a badge to the sidebar link.
+		* Can be a string or an object with a variant and text.
+		* Variants include 'note', 'tip', 'caution', 'danger', 'success', and 'default'.
+		* Passing only a string defaults to the 'default' variant which uses the site accent color.
+		*/
+		badge: BadgeConfigSchema(),
+		/** HTML attributes to add to the sidebar link. */
+		attrs: SidebarLinkItemHTMLAttributesSchema()
+	}).prefault({}),
+	/** Display an announcement banner at the top of this page. */
+	banner: z.object({ 
+	/** The content of the banner. Supports HTML syntax. */
+content: z.string() }).optional(),
+	/** Pagefind indexing for this page - set to false to disable. */
+	pagefind: z.boolean().default(true),
+	/**
+	* Indicates that this page is a draft and will not be included in production builds.
+	* Note that the page will still be available when running Astro in development mode.
+	*/
+	draft: z.boolean().default(false)
+});
+/** Content collection schema for Starlight’s `docs` collection. */
+function docsSchema(...args) {
+	const [options = {}] = args;
+	const { extend } = options;
+	return (context) => {
+		const UserSchema = typeof extend === "function" ? extend(context) : extend;
+		return UserSchema ? deepMergeSchemas(StarlightFrontmatterSchema(context), UserSchema) : StarlightFrontmatterSchema(context);
+	};
+}
+//#endregion
+export { docsSchema, i18nSchema };

package/dist/schemas/badge.d.ts

@@ -0,0 +1,86 @@
+import { z } from "astro/zod";
+//#region src/schemas/badge.d.ts
+declare const badgeSchema: z.ZodObject<{
+  text: z.ZodString;
+  variant: z.ZodDefault<z.ZodEnum<{
+    default: "default";
+    success: "success";
+    note: "note";
+    tip: "tip";
+    caution: "caution";
+    danger: "danger";
+  }>>;
+  class: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const i18nBadgeSchema: z.ZodObject<{
+  text: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+  variant: z.ZodDefault<z.ZodEnum<{
+    default: "default";
+    success: "success";
+    note: "note";
+    tip: "tip";
+    caution: "caution";
+    danger: "danger";
+  }>>;
+  class: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const BadgeComponentSchema: z.ZodObject<{
+  size: z.ZodDefault<z.ZodEnum<{
+    small: "small";
+    medium: "medium";
+    large: "large";
+  }>>;
+  text: z.ZodString;
+  variant: z.ZodDefault<z.ZodEnum<{
+    default: "default";
+    success: "success";
+    note: "note";
+    tip: "tip";
+    caution: "caution";
+    danger: "danger";
+  }>>;
+  class: z.ZodOptional<z.ZodString>;
+}, z.core.$loose>;
+type BadgeComponentProps = z.input<typeof BadgeComponentSchema>;
+declare const BadgeConfigSchema: () => z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  text: z.ZodString;
+  variant: z.ZodDefault<z.ZodEnum<{
+    default: "default";
+    success: "success";
+    note: "note";
+    tip: "tip";
+    caution: "caution";
+    danger: "danger";
+  }>>;
+  class: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>, z.ZodTransform<{
+  text: string;
+  variant: "default" | "success" | "note" | "tip" | "caution" | "danger";
+  class?: string | undefined;
+}, string | {
+  text: string;
+  variant: "default" | "success" | "note" | "tip" | "caution" | "danger";
+  class?: string | undefined;
+}>>>;
+type I18nBadgeUserConfig = string | {
+  variant?: 'note' | 'danger' | 'success' | 'caution' | 'tip' | 'default' | undefined;
+  class?: string | undefined;
+  text: string | Record<string, string>;
+} | undefined;
+declare const I18nBadgeConfigSchema: () => z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+  text: z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+  variant: z.ZodDefault<z.ZodEnum<{
+    default: "default";
+    success: "success";
+    note: "note";
+    tip: "tip";
+    caution: "caution";
+    danger: "danger";
+  }>>;
+  class: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>]>>;
+type Badge = z.output<typeof badgeSchema>;
+type I18nBadge = z.output<typeof i18nBadgeSchema>;
+type I18nBadgeConfig = z.output<ReturnType<typeof I18nBadgeConfigSchema>>;
+//#endregion
+export { Badge, BadgeComponentProps, BadgeComponentSchema, BadgeConfigSchema, I18nBadge, I18nBadgeConfig, I18nBadgeConfigSchema, I18nBadgeUserConfig };

package/dist/schemas/badge.js

@@ -0,0 +1,39 @@
+import { z } from "astro/zod";
+//#region src/schemas/badge.ts
+const badgeBaseSchema = z.object({
+	variant: z.enum([
+		"note",
+		"danger",
+		"success",
+		"caution",
+		"tip",
+		"default"
+	]).default("default"),
+	class: z.string().optional()
+});
+const badgeSchema = z.object({
+	...badgeBaseSchema.shape,
+	text: z.string()
+});
+const i18nBadgeSchema = z.object({
+	...badgeBaseSchema.shape,
+	text: z.union([z.string(), z.record(z.string(), z.string())])
+});
+const BadgeComponentSchema = z.looseObject({
+	...badgeSchema.shape,
+	size: z.enum([
+		"small",
+		"medium",
+		"large"
+	]).default("small")
+});
+const BadgeConfigSchema = () => z.union([z.string(), badgeSchema]).transform((badge) => {
+	if (typeof badge === "string") return {
+		variant: "default",
+		text: badge
+	};
+	return badge;
+}).optional();
+const I18nBadgeConfigSchema = () => z.union([z.string(), i18nBadgeSchema]).optional();
+//#endregion
+export { BadgeComponentSchema, BadgeConfigSchema, I18nBadgeConfigSchema };