@grove-dev/starlight 0.7.0 → 0.9.0

package/components/overrides/parts/toc/starlight-toc.ts

@@ -5,115 +5,113 @@
 import { PAGE_TITLE_ID } from '../../../../core/config/constants';
 
 export class StarlightTOC extends HTMLElement {
-    private _current = this.querySelector<HTMLAnchorElement>('a[aria-current="true"]');
-    private minH = Number.parseInt(this.dataset.minH || '2', 10);
-    private maxH = Number.parseInt(this.dataset.maxH || '3', 10);
+  private _current = this.querySelector<HTMLAnchorElement>('a[aria-current="true"]');
+  private minH = Number.parseInt(this.dataset.minH || '2', 10);
+  private maxH = Number.parseInt(this.dataset.maxH || '3', 10);
 
-    protected set current(link: HTMLAnchorElement) {
-        if (link === this._current) return;
-        if (this._current) this._current.removeAttribute('aria-current');
-        link.setAttribute('aria-current', 'true');
-        this._current = link;
-    }
+  protected set current(link: HTMLAnchorElement) {
+    if (link === this._current) return;
+    if (this._current) this._current.removeAttribute('aria-current');
+    link.setAttribute('aria-current', 'true');
+    this._current = link;
+  }
 
-    private onIdle = (cb: IdleRequestCallback) =>
-        (window.requestIdleCallback || ((cb) => setTimeout(cb, 1)))(cb);
+  private onIdle = (cb: IdleRequestCallback) =>
+    (window.requestIdleCallback || ((cb) => setTimeout(cb, 1)))(cb);
 
-    constructor() {
-        super();
-        this.onIdle(() => this.init());
-    }
+  constructor() {
+    super();
+    this.onIdle(() => this.init());
+  }
 
-    private init = (): void => {
-        /** All the links in the table of contents. */
-        const links = [...this.querySelectorAll('a')];
+  private init = (): void => {
+    /** All the links in the table of contents. */
+    const links = [...this.querySelectorAll('a')];
 
-        /** Test if an element is a table-of-contents heading. */
-        const isHeading = (el: Element): el is HTMLHeadingElement => {
-            if (el instanceof HTMLHeadingElement) {
-                // Special case for page title h1
-                if (el.id === PAGE_TITLE_ID) return true;
-                // Check the heading level is within the user-configured limits for the ToC
-                const level = el.tagName[1];
-                if (level) {
-                    const int = Number.parseInt(level, 10);
-                    if (int >= this.minH && int <= this.maxH) return true;
-                }
-            }
-            return false;
-        };
-
-        /** Walk up the DOM to find the nearest heading. */
-        const getElementHeading = (el: Element | null): HTMLHeadingElement | null => {
-            if (!el) return null;
-            const origin = el;
-            while (el) {
-                if (isHeading(el)) return el;
-                // Assign the previous sibling’s last, most deeply nested child to el.
-                el = el.previousElementSibling;
-                while (el?.lastElementChild) {
-                    el = el.lastElementChild;
-                }
-                // Look for headings amongst siblings.
-                const h = getElementHeading(el);
-                if (h) return h;
-            }
-            // Walk back up the parent.
-            return getElementHeading(origin.parentElement);
-        };
+    /** Test if an element is a table-of-contents heading. */
+    const isHeading = (el: Element): el is HTMLHeadingElement => {
+      if (el instanceof HTMLHeadingElement) {
+        // Special case for page title h1
+        if (el.id === PAGE_TITLE_ID) return true;
+        // Check the heading level is within the user-configured limits for the ToC
+        const level = el.tagName[1];
+        if (level) {
+          const int = Number.parseInt(level, 10);
+          if (int >= this.minH && int <= this.maxH) return true;
+        }
+      }
+      return false;
+    };
 
-        /** Handle intersections and set the current link to the heading for the current intersection. */
-        const setCurrent: IntersectionObserverCallback = (entries) => {
-            for (const { isIntersecting, target } of entries) {
-                if (!isIntersecting) continue;
-                const heading = getElementHeading(target);
-                if (!heading) continue;
-                const link = links.find(
-                    (link) => link.hash === `#${encodeURIComponent(heading.id)}`
-                );
-                if (link) {
-                    this.current = link;
-                    break;
-                }
-            }
-        };
+    /** Walk up the DOM to find the nearest heading. */
+    const getElementHeading = (el: Element | null): HTMLHeadingElement | null => {
+      if (!el) return null;
+      const origin = el;
+      while (el) {
+        if (isHeading(el)) return el;
+        // Assign the previous sibling’s last, most deeply nested child to el.
+        el = el.previousElementSibling;
+        while (el?.lastElementChild) {
+          el = el.lastElementChild;
+        }
+        // Look for headings amongst siblings.
+        const h = getElementHeading(el);
+        if (h) return h;
+      }
+      // Walk back up the parent.
+      return getElementHeading(origin.parentElement);
+    };
 
-        // Observe elements with an `id` (most likely headings) and their siblings.
-        // Also observe direct children of `.content` to include elements before
-        // the first heading.
-        const toObserve = document.querySelectorAll('main [id], main [id] ~ *, main .content > *');
+    /** Handle intersections and set the current link to the heading for the current intersection. */
+    const setCurrent: IntersectionObserverCallback = (entries) => {
+      for (const { isIntersecting, target } of entries) {
+        if (!isIntersecting) continue;
+        const heading = getElementHeading(target);
+        if (!heading) continue;
+        const link = links.find((link) => link.hash === `#${encodeURIComponent(heading.id)}`);
+        if (link) {
+          this.current = link;
+          break;
+        }
+      }
+    };
 
-        let observer: IntersectionObserver | undefined;
-        const observe = () => {
-            if (observer) return;
-            observer = new IntersectionObserver(setCurrent, { rootMargin: this.getRootMargin() });
-            toObserve.forEach((h) => observer!.observe(h));
-        };
-        observe();
+    // Observe elements with an `id` (most likely headings) and their siblings.
+    // Also observe direct children of `.content` to include elements before
+    // the first heading.
+    const toObserve = document.querySelectorAll('main [id], main [id] ~ *, main .content > *');
 
-        let timeout: NodeJS.Timeout;
-        window.addEventListener('resize', () => {
-            // Disable intersection observer while window is resizing.
-            if (observer) {
-                observer.disconnect();
-                observer = undefined;
-            }
-            clearTimeout(timeout);
-            timeout = setTimeout(() => this.onIdle(observe), 200);
-        });
+    let observer: IntersectionObserver | undefined;
+    const observe = () => {
+      if (observer) return;
+      observer = new IntersectionObserver(setCurrent, { rootMargin: this.getRootMargin() });
+      for (const h of toObserve) observer.observe(h);
     };
+    observe();
+
+    let timeout: NodeJS.Timeout;
+    window.addEventListener('resize', () => {
+      // Disable intersection observer while window is resizing.
+      if (observer) {
+        observer.disconnect();
+        observer = undefined;
+      }
+      clearTimeout(timeout);
+      timeout = setTimeout(() => this.onIdle(observe), 200);
+    });
+  };
 
-    private getRootMargin(): `-${number}px 0% ${number}px` {
-        const navBarHeight = document.querySelector('header')?.getBoundingClientRect().height || 0;
-        // `<summary>` only exists in mobile ToC, so will fall back to 0 in large viewport component.
-        const mobileTocHeight = this.querySelector('summary')?.getBoundingClientRect().height || 0;
-        /** Start intersections at nav height + 2rem padding. */
-        const top = navBarHeight + mobileTocHeight + 32;
-        /** End intersections `53px` later. This is slightly more than the maximum `margin-top` in Markdown content. */
-        const bottom = top + 53;
-        const height = document.documentElement.clientHeight;
-        return `-${top}px 0% ${bottom - height}px`;
-    }
+  private getRootMargin(): `-${number}px 0% ${number}px` {
+    const navBarHeight = document.querySelector('header')?.getBoundingClientRect().height || 0;
+    // `<summary>` only exists in mobile ToC, so will fall back to 0 in large viewport component.
+    const mobileTocHeight = this.querySelector('summary')?.getBoundingClientRect().height || 0;
+    /** Start intersections at nav height + 2rem padding. */
+    const top = navBarHeight + mobileTocHeight + 32;
+    /** End intersections `53px` later. This is slightly more than the maximum `margin-top` in Markdown content. */
+    const bottom = top + 53;
+    const height = document.documentElement.clientHeight;
+    return `-${top}px 0% ${bottom - height}px`;
+  }
 }
 
 customElements.define('starlight-toc', StarlightTOC);

package/core/config/docs-schema.ts

@@ -12,11 +12,11 @@ const LOADED = Symbol.for('@grove-dev/starlight.docs-schema-loaded');
 
 /** Called by `@grove-dev/starlight/schema` on import. */
 export function markDocsSchemaLoaded(): void {
-    (globalThis as Record<symbol, unknown>)[LOADED] = true;
+  (globalThis as Record<symbol, unknown>)[LOADED] = true;
 }
 
 export function isDocsSchemaExtended(): boolean {
-    return (globalThis as Record<symbol, unknown>)[LOADED] === true;
+  return (globalThis as Record<symbol, unknown>)[LOADED] === true;
 }
 
 let warned = false;
@@ -27,32 +27,32 @@ let warned = false;
  * several splash pages does not repeat the same advice once per page.
  */
 export function warnAboutMissingDocsSchemaOnce(
-    hero: unknown,
-    warn: (message: string) => void = console.warn
+  hero: unknown,
+  warn: (message: string) => void = console.warn,
 ): boolean {
-    if (warned || hero == null || isDocsSchemaExtended()) return false;
+  if (warned || hero == null || isDocsSchemaExtended()) return false;
 
-    warned = true;
-    warn(missingDocsSchemaWarning());
-    return true;
+  warned = true;
+  warn(missingDocsSchemaWarning());
+  return true;
 }
 
 /** Test seam: clears the once-per-process guard used by {@link warnAboutMissingDocsSchemaOnce}. */
 export function resetDocsSchemaWarning(): void {
-    warned = false;
+  warned = false;
 }
 
 /** The advice printed when the schema extension is missing. */
 export function missingDocsSchemaWarning(): string {
-    return [
-        '[@grove-dev/starlight] This page sets `hero` frontmatter, but the docs schema is not extended,',
-        "so Starlight is dropping the theme's hero fields. `hero.layout`, `hero.announcement` and the",
-        'extra `hero.actions[].variant` values have no effect until you extend it:',
-        '',
-        "    import { ExtendDocsSchema } from '@grove-dev/starlight/schema';",
-        '',
-        '    schema: docsSchema({ extend: ExtendDocsSchema }),',
-        '',
-        'See https://withgrove.dev/reference/plugin-api/#frontmatter-extension',
-    ].join('\n');
+  return [
+    '[@grove-dev/starlight] This page sets `hero` frontmatter, but the docs schema is not extended,',
+    "so Starlight is dropping the theme's hero fields. `hero.layout`, `hero.announcement` and the",
+    'extra `hero.actions[].variant` values have no effect until you extend it:',
+    '',
+    "    import { ExtendDocsSchema } from '@grove-dev/starlight/schema';",
+    '',
+    '    schema: docsSchema({ extend: ExtendDocsSchema }),',
+    '',
+    'See https://withgrove.dev/reference/plugin-api/#frontmatter-extension',
+  ].join('\n');
 }

package/core/config/expresive-code.ts

@@ -2,62 +2,60 @@ import type { StarlightExpressiveCodeOptions } from '@astrojs/starlight/expressi
 import type { StarlightUserConfig } from '@astrojs/starlight/types';
 
 const createInlineSvgUrl = (svgContents: string): string => {
-    const inlineSvg = svgContents.replace(
-        /^(\s*<svg)\s+([^>]+)\s*(\/?>)/,
-        (_match, tagStart: string, attributes: string, tagEnd: string) => {
-            const sanitizedAttributes = attributes.replaceAll(
-                /(?:width|height)\s*=\s*(?:(["'])[^"']*\1|\d+)\s*/g,
-                ''
-            );
+  const inlineSvg = svgContents.replace(
+    /^(\s*<svg)\s+([^>]+)\s*(\/?>)/,
+    (_match, tagStart: string, attributes: string, tagEnd: string) => {
+      const sanitizedAttributes = attributes.replaceAll(
+        /(?:width|height)\s*=\s*(?:(["'])[^"']*\1|\d+)\s*/g,
+        '',
+      );
 
-            return `${tagStart} ${sanitizedAttributes.trim()}${tagEnd}`;
-        }
-    );
+      return `${tagStart} ${sanitizedAttributes.trim()}${tagEnd}`;
+    },
+  );
 
-    return `url("data:image/svg+xml,${encodeURIComponent(inlineSvg)}")`;
+  return `url("data:image/svg+xml,${encodeURIComponent(inlineSvg)}")`;
 };
 
 export const expressiveCode = (
-    config: StarlightUserConfig
+  config: StarlightUserConfig,
 ): boolean | StarlightExpressiveCodeOptions => {
-    const userExpressiveCodeConfig =
-        config.expressiveCode === false || config.expressiveCode === true
-            ? {}
-            : config.expressiveCode;
+  const userExpressiveCodeConfig =
+    config.expressiveCode === false || config.expressiveCode === true ? {} : config.expressiveCode;
 
-    return config.expressiveCode === false
-        ? false
-        : {
-              themes: ['github-dark-default', 'github-light-default'],
-              ...userExpressiveCodeConfig,
-              styleOverrides: {
-                  codeBackground: 'var(--code-background)',
-                  borderWidth: '0px',
-                  borderRadius: 'calc(var(--radius) + 4px)',
-                  gutterBorderWidth: '0px',
-                  ...userExpressiveCodeConfig?.styleOverrides,
-                  frames: {
-                      editorBackground: 'var(--code-background)',
-                      editorActiveTabBackground: 'var(--gray-5)',
-                      editorActiveTabForeground: 'var(--foreground)',
-                      editorTabBarBackground: 'var(--gray-6)',
-                      editorTabBarBorderColor: 'var(--border)',
-                      editorTabBarBorderBottomColor: 'var(--border)',
-                      terminalBackground: 'var(--code-background)',
-                      terminalTitlebarBackground: 'var(--gray-6)',
-                      terminalTitlebarBorderBottomColor: 'var(--border)',
-                      terminalTitlebarForeground: 'var(--muted-foreground)',
-                      shadowColor: 'transparent',
-                      copyIcon: createInlineSvgUrl(
-                          `<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-clipboard"><rect width="8" height="4" x="8" y="2" rx="1" ry="1"></rect><path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"></path></svg>`
-                      ),
-                      ...userExpressiveCodeConfig?.styleOverrides?.frames,
-                  },
-                  textMarkers: {
-                      markBackground: 'var(--mark-background)',
-                      markBorderColor: 'var(--border)',
-                      ...userExpressiveCodeConfig?.styleOverrides?.textMarkers,
-                  },
-              },
-          };
+  return config.expressiveCode === false
+    ? false
+    : {
+        themes: ['github-dark-default', 'github-light-default'],
+        ...userExpressiveCodeConfig,
+        styleOverrides: {
+          codeBackground: 'var(--code-background)',
+          borderWidth: '0px',
+          borderRadius: 'calc(var(--radius) + 4px)',
+          gutterBorderWidth: '0px',
+          ...userExpressiveCodeConfig?.styleOverrides,
+          frames: {
+            editorBackground: 'var(--code-background)',
+            editorActiveTabBackground: 'var(--gray-5)',
+            editorActiveTabForeground: 'var(--foreground)',
+            editorTabBarBackground: 'var(--gray-6)',
+            editorTabBarBorderColor: 'var(--border)',
+            editorTabBarBorderBottomColor: 'var(--border)',
+            terminalBackground: 'var(--code-background)',
+            terminalTitlebarBackground: 'var(--gray-6)',
+            terminalTitlebarBorderBottomColor: 'var(--border)',
+            terminalTitlebarForeground: 'var(--muted-foreground)',
+            shadowColor: 'transparent',
+            copyIcon: createInlineSvgUrl(
+              `<svg xmlns="http://www.w3.org/2000/svg" width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-clipboard"><rect width="8" height="4" x="8" y="2" rx="1" ry="1"></rect><path d="M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"></path></svg>`,
+            ),
+            ...userExpressiveCodeConfig?.styleOverrides?.frames,
+          },
+          textMarkers: {
+            markBackground: 'var(--mark-background)',
+            markBorderColor: 'var(--border)',
+            ...userExpressiveCodeConfig?.styleOverrides?.textMarkers,
+          },
+        },
+      };
 };

package/core/config/override.ts

@@ -6,47 +6,47 @@ type StarlightUserConfig = HookParameters<'config:setup'>['config'];
 type ComponentOverride = keyof NonNullable<StarlightUserConfig['components']>;
 
 export const COMPONENT_OVERRIDES: ComponentOverride[] = [
-    'ThemeSelect',
-    'PageFrame',
-    'Header',
-    'SiteTitle',
-    'Sidebar',
-    'TwoColumnContent',
-    'ContentPanel',
-    'PageTitle',
-    'MarkdownContent',
-    'Hero',
-    'Footer',
-    'SocialIcons',
-    'Pagination',
-    'Search',
-    'TableOfContents',
-    'PageSidebar',
+  'ThemeSelect',
+  'PageFrame',
+  'Header',
+  'SiteTitle',
+  'Sidebar',
+  'TwoColumnContent',
+  'ContentPanel',
+  'PageTitle',
+  'MarkdownContent',
+  'Hero',
+  'Footer',
+  'SocialIcons',
+  'Pagination',
+  'Search',
+  'TableOfContents',
+  'PageSidebar',
 ];
 
 export function override(
-    starlightConfig: StarlightUserConfig,
-    pluginConfig: GroveStarlightConfig,
-    overrides: ComponentOverride[],
-    logger: AstroIntegrationLogger
+  starlightConfig: StarlightUserConfig,
+  pluginConfig: GroveStarlightConfig,
+  overrides: ComponentOverride[],
+  logger: AstroIntegrationLogger,
 ): StarlightUserConfig['components'] {
-    const components = { ...starlightConfig.components };
-    for (const override of overrides) {
-        if (starlightConfig.components?.[override] != null) {
-            const fallback = `@grove-dev/starlight/components/overrides/${override}.astro`;
+  const components = { ...starlightConfig.components };
+  for (const override of overrides) {
+    if (starlightConfig.components?.[override] != null) {
+      const fallback = `@grove-dev/starlight/components/overrides/${override}.astro`;
 
-            if (pluginConfig.warnOverrides) {
-                logger.warn(
-                    `A \`<${override}>\` component override is already defined in your Starlight configuration.`
-                );
-                logger.warn(
-                    `To use \`@grove-dev/starlight/components\`, either remove this override or manually render the content from \`${fallback}\`.`
-                );
-            }
-            continue;
-        }
-        components[override] = `@grove-dev/starlight/components/overrides/${override}.astro`;
+      if (pluginConfig.warnOverrides) {
+        logger.warn(
+          `A \`<${override}>\` component override is already defined in your Starlight configuration.`,
+        );
+        logger.warn(
+          `To use \`@grove-dev/starlight/components\`, either remove this override or manually render the content from \`${fallback}\`.`,
+        );
+      }
+      continue;
     }
+    components[override] = `@grove-dev/starlight/components/overrides/${override}.astro`;
+  }
 
-    return components;
+  return components;
 }

package/core/config/schemas.ts

@@ -3,75 +3,75 @@ import type { HTMLAttributes } from 'astro/types';
 import { z } from 'astro/zod';
 
 const linkHTMLAttributesSchema = z.record(
-    z.string(),
-    z.union([z.string(), z.number(), z.boolean(), z.undefined()])
+  z.string(),
+  z.union([z.string(), z.number(), z.boolean(), z.undefined()]),
 ) as z.Schema<Omit<HTMLAttributes<'a'>, keyof AstroBuiltinAttributes | 'children'>>;
 
 const LinkItemHTMLAttributesSchema = () => linkHTMLAttributesSchema.default({});
 
 export const linkSchema = z.object({
-    /**
-     * An optional badge to display next to the topic label.
-     *
-     * This option accepts the same configuration as the Starlight badge sidebar item configuration.
-     * @see https://starlight.astro.build/guides/sidebar/#badges
-     */
-    badge: z.string().optional(),
-    /**
-     * The link label.
-     *
-     * - A string used as the default-locale label (pair with `translations` for other languages).
-     * - Or a locale map keyed by BCP-47 tags / locale paths (e.g. `en`, `es`).
-     *
-     * @see https://starlight.astro.build/guides/sidebar/#internationalization
-     */
-    label: z.union([z.string(), z.record(z.string(), z.string())]),
-    /**
-     * Optional labels for other languages when `label` is a string.
-     * Keys should be BCP-47 tags (e.g. `en`, `es`), matching Starlight sidebar translations.
-     *
-     * @see https://starlight.astro.build/guides/sidebar/#internationalization
-     */
-    translations: z.record(z.string(), z.string()).optional(),
-    /**
-     * The link to the topic’s content which an be a relative link to local files or the full URL of an external page.
-     *
-     * For internal links, the link can either be a page included in the items array or a different page acting as the
-     * topic’s landing page.
-     */
-    link: z.string(),
-    /** HTML attributes to add to the link item. */
-    attrs: LinkItemHTMLAttributesSchema().optional(),
+  /**
+   * An optional badge to display next to the topic label.
+   *
+   * This option accepts the same configuration as the Starlight badge sidebar item configuration.
+   * @see https://starlight.astro.build/guides/sidebar/#badges
+   */
+  badge: z.string().optional(),
+  /**
+   * The link label.
+   *
+   * - A string used as the default-locale label (pair with `translations` for other languages).
+   * - Or a locale map keyed by BCP-47 tags / locale paths (e.g. `en`, `es`).
+   *
+   * @see https://starlight.astro.build/guides/sidebar/#internationalization
+   */
+  label: z.union([z.string(), z.record(z.string(), z.string())]),
+  /**
+   * Optional labels for other languages when `label` is a string.
+   * Keys should be BCP-47 tags (e.g. `en`, `es`), matching Starlight sidebar translations.
+   *
+   * @see https://starlight.astro.build/guides/sidebar/#internationalization
+   */
+  translations: z.record(z.string(), z.string()).optional(),
+  /**
+   * The link to the topic’s content which an be a relative link to local files or the full URL of an external page.
+   *
+   * For internal links, the link can either be a page included in the items array or a different page acting as the
+   * topic’s landing page.
+   */
+  link: z.string(),
+  /** HTML attributes to add to the link item. */
+  attrs: LinkItemHTMLAttributesSchema().optional(),
 });
 
 export type Link = z.infer<typeof linkSchema>;
 
 export const GroveStarlightConfigSchema = z.object({
-    /** Array of navigation links for the header/nav bar. */
-    navLinks: z.array(linkSchema).optional(),
-    docs: z
-        .object({
-            includeAiUtilities: z.boolean().optional().default(false),
-        })
-        .optional()
-        .default({ includeAiUtilities: false }),
-    /**
-     * Whether to warn when a component override defined in your Starlight configuration prevents
-     * the theme from applying its own. Set to `false` to silence those warnings.
-     */
-    warnOverrides: z.boolean().optional().default(true),
-    /**
-     * Footer Markdown text. Can be a string, or for multilingual sites an object with values for
-     * each locale. Keys may be BCP-47 tags (e.g. `en`, `es`) or locale paths.
-     *
-     * @see https://starlight.astro.build/reference/configuration/#title
-     */
-    footerText: z
-        .union([z.string(), z.record(z.string(), z.string())])
-        .optional()
-        .default(
-            'Inspired by the [shadcn/ui](https://ui.shadcn.com/) documentation theme and based on [starlight-theme-black](https://github.com/adrian-ub/starlight-theme-black). Originally forked from [lucas-labs/lucode-starlight-theme](https://github.com/lucas-labs/lucode-starlight-theme) and maintained by [grove](https://github.com/tortuvshin/grove).'
-        ),
+  /** Array of navigation links for the header/nav bar. */
+  navLinks: z.array(linkSchema).optional(),
+  docs: z
+    .object({
+      includeAiUtilities: z.boolean().optional().default(false),
+    })
+    .optional()
+    .default({ includeAiUtilities: false }),
+  /**
+   * Whether to warn when a component override defined in your Starlight configuration prevents
+   * the theme from applying its own. Set to `false` to silence those warnings.
+   */
+  warnOverrides: z.boolean().optional().default(true),
+  /**
+   * Footer Markdown text. Can be a string, or for multilingual sites an object with values for
+   * each locale. Keys may be BCP-47 tags (e.g. `en`, `es`) or locale paths.
+   *
+   * @see https://starlight.astro.build/reference/configuration/#title
+   */
+  footerText: z
+    .union([z.string(), z.record(z.string(), z.string())])
+    .optional()
+    .default(
+      'Inspired by the [shadcn/ui](https://ui.shadcn.com/) documentation theme and based on [starlight-theme-black](https://github.com/adrian-ub/starlight-theme-black). Originally forked from [lucas-labs/lucode-starlight-theme](https://github.com/lucas-labs/lucode-starlight-theme) and maintained by [grove](https://github.com/tortuvshin/grove).',
+    ),
 });
 
 export type GroveStarlightUserConfig = z.input<typeof GroveStarlightConfigSchema>;