@astryxdesign/core 0.7.6-canary.fdabeba → 0.7.6

package/dist/utils/standaloneMonthCapitals.generated.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @generated by scripts/generate-cldr-month-capitals.mjs from Unicode CLDR 48.2.0.
+ * Do not edit by hand. Run `pnpm generate:cldr-month-capitals` instead.
+ */
+/** Shipped languages whose stand-alone month names start with a capital. */
+export declare const standaloneMonthCapitalLanguages: ReadonlySet<string>;
+//# sourceMappingURL=standaloneMonthCapitals.generated.d.ts.map

package/dist/utils/standaloneMonthCapitals.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standaloneMonthCapitals.generated.d.ts","sourceRoot":"","sources":["../../src/utils/standaloneMonthCapitals.generated.ts"],"names":[],"mappings":"AAEA;;;GAGG;AAEH,4EAA4E;AAC5E,eAAO,MAAM,+BAA+B,EAAE,WAAW,CAAC,MAAM,CAQ9D,CAAC"}

package/dist/utils/standaloneMonthCapitals.generated.js

@@ -0,0 +1,9 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @generated by scripts/generate-cldr-month-capitals.mjs from Unicode CLDR 48.2.0.
+ * Do not edit by hand. Run `pnpm generate:cldr-month-capitals` instead.
+ */
+
+/** Shipped languages whose stand-alone month names start with a capital. */
+export const standaloneMonthCapitalLanguages = new Set(['es', 'fr', 'it', 'nl', 'pl', 'ru', 'uk']);

package/dist/utils/timeFormat.d.ts

@@ -5,19 +5,11 @@
  * @position Internal shared helper for TimeInput and DateTimeInput; not part
  *   of the public surface
  *
- * Time of day as the locale writes it. The hour cycle, digits, separator, and
- * day-period words all come from Intl rather than a table, so a field reads
- * the same way `Timestamp` does beside it.
- *
- * The hour cycle is the locale's own: `en-US` and `ko-KR` read twelve-hour,
- * `en-GB`, `de-DE`, and `vi-VN` read twenty-four-hour. A `-u-hc-` extension
- * on the provider locale (`en-US-u-hc-h23`) carries an app's per-user
- * preference through the same path, so every Astryx time honors it.
- *
- * The parser reads back what the formatter writes: the locale's digits, its
- * hour-minute separator, and its day-period words, on either side of the time.
- * Whatever is left goes through the shared English-tolerant parser, so "2:30
- * PM" and "14:30" keep working in every locale.
+ * The hour cycle, digits, separator and day-period words come from Intl, so a
+ * field reads like `Timestamp`. A `-u-hc-` extension on the provider locale
+ * carries an app's per-user hour cycle. The parser reads back what the
+ * formatter writes, and the rest goes through the English-tolerant parser,
+ * so "2:30 PM" and "14:30" work in every locale.
  *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/utils/timeFormat.test.ts

package/dist/utils/timeFormat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeFormat.d.ts","sourceRoot":"","sources":["../../src/utils/timeFormat.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAA+B,KAAK,aAAa,EAAC,MAAM,cAAc,CAAC;AAG9E,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;AAsLvC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,UAAU,GACtB,UAAU,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,cAAc,GAAE,OAAe,GAC9B,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,OAAe,GAC9B,aAAa,GAAG,IAAI,CAmDtB"}
+{"version":3,"file":"timeFormat.d.ts","sourceRoot":"","sources":["../../src/utils/timeFormat.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAC,MAAM,EAAC,MAAM,eAAe,CAAC;AAC1C,OAAO,EAA+B,KAAK,aAAa,EAAC,MAAM,cAAc,CAAC;AAG9E,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,KAAK,CAAC;AAsLvC;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,UAAU,GACtB,UAAU,CAEZ;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,aAAa,GAAG,SAAS,EAC/B,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACtB,cAAc,GAAE,OAAe,GAC9B,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,cAAc,GAAE,OAAe,GAC9B,aAAa,GAAG,IAAI,CAmDtB"}

package/dist/utils/timeFormat.js

@@ -7,19 +7,11 @@
  * @position Internal shared helper for TimeInput and DateTimeInput; not part
  *   of the public surface
  *
- * Time of day as the locale writes it. The hour cycle, digits, separator, and
- * day-period words all come from Intl rather than a table, so a field reads
- * the same way `Timestamp` does beside it.
- *
- * The hour cycle is the locale's own: `en-US` and `ko-KR` read twelve-hour,
- * `en-GB`, `de-DE`, and `vi-VN` read twenty-four-hour. A `-u-hc-` extension
- * on the provider locale (`en-US-u-hc-h23`) carries an app's per-user
- * preference through the same path, so every Astryx time honors it.
- *
- * The parser reads back what the formatter writes: the locale's digits, its
- * hour-minute separator, and its day-period words, on either side of the time.
- * Whatever is left goes through the shared English-tolerant parser, so "2:30
- * PM" and "14:30" keep working in every locale.
+ * The hour cycle, digits, separator and day-period words come from Intl, so a
+ * field reads like `Timestamp`. A `-u-hc-` extension on the provider locale
+ * carries an app's per-user hour cycle. The parser reads back what the
+ * formatter writes, and the rest goes through the English-tolerant parser,
+ * so "2:30 PM" and "14:30" work in every locale.
  *
  * SYNC: When modified, update these files to stay in sync:
  * - /packages/core/src/utils/timeFormat.test.ts

package/dist/utils/touchPresentation.d.ts

@@ -1,21 +1,16 @@
 import { type CompactDefinition } from '../theme/themeAdaptations.js';
-import { TOUCH_QUERY } from './touchQueries.js';
+import { IOS_SUPPORTS_QUERY, TOUCH_QUERY } from './touchQueries.js';
 export { TOUCH_QUERY };
 /**
- * The viewport is compact at the default width points: layout behaviours
- * (`spec:AST-012` FR9). A StyleX media key, which cannot read the theme,
+ * The viewport is compact at the default width points: layout behaviours.
+ * A StyleX media key, which cannot read the theme,
  * spells this; behaviour reads the active theme's definition
  * (useCompactDefinition), so a theme that moves `md` moves compact with it.
  */
 export declare const COMPACT_QUERY: string;
 /** Both, at the default width points: a sheet in place of a popover. */
 export declare const COMPACT_TOUCH_QUERY: string;
-/**
- * The engine is WebKit on iOS or iPadOS: the only one that implements
- * `-webkit-touch-callout`. For a style iOS WebKit requires, never a
- * behaviour.
- */
-export declare const IOS_SUPPORTS_QUERY = "(-webkit-touch-callout: none)";
+export { IOS_SUPPORTS_QUERY };
 /**
  * The iOS gate as StyleX keys, nested in this order: the media query
  * outside, the supports query inside.
@@ -28,7 +23,7 @@ export interface TouchPresentation {
     readonly isCompact: boolean;
 }
 /**
- * The active theme's compact definition (`spec:AST-012` FR9): width below the
+ * The active theme's compact definition: width below the
  * theme's effective `md` point, or height below 500.
  */
 export declare function useCompactDefinition(): CompactDefinition;
@@ -41,7 +36,7 @@ export declare function useTouchPresentation(serverDefault?: Partial<TouchPresen
  * The touch presentation at this moment, for a decision taken once (a menu
  * deciding how it presents as it opens). `compact` is the active theme's
  * definition (`useCompactDefinition()`, read while rendering), required so a
- * theme that moves `md` is never ignored (spec:AST-012 FR9). Not touch and
+ * theme that moves `md` is never ignored. Not touch and
  * not compact where there is no window.
  */
 export declare function readTouchPresentation(view: Window | null, compact: CompactDefinition): TouchPresentation;

package/dist/utils/touchPresentation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"touchPresentation.d.ts","sourceRoot":"","sources":["../../src/utils/touchPresentation.ts"],"names":[],"mappings":"AAgEA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAC,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAI3C,OAAO,EAAC,WAAW,EAAC,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAmC,CAAC;AAE9D,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,QACe,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,kCAAkC,CAAC;AAElE;;;GAGG;AACH,eAAO,MAAM,oBAAoB,kFAGvB,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAOxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAC7C,iBAAiB,CAQnB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,EAAE,iBAAiB,GACzB,iBAAiB,CAOnB"}
+{"version":3,"file":"touchPresentation.d.ts","sourceRoot":"","sources":["../../src/utils/touchPresentation.ts"],"names":[],"mappings":"AA0CA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAC,kBAAkB,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC;AAI/D,OAAO,EAAC,WAAW,EAAC,CAAC;AAErB;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAAmC,CAAC;AAE9D,wEAAwE;AACxE,eAAO,MAAM,mBAAmB,QACe,CAAC;AAIhD,OAAO,EAAC,kBAAkB,EAAC,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,oBAAoB,kFAGvB,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,iBAAiB,CAOxD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,GAAE,OAAO,CAAC,iBAAiB,CAAM,GAC7C,iBAAiB,CAQnB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,IAAI,EACnB,OAAO,EAAE,iBAAiB,GACzB,iBAAiB,CAOnB"}

package/dist/utils/touchPresentation.js

@@ -4,74 +4,52 @@
 
 /**
  * @file touchPresentation.ts
- * @input Uses the SSR-safe useMediaQuery hook, window.matchMedia, and
- *   TOUCH_QUERY from touchQueries.ts (which loads without React or the theme)
- * @output The one definition of when a component presents itself the touch
- *   way: TOUCH_QUERY, COMPACT_QUERY, COMPACT_TOUCH_QUERY, the iOS style gate
- *   (IOS_SUPPORTS_QUERY and its StyleX keys); the hook useTouchPresentation;
- *   readTouchPresentation for a decision taken at one moment
- * @position Internal shared resolver beside interactionModality.ts
- *
- * Two questions, answered once:
- *
- * - TOUCH behaviours (the press model, gesture recognizers, UIKit springs and
- *   timings) key on the PRIMARY pointer being coarse: a finger. A touchscreen
- *   laptop reports its trackpad (fine) and keeps pointer behaviours; a tablet
- *   reports coarse and gets touch ones at any width. Not `hover: none` (some
- *   touch browsers report hover) and not `any-pointer` (a laptop's touch
- *   screen is not how it is driven).
- * - LAYOUT behaviours key on the available size, whatever the pointer:
- *   the theme's one compact definition (`spec:AST-012` FR9), width below the
- *   `md` point or height below 500, the same numbers on every platform. A
- *   phone in landscape is compact by its height; no platform size class is
- *   consulted.
- * - A presentation that needs both (a bottom sheet in place of a popover, a
- *   drilled-in sub-menu in place of a flyout) asks for both.
- *
- * Touch behaviour is one model on every touch device, iOS and Android alike;
- * nothing here chooses a platform. Touch motion plays the measured table,
- * through the internal motion roles where a value is one.
- *
- * CSS first: a style that changes with these conditions writes the same
- * query as a StyleX media key, spelled exactly as here (`@media` followed by
- * the constant's text), so the right rule paints before hydration. The iOS
- * gate is two nested keys, the media query outside and the supports query
- * inside (IOS_TOUCH_STYLE_KEYS):
- *
- *   '@media (pointer: coarse)': {
- *     '@supports (-webkit-touch-callout: none)': value,
- *   },
- *
- * One `@supports (-webkit-touch-callout: none) and (pointer: coarse)` never
- * matches anywhere (`pointer` is not a property), so it is not written. A
- * test keeps core's compact-touch keys identical to COMPACT_TOUCH_QUERY and
- * every touch-callout key spelled and nested as above. The iOS style gate
- * is only for a style iOS WebKit itself requires (core's 16px input floor);
- * it never selects a behaviour. Core spells the keys literally: an imported
- * `defineConsts` key compiles to a different StyleX priority than the same
- * literal, which would reorder the cascade. `touchKeys`
- * (touchPresentation.stylex.ts, internal to core) holds the same keys, and a
- * test keeps every literal equal to them. The hook is for behaviour. It answers the server default
- * (not touch, not compact) until hydrated unless the caller passes a server
- * hint, and follows the pointer and size when they change (a tablet docking
- * a mouse).
+ * @input useMediaQuery, window.matchMedia, and TOUCH_QUERY from touchQueries.ts
+ * @output TOUCH_QUERY, COMPACT_QUERY, COMPACT_TOUCH_QUERY, the iOS style gate
+ *   (IOS_SUPPORTS_QUERY and its StyleX keys), useTouchPresentation, and
+ *   readTouchPresentation
+ * @position Internal shared resolver beside interactionModality.ts; the one
+ *   definition of when a component presents itself the touch way
  *
  * SYNC: When modified, update touchPresentation.test.ts and every StyleX
  * media key that spells these queries.
  */
+
+// - Touch behaviors key on a coarse primary pointer: a finger. A touchscreen
+//   laptop reports its trackpad and keeps pointer behaviors. Not
+//   `hover: none` (some touch browsers report hover), and not `any-pointer`.
+// - Layout behaviors key on the available size: the theme's compact
+//   definition (AST-012, and its AST-012 FR9). A phone in landscape is
+//   compact by its height.
+// - A presentation that needs both asks for both. No platform is chosen.
+//
+// A style that changes with these conditions uses the same query as a StyleX
+// media key, so the right rule paints before hydration. The iOS gate is two
+// nested keys, the media query outside and the supports query inside:
+//
+//   '@media (pointer: coarse)': {
+//     '@supports (-webkit-touch-callout: none)': value,
+//   },
+//
+// One combined `@supports` never matches, because `pointer` is not a
+// property. The iOS gate is only for a style that iOS WebKit requires (the
+// 16px input floor). Core spells the keys literally, because an imported
+// `defineConsts` key gets a different StyleX priority. Tests keep the
+// literals equal to these queries and to `touchKeys`. The hook answers the
+// server default until hydrated, unless the caller passes a hint.
 import { useMemo } from 'react';
 import { useMediaQuery } from "../hooks/useMediaQuery.js";
 import { DEFAULT_COMPACT_DEFINITION, compactDefinition } from "../theme/themeAdaptations.js";
 import { useThemeDefinition } from "../theme/useTheme.js";
-import { TOUCH_QUERY } from "./touchQueries.js";
+import { IOS_SUPPORTS_QUERY, TOUCH_QUERY } from "./touchQueries.js";
 
 // The primary pointer is coarse: touch behaviours. Defined in touchQueries.ts,
 // which loads without React or the theme.
 export { TOUCH_QUERY };
 
 /**
- * The viewport is compact at the default width points: layout behaviours
- * (`spec:AST-012` FR9). A StyleX media key, which cannot read the theme,
+ * The viewport is compact at the default width points: layout behaviours.
+ * A StyleX media key, which cannot read the theme,
  * spells this; behaviour reads the active theme's definition
  * (useCompactDefinition), so a theme that moves `md` moves compact with it.
  */
@@ -80,12 +58,9 @@ export const COMPACT_QUERY = DEFAULT_COMPACT_DEFINITION.query;
 /** Both, at the default width points: a sheet in place of a popover. */
 export const COMPACT_TOUCH_QUERY = DEFAULT_COMPACT_DEFINITION.coarsePointerQuery;
 
-/**
- * The engine is WebKit on iOS or iPadOS: the only one that implements
- * `-webkit-touch-callout`. For a style iOS WebKit requires, never a
- * behaviour.
- */
-export const IOS_SUPPORTS_QUERY = '(-webkit-touch-callout: none)';
+// The engine is WebKit on iOS or iPadOS, for a style iOS WebKit requires.
+// Defined in touchQueries.ts, which loads without React or the theme.
+export { IOS_SUPPORTS_QUERY };
 
 /**
  * The iOS gate as StyleX keys, nested in this order: the media query
@@ -93,7 +68,7 @@ export const IOS_SUPPORTS_QUERY = '(-webkit-touch-callout: none)';
  */
 export const IOS_TOUCH_STYLE_KEYS = [`@media ${TOUCH_QUERY}`, `@supports ${IOS_SUPPORTS_QUERY}`];
 /**
- * The active theme's compact definition (`spec:AST-012` FR9): width below the
+ * The active theme's compact definition: width below the
  * theme's effective `md` point, or height below 500.
  */
 export function useCompactDefinition() {
@@ -119,7 +94,7 @@ export function useTouchPresentation(serverDefault = {}) {
  * The touch presentation at this moment, for a decision taken once (a menu
  * deciding how it presents as it opens). `compact` is the active theme's
  * definition (`useCompactDefinition()`, read while rendering), required so a
- * theme that moves `md` is never ignored (spec:AST-012 FR9). Not touch and
+ * theme that moves `md` is never ignored. Not touch and
  * not compact where there is no window.
  */
 export function readTouchPresentation(view, compact) {

package/dist/utils/touchPresentation.stylex.d.ts

@@ -1,7 +1,7 @@
 export declare const touchKeys: {
     /** The primary pointer is coarse (TOUCH_QUERY). */
     touch: string;
-    /** The viewport is compact (COMPACT_QUERY, `spec:AST-012` FR9). */
+    /** The viewport is compact (COMPACT_QUERY). */
     compact: string;
     /** Both: a presentation such as a sheet in place of a popover. */
     compactTouch: string;

package/dist/utils/touchPresentation.stylex.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"touchPresentation.stylex.d.ts","sourceRoot":"","sources":["../../src/utils/touchPresentation.stylex.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,SAAS;IACpB,mDAAmD;;IAEnD,mEAAmE;;IAEnE,kEAAkE;;IAGlE;;;;OAIG;;CAEH,CAAC"}
+{"version":3,"file":"touchPresentation.stylex.d.ts","sourceRoot":"","sources":["../../src/utils/touchPresentation.stylex.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,SAAS;IACpB,mDAAmD;;IAEnD,+CAA+C;;IAE/C,kEAAkE;;IAGlE;;;;OAIG;;CAEH,CAAC"}

package/dist/utils/touchPresentation.stylex.js

@@ -6,24 +6,18 @@
  * @output Exports touchKeys: the touch presentation resolver's queries as
  *   StyleX at-rule keys
  * @position The reference spellings of the touch, compact and iOS-gate
- *   conditions. Core styles write these as literal keys wherever they need
- *   them (`spec:AST-094` FR13, `spec:AST-012` FR9), and a test pins each
- *   literal to these values; utils/touchPresentation.ts holds the same
- *   queries for script (matchMedia)
- *
- * These are the spellings to match. A style that changes with these
- * conditions writes the same literal key (`'@media (pointer: coarse)'`, the
- * iOS gate as that media key outside `'@supports (-webkit-touch-callout:
- * none)'`), and a test pins every literal in core to these values. Do not use
- * an imported key as a computed StyleX key: it compiles to a different
- * priority than the literal (6000 against 3200) and reorders the cascade.
- * The iOS supports gate is only for a style iOS WebKit itself requires (the
- * 16px input floor), never a behaviour.
+ *   conditions. utils/touchPresentation.ts holds the same queries for script.
  *
  * SYNC: When modified, update touchPresentation.ts and
  * touchPresentation.test.ts.
  */
 
+// Core styles write these as literal keys (AST-012), and a test pins each
+// literal to these values. Do not use an imported key as a computed StyleX key:
+// it gets a different priority than the literal (6000 against 3200) and
+// reorders the cascade. The iOS supports gate is only for a style that iOS
+// WebKit requires (the 16px input floor), never for a behavior (AST-094).
+
 import * as stylex from '@stylexjs/stylex';
 export const touchKeys = {
   touch: "@media (pointer: coarse)",

package/dist/utils/touchQueries.d.ts

@@ -1,7 +1,8 @@
 /**
  * @file touchQueries.ts
  * @input Nothing: plain strings
- * @output TOUCH_QUERY, the media query for a coarse primary pointer
+ * @output TOUCH_QUERY, the media query for a coarse primary pointer; and
+ *   IOS_SUPPORTS_QUERY with isIosWebKit, the iOS WebKit engine check
  * @position The dependency-free half of touchPresentation.ts, for code that
  *   must load without React or the theme: the motion foundation, which
  *   Node-side specs and browser proofs load without a StyleX compile.
@@ -10,4 +11,19 @@
  */
 /** The primary pointer is coarse: touch behaviours. */
 export declare const TOUCH_QUERY = "(pointer: coarse)";
+/**
+ * The engine is WebKit on iOS or iPadOS: the only one that implements
+ * `-webkit-touch-callout`. For a style iOS WebKit requires, never a
+ * behaviour; isIosWebKit reads it for an engine workaround a record names.
+ */
+export declare const IOS_SUPPORTS_QUERY = "(-webkit-touch-callout: none)";
+/**
+ * Whether `view`'s engine is iOS WebKit, by IOS_SUPPORTS_QUERY. Only for an
+ * engine workaround a record names (`spec:AST-013` FR6): the selection
+ * lock's inline style, and the gesture host's presented hit testing. False
+ * where `CSS.supports` is missing (jsdom has `CSS.escape` only).
+ */
+export declare function isIosWebKit(view?: {
+    CSS?: Partial<Pick<typeof CSS, 'supports'>>;
+} | null | undefined): boolean;
 //# sourceMappingURL=touchQueries.d.ts.map

package/dist/utils/touchQueries.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"touchQueries.d.ts","sourceRoot":"","sources":["../../src/utils/touchQueries.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,uDAAuD;AACvD,eAAO,MAAM,WAAW,sBAAsB,CAAC"}
+{"version":3,"file":"touchQueries.d.ts","sourceRoot":"","sources":["../../src/utils/touchQueries.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,uDAAuD;AACvD,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,kCAAkC,CAAC;AAElE;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,IAAI,GACA;IAAC,GAAG,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,UAAU,CAAC,CAAC,CAAA;CAAC,GAC7C,IAAI,GACJ,SAAsB,GACzB,OAAO,CAET"}

package/dist/utils/touchQueries.js

@@ -3,7 +3,8 @@
 /**
  * @file touchQueries.ts
  * @input Nothing: plain strings
- * @output TOUCH_QUERY, the media query for a coarse primary pointer
+ * @output TOUCH_QUERY, the media query for a coarse primary pointer; and
+ *   IOS_SUPPORTS_QUERY with isIosWebKit, the iOS WebKit engine check
  * @position The dependency-free half of touchPresentation.ts, for code that
  *   must load without React or the theme: the motion foundation, which
  *   Node-side specs and browser proofs load without a StyleX compile.
@@ -12,4 +13,21 @@
  */
 
 /** The primary pointer is coarse: touch behaviours. */
-export const TOUCH_QUERY = '(pointer: coarse)';
+export const TOUCH_QUERY = '(pointer: coarse)';
+
+/**
+ * The engine is WebKit on iOS or iPadOS: the only one that implements
+ * `-webkit-touch-callout`. For a style iOS WebKit requires, never a
+ * behaviour; isIosWebKit reads it for an engine workaround a record names.
+ */
+export const IOS_SUPPORTS_QUERY = '(-webkit-touch-callout: none)';
+
+/**
+ * Whether `view`'s engine is iOS WebKit, by IOS_SUPPORTS_QUERY. Only for an
+ * engine workaround a record names (`spec:AST-013` FR6): the selection
+ * lock's inline style, and the gesture host's presented hit testing. False
+ * where `CSS.supports` is missing (jsdom has `CSS.escape` only).
+ */
+export function isIosWebKit(view = globalThis) {
+  return view?.CSS?.supports?.(IOS_SUPPORTS_QUERY) === true;
+}

package/dist/utils/typeaheadMatch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Fold text for type-to-select: no case, no combining marks, the six stroked
+ * letters and ı as their base letter. Locale-independent by design.
+ */
+export declare function foldForTypeahead(text: string): string;
+/**
+ * The type-to-select buffer after one more key, shared by every path so they
+ * buffer the same way. Returns null when the key is not a letter to jump to: a
+ * lone combining mark typed first. Pressing the same letter again (as folded)
+ * cycles, so the buffer stays that one letter instead of growing.
+ */
+export declare function nextTypeaheadBuffer(buffer: string, key: string): string | null;
+/**
+ * Whether `label` starts with `typed` under the fold. `exact` additionally
+ * requires the unfolded letters to match (Turkish case pairing).
+ */
+export declare function typeaheadPrefixMatch(label: string, typed: string, exact?: boolean): boolean;
+/**
+ * Find the next item whose label matches the typed letters, visiting indexes
+ * in `order`. When the typed letters carry a diacritic, a stroked letter, ı or
+ * İ, an exact match anywhere in the order wins over a folded one.
+ */
+export declare function findTypeaheadMatch(order: ReadonlyArray<number>, getLabel: (index: number) => string | null | undefined, typed: string): number;
+//# sourceMappingURL=typeaheadMatch.d.ts.map

package/dist/utils/typeaheadMatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeaheadMatch.d.ts","sourceRoot":"","sources":["../../src/utils/typeaheadMatch.ts"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWrD;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,IAAI,CAYf;AAsBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,KAAK,UAAQ,GACZ,OAAO,CAWT;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,EAC5B,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,EACtD,KAAK,EAAE,MAAM,GACZ,MAAM,CAWR"}

package/dist/utils/typeaheadMatch.js

@@ -0,0 +1,113 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file typeaheadMatch.ts
+ * @input Plain strings (an item label and the letters a person typed)
+ * @output foldForTypeahead, nextTypeaheadBuffer, typeaheadPrefixMatch,
+ *   findTypeaheadMatch
+ * @position Shared type-to-select matching for useTypeahead, useTreeFocus and
+ *   MultiSelector
+ *
+ * Type-to-select is navigation, not sorting, so it folds the same way in every
+ * locale: case, the combining marks canonical decomposition leaves
+ * (U+0300–U+036F), six Latin letters with a stroke or bar, and Turkish ı and
+ * İ. Typed letters that carry one of those marks prefer an exact match, with
+ * case paired the Turkish way (ı with I, İ with i).
+ */
+
+const COMBINING_MARKS = /[\u0300-\u036f]/g;
+
+// The six stroked or barred Latin letters that the fold removes, in both cases.
+// Turkish dotless ı joins them; dotted İ decomposes to I + U+0307 and needs no
+// entry.
+const STROKED = {
+  đ: 'd',
+  Đ: 'd',
+  ł: 'l',
+  Ł: 'l',
+  ø: 'o',
+  Ø: 'o',
+  ħ: 'h',
+  Ħ: 'h',
+  ŧ: 't',
+  Ŧ: 't',
+  ƀ: 'b',
+  Ƀ: 'b',
+  ı: 'i'
+};
+const STROKED_CHARS = /[đĐłŁøØħĦŧŦƀɃı]/g;
+const MARKED_CHARS = /[đĐłŁøØħĦŧŦƀɃıİ]/;
+
+/**
+ * Fold text for type-to-select: no case, no combining marks, the six stroked
+ * letters and ı as their base letter. Locale-independent by design.
+ */
+export function foldForTypeahead(text) {
+  return text.normalize('NFD').replace(COMBINING_MARKS, '').replace(STROKED_CHARS, c => STROKED[c] ?? c)
+  // Recompose what the fold keeps (a Japanese voiced mark, an Arabic hamza,
+  // a Hangul final consonant), so a one-letter prefix does not skip it.
+  .normalize('NFC').toLowerCase();
+}
+
+/**
+ * The type-to-select buffer after one more key, shared by every path so they
+ * buffer the same way. Returns null when the key is not a letter to jump to: a
+ * lone combining mark typed first. Pressing the same letter again (as folded)
+ * cycles, so the buffer stays that one letter instead of growing.
+ */
+export function nextTypeaheadBuffer(buffer, key) {
+  if (buffer.length === 0 && key !== ' ' && foldForTypeahead(key).length === 0) {
+    return null;
+  }
+  const isRepeatSameChar = buffer.length > 0 && buffer.split('').every(c => foldForTypeahead(c) === foldForTypeahead(key));
+  return isRepeatSameChar ? key : buffer + key;
+}
+
+/**
+ * Case-fold for the exact-match preference, pairing the Turkish way: I with ı
+ * and İ with i. Composed, so an accent typed as its own key counts as one
+ * letter, as it does in a composed label.
+ */
+function exactFold(text) {
+  return text.normalize('NFC').replace(/I/g, 'ı').replace(/İ/g, 'i').toLowerCase();
+}
+
+/** Whether typed letters carry a mark that makes an exact match preferable. */
+function hasMark(typed) {
+  return MARKED_CHARS.test(typed) || /[\u0300-\u036f]/.test(typed.normalize('NFD'));
+}
+
+/**
+ * Whether `label` starts with `typed` under the fold. `exact` additionally
+ * requires the unfolded letters to match (Turkish case pairing).
+ */
+export function typeaheadPrefixMatch(label, typed, exact = false) {
+  const trimmed = label.trim();
+  if (exact) {
+    return exactFold(trimmed).startsWith(exactFold(typed));
+  }
+  const foldedTyped = foldForTypeahead(typed);
+  // A lone combining mark folds to nothing; it is not a letter to jump to.
+  if (foldedTyped.length === 0) {
+    return false;
+  }
+  return foldForTypeahead(trimmed).startsWith(foldedTyped);
+}
+
+/**
+ * Find the next item whose label matches the typed letters, visiting indexes
+ * in `order`. When the typed letters carry a diacritic, a stroked letter, ı or
+ * İ, an exact match anywhere in the order wins over a folded one.
+ */
+export function findTypeaheadMatch(order, getLabel, typed) {
+  const passes = hasMark(typed) ? [true, false] : [false];
+  for (const exact of passes) {
+    for (const index of order) {
+      const label = getLabel(index);
+      if (label != null && typeaheadPrefixMatch(label, typed, exact)) {
+        return index;
+      }
+    }
+  }
+  return -1;
+}

package/dist/utils/useFocusLeavingChange.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Notes focus in the commit before `value`'s change touches the DOM, and
+ * moves it from a layout effect of the same commit.
+ *
+ * Pass the returned callback as `LayoutChangeSnapshot`'s `onBeforeChange`
+ * (with `value` as its `value`). `note` receives the value being left and
+ * returns what `move` needs, or `null` when there is nothing to move; `move`
+ * receives that and the new value once the change has committed. `move` is
+ * the latest render's. `note` runs before this commit's effects, so it is the
+ * previous committed render's: read refs or the DOM in it, not props.
+ */
+export declare function useFocusLeavingChange<V, N>(value: V, note: (previous: V) => N | null, move: (noted: N, value: V) => void): (previous: V) => void;
+//# sourceMappingURL=useFocusLeavingChange.d.ts.map

package/dist/utils/useFocusLeavingChange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFocusLeavingChange.d.ts","sourceRoot":"","sources":["../../src/utils/useFocusLeavingChange.ts"],"names":[],"mappings":"AAmBA;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,CAAC,EACxC,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,IAAI,EAC/B,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,GACjC,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAkBvB"}

package/dist/utils/useFocusLeavingChange.js

@@ -0,0 +1,48 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file useFocusLeavingChange.ts
+ * @input A state whose change can remove or hide focused content, how to note
+ *   the focus before the change, and how to move it after
+ * @output A before-change callback for `LayoutChangeSnapshot`, and the move,
+ *   run from a layout effect of the same commit
+ * @position Internal hook, not exported from the package: the one sequence a
+ *   disclosure runs so focus leaves content its change takes away
+ *   (`component:SideNav` AR3, `component:Collapsible` AR4). It pairs with
+ *   `noteFocusWithin` and `moveFocusLeftBehind` in `focusReturn.ts`, which
+ *   stays free of React so `isFocusDetached` remains server-safe.
+ */
+import { useCallback, useLayoutEffect, useRef } from 'react';
+
+/**
+ * Notes focus in the commit before `value`'s change touches the DOM, and
+ * moves it from a layout effect of the same commit.
+ *
+ * Pass the returned callback as `LayoutChangeSnapshot`'s `onBeforeChange`
+ * (with `value` as its `value`). `note` receives the value being left and
+ * returns what `move` needs, or `null` when there is nothing to move; `move`
+ * receives that and the new value once the change has committed. `move` is
+ * the latest render's. `note` runs before this commit's effects, so it is the
+ * previous committed render's: read refs or the DOM in it, not props.
+ */
+export function useFocusLeavingChange(value, note, move) {
+  const noteRef = useRef(note);
+  const moveRef = useRef(move);
+  const pendingRef = useRef(null);
+  useLayoutEffect(() => {
+    noteRef.current = note;
+    moveRef.current = move;
+  });
+  useLayoutEffect(() => {
+    const noted = pendingRef.current;
+    pendingRef.current = null;
+    if (noted != null) {
+      moveRef.current(noted, value);
+    }
+  }, [value]);
+  return useCallback(previous => {
+    pendingRef.current = noteRef.current(previous);
+  }, []);
+}

package/locales/af-ZA.json

@@ -580,7 +580,7 @@
     "description": "Screen-reader-only label on the vertical drag handle at the right edge of the SideNav that lets the user resize the sidebar's width."
   },
   "@astryx.sideNav.heading.openMenu": {
-    "defaultMessage": "Maak kieslys oop",
+    "defaultMessage": "{heading}, Maak kieslys oop",
     "description": "Screen-reader-only label on the `⋯` overflow-menu button embedded in a SideNav section heading. Same string as `topNav.heading.openMenu` — translations may share."
   },
   "@astryx.tabList.label": {
@@ -648,7 +648,7 @@
     "description": "Label on the \"×\" button that removes every token/chip from a Tokenizer input. Imperative verb + determiner \"all\"; short."
   },
   "@astryx.topNav.heading.openMenu": {
-    "defaultMessage": "Maak kieslys oop",
+    "defaultMessage": "{hasHeading, select, true {{heading}, } other {}}Maak kieslys oop",
     "description": "Screen-reader-only label on the `⋯` overflow button in a TopNav section heading. Kept separate from `sideNav.heading.openMenu` so translations may diverge."
   },
   "@astryx.topNav.landmarkLabel": {

package/locales/ar-SA.json

@@ -580,7 +580,7 @@
     "description": "Screen-reader-only label on the vertical drag handle at the right edge of the SideNav that lets the user resize the sidebar's width."
   },
   "@astryx.sideNav.heading.openMenu": {
-    "defaultMessage": "فتح القائمة",
+    "defaultMessage": "{heading}, فتح القائمة",
     "description": "Screen-reader-only label on the `⋯` overflow-menu button embedded in a SideNav section heading. Same string as `topNav.heading.openMenu` — translations may share."
   },
   "@astryx.tabList.label": {
@@ -648,7 +648,7 @@
     "description": "Label on the \"×\" button that removes every token/chip from a Tokenizer input. Imperative verb + determiner \"all\"; short."
   },
   "@astryx.topNav.heading.openMenu": {
-    "defaultMessage": "فتح القائمة",
+    "defaultMessage": "{hasHeading, select, true {{heading}, } other {}}فتح القائمة",
     "description": "Screen-reader-only label on the `⋯` overflow button in a TopNav section heading. Kept separate from `sideNav.heading.openMenu` so translations may diverge."
   },
   "@astryx.topNav.landmarkLabel": {