@mui/internal-docs-infra 0.2.3-canary.10 → 0.2.3-canary.12

package/esm/CodeHighlighter/CodeHighlighter.js

@@ -5,11 +5,11 @@ import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import _extends from "@babel/runtime/helpers/esm/extends";
 import * as React from 'react';
-import { loadVariant } from "./loadVariant.js";
-import { loadFallbackCode } from "./loadFallbackCode.js";
+import { loadCodeVariant } from "../pipeline/loadCodeVariant/loadCodeVariant.js";
+import { loadCodeFallback } from "../pipeline/loadCodeVariant/loadCodeFallback.js";
 import { CodeHighlighterClient } from "./CodeHighlighterClient.js";
-import { maybeInitialData } from "./maybeInitialData.js";
-import { hasAllVariants } from "./hasAllVariants.js";
+import { maybeCodeInitialData } from "../pipeline/loadCodeVariant/maybeCodeInitialData.js";
+import { hasAllVariants } from "../pipeline/loadCodeVariant/hasAllCodeVariants.js";
 import { getFileNameFromUrl } from "../pipeline/loaderUtils/getFileNameFromUrl.js";
 import { codeToFallbackProps } from "./codeToFallbackProps.js";
 import * as Errors from "./errors.js";
@@ -176,7 +176,7 @@ function _CodeSourceLoader() {
             } else if (props.deferParsing === 'none') {
               output = 'hast';
             }
-            return loadVariant(variantUrl, variantName, variantCode, {
+            return loadCodeVariant(variantUrl, variantName, variantCode, {
               sourceParser: props.sourceParser,
               loadSource: props.loadSource,
               loadVariantMeta: props.loadVariantMeta,
@@ -313,7 +313,7 @@ function CodeInitialSourceLoader(_x3) {
 }
 function _CodeInitialSourceLoader() {
   _CodeInitialSourceLoader = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(props) {
-    var url, initialVariant, highlightAfter, fallbackUsesExtraFiles, fallbackUsesAllVariants, sourceParser, loadSource, loadVariantMeta, loadCodeMeta, fileName, variants, globalsCode, ContentLoading, output, _yield$loadFallbackCo, code, initialFilename, initialSource, initialExtraFiles, processedGlobalsCode;
+    var url, initialVariant, highlightAfter, fallbackUsesExtraFiles, fallbackUsesAllVariants, sourceParser, loadSource, loadVariantMeta, loadCodeMeta, fileName, variants, globalsCode, ContentLoading, output, _yield$loadCodeFallba, code, initialFilename, initialSource, initialExtraFiles, processedGlobalsCode;
     return _regenerator().w(function (_context4) {
       while (1) switch (_context4.n) {
         case 0:
@@ -331,7 +331,7 @@ function _CodeInitialSourceLoader() {
             output = 'hast';
           }
           _context4.n = 2;
-          return loadFallbackCode(url, initialVariant, props.code, {
+          return loadCodeFallback(url, initialVariant, props.code, {
             shouldHighlight: highlightAfter === 'init',
             fallbackUsesExtraFiles: fallbackUsesExtraFiles,
             fallbackUsesAllVariants: fallbackUsesAllVariants,
@@ -345,12 +345,12 @@ function _CodeInitialSourceLoader() {
             output: output
           });
         case 2:
-          _yield$loadFallbackCo = _context4.v;
-          code = _yield$loadFallbackCo.code;
-          initialFilename = _yield$loadFallbackCo.initialFilename;
-          initialSource = _yield$loadFallbackCo.initialSource;
-          initialExtraFiles = _yield$loadFallbackCo.initialExtraFiles;
-          processedGlobalsCode = _yield$loadFallbackCo.processedGlobalsCode;
+          _yield$loadCodeFallba = _context4.v;
+          code = _yield$loadCodeFallba.code;
+          initialFilename = _yield$loadCodeFallba.initialFilename;
+          initialSource = _yield$loadCodeFallba.initialSource;
+          initialExtraFiles = _yield$loadCodeFallba.initialExtraFiles;
+          processedGlobalsCode = _yield$loadCodeFallba.processedGlobalsCode;
           return _context4.a(2, renderWithInitialSource(_extends(_extends({}, props), {}, {
             ContentLoading: ContentLoading,
             code: code,
@@ -417,11 +417,11 @@ export function CodeHighlighter(props) {
 
   // TODO: use initial.filesOrder to determing which source to use
 
-  var _maybeInitialData = maybeInitialData(variants, initialKey, code || props.precompute, undefined,
+  var _maybeCodeInitialData = maybeCodeInitialData(variants, initialKey, code || props.precompute, undefined,
     // TODO: use initial.filesOrder if provided?
     props.highlightAfter === 'init', props.fallbackUsesExtraFiles, props.fallbackUsesAllVariants),
-    initialData = _maybeInitialData.initialData,
-    reason = _maybeInitialData.reason;
+    initialData = _maybeCodeInitialData.initialData,
+    reason = _maybeCodeInitialData.reason;
   if (!initialData) {
     if (DEBUG) {
       // eslint-disable-next-line no-console

package/esm/CodeHighlighter/CodeHighlighterClient.js

@@ -9,12 +9,12 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import * as React from 'react';
 import { useCodeContext } from "../CodeProvider/CodeContext.js";
 import { CodeHighlighterContext } from "./CodeHighlighterContext.js";
-import { maybeInitialData } from "./maybeInitialData.js";
-import { hasAllVariants } from "./hasAllVariants.js";
+import { maybeCodeInitialData } from "../pipeline/loadCodeVariant/maybeCodeInitialData.js";
+import { hasAllVariants } from "../pipeline/loadCodeVariant/hasAllCodeVariants.js";
 import { CodeHighlighterFallbackContext } from "./CodeHighlighterFallbackContext.js";
 import { useControlledCode } from "../CodeControllerContext/index.js";
 import { codeToFallbackProps } from "./codeToFallbackProps.js";
-import { mergeMetadata } from "./mergeMetadata.js";
+import { mergeCodeMetadata } from "../pipeline/loadCodeVariant/mergeCodeMetadata.js";
 import * as Errors from "./errors.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 var DEBUG = false; // Set to true for debugging purposes
@@ -37,9 +37,9 @@ function useInitialData(_ref) {
     loadCodeMeta = _useCodeContext.loadCodeMeta,
     loadVariantMeta = _useCodeContext.loadVariantMeta,
     loadSource = _useCodeContext.loadSource,
-    loadFallbackCode = _useCodeContext.loadFallbackCode;
+    loadCodeFallback = _useCodeContext.loadCodeFallback;
   var _React$useMemo = React.useMemo(function () {
-      return maybeInitialData(variants, variantName, code, fileName, highlightAfter === 'init', fallbackUsesExtraFiles, fallbackUsesAllVariants);
+      return maybeCodeInitialData(variants, variantName, code, fileName, highlightAfter === 'init', fallbackUsesExtraFiles, fallbackUsesAllVariants);
     }, [variants, variantName, code, fileName, highlightAfter, fallbackUsesExtraFiles, fallbackUsesAllVariants]),
     initialData = _React$useMemo.initialData,
     reason = _React$useMemo.reason;
@@ -49,7 +49,7 @@ function useInitialData(_ref) {
       // URL is required for loading fallback data
       throw new Errors.ErrorCodeHighlighterClientMissingUrlForFallback();
     }
-    if (!loadFallbackCode) {
+    if (!loadCodeFallback) {
       throw new Errors.ErrorCodeHighlighterClientMissingLoadFallbackCode(url);
     }
   }
@@ -57,7 +57,7 @@ function useInitialData(_ref) {
   // TODO: fallbackInitialRenderOnly option? this would mean we can't fetch fallback data on the client side
   // Load initial data if not provided
   React.useEffect(function () {
-    if (!needsFallback || !url || !loadFallbackCode) {
+    if (!needsFallback || !url || !loadCodeFallback) {
       return;
     }
 
@@ -73,7 +73,7 @@ function useInitialData(_ref) {
               console.log('Loading initial data for CodeHighlighterClient: ', reason);
             }
             _context.n = 1;
-            return loadFallbackCode(url, variantName, code, {
+            return loadCodeFallback(url, variantName, code, {
               shouldHighlight: highlightAfter === 'init',
               fallbackUsesExtraFiles: fallbackUsesExtraFiles,
               fallbackUsesAllVariants: fallbackUsesAllVariants,
@@ -83,7 +83,7 @@ function useInitialData(_ref) {
               loadCodeMeta: loadCodeMeta,
               initialFilename: fileName,
               variants: variants,
-              globalsCode: globalsCode // Let loadFallbackCode handle processing
+              globalsCode: globalsCode // Let loadCodeFallback handle processing
             })["catch"](function (error) {
               return {
                 error: error
@@ -95,7 +95,7 @@ function useInitialData(_ref) {
               console.error(new Errors.ErrorCodeHighlighterClientLoadFallbackFailure(loaded.error));
             } else {
               setCode(loaded.code);
-              // Store processed globalsCode from loadFallbackCode result
+              // Store processed globalsCode from loadCodeFallback result
               if (loaded.processedGlobalsCode) {
                 setProcessedGlobalsCode(loaded.processedGlobalsCode);
               }
@@ -105,7 +105,7 @@ function useInitialData(_ref) {
         }
       }, _callee);
     }))();
-  }, [initialData, reason, needsFallback, variantName, code, setCode, highlightAfter, url, sourceParser, loadSource, loadVariantMeta, loadCodeMeta, fallbackUsesExtraFiles, fallbackUsesAllVariants, fileName, variants, globalsCode, setProcessedGlobalsCode, loadFallbackCode]);
+  }, [initialData, reason, needsFallback, variantName, code, setCode, highlightAfter, url, sourceParser, loadSource, loadVariantMeta, loadCodeMeta, fallbackUsesExtraFiles, fallbackUsesAllVariants, fileName, variants, globalsCode, setProcessedGlobalsCode, loadCodeFallback]);
 }
 function useAllVariants(_ref3) {
   var readyForContent = _ref3.readyForContent,
@@ -121,7 +121,7 @@ function useAllVariants(_ref3) {
     loadCodeMeta = _useCodeContext2.loadCodeMeta,
     loadVariantMeta = _useCodeContext2.loadVariantMeta,
     loadSource = _useCodeContext2.loadSource,
-    loadVariant = _useCodeContext2.loadVariant;
+    loadCodeVariant = _useCodeContext2.loadCodeVariant;
   var needsData = !readyForContent && !isControlled;
 
   // validation
@@ -130,7 +130,7 @@ function useAllVariants(_ref3) {
       if (!url) {
         throw new Errors.ErrorCodeHighlighterClientMissingUrlForVariants();
       }
-      if (!loadVariant) {
+      if (!loadCodeVariant) {
         throw new Errors.ErrorCodeHighlighterClientMissingLoadVariant(url);
       }
       if (!code && !loadCodeMeta) {
@@ -160,9 +160,9 @@ function useAllVariants(_ref3) {
         throw new Errors.ErrorCodeHighlighterClientMissingLoadSourceForUnloadedUrls();
       }
     }
-  }, [code, globalsCode, loadCodeMeta, loadVariant, loadSource, needsData, url]);
+  }, [code, globalsCode, loadCodeMeta, loadCodeVariant, loadSource, needsData, url]);
   React.useEffect(function () {
-    if (!needsData || !url || !loadVariant) {
+    if (!needsData || !url || !loadCodeVariant) {
       return;
     }
 
@@ -245,7 +245,7 @@ function useAllVariants(_ref3) {
               }).filter(function (item) {
                 return Boolean(item);
               });
-              return loadVariant(url, name, loadedCode[name], {
+              return loadCodeVariant(url, name, loadedCode[name], {
                 disableParsing: true,
                 disableTransforms: true,
                 loadSource: loadSource,
@@ -297,7 +297,7 @@ function useAllVariants(_ref3) {
         }
       }, _callee3, null, [[0, 8]]);
     }))();
-  }, [needsData, variants, url, code, setCode, loadSource, loadVariantMeta, loadCodeMeta, processedGlobalsCode, globalsCode, setProcessedGlobalsCode, loadVariant]);
+  }, [needsData, variants, url, code, setCode, loadSource, loadVariantMeta, loadCodeMeta, processedGlobalsCode, globalsCode, setProcessedGlobalsCode, loadCodeVariant]);
   return {
     readyForContent: readyForContent
   };
@@ -396,7 +396,7 @@ function useCodeTransforms(_ref7) {
   var _useCodeContext4 = useCodeContext(),
     sourceParser = _useCodeContext4.sourceParser,
     getAvailableTransforms = _useCodeContext4.getAvailableTransforms,
-    applyTransforms = _useCodeContext4.applyTransforms;
+    computeHastDeltas = _useCodeContext4.computeHastDeltas;
   var _React$useState3 = React.useState(undefined),
     _React$useState4 = _slicedToArray(_React$useState3, 2),
     transformedCode = _React$useState4[0],
@@ -412,7 +412,7 @@ function useCodeTransforms(_ref7) {
 
   // Effect to compute transformations for all variants
   React.useEffect(function () {
-    if (!parsedCode || !sourceParser || !applyTransforms) {
+    if (!parsedCode || !sourceParser || !computeHastDeltas) {
       setTransformedCode(parsedCode);
       return;
     }
@@ -429,7 +429,7 @@ function useCodeTransforms(_ref7) {
           case 1:
             parseSource = _context4.v;
             _context4.n = 2;
-            return applyTransforms(parsedCode, parseSource);
+            return computeHastDeltas(parsedCode, parseSource);
           case 2:
             enhanced = _context4.v;
             setTransformedCode(enhanced);
@@ -445,7 +445,7 @@ function useCodeTransforms(_ref7) {
         }
       }, _callee4, null, [[0, 3]]);
     }))();
-  }, [parsedCode, sourceParser, applyTransforms]);
+  }, [parsedCode, sourceParser, computeHastDeltas]);
   return {
     transformedCode: transformedCode,
     availableTransforms: availableTransforms
@@ -500,7 +500,7 @@ function useGlobalsCodeMerging(_ref0) {
     loadCodeMeta = _useCodeContext6.loadCodeMeta,
     loadSource = _useCodeContext6.loadSource,
     loadVariantMeta = _useCodeContext6.loadVariantMeta,
-    loadVariant = _useCodeContext6.loadVariant;
+    loadCodeVariant = _useCodeContext6.loadCodeVariant;
 
   // Set processedGlobalsCode if we have ready Code objects but haven't stored them yet
   React.useEffect(function () {
@@ -523,7 +523,7 @@ function useGlobalsCodeMerging(_ref0) {
       }
       // If not all ready, fall through to loading logic below
     }
-    if (!loadVariant) {
+    if (!loadCodeVariant) {
       console.error(new Errors.ErrorCodeHighlighterClientMissingLoadVariantForGlobals());
       return;
     }
@@ -606,7 +606,7 @@ function useGlobalsCodeMerging(_ref0) {
                               case 1:
                                 _context6.p = 1;
                                 _context6.n = 2;
-                                return loadVariant(originalUrl || '',
+                                return loadCodeVariant(originalUrl || '',
                                 // Use the original URL if available
                                 variantName, codeObj[variantName],
                                 // May be undefined or string
@@ -658,7 +658,7 @@ function useGlobalsCodeMerging(_ref0) {
         }
       }, _callee8, null, [[0, 3]]);
     }))();
-  }, [url, globalsCode, processedGlobalsCode, setProcessedGlobalsCode, loadCodeMeta, loadSource, loadVariantMeta, variants, loadVariant]);
+  }, [url, globalsCode, processedGlobalsCode, setProcessedGlobalsCode, loadCodeMeta, loadSource, loadVariantMeta, variants, loadCodeVariant]);
 
   // Determine globalsCodeObjects to use (prefer processed, fallback to direct if ready)
   var globalsCodeObjects = React.useMemo(function () {
@@ -707,11 +707,11 @@ function useGlobalsCodeMerging(_ref0) {
         return Boolean(item) && _typeof(item) === 'object';
       });
       if (globalsForVariant.length > 0) {
-        // Use mergeMetadata for sophisticated globals merging with proper positioning
+        // Use mergeCodeMetadata for sophisticated globals merging with proper positioning
         var currentVariant = variantData;
         globalsForVariant.forEach(function (globalVariant) {
           if (globalVariant.extraFiles) {
-            // Convert globals extraFiles to metadata format for mergeMetadata
+            // Convert globals extraFiles to metadata format for mergeCodeMetadata
             var globalsMetadata = {};
             for (var _i = 0, _Object$entries = Object.entries(globalVariant.extraFiles); _i < _Object$entries.length; _i++) {
               var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
@@ -726,8 +726,8 @@ function useGlobalsCodeMerging(_ref0) {
               }
             }
 
-            // Use mergeMetadata to properly position and merge the globals
-            currentVariant = mergeMetadata(currentVariant, globalsMetadata);
+            // Use mergeCodeMetadata to properly position and merge the globals
+            currentVariant = mergeCodeMetadata(currentVariant, globalsMetadata);
           }
         });
 
@@ -774,11 +774,11 @@ function usePropsCodeGlobalsMerging(_ref14) {
         return Boolean(item) && _typeof(item) === 'object';
       });
       if (globalsForVariant.length > 0) {
-        // Use mergeMetadata for sophisticated globals merging with proper positioning
+        // Use mergeCodeMetadata for sophisticated globals merging with proper positioning
         var currentVariant = variantData;
         globalsForVariant.forEach(function (globalVariant) {
           if (globalVariant.extraFiles) {
-            // Convert globals extraFiles to metadata format for mergeMetadata
+            // Convert globals extraFiles to metadata format for mergeCodeMetadata
             var globalsMetadata = {};
             for (var _i2 = 0, _Object$entries2 = Object.entries(globalVariant.extraFiles); _i2 < _Object$entries2.length; _i2++) {
               var _Object$entries2$_i = _slicedToArray(_Object$entries2[_i2], 2),
@@ -793,8 +793,8 @@ function usePropsCodeGlobalsMerging(_ref14) {
               }
             }
 
-            // Use mergeMetadata to properly position and merge the globals
-            currentVariant = mergeMetadata(currentVariant, globalsMetadata);
+            // Use mergeCodeMetadata to properly position and merge the globals
+            currentVariant = mergeCodeMetadata(currentVariant, globalsMetadata);
           }
         });
 

package/esm/CodeHighlighter/errors.js

@@ -230,7 +230,7 @@ export var ErrorCodeHighlighterServerLoadVariantsFailure = /*#__PURE__*/function
 export var ErrorCodeHighlighterClientMissingLoadFallbackCode = /*#__PURE__*/function (_ErrorCodeHighlighter21) {
   function ErrorCodeHighlighterClientMissingLoadFallbackCode(url) {
     _classCallCheck(this, ErrorCodeHighlighterClientMissingLoadFallbackCode);
-    return _callSuper(this, ErrorCodeHighlighterClientMissingLoadFallbackCode, ["Missing loadFallbackCode function - loadFallbackCode is required (".concat(url || 'No URL', ") add a <CodeProvider />")]);
+    return _callSuper(this, ErrorCodeHighlighterClientMissingLoadFallbackCode, ["Missing loadCodeFallback function - loadCodeFallback is required (".concat(url || 'No URL', ") add a <CodeProvider />")]);
   }
   _inherits(ErrorCodeHighlighterClientMissingLoadFallbackCode, _ErrorCodeHighlighter21);
   return _createClass(ErrorCodeHighlighterClientMissingLoadFallbackCode);
@@ -238,7 +238,7 @@ export var ErrorCodeHighlighterClientMissingLoadFallbackCode = /*#__PURE__*/func
 export var ErrorCodeHighlighterClientMissingLoadVariant = /*#__PURE__*/function (_ErrorCodeHighlighter22) {
   function ErrorCodeHighlighterClientMissingLoadVariant(url) {
     _classCallCheck(this, ErrorCodeHighlighterClientMissingLoadVariant);
-    return _callSuper(this, ErrorCodeHighlighterClientMissingLoadVariant, ["Missing loadVariant function - loadVariant function is required when no initial code is provided (".concat(url || 'No URL', ")")]);
+    return _callSuper(this, ErrorCodeHighlighterClientMissingLoadVariant, ["Missing loadCodeVariant function - loadCodeVariant function is required when no initial code is provided (".concat(url || 'No URL', ")")]);
   }
   _inherits(ErrorCodeHighlighterClientMissingLoadVariant, _ErrorCodeHighlighter22);
   return _createClass(ErrorCodeHighlighterClientMissingLoadVariant);
@@ -417,7 +417,7 @@ export var ErrorCodeHighlighterClientTransformProcessingFailure = /*#__PURE__*/f
 export var ErrorCodeHighlighterClientMissingLoadVariantForGlobals = /*#__PURE__*/function (_ErrorCodeHighlighter42) {
   function ErrorCodeHighlighterClientMissingLoadVariantForGlobals() {
     _classCallCheck(this, ErrorCodeHighlighterClientMissingLoadVariantForGlobals);
-    return _callSuper(this, ErrorCodeHighlighterClientMissingLoadVariantForGlobals, ["loadVariant function is required for loading missing variants in globalsCode"]);
+    return _callSuper(this, ErrorCodeHighlighterClientMissingLoadVariantForGlobals, ["loadCodeVariant function is required for loading missing variants in globalsCode"]);
   }
   _inherits(ErrorCodeHighlighterClientMissingLoadVariantForGlobals, _ErrorCodeHighlighter42);
   return _createClass(ErrorCodeHighlighterClientMissingLoadVariantForGlobals);

package/esm/CodeHighlighter/types.d.ts

@@ -149,7 +149,7 @@ export interface LoadFileOptions {
   output?: 'hast' | 'hastJson' | 'hastGzip';
 }
 /**
- * Options for the loadVariant function, extending LoadFileOptions with required function dependencies
+ * Options for the loadCodeVariant function, extending LoadFileOptions with required function dependencies
  */
 export interface LoadVariantOptions extends LoadFileOptions, Pick<CodeFunctionProps, 'sourceParser' | 'loadSource' | 'loadVariantMeta' | 'sourceTransformers'> {}
 /**

package/esm/CodeProvider/CodeContext.d.ts

@@ -11,7 +11,7 @@ export type LoadVariantFn = (url: string | undefined, variantName: string, varia
 }>;
 export type ParseCodeFn = (code: Code, parseSource: ParseSource) => Code;
 export type ParseControlledCodeFn = (controlledCode: ControlledCode, parseSource: ParseSource) => Code;
-export type ApplyTransformsFn = (parsedCode: Code, parseSource: ParseSource) => Promise<Code>;
+export type ComputeHastDeltasFn = (parsedCode: Code, parseSource: ParseSource) => Promise<Code>;
 export type GetAvailableTransformsFn = (parsedCode: Code | undefined, variantName: string) => string[];
 export interface CodeContext {
   sourceParser?: Promise<ParseSource>;
@@ -20,11 +20,11 @@ export interface CodeContext {
   loadSource?: LoadSource;
   loadVariantMeta?: LoadVariantMeta;
   loadCodeMeta?: LoadCodeMeta;
-  loadFallbackCode?: LoadFallbackCodeFn;
-  loadVariant?: LoadVariantFn;
+  loadCodeFallback?: LoadFallbackCodeFn;
+  loadCodeVariant?: LoadVariantFn;
   parseCode?: ParseCodeFn;
   parseControlledCode?: ParseControlledCodeFn;
-  applyTransforms?: ApplyTransformsFn;
+  computeHastDeltas?: ComputeHastDeltasFn;
   getAvailableTransforms?: GetAvailableTransformsFn;
 }
 export declare const CodeContext: React.Context<CodeContext>;

package/esm/CodeProvider/CodeProvider.js

@@ -7,11 +7,11 @@ import { CodeContext } from "./CodeContext.js";
 import { extensionMap, grammars } from "../pipeline/parseSource/grammars.js";
 import { starryNightGutter } from "../pipeline/parseSource/addLineGutters.js";
 // Import the heavy functions
-import { loadFallbackCode } from "../CodeHighlighter/loadFallbackCode.js";
-import { loadVariant } from "../CodeHighlighter/loadVariant.js";
-import { parseCode } from "../CodeHighlighter/parseCode.js";
+import { loadCodeFallback } from "../pipeline/loadCodeVariant/loadCodeFallback.js";
+import { loadCodeVariant } from "../pipeline/loadCodeVariant/loadCodeVariant.js";
+import { parseCode } from "../pipeline/loadCodeVariant/parseCode.js";
 import { parseControlledCode } from "../CodeHighlighter/parseControlledCode.js";
-import { applyTransforms, getAvailableTransforms } from "../CodeHighlighter/transformCode.js";
+import { computeHastDeltas, getAvailableTransforms } from "../pipeline/loadCodeVariant/computeHastDeltas.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 export function CodeProvider(_ref) {
   var children = _ref.children,
@@ -68,11 +68,11 @@ export function CodeProvider(_ref) {
       loadVariantMeta: loadVariantMeta,
       loadCodeMeta: loadCodeMeta,
       // Provide the heavy functions
-      loadFallbackCode: loadFallbackCode,
-      loadVariant: loadVariant,
+      loadCodeFallback: loadCodeFallback,
+      loadCodeVariant: loadCodeVariant,
       parseCode: parseCode,
       parseControlledCode: parseControlledCode,
-      applyTransforms: applyTransforms,
+      computeHastDeltas: computeHastDeltas,
       getAvailableTransforms: getAvailableTransforms
     };
   }, [sourceParser, parseSource, loadSource, loadVariantMeta, loadCodeMeta]);

package/esm/{CodeHighlighter/addPathsToVariant.d.ts → pipeline/loadCodeVariant/addCodeVariantPaths.d.ts}

@@ -2,7 +2,7 @@
  * Add path utility to add path property to each file in a variant
  * Uses calculateMainFilePath utility and URL resolution for simplified path calculation
  */
-import type { VariantCode, VariantSource } from "./types.js";
+import type { VariantCode, VariantSource } from "../../CodeHighlighter/types.js";
 export interface FileWithPath {
   source?: VariantSource;
   metadata?: boolean;

package/esm/{CodeHighlighter/applyTransform.d.ts → pipeline/loadCodeVariant/applyCodeTransform.d.ts}

@@ -1,4 +1,4 @@
-import type { VariantSource, Transforms } from "./types.js";
+import type { VariantSource, Transforms } from "../../CodeHighlighter/types.js";
 /**
  * Applies a specific transform to a variant source and returns the transformed source
  * @param source - The original variant source (string, HastNodes, or hastJson object)
@@ -7,7 +7,7 @@ import type { VariantSource, Transforms } from "./types.js";
  * @returns The transformed variant source in the same format as the input
  * @throws Error if the transform key doesn't exist or patching fails
  */
-export declare function applyTransform(source: VariantSource, transforms: Transforms, transformKey: string): VariantSource;
+export declare function applyCodeTransform(source: VariantSource, transforms: Transforms, transformKey: string): VariantSource;
 /**
  * Applies multiple transforms to a variant source in sequence
  * @param source - The original variant source
@@ -16,4 +16,4 @@ export declare function applyTransform(source: VariantSource, transforms: Transf
  * @returns The transformed variant source in the same format as the input
  * @throws Error if any transform key doesn't exist or patching fails
  */
-export declare function applyTransforms(source: VariantSource, transforms: Transforms, transformKeys: string[]): VariantSource;
+export declare function applyCodeTransforms(source: VariantSource, transforms: Transforms, transformKeys: string[]): VariantSource;

package/esm/{CodeHighlighter/applyTransform.js → pipeline/loadCodeVariant/applyCodeTransform.js}

@@ -8,7 +8,7 @@ import { patch, clone } from 'jsondiffpatch';
  * @returns The transformed variant source in the same format as the input
  * @throws Error if the transform key doesn't exist or patching fails
  */
-export function applyTransform(source, transforms, transformKey) {
+export function applyCodeTransform(source, transforms, transformKey) {
   var transform = transforms[transformKey];
   if (!transform) {
     throw new Error("Transform \"".concat(transformKey, "\" not found in transforms"));
@@ -25,7 +25,7 @@ export function applyTransform(source, transforms, transformKey) {
     return patched.join('\n');
   }
 
-  // For Hast node sources, deltas are typically node-based (from transformParsedSource)
+  // For Hast node sources, deltas are typically node-based (from diffHast)
   var sourceRoot;
   var isHastJson = 'hastJson' in source;
   if (isHastJson) {
@@ -57,14 +57,14 @@ export function applyTransform(source, transforms, transformKey) {
  * @returns The transformed variant source in the same format as the input
  * @throws Error if any transform key doesn't exist or patching fails
  */
-export function applyTransforms(source, transforms, transformKeys) {
+export function applyCodeTransforms(source, transforms, transformKeys) {
   var currentSource = source;
   var _iterator = _createForOfIteratorHelper(transformKeys),
     _step;
   try {
     for (_iterator.s(); !(_step = _iterator.n()).done;) {
       var transformKey = _step.value;
-      currentSource = applyTransform(currentSource, transforms, transformKey);
+      currentSource = applyCodeTransform(currentSource, transforms, transformKey);
     }
   } catch (err) {
     _iterator.e(err);

package/esm/{CodeHighlighter/transformCode.d.ts → pipeline/loadCodeVariant/computeHastDeltas.d.ts}

@@ -1,4 +1,4 @@
-import type { Code, ParseSource } from "./types.js";
+import type { Code, ParseSource } from "../../CodeHighlighter/types.js";
 /**
  * Pure function to identify which variants need transformation.
  * Returns entries of variants that have transforms requiring processing.
@@ -13,9 +13,13 @@ export declare function getAvailableTransforms(parsedCode: Code | undefined, var
  * Pure async function to transform a single variant's code and extraFiles.
  * Returns the transformed variant or the original if transformation fails.
  */
-export declare function transformVariant(variant: string, variantCode: any, parseSource: ParseSource): Promise<any>;
+export declare function computeVariantDeltas(variant: string, variantCode: any, parseSource: ParseSource): Promise<any>;
 /**
- * Pure async function to apply transformations to all variants that need them.
- * Returns the enhanced code with computed transforms.
+ * Computes transform deltas for all variants in the parsed code.
+ * This function generates the transformation data that can be applied later.
+ *
+ * @param parsedCode - The parsed code object containing variants
+ * @param parseSource - The parser function to parse source strings
+ * @returns A promise that resolves to the code with computed transforms
  */
-export declare function applyTransforms(parsedCode: Code, parseSource: ParseSource): Promise<Code>;
+export declare function computeHastDeltas(parsedCode: Code, parseSource: ParseSource): Promise<Code>;

package/esm/{CodeHighlighter/transformCode.js → pipeline/loadCodeVariant/computeHastDeltas.js}

@@ -5,7 +5,7 @@ import _asyncToGenerator from "@babel/runtime/helpers/esm/asyncToGenerator";
 import _typeof from "@babel/runtime/helpers/esm/typeof";
 import _slicedToArray from "@babel/runtime/helpers/esm/slicedToArray";
 import { toText } from 'hast-util-to-text';
-import { transformParsedSource } from "./transformParsedSource.js";
+import { diffHast } from "./diffHast.js";
 
 /**
  * Pure function to identify which variants need transformation.
@@ -85,16 +85,20 @@ export function getAvailableTransforms(parsedCode, variantName) {
  * Pure async function to transform a single variant's code and extraFiles.
  * Returns the transformed variant or the original if transformation fails.
  */
-export function transformVariant(_x, _x2, _x3) {
-  return _transformVariant.apply(this, arguments);
+export function computeVariantDeltas(_x, _x2, _x3) {
+  return _computeVariantDeltas.apply(this, arguments);
 }
 
 /**
- * Pure async function to apply transformations to all variants that need them.
- * Returns the enhanced code with computed transforms.
+ * Computes transform deltas for all variants in the parsed code.
+ * This function generates the transformation data that can be applied later.
+ *
+ * @param parsedCode - The parsed code object containing variants
+ * @param parseSource - The parser function to parse source strings
+ * @returns A promise that resolves to the code with computed transforms
  */
-function _transformVariant() {
-  _transformVariant = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(variant, variantCode, parseSource) {
+function _computeVariantDeltas() {
+  _computeVariantDeltas = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(variant, variantCode, parseSource) {
     var mainTransformResult, transformedExtraFiles, hastNodes, sourceString, transformedVariant;
     return _regenerator().w(function (_context2) {
       while (1) switch (_context2.n) {
@@ -114,7 +118,7 @@ function _transformVariant() {
             whitespace: 'pre'
           });
           _context2.n = 2;
-          return transformParsedSource(sourceString, hastNodes, variant,
+          return diffHast(sourceString, hastNodes, variant,
           // fileName
           variantCode.transforms, parseSource);
         case 2:
@@ -142,7 +146,7 @@ function _transformVariant() {
                       whitespace: 'pre'
                     });
                     _context.n = 2;
-                    return transformParsedSource(extraSourceString, extraHastNodes, fileName, fileContent.transforms, parseSource);
+                    return diffHast(extraSourceString, extraHastNodes, fileName, fileContent.transforms, parseSource);
                   case 2:
                     extraTransformResult = _context.v;
                     return _context.a(2, [fileName, _extends(_extends({}, fileContent), {}, {
@@ -177,13 +181,13 @@ function _transformVariant() {
       }
     }, _callee2);
   }));
-  return _transformVariant.apply(this, arguments);
+  return _computeVariantDeltas.apply(this, arguments);
 }
-export function applyTransforms(_x4, _x5) {
-  return _applyTransforms.apply(this, arguments);
+export function computeHastDeltas(_x4, _x5) {
+  return _computeHastDeltas.apply(this, arguments);
 }
-function _applyTransforms() {
-  _applyTransforms = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(parsedCode, parseSource) {
+function _computeHastDeltas() {
+  _computeHastDeltas = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee4(parsedCode, parseSource) {
     var variantsToTransform, results, enhancedCode, _iterator, _step, _step$value, variant, transformedVariant;
     return _regenerator().w(function (_context4) {
       while (1) switch (_context4.n) {
@@ -205,7 +209,7 @@ function _applyTransforms() {
                     _ref8 = _slicedToArray(_ref6, 2), variant = _ref8[0], variantCode = _ref8[1];
                     _context3.p = 1;
                     _context3.n = 2;
-                    return transformVariant(variant, variantCode, parseSource);
+                    return computeVariantDeltas(variant, variantCode, parseSource);
                   case 2:
                     transformedVariant = _context3.v;
                     return _context3.a(2, {
@@ -247,5 +251,5 @@ function _applyTransforms() {
       }
     }, _callee4);
   }));
-  return _applyTransforms.apply(this, arguments);
+  return _computeHastDeltas.apply(this, arguments);
 }

package/esm/pipeline/loadCodeVariant/diffHast.d.ts

@@ -0,0 +1,3 @@
+import type { Nodes } from 'hast';
+import { ParseSource, Transforms } from "../../CodeHighlighter/types.js";
+export declare function diffHast(source: string, parsedSource: Nodes, filename: string, transforms: Transforms, parseSource: ParseSource): Promise<Record<string, any>>;

package/esm/{CodeHighlighter/transformParsedSource.js → pipeline/loadCodeVariant/diffHast.js}

@@ -9,11 +9,11 @@ var differ = create({
   omitRemovedValues: true,
   cloneDiffValues: true
 });
-export function transformParsedSource(_x, _x2, _x3, _x4, _x5) {
-  return _transformParsedSource.apply(this, arguments);
+export function diffHast(_x, _x2, _x3, _x4, _x5) {
+  return _diffHast.apply(this, arguments);
 }
-function _transformParsedSource() {
-  _transformParsedSource = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(source, parsedSource, filename, transforms, parseSource) {
+function _diffHast() {
+  _diffHast = _asyncToGenerator(/*#__PURE__*/_regenerator().m(function _callee2(source, parsedSource, filename, transforms, parseSource) {
     var transformed;
     return _regenerator().w(function (_context2) {
       while (1) switch (_context2.n) {
@@ -56,5 +56,5 @@ function _transformParsedSource() {
       }
     }, _callee2);
   }));
-  return _transformParsedSource.apply(this, arguments);
+  return _diffHast.apply(this, arguments);
 }

package/esm/{CodeHighlighter/examineVariant.d.ts → pipeline/loadCodeVariant/examineCodeVariant.d.ts}

@@ -1,7 +1,7 @@
 /**
  * Variant examination utility for analyzing variant structure and paths
  */
-import type { VariantCode } from "./types.js";
+import type { VariantCode } from "../../CodeHighlighter/types.js";
 interface PathContextBase {
   hasMetadata: boolean;
   maxSourceBackNavigation: number;
@@ -21,5 +21,5 @@ export type PathContext = PathContextWithUrl | PathContextWithoutUrl;
 /**
  * Create path context for processing files with extended information
  */
-export declare function createPathContext(variant: VariantCode): PathContext;
+export declare function examineCodeVariant(variant: VariantCode): PathContext;
 export {};