@astryxdesign/core 0.7.5-canary.fccd771 → 0.7.5

package/locales/pseudo.json

@@ -293,6 +293,9 @@
   "@astryx.chat.pastedText.expand": {
     "defaultMessage": "⟦Éẋþàñð⟧"
   },
+  "@astryx.chat.pastedText.label": {
+    "defaultMessage": "⟦{lines, plural, =1 {{chars, plural, other {{chars} chars}}} other {{lines} lines, {chars, plural, other {{chars} chars}}}}⟧"
+  },
   "@astryx.checkboxList.item.checkbox": {
     "defaultMessage": "⟦Çĥéçķƀóẋ⟧"
   },
@@ -965,6 +968,15 @@
   "@astryx.fileInput.fileSelected": {
     "defaultMessage": "⟦1 ƒíłé šéłéçţéð: {fileName}⟧"
   },
+  "@astryx.fileInput.fileSize.bytes": {
+    "defaultMessage": "⟦{size, number, ::group-off} Ɓ⟧"
+  },
+  "@astryx.fileInput.fileSize.kilobytes": {
+    "defaultMessage": "⟦{size, number, :: .0 group-off} ĶƁ⟧"
+  },
+  "@astryx.fileInput.fileSize.megabytes": {
+    "defaultMessage": "⟦{size, number, :: .0 group-off} ṀƁ⟧"
+  },
   "@astryx.fileInput.filesSelected": {
     "defaultMessage": "⟦{count} ƒíłéš šéłéçţéð⟧"
   },
@@ -980,6 +992,54 @@
   "@astryx.fileInput.triggerWithFiles": {
     "defaultMessage": "⟦{label}, {fileNames}⟧"
   },
+  "@astryx.kbd.key.alt": {
+    "defaultMessage": "⟦Àłţ⟧"
+  },
+  "@astryx.kbd.key.backspace": {
+    "defaultMessage": "⟦Ɓàçķšþàçé⟧"
+  },
+  "@astryx.kbd.key.command": {
+    "defaultMessage": "⟦Çóɱɱàñð⟧"
+  },
+  "@astryx.kbd.key.control": {
+    "defaultMessage": "⟦Çóñţřół⟧"
+  },
+  "@astryx.kbd.key.controlShort": {
+    "defaultMessage": "⟦Çţřł⟧"
+  },
+  "@astryx.kbd.key.down": {
+    "defaultMessage": "⟦Ðóŵñ àřřóŵ⟧"
+  },
+  "@astryx.kbd.key.enter": {
+    "defaultMessage": "⟦Éñţéř⟧"
+  },
+  "@astryx.kbd.key.escape": {
+    "defaultMessage": "⟦Éšçàþé⟧"
+  },
+  "@astryx.kbd.key.escapeShort": {
+    "defaultMessage": "⟦Éšç⟧"
+  },
+  "@astryx.kbd.key.left": {
+    "defaultMessage": "⟦Łéƒţ àřřóŵ⟧"
+  },
+  "@astryx.kbd.key.plus": {
+    "defaultMessage": "⟦Þłúš⟧"
+  },
+  "@astryx.kbd.key.right": {
+    "defaultMessage": "⟦Říĝĥţ àřřóŵ⟧"
+  },
+  "@astryx.kbd.key.shift": {
+    "defaultMessage": "⟦Šĥíƒţ⟧"
+  },
+  "@astryx.kbd.key.tab": {
+    "defaultMessage": "⟦Ţàƀ⟧"
+  },
+  "@astryx.kbd.key.up": {
+    "defaultMessage": "⟦Úþ àřřóŵ⟧"
+  },
+  "@astryx.kbd.shortcut": {
+    "defaultMessage": "⟦{shortcut} + {key}⟧"
+  },
   "@astryx.keyboardHint.toNavigate": {
     "defaultMessage": "⟦ţó ñàṽíĝàţé⟧"
   },
@@ -1199,6 +1259,45 @@
   "@astryx.tokenizer.tokenRemoved": {
     "defaultMessage": "⟦Řéɱóṽéð {label}⟧"
   },
+  "@astryx.tokenizer.search": {
+    "defaultMessage": "⟦Šéàřçĥ {label}⟧"
+  },
+  "@astryx.tokenizer.searchPlaceholder": {
+    "defaultMessage": "⟦Šéàřçĥ…⟧"
+  },
+  "@astryx.tokenizer.noResultsDescription": {
+    "defaultMessage": "⟦Ţřý à ð탃éřéñţ šéàřçĥ.⟧"
+  },
+  "@astryx.tokenizer.create": {
+    "defaultMessage": "⟦Çřéàţé \"{value}\"⟧"
+  },
+  "@astryx.tokenizer.add": {
+    "defaultMessage": "⟦Àðð⟧"
+  },
+  "@astryx.tokenizer.addValue": {
+    "defaultMessage": "⟦Àðð {value}⟧"
+  },
+  "@astryx.tokenizer.done": {
+    "defaultMessage": "⟦Ðóñé⟧"
+  },
+  "@astryx.tokenizer.clearAllTitle": {
+    "defaultMessage": "⟦Çłéàř àłł šéłéçţéð íţéɱš?⟧"
+  },
+  "@astryx.tokenizer.clearAllDescription": {
+    "defaultMessage": "⟦Ţĥíš řéɱóṽéš àłł šéłéçţéð íţéɱš ƒřóɱ {label}.⟧"
+  },
+  "@astryx.tokenizer.nothingToClear": {
+    "defaultMessage": "⟦Ñóţĥíñĝ šéłéçţéð⟧"
+  },
+  "@astryx.tokenizer.allRemoved": {
+    "defaultMessage": "⟦Àłł íţéɱš řéɱóṽéð⟧"
+  },
+  "@astryx.tokenizer.selectedCount": {
+    "defaultMessage": "⟦{count, number} šéłéçţéð⟧"
+  },
+  "@astryx.tokenizer.clearSelection": {
+    "defaultMessage": "⟦Çłéàř šéłéçţíóñ⟧"
+  },
   "@astryx.lightbox.imagePosition": {
     "defaultMessage": "⟦Íɱàĝé {index, number} óƒ {total, number}⟧"
   },

package/locales/pt-BR.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Nenhum resultado 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": "Carregando",

package/locales/pt-PT.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Sem 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": "A carregar",

package/locales/ro-RO.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Niciun rezultat pentru {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": "Se încarcă",

package/locales/ru-RU.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/sr-SP.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/sv-SE.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Inga resultat 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": "Läser in",

package/locales/tr-TR.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "{query} için sonuç bulunamadı",
-    "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": "Yükleniyor",

package/locales/uk-UA.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/vi-VN.json

@@ -409,7 +409,7 @@
   },
   "@astryx.commandPalette.noResultsFor": {
     "defaultMessage": "Không có kết quả cho {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": "Đang tải",

package/locales/zh-CN.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/zh-TW.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/package.json

@@ -1,18 +1,18 @@
 {
   "name": "@astryxdesign/core",
-  "version": "0.7.5-canary.fccd771",
+  "version": "0.7.5",
   "displayName": "Astryx Core",
   "description": "The component library. Accessible, themeable React components with built-in spacing, dark mode, and StyleX styling.",
   "author": "Meta Open Source",
   "license": "MIT",
-  "homepage": "https://github.com/facebook/astryx#readme",
+  "homepage": "https://github.com/meta/astryx#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/facebook/astryx.git",
+    "url": "git+https://github.com/meta/astryx.git",
     "directory": "packages/core"
   },
   "bugs": {
-    "url": "https://github.com/facebook/astryx/issues"
+    "url": "https://github.com/meta/astryx/issues"
   },
   "keywords": [
     "astryx",
@@ -769,10 +769,65 @@
       "types": "./dist/Typeahead/utils.d.ts",
       "default": "./dist/Typeahead/utils.js"
     },
+    "./CodeBlock/languages/dockerfile": {
+      "source": "./src/CodeBlock/languages/dockerfile.ts",
+      "types": "./dist/CodeBlock/languages/dockerfile.d.ts",
+      "default": "./dist/CodeBlock/languages/dockerfile.js"
+    },
+    "./CodeBlock/languages/graphql": {
+      "source": "./src/CodeBlock/languages/graphql.ts",
+      "types": "./dist/CodeBlock/languages/graphql.d.ts",
+      "default": "./dist/CodeBlock/languages/graphql.js"
+    },
+    "./CodeBlock/languages/java": {
+      "source": "./src/CodeBlock/languages/java.ts",
+      "types": "./dist/CodeBlock/languages/java.d.ts",
+      "default": "./dist/CodeBlock/languages/java.js"
+    },
+    "./CodeBlock/languages/lua": {
+      "source": "./src/CodeBlock/languages/lua.ts",
+      "types": "./dist/CodeBlock/languages/lua.d.ts",
+      "default": "./dist/CodeBlock/languages/lua.js"
+    },
+    "./CodeBlock/languages/objective-c": {
+      "source": "./src/CodeBlock/languages/objective-c.ts",
+      "types": "./dist/CodeBlock/languages/objective-c.d.ts",
+      "default": "./dist/CodeBlock/languages/objective-c.js"
+    },
+    "./CodeBlock/languages/powershell": {
+      "source": "./src/CodeBlock/languages/powershell.ts",
+      "types": "./dist/CodeBlock/languages/powershell.d.ts",
+      "default": "./dist/CodeBlock/languages/powershell.js"
+    },
+    "./CodeBlock/languages/ruby": {
+      "source": "./src/CodeBlock/languages/ruby.ts",
+      "types": "./dist/CodeBlock/languages/ruby.d.ts",
+      "default": "./dist/CodeBlock/languages/ruby.js"
+    },
+    "./CodeBlock/languages/thrift": {
+      "source": "./src/CodeBlock/languages/thrift.ts",
+      "types": "./dist/CodeBlock/languages/thrift.d.ts",
+      "default": "./dist/CodeBlock/languages/thrift.js"
+    },
+    "./CodeBlock/languages/toml": {
+      "source": "./src/CodeBlock/languages/toml.ts",
+      "types": "./dist/CodeBlock/languages/toml.d.ts",
+      "default": "./dist/CodeBlock/languages/toml.js"
+    },
     "./Markdown/remark": {
       "source": "./src/Markdown/remark.ts",
       "types": "./dist/Markdown/remark.d.ts",
       "default": "./dist/Markdown/remark.js"
+    },
+    "./internal/touch": {
+      "source": "./src/internal/touch.ts",
+      "types": "./dist/internal/touch.d.ts",
+      "default": "./dist/internal/touch.js"
+    },
+    "./internal/tokenizer-presentation": {
+      "source": "./src/internal/tokenizer-presentation.ts",
+      "types": "./dist/internal/tokenizer-presentation.d.ts",
+      "default": "./dist/internal/tokenizer-presentation.js"
     }
   },
   "files": [
@@ -792,8 +847,6 @@
     "react-dom": ">=19.0.0"
   },
   "devDependencies": {
-    "@astryxdesign/a11y-spec": "0.7.5-canary.fccd771",
-    "@astryxdesign/cli": "0.7.5-canary.fccd771",
     "@babel/cli": "^7.29.7",
     "@babel/core": "^7.29.7",
     "@babel/preset-react": "^7.29.7",
@@ -804,7 +857,9 @@
     "@testing-library/jest-dom": "^6.6.0",
     "@testing-library/react": "^16.3.2",
     "@types/babel__core": "^7.20.5",
-    "tailwindcss": "^4.3.2"
+    "tailwindcss": "^4.3.2",
+    "@astryxdesign/cli": "0.7.5",
+    "@astryxdesign/a11y-spec": "0.0.0"
   },
   "dependencies": {
     "intl-messageformat": "^11.2.9"
@@ -821,6 +876,6 @@
     "test:watch": "vitest --root ../..",
     "lint": "eslint src",
     "typecheck:docs": "tsc --project tsconfig.docs.json",
-    "typecheck": "tsc --project tsconfig.json --noEmit"
+    "typecheck": "tsc --project tsconfig.json --noEmit && pnpm typecheck:docs"
   }
 }

package/src/AlertDialog/AlertDialog.spec.md

@@ -19,7 +19,7 @@ verified_by:
   ]
 modules: []
 families: [family:overlay-dismissal]
-design_specs: []
+design_specs: [design:reduced-motion]
 architecture:
   [
     architecture:public-component-api,
@@ -27,22 +27,29 @@ architecture:
     architecture:layer-runtime,
   ]
 contributing: []
-system_specs: [spec:AST-020/FR15]
+system_specs:
+  [
+    spec:AST-020/FR15,
+    spec:AST-094/FR4,
+    spec:AST-094/FR13,
+    spec:AST-094/FR35,
+    spec:AST-094/DEC-15,
+  ]
 ---
 
 # AlertDialog component contract
 
 ## Contract at a glance
 
-| Area                    | Contract                                                                                                                                                                                                                                                                                                             |
-| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Public contract         | None changes. `AlertDialog`, `AlertDialogProps`, and `useImperativeAlertDialog` are exported from `@astryxdesign/core/AlertDialog`; `title`, `description`, `actionLabel`, `onAction`, and `onOpenChange` are required with `isOpen`, plus cancel label, action variant, loading, width, and an inline preview mode. |
-| Behavior                | A modal confirmation that interrupts: it opens through the native dialog, cannot be dismissed by a click outside, closes on Escape or Cancel through `onOpenChange(false)`, and runs `onAction` on the action button.                                                                                                |
-| End-user impact         | A keyboard or screen-reader user is told a decision is needed (the title and description are announced), lands on Cancel, and cannot lose the dialog by clicking past it.                                                                                                                                            |
-| Builder impact          | None.                                                                                                                                                                                                                                                                                                                |
-| Compatibility/readiness | Released behavior as observed; this draft records it and adopts the APG Alert Dialog pattern (AR1) under `spec:AST-020/FR15`.                                                                                                                                                                                        |
-| Review checks           | Reject a modal AlertDialog without `role="alertdialog"`, a title or description not linked by id, initial focus on the destructive action, or a backdrop click that dismisses it.                                                                                                                                    |
-| Governing rules         | `architecture:public-component-api/INV1,INV5–INV8`; `architecture:component-theming-surface/INV3–INV7`; `architecture:layer-runtime`; `component:Dialog/AR1–AR3`; `spec:AST-020/FR15`.                                                                                                                               |
+| Area                    | Contract                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Public contract         | None changes. `AlertDialog`, `AlertDialogProps`, and `useImperativeAlertDialog` are exported from `@astryxdesign/core/AlertDialog`; `title`, `description`, `actionLabel`, `onAction`, and `onOpenChange` are required with `isOpen`, plus cancel label, action variant, loading, width, and an inline preview mode.                                                                                                                                   |
+| Behavior                | A modal confirmation that interrupts: it opens through the native dialog, cannot be dismissed by a click outside, closes on Escape or Cancel through `onOpenChange(false)`, and runs `onAction` on the action button.                                                                                                                                                                                                                                  |
+| End-user impact         | A keyboard or screen-reader user is told a decision is needed (the title and description are announced), lands on Cancel, and cannot lose the dialog by clicking past it. On a touch screen the alert scales in and fades out as iOS's does and ignores taps while it enters (FR6, FR7), and on a phone it is 320 px wide (FR9); under every pointer, mouse included, a press that slides from Cancel to the action runs the action it lifts on (FR8). |
+| Builder impact          | A phone-width alert is 320 px unless the caller sets `width` (FR9); actions track a slide under every pointer (FR8).                                                                                                                                                                                                                                                                                                                                   |
+| Compatibility/readiness | Released behavior as observed; this draft records it and adopts the APG Alert Dialog pattern (AR1) under `spec:AST-020/FR15`. FR6–FR9 change shipped behavior and are specified, not implemented yet.                                                                                                                                                                                                                                                  |
+| Review checks           | Reject a modal AlertDialog without `role="alertdialog"`, a title or description not linked by id, initial focus on the destructive action, or a backdrop click that dismisses it.                                                                                                                                                                                                                                                                      |
+| Governing rules         | `architecture:public-component-api/INV1,INV5–INV8`; `architecture:component-theming-surface/INV3–INV7`; `architecture:layer-runtime`; `component:Dialog/AR1–AR3`; `spec:AST-020/FR15`; `spec:AST-094` FR4, FR13, FR35, DEC-15, DEC-17; `family:action-groups`; `design:reduced-motion`; `spec:AST-017`.                                                                                                                                                |
 
 This table is a review projection; the body below is authoritative.
 
@@ -55,9 +62,12 @@ confirmation without assembling it.
 
 ## Compatibility and migration
 
-- Released default preserved: `yes`
-- Compatibility class: additive documentation; runtime, DOM, styling, targets, and
-  public API are unchanged
+- Released default preserved: `no` under a touch presentation: the alert
+  presents and dismisses with FR6's motion, holds pointer input while it enters
+  (FR7), and is 320 px wide on a phone (FR9); its actions track a slide under
+  every pointer (FR8)
+- Compatibility class: nonbreaking behavior change; no public API, DOM, or
+  target change
 - Controlled/uncontrolled behavior: unchanged — `isOpen` with `onOpenChange` is
   controlled; `useImperativeAlertDialog` owns that pair for a caller that wants
   `show`/`hide`
@@ -74,9 +84,12 @@ Consumer migration instructions belong in consumer docs and release notes.
 - The alert-dialog role, its name and description links, and the least-destructive
   initial focus.
 - The imperative wrapper hook.
+- The touch presentation's motion, input hold, and phone width (FR6, FR7, FR9).
 
 **Does not own / non-goals**
 
+- A press that slides across the actions acts on the lifted one, as
+  `family:action-groups` owns (FR8).
 - Modal presentation, focus return, backdrop, and dismissal mechanics — owned by
   `component:Dialog` and `architecture:layer-runtime`.
 - Button variants and loading — owned by `component:Button`.
@@ -93,13 +106,17 @@ Consumer migration instructions belong in consumer docs and release notes.
 Draft requirements identify their basis so observed code is not mistaken for an
 intentional decision. A `current` contract contains no unresolved rows.
 
-| ID  | Candidate invariant                                                                                                                                                                                                                               | Basis                                                                            | Draft review state |
-| --- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------ |
-| FR1 | A modal AlertDialog opens through Dialog's native modal path and a click on the backdrop does not dismiss it.                                                                                                                                     | shipped source (`purpose="form"`); Alert Dialog accessibility contract (pending) | verify             |
-| FR2 | Escape and the Cancel button both call `onOpenChange(false)`; the action button calls `onAction` and leaves closing to the caller.                                                                                                                | shipped source and focused tests                                                 | verify             |
-| FR3 | The anatomy is title, description, then the buttons: Cancel then action on wider screens, the action stacked above Cancel on small screens, Cancel keeping initial focus either way; the action may show a loading state while `isActionLoading`. | shipped source and focused tests                                                 | verify             |
-| FR4 | `isInline` renders the same anatomy without modality and without the alert-dialog role.                                                                                                                                                           | shipped source and public docs                                                   | verify             |
-| FR5 | `useImperativeAlertDialog` returns `show`, `hide`, and the element to render, and owns `isOpen`/`onOpenChange` for its caller.                                                                                                                    | shipped source and focused tests                                                 | verify             |
+| ID  | Candidate invariant                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Basis                                                                            | Draft review state |
+| --- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------ |
+| FR1 | A modal AlertDialog opens through Dialog's native modal path and a click on the backdrop does not dismiss it.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | shipped source (`purpose="form"`); Alert Dialog accessibility contract (pending) | verify             |
+| FR2 | Escape and the Cancel button both call `onOpenChange(false)`; the action button calls `onAction` and leaves closing to the caller.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | shipped source and focused tests                                                 | verify             |
+| FR3 | The anatomy is title, description, then the buttons: Cancel then action on wider screens, the action stacked above Cancel on small screens, Cancel keeping initial focus either way; the action may show a loading state while `isActionLoading`.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | shipped source and focused tests                                                 | verify             |
+| FR4 | `isInline` renders the same anatomy without modality and without the alert-dialog role.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | shipped source and public docs                                                   | verify             |
+| FR5 | `useImperativeAlertDialog` returns `show`, `hide`, and the element to render, and owns `isOpen`/`onOpenChange` for its caller.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | shipped source and focused tests                                                 | verify             |
+| FR6 | Under a touch presentation (`spec:AST-094` FR13), a modal AlertDialog presents by scaling from 1.2 to 1 with its opacity and its backdrop's dimming rising from 0 to 1 on the motion role `springs.alertPresent`, started at the browser's commit, with the larger start kept inside the viewport; it dismisses by a fade alone on `springs.alertDismiss` and closes at the fade's end; a close during the presentation, or a reopen during the dismissal, springs from where it is. The roles are internal, with UIKit's measured values at `tempo` 1 and `'standard'`, and follow the theme's motion knobs (`spec:AST-094` FR4, DEC-15). Under Reduce Motion both are the shared cross-fade (`design:reduced-motion` DR1–DR3). A fine primary pointer keeps today's motion (`spec:AST-094` FR13 and its Non-goals). | proposed from measured iOS 26.2 behavior                                         | decided            |
+| FR7 | Under a touch presentation, pointer input to the alert is held while it enters (`spec:AST-094` FR35); keyboard and assistive-technology input are never held, and the entrance never makes the content inert. While the alert leaves, its content is inert for the dismissal fade. The hold's timing stays internal (`spec:AST-002` FR3).                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | `spec:AST-094` FR35; owner decision (DEC-1)                                      | decided            |
+| FR8 | AlertDialog's actions are an action group (`family:action-groups`): a press that slides across them runs the action it lifts on, and a lift outside them runs nothing, under every pointer; keyboard and assistive-technology behavior is unchanged.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | `family:action-groups`; `spec:AST-094` DEC-17; DEC-3                             | decided            |
+| FR9 | On a phone, a compact window (`spec:AST-012` FR9: narrower than `md` or shorter than 500 px) under a coarse primary pointer, the alert is 320 px wide in every theme, as iOS's is; no theme role sets it. A caller's explicit `width` still wins there (`architecture:public-component-api` INV5), and Dialog's viewport clamp still applies on a screen narrower than the alert. Elsewhere it keeps today's width.                                                                                                                                                                                                                                                                                                                                                                                                   | owner decision (DEC-2)                                                           | decided            |
 
 ### Allowed variation
 
@@ -122,18 +139,24 @@ intentional decision. A `current` contract contains no unresolved rows.
 
 ### Performance and resources
 
-- **PR1 — Dialog-owned resources.** AlertDialog's only listener is the
-  small-screen media query behind the button order; Dialog owns the modal
+- **PR1 — Dialog-owned resources.** AlertDialog's listeners are the
+  small-screen media query behind the button order and the press tracking
+  `family:action-groups` FR5 gives its actions; Dialog owns the modal
   lifecycle.
 
+- **PR2 — The touch presentation adds no element.** The motion plays on the
+  dialog surface and its `::backdrop`; AlertDialog renders no extra element
+  under a touch presentation, within `spec:AST-017` FR60's open-layer
+  allowance (`architecture:component-style-authoring` INV7).
+
 ## Accessibility contract
 
 - **AR1 — AlertDialog adopts the APG Alert Dialog pattern** (`spec:AST-020/FR15`):
   the modal surface is `role="alertdialog"`, named by its title through
   `aria-labelledby` and described by its description through `aria-describedby`;
   it is modal through Dialog (focus enters it and returns to the opener on close
-  per `component:Dialog/AR1–AR2`; Tab containment follows Dialog, whose record
-  leaves it open); initial
+  per `component:Dialog/AR1–AR2`, and Tab wraps inside it per
+  `component:Dialog/FR7`); initial
   focus lands on Cancel, the least destructive action; Escape cancels; no click
   outside dismisses it. The inline preview is not an alert dialog and carries
   `role="group"`.
@@ -184,15 +207,46 @@ The dialog surface (the Dialog element AlertDialog renders) carries `alert-dialo
 
 ## Verification map
 
-| Contract | Verification                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Representative states                  | Mutation or failure expectation                                                                                  | Audit section                     |
-| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | --------------------------------- |
-| FR1–FR5  | `AlertDialog.test.tsx` ("calls onOpenChange(false) on Escape", "does not call onOpenChange when action is clicked", "does not call onAction on Escape", "does not disable the cancel button while the action is loading", "exposes a named group instead, with no aria-modal") and `useImperativeAlertDialog.test.tsx` ("opens on show()", "closes on hide()")                                                                                                                                                                                                                                                                                                             | open, loading, inline, imperative      | Escape not cancelling, the action closing by itself, or the inline path claiming the role fails.                 | `audit:AlertDialog/behavior`      |
-| AR1      | `AlertDialog.test.tsx` ("renders with alertdialog role", "links title via aria-labelledby", "links description via aria-describedby", "marks cancel as the initial focus target", "keeps the initial focus target on the least destructive action", "calls onOpenChange(false) on Escape", "stacks long destructive action labels above cancel on a narrow fine-pointer screen", "reaches both buttons by Tab, cancel first", "is a modal alertdialog", "does not claim the alertdialog role") and `useImperativeAlertDialog.test.tsx`; the no-backdrop-dismiss outcome and focus delegation under the Alert Dialog accessibility contract (`internal/a11y-spec`, pending) | open modal; after Escape; after Cancel | The role, name link, description link, or Cancel initial focus is lost, or a click outside dismisses the dialog. | `audit:AlertDialog/accessibility` |
+| Contract | Verification                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Representative states                                                                                                                                                                                                 | Mutation or failure expectation                                                                                                                                                                                                                                | Audit section                     |
+| -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
+| FR1–FR5  | `AlertDialog.test.tsx` ("calls onOpenChange(false) on Escape", "does not call onOpenChange when action is clicked", "does not call onAction on Escape", "does not disable the cancel button while the action is loading", "exposes a named group instead, with no aria-modal") and `useImperativeAlertDialog.test.tsx` ("opens on show()", "closes on hide()")                                                                                                                                                                                                                                                                                                             | open, loading, inline, imperative                                                                                                                                                                                     | Escape not cancelling, the action closing by itself, or the inline path claiming the role fails.                                                                                                                                                               | `audit:AlertDialog/behavior`      |
+| FR6, PR2 | Browser tests under a coarse pointer in Chromium and WebKit, a spring-curve oracle, a busy-main-thread case, and real-device clips on iOS Safari and Android Chrome                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | present, dismiss, close during present, reopen during dismiss, Reduce Motion, a fine pointer, a narrow viewport                                                                                                       | a curve off its role, a start outside the viewport, a jump on interruption, a scale under Reduce Motion, changed motion under a fine pointer, or an added element fails                                                                                        | `audit:AlertDialog/behavior`      |
+| FR7      | Browser tests under a coarse pointer, with keyboard and assistive-technology input                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | a tap during the presentation, Enter and Escape during it, a screen reader's activation, a tap during the dismissal; a mouse click during the presentation under a fine pointer                                       | a held key or assistive-technology action, content made inert during the entrance, a tap that reaches a leaving alert, or a mouse click held under a fine pointer fails                                                                                        | `audit:AlertDialog/behavior`      |
+| FR8      | Pointer-stream tests with a mouse, a pen, and a finger, and keyboard tests                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | a press on Cancel slid onto the action and lifted, and a press lifted outside the actions, each with a mouse, a pen, and a finger; Enter and Space on each action                                                     | the press-start action running after a slide, any action running on a lift outside, or a changed keyboard or assistive-technology activation fails                                                                                                             | `audit:AlertDialog/behavior`      |
+| FR9      | Browser tests at a phone width and at a desktop width, in the default and an alternate theme                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | a phone width and a desktop width, in the default and an alternate theme; a caller `width` at a phone width; a screen narrower than 320 px; a narrow window under a fine pointer; a coarse screen that is not compact | a phone-width alert other than 320 px in any theme without a caller `width`, a caller `width` overridden, a desktop width changed, an alert wider than the viewport, or a 320 px alert in a narrow fine-pointer window or on a non-compact coarse screen fails | `audit:AlertDialog/behavior`      |
+| AR1      | `AlertDialog.test.tsx` ("renders with alertdialog role", "links title via aria-labelledby", "links description via aria-describedby", "marks cancel as the initial focus target", "keeps the initial focus target on the least destructive action", "calls onOpenChange(false) on Escape", "stacks long destructive action labels above cancel on a narrow fine-pointer screen", "reaches both buttons by Tab, cancel first", "is a modal alertdialog", "does not claim the alertdialog role") and `useImperativeAlertDialog.test.tsx`; the no-backdrop-dismiss outcome and focus delegation under the Alert Dialog accessibility contract (`internal/a11y-spec`, pending) | open modal; after Escape; after Cancel                                                                                                                                                                                | The role, name link, description link, or Cancel initial focus is lost, or a click outside dismisses the dialog.                                                                                                                                               | `audit:AlertDialog/accessibility` |
 
 ## Decision log
 
-None. This draft records shipped behavior; the Alert Dialog adoption follows the
-system rule rather than a component-local decision.
+### DEC-1 — An alert holds pointer input while it enters
+
+**Reference:** `component:AlertDialog/DEC-1`
+**Decider:** `cixzhang`, `2026-10-26`
+
+An alert follows every touch presentation's entrance hold (`spec:AST-094`
+FR35): pointer input only, never keyboard or assistive technology, and its
+content is inert only while it fades out.
+
+### DEC-2 — On a phone an alert is 320 px wide in every theme
+
+**Reference:** `component:AlertDialog/DEC-2`
+**Decider:** `cixzhang`, `2026-10-26`
+
+A phone-width alert matches iOS's 320 px in every theme, so it reads as a
+system alert; a theme role for it is not added.
+
+Rejected: a general compact-dialog width theme role.
+
+### DEC-3 — An alert's actions are an action group
+
+**Reference:** `component:AlertDialog/DEC-3`
+**Decider:** `cixzhang`, `2026-10-26`
+
+A press that slides from Cancel to the action runs the action it lifts on, as
+in every group of sibling actions (`spec:AST-094` DEC-17), so an alert's two
+buttons behave like a button group under every pointer.
+
+Rejected: keeping each action's activation on the browser's click alone.
 
 ## Open questions
 

package/src/AlertDialog/AlertDialog.tsx

@@ -30,7 +30,7 @@ import type {BaseProps} from '../BaseProps';
 import {mergeProps} from '../utils';
 import {themeProps} from '../utils/themeProps';
 import {useTranslator} from '../i18n';
-import {useMediaQuery} from '../hooks';
+import {useMediaQuery} from '../hooks/useMediaQuery';
 
 const SMALL_SCREEN_QUERY = '(max-width: 640px)';
 

package/src/AlertDialog/__tests__/AlertDialog.a11y.chromium.spec.ts

@@ -1,4 +1,5 @@
 // Copyright (c) Meta Platforms, Inc. and affiliates.
+// @pr-a11y scope ^(internal/a11y-spec/src/patterns/alert-dialog|internal/a11y-spec/src/harness|packages/core/src/AlertDialog/|packages/core/src/Dialog/|apps/storybook/stories/AlertDialogA11y)
 
 /**
  * @file AlertDialog.a11y.chromium.spec.ts