docs(components): stop teaching #6124's retired handler keys as authorable props

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });
 

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });
 

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });
 

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });
 

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });
 

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });
 

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });
 

.changeset/7340-docs-retired-handler-keys.md

@@ -0,0 +1,17 @@
+---
+---
+
+Docs-only: ten rows across eight `content/docs` pages still listed one of
+objectui#6124's 22 RETIRED `on*` handler keys as a callable prop, after PR
+#7339 turned those keys into `?: never` tombstones with named refusal arms on
+the zod mirror. Seven pages have the rows removed;
+`components/basic/button-group.mdx` keeps its `ButtonGroupButton.onClick` row
+spelled `never` with the node-type pointer, because
+`button-group-doc-surface-6347.test.ts` asserts set equality between that block
+and the mirror's `.shape` and a refusal arm is still a key of that shape. A new
+test-only pin
+(`packages/types/src/__tests__/component-docs-retired-handler-keys-7340.test.ts`)
+measures the retired population off `packages/types/src` and holds every doc row
+whose `(interface, key)` pair resolves to a tombstone to the `never` spelling,
+with six runtime-slot rows as the blanket-sweep control (objectui#7340). No
+published package behaviour changes.

content/docs/api/schema-reference.md

@@ -923,8 +923,6 @@ A drag-and-drop Kanban board with columns and cards.
 | `draggable` | `boolean` | Enable drag-and-drop between columns. |
 | `onCardMove` | `function` | Callback when a card is moved: `(cardId, fromColumn, toColumn, position)`. |
 | `onCardClick` | `function` | Callback when a card is clicked. |
-| `onColumnAdd` | `function` | Callback when a new column is added. |
-| `onCardAdd` | `function` | Callback when a new card is added to a column. |
 
 **Related:** [ObjectViewSchema](#objectviewschema), [ObjectGridSchema](#objectgridschema)
 

content/docs/components/basic/button-group.mdx

@@ -26,7 +26,8 @@ interface ButtonGroupButton {
  variant?: 'default' | 'secondary' | 'destructive' | 'outline' | 'ghost' | 'link';
  size?: 'default' | 'sm' | 'lg' | 'icon';
  disabled?: boolean; // Whether this button is disabled
- onClick?: () => void; // Runtime handler; not authorable in JSON
+ onClick?: never; // RETIRED (objectui#6124) — author behaviour
+ // as a node type, e.g. an action:button node
  className?: string; // Per-button CSS class
 }
 

content/docs/components/data-display/tree-view.mdx

@@ -43,9 +43,7 @@ interface TreeViewSchema {
  showLines?: boolean; // Show connecting lines (default: true)
 
  // Events
- onSelectChange?: (selectedIds: string[]) => void; // Selection change handler
- onExpandChange?: (expandedIds: string[]) => void; // Expand change handler
- onNodeClick?: (node: TreeNode) => void; // Node click handler
+ onNodeClick?: (node: TreeNode) => void; // Node click handler
 
  // Styling
  className?: string; // Tailwind CSS classes

content/docs/components/form/calendar.mdx

@@ -38,9 +38,6 @@ interface CalendarSchema {
  maxDate?: Date | string; // Maximum selectable date
  disabled?: boolean | string; // boolean, or a predicate expression
 
- // Events
- onChange?: (date: Date | Date[] | undefined) => void; // Date change handler
-
  // Styling
  className?: string; // Tailwind CSS classes
 

content/docs/components/form/combobox.mdx

@@ -38,9 +38,6 @@ interface ComboboxSchema {
  // Text
  placeholder?: string; // Button placeholder
 
- // Events
- onChange?: (value: string) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

content/docs/components/form/command.mdx

@@ -37,9 +37,6 @@ interface CommandSchema {
  groups: CommandGroup[]; // Command groups
  emptyText?: string; // Text when no results
 
- // Events
- onChange?: (value: string) => void;
-
  // Styling
  className?: string;
 }

content/docs/components/form/input-otp.mdx

@@ -33,7 +33,6 @@ interface InputOTPSchema {
 
  // Events
  onChange?: (value: string) => void;
- onComplete?: (value: string) => void;
 
  // States
  disabled?: boolean | string; // boolean, or a predicate expression

content/docs/components/form/radio-group.mdx

@@ -46,9 +46,6 @@ interface RadioGroupSchema {
  // Layout
  orientation?: 'horizontal' | 'vertical';
 
- // Events
- onChange?: (value: string | number) => void;
-
  // States
  disabled?: boolean | string; // boolean, or a predicate expression
 

packages/types/src/__tests__/button-group-doc-surface-6347.test.ts

@@ -39,6 +39,17 @@
  * subset the card enumerated. A one-directional pin is what let the omissions
  * sit beside the corrections through two earlier passes over these pages.
  *
+ * ⚠️ `.onClick` is in that UNDER-stated list as HISTORY. objectui#6124 (PR
+ * #7339, ruling of 2026-08-30) RETIRED the key: the `button-group` renderer
+ * renders each `<Button>` without a click handler and never reads it, so the
+ * TypeScript face is now `onClick?: never` and the mirror member is a named
+ * refusal, `handlerKeyRefusal('onClick', 'retired', …)`. The page owes the row
+ * either way — a refusal arm is still a key of `.shape`, so the set equality
+ * above is what forced objectui#7340 to spell the row `never` on the page
+ * rather than delete it — but the row must no longer name a callable type.
+ * The `onClick` case below therefore reads the mirror's refusal instead of
+ * restating `() => void`.
+ *
  * ## The authority is the mirror's `.shape`, never parse acceptance
  *
  * `BaseSchema` is `.passthrough()` and carries `[key: string]: any`, so an
@@ -235,11 +246,18 @@ describe('button-group.mdx: the `ButtonGroupButton` block IS the shipped mirror
  expect(documentedLiterals(buttonDoc.get(key)?.typeText ?? '')).toEqual(shipped);
  });
 
- it('documents `onClick` as a runtime slot, not something a JSON author supplies', () => {
- // `onClick` is `() => void` / `z.function()`; objectui#4453 narrowed the
- // runtime to `typeof === 'function'`, so an authored object is dropped.
- expect(buttonDoc.get('onClick')?.typeText).toBe('() => void');
- expect(buttonBody).toContain('not authorable in JSON');
+ it('documents `onClick` as the RETIRED tombstone it now is (objectui#6124)', () => {
+ // Read off the mirror rather than restated: a `handlerKeyRefusal` arm
+ // refuses EVERY value, a function included, which is what distinguishes a
+ // retired key from the runtime slots that kept `z.function()`. If #6124 is
+ // ever reversed this goes red here — at `packages/types`, where the
+ // decision would live — instead of leaving the page silently understated.
+ expect(buttonShape.onClick.safeParse(() => undefined).success).toBe(false);
+ expect(buttonShape.onClick.safeParse('anything').success).toBe(false);
+ expect(buttonDoc.get('onClick')?.typeText).toBe('never');
+ expect(buttonBody).toContain('RETIRED');
+ // The remedy the tombstone JSDoc and the refusal message both point at.
+ expect(buttonBody).toContain('action:button');
  });
 });