@mui/internal-docs-infra 0.10.1-canary.3 → 0.10.1-canary.5

package/CodeHighlighter/CodeHighlighterClient.d.mts

@@ -1,2 +1,2 @@
-import { CodeHighlighterClientProps } from "./types.mjs";
+import { type CodeHighlighterClientProps } from "./types.mjs";
 export declare function CodeHighlighterClient(props: CodeHighlighterClientProps): import("react/jsx-runtime").JSX.Element;

package/CodeHighlighter/CodeHighlighterContext.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { Code, ControlledCode } from "./types.mjs";
-import { Selection } from "../CodeControllerContext/index.mjs";
+import { type Code, type ControlledCode } from "./types.mjs";
+import { type Selection } from "../CodeControllerContext/index.mjs";
 export interface CodeHighlighterContextType {
   code?: Code;
   setCode?: React.Dispatch<React.SetStateAction<ControlledCode | undefined>>;

package/CodeHighlighter/CodeHighlighterFallbackContext.d.mts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { ContentLoadingVariant } from "./types.mjs";
+import { type ContentLoadingVariant } from "./types.mjs";
 export interface CodeHighlighterFallbackContext extends ContentLoadingVariant {
   extraVariants?: Record<string, ContentLoadingVariant>;
 }

package/CodeHighlighter/codeToFallbackProps.d.mts

@@ -1,2 +1,2 @@
-import { BaseContentLoadingProps, Code } from "./types.mjs";
+import { type BaseContentLoadingProps, type Code } from "./types.mjs";
 export declare function codeToFallbackProps(variant: string, code?: Code, fileName?: string, needsAllFiles?: boolean, needsAllVariants?: boolean): BaseContentLoadingProps;

package/abstractCreateDemo/abstractCreateDemo.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { Code, CodeHighlighterProps, ContentLoadingProps, ContentProps, LoadCodeMeta, LoadSource, LoadVariantMeta, ParseSource, SourceEnhancers } from "../CodeHighlighter/types.mjs";
-import { DemoGlobalData } from "../createDemoData/types.mjs";
+import { type DemoGlobalData } from "../createDemoData/types.mjs";
 type CreateDemoMeta = {
   name?: string;
   slug?: string;

package/createDemoData/createDemoData.d.mts

@@ -1,5 +1,5 @@
-import * as React from 'react';
-import { CreateDemoDataMeta, DemoData, DemoGlobalData, DemoGlobalProvider } from "./types.mjs";
+import type * as React from 'react';
+import { type CreateDemoDataMeta, type DemoData, type DemoGlobalData, type DemoGlobalProvider } from "./types.mjs";
 /**
  * Creates demo data for displaying code examples with syntax highlighting.
  * A variant is a different implementation style of the same component.

package/package.json

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

package/pipeline/hastUtils/getHastTextContent.d.mts

@@ -0,0 +1,9 @@
+import type { Root as HastRoot, Element, Text, RootContent } from 'hast';
+/**
+ * Extracts all text content from a HAST node recursively.
+ */
+export declare function getHastTextContent(node: HastRoot | Element | Text | RootContent): string;
+/**
+ * Gets the direct text content of a HAST element (non-recursive, first level only).
+ */
+export declare function getShallowTextContent(element: Element): string;

package/pipeline/hastUtils/getHastTextContent.mjs

@@ -0,0 +1,25 @@
+/**
+ * Extracts all text content from a HAST node recursively.
+ */
+export function getHastTextContent(node) {
+  if (node.type === 'text') {
+    return node.value || '';
+  }
+  if ('children' in node && Array.isArray(node.children)) {
+    return node.children.map(child => getHastTextContent(child)).join('');
+  }
+  return '';
+}
+
+/**
+ * Gets the direct text content of a HAST element (non-recursive, first level only).
+ */
+export function getShallowTextContent(element) {
+  let text = '';
+  for (const child of element.children) {
+    if (child.type === 'text') {
+      text += child.value;
+    }
+  }
+  return text;
+}

package/pipeline/hastUtils/index.d.mts

@@ -1,3 +1,4 @@
 export * from "./hastCompression.mjs";
 export * from "./hastUtils.mjs";
+export { getHastTextContent, getShallowTextContent } from "./getHastTextContent.mjs";
 export { stripHighlightingSpans } from "./stripHighlightingSpans.mjs";

package/pipeline/hastUtils/index.mjs

@@ -1,3 +1,4 @@
 export * from "./hastCompression.mjs";
 export * from "./hastUtils.mjs";
+export { getHastTextContent, getShallowTextContent } from "./getHastTextContent.mjs";
 export { stripHighlightingSpans } from "./stripHighlightingSpans.mjs";

package/pipeline/loadCodeVariant/diffHast.d.mts

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

package/pipeline/loadCodeVariant/hasAllCodeVariants.d.mts

@@ -1,4 +1,4 @@
-import { Code } from "../../CodeHighlighter/types.mjs";
+import { type Code } from "../../CodeHighlighter/types.mjs";
 /**
  * Determines if all code variants are fully loaded and ready to render the complete content component.
  *

package/pipeline/loadCodeVariant/maybeCodeInitialData.d.mts

@@ -1,4 +1,4 @@
-import { Code, VariantExtraFiles, VariantSource } from "../../CodeHighlighter/types.mjs";
+import { type Code, type VariantExtraFiles, type VariantSource } from "../../CodeHighlighter/types.mjs";
 /**
  * Type guard function that determines if we have sufficient data to render a code highlighter
  * component immediately, or if we need to start loading data first.

package/pipeline/loadServerTypes/hastTypeUtils.d.mts

@@ -4,20 +4,14 @@
  * These utilities work on already-highlighted HAST nodes to detect type patterns
  * (unions, functions, objects) and derive shortType/detailedType variants.
  */
-import type { Root as HastRoot, Element, Text, RootContent } from 'hast';
-/**
- * Extracts all text content from a HAST node recursively.
- */
-export declare function getHastTextContent(node: HastRoot | Element | Text | RootContent): string;
+import type { Root as HastRoot, Element } from 'hast';
+import { getHastTextContent, getShallowTextContent } from "../hastUtils/index.mjs";
+export { getHastTextContent, getShallowTextContent };
 /**
  * Checks if a HAST element has a specific CSS class.
  * Handles both string and array class representations.
  */
 export declare function hasClass(element: Element, className: string): boolean;
-/**
- * Gets the direct text content of a HAST element (non-recursive, first level only).
- */
-export declare function getShallowTextContent(element: Element): string;
 /**
  * Checks if a HAST element is a span with class `line`.
  */

package/pipeline/loadServerTypes/hastTypeUtils.mjs

@@ -5,20 +5,8 @@
  * (unions, functions, objects) and derive shortType/detailedType variants.
  */
 
-import { compressHast } from "../hastUtils/index.mjs";
-
-/**
- * Extracts all text content from a HAST node recursively.
- */
-export function getHastTextContent(node) {
-  if (node.type === 'text') {
-    return node.value || '';
-  }
-  if ('children' in node && Array.isArray(node.children)) {
-    return node.children.map(child => getHastTextContent(child)).join('');
-  }
-  return '';
-}
+import { compressHast, getHastTextContent, getShallowTextContent } from "../hastUtils/index.mjs";
+export { getHastTextContent, getShallowTextContent };
 
 /**
  * Checks if a HAST element has a specific CSS class.
@@ -35,19 +23,6 @@ export function hasClass(element, className) {
   return false;
 }
 
-/**
- * Gets the direct text content of a HAST element (non-recursive, first level only).
- */
-export function getShallowTextContent(element) {
-  let text = '';
-  for (const child of element.children) {
-    if (child.type === 'text') {
-      text += child.value;
-    }
-  }
-  return text;
-}
-
 /**
  * Checks if a HAST element is a span with class `line`.
  */

package/pipeline/loadServerTypesMeta/createOptimizedProgram.d.mts

@@ -1,4 +1,4 @@
-import ts, { CompilerOptions } from 'typescript';
+import ts, { type CompilerOptions } from 'typescript';
 import type { PerformanceTracker } from "./performanceTracking.mjs";
 export interface TypesMetaOptions {
   /**

package/pipeline/loadServerTypesMeta/formatClass.d.mts

@@ -1,4 +1,4 @@
-import * as tae from 'typescript-api-extractor';
+import type * as tae from 'typescript-api-extractor';
 import { type FormattedParameter, type FormatInlineTypeOptions, type DescriptionReplacement } from "./format.mjs";
 import { type TypeRewriteContext } from "./rewriteTypes.mjs";
 import type { ExternalTypesCollector } from "./externalTypes.mjs";

package/pipeline/loadServerTypesMeta/formatComponent.d.mts

@@ -1,4 +1,4 @@
-import * as tae from 'typescript-api-extractor';
+import type * as tae from 'typescript-api-extractor';
 import { type FormattedProperty, type FormattedEnumMember, type FormatInlineTypeOptions, type DescriptionReplacement } from "./format.mjs";
 import { type TypeRewriteContext } from "./rewriteTypes.mjs";
 import type { ExternalTypesCollector } from "./externalTypes.mjs";

package/pipeline/loadServerTypesMeta/formatFunction.d.mts

@@ -1,4 +1,4 @@
-import * as tae from 'typescript-api-extractor';
+import type * as tae from 'typescript-api-extractor';
 import { type FormattedParameter, type FormattedProperty, type FormatInlineTypeOptions, type DescriptionReplacement } from "./format.mjs";
 import { type TypeRewriteContext } from "./rewriteTypes.mjs";
 import type { ExternalTypesCollector } from "./externalTypes.mjs";

package/pipeline/loadServerTypesMeta/formatHook.d.mts

@@ -1,4 +1,4 @@
-import * as tae from 'typescript-api-extractor';
+import type * as tae from 'typescript-api-extractor';
 import { type FormattedProperty, type FormattedParameter, type FormatInlineTypeOptions, type DescriptionReplacement } from "./format.mjs";
 import { type TypeRewriteContext } from "./rewriteTypes.mjs";
 import type { ExternalTypesCollector } from "./externalTypes.mjs";

package/pipeline/loadServerTypesMeta/formatRaw.d.mts

@@ -1,4 +1,4 @@
-import * as tae from 'typescript-api-extractor';
+import type * as tae from 'typescript-api-extractor';
 import { type FormattedProperty, type FormatInlineTypeOptions, type DescriptionReplacement } from "./format.mjs";
 import { type TypeRewriteContext } from "./rewriteTypes.mjs";
 import type { ExternalTypesCollector } from "./externalTypes.mjs";

package/pipeline/loadServerTypesMeta/loadServerTypesMeta.d.mts

@@ -1,8 +1,8 @@
-import { ClassTypeMeta as ClassType } from "./formatClass.mjs";
-import { ComponentTypeMeta as ComponentType } from "./formatComponent.mjs";
-import { HookTypeMeta as HookType } from "./formatHook.mjs";
-import { FunctionTypeMeta as FunctionType } from "./formatFunction.mjs";
-import { RawTypeMeta as RawType, type ReExportInfo } from "./formatRaw.mjs";
+import { type ClassTypeMeta as ClassType } from "./formatClass.mjs";
+import { type ComponentTypeMeta as ComponentType } from "./formatComponent.mjs";
+import { type HookTypeMeta as HookType } from "./formatHook.mjs";
+import { type FunctionTypeMeta as FunctionType } from "./formatFunction.mjs";
+import { type RawTypeMeta as RawType, type ReExportInfo } from "./formatRaw.mjs";
 import { type FormattedProperty, type FormattedEnumMember, type FormattedParameter, type FormatInlineTypeOptions, type DescriptionReplacement } from "./format.mjs";
 import type { OrderingConfig } from "../loadServerTypesText/order.mjs";
 import { type OrganizeTypesResult } from "../loadServerTypesText/organizeTypesByExport.mjs";

package/pipeline/loadServerTypesMeta/processTypes.d.mts

@@ -1,5 +1,5 @@
 import type { CompilerOptions } from 'typescript';
-import { ExportNode } from 'typescript-api-extractor';
+import { type ExportNode } from 'typescript-api-extractor';
 import { type PerformanceLog } from "./performanceTracking.mjs";
 export interface VariantResult {
   exports: ExportNode[];

package/pipeline/parseSource/addLineGutters.mjs

@@ -127,16 +127,26 @@ export function starryNightGutter(tree, sourceLines, frameSize = 120) {
     replacement.push(createFrame(frameLines));
   }
 
-  // If there are multiple frames and sourceLines provided, add dataAsString to each frame
+  // If there are multiple frames and sourceLines provided, add dataAsString to each frame.
+  // Every frame except the last covers `frameSize` source lines, each of which
+  // was followed by a newline separator in the original source, so its text
+  // ends with a trailing '\n'. The final frame only carries a trailing newline
+  // if the source itself ends with one. Without this trailing '\n', the
+  // plain-text fallback and the highlighted render disagree by exactly one
+  // newline per non-final frame, which causes a layout shift during lazy
+  // hydration when a frame toggles between the two.
   if (replacement.length > 1 && sourceLines) {
-    for (const frame of replacement) {
+    const lastIndex = replacement.length - 1;
+    for (let frameIndex = 0; frameIndex < replacement.length; frameIndex += 1) {
+      const frame = replacement[frameIndex];
       if (frame.type === 'element' && frame.tagName === 'span' && frame.properties?.className === 'frame') {
         // Extract line range from child .line elements
         const lineChildren = frame.children.filter(c => c.type === 'element' && c.properties?.className === 'line' && typeof c.properties.dataLn === 'number');
         if (lineChildren.length > 0) {
           const startLine = Number(lineChildren[0].properties.dataLn) - 1;
           const endLine = Number(lineChildren[lineChildren.length - 1].properties.dataLn);
-          frame.properties.dataAsString = sourceLines.slice(startLine, endLine).join('\n');
+          const joined = sourceLines.slice(startLine, endLine).join('\n');
+          frame.properties.dataAsString = frameIndex < lastIndex ? `${joined}\n` : joined;
         }
       }
     }

package/pipeline/syncPageIndex/metadataToMarkdown.d.mts

@@ -1,6 +1,6 @@
 import type { Root } from 'mdast';
 import type { ExtractedMetadata } from "../transformMarkdownMetadata/types.mjs";
-import { Audience } from "../../createSitemap/types.mjs";
+import { type Audience } from "../../createSitemap/types.mjs";
 export interface PageMetadata extends ExtractedMetadata {
   /** The slug/path for this page (e.g., 'button', 'checkbox') */
   slug: string;

package/pipeline/transformHtmlCodeInline/transformHtmlCodeInline.mjs

@@ -2,6 +2,7 @@ import { createStarryNight } from '@wooorm/starry-night';
 import { visit } from 'unist-util-visit';
 import { grammars, extensionMap } from "../parseSource/grammars.mjs";
 import { extendSyntaxTokens } from "../parseSource/extendSyntaxTokens.mjs";
+import { getHastTextContent } from "../hastUtils/index.mjs";
 import { removePrefixFromHighlightedNodes } from "./removePrefixFromHighlightedNodes.mjs";
 const STARRY_NIGHT_KEY = '__docs_infra_starry_night_instance__';
 
@@ -56,18 +57,7 @@ export default function transformHtmlCodeInline(options = {}) {
       }
 
       // Extract all text content from children (handles multiple text nodes and newlines)
-      const getTextContent = children => {
-        return children.map(child => {
-          if (child.type === 'text') {
-            return child.value;
-          }
-          if (child.type === 'element' && 'children' in child) {
-            return getTextContent(child.children);
-          }
-          return '';
-        }).join('');
-      };
-      const source = getTextContent(node.children);
+      const source = node.children.map(child => getHastTextContent(child)).join('');
       if (!source) {
         return;
       }

package/pipeline/transformMarkdownMetadata/types.d.mts

@@ -1,5 +1,5 @@
 import type { PhrasingContent } from 'mdast';
-import { Audience } from "../../createSitemap/types.mjs";
+import { type Audience } from "../../createSitemap/types.mjs";
 /**
  * Base options for syncing page indexes.
  * Shared between extractToIndex (markdown metadata) and updateParentIndex (types).

package/useCode/useCode.d.mts

@@ -1,6 +1,6 @@
 import * as React from 'react';
 import type { ContentProps, SourceEnhancers } from "../CodeHighlighter/types.mjs";
-import { UseCopierOpts } from "../useCopier/index.mjs";
+import { type UseCopierOpts } from "../useCopier/index.mjs";
 export type UseCodeOpts = {
   preClassName?: string;
   preRef?: React.Ref<HTMLPreElement>;

package/useCode/useCopyFunctionality.d.mts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { UseCopierOpts } from "../useCopier/index.mjs";
+import { type UseCopierOpts } from "../useCopier/index.mjs";
 import type { VariantSource } from "../CodeHighlighter/types.mjs";
 interface UseCopyFunctionalityProps {
   selectedFile: VariantSource | null;

package/useCode/useTransformManagement.d.mts

@@ -1,6 +1,6 @@
 import type { Code, VariantCode } from "../CodeHighlighter/types.mjs";
 import { createTransformedFiles } from "./useCodeUtils.mjs";
-import { CodeHighlighterContextType } from "../CodeHighlighter/CodeHighlighterContext.mjs";
+import { type CodeHighlighterContextType } from "../CodeHighlighter/CodeHighlighterContext.mjs";
 interface UseTransformManagementProps {
   context?: CodeHighlighterContextType;
   effectiveCode: Code;

package/useSearch/types.d.mts

@@ -1,4 +1,4 @@
-import { ElapsedTime, Orama, SearchParams } from '@orama/orama';
+import { type ElapsedTime, type Orama, type Result, type SearchParams } from '@orama/orama';
 import type { Sitemap, SitemapPage, SitemapSection, SitemapPart, SitemapExport, SitemapSectionData } from "../createSitemap/types.mjs";
 /**
  * Base search result structure that can be extended by consumers
@@ -140,7 +140,7 @@ export interface UseSearchOptions {
   /** Custom function to flatten sitemap pages into search results */
   flattenPage?: (page: SitemapPage, sectionData: SitemapSectionData) => SearchResult[];
   /** Custom function to format Orama search hits into typed results */
-  formatResult?: <TDocument = unknown>(hit: import('@orama/orama').Result<TDocument>) => SearchResult;
+  formatResult?: <TDocument = unknown>(hit: Result<TDocument>) => SearchResult;
 }
 export type SearchBy<T> = Pick<SearchParams<Orama<T>>, 'facets' | 'groupBy' | 'limit' | 'offset' | 'where'>;
 /**

package/useType/useType.d.mts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import { type TypeData } from "./TypesDataContext.mjs";
 /**
  * Props passed to the custom `typeRefComponent` element.

package/useType/useTypeProp.d.mts

@@ -1,4 +1,4 @@
-import * as React from 'react';
+import type * as React from 'react';
 import { type TypePropData } from "./TypesDataContext.mjs";
 /**
  * Props passed to the custom `typePropRefComponent` element.