@astrojs/starlight@0.32.5

Patch Changes

• #3021 e3f881e Thanks @jsparkdev! - Updates Korean language support

• #3020 58e3e84 Thanks @ayoayco! - Add SourceHut social icon

• #3013 5b599dd Thanks @oluwatobiss! - Adds Substack icon to social links list

@astrojs/starlight@0.32.4

Patch Changes

• #2994 ca4ec8b Thanks @XREvo! - Fixes default ranking of merged indexes when using multi-site search

• #2969 4682c7a Thanks @webpro! - Add npm social icon

@astrojs/starlight-tailwind@3.0.1

Patch Changes

• #2991 b8a4800 Thanks @florian-lefebvre! - Adds support for @astrojs/tailwind v6

@astrojs/starlight@0.32.3

Patch Changes

• #2955 77b6a41 Thanks @trueberryless! - Adds 5 new icons: figma, sketch, vim, vscode, and zed.

• #2961 da57fab Thanks @ematipico! - Adds 1 new icon: jetbrains.

@astrojs/starlight-markdoc@0.3.0

Minor Changes

• #2931 10b93b3 Thanks @HiDeoo! - Adds support for the title, frame, and meta fence attributes to code blocks.

  These new optional attributes add support for Expressive Code text & line markers. The following example renders a code block using a terminal frame with a title:

  ```js {% title="editor.exe" frame="terminal" %}
  console.log('Hello, world!');
  ```

  Any other text or line markers should be specified using the meta fence attribute. For example, the following code block renders a code block using the diff syntax combined with the js language syntax highlighting and the markers text highlighted:

  ```diff {% meta="lang=js 'markers'" %}
    function thisIsJavaScript() {
      // This entire block gets highlighted as JavaScript,
      // and we can still add diff markers to it!
  -   console.log('Old code to be removed')
  +   console.log('New and shiny code!')
    }
  ```

  To learn more about all the available options, check out the Expressive Code documentation.

@astrojs/starlight@0.32.2

Patch Changes

• #2926 c0170fd Thanks @resoltico! - Adds Latvian language support

• #2918 790c000 Thanks @HiDeoo! - Fixes a trailing slash inconsistency in generated sidebar links when using the trailingSlash: 'ignore' Astro option (the default) between internal and auto-generated links. Starlight behavior for this configuration value is to use a trailing slash as many common hosting providers redirect to URLs with a trailing slash by default.

@astrojs/starlight@0.32.1

Patch Changes

• #2904 ec5ca59 Thanks @HiDeoo! - Fixes an issue preventing the use of rewrites.

@astrojs/starlight@0.32.0

Minor Changes

• #2390 f493361 Thanks @delucis! - Moves route data to Astro.locals instead of passing it down via component props

  ⚠️ Breaking change:
  Previously, all of Starlight’s templating components, including user or plugin overrides, had access to a data object for the current route via Astro.props.
  This data is now available as Astro.locals.starlightRoute instead.

  To update, refactor any component overrides you have:

  • Remove imports of @astrojs/starlight/props, which is now deprecated.
  • Update code that accesses Astro.props to use Astro.locals.starlightRoute instead.
  • Remove any spreading of {...Astro.props} into child components, which is no longer required.

  In the following example, a custom override for Starlight’s LastUpdated component is updated for the new style:

  ---
  import Default from '@astrojs/starlight/components/LastUpdated.astro';
  - import type { Props } from '@astrojs/starlight/props';
  
  - const { lastUpdated } = Astro.props;
  + const { lastUpdated } = Astro.locals.starlightRoute;
  
  const updatedThisYear = lastUpdated?.getFullYear() === new Date().getFullYear();
  ---
  
  {updatedThisYear && (
  -   <Default {...Astro.props}><slot /></Default>
  +   <Default><slot /></Default>
  )}

  Community Starlight plugins may also need to be manually updated to work with Starlight 0.32. If you encounter any issues, please reach out to the plugin author to see if it is a known issue or if an updated version is being worked on.

• #2578 f895f75 Thanks @HiDeoo! - Deprecates the Starlight plugin setup hook in favor of the new config:setup hook which provides the same functionality.

  ⚠️ BREAKING CHANGE:

  The Starlight plugin setup hook is now deprecated and will be removed in a future release. Please update your plugins to use the new config:setup hook instead.

  export default {
    name: 'plugin-with-translations',
    hooks: {
  -   'setup'({ config }) {
  +   'config:setup'({ config }) {
        // Your plugin configuration setup code
      },
    },
  };

• #2578 f895f75 Thanks @HiDeoo! - Exposes the built-in localization system in the Starlight plugin config:setup hook.

  ⚠️ BREAKING CHANGE:

  This addition changes how Starlight plugins add or update translation strings used in Starlight’s localization APIs.
  Plugins previously using the injectTranslations() callback function from the plugin config:setup hook should now use the same function available in the i18n:setup hook.

  export default {
    name: 'plugin-with-translations',
    hooks: {
  -   'config:setup'({ injectTranslations }) {
  +   'i18n:setup'({ injectTranslations }) {
        injectTranslations({
          en: {
            'myPlugin.doThing': 'Do the thing',
          },
          fr: {
            'myPlugin.doThing': 'Faire le truc',
          },
        });
      },
    },
  };

• #2858 2df9d05 Thanks @XREvo! - Adds support for Pagefind’s multisite search features

• #2578 f895f75 Thanks @HiDeoo! - Adds a new HookParameters utility type to get the type of a plugin hook’s arguments.

• #2578 f895f75 Thanks @HiDeoo! - Adds a new useTranslations() callback function to the Starlight plugin config:setup hook to generate a utility function to access UI strings for a given language.

• #2578 f895f75 Thanks @HiDeoo! - Adds a new absolutePathToLang() callback function to the Starlight plugin config:setup to get the language for a given absolute file path.

Patch Changes

• #2848 9b32ba9 Thanks @HiDeoo! - Fixes styling of filter and metadata elements in Pagefind search UI.

@astrojs/starlight-docsearch@0.6.0

Minor Changes

• #2578 f895f75 and #2390 f493361 Thanks @HiDeoo and @delucis!
  ⚠️ BREAKING CHANGE: The minimum supported version of Starlight is now 0.32.0

  Please use the @astrojs/upgrade command to upgrade your project:

  npx @astrojs/upgrade

@astrojs/starlight-docsearch@0.5.0

Minor Changes

• #2822 e56586a Thanks @KianNH! - Adds a new clientOptionsModule plugin option to support configuring unserializable DocSearch options such as resultsFooterComponent().

  See “DocSearch configuration” in the Starlight docs for more details.