@kouji-ui/core 0.0.4 → 0.1.1

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 (534) hide show
  1. package/.turbo/turbo-build.log +7 -4
  2. package/CHANGELOG.md +169 -0
  3. package/ng-package.json +5 -1
  4. package/package.json +18 -6
  5. package/src/a11y/aria-describedby.ts +7 -3
  6. package/src/a11y/aria-labelledby.spec.ts +55 -0
  7. package/src/a11y/aria-labelledby.ts +38 -0
  8. package/src/a11y/focus-trap.ts +4 -2
  9. package/src/a11y/index.ts +1 -0
  10. package/src/a11y/live-region.ts +4 -2
  11. package/src/a11y/roving-tabindex.spec.ts +139 -0
  12. package/src/a11y/roving-tabindex.ts +56 -7
  13. package/src/a11y/visually-hidden.ts +4 -2
  14. package/src/accordion/accordion.context.ts +22 -0
  15. package/src/accordion/accordion.spec.ts +233 -23
  16. package/src/accordion/accordion.ts +311 -39
  17. package/src/accordion/index.ts +8 -2
  18. package/src/alert/alert.context.ts +28 -0
  19. package/src/alert/alert.spec.ts +217 -0
  20. package/src/alert/alert.ts +417 -0
  21. package/src/alert/config.ts +46 -0
  22. package/src/alert/index.ts +19 -0
  23. package/src/avatar/avatar-group.context.ts +45 -0
  24. package/src/avatar/avatar-group.spec.ts +358 -0
  25. package/src/avatar/avatar-group.ts +259 -0
  26. package/src/avatar/avatar.ts +17 -4
  27. package/src/avatar/index.ts +11 -1
  28. package/src/badge/badge.spec.ts +8 -0
  29. package/src/badge/badge.ts +24 -3
  30. package/src/breadcrumb/breadcrumb-current.ts +38 -0
  31. package/src/breadcrumb/breadcrumb-ellipsis.ts +71 -0
  32. package/src/breadcrumb/breadcrumb-item.ts +41 -0
  33. package/src/breadcrumb/breadcrumb-link.ts +44 -0
  34. package/src/breadcrumb/breadcrumb-list.ts +42 -0
  35. package/src/breadcrumb/breadcrumb-separator.ts +45 -0
  36. package/src/breadcrumb/breadcrumb.context.ts +45 -0
  37. package/src/breadcrumb/breadcrumb.spec.ts +354 -0
  38. package/src/breadcrumb/breadcrumb.ts +239 -0
  39. package/src/breadcrumb/config.ts +84 -0
  40. package/src/breadcrumb/index.ts +18 -0
  41. package/src/button/_examples/button.example.ts +71 -0
  42. package/src/button/_examples/button.finance.example.ts +83 -0
  43. package/src/button/_examples/button.retro.example.ts +91 -0
  44. package/src/button/_examples/button.sizes.example.ts +60 -0
  45. package/src/button/_examples/index.ts +6 -0
  46. package/src/button/button.spec.ts +139 -8
  47. package/src/button/button.ts +114 -16
  48. package/src/button/config.spec.ts +33 -0
  49. package/src/button/config.ts +45 -0
  50. package/src/button/index.ts +2 -1
  51. package/src/button-group/button-group.context.ts +28 -0
  52. package/src/button-group/button-group.spec.ts +99 -0
  53. package/src/button-group/button-group.ts +99 -0
  54. package/src/button-group/index.ts +2 -0
  55. package/src/calendar/calendar-day.ts +102 -0
  56. package/src/calendar/calendar-grid.ts +90 -0
  57. package/src/calendar/calendar-header.ts +65 -0
  58. package/src/calendar/calendar.context.ts +53 -0
  59. package/src/calendar/calendar.spec.ts +225 -0
  60. package/src/calendar/calendar.ts +233 -0
  61. package/src/calendar/date-utils.ts +225 -0
  62. package/src/calendar/index.ts +28 -0
  63. package/src/carousel/carousel.context.ts +81 -0
  64. package/src/carousel/carousel.spec.ts +337 -0
  65. package/src/carousel/carousel.ts +919 -0
  66. package/src/carousel/index.ts +22 -0
  67. package/src/cascade-select/cascade-select-option.ts +205 -0
  68. package/src/cascade-select/cascade-select-panel.ts +106 -0
  69. package/src/cascade-select/cascade-select-root.ts +265 -0
  70. package/src/cascade-select/cascade-select-sub-panel.ts +168 -0
  71. package/src/cascade-select/cascade-select-trigger.ts +44 -0
  72. package/src/cascade-select/cascade-select.context.ts +71 -0
  73. package/src/cascade-select/cascade-select.spec.ts +241 -0
  74. package/src/cascade-select/cascade-select.ts +5 -0
  75. package/src/cascade-select/index.ts +11 -0
  76. package/src/chart/chart.ts +6 -2
  77. package/src/chat/chat-avatar.ts +31 -0
  78. package/src/chat/chat-bubble.ts +49 -0
  79. package/src/chat/chat-footer.ts +67 -0
  80. package/src/chat/chat-header.ts +41 -0
  81. package/src/chat/chat-log.ts +43 -0
  82. package/src/chat/chat.context.ts +64 -0
  83. package/src/chat/chat.spec.ts +341 -0
  84. package/src/chat/chat.ts +191 -0
  85. package/src/chat/config.ts +53 -0
  86. package/src/chat/index.ts +21 -0
  87. package/src/checkbox/checkbox.ts +9 -2
  88. package/src/color-picker/color-picker.context.ts +74 -0
  89. package/src/color-picker/color-picker.spec.ts +241 -0
  90. package/src/color-picker/color-picker.ts +698 -0
  91. package/src/color-picker/color-picker.utils.ts +140 -0
  92. package/src/color-picker/index.ts +28 -0
  93. package/src/combobox/combobox-input.ts +143 -0
  94. package/src/combobox/combobox-listbox.ts +49 -0
  95. package/src/combobox/combobox-option.ts +43 -0
  96. package/src/combobox/combobox-root.ts +281 -0
  97. package/src/combobox/combobox.spec.ts +75 -0
  98. package/src/combobox/combobox.ts +4 -0
  99. package/src/combobox/index.ts +4 -0
  100. package/src/command-palette/command-empty.ts +36 -0
  101. package/src/command-palette/command-group.ts +21 -0
  102. package/src/command-palette/command-input.ts +70 -0
  103. package/src/command-palette/command-item.ts +60 -0
  104. package/src/command-palette/command-list.ts +25 -0
  105. package/src/command-palette/command-palette-dialog.ts +74 -0
  106. package/src/command-palette/command-palette-trigger.ts +64 -0
  107. package/src/command-palette/command-palette.filters.ts +53 -0
  108. package/src/command-palette/command-palette.spec.ts +349 -0
  109. package/src/command-palette/command-palette.ts +204 -0
  110. package/src/command-palette/command-separator.ts +18 -0
  111. package/src/command-palette/index.ts +15 -0
  112. package/src/confirm-popup/confirm-popup-action.ts +39 -0
  113. package/src/confirm-popup/confirm-popup-cancel.ts +38 -0
  114. package/src/confirm-popup/confirm-popup-content.ts +113 -0
  115. package/src/confirm-popup/confirm-popup-message.ts +36 -0
  116. package/src/confirm-popup/confirm-popup-trigger.ts +31 -0
  117. package/src/confirm-popup/confirm-popup.context.ts +41 -0
  118. package/src/confirm-popup/confirm-popup.spec.ts +337 -0
  119. package/src/confirm-popup/confirm-popup.ts +109 -0
  120. package/src/confirm-popup/index.ts +12 -0
  121. package/src/date-picker/date-picker-calendar.ts +65 -0
  122. package/src/date-picker/date-picker-trigger.ts +215 -0
  123. package/src/date-picker/date-picker.context.ts +50 -0
  124. package/src/date-picker/date-picker.spec.ts +117 -0
  125. package/src/date-picker/date-picker.ts +127 -0
  126. package/src/date-picker/index.ts +7 -0
  127. package/src/dialog/_examples/dialog.confirm.example.ts +145 -0
  128. package/src/dialog/_examples/dialog.example.ts +106 -0
  129. package/src/dialog/_examples/dialog.finance.example.ts +121 -0
  130. package/src/dialog/_examples/dialog.retro.example.ts +126 -0
  131. package/src/dialog/_examples/index.ts +6 -0
  132. package/src/dialog/dialog.ref.ts +42 -0
  133. package/src/dialog/dialog.service.ts +57 -167
  134. package/src/dialog/dialog.spec.ts +35 -120
  135. package/src/dialog/dialog.ts +17 -192
  136. package/src/dialog/index.ts +3 -9
  137. package/src/divider/divider.spec.ts +223 -0
  138. package/src/divider/divider.ts +137 -0
  139. package/src/divider/index.ts +5 -0
  140. package/src/drawer/drawer.ref.ts +63 -0
  141. package/src/drawer/drawer.service.ts +106 -0
  142. package/src/drawer/drawer.spec.ts +117 -0
  143. package/src/drawer/drawer.ts +122 -0
  144. package/src/drawer/index.ts +10 -0
  145. package/src/dropdown-menu/dropdown-menu-content.ts +258 -0
  146. package/src/dropdown-menu/dropdown-menu-group.ts +31 -0
  147. package/src/dropdown-menu/dropdown-menu-item.ts +51 -0
  148. package/src/dropdown-menu/dropdown-menu-label.ts +41 -0
  149. package/src/dropdown-menu/dropdown-menu-separator.ts +27 -0
  150. package/src/dropdown-menu/dropdown-menu-trigger.ts +140 -0
  151. package/src/dropdown-menu/dropdown-menu.spec.ts +265 -0
  152. package/src/dropdown-menu/dropdown-menu.ts +60 -0
  153. package/src/dropdown-menu/index.ts +15 -0
  154. package/src/example-components.ts +39 -30
  155. package/src/field/field-error.ts +49 -0
  156. package/src/field/field-group.ts +39 -0
  157. package/src/field/field-help.ts +47 -0
  158. package/src/field/field-label.ts +30 -0
  159. package/src/field/field.context.ts +28 -0
  160. package/src/field/field.spec.ts +179 -0
  161. package/src/field/field.ts +121 -0
  162. package/src/field/index.ts +6 -0
  163. package/src/file-upload/file-upload.context.ts +89 -0
  164. package/src/file-upload/file-upload.spec.ts +290 -0
  165. package/src/file-upload/file-upload.ts +639 -0
  166. package/src/file-upload/file-upload.types.ts +59 -0
  167. package/src/file-upload/index.ts +23 -0
  168. package/src/form/form-error-summary.ts +87 -0
  169. package/src/form/form-field.context.ts +3 -0
  170. package/src/form/form-field.spec.ts +25 -0
  171. package/src/form/form-field.ts +52 -0
  172. package/src/form/form.context.ts +52 -2
  173. package/src/form/form.spec.ts +155 -18
  174. package/src/form/form.ts +315 -35
  175. package/src/form/index.ts +11 -2
  176. package/src/icon/E2E.md +14 -0
  177. package/src/icon/icon.css +40 -0
  178. package/src/icon/icon.directive.spec.ts +198 -0
  179. package/src/icon/icon.directive.ts +113 -0
  180. package/src/icon/icon.mode.spec.ts +29 -0
  181. package/src/icon/icon.mode.ts +23 -0
  182. package/src/icon/icon.providers.spec.ts +63 -0
  183. package/src/icon/icon.providers.ts +47 -0
  184. package/src/icon/icon.resolver.spec.ts +96 -0
  185. package/src/icon/icon.resolver.ts +49 -0
  186. package/src/icon/icon.tokens.ts +88 -0
  187. package/src/icon/icon.types.ts +48 -0
  188. package/src/icon/index.ts +21 -0
  189. package/src/input/input.ts +12 -3
  190. package/src/input-group/index.ts +3 -0
  191. package/src/input-group/input-group-addon.ts +92 -0
  192. package/src/input-group/input-group.context.ts +27 -0
  193. package/src/input-group/input-group.spec.ts +186 -0
  194. package/src/input-group/input-group.ts +136 -0
  195. package/src/input-mask/index.ts +11 -0
  196. package/src/input-mask/input-mask.compile.ts +69 -0
  197. package/src/input-mask/input-mask.engine.ts +376 -0
  198. package/src/input-mask/input-mask.presets.ts +24 -0
  199. package/src/input-mask/input-mask.spec.ts +304 -0
  200. package/src/input-mask/input-mask.tokens.ts +49 -0
  201. package/src/input-mask/input-mask.ts +280 -0
  202. package/src/input-otp/index.ts +2 -0
  203. package/src/input-otp/input-otp.context.ts +41 -0
  204. package/src/input-otp/input-otp.spec.ts +308 -0
  205. package/src/input-otp/input-otp.ts +470 -0
  206. package/src/kbd/index.ts +1 -0
  207. package/src/kbd/kbd.spec.ts +127 -0
  208. package/src/kbd/kbd.ts +132 -0
  209. package/src/link/config.ts +44 -0
  210. package/src/link/index.ts +2 -0
  211. package/src/link/link.spec.ts +246 -0
  212. package/src/link/link.ts +226 -0
  213. package/src/list/index.ts +11 -0
  214. package/src/list/list.spec.ts +237 -0
  215. package/src/list/list.ts +277 -0
  216. package/src/menubar/index.ts +7 -0
  217. package/src/menubar/menubar-item.ts +204 -0
  218. package/src/menubar/menubar.context.ts +43 -0
  219. package/src/menubar/menubar.spec.ts +433 -0
  220. package/src/menubar/menubar.ts +309 -0
  221. package/src/number-input/index.ts +4 -0
  222. package/src/number-input/number-input-group.ts +64 -0
  223. package/src/number-input/number-input.context.ts +31 -0
  224. package/src/number-input/number-input.format.ts +148 -0
  225. package/src/number-input/number-input.spec.ts +170 -0
  226. package/src/number-input/number-input.ts +457 -0
  227. package/src/number-input/number-stepper.ts +193 -0
  228. package/src/overlay-badge/index.ts +7 -0
  229. package/src/overlay-badge/overlay-badge-content.ts +73 -0
  230. package/src/overlay-badge/overlay-badge.context.ts +37 -0
  231. package/src/overlay-badge/overlay-badge.spec.ts +220 -0
  232. package/src/overlay-badge/overlay-badge.ts +128 -0
  233. package/src/pagination/config.ts +82 -0
  234. package/src/pagination/index.ts +19 -0
  235. package/src/pagination/page-tokens.ts +78 -0
  236. package/src/pagination/pagination-ellipsis.ts +69 -0
  237. package/src/pagination/pagination-first.ts +84 -0
  238. package/src/pagination/pagination-info.ts +70 -0
  239. package/src/pagination/pagination-item.ts +81 -0
  240. package/src/pagination/pagination-last.ts +85 -0
  241. package/src/pagination/pagination-next.ts +86 -0
  242. package/src/pagination/pagination-previous.ts +90 -0
  243. package/src/pagination/pagination.context.ts +52 -0
  244. package/src/pagination/pagination.spec.ts +388 -0
  245. package/src/pagination/pagination.ts +288 -0
  246. package/src/password-input/index.ts +15 -0
  247. package/src/password-input/password-input.context.ts +65 -0
  248. package/src/password-input/password-input.scorer.ts +34 -0
  249. package/src/password-input/password-input.spec.ts +274 -0
  250. package/src/password-input/password-input.ts +488 -0
  251. package/src/popover/_examples/index.ts +5 -0
  252. package/src/popover/_examples/popover.example.ts +92 -0
  253. package/src/popover/_examples/popover.finance.example.ts +106 -0
  254. package/src/popover/_examples/popover.retro.example.ts +103 -0
  255. package/src/popover/index.ts +5 -12
  256. package/src/popover/popover-arrow.ts +30 -0
  257. package/src/popover/popover-close.ts +36 -0
  258. package/src/popover/popover-content.ts +41 -0
  259. package/src/popover/popover-title.ts +39 -0
  260. package/src/popover/popover-trigger.ts +40 -0
  261. package/src/popover/popover.spec.ts +51 -44
  262. package/src/popover/popover.ts +5 -124
  263. package/src/presets/bind-presets.spec.ts +50 -0
  264. package/src/presets/bind-presets.ts +43 -0
  265. package/src/presets/index.ts +3 -0
  266. package/src/presets/size.spec.ts +67 -0
  267. package/src/presets/size.ts +59 -0
  268. package/src/presets/variant.spec.ts +72 -0
  269. package/src/presets/variant.ts +62 -0
  270. package/src/primitives/directionality/directionality.spec.ts +112 -0
  271. package/src/primitives/directionality/directionality.ts +89 -0
  272. package/src/primitives/directionality/index.ts +1 -0
  273. package/src/primitives/forms/form-control.spec.ts +11 -3
  274. package/src/primitives/forms/form-control.ts +6 -2
  275. package/src/primitives/index.ts +3 -0
  276. package/src/primitives/interaction/disabled.ts +12 -5
  277. package/src/primitives/interaction/focus-ring.ts +4 -2
  278. package/src/primitives/list/filterable-list.spec.ts +114 -0
  279. package/src/primitives/list/filterable-list.ts +126 -0
  280. package/src/primitives/list/group.spec.ts +99 -0
  281. package/src/primitives/list/group.ts +139 -0
  282. package/src/primitives/list/index.ts +8 -0
  283. package/src/primitives/list/inject-helpers.ts +8 -0
  284. package/src/primitives/list/item.spec.ts +173 -0
  285. package/src/primitives/list/item.ts +222 -0
  286. package/src/primitives/list/navigator.spec.ts +286 -0
  287. package/src/primitives/list/navigator.ts +238 -0
  288. package/src/primitives/list/selection.spec.ts +214 -0
  289. package/src/primitives/list/selection.ts +339 -0
  290. package/src/primitives/list/tokens.ts +106 -0
  291. package/src/primitives/list/type-ahead.spec.ts +58 -0
  292. package/src/primitives/list/type-ahead.ts +46 -0
  293. package/src/primitives/overlay/backdrop.spec.ts +54 -0
  294. package/src/primitives/overlay/backdrop.ts +31 -0
  295. package/src/primitives/overlay/builder.spec.ts +38 -0
  296. package/src/primitives/overlay/builder.ts +151 -0
  297. package/src/primitives/overlay/container.ts +42 -0
  298. package/src/primitives/overlay/context.ts +14 -0
  299. package/src/primitives/overlay/controller.spec.ts +86 -0
  300. package/src/primitives/overlay/controller.ts +190 -0
  301. package/src/primitives/overlay/id.spec.ts +24 -0
  302. package/src/primitives/overlay/id.ts +17 -0
  303. package/src/primitives/overlay/index.ts +18 -1
  304. package/src/primitives/overlay/overlay.css +42 -0
  305. package/src/primitives/overlay/panel.spec.ts +52 -0
  306. package/src/primitives/overlay/panel.ts +102 -0
  307. package/src/primitives/overlay/stack.spec.ts +55 -0
  308. package/src/primitives/overlay/stack.ts +113 -0
  309. package/src/primitives/overlay/strategies/backdrop/blurred.spec.ts +11 -0
  310. package/src/primitives/overlay/strategies/backdrop/blurred.ts +5 -0
  311. package/src/primitives/overlay/strategies/backdrop/none.spec.ts +10 -0
  312. package/src/primitives/overlay/strategies/backdrop/none.ts +9 -0
  313. package/src/primitives/overlay/strategies/backdrop/solid.spec.ts +18 -0
  314. package/src/primitives/overlay/strategies/backdrop/solid.ts +23 -0
  315. package/src/primitives/overlay/strategies/focus-trap/inert-based.spec.ts +28 -0
  316. package/src/primitives/overlay/strategies/focus-trap/inert-based.ts +38 -0
  317. package/src/primitives/overlay/strategies/focus-trap/no-trap.spec.ts +9 -0
  318. package/src/primitives/overlay/strategies/focus-trap/no-trap.ts +8 -0
  319. package/src/primitives/overlay/strategies/focus-trap/tab-cycle.spec.ts +49 -0
  320. package/src/primitives/overlay/strategies/focus-trap/tab-cycle.ts +85 -0
  321. package/src/primitives/overlay/strategies/index.ts +34 -0
  322. package/src/primitives/overlay/strategies/live-announcer/_announce.ts +35 -0
  323. package/src/primitives/overlay/strategies/live-announcer/assertive.spec.ts +21 -0
  324. package/src/primitives/overlay/strategies/live-announcer/assertive.ts +11 -0
  325. package/src/primitives/overlay/strategies/live-announcer/polite.spec.ts +21 -0
  326. package/src/primitives/overlay/strategies/live-announcer/polite.ts +11 -0
  327. package/src/primitives/overlay/strategies/live-announcer/silent.spec.ts +12 -0
  328. package/src/primitives/overlay/strategies/live-announcer/silent.ts +5 -0
  329. package/src/primitives/overlay/strategies/mount/body-portal.spec.ts +40 -0
  330. package/src/primitives/overlay/strategies/mount/body-portal.ts +91 -0
  331. package/src/primitives/overlay/strategies/mount/in-container.spec.ts +43 -0
  332. package/src/primitives/overlay/strategies/mount/in-container.ts +39 -0
  333. package/src/primitives/overlay/strategies/mount/in-place.spec.ts +40 -0
  334. package/src/primitives/overlay/strategies/mount/in-place.ts +20 -0
  335. package/src/primitives/overlay/strategies/position/anchored-to.spec.ts +56 -0
  336. package/src/primitives/overlay/strategies/position/anchored-to.ts +248 -0
  337. package/src/primitives/overlay/strategies/position/corner.spec.ts +36 -0
  338. package/src/primitives/overlay/strategies/position/corner.ts +33 -0
  339. package/src/primitives/overlay/strategies/position/edge-sheet.spec.ts +32 -0
  340. package/src/primitives/overlay/strategies/position/edge-sheet.ts +36 -0
  341. package/src/primitives/overlay/strategies/position/in-place-sibling.spec.ts +25 -0
  342. package/src/primitives/overlay/strategies/position/in-place-sibling.ts +13 -0
  343. package/src/primitives/overlay/strategies/position/point-at.spec.ts +40 -0
  344. package/src/primitives/overlay/strategies/position/point-at.ts +34 -0
  345. package/src/primitives/overlay/strategies/position/viewport-centered.spec.ts +31 -0
  346. package/src/primitives/overlay/strategies/position/viewport-centered.ts +31 -0
  347. package/src/primitives/overlay/strategies/scroll-lock/css-clip.spec.ts +15 -0
  348. package/src/primitives/overlay/strategies/scroll-lock/css-clip.ts +39 -0
  349. package/src/primitives/overlay/strategies/scroll-lock/html-overflow.spec.ts +21 -0
  350. package/src/primitives/overlay/strategies/scroll-lock/html-overflow.ts +44 -0
  351. package/src/primitives/overlay/strategies/scroll-lock/none.spec.ts +9 -0
  352. package/src/primitives/overlay/strategies/scroll-lock/none.ts +5 -0
  353. package/src/primitives/overlay/strategies/trigger-event/on-click.spec.ts +32 -0
  354. package/src/primitives/overlay/strategies/trigger-event/on-click.ts +28 -0
  355. package/src/primitives/overlay/strategies/trigger-event/on-context-menu.spec.ts +45 -0
  356. package/src/primitives/overlay/strategies/trigger-event/on-context-menu.ts +70 -0
  357. package/src/primitives/overlay/strategies/trigger-event/on-focus-or-input.spec.ts +35 -0
  358. package/src/primitives/overlay/strategies/trigger-event/on-focus-or-input.ts +34 -0
  359. package/src/primitives/overlay/strategies/trigger-event/on-focus.spec.ts +64 -0
  360. package/src/primitives/overlay/strategies/trigger-event/on-focus.ts +37 -0
  361. package/src/primitives/overlay/strategies/trigger-event/on-hotkey.spec.ts +37 -0
  362. package/src/primitives/overlay/strategies/trigger-event/on-hotkey.ts +59 -0
  363. package/src/primitives/overlay/strategies/trigger-event/on-hover.spec.ts +34 -0
  364. package/src/primitives/overlay/strategies/trigger-event/on-hover.ts +86 -0
  365. package/src/primitives/overlay/strategies/trigger-event/programmatic.spec.ts +16 -0
  366. package/src/primitives/overlay/strategies/trigger-event/programmatic.ts +12 -0
  367. package/src/primitives/overlay/tokens.ts +54 -0
  368. package/src/primitives/overlay/trigger.spec.ts +103 -0
  369. package/src/primitives/overlay/trigger.ts +75 -0
  370. package/src/primitives/overlay/types.ts +24 -0
  371. package/src/primitives/overlay/wrapper.ts +50 -0
  372. package/src/primitives/signals/deep-signal.ts +109 -0
  373. package/src/primitives/signals/index.ts +1 -0
  374. package/src/progress-bar/config.ts +48 -0
  375. package/src/progress-bar/index.ts +12 -0
  376. package/src/progress-bar/progress-bar-fill.ts +37 -0
  377. package/src/progress-bar/progress-bar.context.ts +34 -0
  378. package/src/progress-bar/progress-bar.spec.ts +423 -0
  379. package/src/progress-bar/progress-bar.ts +217 -0
  380. package/src/public-api.ts +58 -9
  381. package/src/radio/radio.ts +14 -3
  382. package/src/select/index.ts +4 -2
  383. package/src/select/select-content.ts +69 -0
  384. package/src/select/select-option.ts +35 -0
  385. package/src/select/select-root.ts +129 -0
  386. package/src/select/select-trigger.ts +93 -0
  387. package/src/select/select.spec.ts +133 -140
  388. package/src/select/select.ts +4 -250
  389. package/src/skeleton/index.ts +5 -0
  390. package/src/skeleton/skeleton.spec.ts +115 -0
  391. package/src/skeleton/skeleton.ts +56 -0
  392. package/src/slider/index.ts +10 -0
  393. package/src/slider/slider-range.ts +49 -0
  394. package/src/slider/slider-thumb.ts +335 -0
  395. package/src/slider/slider-track.ts +70 -0
  396. package/src/slider/slider.context.ts +79 -0
  397. package/src/slider/slider.geometry.ts +73 -0
  398. package/src/slider/slider.spec.ts +216 -0
  399. package/src/slider/slider.ts +443 -0
  400. package/src/speed-dial/index.ts +10 -0
  401. package/src/speed-dial/speed-dial-action.ts +40 -0
  402. package/src/speed-dial/speed-dial-actions.ts +31 -0
  403. package/src/speed-dial/speed-dial-trigger.ts +55 -0
  404. package/src/speed-dial/speed-dial.context.ts +36 -0
  405. package/src/speed-dial/speed-dial.spec.ts +143 -0
  406. package/src/speed-dial/speed-dial.ts +127 -0
  407. package/src/spinner/config.ts +48 -0
  408. package/src/spinner/index.ts +8 -0
  409. package/src/spinner/spinner.spec.ts +262 -0
  410. package/src/spinner/spinner.ts +129 -0
  411. package/src/stepper/index.ts +15 -0
  412. package/src/stepper/stepper.context.ts +63 -0
  413. package/src/stepper/stepper.spec.ts +403 -0
  414. package/src/stepper/stepper.ts +544 -0
  415. package/src/styles.css +17 -0
  416. package/src/table/column-helpers.spec.ts +74 -0
  417. package/src/table/column-helpers.ts +68 -0
  418. package/src/table/filter-fns.ts +230 -0
  419. package/src/table/filter-models.spec.ts +240 -0
  420. package/src/table/filter-models.ts +124 -0
  421. package/src/table/filter-params.ts +90 -0
  422. package/src/table/grid-api-impl.ts +321 -0
  423. package/src/table/grid-api.spec.ts +178 -0
  424. package/src/table/grid-api.ts +285 -0
  425. package/src/table/index.ts +73 -1
  426. package/src/table/table-cell.spec.ts +43 -0
  427. package/src/table/table-cell.ts +38 -0
  428. package/src/table/table-filter-outlet.ts +120 -0
  429. package/src/table/table-header.spec.ts +54 -0
  430. package/src/table/table-header.ts +63 -0
  431. package/src/table/table-keyboard.spec.ts +68 -0
  432. package/src/table/table-keyboard.ts +107 -0
  433. package/src/table/table-resource.spec.ts +37 -0
  434. package/src/table/table-resource.ts +36 -0
  435. package/src/table/table-row.spec.ts +54 -0
  436. package/src/table/table-row.ts +31 -0
  437. package/src/table/table-storage.spec.ts +67 -0
  438. package/src/table/table-storage.ts +76 -0
  439. package/src/table/table.spec.ts +101 -42
  440. package/src/table/table.ts +228 -73
  441. package/src/table/table.types.ts +83 -0
  442. package/src/tabs/index.ts +7 -2
  443. package/src/tabs/tabs.context.ts +27 -4
  444. package/src/tabs/tabs.spec.ts +336 -24
  445. package/src/tabs/tabs.ts +313 -79
  446. package/src/tag/config.ts +53 -0
  447. package/src/tag/index.ts +7 -0
  448. package/src/tag/tag-list.ts +76 -0
  449. package/src/tag/tag-remove.ts +61 -0
  450. package/src/tag/tag.context.ts +36 -0
  451. package/src/tag/tag.spec.ts +240 -0
  452. package/src/tag/tag.ts +203 -0
  453. package/src/textarea/config.ts +42 -0
  454. package/src/textarea/index.ts +8 -0
  455. package/src/textarea/textarea.spec.ts +176 -0
  456. package/src/textarea/textarea.ts +235 -0
  457. package/src/time-picker/index.ts +15 -0
  458. package/src/time-picker/time-picker-meridiem.ts +123 -0
  459. package/src/time-picker/time-picker-segment.ts +318 -0
  460. package/src/time-picker/time-picker.context.ts +38 -0
  461. package/src/time-picker/time-picker.format.ts +181 -0
  462. package/src/time-picker/time-picker.spec.ts +189 -0
  463. package/src/time-picker/time-picker.ts +274 -0
  464. package/src/toast/_examples/index.ts +5 -0
  465. package/src/toast/_examples/toast.example.ts +282 -0
  466. package/src/toast/_examples/toast.finance.example.ts +180 -0
  467. package/src/toast/_examples/toast.retro.example.ts +161 -0
  468. package/src/toast/index.ts +8 -1
  469. package/src/toast/toast.ref.ts +26 -0
  470. package/src/toast/toast.service.ts +227 -41
  471. package/src/toast/toast.spec.ts +166 -14
  472. package/src/toast/toast.strategy.ts +10 -0
  473. package/src/toast/toast.ts +177 -21
  474. package/src/toggle/toggle.ts +10 -2
  475. package/src/tooltip/_examples/index.ts +6 -0
  476. package/src/tooltip/_examples/tooltip.example.ts +82 -0
  477. package/src/tooltip/_examples/tooltip.finance.example.ts +97 -0
  478. package/src/tooltip/_examples/tooltip.placements.example.ts +83 -0
  479. package/src/tooltip/_examples/tooltip.retro.example.ts +107 -0
  480. package/src/tooltip/index.ts +4 -5
  481. package/src/tooltip/tooltip-arrow.ts +31 -0
  482. package/src/tooltip/tooltip-content.ts +38 -0
  483. package/src/tooltip/tooltip-group.ts +32 -0
  484. package/src/tooltip/tooltip-trigger.ts +47 -0
  485. package/src/tooltip/tooltip.spec.ts +38 -102
  486. package/src/tooltip/tooltip.ts +5 -129
  487. package/src/tree-select/index.ts +12 -0
  488. package/src/tree-select/tree-select-content.ts +199 -0
  489. package/src/tree-select/tree-select-node.ts +132 -0
  490. package/src/tree-select/tree-select-root.ts +272 -0
  491. package/src/tree-select/tree-select-trigger.ts +90 -0
  492. package/src/tree-select/tree-select.context.ts +63 -0
  493. package/src/tree-select/tree-select.spec.ts +433 -0
  494. package/src/tree-select/tree-select.ts +2 -0
  495. package/src/typography/blockquote.ts +57 -0
  496. package/src/typography/code.ts +53 -0
  497. package/src/typography/index.ts +22 -0
  498. package/src/typography/lead.ts +49 -0
  499. package/src/typography/muted.ts +29 -0
  500. package/src/typography/prose.css +312 -0
  501. package/src/typography/truncate.ts +99 -0
  502. package/src/typography/typography.spec.ts +203 -0
  503. package/tsconfig.lib.json +9 -1
  504. package/tsconfig.lib.prod.json +7 -1
  505. package/tsconfig.spec.json +9 -1
  506. package/vite.config.ts +8 -0
  507. package/src/button/button.example.ts +0 -30
  508. package/src/button/button.finance.example.ts +0 -37
  509. package/src/button/button.retro.example.ts +0 -47
  510. package/src/button/button.sizes.example.ts +0 -25
  511. package/src/dialog/dialog.confirm.example.ts +0 -57
  512. package/src/dialog/dialog.context.ts +0 -11
  513. package/src/dialog/dialog.example.ts +0 -40
  514. package/src/dialog/dialog.finance.example.ts +0 -47
  515. package/src/dialog/dialog.retro.example.ts +0 -46
  516. package/src/menu/index.ts +0 -2
  517. package/src/menu/menu.context.ts +0 -10
  518. package/src/menu/menu.example.ts +0 -39
  519. package/src/menu/menu.spec.ts +0 -168
  520. package/src/menu/menu.ts +0 -176
  521. package/src/popover/popover.context.ts +0 -18
  522. package/src/popover/popover.example.ts +0 -50
  523. package/src/popover/popover.finance.example.ts +0 -52
  524. package/src/popover/popover.retro.example.ts +0 -53
  525. package/src/primitives/overlay/overlay.spec.ts +0 -90
  526. package/src/primitives/overlay/overlay.ts +0 -106
  527. package/src/select/select.context.ts +0 -3
  528. package/src/toast/toast.example.ts +0 -134
  529. package/src/toast/toast.finance.example.ts +0 -68
  530. package/src/toast/toast.retro.example.ts +0 -69
  531. package/src/tooltip/tooltip.example.ts +0 -46
  532. package/src/tooltip/tooltip.finance.example.ts +0 -54
  533. package/src/tooltip/tooltip.placements.example.ts +0 -56
  534. package/src/tooltip/tooltip.retro.example.ts +0 -65
@@ -0,0 +1,49 @@
1
+ import { InjectionToken } from '@angular/core';
2
+
3
+ /**
4
+ * Default token alphabet for `KjInputMask`.
5
+ *
6
+ * | Token | Matches |
7
+ * |-------|---------|
8
+ * | `9` | digit `[0-9]` |
9
+ * | `a` | letter `[A-Za-z]` |
10
+ * | `*` | alphanumeric `[A-Za-z0-9]` |
11
+ *
12
+ * Override app-wide by providing `KJ_INPUT_MASK_TOKENS` in `bootstrapApplication`:
13
+ * ```ts
14
+ * provideKjInputMaskTokens({ ...defaultTokens, 'H': /[0-9A-Fa-f]/ })
15
+ * ```
16
+ */
17
+ export const KJ_INPUT_MASK_TOKENS = new InjectionToken<Record<string, RegExp>>(
18
+ 'KjInputMaskTokens',
19
+ {
20
+ providedIn: 'root',
21
+ factory: () => ({
22
+ '9': /[0-9]/,
23
+ 'a': /[A-Za-z]/,
24
+ '*': /[A-Za-z0-9]/,
25
+ }),
26
+ },
27
+ );
28
+
29
+ /** Default token map — exported for consumers who want to spread into custom maps. */
30
+ export const defaultMaskTokens: Record<string, RegExp> = {
31
+ '9': /[0-9]/,
32
+ 'a': /[A-Za-z]/,
33
+ '*': /[A-Za-z0-9]/,
34
+ };
35
+
36
+ /**
37
+ * Helper to provide a custom token alphabet app-wide.
38
+ * @example
39
+ * ```ts
40
+ * bootstrapApplication(AppComponent, {
41
+ * providers: [
42
+ * provideKjInputMaskTokens({ ...defaultMaskTokens, 'H': /[0-9A-Fa-f]/ }),
43
+ * ],
44
+ * });
45
+ * ```
46
+ */
47
+ export function provideKjInputMaskTokens(tokens: Record<string, RegExp>) {
48
+ return { provide: KJ_INPUT_MASK_TOKENS, useValue: tokens };
49
+ }
@@ -0,0 +1,280 @@
1
+ import {
2
+ AbstractControl,
3
+ NG_VALIDATORS,
4
+ ValidationErrors,
5
+ Validator,
6
+ } from '@angular/forms';
7
+ import {
8
+ Directive,
9
+ ElementRef,
10
+ booleanAttribute,
11
+ computed,
12
+ effect,
13
+ forwardRef,
14
+ inject,
15
+ input,
16
+ output,
17
+ } from '@angular/core';
18
+
19
+ import { KjInput } from '../input/input';
20
+ import { compileMask } from './input-mask.compile';
21
+ import { MaskEngine } from './input-mask.engine';
22
+ import { KJ_INPUT_MASK_TOKENS } from './input-mask.tokens';
23
+
24
+ /**
25
+ * Applies a fixed-format mask to a native `<input>` element. Composes
26
+ * `KjInput` via `hostDirectives` so all Angular forms integration (CVA,
27
+ * `aria-invalid`, focus-ring, ARIA-disabled) applies unchanged.
28
+ *
29
+ * Supports `[(ngModel)]`, `[formControl]`, and `[formControlName]` bindings.
30
+ * By default the model value is the **raw** (unmasked) alphanumerics
31
+ * (`kjMaskMode="unmasked"`). Switch to `kjMaskMode="masked"` to commit the
32
+ * full display string.
33
+ *
34
+ * Provides itself as an `NG_VALIDATORS` multi-validator. When the field has
35
+ * been partially filled, `validate()` returns `{ mask: { expected, filled,
36
+ * required } }`. An empty field does **not** trigger the mask error —
37
+ * `Validators.required` handles that.
38
+ *
39
+ * @example
40
+ * ```html
41
+ * <input kjInputMask kjMask="(999) 999-9999" [(ngModel)]="phone" />
42
+ * ```
43
+ *
44
+ * @doc-category Core/Inputs
45
+ * @doc
46
+ * @doc-name input-mask
47
+ * @doc-description Applies a fixed-format mask to a native input with caret handling and partial-fill validation.
48
+ * @doc-is-main
49
+ */
50
+ @Directive({
51
+ selector: 'input[kjInputMask]',
52
+ standalone: true,
53
+ exportAs: 'kjInputMask',
54
+ hostDirectives: [
55
+ // KjInput already composes KjDisabled internally — do NOT add KjDisabled
56
+ // here or it will match twice on the same element (NG0309).
57
+ // kjDisabled is forwarded via our own input below and bound via the
58
+ // KjDisabled instance injected from the host directive chain.
59
+ { directive: KjInput, inputs: ['kjInvalid'] },
60
+ ],
61
+ providers: [
62
+ {
63
+ provide: NG_VALIDATORS,
64
+ useExisting: forwardRef(() => KjInputMask),
65
+ multi: true,
66
+ },
67
+ ],
68
+ host: {
69
+ // Force type="text" — partially-masked values fail browser validation
70
+ // for tel/email/number types, and autofill behaves better with text.
71
+ '[attr.type]': '"text"',
72
+ '[attr.inputmode]': 'autoInputMode()',
73
+ '[attr.placeholder]': 'displayPlaceholder()',
74
+ '(keydown)': 'engine.onKeydown($event)',
75
+ '(paste)': 'engine.onPaste($event)',
76
+ '(beforeinput)': 'engine.onBeforeInput($event)',
77
+ '(compositionstart)': 'engine.onCompositionStart()',
78
+ '(compositionend)': 'engine.onCompositionEnd($event)',
79
+ },
80
+ })
81
+ export class KjInputMask implements Validator {
82
+ private readonly el = inject<ElementRef<HTMLInputElement>>(ElementRef);
83
+ private readonly kjInput = inject(KjInput);
84
+ private readonly defaultTokens = inject(KJ_INPUT_MASK_TOKENS);
85
+
86
+ // ── Inputs ────────────────────────────────────────────────────────────
87
+
88
+ /** Mask template, e.g. `'(999) 999-9999'`, `'99/99/9999'`. Required. */
89
+ readonly kjMask = input.required<string>();
90
+
91
+ /**
92
+ * Per-instance token overrides. Merged on top of `KJ_INPUT_MASK_TOKENS`
93
+ * — entries here win. Use `provideKjInputMaskTokens` to set app-wide tokens.
94
+ */
95
+ readonly kjMaskTokens = input<Record<string, RegExp>>({});
96
+
97
+ /**
98
+ * What value is committed to the FormControl.
99
+ * - `'unmasked'` (default) — raw alphanumerics only: `"4155551234"`.
100
+ * - `'masked'` — full display string: `"(415) 555-1234"`.
101
+ */
102
+ readonly kjMaskMode = input<'unmasked' | 'masked'>('unmasked');
103
+
104
+ /** Placeholder character shown in unfilled variable slots. @default '_' */
105
+ readonly kjSlotChar = input<string>('_');
106
+
107
+ /**
108
+ * Forwarded to the inherited `KjDisabled` directive. Setting this disables
109
+ * the input via `aria-disabled` / `data-disabled`.
110
+ * @default false
111
+ */
112
+ readonly kjDisabled = input(false, { transform: booleanAttribute });
113
+
114
+ /**
115
+ * When `true`, the field value is cleared on blur if the mask is incomplete.
116
+ * Defaults to `false` — see analysis doc for rationale.
117
+ */
118
+ readonly kjAutoClear = input(false, { transform: booleanAttribute });
119
+
120
+ /**
121
+ * Override the auto-generated screen-reader format hint. Set to `''` to
122
+ * suppress it entirely (when `KjField`'s hint slot already covers the format).
123
+ */
124
+ readonly kjFormatHint = input<string | undefined>(undefined);
125
+
126
+ // ── Outputs ──────────────────────────────────────────────────────────
127
+
128
+ /**
129
+ * Emits once when every variable slot is filled.
130
+ * Re-emits if the user clears and re-fills.
131
+ * Useful for auto-advancing focus in card-entry UX.
132
+ */
133
+ readonly kjComplete = output<void>();
134
+
135
+ // ── Computed state ───────────────────────────────────────────────────
136
+
137
+ /** Compiled mask — recomputed when `kjMask` or `kjMaskTokens` change. */
138
+ readonly compiled = computed(() =>
139
+ compileMask(this.kjMask(), {
140
+ ...this.defaultTokens,
141
+ ...this.kjMaskTokens(),
142
+ }),
143
+ );
144
+
145
+ /**
146
+ * `inputmode` attribute — `'numeric'` when all variable slots are digit-only,
147
+ * `'text'` otherwise. Mobile browsers show the right keyboard.
148
+ */
149
+ readonly autoInputMode = computed<string>(() => {
150
+ const { slots, variableIndices } = this.compiled();
151
+ if (variableIndices.length === 0) return 'text';
152
+ const allDigit = variableIndices.every(i => {
153
+ const slot = slots[i];
154
+ return slot.kind === 'variable' && slot.tokenId === '9';
155
+ });
156
+ return allDigit ? 'numeric' : 'text';
157
+ });
158
+
159
+ /**
160
+ * Placeholder string shown when no value is entered — literals keep their
161
+ * characters, variable slots show `kjSlotChar`.
162
+ */
163
+ readonly displayPlaceholder = computed<string>(() => {
164
+ const { slots } = this.compiled();
165
+ const slotChar = this.kjSlotChar();
166
+ return slots
167
+ .map(slot => (slot.kind === 'literal' ? slot.char : slotChar))
168
+ .join('');
169
+ });
170
+
171
+ /** The MaskEngine instance — stateful per-directive. */
172
+ readonly engine: MaskEngine;
173
+
174
+ // Track whether completion was already emitted for the current fill cycle.
175
+ private _wasComplete = false;
176
+
177
+ constructor() {
178
+ const el = this.el;
179
+ const formCtrl = this.kjInput.formCtrl;
180
+
181
+ this.engine = new MaskEngine({
182
+ getCompiled: () => this.compiled(),
183
+ getSlotChar: () => this.kjSlotChar(),
184
+ getMaskMode: () => this.kjMaskMode(),
185
+ callbacks: {
186
+ getValue: () => el.nativeElement.value,
187
+ setValue: (val) => { el.nativeElement.value = val; },
188
+ getCaret: () => el.nativeElement.selectionStart ?? 0,
189
+ setCaret: (pos) => {
190
+ // requestAnimationFrame defers the caret move so it runs after the
191
+ // browser's own value-update microtask; without this, some browsers
192
+ // reset selectionStart back to 0 after we set the value.
193
+ requestAnimationFrame(() => {
194
+ el.nativeElement.setSelectionRange(pos, pos);
195
+ });
196
+ },
197
+ notifyChange: (val) => {
198
+ formCtrl.notifyChange(val);
199
+ // Check completion
200
+ const { variableIndices } = this.compiled();
201
+ const display = el.nativeElement.value;
202
+ const slotChar = this.kjSlotChar();
203
+ const filled = variableIndices.filter(i => {
204
+ const ch = display[i];
205
+ return ch && ch !== slotChar;
206
+ }).length;
207
+ const isComplete = filled === variableIndices.length;
208
+ if (isComplete && !this._wasComplete) {
209
+ this._wasComplete = true;
210
+ this.kjComplete.emit();
211
+ } else if (!isComplete) {
212
+ this._wasComplete = false;
213
+ }
214
+ },
215
+ },
216
+ });
217
+
218
+ // Reflect the form control value → display string (e.g. from setValue() calls).
219
+ effect(() => {
220
+ const val = formCtrl.value();
221
+ if (val == null || val === undefined) return;
222
+ const raw = String(val);
223
+ this.engine.applyRawValue(raw);
224
+ });
225
+
226
+ // Auto-clear on blur if incomplete and kjAutoClear is enabled.
227
+ el.nativeElement.addEventListener('blur', () => {
228
+ if (!this.kjAutoClear()) return;
229
+ const errors = this._computeErrors();
230
+ if (errors) {
231
+ el.nativeElement.value = this.displayPlaceholder();
232
+ formCtrl.notifyChange('');
233
+ this._wasComplete = false;
234
+ }
235
+ });
236
+ }
237
+
238
+ // ── Validator ────────────────────────────────────────────────────────
239
+
240
+ /** @internal — called by Angular forms. */
241
+ validate(_control: AbstractControl): ValidationErrors | null {
242
+ return this._computeErrors();
243
+ }
244
+
245
+ private _computeErrors(): ValidationErrors | null {
246
+ const { variableIndices } = this.compiled();
247
+ const display = this.el.nativeElement.value;
248
+ const slotChar = this.kjSlotChar();
249
+ const mode = this.kjMaskMode();
250
+
251
+ // Determine how many variable slots are filled in the current display.
252
+ const filledCount = variableIndices.filter(i => {
253
+ const ch = display[i];
254
+ return ch && ch !== slotChar;
255
+ }).length;
256
+
257
+ // Empty (no filled slots) — let Validators.required handle it.
258
+ if (filledCount === 0) return null;
259
+
260
+ // If using unmasked mode, the control value is the raw string. Recalculate
261
+ // filled from the control value length vs. variableCount.
262
+ let effectiveFilled = filledCount;
263
+ if (mode === 'unmasked') {
264
+ const raw = String(this.kjInput.formCtrl.value() ?? '');
265
+ effectiveFilled = Math.min(raw.length, variableIndices.length);
266
+ }
267
+
268
+ if (effectiveFilled < variableIndices.length) {
269
+ return {
270
+ mask: {
271
+ expected: this.kjMask(),
272
+ filled: effectiveFilled,
273
+ required: variableIndices.length,
274
+ },
275
+ };
276
+ }
277
+
278
+ return null;
279
+ }
280
+ }
@@ -0,0 +1,2 @@
1
+ export { KjInputOtp, KjInputOtpCell } from './input-otp';
2
+ export { KJ_INPUT_OTP, type KjInputOtpContext } from './input-otp.context';
@@ -0,0 +1,41 @@
1
+ import { InjectionToken, Signal } from '@angular/core';
2
+
3
+ /**
4
+ * Context shared between the root `KjInputOtp` directive and each
5
+ * `KjInputOtpCell` leaf directive. Provided via `KJ_INPUT_OTP` on the
6
+ * root element and injected by every cell.
7
+ */
8
+ export interface KjInputOtpContext {
9
+ /** The full concatenated OTP value. */
10
+ value: Signal<string>;
11
+ /** Total number of cells. */
12
+ length: Signal<number>;
13
+ /** Whether the widget is disabled (union of kjDisabled + form-level disable). */
14
+ disabled: Signal<boolean>;
15
+ /** Whether the widget is read-only. */
16
+ readonly: Signal<boolean>;
17
+ /** Whether cells should render as `type="password"`. */
18
+ masked: Signal<boolean>;
19
+ /** Character set restriction — drives inputmode, pattern, and filter logic. */
20
+ charSet: Signal<'digits' | 'alphanumeric' | RegExp>;
21
+ /** Index of the currently focused cell, or -1 if none. */
22
+ focusedIndex: Signal<number>;
23
+
24
+ /** Called by a cell to push its new single character (or '' for clear) upstream. */
25
+ setCellValue(index: number, char: string): void;
26
+ /** Called by a cell to request focus movement by delta (+1 / -1). */
27
+ moveFocus(delta: number): void;
28
+ /** Called by a cell to request focus on a specific index (clamped). */
29
+ focusIndex(index: number): void;
30
+ /** Called by a cell when a paste event occurs; distributes chars from `fromIndex`. */
31
+ handlePaste(event: ClipboardEvent, fromIndex: number): void;
32
+ /** Called by a cell when a copy event occurs; writes the full code to clipboard. */
33
+ handleCopy(event: ClipboardEvent): void;
34
+ /** Called by a cell in ngOnInit to register its native input element. */
35
+ registerCell(index: number, el: HTMLInputElement): void;
36
+ /** Called by a cell in ngOnDestroy to deregister its element. */
37
+ unregisterCell(index: number): void;
38
+ }
39
+
40
+ /** Injection token for the `KjInputOtpContext`. */
41
+ export const KJ_INPUT_OTP = new InjectionToken<KjInputOtpContext>('KjInputOtp');
@@ -0,0 +1,308 @@
1
+ import { Component, signal, ChangeDetectionStrategy } from '@angular/core';
2
+ import { render, fireEvent } from '@testing-library/angular';
3
+ import { FormsModule } from '@angular/forms';
4
+ import { KjInputOtp, KjInputOtpCell } from './input-otp';
5
+
6
+ // ── Test host component ───────────────────────────────────────────────────────
7
+
8
+ @Component({
9
+ selector: 'kj-test-host',
10
+ standalone: true,
11
+ imports: [KjInputOtp, KjInputOtpCell, FormsModule],
12
+ changeDetection: ChangeDetectionStrategy.Eager,
13
+ template: `
14
+ <div
15
+ kjInputOtp
16
+ [kjLength]="length()"
17
+ [kjCharSet]="charSet()"
18
+ [kjMask]="masked()"
19
+ [(ngModel)]="value"
20
+ >
21
+ @for (i of cells(); track i) {
22
+ <input kjInputOtpCell [kjIndex]="i" />
23
+ }
24
+ </div>
25
+ `,
26
+ })
27
+ class TestHost {
28
+ value = '';
29
+ readonly length = signal(6);
30
+ readonly charSet = signal<'digits' | 'alphanumeric'>('digits');
31
+ readonly masked = signal(false);
32
+ readonly cells = signal([0, 1, 2, 3, 4, 5]);
33
+ }
34
+
35
+ // ── Helpers ───────────────────────────────────────────────────────────────────
36
+
37
+ async function setup() {
38
+ const result = await render(TestHost, {});
39
+ return result;
40
+ }
41
+
42
+ function getInputs(container: HTMLElement): HTMLInputElement[] {
43
+ return Array.from(container.querySelectorAll('input[kjInputOtpCell]'));
44
+ }
45
+
46
+ // ── Tests ─────────────────────────────────────────────────────────────────────
47
+
48
+ describe('KjInputOtp + KjInputOtpCell', () => {
49
+ describe('rendering', () => {
50
+ it('renders 6 cells by default', async () => {
51
+ const { container } = await setup();
52
+ expect(getInputs(container)).toHaveLength(6);
53
+ });
54
+
55
+ it('sets role="group" on the root', async () => {
56
+ const { container } = await setup();
57
+ expect(container.querySelector('[role="group"]')).toBeInTheDocument();
58
+ });
59
+
60
+ it('sets autocomplete="one-time-code" on cell 0 only', async () => {
61
+ const { container } = await setup();
62
+ const inputs = getInputs(container);
63
+ expect(inputs[0].getAttribute('autocomplete')).toBe('one-time-code');
64
+ expect(inputs[1].getAttribute('autocomplete')).toBe('off');
65
+ });
66
+
67
+ it('sets inputmode="numeric" for digits charSet', async () => {
68
+ const { container } = await setup();
69
+ const inputs = getInputs(container);
70
+ expect(inputs[0].getAttribute('inputmode')).toBe('numeric');
71
+ });
72
+
73
+ it('sets correct aria-label per cell', async () => {
74
+ const { container } = await setup();
75
+ const inputs = getInputs(container);
76
+ expect(inputs[0].getAttribute('aria-label')).toBe('Code digit 1 of 6');
77
+ expect(inputs[5].getAttribute('aria-label')).toBe('Code digit 6 of 6');
78
+ });
79
+
80
+ it('sets maxlength="1" on each cell', async () => {
81
+ const { container } = await setup();
82
+ const inputs = getInputs(container);
83
+ inputs.forEach((input) => expect(input.getAttribute('maxlength')).toBe('1'));
84
+ });
85
+
86
+ it('sets spellcheck="false" on each cell', async () => {
87
+ const { container } = await setup();
88
+ const inputs = getInputs(container);
89
+ inputs.forEach((input) => expect(input.getAttribute('spellcheck')).toBe('false'));
90
+ });
91
+ });
92
+
93
+ describe('auto-advance', () => {
94
+ it('sets cell value and advances when a valid character is entered', async () => {
95
+ const { container, fixture } = await setup();
96
+ const inputs = getInputs(container);
97
+ inputs[0].focus();
98
+
99
+ // Simulate typing '1' into cell 0.
100
+ // We set the target value before firing (testing-library normalises this).
101
+ Object.defineProperty(inputs[0], 'value', { value: '1', writable: true, configurable: true });
102
+ fireEvent.input(inputs[0], { target: { value: '1' } });
103
+ await fixture.whenStable();
104
+
105
+ // The context should have the char set to '1' in cell 0.
106
+ expect(inputs[0].value).toBe('1');
107
+ });
108
+
109
+ it('ignores non-digit characters when charSet is digits', async () => {
110
+ const { container, fixture } = await setup();
111
+ const inputs = getInputs(container);
112
+ inputs[0].focus();
113
+
114
+ fireEvent.input(inputs[0], { target: { value: 'a' } });
115
+ await fixture.whenStable();
116
+
117
+ // Cell should remain empty since 'a' is rejected.
118
+ expect(inputs[0].value).toBe('');
119
+ });
120
+ });
121
+
122
+ describe('backspace', () => {
123
+ it('clears a cell and moves focus back on backspace when cell is filled', async () => {
124
+ const { container, fixture } = await setup();
125
+ const inputs = getInputs(container);
126
+
127
+ // First fill cell 0 via multi-char input event (iOS autofill path).
128
+ fireEvent.input(inputs[0], { target: { value: '12' } });
129
+ await fixture.whenStable();
130
+
131
+ // Focus cell 1 and press backspace.
132
+ inputs[1].focus();
133
+ fireEvent.keyDown(inputs[1], { key: 'Backspace' });
134
+ await fixture.whenStable();
135
+
136
+ // Cell 1 should now be empty.
137
+ expect(inputs[1].value).toBe('');
138
+ });
139
+
140
+ it('moves to previous cell on backspace when current cell is empty', async () => {
141
+ const { container, fixture } = await setup();
142
+ const inputs = getInputs(container);
143
+
144
+ // Cell 1 is empty; focus it.
145
+ inputs[1].focus();
146
+ fireEvent.keyDown(inputs[1], { key: 'Backspace' });
147
+ await fixture.whenStable();
148
+
149
+ // No error thrown; cell 0 is still in the DOM.
150
+ expect(inputs[0]).toBeInTheDocument();
151
+ });
152
+ });
153
+
154
+ describe('arrow keys', () => {
155
+ it('ArrowLeft and ArrowRight are handled without errors', async () => {
156
+ const { container, fixture } = await setup();
157
+ const inputs = getInputs(container);
158
+ inputs[2].focus();
159
+
160
+ fireEvent.keyDown(inputs[2], { key: 'ArrowLeft' });
161
+ await fixture.whenStable();
162
+ expect(inputs[1]).toBeInTheDocument();
163
+
164
+ fireEvent.keyDown(inputs[1], { key: 'ArrowRight' });
165
+ await fixture.whenStable();
166
+ expect(inputs[2]).toBeInTheDocument();
167
+ });
168
+
169
+ it('Home focuses cell 0', async () => {
170
+ const { container, fixture } = await setup();
171
+ const inputs = getInputs(container);
172
+ inputs[3].focus();
173
+
174
+ fireEvent.keyDown(inputs[3], { key: 'Home' });
175
+ await fixture.whenStable();
176
+
177
+ expect(inputs[0]).toBeInTheDocument();
178
+ });
179
+
180
+ it('End focuses last cell', async () => {
181
+ const { container, fixture } = await setup();
182
+ const inputs = getInputs(container);
183
+ inputs[0].focus();
184
+
185
+ fireEvent.keyDown(inputs[0], { key: 'End' });
186
+ await fixture.whenStable();
187
+
188
+ expect(inputs[5]).toBeInTheDocument();
189
+ });
190
+ });
191
+
192
+ describe('paste distribution (via iOS autofill path)', () => {
193
+ it('distributes multi-char input across cells from index 0', async () => {
194
+ const { container, fixture } = await setup();
195
+ const inputs = getInputs(container);
196
+
197
+ // Simulate iOS autofill: cell 0 receives the full OTP as its input value.
198
+ fireEvent.input(inputs[0], { target: { value: '123456' } });
199
+ await fixture.whenStable();
200
+
201
+ expect(inputs[0].value).toBe('1');
202
+ expect(inputs[1].value).toBe('2');
203
+ expect(inputs[2].value).toBe('3');
204
+ expect(inputs[3].value).toBe('4');
205
+ expect(inputs[4].value).toBe('5');
206
+ expect(inputs[5].value).toBe('6');
207
+ });
208
+
209
+ it('filters non-digit characters when distributing', async () => {
210
+ const { container, fixture } = await setup();
211
+ const inputs = getInputs(container);
212
+
213
+ // '1a2b3c' → only '1', '2', '3' pass the digits filter.
214
+ fireEvent.input(inputs[0], { target: { value: '1a2b3c' } });
215
+ await fixture.whenStable();
216
+
217
+ expect(inputs[0].value).toBe('1');
218
+ expect(inputs[1].value).toBe('2');
219
+ expect(inputs[2].value).toBe('3');
220
+ // Remaining cells stay empty.
221
+ expect(inputs[3].value).toBe('');
222
+ });
223
+
224
+ it('distributes from a mid-cell index', async () => {
225
+ const { container, fixture } = await setup();
226
+ const inputs = getInputs(container);
227
+
228
+ // First fill cells 0+1 via multi-char from cell 0.
229
+ fireEvent.input(inputs[0], { target: { value: '12' } });
230
+ await fixture.whenStable();
231
+
232
+ // Then paste '345' from cell 2.
233
+ fireEvent.input(inputs[2], { target: { value: '345' } });
234
+ await fixture.whenStable();
235
+
236
+ expect(inputs[2].value).toBe('3');
237
+ expect(inputs[3].value).toBe('4');
238
+ expect(inputs[4].value).toBe('5');
239
+ });
240
+ });
241
+
242
+ describe('completion', () => {
243
+ it('fills all cells when a 6-char value is distributed from cell 0', async () => {
244
+ const { container, fixture } = await setup();
245
+ const inputs = getInputs(container);
246
+
247
+ fireEvent.input(inputs[0], { target: { value: '123456' } });
248
+ await fixture.whenStable();
249
+
250
+ // All 6 cells should have their respective digits.
251
+ expect(inputs[0].value).toBe('1');
252
+ expect(inputs[5].value).toBe('6');
253
+ });
254
+ });
255
+
256
+ describe('mask mode', () => {
257
+ it('sets type="password" when kjMask is true', async () => {
258
+ const { container, fixture } = await render(TestHost, {});
259
+ const comp = fixture.componentInstance as TestHost;
260
+ comp.masked.set(true);
261
+ fixture.detectChanges();
262
+ await fixture.whenStable();
263
+
264
+ const inputs = getInputs(container);
265
+ inputs.forEach((input) => expect(input.type).toBe('password'));
266
+ });
267
+
268
+ it('uses type="text" by default', async () => {
269
+ const { container } = await setup();
270
+ const inputs = getInputs(container);
271
+ inputs.forEach((input) => expect(input.type).toBe('text'));
272
+ });
273
+ });
274
+
275
+ describe('tab stop', () => {
276
+ it('first cell has tabindex="0" when all cells are empty', async () => {
277
+ const { container } = await setup();
278
+ const inputs = getInputs(container);
279
+ expect(inputs[0].getAttribute('tabindex')).toBe('0');
280
+ expect(inputs[1].getAttribute('tabindex')).toBe('-1');
281
+ });
282
+
283
+ it('all non-first cells have tabindex="-1"', async () => {
284
+ const { container } = await setup();
285
+ const inputs = getInputs(container);
286
+ for (let i = 1; i < inputs.length; i++) {
287
+ expect(inputs[i].getAttribute('tabindex')).toBe('-1');
288
+ }
289
+ });
290
+ });
291
+
292
+ describe('delete key', () => {
293
+ it('clears a filled cell without moving focus', async () => {
294
+ const { container, fixture } = await setup();
295
+ const inputs = getInputs(container);
296
+
297
+ // Fill cell 0.
298
+ fireEvent.input(inputs[0], { target: { value: '5' } });
299
+ await fixture.whenStable();
300
+
301
+ inputs[0].focus();
302
+ fireEvent.keyDown(inputs[0], { key: 'Delete' });
303
+ await fixture.whenStable();
304
+
305
+ expect(inputs[0].value).toBe('');
306
+ });
307
+ });
308
+ });