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

package/CodeHighlighter/buildStringFallback.mjs

@@ -1,5 +1,5 @@
 import { buildRootFallback } from "./fallbackFormat.mjs";
-import { parsePlainText } from "../pipeline/parseSource/index.mjs";
+import { parsePlainText } from "../pipeline/parseSource/createPlainTextRoot.mjs";
 function isPromiseLike(value) {
   return typeof value === 'object' && value !== null && typeof value.then === 'function';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/internal-docs-infra",
-  "version": "0.13.1-canary.1",
+  "version": "0.13.1-canary.3",
   "author": "MUI Team",
   "description": "MUI Infra - internal documentation creation tools.",
   "license": "MIT",
@@ -814,5 +814,5 @@
   "bin": {
     "docs-infra": "./cli/index.mjs"
   },
-  "gitSha": "41611dd904d88de9bbc8dce94594452c144fd2ea"
+  "gitSha": "d81524e8f3c59df916d9e262bdad83961cb98512"
 }

package/pipeline/parseSource/createPlainTextRoot.d.mts

@@ -0,0 +1,18 @@
+import type { ParseSource } from "../../CodeHighlighter/types.mjs";
+export declare function createPlainTextRoot(source: string): ReturnType<ParseSource>;
+/**
+ * Parses source into a line-guttered HAST **without** syntax highlighting — the
+ * raw text wrapped in the same `.line`/`.frame` structure `parseSource` produces,
+ * just no starry-night tokenization. It is a `ParseSource` so it can be dropped
+ * into the loader in place of the highlighting parser.
+ *
+ * Used for the deferred (un-highlighted) fallback: the enhancer pipeline needs the
+ * line/frame structure to compute focus windows and truncation, but the syntax
+ * colors are exactly the part being deferred — so we skip them. Cheap (no grammar,
+ * no `getInstance`); the frames it produces collapse back to text via `buildRootFallback`.
+ *
+ * Takes only `source` (it ignores file name / language since it never highlights) but
+ * stays structurally assignable to `ParseSource`, so it drops into the loader in place
+ * of the highlighting parser.
+ */
+export declare const parsePlainText: (source: string) => ReturnType<ParseSource>;

package/pipeline/parseSource/createPlainTextRoot.mjs

@@ -0,0 +1,38 @@
+import { starryNightGutter } from "./addLineGutters.mjs";
+
+// Lives apart from `parseSource.ts` so callers that only need plain text (the
+// server fallback in `buildStringFallback`) don't statically pull the Starry
+// Night engine (vscode-textmate + oniguruma + grammars) into the page bundle.
+//
+// Builds the plain-text HAST fallback used for unsupported file types and for a
+// mapped-but-not-yet-registered scope. Line gutters are still added so the
+// enhancer pipeline (e.g. auto-focus frames) can operate on the result.
+export function createPlainTextRoot(source) {
+  const root = {
+    type: 'root',
+    children: [{
+      type: 'text',
+      value: source
+    }]
+  };
+  const sourceLines = source.split(/\r?\n|\r/);
+  starryNightGutter(root, sourceLines);
+  return root;
+}
+
+/**
+ * Parses source into a line-guttered HAST **without** syntax highlighting — the
+ * raw text wrapped in the same `.line`/`.frame` structure `parseSource` produces,
+ * just no starry-night tokenization. It is a `ParseSource` so it can be dropped
+ * into the loader in place of the highlighting parser.
+ *
+ * Used for the deferred (un-highlighted) fallback: the enhancer pipeline needs the
+ * line/frame structure to compute focus windows and truncation, but the syntax
+ * colors are exactly the part being deferred — so we skip them. Cheap (no grammar,
+ * no `getInstance`); the frames it produces collapse back to text via `buildRootFallback`.
+ *
+ * Takes only `source` (it ignores file name / language since it never highlights) but
+ * stays structurally assignable to `ParseSource`, so it drops into the loader in place
+ * of the highlighting parser.
+ */
+export const parsePlainText = source => createPlainTextRoot(source);

package/pipeline/parseSource/parseSource.d.mts

@@ -1,22 +1,7 @@
 import { createStarryNight } from '@wooorm/starry-night';
 import type { ParseSource } from "../../CodeHighlighter/types.mjs";
 type StarryNight = Awaited<ReturnType<typeof createStarryNight>>;
-/**
- * Parses source into a line-guttered HAST **without** syntax highlighting — the
- * raw text wrapped in the same `.line`/`.frame` structure `parseSource` produces,
- * just no starry-night tokenization. It is a `ParseSource` so it can be dropped
- * into the loader in place of the highlighting parser.
- *
- * Used for the deferred (un-highlighted) fallback: the enhancer pipeline needs the
- * line/frame structure to compute focus windows and truncation, but the syntax
- * colors are exactly the part being deferred — so we skip them. Cheap (no grammar,
- * no `getInstance`); the frames it produces collapse back to text via `buildRootFallback`.
- *
- * Takes only `source` (it ignores file name / language since it never highlights) but
- * stays structurally assignable to `ParseSource`, so it drops into the loader in place
- * of the highlighting parser.
- */
-export declare const parsePlainText: (source: string) => ReturnType<ParseSource>;
+export { parsePlainText } from "./createPlainTextRoot.mjs";
 /**
  * Parses source code into a HAST tree with syntax highlighting.
  *
@@ -64,5 +49,4 @@ export declare function getStarryNightInstance(): Promise<StarryNight>;
  * Clears the global Starry Night singleton and registration state. Intended for
  * tests exercising lazy registration from a known-empty registry.
  */
-export declare function resetStarryNight(): void;
-export {};
+export declare function resetStarryNight(): void;

package/pipeline/parseSource/parseSource.mjs

@@ -2,6 +2,7 @@ import { createStarryNight } from '@wooorm/starry-night';
 import { resolveGrammarScope } from "./grammarMaps.mjs";
 import { grammarLoaders } from "./grammarLoaders.mjs";
 import { starryNightGutter } from "./addLineGutters.mjs";
+import { createPlainTextRoot } from "./createPlainTextRoot.mjs";
 import { extendSyntaxTokens } from "./extendSyntaxTokens.mjs";
 const STARRY_NIGHT_KEY = '__docs_infra_starry_night_instance__';
 const STARRY_NIGHT_STATE_KEY = '__docs_infra_starry_night_state__';
@@ -24,39 +25,7 @@ function getState() {
   }
   return state;
 }
-
-// Builds the plain-text HAST fallback used for unsupported file types and for a
-// mapped-but-not-yet-registered scope. Line gutters are still added so the
-// enhancer pipeline (e.g. auto-focus frames) can operate on the result.
-function createPlainTextRoot(source) {
-  const root = {
-    type: 'root',
-    children: [{
-      type: 'text',
-      value: source
-    }]
-  };
-  const sourceLines = source.split(/\r?\n|\r/);
-  starryNightGutter(root, sourceLines);
-  return root;
-}
-
-/**
- * Parses source into a line-guttered HAST **without** syntax highlighting — the
- * raw text wrapped in the same `.line`/`.frame` structure `parseSource` produces,
- * just no starry-night tokenization. It is a `ParseSource` so it can be dropped
- * into the loader in place of the highlighting parser.
- *
- * Used for the deferred (un-highlighted) fallback: the enhancer pipeline needs the
- * line/frame structure to compute focus windows and truncation, but the syntax
- * colors are exactly the part being deferred — so we skip them. Cheap (no grammar,
- * no `getInstance`); the frames it produces collapse back to text via `buildRootFallback`.
- *
- * Takes only `source` (it ignores file name / language since it never highlights) but
- * stays structurally assignable to `ParseSource`, so it drops into the loader in place
- * of the highlighting parser.
- */
-export const parsePlainText = source => createPlainTextRoot(source);
+export { parsePlainText } from "./createPlainTextRoot.mjs";
 
 /**
  * Parses source code into a HAST tree with syntax highlighting.