@astryxdesign/core 0.7.5-canary.fccd771 → 0.7.5

package/dist/utils/pressGesture.js

@@ -2,7 +2,7 @@
 
 /**
  * @file pressGesture.ts
- * @input A press gesture's current phase and one pointer or timer event
+ * @input A press gesture's current phase and one pointer, key or timer event
  * @output Exports the press state machine (pressGestureStep, idlePressGesture),
  *   its clocks (PRESS_ONSET_MS, PRESS_SLOP_PX, PRESS_FLASH_MS, PRESS_FADE_MS,
  *   PRESS_SCROLL_BRAKE_MS) and their types
@@ -18,6 +18,11 @@
  * still painted 1.6 s into a scroll. So on a coarse pointer the pressed state
  * is owned here, in JavaScript, and `:active` keeps only the mouse.
  *
+ * The stylesheet drops `:active` by the PRIMARY pointer, so a mouse, trackpad
+ * or Space key on such a device has lost `:active` too. Their presses come
+ * here as `buttonDown`: painted at once, held through any travel, faded on
+ * release like a finger's.
+ *
  * Every constant below was measured against the real Settings and Contacts
  * apps on an iPhone simulator, driven with real HID touches at 60 fps, before
  * it was written down. The machine is deliberately ignorant of the DOM: it
@@ -91,6 +96,10 @@ export const PRESS_SCROLL_BRAKE_MS = 150;
  * until the finger lifts and a new one starts, so a finger that stops moving,
  * or comes back to the control it started on, paints nothing. That is the
  * difference between this and `:active`.
+ *
+ * `buttonHeld` is a press made with a mouse button or the Space key. No
+ * scroller can claim one, so it paints at once, travel does not end it, and
+ * only the release does.
  */
 
 const IDLE = {
@@ -134,6 +143,19 @@ export function pressGestureStep(gesture, event) {
       timer: 'onset'
     };
   }
+  if (event.kind === 'buttonDown') {
+    // Nothing can turn a mouse button or a key into a scroll, so there is
+    // nothing to wait for: paint now, as `:active` does on a desktop.
+    return {
+      gesture: {
+        originX: 0,
+        originY: 0,
+        phase: 'buttonHeld'
+      },
+      paint: 'on',
+      timer: null
+    };
+  }
   switch (gesture.phase) {
     case 'armed':
       if (event.kind === 'move') {
@@ -188,6 +210,23 @@ export function pressGestureStep(gesture, event) {
         paint: 'on',
         timer: null
       };
+    case 'buttonHeld':
+      // Travel is not a scroll here (a mouse dragged off a button keeps its
+      // `:active` until the button comes up), so only the release ends the
+      // press, with the same fade a finger's release gets.
+      if (event.kind === 'up') {
+        return step(gesture, 'fading', 'fading', 'fade');
+      }
+      // The platform took it (a drag began, the pointer was cancelled): the
+      // paint goes at once, as for a finger.
+      if (event.kind === 'cancel') {
+        return step(gesture, 'dead', 'none', null);
+      }
+      return {
+        gesture,
+        paint: 'on',
+        timer: null
+      };
     case 'flash':
       // The full-strength hold is over; hand it to the same fade a long press
       // gets, so both releases leave the same way.

package/dist/utils/touchPresentation.d.ts

@@ -0,0 +1,48 @@
+import { type CompactDefinition } from '../theme/themeAdaptations.js';
+/** The primary pointer is coarse: touch behaviours. */
+export declare const TOUCH_QUERY = "(pointer: coarse)";
+/**
+ * The viewport is compact at the default width points: layout behaviours
+ * (`spec:AST-012` FR9). 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)";
+/**
+ * The iOS gate as StyleX keys, nested in this order: the media query
+ * outside, the supports query inside.
+ */
+export declare const IOS_TOUCH_STYLE_KEYS: readonly ["@media (pointer: coarse)", "@supports (-webkit-touch-callout: none)"];
+export interface TouchPresentation {
+    /** The primary pointer is coarse (a finger). */
+    readonly isTouch: boolean;
+    /** The viewport is compact. */
+    readonly isCompact: boolean;
+}
+/**
+ * The active theme's compact definition (`spec:AST-012` FR9): width below the
+ * theme's effective `md` point, or height below 500.
+ */
+export declare function useCompactDefinition(): CompactDefinition;
+/**
+ * The touch presentation now. SSR-safe: hooks render the server default and
+ * update after hydration.
+ */
+export declare function useTouchPresentation(serverDefault?: Partial<TouchPresentation>): TouchPresentation;
+/**
+ * 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
+ * not compact where there is no window.
+ */
+export declare function readTouchPresentation(view: Window | null, compact: CompactDefinition): TouchPresentation;
+//# sourceMappingURL=touchPresentation.d.ts.map

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

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

package/dist/utils/touchPresentation.js

@@ -0,0 +1,133 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+'use client';
+
+/**
+ * @file touchPresentation.ts
+ * @input Uses the SSR-safe useMediaQuery hook and window.matchMedia
+ * @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 reads the theme's motion
+ * roles, whose defaults are the measured table.
+ *
+ * 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. 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
+ * (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).
+ *
+ * SYNC: When modified, update touchPresentation.test.ts and every StyleX
+ * media key that spells these queries.
+ */
+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";
+
+/** The primary pointer is coarse: touch behaviours. */
+export const TOUCH_QUERY = '(pointer: coarse)';
+
+/**
+ * The viewport is compact at the default width points: layout behaviours
+ * (`spec:AST-012` FR9). 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 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 iOS gate as StyleX keys, nested in this order: the media query
+ * outside, the supports query inside.
+ */
+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
+ * theme's effective `md` point, or height below 500.
+ */
+export function useCompactDefinition() {
+  const points = useThemeDefinition()?.__adaptations?.widthBreakpoints;
+  return useMemo(() => points == null ? DEFAULT_COMPACT_DEFINITION : compactDefinition(points), [points]);
+}
+
+/**
+ * The touch presentation now. SSR-safe: hooks render the server default and
+ * update after hydration.
+ */
+export function useTouchPresentation(serverDefault = {}) {
+  const compact = useCompactDefinition();
+  const isTouch = useMediaQuery(TOUCH_QUERY, serverDefault.isTouch ?? false);
+  const isCompact = useMediaQuery(compact.query, serverDefault.isCompact ?? false);
+  return useMemo(() => ({
+    isTouch,
+    isCompact
+  }), [isTouch, isCompact]);
+}
+
+/**
+ * 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
+ * not compact where there is no window.
+ */
+export function readTouchPresentation(view, compact) {
+  if (view == null || typeof view.matchMedia !== 'function') {
+    return {
+      isTouch: false,
+      isCompact: false
+    };
+  }
+  const isTouch = view.matchMedia(TOUCH_QUERY).matches;
+  const isCompact = view.matchMedia(compact.query).matches;
+  return {
+    isTouch,
+    isCompact
+  };
+}

package/locales/af-ZA.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Geen resultate vir {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Laai tans",

package/locales/ar-SA.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "لا توجد نتائج لـ {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "جارٍ التحميل",

package/locales/ca-ES.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Cap resultat per a {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "S’està carregant",

package/locales/cs-CZ.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Žádné výsledky pro {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Načítání",

package/locales/da-DK.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Ingen resultater for {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Indlæser",

package/locales/de-DE.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Keine Ergebnisse für {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Wird geladen",

package/locales/el-GR.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Κανένα αποτέλεσμα για {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Φόρτωση",

package/locales/en.json

@@ -391,6 +391,10 @@
     "defaultMessage": "Expand",
     "description": "Button label on a chip in the chat composer representing a long pasted text block; clicking reveals full content. \"Expand\" here means reveal more, not grow physically."
   },
+  "@astryx.chat.pastedText.label": {
+    "defaultMessage": "{lines, plural, =1 {{chars, plural, other {{chars} chars}}} other {{lines} lines, {chars, plural, other {{chars} chars}}}}",
+    "description": "Count label on a pasted-text chip and its hover preview in the chat composer. {lines} is the number of text lines and {chars} is the character count. The single-line branch omits the line count. Translators may reorder the counts and localize the abbreviated units."
+  },
   "@astryx.checkboxList.item.checkbox": {
     "defaultMessage": "Checkbox",
     "description": "Localized hidden text used internally when a rich visible label names the checkbox through aria-labelledby. It does not become the computed name; callers must provide aria-label when rich content has no text."
@@ -1287,6 +1291,18 @@
     "defaultMessage": "1 file selected: {fileName}",
     "description": "Live-region announcement when a single file is successfully selected."
   },
+  "@astryx.fileInput.fileSize.bytes": {
+    "defaultMessage": "{size, number, ::group-off} B",
+    "description": "File-size limit below 1024 bytes in FileInput validation feedback. {size} is a number of bytes. Localize the unit abbreviation; do not add digit grouping."
+  },
+  "@astryx.fileInput.fileSize.kilobytes": {
+    "defaultMessage": "{size, number, :: .0 group-off} KB",
+    "description": "File-size limit from 1024 bytes up to one megabyte in FileInput validation feedback. {size} is bytes divided by 1024, displayed to one decimal place without digit grouping. Localize the unit abbreviation."
+  },
+  "@astryx.fileInput.fileSize.megabytes": {
+    "defaultMessage": "{size, number, :: .0 group-off} MB",
+    "description": "File-size limit of at least one megabyte in FileInput validation feedback. {size} is bytes divided by 1048576, displayed to one decimal place without digit grouping. Localize the unit abbreviation."
+  },
   "@astryx.fileInput.filesSelected": {
     "defaultMessage": "{count} files selected",
     "description": "Live-region announcement when multiple files are successfully selected."
@@ -1307,6 +1323,70 @@
     "defaultMessage": "{label}, {fileNames}",
     "description": "Accessible name for a FileInput trigger that has files attached, composing the field label with the selected filenames. Example: `Attachments, report.pdf, notes.txt`."
   },
+  "@astryx.kbd.key.alt": {
+    "defaultMessage": "Alt",
+    "description": "Spoken name of the Alt modifier key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.backspace": {
+    "defaultMessage": "Backspace",
+    "description": "Spoken name of the Backspace key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.command": {
+    "defaultMessage": "Command",
+    "description": "Spoken name of the Command modifier key on Apple platforms in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.control": {
+    "defaultMessage": "Control",
+    "description": "Spoken name of the Control modifier key in a keyboard shortcut's accessible name. Also resolves the mod key on non-Apple platforms."
+  },
+  "@astryx.kbd.key.controlShort": {
+    "defaultMessage": "Ctrl",
+    "description": "Abbreviated visible label of the Control keycap used for mod on non-Apple platforms. Localize to the keyboard's conventional short label."
+  },
+  "@astryx.kbd.key.down": {
+    "defaultMessage": "Down arrow",
+    "description": "Spoken name of the down arrow key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.enter": {
+    "defaultMessage": "Enter",
+    "description": "Spoken name of the Enter or Return key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.escape": {
+    "defaultMessage": "Escape",
+    "description": "Spoken name of the Escape key in a keyboard shortcut's accessible name. Also used for the esc alias."
+  },
+  "@astryx.kbd.key.escapeShort": {
+    "defaultMessage": "Esc",
+    "description": "Abbreviated visible label of the Escape keycap. Also used for the esc alias."
+  },
+  "@astryx.kbd.key.left": {
+    "defaultMessage": "Left arrow",
+    "description": "Spoken name of the left arrow key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.plus": {
+    "defaultMessage": "Plus",
+    "description": "Spoken name of the literal plus key in a keyboard shortcut's accessible name, distinct from the separator between keys."
+  },
+  "@astryx.kbd.key.right": {
+    "defaultMessage": "Right arrow",
+    "description": "Spoken name of the right arrow key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.shift": {
+    "defaultMessage": "Shift",
+    "description": "Spoken name of the Shift modifier key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.tab": {
+    "defaultMessage": "Tab",
+    "description": "Spoken name of the Tab key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.key.up": {
+    "defaultMessage": "Up arrow",
+    "description": "Spoken name of the up arrow key in a keyboard shortcut's accessible name."
+  },
+  "@astryx.kbd.shortcut": {
+    "defaultMessage": "{shortcut} + {key}",
+    "description": "Combines spoken key names into one keyboard shortcut's accessible name. {shortcut} is the preceding keys and {key} is the next key's localized spoken name. Applied once for each key after the first; translators may change the separator or order."
+  },
   "@astryx.keyboardHint.toNavigate": {
     "defaultMessage": "to navigate",
     "description": "Trailing text in the keyboard-hint badge, shown after arrow-key icons — reads as `← → to navigate`. Lowercase sentence fragment completing the visual phrase; the badge is aria-hidden, so this is for sighted users only."
@@ -1599,6 +1679,58 @@
     "defaultMessage": "Removed {label}",
     "description": "Polite screen-reader announcement after a token is removed from a Tokenizer, by its × button or by Backspace. Live-region text, never shown on screen; `{label}` is the token's visible text."
   },
+  "@astryx.tokenizer.search": {
+    "defaultMessage": "Search {label}",
+    "description": "Accessible name of the search field at the top of a Tokenizer's bottom sheet (the touch presentation). `{label}` is the field's own label, e.g. `Search Tags`. Not shown on screen."
+  },
+  "@astryx.tokenizer.searchPlaceholder": {
+    "defaultMessage": "Search…",
+    "description": "Placeholder inside the search field at the top of a Tokenizer's bottom sheet, shown while the query is empty. Single word plus ellipsis."
+  },
+  "@astryx.tokenizer.noResultsDescription": {
+    "defaultMessage": "Try a different search.",
+    "description": "Supporting sentence under the no-results empty-state title inside a Tokenizer's bottom sheet, suggesting the person change the query."
+  },
+  "@astryx.tokenizer.create": {
+    "defaultMessage": "Create \"{value}\"",
+    "description": "Label of the create row inside a Tokenizer's bottom sheet when `hasCreate` is set and the typed text matches no existing item. `{value}` is the typed text, e.g. `Create \"Marketing\"`."
+  },
+  "@astryx.tokenizer.add": {
+    "defaultMessage": "Add",
+    "description": "Visible label of the button at the end of the create row inside a Tokenizer's bottom sheet; pressing it adds the typed text as a new token. Imperative verb; short."
+  },
+  "@astryx.tokenizer.addValue": {
+    "defaultMessage": "Add {value}",
+    "description": "Screen-reader-only name of the create row's Add button inside a Tokenizer's bottom sheet. `{value}` is the typed text, e.g. `Add Marketing`."
+  },
+  "@astryx.tokenizer.done": {
+    "defaultMessage": "Done",
+    "description": "Label of the primary footer button inside a Tokenizer's bottom sheet; pressing it closes the sheet. Selections are already applied, so this is not a confirm."
+  },
+  "@astryx.tokenizer.clearAllTitle": {
+    "defaultMessage": "Clear all selected items?",
+    "description": "Title of the confirmation dialog shown when the person presses Clear all inside a Tokenizer's bottom sheet. A question."
+  },
+  "@astryx.tokenizer.clearAllDescription": {
+    "defaultMessage": "This removes all selected items from {label}.",
+    "description": "Body of the Clear all confirmation dialog inside a Tokenizer's bottom sheet. `{label}` is the field's own label, e.g. `This removes all selected items from Tags.`"
+  },
+  "@astryx.tokenizer.nothingToClear": {
+    "defaultMessage": "Nothing selected",
+    "description": "Tooltip on the disabled Clear all action in a Tokenizer's bottom sheet while no item is selected; keeps the action focusable and says why it does nothing."
+  },
+  "@astryx.tokenizer.allRemoved": {
+    "defaultMessage": "All items removed",
+    "description": "Polite screen-reader announcement after a confirmed Clear all in a Tokenizer's bottom sheet has removed every selected item. Live-region text, never shown on screen."
+  },
+  "@astryx.tokenizer.selectedCount": {
+    "defaultMessage": "{count, number} selected",
+    "description": "Screen-reader-only lead-in of the description on a Tokenizer's bottom-sheet trigger (the touch presentation), followed by the selected token labels. `{count}` is how many tokens are selected, e.g. `2 selected`. Not shown on screen."
+  },
+  "@astryx.tokenizer.clearSelection": {
+    "defaultMessage": "Clear selection",
+    "description": "Label of the destructive action button in the Clear all confirmation dialog inside a Tokenizer's bottom sheet. Imperative verb phrase; confirms removing every token."
+  },
   "@astryx.lightbox.imagePosition": {
     "defaultMessage": "Image {index, number} of {total, number}",
     "description": "Polite screen-reader announcement when a Lightbox moves to a media item that has no alt text. Live-region text, never shown on screen; `{index}` is 1-based, example: `Image 3 of 12`."

package/locales/es-ES.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Sin resultados para {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Cargando",

package/locales/fi-FI.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Ei tuloksia haulle {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Ladataan",

package/locales/fr-FR.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Aucun résultat pour {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Chargement",

package/locales/he-IL.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "אין תוצאות עבור {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "טוען",

package/locales/hu-HU.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Nincs találat erre: {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Betöltés",

package/locales/it-IT.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Nessun risultato per {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Caricamento",

package/locales/ja-JP.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "{query} の結果がありません",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "読み込み中",

package/locales/ko-KR.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "{query}에 대한 결과 없음",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "로드 중",

package/locales/nl-NL.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Geen resultaten voor {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Laden",

package/locales/no-NO.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Ingen resultater for {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Laster",

package/locales/pl-PL.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Brak wyników dla {query}",
-    "description": "Screen-reader-only announcement when a CommandPalette query matches nothing. `{query}` is the user's verbatim search text; keep it last if your language allows so truncation-by-AT still conveys the outcome."
+    "description": "Not read by any component: CommandPalette announces its rendered empty-search message (`emptySearchText`) instead. Formerly the screen-reader-only announcement when a query matched nothing; `{query}` was the user's verbatim search text."
   },
   "@astryx.commandPalette.loading": {
     "defaultMessage": "Ładowanie",