@mui/internal-docs-infra 0.9.1-canary.0 → 0.10.1-canary.1

package/CodeHighlighter/types.d.mts

@@ -24,6 +24,8 @@ export type Externals = Record<string, ExternalImportItem[]>;
 export interface HastRoot extends Root {
   data?: RootData & {
     totalLines?: number;
+    collapsible?: boolean;
+    frameSize?: number;
   };
 }
 export type VariantSource = string | HastRoot | {

package/abstractCreateDemo/abstractCreateDemo.d.mts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import type { Code, CodeHighlighterProps, ContentLoadingProps, ContentProps, LoadCodeMeta, LoadSource, LoadVariantMeta, ParseSource } from "../CodeHighlighter/types.mjs";
+import type { Code, CodeHighlighterProps, ContentLoadingProps, ContentProps, LoadCodeMeta, LoadSource, LoadVariantMeta, ParseSource, SourceEnhancers } from "../CodeHighlighter/types.mjs";
 import { DemoGlobalData } from "../createDemoData/types.mjs";
 type CreateDemoMeta = {
   name?: string;
@@ -32,6 +32,7 @@ type AbstractCreateDemoOptions<T extends {}> = {
   loadVariantMeta?: LoadVariantMeta;
   loadSource?: LoadSource;
   sourceParser?: Promise<ParseSource>;
+  sourceEnhancers?: SourceEnhancers;
 };
 export declare function abstractCreateDemo<T extends {}>(options: AbstractCreateDemoOptions<T>, url: string, variants: {
   [key: string]: React.ComponentType;

package/abstractCreateDemo/abstractCreateDemo.mjs

@@ -31,6 +31,7 @@ export function abstractCreateDemo(options, url, variants, meta) {
       loadVariantMeta: options.loadVariantMeta,
       loadSource: options.loadSource,
       sourceParser: options.sourceParser,
+      sourceEnhancers: options.sourceEnhancers,
       highlightAfter: meta?.highlightAfter || options.highlightAfter,
       enhanceAfter: meta?.enhanceAfter || options.enhanceAfter,
       controlled: options.controlled,

package/cli/index.mjs

@@ -7,4 +7,4 @@ function getVersion() {
 }
 yargs().scriptName('docs-infra').usage('$0 <command> [args]').command(runValidate).demandCommand(1, 'You need at least one command before moving on').strict().help()
 // MUI_VERSION is set through the code-infra build command.
-.version("0.9.0" || getVersion()).parse(hideBin(process.argv));
+.version("0.10.0" || getVersion()).parse(hideBin(process.argv));

package/cli/loadNextConfig.d.mts

@@ -4,6 +4,7 @@ export type ExtractedNextConfigOptions = {
   ordering?: OrderingConfig;
   descriptionReplacements?: DescriptionReplacement[];
   useVisibleDescription?: boolean;
+  socketDir?: string;
 };
 /**
  * Dynamically imports the next config from the given directory and extracts

package/cli/loadNextConfig.mjs

@@ -29,7 +29,8 @@ function extractUseVisibleDescriptionFromRemarkPlugins(remarkPlugins) {
 }
 
 /**
- * Extracts ordering and useVisibleDescription from loader options in a single pass.
+ * Extracts docs-infra options (ordering, descriptionReplacements, socketDir,
+ * useVisibleDescription) from loader options in a single pass.
  */
 function extractOptionsFromLoaderEntries(loaders) {
   const result = {};
@@ -43,6 +44,9 @@ function extractOptionsFromLoaderEntries(loaders) {
     if (!result.descriptionReplacements && loader.loader === TYPES_LOADER && loader.options?.descriptionReplacements) {
       result.descriptionReplacements = loader.options.descriptionReplacements;
     }
+    if (!result.socketDir && loader.loader === TYPES_LOADER && typeof loader.options?.socketDir === 'string') {
+      result.socketDir = loader.options.socketDir;
+    }
     if (result.useVisibleDescription === undefined && loader.options?.remarkPlugins) {
       const extracted = extractUseVisibleDescriptionFromRemarkPlugins(loader.options.remarkPlugins);
       if (typeof extracted === 'boolean') {
@@ -54,7 +58,8 @@ function extractOptionsFromLoaderEntries(loaders) {
 }
 
 /**
- * Searches turbopack rules for docs-infra options (ordering + useVisibleDescription).
+ * Searches turbopack rules for docs-infra options (ordering,
+ * descriptionReplacements, socketDir, useVisibleDescription).
  */
 function extractOptionsFromTurbopack(config) {
   const rules = config?.turbopack?.rules;
@@ -71,13 +76,15 @@ function extractOptionsFromTurbopack(config) {
     merged.ordering ??= extracted.ordering;
     merged.descriptionReplacements ??= extracted.descriptionReplacements;
     merged.useVisibleDescription ??= extracted.useVisibleDescription;
+    merged.socketDir ??= extracted.socketDir;
   }
   return merged;
 }
 
 /**
  * Calls the webpack function with a minimal config and extracts docs-infra
- * options (ordering + useVisibleDescription) from the resulting rules.
+ * options (ordering, descriptionReplacements, socketDir, useVisibleDescription)
+ * from the resulting rules.
  */
 function extractOptionsFromWebpack(config) {
   if (typeof config?.webpack !== 'function') {
@@ -105,6 +112,7 @@ function extractOptionsFromWebpack(config) {
       merged.ordering ??= extracted.ordering;
       merged.descriptionReplacements ??= extracted.descriptionReplacements;
       merged.useVisibleDescription ??= extracted.useVisibleDescription;
+      merged.socketDir ??= extracted.socketDir;
     }
     return merged;
   } catch {
@@ -131,7 +139,8 @@ export async function extractDocsInfraOptionsFromNextConfig(dir) {
     return {
       ordering: turbopack.ordering ?? webpack.ordering,
       descriptionReplacements: turbopack.descriptionReplacements ?? webpack.descriptionReplacements,
-      useVisibleDescription: turbopack.useVisibleDescription ?? webpack.useVisibleDescription
+      useVisibleDescription: turbopack.useVisibleDescription ?? webpack.useVisibleDescription,
+      socketDir: turbopack.socketDir ?? webpack.socketDir
     };
   } catch {
     // Config not importable — use defaults

package/cli/runValidate.mjs

@@ -85,8 +85,10 @@ const runValidate = {
     const {
       ordering,
       descriptionReplacements,
-      useVisibleDescription = false
+      useVisibleDescription = false,
+      socketDir: configSocketDir
     } = await extractDocsInfraOptionsFromNextConfig(cwd);
+    const socketDir = configSocketDir ? path.resolve(cwd, configSocketDir) : undefined;
 
     // If neither flag is set, run both. If one is set, run only that one.
     const runIndexes = !typesOnly || indexesOnly;
@@ -282,7 +284,8 @@ const runValidate = {
                 markerDir: typesMarkerDir
               },
               ordering,
-              descriptionReplacements
+              descriptionReplacements,
+              socketDir
             }
           });
         }));

package/cli/validateWorker.mjs

@@ -73,7 +73,8 @@ if (parentPort) {
             watchSourceDirectly: Boolean(typesMetaCall.structuredOptions?.watchSourceDirectly),
             updateParentIndex: excludeFromIndex ? undefined : task.syncTypesOptions.updateParentIndex,
             ordering: task.syncTypesOptions.ordering,
-            descriptionReplacements: task.syncTypesOptions.descriptionReplacements
+            descriptionReplacements: task.syncTypesOptions.descriptionReplacements,
+            socketDir: task.syncTypesOptions.socketDir
           });
           parentPort.postMessage({
             type: 'types',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mui/internal-docs-infra",
-  "version": "0.9.1-canary.0",
+  "version": "0.10.1-canary.1",
   "author": "MUI Team",
   "description": "MUI Infra - internal documentation creation tools.",
   "license": "MIT",
@@ -429,6 +429,16 @@
         "default": "./pipeline/hastUtils/index.mjs"
       }
     },
+    "./pipeline/lintJavascriptDemoFocus": {
+      "import": {
+        "types": "./pipeline/lintJavascriptDemoFocus/index.d.mts",
+        "default": "./pipeline/lintJavascriptDemoFocus/index.mjs"
+      },
+      "default": {
+        "types": "./pipeline/lintJavascriptDemoFocus/index.d.mts",
+        "default": "./pipeline/lintJavascriptDemoFocus/index.mjs"
+      }
+    },
     "./pipeline/loadCodeVariant": {
       "import": {
         "types": "./pipeline/loadCodeVariant/index.d.mts",
@@ -633,5 +643,5 @@
   "bin": {
     "docs-infra": "./cli/index.mjs"
   },
-  "gitSha": "3feee347096f50b441cad3087743bd1c5aef8651"
+  "gitSha": "eb63c846936de0d8b339188c5191c2c524357cc7"
 }

package/pipeline/enhanceCodeEmphasis/enhanceCodeEmphasis.d.mts

@@ -6,6 +6,23 @@ export type { EmphasisMeta, EnhanceCodeEmphasisOptions, FrameRange } from "../pa
  * Comments starting with this prefix will be processed for emphasis.
  */
 export declare const EMPHASIS_COMMENT_PREFIX = "@highlight";
+/**
+ * The prefix used to identify focus-only comments in source code.
+ * Comments starting with this prefix will mark the region as focused without highlighting.
+ */
+export declare const FOCUS_COMMENT_PREFIX = "@focus";
+/**
+ * Modifier token used inside `@highlight` / `@focus` comments
+ * to override padding for that directive.
+ * Example: @highlight @padding 2.
+ */
+export declare const PADDING_COMMENT_PREFIX = "@padding";
+/**
+ * Modifier token used inside `@highlight` / `@focus` comments
+ * to override focus max size for that directive.
+ * Example: @highlight @min 6.
+ */
+export declare const MIN_COMMENT_PREFIX = "@min";
 /**
  * Creates a source enhancer that adds emphasis to code lines based on `@highlight` comments
  * and restructures frames around highlighted regions.