@cssints/apg-specs 0.18.0 → 0.20.0

package/dist/apg/menu-button.bridge.d.mts

@@ -6,11 +6,9 @@ import { ActionStep, Probe, ScenarioConfig, SpecBridge } from "../scenario.mjs";
  * cannot model a menu longer than four); the labels never reach the model.
  *
  * The spec's `menuOpen` axis is its own controlled contract (`controlled` /
- * `accepts` / `value`), separate from `createMenu`'s packed checked `value`.
- * `createMenu`'s open state is still uncontrolled, so the differential walk
- * stays uncontrolled and `setValue` / `hostToggle` are inert on both sides; the
- * controlled vocabulary is accepted here only so a scenario carrying it is
- * modelled instead of silently dropped (see the menu-button DIVERGENCES).
+ * `accepts` / `value`), and `createMenu`'s `open` pair implements it: the walk
+ * runs it uncontrolled, accepting, holding and controlled-open, and `setValue` /
+ * `hostToggle` are the host writing its own copy.
  */
 export interface MenuButtonConfig {
   readonly items: ReadonlyArray<string>;

package/dist/apg/menu-button.model.json

@@ -1,6 +1,6 @@
 {
   "generatedFrom": "../../specs/apg/menu-button.qnt",
-  "specHash": "f7bae37e4eea0a7fed07c26085f022035ad1d13c0802bfa3f43dc734251bc3cf",
+  "specHash": "8636cd7e8489abe537f78fcdfd70fef48666a438e85da14e781d9e13aec55014",
   "module": "apg_menu_button",
   "vars": [
     {
@@ -5159,8 +5159,28 @@
             "opcode": "ite",
             "args": [
               {
-                "kind": "name",
-                "name": "controlled"
+                "kind": "app",
+                "opcode": "and",
+                "args": [
+                  {
+                    "kind": "name",
+                    "name": "controlled"
+                  },
+                  {
+                    "kind": "app",
+                    "opcode": "neq",
+                    "args": [
+                      {
+                        "kind": "name",
+                        "name": "v"
+                      },
+                      {
+                        "kind": "name",
+                        "name": "menuOpen"
+                      }
+                    ]
+                  }
+                ]
               },
               {
                 "kind": "app",
@@ -5194,8 +5214,28 @@
             "opcode": "ite",
             "args": [
               {
-                "kind": "name",
-                "name": "controlled"
+                "kind": "app",
+                "opcode": "and",
+                "args": [
+                  {
+                    "kind": "name",
+                    "name": "controlled"
+                  },
+                  {
+                    "kind": "app",
+                    "opcode": "neq",
+                    "args": [
+                      {
+                        "kind": "name",
+                        "name": "v"
+                      },
+                      {
+                        "kind": "name",
+                        "name": "menuOpen"
+                      }
+                    ]
+                  }
+                ]
               },
               {
                 "kind": "app",

package/dist/apg/slider.model.json

@@ -1,6 +1,6 @@
 {
   "generatedFrom": "../../specs/apg/slider.qnt",
-  "specHash": "189f136f0b8c0e2ab5d6f3dc6145065fac2e2d0f97d2b54b720af8d8f390e635",
+  "specHash": "7f8cabe937ca10920c10b5bda488a1ab01e76b75b8ffc8ae61a4abf8d0c8131d",
   "module": "apg_slider",
   "vars": [
     {

package/dist/apg/spinbutton.model.json

@@ -1,6 +1,6 @@
 {
   "generatedFrom": "../../specs/apg/spinbutton.qnt",
-  "specHash": "19c6cf077a7017c6cb2df08b2ff6749bed9f75056e77a5f7084b393967cca18f",
+  "specHash": "2cec7069c44874e465cbdf1a751fa272ff8272be19d3bc84ab2edc5574673e3a",
   "module": "apg_spinbutton",
   "vars": [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cssints/apg-specs",
-  "version": "0.18.0",
+  "version": "0.20.0",
   "description": "APG widget specs: Quint sources, generated models, scenario bridges and ported scenario sets, the test oracle of headless widgets",
   "license": "MIT",
   "repository": {

package/specs/apg/menu-button.qnt

@@ -24,7 +24,9 @@
 //   controlled, accepts the host answers with the same value (`accepting`): the
 //                       transition commits through the controlled value
 // `valueProp` is the only thing that changes `menuOpen` while `controlled`;
-// `setValue` / `hostToggle` are the host writing it. `control` / `acceptRequests`
+// `setValue` / `hostToggle` are the host writing it, and a write that changes it
+// takes the focus with it (a write of the value it already has is unobservable
+// and moves no focus). `control` / `acceptRequests`
 // are configuration events (init is literal-only). A rejected request reverts
 // the *whole* transition (focus included), so the ARIA invariants still hold.
 //
@@ -272,12 +274,15 @@ module apg_menu_button {
     }
   }
 
-  // commit: the host writes the controlled open state (a no-op while uncontrolled)
+  // commit: the host writes the controlled open state (a no-op while uncontrolled).
+  // A controlled host writing the value it already has is unobservable to the
+  // widget (nothing changes, so nothing notifies), so it moves no focus: only a
+  // write that changes the open state takes the focus with it.
   action setValue = {
     nondet v = Set(true, false).oneOf()
     all {
-      focusLevel' = if (controlled) (if (v) 2 else 1) else focusLevel,
-      focusIdx' = if (controlled) (if (v) 1 else 0) else focusIdx,
+      focusLevel' = if (and(controlled, v != menuOpen)) (if (v) 2 else 1) else focusLevel,
+      focusIdx' = if (and(controlled, v != menuOpen)) (if (v) 1 else 0) else focusIdx,
       menuOpen' = if (controlled) v else menuOpen,
       lastActivated' = lastActivated,
       controlled' = controlled,

package/specs/apg/slider.qnt

@@ -45,10 +45,15 @@
 //     press always land on the grid.
 //   - Dragging (pointer capture, move events): only a discrete pointer
 //     "press at value" is modelled, snapped to the step grid and clamped.
-//   - Disabled / read-only, touch assistive-technology key synthesis, and
-//     aria-valuetext formatting (units, locale): a real widget formats the text
-//     from its own value; the spec only fixes WHEN the text is derived (always,
-//     from valuenow).
+//   - Disabled / read-only: the primitive's widget-level `disabled` is a
+//     deliberate extension of the pattern, and the machine has no `disabled`
+//     var. So the model carries no invariant for it ("a disabled thumb drops
+//     every key and rail press and announces aria-disabled"); its oracle is the
+//     DOM test in `packages/headless/test/slider.browser.test.tsx`. Read-only is
+//     not offered at all.
+//   - Touch assistive-technology key synthesis, and aria-valuetext formatting
+//     (units, locale): a real widget formats the text from its own value; the
+//     spec only fixes WHEN the text is derived (always, from valuenow).
 //   - The range (0..10) is fixed; `configure` varies step, large step and the
 //     starting value. The bridge rejects a config outside the variant table.
 module apg_slider {

package/specs/apg/spinbutton.qnt

@@ -49,6 +49,12 @@
 //     is replaced wholesale by a sample text.
 //   - the commit/revert policy (Enter/Escape/blur) is a widely used
 //     convention, not APG text; so is the buttons' aria-disabled-at-bound.
+//   - a widget-level `disabled`: a deliberate extension of the pattern, not
+//     modelled. The machine's only disabled state is the steppers' at-bound
+//     one (`DisabledOnlyAtBound`); it has no `disabled` var, so it cannot say
+//     "while disabled, keys, typing and both steppers change nothing and both
+//     steppers announce aria-disabled". The DOM test in
+//     `packages/headless/test/spinbutton.browser.test.tsx` is its oracle.
 //   - press-and-hold auto-repeat on the buttons, mouse wheel.
 //
 // Generator notes: no action preconditions (guards live in the assignment