@vizejs/ui 0.714.0 → 0.716.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (257) hide show
  1. package/dist/{accordion-B8xySJ9Z.mjs → accordion-DCZpHYPr.mjs} +1 -1
  2. package/dist/accordion.d.mts +1 -1
  3. package/dist/accordion.mjs +1 -1
  4. package/dist/{action-sheet-CTfduiVj.mjs → action-sheet-BUUgo0WP.mjs} +1 -1
  5. package/dist/action-sheet.d.mts +1 -1
  6. package/dist/action-sheet.mjs +3 -3
  7. package/dist/{alert-dialog-DGbpHYVc.mjs → alert-dialog-BI00j7h7.mjs} +1 -1
  8. package/dist/alert-dialog.d.mts +1 -1
  9. package/dist/alert-dialog.mjs +2 -2
  10. package/dist/{announcer-CV09roPJ.d.mts → announcer-BbaoRW6K.d.mts} +39 -29
  11. package/dist/announcer.d.mts +1 -1
  12. package/dist/autocomplete.d.mts +1 -1
  13. package/dist/avatar.d.mts +1 -1
  14. package/dist/badge.d.mts +1 -1
  15. package/dist/banner.d.mts +1 -1
  16. package/dist/block-ui.d.mts +1 -1
  17. package/dist/blockquote.d.mts +1 -1
  18. package/dist/{calendar-year-select.vue-BohqVCaU.d.mts → calendar-year-select.vue-BQcKQTQK.d.mts} +3 -1
  19. package/dist/calendar.d.mts +2 -2
  20. package/dist/callout.d.mts +1 -1
  21. package/dist/card.d.mts +1 -1
  22. package/dist/{cascader-Cjq1lBSV.d.mts → cascader-CpuiN9gN.d.mts} +1 -1
  23. package/dist/cascader.d.mts +1 -1
  24. package/dist/catalog.d.mts +4 -0
  25. package/dist/catalog.mjs +7 -0
  26. package/dist/chart.d.mts +1 -1
  27. package/dist/checkbox.d.mts +1 -1
  28. package/dist/code.d.mts +1 -1
  29. package/dist/{collapsible-773Rn_1a.mjs → collapsible-Bu1EaVPo.mjs} +1 -0
  30. package/dist/collapsible.d.mts +1 -1
  31. package/dist/collapsible.mjs +1 -1
  32. package/dist/{collection-BaPf8lgw.d.mts → collection-uZxHxJXO.d.mts} +3 -3
  33. package/dist/collection.d.mts +1 -1
  34. package/dist/color-picker.d.mts +1 -1
  35. package/dist/combobox.d.mts +1 -1
  36. package/dist/{command-CAH0yrMT.d.mts → command-DNIK2Qo6.d.mts} +1 -1
  37. package/dist/{command-palette-CUiAda3h.mjs → command-palette-CFM0cW96.mjs} +2 -2
  38. package/dist/command-palette.d.mts +1 -1
  39. package/dist/command-palette.mjs +1 -1
  40. package/dist/command.d.mts +1 -1
  41. package/dist/{composite-navigation-i7ocwmio.d.mts → composite-navigation-DZZ5cAZL.d.mts} +11 -9
  42. package/dist/composite-navigation.d.mts +1 -1
  43. package/dist/{confirm-5iLHxupT.mjs → confirm-CocH5VBh.mjs} +2 -2
  44. package/dist/confirm.d.mts +1 -1
  45. package/dist/confirm.mjs +1 -1
  46. package/dist/{context-menu-D2ZLeqYu.mjs → context-menu-CRDvogFb.mjs} +1 -1
  47. package/dist/context-menu.d.mts +1 -1
  48. package/dist/context-menu.mjs +2 -2
  49. package/dist/copy-button.d.mts +1 -1
  50. package/dist/{data-grid-CM7Aerqz.d.mts → data-grid-C9kLgc3P.d.mts} +9 -9
  51. package/dist/data-grid.d.mts +1 -1
  52. package/dist/{date-picker-LEtopwTI.d.mts → date-picker-M__fXGCG.d.mts} +2 -2
  53. package/dist/date-picker.d.mts +2 -2
  54. package/dist/date-range-picker.d.mts +3 -3
  55. package/dist/{dialog-trigger-B7JM7Ay9.mjs → dialog-trigger-DZKuwAL4.mjs} +1 -0
  56. package/dist/dialog.d.mts +1 -1
  57. package/dist/dialog.mjs +1 -1
  58. package/dist/direction.d.mts +1 -1
  59. package/dist/{dismissable-layer-CTWSFZwj.d.mts → dismissable-layer-CmHNmp14.d.mts} +5 -5
  60. package/dist/dismissable-layer.d.mts +1 -1
  61. package/dist/{drag-and-drop-yh1y-FD_.d.mts → drag-and-drop-BEX1UhUa.d.mts} +1 -1
  62. package/dist/{drag-and-drop-controller-types-oM5xTtD2.d.mts → drag-and-drop-controller-types-D35h2Y8Q.d.mts} +8 -8
  63. package/dist/drag-and-drop.d.mts +2 -2
  64. package/dist/{drawer-Dxl5hMPT.mjs → drawer-DNHxUgXG.mjs} +1 -1
  65. package/dist/drawer.d.mts +1 -1
  66. package/dist/drawer.mjs +2 -2
  67. package/dist/{dropdown-menu-DddzcuXj.mjs → dropdown-menu-Dz5rgVcY.mjs} +1 -1
  68. package/dist/dropdown-menu.d.mts +1 -1
  69. package/dist/dropdown-menu.mjs +2 -2
  70. package/dist/duration-field.d.mts +1 -1
  71. package/dist/{emoji-picker-DNPPdAXl.d.mts → emoji-picker-BVj6pvRu.d.mts} +2 -0
  72. package/dist/emoji-picker.d.mts +1 -1
  73. package/dist/empty-state.d.mts +1 -1
  74. package/dist/fieldset.d.mts +1 -1
  75. package/dist/file-upload.d.mts +1 -1
  76. package/dist/floating-action-button.d.mts +1 -1
  77. package/dist/{focus-eObxGOtP.d.mts → focus-GaPcm0qz.d.mts} +3 -3
  78. package/dist/{focus-guards-BZa7vm6O.d.mts → focus-guards-Bu_N_Vb9.d.mts} +5 -3
  79. package/dist/focus-guards.d.mts +1 -1
  80. package/dist/{focus-scope-CsnioDR4.d.mts → focus-scope-BEIV6tFj.d.mts} +8 -8
  81. package/dist/focus-scope.d.mts +1 -1
  82. package/dist/focus-visible.d.mts +1 -1
  83. package/dist/focus.d.mts +1 -1
  84. package/dist/{form-wizard-mErOrBg3.d.mts → form-wizard-D_B-Cydo.d.mts} +2 -2
  85. package/dist/form-wizard.d.mts +1 -1
  86. package/dist/fullscreen-button.d.mts +1 -1
  87. package/dist/{grid-list-BBlRg22H.d.mts → grid-list-kQwU09ec.d.mts} +1 -1
  88. package/dist/grid-list.d.mts +1 -1
  89. package/dist/heading.d.mts +1 -1
  90. package/dist/{history-BkcOSOWb.d.mts → history-CU1beAvx.d.mts} +7 -5
  91. package/dist/history.d.mts +1 -1
  92. package/dist/{hotspot-QUJJ382M.d.mts → hotspot-Cc89VVie.d.mts} +1 -1
  93. package/dist/hotspot.d.mts +1 -1
  94. package/dist/{hover-ZiPRiZkb.d.mts → hover-CQGn1F67.d.mts} +3 -3
  95. package/dist/hover-card.d.mts +1 -1
  96. package/dist/hover.d.mts +1 -1
  97. package/dist/icon-button.d.mts +1 -1
  98. package/dist/icon.d.mts +1 -1
  99. package/dist/index.d.mts +49 -49
  100. package/dist/index.mjs +17 -17
  101. package/dist/{inert-outside-B6KdwAHY.d.mts → inert-outside-C8Hfd6HF.d.mts} +1 -1
  102. package/dist/inert-outside.d.mts +1 -1
  103. package/dist/{infinite-scroll-BotnfjUx.d.mts → infinite-scroll-Dd-_uQFI.d.mts} +2 -2
  104. package/dist/infinite-scroll.d.mts +1 -1
  105. package/dist/{input-D4Zvmf67.d.mts → input-C0fgeRnS.d.mts} +2 -2
  106. package/dist/input.d.mts +1 -1
  107. package/dist/{interaction-hooks-sD63_AhA.d.mts → interaction-hooks-B1b-CbUb.d.mts} +16 -4
  108. package/dist/interaction-hooks.d.mts +5 -5
  109. package/dist/interaction-hooks.mjs +2 -0
  110. package/dist/{interaction-modality-BTiZ7j98.d.mts → interaction-modality-Bz6QN_p7.d.mts} +1 -1
  111. package/dist/interaction-modality.d.mts +1 -1
  112. package/dist/kbd.d.mts +1 -1
  113. package/dist/landmark.d.mts +1 -1
  114. package/dist/{lightbox-BC5VnUsG.mjs → lightbox-CDqJQ7QF.mjs} +1 -1
  115. package/dist/lightbox.mjs +1 -1
  116. package/dist/list.d.mts +1 -1
  117. package/dist/{listbox-grid-BifoC9TP.d.mts → listbox-grid-BPMnoDF2.d.mts} +1 -1
  118. package/dist/listbox-grid.d.mts +1 -1
  119. package/dist/listbox.d.mts +1 -1
  120. package/dist/locale.d.mts +1 -1
  121. package/dist/{long-press-DyYxp191.d.mts → long-press-r7IluMf6.d.mts} +10 -4
  122. package/dist/long-press.d.mts +1 -1
  123. package/dist/{marquee-DJLOGKYQ.d.mts → marquee-BXVz0Oyy.d.mts} +2 -2
  124. package/dist/marquee.d.mts +1 -1
  125. package/dist/media-preferences.d.mts +1 -1
  126. package/dist/{mention-RayImxP_.d.mts → mention-Cz_qL9-F.d.mts} +1 -1
  127. package/dist/mention.d.mts +1 -1
  128. package/dist/{menu-zVLPQ3qq.mjs → menu-D0jsX5ex.mjs} +6 -0
  129. package/dist/menu.d.mts +1 -1
  130. package/dist/menu.mjs +1 -1
  131. package/dist/{menubar-D0qmUnA8.mjs → menubar-FFAqwU2g.mjs} +1 -1
  132. package/dist/menubar.d.mts +1 -1
  133. package/dist/menubar.mjs +2 -2
  134. package/dist/month-picker.d.mts +1 -1
  135. package/dist/{move-BJGaV7Y9.d.mts → move-Pkfnke5x.d.mts} +3 -3
  136. package/dist/move.d.mts +1 -1
  137. package/dist/native-select.d.mts +1 -1
  138. package/dist/navigation-rail.d.mts +1 -1
  139. package/dist/{notification-center-CNfcvQ0r.mjs → notification-center-BFgDx8Os.mjs} +1 -0
  140. package/dist/notification-center.d.mts +1 -1
  141. package/dist/notification-center.mjs +1 -1
  142. package/dist/pager.d.mts +1 -1
  143. package/dist/pagination.d.mts +1 -1
  144. package/dist/{pointer-grace-CAFcO4om.d.mts → pointer-grace-Dw_EQOrW.d.mts} +1 -1
  145. package/dist/pointer-grace.d.mts +1 -1
  146. package/dist/popconfirm.d.mts +1 -1
  147. package/dist/{popover-types-DCcody_B.d.mts → popover-types-C1qIeZbC.d.mts} +2 -2
  148. package/dist/popover.d.mts +3 -3
  149. package/dist/{presence-Bhv1qtvn.d.mts → presence-BSRPHC4s.d.mts} +1 -1
  150. package/dist/{presence-types-CRB4HbML.d.mts → presence-types-B9oh0msp.d.mts} +2 -2
  151. package/dist/presence.d.mts +2 -2
  152. package/dist/{press-types-DfTNpqby.d.mts → press-types-VAT8E1Qh.d.mts} +5 -5
  153. package/dist/{press-R0_juZq2.d.mts → press-vCzBqNpZ.d.mts} +1 -1
  154. package/dist/press.d.mts +2 -2
  155. package/dist/print-button.d.mts +1 -1
  156. package/dist/progress-bar.d.mts +1 -1
  157. package/dist/radio-group.d.mts +1 -1
  158. package/dist/{range-calendar-Ck_L_GjZ.d.mts → range-calendar-DKSgY7LF.d.mts} +3 -3
  159. package/dist/range-calendar.d.mts +2 -2
  160. package/dist/scroll-area.d.mts +1 -1
  161. package/dist/{scroll-spy-UzNvEzBk.d.mts → scroll-spy-CpVd2rt1.d.mts} +1 -1
  162. package/dist/scroll-spy.d.mts +1 -1
  163. package/dist/{search-field-DzW31UHM.d.mts → search-field-Biw9vApG.d.mts} +2 -2
  164. package/dist/search-field.d.mts +1 -1
  165. package/dist/select.d.mts +1 -1
  166. package/dist/share-button.d.mts +1 -1
  167. package/dist/{shortcut-DAZJ9LEd.d.mts → shortcut-BYDNeoht.d.mts} +1 -1
  168. package/dist/{shortcut-CvA_o0_F.mjs → shortcut-Bke2M083.mjs} +1 -0
  169. package/dist/shortcut.d.mts +1 -1
  170. package/dist/shortcut.mjs +1 -1
  171. package/dist/{sidebar-YNcuialf.mjs → sidebar-997KLhQT.mjs} +4 -2
  172. package/dist/sidebar.d.mts +1 -1
  173. package/dist/sidebar.mjs +1 -1
  174. package/dist/{sortable-CmSh0mgo.d.mts → sortable-CLTG4F2W.d.mts} +5 -5
  175. package/dist/sortable.d.mts +1 -1
  176. package/dist/{spatial-navigation-BPVJGSiJ.d.mts → spatial-navigation-DbKs6xex.d.mts} +12 -5
  177. package/dist/spatial-navigation.d.mts +1 -1
  178. package/dist/{split-button-B7xnT9vz.mjs → split-button-DOop3cSq.mjs} +1 -1
  179. package/dist/split-button.d.mts +1 -1
  180. package/dist/split-button.mjs +2 -2
  181. package/dist/splitter.d.mts +1 -1
  182. package/dist/status-light.d.mts +1 -1
  183. package/dist/stepper.d.mts +1 -1
  184. package/dist/surface.d.mts +1 -1
  185. package/dist/switch.d.mts +1 -1
  186. package/dist/tabs.d.mts +1 -1
  187. package/dist/tags-input.d.mts +1 -1
  188. package/dist/text.d.mts +1 -1
  189. package/dist/{textarea-D7V5lLPX.d.mts → textarea-4eIDNcvv.d.mts} +2 -2
  190. package/dist/textarea.d.mts +1 -1
  191. package/dist/{theme-CNK06Pja.d.mts → theme-BxObVL1d.d.mts} +1 -1
  192. package/dist/theme-scope.d.mts +1 -1
  193. package/dist/{theme-types-CkIa4Sa3.d.mts → theme-types-DhXLFvar.d.mts} +1 -1
  194. package/dist/theme.d.mts +2 -2
  195. package/dist/toggle.d.mts +1 -1
  196. package/dist/tooltip.d.mts +1 -1
  197. package/dist/tour.d.mts +1 -1
  198. package/dist/{transition-BtIWNEFU.d.mts → transition-BKw2vyI9.d.mts} +1 -1
  199. package/dist/transition.d.mts +1 -1
  200. package/dist/tree.d.mts +1 -1
  201. package/dist/{typeahead-Dl6w5PAN.d.mts → typeahead-C1RHCOuj.d.mts} +3 -3
  202. package/dist/typeahead.d.mts +1 -1
  203. package/dist/{virtualizer-D9qfT4wS.d.mts → virtualizer-CZLyY4kq.d.mts} +4 -4
  204. package/dist/virtualizer.d.mts +1 -1
  205. package/dist/{webcam-capture-D5JRu3ab.d.mts → webcam-capture-DWdP7sr4.d.mts} +3 -3
  206. package/dist/webcam-capture.d.mts +1 -1
  207. package/dist/week-picker.d.mts +2 -2
  208. package/package.json +2 -2
  209. package/registry/files/families/accessibility/focus/focus-types.ts +3 -3
  210. package/registry/files/families/accessibility/focus-guards/focus-guards-types.ts +5 -3
  211. package/registry/files/families/accessibility/focus-scope/focus-scope-types.ts +8 -8
  212. package/registry/files/families/accessibility/inert-outside/inert-outside-types.ts +1 -1
  213. package/registry/files/families/accessibility/interaction-modality/interaction-modality-types.ts +1 -1
  214. package/registry/files/families/accessibility/landmark/landmark-types.ts +1 -1
  215. package/registry/files/families/data/data-grid/data-grid-model.ts +4 -4
  216. package/registry/files/families/data/data-grid/data-grid-types.ts +5 -5
  217. package/registry/files/families/date-time/calendar/calendar-locale.ts +3 -1
  218. package/registry/files/families/date-time/calendar/calendar-selection.ts +2 -2
  219. package/registry/files/families/date-time/week-picker/week-picker-selection.ts +1 -0
  220. package/registry/files/families/disclosure/collapsible/collapsible-context.ts +1 -0
  221. package/registry/files/families/feedback/notification-center/notification-center-context.ts +1 -0
  222. package/registry/files/families/form/tags-input/tags-input-value.ts +1 -1
  223. package/registry/files/families/foundations/collection/collection-types.ts +3 -3
  224. package/registry/files/families/foundations/command/command-types.ts +1 -1
  225. package/registry/files/families/foundations/composite-navigation/composite-navigation-types.ts +9 -7
  226. package/registry/files/families/foundations/theme/theme-types.ts +1 -1
  227. package/registry/files/families/interaction/drag-and-drop/drag-and-drop-controller-types.ts +8 -8
  228. package/registry/files/families/interaction/history/history-types.ts +7 -5
  229. package/registry/files/families/interaction/hover/hover-types.ts +3 -3
  230. package/registry/files/families/interaction/interaction-hooks/interaction-hooks-types.ts +10 -0
  231. package/registry/files/families/interaction/interaction-hooks/interaction-hooks.ts +2 -0
  232. package/registry/files/families/interaction/long-press/long-press-types.ts +9 -3
  233. package/registry/files/families/interaction/move/move-types.ts +3 -3
  234. package/registry/files/families/interaction/pointer-grace/pointer-grace-types.ts +1 -1
  235. package/registry/files/families/interaction/press/press-types.ts +5 -5
  236. package/registry/files/families/interaction/scroll-spy/scroll-spy-types.ts +1 -1
  237. package/registry/files/families/interaction/shortcut/shortcut-parse.ts +1 -0
  238. package/registry/files/families/interaction/shortcut/shortcut-types.ts +1 -1
  239. package/registry/files/families/interaction/sortable/sortable-types.ts +4 -4
  240. package/registry/files/families/interaction/spatial-navigation/spatial-navigation-types.ts +11 -4
  241. package/registry/files/families/interaction/typeahead/typeahead-types.ts +2 -2
  242. package/registry/files/families/interaction/virtualizer/virtualizer-infinite.ts +3 -3
  243. package/registry/files/families/interaction/virtualizer/virtualizer-types.ts +1 -1
  244. package/registry/files/families/layout/icon/icon-types.ts +2 -0
  245. package/registry/files/families/layout/sidebar/sidebar-context.ts +2 -0
  246. package/registry/files/families/media/webcam-capture/webcam-capture-media.ts +3 -3
  247. package/registry/files/families/menus/menu/menu-context.ts +6 -0
  248. package/registry/files/families/menus/menu/menu-item-runtime.ts +4 -3
  249. package/registry/files/families/menus/menu/menu-root-runtime.ts +6 -0
  250. package/registry/files/families/navigation/pagination/pagination-range.ts +3 -2
  251. package/registry/files/families/overlays/dialog/dialog-context.ts +1 -0
  252. package/registry/files/families/overlays/dismissable-layer/dismissable-layer-types.ts +5 -5
  253. package/registry/files/families/overlays/presence/presence-types.ts +2 -2
  254. package/registry/files/families/selection/emoji-picker/emoji-picker-model.ts +2 -0
  255. package/registry/files/families/selection/listbox-grid/listbox-grid-model.ts +1 -1
  256. package/registry/files/families/selection/select/select-collection.ts +1 -1
  257. package/registry/registry.json +138 -138
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@vizejs/ui",
3
- "version": "0.714.0",
3
+ "version": "0.716.0",
4
4
  "description": "Accessible, headless, Native CSS-first UI primitives",
5
5
  "keywords": [
6
6
  "accessibility",
@@ -1171,7 +1171,7 @@
1171
1171
  "@tsdown/css": "0.22.14",
1172
1172
  "@types/node": "25.9.2",
1173
1173
  "@vitejs/plugin-vue": "6.0.7",
1174
- "@vizejs/native": "0.714.0",
1174
+ "@vizejs/native": "0.716.0",
1175
1175
  "@vue/compiler-sfc": "3.5.35",
1176
1176
  "@vue/test-utils": "2.4.10",
1177
1177
  "happy-dom": "21.0.4",
@@ -72,13 +72,13 @@ export interface FocusOptions {
72
72
  */
73
73
  readonly autoFocus?: boolean;
74
74
 
75
- /** Called after focus ownership is acquired. */
75
+ /** Called after focus ownership is acquired. @default undefined */
76
76
  readonly onFocus?: (event: FocusEvent) => void;
77
77
 
78
- /** Called after focus ownership is released. */
78
+ /** Called after focus ownership is released. @default undefined */
79
79
  readonly onBlur?: (event: FocusEvent) => void;
80
80
 
81
- /** Called after each distinct focus-state transition. */
81
+ /** Called after each distinct focus-state transition. @default undefined */
82
82
  readonly onFocusChange?: (isFocused: boolean, event: FocusEvent) => void;
83
83
  }
84
84
 
@@ -34,7 +34,7 @@ export interface FocusGuardsOptions {
34
34
  /** Primary guarded region. It may be `null` during SSR and before mount. */
35
35
  readonly root: MaybeRefOrGetter<Element | null | undefined>;
36
36
 
37
- /** Portalled regions that share the primary region's focus order. */
37
+ /** Portalled regions that share the primary region's focus order. @default undefined */
38
38
  readonly branches?: MaybeRefOrGetter<readonly Element[] | null | undefined>;
39
39
 
40
40
  /** Whether an activated pair participates in its document's guard stack. @default true */
@@ -43,15 +43,17 @@ export interface FocusGuardsOptions {
43
43
  /** Avoid scrolling when a sentinel redirects focus. @default true */
44
44
  readonly preventScroll?: MaybeRefOrGetter<boolean | undefined>;
45
45
 
46
- /** Additional filter applied after native sequential-focus checks. */
46
+ /** Additional filter applied after native sequential-focus checks. @default undefined */
47
47
  readonly accept?: (element: HTMLElement) => boolean;
48
48
 
49
- /** Fallback used when no sequentially focusable descendant remains. */
49
+ /** Fallback used when no sequentially focusable descendant remains. @default undefined */
50
50
  readonly fallbackFocus?: () => HTMLElement | null | undefined;
51
51
 
52
52
  /**
53
53
  * Called before focus is redirected. If `preventDefault` retains sentinel focus, the consumer
54
54
  * must move focus elsewhere or provide a visible focus indicator.
55
+ *
56
+ * @default undefined
55
57
  */
56
58
  readonly onRedirect?: (event: FocusGuardRedirectEvent) => void;
57
59
  }
@@ -10,7 +10,7 @@ export interface FocusScopeAutoFocusEvent {
10
10
 
11
11
  /** Programmatic movement options shared by the focus manager methods. */
12
12
  export interface FocusScopeMoveOptions {
13
- /** Element from which traversal begins. Defaults to the deep active element. */
13
+ /** Element from which traversal begins. @default the deep active element */
14
14
  readonly from?: Element | null;
15
15
 
16
16
  /**
@@ -34,7 +34,7 @@ export interface FocusScopeMoveOptions {
34
34
  */
35
35
  readonly preventScroll?: boolean;
36
36
 
37
- /** Additional consumer filter applied after native focusability checks. */
37
+ /** Additional consumer filter applied after native focusability checks. @default undefined */
38
38
  readonly accept?: (element: HTMLElement) => boolean;
39
39
  }
40
40
 
@@ -64,22 +64,22 @@ export interface FocusScopeOptions {
64
64
  */
65
65
  readonly restoreFocus?: MaybeRefOrGetter<boolean | undefined>;
66
66
 
67
- /** Preferred initial target. It must resolve inside the current scope. */
67
+ /** Preferred initial target. It must resolve inside the current scope. @default undefined */
68
68
  readonly initialFocus?: () => HTMLElement | null | undefined;
69
69
 
70
- /** Explicit restoration target, evaluated at deactivation time. */
70
+ /** Explicit restoration target, evaluated at deactivation time. @default undefined */
71
71
  readonly restoreTarget?: () => HTMLElement | null | undefined;
72
72
 
73
- /** Fallback target when a scope has no tabbable descendants. */
73
+ /** Fallback target when a scope has no tabbable descendants. @default undefined */
74
74
  readonly fallbackFocus?: () => HTMLElement | null | undefined;
75
75
 
76
- /** Consumer filter applied to automatically discovered focusable descendants. */
76
+ /** Consumer filter applied to automatically discovered focusable descendants. @default undefined */
77
77
  readonly accept?: (element: HTMLElement) => boolean;
78
78
 
79
- /** Called before automatic entry focus. Call `preventDefault` to retain focus. */
79
+ /** Called before automatic entry focus. Call `preventDefault` to retain focus. @default undefined */
80
80
  readonly onMountAutoFocus?: (event: FocusScopeAutoFocusEvent) => void;
81
81
 
82
- /** Called before automatic restoration. Call `preventDefault` to retain focus. */
82
+ /** Called before automatic restoration. Call `preventDefault` to retain focus. @default undefined */
83
83
  readonly onUnmountAutoFocus?: (event: FocusScopeAutoFocusEvent) => void;
84
84
  }
85
85
 
@@ -8,7 +8,7 @@ export interface InertOutsideOptions {
8
8
  /** Primary allowed root. It may be `null` during SSR and before mount. */
9
9
  readonly root: MaybeRefOrGetter<Element | null | undefined>;
10
10
 
11
- /** Additional portalled or exceptional roots that remain available. */
11
+ /** Additional portalled or exceptional roots that remain available. @default undefined */
12
12
  readonly branches?: MaybeRefOrGetter<readonly Element[] | undefined>;
13
13
 
14
14
  /** Whether an activated controller currently isolates outside content. @default true */
@@ -48,7 +48,7 @@ export interface InteractionModalityOptions {
48
48
  */
49
49
  readonly initialModality?: InteractionModality | null;
50
50
 
51
- /** Called synchronously after each distinct change. */
51
+ /** Called synchronously after each distinct change. @default undefined */
52
52
  readonly onChange?: (change: InteractionModalityChange) => void;
53
53
  }
54
54
 
@@ -118,7 +118,7 @@ export interface LandmarkNavigationOptions {
118
118
  */
119
119
  readonly previousKey?: MaybeRefOrGetter<LandmarkKeyBinding | null | undefined>;
120
120
 
121
- /** Called after focus moves to a landmark. */
121
+ /** Called after focus moves to a landmark. @default undefined */
122
122
  readonly onNavigate?: (landmark: LandmarkInfo, event: KeyboardEvent | null) => void;
123
123
  }
124
124
 
@@ -68,18 +68,18 @@ export interface DataGridOptions<Row, Column extends DataGridColumn<Row>> {
68
68
  readonly pageSize?: MaybeRefOrGetter<number | undefined>;
69
69
  /** Reading direction for horizontal arrow keys. @default "ltr" */
70
70
  readonly dir?: MaybeRefOrGetter<"ltr" | "rtl" | undefined>;
71
- /** Controlled state slices; `undefined` leaves a slice uncontrolled. */
71
+ /** Controlled state slices; `undefined` leaves every slice uncontrolled. @default undefined */
72
72
  readonly state?: {
73
73
  readonly [Key in DataGridStateKey]?: MaybeRefOrGetter<DataGridState[Key] | undefined>;
74
74
  };
75
- /** Initial uncontrolled state slices. */
75
+ /** Initial uncontrolled state slices; omitted slices use their built-in empty state. @default undefined */
76
76
  readonly defaultState?: MaybeRefOrGetter<Partial<DataGridState> | undefined>;
77
- /** Called after any slice changes (controlled or not). */
77
+ /** Called after any slice changes (controlled or not). @default undefined */
78
78
  readonly onStateChange?: <Key extends DataGridStateKey>(
79
79
  key: Key,
80
80
  value: DataGridState[Key],
81
81
  ) => void;
82
- /** Called when an edit commits. The grid never mutates rows. */
82
+ /** Called when an edit commits. The grid never mutates rows. @default undefined */
83
83
  readonly onCellEdit?: (event: DataGridCellEditEvent<Row>) => void;
84
84
  }
85
85
 
@@ -77,7 +77,7 @@ export interface DataGridPinning {
77
77
 
78
78
  /** Behavior shared by every column kind; `Value` is the resolved cell value. */
79
79
  export interface DataGridColumnOptions<Row, Value> {
80
- /** Visible header label, also used for the column header's accessible name. */
80
+ /** Visible header label, also used for the column header's accessible name. @default the column id */
81
81
  readonly header?: string;
82
82
 
83
83
  /** Allow sorting by this column. Display columns are never sortable. @default true */
@@ -117,19 +117,19 @@ export interface DataGridColumnOptions<Row, Value> {
117
117
  */
118
118
  readonly editable?: boolean | ((row: Row) => boolean);
119
119
 
120
- /** Order two values; defaults to locale-aware, `null`-last comparison. */
120
+ /** Order two values. @default locale-aware, numeric, `null`-last comparison */
121
121
  compare?(left: Value, right: Value, leftRow: Row, rightRow: Row): number;
122
122
 
123
- /** Keep a row when this column's filter value is set. */
123
+ /** Keep a row when this column's filter value is set. @default case-insensitive formatted substring matching */
124
124
  filter?(value: Value, filterValue: unknown, row: Row): boolean;
125
125
 
126
- /** Text used for display fallbacks, the global filter, and the editor draft. */
126
+ /** Text used for display fallbacks, the global filter, and the editor draft. @default built-in primitive and ISO date formatter */
127
127
  format?(value: Value, row: Row): string;
128
128
 
129
129
  /** Convert editor text back into a value. @default identity for string values */
130
130
  parse?(input: string, row: Row): Value;
131
131
 
132
- /** Return an error message to reject an edited value. */
132
+ /** Return an error message to reject an edited value. @default no validation error */
133
133
  validate?(value: Value, row: Row): string | null;
134
134
  }
135
135
 
@@ -24,10 +24,12 @@ export interface CalendarLocaleOptions {
24
24
  /**
25
25
  * Intl calendar used for display only (for example `japanese` or `buddhist`).
26
26
  * Grid structure always follows ISO months.
27
+ *
28
+ * @default the locale's calendar
27
29
  */
28
30
  readonly calendar?: string | undefined;
29
31
 
30
- /** Intl numbering system for day numbers and years. */
32
+ /** Intl numbering system for day numbers and years. @default the locale's numbering system */
31
33
  readonly numberingSystem?: string | undefined;
32
34
  }
33
35
 
@@ -20,7 +20,7 @@ export interface SingleCalendarSelectionOptions {
20
20
  previous: PlainDate | null,
21
21
  event: Event | null,
22
22
  ) => void;
23
- /** Called for every user activation of a selectable date, even when unchanged. */
23
+ /** Called for every user activation of a selectable date, even when unchanged. @default undefined */
24
24
  readonly onSelect?: (value: PlainDate, event: Event) => void;
25
25
  }
26
26
 
@@ -105,7 +105,7 @@ export interface MultipleCalendarSelectionOptions {
105
105
  previous: readonly PlainDate[],
106
106
  event: Event | null,
107
107
  ) => void;
108
- /** Called for every user toggle with the date and whether it is now selected. */
108
+ /** Called for every user toggle with the date and whether it is now selected. @default undefined */
109
109
  readonly onToggle?: (date: PlainDate, selected: boolean, event: Event) => void;
110
110
  }
111
111
 
@@ -34,6 +34,7 @@ export interface WeekSelectionOptions {
34
34
  previous: DateRange | null,
35
35
  event: Event | null,
36
36
  ) => void;
37
+ /** Called after a user selects a week. @default undefined */
37
38
  readonly onSelect?: (value: DateRange, event: Event) => void;
38
39
  }
39
40
 
@@ -17,4 +17,5 @@ export interface CollapsibleContextValue {
17
17
  readonly toggle: (event?: Event | null) => boolean;
18
18
  }
19
19
 
20
+ /** Required context shared by one Collapsible compound component tree. */
20
21
  export const collapsibleContext = createContext<CollapsibleContextValue>("Collapsible");
@@ -25,6 +25,7 @@ export interface NotificationCenterContextValue {
25
25
  readonly itemId: (id: string) => string;
26
26
  }
27
27
 
28
+ /** Required context shared by one NotificationCenter compound component tree. */
28
29
  export const notificationCenterContext =
29
30
  createContext<NotificationCenterContextValue>("NotificationCenter");
30
31
 
@@ -20,7 +20,7 @@ export interface TagsInputEvaluateOptions<T> {
20
20
  /** Consumer validator, if any. */
21
21
  readonly validate: TagsInputValidator<T> | undefined;
22
22
 
23
- /** Index being replaced by an inline edit; it is excluded from duplicate and max checks. */
23
+ /** Index being replaced by an inline edit; it is excluded from duplicate and max checks. @default undefined */
24
24
  readonly replaceIndex?: number;
25
25
  }
26
26
 
@@ -93,10 +93,10 @@ export interface CollectionRegistryOptions<Key extends CollectionKey> {
93
93
  */
94
94
  readonly disabledBehavior?: CollectionDisabledBehavior;
95
95
 
96
- /** Locale-aware comparator used by typeahead matching. */
96
+ /** Locale-aware comparator used by typeahead matching. @default an accent-insensitive search collator for the host locale */
97
97
  readonly collator?: Intl.Collator;
98
98
 
99
- /** Called synchronously after a distinct active-key transition. */
99
+ /** Called synchronously after a distinct active-key transition. @default undefined */
100
100
  readonly onActiveKeyChange?: (change: CollectionActiveChange<Key>) => void;
101
101
  }
102
102
 
@@ -140,7 +140,7 @@ export interface CollectionTextSearchOptions<Key extends CollectionKey> {
140
140
  */
141
141
  readonly loop?: boolean;
142
142
 
143
- /** Per-search locale comparator override. */
143
+ /** Per-search locale comparator override. @default the registry collator */
144
144
  readonly collator?: Intl.Collator;
145
145
  }
146
146
 
@@ -88,7 +88,7 @@ export interface CommandRouterOptions<Id extends string = string> {
88
88
  */
89
89
  readonly isDisabled?: MaybeRefOrGetter<boolean | undefined>;
90
90
 
91
- /** Observer called after every dispatch that found its command. */
91
+ /** Observer called after every dispatch that found its command. @default undefined */
92
92
  readonly onDidExecute?: (dispatch: CommandDispatch<Id>) => void;
93
93
  }
94
94
 
@@ -74,25 +74,27 @@ export interface CompositeNavigationBaseOptions<Key extends CollectionKey, Value
74
74
  */
75
75
  readonly direction?: MaybeRefOrGetter<CompositeDirection | undefined>;
76
76
 
77
- /** Wrap arrow navigation at collection boundaries. */
77
+ /** Wrap arrow navigation at collection boundaries. @default false */
78
78
  readonly loop?: MaybeRefOrGetter<boolean | undefined>;
79
79
 
80
- /** Suppress keyboard and pointer navigation while retaining active state. */
80
+ /** Suppress keyboard and pointer navigation while retaining active state. @default false */
81
81
  readonly isDisabled?: MaybeRefOrGetter<boolean | undefined>;
82
82
 
83
- /** Number of logical items traversed by PageUp and PageDown. */
83
+ /** Number of logical items traversed by PageUp and PageDown. @default 10 */
84
84
  readonly pageSize?: MaybeRefOrGetter<number | undefined>;
85
85
 
86
- /** Optional buffered typeahead integrated into the same active state. */
86
+ /** Optional buffered typeahead integrated into the same active state. @default false */
87
87
  readonly typeahead?: false | Omit<TypeaheadOptions<Key, Value>, "registry">;
88
88
 
89
- /** Called after the active item and DOM focus representation are synchronized. */
89
+ /** Called after the active item and DOM focus representation are synchronized. @default undefined */
90
90
  readonly onNavigate?: (change: CompositeNavigationChange<Key>) => void;
91
91
 
92
92
  /**
93
93
  * Custom visibility policy for virtualized or scroll-managed collections.
94
94
  * The default calls `scrollIntoView({block: "nearest", inline: "nearest"})`
95
95
  * when the method exists and DOM focus did not already scroll the item.
96
+ *
97
+ * @default nearest-block and nearest-inline scrolling
96
98
  */
97
99
  readonly scrollIntoView?: (item: CollectionItem<Key, Value>, originalEvent: Event | null) => void;
98
100
  }
@@ -105,10 +107,10 @@ export interface RovingNavigationOptions<
105
107
  /** @default "roving" */
106
108
  readonly focusStrategy?: "roving";
107
109
 
108
- /** Avoid browser scrolling when DOM focus moves; custom scrolling still runs. */
110
+ /** Avoid browser scrolling when DOM focus moves; custom scrolling still runs. @default false */
109
111
  readonly preventScroll?: MaybeRefOrGetter<boolean | undefined>;
110
112
 
111
- /** Optional stable ID projection for item props. */
113
+ /** Optional stable ID projection for item props. @default undefined */
112
114
  readonly getItemId?: (item: CollectionItem<Key, Value>) => string | undefined;
113
115
  }
114
116
 
@@ -115,7 +115,7 @@ export type ThemeScopeAttributes = Partial<Record<ThemeScopeAttributeName, strin
115
115
 
116
116
  /** Options for a declarative theme scope. */
117
117
  export interface ThemeScopeOptions {
118
- /** Opt-in preset name or array-composed preset names. */
118
+ /** Opt-in preset name or array-composed preset names. @default undefined */
119
119
  readonly presets?: ThemePresetName | readonly ThemePresetName[];
120
120
 
121
121
  /**
@@ -72,13 +72,13 @@ export interface DragAndDropOptions<Data = unknown> {
72
72
  */
73
73
  readonly announcements?: DragAnnouncements<Data>;
74
74
 
75
- /** Called exactly once when a session starts. */
75
+ /** Called exactly once when a session starts. @default undefined */
76
76
  readonly onDragStart?: (event: DragStartEvent<Data>) => void;
77
77
 
78
- /** Called for pointer movement and keyboard target changes inside a session. */
78
+ /** Called for pointer movement and keyboard target changes inside a session. @default undefined */
79
79
  readonly onDragMove?: (event: DragMoveEvent<Data>) => void;
80
80
 
81
- /** Called exactly once after a session drops or cancels. */
81
+ /** Called exactly once after a session drops or cancels. @default undefined */
82
82
  readonly onDragEnd?: (event: DragEndEvent<Data>) => void;
83
83
  }
84
84
 
@@ -87,7 +87,7 @@ export interface DragSourceOptions<Data = unknown> {
87
87
  /** Stable key unique among this controller's sources. */
88
88
  readonly key: string;
89
89
 
90
- /** Dragged item element used for geometry; the handle receives `sourceProps`. */
90
+ /** Dragged item element used for geometry; the handle receives `sourceProps`. @default undefined */
91
91
  readonly element?: MaybeRefOrGetter<Element | null | undefined>;
92
92
 
93
93
  /**
@@ -187,16 +187,16 @@ export interface DropTargetOptions<Data = unknown> {
187
187
  */
188
188
  readonly label?: MaybeRefOrGetter<string | undefined>;
189
189
 
190
- /** Called when the drag enters this target. */
190
+ /** Called when the drag enters this target. @default undefined */
191
191
  readonly onEnter?: (event: DropTargetEvent<Data>) => void;
192
192
 
193
- /** Called when the drag moves inside this target or its edge changes. */
193
+ /** Called when the drag moves inside this target or its edge changes. @default undefined */
194
194
  readonly onMove?: (event: DropTargetEvent<Data>) => void;
195
195
 
196
- /** Called when the drag leaves this target without dropping. */
196
+ /** Called when the drag leaves this target without dropping. @default undefined */
197
197
  readonly onLeave?: (event: DropTargetEvent<Data>) => void;
198
198
 
199
- /** Called when the session drops on this target. */
199
+ /** Called when the session drops on this target. @default undefined */
200
200
  readonly onDrop?: (event: DropTargetEvent<Data>) => void;
201
201
  }
202
202
 
@@ -8,12 +8,14 @@ export interface HistoryEntry {
8
8
  /** Re-apply the change after it was undone. */
9
9
  readonly redo: () => void;
10
10
 
11
- /** Human-readable label for Undo/Redo menu items. */
11
+ /** Human-readable label for Undo/Redo menu items. @default undefined */
12
12
  readonly label?: string;
13
13
 
14
14
  /**
15
15
  * Adjacent pushes carrying the same key merge into one step while they
16
16
  * arrive within the coalescing window and nothing was undone in between.
17
+ *
18
+ * @default undefined
17
19
  */
18
20
  readonly coalesceKey?: string;
19
21
  }
@@ -29,10 +31,10 @@ export interface HistorySnapshotOptions<Value> {
29
31
  /** Writer invoked with `before` on undo and `after` on redo. */
30
32
  readonly apply: (value: Value) => void;
31
33
 
32
- /** Human-readable label for Undo/Redo menu items. */
34
+ /** Human-readable label for Undo/Redo menu items. @default undefined */
33
35
  readonly label?: string;
34
36
 
35
- /** Coalescing key; see {@link HistoryEntry.coalesceKey}. */
37
+ /** Coalescing key; see {@link HistoryEntry.coalesceKey}. @default undefined */
36
38
  readonly coalesceKey?: string;
37
39
 
38
40
  /**
@@ -135,10 +137,10 @@ export interface EditableTransactionOptions<Value> {
135
137
  /** Write a value back into the editor. */
136
138
  readonly write: (value: Value) => void;
137
139
 
138
- /** Label recorded on committed steps. */
140
+ /** Label recorded on committed steps. @default undefined */
139
141
  readonly label?: string;
140
142
 
141
- /** Coalescing key recorded on committed steps. */
143
+ /** Coalescing key recorded on committed steps. @default undefined */
142
144
  readonly coalesceKey?: string;
143
145
 
144
146
  /**
@@ -51,13 +51,13 @@ export interface HoverOptions {
51
51
  */
52
52
  readonly pointerType?: MaybeRefOrGetter<HoverPointerType | undefined>;
53
53
 
54
- /** Called after hover state becomes active. */
54
+ /** Called after hover state becomes active. @default undefined */
55
55
  readonly onHoverStart?: (event: HoverEvent) => void;
56
56
 
57
- /** Called after hover ends or is canceled. */
57
+ /** Called after hover ends or is canceled. @default undefined */
58
58
  readonly onHoverEnd?: (event: HoverEvent) => void;
59
59
 
60
- /** Called for every distinct hover-state transition. */
60
+ /** Called for every distinct hover-state transition. @default undefined */
61
61
  readonly onHoverChange?: (isHovered: boolean) => void;
62
62
  }
63
63
 
@@ -14,6 +14,7 @@ import type {
14
14
  import type { HoverController, HoverOptions, HoverProps } from "../hover/hover.ts";
15
15
  import type { PressController, PressOptions, PressProps } from "../press/press.ts";
16
16
 
17
+ /** Disabled, configured, or default-enabled options for one interaction feature. */
17
18
  export type InteractionFeatureOptions<Options> = false | Options | undefined;
18
19
 
19
20
  /** Platform family used to resolve `Mod` in host-scoped shortcuts. */
@@ -104,7 +105,9 @@ export interface InteractionShortcutController {
104
105
  readonly dispose: () => void;
105
106
  }
106
107
 
108
+ /** Features composed into one host's interaction props and controller state. */
107
109
  export interface InteractionHooksOptions {
110
+ /** Disable every configured host interaction while preserving its state. @default false */
108
111
  readonly isDisabled?: MaybeRefOrGetter<boolean | undefined>;
109
112
  /**
110
113
  * Track document-level keyboard, pointer, touch, and virtual input modality.
@@ -112,9 +115,13 @@ export interface InteractionHooksOptions {
112
115
  * @default false
113
116
  */
114
117
  readonly modality?: InteractionFeatureOptions<InteractionModalityOptions>;
118
+ /** Configure direct-target focus-ring tracking. @default enabled with default options */
115
119
  readonly focusRing?: InteractionFeatureOptions<FocusRingOptions>;
120
+ /** Configure descendant focus tracking. @default enabled with default options */
116
121
  readonly focusWithin?: InteractionFeatureOptions<FocusWithinOptions>;
122
+ /** Configure hover normalization. @default enabled with default options */
117
123
  readonly hover?: InteractionFeatureOptions<HoverOptions>;
124
+ /** Configure press normalization. @default enabled with default options */
118
125
  readonly press?: InteractionFeatureOptions<PressOptions>;
119
126
  /**
120
127
  * Route element-scoped or explicitly attached keyboard shortcuts.
@@ -149,6 +156,7 @@ type ShortcutFeature<Options> = Options extends { readonly shortcuts: infer Feat
149
156
  type FeatureController<Feature, Controller> = [Feature] extends [false] ? null : Controller;
150
157
  type FeatureProps<Feature, Props> = [Feature] extends [false] ? object : Props;
151
158
 
159
+ /** Native host props contributed by the statically configured features. */
152
160
  export type InteractionHooksProps<Options extends InteractionHooksOptions = {}> = FeatureProps<
153
161
  PressFeature<Options>,
154
162
  PressProps
@@ -158,6 +166,7 @@ export type InteractionHooksProps<Options extends InteractionHooksOptions = {}>
158
166
  FeatureProps<FocusWithinFeature<Options>, FocusProps> &
159
167
  FeatureProps<ShortcutFeature<Options>, InteractionShortcutProps>;
160
168
 
169
+ /** Whether each feature had transient interaction state to cancel. */
161
170
  export interface InteractionHooksCancelResult {
162
171
  readonly focusRing: boolean;
163
172
  readonly focusWithin: boolean;
@@ -166,6 +175,7 @@ export interface InteractionHooksCancelResult {
166
175
  readonly shortcuts: boolean;
167
176
  }
168
177
 
178
+ /** Composed feature controllers, state, host props, and lifecycle operations. */
169
179
  export interface InteractionHooksController<Options extends InteractionHooksOptions = {}> {
170
180
  readonly modalityTracker: FeatureController<ModalityFeature<Options>, InteractionModalityTracker>;
171
181
  readonly shortcutController: FeatureController<
@@ -239,6 +239,7 @@ function surfaceErrors(errors: readonly unknown[]): void {
239
239
  if (errors.length > 1) throw new AggregateError(errors, "Interaction hook cleanup failed");
240
240
  }
241
241
 
242
+ /** Create explicitly disposable interaction features and merged host props. */
242
243
  export function createInteractionHooks<const Options extends InteractionHooksOptions = {}>(
243
244
  options: Options = {} as Options,
244
245
  ): InteractionHooksController<Options> {
@@ -305,6 +306,7 @@ export function createInteractionHooks<const Options extends InteractionHooksOpt
305
306
  }) as InteractionHooksController<Options>;
306
307
  }
307
308
 
309
+ /** Scope {@link createInteractionHooks} to the active Vue effect scope. */
308
310
  export function useInteractionHooks<const Options extends InteractionHooksOptions = {}>(
309
311
  options: Options = {} as Options,
310
312
  ): InteractionHooksController<Options> {
@@ -47,12 +47,16 @@ export interface LongPressOptions {
47
47
  * Accessible explanation of the long action, for example
48
48
  * "Long press to open actions". Used as `aria-description` unless
49
49
  * `accessibilityDescriptionId` is supplied.
50
+ *
51
+ * @default undefined
50
52
  */
51
53
  readonly accessibilityDescription?: MaybeRefOrGetter<string | undefined>;
52
54
 
53
55
  /**
54
56
  * ID of consumer-rendered descriptive content. When supplied, the host uses
55
57
  * `aria-describedby` and the inline accessibility description is omitted.
58
+ *
59
+ * @default undefined
56
60
  */
57
61
  readonly accessibilityDescriptionId?: MaybeRefOrGetter<string | undefined>;
58
62
 
@@ -70,18 +74,20 @@ export interface LongPressOptions {
70
74
  */
71
75
  readonly preventFocusOnPress?: MaybeRefOrGetter<boolean | undefined>;
72
76
 
73
- /** Called after a qualifying primary pointer starts. */
77
+ /** Called after a qualifying primary pointer starts. @default undefined */
74
78
  readonly onLongPressStart?: (event: LongPressEvent) => void;
75
79
 
76
- /** Called when an attempt ends, whether before or after the threshold. */
80
+ /** Called when an attempt ends, whether before or after the threshold. @default undefined */
77
81
  readonly onLongPressEnd?: (event: LongPressEvent) => void;
78
82
 
79
- /** Called exactly once when the configured threshold is reached. */
83
+ /** Called exactly once when the configured threshold is reached. @default undefined */
80
84
  readonly onLongPress?: (event: LongPressEvent) => void;
81
85
 
82
86
  /**
83
87
  * Called for an ordinary short, keyboard, or virtual activation.
84
88
  * Use this as the keyboard-accessible alternative to a long-only action.
89
+ *
90
+ * @default undefined
85
91
  */
86
92
  readonly onPress?: (event: PressEvent) => void;
87
93
  }
@@ -71,13 +71,13 @@ export interface MoveOptions {
71
71
  */
72
72
  readonly keyboardStep?: MaybeRefOrGetter<number | undefined>;
73
73
 
74
- /** Called exactly once before the first non-zero delta in an interaction. */
74
+ /** Called exactly once before the first non-zero delta in an interaction. @default undefined */
75
75
  readonly onMoveStart?: (event: MoveStartEvent) => void;
76
76
 
77
- /** Called for every non-zero pointer or keyboard delta. */
77
+ /** Called for every non-zero pointer or keyboard delta. @default undefined */
78
78
  readonly onMove?: (event: MoveUpdateEvent) => void;
79
79
 
80
- /** Called after an interaction that emitted at least one move finishes. */
80
+ /** Called after an interaction that emitted at least one move finishes. @default undefined */
81
81
  readonly onMoveEnd?: (event: MoveEndEvent) => void;
82
82
  }
83
83
 
@@ -23,7 +23,7 @@ export interface PointerGraceOptions {
23
23
  */
24
24
  readonly delay?: MaybeRefOrGetter<number | undefined>;
25
25
 
26
- /** Called once the pointer stays outside the polygon for `delay`. */
26
+ /** Called once the pointer stays outside the polygon for `delay`. @default undefined */
27
27
  readonly onGraceEnd?: () => void;
28
28
  }
29
29
 
@@ -83,19 +83,19 @@ export interface PressOptions {
83
83
  */
84
84
  readonly allowTextSelectionOnPress?: MaybeRefOrGetter<boolean | undefined>;
85
85
 
86
- /** Called after pressed state becomes active. */
86
+ /** Called after pressed state becomes active. @default undefined */
87
87
  readonly onPressStart?: (event: PressEvent) => void;
88
88
 
89
- /** Called after pressed state ends or pauses at the pointer boundary. */
89
+ /** Called after pressed state ends or pauses at the pointer boundary. @default undefined */
90
90
  readonly onPressEnd?: (event: PressEvent) => void;
91
91
 
92
- /** Called for every distinct pressed-state transition. */
92
+ /** Called for every distinct pressed-state transition. @default undefined */
93
93
  readonly onPressChange?: (isPressed: boolean) => void;
94
94
 
95
- /** Called when keyboard or pointing hardware is released over the host. */
95
+ /** Called when keyboard or pointing hardware is released over the host. @default undefined */
96
96
  readonly onPressUp?: (event: PressEvent) => void;
97
97
 
98
- /** Called exactly once for a completed activation. */
98
+ /** Called exactly once for a completed activation. @default undefined */
99
99
  readonly onPress?: (event: PressEvent) => void;
100
100
  }
101
101