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

package/package.json

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

package/pipeline/enhanceCodeEmphasis/enhanceCodeEmphasis.mjs

@@ -587,7 +587,11 @@ function calculateEmphasizedLines(directives, lineElements) {
         lineHighlight: directive.lineHighlight,
         focus: directive.focus,
         paddingFrameMaxSize: directive.paddingFrameMaxSize,
-        focusFramesMaxSize: directive.focusFramesMaxSize
+        focusFramesMaxSize: directive.focusFramesMaxSize,
+        // Treat a single `@highlight` as a containing highlight range of depth 1
+        // so that an outer multiline range wrapping this line is detected as
+        // nesting and promoted to `strong`.
+        containingRangeDepth: directive.lineHighlight ? 1 : undefined
       });
     } else if (directive.type === 'text') {
       // Text highlight - emphasize specific text(s) within the line.
@@ -640,7 +644,12 @@ function calculateEmphasizedLines(directives, lineElements) {
 
         // Determine position for this line in the current range
         let position;
-        if (line === startLine && line !== endLine) {
+        if (line === startLine && line === endLine) {
+          // A multiline range that resolves to a single content line (e.g.
+          // when comment-only lines are stripped) should be treated as a
+          // standalone single-line highlight.
+          position = 'single';
+        } else if (line === startLine && line !== endLine) {
           position = 'start';
         } else if (line === endLine && line !== startLine) {
           position = 'end';
@@ -651,13 +660,20 @@ function calculateEmphasizedLines(directives, lineElements) {
         // A focus range overlapping with a highlight is not nesting — it just
         // merges focus into the existing entry.
         const meta = existing ? {
-          // Nested highlight ranges are strong; focus+highlight overlap is not
-          strong: existing.lineHighlight && startDirective.lineHighlight && !existing.highlightTexts || existing.strong || strong,
+          // Nested highlight ranges are strong; focus+highlight overlap is not.
+          // Detect true nesting via `containingRangeDepth` rather than
+          // `existing.lineHighlight`. This works when the existing entry
+          // came from a `@highlight-text` directive on a line that's also
+          // wrapped in a highlight range — `existing.lineHighlight` is true
+          // after the first range merge, so a second wrapping range needs to
+          // see the depth to know nesting occurred.
+          strong: (existing.containingRangeDepth ?? 0) >= 1 && startDirective.lineHighlight || existing.strong || strong,
           description: existing.description ?? (line === startLine ? description : undefined),
           // Inner range position takes precedence, but 'single' from a standalone
           // @highlight-text should be replaced by the multiline range's position.
-          // Keep 'single' from regular @highlight (no highlightTexts).
-          position: existing.position && !(existing.position === 'single' && existing.highlightTexts) ? existing.position : position,
+          // Keep 'single' from a real @highlight (lineHighlight is set), even when
+          // the line also carries @highlight-text.
+          position: existing.position && !(existing.position === 'single' && existing.highlightTexts && !existing.lineHighlight) ? existing.position : position,
           highlightTexts: existing.highlightTexts,
           // Preserve text highlights from @highlight-text
           lineHighlight: existing.lineHighlight || startDirective.lineHighlight,
@@ -682,7 +698,10 @@ function calculateEmphasizedLines(directives, lineElements) {
           focus: startDirective.focus,
           paddingFrameMaxSize: startDirective.paddingFrameMaxSize,
           focusFramesMaxSize: startDirective.focusFramesMaxSize,
-          propagatedOverride: true
+          propagatedOverride: true,
+          // Track depth so a wrapping outer range can detect nesting
+          // (used by the `strong` calculation above).
+          containingRangeDepth: startDirective.lineHighlight ? 1 : undefined
         };
         emphasizedLines.set(line, meta);
       }