An open source design system that's fully customizable and agent ready
TypeScript
docs: keep ToggleButton contracts implementation-independent (#6467)
Cindy Zhang82eeea2a7848
diff --git a/docs/families/buttons.md b/docs/families/buttons.mdindex 39f752aba2..523afaccbf 100644--- a/docs/families/buttons.md+++ b/docs/families/buttons.md@@ -121,14 +121,12 @@ Membership follows public responsibility, not an import of Button or a rendereddistinct.- **FR5 — Callback and Action order is consistent.** Where a member exposes botha synchronous callback and an Action, the callback runs first. Preventing that- event prevents the Action. Standalone ToggleButton runs `onPressedChange` from- its internal `onClick` and delegates `pressedChangeAction` to Button's- `clickAction`. Button runs the callback before the Action and skips the Action- when the callback calls `preventDefault()`. The Action also runs when no callback- is supplied. Without `pressedChangeAction`, ToggleButton MUST leave `clickAction`- absent so callback-only activation starts no empty Action transition and reports- no Action-pending feedback. A fire-once action deduplicates activation while- pending; an explicitly interruptible persistent action may accept a new+ event prevents the Action. Standalone ToggleButton runs `onPressedChange`+ synchronously before `pressedChangeAction` and skips the Action when the callback+ calls `preventDefault()`. The Action also runs when no callback is supplied.+ Without `pressedChangeAction`, callback-only activation MUST remain synchronous+ and report no Action-pending feedback. A fire-once action deduplicates activation+ while pending; an explicitly interruptible persistent action may accept a newactivation and replace the in-flight intent.- **FR6 — Persistent state is explicit and reversible.** A ToggleButton MUSTexpose its effective state with `aria-pressed` and request the next controlled@@ -157,7 +155,8 @@ Membership follows public responsibility, not an import of Button or a renderedA ToggleButtonGroup member identified by `value` MUST derive pressed state andselection requests from the group, not its standalone `isPressed`,`onPressedChange`, or `pressedChangeAction`. Member `onPressedChange` and- `pressedChangeAction` are ignored, and Button's `clickAction` MUST be absent.+ `pressedChangeAction` are ignored. Member activation MUST NOT start a member+ Action or report member Action-pending feedback.- **FR12 — Connected and spaced groups stay distinct.** ButtonGroup's connectedpresentation removes inter-member gaps, shares outer edges, owns one elevation,and uses its documented roving-focus keyboard model. The currentdiff --git a/packages/core/src/ToggleButton/ToggleButton.doc.mjs b/packages/core/src/ToggleButton/ToggleButton.doc.mjsindex 1cf97b6e94..38512544be 100644--- a/packages/core/src/ToggleButton/ToggleButton.doc.mjs+++ b/packages/core/src/ToggleButton/ToggleButton.doc.mjs@@ -36,12 +36,12 @@ export const docs = {{name: 'onPressedChange',type: '(isPressed: boolean, event: MouseEvent) => void',- description: 'Called synchronously from the internal click handler when pressed state should change. Receives the next state and the click event; call event.preventDefault() to skip pressedChangeAction. Without an Action, the callback starts no Action transition. Ignored for a ToggleButtonGroup member with a value.',+ description: 'Called synchronously when pressed state should change. Receives the next state and the click event; call event.preventDefault() to skip pressedChangeAction. Without an Action, the callback produces no Action-pending feedback. Ignored for a ToggleButtonGroup member with a value.',},{name: 'pressedChangeAction',type: '(isPressed: boolean) => void | Promise<void>',- description: 'Action handler for API- or navigation-backed toggles, run through Button’s clickAction transition after the synchronous onPressedChange callback unless that callback calls event.preventDefault(). Works without onPressedChange. Shows an optimistic pressed state and a spinner while pending, and remains interruptible by re-clicks. Omit it for callback-only toggles with no Action transition. Ignored for a ToggleButtonGroup member with a value.',+ description: 'Action handler for API- or navigation-backed toggles, run in a transition after the synchronous onPressedChange callback unless that callback calls event.preventDefault(). Works without onPressedChange. Shows an optimistic pressed state and a spinner while pending, and remains interruptible by re-clicks. Omit it for callback-only toggles with no Action-pending feedback. Ignored for a ToggleButtonGroup member with a value.',},{name: 'size',