@astrojs/starlight 0.41.11 → 0.42.0

package/dist/schemas/sidebar.d.ts

@@ -0,0 +1,205 @@
+import { I18nBadgeUserConfig } from "./badge.js";
+import { z } from "astro/zod";
+import { AstroBuiltinAttributes } from "astro";
+import { HTMLAttributes } from "astro/types";
+//#region src/schemas/sidebar.d.ts
+interface SidebarBaseUserConfig {
+  /** The visible label for this item in the sidebar. */
+  label: string;
+  /** Translations of the `label` for each supported language. */
+  translations?: Record<string, string> | undefined;
+  /** Adds a badge to the item */
+  badge?: I18nBadgeUserConfig;
+}
+interface SidebarGroupUserConfig extends SidebarBaseUserConfig {
+  /**
+   * Explicitly prevent custom attributes on groups as the final type for supported sidebar item
+   * is a non-discriminated union where TypeScript will not perform excess property checks.
+   * This means that a user could define a sidebar group with custom attributes, not getting a
+   * TypeScript error, and only have it fail at runtime.
+   * @see https://github.com/microsoft/TypeScript/issues/20863
+   */
+  attrs?: undefined;
+  /** Whether this item should be collapsed by default. */
+  collapsed?: boolean | undefined;
+}
+declare const SidebarGroupSchema: z.ZodObject<{
+  attrs: z.ZodOptional<z.ZodNever>;
+  collapsed: z.ZodDefault<z.ZodBoolean>;
+  label: z.ZodString;
+  translations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  badge: 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>]>>;
+}, z.core.$strip>;
+type LinkHTMLAttributes = Omit<HTMLAttributes<'a'>, keyof AstroBuiltinAttributes | 'children'>;
+declare const SidebarLinkItemHTMLAttributesSchema: () => z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+interface SidebarLinkItemUserConfig extends SidebarBaseUserConfig {
+  /** The link to this item’s content. Can be a relative link to local files or the full URL of an external page. */
+  link: string;
+  /** HTML attributes to add to the link item. */
+  attrs?: LinkHTMLAttributes | undefined;
+}
+declare const SidebarLinkItemSchema: z.ZodObject<{
+  link: z.ZodString;
+  attrs: z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+  label: z.ZodString;
+  translations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  badge: 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>]>>;
+}, z.core.$strict>;
+type SidebarLinkItem = z.infer<typeof SidebarLinkItemSchema>;
+interface AutoSidebarEntriesUserConfig {
+  /**
+   * Explicitly prevent autogenerated groups which are no longer supported as the final type for
+   * supported sidebar item is a non-discriminated union where TypeScript will not perform excess
+   * property checks. This means that a user could define a sidebar group with an autogenerated
+   * property, not getting a TypeScript error, and only have it fail at runtime.
+   * @see https://github.com/microsoft/TypeScript/issues/20863
+   */
+  label?: undefined;
+  /** Enable autogenerating entries from a specific docs directory. */
+  autogenerate: {
+    /** The directory to generate sidebar items for. */
+    directory: string;
+    /** Whether autogenerated subgroups should be collapsed. Default: `false`. */
+    collapsed?: boolean | undefined;
+    /** HTML attributes to add to autogenerated link items. */
+    attrs?: LinkHTMLAttributes | undefined;
+  };
+}
+declare const AutoSidebarEntriesSchema: z.ZodObject<{
+  label: z.ZodOptional<z.ZodCustom<never, never>>;
+  autogenerate: z.ZodObject<{
+    directory: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    collapsed: z.ZodOptional<z.ZodBoolean>;
+    attrs: z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+  }, z.core.$strip>;
+}, z.core.$strict>;
+type AutoSidebarEntries = z.infer<typeof AutoSidebarEntriesSchema>;
+type ManualSidebarGroupInput = z.input<typeof SidebarGroupSchema> & {
+  /** Array of links and subcategories to display in this category. */
+  items: Array<z.input<typeof SidebarLinkItemSchema> | z.input<typeof AutoSidebarEntriesSchema> | z.input<typeof InternalSidebarLinkItemSchema> | z.input<typeof InternalSidebarLinkItemShorthandSchema> | ManualSidebarGroupInput>;
+};
+type ManualSidebarGroupOutput = z.output<typeof SidebarGroupSchema> & {
+  /** Array of links and subcategories to display in this category. */
+  items: Array<z.output<typeof SidebarLinkItemSchema> | z.output<typeof AutoSidebarEntriesSchema> | z.output<typeof InternalSidebarLinkItemSchema> | z.output<typeof InternalSidebarLinkItemShorthandSchema> | ManualSidebarGroupOutput>;
+};
+type ManualSidebarGroupUserConfig = SidebarGroupUserConfig & {
+  /** Array of links and subcategories to display in this category. */
+  items: SidebarItemUserConfig[];
+};
+interface InternalSidebarLinkItemUserConfig extends Omit<SidebarBaseUserConfig, 'label'> {
+  /** The visible label for this item in the sidebar. */
+  label?: SidebarBaseUserConfig['label'] | undefined;
+  /** The link to this item’s content. Must be a slug of a Content Collection entry. */
+  slug: string;
+  /** HTML attributes to add to the link item. */
+  attrs?: LinkHTMLAttributes | undefined;
+}
+declare const InternalSidebarLinkItemSchema: z.ZodObject<{
+  slug: z.ZodString;
+  attrs: z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+  label: z.ZodOptional<z.ZodString>;
+  translations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  badge: 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>]>>;
+}, z.core.$strip>;
+type InternalSidebarLinkItemShorthandUserConfig = string;
+declare const InternalSidebarLinkItemShorthandSchema: z.ZodPipe<z.ZodString, z.ZodTransform<{
+  slug: string;
+  attrs: LinkHTMLAttributes;
+  translations: Record<string, string>;
+  label?: string | undefined;
+  badge?: string | {
+    text: string | Record<string, string>;
+    variant: "default" | "success" | "note" | "tip" | "caution" | "danger";
+    class?: string | undefined;
+  } | undefined;
+}, string>>;
+type InternalSidebarLinkItem = z.output<typeof InternalSidebarLinkItemSchema>;
+type SidebarItemUserConfig = SidebarLinkItemUserConfig | ManualSidebarGroupUserConfig | AutoSidebarEntriesUserConfig | InternalSidebarLinkItemUserConfig | InternalSidebarLinkItemShorthandUserConfig;
+declare const SidebarItemSchema: z.ZodUnion<readonly [z.ZodObject<{
+  link: z.ZodString;
+  attrs: z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+  label: z.ZodString;
+  translations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  badge: 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>]>>;
+}, z.core.$strict>, z.ZodType<ManualSidebarGroupOutput, ManualSidebarGroupInput, z.core.$ZodTypeInternals<ManualSidebarGroupOutput, ManualSidebarGroupInput>>, z.ZodObject<{
+  label: z.ZodOptional<z.ZodCustom<never, never>>;
+  autogenerate: z.ZodObject<{
+    directory: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+    collapsed: z.ZodOptional<z.ZodBoolean>;
+    attrs: z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+  }, z.core.$strip>;
+}, z.core.$strict>, z.ZodObject<{
+  slug: z.ZodString;
+  attrs: z.ZodDefault<z.ZodType<LinkHTMLAttributes, LinkHTMLAttributes, z.core.$ZodTypeInternals<LinkHTMLAttributes, LinkHTMLAttributes>>>;
+  label: z.ZodOptional<z.ZodString>;
+  translations: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodString>>;
+  badge: 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>]>>;
+}, z.core.$strip>, z.ZodPipe<z.ZodString, z.ZodTransform<{
+  slug: string;
+  attrs: LinkHTMLAttributes;
+  translations: Record<string, string>;
+  label?: string | undefined;
+  badge?: string | {
+    text: string | Record<string, string>;
+    variant: "default" | "success" | "note" | "tip" | "caution" | "danger";
+    class?: string | undefined;
+  } | undefined;
+}, string>>]>;
+type SidebarItem = z.infer<typeof SidebarItemSchema>;
+//#endregion
+export { AutoSidebarEntries, InternalSidebarLinkItem, LinkHTMLAttributes, SidebarItem, SidebarItemSchema, SidebarItemUserConfig, SidebarLinkItem, SidebarLinkItemHTMLAttributesSchema };

package/dist/schemas/sidebar.js

@@ -0,0 +1,71 @@
+import { stripLeadingAndTrailingSlashes } from "../utils/path.js";
+import { I18nBadgeConfigSchema } from "./badge.js";
+import { z } from "astro/zod";
+//#region src/schemas/sidebar.ts
+const SidebarBaseSchema = z.object({
+	label: z.string(),
+	translations: z.record(z.string(), z.string()).default({}),
+	badge: I18nBadgeConfigSchema()
+});
+const SidebarGroupSchema = z.object({
+	...SidebarBaseSchema.shape,
+	attrs: z.never().optional(),
+	collapsed: z.boolean().default(false)
+});
+const linkHTMLAttributesSchema = z.record(z.string(), z.union([
+	z.string(),
+	z.number(),
+	z.boolean(),
+	z.undefined(),
+	z.null()
+]));
+const SidebarLinkItemHTMLAttributesSchema = () => linkHTMLAttributesSchema.default({});
+const SidebarLinkItemSchema = z.strictObject({
+	...SidebarBaseSchema.shape,
+	link: z.string(),
+	attrs: SidebarLinkItemHTMLAttributesSchema()
+});
+const AutoSidebarEntriesSchema = z.object({
+	label: z.custom().optional(),
+	autogenerate: z.object({
+		directory: z.string().transform(stripLeadingAndTrailingSlashes),
+		collapsed: z.boolean().optional(),
+		attrs: SidebarLinkItemHTMLAttributesSchema()
+	})
+}).strict().superRefine((config, ctx) => {
+	if (!("label" in config)) return;
+	ctx.addIssue({
+		code: "custom",
+		message: `Found an \`autogenerate\` object with a \`label\`. Support for autogenerated sidebar groups was removed in Starlight v0.39.0.
+You should instead create a group with the desired \`label\` and an \`items\` array containing the autogenerate config:
+
+{
+  label: '${config.label}',\n  items: [{ autogenerate: ${JSON.stringify(config.autogenerate, (key, value) => key === "attrs" && typeof value === "object" && value !== null && Object.keys(value).length === 0 ? void 0 : value, " ").replace(/\n\s*/g, " ")} }]\n}`
+	});
+});
+const ManualSidebarGroupSchema = z.strictObject({
+	...SidebarGroupSchema.shape,
+	/** Array of links and subcategories to display in this category. */
+	items: z.lazy(() => z.union([
+		SidebarLinkItemSchema,
+		ManualSidebarGroupSchema,
+		AutoSidebarEntriesSchema,
+		InternalSidebarLinkItemSchema,
+		InternalSidebarLinkItemShorthandSchema
+	]).array())
+});
+const InternalSidebarLinkItemSchema = z.object({
+	...SidebarBaseSchema.partial({ label: true }).shape,
+	slug: z.string(),
+	attrs: SidebarLinkItemHTMLAttributesSchema()
+});
+const InternalSidebarLinkItemShorthandSchema = z.string().transform((slug) => InternalSidebarLinkItemSchema.parse({ slug }));
+const SidebarItemSchema = z.union([
+	SidebarLinkItemSchema,
+	ManualSidebarGroupSchema,
+	AutoSidebarEntriesSchema,
+	InternalSidebarLinkItemSchema,
+	InternalSidebarLinkItemShorthandSchema
+]);
+//#endregion
+export { SidebarItemSchema, SidebarLinkItemHTMLAttributesSchema };

package/dist/schemas/site-title.d.ts

@@ -0,0 +1,7 @@
+import { z } from "astro/zod";
+//#region src/schemas/site-title.d.ts
+type TitleUserConfig = string | Record<string, string>;
+declare const TitleConfigSchema: () => z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>;
+declare const TitleTransformConfigSchema: (defaultLang: string) => z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodRecord<z.ZodString, z.ZodString>]>, z.ZodTransform<Record<string, string>, string | Record<string, string>>>;
+//#endregion
+export { TitleConfigSchema, TitleTransformConfigSchema, TitleUserConfig };

package/dist/schemas/site-title.js

@@ -0,0 +1,17 @@
+import { z } from "astro/zod";
+//#region src/schemas/site-title.ts
+const TitleConfigSchema = () => z.union([z.string(), z.record(z.string(), z.string())]);
+const TitleTransformConfigSchema = (defaultLang) => TitleConfigSchema().transform((title, ctx) => {
+	if (typeof title === "string") return { [defaultLang]: title };
+	if (!title[defaultLang] && title[defaultLang] !== "") {
+		ctx.issues.push({
+			code: "custom",
+			message: `Title must have a key for the default language "${defaultLang}"`,
+			input: title
+		});
+		return z.NEVER;
+	}
+	return title;
+});
+//#endregion
+export { TitleConfigSchema, TitleTransformConfigSchema };

package/dist/schemas/social.d.ts

@@ -0,0 +1,292 @@
+import { IconUserConfig } from "./icon.js";
+import { z } from "astro/zod";
+//#region src/schemas/social.d.ts
+type SocialLinksUserConfig = {
+  icon: IconUserConfig;
+  label: string;
+  href: string;
+}[] | undefined;
+declare const LinksSchema: z.ZodOptional<z.ZodArray<z.ZodObject<{
+  icon: 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";
+  }>;
+  label: z.ZodString;
+  href: z.ZodString;
+}, z.core.$strip>>>;
+declare const SocialLinksSchema: () => typeof LinksSchema;
+//#endregion
+export { SocialLinksSchema, SocialLinksUserConfig };

package/dist/schemas/social.js

@@ -0,0 +1,18 @@
+import { IconSchema } from "./icon.js";
+import { z } from "astro/zod";
+//#region src/schemas/social.ts
+const LinksSchema = z.object({
+	icon: IconSchema(),
+	label: z.string().min(1),
+	href: z.string()
+}).array().optional();
+const SocialLinksSchema = () => z.preprocess((value, ctx) => {
+	if (value && typeof value === "object" && !Array.isArray(value)) ctx.issues.push({
+		code: "custom",
+		message: "Starlight v0.33.0 changed the `social` configuration syntax. Please specify an array of link items instead of an object.\nSee the Starlight changelog for details: https://github.com/withastro/starlight/blob/main/packages/starlight/CHANGELOG.md#0330\n",
+		input: value
+	});
+	return value;
+}, LinksSchema);
+//#endregion
+export { SocialLinksSchema };

package/dist/schemas/tableOfContents.d.ts

@@ -0,0 +1,24 @@
+import { z } from "astro/zod";
+//#region src/schemas/tableOfContents.d.ts
+type TableOfContentsUserConfig = boolean | {
+  /** The level to start including headings at in the table of contents. Default: 2. */
+  minHeadingLevel?: number | undefined;
+  /** The level to stop including headings at in the table of contents. Default: 3. */
+  maxHeadingLevel?: number | undefined;
+} | undefined;
+declare const UserConfigTableOfContentsSchema: () => z.ZodDefault<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>>]>>;
+declare const FrontmatterTableOfContentsSchema: () => 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>>]>>;
+//#endregion
+export { FrontmatterTableOfContentsSchema, TableOfContentsUserConfig, UserConfigTableOfContentsSchema };

package/dist/schemas/tableOfContents.js

@@ -0,0 +1,16 @@
+import { z } from "astro/zod";
+//#region src/schemas/tableOfContents.ts
+const defaults = {
+	minHeadingLevel: 2,
+	maxHeadingLevel: 3
+};
+const TableOfContentsBaseSchema = z.union([z.object({
+	/** The level to start including headings at in the table of contents. Default: 2. */
+	minHeadingLevel: z.int().min(1).max(6).optional().default(2),
+	/** The level to stop including headings at in the table of contents. Default: 3. */
+	maxHeadingLevel: z.int().min(1).max(6).optional().default(3)
+}), z.boolean().transform((enabled) => enabled ? defaults : false)]).refine((toc) => toc ? toc.minHeadingLevel <= toc.maxHeadingLevel : true, { error: "minHeadingLevel must be less than or equal to maxHeadingLevel" });
+const UserConfigTableOfContentsSchema = () => TableOfContentsBaseSchema.default(defaults);
+const FrontmatterTableOfContentsSchema = () => TableOfContentsBaseSchema.optional();
+//#endregion
+export { FrontmatterTableOfContentsSchema, UserConfigTableOfContentsSchema };