@mui/internal-docs-infra 0.3.1-canary.1 → 0.3.1-canary.3

package/esm/CodeHighlighter/CodeHighlighter.js

@@ -10,7 +10,7 @@ import { loadCodeFallback } from "../pipeline/loadCodeVariant/loadCodeFallback.j
 import { CodeHighlighterClient } from "./CodeHighlighterClient.js";
 import { maybeCodeInitialData } from "../pipeline/loadCodeVariant/maybeCodeInitialData.js";
 import { hasAllVariants } from "../pipeline/loadCodeVariant/hasAllCodeVariants.js";
-import { getFileNameFromUrl } from "../pipeline/loaderUtils/getFileNameFromUrl.js";
+import { getFileNameFromUrl, getLanguageFromExtension } from "../pipeline/loaderUtils/index.js";
 import { codeToFallbackProps } from "./codeToFallbackProps.js";
 import * as Errors from "./errors.js";
 import { jsx as _jsx } from "react/jsx-runtime";
@@ -375,9 +375,16 @@ export function CodeHighlighter(props) {
   var code = props.code;
   if (props.children && typeof props.children === 'string') {
     var fileName = props.fileName || (props.url ? getFileNameFromUrl(props.url).fileName : undefined);
+    // Derive language: use explicit prop, or derive from fileName extension
+    var language = props.language;
+    if (!language && fileName) {
+      var extension = fileName.slice(fileName.lastIndexOf('.'));
+      language = getLanguageFromExtension(extension);
+    }
     code = {
       Default: {
         fileName: fileName,
+        language: language,
         source: props.children,
         url: props.url
       }

package/esm/CodeHighlighter/types.d.ts

@@ -6,6 +6,8 @@ export type Components = {
 type CodeMeta = {
   /** Name of the file (e.g., 'Button.tsx') */
   fileName?: string;
+  /** Language for syntax highlighting (e.g., 'tsx', 'css'). When provided, fileName is not required. */
+  language?: string;
   /** Flattened path for the file */
   path?: string;
 };
@@ -37,6 +39,8 @@ export type VariantExtraFiles = {
   [fileName: string]: string | {
     /** Source content for this file */
     source?: VariantSource;
+    /** Language for syntax highlighting (e.g., 'tsx', 'css'). Derived from fileName extension if not provided. */
+    language?: string;
     /** Transformations that can be applied to this file */
     transforms?: Transforms;
     /** Skip generating source transformers for this file */
@@ -123,7 +127,7 @@ export type TransformSource = (source: string, fileName: string) => Promise<Reco
   source: string;
   fileName?: string;
 }> | undefined>;
-export type ParseSource = (source: string, fileName: string) => HastRoot;
+export type ParseSource = (source: string, fileName: string, language?: string) => HastRoot;
 export type SourceTransformer = {
   extensions: string[];
   transformer: TransformSource;
@@ -190,6 +194,8 @@ export interface CodeContentProps {
   variant?: string;
   /** Currently selected file name */
   fileName?: string;
+  /** Language for syntax highlighting (e.g., 'tsx', 'css'). When provided, fileName is not required for parsing. */
+  language?: string;
   /** Default variant to show on first load */
   initialVariant?: string;
   /** Fallback variant when the requested variant is not available */

package/esm/createSitemap/types.d.ts

@@ -35,15 +35,9 @@ export interface SitemapPage {
   exports?: Record<string, SitemapExport>;
   tags?: string[];
   skipDetailSection?: boolean;
-  openGraph?: {
-    title?: string;
-    description?: string;
-    images?: Array<{
-      url: string;
-      width: number;
-      height: number;
-      alt: string;
-    }>;
+  image?: {
+    url: string;
+    alt?: string;
   };
 }
 /**

package/esm/pipeline/loadCodeVariant/loadCodeFallback.js

@@ -5,7 +5,7 @@ import _extends from "@babel/runtime/helpers/esm/extends";
 import _regenerator from "@babel/runtime/helpers/esm/regenerator";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import { loadCodeVariant } from "./loadCodeVariant.js";
-import { getFileNameFromUrl } from "../loaderUtils/index.js";
+import { getFileNameFromUrl, getLanguageFromExtension } from "../loaderUtils/index.js";
 import { performanceMeasure } from "../loadPrecomputedCodeHighlighter/performanceLogger.js";
 
 // Helper function to get the source for a specific filename from a variant
@@ -110,6 +110,8 @@ function _loadCodeFallback() {
       result,
       parseSource,
       quickVariant,
+      derivedFileName,
+      extension,
       beforeInitialVariantMark,
       _allFileNames2,
       _fileSource,
@@ -307,9 +309,12 @@ function _loadCodeFallback() {
           break;
         case 20:
           // Create a basic variant using fallback logic
+          derivedFileName = getFileNameFromUrl(initial).fileName;
+          extension = derivedFileName.slice(derivedFileName.lastIndexOf('.'));
           quickVariant = {
             url: initial,
-            fileName: getFileNameFromUrl(initial).fileName
+            fileName: derivedFileName,
+            language: getLanguageFromExtension(extension)
           };
         case 21:
           beforeInitialVariantMark = currentMark;

package/esm/pipeline/loadCodeVariant/loadCodeVariant.js

@@ -10,7 +10,7 @@ import { compress, strToU8 } from 'fflate';
 import { encode } from 'uint8-to-base64';
 import { transformSource } from "./transformSource.js";
 import { diffHast } from "./diffHast.js";
-import { getFileNameFromUrl } from "../loaderUtils/index.js";
+import { getFileNameFromUrl, getLanguageFromExtension, normalizeLanguage } from "../loaderUtils/index.js";
 import { mergeExternals } from "../loaderUtils/mergeExternals.js";
 import { performanceMeasure } from "../loadPrecomputedCodeHighlighter/performanceLogger.js";
 function compressAsync(input) {
@@ -144,6 +144,7 @@ function _loadSingleFile() {
     var options,
       allFilesListed,
       knownExtraFiles,
+      language,
       _options$disableTrans,
       disableTransforms,
       _options$disableParsi,
@@ -184,6 +185,7 @@ function _loadSingleFile() {
           options = _args.length > 9 && _args[9] !== undefined ? _args[9] : {};
           allFilesListed = _args.length > 10 && _args[10] !== undefined ? _args[10] : false;
           knownExtraFiles = _args.length > 11 && _args[11] !== undefined ? _args[11] : new Set();
+          language = _args.length > 12 ? _args[12] : undefined;
           _options$disableTrans = options.disableTransforms, disableTransforms = _options$disableTrans === void 0 ? false : _options$disableTrans, _options$disableParsi = options.disableParsing, disableParsing = _options$disableParsi === void 0 ? false : _options$disableParsi;
           finalSource = source;
           functionName = 'Load Variant File';
@@ -367,7 +369,7 @@ function _loadSingleFile() {
           return sourceParser;
         case 24:
           parseSource = _context.v;
-          finalSource = parseSource(finalSource, fileName);
+          finalSource = parseSource(finalSource, fileName, language);
           currentMark = performanceMeasure(currentMark, {
             mark: 'Parsed File',
             measure: 'File Parsing'
@@ -504,7 +506,7 @@ function _loadExtraFiles() {
           allExternals = {}; // Start loading all extra files in parallel
           extraFilePromises = Object.entries(extraFiles).map(/*#__PURE__*/function () {
             var _ref2 = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(_ref) {
-              var _ref3, fileName, fileData, fileUrl, sourceData, transforms, fileResult, filesUsedFromFile, externalsFromFile, _t5;
+              var _ref3, fileName, fileData, fileUrl, sourceData, transforms, extraFileExtension, extraFileLanguage, fileResult, filesUsedFromFile, externalsFromFile, _t5;
               return _regenerator().w(function (_context2) {
                 while (1) switch (_context2.p = _context2.n) {
                   case 0:
@@ -533,11 +535,14 @@ function _loadExtraFiles() {
                     transforms = fileData.transforms;
                     fileUrl = baseUrl; // Use base URL as fallback
                   case 4:
+                    // Derive language from fileName for extra files
+                    extraFileExtension = fileName.slice(fileName.lastIndexOf('.'));
+                    extraFileLanguage = getLanguageFromExtension(extraFileExtension); // Load the file (this will handle recursive extra files)
                     _context2.n = 5;
                     return loadSingleFile(variantName, fileName, sourceData, fileUrl, loadSource, sourceParser, sourceTransformers, loadSourceCache, transforms, _extends(_extends({}, options), {}, {
                       maxDepth: maxDepth - 1,
                       loadedFiles: new Set(loadedFiles)
-                    }), allFilesListed, knownExtraFiles);
+                    }), allFilesListed, knownExtraFiles, extraFileLanguage);
                   case 5:
                     fileResult = _context2.v;
                     // Collect files used from this file load
@@ -582,7 +587,7 @@ function _loadExtraFiles() {
           _iterator2 = _createForOfIteratorHelper(extraFileResults);
           _context4.p = 3;
           _loop = /*#__PURE__*/_regenerator().m(function _loop() {
-            var _step2$value, fileName, result, filesUsed, externals, normalizedFileName, originalFileData, metadata, mergedExternals, sourceFileUrl, fileData;
+            var _step2$value, fileName, result, filesUsed, externals, normalizedFileName, originalFileData, metadata, extraFileExtension, extraFileLanguage, mergedExternals, sourceFileUrl, fileData;
             return _regenerator().w(function (_context3) {
               while (1) switch (_context3.n) {
                 case 0:
@@ -594,10 +599,17 @@ function _loadExtraFiles() {
                   } else if (globalsFileKeys.has(fileName)) {
                     metadata = true;
                   }
-                  processedExtraFiles[normalizedFileName] = _extends({
-                    source: result.source,
+
+                  // Derive language from fileName extension for extra files
+                  extraFileExtension = normalizedFileName.slice(normalizedFileName.lastIndexOf('.'));
+                  extraFileLanguage = getLanguageFromExtension(extraFileExtension);
+                  processedExtraFiles[normalizedFileName] = _extends(_extends(_extends({
+                    source: result.source
+                  }, extraFileLanguage && {
+                    language: extraFileLanguage
+                  }), result.transforms && {
                     transforms: result.transforms
-                  }, metadata !== undefined && {
+                  }), metadata !== undefined && {
                     metadata: metadata
                   });
 
@@ -712,6 +724,7 @@ function _loadCodeVariant() {
       loadVariantMeta,
       sourceTransformers,
       globalsCode,
+      disableParsing,
       loadSourceCache,
       functionName,
       currentMark,
@@ -725,6 +738,10 @@ function _loadCodeVariant() {
       _Object$keys2,
       extraFileName,
       fileName,
+      language,
+      extension,
+      finalSource,
+      parseSource,
       _finalVariant,
       mainFileResult,
       _i5,
@@ -761,6 +778,8 @@ function _loadCodeVariant() {
       _key3,
       _value2,
       metadata,
+      _extension,
+      extraFileLanguage,
       urlFilesToLoad,
       _i0,
       _Object$entries6,
@@ -782,7 +801,7 @@ function _loadCodeVariant() {
           }
           throw new Error("Variant is missing from code: ".concat(variantName));
         case 1:
-          sourceParser = options.sourceParser, loadSource = options.loadSource, loadVariantMeta = options.loadVariantMeta, sourceTransformers = options.sourceTransformers, globalsCode = options.globalsCode; // Create a cache for loadSource calls scoped to this loadCodeVariant call
+          sourceParser = options.sourceParser, loadSource = options.loadSource, loadVariantMeta = options.loadVariantMeta, sourceTransformers = options.sourceTransformers, globalsCode = options.globalsCode, disableParsing = options.disableParsing; // Create a cache for loadSource calls scoped to this loadCodeVariant call
           loadSourceCache = new Map();
           functionName = 'Load Variant';
           currentMark = performanceMeasure(undefined, {
@@ -845,20 +864,46 @@ function _loadCodeVariant() {
           }
 
           // Load main file
-          fileName = variant.fileName || (url ? getFileNameFromUrl(url).fileName : undefined); // If we don't have a fileName and no URL, we can't parse or transform but can still return the code
+          fileName = variant.fileName || (url ? getFileNameFromUrl(url).fileName : undefined); // Derive language from variant.language or from fileName extension
+          // Normalize the language to its canonical form (e.g., 'js' -> 'javascript')
+          language = variant.language ? normalizeLanguage(variant.language) : undefined;
+          if (!language && fileName) {
+            extension = fileName.slice(fileName.lastIndexOf('.'));
+            language = getLanguageFromExtension(extension);
+          }
+
+          // If we don't have a fileName and no URL, we can still parse if we have language
           if (!(!fileName && !url)) {
-            _context6.n = 8;
+            _context6.n = 11;
             break;
           }
-          // Return the variant as-is without parsing or transforms
-          _finalVariant = _extends(_extends({}, variant), {}, {
-            source: typeof variant.source === 'string' ? {
+          finalSource = variant.source; // Parse the source if we have language and sourceParser
+          if (!(typeof finalSource === 'string' && language && sourceParser && !disableParsing)) {
+            _context6.n = 9;
+            break;
+          }
+          _context6.n = 8;
+          return sourceParser;
+        case 8:
+          parseSource = _context6.v;
+          finalSource = parseSource(finalSource, '', language);
+          _context6.n = 10;
+          break;
+        case 9:
+          if (typeof finalSource === 'string') {
+            // No language or parser - return as plain text
+            finalSource = {
               type: 'root',
               children: [{
                 type: 'text',
-                value: variant.source || ''
+                value: finalSource || ''
               }]
-            } : variant.source
+            };
+          }
+        case 10:
+          _finalVariant = _extends(_extends({}, variant), {}, {
+            language: language,
+            source: finalSource
           });
           return _context6.a(2, {
             code: _finalVariant,
@@ -866,18 +911,18 @@ function _loadCodeVariant() {
             // No dependencies without URL
             externals: {} // No externals without URL
           });
-        case 8:
+        case 11:
           if (fileName) {
-            _context6.n = 9;
+            _context6.n = 12;
             break;
           }
           throw new Error("No fileName available for variant \"".concat(variantName, "\". ") + "Please provide a fileName in the variant definition or ensure the URL has a valid file extension.");
-        case 9:
-          _context6.n = 10;
+        case 12:
+          _context6.n = 13;
           return loadSingleFile(variantName, fileName, variant.source, url, loadSource, sourceParser, sourceTransformers, loadSourceCache, variant.transforms, _extends(_extends({}, options), {}, {
             loadedFiles: loadedFiles
-          }), variant.allFilesListed || false, knownExtraFiles);
-        case 10:
+          }), variant.allFilesListed || false, knownExtraFiles, language);
+        case 13:
           mainFileResult = _context6.v;
           // Add files used from main file loading
           if (mainFileResult.extraDependencies) {
@@ -890,26 +935,26 @@ function _loadCodeVariant() {
 
           // Validate extraFiles keys from variant definition
           if (!variant.extraFiles) {
-            _context6.n = 13;
+            _context6.n = 16;
             break;
           }
           _i5 = 0, _Object$keys3 = Object.keys(variant.extraFiles);
-        case 11:
+        case 14:
           if (!(_i5 < _Object$keys3.length)) {
-            _context6.n = 13;
+            _context6.n = 16;
             break;
           }
           _extraFileName = _Object$keys3[_i5];
           if (!isAbsolutePath(_extraFileName)) {
-            _context6.n = 12;
+            _context6.n = 15;
             break;
           }
           throw new Error("Invalid extraFiles key in variant: \"".concat(_extraFileName, "\" appears to be an absolute path. ") + "extraFiles keys in variant definition should be relative paths from the main file.");
-        case 12:
+        case 15:
           _i5++;
-          _context6.n = 11;
+          _context6.n = 14;
           break;
-        case 13:
+        case 16:
           // Collect extra files from variant definition and from loaded source
           extraFilesToLoad = _extends(_extends({}, variant.extraFiles || {}), mainFileResult.extraFiles || {}); // Add externals from main file loading
           if (mainFileResult.externals) {
@@ -925,7 +970,7 @@ function _loadCodeVariant() {
           globalsFileKeys = new Set(); // Track globals file keys for loadExtraFiles
           // Process globalsCode array and add to extraFiles if provided
           if (!(globalsCode && globalsCode.length > 0)) {
-            _context6.n = 15;
+            _context6.n = 18;
             break;
           }
           // Collect existing filenames to avoid conflicts
@@ -1017,9 +1062,9 @@ function _loadCodeVariant() {
               return _ref4.apply(this, arguments);
             };
           }()); // Wait for all globals to load
-          _context6.n = 14;
+          _context6.n = 17;
           return Promise.all(globalsPromises);
-        case 14:
+        case 17:
           globalsResults = _context6.v;
           // Merge results from all globals
           _iterator4 = _createForOfIteratorHelper(globalsResults);
@@ -1057,18 +1102,18 @@ function _loadCodeVariant() {
           } finally {
             _iterator4.f();
           }
-        case 15:
+        case 18:
           currentMark = performanceMeasure(externalsMergedMark, {
             mark: 'Globals Loaded',
             measure: 'Globals Loading'
           }, [functionName, url || fileName], true);
           allExtraFiles = {}; // Load all extra files if any exist and we have a URL
           if (!(Object.keys(extraFilesToLoad).length > 0)) {
-            _context6.n = 21;
+            _context6.n = 24;
             break;
           }
           if (url) {
-            _context6.n = 18;
+            _context6.n = 21;
             break;
           }
           // If there's no URL, we can only load extra files that have inline source or absolute URLs
@@ -1086,7 +1131,7 @@ function _loadCodeVariant() {
             }
           }
           if (!(Object.keys(loadableFiles).length > 0)) {
-            _context6.n = 17;
+            _context6.n = 20;
             break;
           }
           // Process loadable files: inline sources without URL-based loading, absolute URLs with loading
@@ -1094,11 +1139,16 @@ function _loadCodeVariant() {
             _Object$entries5$_i = _slicedToArray(_Object$entries5[_i9], 2), _key3 = _Object$entries5$_i[0], _value2 = _Object$entries5$_i[1];
             if (typeof _value2 !== 'string') {
               // Inline source - preserve metadata if it was marked as globals
-              metadata = _value2.metadata || globalsFileKeys.has(_key3) ? true : undefined;
-              allExtraFiles[normalizePathKey(_key3)] = _extends({
-                source: _value2.source,
+              metadata = _value2.metadata || globalsFileKeys.has(_key3) ? true : undefined; // Derive language from filename extension
+              _extension = _key3.slice(_key3.lastIndexOf('.'));
+              extraFileLanguage = getLanguageFromExtension(_extension);
+              allExtraFiles[normalizePathKey(_key3)] = _extends(_extends(_extends({
+                source: _value2.source
+              }, extraFileLanguage && {
+                language: extraFileLanguage
+              }), _value2.transforms && {
                 transforms: _value2.transforms
-              }, metadata !== undefined && {
+              }), metadata !== undefined && {
                 metadata: metadata
               });
             }
@@ -1113,10 +1163,10 @@ function _loadCodeVariant() {
             }
           }
           if (!(Object.keys(urlFilesToLoad).length > 0)) {
-            _context6.n = 17;
+            _context6.n = 20;
             break;
           }
-          _context6.n = 16;
+          _context6.n = 19;
           return loadExtraFiles(variantName, urlFilesToLoad, '',
           // No base URL needed for absolute URLs
           '',
@@ -1125,35 +1175,36 @@ function _loadCodeVariant() {
             loadedFiles: loadedFiles
           }), variant.allFilesListed || false, knownExtraFiles, globalsFileKeys // Pass globals file tracking
           );
-        case 16:
+        case 19:
           extraFilesResult = _context6.v;
           allExtraFiles = _extends(_extends({}, allExtraFiles), extraFilesResult.extraFiles);
           allFilesUsed.push.apply(allFilesUsed, _toConsumableArray(extraFilesResult.allFilesUsed));
           allExternals = mergeExternals([allExternals, extraFilesResult.allExternals]);
-        case 17:
-          _context6.n = 20;
+        case 20:
+          _context6.n = 23;
           break;
-        case 18:
-          _context6.n = 19;
+        case 21:
+          _context6.n = 22;
           return loadExtraFiles(variantName, extraFilesToLoad, url, url,
           // Entry URL is the same as the main file URL
           loadSource, sourceParser, sourceTransformers, loadSourceCache, _extends(_extends({}, options), {}, {
             loadedFiles: loadedFiles
           }), variant.allFilesListed || false, knownExtraFiles, globalsFileKeys // Pass globals file tracking
           );
-        case 19:
+        case 22:
           _extraFilesResult = _context6.v;
           allExtraFiles = _extraFilesResult.extraFiles;
           allFilesUsed.push.apply(allFilesUsed, _toConsumableArray(_extraFilesResult.allFilesUsed));
           allExternals = mergeExternals([allExternals, _extraFilesResult.allExternals]);
-        case 20:
+        case 23:
           currentMark = performanceMeasure(currentMark, {
             mark: 'Extra Files Loaded',
             measure: 'Extra Files Loading'
           }, [functionName, url || fileName], true);
-        case 21:
+        case 24:
           // Note: metadata marking is now handled during loadExtraFiles processing
           finalVariant = _extends(_extends({}, variant), {}, {
+            language: language,
             source: mainFileResult.source,
             transforms: mainFileResult.transforms,
             extraFiles: Object.keys(allExtraFiles).length > 0 ? allExtraFiles : undefined,

package/esm/pipeline/loaderUtils/getLanguageFromExtension.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Maps file extensions to language names.
+ * These are user-friendly names that can be used in the `language` prop.
+ */
+export declare const languageMap: Record<string, string>;
+/**
+ * Maps language aliases to canonical language names.
+ * Used to normalize short language names (e.g., from className like 'language-js')
+ * to their full names.
+ */
+export declare const languageAliasMap: Record<string, string>;
+/**
+ * Gets the language name from a file extension.
+ * @param extension - The file extension (e.g., '.tsx', '.css')
+ * @returns The language name or undefined if not recognized
+ */
+export declare function getLanguageFromExtension(extension: string): string | undefined;
+/**
+ * Normalizes a language name to its canonical form.
+ * This handles aliases like 'js' -> 'javascript', 'ts' -> 'typescript'.
+ * @param language - The language name or alias
+ * @returns The canonical language name, or the input if not a known alias
+ */
+export declare function normalizeLanguage(language: string): string;

package/esm/pipeline/loaderUtils/getLanguageFromExtension.js

@@ -0,0 +1,63 @@
+/**
+ * Maps file extensions to language names.
+ * These are user-friendly names that can be used in the `language` prop.
+ */
+export var languageMap = {
+  '.js': 'javascript',
+  '.ts': 'typescript',
+  '.jsx': 'jsx',
+  '.tsx': 'tsx',
+  '.json': 'json',
+  '.md': 'markdown',
+  '.mdx': 'mdx',
+  '.html': 'html',
+  '.css': 'css',
+  '.sh': 'shell',
+  '.yaml': 'yaml',
+  '.yml': 'yaml'
+};
+
+/**
+ * Maps language aliases to canonical language names.
+ * Used to normalize short language names (e.g., from className like 'language-js')
+ * to their full names.
+ */
+export var languageAliasMap = {
+  js: 'javascript',
+  ts: 'typescript',
+  javascript: 'javascript',
+  typescript: 'typescript',
+  jsx: 'jsx',
+  tsx: 'tsx',
+  json: 'json',
+  md: 'markdown',
+  markdown: 'markdown',
+  mdx: 'mdx',
+  html: 'html',
+  css: 'css',
+  sh: 'shell',
+  bash: 'shell',
+  shell: 'shell',
+  yaml: 'yaml',
+  yml: 'yaml'
+};
+
+/**
+ * Gets the language name from a file extension.
+ * @param extension - The file extension (e.g., '.tsx', '.css')
+ * @returns The language name or undefined if not recognized
+ */
+export function getLanguageFromExtension(extension) {
+  return languageMap[extension];
+}
+
+/**
+ * Normalizes a language name to its canonical form.
+ * This handles aliases like 'js' -> 'javascript', 'ts' -> 'typescript'.
+ * @param language - The language name or alias
+ * @returns The canonical language name, or the input if not a known alias
+ */
+export function normalizeLanguage(language) {
+  var _languageAliasMap$lan;
+  return (_languageAliasMap$lan = languageAliasMap[language]) != null ? _languageAliasMap$lan : language;
+}

package/esm/pipeline/loaderUtils/index.d.ts

@@ -5,4 +5,5 @@ export * from "./processRelativeImports.js";
 export * from "./getFileNameFromUrl.js";
 export * from "./extractNameAndSlugFromUrl.js";
 export * from "./externalsToPackages.js";
-export * from "./fileUrlToPortablePath.js";
+export * from "./fileUrlToPortablePath.js";
+export * from "./getLanguageFromExtension.js";

package/esm/pipeline/loaderUtils/index.js

@@ -5,4 +5,5 @@ export * from "./processRelativeImports.js";
 export * from "./getFileNameFromUrl.js";
 export * from "./extractNameAndSlugFromUrl.js";
 export * from "./externalsToPackages.js";
-export * from "./fileUrlToPortablePath.js";
+export * from "./fileUrlToPortablePath.js";
+export * from "./getLanguageFromExtension.js";

package/esm/pipeline/parseSource/grammars.d.ts

@@ -1,2 +1,13 @@
 export declare const grammars: import("@wooorm/starry-night").Grammar[];
-export declare const extensionMap: Record<string, string>;
+export declare const extensionMap: Record<string, string>;
+/**
+ * Maps simplified language names back to grammar scope names.
+ * Used when `language` prop is provided instead of fileName.
+ */
+export declare const languageToGrammarMap: Record<string, string>;
+/**
+ * Gets the grammar scope from a language name.
+ * @param language - The language name (e.g., 'tsx', 'css', 'typescript')
+ * @returns The grammar scope or undefined if not recognized
+ */
+export declare function getGrammarFromLanguage(language: string): string | undefined;

package/esm/pipeline/parseSource/grammars.js

@@ -15,7 +15,6 @@ export var extensionMap = {
   '.js': 'source.js',
   '.ts': 'source.ts',
   '.jsx': 'source.tsx',
-  // TODO: is there a JSX grammar?
   '.tsx': 'source.tsx',
   '.json': 'source.json',
   '.md': 'text.md',
@@ -24,4 +23,37 @@ export var extensionMap = {
   '.css': 'source.css',
   '.sh': 'source.shell',
   '.yaml': 'source.yaml'
-};
+};
+
+/**
+ * Maps simplified language names back to grammar scope names.
+ * Used when `language` prop is provided instead of fileName.
+ */
+export var languageToGrammarMap = {
+  js: 'source.js',
+  javascript: 'source.js',
+  ts: 'source.ts',
+  typescript: 'source.ts',
+  jsx: 'source.tsx',
+  tsx: 'source.tsx',
+  json: 'source.json',
+  md: 'text.md',
+  markdown: 'text.md',
+  mdx: 'source.mdx',
+  html: 'text.html.basic',
+  css: 'source.css',
+  sh: 'source.shell',
+  shell: 'source.shell',
+  bash: 'source.shell',
+  yaml: 'source.yaml',
+  yml: 'source.yaml'
+};
+
+/**
+ * Gets the grammar scope from a language name.
+ * @param language - The language name (e.g., 'tsx', 'css', 'typescript')
+ * @returns The grammar scope or undefined if not recognized
+ */
+export function getGrammarFromLanguage(language) {
+  return languageToGrammarMap[language.toLowerCase()];
+}

package/esm/pipeline/parseSource/index.d.ts

@@ -1 +1,2 @@
-export * from "./parseSource.js";
+export * from "./parseSource.js";
+export { getGrammarFromLanguage, languageToGrammarMap, extensionMap } from "./grammars.js";

package/esm/pipeline/parseSource/index.js

@@ -1 +1,2 @@
-export * from "./parseSource.js";
+export * from "./parseSource.js";
+export { getGrammarFromLanguage, languageToGrammarMap, extensionMap } from "./grammars.js";