@astryxdesign/core 0.7.4 → 0.7.5-canary.0418c47

package/dist/Markdown/Markdown.fr23.sampling.d.ts

@@ -1,2 +1,18 @@
+/**
+ * @file Markdown.fr23.sampling.ts
+ * @input Baseline/candidate callbacks and the main thread's microsecond CPU clock
+ * @output The FR23 paired-median ratio
+ * @position Test-only sampling for Markdown.fr23.bench.ts
+ */
+/**
+ * CPU time of the calling thread, in microseconds: the time the measured call
+ * holds the JS thread, its own garbage-collection pauses included.
+ *
+ * Not `process.cpuUsage()`, which sums every thread of the process: V8's
+ * concurrent GC and compiler threads run during the timed windows, and their
+ * CPU lands in whichever window is open. At 500 sections that made even the
+ * A/A control (identical work on both sides) vary by up to 13 percent.
+ */
+export declare function mainThreadCpuTime(): number;
 export declare function measureMarkdownPairedRatio(baseline: () => number, candidate: () => number, now?: () => number): number;
 //# sourceMappingURL=Markdown.fr23.sampling.d.ts.map

package/dist/Markdown/Markdown.fr23.sampling.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Markdown.fr23.sampling.d.ts","sourceRoot":"","sources":["../../src/Markdown/Markdown.fr23.sampling.ts"],"names":[],"mappings":"AAmBA,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,MAAM,EACtB,SAAS,EAAE,MAAM,MAAM,EACvB,GAAG,GAAE,MAAM,MAAgB,GAC1B,MAAM,CAyBR"}
+{"version":3,"file":"Markdown.fr23.sampling.d.ts","sourceRoot":"","sources":["../../src/Markdown/Markdown.fr23.sampling.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAG1C;AAOD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,MAAM,MAAM,EACtB,SAAS,EAAE,MAAM,MAAM,EACvB,GAAG,GAAE,MAAM,MAA0B,GACpC,MAAM,CAyBR"}

package/dist/Markdown/Markdown.fr23.sampling.js

@@ -2,20 +2,29 @@
 
 /**
  * @file Markdown.fr23.sampling.ts
- * @input Baseline/candidate callbacks and a microsecond CPU clock
+ * @input Baseline/candidate callbacks and the main thread's microsecond CPU clock
  * @output The FR23 paired-median ratio
  * @position Test-only sampling for Markdown.fr23.bench.ts
  */
 
-function cpuTime() {
-  const used = process.cpuUsage();
+/**
+ * CPU time of the calling thread, in microseconds: the time the measured call
+ * holds the JS thread, its own garbage-collection pauses included.
+ *
+ * Not `process.cpuUsage()`, which sums every thread of the process: V8's
+ * concurrent GC and compiler threads run during the timed windows, and their
+ * CPU lands in whichever window is open. At 500 sections that made even the
+ * A/A control (identical work on both sides) vary by up to 13 percent.
+ */
+export function mainThreadCpuTime() {
+  const used = process.threadCpuUsage();
   return used.user + used.system;
 }
 function median(values) {
   const sorted = [...values].sort((left, right) => left - right);
   return sorted[Math.floor(sorted.length / 2)];
 }
-export function measureMarkdownPairedRatio(baseline, candidate, now = cpuTime) {
+export function measureMarkdownPairedRatio(baseline, candidate, now = mainThreadCpuTime) {
   let sink = 0;
   const average = callback => {
     const start = now();

package/dist/Markdown/Markdown.js

@@ -8,13 +8,14 @@
  * @output Exports Markdown component, MarkdownProps, and renderer contracts
  * @position Core implementation; renders markdown as Astryx components
  */
-import { Suspense, useMemo, useRef } from 'react';
+import { Suspense, useMemo, useRef, useState } from 'react';
 import { Fragment } from 'react';
 import * as stylex from '@stylexjs/stylex';
 import "../theme/tokens.stylex.js";
 import { colorVars, spacingVars, radiusVars, typeScaleVars, typographyVars, fontWeightVars, borderVars, durationVars, easeVars } from "../theme/tokens.stylex.js";
 import { CodeBlock, Code } from "../CodeBlock/index.js";
 import { parseFenceLanguage } from "../CodeBlock/tokenizer.js";
+import { listedLanguage, sameCodeLanguageList } from "../CodeBlock/grammar.js";
 import { CheckboxList } from "../CheckboxList/CheckboxList.js";
 import { CheckboxListItem } from "../CheckboxList/CheckboxListItem.js";
 import { Blockquote } from "../Blockquote/Blockquote.js";
@@ -921,7 +922,9 @@ function computeTableColumnMinWidths(node) {
     return Math.min(TABLE_COLUMN_MAX_CH, Math.max(TABLE_COLUMN_MIN_CH, bodyFloor, headerFloor));
   });
 }
-function renderBlock(node, index, blockCount, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent = 'a', inlinePlugins, components, preparedPlugins, t, headingProjection,
+function renderBlock(node, index, blockCount, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent = 'a', inlinePlugins, components, preparedPlugins, t,
+// Language values fences may name (component:Markdown FR30).
+codeLanguages, headingProjection,
 // How many lists enclose this block (spec:AST-061 DEC-6).
 listDepth = 0) {
   const blockAlignMargin = BLOCK_ALIGN_MARGIN[contentAlign];
@@ -1027,7 +1030,10 @@ listDepth = 0) {
         const isDiff = fence.isDiff;
         // The language under the diff layer; the default CodeBlock renders it.
         const diffLanguage = isDiff ? fence.language.match(/^\w*/)?.[0] || 'plaintext' : undefined;
-        const language = diffLanguage ?? legacyLanguage;
+        const fenceWord = diffLanguage ?? legacyLanguage;
+        // A listed language value claims its identifiers ahead of a built-in
+        // with the same identifier (component:Markdown FR30).
+        const language = listedLanguage(codeLanguages, fenceWord) ?? fenceWord;
         // A semantic-fence proposal claims its fence before the host's code
         // renderer (spec:AST-036 FR17). The host renderer, or the default Code
         // block without one, draws every unclaimed fence and is the fallback
@@ -1109,7 +1115,7 @@ listDepth = 0) {
       {
         const BlockquoteComp = components?.blockquote;
         if (BlockquoteComp) {
-          const bqC = node.children.map((c, i) => renderBlock(c, i, node.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, headingProjection, listDepth));
+          const bqC = node.children.map((c, i) => renderBlock(c, i, node.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, codeLanguages, headingProjection, listDepth));
           return /*#__PURE__*/_jsx(BlockquoteComp, {
             ...lineProp,
             children: bqC
@@ -1121,7 +1127,7 @@ listDepth = 0) {
           }),
           ...lineStamps,
           xstyle: [spacing, contentWidthValue != null ? dynamicStyles.proseWidth(contentWidthValue) : undefined, contentAlign !== 'start' ? dynamicStyles.proseAlign(ALIGN_MARGIN[contentAlign]) : undefined, isFirst && styles.noMarginBlockStart, isLast && styles.noMarginBlockEnd],
-          children: node.children.map((c, i) => renderBlock(c, i, node.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, headingProjection, listDepth))
+          children: node.children.map((c, i) => renderBlock(c, i, node.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, codeLanguages, headingProjection, listDepth))
         }, index);
       }
     case 'list':
@@ -1155,7 +1161,7 @@ listDepth = 0) {
                 const label = isInline ? /*#__PURE__*/_jsx(_Fragment, {
                   children: firstChild.children.map((c, j) => renderInline(c, j, onLinkClick, cursor, citationCtx, linkComponent, inlinePlugins, components, preparedPlugins))
                 }) : /*#__PURE__*/_jsx(_Fragment, {
-                  children: item.children.map((c, j) => renderBlock(c, j, item.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, headingProjection, listDepth + 1))
+                  children: item.children.map((c, j) => renderBlock(c, j, item.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, codeLanguages, headingProjection, listDepth + 1))
                 });
                 return /*#__PURE__*/_jsx(CheckboxListItem
                 // eslint-disable-next-line @eslint-react/no-array-index-key -- markdown task items are rendered from positional AST nodes
@@ -1187,7 +1193,7 @@ listDepth = 0) {
               const label = isInline ? /*#__PURE__*/_jsx(_Fragment, {
                 children: firstChild.children.map((c, j) => renderInline(c, j, onLinkClick, cursor, citationCtx, linkComponent, inlinePlugins, components, preparedPlugins))
               }) : /*#__PURE__*/_jsx(_Fragment, {
-                children: item.children.map((c, j) => renderBlock(c, j, item.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, headingProjection, listDepth + 1))
+                children: item.children.map((c, j) => renderBlock(c, j, item.children.length, density, headingLevelStart, onLinkClick, cursor, citationCtx, contentWidthValue, contentAlign, linkComponent, inlinePlugins, components, preparedPlugins, t, codeLanguages, headingProjection, listDepth + 1))
               });
 
               // A task item beside plain items keeps its own checked state
@@ -1350,6 +1356,7 @@ export function Markdown({
   plugins,
   inlinePlugins,
   autolink,
+  codeLanguages: codeLanguagesProp,
   xstyle,
   className,
   style,
@@ -1358,6 +1365,13 @@ export function Markdown({
   ...props
 }) {
   const t = useTranslator();
+  // Keep one list while it names the same values, so an inline
+  // `codeLanguages={[…]}` does not re-render every block on each parent
+  // render (adjusting state during render, not in an Effect).
+  const [codeLanguages, setCodeLanguages] = useState(codeLanguagesProp);
+  if (!sameCodeLanguageList(codeLanguages, codeLanguagesProp)) {
+    setCodeLanguages(codeLanguagesProp);
+  }
   const LinkComponent = useLinkComponent();
   // Links read the caller's handler when clicked, so a handler recreated on
   // every caller render does not invalidate the memoized document below.
@@ -1514,8 +1528,8 @@ export function Markdown({
       nextNumber: 1,
       style: citationStyle
     } : null;
-    return blocks.map((block, i) => renderBlock(block, i, blocks.length, density, headingLevelStart, stableOnLinkClick, blockCursor, blockCitationCtx, contentWidthValue, contentAlign, LinkComponent, inlinePlugins, components, preparedPlugins, t, headingProjection));
-  }, [display, blocks, boundaries, isStreaming, sources, citationStyle, density, headingLevelStart, stableOnLinkClick, contentWidthValue, contentAlign, LinkComponent, inlinePlugins, components, preparedPlugins, t, headingProjection]);
+    return blocks.map((block, i) => renderBlock(block, i, blocks.length, density, headingLevelStart, stableOnLinkClick, blockCursor, blockCitationCtx, contentWidthValue, contentAlign, LinkComponent, inlinePlugins, components, preparedPlugins, t, codeLanguages, headingProjection));
+  }, [display, blocks, boundaries, isStreaming, sources, citationStyle, density, headingLevelStart, stableOnLinkClick, contentWidthValue, contentAlign, LinkComponent, inlinePlugins, components, preparedPlugins, t, headingProjection, codeLanguages]);
   if (display === 'inline') {
     const cursor = {
       offset: 0,

package/dist/Markdown/MarkdownTable.a11y.chromium.spec.js

@@ -1,4 +1,5 @@
 // Copyright (c) Meta Platforms, Inc. and affiliates.
+// @pr-a11y release-only
 
 /**
  * @file MarkdownTable.a11y.chromium.spec.ts

package/dist/Markdown/headingProjection.d.ts

@@ -1,6 +1,6 @@
-import type { MarkdownAstHeading, MarkdownAstRoot } from './ast';
-import type { MarkdownExtensionNode, PreparedMarkdownPlugins } from './plugins/protocol';
-import type { OutlineItem } from '../Outline/types';
+import type { MarkdownAstHeading, MarkdownAstRoot } from './ast.js';
+import type { MarkdownExtensionNode, PreparedMarkdownPlugins } from './plugins/protocol.js';
+import type { OutlineItem } from '../Outline/types.js';
 type Heading = MarkdownAstHeading<MarkdownExtensionNode>;
 export interface MarkdownHeadingProjection {
     /** Headings with generated ids. */

package/dist/Markdown/index.d.ts

@@ -4,11 +4,11 @@
  *   the character reference decoder, and types
  * @position Component entry point; re-exported by /packages/core/src/index.ts
  */
-export { visitMarkdownNodes } from './ast';
-export type { MarkdownAstPoint, MarkdownAstDataValue, MarkdownAstPosition, MarkdownAstNodeBase, MarkdownAstExtensionNode, MarkdownAstText, MarkdownAstInlineCode, MarkdownAstInlineMath, MarkdownAstLink, MarkdownAstImage, MarkdownAstCitation, MarkdownAstBreak, MarkdownAstPhrasingContent, MarkdownAstHeading, MarkdownAstParagraph, MarkdownAstCode, MarkdownAstMath, MarkdownAstBlockquote, MarkdownAstList, MarkdownAstListItem, MarkdownAstTable, MarkdownAstTableRow, MarkdownAstTableCell, MarkdownAstThematicBreak, MarkdownAstBlockContent, MarkdownAstRoot, MarkdownAstNodeMap, MarkdownAstNode, } from './ast';
-export { Markdown } from './Markdown';
-export type { MarkdownProps, MarkdownSource, MarkdownComponents, MarkdownInlinePlugin, MarkdownSourceLines, } from './Markdown';
-export { parseMarkdown, parseMarkdownAst, parseMarkdownIncremental, createIncrementalState, parseInline, parseInlineAst, } from './parser';
-export { decodeMarkdownCharacterReferences } from './characterReferences';
-export type { BlockNode, BlockNodeWithMath, MathBlockNode, InlineNode, InlineNodeWithMath, MathInlineNode, SourceRange, ListItemNode, TableCellNode, TableAlignment, ParseOptions, MathParseOptions, IncrementalParseOptions, IncrementalMathParseOptions, IncrementalState as IncrementalParseState, } from './parser';
+export { visitMarkdownNodes } from './ast.js';
+export type { MarkdownAstPoint, MarkdownAstDataValue, MarkdownAstPosition, MarkdownAstNodeBase, MarkdownAstExtensionNode, MarkdownAstText, MarkdownAstInlineCode, MarkdownAstInlineMath, MarkdownAstLink, MarkdownAstImage, MarkdownAstCitation, MarkdownAstBreak, MarkdownAstPhrasingContent, MarkdownAstHeading, MarkdownAstParagraph, MarkdownAstCode, MarkdownAstMath, MarkdownAstBlockquote, MarkdownAstList, MarkdownAstListItem, MarkdownAstTable, MarkdownAstTableRow, MarkdownAstTableCell, MarkdownAstThematicBreak, MarkdownAstBlockContent, MarkdownAstRoot, MarkdownAstNodeMap, MarkdownAstNode, } from './ast.js';
+export { Markdown } from './Markdown.js';
+export type { MarkdownProps, MarkdownSource, MarkdownComponents, MarkdownInlinePlugin, MarkdownSourceLines, } from './Markdown.js';
+export { parseMarkdown, parseMarkdownAst, parseMarkdownIncremental, createIncrementalState, parseInline, parseInlineAst, } from './parser.js';
+export { decodeMarkdownCharacterReferences } from './characterReferences.js';
+export type { BlockNode, BlockNodeWithMath, MathBlockNode, InlineNode, InlineNodeWithMath, MathInlineNode, SourceRange, ListItemNode, TableCellNode, TableAlignment, ParseOptions, MathParseOptions, IncrementalParseOptions, IncrementalMathParseOptions, IncrementalState as IncrementalParseState, } from './parser.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Markdown/parser/index.d.ts

@@ -5,7 +5,7 @@
  *   and the character reference decoder Markdown renders with
  * @position Public subpath entry point: `@astryxdesign/core/Markdown/parser`
  */
-export { createIncrementalState, decodeMarkdownCharacterReferences, parseInline, parseInlineAst, parseMarkdown, parseMarkdownAst, parseMarkdownIncremental, } from '../parser';
-export type { BlockNode, BlockNodeWithMath, MathBlockNode, InlineNode, InlineNodeWithMath, MathInlineNode, SourceRange, ListItemNode, TableCellNode, TableAlignment, ParseOptions, MathParseOptions, IncrementalParseOptions, IncrementalMathParseOptions, IncrementalState as IncrementalParseState, } from '../parser';
-export type { MarkdownAstPoint, MarkdownAstDataValue, MarkdownAstPosition, MarkdownAstNodeBase, MarkdownAstExtensionNode, MarkdownAstText, MarkdownAstInlineCode, MarkdownAstInlineMath, MarkdownAstLink, MarkdownAstImage, MarkdownAstCitation, MarkdownAstBreak, MarkdownAstPhrasingContent, MarkdownAstHeading, MarkdownAstParagraph, MarkdownAstCode, MarkdownAstMath, MarkdownAstBlockquote, MarkdownAstList, MarkdownAstListItem, MarkdownAstTable, MarkdownAstTableRow, MarkdownAstTableCell, MarkdownAstThematicBreak, MarkdownAstBlockContent, MarkdownAstRoot, MarkdownAstNodeMap, MarkdownAstNode, } from '../ast';
+export { createIncrementalState, decodeMarkdownCharacterReferences, parseInline, parseInlineAst, parseMarkdown, parseMarkdownAst, parseMarkdownIncremental, } from '../parser.js';
+export type { BlockNode, BlockNodeWithMath, MathBlockNode, InlineNode, InlineNodeWithMath, MathInlineNode, SourceRange, ListItemNode, TableCellNode, TableAlignment, ParseOptions, MathParseOptions, IncrementalParseOptions, IncrementalMathParseOptions, IncrementalState as IncrementalParseState, } from '../parser.js';
+export type { MarkdownAstPoint, MarkdownAstDataValue, MarkdownAstPosition, MarkdownAstNodeBase, MarkdownAstExtensionNode, MarkdownAstText, MarkdownAstInlineCode, MarkdownAstInlineMath, MarkdownAstLink, MarkdownAstImage, MarkdownAstCitation, MarkdownAstBreak, MarkdownAstPhrasingContent, MarkdownAstHeading, MarkdownAstParagraph, MarkdownAstCode, MarkdownAstMath, MarkdownAstBlockquote, MarkdownAstList, MarkdownAstListItem, MarkdownAstTable, MarkdownAstTableRow, MarkdownAstTableCell, MarkdownAstThematicBreak, MarkdownAstBlockContent, MarkdownAstRoot, MarkdownAstNodeMap, MarkdownAstNode, } from '../ast.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Markdown/parser.d.ts

@@ -1,6 +1,6 @@
-import type { MarkdownAstPhrasingContent, MarkdownAstRoot } from './ast';
-import type { MarkdownExtensionNode, MarkdownExtensionsOf, MarkdownPluginData, MarkdownPluginEntry } from './plugins/protocol';
-export { decodeMarkdownCharacterReferences } from './characterReferences';
+import type { MarkdownAstPhrasingContent, MarkdownAstRoot } from './ast.js';
+import type { MarkdownExtensionNode, MarkdownExtensionsOf, MarkdownPluginData, MarkdownPluginEntry } from './plugins/protocol.js';
+export { decodeMarkdownCharacterReferences } from './characterReferences.js';
 /** Nodes returned by default and legacy parser calls. */
 export type InlineNode<Extension extends MarkdownExtensionNode = never> = {
     type: 'text';

package/dist/Markdown/plugin-renderer/MarkdownPluginNodeRenderer.d.ts

@@ -16,7 +16,7 @@
  *   element or theme target of its own (spec:AST-064 FR8, DEC-6).
  */
 import { Component, type JSX, type ReactNode } from 'react';
-import { type MarkdownExtensionNode, type MarkdownPluginEntry, type PreparedMarkdownPlugins } from '../plugins/protocol';
+import { type MarkdownExtensionNode, type MarkdownPluginEntry, type PreparedMarkdownPlugins } from '../plugins/protocol.js';
 interface MarkdownPluginBoundaryProps {
     children: ReactNode;
     fallback: ReactNode;

package/dist/Markdown/plugin-renderer/index.d.ts

@@ -4,6 +4,6 @@
  * @position Client-only subpath entry point:
  *   `@astryxdesign/core/Markdown/plugin-renderer`
  */
-export { MarkdownPluginNodeRenderer } from './MarkdownPluginNodeRenderer';
-export type { MarkdownPluginNodeRendererProps } from './MarkdownPluginNodeRenderer';
+export { MarkdownPluginNodeRenderer } from './MarkdownPluginNodeRenderer.js';
+export type { MarkdownPluginNodeRendererProps } from './MarkdownPluginNodeRenderer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Markdown/plugins/frontmatter.d.ts

@@ -4,8 +4,8 @@
  * @output A Markdown plugin plus a typed metadata reader for later transforms
  * @position Optional first-party document metadata helper
  */
-import type { MarkdownAstRoot } from '../ast';
-import { type MarkdownExtensionNode, type MarkdownPluginData, type MarkdownPluginEntry } from './protocol';
+import type { MarkdownAstRoot } from '../ast.js';
+import { type MarkdownExtensionNode, type MarkdownPluginData, type MarkdownPluginEntry } from './protocol.js';
 type FrontmatterRecord = Readonly<Record<string, string>>;
 export interface MarkdownFrontmatterOptions<Metadata extends MarkdownPluginData> {
     /** Stable plugin and metadata namespace. */

package/dist/Markdown/plugins/headingLinks.d.ts

@@ -1,5 +1,5 @@
-import type { MarkdownAstHeading, MarkdownAstRoot } from '../ast';
-import { type MarkdownExtensionNode, type MarkdownPluginEntry, type PreparedMarkdownPlugins } from './protocol';
+import type { MarkdownAstHeading, MarkdownAstRoot } from '../ast.js';
+import { type MarkdownExtensionNode, type MarkdownPluginEntry, type PreparedMarkdownPlugins } from './protocol.js';
 type Heading = MarkdownAstHeading<MarkdownExtensionNode>;
 export interface MarkdownHeadingLinksOptions {
     /**

package/dist/Markdown/plugins/index.d.ts

@@ -3,18 +3,18 @@
  * @output Public Markdown plugin protocol, factory, and types
  * @position Subpath entry point: `@astryxdesign/core/Markdown/plugins`
  */
-export { createMarkdownPlugin, getMarkdownPluginCapabilities, isMarkdownExtensionNode, } from './protocol';
-export { createMarkdownTextTransform } from './textTransform';
-export type { MarkdownTextTransformContext, MarkdownTextTransformOptions, } from './textTransform';
-export { createMarkdownFenceTransform } from './semanticFence';
-export type { MarkdownFenceContext, MarkdownFenceNode, MarkdownFenceTransformOptions, } from './semanticFence';
-export { createMarkdownSourceDecoration, getMarkdownSourceDecorations, } from './sourceDecoration';
-export type { MarkdownSourceDecoration, MarkdownSourceDecorationOptions, MarkdownSourceDecorationRange, } from './sourceDecoration';
-export { createMarkdownFrontmatter } from './frontmatter';
-export { markdownSoftBreaksPlugin } from './softBreaks';
-export { markdownSourceLinesPlugin } from './sourceLines';
-export { createMarkdownHeadingLinks } from './headingLinks';
-export type { MarkdownHeadingLinksOptions } from './headingLinks';
-export type { MarkdownFrontmatter, MarkdownFrontmatterOptions, MarkdownFrontmatterParseResult, } from './frontmatter';
-export type { MarkdownPluginCapabilities, MarkdownPluginData, MarkdownExtensionNode, MarkdownTokenizerInput, MarkdownTokenizeResult, MarkdownSyntaxContribution, MarkdownSyntaxCapability, MarkdownTransformContext, MarkdownTransform, MarkdownExtensionRenderer, MarkdownExtensionRenderers, MarkdownSyntaxPluginDefinition, MarkdownTransformPluginDefinition, MarkdownPluginDefinition, MarkdownPluginEntry, MarkdownNodeOf, MarkdownExtensionsOf, } from './protocol';
+export { createMarkdownPlugin, getMarkdownPluginCapabilities, isMarkdownExtensionNode, } from './protocol.js';
+export { createMarkdownTextTransform } from './textTransform.js';
+export type { MarkdownTextTransformContext, MarkdownTextTransformOptions, } from './textTransform.js';
+export { createMarkdownFenceTransform } from './semanticFence.js';
+export type { MarkdownFenceContext, MarkdownFenceNode, MarkdownFenceTransformOptions, } from './semanticFence.js';
+export { createMarkdownSourceDecoration, getMarkdownSourceDecorations, } from './sourceDecoration.js';
+export type { MarkdownSourceDecoration, MarkdownSourceDecorationOptions, MarkdownSourceDecorationRange, } from './sourceDecoration.js';
+export { createMarkdownFrontmatter } from './frontmatter.js';
+export { markdownSoftBreaksPlugin } from './softBreaks.js';
+export { markdownSourceLinesPlugin } from './sourceLines.js';
+export { createMarkdownHeadingLinks } from './headingLinks.js';
+export type { MarkdownHeadingLinksOptions } from './headingLinks.js';
+export type { MarkdownFrontmatter, MarkdownFrontmatterOptions, MarkdownFrontmatterParseResult, } from './frontmatter.js';
+export type { MarkdownPluginCapabilities, MarkdownPluginData, MarkdownExtensionNode, MarkdownTokenizerInput, MarkdownTokenizeResult, MarkdownSyntaxContribution, MarkdownSyntaxCapability, MarkdownTransformContext, MarkdownTransform, MarkdownExtensionRenderer, MarkdownExtensionRenderers, MarkdownSyntaxPluginDefinition, MarkdownTransformPluginDefinition, MarkdownPluginDefinition, MarkdownPluginEntry, MarkdownNodeOf, MarkdownExtensionsOf, } from './protocol.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/Markdown/plugins/protocol.d.ts

@@ -5,7 +5,7 @@
  * @position Shared Markdown extension boundary consumed by the parser and renderer
  */
 import type React from 'react';
-import type { MarkdownAstDataValue, MarkdownAstExtensionNode, MarkdownAstNodeBase, MarkdownAstRoot } from '../ast';
+import type { MarkdownAstDataValue, MarkdownAstExtensionNode, MarkdownAstNodeBase, MarkdownAstRoot } from '../ast.js';
 export type MarkdownPluginData = MarkdownAstDataValue;
 export type MarkdownExtensionNode<PluginName extends string = string, NodeName extends string = string, Data extends MarkdownPluginData = MarkdownPluginData, Display extends 'inline' | 'block' = 'inline' | 'block'> = MarkdownAstExtensionNode<PluginName, NodeName, Data, Display>;
 export declare function isMarkdownExtensionNode<Node extends MarkdownExtensionNode>(node: MarkdownAstNodeBase & {

package/dist/Markdown/plugins/semanticFence.d.ts

@@ -4,8 +4,8 @@
  * @output Immutable Markdown transform that annotates eligible canonical code nodes
  * @position Optional helper layer compiled onto the core transform protocol
  */
-import type { MarkdownAstCode } from '../ast';
-import { type MarkdownExtensionNode, type MarkdownPluginData, type MarkdownTransform } from './protocol';
+import type { MarkdownAstCode } from '../ast.js';
+import { type MarkdownExtensionNode, type MarkdownPluginData, type MarkdownTransform } from './protocol.js';
 export interface MarkdownFenceContext<Language extends string> {
     readonly code: string;
     readonly language: Language;

package/dist/Markdown/plugins/softBreaks.d.ts

@@ -1,3 +1,3 @@
 /** Converts soft line endings in Markdown phrasing content to hard breaks. */
-export declare const markdownSoftBreaksPlugin: import("./protocol").MarkdownPluginEntry<never>;
+export declare const markdownSoftBreaksPlugin: import("./protocol.js").MarkdownPluginEntry<never>;
 //# sourceMappingURL=softBreaks.d.ts.map

package/dist/Markdown/plugins/sourceDecoration.d.ts

@@ -4,8 +4,8 @@
  * @output Immutable Markdown transforms that annotate Core-authored source-backed nodes
  * @position Optional helper layer compiled onto the core transform protocol
  */
-import type { MarkdownAstNodeBase } from '../ast';
-import { type MarkdownPluginData, type MarkdownTransform } from './protocol';
+import type { MarkdownAstNodeBase } from '../ast.js';
+import { type MarkdownPluginData, type MarkdownTransform } from './protocol.js';
 /** One decoration recorded on an annotated node. */
 export interface MarkdownSourceDecoration {
     /** Stable decoration name supplied by the helper's caller. */

package/dist/Markdown/plugins/sourceLines.d.ts

@@ -6,5 +6,5 @@
  * The lines come from the parse Markdown already runs; without this plugin
  * no line work happens.
  */
-export declare const markdownSourceLinesPlugin: import("./protocol").MarkdownPluginEntry<never>;
+export declare const markdownSourceLinesPlugin: import("./protocol.js").MarkdownPluginEntry<never>;
 //# sourceMappingURL=sourceLines.d.ts.map

package/dist/Markdown/plugins/textTransform.d.ts

@@ -4,8 +4,8 @@
  * @output Immutable Markdown transforms with protected-context traversal
  * @position Optional helper layer compiled onto the core transform protocol
  */
-import type { MarkdownAstPhrasingContent } from '../ast';
-import { type MarkdownExtensionNode, type MarkdownTransform } from './protocol';
+import type { MarkdownAstPhrasingContent } from '../ast.js';
+import { type MarkdownExtensionNode, type MarkdownTransform } from './protocol.js';
 export interface MarkdownTextTransformContext {
     readonly parentType: 'heading' | 'paragraph' | 'strong' | 'emphasis' | 'delete' | 'tableCell';
 }

package/dist/Markdown/remark.d.ts

@@ -1,4 +1,4 @@
-import { type MarkdownTransform } from './plugins/protocol';
+import { type MarkdownTransform } from './plugins/protocol.js';
 export interface MarkdownRemarkPoint {
     line?: number;
     column?: number;

package/dist/Markdown/utils.d.ts

@@ -3,8 +3,8 @@
  * @output Server-safe exports for Markdown parsing and AST traversal
  * @position Subpath entry point: `@astryxdesign/core/Markdown/utils`
  */
-export { visitMarkdownNodes } from './ast';
-export type { MarkdownAstExtensionNode, MarkdownAstPhrasingContent, MarkdownAstBlockContent, MarkdownAstRoot, MarkdownAstNodeMap, MarkdownAstNode, } from './ast';
-export { parseMarkdown, parseInline, parseMarkdownIncremental, createIncrementalState, trimStreamingArtifacts, } from './parser';
-export type { InlineNode, InlineNodeWithMath, MathInlineNode, BlockNode, BlockNodeWithMath, MathBlockNode, ListItemNode, TableCellNode, TableAlignment, ParseOptions, MathParseOptions, IncrementalParseOptions, IncrementalMathParseOptions, IncrementalState, } from './parser';
+export { visitMarkdownNodes } from './ast.js';
+export type { MarkdownAstExtensionNode, MarkdownAstPhrasingContent, MarkdownAstBlockContent, MarkdownAstRoot, MarkdownAstNodeMap, MarkdownAstNode, } from './ast.js';
+export { parseMarkdown, parseInline, parseMarkdownIncremental, createIncrementalState, trimStreamingArtifacts, } from './parser.js';
+export type { InlineNode, InlineNodeWithMath, MathInlineNode, BlockNode, BlockNodeWithMath, MathBlockNode, ListItemNode, TableCellNode, TableAlignment, ParseOptions, MathParseOptions, IncrementalParseOptions, IncrementalMathParseOptions, IncrementalState, } from './parser.js';
 //# sourceMappingURL=utils.d.ts.map

package/dist/MetadataList/MetadataList.d.ts

@@ -12,8 +12,8 @@
  * - /packages/cli/assets/templates/blocks/components/MetadataList/ (showcase blocks)
  */
 import { type ReactNode } from 'react';
-import { type MetadataListLabelConfig } from './MetadataListContext';
-import type { BaseProps } from '../BaseProps';
+import { type MetadataListLabelConfig } from './MetadataListContext.js';
+import type { BaseProps } from '../BaseProps.js';
 export type MetadataListColumns = 'multi' | 'single' | number;
 export interface MetadataListProps extends Omit<BaseProps<HTMLDivElement>, 'title'> {
     /** Ref forwarded to the root element */

package/dist/MetadataList/MetadataListItem.d.ts

@@ -12,7 +12,7 @@
  * - /packages/cli/assets/templates/blocks/components/MetadataList/ (showcase blocks)
  */
 import { type ReactNode } from 'react';
-import type { BaseProps } from '../BaseProps';
+import type { BaseProps } from '../BaseProps.js';
 export interface MetadataListItemProps extends BaseProps<HTMLDivElement> {
     /** Ref forwarded to the root element */
     ref?: React.Ref<HTMLDivElement>;

package/dist/MetadataList/index.d.ts

@@ -6,9 +6,9 @@
  *
  * SYNC: When modified, update /packages/core/src/MetadataList/MetadataList.doc.mjs
  */
-export { MetadataList } from './MetadataList';
-export type { MetadataListProps, MetadataListColumns, } from './MetadataList';
-export { MetadataListItem } from './MetadataListItem';
-export type { MetadataListItemProps } from './MetadataListItem';
-export type { MetadataListLabelConfig } from './MetadataListContext';
+export { MetadataList } from './MetadataList.js';
+export type { MetadataListProps, MetadataListColumns, } from './MetadataList.js';
+export { MetadataListItem } from './MetadataListItem.js';
+export type { MetadataListItemProps } from './MetadataListItem.js';
+export type { MetadataListLabelConfig } from './MetadataListContext.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/MobileNav/MobileNav.d.ts

@@ -6,7 +6,8 @@
  *
  * Full-height slide-out drawer overlay for mobile navigation.
  * The mobile counterpart to SideNav — accepts the same children
- * (SideNavSection, SideNavItem, or any ReactNode).
+ * (SideNavSection, SideNavItem, or any ReactNode). The drawer is never wider
+ * than 85% of the viewport, so a strip of the page stays beside it to tap.
  *
  * Uses the native `<dialog>` element with `showModal()` for top-layer rendering.
  * This eliminates z-index stacking issues — the drawer renders above everything
@@ -35,7 +36,7 @@
  * - /packages/cli/assets/templates/blocks/components/MobileNav/ (showcase blocks)
  */
 import { type ReactNode } from 'react';
-import type { BaseProps } from '../BaseProps';
+import type { BaseProps } from '../BaseProps.js';
 /**
  * Longest the drawer will wait before closing, however long the hold is.
  *

package/dist/MobileNav/MobileNav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileNav.d.ts","sourceRoot":"","sources":["../../src/MobileNav/MobileNav.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAOL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAwBf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AA4L5C;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAItC;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBpE;AA+DD,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;IAC9D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,gBAAgB,EAC9B,QAAQ,EACR,MAAM,EACN,KAAW,EACX,IAAa,EACb,KAAK,EACL,aAAa,EAAE,MAAM,EACrB,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EAAE,WAAW,EACpB,GAAG,EACH,GAAG,IAAI,EACR,EAAE,cAAc,+BAuQhB;yBAtRe,SAAS"}
+{"version":3,"file":"MobileNav.d.ts","sourceRoot":"","sources":["../../src/MobileNav/MobileNav.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAOL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAyBf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AA+L5C;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAItC;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBpE;AA+DD,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC;IAC9D,wCAAwC;IACxC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnC;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IAEzC;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;OAIG;IACH,MAAM,CAAC,EAAE,SAAS,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CAAC,EACxB,MAAM,EAAE,UAAU,EAClB,YAAY,EAAE,gBAAgB,EAC9B,QAAQ,EACR,MAAM,EACN,KAAW,EACX,IAAa,EACb,KAAK,EACL,aAAa,EAAE,MAAM,EACrB,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EAAE,WAAW,EACpB,GAAG,EACH,GAAG,IAAI,EACR,EAAE,cAAc,+BA+QhB;yBA9Re,SAAS"}

package/dist/MobileNav/MobileNav.js

@@ -10,7 +10,8 @@
  *
  * Full-height slide-out drawer overlay for mobile navigation.
  * The mobile counterpart to SideNav — accepts the same children
- * (SideNavSection, SideNavItem, or any ReactNode).
+ * (SideNavSection, SideNavItem, or any ReactNode). The drawer is never wider
+ * than 85% of the viewport, so a strip of the page stays beside it to tap.
  *
  * Uses the native `<dialog>` element with `showModal()` for top-layer rendering.
  * This eliminates z-index stacking issues — the drawer renders above everything
@@ -53,6 +54,7 @@ import { layerStructureReset } from "../Layer/layerStructureReset.stylex.js";
 import { LayerContentBoundary } from "../Layer/layerScopedContext.js";
 import { overlayPaddingReset } from "../Layout/padding.stylex.js";
 import { LayerDepthProvider } from "../Layer/LayerDepthContext.js";
+import { ModalAnnounceProvider } from "../hooks/ModalAnnounceProvider.js";
 import { useLayerDismissal } from "../Layer/useLayerDismissal.js";
 import { themeProps } from "../utils/themeProps.js";
 import { useTranslator } from "../i18n/index.js";
@@ -148,13 +150,13 @@ const styles = {
   }
 };
 const _temp = {
-  kzqmXN: "xn9wirt",
-  ks0D6T: "xf68679",
+  kzqmXN: "x5lhr3w",
+  ks0D6T: "x1jrhgas",
   "$$css": true
 };
 const dynamicStyles = {
   width: w => [_temp, {
-    "--x-maxWidth": (val => typeof val === "number" ? val + "px" : val != null ? val : undefined)(`${w}px`)
+    "--x-width": (val => typeof val === "number" ? val + "px" : val != null ? val : undefined)(`${w}px`)
   }]
 };
 
@@ -438,7 +440,10 @@ export function MobileNav({
     shouldDismissOnCloseRequest
   } = useLayerDismissal({
     isActive: isOpen,
-    onDismiss: () => onOpenChange(false)
+    onDismiss: () => onOpenChange(false),
+    // The dialog's document is this layer's: rendered into an iframe or a
+    // Picture-in-Picture window, it ranks with the layers opened inside it.
+    getContainer: () => dialogRef.current
   });
 
   // The native `cancel` event is the browser's own close-watcher firing: an
@@ -477,40 +482,44 @@ export function MobileNav({
     "aria-label": label ?? (typeof header === 'string' ? header : t('@astryx.mobileNav.navigation')),
     onClick: composeEventHandlers(onClickProp, handleDialogClick),
     onCancel: handleCancel,
-    children: /*#__PURE__*/_jsx(LayerDepthProvider, {
-      children: /*#__PURE__*/_jsx(LayerContentBoundary, {
-        children: /*#__PURE__*/_jsxs("div", {
-          tabIndex: -1,
-          ...stylex.props(styles.drawer, dynamicStyles.width(width), isStart && styles.drawerStart, isStart && isOpen && styles.drawerStartOpen, !isStart && styles.drawerEnd, !isStart && isOpen && styles.drawerEndOpen),
-          children: [/*#__PURE__*/_jsxs("div", {
-            ...{
-              0: {
-                className: "x78zum5 x6s0dn4 x1qughib x1k15mir xf314gf x2lah0s x92x3c3 x1q0q8m5 xw8gpjh"
+    children: /*#__PURE__*/_jsx(ModalAnnounceProvider, {
+      dialogRef: dialogRef,
+      isOpen: isOpen,
+      children: /*#__PURE__*/_jsx(LayerDepthProvider, {
+        children: /*#__PURE__*/_jsx(LayerContentBoundary, {
+          children: /*#__PURE__*/_jsxs("div", {
+            tabIndex: -1,
+            ...stylex.props(styles.drawer, dynamicStyles.width(width), isStart && styles.drawerStart, isStart && isOpen && styles.drawerStartOpen, !isStart && styles.drawerEnd, !isStart && isOpen && styles.drawerEndOpen),
+            children: [/*#__PURE__*/_jsxs("div", {
+              ...{
+                0: {
+                  className: "x78zum5 x6s0dn4 x1qughib x1k15mir xf314gf x2lah0s x92x3c3 x1q0q8m5 xw8gpjh"
+                },
+                1: {
+                  className: "x78zum5 x6s0dn4 x1k15mir xf314gf x2lah0s x92x3c3 x1q0q8m5 xw8gpjh x13a6bvl"
+                }
+              }[!!!header << 0],
+              children: [typeof header === 'string' ? /*#__PURE__*/_jsx(Heading, {
+                level: 2,
+                xstyle: styles.headerText,
+                children: header
+              }) : header ?? null, /*#__PURE__*/_jsx(Button, {
+                variant: "ghost",
+                label: t('@astryx.mobileNav.closeNavigation'),
+                icon: /*#__PURE__*/_jsx(Icon, {
+                  icon: "close",
+                  color: "inherit"
+                }),
+                onClick: () => onOpenChange(false),
+                isIconOnly: true
+              })]
+            }), /*#__PURE__*/_jsx("div", {
+              ...{
+                className: "x98rzlu x1odjw0f x6ikm8r xish69e xge0x1e xf314gf xce4md1"
               },
-              1: {
-                className: "x78zum5 x6s0dn4 x1k15mir xf314gf x2lah0s x92x3c3 x1q0q8m5 xw8gpjh x13a6bvl"
-              }
-            }[!!!header << 0],
-            children: [typeof header === 'string' ? /*#__PURE__*/_jsx(Heading, {
-              level: 2,
-              xstyle: styles.headerText,
-              children: header
-            }) : header ?? null, /*#__PURE__*/_jsx(Button, {
-              variant: "ghost",
-              label: t('@astryx.mobileNav.closeNavigation'),
-              icon: /*#__PURE__*/_jsx(Icon, {
-                icon: "close",
-                color: "inherit"
-              }),
-              onClick: () => onOpenChange(false),
-              isIconOnly: true
+              children: children
             })]
-          }), /*#__PURE__*/_jsx("div", {
-            ...{
-              className: "x98rzlu x1odjw0f x6ikm8r xish69e xge0x1e xf314gf xce4md1"
-            },
-            children: children
-          })]
+          })
         })
       })
     })

package/dist/MobileNav/MobileNavPinchZoom.a11y.chromium.spec.js

@@ -1,4 +1,5 @@
 // Copyright (c) Meta Platforms, Inc. and affiliates.
+// @pr-a11y release-only
 
 /**
  * @file MobileNavPinchZoom.a11y.chromium.spec.ts

package/dist/MobileNav/MobileNavToggle.d.ts

@@ -9,7 +9,7 @@
  * Can be placed anywhere in the component tree (TopNav, content area, custom toolbar, etc.).
  */
 import React, { type ReactNode } from 'react';
-import type { BaseProps } from '../BaseProps';
+import type { BaseProps } from '../BaseProps.js';
 export interface MobileNavToggleProps extends Pick<BaseProps, 'xstyle' | 'className' | 'style'> {
     ref?: React.Ref<HTMLButtonElement>;
     /**