@astryxdesign/core 0.7.5 → 0.7.6-canary.0d71e8d

package/dist/utils/sharedMutationObserver.js

@@ -5,50 +5,82 @@
 /**
  * @file sharedMutationObserver.ts
  * @input MutationObserver API
- * @output Exports observeContent for shared content-change observation
- * @position Internal utility; consumed by useTruncation. The content-change
- *   counterpart of sharedResizeObserver: one observer for every element, so a
- *   repeated cell or row path does not create one observer per instance.
+ * @output Exports observeMutations (one shared observer per set of options)
+ *   and observeContent, its text-and-children form
+ * @position Internal utility; consumed by useTruncation, hitArea and AppShell's
+ *   main-overflow observer. The mutation counterpart of sharedResizeObserver:
+ *   one observer for every element observed with the same options, so a
+ *   repeated cell, row or region does not create one observer per instance.
  */
-const OPTIONS = {
+const CONTENT_OPTIONS = {
   characterData: true,
   childList: true,
   subtree: true
 };
-let observer = null;
-const callbacks = new Map();
-function dispatch(records) {
-  // One call per callback per batch, however many records it received. A
-  // record's target can be any descendant, so walk up to the observed roots.
-  const pending = new Set();
-  for (const record of records) {
-    for (let node = record.target; node; node = node.parentNode) {
-      callbacks.get(node)?.forEach(callback => pending.add(callback));
+/**
+ * One observer per distinct set of options: an observer holds one set of
+ * options per node, so registrations that need different options cannot
+ * share one.
+ */
+const observers = new Map();
+function optionsKey(options) {
+  return JSON.stringify([options.attributes === true, options.attributeFilter == null ? null : [...options.attributeFilter].sort(), options.characterData === true, options.childList === true, options.subtree === true]);
+}
+function createSharedObserver(options) {
+  const callbacks = new Map();
+  const isSubtree = options.subtree === true;
+  const observer = new MutationObserver(records => {
+    // One call per callback per batch, however many records it received.
+    // With `subtree`, a record's target can be any descendant, so walk up to
+    // the observed roots; without it, the target is the observed node.
+    const pending = new Set();
+    for (const record of records) {
+      if (!isSubtree) {
+        callbacks.get(record.target)?.forEach(callback => pending.add(callback));
+        continue;
+      }
+      for (let node = record.target; node; node = node.parentNode) {
+        callbacks.get(node)?.forEach(callback => pending.add(callback));
+      }
     }
-  }
-  pending.forEach(callback => callback());
+    pending.forEach(callback => callback());
+  });
+  return {
+    observer,
+    callbacks
+  };
 }
 
 /**
- * Call `callback` when the element's text or children change (including
- * descendants). Returns an unsubscribe that removes only this registration.
+ * Call `callback` for mutations of `element` matching `options`, through the
+ * one observer shared by every registration with the same options. Returns an
+ * unsubscribe that removes only this registration.
  *
  * MutationObserver has no per-target unobserve, so a released element stays
- * registered with the shared observer until no element remains; its records
- * match no callback and are ignored. The observer disconnects and is released
- * when the last registration goes.
+ * registered with its shared observer until no element remains; its records
+ * match no callback and are ignored. An observer disconnects and is released
+ * when its last registration goes.
  */
-export function observeContent(element, callback) {
+export function observeMutations(element, options, callback) {
   if (typeof MutationObserver === 'undefined') {
     return () => {};
   }
-  observer ??= new MutationObserver(dispatch);
+  const key = optionsKey(options);
+  let shared = observers.get(key);
+  if (shared == null) {
+    shared = createSharedObserver(options);
+    observers.set(key, shared);
+  }
+  const {
+    observer,
+    callbacks
+  } = shared;
   const existing = callbacks.get(element);
   if (existing) {
     existing.add(callback);
   } else {
     callbacks.set(element, new Set([callback]));
-    observer.observe(element, OPTIONS);
+    observer.observe(element, options);
   }
   let isSubscribed = true;
   return () => {
@@ -61,9 +93,17 @@ export function observeContent(element, callback) {
     if (targetCallbacks?.size === 0) {
       callbacks.delete(element);
     }
-    if (callbacks.size === 0 && observer) {
+    if (callbacks.size === 0 && observers.get(key)?.observer === observer) {
       observer.disconnect();
-      observer = null;
+      observers.delete(key);
     }
   };
+}
+
+/**
+ * Call `callback` when the element's text or children change (including
+ * descendants). Returns an unsubscribe that removes only this registration.
+ */
+export function observeContent(element, callback) {
+  return observeMutations(element, CONTENT_OPTIONS, callback);
 }

package/dist/utils/timeFormat.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @file timeFormat.ts
+ * @input An ISO time or typed text, plus the provider's BCP 47 locale
+ * @output Exports resolveHourFormat, formatLocaleTime, and parseLocaleTime
+ * @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.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/utils/timeFormat.test.ts
+ * - /packages/core/src/TimeInput/TimeInput.tsx
+ * - /packages/core/src/DateTimeInput/DateTimeInput.tsx
+ */
+import type { Locale } from '../i18n/types.js';
+import { type ISOTimeString } from './timeParser.js';
+export type HourFormat = '12h' | '24h';
+/**
+ * The hour format a field shows: the caller's explicit choice, else the
+ * locale's hour cycle (including a `-u-hc-` extension on the tag).
+ */
+export declare function resolveHourFormat(locale: Locale, hourFormat?: HourFormat): HourFormat;
+/**
+ * Formats an ISO time as the locale writes it, in the given hour format.
+ * en-US: "14:30" → "2:30 PM"; de-DE 24h: "14:30"; ko-KR 12h: "오후 2:30".
+ * Returns '' for an empty or malformed time.
+ */
+export declare function formatLocaleTime(time: ISOTimeString | undefined, locale: Locale, hourFormat: HourFormat, includeSeconds?: boolean): string;
+/**
+ * Parses typed text into an ISO time, accepting the locale's digits,
+ * separator, and day-period words as well as everything `parseTimeInput`
+ * accepts. Returns null when no reading fits.
+ */
+export declare function parseLocaleTime(input: string, locale: Locale, includeSeconds?: boolean): ISOTimeString | null;
+//# sourceMappingURL=timeFormat.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/timeFormat.js

@@ -0,0 +1,240 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file timeFormat.ts
+ * @input An ISO time or typed text, plus the provider's BCP 47 locale
+ * @output Exports resolveHourFormat, formatLocaleTime, and parseLocaleTime
+ * @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.
+ *
+ * SYNC: When modified, update these files to stay in sync:
+ * - /packages/core/src/utils/timeFormat.test.ts
+ * - /packages/core/src/TimeInput/TimeInput.tsx
+ * - /packages/core/src/DateTimeInput/DateTimeInput.tsx
+ */
+
+import { parseISOTime, parseTimeInput } from "./timeParser.js";
+import { INVISIBLE_CHARS, toAsciiDigits } from "./unicodeDigits.js";
+const symbolsByLocale = new Map();
+
+// The space family Intl writes between a time and its day period ("2:30 PM"
+// uses U+202F). A typed field shows a plain space so people can edit it.
+const SPACES = /[\u00A0\u2007\u202F]/g;
+// What may sit on a peeled word's inner side: a digit (digits are already
+// ASCII here), whitespace, or nothing.
+const WORD_BOUNDARY = /^[\d\s]?$/;
+function utcDate(hour, minute, second) {
+  return new Date(Date.UTC(2000, 0, 1, hour, minute, second));
+}
+function timeFormatter(locale, hourFormat, includeSeconds) {
+  const options = {
+    hour: hourFormat === '12h' ? 'numeric' : '2-digit',
+    minute: '2-digit',
+    second: includeSeconds ? '2-digit' : undefined,
+    // `hourCycle`, not `hour12`: `hour12: true` resolves to h11 in ja-JP and
+    // writes noon as "午後0:30".
+    hourCycle: hourFormat === '12h' ? 'h12' : 'h23',
+    timeZone: 'UTC'
+  };
+  try {
+    return new Intl.DateTimeFormat(locale, options);
+  } catch {
+    return new Intl.DateTimeFormat('en', options);
+  }
+}
+function getLocaleTimeSymbols(locale) {
+  let symbols = symbolsByLocale.get(locale);
+  if (symbols !== undefined) {
+    return symbols;
+  }
+  let hourFormat;
+  let resolved;
+  try {
+    resolved = new Intl.DateTimeFormat(locale, {
+      hour: 'numeric'
+    }).resolvedOptions();
+  } catch {
+    // A malformed tag formats as English everywhere else in this module.
+    resolved = new Intl.DateTimeFormat('en', {
+      hour: 'numeric'
+    }).resolvedOptions();
+  }
+  if (resolved.hourCycle !== undefined) {
+    hourFormat = resolved.hourCycle === 'h11' || resolved.hourCycle === 'h12' ? '12h' : '24h';
+  } else {
+    // Engines that leave hourCycle unresolved still write a day period for a
+    // twelve-hour locale when no cycle is forced.
+    let ambient;
+    try {
+      ambient = new Intl.DateTimeFormat(locale, {
+        hour: 'numeric'
+      });
+    } catch {
+      ambient = new Intl.DateTimeFormat('en', {
+        hour: 'numeric'
+      });
+    }
+    hourFormat = ambient.formatToParts(utcDate(13, 0, 0)).some(part => part.type === 'dayPeriod') ? '12h' : '24h';
+  }
+
+  // Literals of every reading this module writes: twelve- and twenty-four-hour,
+  // with and without seconds. A literal between two numbers is a separator;
+  // one outside them is an edge word.
+  const separatorSet = new Set();
+  const edgeSet = new Set();
+  for (const cycle of ['12h', '24h']) {
+    for (const withSeconds of [false, true]) {
+      const parts = timeFormatter(locale, cycle, withSeconds).formatToParts(utcDate(13, 30, 5));
+      const isNumber = part => part.type === 'hour' || part.type === 'minute' || part.type === 'second';
+      const first = parts.findIndex(isNumber);
+      const last = parts.length - 1 - [...parts].reverse().findIndex(isNumber);
+      parts.forEach((part, index) => {
+        if (part.type !== 'literal') {
+          return;
+        }
+        const text = normalizeText(part.value).trim();
+        if (text === '' || text === ':') {
+          return;
+        }
+        (index > first && index < last ? separatorSet : edgeSet).add(text);
+      });
+    }
+  }
+  const separators = [...separatorSet];
+  const edgeWords = [...edgeSet].sort((a, b) => b.length - a.length);
+
+  // Every hour, because some locales name several periods across the day
+  // (flexible day periods). A word that appears on both sides of noon cannot
+  // say which half it means, so it is left out.
+  const twelveHour = timeFormatter(locale, '12h', false);
+  const sides = new Map();
+  for (let hour = 0; hour < 24; hour++) {
+    const word = twelveHour.formatToParts(utcDate(hour, 0, 0)).find(part => part.type === 'dayPeriod')?.value;
+    if (word === undefined) {
+      continue;
+    }
+    const key = normalizeText(word).trim();
+    if (key === '') {
+      continue;
+    }
+    const seen = sides.get(key) ?? new Set();
+    seen.add(hour >= 12);
+    sides.set(key, seen);
+  }
+  const dayPeriods = [...sides].filter(([, seen]) => seen.size === 1).map(([word, seen]) => ({
+    word,
+    isPM: seen.has(true)
+  })).sort((a, b) => b.word.length - a.word.length);
+  const twelveHourIsAmbiguous = normalizeText(twelveHour.format(utcDate(2, 0, 0))) === normalizeText(twelveHour.format(utcDate(14, 0, 0)));
+  symbols = {
+    hourFormat,
+    separators,
+    edgeWords,
+    dayPeriods,
+    twelveHourIsAmbiguous
+  };
+  symbolsByLocale.set(locale, symbols);
+  return symbols;
+}
+function normalizeText(text) {
+  const folded = text.normalize('NFKC').replace(INVISIBLE_CHARS, '').replace(SPACES, ' ');
+  return (toAsciiDigits(folded) ?? folded).toLowerCase();
+}
+function escapeRegExp(text) {
+  return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+
+/**
+ * The hour format a field shows: the caller's explicit choice, else the
+ * locale's hour cycle (including a `-u-hc-` extension on the tag).
+ */
+export function resolveHourFormat(locale, hourFormat) {
+  return hourFormat ?? getLocaleTimeSymbols(locale).hourFormat;
+}
+
+/**
+ * Formats an ISO time as the locale writes it, in the given hour format.
+ * en-US: "14:30" → "2:30 PM"; de-DE 24h: "14:30"; ko-KR 12h: "오후 2:30".
+ * Returns '' for an empty or malformed time.
+ */
+export function formatLocaleTime(time, locale, hourFormat, includeSeconds = false) {
+  if (!time) {
+    return '';
+  }
+  const parsed = parseISOTime(time);
+  if (!parsed) {
+    return '';
+  }
+  const formatLocale = hourFormat === '12h' && getLocaleTimeSymbols(locale).twelveHourIsAmbiguous ? 'en' : locale;
+  return timeFormatter(formatLocale, hourFormat, includeSeconds).format(utcDate(parsed.hour, parsed.minute, parsed.second)).replace(SPACES, ' ');
+}
+
+/**
+ * Parses typed text into an ISO time, accepting the locale's digits,
+ * separator, and day-period words as well as everything `parseTimeInput`
+ * accepts. Returns null when no reading fits.
+ */
+export function parseLocaleTime(input, locale, includeSeconds = false) {
+  if (!input) {
+    return null;
+  }
+  const {
+    separators,
+    edgeWords,
+    dayPeriods
+  } = getLocaleTimeSymbols(locale);
+  let text = normalizeText(input).trim();
+
+  // Peel the day period and edge words off both ends, in whatever order the
+  // locale writes them ("ŋdi ga 2:30", "kl. 2.30 pm").
+  let isPM = null;
+  // A word counts only when a digit, whitespace, or nothing sits on its inner
+  // side, so gd's "m" (morning) is not read out of an English "pm" or "p.m".
+  const strip = word => {
+    if (text.startsWith(word) && WORD_BOUNDARY.test(text.charAt(word.length))) {
+      text = text.slice(word.length).trim();
+      return true;
+    }
+    if (text.endsWith(word) && WORD_BOUNDARY.test(text.charAt(text.length - word.length - 1))) {
+      text = text.slice(0, -word.length).trim();
+      return true;
+    }
+    return false;
+  };
+  for (let peeled = true; peeled;) {
+    peeled = false;
+    if (isPM === null) {
+      const period = dayPeriods.find(({
+        word
+      }) => strip(word));
+      if (period !== undefined) {
+        isPM = period.isPM;
+        peeled = true;
+      }
+    }
+    if (edgeWords.some(strip)) {
+      peeled = true;
+    }
+  }
+  for (const separator of separators) {
+    text = text.replace(new RegExp(`(\\d)\\s*${escapeRegExp(separator)}\\s*(?=\\d)`, 'g'), '$1:');
+  }
+  if (isPM !== null) {
+    text = `${text} ${isPM ? 'pm' : 'am'}`;
+  }
+  return parseTimeInput(text, includeSeconds);
+}

package/dist/utils/touchPresentation.d.ts

@@ -1,6 +1,6 @@
 import { type CompactDefinition } from '../theme/themeAdaptations.js';
-/** The primary pointer is coarse: touch behaviours. */
-export declare const TOUCH_QUERY = "(pointer: coarse)";
+import { 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,

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

@@ -1 +1 @@
-{"version":3,"file":"touchPresentation.d.ts","sourceRoot":"","sources":["../../src/utils/touchPresentation.ts"],"names":[],"mappings":"AA6DA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,2BAA2B,CAAC;AAGnC,uDAAuD;AACvD,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C;;;;;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":"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"}

package/dist/utils/touchPresentation.js

@@ -4,7 +4,8 @@
 
 /**
  * @file touchPresentation.ts
- * @input Uses the SSR-safe useMediaQuery hook and window.matchMedia
+ * @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;
@@ -28,8 +29,8 @@
  *   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 reads the theme's motion
- * roles, whose defaults are the measured table.
+ * 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
@@ -46,9 +47,11 @@
  * 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. The keys are literal because the Astryx
- * StyleX build does not resolve a key shared across files through
- * `defineConsts`. The hook is for behaviour. It answers the server default
+ * 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).
@@ -60,9 +63,11 @@ 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";
 
-/** The primary pointer is coarse: touch behaviours. */
-export const TOUCH_QUERY = '(pointer: coarse)';
+// 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

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

@@ -0,0 +1,15 @@
+export declare const touchKeys: {
+    /** The primary pointer is coarse (TOUCH_QUERY). */
+    touch: string;
+    /** The viewport is compact (COMPACT_QUERY, `spec:AST-012` FR9). */
+    compact: string;
+    /** Both: a presentation such as a sheet in place of a popover. */
+    compactTouch: string;
+    /**
+     * The iOS WebKit gate, inside `touch` (IOS_SUPPORTS_QUERY): only for a
+     * style iOS WebKit itself requires (the 16px input floor), never a
+     * behaviour; touch behaviour is one model on every touch device.
+     */
+    iosSupports: string;
+};
+//# sourceMappingURL=touchPresentation.stylex.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/touchPresentation.stylex.js

@@ -0,0 +1,33 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file touchPresentation.stylex.ts
+ * @input Uses StyleX defineConsts
+ * @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.
+ *
+ * SYNC: When modified, update touchPresentation.ts and
+ * touchPresentation.test.ts.
+ */
+
+import * as stylex from '@stylexjs/stylex';
+export const touchKeys = {
+  touch: "@media (pointer: coarse)",
+  compact: "@media (width < 768px), (height < 500px)",
+  compactTouch: "@media (width < 768px) and (pointer: coarse), (height < 500px) and (pointer: coarse)",
+  iosSupports: "@supports (-webkit-touch-callout: none)"
+};

package/dist/utils/touchQueries.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file touchQueries.ts
+ * @input Nothing: plain strings
+ * @output TOUCH_QUERY, the media query for a coarse primary pointer
+ * @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.
+ *   touchPresentation.ts re-exports it beside the hook and the parts that
+ *   read the theme.
+ */
+/** The primary pointer is coarse: touch behaviours. */
+export declare const TOUCH_QUERY = "(pointer: coarse)";
+//# sourceMappingURL=touchQueries.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/touchQueries.js

@@ -0,0 +1,15 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file touchQueries.ts
+ * @input Nothing: plain strings
+ * @output TOUCH_QUERY, the media query for a coarse primary pointer
+ * @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.
+ *   touchPresentation.ts re-exports it beside the hook and the parts that
+ *   read the theme.
+ */
+
+/** The primary pointer is coarse: touch behaviours. */
+export const TOUCH_QUERY = '(pointer: coarse)';

package/dist/utils/unicodeDigits.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Zero-width joiners, bidi marks and isolates (which Intl writes around RTL
+ * numbers and day periods), and the BOM Excel prepends.
+ */
+export declare const INVISIBLE_CHARS: RegExp;
+/**
+ * Value of any Unicode decimal digit. Each digit script lays its ten digits
+ * out consecutively, so walking back to the script's zero derives the value
+ * for Arabic-Indic, Devanagari, full-width and the rest without shipping a
+ * table of them. Returns null for a non-digit, and in the one shape the walk
+ * cannot resolve: two digit blocks adjacent in code space (the mathematical
+ * alphanumerics).
+ */
+export declare function digitValue(char: string): number | null;
+/**
+ * Rewrites every decimal digit as its ASCII digit, leaving other characters
+ * alone. Returns null when a digit's value cannot be resolved.
+ */
+export declare function toAsciiDigits(text: string): string | null;
+//# sourceMappingURL=unicodeDigits.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"unicodeDigits.d.ts","sourceRoot":"","sources":["../../src/utils/unicodeDigits.ts"],"names":[],"mappings":"AAwBA;;;GAGG;AACH,eAAO,MAAM,eAAe,QAC6B,CAAC;AAE1D;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAczD"}