react-shiki 0.6.0 → 0.7.1

package/dist/chunk-RZ35JRPP.js

@@ -0,0 +1,324 @@
+// src/lib/utils.ts
+import { visit } from "unist-util-visit";
+function rehypeInlineCodeProperty() {
+  return (tree) => {
+    visit(tree, "element", (node, _index, parent) => {
+      if (node.tagName === "code" && parent.tagName !== "pre") {
+        node.properties.inline = true;
+      }
+    });
+  };
+}
+var isInlineCode = (node) => {
+  const textContent = (node.children || []).filter((child) => child.type === "text").map((child) => child.value).join("");
+  return !textContent.includes("\n");
+};
+var throttleHighlighting = (performHighlight, timeoutControl, throttleMs) => {
+  const now = Date.now();
+  clearTimeout(timeoutControl.current.timeoutId);
+  const delay = Math.max(0, timeoutControl.current.nextAllowedTime - now);
+  timeoutControl.current.timeoutId = setTimeout(() => {
+    performHighlight().catch(console.error);
+    timeoutControl.current.nextAllowedTime = now + throttleMs;
+  }, delay);
+};
+
+// src/lib/hook.ts
+import {
+  useEffect,
+  useMemo,
+  useRef,
+  useState
+} from "react";
+import { dequal } from "dequal/lite";
+import { jsx, jsxs, Fragment } from "react/jsx-runtime";
+import { toJsxRuntime } from "hast-util-to-jsx-runtime";
+
+// src/lib/resolvers.ts
+var resolveLanguage = (lang, customLanguages) => {
+  const normalizedCustomLangs = customLanguages ? Array.isArray(customLanguages) ? customLanguages : [customLanguages] : [];
+  if (lang == null || typeof lang === "string" && !lang.trim()) {
+    return {
+      languageId: "plaintext",
+      displayLanguageId: "plaintext",
+      langsToLoad: void 0
+    };
+  }
+  if (typeof lang === "object") {
+    return {
+      languageId: lang.name,
+      displayLanguageId: lang.name || null,
+      langsToLoad: lang
+    };
+  }
+  const lowerLang = lang.toLowerCase();
+  const matches = (str) => str?.toLowerCase() === lowerLang;
+  const customMatch = normalizedCustomLangs.find(
+    (cl) => matches(cl.name) || matches(cl.scopeName) || matches(cl.scopeName?.split(".").pop()) || cl.aliases?.some(matches) || cl.fileTypes?.some(matches)
+  );
+  if (customMatch) {
+    return {
+      languageId: customMatch.name || lang,
+      displayLanguageId: lang,
+      langsToLoad: customMatch
+    };
+  }
+  return {
+    languageId: lang,
+    displayLanguageId: lang,
+    langsToLoad: lang
+  };
+};
+function resolveTheme(themeInput) {
+  const isTextmateTheme = typeof themeInput === "object" && "tokenColors" in themeInput && Array.isArray(themeInput.tokenColors);
+  const isMultiThemeConfig = typeof themeInput === "object" && themeInput !== null && !isTextmateTheme;
+  const validMultiThemeObj = typeof themeInput === "object" && themeInput !== null && !isTextmateTheme && Object.entries(themeInput).some(
+    ([key, value]) => key && value && key.trim() !== "" && value !== "" && (typeof value === "string" || isTextmateTheme)
+  );
+  if (isMultiThemeConfig) {
+    const themeId = validMultiThemeObj ? `multi-${Object.values(themeInput).map(
+      (theme) => (typeof theme === "string" ? theme : theme?.name) || "custom"
+    ).sort().join("-")}` : "multi-default";
+    return {
+      isMultiTheme: true,
+      themeId,
+      multiTheme: validMultiThemeObj ? themeInput : null,
+      themesToLoad: validMultiThemeObj ? Object.values(themeInput) : []
+    };
+  }
+  return {
+    isMultiTheme: false,
+    themeId: typeof themeInput === "string" ? themeInput : themeInput?.name || "custom",
+    singleTheme: themeInput,
+    themesToLoad: [themeInput]
+  };
+}
+
+// src/lib/transformers.ts
+function lineNumbersTransformer(startLine = 1) {
+  return {
+    name: "react-shiki:line-numbers",
+    code(node) {
+      this.addClassToHast(node, "has-line-numbers");
+      if (startLine !== 1) {
+        const existingStyle = node.properties?.style || "";
+        const newStyle = existingStyle ? `${existingStyle}; --line-start: ${startLine}` : `--line-start: ${startLine}`;
+        node.properties = {
+          ...node.properties,
+          style: newStyle
+        };
+      }
+    },
+    line(node) {
+      this.addClassToHast(node, "line-numbers");
+      return node;
+    }
+  };
+}
+
+// src/lib/hook.ts
+var DEFAULT_THEMES = {
+  light: "github-light",
+  dark: "github-dark"
+};
+var useStableOptions = (value) => {
+  const ref = useRef(value);
+  const revision = useRef(0);
+  if (typeof value !== "object" || value === null) {
+    if (value !== ref.current) {
+      ref.current = value;
+      revision.current += 1;
+    }
+    return [value, revision.current];
+  }
+  if (value !== ref.current) {
+    if (!dequal(value, ref.current)) {
+      ref.current = value;
+      revision.current += 1;
+    }
+  }
+  return [ref.current, revision.current];
+};
+var useShikiHighlighter = (code, lang, themeInput, createHighlighter, options = {}) => {
+  const [highlightedCode, setHighlightedCode] = useState(null);
+  const [stableLang, langRev] = useStableOptions(lang);
+  const [stableTheme, themeRev] = useStableOptions(themeInput);
+  const [stableOpts, optsRev] = useStableOptions(options);
+  const { languageId, langsToLoad } = useMemo(
+    () => resolveLanguage(stableLang, stableOpts.customLanguages),
+    [stableLang, stableOpts.customLanguages]
+  );
+  const { isMultiTheme, themeId, multiTheme, singleTheme, themesToLoad } = useMemo(() => resolveTheme(stableTheme), [stableTheme]);
+  const timeoutControl = useRef({
+    nextAllowedTime: 0,
+    timeoutId: void 0
+  });
+  const shikiOptions = useMemo(() => {
+    const languageOption = { lang: languageId };
+    const {
+      defaultColor,
+      cssVariablePrefix,
+      showLineNumbers,
+      startingLineNumber,
+      ...restOptions
+    } = stableOpts;
+    const themeOptions = isMultiTheme ? {
+      themes: multiTheme || DEFAULT_THEMES,
+      defaultColor,
+      cssVariablePrefix
+    } : {
+      theme: singleTheme || DEFAULT_THEMES.dark
+    };
+    const transformers = restOptions.transformers || [];
+    if (showLineNumbers) {
+      transformers.push(lineNumbersTransformer(startingLineNumber));
+    }
+    return {
+      ...languageOption,
+      ...themeOptions,
+      ...restOptions,
+      transformers
+    };
+  }, [languageId, themeId, langRev, themeRev, optsRev]);
+  useEffect(() => {
+    let isMounted = true;
+    const highlightCode = async () => {
+      if (!languageId) return;
+      const highlighter = stableOpts.highlighter ? stableOpts.highlighter : await createHighlighter(
+        langsToLoad,
+        themesToLoad
+      );
+      const loadedLanguages = highlighter.getLoadedLanguages();
+      const langToUse = loadedLanguages.includes(languageId) ? languageId : "plaintext";
+      const finalOptions = { ...shikiOptions, lang: langToUse };
+      const hast = highlighter.codeToHast(code, finalOptions);
+      if (isMounted) {
+        setHighlightedCode(toJsxRuntime(hast, { jsx, jsxs, Fragment }));
+      }
+    };
+    const { delay } = stableOpts;
+    if (delay) {
+      throttleHighlighting(highlightCode, timeoutControl, delay);
+    } else {
+      highlightCode().catch(console.error);
+    }
+    return () => {
+      isMounted = false;
+      clearTimeout(timeoutControl.current.timeoutId);
+    };
+  }, [
+    code,
+    shikiOptions,
+    stableOpts.delay,
+    stableOpts.highlighter,
+    langsToLoad,
+    themesToLoad
+  ]);
+  return highlightedCode;
+};
+
+// #style-inject:#style-inject
+function styleInject(css, { insertAt } = {}) {
+  if (!css || typeof document === "undefined") return;
+  const head = document.head || document.getElementsByTagName("head")[0];
+  const style = document.createElement("style");
+  style.type = "text/css";
+  if (insertAt === "top") {
+    if (head.firstChild) {
+      head.insertBefore(style, head.firstChild);
+    } else {
+      head.appendChild(style);
+    }
+  } else {
+    head.appendChild(style);
+  }
+  if (style.styleSheet) {
+    style.styleSheet.cssText = css;
+  } else {
+    style.appendChild(document.createTextNode(css));
+  }
+}
+
+// src/lib/styles.css
+styleInject(".relative {\n  position: relative;\n}\n.defaultStyles pre {\n  overflow: auto;\n  border-radius: 0.5rem;\n  padding-left: 1.5rem;\n  padding-right: 1.5rem;\n  padding-top: 1.25rem;\n  padding-bottom: 1.25rem;\n}\n.languageLabel {\n  position: absolute;\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.line-numbers::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(--line-numbers-width, 2ch);\n  padding-left: var(--line-numbers-padding-left, 2ch);\n  padding-right: var(--line-numbers-padding-right, 2ch);\n  color: var(--line-numbers-foreground, rgba(107, 114, 128, 0.6));\n  font-size: var(--line-numbers-font-size, inherit);\n  font-weight: var(--line-numbers-font-weight, inherit);\n  line-height: var(--line-numbers-line-height, inherit);\n  font-family: var(--line-numbers-font-family, inherit);\n  opacity: var(--line-numbers-opacity, 1);\n  user-select: none;\n  pointer-events: none;\n}\n.has-line-numbers {\n  counter-reset: line-number calc(var(--line-start, 1) - 1);\n  --line-numbers-foreground: rgba(107, 114, 128, 0.5);\n  --line-numbers-width: 2ch;\n  --line-numbers-padding-left: 0ch;\n  --line-numbers-padding-right: 2ch;\n  --line-numbers-font-size: inherit;\n  --line-numbers-font-weight: inherit;\n  --line-numbers-line-height: inherit;\n  --line-numbers-font-family: inherit;\n  --line-numbers-opacity: 1;\n}\n");
+
+// src/lib/component.tsx
+import { clsx } from "clsx";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+var createShikiHighlighterComponent = (useShikiHighlighterImpl) => {
+  return ({
+    language,
+    theme,
+    delay,
+    transformers,
+    defaultColor,
+    cssVariablePrefix,
+    addDefaultStyles = true,
+    style,
+    langStyle,
+    className,
+    langClassName,
+    showLanguage = true,
+    showLineNumbers = false,
+    startingLineNumber = 1,
+    children: code,
+    as: Element = "pre",
+    customLanguages,
+    ...shikiOptions
+  }) => {
+    const options = {
+      delay,
+      transformers,
+      customLanguages,
+      defaultColor,
+      cssVariablePrefix,
+      showLineNumbers,
+      startingLineNumber,
+      ...shikiOptions
+    };
+    const { displayLanguageId } = resolveLanguage(
+      language,
+      customLanguages
+    );
+    const highlightedCode = useShikiHighlighterImpl(
+      code,
+      language,
+      theme,
+      options
+    );
+    return /* @__PURE__ */ jsxs2(
+      Element,
+      {
+        "data-testid": "shiki-container",
+        className: clsx(
+          "relative",
+          "not-prose",
+          addDefaultStyles && "defaultStyles",
+          className
+        ),
+        style,
+        id: "shiki-container",
+        children: [
+          showLanguage && displayLanguageId ? /* @__PURE__ */ jsx2(
+            "span",
+            {
+              className: clsx("languageLabel", langClassName),
+              style: langStyle,
+              id: "language-label",
+              children: displayLanguageId
+            }
+          ) : null,
+          highlightedCode
+        ]
+      }
+    );
+  };
+};
+
+export {
+  rehypeInlineCodeProperty,
+  isInlineCode,
+  useShikiHighlighter,
+  createShikiHighlighterComponent
+};
+//# sourceMappingURL=chunk-RZ35JRPP.js.map

package/dist/chunk-RZ35JRPP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/utils.ts","../src/lib/hook.ts","../src/lib/resolvers.ts","../src/lib/transformers.ts","#style-inject:#style-inject","../src/lib/styles.css","../src/lib/component.tsx"],"sourcesContent":["import { visit } from 'unist-util-visit';\n\nimport type { TimeoutState, 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: any): undefined => {\n    visit(tree, 'element', (node: Element, _index, parent: Element) => {\n      if (node.tagName === 'code' && parent.tagName !== 'pre') {\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\n/**\n * Optionally throttles rapid sequential highlighting operations\n * Exported for testing in __tests__/throttleHighlighting.test.ts\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  const now = Date.now();\n  clearTimeout(timeoutControl.current.timeoutId);\n\n  const delay = Math.max(0, timeoutControl.current.nextAllowedTime - now);\n  timeoutControl.current.timeoutId = setTimeout(() => {\n    performHighlight().catch(console.error);\n    timeoutControl.current.nextAllowedTime = now + throttleMs;\n  }, delay);\n};\n","import {\n  useEffect,\n  useMemo,\n  useRef,\n  useState,\n  type ReactNode,\n} from 'react';\n\nimport { dequal } from 'dequal/lite';\n\nimport { jsx, jsxs, Fragment } from 'react/jsx-runtime';\nimport { toJsxRuntime } from 'hast-util-to-jsx-runtime';\n\nimport type {\n  CodeToHastOptions,\n  CodeOptionsSingleTheme,\n  CodeOptionsMultipleThemes,\n  Highlighter,\n  HighlighterCore,\n} from 'shiki';\n\nimport type { ShikiLanguageRegistration } from './extended-types';\n\nimport type {\n  Language,\n  Theme,\n  HighlighterOptions,\n  TimeoutState,\n  Themes,\n} from './types';\n\nimport { throttleHighlighting } from './utils';\nimport { resolveLanguage, resolveTheme } from './resolvers';\nimport { lineNumbersTransformer } from './transformers';\n\nconst DEFAULT_THEMES: Themes = {\n  light: 'github-light',\n  dark: 'github-dark',\n};\n\n/**\n * Returns a deep-stable reference and a version counter that only changes when content changes.\n * Includes optimizations for primitive values and reference equality.\n */\nconst useStableOptions = <T>(value: T) => {\n  const ref = useRef(value);\n  const revision = useRef(0);\n\n  // Fast-path for primitive values\n  if (typeof value !== 'object' || value === null) {\n    if (value !== ref.current) {\n      ref.current = value;\n      revision.current += 1;\n    }\n    return [value, revision.current] as const;\n  }\n\n  // Reference equality check before expensive deep comparison\n  if (value !== ref.current) {\n    if (!dequal(value, ref.current)) {\n      ref.current = value;\n      revision.current += 1;\n    }\n  }\n\n  return [ref.current, revision.current] as const;\n};\n\n/**\n * Base hook for syntax highlighting using Shiki.\n * This is the core implementation used by all entry points.\n *\n * @param code - The code to highlight\n * @param lang - Language for highlighting\n * @param themeInput - Theme or themes to use\n * @param options - Highlighting options\n * @param createHighlighter - Factory function to create highlighter (internal use)\n */\nexport const useShikiHighlighter = (\n  code: string,\n  lang: Language,\n  themeInput: Theme | Themes,\n  createHighlighter: (\n    langsToLoad: ShikiLanguageRegistration,\n    themesToLoad: Theme[]\n  ) => Promise<Highlighter | HighlighterCore>,\n  options: HighlighterOptions = {}\n) => {\n  const [highlightedCode, setHighlightedCode] =\n    useState<ReactNode | null>(null);\n\n  // Stabilize options, language and theme inputs to prevent unnecessary\n  // re-renders or recalculations when object references change\n  const [stableLang, langRev] = useStableOptions(lang);\n  const [stableTheme, themeRev] = useStableOptions(themeInput);\n  const [stableOpts, optsRev] = useStableOptions(options);\n\n  const { languageId, langsToLoad } = useMemo(\n    () => resolveLanguage(stableLang, stableOpts.customLanguages),\n    [stableLang, stableOpts.customLanguages]\n  );\n\n  const { isMultiTheme, themeId, multiTheme, singleTheme, themesToLoad } =\n    useMemo(() => resolveTheme(stableTheme), [stableTheme]);\n\n  const timeoutControl = useRef<TimeoutState>({\n    nextAllowedTime: 0,\n    timeoutId: undefined,\n  });\n\n  const shikiOptions = useMemo<CodeToHastOptions>(() => {\n    const languageOption = { lang: languageId };\n    const {\n      defaultColor,\n      cssVariablePrefix,\n      showLineNumbers,\n      startingLineNumber,\n      ...restOptions\n    } = stableOpts;\n\n    const themeOptions = isMultiTheme\n      ? ({\n          themes: multiTheme || DEFAULT_THEMES,\n          defaultColor,\n          cssVariablePrefix,\n        } as CodeOptionsMultipleThemes)\n      : ({\n          theme: singleTheme || DEFAULT_THEMES.dark,\n        } as CodeOptionsSingleTheme);\n\n    // Add line numbers transformer if enabled\n    const transformers = restOptions.transformers || [];\n    if (showLineNumbers) {\n      transformers.push(lineNumbersTransformer(startingLineNumber));\n    }\n\n    return {\n      ...languageOption,\n      ...themeOptions,\n      ...restOptions,\n      transformers,\n    };\n  }, [languageId, themeId, langRev, themeRev, optsRev]);\n\n  useEffect(() => {\n    let isMounted = true;\n\n    const highlightCode = async () => {\n      if (!languageId) return;\n\n      // Use provided custom highlighter or create one using the factory\n      const highlighter = stableOpts.highlighter\n        ? stableOpts.highlighter\n        : await createHighlighter(\n            langsToLoad as ShikiLanguageRegistration,\n            themesToLoad\n          );\n\n      // Check if language is loaded, fallback to plaintext if not\n      const loadedLanguages = highlighter.getLoadedLanguages();\n      const langToUse = loadedLanguages.includes(languageId)\n        ? languageId\n        : 'plaintext';\n      const finalOptions = { ...shikiOptions, lang: langToUse };\n\n      const hast = highlighter.codeToHast(code, finalOptions);\n\n      if (isMounted) {\n        setHighlightedCode(toJsxRuntime(hast, { jsx, jsxs, Fragment }));\n      }\n    };\n\n    const { delay } = stableOpts;\n\n    if (delay) {\n      throttleHighlighting(highlightCode, timeoutControl, delay);\n    } else {\n      highlightCode().catch(console.error);\n    }\n\n    return () => {\n      isMounted = false;\n      clearTimeout(timeoutControl.current.timeoutId);\n    };\n  }, [\n    code,\n    shikiOptions,\n    stableOpts.delay,\n    stableOpts.highlighter,\n    langsToLoad,\n    themesToLoad,\n  ]);\n\n  return highlightedCode;\n};\n","import type { Language, Theme, Themes } from './types';\nimport type { ThemeRegistrationAny } from 'shiki/core';\nimport type { LanguageRegistration } from './extended-types';\n\n/**\n * Resolved languages and metadata\n */\ntype LanguageResult = {\n  languageId: string;\n  displayLanguageId: string | null;\n  langsToLoad: Language;\n};\n\n/**\n * Resolves the language input to standardized IDs and objects for Shiki and UI display\n * @param lang The language input from props\n * @param customLanguages An array of custom textmate grammar objects or a single grammar object\n * @returns A LanguageResult object containing:\n *   - languageId: The resolved language ID\n *   - displayLanguageId: The display language ID\n *   - langToLoad: The language object or string id to load\n */\nexport const resolveLanguage = (\n  lang: Language,\n  customLanguages?: LanguageRegistration | LanguageRegistration[]\n): LanguageResult => {\n  const normalizedCustomLangs = customLanguages\n    ? Array.isArray(customLanguages)\n      ? customLanguages\n      : [customLanguages]\n    : [];\n\n  // Language is null or empty string\n  if (lang == null || (typeof lang === 'string' && !lang.trim())) {\n    return {\n      languageId: 'plaintext',\n      displayLanguageId: 'plaintext',\n      langsToLoad: undefined,\n    };\n  }\n\n  // Language is custom\n  if (typeof lang === 'object') {\n    return {\n      languageId: lang.name,\n      displayLanguageId: lang.name || null,\n      langsToLoad: lang,\n    };\n  }\n\n  // Language is string\n  const lowerLang = lang.toLowerCase();\n  const matches = (str: string | undefined): boolean =>\n    str?.toLowerCase() === lowerLang;\n\n  // Check if the string identifies a provided custom language\n  const customMatch = normalizedCustomLangs.find(\n    (cl) =>\n      matches(cl.name) ||\n      matches(cl.scopeName) ||\n      matches(cl.scopeName?.split('.').pop()) ||\n      cl.aliases?.some(matches) ||\n      cl.fileTypes?.some(matches)\n  );\n\n  if (customMatch) {\n    return {\n      languageId: customMatch.name || lang,\n      displayLanguageId: lang,\n      langsToLoad: customMatch,\n    };\n  }\n\n  // For any other string, pass it through,\n  // fallback is handled in highlighter factories\n  return {\n    languageId: lang,\n    displayLanguageId: lang,\n    langsToLoad: lang,\n  };\n};\n\n/**\n * Resolved themes and metadata\n */\ninterface ThemeResult {\n  isMultiTheme: boolean;\n  themeId: Theme;\n  multiTheme?: Themes | ThemeRegistrationAny | null;\n  singleTheme?: Theme | undefined;\n  themesToLoad: Theme[];\n}\n\n/**\n * Determines theme configuration and returns the resolved theme with metadata\n * @param themeInput - The theme input, either as a string name or theme object\n * @returns Object containing:\n *   - isMultiTheme: If theme input is a multi-theme configuration\n *   - themeId: Theme reference identifier\n *   - multiTheme: The multi-theme config if it exists\n *   - singleTheme: The single theme if it exists\n *   - themesToLoad: The themes to load when creating the highlighter\n */\nexport function resolveTheme(themeInput: Theme | Themes): ThemeResult {\n  const isTextmateTheme =\n    typeof themeInput === 'object' &&\n    'tokenColors' in themeInput &&\n    Array.isArray(themeInput.tokenColors);\n\n  // Assume non textmate objects are multi theme configs\n  const isMultiThemeConfig =\n    typeof themeInput === 'object' &&\n    themeInput !== null &&\n    !isTextmateTheme;\n\n  const validMultiThemeObj =\n    typeof themeInput === 'object' &&\n    themeInput !== null &&\n    !isTextmateTheme &&\n    Object.entries(themeInput).some(\n      ([key, value]) =>\n        key &&\n        value &&\n        key.trim() !== '' &&\n        value !== '' &&\n        (typeof value === 'string' || isTextmateTheme)\n    );\n\n  if (isMultiThemeConfig) {\n    const themeId = validMultiThemeObj\n      ? `multi-${Object.values(themeInput)\n          .map(\n            (theme) =>\n              (typeof theme === 'string' ? theme : theme?.name) ||\n              'custom'\n          )\n          .sort()\n          .join('-')}`\n      : 'multi-default';\n\n    // If config is invalid, return null to handle fallback in `buildShikiOptions()`\n    return {\n      isMultiTheme: true,\n      themeId,\n      multiTheme: validMultiThemeObj ? themeInput : null,\n      themesToLoad: validMultiThemeObj ? Object.values(themeInput) : [],\n    };\n  }\n\n  return {\n    isMultiTheme: false,\n    themeId:\n      typeof themeInput === 'string'\n        ? themeInput\n        : themeInput?.name || 'custom',\n    singleTheme: themeInput,\n    themesToLoad: [themeInput],\n  };\n}\n","import type { ShikiTransformer } from 'shiki/core';\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, 'has-line-numbers');\n      if (startLine !== 1) {\n        const existingStyle = (node.properties?.style as string) || '';\n        const newStyle = existingStyle\n          ? `${existingStyle}; --line-start: ${startLine}`\n          : `--line-start: ${startLine}`;\n        node.properties = {\n          ...node.properties,\n          style: newStyle,\n        };\n      }\n    },\n    line(node) {\n      this.addClassToHast(node, 'line-numbers');\n      return node;\n    },\n  };\n}\n","\n          export default function styleInject(css, { insertAt } = {}) {\n            if (!css || typeof document === 'undefined') return\n          \n            const head = document.head || document.getElementsByTagName('head')[0]\n            const style = document.createElement('style')\n            style.type = 'text/css'\n          \n            if (insertAt === 'top') {\n              if (head.firstChild) {\n                head.insertBefore(style, head.firstChild)\n              } else {\n                head.appendChild(style)\n              }\n            } else {\n              head.appendChild(style)\n            }\n          \n            if (style.styleSheet) {\n              style.styleSheet.cssText = css\n            } else {\n              style.appendChild(document.createTextNode(css))\n            }\n          }\n          ","import styleInject from '#style-inject';styleInject(\".relative {\\n  position: relative;\\n}\\n.defaultStyles pre {\\n  overflow: auto;\\n  border-radius: 0.5rem;\\n  padding-left: 1.5rem;\\n  padding-right: 1.5rem;\\n  padding-top: 1.25rem;\\n  padding-bottom: 1.25rem;\\n}\\n.languageLabel {\\n  position: absolute;\\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.line-numbers::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(--line-numbers-width, 2ch);\\n  padding-left: var(--line-numbers-padding-left, 2ch);\\n  padding-right: var(--line-numbers-padding-right, 2ch);\\n  color: var(--line-numbers-foreground, rgba(107, 114, 128, 0.6));\\n  font-size: var(--line-numbers-font-size, inherit);\\n  font-weight: var(--line-numbers-font-weight, inherit);\\n  line-height: var(--line-numbers-line-height, inherit);\\n  font-family: var(--line-numbers-font-family, inherit);\\n  opacity: var(--line-numbers-opacity, 1);\\n  user-select: none;\\n  pointer-events: none;\\n}\\n.has-line-numbers {\\n  counter-reset: line-number calc(var(--line-start, 1) - 1);\\n  --line-numbers-foreground: rgba(107, 114, 128, 0.5);\\n  --line-numbers-width: 2ch;\\n  --line-numbers-padding-left: 0ch;\\n  --line-numbers-padding-right: 2ch;\\n  --line-numbers-font-size: inherit;\\n  --line-numbers-font-weight: inherit;\\n  --line-numbers-line-height: inherit;\\n  --line-numbers-font-family: inherit;\\n  --line-numbers-opacity: 1;\\n}\\n\")","import './styles.css';\nimport { clsx } from 'clsx';\nimport { resolveLanguage } from './resolvers';\n\nimport type {\n  HighlighterOptions,\n  Language,\n  Theme,\n  Themes,\n} from './types';\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   * Whether to show line numbers\n   * @default false\n   */\n  showLineNumbers?: boolean;\n\n  /**\n   * Starting line number (when showLineNumbers is true)\n   * @default 1\n   */\n  startingLineNumber?: number;\n\n  /**\n   * The HTML element that wraps the generated code block.\n   * @default 'pre'\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: (\n    code: string,\n    lang: Language,\n    themeInput: Theme | Themes,\n    options?: HighlighterOptions\n  ) => React.ReactNode\n) => {\n  return ({\n    language,\n    theme,\n    delay,\n    transformers,\n    defaultColor,\n    cssVariablePrefix,\n    addDefaultStyles = true,\n    style,\n    langStyle,\n    className,\n    langClassName,\n    showLanguage = true,\n    showLineNumbers = false,\n    startingLineNumber = 1,\n    children: code,\n    as: Element = 'pre',\n    customLanguages,\n    ...shikiOptions\n  }: ShikiHighlighterProps): React.ReactElement => {\n    const options: HighlighterOptions = {\n      delay,\n      transformers,\n      customLanguages,\n      defaultColor,\n      cssVariablePrefix,\n      showLineNumbers,\n      startingLineNumber,\n      ...shikiOptions,\n    };\n\n    // Use resolveLanguage to get displayLanguageId directly\n    const { displayLanguageId } = resolveLanguage(\n      language,\n      customLanguages\n    );\n\n    const highlightedCode = useShikiHighlighterImpl(\n      code,\n      language,\n      theme,\n      options\n    );\n\n    return (\n      <Element\n        data-testid=\"shiki-container\"\n        className={clsx(\n          'relative',\n          'not-prose',\n          addDefaultStyles && 'defaultStyles',\n          className\n        )}\n        style={style}\n        id=\"shiki-container\"\n      >\n        {showLanguage && displayLanguageId ? (\n          <span\n            className={clsx('languageLabel', langClassName)}\n            style={langStyle}\n            id=\"language-label\"\n          >\n            {displayLanguageId}\n          </span>\n        ) : null}\n        {highlightedCode}\n      </Element>\n    );\n  };\n};\n"],"mappings":"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","names":["jsx","jsxs"]}

package/dist/component-DU2-v6BV.d.ts

@@ -0,0 +1,229 @@
+import { Highlighter, HighlighterCore, CodeOptionsMultipleThemes, BundledTheme, CodeToHastOptions, StringLiteralUnion, BundledLanguage, SpecialLanguage, ThemeRegistrationAny } from 'shiki';
+import { ReactNode } from 'react';
+import { LanguageRegistration as LanguageRegistration$1 } from 'shiki/core';
+import { Element as Element$1 } from 'hast';
+
+/**
+ * Attribution:
+ *  This code was written by github:hippotastic in expressive-code/expressive-code
+ *  https://github.com/expressive-code/expressive-code/blob/main/packages/%40expressive-code/plugin-shiki/src/languages.ts
+ */
+
+type IShikiRawRepository = LanguageRegistration$1['repository'];
+type IShikiRawRule = IShikiRawRepository[keyof IShikiRawRepository];
+type ILocation = IShikiRawRepository['$vscodeTextmateLocation'];
+interface ILocatable {
+    readonly $vscodeTextmateLocation?: ILocation;
+}
+interface IRawRepositoryMap {
+    [name: string]: IRawRule;
+}
+type IRawRepository = IRawRepositoryMap & ILocatable;
+interface IRawCapturesMap {
+    [captureId: string]: IRawRule;
+}
+type IRawCaptures = IRawCapturesMap & ILocatable;
+interface IRawRule extends Omit<IShikiRawRule, 'applyEndPatternLast' | 'captures' | 'patterns'> {
+    readonly applyEndPatternLast?: boolean | number;
+    readonly captures?: IRawCaptures;
+    readonly comment?: string;
+    readonly patterns?: IRawRule[];
+}
+/**
+ * A less strict version of Shiki's `LanguageRegistration` interface that aligns better with
+ * actual grammars found in the wild. This version attempts to reduce the amount
+ * of type errors that would occur when importing and adding external grammars,
+ * while still being supported by the language processing code.
+ */
+interface LanguageRegistration extends Omit<LanguageRegistration$1, 'repository'> {
+    repository?: IRawRepository;
+}
+
+/**
+ * HTML Element, use to type `node` from react-markdown
+ */
+type Element = Element$1;
+/**
+ * A Shiki BundledLanguage or a custom textmate grammar object
+ * @see https://shiki.style/languages
+ */
+type Language = LanguageRegistration | StringLiteralUnion<BundledLanguage | SpecialLanguage> | undefined;
+/**
+ * A Shiki BundledTheme or a custom textmate theme object
+ * @see https://shiki.style/themes
+ */
+type Theme = ThemeRegistrationAny | StringLiteralUnion<BundledTheme>;
+/**
+ * A map of color names to themes.
+ * This allows you to specify multiple themes for the generated code.
+ * Supports custom textmate theme objects in addition to Shiki's bundled themes
+ *
+ * @example
+ * ```ts
+ * useShikiHighlighter(code, language, {
+ *   light: 'github-light',
+ *   dark: 'github-dark',
+ *   dim: 'github-dark-dimmed'
+ * })
+ * ```
+ *
+ * @see https://shiki.style/guide/dual-themes
+ */
+type Themes = {
+    [key: string]: ThemeRegistrationAny | StringLiteralUnion<BundledTheme>;
+};
+/**
+ * Configuration options specific to react-shiki
+ */
+interface ReactShikiOptions {
+    /**
+     * Minimum time (in milliseconds) between highlight operations.
+     * @default undefined (no throttling)
+     */
+    delay?: number;
+    /**
+     * Custom textmate grammars to be preloaded for highlighting.
+     */
+    customLanguages?: LanguageRegistration | LanguageRegistration[];
+    /**
+     * Custom Shiki highlighter instance to use instead of the default one.
+     * Keeps bundle small by only importing specified languages/themes.
+     * Can be either a Highlighter or HighlighterCore instance.
+     *
+     * @example
+     * import {
+     *   createHighlighterCore,
+     *   createOnigurumaEngine,
+     *   useShikiHighlighter
+     * } from "react-shiki";
+     *
+     * const customHighlighter = await createHighlighterCore({
+     *   themes: [
+     *     import('@shikijs/themes/nord')
+     *   ],
+     *   langs: [
+     *     import('@shikijs/langs/javascript'),
+     *     import('@shikijs/langs/typescript')
+     *   ],
+     *   engine: createOnigurumaEngine(import('shiki/wasm'))
+     * });
+     *
+     * const highlightedCode = useShikiHighlighter(code, language, theme, {
+     *   highlighter: customHighlighter,
+     * });
+     */
+    highlighter?: Highlighter | HighlighterCore;
+    /**
+     * Whether to show line numbers
+     * @default false
+     */
+    showLineNumbers?: boolean;
+    /**
+     * Starting line number (when showLineNumbers is true)
+     * @default 1
+     */
+    startingLineNumber?: 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'> {
+}
+/**
+ * Public API signature for the useShikiHighlighter hook.
+ * This ensures all entry points have consistent signatures.
+ */
+type UseShikiHighlighter = (code: string, lang: Language, themeInput: Theme | Themes, options?: HighlighterOptions) => ReactNode;
+
+/**
+ * Rehype plugin to add an 'inline' property to <code> elements
+ * Sets 'inline' property to true if the <code> is not within a <pre> tag
+ *
+ * Pass this plugin to the `rehypePlugins` prop of react-markdown
+ * You can then access `inline` as a prop in components passed to react-markdown
+ *
+ * @example
+ * <ReactMarkdown rehypePlugins={[rehypeInlineCodeProperty]} />
+ */
+declare function rehypeInlineCodeProperty(): (tree: any) => undefined;
+/**
+ * Function to determine if code is inline based on the presence of line breaks
+ *
+ * @example
+ * const isInline = node && isInlineCode(node: Element)
+ */
+declare const isInlineCode: (node: Element) => boolean;
+
+/**
+ * Props for the ShikiHighlighter component
+ */
+interface ShikiHighlighterProps extends HighlighterOptions {
+    /**
+     * The programming language for syntax highlighting
+     * Supports custom textmate grammar objects in addition to Shiki's bundled languages
+     * @see https://shiki.style/languages
+     */
+    language: Language;
+    /**
+     * The code to be highlighted
+     */
+    children: string;
+    /**
+     * The color theme or themes for syntax highlighting
+     * Supports single, dual, or multiple themes
+     * Supports custom textmate theme objects in addition to Shiki's bundled themes
+     *
+     * @example
+     * theme='github-dark' // single theme
+     * theme={{ light: 'github-light', dark: 'github-dark' }} // multi-theme
+     *
+     * @see https://shiki.style/themes
+     */
+    theme: Theme | Themes;
+    /**
+     * Controls the application of default styles to the generated code blocks
+     *
+     * Default styles include padding, overflow handling, border radius, language label styling, and font settings
+     * @default true
+     */
+    addDefaultStyles?: boolean;
+    /**
+     * Add custom inline styles to the generated code block
+     */
+    style?: React.CSSProperties;
+    /**
+     * Add custom inline styles to the language label
+     */
+    langStyle?: React.CSSProperties;
+    /**
+     * Add custom CSS class names to the generated code block
+     */
+    className?: string;
+    /**
+     * Add custom CSS class names to the language label
+     */
+    langClassName?: string;
+    /**
+     * Whether to show the language label
+     * @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 'pre'
+     */
+    as?: React.ElementType;
+}
+
+export { type Element as E, type HighlighterOptions as H, type Language as L, type ShikiHighlighterProps as S, type Theme as T, type UseShikiHighlighter as U, type Themes as a, isInlineCode as i, rehypeInlineCodeProperty as r };

package/dist/core.d.ts

@@ -0,0 +1,38 @@
+import { S as ShikiHighlighterProps, U as UseShikiHighlighter } from './component-DU2-v6BV.js';
+export { E as Element, H as HighlighterOptions, L as Language, T as Theme, a as Themes, i as isInlineCode, r as rehypeInlineCodeProperty } from './component-DU2-v6BV.js';
+export { createHighlighterCore } from 'shiki/core';
+export { createOnigurumaEngine } from 'shiki/engine/oniguruma';
+export { createJavaScriptRegexEngine } from 'shiki/engine/javascript';
+import 'shiki';
+import 'react';
+import 'hast';
+
+/**
+ * A React hook that provides syntax highlighting using Shiki with a custom highlighter.
+ * Requires a highlighter to be provided in options for minimal bundle size.
+ *
+ * @example
+ * ```ts
+ * import { createHighlighterCore, createOnigurumaEngine } from 'react-shiki/core';
+ *
+ * const highlighter = await createHighlighterCore({
+ *   themes: [import('@shikijs/themes/nord')],
+ *   langs: [import('@shikijs/langs/typescript')],
+ *   engine: createOnigurumaEngine(import('shiki/wasm'))
+ * });
+ *
+ * const code = useShikiHighlighter(code, 'typescript', 'nord', { highlighter });
+ * ```
+ *
+ * For plug-and-play usage, consider:
+ * - `react-shiki` for full shiki bundle (~6.4MB minified, 1.2MB gzipped)
+ * - `react-shiki/web` for smaller shiki web bundle (~3.8MB minified, 695KB gzipped)
+ */
+declare const useShikiHighlighter: UseShikiHighlighter;
+/**
+ * ShikiHighlighter component using a custom highlighter.
+ * Requires a highlighter to be provided.
+ */
+declare const ShikiHighlighter: ({ language, theme, delay, transformers, defaultColor, cssVariablePrefix, addDefaultStyles, style, langStyle, className, langClassName, showLanguage, showLineNumbers, startingLineNumber, children: code, as: Element, customLanguages, ...shikiOptions }: ShikiHighlighterProps) => React.ReactElement;
+
+export { ShikiHighlighter, ShikiHighlighterProps, UseShikiHighlighter, ShikiHighlighter as default, useShikiHighlighter };