@astryxdesign/core 0.7.5-canary.fccd771 → 0.7.5

package/dist/Markdown/Markdown.d.ts

@@ -1,5 +1,6 @@
 import type React from 'react';
 import type { TextDisplay } from '../theme/types.js';
+import type { CodeLanguage } from '../CodeBlock/grammar.js';
 import type { BaseProps } from '../BaseProps.js';
 import type { CitationSource } from '../Citation/Citation.js';
 import type { MarkdownPluginEntry } from './plugins/protocol.js';
@@ -177,6 +178,15 @@ export interface MarkdownProps<Plugins extends ReadonlyArray<MarkdownPluginEntry
      * literal text.
      */
     autolink?: 'gfm';
+    /**
+     * CodeBlock language values a fence may name: each one imported on its
+     * own, such as `graphql` from `@astryxdesign/core/CodeBlock/languages/graphql`,
+     * or made with `createCodeLanguage`. A fence whose language word is one of
+     * a listed value's identifiers renders with that value, ahead of a built-in
+     * with the same identifier; a later entry wins. Without it, fences render
+     * as they do today.
+     */
+    codeLanguages?: ReadonlyArray<CodeLanguage>;
 }
 /**
  * Renders a markdown string as Astryx components. Supports streaming with
@@ -189,7 +199,7 @@ export interface MarkdownProps<Plugins extends ReadonlyArray<MarkdownPluginEntry
  * </Markdown>
  * ```
  */
-export declare function Markdown<const Plugins extends ReadonlyArray<MarkdownPluginEntry> = readonly []>({ ref, children, display, density, headingLevelStart, isStreaming, onLinkClick, sources, citationStyle, contentWidth, contentAlign, components, plugins, inlinePlugins, autolink, xstyle, className, style, id: rootId, 'data-testid': testId, ...props }: MarkdownProps<Plugins>): React.ReactElement;
+export declare function Markdown<const Plugins extends ReadonlyArray<MarkdownPluginEntry> = readonly []>({ ref, children, display, density, headingLevelStart, isStreaming, onLinkClick, sources, citationStyle, contentWidth, contentAlign, components, plugins, inlinePlugins, autolink, codeLanguages: codeLanguagesProp, xstyle, className, style, id: rootId, 'data-testid': testId, ...props }: MarkdownProps<Plugins>): React.ReactElement;
 export declare namespace Markdown {
     var displayName: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../src/Markdown/Markdown.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"Markdown.d.ts","sourceRoot":"","sources":["../../src/Markdown/Markdown.tsx"],"names":[],"mappings":"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"}

package/dist/Markdown/Markdown.fr23.bench.js

@@ -16,7 +16,9 @@
  * then nine alternating paired rounds averaging 20 iterations a side,
  * reported as the median of the nine paired ratios — against the omitted
  * baseline, for a stable list and a recreated equivalent one. Each ratio
- * comes from one sample, never a selection by the fastest baseline.
+ * comes from one sample, never a selection by the fastest baseline. Windows
+ * are timed on the main thread's CPU clock, so V8's background threads do not
+ * bill their work to whichever side happens to be running.
  *
  * The harness retries a fresh process only when the A/A control is invalid.
  * A helper-overhead failure is never retried to obtain a passing sample.

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

@@ -4,17 +4,22 @@
 
 /**
  * @file Markdown.tsx
- * @input Markdown string, canonical AST, optional plugins and custom renderers
+ * @input Markdown string, canonical AST, optional plugins and custom renderers;
+ *   static document lists permit outside counter paint through ordered and
+ *   unordered ancestors. Flow-task
+ *   bodies use per-item first-line markers; paragraph-only task lists retain
+ *   their CheckboxList representation.
  * @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";
@@ -392,6 +397,12 @@ const styles = {
   },
   blockIndent: {
     kUOVxO: "x1ho7dyk",
+    kXHlph: "x1plvlek",
+    $$css: true
+  },
+  markerGutter: {
+    keTefX: "x1wgbfqz",
+    kZCmMZ: "x1rey3nv",
     $$css: true
   },
   hr: {
@@ -921,7 +932,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 +1040,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 +1125,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,13 +1137,15 @@ 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':
       {
-        // Detect task lists: all items have a checked state
-        const isTaskList = node.children.length > 0 && node.children.every(item => item.checked != null);
+        // Preserve the released CheckboxList representation for paragraph-only
+        // pure task lists. Flow/nested task bodies use the shared per-item marker
+        // path below, which owns first-line placement and static outside paint.
+        const isTaskList = node.children.length > 0 && node.children.every(item => item.checked != null && item.children.every(block => block.type === 'paragraph'));
         if (isTaskList) {
           // Extract labels from task items — render as rich inline content
           const checkedValues = node.children.map((item, i) => ({
@@ -1155,7 +1173,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
@@ -1176,7 +1194,7 @@ listDepth = 0) {
             listStyle: node.ordered ? 'decimal' : 'disc',
             density: "compact",
             start: node.ordered ? node.start : undefined,
-            xstyle: styles.blockIndent,
+            xstyle: [styles.blockIndent, node.ordered && styles.markerGutter],
             children: node.children.map((item, i) => {
               const firstChild = item.children[0];
               const isInline = item.children.length === 1 && firstChild?.type === 'paragraph';
@@ -1187,10 +1205,10 @@ 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
+              // Each task item on this shared list path keeps its checked state
               // (FR23): it shows a read-only checkbox where its marker
               // would be, named by its text.
               const firstParagraph = item.children.find(block => block.type === 'paragraph');
@@ -1203,6 +1221,7 @@ listDepth = 0) {
               , {
                 marker: (node.ordered ? NUMBER_MARKERS : BULLET_MARKERS)[listDepth % 3],
                 task: task,
+                hasMarkerGutter: node.ordered,
                 children: /*#__PURE__*/_jsx(ListItem, {
                   label: label,
                   ...(recordsSourceLines ? sourceLineAttributes(blockSourceLines(item)) : undefined)
@@ -1350,6 +1369,7 @@ export function Markdown({
   plugins,
   inlinePlugins,
   autolink,
+  codeLanguages: codeLanguagesProp,
   xstyle,
   className,
   style,
@@ -1358,6 +1378,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 +1541,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/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

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

@@ -1,16 +1,20 @@
 /**
  * @file MobileNavToggle.tsx
- * @input Uses React, Button, Icon, AppShell mobile context
+ * @input Uses React, Button, Icon, AppShell mobile context; forwards host props
+ *   to the Button
  * @output Exports MobileNavToggle component
  * @position Standalone toggle button; can be placed anywhere in the AppShell tree.
  *
  * Hamburger button that opens/closes the mobile nav drawer.
  * Reads from AppShell mobile context — renders nothing above the mobile breakpoint.
  * Can be placed anywhere in the component tree (TopNav, content area, custom toolbar, etc.).
+ * Host attributes and DOM handlers reach the button; its `aria-expanded` and
+ * `aria-controls` stay component-owned, and a caller `onClick` runs after the
+ * toggle.
  */
 import React, { type ReactNode } from 'react';
 import type { BaseProps } from '../BaseProps.js';
-export interface MobileNavToggleProps extends Pick<BaseProps, 'xstyle' | 'className' | 'style'> {
+export interface MobileNavToggleProps extends Omit<BaseProps<HTMLButtonElement>, 'aria-expanded' | 'aria-controls'> {
     ref?: React.Ref<HTMLButtonElement>;
     /**
      * Custom content to render instead of the default hamburger icon.
@@ -44,7 +48,7 @@ export interface MobileNavToggleProps extends Pick<BaseProps, 'xstyle' | 'classN
  * </MobileNavToggle>
  * ```
  */
-export declare function MobileNavToggle({ ref, children, label: labelFromProps, 'data-testid': testId, xstyle, className, style, }: MobileNavToggleProps): React.JSX.Element | null;
+export declare function MobileNavToggle({ ref, children, label: labelFromProps, 'data-testid': testId, xstyle, className, style, onClick, ...rest }: MobileNavToggleProps): React.JSX.Element | null;
 export declare namespace MobileNavToggle {
     var displayName: string;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"MobileNavToggle.d.ts","sourceRoot":"","sources":["../../src/MobileNav/MobileNavToggle.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,EAAC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAI5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAG5C,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,SAAS,EACT,QAAQ,GAAG,WAAW,GAAG,OAAO,CACjC;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,QAAQ,EACR,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EACN,SAAS,EACT,KAAK,GACN,EAAE,oBAAoB,4BAgCtB;yBAxCe,eAAe"}
+{"version":3,"file":"MobileNavToggle.d.ts","sourceRoot":"","sources":["../../src/MobileNav/MobileNavToggle.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,EAAC,KAAK,SAAS,EAAC,MAAM,OAAO,CAAC;AAI5C,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAI5C,MAAM,WAAW,oBAAqB,SAAQ,IAAI,CAChD,SAAS,CAAC,iBAAiB,CAAC,EAC5B,eAAe,GAAG,eAAe,CAClC;IACC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,GAAG,EACH,QAAQ,EACR,KAAK,EAAE,cAAc,EACrB,aAAa,EAAE,MAAM,EACrB,MAAM,EACN,SAAS,EACT,KAAK,EACL,OAAO,EACP,GAAG,IAAI,EACR,EAAE,oBAAoB,4BAiCtB;yBA3Ce,eAAe"}

package/dist/MobileNav/MobileNavToggle.js

@@ -4,19 +4,24 @@
 
 /**
  * @file MobileNavToggle.tsx
- * @input Uses React, Button, Icon, AppShell mobile context
+ * @input Uses React, Button, Icon, AppShell mobile context; forwards host props
+ *   to the Button
  * @output Exports MobileNavToggle component
  * @position Standalone toggle button; can be placed anywhere in the AppShell tree.
  *
  * Hamburger button that opens/closes the mobile nav drawer.
  * Reads from AppShell mobile context — renders nothing above the mobile breakpoint.
  * Can be placed anywhere in the component tree (TopNav, content area, custom toolbar, etc.).
+ * Host attributes and DOM handlers reach the button; its `aria-expanded` and
+ * `aria-controls` stay component-owned, and a caller `onClick` runs after the
+ * toggle.
  */
 import React from 'react';
 import { Button } from "../Button/index.js";
 import { Icon } from "../Icon/index.js";
 import { useAppShellMobile } from "../AppShell/AppShellMobileContext.js";
 import { useTranslator } from "../i18n/index.js";
+import { composeEventHandlers } from "../utils/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Mobile nav toggle button. Reads from AppShell context to open/close
@@ -43,7 +48,9 @@ export function MobileNavToggle({
   'data-testid': testId,
   xstyle,
   className,
-  style
+  style,
+  onClick,
+  ...rest
 }) {
   const t = useTranslator();
   const label = labelFromProps ?? t('@astryx.mobileNav.toggle.open');
@@ -60,6 +67,7 @@ export function MobileNavToggle({
     return null;
   }
   return /*#__PURE__*/_jsx(Button, {
+    ...rest,
     ref: ref,
     variant: "ghost",
     label: label,
@@ -67,7 +75,7 @@ export function MobileNavToggle({
       icon: "menu",
       color: "inherit"
     }),
-    onClick: toggleMobileNav,
+    onClick: composeEventHandlers(toggleMobileNav, onClick),
     "aria-expanded": isMobileNavOpen,
     "aria-controls": mobileNavId || undefined,
     "data-testid": testId ?? 'mobile-nav-toggle',

package/dist/MultiSelector/CreateRow.a11y.chromium.spec.js

@@ -1,11 +1,14 @@
 // Copyright (c) Meta Platforms, Inc. and affiliates.
+// @pr-a11y release-only
 
 /**
  * @file CreateRow.a11y.chromium.spec.ts
  * @input The `Core/MultiSelector` CreateFromQuery story in a built Storybook.
  * @output Real-engine proof of the create row's appear/disappear cycle: what
  *   the live region says as the row comes and goes, and where the highlight
- *   lands when the row vanishes mid-type.
+ *   lands when the row vanishes mid-type. The region clears itself after each
+ *   announcement, so the spec reads a record of what it exposed rather than
+ *   its live text.
  * @position Run with `pnpm test:a11y-contract`; a DOM emulator cannot show
  *   the live region and the active descendant as a screen reader sees them
  *   across a sequence of keystrokes.
@@ -20,8 +23,49 @@ test.beforeAll(async () => {
 test.afterAll(async () => {
   await storybook?.close();
 });
-async function polite(page) {
-  return page.evaluate(() => document.querySelector('[data-astryx-live-region="polite"]')?.textContent?.trim() ?? '');
+
+/**
+ * Records every message the polite region exposes, in order. The region
+ * clears itself 2 s after its last announcement, so a read of its live text
+ * that a slow runner makes late finds it empty; the record keeps what was
+ * said.
+ */
+async function recordPolite(page) {
+  await page.evaluate(() => {
+    const exposed = [];
+    window.__polite = exposed;
+    new MutationObserver(() => {
+      const text = document.querySelector('[data-astryx-live-region="polite"]')?.textContent?.trim() ?? '';
+      if (text !== '' && text !== exposed.at(-1)) {
+        exposed.push(text);
+      }
+    }).observe(document.body, {
+      subtree: true,
+      childList: true,
+      characterData: true
+    });
+  });
+}
+
+/** How many messages the polite region has exposed so far. */
+async function politeCount(page) {
+  return page.evaluate(() => window.__polite.length);
+}
+
+/** The latest message the polite region exposed after the first `since`. */
+async function politeSince(page, since) {
+  return page.evaluate(start => window.__polite.slice(start).at(-1) ?? '', since);
+}
+
+/**
+ * Matches a polite region whose newest message is `message`. Messages written
+ * before the region exposes the previous one are joined in order
+ * (spec:AST-086 FR9), so typing faster than a frame can leave the previous
+ * keystroke's message ahead of the one under test.
+ */
+function newestMessage(message) {
+  const escaped = message.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  return new RegExp(`(^|\\s)${escaped}$`);
 }
 async function activeDescendantText(page) {
   return page.evaluate(() => {
@@ -35,11 +79,12 @@ test('the create row is announced as it appears and the highlight survives it va
   await page.goto(`${storybook.origin}/iframe.html?id=core-multiselector--create-from-query&viewMode=story`);
   const search = page.getByRole('combobox');
   await expect(search).toBeFocused();
+  await recordPolite(page);
 
   // "Bu": a partial match plus the create row above it.
   await search.pressSequentially('Bu');
   await expect(page.getByRole('option')).toHaveText(['Create "Bu"', 'Bug']);
-  await expect.poll(async () => polite(page)).toBe('1 result');
+  await expect.poll(async () => politeSince(page, 0)).toMatch(newestMessage('1 result'));
 
   // Highlight the create row, then type the letter that makes it vanish: the
   // highlight must not be left pointing at a row that no longer exists.
@@ -53,15 +98,17 @@ test('the create row is announced as it appears and the highlight survives it va
 
   // A query that matches nothing: the row is the whole result and the region
   // says so rather than "No results found".
+  const beforeUrgent = await politeCount(page);
   await search.fill('');
   await search.pressSequentially('Urgent');
   await expect(page.getByRole('option')).toHaveText(['Create "Urgent"']);
-  await expect.poll(async () => polite(page)).toBe('Create "Urgent"');
+  await expect.poll(async () => politeSince(page, beforeUrgent)).toMatch(newestMessage('Create "Urgent"'));
 
   // Enter commits: the caller adds the option, the search clears, and the new
   // label is a real row.
+  const beforeEnter = await politeCount(page);
   await search.press('Enter');
-  await expect.poll(async () => polite(page)).toBe('Urgent created');
+  await expect.poll(async () => politeSince(page, beforeEnter)).toMatch(newestMessage('Urgent created'));
   await expect(search).toHaveValue('');
   await expect(page.getByRole('option', {
     name: 'Urgent'