fix: export lang types for use in custom component (#14071)

Grisoly · florian-lefebvre · web-flow · commit d2cb35d2b7ff · 2025-07-21T18:03:54.000+02:00
Co-authored-by: Florian Lefebvre &lt;contact@florian-lefebvre.dev&gt;
diff --git a/.changeset/clever-numbers-sink.md b/.changeset/clever-numbers-sink.md
@@ -0,0 +1,9 @@
+---
+'astro': patch
+---
+
+Exposes the `Code` component `lang` prop type:
+
+```ts
+import type { CodeLanguage } from "astro";
+```
diff --git a/packages/astro/components/Code.astro b/packages/astro/components/Code.astro
@@ -1,15 +1,9 @@
 ---
 import type { ThemePresets } from '@astrojs/markdown-remark';
-import type {
-	BuiltinLanguage,
-	LanguageRegistration,
-	ShikiTransformer,
-	SpecialLanguage,
-	ThemeRegistration,
-	ThemeRegistrationRaw,
-} from 'shiki';
+import type { ShikiTransformer, ThemeRegistration, ThemeRegistrationRaw } from 'shiki';
 import { bundledLanguages } from 'shiki/langs';
 import { getCachedHighlighter } from '../dist/core/shiki.js';
+import type { CodeLanguage } from '../dist/types/public';
 import type { HTMLAttributes } from '../types';
 
 interface Props extends Omit<HTMLAttributes<'pre'>, 'lang'> {
@@ -22,7 +16,7 @@ interface Props extends Omit<HTMLAttributes<'pre'>, 'lang'> {
 	 *
 	 * @default "plaintext"
 	 */
-	lang?: BuiltinLanguage | SpecialLanguage | LanguageRegistration;
+	lang?: CodeLanguage;
 	/**
 	 * A metastring to pass to the highlighter.
 	 * Allows passing information to transformers: https://shiki.style/guide/transformers#meta
diff --git a/packages/astro/src/types/public/common.ts b/packages/astro/src/types/public/common.ts
@@ -1,3 +1,4 @@
+import type { BundledLanguage, LanguageRegistration, SpecialLanguage } from 'shiki';
 import type { OmitIndexSignature, Simplify } from '../../type-utils.js';
 import type { APIContext } from './context.js';
 
@@ -180,3 +181,5 @@ export type InferGetStaticPropsType<T> = T extends (
 
 export type Params = Record<string, string | undefined>;
 export type Props = Record<string, unknown>;
+
+export type CodeLanguage = BundledLanguage | LanguageRegistration | SpecialLanguage;
