react-shiki 0.10.1 → 0.11.1

package/dist/{component-CYq7SnJ0.mjs → component-Cf8Topxy.mjs}

@@ -1,4 +1,4 @@
-import './style.css';
+import * as React from "react";
 import { forwardRef, useEffect, useMemo, useRef, useState } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { toJsxRuntime } from "hast-util-to-jsx-runtime";
@@ -36,36 +36,103 @@ const throttleHighlighting = (performHighlight, timeoutControl, throttleMs) => {
 	}, delay);
 };
 //#endregion
+//#region src/styles/component.css?inline
+var component_default = ":where(.rs-root){position:relative}:where(.rs-root.rs-default-styles pre){border-radius:.5rem;padding-block:1.25rem;padding-inline:1.5rem;overflow:auto}:where(.rs-root .rs-language-label){z-index:1;letter-spacing:-.05em;color:#6b7280d9;font-family:monospace;font-size:.75rem;position:absolute;top:.5rem;right:.75rem}\n";
+//#endregion
+//#region src/styles/features.css?inline
+var features_default = ":where(.rs-has-line-numbers){counter-reset:line-number calc(var(--line-start,1) - 1)}:where(.rs-has-line-numbers .rs-line-number):before{counter-increment:line-number;content:counter(line-number);box-sizing:content-box;min-width:var(--rs-line-numbers-width,2ch);padding-left:var(--rs-line-numbers-padding-left,0ch);padding-right:var(--rs-line-numbers-padding-right,2ch);color:var(--rs-line-numbers-foreground,#6b728080);font-size:var(--rs-line-numbers-font-size,inherit);font-weight:var(--rs-line-numbers-font-weight,inherit);line-height:var(--rs-line-numbers-line-height,inherit);font-family:var(--rs-line-numbers-font-family,inherit);opacity:var(--rs-line-numbers-opacity,1);user-select:none;pointer-events:none;justify-content:flex-end;align-items:flex-start;display:inline-flex}:where(.rs-has-highlighted-lines){width:fit-content;min-width:100%;display:block}:where(.rs-highlighted-line){--_rs-hl-background:var(--rs-highlighted-line-background,color-mix(in srgb, currentColor 10%, transparent));background-color:var(--_rs-hl-background);width:100%;min-height:1lh;display:inline-block}:where(.rs-default-styles .rs-highlighted-line){border-image:linear-gradient(var(--_rs-hl-background) 0 0) fill 0 / 0 / 0 100vw;background-color:#0000}:where(.rs-has-line-numbers .rs-highlighted-line):before{color:var(--rs-highlighted-line-number-foreground,color-mix(in srgb, currentColor 65%, transparent))}\n";
+//#endregion
+//#region src/lib/styles.ts
+const injected = /* @__PURE__ */ new Set();
+const useStyleInsertionEffect = React.useInsertionEffect ?? React.useLayoutEffect;
+const inject = (css, key) => {
+	if (injected.has(key) || typeof document === "undefined") return;
+	injected.add(key);
+	try {
+		const sheet = new CSSStyleSheet();
+		sheet.replaceSync(css);
+		document.adoptedStyleSheets = [...document.adoptedStyleSheets, sheet];
+	} catch {
+		const style = document.createElement("style");
+		style.dataset.reactShiki = key;
+		style.textContent = css;
+		document.head.append(style);
+	}
+};
+/** Installs component styles before layout without triggering a render. */
+const useComponentStyles = () => {
+	useStyleInsertionEffect(() => {
+		inject(component_default, "component");
+	}, []);
+};
+/** Installs line-number/highlight styles only when those options are used. */
+const useFeatureStyles = (enabled) => {
+	useStyleInsertionEffect(() => {
+		if (enabled) inject(features_default, "features");
+	}, [enabled]);
+};
+//#endregion
 //#region src/lib/language.ts
 const FALLBACK_LANGUAGE = "plaintext";
-const getEmbeddedLanguages = (code, languageId, highlighter) => {
-	const bundled = highlighter.getBundledLanguages();
-	return guessEmbeddedLanguages(code, languageId).flatMap((language) => bundled[language] ?? []);
-};
 const toArray = (value) => value == null ? [] : Array.isArray(value) ? value : [value];
+const isDynamicLanguage = (lang) => typeof lang === "function" || lang instanceof Promise || Array.isArray(lang) || typeof lang === "object" && lang != null && "default" in lang;
+const isRegistration = (lang) => typeof lang === "object" && lang != null && !isDynamicLanguage(lang);
+/** Dedupe identity: strings and registrations by value, dynamic inputs by reference */
 const languageKey = (lang) => {
 	if (lang == null) return null;
 	if (typeof lang === "string") return `s:${lang}`;
+	if (isDynamicLanguage(lang)) return lang;
 	return `o:${lang.name}::${lang.scopeName}`;
 };
 const dedupeLanguages = (langs) => {
 	const seen = /* @__PURE__ */ new Set();
-	const deduped = [];
-	for (const lang of langs) {
+	return langs.filter((lang) => {
 		const key = languageKey(lang);
-		if (key == null || seen.has(key)) continue;
+		if (key == null || seen.has(key)) return false;
 		seen.add(key);
-		deduped.push(lang);
-	}
-	return deduped;
+		return true;
+	});
+};
+/**
+* A registration matches a query by name, scopeName (full or its last
+* segment, e.g. "source.tsx" -> "tsx"), aliases, or fileTypes.
+*/
+const registrationMatches = (candidate, matches) => matches(candidate.name) || matches(candidate.scopeName) || matches(candidate.scopeName?.split(".").pop()) || !!candidate.aliases?.some(matches) || !!candidate.fileTypes?.some(matches);
+/**
+* Resolves the language prop to a shiki language id plus everything the
+* factory should load (primary, preloaded, and custom grammars, deduped).
+*/
+const resolveLanguage = (lang, customLanguages, langAliases, preloadLanguages) => {
+	const customLangs = toArray(customLanguages);
+	const preloadLangs = toArray(preloadLanguages);
+	const result = (languageId, primary) => ({
+		languageId,
+		langsToLoad: dedupeLanguages([
+			primary,
+			...preloadLangs,
+			...customLangs
+		])
+	});
+	if (lang == null || typeof lang === "string" && !lang.trim()) return result(FALLBACK_LANGUAGE);
+	if (typeof lang === "object") return result(lang.name, lang);
+	const normalized = lang.trim();
+	const query = normalized.toLowerCase();
+	const matches = (str) => str?.toLowerCase() === query;
+	const customMatch = [...customLangs, ...preloadLangs].filter(isRegistration).find((candidate) => registrationMatches(candidate, matches));
+	if (customMatch) return result(customMatch.name || normalized, customMatch);
+	const alias = Object.entries(langAliases ?? {}).find(([name]) => matches(name))?.[1];
+	if (alias) return result(alias, alias);
+	return result(normalized, normalized);
 };
 /**
 * Used in factories to check if language is supported.
-* Objects are validated as grammar registrations (name + scopeName).
+* Objects are validated as grammar registrations (name + scopeName);
+* dynamic imports pass through for shiki to resolve.
 */
 const isLoadableLanguage = (lang, bundledLanguages) => {
 	if (lang == null) return false;
 	if (typeof lang === "string") return lang in bundledLanguages;
+	if (isDynamicLanguage(lang)) return true;
 	return typeof lang.name === "string" && typeof lang.scopeName === "string";
 };
 /**
@@ -73,50 +140,9 @@ const isLoadableLanguage = (lang, bundledLanguages) => {
 * Falls back to "plaintext" if not supported.
 */
 const resolveLoadedLanguage = (languageId, loadedLanguages) => isSpecialLang(languageId) || loadedLanguages.includes(languageId) ? languageId : FALLBACK_LANGUAGE;
-/**
-* Resolves the language input to standardized IDs and objects for Shiki
-* @param lang The language input from props
-* @param customLanguages An array of custom textmate grammar objects or a single grammar object
-* @returns A LanguageResult object containing:
-*   - languageId: The resolved language ID
-*   - langsToLoad: The language objects/string ids to load
-*/
-const resolveLanguage = (lang, customLanguages, langAliases, preloadLanguages) => {
-	const customLangs = toArray(customLanguages);
-	const preloadLangs = toArray(preloadLanguages);
-	const customMatchPool = [...customLangs, ...preloadLangs];
-	let languageId = FALLBACK_LANGUAGE;
-	let primaryLang;
-	if (lang == null || typeof lang === "string" && !lang.trim()) return {
-		languageId,
-		langsToLoad: dedupeLanguages([...preloadLangs, ...customLangs])
-	};
-	if (typeof lang === "object") {
-		languageId = lang.name;
-		primaryLang = lang;
-	} else {
-		const lowerLang = lang.toLowerCase();
-		const matches = (str) => str?.toLowerCase() === lowerLang;
-		const customMatch = customMatchPool.find((candidate) => typeof candidate === "object" && candidate != null && !!(matches(candidate.name) || matches(candidate.scopeName) || matches(candidate.scopeName?.split(".").pop()) || candidate.aliases?.some(matches) || candidate.fileTypes?.some(matches)));
-		if (customMatch) {
-			languageId = customMatch.name || lang;
-			primaryLang = customMatch;
-		} else if (langAliases?.[lang]) {
-			languageId = langAliases[lang];
-			primaryLang = langAliases[lang];
-		} else {
-			languageId = lang;
-			primaryLang = lang;
-		}
-	}
-	return {
-		languageId,
-		langsToLoad: dedupeLanguages([
-			primaryLang,
-			...preloadLangs,
-			...customLangs
-		])
-	};
+const getEmbeddedLanguages = (code, languageId, highlighter) => {
+	const bundled = highlighter.getBundledLanguages();
+	return guessEmbeddedLanguages(code, languageId).flatMap((language) => bundled[language] ?? []);
 };
 //#endregion
 //#region src/lib/theme.ts
@@ -154,7 +180,33 @@ function resolveTheme(themeInput) {
 	};
 }
 //#endregion
+//#region src/lib/engine.ts
+const engines = /* @__PURE__ */ new Map();
+const loaders = {
+	javascript: () => import("shiki/engine/javascript").then((m) => m.createJavaScriptRegexEngine()),
+	oniguruma: () => import("shiki/engine/oniguruma").then((m) => m.createOnigurumaEngine(import("shiki/wasm")))
+};
+/**
+* Resolves a named engine to a lazily created, cached instance.
+* Engine instances and undefined pass through untouched.
+*
+* The cache makes named engines referentially stable across renders and
+* call sites, unlike inline `createJavaScriptRegexEngine()` calls.
+*/
+const resolveEngine = (engine) => {
+	if (typeof engine !== "string") return engine;
+	const load = loaders[engine];
+	if (!load) throw new Error(`[react-shiki] unknown engine '${engine}', expected 'javascript' or 'oniguruma'`);
+	const cached = engines.get(engine);
+	if (cached) return cached;
+	const instance = load();
+	instance.catch(() => engines.delete(engine));
+	engines.set(engine, instance);
+	return instance;
+};
+//#endregion
 //#region src/lib/transformers.ts
+const toLineNumberSet = (lineNumbers) => new Set(lineNumbers.filter(Number.isInteger));
 /**
 * Creates a transformer that enables line numbers display
 * @param startLine - The starting line number (defaults to 1)
@@ -165,11 +217,10 @@ function lineNumbersTransformer(startLine = 1) {
 		code(node) {
 			this.addClassToHast(node, "rs-has-line-numbers");
 			if (startLine !== 1) {
-				const existingStyle = node.properties?.style || "";
-				const newStyle = existingStyle ? `${existingStyle}; --line-start: ${startLine}` : `--line-start: ${startLine}`;
+				const existing = node.properties?.style;
 				node.properties = {
 					...node.properties,
-					style: newStyle
+					style: [existing, `--line-start: ${startLine}`].filter(Boolean).join("; ")
 				};
 			}
 		},
@@ -179,6 +230,25 @@ function lineNumbersTransformer(startLine = 1) {
 		}
 	};
 }
+/**
+* Creates a transformer that marks selected displayed line numbers.
+* @param lineNumbers - Displayed line numbers to highlight
+* @param startLine - The starting line number (defaults to 1)
+*/
+function highlightedLinesTransformer(lineNumbers, startLine = 1) {
+	const highlightedLines = toLineNumberSet(lineNumbers);
+	return {
+		name: "react-shiki:highlight-lines",
+		code(node) {
+			this.addClassToHast(node, "rs-has-highlighted-lines");
+		},
+		line(node, line) {
+			const displayedLine = startLine + line - 1;
+			if (highlightedLines.has(displayedLine)) this.addClassToHast(node, "rs-highlighted-line");
+			return node;
+		}
+	};
+}
 //#endregion
 //#region src/lib/options.ts
 const buildThemeOptions = (resolvedTheme, defaultColor, cssVariablePrefix) => {
@@ -190,9 +260,10 @@ const buildThemeOptions = (resolvedTheme, defaultColor, cssVariablePrefix) => {
 	return { theme: resolvedTheme.theme };
 };
 const buildShikiOptions = (languageId, resolvedTheme, options) => {
-	const { delay, customLanguages, preloadLanguages, outputFormat, highlighter, langAlias, engine, defaultColor, cssVariablePrefix, showLineNumbers, startingLineNumber, transformers: userTransformers, ...shikiPassthrough } = options;
+	const { delay, customLanguages, preloadLanguages, outputFormat, highlighter, langAlias, engine, defaultColor, cssVariablePrefix, showLineNumbers, startingLineNumber, highlightLineNumbers, transformers: userTransformers, ...shikiPassthrough } = options;
 	const transformers = [...userTransformers || []];
 	if (showLineNumbers) transformers.push(lineNumbersTransformer(startingLineNumber));
+	if (highlightLineNumbers?.length) transformers.push(highlightedLinesTransformer(highlightLineNumbers, startingLineNumber));
 	return {
 		lang: languageId,
 		...buildThemeOptions(resolvedTheme, defaultColor, cssVariablePrefix),
@@ -204,8 +275,9 @@ const buildShikiOptions = (languageId, resolvedTheme, options) => {
 //#region src/lib/hook.ts
 async function highlight(code, resolved, opts, factory) {
 	const { languageId, langsToLoad, themesToLoad, shikiOptions } = resolved;
+	const format = opts.outputFormat ?? "react";
 	const highlighter = opts.highlighter ?? await (async () => {
-		const hl = await factory(langsToLoad, themesToLoad, opts.engine);
+		const hl = await factory(langsToLoad, themesToLoad, resolveEngine(opts.engine));
 		await hl.loadLanguage(...getEmbeddedLanguages(code, languageId, hl));
 		return hl;
 	})();
@@ -214,14 +286,20 @@ async function highlight(code, resolved, opts, factory) {
 		...shikiOptions,
 		lang: language
 	};
-	return opts.outputFormat === "html" ? highlighter.codeToHtml(code, options) : toJsxRuntime(highlighter.codeToHast(code, options), {
-		jsx,
-		jsxs,
-		Fragment
-	});
+	const outputs = {
+		react: () => toJsxRuntime(highlighter.codeToHast(code, options), {
+			jsx,
+			jsxs,
+			Fragment
+		}),
+		html: () => highlighter.codeToHtml(code, options),
+		tokens: () => highlighter.codeToTokens(code, options)
+	};
+	return (outputs[format] ?? outputs.react)();
 }
 const useHighlight = (code, lang, themeInput, options = {}, highlighterFactory) => {
 	const [highlightedCode, setHighlightedCode] = useState(null);
+	useFeatureStyles(Boolean(options.showLineNumbers || options.highlightLineNumbers?.length));
 	const stableLang = useStableValue(lang);
 	const stableTheme = useStableValue(themeInput);
 	const stableOpts = useStableValue(options);
@@ -300,25 +378,32 @@ const isInlineCode = (node) => {
 };
 //#endregion
 //#region src/lib/component.tsx
+let warnedTokensOutputFormat = false;
+/**
+* The component's props exclude `outputFormat: 'tokens'`, but plain-JS
+* callers can still pass it. Tokens are not renderable React children,
+* so fall back to 'react' instead of crashing the render.
+*/
+const resolveOutputFormat = (outputFormat) => {
+	if (outputFormat !== "tokens") return outputFormat;
+	if (!warnedTokensOutputFormat) {
+		warnedTokensOutputFormat = true;
+		console.warn("[react-shiki] outputFormat 'tokens' is only supported by the useShikiHighlighter hook, falling back to 'react'");
+	}
+	return "react";
+};
 /**
 * Base ShikiHighlighter component factory.
 * This creates a component that uses the provided hook implementation.
 */
 const createShikiHighlighterComponent = (useShikiHighlighterImpl) => {
-	return forwardRef(({ language, theme, delay, transformers, defaultColor, cssVariablePrefix, addDefaultStyles = true, style, langStyle, className, langClassName, showLanguage = true, showLineNumbers = false, startingLineNumber = 1, children: code, as: Element = "div", customLanguages, preloadLanguages, ...shikiOptions }, ref) => {
-		const options = {
-			delay,
-			transformers,
-			customLanguages,
-			preloadLanguages,
-			showLineNumbers,
-			defaultColor,
-			cssVariablePrefix,
-			startingLineNumber,
-			...shikiOptions
-		};
+	return forwardRef(({ language, theme, addDefaultStyles = true, style, langStyle, className, langClassName, showLanguage = true, children: code, as: Element = "div", outputFormat, ...options }, ref) => {
+		useComponentStyles();
 		const displayLanguageId = typeof language === "object" ? language.name || null : language?.trim() || null;
-		const highlightedCode = useShikiHighlighterImpl(code, language, theme, options);
+		const highlightedCode = useShikiHighlighterImpl(code, language, theme, {
+			...options,
+			outputFormat: resolveOutputFormat(outputFormat)
+		});
 		return /* @__PURE__ */ jsxs(Element, {
 			ref,
 			"data-testid": "shiki-container",
@@ -326,7 +411,6 @@ const createShikiHighlighterComponent = (useShikiHighlighterImpl) => {
 			className: clsx("rs-root", "not-prose", addDefaultStyles && "rs-default-styles", className),
 			style,
 			children: [showLanguage && displayLanguageId ? /* @__PURE__ */ jsx("span", {
-				id: "language-label",
 				"data-slot": "language-label",
 				className: clsx("rs-language-label", langClassName),
 				style: langStyle,
@@ -341,4 +425,4 @@ const createShikiHighlighterComponent = (useShikiHighlighterImpl) => {
 //#endregion
 export { isLoadableLanguage as a, useHighlight as i, isInlineCode as n, rehypeInlineCodeProperty as r, createShikiHighlighterComponent as t };
 
-//# sourceMappingURL=component-CYq7SnJ0.mjs.map
+//# sourceMappingURL=component-Cf8Topxy.mjs.map

package/dist/component-Cf8Topxy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"component-Cf8Topxy.mjs","names":["componentCss","featuresCss"],"sources":["../src/lib/utils.ts","../src/styles/component.css?inline","../src/styles/features.css?inline","../src/lib/styles.ts","../src/lib/language.ts","../src/lib/theme.ts","../src/lib/engine.ts","../src/lib/transformers.ts","../src/lib/options.ts","../src/lib/hook.ts","../src/lib/plugins.ts","../src/lib/component.tsx"],"sourcesContent":["import { useRef } from 'react';\nimport { dequal } from 'dequal';\n\nimport type { TimeoutState } from './types';\n\n/**\n * Returns a referentially stable version of `value` that only updates when content changes.\n * Uses reference equality as a fast path and deep comparison to prevent unnecessary updates.\n */\nexport const useStableValue = <T>(value: T): T => {\n  const ref = useRef(value);\n\n  if (value !== ref.current && !dequal(value, ref.current)) {\n    ref.current = value;\n  }\n\n  return ref.current;\n};\n\n/**\n * Optionally throttles rapid sequential highlighting operations\n *\n * @example\n * const timeoutControl = useRef<TimeoutState>({\n *   nextAllowedTime: 0,\n *   timeoutId: undefined\n * });\n *\n * throttleHighlighting(highlightCode, timeoutControl, 1000);\n */\nexport const throttleHighlighting = (\n  performHighlight: () => Promise<void>,\n  timeoutControl: React.RefObject<TimeoutState>,\n  throttleMs: number\n) => {\n  clearTimeout(timeoutControl.current.timeoutId);\n\n  const delay = Math.max(\n    0,\n    timeoutControl.current.nextAllowedTime - Date.now()\n  );\n  timeoutControl.current.timeoutId = setTimeout(() => {\n    performHighlight();\n    timeoutControl.current.nextAllowedTime = Date.now() + throttleMs;\n  }, delay);\n};\n","/* Unlayered :where() defaults: immune to layered resets, overridden by any user rule. */\n:where(.rs-root) {\n  position: relative;\n}\n\n:where(.rs-root.rs-default-styles pre) {\n  overflow: auto;\n  border-radius: 0.5rem;\n  padding-inline: 1.5rem;\n  padding-block: 1.25rem;\n}\n\n:where(.rs-root .rs-language-label) {\n  position: absolute;\n  z-index: 1;\n  right: 0.75rem;\n  top: 0.5rem;\n  font-family: monospace;\n  font-size: 0.75rem;\n  letter-spacing: -0.05em;\n  color: rgba(107, 114, 128, 0.85);\n}\n",":where(.rs-has-line-numbers) {\n  counter-reset: line-number calc(var(--line-start, 1) - 1);\n}\n\n:where(.rs-has-line-numbers .rs-line-number)::before {\n  counter-increment: line-number;\n  content: counter(line-number);\n  display: inline-flex;\n  justify-content: flex-end;\n  align-items: flex-start;\n  box-sizing: content-box;\n  min-width: var(--rs-line-numbers-width, 2ch);\n  padding-left: var(--rs-line-numbers-padding-left, 0ch);\n  padding-right: var(--rs-line-numbers-padding-right, 2ch);\n  color: var(--rs-line-numbers-foreground, rgba(107, 114, 128, 0.5));\n  font-size: var(--rs-line-numbers-font-size, inherit);\n  font-weight: var(--rs-line-numbers-font-weight, inherit);\n  line-height: var(--rs-line-numbers-line-height, inherit);\n  font-family: var(--rs-line-numbers-font-family, inherit);\n  opacity: var(--rs-line-numbers-opacity, 1);\n  user-select: none;\n  pointer-events: none;\n}\n\n:where(.rs-has-highlighted-lines) {\n  display: block;\n  width: fit-content;\n  min-width: 100%;\n}\n\n:where(.rs-highlighted-line) {\n  --_rs-hl-background: var(\n    --rs-highlighted-line-background,\n    color-mix(in srgb, currentColor 10%, transparent)\n  );\n  display: inline-block;\n  width: 100%;\n  min-height: 1lh;\n  background-color: var(--_rs-hl-background);\n}\n\n/* Full bleed: the 100vw outset paints into the pre's padding, clipped by its overflow. */\n:where(.rs-default-styles .rs-highlighted-line) {\n  background-color: transparent;\n  border-image:\n    linear-gradient(var(--_rs-hl-background) 0 0) fill 0 / 0 / 0 100vw;\n}\n\n:where(.rs-has-line-numbers .rs-highlighted-line)::before {\n  color: var(\n    --rs-highlighted-line-number-foreground,\n    color-mix(in srgb, currentColor 65%, transparent)\n  );\n}\n","import componentCss from '../styles/component.css?inline';\nimport featuresCss from '../styles/features.css?inline';\nimport * as React from 'react';\n// Side-effect import so tsdown emits dist/style.css for the ./css export;\n// stripped from the built JS, guarded by check:package\nimport '../styles/index.css';\n\nconst injected = new Set<string>();\nconst useStyleInsertionEffect =\n  React.useInsertionEffect ?? React.useLayoutEffect;\n\nconst inject = (css: string, key: string) => {\n  if (injected.has(key) || typeof document === 'undefined') return;\n  injected.add(key);\n  try {\n    // Not governed by CSP style-src in current browsers, unlike the <style> fallback\n    const sheet = new CSSStyleSheet();\n    sheet.replaceSync(css);\n    document.adoptedStyleSheets = [...document.adoptedStyleSheets, sheet];\n  } catch {\n    const style = document.createElement('style');\n    style.dataset.reactShiki = key;\n    style.textContent = css;\n    document.head.append(style);\n  }\n};\n\n/** Installs component styles before layout without triggering a render. */\nexport const useComponentStyles = () => {\n  useStyleInsertionEffect(() => {\n    inject(componentCss, 'component');\n  }, []);\n};\n\n/** Installs line-number/highlight styles only when those options are used. */\nexport const useFeatureStyles = (enabled: boolean) => {\n  useStyleInsertionEffect(() => {\n    if (enabled) inject(featuresCss, 'features');\n  }, [enabled]);\n};\n","import type { Language, PreloadLanguage } from './types';\nimport { guessEmbeddedLanguages, isSpecialLang } from 'shiki/core';\nimport type {\n  DynamicImportLanguageRegistration,\n  Highlighter,\n  HighlighterCore,\n  LanguageInput,\n  LanguageRegistration,\n} from 'shiki';\n\nexport const FALLBACK_LANGUAGE = 'plaintext';\n\nconst toArray = <T>(value?: T | T[]): T[] =>\n  value == null ? [] : Array.isArray(value) ? value : [value];\n\n/** Deferred `LanguageInput` forms (getter, promise, module, array) that shiki resolves itself */\ntype DynamicLanguage = Exclude<LanguageInput, LanguageRegistration>;\n\nconst isDynamicLanguage = (\n  lang: PreloadLanguage\n): lang is DynamicLanguage =>\n  typeof lang === 'function' ||\n  lang instanceof Promise ||\n  Array.isArray(lang) ||\n  (typeof lang === 'object' && lang != null && 'default' in lang);\n\nconst isRegistration = (\n  lang: PreloadLanguage\n): lang is LanguageRegistration =>\n  typeof lang === 'object' && lang != null && !isDynamicLanguage(lang);\n\n/** Dedupe identity: strings and registrations by value, dynamic inputs by reference */\nconst languageKey = (lang: PreloadLanguage): string | object | null => {\n  if (lang == null) return null;\n  if (typeof lang === 'string') return `s:${lang}`;\n  if (isDynamicLanguage(lang)) return lang;\n  return `o:${lang.name}::${lang.scopeName}`;\n};\n\nconst dedupeLanguages = (langs: PreloadLanguage[]): PreloadLanguage[] => {\n  const seen = new Set<string | object>();\n  return langs.filter((lang) => {\n    const key = languageKey(lang);\n    if (key == null || seen.has(key)) return false;\n    seen.add(key);\n    return true;\n  });\n};\n\n/**\n * A registration matches a query by name, scopeName (full or its last\n * segment, e.g. \"source.tsx\" -> \"tsx\"), aliases, or fileTypes.\n */\nconst registrationMatches = (\n  candidate: LanguageRegistration,\n  matches: (str: string | undefined) => boolean\n): boolean =>\n  matches(candidate.name) ||\n  matches(candidate.scopeName) ||\n  matches(candidate.scopeName?.split('.').pop()) ||\n  !!candidate.aliases?.some(matches) ||\n  !!candidate.fileTypes?.some(matches);\n\ntype LanguageResult = {\n  languageId: string;\n  langsToLoad: PreloadLanguage[];\n};\n\n/**\n * Resolves the language prop to a shiki language id plus everything the\n * factory should load (primary, preloaded, and custom grammars, deduped).\n */\nexport const resolveLanguage = (\n  lang: Language,\n  customLanguages?: LanguageRegistration | LanguageRegistration[],\n  langAliases?: Record<string, string>,\n  preloadLanguages?: PreloadLanguage | PreloadLanguage[]\n): LanguageResult => {\n  const customLangs = toArray(customLanguages);\n  const preloadLangs = toArray(preloadLanguages);\n\n  const result = (\n    languageId: string,\n    primary?: Language\n  ): LanguageResult => ({\n    languageId,\n    langsToLoad: dedupeLanguages([\n      primary,\n      ...preloadLangs,\n      ...customLangs,\n    ]),\n  });\n\n  if (lang == null || (typeof lang === 'string' && !lang.trim())) {\n    return result(FALLBACK_LANGUAGE);\n  }\n\n  if (typeof lang === 'object') {\n    return result(lang.name, lang);\n  }\n\n  const normalized = lang.trim();\n  const query = normalized.toLowerCase();\n  const matches = (str: string | undefined): boolean =>\n    str?.toLowerCase() === query;\n\n  // Custom registrations (from both customLanguages and preloadLanguages)\n  const customMatch = [...customLangs, ...preloadLangs]\n    .filter(isRegistration)\n    .find((candidate) => registrationMatches(candidate, matches));\n  if (customMatch) {\n    return result(customMatch.name || normalized, customMatch);\n  }\n\n  const alias = Object.entries(langAliases ?? {}).find(([name]) =>\n    matches(name)\n  )?.[1];\n  if (alias) {\n    return result(alias, alias);\n  }\n\n  // Any other string passes through to the factory\n  return result(normalized, normalized);\n};\n\n/**\n * Used in factories to check if language is supported.\n * Objects are validated as grammar registrations (name + scopeName);\n * dynamic imports pass through for shiki to resolve.\n */\nexport const isLoadableLanguage = <T extends string>(\n  lang: PreloadLanguage,\n  bundledLanguages: Record<T, DynamicImportLanguageRegistration>\n): lang is NonNullable<PreloadLanguage> => {\n  if (lang == null) return false;\n  if (typeof lang === 'string') return lang in bundledLanguages;\n  if (isDynamicLanguage(lang)) return true;\n  return (\n    typeof lang.name === 'string' && typeof lang.scopeName === 'string'\n  );\n};\n\n/**\n * Used in hook to resolve loaded language for highlighting.\n * Falls back to \"plaintext\" if not supported.\n */\nexport const resolveLoadedLanguage = (\n  languageId: string,\n  loadedLanguages: string[]\n): string =>\n  isSpecialLang(languageId) || loadedLanguages.includes(languageId)\n    ? languageId\n    : FALLBACK_LANGUAGE;\n\nexport const getEmbeddedLanguages = (\n  code: string,\n  languageId: string,\n  highlighter: Highlighter | HighlighterCore\n): LanguageInput[] => {\n  const bundled: Record<string, LanguageInput> =\n    highlighter.getBundledLanguages();\n  return guessEmbeddedLanguages(code, languageId).flatMap(\n    (language) => bundled[language] ?? []\n  );\n};\n","import type { Theme, Themes } from './types';\nimport type { ThemeRegistrationAny } from 'shiki/core';\n\nexport const DEFAULT_THEMES: Themes = {\n  light: 'github-light',\n  dark: 'github-dark',\n};\n\nexport type ResolvedTheme =\n  | { isMulti: true; themes: Themes; themesToLoad: Theme[] }\n  | { isMulti: false; theme: Theme; themesToLoad: Theme[] };\n\nconst isTextmateTheme = (\n  value: unknown\n): value is ThemeRegistrationAny => {\n  if (typeof value !== 'object' || value === null) return false;\n  const v = value as Partial<ThemeRegistrationAny> & {\n    settings?: unknown;\n  };\n  const hasTokens =\n    Array.isArray(v.tokenColors) || Array.isArray(v.settings);\n  const hasIdentity =\n    typeof v.name === 'string' || typeof v.type === 'string';\n  return hasTokens && hasIdentity;\n};\n\nexport function resolveTheme(themeInput: Theme | Themes): ResolvedTheme {\n  if (\n    typeof themeInput !== 'object' ||\n    themeInput === null ||\n    isTextmateTheme(themeInput)\n  ) {\n    return {\n      isMulti: false,\n      theme: themeInput,\n      themesToLoad: [themeInput],\n    };\n  }\n\n  const validEntries = Object.entries(themeInput).filter(\n    ([key, value]) =>\n      key.trim() !== '' &&\n      ((typeof value === 'string' && value.trim() !== '') ||\n        isTextmateTheme(value))\n  );\n\n  if (validEntries.length === 0) {\n    console.warn(\n      '[react-shiki] invalid multi-theme config, falling back to defaults'\n    );\n    return {\n      isMulti: true,\n      themes: DEFAULT_THEMES,\n      themesToLoad: Object.values(DEFAULT_THEMES),\n    };\n  }\n\n  if (validEntries.length !== Object.keys(themeInput).length) {\n    console.warn(\n      '[react-shiki] multi-theme config contained invalid entries; they were dropped'\n    );\n  }\n\n  const themes = Object.fromEntries(validEntries) as Themes;\n  return {\n    isMulti: true,\n    themes,\n    themesToLoad: validEntries.map(([, value]) => value as Theme),\n  };\n}\n","import type { Awaitable, RegexEngine } from 'shiki/core';\nimport type { EngineName } from './types';\n\nconst engines = new Map<EngineName, Promise<RegexEngine>>();\n\n// Dynamic imports keep unused engines out of the loaded graph: naming an\n// engine loads only that engine, and 'javascript' never fetches the wasm.\nconst loaders: Record<EngineName, () => Promise<RegexEngine>> = {\n  javascript: () =>\n    import('shiki/engine/javascript').then((m) =>\n      m.createJavaScriptRegexEngine()\n    ),\n  oniguruma: () =>\n    import('shiki/engine/oniguruma').then((m) =>\n      m.createOnigurumaEngine(import('shiki/wasm'))\n    ),\n};\n\n/**\n * Resolves a named engine to a lazily created, cached instance.\n * Engine instances and undefined pass through untouched.\n *\n * The cache makes named engines referentially stable across renders and\n * call sites, unlike inline `createJavaScriptRegexEngine()` calls.\n */\nexport const resolveEngine = (\n  engine: EngineName | Awaitable<RegexEngine> | undefined\n): Awaitable<RegexEngine> | undefined => {\n  if (typeof engine !== 'string') return engine;\n\n  const load = loaders[engine];\n  if (!load) {\n    throw new Error(\n      `[react-shiki] unknown engine '${engine}', expected 'javascript' or 'oniguruma'`\n    );\n  }\n\n  const cached = engines.get(engine);\n  if (cached) return cached;\n\n  const instance = load();\n  // Evict rejected loads (e.g. transient wasm fetch failure) so the\n  // next highlight retries instead of reusing the cached rejection.\n  instance.catch(() => engines.delete(engine));\n  engines.set(engine, instance);\n  return instance;\n};\n","import type { ShikiTransformer } from 'shiki/core';\n\nconst toLineNumberSet = (lineNumbers: readonly number[]) =>\n  new Set(lineNumbers.filter(Number.isInteger));\n\n/**\n * Creates a transformer that enables line numbers display\n * @param startLine - The starting line number (defaults to 1)\n */\nexport function lineNumbersTransformer(startLine = 1): ShikiTransformer {\n  return {\n    name: 'react-shiki:line-numbers',\n    code(node) {\n      this.addClassToHast(node, 'rs-has-line-numbers');\n      if (startLine !== 1) {\n        const existing = node.properties?.style as string | undefined;\n        node.properties = {\n          ...node.properties,\n          style: [existing, `--line-start: ${startLine}`]\n            .filter(Boolean)\n            .join('; '),\n        };\n      }\n    },\n    line(node) {\n      this.addClassToHast(node, 'rs-line-number');\n      return node;\n    },\n  };\n}\n\n/**\n * Creates a transformer that marks selected displayed line numbers.\n * @param lineNumbers - Displayed line numbers to highlight\n * @param startLine - The starting line number (defaults to 1)\n */\nexport function highlightedLinesTransformer(\n  lineNumbers: readonly number[],\n  startLine = 1\n): ShikiTransformer {\n  const highlightedLines = toLineNumberSet(lineNumbers);\n\n  return {\n    name: 'react-shiki:highlight-lines',\n    code(node) {\n      this.addClassToHast(node, 'rs-has-highlighted-lines');\n    },\n    line(node, line) {\n      const displayedLine = startLine + line - 1;\n\n      if (highlightedLines.has(displayedLine)) {\n        this.addClassToHast(node, 'rs-highlighted-line');\n      }\n\n      return node;\n    },\n  };\n}\n","import type {\n  BundledTheme,\n  CodeOptionsMultipleThemes,\n  CodeOptionsSingleTheme,\n  CodeToHastOptions,\n} from 'shiki';\n\nimport type {\n  HighlighterOptions,\n  HighlighterOptionsFor,\n  OutputFormat,\n} from './types';\nimport type { ResolvedTheme } from './theme';\nimport {\n  highlightedLinesTransformer,\n  lineNumbersTransformer,\n} from './transformers';\n\nconst buildThemeOptions = (\n  resolvedTheme: ResolvedTheme,\n  defaultColor: HighlighterOptions['defaultColor'],\n  cssVariablePrefix: HighlighterOptions['cssVariablePrefix']\n):\n  | CodeOptionsMultipleThemes<BundledTheme>\n  | CodeOptionsSingleTheme<BundledTheme> => {\n  if (resolvedTheme.isMulti) {\n    return {\n      themes: resolvedTheme.themes,\n      defaultColor,\n      cssVariablePrefix,\n    };\n  }\n\n  return {\n    theme: resolvedTheme.theme,\n  };\n};\n\nexport const buildShikiOptions = (\n  languageId: string,\n  resolvedTheme: ResolvedTheme,\n  options: HighlighterOptionsFor<OutputFormat>\n): CodeToHastOptions => {\n  const {\n    delay,\n    customLanguages,\n    preloadLanguages,\n    outputFormat,\n    highlighter,\n    langAlias,\n    engine,\n    defaultColor,\n    cssVariablePrefix,\n    showLineNumbers,\n    startingLineNumber,\n    highlightLineNumbers,\n    transformers: userTransformers,\n    ...shikiPassthrough\n  } = options;\n\n  const transformers = [...(userTransformers || [])];\n  if (showLineNumbers) {\n    transformers.push(lineNumbersTransformer(startingLineNumber));\n  }\n  if (highlightLineNumbers?.length) {\n    transformers.push(\n      highlightedLinesTransformer(\n        highlightLineNumbers,\n        startingLineNumber\n      )\n    );\n  }\n\n  return {\n    lang: languageId,\n    ...buildThemeOptions(resolvedTheme, defaultColor, cssVariablePrefix),\n    ...shikiPassthrough,\n    transformers,\n  };\n};\n","import { useEffect, useMemo, useRef, useState } from 'react';\nimport { jsx, jsxs, Fragment } from 'react/jsx-runtime';\nimport { toJsxRuntime } from 'hast-util-to-jsx-runtime';\nimport type { CodeToHastOptions } from 'shiki';\n\nimport type {\n  HighlighterFactory,\n  HighlighterOptions,\n  HighlighterOptionsFor,\n  HighlightResult,\n  HighlightResultMap,\n  Language,\n  OutputFormat,\n  PreloadLanguage,\n  Theme,\n  Themes,\n  TimeoutState,\n} from './types';\n\nimport { throttleHighlighting, useStableValue } from './utils';\nimport { useFeatureStyles } from './styles';\nimport {\n  getEmbeddedLanguages,\n  resolveLanguage,\n  resolveLoadedLanguage,\n} from './language';\nimport { resolveTheme } from './theme';\nimport { resolveEngine } from './engine';\nimport { buildShikiOptions } from './options';\n\nexport async function highlight<F extends OutputFormat = 'react'>(\n  code: string,\n  resolved: {\n    languageId: string;\n    langsToLoad: PreloadLanguage[];\n    themesToLoad: Theme[];\n    shikiOptions: CodeToHastOptions;\n  },\n  opts: Pick<HighlighterOptions, 'highlighter' | 'engine'> & {\n    outputFormat?: F;\n  },\n  factory: HighlighterFactory\n): Promise<HighlightResultMap[F]> {\n  const { languageId, langsToLoad, themesToLoad, shikiOptions } =\n    resolved;\n  const format: OutputFormat = opts.outputFormat ?? 'react';\n\n  const highlighter =\n    opts.highlighter ??\n    (await (async () => {\n      const hl = await factory(\n        langsToLoad,\n        themesToLoad,\n        resolveEngine(opts.engine)\n      );\n      await hl.loadLanguage(\n        ...getEmbeddedLanguages(code, languageId, hl)\n      );\n      return hl;\n    })());\n\n  const language = resolveLoadedLanguage(\n    languageId,\n    highlighter.getLoadedLanguages()\n  );\n  const options = { ...shikiOptions, lang: language };\n\n  const outputs: { [K in OutputFormat]: () => HighlightResultMap[K] } = {\n    react: () =>\n      toJsxRuntime(highlighter.codeToHast(code, options), {\n        jsx,\n        jsxs,\n        Fragment,\n      }),\n    html: () => highlighter.codeToHtml(code, options),\n    tokens: () => highlighter.codeToTokens(code, options),\n  };\n\n  // Untyped call sites can pass formats outside OutputFormat; degrade to\n  // react rendering like the pre-tokens ternary did instead of throwing.\n  return (outputs[format] ?? outputs.react)() as HighlightResultMap[F];\n}\n\nexport const useHighlight = <F extends OutputFormat = 'react'>(\n  code: string,\n  lang: Language,\n  themeInput: Theme | Themes,\n  options: HighlighterOptionsFor<F> = {},\n  highlighterFactory: HighlighterFactory\n): HighlightResult<F> => {\n  const [highlightedCode, setHighlightedCode] =\n    useState<HighlightResult<F>>(null);\n\n  // This hook owns the line-number/highlight output, so it also owns the\n  // corresponding styles. The primitive boolean limits effect reruns.\n  useFeatureStyles(\n    Boolean(\n      options.showLineNumbers || options.highlightLineNumbers?.length\n    )\n  );\n\n  const stableLang = useStableValue(lang);\n  const stableTheme = useStableValue(themeInput);\n  const stableOpts = useStableValue(options);\n\n  const resolved = useMemo(() => {\n    const { languageId, langsToLoad } = resolveLanguage(\n      stableLang,\n      stableOpts.customLanguages,\n      stableOpts.langAlias,\n      stableOpts.preloadLanguages\n    );\n\n    const theme = resolveTheme(stableTheme);\n\n    const shikiOptions = buildShikiOptions(languageId, theme, stableOpts);\n    return {\n      languageId,\n      langsToLoad,\n      themesToLoad: theme.themesToLoad,\n      shikiOptions,\n    };\n  }, [stableLang, stableTheme, stableOpts]);\n\n  const requestIdRef = useRef(0);\n\n  const timeoutControl = useRef<TimeoutState>({\n    nextAllowedTime: 0,\n    timeoutId: undefined,\n  });\n\n  // Factory is invoked imperatively; its identity is not semantic, so it must\n  // not invalidate the effect on every render. See issue #161.\n  const highlighterFactoryRef = useRef(highlighterFactory);\n  highlighterFactoryRef.current = highlighterFactory;\n\n  useEffect(() => {\n    const requestId = ++requestIdRef.current;\n\n    if (!resolved.languageId) return;\n\n    const run = async () => {\n      try {\n        const result = await highlight<F>(\n          code,\n          resolved,\n          stableOpts,\n          highlighterFactoryRef.current\n        );\n        if (requestId === requestIdRef.current) {\n          setHighlightedCode(result);\n        }\n      } catch (error) {\n        console.error('[react-shiki] highlight failed', error);\n      }\n    };\n\n    if (stableOpts.delay) {\n      throttleHighlighting(run, timeoutControl, stableOpts.delay);\n    } else {\n      run();\n    }\n\n    return () => {\n      clearTimeout(timeoutControl.current.timeoutId);\n    };\n  }, [code, resolved, stableOpts]);\n\n  return highlightedCode;\n};\n","import { visit } from 'unist-util-visit';\nimport type { Root } from 'hast';\nimport type { Element } from './types';\n\n/**\n * Rehype plugin to add an 'inline' property to <code> elements\n * Sets 'inline' property to true if the <code> is not within a <pre> tag\n *\n * Pass this plugin to the `rehypePlugins` prop of react-markdown\n * You can then access `inline` as a prop in components passed to react-markdown\n *\n * @example\n * <ReactMarkdown rehypePlugins={[rehypeInlineCodeProperty]} />\n */\nexport function rehypeInlineCodeProperty() {\n  return (tree: Root): undefined => {\n    visit(tree, 'element', (node: Element, _index, parent) => {\n      if (\n        node.tagName === 'code' &&\n        parent?.type === 'element' &&\n        parent.tagName !== 'pre'\n      ) {\n        node.properties.inline = true;\n      }\n    });\n  };\n}\n\n/**\n * Function to determine if code is inline based on the presence of line breaks\n *\n * @example\n * const isInline = node && isInlineCode(node: Element)\n */\nexport const isInlineCode = (node: Element): boolean => {\n  const textContent = (node.children || [])\n    .filter((child) => child.type === 'text')\n    .map((child) => child.value)\n    .join('');\n\n  return !textContent.includes('\\n');\n};\n","import { clsx } from 'clsx';\n\nimport type {\n  HighlighterOptions,\n  Language,\n  OutputFormat,\n  Theme,\n  Themes,\n  UseShikiHighlighter,\n} from './types';\nimport { forwardRef } from 'react';\nimport { useComponentStyles } from './styles';\n\nlet warnedTokensOutputFormat = false;\n\n/**\n * The component's props exclude `outputFormat: 'tokens'`, but plain-JS\n * callers can still pass it. Tokens are not renderable React children,\n * so fall back to 'react' instead of crashing the render.\n */\nconst resolveOutputFormat = (\n  outputFormat: HighlighterOptions['outputFormat']\n): HighlighterOptions['outputFormat'] => {\n  if ((outputFormat as OutputFormat) !== 'tokens') return outputFormat;\n\n  if (!warnedTokensOutputFormat) {\n    warnedTokensOutputFormat = true;\n    console.warn(\n      \"[react-shiki] outputFormat 'tokens' is only supported by the useShikiHighlighter hook, falling back to 'react'\"\n    );\n  }\n  return 'react';\n};\n\n/**\n * Props for the ShikiHighlighter component\n */\nexport interface ShikiHighlighterProps extends HighlighterOptions {\n  /**\n   * The programming language for syntax highlighting\n   * Supports custom textmate grammar objects in addition to Shiki's bundled languages\n   * @see https://shiki.style/languages\n   */\n  language: Language;\n\n  /**\n   * The code to be highlighted\n   */\n  children: string;\n\n  /**\n   * The color theme or themes for syntax highlighting\n   * Supports single, dual, or multiple themes\n   * Supports custom textmate theme objects in addition to Shiki's bundled themes\n   *\n   * @example\n   * theme='github-dark' // single theme\n   * theme={{ light: 'github-light', dark: 'github-dark' }} // multi-theme\n   *\n   * @see https://shiki.style/themes\n   */\n  theme: Theme | Themes;\n\n  /**\n   * Controls the application of default styles to the generated code blocks\n   *\n   * Default styles include padding, overflow handling, border radius, language label styling, and font settings\n   * @default true\n   */\n  addDefaultStyles?: boolean;\n\n  /**\n   * Add custom inline styles to the generated code block\n   */\n  style?: React.CSSProperties;\n\n  /**\n   * Add custom inline styles to the language label\n   */\n  langStyle?: React.CSSProperties;\n\n  /**\n   * Add custom CSS class names to the generated code block\n   */\n  className?: string;\n\n  /**\n   * Add custom CSS class names to the language label\n   */\n  langClassName?: string;\n\n  /**\n   * Whether to show the language label\n   * @default true\n   */\n  showLanguage?: boolean;\n\n  /**\n   * The HTML element that wraps the generated code block.\n   * @default 'div'\n   */\n  as?: React.ElementType;\n}\n\n/**\n * Base ShikiHighlighter component factory.\n * This creates a component that uses the provided hook implementation.\n */\nexport const createShikiHighlighterComponent = (\n  useShikiHighlighterImpl: UseShikiHighlighter\n) => {\n  return forwardRef<HTMLElement, ShikiHighlighterProps>(\n    (\n      {\n        language,\n        theme,\n        addDefaultStyles = true,\n        style,\n        langStyle,\n        className,\n        langClassName,\n        showLanguage = true,\n        children: code,\n        as: Element = 'div',\n        outputFormat,\n        ...options\n      },\n      ref\n    ) => {\n      // Kept inside the component so hook-only bundles can tree-shake it\n      // together with the component CSS.\n      useComponentStyles();\n\n      const displayLanguageId =\n        typeof language === 'object'\n          ? language.name || null\n          : language?.trim() || null;\n\n      const highlightedCode = useShikiHighlighterImpl(\n        code,\n        language,\n        theme,\n        {\n          ...options,\n          outputFormat: resolveOutputFormat(outputFormat),\n        }\n      );\n\n      return (\n        <Element\n          ref={ref}\n          data-testid=\"shiki-container\"\n          data-slot=\"container\"\n          className={clsx(\n            'rs-root',\n            'not-prose',\n            addDefaultStyles && 'rs-default-styles',\n            className\n          )}\n          style={style}\n        >\n          {showLanguage && displayLanguageId ? (\n            <span\n              data-slot=\"language-label\"\n              className={clsx('rs-language-label', langClassName)}\n              style={langStyle}\n            >\n              {displayLanguageId}\n            </span>\n          ) : null}\n          {typeof highlightedCode === 'string' ? (\n            <div\n              data-slot=\"content\"\n              dangerouslySetInnerHTML={{ __html: highlightedCode }}\n            />\n          ) : (\n            highlightedCode\n          )}\n        </Element>\n      );\n    }\n  );\n};\n"],"mappings":"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"}

package/dist/{component-CjpuWrgO.d.mts → component-DlK6KonE.d.mts}

@@ -1,6 +1,5 @@
 import { ReactElement } from "react";
-import { BundledHighlighterOptions, BundledLanguage, BundledTheme, CodeOptionsMultipleThemes, CodeToHastOptions, Highlighter, HighlighterCore, LanguageRegistration, SpecialLanguage, StringLiteralUnion, ThemeRegistrationAny } from "shiki";
-
+import { Awaitable, BundledHighlighterOptions, BundledLanguage, BundledTheme, CodeOptionsMultipleThemes, CodeToHastOptions, Highlighter, HighlighterCore, LanguageInput, LanguageRegistration, RegexEngine, SpecialLanguage, StringLiteralUnion, ThemeRegistrationAny, TokensResult } from "shiki";
 //#region ../node_modules/.pnpm/@types+unist@3.0.3/node_modules/@types/unist/index.d.ts
 // ## Interfaces
 /**
@@ -317,6 +316,12 @@ type Element = Element$1;
  * @see https://shiki.style/languages
  */
 type Language = LanguageRegistration | StringLiteralUnion<BundledLanguage> | SpecialLanguage | undefined;
+/**
+ * A `preloadLanguages` entry: a bundled language id, a custom grammar
+ * object, or a dynamic grammar import (shiki's `LanguageInput`), e.g.
+ * `() => import('../langs/mcfunction.json')`
+ */
+type PreloadLanguage = Language | LanguageInput;
 type MultiThemeKey = 'dark' | 'light' | (string & {});
 /**
  * A Shiki BundledTheme or a custom textmate theme object
@@ -339,7 +344,11 @@ type Theme = ThemeRegistrationAny | StringLiteralUnion<BundledTheme>;
  *
  * @see https://shiki.style/guide/dual-themes
  */
-type Themes = { [Key in MultiThemeKey]: Theme };
+type Themes = { [Key in MultiThemeKey]: Theme; };
+/**
+ * Named RegExp engines that react-shiki creates and caches internally.
+ */
+type EngineName = 'javascript' | 'oniguruma';
 /**
  * Configuration options specific to react-shiki
  */
@@ -349,6 +358,18 @@ interface ReactShikiOptions {
    * @default undefined (no throttling)
    */
   delay?: number;
+  /**
+   * RegExp engine for syntax highlighting.
+   * - 'oniguruma': compiled WebAssembly engine, maximum grammar support
+   * - 'javascript': pure-JS engine, no WASM fetch, faster startup
+   *
+   * Named engines are created lazily and cached by react-shiki, so they
+   * are safe to pass inline. A custom engine instance is also accepted;
+   * create it once at module scope, as a new instance on every render
+   * re-triggers highlighting.
+   * @default 'oniguruma'
+   */
+  engine?: EngineName | Awaitable<RegexEngine>;
   /**
    * Custom textmate grammars to be preloaded for highlighting.
    * @deprecated Use preloadLanguages instead.
@@ -357,12 +378,25 @@ interface ReactShikiOptions {
   /**
    * Preload custom grammars or bundled languages.
    * Supports custom textmate grammars, replaces deprecated `customLanguages`
+   *
+   * Full/web bundles also accept dynamic grammar imports, keeping custom
+   * grammars out of the main bundle. Define them at module scope, preferring
+   * getters: a fresh getter each render re-triggers highlighting, while
+   * swapping a bare promise at runtime is not detected.
+   *
+   * @example
+   * const preload = [() => import('../langs/mcfunction.json')];
    */
-  preloadLanguages?: Language | Language[];
+  preloadLanguages?: PreloadLanguage | PreloadLanguage[];
   /**
    * Output format for the highlighted code.
    * - 'react': Returns React nodes (default, safer)
-   * - 'html': Returns HTML string (~15-45% faster, requires dangerouslySetInnerHTML)
+   * - 'html': Returns HTML string (rendered via dangerouslySetInnerHTML)
+   *
+   * The hook additionally accepts 'tokens' (experimental) to return raw
+   * Shiki tokens for custom rendering. It is deliberately excluded here
+   * and only enters through the hook's generic signature, so option
+   * objects typed with this interface keep the classic return type.
    * @default 'react'
    */
   outputFormat?: 'react' | 'html';
@@ -404,20 +438,39 @@ interface ReactShikiOptions {
    * @default 1
    */
   startingLineNumber?: number;
+  /**
+   * Displayed line numbers to highlight
+   */
+  highlightLineNumbers?: number[];
 }
 /**
  * Configuration options for the syntax highlighter
  * Extends CodeToHastOptions to allow passing any Shiki options directly
  */
-interface HighlighterOptions extends ReactShikiOptions, Pick<CodeOptionsMultipleThemes<BundledTheme>, 'defaultColor' | 'cssVariablePrefix'>, Omit<CodeToHastOptions, 'lang' | 'theme' | 'themes'>, Pick<BundledHighlighterOptions<string, string>, 'langAlias' | 'engine'> {}
+interface HighlighterOptions extends ReactShikiOptions, Pick<CodeOptionsMultipleThemes<BundledTheme>, 'defaultColor' | 'cssVariablePrefix'>, Omit<CodeToHastOptions, 'lang' | 'theme' | 'themes'>, Pick<BundledHighlighterOptions<string, string>, 'langAlias'> {}
 /**
- * State for the throttling logic
+ * Supported output formats and their corresponding result shapes.
  */
+type OutputFormat = 'react' | 'html' | 'tokens';
+interface HighlightResultMap {
+  react: ReactElement;
+  html: string;
+  tokens: TokensResult;
+}
+type HighlightResult<F extends OutputFormat = 'react'> = HighlightResultMap[F] | null;
 /**
- * Public API signature for the useShikiHighlighter hook.
- */
-type HighlightedCode = ReactElement | string | null;
-type UseShikiHighlighter = (code: string, lang: Language, themeInput: Theme | Themes, options?: HighlighterOptions) => HighlightedCode;
+ * Per-call options shape: every highlighter option except `outputFormat`,
+ * plus a narrowed `outputFormat?: F` so the return type can be inferred
+ * from the format the caller actually passes.
+ *
+ * This is the only place 'tokens' is accepted. Keeping it out of
+ * `HighlighterOptions` means values typed with that interface infer
+ * `F = 'react' | 'html'` and keep their pre-tokens return type.
+ */
+type HighlighterOptionsFor<F extends OutputFormat> = Omit<HighlighterOptions, 'outputFormat'> & {
+  outputFormat?: F;
+};
+type UseShikiHighlighter = <F extends OutputFormat = 'react'>(code: string, lang: Language, themeInput: Theme | Themes, options?: HighlighterOptionsFor<F>) => HighlightResult<F>;
 //#endregion
 //#region src/lib/plugins.d.ts
 /**
@@ -494,16 +547,6 @@ interface ShikiHighlighterProps extends HighlighterOptions {
    * @default true
    */
   showLanguage?: boolean;
-  /**
-   * Whether to show line numbers
-   * @default false
-   */
-  showLineNumbers?: boolean;
-  /**
-   * Starting line number (when showLineNumbers is true)
-   * @default 1
-   */
-  startingLineNumber?: number;
   /**
    * The HTML element that wraps the generated code block.
    * @default 'div'
@@ -511,5 +554,5 @@ interface ShikiHighlighterProps extends HighlighterOptions {
   as?: React.ElementType;
 }
 //#endregion
-export { HighlighterOptions as a, Themes as c, Element as i, UseShikiHighlighter as l, isInlineCode as n, Language as o, rehypeInlineCodeProperty as r, Theme as s, ShikiHighlighterProps as t };
-//# sourceMappingURL=component-CjpuWrgO.d.mts.map
+export { EngineName as a, HighlighterOptionsFor as c, PreloadLanguage as d, Theme as f, Element as i, Language as l, UseShikiHighlighter as m, isInlineCode as n, HighlightResult as o, Themes as p, rehypeInlineCodeProperty as r, HighlighterOptions as s, ShikiHighlighterProps as t, OutputFormat as u };
+//# sourceMappingURL=component-DlK6KonE.d.mts.map

package/dist/core.d.mts

@@ -1,9 +1,7 @@
-import { a as HighlighterOptions, c as Themes, i as Element, l as UseShikiHighlighter, n as isInlineCode, o as Language, r as rehypeInlineCodeProperty, s as Theme, t as ShikiHighlighterProps } from "./component-CjpuWrgO.mjs";
-import * as _$react from "react";
-import { LanguageRegistration, createHighlighterCore } from "shiki/core";
+import { a as EngineName, c as HighlighterOptionsFor, d as PreloadLanguage, f as Theme, i as Element, l as Language, m as UseShikiHighlighter, n as isInlineCode, o as HighlightResult, p as Themes, r as rehypeInlineCodeProperty, s as HighlighterOptions, t as ShikiHighlighterProps, u as OutputFormat } from "./component-DlK6KonE.mjs";
+import { LanguageRegistration, TokensResult, createHighlighterCore } from "shiki/core";
 import { createOnigurumaEngine } from "shiki/engine/oniguruma";
 import { createJavaScriptRawEngine, createJavaScriptRegexEngine } from "shiki/engine/javascript";
-
 //#region src/core.d.ts
 /**
  * Highlight code with shiki (core bundle)
@@ -12,7 +10,7 @@ import { createJavaScriptRawEngine, createJavaScriptRegexEngine } from "shiki/en
  * @param lang - Language (bundled or custom)
  * @param theme - Theme (bundled, multi-theme, or custom)
  * @param options - react-shiki options + shiki options
- * @returns Highlighted code as React elements or HTML string
+ * @returns Highlighted code as React elements (default), HTML string, or Shiki tokens, based on `outputFormat`
  *
  * @example
  * ```tsx
@@ -43,7 +41,7 @@ declare const useShikiHighlighter: UseShikiHighlighter;
  * ShikiHighlighter component using a custom highlighter.
  * Requires a highlighter to be provided.
  */
-declare const ShikiHighlighter: _$react.ForwardRefExoticComponent<ShikiHighlighterProps & _$react.RefAttributes<HTMLElement>>;
+declare const ShikiHighlighter: import("react").ForwardRefExoticComponent<ShikiHighlighterProps & import("react").RefAttributes<HTMLElement>>;
 //#endregion
-export { type Element, type HighlighterOptions, type Language, type LanguageRegistration, ShikiHighlighter, ShikiHighlighter as default, type ShikiHighlighterProps, type Theme, type Themes, type UseShikiHighlighter, createHighlighterCore, createJavaScriptRawEngine, createJavaScriptRegexEngine, createOnigurumaEngine, isInlineCode, rehypeInlineCodeProperty, useShikiHighlighter };
+export { type Element, type EngineName, type HighlightResult, type HighlighterOptions, type HighlighterOptionsFor, type Language, type LanguageRegistration, type OutputFormat, type PreloadLanguage, ShikiHighlighter, ShikiHighlighter as default, type ShikiHighlighterProps, type Theme, type Themes, type TokensResult, type UseShikiHighlighter, createHighlighterCore, createJavaScriptRawEngine, createJavaScriptRegexEngine, createOnigurumaEngine, isInlineCode, rehypeInlineCodeProperty, useShikiHighlighter };
 //# sourceMappingURL=core.d.mts.map

package/dist/core.mjs

@@ -1,4 +1,4 @@
-import { i as useHighlight, n as isInlineCode, r as rehypeInlineCodeProperty, t as createShikiHighlighterComponent } from "./component-CYq7SnJ0.mjs";
+import { i as useHighlight, n as isInlineCode, r as rehypeInlineCodeProperty, t as createShikiHighlighterComponent } from "./component-Cf8Topxy.mjs";
 import { createHighlighterCore } from "shiki/core";
 import { createOnigurumaEngine } from "shiki/engine/oniguruma";
 import { createJavaScriptRawEngine, createJavaScriptRegexEngine } from "shiki/engine/javascript";
@@ -20,7 +20,7 @@ function validateCoreHighlighter(highlighter) {
 * @param lang - Language (bundled or custom)
 * @param theme - Theme (bundled, multi-theme, or custom)
 * @param options - react-shiki options + shiki options
-* @returns Highlighted code as React elements or HTML string
+* @returns Highlighted code as React elements (default), HTML string, or Shiki tokens, based on `outputFormat`
 *
 * @example
 * ```tsx
@@ -57,7 +57,7 @@ const useShikiHighlighter = (code, lang, themeInput, options = {}) => {
 * ShikiHighlighter component using a custom highlighter.
 * Requires a highlighter to be provided.
 */
-const ShikiHighlighter = createShikiHighlighterComponent(useShikiHighlighter);
+const ShikiHighlighter = /*#__PURE__*/ createShikiHighlighterComponent(useShikiHighlighter);
 //#endregion
 export { ShikiHighlighter, ShikiHighlighter as default, createHighlighterCore, createJavaScriptRawEngine, createJavaScriptRegexEngine, createOnigurumaEngine, isInlineCode, rehypeInlineCodeProperty, useShikiHighlighter };