@krizaka/ui 3.54.0 → 3.59.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 (814) hide show
  1. package/README.md +1 -0
  2. package/dist/{RotatingWord-D9s7FXFD.d.ts → RotatingWord-COSabR2c.d.ts} +2 -1
  3. package/dist/account-menu.d.ts +8 -3
  4. package/dist/account-menu.js +8 -1
  5. package/dist/account-menu.js.map +1 -1
  6. package/dist/account-settings.d.ts +153 -61
  7. package/dist/account-settings.js +243 -160
  8. package/dist/account-settings.js.map +1 -1
  9. package/dist/achievement.d.ts +2 -1
  10. package/dist/action-bar.d.ts +3 -2
  11. package/dist/activity-feed.d.ts +2 -1
  12. package/dist/agenda.d.ts +2 -1
  13. package/dist/alert.d.ts +2 -1
  14. package/dist/anatomy-plate.d.ts +6 -2
  15. package/dist/anatomy-plate.js +4 -0
  16. package/dist/anatomy-plate.js.map +1 -1
  17. package/dist/app-header/search.d.ts +64 -0
  18. package/dist/app-header/search.js +70 -0
  19. package/dist/app-header/search.js.map +1 -0
  20. package/dist/app-header.d.ts +89 -4
  21. package/dist/app-header.js +63 -5
  22. package/dist/app-header.js.map +1 -1
  23. package/dist/app-shell.d.ts +26 -25
  24. package/dist/app-shell.js +31 -40
  25. package/dist/app-shell.js.map +1 -1
  26. package/dist/argument-card.d.ts +3 -2
  27. package/dist/argument-card.js +3 -3
  28. package/dist/audio-player.d.ts +2 -1
  29. package/dist/auth-layout.d.ts +11 -10
  30. package/dist/avatar/defaults.d.ts +2 -1
  31. package/dist/avatar.d.ts +2 -1
  32. package/dist/badge.d.ts +2 -1
  33. package/dist/bird-plate.d.ts +7 -3
  34. package/dist/bird-plate.js +2 -2
  35. package/dist/bird-plate.js.map +1 -1
  36. package/dist/blocks.css +235 -27
  37. package/dist/button.d.ts +2 -1
  38. package/dist/captcha.d.ts +2 -1
  39. package/dist/captcha.js +1 -0
  40. package/dist/captcha.js.map +1 -1
  41. package/dist/card-grid.d.ts +2 -1
  42. package/dist/card.d.ts +2 -1
  43. package/dist/catalogue-page.d.ts +82 -2
  44. package/dist/catalogue-page.js +156 -13
  45. package/dist/catalogue-page.js.map +1 -1
  46. package/dist/changelog-page.d.ts +2 -1
  47. package/dist/chapter.d.ts +2 -1
  48. package/dist/chat.d.ts +14 -13
  49. package/dist/chat.js +2 -2
  50. package/dist/chat.js.map +1 -1
  51. package/dist/checkbox.d.ts +2 -1
  52. package/dist/checkbox.js +1 -1
  53. package/dist/checkbox.js.map +1 -1
  54. package/dist/chip-link.d.ts +2 -1
  55. package/dist/chip-row.d.ts +8 -7
  56. package/dist/chip.d.ts +55 -1
  57. package/dist/chip.js +14 -98
  58. package/dist/chip.js.map +1 -1
  59. package/dist/choice-grid.d.ts +3 -2
  60. package/dist/choice-grid.js +28 -88
  61. package/dist/choice-grid.js.map +1 -1
  62. package/dist/chunk-27AWSJTK.js +46 -0
  63. package/dist/chunk-27AWSJTK.js.map +1 -0
  64. package/dist/{chunk-YGIN2YIY.js → chunk-3X3OF4TI.js} +2 -2
  65. package/dist/chunk-3X3OF4TI.js.map +1 -0
  66. package/dist/{chunk-KBQD6HE3.js → chunk-4GQH27IT.js} +3 -3
  67. package/dist/{chunk-KBQD6HE3.js.map → chunk-4GQH27IT.js.map} +1 -1
  68. package/dist/{chunk-YHKTYFOQ.js → chunk-5LANVCK7.js} +383 -107
  69. package/dist/chunk-5LANVCK7.js.map +1 -0
  70. package/dist/{chunk-KDXRYUD3.js → chunk-5QEXOGO2.js} +3 -1
  71. package/dist/{chunk-KDXRYUD3.js.map → chunk-5QEXOGO2.js.map} +1 -1
  72. package/dist/chunk-5VEVYDVC.js +11 -0
  73. package/dist/chunk-5VEVYDVC.js.map +1 -0
  74. package/dist/chunk-7J2L4HOD.js +340 -0
  75. package/dist/chunk-7J2L4HOD.js.map +1 -0
  76. package/dist/chunk-BDIU5LZB.js +18 -0
  77. package/dist/chunk-BDIU5LZB.js.map +1 -0
  78. package/dist/chunk-BQ4EOR2O.js +177 -0
  79. package/dist/chunk-BQ4EOR2O.js.map +1 -0
  80. package/dist/chunk-CSRKYZ53.js +39 -0
  81. package/dist/chunk-CSRKYZ53.js.map +1 -0
  82. package/dist/chunk-F6JTHPHE.js +399 -0
  83. package/dist/chunk-F6JTHPHE.js.map +1 -0
  84. package/dist/chunk-HEKDKM5Y.js +128 -0
  85. package/dist/chunk-HEKDKM5Y.js.map +1 -0
  86. package/dist/chunk-KGLRZMCY.js +16 -0
  87. package/dist/chunk-KGLRZMCY.js.map +1 -0
  88. package/dist/chunk-KID32IRJ.js +18 -0
  89. package/dist/chunk-KID32IRJ.js.map +1 -0
  90. package/dist/chunk-OGWB76BR.js +90 -0
  91. package/dist/chunk-OGWB76BR.js.map +1 -0
  92. package/dist/{chunk-4LYKBSOG.js → chunk-USPOIQV5.js} +2 -2
  93. package/dist/chunk-USPOIQV5.js.map +1 -0
  94. package/dist/chunk-UYGUSYIC.js +173 -0
  95. package/dist/chunk-UYGUSYIC.js.map +1 -0
  96. package/dist/{chunk-7NRSPHAF.js → chunk-VB7MWE2N.js} +2 -2
  97. package/dist/{chunk-7NRSPHAF.js.map → chunk-VB7MWE2N.js.map} +1 -1
  98. package/dist/chunk-WOZP3JLW.js +51 -0
  99. package/dist/chunk-WOZP3JLW.js.map +1 -0
  100. package/dist/chunk-XVXFMVG3.js +27 -0
  101. package/dist/chunk-XVXFMVG3.js.map +1 -0
  102. package/dist/chunk-YCZ7N6Q6.js +385 -0
  103. package/dist/chunk-YCZ7N6Q6.js.map +1 -0
  104. package/dist/code-block.d.ts +2 -1
  105. package/dist/code-block.js +81 -98
  106. package/dist/code-block.js.map +1 -1
  107. package/dist/combobox.d.ts +20 -19
  108. package/dist/combobox.js +3 -2
  109. package/dist/command.d.ts +21 -20
  110. package/dist/comparison-table.d.ts +2 -1
  111. package/dist/component-page.d.ts +6 -2
  112. package/dist/component-page.js +5 -0
  113. package/dist/component-page.js.map +1 -1
  114. package/dist/confirm-button.d.ts +2 -1
  115. package/dist/contact-page.d.ts +2 -1
  116. package/dist/continue-prompt.d.ts +6 -2
  117. package/dist/continue-prompt.js +4 -0
  118. package/dist/continue-prompt.js.map +1 -1
  119. package/dist/countdown.d.ts +2 -1
  120. package/dist/cover-hero.d.ts +20 -19
  121. package/dist/cover-hero.js +25 -42
  122. package/dist/cover-hero.js.map +1 -1
  123. package/dist/cta-panel.d.ts +2 -1
  124. package/dist/dashboard-layout.d.ts +50 -2
  125. package/dist/dashboard-layout.js +66 -11
  126. package/dist/dashboard-layout.js.map +1 -1
  127. package/dist/data-table.d.ts +103 -4
  128. package/dist/data-table.js +23 -7
  129. package/dist/date-picker.d.ts +29 -28
  130. package/dist/date-picker.js +2 -2
  131. package/dist/date-picker.js.map +1 -1
  132. package/dist/decision-list.d.ts +2 -1
  133. package/dist/description-list.d.ts +2 -1
  134. package/dist/detail-layout.d.ts +147 -3
  135. package/dist/detail-layout.js +143 -17
  136. package/dist/detail-layout.js.map +1 -1
  137. package/dist/{dialog-D42QwYb_.d.ts → dialog-DpUwec2g.d.ts} +2 -1
  138. package/dist/dialog.d.ts +3 -2
  139. package/dist/docs-article-page.d.ts +2 -1
  140. package/dist/docs-hub-page.d.ts +2 -1
  141. package/dist/docs-layout.d.ts +2 -1
  142. package/dist/docs-nav.d.ts +3 -10
  143. package/dist/document-viewer.d.ts +5 -4
  144. package/dist/doodle.d.ts +32 -0
  145. package/dist/doodle.js +70 -0
  146. package/dist/doodle.js.map +1 -0
  147. package/dist/drop-overlay.d.ts +14 -5
  148. package/dist/drop-overlay.js +16 -6
  149. package/dist/drop-overlay.js.map +1 -1
  150. package/dist/dropdown-menu.d.ts +2 -1
  151. package/dist/dropdown-menu.js +13 -74
  152. package/dist/dropdown-menu.js.map +1 -1
  153. package/dist/elephant.d.ts +4 -1
  154. package/dist/elephant.js +4 -0
  155. package/dist/elephant.js.map +1 -1
  156. package/dist/empty-state.d.ts +2 -1
  157. package/dist/engine-flow.d.ts +2 -1
  158. package/dist/error-page.d.ts +2 -1
  159. package/dist/field.js +1 -1
  160. package/dist/field.js.map +1 -1
  161. package/dist/file-upload.d.ts +14 -13
  162. package/dist/filter-bar.d.ts +84 -11
  163. package/dist/filter-bar.js +6 -2
  164. package/dist/flock.d.ts +3 -2
  165. package/dist/footnote.d.ts +2 -1
  166. package/dist/force-update-screen.d.ts +13 -8
  167. package/dist/force-update-screen.js +4 -0
  168. package/dist/force-update-screen.js.map +1 -1
  169. package/dist/form/server.d.ts +2 -1
  170. package/dist/form.d.ts +2 -1
  171. package/dist/gallery-page.d.ts +6 -2
  172. package/dist/gallery-page.js +4 -0
  173. package/dist/gallery-page.js.map +1 -1
  174. package/dist/genui.d.ts +2 -1
  175. package/dist/genui.js +5 -5
  176. package/dist/{geometry-DX-W-Yyf.d.ts → geometry-DZ4Q3hDQ.d.ts} +2 -1
  177. package/dist/glossary-term.d.ts +2 -1
  178. package/dist/glossary.d.ts +2 -1
  179. package/dist/glow-card.d.ts +2 -1
  180. package/dist/goal-gauge.d.ts +2 -1
  181. package/dist/grade-stamp.d.ts +23 -0
  182. package/dist/grade-stamp.js +42 -0
  183. package/dist/grade-stamp.js.map +1 -0
  184. package/dist/how-it-works-page.d.ts +2 -1
  185. package/dist/image-cropper.d.ts +15 -6
  186. package/dist/image-cropper.js +4 -0
  187. package/dist/image-cropper.js.map +1 -1
  188. package/dist/index.d.ts +3 -2
  189. package/dist/index.js +4 -4
  190. package/dist/iso.d.ts +2 -1
  191. package/dist/kanban.d.ts +5 -1
  192. package/dist/kanban.js +4 -0
  193. package/dist/kanban.js.map +1 -1
  194. package/dist/kbd.d.ts +2 -1
  195. package/dist/kind-config-editor.d.ts +152 -0
  196. package/dist/kind-config-editor.js +574 -0
  197. package/dist/kind-config-editor.js.map +1 -0
  198. package/dist/kpi-explained.d.ts +2 -1
  199. package/dist/landing-page.d.ts +2 -1
  200. package/dist/landscape.d.ts +6 -2
  201. package/dist/landscape.js +4 -0
  202. package/dist/landscape.js.map +1 -1
  203. package/dist/language-switch/server.d.ts +2 -1
  204. package/dist/language-switch.d.ts +11 -10
  205. package/dist/legal-page.d.ts +2 -1
  206. package/dist/link-card.d.ts +2 -1
  207. package/dist/list.d.ts +2 -1
  208. package/dist/list.js +1 -1
  209. package/dist/loader.d.ts +2 -1
  210. package/dist/longform-page.d.ts +2 -1
  211. package/dist/maintenance-screen.d.ts +10 -5
  212. package/dist/maintenance-screen.js +4 -0
  213. package/dist/maintenance-screen.js.map +1 -1
  214. package/dist/map.d.ts +8 -7
  215. package/dist/map.js +30 -0
  216. package/dist/map.js.map +1 -1
  217. package/dist/markdown.d.ts +7 -2
  218. package/dist/markdown.js +12 -5
  219. package/dist/markdown.js.map +1 -1
  220. package/dist/marketing-layout.d.ts +5 -4
  221. package/dist/marquee.d.ts +2 -1
  222. package/dist/mascot-quote.d.ts +2 -1
  223. package/dist/mascot-state.d.ts +3 -2
  224. package/dist/mascots.d.ts +4 -3
  225. package/dist/match-dialog.d.ts +6 -2
  226. package/dist/match-dialog.js +4 -0
  227. package/dist/match-dialog.js.map +1 -1
  228. package/dist/media-capture.d.ts +11 -5
  229. package/dist/media-capture.js +4 -0
  230. package/dist/media-capture.js.map +1 -1
  231. package/dist/media-gallery.d.ts +2 -1
  232. package/dist/media-grid.d.ts +3 -10
  233. package/dist/meta-row.d.ts +2 -1
  234. package/dist/meter.d.ts +2 -1
  235. package/dist/meter.js +5 -121
  236. package/dist/meter.js.map +1 -1
  237. package/dist/motion.d.ts +3 -2
  238. package/dist/native/form.d.ts +2 -1
  239. package/dist/native/list.d.ts +2 -1
  240. package/dist/native/map.d.ts +2 -1
  241. package/dist/native/map.js +30 -0
  242. package/dist/native/map.js.map +1 -1
  243. package/dist/native/markdown.d.ts +11 -3
  244. package/dist/native/markdown.js +46 -7
  245. package/dist/native/markdown.js.map +1 -1
  246. package/dist/native/media-capture.d.ts +3 -1
  247. package/dist/native/media-capture.js +5 -0
  248. package/dist/native/media-capture.js.map +1 -1
  249. package/dist/native/media-picker.d.ts +2 -1
  250. package/dist/native/vertical-video.d.ts +10 -3
  251. package/dist/native/vertical-video.js +6 -0
  252. package/dist/native/vertical-video.js.map +1 -1
  253. package/dist/native/video-player.d.ts +2 -1
  254. package/dist/native.d.ts +323 -4
  255. package/dist/native.js +1974 -1348
  256. package/dist/native.js.map +1 -1
  257. package/dist/nav-bar/me.d.ts +33 -0
  258. package/dist/nav-bar/me.js +23 -0
  259. package/dist/nav-bar/me.js.map +1 -0
  260. package/dist/nav-bar.d.ts +61 -2
  261. package/dist/nav-bar.js +92 -48
  262. package/dist/nav-bar.js.map +1 -1
  263. package/dist/next-actions.d.ts +2 -1
  264. package/dist/notification-preferences.d.ts +152 -0
  265. package/dist/notification-preferences.js +78 -0
  266. package/dist/notification-preferences.js.map +1 -0
  267. package/dist/number-ticker.d.ts +2 -1
  268. package/dist/opening-hours.d.ts +2 -1
  269. package/dist/page-header.d.ts +2 -1
  270. package/dist/page-header.js +1 -1
  271. package/dist/page-header.js.map +1 -1
  272. package/dist/page-hero.d.ts +2 -1
  273. package/dist/page-index.d.ts +2 -1
  274. package/dist/page.d.ts +2 -1
  275. package/dist/pagination.d.ts +2 -1
  276. package/dist/photo-grid.d.ts +2 -1
  277. package/dist/pointer-light.d.ts +2 -1
  278. package/dist/pointer-light.js +5 -0
  279. package/dist/pointer-light.js.map +1 -1
  280. package/dist/popover.d.ts +2 -1
  281. package/dist/pricing-page.d.ts +2 -1
  282. package/dist/product-page.d.ts +6 -2
  283. package/dist/product-page.js +4 -0
  284. package/dist/product-page.js.map +1 -1
  285. package/dist/profile-card.d.ts +120 -1
  286. package/dist/profile-card.js +68 -21
  287. package/dist/profile-card.js.map +1 -1
  288. package/dist/progress.d.ts +2 -1
  289. package/dist/promise-card.d.ts +6 -2
  290. package/dist/promise-card.js +4 -0
  291. package/dist/promise-card.js.map +1 -1
  292. package/dist/quota-meter.d.ts +114 -0
  293. package/dist/quota-meter.js +58 -0
  294. package/dist/quota-meter.js.map +1 -0
  295. package/dist/radio-group.d.ts +2 -1
  296. package/dist/radio-group.js +7 -9
  297. package/dist/radio-group.js.map +1 -1
  298. package/dist/rail-nav.d.ts +35 -18
  299. package/dist/rail-nav.js +45 -56
  300. package/dist/rail-nav.js.map +1 -1
  301. package/dist/recipes.d.ts +2 -1
  302. package/dist/retro-tv.d.ts +31 -0
  303. package/dist/retro-tv.js +124 -0
  304. package/dist/retro-tv.js.map +1 -0
  305. package/dist/router.d.ts +13 -1
  306. package/dist/router.js +85 -8
  307. package/dist/router.js.map +1 -1
  308. package/dist/scroll-stage.d.ts +7 -2
  309. package/dist/scroll-stage.js +5 -0
  310. package/dist/scroll-stage.js.map +1 -1
  311. package/dist/search-field.d.ts +2 -1
  312. package/dist/search-field.js +1 -1
  313. package/dist/section-backdrop.d.ts +2 -1
  314. package/dist/separator.d.ts +2 -1
  315. package/dist/service-card.d.ts +9 -8
  316. package/dist/settings-layout.d.ts +2 -1
  317. package/dist/settings-layout.js +10 -324
  318. package/dist/settings-layout.js.map +1 -1
  319. package/dist/showcase.d.ts +11 -3
  320. package/dist/showcase.js +5 -0
  321. package/dist/showcase.js.map +1 -1
  322. package/dist/signature.d.ts +20 -0
  323. package/dist/signature.js +39 -0
  324. package/dist/signature.js.map +1 -0
  325. package/dist/site-cahier.d.ts +187 -0
  326. package/dist/site-cahier.js +844 -0
  327. package/dist/site-cahier.js.map +1 -0
  328. package/dist/site-footer.d.ts +2 -1
  329. package/dist/site-footer.js +1 -1
  330. package/dist/sites.d.ts +2 -1
  331. package/dist/sites.js +1 -1
  332. package/dist/sites.js.map +1 -1
  333. package/dist/skeleton.d.ts +2 -1
  334. package/dist/skip-link.d.ts +2 -1
  335. package/dist/slider.d.ts +2 -1
  336. package/dist/slot-picker.d.ts +86 -13
  337. package/dist/slot-picker.js +98 -16
  338. package/dist/slot-picker.js.map +1 -1
  339. package/dist/slot.d.ts +1 -1
  340. package/dist/specimen-tag.d.ts +2 -1
  341. package/dist/speed-lines.d.ts +19 -0
  342. package/dist/speed-lines.js +45 -0
  343. package/dist/speed-lines.js.map +1 -0
  344. package/dist/spinner.d.ts +2 -1
  345. package/dist/split-view.d.ts +2 -1
  346. package/dist/stage-banner.d.ts +2 -1
  347. package/dist/stat.d.ts +2 -1
  348. package/dist/stat.js +1 -1
  349. package/dist/stat.js.map +1 -1
  350. package/dist/status-chip.d.ts +44 -0
  351. package/dist/status-chip.js +137 -0
  352. package/dist/status-chip.js.map +1 -0
  353. package/dist/status-page.d.ts +6 -2
  354. package/dist/status-page.js +5 -0
  355. package/dist/status-page.js.map +1 -1
  356. package/dist/step-progress.d.ts +2 -1
  357. package/dist/step-showcase.d.ts +2 -1
  358. package/dist/stepper.d.ts +2 -1
  359. package/dist/sticky-action.d.ts +28 -5
  360. package/dist/sticky-action.js +10 -4
  361. package/dist/sticky-action.js.map +1 -1
  362. package/dist/stuck.d.ts +28 -0
  363. package/dist/stuck.js +26 -0
  364. package/dist/stuck.js.map +1 -0
  365. package/dist/swipe-deck.d.ts +11 -3
  366. package/dist/swipe-deck.js +5 -0
  367. package/dist/swipe-deck.js.map +1 -1
  368. package/dist/switch.d.ts +2 -1
  369. package/dist/switch.js +4 -32
  370. package/dist/switch.js.map +1 -1
  371. package/dist/tabs.d.ts +48 -8
  372. package/dist/tabs.js +62 -12
  373. package/dist/tabs.js.map +1 -1
  374. package/dist/tag-input.d.ts +2 -1
  375. package/dist/tag-input.js +3 -2
  376. package/dist/tag-input.js.map +1 -1
  377. package/dist/tag-selector.d.ts +30 -4
  378. package/dist/tag-selector.js +90 -8
  379. package/dist/tag-selector.js.map +1 -1
  380. package/dist/taped-photo.d.ts +2 -1
  381. package/dist/taped-photo.js +3 -20
  382. package/dist/taped-photo.js.map +1 -1
  383. package/dist/terminal-replay.d.ts +6 -2
  384. package/dist/terminal-replay.js +5 -1
  385. package/dist/terminal-replay.js.map +1 -1
  386. package/dist/text-style/server.d.ts +2 -1
  387. package/dist/text-style.d.ts +2 -1
  388. package/dist/theme.d.ts +21 -1
  389. package/dist/theme.js +37 -1
  390. package/dist/theme.js.map +1 -1
  391. package/dist/toast.d.ts +2 -1
  392. package/dist/toc.d.ts +2 -1
  393. package/dist/tooltip.d.ts +2 -1
  394. package/dist/tree-view.d.ts +2 -1
  395. package/dist/tree-view.js +4 -0
  396. package/dist/tree-view.js.map +1 -1
  397. package/dist/update-prompt.d.ts +16 -11
  398. package/dist/update-prompt.js +4 -0
  399. package/dist/update-prompt.js.map +1 -1
  400. package/dist/upload-queue.d.ts +2 -1
  401. package/dist/verified-badge.d.ts +2 -1
  402. package/dist/versus-card.d.ts +40 -0
  403. package/dist/versus-card.js +40 -0
  404. package/dist/versus-card.js.map +1 -0
  405. package/dist/vertical-video.d.ts +2 -1
  406. package/dist/video-player.d.ts +20 -19
  407. package/dist/video-player.js +7 -376
  408. package/dist/video-player.js.map +1 -1
  409. package/dist/video-trimmer.d.ts +8 -2
  410. package/dist/video-trimmer.js +4 -0
  411. package/dist/video-trimmer.js.map +1 -1
  412. package/dist/virtual.d.ts +8 -7
  413. package/dist/waveform.d.ts +2 -1
  414. package/package.json +249 -52
  415. package/registry/account-menu.json +9 -8
  416. package/registry/account-settings.json +258 -6
  417. package/registry/achievement.json +3 -4
  418. package/registry/action-bar.json +3 -3
  419. package/registry/action-sheet.json +1 -0
  420. package/registry/activity-feed.json +2 -1
  421. package/registry/agenda.json +1 -1
  422. package/registry/alert.json +1 -1
  423. package/registry/anatomy-plate.json +13 -5
  424. package/registry/app-header.json +470 -23
  425. package/registry/app-shell.json +2 -2
  426. package/registry/argument-card.json +1 -1
  427. package/registry/audio-player.json +1 -1
  428. package/registry/auth-layout.json +1 -1
  429. package/registry/avatar.json +3 -2
  430. package/registry/badge.json +2 -1
  431. package/registry/bird-plate.json +16 -2
  432. package/registry/button.json +7 -6
  433. package/registry/captcha.json +1 -1
  434. package/registry/card-grid.json +1 -1
  435. package/registry/card.json +7 -6
  436. package/registry/catalogue-page.json +117 -8
  437. package/registry/changelog-page.json +3 -5
  438. package/registry/chapter.json +1 -1
  439. package/registry/chat.json +3 -2
  440. package/registry/checkbox.json +4 -3
  441. package/registry/chip-link.json +2 -2
  442. package/registry/chip-row.json +2 -2
  443. package/registry/chip.json +388 -12
  444. package/registry/choice-grid.json +3 -4
  445. package/registry/code-block.json +1 -1
  446. package/registry/combobox.json +3 -2
  447. package/registry/command.json +2 -2
  448. package/registry/comparison-table.json +1 -1
  449. package/registry/component-page.json +14 -5
  450. package/registry/confirm-button.json +4 -4
  451. package/registry/contact-page.json +1 -1
  452. package/registry/continue-prompt.json +13 -5
  453. package/registry/countdown.json +4 -3
  454. package/registry/cover-hero.json +3 -4
  455. package/registry/cta-panel.json +1 -1
  456. package/registry/dashboard-layout.json +91 -5
  457. package/registry/data-table.json +215 -8
  458. package/registry/date-picker.json +5 -4
  459. package/registry/decision-list.json +1 -1
  460. package/registry/description-list.json +2 -1
  461. package/registry/detail-layout.json +226 -8
  462. package/registry/dialog.json +7 -6
  463. package/registry/docs-article-page.json +3 -4
  464. package/registry/docs-hub-page.json +1 -1
  465. package/registry/docs-layout.json +1 -1
  466. package/registry/docs-nav.json +1 -1
  467. package/registry/document-viewer.json +3 -5
  468. package/registry/doodle.json +302 -0
  469. package/registry/drop-overlay.json +30 -16
  470. package/registry/dropdown-menu.json +2 -2
  471. package/registry/elephant.json +15 -7
  472. package/registry/empty-state.json +2 -1
  473. package/registry/engine-flow.json +1 -1
  474. package/registry/error-page.json +3 -5
  475. package/registry/examples/account-settings/appearance.d.ts +4 -0
  476. package/registry/examples/account-settings/appearance.js +40 -0
  477. package/registry/examples/account-settings/appearance.tsx +30 -0
  478. package/registry/examples/app-header/family.d.ts +4 -0
  479. package/registry/examples/app-header/family.js +41 -0
  480. package/registry/examples/app-header/family.tsx +37 -0
  481. package/registry/examples/app-header/native/family.d.ts +4 -0
  482. package/registry/examples/app-header/native/family.dark.png +0 -0
  483. package/registry/examples/app-header/native/family.js +25 -0
  484. package/registry/examples/app-header/native/family.light.png +0 -0
  485. package/registry/examples/app-header/native/family.tsx +33 -0
  486. package/registry/examples/catalogue-page/clients.d.ts +4 -0
  487. package/registry/examples/catalogue-page/clients.js +49 -0
  488. package/registry/examples/catalogue-page/clients.tsx +61 -0
  489. package/registry/examples/chip/marker-picker.d.ts +4 -0
  490. package/registry/examples/chip/marker-picker.js +17 -0
  491. package/registry/examples/chip/marker-picker.tsx +17 -0
  492. package/registry/examples/chip/native/marker-picker.d.ts +4 -0
  493. package/registry/examples/chip/native/marker-picker.dark.png +0 -0
  494. package/registry/examples/chip/native/marker-picker.js +18 -0
  495. package/registry/examples/chip/native/marker-picker.light.png +0 -0
  496. package/registry/examples/chip/native/marker-picker.tsx +16 -0
  497. package/registry/examples/chip/native/tags.d.ts +4 -0
  498. package/registry/examples/chip/native/tags.dark.png +0 -0
  499. package/registry/examples/chip/native/tags.js +22 -0
  500. package/registry/examples/chip/native/tags.light.png +0 -0
  501. package/registry/examples/chip/native/tags.tsx +20 -0
  502. package/registry/examples/chip/tags.d.ts +4 -0
  503. package/registry/examples/chip/tags.js +26 -0
  504. package/registry/examples/chip/tags.tsx +23 -0
  505. package/registry/examples/dashboard-layout/today.d.ts +4 -0
  506. package/registry/examples/dashboard-layout/today.js +54 -0
  507. package/registry/examples/dashboard-layout/today.tsx +63 -0
  508. package/registry/examples/data-table/applicant-files.d.ts +4 -0
  509. package/registry/examples/data-table/applicant-files.js +24 -0
  510. package/registry/examples/data-table/applicant-files.tsx +23 -0
  511. package/registry/examples/data-table/bulk.d.ts +4 -0
  512. package/registry/examples/data-table/bulk.js +45 -0
  513. package/registry/examples/data-table/bulk.tsx +34 -0
  514. package/registry/examples/data-table/checks.d.ts +4 -0
  515. package/registry/examples/data-table/checks.js +25 -0
  516. package/registry/examples/data-table/checks.tsx +24 -0
  517. package/registry/examples/detail-layout/client.d.ts +4 -0
  518. package/registry/examples/detail-layout/client.js +40 -0
  519. package/registry/examples/detail-layout/client.tsx +39 -0
  520. package/registry/examples/detail-layout/new-invoice.d.ts +4 -0
  521. package/registry/examples/detail-layout/new-invoice.js +44 -0
  522. package/registry/examples/detail-layout/new-invoice.tsx +34 -0
  523. package/registry/examples/detail-layout/profile.d.ts +4 -0
  524. package/registry/examples/detail-layout/profile.js +26 -0
  525. package/registry/examples/detail-layout/profile.tsx +21 -0
  526. package/registry/examples/doodle/bird-sketch.d.ts +4 -0
  527. package/registry/examples/doodle/bird-sketch.js +11 -0
  528. package/registry/examples/doodle/bird-sketch.tsx +12 -0
  529. package/registry/examples/doodle/kinds.d.ts +4 -0
  530. package/registry/examples/doodle/kinds.js +17 -0
  531. package/registry/examples/doodle/kinds.tsx +14 -0
  532. package/registry/examples/doodle/margin-marks.d.ts +4 -0
  533. package/registry/examples/doodle/margin-marks.js +27 -0
  534. package/registry/examples/doodle/margin-marks.tsx +19 -0
  535. package/registry/examples/doodle/margin.d.ts +4 -0
  536. package/registry/examples/doodle/margin.js +17 -0
  537. package/registry/examples/doodle/margin.tsx +17 -0
  538. package/registry/examples/filter-bar/views.d.ts +4 -0
  539. package/registry/examples/filter-bar/views.js +39 -0
  540. package/registry/examples/filter-bar/views.tsx +30 -0
  541. package/registry/examples/grade-stamp/coverage.d.ts +4 -0
  542. package/registry/examples/grade-stamp/coverage.js +12 -0
  543. package/registry/examples/grade-stamp/coverage.tsx +8 -0
  544. package/registry/examples/grade-stamp/lighthouse.d.ts +4 -0
  545. package/registry/examples/grade-stamp/lighthouse.js +12 -0
  546. package/registry/examples/grade-stamp/lighthouse.tsx +14 -0
  547. package/registry/examples/kind-config-editor/derived.d.ts +4 -0
  548. package/registry/examples/kind-config-editor/derived.js +26 -0
  549. package/registry/examples/kind-config-editor/derived.tsx +16 -0
  550. package/registry/examples/kind-config-editor/native/status-set.d.ts +4 -0
  551. package/registry/examples/kind-config-editor/native/status-set.dark.png +0 -0
  552. package/registry/examples/kind-config-editor/native/status-set.js +22 -0
  553. package/registry/examples/kind-config-editor/native/status-set.light.png +0 -0
  554. package/registry/examples/kind-config-editor/native/status-set.tsx +19 -0
  555. package/registry/examples/kind-config-editor/native/tag-set.d.ts +4 -0
  556. package/registry/examples/kind-config-editor/native/tag-set.dark.png +0 -0
  557. package/registry/examples/kind-config-editor/native/tag-set.js +20 -0
  558. package/registry/examples/kind-config-editor/native/tag-set.light.png +0 -0
  559. package/registry/examples/kind-config-editor/native/tag-set.tsx +18 -0
  560. package/registry/examples/kind-config-editor/status-set.d.ts +4 -0
  561. package/registry/examples/kind-config-editor/status-set.js +29 -0
  562. package/registry/examples/kind-config-editor/status-set.tsx +25 -0
  563. package/registry/examples/kind-config-editor/tag-set.d.ts +4 -0
  564. package/registry/examples/kind-config-editor/tag-set.js +20 -0
  565. package/registry/examples/kind-config-editor/tag-set.tsx +18 -0
  566. package/registry/examples/markdown/native/basic.dark.png +0 -0
  567. package/registry/examples/markdown/native/basic.light.png +0 -0
  568. package/registry/examples/markdown/native/wide-table.d.ts +4 -0
  569. package/registry/examples/markdown/native/wide-table.dark.png +0 -0
  570. package/registry/examples/markdown/native/wide-table.js +23 -0
  571. package/registry/examples/markdown/native/wide-table.light.png +0 -0
  572. package/registry/examples/markdown/native/wide-table.tsx +22 -0
  573. package/registry/examples/markdown/wide-table.d.ts +4 -0
  574. package/registry/examples/markdown/wide-table.js +28 -0
  575. package/registry/examples/markdown/wide-table.tsx +23 -0
  576. package/registry/examples/nav-bar/family-product.js +2 -4
  577. package/registry/examples/nav-bar/family-product.tsx +3 -5
  578. package/registry/examples/notification-preferences/default.d.ts +4 -0
  579. package/registry/examples/notification-preferences/default.js +29 -0
  580. package/registry/examples/notification-preferences/default.tsx +28 -0
  581. package/registry/examples/profile-card/banner.d.ts +4 -0
  582. package/registry/examples/profile-card/banner.js +28 -0
  583. package/registry/examples/profile-card/banner.tsx +24 -0
  584. package/registry/examples/profile-card/native/banner.d.ts +4 -0
  585. package/registry/examples/profile-card/native/banner.dark.png +0 -0
  586. package/registry/examples/profile-card/native/banner.js +22 -0
  587. package/registry/examples/profile-card/native/banner.light.png +0 -0
  588. package/registry/examples/profile-card/native/banner.tsx +18 -0
  589. package/registry/examples/quota-meter/default.d.ts +4 -0
  590. package/registry/examples/quota-meter/default.js +26 -0
  591. package/registry/examples/quota-meter/default.tsx +20 -0
  592. package/registry/examples/quota-meter/full.d.ts +4 -0
  593. package/registry/examples/quota-meter/full.js +25 -0
  594. package/registry/examples/quota-meter/full.tsx +18 -0
  595. package/registry/examples/rail-nav/shortcuts.d.ts +4 -0
  596. package/registry/examples/rail-nav/shortcuts.js +49 -0
  597. package/registry/examples/rail-nav/shortcuts.tsx +40 -0
  598. package/registry/examples/retro-tv/cabinet.d.ts +4 -0
  599. package/registry/examples/retro-tv/cabinet.js +12 -0
  600. package/registry/examples/retro-tv/cabinet.tsx +7 -0
  601. package/registry/examples/retro-tv/portable.d.ts +4 -0
  602. package/registry/examples/retro-tv/portable.js +12 -0
  603. package/registry/examples/retro-tv/portable.tsx +7 -0
  604. package/registry/examples/signature/both.d.ts +4 -0
  605. package/registry/examples/signature/both.js +11 -0
  606. package/registry/examples/signature/both.tsx +6 -0
  607. package/registry/examples/signature/variants.d.ts +4 -0
  608. package/registry/examples/signature/variants.js +14 -0
  609. package/registry/examples/signature/variants.tsx +11 -0
  610. package/registry/examples/site-cahier/java-releases.d.ts +4 -0
  611. package/registry/examples/site-cahier/java-releases.js +33 -0
  612. package/registry/examples/site-cahier/java-releases.tsx +32 -0
  613. package/registry/examples/site-cahier/motion-lab.d.ts +4 -0
  614. package/registry/examples/site-cahier/motion-lab.js +32 -0
  615. package/registry/examples/site-cahier/motion-lab.tsx +29 -0
  616. package/registry/examples/site-cahier/ts-changelog.d.ts +4 -0
  617. package/registry/examples/site-cahier/ts-changelog.js +24 -0
  618. package/registry/examples/site-cahier/ts-changelog.tsx +20 -0
  619. package/registry/examples/site-cahier/ts-doc.d.ts +4 -0
  620. package/registry/examples/site-cahier/ts-doc.js +38 -0
  621. package/registry/examples/site-cahier/ts-doc.tsx +27 -0
  622. package/registry/examples/site-cahier/ui-home.d.ts +4 -0
  623. package/registry/examples/site-cahier/ui-home.js +46 -0
  624. package/registry/examples/site-cahier/ui-home.tsx +40 -0
  625. package/registry/examples/slot-picker/weeks.d.ts +4 -0
  626. package/registry/examples/slot-picker/weeks.js +45 -0
  627. package/registry/examples/slot-picker/weeks.tsx +28 -0
  628. package/registry/examples/speed-lines/hero.d.ts +4 -0
  629. package/registry/examples/speed-lines/hero.js +11 -0
  630. package/registry/examples/speed-lines/hero.tsx +12 -0
  631. package/registry/examples/speed-lines/streaks.d.ts +4 -0
  632. package/registry/examples/speed-lines/streaks.js +11 -0
  633. package/registry/examples/speed-lines/streaks.tsx +12 -0
  634. package/registry/examples/status-chip/default.d.ts +4 -0
  635. package/registry/examples/status-chip/default.js +35 -0
  636. package/registry/examples/status-chip/default.tsx +32 -0
  637. package/registry/examples/status-chip/native/default.d.ts +4 -0
  638. package/registry/examples/status-chip/native/default.dark.png +0 -0
  639. package/registry/examples/status-chip/native/default.js +26 -0
  640. package/registry/examples/status-chip/native/default.light.png +0 -0
  641. package/registry/examples/status-chip/native/default.tsx +20 -0
  642. package/registry/examples/stuck/card.d.ts +4 -0
  643. package/registry/examples/stuck/card.js +13 -0
  644. package/registry/examples/stuck/card.tsx +14 -0
  645. package/registry/examples/stuck/holds.d.ts +4 -0
  646. package/registry/examples/stuck/holds.js +12 -0
  647. package/registry/examples/stuck/holds.tsx +16 -0
  648. package/registry/examples/stuck/tag.d.ts +4 -0
  649. package/registry/examples/stuck/tag.js +12 -0
  650. package/registry/examples/stuck/tag.tsx +13 -0
  651. package/registry/examples/tabs/binder.d.ts +4 -0
  652. package/registry/examples/tabs/binder.js +22 -0
  653. package/registry/examples/tabs/binder.tsx +20 -0
  654. package/registry/examples/tabs/native/binder.d.ts +4 -0
  655. package/registry/examples/tabs/native/binder.dark.png +0 -0
  656. package/registry/examples/tabs/native/binder.js +26 -0
  657. package/registry/examples/tabs/native/binder.light.png +0 -0
  658. package/registry/examples/tabs/native/binder.tsx +22 -0
  659. package/registry/examples/tag-selector/creatable.d.ts +4 -0
  660. package/registry/examples/tag-selector/creatable.js +41 -0
  661. package/registry/examples/tag-selector/creatable.tsx +29 -0
  662. package/registry/examples/tag-selector/native/tags.d.ts +4 -0
  663. package/registry/examples/tag-selector/native/tags.dark.png +0 -0
  664. package/registry/examples/tag-selector/native/tags.js +19 -0
  665. package/registry/examples/tag-selector/native/tags.light.png +0 -0
  666. package/registry/examples/tag-selector/native/tags.tsx +19 -0
  667. package/registry/examples/versus-card/alternatives.d.ts +4 -0
  668. package/registry/examples/versus-card/alternatives.js +20 -0
  669. package/registry/examples/versus-card/alternatives.tsx +14 -0
  670. package/registry/examples/versus-card/releases.d.ts +4 -0
  671. package/registry/examples/versus-card/releases.js +35 -0
  672. package/registry/examples/versus-card/releases.tsx +29 -0
  673. package/registry/fab.json +1 -0
  674. package/registry/field.json +3 -2
  675. package/registry/file-upload.json +6 -11
  676. package/registry/filter-bar.json +209 -9
  677. package/registry/flock.json +3 -4
  678. package/registry/footnote.json +2 -3
  679. package/registry/force-update-screen.json +14 -5
  680. package/registry/form.json +5 -4
  681. package/registry/gallery-page.json +14 -5
  682. package/registry/genui.json +2 -2
  683. package/registry/glossary-term.json +1 -1
  684. package/registry/glossary.json +1 -1
  685. package/registry/glow-card.json +2 -2
  686. package/registry/goal-gauge.json +2 -1
  687. package/registry/grade-stamp.json +227 -0
  688. package/registry/header.json +1 -0
  689. package/registry/how-it-works-page.json +3 -5
  690. package/registry/image-cropper.json +13 -5
  691. package/registry/image-viewer.json +3 -4
  692. package/registry/index.json +612 -105
  693. package/registry/iso.json +1 -1
  694. package/registry/kanban.json +13 -5
  695. package/registry/kbd.json +1 -1
  696. package/registry/kind-config-editor.json +565 -0
  697. package/registry/kpi-explained.json +2 -2
  698. package/registry/landing-page.json +3 -5
  699. package/registry/landscape.json +13 -5
  700. package/registry/language-switch.json +1 -1
  701. package/registry/legal-page.json +1 -1
  702. package/registry/link-card.json +1 -1
  703. package/registry/list.json +2 -1
  704. package/registry/loader.json +2 -1
  705. package/registry/longform-page.json +1 -1
  706. package/registry/maintenance-screen.json +14 -5
  707. package/registry/map.json +3 -2
  708. package/registry/markdown.json +86 -9
  709. package/registry/marketing-layout.json +1 -1
  710. package/registry/marquee.json +1 -1
  711. package/registry/mascot-quote.json +1 -1
  712. package/registry/mascot-state.json +12 -11
  713. package/registry/mascots.json +2 -1
  714. package/registry/match-dialog.json +14 -5
  715. package/registry/media-capture.json +14 -5
  716. package/registry/media-gallery.json +3 -5
  717. package/registry/media-grid.json +1 -1
  718. package/registry/media-picker.json +2 -3
  719. package/registry/meta-row.json +2 -1
  720. package/registry/meter.json +4 -3
  721. package/registry/nav-bar.json +100 -9
  722. package/registry/next-actions.json +1 -1
  723. package/registry/notification-preferences.json +250 -0
  724. package/registry/number-ticker.json +2 -1
  725. package/registry/onboarding.json +1 -0
  726. package/registry/opening-hours.json +1 -1
  727. package/registry/otp-input.json +1 -0
  728. package/registry/page-header.json +2 -2
  729. package/registry/page-hero.json +1 -1
  730. package/registry/page-index.json +1 -1
  731. package/registry/page.json +3 -3
  732. package/registry/pagination.json +2 -1
  733. package/registry/permission-prompt.json +2 -2
  734. package/registry/photo-grid.json +4 -4
  735. package/registry/pointer-light.json +6 -2
  736. package/registry/popover.json +2 -2
  737. package/registry/pricing-page.json +4 -6
  738. package/registry/product-page.json +14 -5
  739. package/registry/profile-card.json +232 -8
  740. package/registry/progress.json +4 -3
  741. package/registry/promise-card.json +13 -5
  742. package/registry/pull-to-refresh.json +1 -0
  743. package/registry/quota-meter.json +308 -0
  744. package/registry/radio-group.json +4 -3
  745. package/registry/rail-nav.json +48 -10
  746. package/registry/recipes.json +1 -1
  747. package/registry/retro-tv.json +478 -0
  748. package/registry/router.json +3 -3
  749. package/registry/screen.json +1 -0
  750. package/registry/scroll-stage.json +14 -5
  751. package/registry/search-field.json +3 -2
  752. package/registry/section-backdrop.json +1 -1
  753. package/registry/segmented.json +1 -0
  754. package/registry/separator.json +2 -2
  755. package/registry/service-card.json +1 -1
  756. package/registry/settings-layout.json +2 -1
  757. package/registry/showcase.json +14 -5
  758. package/registry/signature.json +185 -0
  759. package/registry/site-cahier.json +548 -0
  760. package/registry/site-footer.json +3 -3
  761. package/registry/sites.json +2 -2
  762. package/registry/skeleton.json +2 -1
  763. package/registry/skip-link.json +1 -1
  764. package/registry/slider.json +5 -4
  765. package/registry/slot-picker.json +156 -10
  766. package/registry/slot.json +2 -2
  767. package/registry/specimen-tag.json +1 -1
  768. package/registry/speed-lines.json +174 -0
  769. package/registry/spinner.json +4 -3
  770. package/registry/splash-handoff.json +1 -0
  771. package/registry/split-view.json +1 -1
  772. package/registry/stage-banner.json +2 -3
  773. package/registry/stat.json +2 -2
  774. package/registry/status-chip.json +350 -0
  775. package/registry/status-page.json +13 -5
  776. package/registry/step-progress.json +2 -1
  777. package/registry/step-showcase.json +3 -5
  778. package/registry/stepper.json +2 -1
  779. package/registry/sticky-action.json +38 -8
  780. package/registry/stuck.json +219 -0
  781. package/registry/swipe-deck.json +14 -5
  782. package/registry/swipeable-row.json +1 -0
  783. package/registry/switch.json +3 -2
  784. package/registry/tab-bar.json +1 -0
  785. package/registry/tabs.json +154 -22
  786. package/registry/tag-input.json +1 -1
  787. package/registry/tag-selector.json +190 -12
  788. package/registry/taped-photo.json +1 -1
  789. package/registry/terminal-replay.json +14 -5
  790. package/registry/text-style.json +5 -5
  791. package/registry/theme.json +4 -3
  792. package/registry/toast.json +2 -1
  793. package/registry/toc.json +1 -1
  794. package/registry/tooltip.json +2 -2
  795. package/registry/tree-view.json +6 -2
  796. package/registry/txt.json +1 -0
  797. package/registry/update-prompt.json +14 -5
  798. package/registry/upload-queue.json +1 -1
  799. package/registry/verified-badge.json +6 -6
  800. package/registry/versus-card.json +194 -0
  801. package/registry/vertical-video.json +8 -3
  802. package/registry/video-player.json +5 -6
  803. package/registry/video-trimmer.json +13 -5
  804. package/registry/virtual.json +2 -2
  805. package/registry/waveform.json +4 -3
  806. package/dist/chunk-4LYKBSOG.js.map +0 -1
  807. package/dist/chunk-HHFWK2HH.js +0 -163
  808. package/dist/chunk-HHFWK2HH.js.map +0 -1
  809. package/dist/chunk-R3LTSMS5.js +0 -75
  810. package/dist/chunk-R3LTSMS5.js.map +0 -1
  811. package/dist/chunk-YGIN2YIY.js.map +0 -1
  812. package/dist/chunk-YHKTYFOQ.js.map +0 -1
  813. package/dist/chunk-ZQW7LF4Y.js +0 -179
  814. package/dist/chunk-ZQW7LF4Y.js.map +0 -1
@@ -2,8 +2,8 @@
2
2
  "name": "chip",
3
3
  "type": "primitive",
4
4
  "title": "Chip",
5
- "summary": "A selectable pill: alone a toggle, in a group a single or multiple choice, or a removable tag.",
6
- "description": "A selectable pill: alone a toggle, in a group a single or multiple choice, or a removable tag.",
5
+ "summary": "A selectable pill: alone a toggle, in a group a single or multiple choice, or a removable tag. Also the tags of a workspace: `TagChip`, with a colour marker from the closed palette.",
6
+ "description": "A selectable pill: alone a toggle, in a group a single or multiple choice, or a removable tag. Also the tags of a workspace: `TagChip`, with a colour marker from the closed palette.",
7
7
  "status": "beta",
8
8
  "deprecated": null,
9
9
  "category": "forms",
@@ -22,7 +22,8 @@
22
22
  "whenToUse": [
23
23
  "To filter a list with a few short options shown at once: format, genre, speed.",
24
24
  "`Chip.Group type=\"multiple\"` for several tags; `type=\"single\"` (with `required`) for one filter.",
25
- "`removable` for the values already chosen: tags, recipients, active filters."
25
+ "`removable` for the values already chosen: tags, recipients, active filters.",
26
+ "`TagChip` for the tags a person puts on a file (a client, an invoice, an applicant): the name with its marker, a dot or a ribbon. `MarkerPicker` recolours one from the six colours."
26
27
  ],
27
28
  "whenNotToUse": [
28
29
  {
@@ -33,6 +34,10 @@
33
34
  "when": "To choose in a form that is submitted, with labels that read as sentences.",
34
35
  "use": "radio-group"
35
36
  },
37
+ {
38
+ "when": "For the state of an entity whose kind has a status set.",
39
+ "use": "status-chip"
40
+ },
36
41
  {
37
42
  "when": "For a status that cannot be changed.",
38
43
  "use": "badge"
@@ -45,7 +50,8 @@
45
50
  "bestPractices": [
46
51
  "One or two words per chip; the group's `label` says what is being chosen.",
47
52
  "Keep the order stable when a chip is selected: do not move it to the front.",
48
- "Give each removable chip a `removeLabel` that names it: “Remove #night”, not “Remove”."
53
+ "Give each removable chip a `removeLabel` that names it: “Remove #night”, not “Remove”.",
54
+ "A marker sits beside the name and never fills the chip: the colour is never the only signal. Keep tag names short; the closed palette has six colours, the tokens `--kz-tag-<name>` and `--kz-tag-<name>-text` (≥ 3:1 and ≥ 4.5:1 on every surface)."
49
55
  ],
50
56
  "accessibility": {
51
57
  "keyboard": [
@@ -65,18 +71,21 @@
65
71
  "notes": [
66
72
  "Radix Toggle and ToggleGroup: alone `aria-pressed`; in a single group a radio (`aria-checked`), in a multiple group pressed buttons.",
67
73
  "`Chip.Group` takes `label` as the group's accessible name.",
68
- "The remove button is a separate button named by `removeLabel`."
74
+ "The remove button is a separate button named by `removeLabel`.",
75
+ "A marker is decorative (`aria-hidden`); the tag's name is the chip's name. `MarkerPicker` is a radio group of named swatches (arrow keys), the chosen one ticked."
69
76
  ]
70
77
  },
71
78
  "related": [
72
79
  "tabs",
73
80
  "radio-group",
74
81
  "checkbox",
75
- "badge"
82
+ "badge",
83
+ "status-chip",
84
+ "tag-selector"
76
85
  ],
77
86
  "web": {
78
87
  "entry": "@krizaka/ui/chip",
79
- "import": "import { Chip } from \"@krizaka/ui/chip\";",
88
+ "import": "import { Chip, TagChip, TagMarker, MarkerPicker } from \"@krizaka/ui/chip\";",
80
89
  "props": [
81
90
  {
82
91
  "component": "Chip",
@@ -229,6 +238,164 @@
229
238
  "required": false
230
239
  }
231
240
  ]
241
+ },
242
+ {
243
+ "component": "MarkerPicker",
244
+ "description": "Recolours a tag from the closed palette: a radio group of swatches (arrow keys), the chosen one ticked and named.",
245
+ "props": [
246
+ {
247
+ "name": "label",
248
+ "type": "string",
249
+ "default": null,
250
+ "description": "The group's accessible name (\"Colour of the tag\"), passed translated.",
251
+ "required": true
252
+ },
253
+ {
254
+ "name": "names",
255
+ "type": "Readonly<Record<\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\", string>>",
256
+ "default": null,
257
+ "description": "The name of each colour, passed translated: `{ blue: \"Blue\", … }`. The swatches are named, never colour alone.",
258
+ "required": true
259
+ },
260
+ {
261
+ "name": "className",
262
+ "type": "string",
263
+ "default": null,
264
+ "description": "Classes merged on the root.",
265
+ "required": false
266
+ },
267
+ {
268
+ "name": "defaultValue",
269
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
270
+ "default": null,
271
+ "description": "The colour chosen at first, uncontrolled.",
272
+ "required": false
273
+ },
274
+ {
275
+ "name": "disabled",
276
+ "type": "boolean",
277
+ "default": null,
278
+ "description": "Not available.",
279
+ "required": false
280
+ },
281
+ {
282
+ "name": "markers",
283
+ "type": "readonly (\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\")[]",
284
+ "default": "[\"blue\", \"green\", \"amber\", \"red\", \"violet\", \"gray\"] as const",
285
+ "description": "The colours offered (default: the six).",
286
+ "required": false
287
+ },
288
+ {
289
+ "name": "onValueChange",
290
+ "type": "((value: \"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\") => void)",
291
+ "default": null,
292
+ "description": "Called with the colour chosen.",
293
+ "required": false
294
+ },
295
+ {
296
+ "name": "value",
297
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
298
+ "default": null,
299
+ "description": "The colour chosen (controlled).",
300
+ "required": false
301
+ }
302
+ ]
303
+ },
304
+ {
305
+ "component": "TagChip",
306
+ "description": "A tag: its marker and its name. Alone a toggle (a filter), inside `Chip.Group` an item, or `removable` (a tag worn by a\nfile) — the behaviour of `Chip`, with the marker before the name.",
307
+ "props": [
308
+ {
309
+ "name": "marker",
310
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
311
+ "default": null,
312
+ "description": "The tag's marker: a name of the closed palette (`blue · green · amber · red · violet · gray`).",
313
+ "required": true
314
+ },
315
+ {
316
+ "name": "onRemove",
317
+ "type": "() => void",
318
+ "default": null,
319
+ "description": "Runs when the remove button is pressed.",
320
+ "required": true
321
+ },
322
+ {
323
+ "name": "removeLabel",
324
+ "type": "string",
325
+ "default": null,
326
+ "description": "The accessible name of the remove button — passed translated, e.g. \"Remove #night\".",
327
+ "required": true
328
+ },
329
+ {
330
+ "name": "defaultSelected",
331
+ "type": "boolean",
332
+ "default": null,
333
+ "description": "Alone: pressed at first, uncontrolled.",
334
+ "required": false
335
+ },
336
+ {
337
+ "name": "onSelectedChange",
338
+ "type": "((selected: boolean) => void)",
339
+ "default": null,
340
+ "description": "Alone: called with the new state on every press.",
341
+ "required": false
342
+ },
343
+ {
344
+ "name": "removable",
345
+ "type": "boolean",
346
+ "default": null,
347
+ "description": "A pressable chip (the default); `true` makes it a static chip with a remove button.\nA static chip (a chosen tag, an applied filter) with a remove button.",
348
+ "required": false
349
+ },
350
+ {
351
+ "name": "selected",
352
+ "type": "boolean",
353
+ "default": null,
354
+ "description": "Alone: pressed or not (`defaultSelected` uncontrolled), `onSelectedChange` on every press.",
355
+ "required": false
356
+ },
357
+ {
358
+ "name": "shape",
359
+ "type": "MarkerShape",
360
+ "default": "dot",
361
+ "description": "dot · ribbon.",
362
+ "required": false
363
+ },
364
+ {
365
+ "name": "size",
366
+ "type": "\"sm\" | \"md\"",
367
+ "default": "md",
368
+ "description": "sm · md (inside `Chip.Group`, the group's size by default).",
369
+ "required": false
370
+ },
371
+ {
372
+ "name": "value",
373
+ "type": "string",
374
+ "default": null,
375
+ "description": "Inside `Chip.Group`: the value this chip stands for (required there, ignored alone).",
376
+ "required": false
377
+ }
378
+ ]
379
+ },
380
+ {
381
+ "component": "TagMarker",
382
+ "description": "The marker alone, decorative (`aria-hidden`): put the tag's name beside it.",
383
+ "props": [
384
+ {
385
+ "name": "marker",
386
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
387
+ "default": null,
388
+ "description": "A name of the closed palette.",
389
+ "required": true
390
+ },
391
+ {
392
+ "name": "shape",
393
+ "type": "MarkerShape",
394
+ "default": "dot",
395
+ "description": "dot · ribbon.",
396
+ "required": false
397
+ }
398
+ ]
232
399
  }
233
400
  ],
234
401
  "examples": [
@@ -271,17 +438,34 @@
271
438
  "path": "examples/chip/removable.tsx",
272
439
  "module": "@krizaka/ui/registry/examples/chip/removable",
273
440
  "code": "import { Chip } from \"@krizaka/ui/chip\";\n\n// Chosen tags, each with a named remove button.\nexport default function ChipRemovable() {\n return (\n <div className=\"flex flex-wrap gap-2\">\n <Chip removable removeLabel=\"Remove #night\" onRemove={() => {}}>\n #night\n </Chip>\n <Chip removable removeLabel=\"Remove #city\" onRemove={() => {}}>\n #city\n </Chip>\n </div>\n );\n}\n"
441
+ },
442
+ {
443
+ "name": "tags",
444
+ "title": "Tags with a marker",
445
+ "description": "`TagChip`: a client's tags as a filter, and worn tags with a ribbon marker, removable.",
446
+ "path": "examples/chip/tags.tsx",
447
+ "module": "@krizaka/ui/registry/examples/chip/tags",
448
+ "code": "\"use client\";\n\nimport { Chip, TagChip } from \"@krizaka/ui/chip\";\nimport * as React from \"react\";\n\n// A client's tags (a fictitious bike workshop): the marker sits beside the name, in a dot or in a ribbon; the name says it all.\nexport default function ChipTags() {\n const [filter, setFilter] = React.useState([\"regular\"]);\n return (\n <div className=\"flex flex-col gap-4\">\n <Chip.Group type=\"multiple\" label=\"Filter clients by tag\" value={filter} onValueChange={setFilter}>\n <TagChip value=\"regular\" marker=\"blue\">Regular</TagChip>\n <TagChip value=\"to-follow\" marker=\"amber\">To follow up</TagChip>\n <TagChip value=\"vip\" marker=\"violet\">Gift cards</TagChip>\n <TagChip value=\"late\" marker=\"red\">Late payer</TagChip>\n </Chip.Group>\n <div className=\"flex flex-wrap gap-2\">\n <TagChip marker=\"green\" shape=\"ribbon\" removable removeLabel=\"Remove the tag Pick-up\" onRemove={() => {}}>Pick-up</TagChip>\n <TagChip marker=\"gray\" shape=\"ribbon\" removable removeLabel=\"Remove the tag Winter storage\" onRemove={() => {}}>Winter storage</TagChip>\n </div>\n </div>\n );\n}\n"
449
+ },
450
+ {
451
+ "name": "marker-picker",
452
+ "title": "Recolour a tag",
453
+ "description": "`MarkerPicker`: the six colours of the closed palette, named and ticked.",
454
+ "path": "examples/chip/marker-picker.tsx",
455
+ "module": "@krizaka/ui/registry/examples/chip/marker-picker",
456
+ "code": "\"use client\";\n\nimport { type Marker, MarkerPicker, TagChip } from \"@krizaka/ui/chip\";\nimport * as React from \"react\";\n\nconst NAMES: Record<Marker, string> = { blue: \"Blue\", green: \"Green\", amber: \"Amber\", red: \"Red\", violet: \"Violet\", gray: \"Gray\" };\n\n// Recolour a tag from the closed palette of six: a swatch is named and ticked, the colour is never alone.\nexport default function ChipMarkerPicker() {\n const [marker, setMarker] = React.useState<Marker>(\"violet\");\n return (\n <div className=\"flex flex-col items-start gap-3\">\n <TagChip marker={marker}>Gift cards</TagChip>\n <MarkerPicker label=\"Colour of the tag Gift cards\" names={NAMES} value={marker} onValueChange={setMarker} />\n </div>\n );\n}\n"
274
457
  }
275
458
  ]
276
459
  },
277
460
  "native": {
278
461
  "entry": "@krizaka/ui/native",
279
- "import": "import { Chip } from \"@krizaka/ui/native\";",
462
+ "import": "import { Chip, TagChip, TagMarker, MarkerPicker } from \"@krizaka/ui/native\";",
280
463
  "differences": [
281
464
  "The group's name is `aria-label` (not `label`).",
282
465
  "`scrollable` makes the group one horizontal row: a filter bar.",
283
466
  "`onPress` semantics: a chip alone is a checkbox, in a single group a radio."
284
467
  ],
468
+ "deprecated": null,
285
469
  "props": [
286
470
  {
287
471
  "component": "Chip",
@@ -408,6 +592,30 @@
408
592
  "dark": "examples/chip/native/removable.dark.png",
409
593
  "light": "examples/chip/native/removable.light.png"
410
594
  }
595
+ },
596
+ {
597
+ "name": "tags",
598
+ "title": "Tags with a marker",
599
+ "description": "`TagChip`: the marker beside the name, a dot or a ribbon.",
600
+ "path": "examples/chip/native/tags.tsx",
601
+ "module": "@krizaka/ui/registry/examples/chip/native/tags",
602
+ "code": "import { Chip, TagChip } from \"@krizaka/ui/native\";\nimport { useState } from \"react\";\nimport { View } from \"react-native\";\n\n// A client's tags (a fictitious bike workshop): the marker beside the name, a dot or a ribbon.\nexport default function NativeChipTags() {\n const [filter, setFilter] = useState([\"regular\"]);\n return (\n <View style={{ gap: 16, width: 340 }}>\n <Chip.Group type=\"multiple\" aria-label=\"Filter clients by tag\" value={filter} onValueChange={setFilter}>\n <TagChip value=\"regular\" marker=\"blue\">Regular</TagChip>\n <TagChip value=\"to-follow\" marker=\"amber\">To follow up</TagChip>\n <TagChip value=\"late\" marker=\"red\">Late payer</TagChip>\n </Chip.Group>\n <View style={{ flexDirection: \"row\", gap: 8 }}>\n <TagChip marker=\"green\" shape=\"ribbon\" removable removeLabel=\"Remove the tag Pick-up\" onRemove={() => {}}>Pick-up</TagChip>\n </View>\n </View>\n );\n}\n",
603
+ "screenshots": {
604
+ "dark": "examples/chip/native/tags.dark.png",
605
+ "light": "examples/chip/native/tags.light.png"
606
+ }
607
+ },
608
+ {
609
+ "name": "marker-picker",
610
+ "title": "Recolour a tag",
611
+ "description": "`MarkerPicker`: the six colours, named and ticked.",
612
+ "path": "examples/chip/native/marker-picker.tsx",
613
+ "module": "@krizaka/ui/registry/examples/chip/native/marker-picker",
614
+ "code": "import { type Marker, MarkerPicker, TagChip } from \"@krizaka/ui/native\";\nimport { useState } from \"react\";\nimport { View } from \"react-native\";\n\nconst NAMES: Record<Marker, string> = { blue: \"Blue\", green: \"Green\", amber: \"Amber\", red: \"Red\", violet: \"Violet\", gray: \"Gray\" };\n\n// Recolour a tag from the closed palette of six.\nexport default function NativeChipMarkerPicker() {\n const [marker, setMarker] = useState<Marker>(\"violet\");\n return (\n <View style={{ gap: 12, alignItems: \"flex-start\" }}>\n <TagChip marker={marker}>Gift cards</TagChip>\n <MarkerPicker label=\"Colour of the tag Gift cards\" names={NAMES} value={marker} onValueChange={setMarker} />\n </View>\n );\n}\n",
615
+ "screenshots": {
616
+ "dark": "examples/chip/native/marker-picker.dark.png",
617
+ "light": "examples/chip/native/marker-picker.light.png"
618
+ }
411
619
  }
412
620
  ]
413
621
  },
@@ -418,26 +626,36 @@
418
626
  },
419
627
  {
420
628
  "path": "chip/index.ts",
421
- "content": "/** @krizaka/ui/chip — `Chip` (selectable, removable), `Chip.Group` (single · multiple), `chip` (the slots). Client (\"use client\"). */\nexport { Chip, chip, ChipGroup, type ChipGroupProps, type ChipProps, type ChipVariants } from \"./chip\";\n"
629
+ "content": "/** @krizaka/ui/chip — `Chip` (selectable, removable), `Chip.Group` (single · multiple), `chip` (the slots); the tags of a workspace: `TagChip`, `TagMarker`, `MarkerPicker` (the closed palette of six markers). Client (\"use client\"). */\nexport { Chip, chip, ChipGroup, type ChipGroupProps, type ChipProps, type ChipVariants } from \"./chip\";\nexport { type Marker, MarkerPicker, type MarkerPickerProps, MARKERS, type MarkerShape, TagChip, type TagChipProps, TagMarker, type TagMarkerProps } from \"./tag-chip\";\n"
630
+ },
631
+ {
632
+ "path": "chip/markers.ts",
633
+ "content": "// The six names of the closed palette of tag markers, written once for the platforms that cannot import\n// `@krizaka/organize/contract` (/native adds no dependency). A test keeps them equal to the contract's `MARKERS`.\nexport const TAG_MARKERS = [\"blue\", \"green\", \"amber\", \"red\", \"violet\", \"gray\"] as const;\n"
422
634
  },
423
635
  {
424
636
  "path": "chip/meta.ts",
425
- "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Chip\",\n summary: \"A selectable pill: alone a toggle, in a group a single or multiple choice, or a removable tag.\",\n status: \"beta\",\n category: \"forms\",\n platforms: \"both\",\n parity: { desktop: \"web\" },\n whenToUse: [\n \"To filter a list with a few short options shown at once: format, genre, speed.\",\n \"`Chip.Group type=\\\"multiple\\\"` for several tags; `type=\\\"single\\\"` (with `required`) for one filter.\",\n \"`removable` for the values already chosen: tags, recipients, active filters.\",\n ],\n whenNotToUse: [\n { when: \"To switch between views of the same page.\", use: \"tabs\" },\n { when: \"To choose in a form that is submitted, with labels that read as sentences.\", use: \"radio-group\" },\n { when: \"For a status that cannot be changed.\", use: \"badge\" },\n { when: \"To run an action.\", use: \"button\" },\n ],\n bestPractices: [\n \"One or two words per chip; the group's `label` says what is being chosen.\",\n \"Keep the order stable when a chip is selected: do not move it to the front.\",\n \"Give each removable chip a `removeLabel` that names it: “Remove #night”, not “Remove”.\",\n ],\n accessibility: {\n keyboard: [\n { keys: \"Tab\", action: \"Moves into the group (one tab stop) and out of it.\" },\n { keys: \"Arrow keys\", action: \"Move between the chips of a group.\" },\n { keys: \"Space / Enter\", action: \"Toggles the focused chip.\" },\n ],\n notes: [\n \"Radix Toggle and ToggleGroup: alone `aria-pressed`; in a single group a radio (`aria-checked`), in a multiple group pressed buttons.\",\n \"`Chip.Group` takes `label` as the group's accessible name.\",\n \"The remove button is a separate button named by `removeLabel`.\",\n ],\n },\n related: [\"tabs\", \"radio-group\", \"checkbox\", \"badge\"],\n web: {\n imports: [\"Chip\"],\n examples: [\n { name: \"toggle\", title: \"Toggle\", description: \"Alone, off and on: a pressed button.\" },\n { name: \"single\", title: \"Single choice\", description: \"One choice in a group: a filter; `required` keeps one chosen.\" },\n { name: \"multiple\", title: \"Multiple choice\", description: \"Several choices: tags.\" },\n { name: \"small\", title: \"Small\", description: \"`size=\\\"sm\\\"` for dense toolbars.\" },\n { name: \"removable\", title: \"Removable\", description: \"Chosen tags, each with a named remove button.\" },\n ],\n },\n native: {\n imports: [\"Chip\"],\n differences: [\n \"The group's name is `aria-label` (not `label`).\",\n \"`scrollable` makes the group one horizontal row: a filter bar.\",\n \"`onPress` semantics: a chip alone is a checkbox, in a single group a radio.\",\n ],\n examples: [\n { name: \"toggle\", title: \"Toggle\", description: \"Off and on; `sm` and `md`; disabled.\" },\n { name: \"single\", title: \"Single choice\", description: \"`Chip.Group type=\\\"single\\\"`: one value.\" },\n { name: \"multiple\", title: \"Filter bar\", description: \"`type=\\\"multiple\\\" scrollable`: one horizontal row.\" },\n { name: \"removable\", title: \"Removable\", description: \"A chosen tag with its own named remove button.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
637
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Chip\",\n summary: \"A selectable pill: alone a toggle, in a group a single or multiple choice, or a removable tag. Also the tags of a workspace: `TagChip`, with a colour marker from the closed palette.\",\n status: \"beta\",\n category: \"forms\",\n platforms: \"both\",\n parity: { desktop: \"web\" },\n whenToUse: [\n \"To filter a list with a few short options shown at once: format, genre, speed.\",\n \"`Chip.Group type=\\\"multiple\\\"` for several tags; `type=\\\"single\\\"` (with `required`) for one filter.\",\n \"`removable` for the values already chosen: tags, recipients, active filters.\",\n \"`TagChip` for the tags a person puts on a file (a client, an invoice, an applicant): the name with its marker, a dot or a ribbon. `MarkerPicker` recolours one from the six colours.\",\n ],\n whenNotToUse: [\n { when: \"To switch between views of the same page.\", use: \"tabs\" },\n { when: \"To choose in a form that is submitted, with labels that read as sentences.\", use: \"radio-group\" },\n { when: \"For the state of an entity whose kind has a status set.\", use: \"status-chip\" },\n { when: \"For a status that cannot be changed.\", use: \"badge\" },\n { when: \"To run an action.\", use: \"button\" },\n ],\n bestPractices: [\n \"One or two words per chip; the group's `label` says what is being chosen.\",\n \"Keep the order stable when a chip is selected: do not move it to the front.\",\n \"Give each removable chip a `removeLabel` that names it: “Remove #night”, not “Remove”.\",\n \"A marker sits beside the name and never fills the chip: the colour is never the only signal. Keep tag names short; the closed palette has six colours, the tokens `--kz-tag-<name>` and `--kz-tag-<name>-text` (≥ 3:1 and ≥ 4.5:1 on every surface).\",\n ],\n accessibility: {\n keyboard: [\n { keys: \"Tab\", action: \"Moves into the group (one tab stop) and out of it.\" },\n { keys: \"Arrow keys\", action: \"Move between the chips of a group.\" },\n { keys: \"Space / Enter\", action: \"Toggles the focused chip.\" },\n ],\n notes: [\n \"Radix Toggle and ToggleGroup: alone `aria-pressed`; in a single group a radio (`aria-checked`), in a multiple group pressed buttons.\",\n \"`Chip.Group` takes `label` as the group's accessible name.\",\n \"The remove button is a separate button named by `removeLabel`.\",\n \"A marker is decorative (`aria-hidden`); the tag's name is the chip's name. `MarkerPicker` is a radio group of named swatches (arrow keys), the chosen one ticked.\",\n ],\n },\n related: [\"tabs\", \"radio-group\", \"checkbox\", \"badge\", \"status-chip\", \"tag-selector\"],\n web: {\n imports: [\"Chip\", \"TagChip\", \"TagMarker\", \"MarkerPicker\"],\n examples: [\n { name: \"toggle\", title: \"Toggle\", description: \"Alone, off and on: a pressed button.\" },\n { name: \"single\", title: \"Single choice\", description: \"One choice in a group: a filter; `required` keeps one chosen.\" },\n { name: \"multiple\", title: \"Multiple choice\", description: \"Several choices: tags.\" },\n { name: \"small\", title: \"Small\", description: \"`size=\\\"sm\\\"` for dense toolbars.\" },\n { name: \"removable\", title: \"Removable\", description: \"Chosen tags, each with a named remove button.\" },\n { name: \"tags\", title: \"Tags with a marker\", description: \"`TagChip`: a client's tags as a filter, and worn tags with a ribbon marker, removable.\" },\n { name: \"marker-picker\", title: \"Recolour a tag\", description: \"`MarkerPicker`: the six colours of the closed palette, named and ticked.\" },\n ],\n },\n native: {\n imports: [\"Chip\", \"TagChip\", \"TagMarker\", \"MarkerPicker\"],\n differences: [\n \"The group's name is `aria-label` (not `label`).\",\n \"`scrollable` makes the group one horizontal row: a filter bar.\",\n \"`onPress` semantics: a chip alone is a checkbox, in a single group a radio.\",\n ],\n examples: [\n { name: \"toggle\", title: \"Toggle\", description: \"Off and on; `sm` and `md`; disabled.\" },\n { name: \"single\", title: \"Single choice\", description: \"`Chip.Group type=\\\"single\\\"`: one value.\" },\n { name: \"multiple\", title: \"Filter bar\", description: \"`type=\\\"multiple\\\" scrollable`: one horizontal row.\" },\n { name: \"removable\", title: \"Removable\", description: \"A chosen tag with its own named remove button.\" },\n { name: \"tags\", title: \"Tags with a marker\", description: \"`TagChip`: the marker beside the name, a dot or a ribbon.\" },\n { name: \"marker-picker\", title: \"Recolour a tag\", description: \"`MarkerPicker`: the six colours, named and ticked.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
426
638
  },
427
639
  {
428
640
  "path": "chip/recipe.ts",
429
641
  "content": "// The chip's parts and sizes, written once as classes of the Krizaka tokens: the web wears them with `tv(chipRecipe)`,\n// React Native reads the same classes into styles (native/chip.tsx). `data-[state=on]:` is the chosen chip.\nimport { defineRecipe } from \"../recipes/define\";\n\nexport const chipRecipe = defineRecipe({\n slots: {\n group: \"flex flex-wrap items-center gap-2 data-[orientation=vertical]:flex-col data-[orientation=vertical]:items-stretch\",\n base:\n \"inline-flex shrink-0 select-none items-center justify-center gap-1.5 whitespace-nowrap rounded-sm border font-semibold transition-colors \" +\n \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-40 \" +\n \"border-border-default bg-surface-1 text-fg-secondary hover:border-border-strong hover:text-fg \" +\n \"data-[state=on]:border-accent data-[state=on]:bg-accent-soft data-[state=on]:text-fg\",\n remove:\n \"-mr-1.5 inline-flex h-6 w-6 items-center justify-center rounded-full text-fg-secondary transition-colors hover:bg-surface-3 hover:text-fg \" +\n \"focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring\",\n },\n variants: {\n size: { sm: { base: \"h-7 px-3 text-xs\" }, md: { base: \"h-9 px-3.5 text-xs\" } },\n },\n defaultVariants: { size: \"md\" },\n});\n"
430
642
  },
643
+ {
644
+ "path": "chip/tag-chip.tsx",
645
+ "content": "// Client (a Radix radio group, and `Chip`'s context). The tags of a workspace (krizaka-ts#89, `@krizaka/organize`): a name\n// with a colour marker beside it. The marker is a NAME of the closed palette (`MARKERS`: blue · green · amber · red ·\n// violet · gray), mapped to `--kz-tag-<name>` — a dot (≥ 3:1) or Yomizaka's bookmark ribbon. It sits beside the name and\n// never fills the chip, and the name is always written: the colour is never the only signal.\nimport type { Marker } from \"@krizaka/organize/contract\";\nimport { RadioGroup as RadioPrimitive } from \"radix-ui\";\nimport * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { Chip, type ChipProps } from \"./chip\";\nimport { TAG_MARKERS } from \"./markers\";\n\n/** The six names of the closed palette (`@krizaka/organize` `MARKERS`; a test keeps them equal). */\nexport const MARKERS: readonly Marker[] = TAG_MARKERS;\nexport type { Marker };\n\n/** The marker's shape: a `dot`, or the `ribbon` (a bookmark: a rectangle with a notch at the bottom). */\nexport type MarkerShape = \"dot\" | \"ribbon\";\n\n/** The CSS custom property the marker reads its colour from: `--kz-tag-<name>`. */\nconst markerVar = (marker: Marker) => `var(--kz-tag-${marker})`;\n\nexport type TagMarkerProps = Omit<React.ComponentProps<\"span\">, \"children\"> & {\n /** A name of the closed palette. */\n marker: Marker;\n /**\n * dot · ribbon.\n * @default \"dot\"\n */\n shape?: MarkerShape;\n};\n\n/** The marker alone, decorative (`aria-hidden`): put the tag's name beside it. */\nexport function TagMarker({ marker, shape = \"dot\", className, style, ...props }: TagMarkerProps) {\n return (\n <span\n aria-hidden\n data-marker={marker}\n data-shape={shape}\n className={cn(\n \"inline-block shrink-0 bg-(--kz-marker) data-[shape=dot]:h-2.5 data-[shape=dot]:w-2.5 data-[shape=dot]:rounded-full\",\n \"data-[shape=ribbon]:h-3.5 data-[shape=ribbon]:w-2.5 data-[shape=ribbon]:[clip-path:polygon(0_0,100%_0,100%_100%,50%_72%,0_100%)]\",\n className,\n )}\n style={{ ...style, [\"--kz-marker\" as string]: markerVar(marker) }}\n {...props}\n />\n );\n}\n\nexport type TagChipProps = ChipProps & {\n /** The tag's marker: a name of the closed palette (`blue · green · amber · red · violet · gray`). */\n marker: Marker;\n /**\n * dot · ribbon.\n * @default \"dot\"\n */\n shape?: MarkerShape;\n};\n\n/**\n * A tag: its marker and its name. Alone a toggle (a filter), inside `Chip.Group` an item, or `removable` (a tag worn by a\n * file) — the behaviour of `Chip`, with the marker before the name.\n */\nexport function TagChip({ marker, shape, children, ...props }: TagChipProps) {\n const content = (\n <>\n <TagMarker marker={marker} shape={shape} />\n {children}\n </>\n );\n return <Chip {...(props as ChipProps)}>{content}</Chip>;\n}\n\nexport type MarkerPickerProps = {\n /** The group's accessible name (\"Colour of the tag\"), passed translated. */\n label: string;\n /** The name of each colour, passed translated: `{ blue: \"Blue\", … }`. The swatches are named, never colour alone. */\n names: Readonly<Record<Marker, string>>;\n /** The colour chosen (controlled). */\n value?: Marker;\n /** The colour chosen at first, uncontrolled. */\n defaultValue?: Marker;\n /** Called with the colour chosen. */\n onValueChange?: (value: Marker) => void;\n /** The colours offered (default: the six). */\n markers?: readonly Marker[];\n /** Not available. */\n disabled?: boolean;\n /** Classes merged on the root. */\n className?: string;\n};\n\n/** Recolours a tag from the closed palette: a radio group of swatches (arrow keys), the chosen one ticked and named. */\nexport function MarkerPicker({ label, names, value, defaultValue, onValueChange, markers = MARKERS, disabled, className }: MarkerPickerProps) {\n return (\n <RadioPrimitive.Root\n aria-label={label}\n value={value}\n defaultValue={defaultValue}\n onValueChange={(next) => onValueChange?.(next as Marker)}\n disabled={disabled}\n orientation=\"horizontal\"\n className={cn(\"flex flex-wrap items-center gap-1.5\", className)}\n >\n {markers.map((marker) => (\n <RadioPrimitive.Item\n key={marker}\n value={marker}\n aria-label={names[marker]}\n title={names[marker]}\n className={cn(\n \"inline-flex h-8 w-8 items-center justify-center rounded-full border border-border-default bg-surface-1 transition-colors\",\n \"hover:border-border-strong focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring disabled:opacity-40\",\n \"data-[state=checked]:border-(--kz-marker) data-[state=checked]:bg-surface-2\",\n )}\n style={{ [\"--kz-marker\" as string]: markerVar(marker) }}\n >\n <span aria-hidden className=\"relative inline-flex h-4 w-4 items-center justify-center rounded-full bg-(--kz-marker)\">\n <RadioPrimitive.Indicator forceMount className=\"hidden h-full w-full items-center justify-center data-[state=checked]:flex\">\n {/* The tick is the second signal: a shape, not a colour (it reads in the page's text colour on the swatch's ring). */}\n <svg viewBox=\"0 0 24 24\" className=\"h-3 w-3 text-surface-0\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"4\" strokeLinecap=\"round\" strokeLinejoin=\"round\">\n <path d=\"M20 6 9 17l-5-5\" />\n </svg>\n </RadioPrimitive.Indicator>\n </span>\n </RadioPrimitive.Item>\n ))}\n </RadioPrimitive.Root>\n );\n}\n"
646
+ },
431
647
  {
432
648
  "path": "meta.ts",
433
- "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which ui.krizaka.com (apps/site) renders as\n// ui.krizaka.com/components/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n | \"agenda\"\n | \"account-settings\"\n | \"drop-overlay\"\n | \"upload-queue\"\n | \"achievement\"\n | \"anatomy-plate\"\n | \"bird-plate\"\n | \"taped-photo\"\n | \"text-style\"\n | \"flock\"\n | \"elephant\"\n | \"footnote\"\n | \"page-index\"\n | \"chapter\"\n | \"specimen-tag\"\n | \"action-bar\"\n | \"action-sheet\"\n | \"activity-feed\"\n | \"alert\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\n | \"audio-player\"\n | \"auth-layout\"\n | \"avatar\"\n | \"badge\"\n | \"button\"\n | \"captcha\"\n | \"card\"\n | \"card-grid\"\n | \"catalogue-page\"\n | \"changelog-page\"\n | \"chat\"\n | \"checkbox\"\n | \"chip\"\n | \"chip-link\"\n | \"chip-row\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"contact-page\"\n | \"continue-prompt\"\n | \"countdown\"\n | \"cover-hero\"\n | \"cta-panel\"\n | \"dashboard-layout\"\n | \"data-table\"\n | \"date-picker\"\n | \"decision-list\"\n | \"description-list\"\n | \"detail-layout\"\n | \"dialog\"\n | \"docs-article-page\"\n | \"docs-hub-page\"\n | \"docs-layout\"\n | \"docs-nav\"\n | \"document-viewer\"\n | \"dropdown-menu\"\n | \"empty-state\"\n | \"engine-flow\"\n | \"error-page\"\n | \"fab\"\n | \"field\"\n | \"file-upload\"\n | \"filter-bar\"\n | \"force-update-screen\"\n | \"form\"\n | \"gallery-page\"\n | \"genui\"\n | \"glossary\"\n | \"glossary-term\"\n | \"glow-card\"\n | \"goal-gauge\"\n | \"header\"\n | \"how-it-works-page\"\n | \"image-cropper\"\n | \"image-viewer\"\n | \"iso\"\n | \"kanban\"\n | \"kbd\"\n | \"kpi-explained\"\n | \"landing-page\"\n | \"landscape\"\n | \"legal-page\"\n | \"link-card\"\n | \"list\"\n | \"loader\"\n | \"longform-page\"\n | \"maintenance-screen\"\n | \"map\"\n | \"markdown\"\n | \"meta-row\"\n | \"waveform\"\n | \"marketing-layout\"\n | \"marquee\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\n | \"media-grid\"\n | \"language-switch\"\n | \"media-gallery\"\n | \"media-picker\"\n | \"meter\"\n | \"nav-bar\"\n | \"number-ticker\"\n | \"onboarding\"\n | \"opening-hours\"\n | \"otp-input\"\n | \"page\"\n | \"page-header\"\n | \"page-hero\"\n | \"pagination\"\n | \"permission-prompt\"\n | \"photo-grid\"\n | \"pointer-light\"\n | \"popover\"\n | \"pricing-page\"\n | \"product-page\"\n | \"profile-card\"\n | \"progress\"\n | \"promise-card\"\n | \"pull-to-refresh\"\n | \"radio-group\"\n | \"router\"\n | \"rail-nav\"\n | \"recipes\"\n | \"screen\"\n | \"scroll-stage\"\n | \"search-field\"\n | \"section-backdrop\"\n | \"segmented\"\n | \"separator\"\n | \"service-card\"\n | \"settings-layout\"\n | \"account-menu\"\n | \"showcase\"\n | \"step-showcase\"\n | \"site-footer\"\n | \"sites\"\n | \"skeleton\"\n | \"skip-link\"\n | \"slider\"\n | \"slot-picker\"\n | \"slot\"\n | \"spinner\"\n | \"sticky-action\"\n | \"splash-handoff\"\n | \"split-view\"\n | \"stage-banner\"\n | \"stat\"\n | \"status-page\"\n | \"step-progress\"\n | \"stepper\"\n | \"swipe-deck\"\n | \"swipeable-row\"\n | \"switch\"\n | \"tab-bar\"\n | \"tabs\"\n | \"tag-input\"\n | \"tag-selector\"\n | \"terminal-replay\"\n | \"theme\"\n | \"toast\"\n | \"toc\"\n | \"tooltip\"\n | \"tree-view\"\n | \"txt\"\n | \"update-prompt\"\n | \"verified-badge\"\n | \"vertical-video\"\n | \"video-player\"\n | \"video-trimmer\"\n | \"virtual\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/**\n * Why a component is not on a platform — a decision, never a silence (the parity matrix of ui.krizaka.com/platforms):\n * - `gap` (✗): it belongs there and is not built yet; `issue` is the issue that tracks it (`krizaka/krizaka-ui#275`);\n * - `n/a`: it is not meant for that platform (a site's page block on a phone, a swipe on a desktop); `use` names the\n * component that answers there, when one does.\n */\nexport type Absence =\n | { readonly status: \"gap\"; readonly issue: string; readonly reason: string; readonly use?: undefined }\n | { readonly status: \"n/a\"; readonly reason: string; readonly use?: ComponentName; readonly issue?: undefined };\n\n/**\n * Desktop is the Orazaka Mac app (Tauri 2: the system WebView renders the web components — ADR-002). `web`: the web\n * component runs there as it is; `desktop`: it also has a desktop form (a window's title bar, a denser layout…), said in\n * its documentation; otherwise the absence and why.\n */\nexport type DesktopSupport = \"web\" | \"desktop\" | Absence;\n\n/**\n * The three platforms of Krizaka UI — web · native (React Native, Expo) · desktop — for one component. The side a\n * component has is `platforms`; the side it lacks says why here: `native` is required for (and only for) a web-only\n * component, `web` for a native-only one; `desktop` always. `scripts/registry.test.mjs` fails on a missing decision.\n */\nexport interface Parity {\n readonly web?: Absence;\n readonly native?: Absence;\n readonly desktop: DesktopSupport;\n}\n\n/**\n * `stable`: its API only changes in a major. `beta`: it may still change in a minor. `deprecated`: no product uses it and\n * no work plans to — it still works, says what replaces it, and goes in the major named by `deprecated.removedIn`.\n */\nexport type Status = \"stable\" | \"beta\" | \"deprecated\";\n\n/** What a deprecated component says (required when `status` is `deprecated`, absent otherwise). */\nexport interface Deprecation {\n /** The version that deprecated it (`3.6.0`). */\n readonly since: string;\n /** The major that removes it (`4.0.0`). */\n readonly removedIn: string;\n /** What replaces it, when a component does. */\n readonly use?: ComponentName;\n /** Why it goes: no product uses it, no planned work needs it. */\n readonly reason: string;\n}\n\n/**\n * The group of the catalogue. `media`: video, sound, camera, files, cropping. `blocks`: the page blocks — the frame,\n * the hero, sections, cards that lead or argue, decisions, code, calls to act — that every page of a site is made of.\n * `layouts`: the shells of whole screens — an application, a dashboard, settings, sign-in, an object, a list and its\n * item, a site's page, a documentation page — each with its screens. `templates`: the page templates — whole pages of a\n * site (a landing, a product, a docs hub, a long read, a changelog, pricing, status, an error…), each a distinct\n * composition of the blocks, words and content as props.\n */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"media\" | \"blocks\" | \"layouts\" | \"templates\" | \"layout\" | \"foundations\";\n\n/** Why a reader needs a template: the seven intents the templates are grouped by (sidebar sub-headings, catalogue filter). */\nexport type TemplatePurpose = \"convince\" | \"explain\" | \"show\" | \"act\" | \"operate\" | \"converse\" | \"recover\";\n\n/** The groups of templates, in reading order: the title, and the one line that says when to come to that group. */\nexport const templatePurposes = {\n convince: { title: \"Convince\", useWhen: \"You come here when a visitor must decide: a landing, a product, a price, a comparison, a proof.\" },\n explain: { title: \"Explain\", useWhen: \"You come here when a reader must understand: how it works, a documentation hub or article, a changelog, a FAQ, a policy.\" },\n show: { title: \"Show\", useWhen: \"You come here when the work itself is the argument: a gallery, a story, a case study, an object and its details.\" },\n act: { title: \"Act\", useWhen: \"You come here when a person must do something once: reach the team, sign in or up, set up, pay.\" },\n operate: { title: \"Operate\", useWhen: \"You come here when a person works every day: a dashboard, a console with a table, settings, an app shell.\" },\n converse: { title: \"Converse\", useWhen: \"You come here when people talk: an inbox, a chat, comments, a notifications centre.\" },\n recover: { title: \"Recover\", useWhen: \"You come here when the way is blocked: an empty list, an error, a missing page, maintenance, a product still being built.\" },\n} as const satisfies Record<TemplatePurpose, { readonly title: string; readonly useWhen: string }>;\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\ninterface ExampleBase {\n /** The file name, kebab-case (`primary`, `icon-button`). */\n readonly name: string;\n /** A short title (`Primary`, `Icon button`). */\n readonly title: string;\n /** One or two sentences: when this variant is the right one. */\n readonly description: string;\n}\n\n/** A plain example, or a template: a whole screen with its intent (`purpose`) and the user goal its layout serves (`why`). */\nexport type Example =\n | (ExampleBase & { readonly template?: false; readonly purpose?: undefined; readonly why?: undefined })\n | (ExampleBase & {\n /**\n * A template: a whole screen of a product composed from the platform (a layout and its blocks, real words, its\n * phone version thought out), copied as a starting point — at most 160 lines, listed on ui.krizaka.com/templates.\n */\n readonly template: true;\n /** The intent that groups it: why you need this block. */\n readonly purpose: TemplatePurpose;\n /** Why this layout: the user goal it serves, in one sentence. */\n readonly why: string;\n });\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n readonly imports: readonly string[];\n /** The examples, in reading order; the first one is the component's preview. */\n readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n /**\n * The entry to import from when it is not `@krizaka/ui/native`: a component that needs an Expo module (an optional\n * peer) has its own, `@krizaka/ui/native/<name>`, so an app that does not use it never installs the module.\n */\n readonly entry?: string;\n /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n readonly differences: readonly string[];\n}\n\nexport interface KeyboardInteraction {\n /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n readonly keys: string;\n /** What they do. */\n readonly action: string;\n}\n\nexport interface ComponentMeta {\n /** The display name: `Button`, `Dropdown menu`. */\n readonly title: string;\n /** One sentence: what it is. */\n readonly summary: string;\n readonly status: Status;\n /** Required for, and only for, a `deprecated` component. */\n readonly deprecated?: Deprecation;\n readonly category: Category;\n /** Must match the sides below: `both` ⇔ `web` and `native`. */\n readonly platforms: Platform;\n /** The platforms it is not on, and why; and its desktop form (see `Parity`). */\n readonly parity: Parity;\n /** When to reach for it: concrete situations, one per item. */\n readonly whenToUse: readonly string[];\n /** When not to — and what to use instead (`use`), when another component is the answer. */\n readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n /** How to use it well: wording, placement, composition. */\n readonly bestPractices: readonly string[];\n readonly accessibility: {\n /** The keyboard, when it does more than Tab and Enter. */\n readonly keyboard: readonly KeyboardInteraction[];\n /** Roles, names and announcements: what the component does, what the app must provide. */\n readonly notes: readonly string[];\n };\n /** The components a reader of this page should know about. */\n readonly related: readonly ComponentName[];\n readonly web?: PlatformDocs;\n readonly native?: NativeDocs;\n}\n"
649
+ "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which ui.krizaka.com (apps/site) renders as\n// ui.krizaka.com/components/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n | \"notification-preferences\"\n | \"quota-meter\"\n | \"status-chip\"\n | \"kind-config-editor\"\n | \"agenda\"\n | \"account-settings\"\n | \"drop-overlay\"\n | \"upload-queue\"\n | \"achievement\"\n | \"anatomy-plate\"\n | \"bird-plate\"\n | \"taped-photo\"\n | \"stuck\"\n | \"doodle\"\n | \"signature\"\n | \"grade-stamp\"\n | \"versus-card\"\n | \"speed-lines\"\n | \"site-cahier\"\n | \"text-style\"\n | \"flock\"\n | \"elephant\"\n | \"footnote\"\n | \"page-index\"\n | \"chapter\"\n | \"specimen-tag\"\n | \"action-bar\"\n | \"action-sheet\"\n | \"activity-feed\"\n | \"alert\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\n | \"audio-player\"\n | \"auth-layout\"\n | \"avatar\"\n | \"badge\"\n | \"button\"\n | \"captcha\"\n | \"card\"\n | \"card-grid\"\n | \"catalogue-page\"\n | \"changelog-page\"\n | \"chat\"\n | \"checkbox\"\n | \"chip\"\n | \"chip-link\"\n | \"chip-row\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"contact-page\"\n | \"continue-prompt\"\n | \"countdown\"\n | \"cover-hero\"\n | \"cta-panel\"\n | \"dashboard-layout\"\n | \"data-table\"\n | \"date-picker\"\n | \"decision-list\"\n | \"description-list\"\n | \"detail-layout\"\n | \"dialog\"\n | \"docs-article-page\"\n | \"docs-hub-page\"\n | \"docs-layout\"\n | \"docs-nav\"\n | \"document-viewer\"\n | \"dropdown-menu\"\n | \"empty-state\"\n | \"engine-flow\"\n | \"error-page\"\n | \"fab\"\n | \"field\"\n | \"file-upload\"\n | \"filter-bar\"\n | \"force-update-screen\"\n | \"form\"\n | \"gallery-page\"\n | \"genui\"\n | \"glossary\"\n | \"glossary-term\"\n | \"glow-card\"\n | \"goal-gauge\"\n | \"header\"\n | \"how-it-works-page\"\n | \"image-cropper\"\n | \"image-viewer\"\n | \"iso\"\n | \"kanban\"\n | \"kbd\"\n | \"kpi-explained\"\n | \"landing-page\"\n | \"landscape\"\n | \"legal-page\"\n | \"link-card\"\n | \"list\"\n | \"loader\"\n | \"longform-page\"\n | \"maintenance-screen\"\n | \"map\"\n | \"markdown\"\n | \"meta-row\"\n | \"waveform\"\n | \"marketing-layout\"\n | \"marquee\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\n | \"media-grid\"\n | \"language-switch\"\n | \"media-gallery\"\n | \"media-picker\"\n | \"meter\"\n | \"nav-bar\"\n | \"number-ticker\"\n | \"onboarding\"\n | \"opening-hours\"\n | \"otp-input\"\n | \"page\"\n | \"page-header\"\n | \"page-hero\"\n | \"pagination\"\n | \"permission-prompt\"\n | \"photo-grid\"\n | \"pointer-light\"\n | \"popover\"\n | \"pricing-page\"\n | \"product-page\"\n | \"profile-card\"\n | \"progress\"\n | \"promise-card\"\n | \"pull-to-refresh\"\n | \"retro-tv\"\n | \"radio-group\"\n | \"router\"\n | \"rail-nav\"\n | \"recipes\"\n | \"screen\"\n | \"scroll-stage\"\n | \"search-field\"\n | \"section-backdrop\"\n | \"segmented\"\n | \"separator\"\n | \"service-card\"\n | \"settings-layout\"\n | \"account-menu\"\n | \"showcase\"\n | \"step-showcase\"\n | \"site-footer\"\n | \"sites\"\n | \"skeleton\"\n | \"skip-link\"\n | \"slider\"\n | \"slot-picker\"\n | \"slot\"\n | \"spinner\"\n | \"sticky-action\"\n | \"splash-handoff\"\n | \"split-view\"\n | \"stage-banner\"\n | \"stat\"\n | \"status-page\"\n | \"step-progress\"\n | \"stepper\"\n | \"swipe-deck\"\n | \"swipeable-row\"\n | \"switch\"\n | \"tab-bar\"\n | \"tabs\"\n | \"tag-input\"\n | \"tag-selector\"\n | \"terminal-replay\"\n | \"theme\"\n | \"toast\"\n | \"toc\"\n | \"tooltip\"\n | \"tree-view\"\n | \"txt\"\n | \"update-prompt\"\n | \"verified-badge\"\n | \"vertical-video\"\n | \"video-player\"\n | \"video-trimmer\"\n | \"virtual\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/**\n * Why a component is not on a platform — a decision, never a silence (the parity matrix of ui.krizaka.com/platforms):\n * - `gap` (✗): it belongs there and is not built yet; `issue` is the issue that tracks it (`krizaka/krizaka-ui#275`);\n * - `n/a`: it is not meant for that platform (a site's page block on a phone, a swipe on a desktop); `use` names the\n * component that answers there, when one does.\n */\nexport type Absence =\n | { readonly status: \"gap\"; readonly issue: string; readonly reason: string; readonly use?: undefined }\n | { readonly status: \"n/a\"; readonly reason: string; readonly use?: ComponentName; readonly issue?: undefined };\n\n/**\n * Desktop is the Orazaka Mac app (Tauri 2: the system WebView renders the web components — ADR-002). `web`: the web\n * component runs there as it is; `desktop`: it also has a desktop form (a window's title bar, a denser layout…), said in\n * its documentation; otherwise the absence and why.\n */\nexport type DesktopSupport = \"web\" | \"desktop\" | Absence;\n\n/**\n * The three platforms of Krizaka UI — web · native (React Native, Expo) · desktop — for one component. The side a\n * component has is `platforms`; the side it lacks says why here: `native` is required for (and only for) a web-only\n * component, `web` for a native-only one; `desktop` always. `scripts/registry.test.mjs` fails on a missing decision.\n */\nexport interface Parity {\n readonly web?: Absence;\n readonly native?: Absence;\n readonly desktop: DesktopSupport;\n}\n\n/**\n * `stable`: its API only changes in a major. `beta`: it may still change in a minor. `deprecated`: no product uses it and\n * no work plans to — it still works, says what replaces it, and goes in the major named by `deprecated.removedIn`.\n */\nexport type Status = \"stable\" | \"beta\" | \"deprecated\";\n\n/** What a deprecated component says (required when `status` is `deprecated`, absent otherwise). */\nexport interface Deprecation {\n /** The version that deprecated it (`3.6.0`). */\n readonly since: string;\n /** The major that removes it (`4.0.0`). */\n readonly removedIn: string;\n /** What replaces it, when a component does. */\n readonly use?: ComponentName;\n /** Why it goes: no product uses it, no planned work needs it. */\n readonly reason: string;\n}\n\n/**\n * The group of the catalogue. `media`: video, sound, camera, files, cropping. `blocks`: the page blocks — the frame,\n * the hero, sections, cards that lead or argue, decisions, code, calls to act — that every page of a site is made of.\n * `layouts`: the shells of whole screens — an application, a dashboard, settings, sign-in, an object, a list and its\n * item, a site's page, a documentation page — each with its screens. `templates`: the page templates — whole pages of a\n * site (a landing, a product, a docs hub, a long read, a changelog, pricing, status, an error…), each a distinct\n * composition of the blocks, words and content as props.\n */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"media\" | \"blocks\" | \"layouts\" | \"templates\" | \"layout\" | \"foundations\";\n\n/** Why a reader needs a template: the seven intents the templates are grouped by (sidebar sub-headings, catalogue filter). */\nexport type TemplatePurpose = \"convince\" | \"explain\" | \"show\" | \"act\" | \"operate\" | \"converse\" | \"recover\";\n\n/** The groups of templates, in reading order: the title, and the one line that says when to come to that group. */\nexport const templatePurposes = {\n convince: { title: \"Convince\", useWhen: \"You come here when a visitor must decide: a landing, a product, a price, a comparison, a proof.\" },\n explain: { title: \"Explain\", useWhen: \"You come here when a reader must understand: how it works, a documentation hub or article, a changelog, a FAQ, a policy.\" },\n show: { title: \"Show\", useWhen: \"You come here when the work itself is the argument: a gallery, a story, a case study, an object and its details.\" },\n act: { title: \"Act\", useWhen: \"You come here when a person must do something once: reach the team, sign in or up, set up, pay.\" },\n operate: { title: \"Operate\", useWhen: \"You come here when a person works every day: a dashboard, a console with a table, settings, an app shell.\" },\n converse: { title: \"Converse\", useWhen: \"You come here when people talk: an inbox, a chat, comments, a notifications centre.\" },\n recover: { title: \"Recover\", useWhen: \"You come here when the way is blocked: an empty list, an error, a missing page, maintenance, a product still being built.\" },\n} as const satisfies Record<TemplatePurpose, { readonly title: string; readonly useWhen: string }>;\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\ninterface ExampleBase {\n /** The file name, kebab-case (`primary`, `icon-button`). */\n readonly name: string;\n /** A short title (`Primary`, `Icon button`). */\n readonly title: string;\n /** One or two sentences: when this variant is the right one. */\n readonly description: string;\n}\n\n/** A plain example, or a template: a whole screen with its intent (`purpose`) and the user goal its layout serves (`why`). */\nexport type Example =\n | (ExampleBase & { readonly template?: false; readonly purpose?: undefined; readonly why?: undefined })\n | (ExampleBase & {\n /**\n * A template: a whole screen of a product composed from the platform (a layout and its blocks, real words, its\n * phone version thought out), copied as a starting point — at most 160 lines, listed on ui.krizaka.com/templates.\n */\n readonly template: true;\n /** The intent that groups it: why you need this block. */\n readonly purpose: TemplatePurpose;\n /** Why this layout: the user goal it serves, in one sentence. */\n readonly why: string;\n });\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n readonly imports: readonly string[];\n /** The examples, in reading order; the first one is the component's preview. */\n readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n /**\n * The entry to import from when it is not `@krizaka/ui/native`: a component that needs an Expo module (an optional\n * peer) has its own, `@krizaka/ui/native/<name>`, so an app that does not use it never installs the module.\n */\n readonly entry?: string;\n /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n readonly differences: readonly string[];\n /** The React Native entry alone is deprecated while the web one stays (ADR-006 §7); a deprecated component says it once, above. */\n readonly deprecated?: Deprecation;\n}\n\nexport interface KeyboardInteraction {\n /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n readonly keys: string;\n /** What they do. */\n readonly action: string;\n}\n\nexport interface ComponentMeta {\n /** The display name: `Button`, `Dropdown menu`. */\n readonly title: string;\n /** One sentence: what it is. */\n readonly summary: string;\n readonly status: Status;\n /** Required for, and only for, a `deprecated` component. */\n readonly deprecated?: Deprecation;\n readonly category: Category;\n /** Must match the sides below: `both` ⇔ `web` and `native`. */\n readonly platforms: Platform;\n /** The platforms it is not on, and why; and its desktop form (see `Parity`). */\n readonly parity: Parity;\n /** When to reach for it: concrete situations, one per item. */\n readonly whenToUse: readonly string[];\n /** When not to — and what to use instead (`use`), when another component is the answer. */\n readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n /** How to use it well: wording, placement, composition. */\n readonly bestPractices: readonly string[];\n readonly accessibility: {\n /** The keyboard, when it does more than Tab and Enter. */\n readonly keyboard: readonly KeyboardInteraction[];\n /** Roles, names and announcements: what the component does, what the app must provide. */\n readonly notes: readonly string[];\n };\n /** The components a reader of this page should know about. */\n readonly related: readonly ComponentName[];\n readonly web?: PlatformDocs;\n readonly native?: NativeDocs;\n}\n"
434
650
  }
435
651
  ],
436
652
  "dependencies": [
437
- "radix-ui@^1.7.0",
653
+ "@krizaka/organize@^0.4.0",
654
+ "radix-ui@^1.8.1",
438
655
  "tailwind-variants@^3.3.1"
439
656
  ],
440
657
  "registryDependencies": [
658
+ "cn",
441
659
  "recipes",
442
660
  "router"
443
661
  ],
@@ -597,6 +815,164 @@
597
815
  "required": false
598
816
  }
599
817
  ]
818
+ },
819
+ {
820
+ "component": "MarkerPicker",
821
+ "description": "Recolours a tag from the closed palette: a radio group of swatches (arrow keys), the chosen one ticked and named.",
822
+ "props": [
823
+ {
824
+ "name": "label",
825
+ "type": "string",
826
+ "default": null,
827
+ "description": "The group's accessible name (\"Colour of the tag\"), passed translated.",
828
+ "required": true
829
+ },
830
+ {
831
+ "name": "names",
832
+ "type": "Readonly<Record<\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\", string>>",
833
+ "default": null,
834
+ "description": "The name of each colour, passed translated: `{ blue: \"Blue\", … }`. The swatches are named, never colour alone.",
835
+ "required": true
836
+ },
837
+ {
838
+ "name": "className",
839
+ "type": "string",
840
+ "default": null,
841
+ "description": "Classes merged on the root.",
842
+ "required": false
843
+ },
844
+ {
845
+ "name": "defaultValue",
846
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
847
+ "default": null,
848
+ "description": "The colour chosen at first, uncontrolled.",
849
+ "required": false
850
+ },
851
+ {
852
+ "name": "disabled",
853
+ "type": "boolean",
854
+ "default": null,
855
+ "description": "Not available.",
856
+ "required": false
857
+ },
858
+ {
859
+ "name": "markers",
860
+ "type": "readonly (\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\")[]",
861
+ "default": "[\"blue\", \"green\", \"amber\", \"red\", \"violet\", \"gray\"] as const",
862
+ "description": "The colours offered (default: the six).",
863
+ "required": false
864
+ },
865
+ {
866
+ "name": "onValueChange",
867
+ "type": "((value: \"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\") => void)",
868
+ "default": null,
869
+ "description": "Called with the colour chosen.",
870
+ "required": false
871
+ },
872
+ {
873
+ "name": "value",
874
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
875
+ "default": null,
876
+ "description": "The colour chosen (controlled).",
877
+ "required": false
878
+ }
879
+ ]
880
+ },
881
+ {
882
+ "component": "TagChip",
883
+ "description": "A tag: its marker and its name. Alone a toggle (a filter), inside `Chip.Group` an item, or `removable` (a tag worn by a\nfile) — the behaviour of `Chip`, with the marker before the name.",
884
+ "props": [
885
+ {
886
+ "name": "marker",
887
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
888
+ "default": null,
889
+ "description": "The tag's marker: a name of the closed palette (`blue · green · amber · red · violet · gray`).",
890
+ "required": true
891
+ },
892
+ {
893
+ "name": "onRemove",
894
+ "type": "() => void",
895
+ "default": null,
896
+ "description": "Runs when the remove button is pressed.",
897
+ "required": true
898
+ },
899
+ {
900
+ "name": "removeLabel",
901
+ "type": "string",
902
+ "default": null,
903
+ "description": "The accessible name of the remove button — passed translated, e.g. \"Remove #night\".",
904
+ "required": true
905
+ },
906
+ {
907
+ "name": "defaultSelected",
908
+ "type": "boolean",
909
+ "default": null,
910
+ "description": "Alone: pressed at first, uncontrolled.",
911
+ "required": false
912
+ },
913
+ {
914
+ "name": "onSelectedChange",
915
+ "type": "((selected: boolean) => void)",
916
+ "default": null,
917
+ "description": "Alone: called with the new state on every press.",
918
+ "required": false
919
+ },
920
+ {
921
+ "name": "removable",
922
+ "type": "boolean",
923
+ "default": null,
924
+ "description": "A pressable chip (the default); `true` makes it a static chip with a remove button.\nA static chip (a chosen tag, an applied filter) with a remove button.",
925
+ "required": false
926
+ },
927
+ {
928
+ "name": "selected",
929
+ "type": "boolean",
930
+ "default": null,
931
+ "description": "Alone: pressed or not (`defaultSelected` uncontrolled), `onSelectedChange` on every press.",
932
+ "required": false
933
+ },
934
+ {
935
+ "name": "shape",
936
+ "type": "MarkerShape",
937
+ "default": "dot",
938
+ "description": "dot · ribbon.",
939
+ "required": false
940
+ },
941
+ {
942
+ "name": "size",
943
+ "type": "\"sm\" | \"md\"",
944
+ "default": "md",
945
+ "description": "sm · md (inside `Chip.Group`, the group's size by default).",
946
+ "required": false
947
+ },
948
+ {
949
+ "name": "value",
950
+ "type": "string",
951
+ "default": null,
952
+ "description": "Inside `Chip.Group`: the value this chip stands for (required there, ignored alone).",
953
+ "required": false
954
+ }
955
+ ]
956
+ },
957
+ {
958
+ "component": "TagMarker",
959
+ "description": "The marker alone, decorative (`aria-hidden`): put the tag's name beside it.",
960
+ "props": [
961
+ {
962
+ "name": "marker",
963
+ "type": "\"blue\" | \"green\" | \"amber\" | \"red\" | \"violet\" | \"gray\"",
964
+ "default": null,
965
+ "description": "A name of the closed palette.",
966
+ "required": true
967
+ },
968
+ {
969
+ "name": "shape",
970
+ "type": "MarkerShape",
971
+ "default": "dot",
972
+ "description": "dot · ribbon.",
973
+ "required": false
974
+ }
975
+ ]
600
976
  }
601
977
  ]
602
978
  }