@krizaka/ui 3.55.0 → 3.60.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 (610) 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 +2 -1
  4. package/dist/account-settings.d.ts +153 -61
  5. package/dist/account-settings.js +240 -97
  6. package/dist/account-settings.js.map +1 -1
  7. package/dist/achievement.d.ts +2 -1
  8. package/dist/action-bar.d.ts +3 -2
  9. package/dist/activity-feed.d.ts +2 -1
  10. package/dist/agenda.d.ts +2 -1
  11. package/dist/alert.d.ts +2 -1
  12. package/dist/anatomy-plate.d.ts +2 -1
  13. package/dist/app-header/search.d.ts +8 -7
  14. package/dist/app-header.d.ts +2 -1
  15. package/dist/app-shell.d.ts +26 -25
  16. package/dist/argument-card.d.ts +3 -2
  17. package/dist/audio-player.d.ts +2 -1
  18. package/dist/auth-layout.d.ts +11 -10
  19. package/dist/avatar/defaults.d.ts +2 -1
  20. package/dist/avatar.d.ts +2 -1
  21. package/dist/badge.d.ts +2 -1
  22. package/dist/bird-plate.d.ts +4 -2
  23. package/dist/blocks.css +183 -4
  24. package/dist/button.d.ts +2 -1
  25. package/dist/captcha.d.ts +2 -1
  26. package/dist/captcha.js +1 -0
  27. package/dist/captcha.js.map +1 -1
  28. package/dist/card-grid.d.ts +2 -1
  29. package/dist/card.d.ts +2 -1
  30. package/dist/catalogue-page.d.ts +82 -2
  31. package/dist/catalogue-page.js +156 -13
  32. package/dist/catalogue-page.js.map +1 -1
  33. package/dist/changelog-page.d.ts +2 -1
  34. package/dist/chapter.d.ts +2 -1
  35. package/dist/chat.d.ts +14 -13
  36. package/dist/checkbox.d.ts +2 -1
  37. package/dist/chip-link.d.ts +2 -1
  38. package/dist/chip-row.d.ts +8 -7
  39. package/dist/chip.d.ts +55 -1
  40. package/dist/chip.js +10 -1
  41. package/dist/choice-grid.d.ts +3 -2
  42. package/dist/chunk-27AWSJTK.js +46 -0
  43. package/dist/chunk-27AWSJTK.js.map +1 -0
  44. package/dist/chunk-44FU32KP.js +2 -0
  45. package/dist/chunk-44FU32KP.js.map +1 -0
  46. package/dist/{chunk-AEP3K4YD.js → chunk-4GQH27IT.js} +2 -2
  47. package/dist/{chunk-QWKCNSPF.js → chunk-5LANVCK7.js} +125 -73
  48. package/dist/chunk-5LANVCK7.js.map +1 -0
  49. package/dist/{chunk-KDXRYUD3.js → chunk-5QEXOGO2.js} +3 -1
  50. package/dist/{chunk-KDXRYUD3.js.map → chunk-5QEXOGO2.js.map} +1 -1
  51. package/dist/chunk-7J2L4HOD.js +340 -0
  52. package/dist/chunk-7J2L4HOD.js.map +1 -0
  53. package/dist/{chunk-7U5TXA5Q.js → chunk-BQ4EOR2O.js} +74 -2
  54. package/dist/chunk-BQ4EOR2O.js.map +1 -0
  55. package/dist/chunk-F6JTHPHE.js +399 -0
  56. package/dist/chunk-F6JTHPHE.js.map +1 -0
  57. package/dist/chunk-OGWB76BR.js +90 -0
  58. package/dist/chunk-OGWB76BR.js.map +1 -0
  59. package/dist/{chunk-VIPSZXO4.js → chunk-UYGUSYIC.js} +72 -2
  60. package/dist/chunk-UYGUSYIC.js.map +1 -0
  61. package/dist/chunk-WOZP3JLW.js +51 -0
  62. package/dist/chunk-WOZP3JLW.js.map +1 -0
  63. package/dist/chunk-XVXFMVG3.js +27 -0
  64. package/dist/chunk-XVXFMVG3.js.map +1 -0
  65. package/dist/code-block.d.ts +2 -1
  66. package/dist/combobox.d.ts +20 -19
  67. package/dist/combobox.js +3 -2
  68. package/dist/command.d.ts +21 -20
  69. package/dist/comparison-table.d.ts +2 -1
  70. package/dist/component-page.d.ts +2 -1
  71. package/dist/confirm-button.d.ts +2 -1
  72. package/dist/contact-page.d.ts +2 -1
  73. package/dist/continue-prompt.d.ts +2 -1
  74. package/dist/countdown.d.ts +2 -1
  75. package/dist/cover-hero.d.ts +20 -19
  76. package/dist/cover-hero.js +25 -42
  77. package/dist/cover-hero.js.map +1 -1
  78. package/dist/cta-panel.d.ts +2 -1
  79. package/dist/dashboard-layout.d.ts +50 -2
  80. package/dist/dashboard-layout.js +66 -11
  81. package/dist/dashboard-layout.js.map +1 -1
  82. package/dist/data-table.d.ts +45 -2
  83. package/dist/data-table.js +7 -3
  84. package/dist/date-picker.d.ts +29 -28
  85. package/dist/decision-list.d.ts +2 -1
  86. package/dist/description-list.d.ts +2 -1
  87. package/dist/detail-layout.d.ts +153 -20
  88. package/dist/detail-layout.js +73 -4
  89. package/dist/detail-layout.js.map +1 -1
  90. package/dist/{dialog-D42QwYb_.d.ts → dialog-DpUwec2g.d.ts} +2 -1
  91. package/dist/dialog.d.ts +3 -2
  92. package/dist/docs-article-page.d.ts +2 -1
  93. package/dist/docs-hub-page.d.ts +2 -1
  94. package/dist/docs-layout.d.ts +2 -1
  95. package/dist/docs-nav.d.ts +3 -10
  96. package/dist/document-viewer.d.ts +5 -4
  97. package/dist/doodle.d.ts +17 -6
  98. package/dist/doodle.js +40 -9
  99. package/dist/doodle.js.map +1 -1
  100. package/dist/drop-overlay.d.ts +2 -1
  101. package/dist/dropdown-menu.d.ts +2 -1
  102. package/dist/dropdown-menu.js +13 -74
  103. package/dist/dropdown-menu.js.map +1 -1
  104. package/dist/elephant.d.ts +2 -1
  105. package/dist/empty-state.d.ts +2 -1
  106. package/dist/engine-flow.d.ts +2 -1
  107. package/dist/error-page.d.ts +2 -1
  108. package/dist/file-upload.d.ts +16 -15
  109. package/dist/filter-bar.d.ts +84 -11
  110. package/dist/filter-bar.js +6 -2
  111. package/dist/flock.d.ts +3 -2
  112. package/dist/footnote.d.ts +2 -1
  113. package/dist/force-update-screen.d.ts +8 -7
  114. package/dist/form/server.d.ts +2 -1
  115. package/dist/form.d.ts +2 -1
  116. package/dist/gallery-page.d.ts +2 -1
  117. package/dist/genui.d.ts +2 -1
  118. package/dist/genui.js +3 -3
  119. package/dist/{geometry-DX-W-Yyf.d.ts → geometry-DZ4Q3hDQ.d.ts} +2 -1
  120. package/dist/glossary-term.d.ts +2 -1
  121. package/dist/glossary.d.ts +2 -1
  122. package/dist/glow-card.d.ts +2 -1
  123. package/dist/goal-gauge.d.ts +2 -1
  124. package/dist/grade-stamp.d.ts +23 -0
  125. package/dist/grade-stamp.js +42 -0
  126. package/dist/grade-stamp.js.map +1 -0
  127. package/dist/how-it-works-page.d.ts +2 -1
  128. package/dist/image-cropper.d.ts +5 -4
  129. package/dist/index.d.ts +3 -2
  130. package/dist/index.js +4 -4
  131. package/dist/iso.d.ts +2 -1
  132. package/dist/kanban.d.ts +2 -1
  133. package/dist/kbd.d.ts +2 -1
  134. package/dist/kind-config-editor.d.ts +152 -0
  135. package/dist/kind-config-editor.js +574 -0
  136. package/dist/kind-config-editor.js.map +1 -0
  137. package/dist/kpi-explained.d.ts +2 -1
  138. package/dist/landing-page.d.ts +2 -1
  139. package/dist/landscape.d.ts +2 -1
  140. package/dist/language-switch/server.d.ts +2 -1
  141. package/dist/language-switch.d.ts +11 -10
  142. package/dist/legal-page.d.ts +2 -1
  143. package/dist/link-card.d.ts +2 -1
  144. package/dist/list.d.ts +2 -1
  145. package/dist/loader.d.ts +2 -1
  146. package/dist/longform-page.d.ts +2 -1
  147. package/dist/maintenance-screen.d.ts +5 -4
  148. package/dist/map.d.ts +14 -13
  149. package/dist/map.js +24 -0
  150. package/dist/map.js.map +1 -1
  151. package/dist/markdown.d.ts +2 -1
  152. package/dist/marketing-layout.d.ts +5 -4
  153. package/dist/marquee.d.ts +2 -1
  154. package/dist/mascot-quote.d.ts +2 -1
  155. package/dist/mascot-state.d.ts +3 -2
  156. package/dist/mascots.d.ts +4 -3
  157. package/dist/match-dialog.d.ts +2 -1
  158. package/dist/media-capture.d.ts +5 -4
  159. package/dist/media-gallery.d.ts +2 -1
  160. package/dist/media-grid.d.ts +3 -10
  161. package/dist/meta-row.d.ts +2 -1
  162. package/dist/meter.d.ts +2 -1
  163. package/dist/motion.d.ts +3 -2
  164. package/dist/native/form.d.ts +2 -1
  165. package/dist/native/list.d.ts +2 -1
  166. package/dist/native/map.d.ts +2 -1
  167. package/dist/native/map.js +24 -0
  168. package/dist/native/map.js.map +1 -1
  169. package/dist/native/markdown.d.ts +2 -1
  170. package/dist/native/media-capture.d.ts +2 -1
  171. package/dist/native/media-picker.d.ts +2 -1
  172. package/dist/native/vertical-video.d.ts +2 -1
  173. package/dist/native/video-player.d.ts +2 -1
  174. package/dist/native.d.ts +230 -1
  175. package/dist/native.js +1465 -965
  176. package/dist/native.js.map +1 -1
  177. package/dist/nav-bar/me.d.ts +2 -1
  178. package/dist/nav-bar.d.ts +2 -1
  179. package/dist/next-actions.d.ts +2 -1
  180. package/dist/notification-preferences.d.ts +23 -22
  181. package/dist/notification-preferences.js +4 -3
  182. package/dist/notification-preferences.js.map +1 -1
  183. package/dist/number-ticker.d.ts +2 -1
  184. package/dist/opening-hours.d.ts +2 -1
  185. package/dist/page-header.d.ts +2 -1
  186. package/dist/page-hero.d.ts +2 -1
  187. package/dist/page-index.d.ts +2 -1
  188. package/dist/page.d.ts +2 -1
  189. package/dist/pagination.d.ts +2 -1
  190. package/dist/photo-grid.d.ts +2 -1
  191. package/dist/pointer-light.d.ts +2 -1
  192. package/dist/popover.d.ts +2 -1
  193. package/dist/pricing-page.d.ts +2 -1
  194. package/dist/product-page.d.ts +2 -1
  195. package/dist/profile-card.d.ts +2 -1
  196. package/dist/progress.d.ts +2 -1
  197. package/dist/promise-card.d.ts +2 -1
  198. package/dist/quota-meter.d.ts +2 -1
  199. package/dist/radio-group.d.ts +2 -1
  200. package/dist/radio-group.js +3 -3
  201. package/dist/rail-nav.d.ts +17 -16
  202. package/dist/rail-nav.js +22 -56
  203. package/dist/rail-nav.js.map +1 -1
  204. package/dist/recipes.d.ts +2 -1
  205. package/dist/retro-tv.d.ts +2 -1
  206. package/dist/router.d.ts +2 -1
  207. package/dist/scroll-stage.d.ts +2 -1
  208. package/dist/search-field.d.ts +2 -1
  209. package/dist/section-backdrop.d.ts +2 -1
  210. package/dist/separator.d.ts +2 -1
  211. package/dist/service-card.d.ts +9 -8
  212. package/dist/settings-layout.d.ts +2 -1
  213. package/dist/settings-layout.js +10 -324
  214. package/dist/settings-layout.js.map +1 -1
  215. package/dist/showcase.d.ts +2 -1
  216. package/dist/signature.d.ts +2 -1
  217. package/dist/site-cahier.d.ts +187 -0
  218. package/dist/site-cahier.js +844 -0
  219. package/dist/site-cahier.js.map +1 -0
  220. package/dist/site-footer.d.ts +2 -1
  221. package/dist/sites.d.ts +2 -1
  222. package/dist/skeleton.d.ts +2 -1
  223. package/dist/skip-link.d.ts +2 -1
  224. package/dist/slider.d.ts +2 -1
  225. package/dist/slot-picker.d.ts +86 -13
  226. package/dist/slot-picker.js +98 -16
  227. package/dist/slot-picker.js.map +1 -1
  228. package/dist/specimen-tag.d.ts +2 -1
  229. package/dist/speed-lines.d.ts +19 -0
  230. package/dist/speed-lines.js +45 -0
  231. package/dist/speed-lines.js.map +1 -0
  232. package/dist/spinner.d.ts +2 -1
  233. package/dist/split-view.d.ts +2 -1
  234. package/dist/stage-banner.d.ts +2 -1
  235. package/dist/stat.d.ts +2 -1
  236. package/dist/status-chip.d.ts +44 -0
  237. package/dist/status-chip.js +137 -0
  238. package/dist/status-chip.js.map +1 -0
  239. package/dist/status-page.d.ts +2 -1
  240. package/dist/step-progress.d.ts +2 -1
  241. package/dist/step-showcase.d.ts +2 -1
  242. package/dist/stepper.d.ts +2 -1
  243. package/dist/sticky-action.d.ts +28 -5
  244. package/dist/sticky-action.js +10 -4
  245. package/dist/sticky-action.js.map +1 -1
  246. package/dist/stuck.d.ts +2 -1
  247. package/dist/swipe-deck.d.ts +2 -1
  248. package/dist/switch.d.ts +2 -1
  249. package/dist/tabs.d.ts +2 -1
  250. package/dist/tag-input.d.ts +2 -1
  251. package/dist/tag-input.js +3 -2
  252. package/dist/tag-input.js.map +1 -1
  253. package/dist/tag-selector.d.ts +30 -4
  254. package/dist/tag-selector.js +90 -8
  255. package/dist/tag-selector.js.map +1 -1
  256. package/dist/taped-photo.d.ts +2 -1
  257. package/dist/taped-photo.js +4 -20
  258. package/dist/taped-photo.js.map +1 -1
  259. package/dist/terminal-replay.d.ts +2 -1
  260. package/dist/terminal-replay.js +1 -1
  261. package/dist/text-style/server.d.ts +2 -1
  262. package/dist/text-style.d.ts +2 -1
  263. package/dist/theme.d.ts +21 -1
  264. package/dist/theme.js +37 -1
  265. package/dist/theme.js.map +1 -1
  266. package/dist/toast.d.ts +2 -1
  267. package/dist/toc.d.ts +2 -1
  268. package/dist/tooltip.d.ts +2 -1
  269. package/dist/tree-view.d.ts +2 -1
  270. package/dist/update-prompt.d.ts +11 -10
  271. package/dist/upload-queue.d.ts +2 -1
  272. package/dist/verified-badge.d.ts +2 -1
  273. package/dist/versus-card.d.ts +40 -0
  274. package/dist/versus-card.js +40 -0
  275. package/dist/versus-card.js.map +1 -0
  276. package/dist/vertical-video.d.ts +2 -1
  277. package/dist/video-player.d.ts +20 -19
  278. package/dist/video-trimmer.d.ts +2 -1
  279. package/dist/virtual.d.ts +8 -7
  280. package/dist/wall.d.ts +79 -0
  281. package/dist/wall.js +127 -0
  282. package/dist/wall.js.map +1 -0
  283. package/dist/waveform.d.ts +2 -1
  284. package/package.json +140 -41
  285. package/registry/account-menu.json +1 -1
  286. package/registry/account-settings.json +257 -5
  287. package/registry/achievement.json +1 -1
  288. package/registry/action-bar.json +1 -1
  289. package/registry/activity-feed.json +1 -1
  290. package/registry/agenda.json +1 -1
  291. package/registry/alert.json +1 -1
  292. package/registry/anatomy-plate.json +1 -1
  293. package/registry/app-header.json +1 -1
  294. package/registry/app-shell.json +1 -1
  295. package/registry/argument-card.json +1 -1
  296. package/registry/audio-player.json +1 -1
  297. package/registry/auth-layout.json +1 -1
  298. package/registry/avatar.json +1 -1
  299. package/registry/badge.json +1 -1
  300. package/registry/bird-plate.json +1 -1
  301. package/registry/button.json +1 -1
  302. package/registry/captcha.json +1 -1
  303. package/registry/card-grid.json +1 -1
  304. package/registry/card.json +1 -1
  305. package/registry/catalogue-page.json +116 -6
  306. package/registry/changelog-page.json +1 -1
  307. package/registry/chapter.json +1 -1
  308. package/registry/chat.json +1 -1
  309. package/registry/checkbox.json +1 -1
  310. package/registry/chip-link.json +1 -1
  311. package/registry/chip-row.json +1 -1
  312. package/registry/chip.json +386 -11
  313. package/registry/choice-grid.json +1 -1
  314. package/registry/code-block.json +1 -1
  315. package/registry/combobox.json +1 -1
  316. package/registry/command.json +1 -1
  317. package/registry/comparison-table.json +1 -1
  318. package/registry/component-page.json +1 -1
  319. package/registry/confirm-button.json +1 -1
  320. package/registry/contact-page.json +1 -1
  321. package/registry/continue-prompt.json +1 -1
  322. package/registry/countdown.json +1 -1
  323. package/registry/cover-hero.json +1 -1
  324. package/registry/cta-panel.json +1 -1
  325. package/registry/dashboard-layout.json +91 -5
  326. package/registry/data-table.json +156 -5
  327. package/registry/date-picker.json +1 -1
  328. package/registry/decision-list.json +1 -1
  329. package/registry/description-list.json +1 -1
  330. package/registry/detail-layout.json +199 -5
  331. package/registry/dialog.json +1 -1
  332. package/registry/docs-article-page.json +1 -1
  333. package/registry/docs-hub-page.json +1 -1
  334. package/registry/docs-layout.json +1 -1
  335. package/registry/docs-nav.json +1 -1
  336. package/registry/document-viewer.json +1 -1
  337. package/registry/doodle.json +115 -22
  338. package/registry/drop-overlay.json +1 -1
  339. package/registry/dropdown-menu.json +1 -1
  340. package/registry/elephant.json +2 -2
  341. package/registry/empty-state.json +1 -1
  342. package/registry/engine-flow.json +1 -1
  343. package/registry/error-page.json +1 -1
  344. package/registry/examples/account-settings/appearance.d.ts +4 -0
  345. package/registry/examples/account-settings/appearance.js +40 -0
  346. package/registry/examples/account-settings/appearance.tsx +30 -0
  347. package/registry/examples/catalogue-page/clients.d.ts +4 -0
  348. package/registry/examples/catalogue-page/clients.js +49 -0
  349. package/registry/examples/catalogue-page/clients.tsx +61 -0
  350. package/registry/examples/chip/marker-picker.d.ts +4 -0
  351. package/registry/examples/chip/marker-picker.js +17 -0
  352. package/registry/examples/chip/marker-picker.tsx +17 -0
  353. package/registry/examples/chip/native/marker-picker.d.ts +4 -0
  354. package/registry/examples/chip/native/marker-picker.dark.png +0 -0
  355. package/registry/examples/chip/native/marker-picker.js +18 -0
  356. package/registry/examples/chip/native/marker-picker.light.png +0 -0
  357. package/registry/examples/chip/native/marker-picker.tsx +16 -0
  358. package/registry/examples/chip/native/tags.d.ts +4 -0
  359. package/registry/examples/chip/native/tags.dark.png +0 -0
  360. package/registry/examples/chip/native/tags.js +22 -0
  361. package/registry/examples/chip/native/tags.light.png +0 -0
  362. package/registry/examples/chip/native/tags.tsx +20 -0
  363. package/registry/examples/chip/tags.d.ts +4 -0
  364. package/registry/examples/chip/tags.js +26 -0
  365. package/registry/examples/chip/tags.tsx +23 -0
  366. package/registry/examples/dashboard-layout/today.d.ts +4 -0
  367. package/registry/examples/dashboard-layout/today.js +54 -0
  368. package/registry/examples/dashboard-layout/today.tsx +63 -0
  369. package/registry/examples/data-table/bulk.d.ts +4 -0
  370. package/registry/examples/data-table/bulk.js +45 -0
  371. package/registry/examples/data-table/bulk.tsx +34 -0
  372. package/registry/examples/detail-layout/client.d.ts +4 -0
  373. package/registry/examples/detail-layout/client.js +40 -0
  374. package/registry/examples/detail-layout/client.tsx +39 -0
  375. package/registry/examples/detail-layout/new-invoice.d.ts +4 -0
  376. package/registry/examples/detail-layout/new-invoice.js +44 -0
  377. package/registry/examples/detail-layout/new-invoice.tsx +34 -0
  378. package/registry/examples/doodle/bird-sketch.d.ts +4 -0
  379. package/registry/examples/doodle/bird-sketch.js +11 -0
  380. package/registry/examples/doodle/bird-sketch.tsx +12 -0
  381. package/registry/examples/doodle/margin-marks.d.ts +4 -0
  382. package/registry/examples/doodle/margin-marks.js +27 -0
  383. package/registry/examples/doodle/margin-marks.tsx +19 -0
  384. package/registry/examples/filter-bar/views.d.ts +4 -0
  385. package/registry/examples/filter-bar/views.js +39 -0
  386. package/registry/examples/filter-bar/views.tsx +30 -0
  387. package/registry/examples/grade-stamp/coverage.d.ts +4 -0
  388. package/registry/examples/grade-stamp/coverage.js +12 -0
  389. package/registry/examples/grade-stamp/coverage.tsx +8 -0
  390. package/registry/examples/grade-stamp/lighthouse.d.ts +4 -0
  391. package/registry/examples/grade-stamp/lighthouse.js +12 -0
  392. package/registry/examples/grade-stamp/lighthouse.tsx +14 -0
  393. package/registry/examples/kind-config-editor/derived.d.ts +4 -0
  394. package/registry/examples/kind-config-editor/derived.js +26 -0
  395. package/registry/examples/kind-config-editor/derived.tsx +16 -0
  396. package/registry/examples/kind-config-editor/native/status-set.d.ts +4 -0
  397. package/registry/examples/kind-config-editor/native/status-set.dark.png +0 -0
  398. package/registry/examples/kind-config-editor/native/status-set.js +22 -0
  399. package/registry/examples/kind-config-editor/native/status-set.light.png +0 -0
  400. package/registry/examples/kind-config-editor/native/status-set.tsx +19 -0
  401. package/registry/examples/kind-config-editor/native/tag-set.d.ts +4 -0
  402. package/registry/examples/kind-config-editor/native/tag-set.dark.png +0 -0
  403. package/registry/examples/kind-config-editor/native/tag-set.js +20 -0
  404. package/registry/examples/kind-config-editor/native/tag-set.light.png +0 -0
  405. package/registry/examples/kind-config-editor/native/tag-set.tsx +18 -0
  406. package/registry/examples/kind-config-editor/status-set.d.ts +4 -0
  407. package/registry/examples/kind-config-editor/status-set.js +29 -0
  408. package/registry/examples/kind-config-editor/status-set.tsx +25 -0
  409. package/registry/examples/kind-config-editor/tag-set.d.ts +4 -0
  410. package/registry/examples/kind-config-editor/tag-set.js +20 -0
  411. package/registry/examples/kind-config-editor/tag-set.tsx +18 -0
  412. package/registry/examples/site-cahier/java-releases.d.ts +4 -0
  413. package/registry/examples/site-cahier/java-releases.js +33 -0
  414. package/registry/examples/site-cahier/java-releases.tsx +32 -0
  415. package/registry/examples/site-cahier/motion-lab.d.ts +4 -0
  416. package/registry/examples/site-cahier/motion-lab.js +32 -0
  417. package/registry/examples/site-cahier/motion-lab.tsx +29 -0
  418. package/registry/examples/site-cahier/ts-changelog.d.ts +4 -0
  419. package/registry/examples/site-cahier/ts-changelog.js +24 -0
  420. package/registry/examples/site-cahier/ts-changelog.tsx +20 -0
  421. package/registry/examples/site-cahier/ts-doc.d.ts +4 -0
  422. package/registry/examples/site-cahier/ts-doc.js +38 -0
  423. package/registry/examples/site-cahier/ts-doc.tsx +27 -0
  424. package/registry/examples/site-cahier/ui-home.d.ts +4 -0
  425. package/registry/examples/site-cahier/ui-home.js +46 -0
  426. package/registry/examples/site-cahier/ui-home.tsx +40 -0
  427. package/registry/examples/slot-picker/weeks.d.ts +4 -0
  428. package/registry/examples/slot-picker/weeks.js +45 -0
  429. package/registry/examples/slot-picker/weeks.tsx +28 -0
  430. package/registry/examples/speed-lines/hero.d.ts +4 -0
  431. package/registry/examples/speed-lines/hero.js +11 -0
  432. package/registry/examples/speed-lines/hero.tsx +12 -0
  433. package/registry/examples/speed-lines/streaks.d.ts +4 -0
  434. package/registry/examples/speed-lines/streaks.js +11 -0
  435. package/registry/examples/speed-lines/streaks.tsx +12 -0
  436. package/registry/examples/status-chip/default.d.ts +4 -0
  437. package/registry/examples/status-chip/default.js +35 -0
  438. package/registry/examples/status-chip/default.tsx +32 -0
  439. package/registry/examples/status-chip/native/default.d.ts +4 -0
  440. package/registry/examples/status-chip/native/default.dark.png +0 -0
  441. package/registry/examples/status-chip/native/default.js +26 -0
  442. package/registry/examples/status-chip/native/default.light.png +0 -0
  443. package/registry/examples/status-chip/native/default.tsx +20 -0
  444. package/registry/examples/tag-selector/creatable.d.ts +4 -0
  445. package/registry/examples/tag-selector/creatable.js +41 -0
  446. package/registry/examples/tag-selector/creatable.tsx +29 -0
  447. package/registry/examples/tag-selector/native/tags.d.ts +4 -0
  448. package/registry/examples/tag-selector/native/tags.dark.png +0 -0
  449. package/registry/examples/tag-selector/native/tags.js +19 -0
  450. package/registry/examples/tag-selector/native/tags.light.png +0 -0
  451. package/registry/examples/tag-selector/native/tags.tsx +19 -0
  452. package/registry/examples/versus-card/alternatives.d.ts +4 -0
  453. package/registry/examples/versus-card/alternatives.js +20 -0
  454. package/registry/examples/versus-card/alternatives.tsx +14 -0
  455. package/registry/examples/versus-card/releases.d.ts +4 -0
  456. package/registry/examples/versus-card/releases.js +35 -0
  457. package/registry/examples/versus-card/releases.tsx +29 -0
  458. package/registry/examples/wall/brick.d.ts +4 -0
  459. package/registry/examples/wall/brick.js +14 -0
  460. package/registry/examples/wall/brick.tsx +8 -0
  461. package/registry/examples/wall/composition-fr.d.ts +4 -0
  462. package/registry/examples/wall/composition-fr.js +37 -0
  463. package/registry/examples/wall/composition-fr.tsx +18 -0
  464. package/registry/examples/wall/composition.d.ts +4 -0
  465. package/registry/examples/wall/composition.js +38 -0
  466. package/registry/examples/wall/composition.tsx +18 -0
  467. package/registry/examples/wall/pinned-note.d.ts +4 -0
  468. package/registry/examples/wall/pinned-note.js +15 -0
  469. package/registry/examples/wall/pinned-note.tsx +9 -0
  470. package/registry/examples/wall/plaster.d.ts +4 -0
  471. package/registry/examples/wall/plaster.js +14 -0
  472. package/registry/examples/wall/plaster.tsx +8 -0
  473. package/registry/examples/wall/polaroid.d.ts +4 -0
  474. package/registry/examples/wall/polaroid.js +19 -0
  475. package/registry/examples/wall/polaroid.tsx +10 -0
  476. package/registry/examples/wall/ridge.d.ts +4 -0
  477. package/registry/examples/wall/ridge.js +14 -0
  478. package/registry/examples/wall/ridge.tsx +8 -0
  479. package/registry/examples/wall/shop-sign.d.ts +4 -0
  480. package/registry/examples/wall/shop-sign.js +16 -0
  481. package/registry/examples/wall/shop-sign.tsx +10 -0
  482. package/registry/examples/wall/zellige.d.ts +4 -0
  483. package/registry/examples/wall/zellige.js +14 -0
  484. package/registry/examples/wall/zellige.tsx +8 -0
  485. package/registry/field.json +1 -1
  486. package/registry/file-upload.json +1 -1
  487. package/registry/filter-bar.json +208 -8
  488. package/registry/flock.json +1 -1
  489. package/registry/footnote.json +1 -1
  490. package/registry/force-update-screen.json +1 -1
  491. package/registry/form.json +1 -1
  492. package/registry/gallery-page.json +1 -1
  493. package/registry/genui.json +1 -1
  494. package/registry/glossary-term.json +1 -1
  495. package/registry/glossary.json +1 -1
  496. package/registry/glow-card.json +1 -1
  497. package/registry/goal-gauge.json +1 -1
  498. package/registry/grade-stamp.json +227 -0
  499. package/registry/how-it-works-page.json +1 -1
  500. package/registry/image-cropper.json +1 -1
  501. package/registry/index.json +355 -30
  502. package/registry/iso.json +1 -1
  503. package/registry/kanban.json +1 -1
  504. package/registry/kbd.json +1 -1
  505. package/registry/kind-config-editor.json +565 -0
  506. package/registry/kpi-explained.json +1 -1
  507. package/registry/landing-page.json +1 -1
  508. package/registry/landscape.json +1 -1
  509. package/registry/language-switch.json +1 -1
  510. package/registry/legal-page.json +1 -1
  511. package/registry/link-card.json +1 -1
  512. package/registry/list.json +1 -1
  513. package/registry/loader.json +1 -1
  514. package/registry/longform-page.json +1 -1
  515. package/registry/maintenance-screen.json +1 -1
  516. package/registry/map.json +2 -2
  517. package/registry/markdown.json +1 -1
  518. package/registry/marketing-layout.json +1 -1
  519. package/registry/marquee.json +1 -1
  520. package/registry/mascot-quote.json +1 -1
  521. package/registry/mascot-state.json +1 -1
  522. package/registry/mascots.json +1 -1
  523. package/registry/match-dialog.json +1 -1
  524. package/registry/media-capture.json +1 -1
  525. package/registry/media-gallery.json +1 -1
  526. package/registry/media-grid.json +1 -1
  527. package/registry/meta-row.json +1 -1
  528. package/registry/meter.json +1 -1
  529. package/registry/nav-bar.json +2 -2
  530. package/registry/next-actions.json +1 -1
  531. package/registry/notification-preferences.json +1 -1
  532. package/registry/number-ticker.json +1 -1
  533. package/registry/opening-hours.json +1 -1
  534. package/registry/page-header.json +1 -1
  535. package/registry/page-hero.json +1 -1
  536. package/registry/page-index.json +1 -1
  537. package/registry/page.json +1 -1
  538. package/registry/pagination.json +1 -1
  539. package/registry/photo-grid.json +1 -1
  540. package/registry/pointer-light.json +1 -1
  541. package/registry/popover.json +1 -1
  542. package/registry/pricing-page.json +1 -1
  543. package/registry/product-page.json +1 -1
  544. package/registry/profile-card.json +1 -1
  545. package/registry/progress.json +1 -1
  546. package/registry/promise-card.json +1 -1
  547. package/registry/quota-meter.json +1 -1
  548. package/registry/radio-group.json +1 -1
  549. package/registry/rail-nav.json +2 -2
  550. package/registry/recipes.json +1 -1
  551. package/registry/retro-tv.json +1 -1
  552. package/registry/router.json +1 -1
  553. package/registry/scroll-stage.json +1 -1
  554. package/registry/search-field.json +1 -1
  555. package/registry/section-backdrop.json +1 -1
  556. package/registry/separator.json +1 -1
  557. package/registry/service-card.json +1 -1
  558. package/registry/settings-layout.json +1 -1
  559. package/registry/showcase.json +1 -1
  560. package/registry/signature.json +1 -1
  561. package/registry/site-cahier.json +548 -0
  562. package/registry/site-footer.json +2 -2
  563. package/registry/sites.json +1 -1
  564. package/registry/skeleton.json +1 -1
  565. package/registry/skip-link.json +1 -1
  566. package/registry/slider.json +1 -1
  567. package/registry/slot-picker.json +156 -10
  568. package/registry/slot.json +1 -1
  569. package/registry/specimen-tag.json +1 -1
  570. package/registry/speed-lines.json +174 -0
  571. package/registry/spinner.json +1 -1
  572. package/registry/split-view.json +1 -1
  573. package/registry/stage-banner.json +1 -1
  574. package/registry/stat.json +1 -1
  575. package/registry/status-chip.json +350 -0
  576. package/registry/status-page.json +1 -1
  577. package/registry/step-progress.json +1 -1
  578. package/registry/step-showcase.json +1 -1
  579. package/registry/stepper.json +1 -1
  580. package/registry/sticky-action.json +38 -8
  581. package/registry/stuck.json +1 -1
  582. package/registry/swipe-deck.json +1 -1
  583. package/registry/switch.json +1 -1
  584. package/registry/tabs.json +1 -1
  585. package/registry/tag-input.json +1 -1
  586. package/registry/tag-selector.json +189 -12
  587. package/registry/taped-photo.json +1 -1
  588. package/registry/terminal-replay.json +1 -1
  589. package/registry/text-style.json +1 -1
  590. package/registry/theme.json +3 -3
  591. package/registry/toast.json +1 -1
  592. package/registry/toc.json +1 -1
  593. package/registry/tooltip.json +1 -1
  594. package/registry/tree-view.json +1 -1
  595. package/registry/update-prompt.json +1 -1
  596. package/registry/upload-queue.json +1 -1
  597. package/registry/verified-badge.json +1 -1
  598. package/registry/versus-card.json +194 -0
  599. package/registry/vertical-video.json +1 -1
  600. package/registry/video-player.json +1 -1
  601. package/registry/video-trimmer.json +1 -1
  602. package/registry/virtual.json +2 -2
  603. package/registry/wall.json +511 -0
  604. package/registry/waveform.json +1 -1
  605. package/dist/chunk-7U5TXA5Q.js.map +0 -1
  606. package/dist/chunk-OIMXKRXF.js +0 -179
  607. package/dist/chunk-OIMXKRXF.js.map +0 -1
  608. package/dist/chunk-QWKCNSPF.js.map +0 -1
  609. package/dist/chunk-VIPSZXO4.js.map +0 -1
  610. /package/dist/{chunk-AEP3K4YD.js.map → chunk-4GQH27IT.js.map} +0 -0
@@ -14,7 +14,7 @@
14
14
  },
15
15
  "native": {
16
16
  "state": "n/a",
17
- "reason": "The apps pick a time in their own booking flow.",
17
+ "reason": "The apps pick a time in their own booking flow; a native twin of the weeks follows the first app that needs it.",
18
18
  "use": "date-picker"
19
19
  },
20
20
  "desktop": {
@@ -39,18 +39,30 @@
39
39
  "Compute the slots on the server from the shop's availability and pass only free ones: the picker never decides what is free.",
40
40
  "Format the labels for the reader's locale and the shop's time zone (`9 h 30` in French, `9:30 AM` in English).",
41
41
  "Show the days that have a free time only, a dozen at most; say plainly when none is (`emptyLabel`).",
42
+ "With `week`, the host loads the days of the week it is asked for (`onWeekChange`) and sets `minWeek` / `maxWeek` to what it offers; pass `weekHref` to keep the address as the state (`?week=`, and `?slot=` through each time's `href`).",
43
+ "Put the time zone and the duration in `footer`, formatted with `@krizaka/intl` (`Montréal (UTC−4) · 45 min`); the labels of the parts of the day come from the host's messages.",
42
44
  "Use `note` for what changes the choice (`2 spots left`), not for decoration."
43
45
  ],
44
46
  "accessibility": {
45
47
  "keyboard": [
46
48
  {
47
49
  "keys": "Tab, Enter or Space",
48
- "action": "Moves through the days, then the times; Enter or Space chooses."
50
+ "action": "Moves through the week buttons, the days, then the times; Enter or Space chooses."
51
+ },
52
+ {
53
+ "keys": "← →",
54
+ "action": "Moves between the days, and between the times of a day (a full time is skipped)."
55
+ },
56
+ {
57
+ "keys": "Page Up, Page Down",
58
+ "action": "Previous or next week (`week`); focus returns to the chosen day."
49
59
  }
50
60
  ],
51
61
  "notes": [
52
62
  "The days are toggle buttons in a group named by `label`; the chosen day is `aria-pressed`.",
53
63
  "The times are a list named by the day; each is a link, or a toggle with `aria-pressed` when it is the chosen one.",
64
+ "With `week`, the week in words (`weekLabel`) is a polite live region: a week change is announced. The week buttons are named (`weekButtons`); at an end (`minWeek`, `maxWeek`) they are `aria-disabled`.",
65
+ "A full time is struck out and disabled, and its `note` (`Full`) is read with it — never colour alone. Parts of the day (`groups`) are lists named `day · part`.",
54
66
  "A time that is no longer offered is a disabled button, never removed silently under the reader's finger."
55
67
  ]
56
68
  },
@@ -66,7 +78,7 @@
66
78
  "props": [
67
79
  {
68
80
  "component": "SlotPicker",
69
- "description": "Tappable free times by day: the day strip, then the day's chips — links or toggles.",
81
+ "description": "Tappable free times by day: the day strip, then the day's chips (in parts of the day if asked) — links or toggles — and, with `week`, ← Today →.",
70
82
  "props": [
71
83
  {
72
84
  "name": "days",
@@ -96,11 +108,32 @@
96
108
  "description": "The first day shown. Default: the first of `days`.",
97
109
  "required": false
98
110
  },
111
+ {
112
+ "name": "footer",
113
+ "type": "ReactNode",
114
+ "default": null,
115
+ "description": "The context line under the times: time zone and duration (`Montréal (UTC−4) · 45 min`), formatted by the host.",
116
+ "required": false
117
+ },
99
118
  {
100
119
  "name": "linkAs",
101
120
  "type": "LinkComponent",
102
121
  "default": null,
103
- "description": "The app's link component for the times that have an `href`.",
122
+ "description": "The app's link component for the times that have an `href`, and for the week buttons when `weekHref` is set.",
123
+ "required": false
124
+ },
125
+ {
126
+ "name": "maxWeek",
127
+ "type": "string",
128
+ "default": null,
129
+ "description": "The latest week the host offers (ISO date): → is disabled there.",
130
+ "required": false
131
+ },
132
+ {
133
+ "name": "minWeek",
134
+ "type": "string",
135
+ "default": null,
136
+ "description": "The earliest week the host offers (ISO date): ← is disabled there.",
104
137
  "required": false
105
138
  },
106
139
  {
@@ -110,12 +143,54 @@
110
143
  "description": "Called with the chosen slot's id.",
111
144
  "required": false
112
145
  },
146
+ {
147
+ "name": "onWeekChange",
148
+ "type": "((week: string) => void)",
149
+ "default": null,
150
+ "description": "Called with the ISO date of the week asked for (± 7 days, or `todayWeek`). The host loads that week's days.",
151
+ "required": false
152
+ },
153
+ {
154
+ "name": "todayWeek",
155
+ "type": "string",
156
+ "default": null,
157
+ "description": "The current week, where « Today » goes back to. Default: `minWeek`.",
158
+ "required": false
159
+ },
113
160
  {
114
161
  "name": "value",
115
162
  "type": "string | null",
116
163
  "default": null,
117
164
  "description": "The chosen slot's id (controlled).",
118
165
  "required": false
166
+ },
167
+ {
168
+ "name": "week",
169
+ "type": "string",
170
+ "default": null,
171
+ "description": "The week shown, the ISO date of its first day (`2026-10-19`; controlled). Setting it turns on ← Today →.",
172
+ "required": false
173
+ },
174
+ {
175
+ "name": "weekButtons",
176
+ "type": "{ previous: string; today: string; next: string; }",
177
+ "default": null,
178
+ "description": "Names of the three week buttons, translated: `{ previous: \"Previous week\", today: \"Today\", next: \"Next week\" }`.",
179
+ "required": false
180
+ },
181
+ {
182
+ "name": "weekHref",
183
+ "type": "((week: string) => string)",
184
+ "default": null,
185
+ "description": "Makes the week buttons links (the address holds the state: `?week=`), given the week they go to.",
186
+ "required": false
187
+ },
188
+ {
189
+ "name": "weekLabel",
190
+ "type": "string",
191
+ "default": null,
192
+ "description": "The week in words, formatted by the host with `@krizaka/intl` (`19 – 25 Oct`); announced politely at every change.",
193
+ "required": false
119
194
  }
120
195
  ]
121
196
  }
@@ -128,6 +203,14 @@
128
203
  "path": "examples/slot-picker/times.tsx",
129
204
  "module": "@krizaka/ui/registry/examples/slot-picker/times",
130
205
  "code": "\"use client\";\nimport { SlotPicker } from \"@krizaka/ui/slot-picker\";\nimport * as React from \"react\";\n\nconst at = (id: string, label: string, note?: string) => ({ id, label, note });\n\n// The next free times by day; the reader presses one (or each time is a link to the booking page).\nexport default function SlotPickerTimes() {\n const [value, setValue] = React.useState<string | null>(\"mon-0930\");\n return (\n <SlotPicker\n label=\"Available times\"\n emptyLabel=\"No time is free in the next two weeks.\"\n value={value}\n onValueChange={setValue}\n days={[\n { id: \"mon\", label: \"Today\", sub: \"Oct 19\", slots: [at(\"mon-0930\", \"9:30 AM\"), at(\"mon-1000\", \"10:00 AM\", \"2 spots\"), at(\"mon-1330\", \"1:30 PM\")] },\n { id: \"tue\", label: \"Tue\", sub: \"Oct 20\", slots: [at(\"tue-0800\", \"8:00 AM\"), at(\"tue-1400\", \"2:00 PM\")] },\n { id: \"wed\", label: \"Wed\", sub: \"Oct 21\", slots: [at(\"wed-0900\", \"9:00 AM\")] },\n ]}\n />\n );\n}\n"
206
+ },
207
+ {
208
+ "name": "weeks",
209
+ "title": "Weeks",
210
+ "description": "← Today →: the host loads each week; times in Morning and Afternoon, a full time struck out and announced, the time zone and the duration under them.",
211
+ "path": "examples/slot-picker/weeks.tsx",
212
+ "module": "@krizaka/ui/registry/examples/slot-picker/weeks",
213
+ "code": "\"use client\";\nimport { type PickerDay, SlotPicker } from \"@krizaka/ui/slot-picker\";\nimport * as React from \"react\";\n\n// A fictitious shop: the host loads the days of the week it is asked for; the picker only shows them.\nconst t = (id: string, label: string, note?: string, disabled?: boolean) => ({ id, label, note, disabled });\nconst am = [t(\"a\", \"9:00 AM\"), t(\"b\", \"9:45 AM\", \"Full\", true), t(\"c\", \"10:30 AM\")];\nconst day = (id: string, label: string, sub: string, pm: PickerDay[\"slots\"]): PickerDay => ({\n id, label, sub, groups: [{ id: \"am\", label: \"Morning\", slots: am.map((s) => ({ ...s, id: id + s.id })) }, { id: \"pm\", label: \"Afternoon\", slots: pm ?? [] }],\n});\nconst WEEKS: Record<string, { label: string; days: PickerDay[] }> = {\n \"2026-10-19\": { label: \"Oct 19 – 25\", days: [day(\"20\", \"Tue\", \"Oct 20\", [t(\"20p\", \"2:00 PM\"), t(\"20q\", \"3:30 PM\", \"1 spot left\")])] },\n \"2026-10-26\": { label: \"Oct 26 – Nov 1\", days: [day(\"27\", \"Tue\", \"Oct 27\", [t(\"27p\", \"1:00 PM\")])] },\n \"2026-11-02\": { label: \"Nov 2 – 8\", days: [] },\n};\n\nexport default function SlotPickerWeeks() {\n const [week, setWeek] = React.useState(\"2026-10-19\");\n const [value, setValue] = React.useState<string | null>(\"20c\");\n const data = WEEKS[week] ?? { label: week, days: [] };\n return (\n <SlotPicker\n label=\"Available times\" emptyLabel=\"Nothing free this week — try the next one.\" days={data.days} value={value} onValueChange={setValue}\n week={week} onWeekChange={setWeek} minWeek=\"2026-10-19\" maxWeek=\"2026-11-02\" todayWeek=\"2026-10-19\" weekLabel={data.label}\n weekButtons={{ previous: \"Previous week\", today: \"Today\", next: \"Next week\" }} footer=\"Montréal (UTC−4) · 45 min\"\n />\n );\n}\n"
131
214
  }
132
215
  ]
133
216
  },
@@ -139,19 +222,19 @@
139
222
  },
140
223
  {
141
224
  "path": "meta.ts",
142
- "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 | \"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 | \"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"
225
+ "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 | \"wall\";\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"
143
226
  },
144
227
  {
145
228
  "path": "slot-picker/index.ts",
146
- "content": "/** @krizaka/ui/slot-picker — `SlotPicker` (`days`, `label`, `emptyLabel`, `value`, `onValueChange`, `linkAs`), `slotPicker`: the next free times as chips, by day. Client. */\nexport { type PickerDay, type PickerSlot, SlotPicker, slotPicker, type SlotPickerProps } from \"./slot-picker\";\n"
229
+ "content": "/** @krizaka/ui/slot-picker — `SlotPicker` (`days`, `label`, `emptyLabel`, `value`, `onValueChange`, `linkAs`, `week`/`onWeekChange`/`minWeek`/`maxWeek`, `footer`), `slotPicker`: the next free times as chips, by day. Client. */\nexport { type PickerDay, type PickerGroup, type PickerSlot, SlotPicker, slotPicker, type SlotPickerProps } from \"./slot-picker\";\n"
147
230
  },
148
231
  {
149
232
  "path": "slot-picker/meta.ts",
150
- "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Slot picker\",\n summary: \"The next free times of a service as tappable chips: a strip of days, then the day's times — each a link to the booking page or a toggle the reader presses.\",\n status: \"beta\",\n category: \"forms\",\n platforms: \"web\",\n parity: { native: { status: \"n/a\", reason: \"The apps pick a time in their own booking flow.\", use: \"date-picker\" }, desktop: \"web\" },\n whenToUse: [\n \"A booking page that offers the real availability in one tap: the next days and their free times.\",\n \"On a shop's public page, with each time a link that opens the booking with that time chosen.\",\n ],\n whenNotToUse: [\n { when: \"Picking any date of a calendar, free of availability.\", use: \"date-picker\" },\n { when: \"Choosing between a few options that are not times.\", use: \"choice-grid\" },\n ],\n bestPractices: [\n \"Compute the slots on the server from the shop's availability and pass only free ones: the picker never decides what is free.\",\n \"Format the labels for the reader's locale and the shop's time zone (`9 h 30` in French, `9:30 AM` in English).\",\n \"Show the days that have a free time only, a dozen at most; say plainly when none is (`emptyLabel`).\",\n \"Use `note` for what changes the choice (`2 spots left`), not for decoration.\",\n ],\n accessibility: {\n keyboard: [{ keys: \"Tab, Enter or Space\", action: \"Moves through the days, then the times; Enter or Space chooses.\" }],\n notes: [\n \"The days are toggle buttons in a group named by `label`; the chosen day is `aria-pressed`.\",\n \"The times are a list named by the day; each is a link, or a toggle with `aria-pressed` when it is the chosen one.\",\n \"A time that is no longer offered is a disabled button, never removed silently under the reader's finger.\",\n ],\n },\n related: [\"service-card\", \"opening-hours\", \"date-picker\", \"chip\"],\n web: {\n imports: [\"SlotPicker\"],\n examples: [{ name: \"times\", title: \"Times\", description: \"Three days of free times; the reader presses one, and a time with few seats says so.\" }],\n },\n} satisfies ComponentMeta;\n"
233
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Slot picker\",\n summary: \"The next free times of a service as tappable chips: a strip of days, then the day's times — each a link to the booking page or a toggle the reader presses.\",\n status: \"beta\",\n category: \"forms\",\n platforms: \"web\",\n parity: { native: { status: \"n/a\", reason: \"The apps pick a time in their own booking flow; a native twin of the weeks follows the first app that needs it.\", use: \"date-picker\" }, desktop: \"web\" },\n whenToUse: [\n \"A booking page that offers the real availability in one tap: the next days and their free times.\",\n \"On a shop's public page, with each time a link that opens the booking with that time chosen.\",\n ],\n whenNotToUse: [\n { when: \"Picking any date of a calendar, free of availability.\", use: \"date-picker\" },\n { when: \"Choosing between a few options that are not times.\", use: \"choice-grid\" },\n ],\n bestPractices: [\n \"Compute the slots on the server from the shop's availability and pass only free ones: the picker never decides what is free.\",\n \"Format the labels for the reader's locale and the shop's time zone (`9 h 30` in French, `9:30 AM` in English).\",\n \"Show the days that have a free time only, a dozen at most; say plainly when none is (`emptyLabel`).\",\n \"With `week`, the host loads the days of the week it is asked for (`onWeekChange`) and sets `minWeek` / `maxWeek` to what it offers; pass `weekHref` to keep the address as the state (`?week=`, and `?slot=` through each time's `href`).\",\n \"Put the time zone and the duration in `footer`, formatted with `@krizaka/intl` (`Montréal (UTC−4) · 45 min`); the labels of the parts of the day come from the host's messages.\",\n \"Use `note` for what changes the choice (`2 spots left`), not for decoration.\",\n ],\n accessibility: {\n keyboard: [\n { keys: \"Tab, Enter or Space\", action: \"Moves through the week buttons, the days, then the times; Enter or Space chooses.\" },\n { keys: \"← →\", action: \"Moves between the days, and between the times of a day (a full time is skipped).\" },\n { keys: \"Page Up, Page Down\", action: \"Previous or next week (`week`); focus returns to the chosen day.\" },\n ],\n notes: [\n \"The days are toggle buttons in a group named by `label`; the chosen day is `aria-pressed`.\",\n \"The times are a list named by the day; each is a link, or a toggle with `aria-pressed` when it is the chosen one.\",\n \"With `week`, the week in words (`weekLabel`) is a polite live region: a week change is announced. The week buttons are named (`weekButtons`); at an end (`minWeek`, `maxWeek`) they are `aria-disabled`.\",\n \"A full time is struck out and disabled, and its `note` (`Full`) is read with it — never colour alone. Parts of the day (`groups`) are lists named `day · part`.\",\n \"A time that is no longer offered is a disabled button, never removed silently under the reader's finger.\",\n ],\n },\n related: [\"service-card\", \"opening-hours\", \"date-picker\", \"chip\"],\n web: {\n imports: [\"SlotPicker\"],\n examples: [\n { name: \"times\", title: \"Times\", description: \"Three days of free times; the reader presses one, and a time with few seats says so.\" },\n { name: \"weeks\", title: \"Weeks\", description: \"← Today →: the host loads each week; times in Morning and Afternoon, a full time struck out and announced, the time zone and the duration under them.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
151
234
  },
152
235
  {
153
236
  "path": "slot-picker/slot-picker.tsx",
154
- "content": "// Client (the chosen day). The next free times of a service as tappable chips: a strip of days, then the day's times.\n// A time is a link (`href`: the booking page with the time chosen) or a toggle the reader presses (`value`,\n// `onValueChange`). The app computes the slots (its availability is the truth) and formats the labels.\nimport * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nimport { BlockLink, type LinkComponent } from \"../block-link\";\n\nexport const slotPicker = tv({\n slots: {\n root: \"flex min-w-0 flex-col gap-3\",\n days: \"flex gap-2 overflow-x-auto p-1 [scrollbar-width:none] [&::-webkit-scrollbar]:hidden\",\n day:\n \"flex min-h-12 min-w-[4.5rem] shrink-0 cursor-pointer flex-col items-center justify-center rounded-xl border border-border-default bg-surface-1 px-3 py-1.5 text-center leading-tight text-fg-secondary \" +\n \"transition-colors hover:border-border-strong hover:text-fg focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring \" +\n \"aria-pressed:border-accent aria-pressed:bg-accent-soft aria-pressed:text-fg\",\n dayName: \"text-xs font-bold\",\n daySub: \"text-[11px] tabular-nums text-fg-muted\",\n times: \"m-0 flex list-none flex-wrap gap-2 p-0\",\n time:\n \"inline-flex min-h-11 min-w-[4.75rem] items-center justify-center gap-1.5 rounded-sm border border-border-default bg-surface-1 px-4 text-sm font-semibold tabular-nums text-fg no-underline \" +\n \"transition-colors hover:border-accent/60 hover:bg-accent-soft focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring \" +\n \"aria-pressed:border-accent aria-pressed:bg-accent aria-pressed:text-on-accent disabled:cursor-not-allowed disabled:opacity-50\",\n note: \"text-[11px] font-medium text-fg-secondary group-aria-pressed:text-on-accent\",\n empty: \"m-0 rounded-xl border border-dashed border-border-default px-4 py-6 text-center text-sm text-fg-secondary\",\n },\n});\nconst s = slotPicker();\n\nexport type PickerSlot = {\n /** A stable id (the slot's start as an ISO string). */\n id: string;\n /** The time in words, formatted by the app (`9 h 30`). */\n label: string;\n /** What to know about it (`2 places left`), shown beside the time and read with it. */\n note?: string;\n /** Not offered any more: shown, disabled. */\n disabled?: boolean;\n /** Makes the time a link to this address (the booking page with the slot chosen). */\n href?: string;\n};\n\nexport type PickerDay = {\n /** A stable id (`2026-10-19`). */\n id: string;\n /** The day's name, translated (`Today`, `Mon`). */\n label: string;\n /** Under it (`19 Oct`). */\n sub?: string;\n /** Its free times, in order. */\n slots: readonly PickerSlot[];\n};\n\nexport type SlotPickerProps = Omit<React.ComponentProps<\"div\">, \"onChange\" | \"defaultValue\"> & {\n /** The days that have free times, in order. */\n days: readonly PickerDay[];\n /** The name of the group (`Available times`), passed translated. */\n label: string;\n /** Said when no day has a free time. */\n emptyLabel: string;\n /** The chosen slot's id (controlled). */\n value?: string | null;\n /** Called with the chosen slot's id. */\n onValueChange?: (id: string) => void;\n /** The first day shown. Default: the first of `days`. */\n defaultDay?: string;\n /** The app's link component for the times that have an `href`. */\n linkAs?: LinkComponent;\n};\n\n/** Tappable free times by day: the day strip, then the day's chips — links or toggles. */\nexport function SlotPicker({ days, label, emptyLabel, value, onValueChange, defaultDay, linkAs, className, ...props }: SlotPickerProps) {\n const [dayId, setDayId] = React.useState(defaultDay ?? days[0]?.id);\n const active = days.find((d) => d.id === dayId) ?? days[0];\n if (!active) return <p className={s.empty({ className })}>{emptyLabel}</p>;\n return (\n <div className={s.root({ className })} {...props}>\n <div className={s.days()} role=\"group\" aria-label={label}>\n {days.map((day) => (\n <button key={day.id} type=\"button\" aria-pressed={day.id === active.id} onClick={() => setDayId(day.id)} className={s.day()}>\n <span className={s.dayName()}>{day.label}</span>\n {day.sub && <span className={s.daySub()}>{day.sub}</span>}\n </button>\n ))}\n </div>\n <ul className={s.times()} aria-label={`${active.label}${active.sub ? ` ${active.sub}` : \"\"}`}>\n {active.slots.map((slot) => (\n <li key={slot.id}>\n {slot.href ? (\n <BlockLink href={slot.href} linkAs={linkAs} className={s.time()}>\n {slot.label}\n {slot.note && <span className={s.note()}>{slot.note}</span>}\n </BlockLink>\n ) : (\n <button type=\"button\" aria-pressed={value === slot.id} disabled={slot.disabled} onClick={() => onValueChange?.(slot.id)} className={s.time({ className: \"group\" })}>\n {slot.label}\n {slot.note && <span className={s.note()}>{slot.note}</span>}\n </button>\n )}\n </li>\n ))}\n </ul>\n </div>\n );\n}\n"
237
+ "content": "// Client (the chosen day). The next free times of a service as tappable chips: a strip of days, then the day's times.\n// A time is a link (`href`: the booking page with the time chosen) or a toggle the reader presses (`value`,\n// `onValueChange`). The app computes the slots (its availability is the truth) and formats the labels. With `week` the\n// picker moves through the weeks (← Today →): the host loads the days of the week it is asked for, the picker never computes.\nimport * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nimport { BlockLink, type LinkComponent } from \"../block-link\";\n\nexport const slotPicker = tv({\n slots: {\n root: \"flex min-w-0 flex-col gap-3\",\n days: \"flex gap-2 overflow-x-auto p-1 [scrollbar-width:none] [&::-webkit-scrollbar]:hidden\",\n day:\n \"flex min-h-12 min-w-[4.5rem] shrink-0 cursor-pointer flex-col items-center justify-center rounded-xl border border-border-default bg-surface-1 px-3 py-1.5 text-center leading-tight text-fg-secondary \" +\n \"transition-colors hover:border-border-strong hover:text-fg focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring \" +\n \"aria-pressed:border-accent aria-pressed:bg-accent-soft aria-pressed:text-fg\",\n dayName: \"text-xs font-bold\",\n daySub: \"text-[11px] tabular-nums text-fg-muted\",\n times: \"m-0 flex list-none flex-wrap gap-2 p-0\",\n time:\n \"inline-flex min-h-11 min-w-[4.75rem] items-center justify-center gap-1.5 rounded-sm border border-border-default bg-surface-1 px-4 text-sm font-semibold tabular-nums text-fg no-underline \" +\n \"transition-colors hover:border-accent/60 hover:bg-accent-soft focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring \" +\n \"aria-pressed:border-accent aria-pressed:bg-accent aria-pressed:text-on-accent disabled:cursor-not-allowed disabled:border-dashed disabled:bg-transparent disabled:text-fg-muted disabled:line-through disabled:hover:border-border-default disabled:hover:bg-transparent\",\n note: \"text-[11px] font-medium text-fg-secondary group-aria-pressed:text-on-accent\",\n weekBar: \"flex flex-wrap items-center justify-between gap-2\",\n weekLabel: \"m-0 min-w-0 text-sm font-semibold tabular-nums text-fg\",\n weekNav: \"flex items-center gap-1.5\",\n weekBtn:\n \"inline-flex min-h-11 min-w-11 cursor-pointer items-center justify-center rounded-sm border border-border-default bg-surface-1 px-3 text-sm font-semibold text-fg no-underline \" +\n \"transition-colors hover:border-border-strong focus-visible:outline-hidden focus-visible:ring-2 focus-visible:ring-ring aria-disabled:cursor-not-allowed aria-disabled:opacity-50\",\n groups: \"m-0 flex list-none flex-col gap-3 p-0\",\n groupLabel: \"m-0 mb-1.5 text-xs font-bold text-fg-secondary\",\n footer: \"m-0 text-xs text-fg-secondary\",\n empty: \"m-0 rounded-xl border border-dashed border-border-default px-4 py-6 text-center text-sm text-fg-secondary\",\n },\n});\nconst s = slotPicker();\n\nexport type PickerSlot = {\n /** A stable id (the slot's start as an ISO string). */\n id: string;\n /** The time in words, formatted by the app (`9 h 30`). */\n label: string;\n /** What to know about it (`2 places left`), shown beside the time and read with it. */\n note?: string;\n /** Not offered any more (full): shown struck out and disabled, its `note` (`Full`) read with the time — never colour alone. */\n disabled?: boolean;\n /** Makes the time a link to this address (the booking page with the slot chosen). */\n href?: string;\n};\n\n/** A part of a day (`Morning`, `Afternoon`): the label comes from the host's messages. */\nexport type PickerGroup = {\n id: string;\n label: string;\n slots: readonly PickerSlot[];\n};\n\nexport type PickerDay = {\n /** A stable id (`2026-10-19`). */\n id: string;\n /** The day's name, translated (`Today`, `Mon`). */\n label: string;\n /** Under it (`19 Oct`). */\n sub?: string;\n /** Its times, in order — flat… */\n slots?: readonly PickerSlot[];\n /** …or in parts of the day (`Morning`, `Afternoon`), each under its own label. Wins over `slots`. */\n groups?: readonly PickerGroup[];\n};\n\nexport type SlotPickerProps = Omit<React.ComponentProps<\"div\">, \"onChange\" | \"defaultValue\"> & {\n /** The days that have free times, in order. */\n days: readonly PickerDay[];\n /** The name of the group (`Available times`), passed translated. */\n label: string;\n /** Said when no day has a free time. */\n emptyLabel: string;\n /** The chosen slot's id (controlled). */\n value?: string | null;\n /** Called with the chosen slot's id. */\n onValueChange?: (id: string) => void;\n /** The first day shown. Default: the first of `days`. */\n defaultDay?: string;\n /** The app's link component for the times that have an `href`, and for the week buttons when `weekHref` is set. */\n linkAs?: LinkComponent;\n /** The week shown, the ISO date of its first day (`2026-10-19`; controlled). Setting it turns on ← Today →. */\n week?: string;\n /** Called with the ISO date of the week asked for (± 7 days, or `todayWeek`). The host loads that week's days. */\n onWeekChange?: (week: string) => void;\n /** The earliest week the host offers (ISO date): ← is disabled there. */\n minWeek?: string;\n /** The latest week the host offers (ISO date): → is disabled there. */\n maxWeek?: string;\n /** The current week, where « Today » goes back to. Default: `minWeek`. */\n todayWeek?: string;\n /** The week in words, formatted by the host with `@krizaka/intl` (`19 – 25 Oct`); announced politely at every change. */\n weekLabel?: string;\n /** Names of the three week buttons, translated: `{ previous: \"Previous week\", today: \"Today\", next: \"Next week\" }`. */\n weekButtons?: { previous: string; today: string; next: string };\n /** Makes the week buttons links (the address holds the state: `?week=`), given the week they go to. */\n weekHref?: (week: string) => string;\n /** The context line under the times: time zone and duration (`Montréal (UTC−4) · 45 min`), formatted by the host. */\n footer?: React.ReactNode;\n};\n\n/** The ISO date `days` days after `iso` (UTC, so a time zone never moves it). */\nconst addDays = (iso: string, days: number) => {\n const d = new Date(`${iso}T00:00:00Z`);\n d.setUTCDate(d.getUTCDate() + days);\n return d.toISOString().slice(0, 10);\n};\n\nconst focusables = (root: Element | null) => [...(root?.querySelectorAll<HTMLElement>(\"button:not(:disabled), a[href]\") ?? [])];\n/** Arrows move focus inside one list of controls (`dir` -1/+1 on the arrows that follow the reading order). */\nfunction moveFocus(e: React.KeyboardEvent<HTMLElement>, keys: { prev: string[]; next: string[] }) {\n const dir = keys.prev.includes(e.key) ? -1 : keys.next.includes(e.key) ? 1 : 0;\n if (!dir) return;\n const items = focusables(e.currentTarget);\n const at = items.indexOf(document.activeElement as HTMLElement);\n if (at < 0) return;\n e.preventDefault();\n items[(at + dir + items.length) % items.length]?.focus();\n}\n\n/** Tappable free times by day: the day strip, then the day's chips (in parts of the day if asked) — links or toggles — and, with `week`, ← Today →. */\nexport function SlotPicker({\n days,\n label,\n emptyLabel,\n value,\n onValueChange,\n defaultDay,\n linkAs,\n week,\n onWeekChange,\n minWeek,\n maxWeek,\n todayWeek,\n weekLabel,\n weekButtons,\n weekHref,\n footer,\n className,\n ...props\n}: SlotPickerProps) {\n const [dayId, setDayId] = React.useState(defaultDay ?? days[0]?.id);\n const rootRef = React.useRef<HTMLDivElement>(null);\n const refocusDays = React.useRef(false);\n const active = days.find((d) => d.id === dayId) ?? days[0];\n // After a week change from the keyboard (Page Up / Down inside the times), focus goes to the day strip, which stays.\n React.useEffect(() => {\n if (!refocusDays.current) return;\n refocusDays.current = false;\n rootRef.current?.querySelector<HTMLElement>(\"[data-day][aria-pressed=true]\")?.focus();\n }, [week]);\n\n const weeks = week !== undefined;\n const prev = weeks ? addDays(week, -7) : undefined;\n const next = weeks ? addDays(week, 7) : undefined;\n const current = todayWeek ?? minWeek;\n const prevOff = !!prev && !!minWeek && prev < minWeek;\n const nextOff = !!next && !!maxWeek && next > maxWeek;\n const todayOff = !current || current === week;\n const go = (to: string | undefined, off: boolean) => {\n if (to && !off) onWeekChange?.(to);\n };\n\n const weekButton = (kind: \"previous\" | \"today\" | \"next\", to: string | undefined, off: boolean, text: string, shown: React.ReactNode) =>\n weekHref && to && !off ? (\n <BlockLink key={kind} href={weekHref(to)} linkAs={linkAs} aria-label={text} className={s.weekBtn()}>\n {shown}\n </BlockLink>\n ) : (\n <button key={kind} type=\"button\" aria-label={text} aria-disabled={off || undefined} onClick={() => go(to, off)} className={s.weekBtn()}>\n {shown}\n </button>\n );\n\n const onKeyDown = (e: React.KeyboardEvent<HTMLDivElement>) => {\n if (!weeks || (e.key !== \"PageUp\" && e.key !== \"PageDown\")) return;\n const to = e.key === \"PageUp\" ? prev : next;\n if (!to || (e.key === \"PageUp\" ? prevOff : nextOff)) return;\n e.preventDefault();\n refocusDays.current = true;\n onWeekChange?.(to);\n };\n\n const timeList = (slots: readonly PickerSlot[], name: string) => (\n <ul className={s.times()} aria-label={name} onKeyDown={(e) => moveFocus(e, { prev: [\"ArrowLeft\", \"ArrowUp\"], next: [\"ArrowRight\", \"ArrowDown\"] })}>\n {slots.map((slot) => (\n <li key={slot.id}>\n {slot.href && !slot.disabled ? (\n <BlockLink href={slot.href} linkAs={linkAs} className={s.time()}>\n {slot.label}\n {slot.note && <span className={s.note()}>{slot.note}</span>}\n </BlockLink>\n ) : (\n <button type=\"button\" aria-pressed={value === slot.id} disabled={slot.disabled} onClick={() => onValueChange?.(slot.id)} className={s.time({ className: \"group\" })}>\n {slot.label}\n {slot.note && <span className={s.note()}>{slot.note}</span>}\n </button>\n )}\n </li>\n ))}\n </ul>\n );\n\n const dayName = active ? `${active.label}${active.sub ? ` ${active.sub}` : \"\"}` : \"\";\n return (\n <div ref={rootRef} className={s.root({ className })} onKeyDown={onKeyDown} {...props}>\n {weeks && weekButtons && (\n <div className={s.weekBar()}>\n {weekLabel && (\n <p className={s.weekLabel()} role=\"status\" aria-live=\"polite\">\n {weekLabel}\n </p>\n )}\n <div className={s.weekNav()}>\n {weekButton(\"previous\", prev, prevOff, weekButtons.previous, <span aria-hidden=\"true\">←</span>)}\n {weekButton(\"today\", current, todayOff, weekButtons.today, weekButtons.today)}\n {weekButton(\"next\", next, nextOff, weekButtons.next, <span aria-hidden=\"true\">→</span>)}\n </div>\n </div>\n )}\n {!active ? (\n <p className={s.empty()}>{emptyLabel}</p>\n ) : (\n <>\n <div className={s.days()} role=\"group\" aria-label={label} onKeyDown={(e) => moveFocus(e, { prev: [\"ArrowLeft\"], next: [\"ArrowRight\"] })}>\n {days.map((day) => (\n <button key={day.id} type=\"button\" data-day=\"\" aria-pressed={day.id === active.id} onClick={() => setDayId(day.id)} className={s.day()}>\n <span className={s.dayName()}>{day.label}</span>\n {day.sub && <span className={s.daySub()}>{day.sub}</span>}\n </button>\n ))}\n </div>\n {active.groups ? (\n <ul className={s.groups()} aria-label={dayName}>\n {active.groups.map((group) => (\n <li key={group.id}>\n <p className={s.groupLabel()}>{group.label}</p>\n {timeList(group.slots, `${dayName} · ${group.label}`)}\n </li>\n ))}\n </ul>\n ) : (\n timeList(active.slots ?? [], dayName)\n )}\n </>\n )}\n {footer && <p className={s.footer()}>{footer}</p>}\n </div>\n );\n}\n"
155
238
  }
156
239
  ],
157
240
  "dependencies": [
@@ -165,7 +248,7 @@
165
248
  "props": [
166
249
  {
167
250
  "component": "SlotPicker",
168
- "description": "Tappable free times by day: the day strip, then the day's chips — links or toggles.",
251
+ "description": "Tappable free times by day: the day strip, then the day's chips (in parts of the day if asked) — links or toggles — and, with `week`, ← Today →.",
169
252
  "props": [
170
253
  {
171
254
  "name": "days",
@@ -195,11 +278,32 @@
195
278
  "description": "The first day shown. Default: the first of `days`.",
196
279
  "required": false
197
280
  },
281
+ {
282
+ "name": "footer",
283
+ "type": "ReactNode",
284
+ "default": null,
285
+ "description": "The context line under the times: time zone and duration (`Montréal (UTC−4) · 45 min`), formatted by the host.",
286
+ "required": false
287
+ },
198
288
  {
199
289
  "name": "linkAs",
200
290
  "type": "LinkComponent",
201
291
  "default": null,
202
- "description": "The app's link component for the times that have an `href`.",
292
+ "description": "The app's link component for the times that have an `href`, and for the week buttons when `weekHref` is set.",
293
+ "required": false
294
+ },
295
+ {
296
+ "name": "maxWeek",
297
+ "type": "string",
298
+ "default": null,
299
+ "description": "The latest week the host offers (ISO date): → is disabled there.",
300
+ "required": false
301
+ },
302
+ {
303
+ "name": "minWeek",
304
+ "type": "string",
305
+ "default": null,
306
+ "description": "The earliest week the host offers (ISO date): ← is disabled there.",
203
307
  "required": false
204
308
  },
205
309
  {
@@ -209,12 +313,54 @@
209
313
  "description": "Called with the chosen slot's id.",
210
314
  "required": false
211
315
  },
316
+ {
317
+ "name": "onWeekChange",
318
+ "type": "((week: string) => void)",
319
+ "default": null,
320
+ "description": "Called with the ISO date of the week asked for (± 7 days, or `todayWeek`). The host loads that week's days.",
321
+ "required": false
322
+ },
323
+ {
324
+ "name": "todayWeek",
325
+ "type": "string",
326
+ "default": null,
327
+ "description": "The current week, where « Today » goes back to. Default: `minWeek`.",
328
+ "required": false
329
+ },
212
330
  {
213
331
  "name": "value",
214
332
  "type": "string | null",
215
333
  "default": null,
216
334
  "description": "The chosen slot's id (controlled).",
217
335
  "required": false
336
+ },
337
+ {
338
+ "name": "week",
339
+ "type": "string",
340
+ "default": null,
341
+ "description": "The week shown, the ISO date of its first day (`2026-10-19`; controlled). Setting it turns on ← Today →.",
342
+ "required": false
343
+ },
344
+ {
345
+ "name": "weekButtons",
346
+ "type": "{ previous: string; today: string; next: string; }",
347
+ "default": null,
348
+ "description": "Names of the three week buttons, translated: `{ previous: \"Previous week\", today: \"Today\", next: \"Next week\" }`.",
349
+ "required": false
350
+ },
351
+ {
352
+ "name": "weekHref",
353
+ "type": "((week: string) => string)",
354
+ "default": null,
355
+ "description": "Makes the week buttons links (the address holds the state: `?week=`), given the week they go to.",
356
+ "required": false
357
+ },
358
+ {
359
+ "name": "weekLabel",
360
+ "type": "string",
361
+ "default": null,
362
+ "description": "The week in words, formatted by the host with `@krizaka/intl` (`19 – 25 Oct`); announced politely at every change.",
363
+ "required": false
218
364
  }
219
365
  ]
220
366
  }
@@ -86,7 +86,7 @@
86
86
  "files": [
87
87
  {
88
88
  "path": "meta.ts",
89
- "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 | \"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 | \"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"
89
+ "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 | \"wall\";\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"
90
90
  },
91
91
  {
92
92
  "path": "slot/index.ts",
@@ -166,7 +166,7 @@
166
166
  "files": [
167
167
  {
168
168
  "path": "meta.ts",
169
- "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 | \"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 | \"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"
169
+ "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 | \"wall\";\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"
170
170
  },
171
171
  {
172
172
  "path": "specimen-tag/index.ts",