@krizaka/ui 3.62.0 → 3.63.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (635) hide show
  1. package/README.md +13 -16
  2. package/dist/account-menu.d.ts +1 -1
  3. package/dist/account-menu.js +1 -1
  4. package/dist/account-settings.d.ts +1 -1
  5. package/dist/account-settings.js +2 -2
  6. package/dist/achievement.d.ts +2 -2
  7. package/dist/achievement.js +1 -1
  8. package/dist/achievement.js.map +1 -1
  9. package/dist/action-bar.js +4 -4
  10. package/dist/activity-feed.d.ts +1 -1
  11. package/dist/activity-feed.js.map +1 -1
  12. package/dist/analysis-report.d.ts +274 -0
  13. package/dist/analysis-report.js +207 -0
  14. package/dist/analysis-report.js.map +1 -0
  15. package/dist/app-shell.js.map +1 -1
  16. package/dist/argument-card.d.ts +1 -1
  17. package/dist/argument-card.js +5 -5
  18. package/dist/auth-layout.d.ts +1 -1
  19. package/dist/auth-layout.js.map +1 -1
  20. package/dist/avatar/defaults.d.ts +2 -1
  21. package/dist/avatar/defaults.js.map +1 -1
  22. package/dist/{avatar-iajODANU.d.ts → avatar-BL2iG_Js.d.ts} +2 -1
  23. package/dist/avatar.d.ts +3 -2
  24. package/dist/avatar.js.map +1 -1
  25. package/dist/badge.js +4 -34
  26. package/dist/badge.js.map +1 -1
  27. package/dist/bird-plate.d.ts +1 -1
  28. package/dist/bird-plate.js +1 -1
  29. package/dist/blocks.css +99 -8
  30. package/dist/button.js +1 -1
  31. package/dist/captcha.js +1 -1
  32. package/dist/chat.js +1 -1
  33. package/dist/choice-grid.d.ts +1 -1
  34. package/dist/choice-grid.js +1 -1
  35. package/dist/choice-grid.js.map +1 -1
  36. package/dist/chunk-5PFCELGW.js +41 -0
  37. package/dist/chunk-5PFCELGW.js.map +1 -0
  38. package/dist/chunk-5RWHDX5J.js +37 -0
  39. package/dist/chunk-5RWHDX5J.js.map +1 -0
  40. package/dist/{chunk-KB7OLYIJ.js → chunk-7AZ23BUX.js} +1 -1
  41. package/dist/chunk-7AZ23BUX.js.map +1 -0
  42. package/dist/{chunk-4E5IUZHR.js → chunk-B2HS5EAH.js} +1 -1
  43. package/dist/chunk-B2HS5EAH.js.map +1 -0
  44. package/dist/{chunk-5LANVCK7.js → chunk-BG5APGX6.js} +2 -2
  45. package/dist/{chunk-WOZP3JLW.js → chunk-DJ5ZPPWL.js} +1 -1
  46. package/dist/chunk-DJ5ZPPWL.js.map +1 -0
  47. package/dist/{chunk-MHUUNC5W.js → chunk-DRTIE44Z.js} +1 -1
  48. package/dist/chunk-DRTIE44Z.js.map +1 -0
  49. package/dist/{chunk-UV4HBVH7.js → chunk-EB45EVPJ.js} +2 -2
  50. package/dist/{chunk-SJS6RJIT.js.map → chunk-EB45EVPJ.js.map} +1 -1
  51. package/dist/{chunk-555LWYIN.js → chunk-EHTXLZSM.js} +1 -1
  52. package/dist/{chunk-555LWYIN.js.map → chunk-EHTXLZSM.js.map} +1 -1
  53. package/dist/{chunk-6EAHUURY.js → chunk-GHAN7OOE.js} +2 -2
  54. package/dist/chunk-JT7ZKZT5.js +1 -0
  55. package/dist/chunk-JT7ZKZT5.js.map +1 -0
  56. package/dist/{chunk-3DHNN5V7.js → chunk-M3GEYLMR.js} +2 -2
  57. package/dist/{chunk-3DHNN5V7.js.map → chunk-M3GEYLMR.js.map} +1 -1
  58. package/dist/{chunk-7J2L4HOD.js → chunk-MTVX4RRF.js} +2 -2
  59. package/dist/{chunk-7J2L4HOD.js.map → chunk-MTVX4RRF.js.map} +1 -1
  60. package/dist/{chunk-YKEIOYJ5.js → chunk-NPMGYLJV.js} +1 -1
  61. package/dist/chunk-NPMGYLJV.js.map +1 -0
  62. package/dist/{chunk-3RVFD3UX.js → chunk-PW2FVPTV.js} +1 -1
  63. package/dist/chunk-PW2FVPTV.js.map +1 -0
  64. package/dist/{chunk-HEKDKM5Y.js → chunk-QVHSV6RA.js} +1 -1
  65. package/dist/{chunk-MIMOTE4W.js → chunk-RCHKIOVV.js} +1 -1
  66. package/dist/chunk-RCHKIOVV.js.map +1 -0
  67. package/dist/{chunk-7JG3VR4C.js → chunk-RCKXJEDQ.js} +5 -5
  68. package/dist/{chunk-XVFQZ3ZG.js → chunk-TPITVAUW.js} +1 -1
  69. package/dist/{chunk-XVFQZ3ZG.js.map → chunk-TPITVAUW.js.map} +1 -1
  70. package/dist/chunk-U4XTZMB7.js +103 -0
  71. package/dist/chunk-U4XTZMB7.js.map +1 -0
  72. package/dist/{chunk-SJS6RJIT.js → chunk-V7W4RLRW.js} +2 -2
  73. package/dist/{chunk-UV4HBVH7.js.map → chunk-V7W4RLRW.js.map} +1 -1
  74. package/dist/{chunk-RBETQO2P.js → chunk-Y5YBTHVD.js} +9 -15
  75. package/dist/chunk-Y5YBTHVD.js.map +1 -0
  76. package/dist/command.js +2 -2
  77. package/dist/confirm-button.js +1 -1
  78. package/dist/continue-prompt.js +2 -2
  79. package/dist/continue-prompt.js.map +1 -1
  80. package/dist/cover-hero.js +1 -1
  81. package/dist/dashboard-layout.js.map +1 -1
  82. package/dist/data-table.js +2 -2
  83. package/dist/detail-layout.js.map +1 -1
  84. package/dist/dialog.js +2 -2
  85. package/dist/elephant.js.map +1 -1
  86. package/dist/embed-facade.d.ts +37 -0
  87. package/dist/embed-facade.js +96 -0
  88. package/dist/embed-facade.js.map +1 -0
  89. package/dist/engine-flow.d.ts +4 -4
  90. package/dist/engine-flow.js.map +1 -1
  91. package/dist/environment-notice.d.ts +110 -0
  92. package/dist/environment-notice.js +47 -0
  93. package/dist/environment-notice.js.map +1 -0
  94. package/dist/file-upload.d.ts +2 -2
  95. package/dist/flock.js +1 -1
  96. package/dist/force-update-screen.js +1 -1
  97. package/dist/genui.js +2 -2
  98. package/dist/{geometry-DZ4Q3hDQ.d.ts → geometry-DDlFDtiQ.d.ts} +3 -4
  99. package/dist/{geometry-DncHaYP8.d.ts → geometry-DuUQyHZ1.d.ts} +3 -4
  100. package/dist/goal-gauge.d.ts +1 -1
  101. package/dist/goal-gauge.js +1 -1
  102. package/dist/goal-gauge.js.map +1 -1
  103. package/dist/index.d.ts +15 -1
  104. package/dist/index.js +1 -1
  105. package/dist/kind-config-editor.js +1 -1
  106. package/dist/landing-page.d.ts +1 -1
  107. package/dist/landing-page.js.map +1 -1
  108. package/dist/language-switch.d.ts +9 -9
  109. package/dist/link-card.js +2 -2
  110. package/dist/loader.d.ts +1 -1
  111. package/dist/loader.js.map +1 -1
  112. package/dist/maintenance-screen.js +1 -1
  113. package/dist/map.js +6 -0
  114. package/dist/map.js.map +1 -1
  115. package/dist/margin-layout.d.ts +71 -0
  116. package/dist/margin-layout.js +29 -0
  117. package/dist/margin-layout.js.map +1 -0
  118. package/dist/mascot-quote.d.ts +1 -1
  119. package/dist/mascot-quote.js +1 -1
  120. package/dist/mascot-state.js +1 -1
  121. package/dist/mascots.d.ts +2 -2
  122. package/dist/mascots.js +1 -1
  123. package/dist/match-dialog.js +2 -2
  124. package/dist/media-grid.d.ts +1 -0
  125. package/dist/media-grid.js +2 -2
  126. package/dist/meter.js +2 -1
  127. package/dist/native/map.js +6 -0
  128. package/dist/native/map.js.map +1 -1
  129. package/dist/native.d.ts +125 -10
  130. package/dist/native.js +1690 -1517
  131. package/dist/native.js.map +1 -1
  132. package/dist/nav-bar.d.ts +1 -1
  133. package/dist/nav-bar.js +3 -3
  134. package/dist/page-DPHDmDAQ.d.ts +131 -0
  135. package/dist/page-hero.js +4 -4
  136. package/dist/page.d.ts +7 -125
  137. package/dist/page.js +13 -1
  138. package/dist/page.js.map +1 -1
  139. package/dist/product-page.d.ts +1 -1
  140. package/dist/product-page.js.map +1 -1
  141. package/dist/profile-card.d.ts +1 -1
  142. package/dist/profile-card.js +1 -1
  143. package/dist/profile-card.js.map +1 -1
  144. package/dist/promise-card.js +1 -1
  145. package/dist/quota-meter.js +2 -1
  146. package/dist/quota-meter.js.map +1 -1
  147. package/dist/rail-nav.d.ts +4 -0
  148. package/dist/retro-tv.d.ts +6 -3
  149. package/dist/retro-tv.js +6 -5
  150. package/dist/retro-tv.js.map +1 -1
  151. package/dist/reviews.d.ts +49 -0
  152. package/dist/reviews.js +66 -0
  153. package/dist/reviews.js.map +1 -0
  154. package/dist/scroll-stage.d.ts +1 -1
  155. package/dist/scroll-stage.js +1 -1
  156. package/dist/scroll-stage.js.map +1 -1
  157. package/dist/separator.d.ts +26 -3
  158. package/dist/separator.js +19 -1
  159. package/dist/separator.js.map +1 -1
  160. package/dist/service-card.d.ts +56 -63
  161. package/dist/service-card.js +49 -10
  162. package/dist/service-card.js.map +1 -1
  163. package/dist/settings-layout.js +1 -1
  164. package/dist/site-cahier.d.ts +10 -2
  165. package/dist/site-cahier.js +9 -15
  166. package/dist/site-cahier.js.map +1 -1
  167. package/dist/site-footer.d.ts +1 -1
  168. package/dist/site-footer.js +2 -2
  169. package/dist/{sites-BKz1beUK.d.ts → sites-CEnywB89.d.ts} +10 -2
  170. package/dist/sites.d.ts +13 -5
  171. package/dist/sites.js +7 -13
  172. package/dist/sites.js.map +1 -1
  173. package/dist/specimen-tag.d.ts +15 -3
  174. package/dist/specimen-tag.js +4 -27
  175. package/dist/specimen-tag.js.map +1 -1
  176. package/dist/stage-banner.d.ts +1 -1
  177. package/dist/stage-banner.js +1 -1
  178. package/dist/stage-banner.js.map +1 -1
  179. package/dist/stat.d.ts +87 -5
  180. package/dist/stat.js +9 -53
  181. package/dist/stat.js.map +1 -1
  182. package/dist/status-page.d.ts +1 -1
  183. package/dist/status-page.js.map +1 -1
  184. package/dist/sticky-action.d.ts +7 -2
  185. package/dist/sticky-action.js +24 -3
  186. package/dist/sticky-action.js.map +1 -1
  187. package/dist/theme.js +1 -1
  188. package/dist/update-prompt.js +1 -1
  189. package/dist/usage.d.ts +229 -0
  190. package/dist/usage.js +189 -0
  191. package/dist/usage.js.map +1 -0
  192. package/dist/versus-card.js +1 -1
  193. package/dist/vertical-video.js +2 -2
  194. package/dist/wall.d.ts +24 -12
  195. package/dist/wall.js +106 -43
  196. package/dist/wall.js.map +1 -1
  197. package/package.json +108 -17
  198. package/registry/account-menu.json +1 -1
  199. package/registry/account-settings.json +1 -1
  200. package/registry/achievement.json +8 -8
  201. package/registry/action-bar.json +1 -1
  202. package/registry/activity-feed.json +8 -8
  203. package/registry/agenda.json +1 -1
  204. package/registry/alert.json +1 -1
  205. package/registry/analysis-report.json +445 -0
  206. package/registry/anatomy-plate.json +1 -1
  207. package/registry/app-header.json +3 -3
  208. package/registry/app-shell.json +10 -10
  209. package/registry/argument-card.json +3 -3
  210. package/registry/audio-player.json +6 -6
  211. package/registry/auth-layout.json +9 -9
  212. package/registry/avatar.json +8 -8
  213. package/registry/badge.json +1 -1
  214. package/registry/bird-plate.json +1 -1
  215. package/registry/button.json +2 -2
  216. package/registry/captcha.json +1 -1
  217. package/registry/card-grid.json +6 -6
  218. package/registry/card.json +1 -1
  219. package/registry/catalogue-page.json +1 -1
  220. package/registry/changelog-page.json +1 -1
  221. package/registry/chapter.json +1 -1
  222. package/registry/chat.json +3 -3
  223. package/registry/checkbox.json +1 -1
  224. package/registry/chip-link.json +1 -1
  225. package/registry/chip-row.json +1 -1
  226. package/registry/chip.json +1 -1
  227. package/registry/choice-grid.json +6 -6
  228. package/registry/code-block.json +1 -1
  229. package/registry/combobox.json +1 -1
  230. package/registry/command.json +1 -1
  231. package/registry/comparison-table.json +1 -1
  232. package/registry/component-page.json +1 -1
  233. package/registry/confirm-button.json +1 -1
  234. package/registry/contact-page.json +1 -1
  235. package/registry/continue-prompt.json +2 -2
  236. package/registry/countdown.json +1 -1
  237. package/registry/cover-hero.json +1 -1
  238. package/registry/cta-panel.json +1 -1
  239. package/registry/dashboard-layout.json +2 -2
  240. package/registry/data-table.json +1 -1
  241. package/registry/date-picker.json +2 -2
  242. package/registry/decision-list.json +1 -1
  243. package/registry/description-list.json +1 -1
  244. package/registry/detail-layout.json +6 -6
  245. package/registry/dialog.json +1 -1
  246. package/registry/docs-article-page.json +1 -1
  247. package/registry/docs-hub-page.json +3 -3
  248. package/registry/docs-layout.json +1 -1
  249. package/registry/docs-nav.json +1 -1
  250. package/registry/document-viewer.json +1 -1
  251. package/registry/doodle.json +1 -1
  252. package/registry/drop-overlay.json +1 -1
  253. package/registry/dropdown-menu.json +1 -1
  254. package/registry/elephant.json +7 -7
  255. package/registry/embed-facade.json +243 -0
  256. package/registry/empty-state.json +2 -2
  257. package/registry/engine-flow.json +6 -6
  258. package/registry/environment-notice.json +270 -0
  259. package/registry/error-page.json +1 -1
  260. package/registry/examples/achievement/arcade.js +1 -1
  261. package/registry/examples/achievement/arcade.tsx +1 -1
  262. package/registry/examples/activity-feed/job-activity.tsx +1 -1
  263. package/registry/examples/analysis-report/document-validation.js +47 -0
  264. package/registry/examples/analysis-report/document-validation.tsx +29 -0
  265. package/registry/examples/analysis-report/native/document-validation.dark.png +0 -0
  266. package/registry/examples/analysis-report/native/document-validation.js +48 -0
  267. package/registry/examples/analysis-report/native/document-validation.light.png +0 -0
  268. package/registry/examples/analysis-report/native/document-validation.tsx +32 -0
  269. package/registry/examples/analysis-report/streaming.d.ts +4 -0
  270. package/registry/examples/analysis-report/streaming.js +42 -0
  271. package/registry/examples/analysis-report/streaming.tsx +23 -0
  272. package/registry/examples/app-shell/admin-console.js +1 -1
  273. package/registry/examples/app-shell/admin-console.tsx +2 -2
  274. package/registry/examples/app-shell/basic.js +1 -1
  275. package/registry/examples/app-shell/basic.tsx +1 -1
  276. package/registry/examples/app-shell/creator-studio.d.ts +4 -0
  277. package/registry/examples/app-shell/{orochia-studio.js → creator-studio.js} +6 -6
  278. package/registry/examples/app-shell/{orochia-studio.tsx → creator-studio.tsx} +4 -4
  279. package/registry/examples/audio-player/podcast.js +1 -1
  280. package/registry/examples/audio-player/podcast.tsx +1 -1
  281. package/registry/examples/audio-player/voice-note.js +1 -1
  282. package/registry/examples/audio-player/voice-note.tsx +1 -1
  283. package/registry/examples/auth-layout/onboarding.js +3 -3
  284. package/registry/examples/auth-layout/onboarding.tsx +3 -3
  285. package/registry/examples/auth-layout/sign-in.js +3 -3
  286. package/registry/examples/auth-layout/sign-in.tsx +3 -3
  287. package/registry/examples/avatar/default.js +1 -1
  288. package/registry/examples/avatar/default.tsx +1 -1
  289. package/registry/examples/card-grid/aligned.js +2 -2
  290. package/registry/examples/card-grid/aligned.tsx +2 -2
  291. package/registry/examples/card-grid/foundation.js +1 -2
  292. package/registry/examples/card-grid/foundation.tsx +1 -2
  293. package/registry/examples/card-grid/hover-quiet.js +1 -1
  294. package/registry/examples/card-grid/hover-quiet.tsx +1 -1
  295. package/registry/examples/card-grid/products.js +1 -1
  296. package/registry/examples/card-grid/products.tsx +1 -1
  297. package/registry/examples/choice-grid/line-up.js +1 -1
  298. package/registry/examples/choice-grid/line-up.tsx +1 -1
  299. package/registry/examples/detail-layout/checkout.js +1 -1
  300. package/registry/examples/detail-layout/checkout.tsx +2 -2
  301. package/registry/examples/detail-layout/video.js +1 -1
  302. package/registry/examples/detail-layout/video.tsx +2 -2
  303. package/registry/examples/docs-hub-page/krizaka.js +1 -1
  304. package/registry/examples/docs-hub-page/krizaka.tsx +1 -1
  305. package/registry/examples/embed-facade/tiktok.d.ts +4 -0
  306. package/registry/examples/embed-facade/tiktok.js +20 -0
  307. package/registry/examples/embed-facade/tiktok.tsx +16 -0
  308. package/registry/examples/embed-facade/youtube.d.ts +4 -0
  309. package/registry/examples/embed-facade/youtube.js +22 -0
  310. package/registry/examples/embed-facade/youtube.tsx +20 -0
  311. package/registry/examples/empty-state/library.js +1 -1
  312. package/registry/examples/empty-state/library.tsx +1 -1
  313. package/registry/examples/engine-flow/calm.js +1 -1
  314. package/registry/examples/engine-flow/calm.tsx +1 -1
  315. package/registry/examples/engine-flow/compact.js +4 -4
  316. package/registry/examples/engine-flow/compact.tsx +4 -4
  317. package/registry/examples/engine-flow/radial.js +2 -6
  318. package/registry/examples/engine-flow/radial.tsx +1 -5
  319. package/registry/examples/environment-notice/development.d.ts +4 -0
  320. package/registry/examples/environment-notice/development.js +15 -0
  321. package/registry/examples/environment-notice/development.tsx +13 -0
  322. package/registry/examples/environment-notice/native/development.d.ts +4 -0
  323. package/registry/examples/environment-notice/native/development.dark.png +0 -0
  324. package/registry/examples/environment-notice/native/development.js +21 -0
  325. package/registry/examples/environment-notice/native/development.light.png +0 -0
  326. package/registry/examples/environment-notice/native/development.tsx +17 -0
  327. package/registry/examples/environment-notice/staging.d.ts +4 -0
  328. package/registry/examples/environment-notice/staging.js +11 -0
  329. package/registry/examples/environment-notice/staging.tsx +6 -0
  330. package/registry/examples/force-update-screen/default.js +1 -1
  331. package/registry/examples/force-update-screen/default.tsx +1 -1
  332. package/registry/examples/force-update-screen/native/default.dark.png +0 -0
  333. package/registry/examples/force-update-screen/native/default.js +1 -1
  334. package/registry/examples/force-update-screen/native/default.light.png +0 -0
  335. package/registry/examples/force-update-screen/native/default.tsx +1 -1
  336. package/registry/examples/form/native/sign-up.js +2 -2
  337. package/registry/examples/form/native/sign-up.tsx +2 -2
  338. package/registry/examples/form/sign-up.js +1 -1
  339. package/registry/examples/form/sign-up.tsx +3 -3
  340. package/registry/examples/goal-gauge/arcade.js +1 -1
  341. package/registry/examples/goal-gauge/arcade.tsx +1 -1
  342. package/registry/examples/image-cropper/avatar.js +1 -1
  343. package/registry/examples/image-cropper/avatar.tsx +1 -1
  344. package/registry/examples/image-cropper/banner.js +1 -1
  345. package/registry/examples/image-cropper/banner.tsx +1 -1
  346. package/registry/examples/image-cropper/vertical-video.js +1 -2
  347. package/registry/examples/image-cropper/vertical-video.tsx +1 -3
  348. package/registry/examples/iso/creator-hero.d.ts +4 -0
  349. package/registry/examples/iso/{orochia-hero.js → creator-hero.js} +3 -3
  350. package/registry/examples/iso/{orochia-hero.tsx → creator-hero.tsx} +1 -1
  351. package/registry/examples/landing-page/krizaka.js +2 -2
  352. package/registry/examples/landing-page/krizaka.tsx +2 -2
  353. package/registry/examples/link-card/docs-hub.js +1 -1
  354. package/registry/examples/link-card/docs-hub.tsx +1 -1
  355. package/registry/examples/link-card/hover-quiet.js +1 -1
  356. package/registry/examples/link-card/hover-quiet.tsx +1 -1
  357. package/registry/examples/loader/branded.js +2 -2
  358. package/registry/examples/loader/branded.tsx +3 -3
  359. package/registry/examples/loader/native/branded.dark.png +0 -0
  360. package/registry/examples/loader/native/branded.js +1 -1
  361. package/registry/examples/loader/native/branded.light.png +0 -0
  362. package/registry/examples/loader/native/branded.tsx +2 -2
  363. package/registry/examples/longform-page/story.js +3 -3
  364. package/registry/examples/longform-page/story.tsx +3 -3
  365. package/registry/examples/margin-layout/findings.d.ts +4 -0
  366. package/registry/examples/margin-layout/findings.js +15 -0
  367. package/registry/examples/margin-layout/findings.tsx +18 -0
  368. package/registry/examples/margin-layout/steps.d.ts +4 -0
  369. package/registry/examples/margin-layout/steps.js +15 -0
  370. package/registry/examples/margin-layout/steps.tsx +16 -0
  371. package/registry/examples/marketing-layout/docs-hub.js +1 -1
  372. package/registry/examples/marketing-layout/docs-hub.tsx +1 -1
  373. package/registry/examples/mascots/flock.tsx +2 -2
  374. package/registry/examples/nav-bar/family-admin.js +5 -5
  375. package/registry/examples/nav-bar/family-admin.tsx +4 -4
  376. package/registry/examples/nav-bar/site.js +1 -1
  377. package/registry/examples/nav-bar/site.tsx +1 -1
  378. package/registry/examples/page/kraft.d.ts +4 -0
  379. package/registry/examples/page/kraft.js +14 -0
  380. package/registry/examples/page/kraft.tsx +12 -0
  381. package/registry/examples/page/papers.d.ts +4 -0
  382. package/registry/examples/page/papers.js +14 -0
  383. package/registry/examples/page/papers.tsx +13 -0
  384. package/registry/examples/permission-prompt/native/blocked.dark.png +0 -0
  385. package/registry/examples/permission-prompt/native/blocked.js +1 -1
  386. package/registry/examples/permission-prompt/native/blocked.tsx +1 -1
  387. package/registry/examples/permission-prompt/native/camera.dark.png +0 -0
  388. package/registry/examples/permission-prompt/native/camera.js +1 -1
  389. package/registry/examples/permission-prompt/native/camera.light.png +0 -0
  390. package/registry/examples/permission-prompt/native/camera.tsx +1 -1
  391. package/registry/examples/profile-card/match.js +1 -1
  392. package/registry/examples/profile-card/match.tsx +1 -1
  393. package/registry/examples/promise-card/arcade.js +1 -1
  394. package/registry/examples/promise-card/arcade.tsx +1 -1
  395. package/registry/examples/pull-to-refresh/native/branded.dark.png +0 -0
  396. package/registry/examples/pull-to-refresh/native/branded.js +1 -1
  397. package/registry/examples/pull-to-refresh/native/branded.light.png +0 -0
  398. package/registry/examples/pull-to-refresh/native/branded.tsx +1 -1
  399. package/registry/examples/rail-nav/expandable.js +3 -3
  400. package/registry/examples/rail-nav/expandable.tsx +3 -3
  401. package/registry/examples/retro-tv/cabinet.js +1 -2
  402. package/registry/examples/retro-tv/cabinet.tsx +1 -3
  403. package/registry/examples/retro-tv/facade.d.ts +4 -0
  404. package/registry/examples/retro-tv/facade.js +12 -0
  405. package/registry/examples/retro-tv/facade.tsx +13 -0
  406. package/registry/examples/retro-tv/portable.js +1 -2
  407. package/registry/examples/retro-tv/portable.tsx +1 -3
  408. package/registry/examples/reviews/card.d.ts +4 -0
  409. package/registry/examples/reviews/card.js +23 -0
  410. package/registry/examples/reviews/card.tsx +19 -0
  411. package/registry/examples/reviews/summary.d.ts +4 -0
  412. package/registry/examples/reviews/summary.js +23 -0
  413. package/registry/examples/reviews/summary.tsx +17 -0
  414. package/registry/examples/scroll-stage/arcade.js +1 -1
  415. package/registry/examples/scroll-stage/arcade.tsx +1 -1
  416. package/registry/examples/search-field/global.js +1 -1
  417. package/registry/examples/search-field/global.tsx +1 -1
  418. package/registry/examples/separator/hand.d.ts +4 -0
  419. package/registry/examples/separator/hand.js +19 -0
  420. package/registry/examples/separator/hand.tsx +16 -0
  421. package/registry/examples/service-card/index-card.d.ts +4 -0
  422. package/registry/examples/service-card/index-card.js +15 -0
  423. package/registry/examples/service-card/index-card.tsx +12 -0
  424. package/registry/examples/service-card/index-list.d.ts +4 -0
  425. package/registry/examples/service-card/index-list.js +14 -0
  426. package/registry/examples/service-card/index-list.tsx +11 -0
  427. package/registry/examples/sites/french.js +1 -1
  428. package/registry/examples/sites/french.tsx +1 -1
  429. package/registry/examples/specimen-tag/facts.d.ts +4 -0
  430. package/registry/examples/specimen-tag/facts.js +23 -0
  431. package/registry/examples/specimen-tag/facts.tsx +18 -0
  432. package/registry/examples/specimen-tag/wire.js +2 -2
  433. package/registry/examples/specimen-tag/wire.tsx +2 -2
  434. package/registry/examples/splash-handoff/native/default.dark.png +0 -0
  435. package/registry/examples/splash-handoff/native/default.js +1 -1
  436. package/registry/examples/splash-handoff/native/default.light.png +0 -0
  437. package/registry/examples/splash-handoff/native/default.tsx +1 -1
  438. package/registry/examples/split-view/messages.tsx +1 -1
  439. package/registry/examples/split-view/notifications.js +1 -1
  440. package/registry/examples/split-view/notifications.tsx +1 -1
  441. package/registry/examples/stat/strip.d.ts +4 -0
  442. package/registry/examples/stat/strip.js +25 -0
  443. package/registry/examples/stat/strip.tsx +25 -0
  444. package/registry/examples/status-page/building.js +2 -2
  445. package/registry/examples/status-page/building.tsx +2 -2
  446. package/registry/examples/status-page/operational.js +1 -1
  447. package/registry/examples/status-page/operational.tsx +1 -1
  448. package/registry/examples/sticky-action/hide-while-visible.d.ts +4 -0
  449. package/registry/examples/sticky-action/hide-while-visible.js +16 -0
  450. package/registry/examples/sticky-action/hide-while-visible.tsx +17 -0
  451. package/registry/examples/tab-bar/native/main-sections.tsx +1 -1
  452. package/registry/examples/tree-view/docs.js +1 -1
  453. package/registry/examples/tree-view/docs.tsx +1 -1
  454. package/registry/examples/usage/credits-page.d.ts +4 -0
  455. package/registry/examples/usage/credits-page.js +45 -0
  456. package/registry/examples/usage/credits-page.tsx +40 -0
  457. package/registry/examples/usage/empty.d.ts +4 -0
  458. package/registry/examples/usage/empty.js +15 -0
  459. package/registry/examples/usage/empty.tsx +12 -0
  460. package/registry/examples/video-player/default.js +1 -2
  461. package/registry/examples/video-player/default.tsx +1 -3
  462. package/registry/examples/video-player/gated.js +2 -3
  463. package/registry/examples/video-player/gated.tsx +2 -4
  464. package/registry/examples/video-player/native/default.dark.png +0 -0
  465. package/registry/examples/video-player/native/default.js +3 -3
  466. package/registry/examples/video-player/native/default.light.png +0 -0
  467. package/registry/examples/video-player/native/default.tsx +3 -3
  468. package/registry/examples/video-player/signed-source.js +2 -3
  469. package/registry/examples/video-player/signed-source.tsx +2 -4
  470. package/registry/examples/video-player/vertical.js +1 -2
  471. package/registry/examples/video-player/vertical.tsx +1 -3
  472. package/registry/examples/video-trimmer/filmstrip.js +10 -2
  473. package/registry/examples/video-trimmer/filmstrip.tsx +11 -2
  474. package/registry/examples/video-trimmer/playhead.js +8 -1
  475. package/registry/examples/video-trimmer/playhead.tsx +9 -1
  476. package/registry/examples/wall/brick.js +1 -1
  477. package/registry/examples/wall/brick.tsx +1 -1
  478. package/registry/examples/wall/composition-fr.js +1 -1
  479. package/registry/examples/wall/composition-fr.tsx +1 -1
  480. package/registry/examples/wall/composition.js +1 -1
  481. package/registry/examples/wall/composition.tsx +1 -1
  482. package/registry/examples/wall/pinned-note.js +2 -2
  483. package/registry/examples/wall/pinned-note.tsx +3 -2
  484. package/registry/examples/wall/plaster.js +1 -1
  485. package/registry/examples/wall/plaster.tsx +1 -1
  486. package/registry/examples/wall/ridge.js +1 -1
  487. package/registry/examples/wall/ridge.tsx +1 -1
  488. package/registry/examples/wall/shop-sign.js +5 -4
  489. package/registry/examples/wall/shop-sign.tsx +7 -4
  490. package/registry/examples/wall/zellige.js +1 -1
  491. package/registry/examples/wall/zellige.tsx +1 -1
  492. package/registry/field.json +1 -1
  493. package/registry/file-upload.json +2 -2
  494. package/registry/filter-bar.json +1 -1
  495. package/registry/flock.json +1 -1
  496. package/registry/footnote.json +1 -1
  497. package/registry/force-update-screen.json +4 -4
  498. package/registry/form.json +7 -7
  499. package/registry/gallery-page.json +1 -1
  500. package/registry/genui.json +2 -2
  501. package/registry/glossary-term.json +1 -1
  502. package/registry/glossary.json +1 -1
  503. package/registry/glow-card.json +1 -1
  504. package/registry/goal-gauge.json +6 -6
  505. package/registry/grade-stamp.json +1 -1
  506. package/registry/how-it-works-page.json +1 -1
  507. package/registry/image-cropper.json +5 -5
  508. package/registry/index.json +231 -35
  509. package/registry/iso.json +7 -7
  510. package/registry/kanban.json +3 -3
  511. package/registry/kbd.json +1 -1
  512. package/registry/kind-config-editor.json +1 -1
  513. package/registry/kpi-explained.json +2 -2
  514. package/registry/landing-page.json +6 -6
  515. package/registry/landscape.json +1 -1
  516. package/registry/language-switch.json +1 -1
  517. package/registry/legal-page.json +1 -1
  518. package/registry/link-card.json +4 -4
  519. package/registry/list.json +3 -3
  520. package/registry/loader.json +11 -11
  521. package/registry/longform-page.json +3 -3
  522. package/registry/maintenance-screen.json +1 -1
  523. package/registry/map.json +2 -2
  524. package/registry/margin-layout.json +200 -0
  525. package/registry/markdown.json +1 -1
  526. package/registry/marketing-layout.json +2 -2
  527. package/registry/marquee.json +1 -1
  528. package/registry/mascot-quote.json +1 -1
  529. package/registry/mascot-state.json +1 -1
  530. package/registry/mascots.json +5 -5
  531. package/registry/match-dialog.json +1 -1
  532. package/registry/media-capture.json +1 -1
  533. package/registry/media-gallery.json +1 -1
  534. package/registry/media-grid.json +3 -3
  535. package/registry/meta-row.json +1 -1
  536. package/registry/meter.json +1 -1
  537. package/registry/nav-bar.json +9 -9
  538. package/registry/next-actions.json +1 -1
  539. package/registry/notification-preferences.json +3 -3
  540. package/registry/number-ticker.json +1 -1
  541. package/registry/onboarding.json +1 -1
  542. package/registry/opening-hours.json +1 -1
  543. package/registry/page-header.json +1 -1
  544. package/registry/page-hero.json +1 -1
  545. package/registry/page-index.json +1 -1
  546. package/registry/page.json +53 -11
  547. package/registry/pagination.json +1 -1
  548. package/registry/permission-prompt.json +3 -3
  549. package/registry/photo-grid.json +1 -1
  550. package/registry/pointer-light.json +1 -1
  551. package/registry/popover.json +1 -1
  552. package/registry/pricing-page.json +1 -1
  553. package/registry/product-page.json +6 -6
  554. package/registry/profile-card.json +7 -7
  555. package/registry/progress.json +1 -1
  556. package/registry/promise-card.json +3 -3
  557. package/registry/pull-to-refresh.json +2 -2
  558. package/registry/quota-meter.json +1 -1
  559. package/registry/radio-group.json +1 -1
  560. package/registry/rail-nav.json +10 -10
  561. package/registry/recipes.json +1 -1
  562. package/registry/retro-tv.json +48 -32
  563. package/registry/reviews.json +361 -0
  564. package/registry/router.json +1 -1
  565. package/registry/scroll-stage.json +6 -6
  566. package/registry/search-field.json +3 -3
  567. package/registry/section-backdrop.json +1 -1
  568. package/registry/separator.json +71 -6
  569. package/registry/service-card.json +55 -6
  570. package/registry/settings-layout.json +1 -1
  571. package/registry/showcase.json +1 -1
  572. package/registry/signature.json +1 -1
  573. package/registry/site-cahier.json +1 -1
  574. package/registry/site-footer.json +7 -7
  575. package/registry/sites.json +4 -4
  576. package/registry/skeleton.json +1 -1
  577. package/registry/skip-link.json +1 -1
  578. package/registry/slider.json +1 -1
  579. package/registry/slot-picker.json +1 -1
  580. package/registry/slot.json +1 -1
  581. package/registry/specimen-tag.json +58 -6
  582. package/registry/speed-lines.json +1 -1
  583. package/registry/spinner.json +1 -1
  584. package/registry/splash-handoff.json +4 -4
  585. package/registry/split-view.json +4 -4
  586. package/registry/stage-banner.json +10 -6
  587. package/registry/stat.json +62 -10
  588. package/registry/status-chip.json +1 -1
  589. package/registry/status-page.json +9 -9
  590. package/registry/step-progress.json +1 -1
  591. package/registry/step-showcase.json +1 -1
  592. package/registry/stepper.json +1 -1
  593. package/registry/sticky-action.json +27 -4
  594. package/registry/stuck.json +1 -1
  595. package/registry/swipe-deck.json +1 -1
  596. package/registry/switch.json +1 -1
  597. package/registry/tab-bar.json +2 -2
  598. package/registry/tabs.json +1 -1
  599. package/registry/tag-input.json +1 -1
  600. package/registry/tag-selector.json +1 -1
  601. package/registry/taped-photo.json +1 -1
  602. package/registry/terminal-replay.json +1 -1
  603. package/registry/text-style.json +1 -1
  604. package/registry/theme.json +1 -1
  605. package/registry/toast.json +1 -1
  606. package/registry/toc.json +1 -1
  607. package/registry/tooltip.json +1 -1
  608. package/registry/tree-view.json +3 -3
  609. package/registry/update-prompt.json +1 -1
  610. package/registry/upload-queue.json +1 -1
  611. package/registry/usage.json +542 -0
  612. package/registry/verified-badge.json +1 -1
  613. package/registry/versus-card.json +1 -1
  614. package/registry/vertical-video.json +4 -4
  615. package/registry/video-player.json +7 -7
  616. package/registry/video-trimmer.json +8 -8
  617. package/registry/virtual.json +1 -1
  618. package/registry/wall.json +128 -40
  619. package/registry/waveform.json +1 -1
  620. package/skills/form/SKILL.md +1 -1
  621. package/skills/map/SKILL.md +2 -2
  622. package/dist/chunk-3RVFD3UX.js.map +0 -1
  623. package/dist/chunk-4E5IUZHR.js.map +0 -1
  624. package/dist/chunk-KB7OLYIJ.js.map +0 -1
  625. package/dist/chunk-MHUUNC5W.js.map +0 -1
  626. package/dist/chunk-MIMOTE4W.js.map +0 -1
  627. package/dist/chunk-RBETQO2P.js.map +0 -1
  628. package/dist/chunk-WOZP3JLW.js.map +0 -1
  629. package/dist/chunk-YKEIOYJ5.js.map +0 -1
  630. /package/dist/{chunk-5LANVCK7.js.map → chunk-BG5APGX6.js.map} +0 -0
  631. /package/dist/{chunk-6EAHUURY.js.map → chunk-GHAN7OOE.js.map} +0 -0
  632. /package/dist/{chunk-HEKDKM5Y.js.map → chunk-QVHSV6RA.js.map} +0 -0
  633. /package/dist/{chunk-7JG3VR4C.js.map → chunk-RCKXJEDQ.js.map} +0 -0
  634. /package/registry/examples/{app-shell/orochia-studio.d.ts → analysis-report/document-validation.d.ts} +0 -0
  635. /package/registry/examples/{iso/orochia-hero.d.ts → analysis-report/native/document-validation.d.ts} +0 -0
@@ -14,7 +14,7 @@
14
14
  },
15
15
  "native": {
16
16
  "state": "gap",
17
- "reason": "The phone dashboards (Orochia earnings, Orazaka usage) write a figure and its caption by hand.",
17
+ "reason": "The phone dashboards (a creator's earnings, Orazaka usage) write a figure and its caption by hand.",
18
18
  "issue": "krizaka/krizaka-ui#275"
19
19
  },
20
20
  "desktop": {
@@ -41,6 +41,7 @@
41
41
  ],
42
42
  "bestPractices": [
43
43
  "Format the value in the app (currency, compact numbers) with `@krizaka/intl`.",
44
+ "In a narrow column (a side panel, 26 rem) use `StatGrid variant=\"strip\"`, never four `Stat`s stacked full width.",
44
45
  "Put a `Sparkline` of @krizaka/charts (or a `Meter`) in `chart`: the figure first, its shape under it.",
45
46
  "Say the change in `trendLabel` (“+12 %”) and the period in `hint`: the arrow alone says nothing."
46
47
  ],
@@ -48,7 +49,8 @@
48
49
  "keyboard": [],
49
50
  "notes": [
50
51
  "The arrow is decorative; `trendLabel` is read and shown.",
51
- "Colour is never the only signal of the trend."
52
+ "Colour is never the only signal of the trend.",
53
+ "The strip is a description list: each figure reads its label, its value, then its trend in words; a truncated label keeps its full text as its title."
52
54
  ]
53
55
  },
54
56
  "related": [
@@ -110,8 +112,15 @@
110
112
  },
111
113
  {
112
114
  "component": "StatGrid",
113
- "description": "A row of key figures that wraps with the width: a dashboard's head. The stats are its children.",
115
+ "description": "A row of key figures. The default grid wraps with the width (a dashboard's head, the stats are its children);\n`variant=\"strip\"` is the discreet one: 2 to 4 figures in one row, as a `dl`, each with its sparkline and its trend in words.",
114
116
  "props": [
117
+ {
118
+ "name": "items",
119
+ "type": "readonly StatStripItem[]",
120
+ "default": null,
121
+ "description": "2 to 4 figures, in one row from 320 px.",
122
+ "required": true
123
+ },
115
124
  {
116
125
  "name": "divided",
117
126
  "type": "boolean",
@@ -122,9 +131,23 @@
122
131
  {
123
132
  "name": "minWidth",
124
133
  "type": "number",
125
- "default": "11",
134
+ "default": null,
126
135
  "description": "The narrowest a stat may be before the row wraps, in rem. Default 11.",
127
136
  "required": false
137
+ },
138
+ {
139
+ "name": "period",
140
+ "type": "ReactNode",
141
+ "default": null,
142
+ "description": "The period switch (7 · 30 · 90 d), above the row.",
143
+ "required": false
144
+ },
145
+ {
146
+ "name": "variant",
147
+ "type": "\"grid\" | \"strip\"",
148
+ "default": null,
149
+ "description": "`grid` (default): figures that wrap, hairlines between them.\n`strip`: the discreet row, 2 to 4 figures with their sparkline, as a description list.",
150
+ "required": false
128
151
  }
129
152
  ]
130
153
  }
@@ -170,6 +193,14 @@
170
193
  "module": "@krizaka/ui/registry/examples/stat/row",
171
194
  "code": "import { Stat } from \"@krizaka/ui/stat\";\n\n// A row of stats, as a dashboard shows them.\nexport default function StatRow() {\n return (\n <div className=\"grid grid-cols-3 gap-8 rounded-xl border border-border-default bg-surface-1 p-6\">\n <Stat label=\"Views\" value=\"12.4k\" trend=\"up\" trendLabel=\"+8 %\" hint=\"7 days\" />\n <Stat label=\"Supporters\" value=\"318\" trend=\"up\" trendLabel=\"+21\" hint=\"7 days\" />\n <Stat label=\"Payouts\" value=\"€902\" trend=\"down\" trendLabel=\"−3 %\" hint=\"7 days\" />\n </div>\n );\n}\n"
172
195
  },
196
+ {
197
+ "name": "strip",
198
+ "title": "Strip",
199
+ "description": "`StatGrid variant=\"strip\"`: two to four figures in one row, each with a sparkline (64 × 18) and its trend in words; a `period` slot takes the switch.",
200
+ "path": "examples/stat/strip.tsx",
201
+ "module": "@krizaka/ui/registry/examples/stat/strip",
202
+ "code": "import { StatGrid } from \"@krizaka/ui/stat\";\n\n// A sparkline of @krizaka/charts goes in `chart` (64 × 18); here a plain line stands in for it.\nconst line = (points: string) => (\n <svg viewBox=\"0 0 64 18\" width={64} height={18} fill=\"none\" stroke=\"currentColor\" strokeWidth=\"1.5\" aria-hidden>\n <polyline points={points} />\n </svg>\n);\n\n// The discreet activity of a side column: four figures in one row, each with its shape and its trend in words (demo data).\nexport default function StatStrip() {\n return (\n <StatGrid\n variant=\"strip\"\n className=\"max-w-[26rem]\"\n aria-label=\"Activity, last 30 days\"\n items={[\n { id: \"runs\", label: \"Checks run\", value: \"128\", trend: \"up\", trendLabel: \"+12 %\", chart: line(\"0,15 13,11 26,13 39,7 52,5 64,2\") },\n { id: \"flagged\", label: \"Flagged\", value: \"9\", trend: \"down\", trendLabel: \"−2\", chart: line(\"0,4 13,8 26,5 39,11 52,12 64,14\") },\n { id: \"time\", label: \"Average time\", value: \"42 s\", trend: \"flat\", trendLabel: \"same\", chart: line(\"0,9 13,9 26,8 39,9 52,9 64,9\") },\n { id: \"credits\", label: \"Credits used\", value: \"310\", trend: \"up\", trendLabel: \"+4 %\", chart: line(\"0,14 13,12 26,12 39,9 52,9 64,6\") },\n ]}\n />\n );\n}\n"
203
+ },
173
204
  {
174
205
  "name": "grid",
175
206
  "title": "Grid",
@@ -184,19 +215,19 @@
184
215
  "files": [
185
216
  {
186
217
  "path": "meta.ts",
187
- "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"
218
+ "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 | \"environment-notice\"\n | \"embed-facade\"\n | \"reviews\"\n | \"margin-layout\"\n | \"analysis-report\"\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 | \"usage\"\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"
188
219
  },
189
220
  {
190
221
  "path": "stat/index.ts",
191
- "content": "/** @krizaka/ui/stat — `Stat` (a key figure, its trend in words, a chart under it), `StatGrid`, `stat` (the slots). Server-safe. */\nexport { Stat, stat, StatGrid, statGrid, type StatGridProps, type StatProps, type StatTrend } from \"./stat\";\n"
222
+ "content": "/** @krizaka/ui/stat — `Stat` (a key figure, its trend in words, a chart under it), `StatGrid` (`variant=\"strip\"`: the discreet row), `stat` (the slots). Server-safe. */\nexport {\n Stat,\n stat,\n StatGrid,\n statGrid,\n type StatGridProps,\n type StatProps,\n statStrip,\n type StatStripItem,\n type StatStripProps,\n type StatTrend,\n} from \"./stat\";\n"
192
223
  },
193
224
  {
194
225
  "path": "stat/meta.ts",
195
- "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Stat\",\n summary: \"A key figure: a label, a value in tabular digits, a hint and a trend said in words.\",\n status: \"stable\",\n category: \"data-display\",\n platforms: \"web\",\n parity: { native: { status: \"gap\", issue: \"krizaka/krizaka-ui#275\", reason: \"The phone dashboards (Orochia earnings, Orazaka usage) write a figure and its caption by hand.\" }, desktop: \"web\" },\n whenToUse: [\"On a dashboard: revenue, views, supporters.\", \"In a row of a few figures that compare over the same period.\"],\n whenNotToUse: [\n { when: \"For figures inside an item's card.\", use: \"card\" },\n { when: \"For progress towards a goal.\", use: \"progress\" },\n { when: \"For a status.\", use: \"badge\" },\n ],\n bestPractices: [\n \"Format the value in the app (currency, compact numbers) with `@krizaka/intl`.\",\n \"Put a `Sparkline` of @krizaka/charts (or a `Meter`) in `chart`: the figure first, its shape under it.\",\n \"Say the change in `trendLabel` (“+12 %”) and the period in `hint`: the arrow alone says nothing.\",\n ],\n accessibility: {\n keyboard: [],\n notes: [\"The arrow is decorative; `trendLabel` is read and shown.\", \"Colour is never the only signal of the trend.\"],\n },\n related: [\"card\", \"badge\", \"progress\"],\n web: {\n imports: [\"Stat\", \"StatGrid\"],\n examples: [\n { name: \"up\", title: \"Up\", description: \"A rise, with its period.\" },\n { name: \"down\", title: \"Down\", description: \"A fall, said in words next to the arrow.\" },\n { name: \"flat\", title: \"Flat\", description: \"No change.\" },\n { name: \"plain\", title: \"Plain\", description: \"Label and value only.\" },\n { name: \"row\", title: \"Row\", description: \"A row of stats, as a dashboard shows them.\" },\n { name: \"grid\", title: \"Grid\", description: \"`StatGrid`: figures that wrap, hairlines between them, a meter under one (or a `Sparkline` of @krizaka/charts in `chart`).\" },\n ],\n },\n} satisfies ComponentMeta;\n"
226
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Stat\",\n summary: \"A key figure: a label, a value in tabular digits, a hint and a trend said in words.\",\n status: \"stable\",\n category: \"data-display\",\n platforms: \"web\",\n parity: { native: { status: \"gap\", issue: \"krizaka/krizaka-ui#275\", reason: \"The phone dashboards (a creator's earnings, Orazaka usage) write a figure and its caption by hand.\" }, desktop: \"web\" },\n whenToUse: [\"On a dashboard: revenue, views, supporters.\", \"In a row of a few figures that compare over the same period.\"],\n whenNotToUse: [\n { when: \"For figures inside an item's card.\", use: \"card\" },\n { when: \"For progress towards a goal.\", use: \"progress\" },\n { when: \"For a status.\", use: \"badge\" },\n ],\n bestPractices: [\n \"Format the value in the app (currency, compact numbers) with `@krizaka/intl`.\",\n \"In a narrow column (a side panel, 26 rem) use `StatGrid variant=\\\"strip\\\"`, never four `Stat`s stacked full width.\",\n \"Put a `Sparkline` of @krizaka/charts (or a `Meter`) in `chart`: the figure first, its shape under it.\",\n \"Say the change in `trendLabel` (“+12 %”) and the period in `hint`: the arrow alone says nothing.\",\n ],\n accessibility: {\n keyboard: [],\n notes: [\"The arrow is decorative; `trendLabel` is read and shown.\", \"Colour is never the only signal of the trend.\", \"The strip is a description list: each figure reads its label, its value, then its trend in words; a truncated label keeps its full text as its title.\"],\n },\n related: [\"card\", \"badge\", \"progress\"],\n web: {\n imports: [\"Stat\", \"StatGrid\"],\n examples: [\n { name: \"up\", title: \"Up\", description: \"A rise, with its period.\" },\n { name: \"down\", title: \"Down\", description: \"A fall, said in words next to the arrow.\" },\n { name: \"flat\", title: \"Flat\", description: \"No change.\" },\n { name: \"plain\", title: \"Plain\", description: \"Label and value only.\" },\n { name: \"row\", title: \"Row\", description: \"A row of stats, as a dashboard shows them.\" },\n { name: \"strip\", title: \"Strip\", description: \"`StatGrid variant=\\\"strip\\\"`: two to four figures in one row, each with a sparkline (64 × 18) and its trend in words; a `period` slot takes the switch.\" },\n { name: \"grid\", title: \"Grid\", description: \"`StatGrid`: figures that wrap, hairlines between them, a meter under one (or a `Sparkline` of @krizaka/charts in `chart`).\" },\n ],\n },\n} satisfies ComponentMeta;\n"
196
227
  },
197
228
  {
198
229
  "path": "stat/stat.tsx",
199
- "content": "// Server-safe. A key figure: a label, the value in tabular digits, a hint, a trend. Every word is a prop.\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const stat = tv({\n slots: {\n root: \"flex min-w-0 flex-col gap-1\",\n label: \"text-xs font-semibold text-fg-secondary\",\n value: \"kz-stat-value font-display text-2xl font-black tabular-nums text-fg\",\n meta: \"flex flex-wrap items-center gap-x-2 gap-y-1 text-xs\",\n // The status tokens are too light for small text on a light surface: the words stay a text role, the arrow carries\n // the direction's colour.\n trend: \"inline-flex items-center gap-1 font-semibold text-fg [&>svg]:h-3.5 [&>svg]:w-3.5 [&>svg]:shrink-0\",\n hint: \"text-fg-secondary\",\n chart: \"mt-2 h-10 w-full min-w-0\",\n },\n variants: {\n trend: {\n up: { trend: \"[&>svg]:text-success\" },\n down: { trend: \"[&>svg]:text-danger\" },\n flat: { trend: \"[&>svg]:text-fg-secondary\" },\n },\n },\n});\n\nexport type StatTrend = \"up\" | \"down\" | \"flat\";\n\nconst ARROW: Record<StatTrend, string> = { up: \"M7 17 17 7M8 7h9v9\", down: \"M7 7l10 10M17 8v9H8\", flat: \"M5 12h14M13 6l6 6-6 6\" };\n\nexport type StatProps = Omit<React.ComponentProps<\"div\">, \"children\"> & {\n /** What the figure is (\"Revenue\"), above it. */\n label: React.ReactNode;\n /** The figure, formatted by the app, in tabular digits. */\n value: React.ReactNode;\n /** A line under the value: the period, the comparison. */\n hint?: React.ReactNode;\n /** The direction of the change; its arrow is decorative. */\n trend?: StatTrend;\n /** The change, in words, as read and shown (e.g. \"+12 % vs last week\") — the arrow alone says nothing. */\n trendLabel?: React.ReactNode;\n /** Under the figure: a `Sparkline` of @krizaka/charts (its own accessible summary), a `Meter`. */\n chart?: React.ReactNode;\n};\n\nexport function Stat({ label, value, hint, trend, trendLabel, chart, className, ...props }: StatProps) {\n const s = stat({ trend });\n return (\n <div data-trend={trend} className={s.root({ className })} {...props}>\n <p className={s.label()}>{label}</p>\n <p className={s.value()}>{value}</p>\n {(trendLabel || hint) && (\n <p className={s.meta()}>\n {trend && trendLabel && (\n <span className={s.trend()}>\n <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden>\n <path d={ARROW[trend]} />\n </svg>\n {trendLabel}\n </span>\n )}\n {hint && <span className={s.hint()}>{hint}</span>}\n </p>\n )}\n {chart ? <div className={s.chart()}>{chart}</div> : null}\n </div>\n );\n}\n\nexport const statGrid = tv({\n base: \"grid w-full grid-cols-[repeat(auto-fit,minmax(var(--kz-stat-min,11rem),1fr))] overflow-hidden rounded-xl border border-border-default bg-surface-1\",\n variants: {\n divided: {\n true: \"gap-px bg-border-subtle [&>*]:bg-surface-1 [&>*]:p-5\",\n false: \"gap-6 p-5\",\n },\n },\n defaultVariants: { divided: true },\n});\n\nexport type StatGridProps = React.ComponentProps<\"div\"> & {\n /** Hairlines between the stats (default) or space only. */\n divided?: boolean;\n /** The narrowest a stat may be before the row wraps, in rem. Default 11. */\n minWidth?: number;\n};\n\n/** A row of key figures that wraps with the width: a dashboard's head. The stats are its children. */\nexport function StatGrid({ divided, minWidth = 11, className, style, ...props }: StatGridProps) {\n return <div className={statGrid({ divided, className })} style={{ ...style, [\"--kz-stat-min\" as string]: `${minWidth}rem` }} {...props} />;\n}\n"
230
+ "content": "// Server-safe. A key figure: a label, the value in tabular digits, a hint, a trend. Every word is a prop.\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const stat = tv({\n slots: {\n root: \"flex min-w-0 flex-col gap-1\",\n label: \"text-xs font-semibold text-fg-secondary\",\n value: \"kz-stat-value font-display text-2xl font-black tabular-nums text-fg\",\n meta: \"flex flex-wrap items-center gap-x-2 gap-y-1 text-xs\",\n // The status tokens are too light for small text on a light surface: the words stay a text role, the arrow carries\n // the direction's colour.\n trend: \"inline-flex items-center gap-1 font-semibold text-fg [&>svg]:h-3.5 [&>svg]:w-3.5 [&>svg]:shrink-0\",\n hint: \"text-fg-secondary\",\n chart: \"mt-2 h-10 w-full min-w-0\",\n },\n variants: {\n trend: {\n up: { trend: \"[&>svg]:text-success\" },\n down: { trend: \"[&>svg]:text-danger\" },\n flat: { trend: \"[&>svg]:text-fg-secondary\" },\n },\n },\n});\n\nexport type StatTrend = \"up\" | \"down\" | \"flat\";\n\nconst ARROW: Record<StatTrend, string> = { up: \"M7 17 17 7M8 7h9v9\", down: \"M7 7l10 10M17 8v9H8\", flat: \"M5 12h14M13 6l6 6-6 6\" };\n\nexport type StatProps = Omit<React.ComponentProps<\"div\">, \"children\"> & {\n /** What the figure is (\"Revenue\"), above it. */\n label: React.ReactNode;\n /** The figure, formatted by the app, in tabular digits. */\n value: React.ReactNode;\n /** A line under the value: the period, the comparison. */\n hint?: React.ReactNode;\n /** The direction of the change; its arrow is decorative. */\n trend?: StatTrend;\n /** The change, in words, as read and shown (e.g. \"+12 % vs last week\") — the arrow alone says nothing. */\n trendLabel?: React.ReactNode;\n /** Under the figure: a `Sparkline` of @krizaka/charts (its own accessible summary), a `Meter`. */\n chart?: React.ReactNode;\n};\n\nexport function Stat({ label, value, hint, trend, trendLabel, chart, className, ...props }: StatProps) {\n const s = stat({ trend });\n return (\n <div data-trend={trend} className={s.root({ className })} {...props}>\n <p className={s.label()}>{label}</p>\n <p className={s.value()}>{value}</p>\n {(trendLabel || hint) && (\n <p className={s.meta()}>\n {trend && trendLabel && (\n <span className={s.trend()}>\n <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden>\n <path d={ARROW[trend]} />\n </svg>\n {trendLabel}\n </span>\n )}\n {hint && <span className={s.hint()}>{hint}</span>}\n </p>\n )}\n {chart ? <div className={s.chart()}>{chart}</div> : null}\n </div>\n );\n}\n\nexport const statGrid = tv({\n base: \"grid w-full grid-cols-[repeat(auto-fit,minmax(var(--kz-stat-min,11rem),1fr))] overflow-hidden rounded-xl border border-border-default bg-surface-1\",\n variants: {\n divided: {\n true: \"gap-px bg-border-subtle [&>*]:bg-surface-1 [&>*]:p-5\",\n false: \"gap-6 p-5\",\n },\n },\n defaultVariants: { divided: true },\n});\n\nexport type StatGridCommonProps = Omit<React.ComponentProps<\"div\">, \"children\">;\n\nexport type StatGridDefaultProps = React.ComponentProps<\"div\"> & {\n /** `grid` (default): figures that wrap, hairlines between them. */\n variant?: \"grid\";\n /** Hairlines between the stats (default) or space only. */\n divided?: boolean;\n /** The narrowest a stat may be before the row wraps, in rem. Default 11. */\n minWidth?: number;\n};\n\n/** One figure of the strip. */\nexport type StatStripItem = {\n id: string;\n /** What the figure is; truncated in the strip, its full text stays the item's `title`. */\n label: string;\n value: React.ReactNode;\n trend?: StatTrend;\n /** The change in words (\"+12 % vs the previous 30 d\"). */\n trendLabel?: React.ReactNode;\n /** A `Sparkline` of @krizaka/charts (64 × 18). */\n chart?: React.ReactNode;\n};\n\nexport type StatStripProps = StatGridCommonProps & {\n /** `strip`: the discreet row, 2 to 4 figures with their sparkline, as a description list. */\n variant: \"strip\";\n /** 2 to 4 figures, in one row from 320 px. */\n items: readonly StatStripItem[];\n /** The period switch (7 · 30 · 90 d), above the row. */\n period?: React.ReactNode;\n};\n\nexport type StatGridProps = StatGridDefaultProps | StatStripProps;\n\nexport const statStrip = tv({\n slots: {\n root: \"flex w-full min-w-0 flex-col gap-2\",\n list: \"m-0 flex w-full min-w-0 divide-x divide-border-default overflow-hidden rounded-xl border border-border-default bg-surface-1\",\n item: \"flex min-w-0 flex-1 flex-col gap-0.5 px-3 py-2.5\",\n label: \"m-0 truncate text-xs font-semibold text-fg-secondary\",\n value: \"m-0 font-display text-lg font-bold tabular-nums text-fg\",\n trend: \"m-0 flex min-w-0 items-center gap-1 text-[0.6875rem] text-fg-secondary [&>svg]:h-3 [&>svg]:w-3 [&>svg]:shrink-0\",\n chart: \"m-0 h-[18px] w-16 max-w-full\",\n },\n variants: {\n trend: {\n up: { trend: \"[&>svg]:text-success\" },\n down: { trend: \"[&>svg]:text-danger\" },\n flat: {},\n },\n },\n});\n\nfunction StatStripFigure({ item }: { item: StatStripItem }) {\n const s = statStrip({ trend: item.trend });\n return (\n <div className={s.item()} data-trend={item.trend}>\n <dt className={s.label()} title={item.label}>\n {item.label}\n </dt>\n <dd className={s.value()}>{item.value}</dd>\n {item.trendLabel ? (\n <dd className={s.trend()}>\n {item.trend ? (\n <svg viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2.5\" strokeLinecap=\"round\" strokeLinejoin=\"round\" aria-hidden>\n <path d={ARROW[item.trend]} />\n </svg>\n ) : null}\n <span className=\"truncate\">{item.trendLabel}</span>\n </dd>\n ) : null}\n {item.chart ? <dd className={s.chart()}>{item.chart}</dd> : null}\n </div>\n );\n}\n\nfunction StatStrip({ items, period, className, ...props }: Omit<StatStripProps, \"variant\">) {\n const s = statStrip();\n return (\n <div className={s.root({ className })} {...props}>\n {period}\n <dl className={s.list()}>\n {items.map((item) => (\n <StatStripFigure key={item.id} item={item} />\n ))}\n </dl>\n </div>\n );\n}\n\n/**\n * A row of key figures. The default grid wraps with the width (a dashboard's head, the stats are its children);\n * `variant=\"strip\"` is the discreet one: 2 to 4 figures in one row, as a `dl`, each with its sparkline and its trend in words.\n */\nexport function StatGrid(props: StatGridProps) {\n if (props.variant === \"strip\") {\n const { variant: _variant, ...rest } = props;\n return <StatStrip {...rest} />;\n }\n const { variant: _variant, divided, minWidth = 11, className, style, ...rest } = props;\n return <div className={statGrid({ divided, className })} style={{ ...style, [\"--kz-stat-min\" as string]: `${minWidth}rem` }} {...rest} />;\n}\n"
200
231
  }
201
232
  ],
202
233
  "dependencies": [
@@ -258,8 +289,15 @@
258
289
  },
259
290
  {
260
291
  "component": "StatGrid",
261
- "description": "A row of key figures that wraps with the width: a dashboard's head. The stats are its children.",
292
+ "description": "A row of key figures. The default grid wraps with the width (a dashboard's head, the stats are its children);\n`variant=\"strip\"` is the discreet one: 2 to 4 figures in one row, as a `dl`, each with its sparkline and its trend in words.",
262
293
  "props": [
294
+ {
295
+ "name": "items",
296
+ "type": "readonly StatStripItem[]",
297
+ "default": null,
298
+ "description": "2 to 4 figures, in one row from 320 px.",
299
+ "required": true
300
+ },
263
301
  {
264
302
  "name": "divided",
265
303
  "type": "boolean",
@@ -270,9 +308,23 @@
270
308
  {
271
309
  "name": "minWidth",
272
310
  "type": "number",
273
- "default": "11",
311
+ "default": null,
274
312
  "description": "The narrowest a stat may be before the row wraps, in rem. Default 11.",
275
313
  "required": false
314
+ },
315
+ {
316
+ "name": "period",
317
+ "type": "ReactNode",
318
+ "default": null,
319
+ "description": "The period switch (7 · 30 · 90 d), above the row.",
320
+ "required": false
321
+ },
322
+ {
323
+ "name": "variant",
324
+ "type": "\"grid\" | \"strip\"",
325
+ "default": null,
326
+ "description": "`grid` (default): figures that wrap, hairlines between them.\n`strip`: the discreet row, 2 to 4 figures with their sparkline, as a description list.",
327
+ "required": false
276
328
  }
277
329
  ]
278
330
  }
@@ -255,7 +255,7 @@
255
255
  },
256
256
  {
257
257
  "path": "meta.ts",
258
- "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"
258
+ "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 | \"environment-notice\"\n | \"embed-facade\"\n | \"reviews\"\n | \"margin-layout\"\n | \"analysis-report\"\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 | \"usage\"\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"
259
259
  },
260
260
  {
261
261
  "path": "status-chip/index.ts",
@@ -82,7 +82,7 @@
82
82
  "name": "title",
83
83
  "type": "ReactNode",
84
84
  "default": null,
85
- "description": "The page's `h1` (`Status`, `Yasakia is on its way`).",
85
+ "description": "The page's `h1` (`Status`, `Akinaza is on its way`).",
86
86
  "required": true
87
87
  },
88
88
  {
@@ -154,18 +154,18 @@
154
154
  "why": "A person checks in one look whether the service works and which part is slow.",
155
155
  "path": "examples/status-page/operational.tsx",
156
156
  "module": "@krizaka/ui/registry/examples/status-page/operational",
157
- "code": "import { StatusPage } from \"@krizaka/ui/status-page\";\n\n// TEMPLATE — a status page: the overall state in words and colour, each service on its line.\nexport default function StatusPageOperational() {\n return (\n <StatusPage\n eyebrow=\"Status\"\n title=\"How things are running\"\n state=\"operational\"\n stateLabel=\"All systems operational\"\n checked=\"Checked 2 min ago\"\n servicesLabel=\"Services\"\n services={[\n { id: \"web\", name: \"krizaka.com\", state: \"operational\", label: \"Operational\" },\n { id: \"orochia\", name: \"Orochia\", state: \"operational\", label: \"Operational\" },\n { id: \"cdn\", name: \"Video delivery\", state: \"degraded\", label: \"Slower than usual\" },\n ]}\n />\n );\n}\n"
157
+ "code": "import { StatusPage } from \"@krizaka/ui/status-page\";\n\n// TEMPLATE — a status page: the overall state in words and colour, each service on its line.\nexport default function StatusPageOperational() {\n return (\n <StatusPage\n eyebrow=\"Status\"\n title=\"How things are running\"\n state=\"operational\"\n stateLabel=\"All systems operational\"\n checked=\"Checked 2 min ago\"\n servicesLabel=\"Services\"\n services={[\n { id: \"web\", name: \"krizaka.com\", state: \"operational\", label: \"Operational\" },\n { id: \"orazaka\", name: \"Orazaka\", state: \"operational\", label: \"Operational\" },\n { id: \"cdn\", name: \"Video delivery\", state: \"degraded\", label: \"Slower than usual\" },\n ]}\n />\n );\n}\n"
158
158
  },
159
159
  {
160
160
  "name": "building",
161
161
  "title": "Under construction",
162
- "description": "Yasakia on its way: progress and how to hear about it.",
162
+ "description": "Akinaza on its way: progress and how to hear about it.",
163
163
  "template": true,
164
164
  "purpose": "recover",
165
165
  "why": "A visitor learns honestly what is coming, how far it is and how to hear about it.",
166
166
  "path": "examples/status-page/building.tsx",
167
167
  "module": "@krizaka/ui/registry/examples/status-page/building",
168
- "code": "import { Button } from \"@krizaka/ui/button\";\nimport { Mascot } from \"@krizaka/ui/mascots\";\nimport { Progress } from \"@krizaka/ui/progress\";\nimport { StatusPage } from \"@krizaka/ui/status-page\";\n\n// TEMPLATE — « under construction »: what is coming, said honestly — its state in words, its progress, how to hear\n// about it — the duck that builds beside it. Never a fake screen.\nexport default function StatusPageBuilding() {\n return (\n <StatusPage\n eyebrow=\"Yasakia\"\n title=\"On its way\"\n lead=\"Meet by talking first. The first build reaches testers this winter.\"\n aside={<Mascot bird=\"duck\" mood=\"thinking\" size={112} />}\n state=\"building\"\n stateLabel=\"In construction\"\n checked=\"Updated this week\"\n >\n <div className=\"flex max-w-md flex-col gap-4\">\n <Progress value={40} label=\"First build\" showLabel valueText=\"4 of 10 milestones\" />\n <Button variant=\"primary\" className=\"w-fit\">Tell me when it is ready</Button>\n </div>\n </StatusPage>\n );\n}\n"
168
+ "code": "import { Button } from \"@krizaka/ui/button\";\nimport { Mascot } from \"@krizaka/ui/mascots\";\nimport { Progress } from \"@krizaka/ui/progress\";\nimport { StatusPage } from \"@krizaka/ui/status-page\";\n\n// TEMPLATE — « under construction »: what is coming, said honestly — its state in words, its progress, how to hear\n// about it — the duck that builds beside it. Never a fake screen.\nexport default function StatusPageBuilding() {\n return (\n <StatusPage\n eyebrow=\"Akinaza\"\n title=\"On its way\"\n lead=\"The all-in-one for independent Québec shops. The first build reaches testers this winter.\"\n aside={<Mascot bird=\"duck\" mood=\"thinking\" size={112} />}\n state=\"building\"\n stateLabel=\"In construction\"\n checked=\"Updated this week\"\n >\n <div className=\"flex max-w-md flex-col gap-4\">\n <Progress value={40} label=\"First build\" showLabel valueText=\"4 of 10 milestones\" />\n <Button variant=\"primary\" className=\"w-fit\">Tell me when it is ready</Button>\n </div>\n </StatusPage>\n );\n}\n"
169
169
  },
170
170
  {
171
171
  "name": "maintenance",
@@ -188,7 +188,7 @@
188
188
  },
189
189
  {
190
190
  "path": "meta.ts",
191
- "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"
191
+ "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 | \"environment-notice\"\n | \"embed-facade\"\n | \"reviews\"\n | \"margin-layout\"\n | \"analysis-report\"\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 | \"usage\"\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"
192
192
  },
193
193
  {
194
194
  "path": "status-page/index.ts",
@@ -196,11 +196,11 @@
196
196
  },
197
197
  {
198
198
  "path": "status-page/meta.ts",
199
- "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Status page\",\n summary: \"Where things stand: the overall state in words and colour, each service on its line, the incidents — or, for what is not built yet, its progress and how to hear about it.\",\n status: \"deprecated\",\n deprecated: {\n since: \"3.55.0\",\n removedIn: \"4.0.0\",\n reason: \"No page uses this template and no filed need names it (ADR-006 audit, 2026-10-25): there is no replacement.\",\n },\n category: \"templates\",\n platforms: \"web\",\n parity: { native: { status: \"n/a\", reason: \"A whole page of a public site; a phone app's screens are built from Screen, Header and the native primitives.\" }, desktop: { status: \"n/a\", reason: \"A public site's page, not a window of the Mac app.\" } },\n whenToUse: [\"A service status page.\", \"An « under construction » page that says honestly what is coming.\"],\n whenNotToUse: [\n { when: \"For what changed over time.\", use: \"changelog-page\" },\n { when: \"For a page that does not exist.\", use: \"error-page\" },\n ],\n bestPractices: [\"Always say the state in words; the colour only repeats it.\", \"Under construction: show progress and a way to follow, never a fake screen.\", \"Words and content arrive as props; the motion is the platform's (`[data-reveal]`, still under reduced motion).\"],\n accessibility: {\n keyboard: [],\n notes: [\"The overall state is a `status` region.\", \"Each service says its state in words beside its dot.\"],\n },\n related: [\"changelog-page\", \"progress\", \"error-page\"],\n web: {\n imports: [\"StatusPage\"],\n examples: [\n { name: \"operational\", title: \"Status\", description: \"Three services, one slower than usual.\", template: true, purpose: \"recover\", why: \"A person checks in one look whether the service works and which part is slow.\" },\n { name: \"building\", title: \"Under construction\", description: \"Yasakia on its way: progress and how to hear about it.\", template: true, purpose: \"recover\", why: \"A visitor learns honestly what is coming, how far it is and how to hear about it.\" },\n { name: \"maintenance\", title: \"Planned maintenance\", description: \"What is paused until when, and what still works.\", template: true, purpose: \"recover\", why: \"A person learns what is down, until when, and what they can still do.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
199
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Status page\",\n summary: \"Where things stand: the overall state in words and colour, each service on its line, the incidents — or, for what is not built yet, its progress and how to hear about it.\",\n status: \"deprecated\",\n deprecated: {\n since: \"3.55.0\",\n removedIn: \"4.0.0\",\n reason: \"No page uses this template and no filed need names it (ADR-006 audit, 2026-10-25): there is no replacement.\",\n },\n category: \"templates\",\n platforms: \"web\",\n parity: { native: { status: \"n/a\", reason: \"A whole page of a public site; a phone app's screens are built from Screen, Header and the native primitives.\" }, desktop: { status: \"n/a\", reason: \"A public site's page, not a window of the Mac app.\" } },\n whenToUse: [\"A service status page.\", \"An « under construction » page that says honestly what is coming.\"],\n whenNotToUse: [\n { when: \"For what changed over time.\", use: \"changelog-page\" },\n { when: \"For a page that does not exist.\", use: \"error-page\" },\n ],\n bestPractices: [\"Always say the state in words; the colour only repeats it.\", \"Under construction: show progress and a way to follow, never a fake screen.\", \"Words and content arrive as props; the motion is the platform's (`[data-reveal]`, still under reduced motion).\"],\n accessibility: {\n keyboard: [],\n notes: [\"The overall state is a `status` region.\", \"Each service says its state in words beside its dot.\"],\n },\n related: [\"changelog-page\", \"progress\", \"error-page\"],\n web: {\n imports: [\"StatusPage\"],\n examples: [\n { name: \"operational\", title: \"Status\", description: \"Three services, one slower than usual.\", template: true, purpose: \"recover\", why: \"A person checks in one look whether the service works and which part is slow.\" },\n { name: \"building\", title: \"Under construction\", description: \"Akinaza on its way: progress and how to hear about it.\", template: true, purpose: \"recover\", why: \"A visitor learns honestly what is coming, how far it is and how to hear about it.\" },\n { name: \"maintenance\", title: \"Planned maintenance\", description: \"What is paused until when, and what still works.\", template: true, purpose: \"recover\", why: \"A person learns what is down, until when, and what they can still do.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
200
200
  },
201
201
  {
202
202
  "path": "status-page/status-page.tsx",
203
- "content": "// Server-safe. Where things stand (blocks.css `.kz-tpl-state`, `.kz-tpl-services`): the overall state in words and\n// colour, each service on its line, the incidents under them — or, for something not built yet (`state=\"building\"`),\n// what is coming, its progress and how to hear about it, the bird beside it. A state is always said in words.\nimport { Page, Section } from \"@krizaka/ui/page\";\nimport type { LinkComponent } from \"@krizaka/ui/page-hero\";\nimport { PageHero } from \"@krizaka/ui/page-hero\";\nimport type * as React from \"react\";\n\nimport { warnDeprecated } from \"../deprecated\";\n\nexport type ServiceState = \"operational\" | \"degraded\" | \"outage\" | \"building\";\n\nexport type StatusPageProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The way back. */\n back?: { href: string; label: string };\n /** A mono line above the title. */\n eyebrow?: React.ReactNode;\n /** The page's `h1` (`Status`, `Yasakia is on its way`). */\n title: React.ReactNode;\n /** One sentence under it. */\n lead?: React.ReactNode;\n /** Beside the hero: a bird (the pigeon that delivers, the duck that builds). */\n aside?: React.ReactNode;\n /** The overall state. */\n state: ServiceState;\n /** The overall state, in words (`All systems operational`). */\n stateLabel: React.ReactNode;\n /** When it was checked (`Checked 2 min ago`). */\n checked?: React.ReactNode;\n /** The services and their states, in words: `{ id, name, state, label }`. */\n services?: readonly { id: string; name: React.ReactNode; state: ServiceState; label: React.ReactNode }[];\n /** The services list's accessible name (`Services`). */\n servicesLabel?: string;\n /** Under the services: the incidents (a ChangelogPage's entries, a list), or for `building` the progress and the way to follow. */\n children?: React.ReactNode;\n /** The app's link component (Next's `Link`). */\n linkAs?: LinkComponent;\n};\n\n/**\n * A status page — or an « under construction » one: the overall state, each service, then incidents or progress.\n * @deprecated Since 3.55 (ADR-006, krizaka-ui#674): no product uses it. Removed in 4.0.\n */\nexport function StatusPage({ back, eyebrow, title, lead, aside, state, stateLabel, checked, services, servicesLabel = \"Services\", linkAs, children, ...props }: StatusPageProps) {\n warnDeprecated(\"status-page\");\n return (\n <div {...props}>\n <PageHero back={back} linkAs={linkAs} eyebrow={eyebrow} title={title} lead={lead} aside={aside} backdrop=\"plain\" />\n <Page className=\"kz-tpl-longform\">\n <div className=\"kz-tpl-state\" data-state={state} role=\"status\">\n <span className=\"kz-tpl-dot\" aria-hidden />\n <strong>{stateLabel}</strong>\n {checked && <span className=\"kz-tpl-count\">{checked}</span>}\n </div>\n {services && services.length > 0 && (\n <ul className=\"kz-tpl-services\" aria-label={servicesLabel}>\n {services.map((s) => (\n <li key={s.id}>\n <span>{s.name}</span>\n <small>\n <span className=\"kz-tpl-dot\" data-state={s.state} aria-hidden />\n {s.label}\n </small>\n </li>\n ))}\n </ul>\n )}\n </Page>\n {children && <Section spacing=\"sm\">{children}</Section>}\n </div>\n );\n}\n"
203
+ "content": "// Server-safe. Where things stand (blocks.css `.kz-tpl-state`, `.kz-tpl-services`): the overall state in words and\n// colour, each service on its line, the incidents under them — or, for something not built yet (`state=\"building\"`),\n// what is coming, its progress and how to hear about it, the bird beside it. A state is always said in words.\nimport { Page, Section } from \"@krizaka/ui/page\";\nimport type { LinkComponent } from \"@krizaka/ui/page-hero\";\nimport { PageHero } from \"@krizaka/ui/page-hero\";\nimport type * as React from \"react\";\n\nimport { warnDeprecated } from \"../deprecated\";\n\nexport type ServiceState = \"operational\" | \"degraded\" | \"outage\" | \"building\";\n\nexport type StatusPageProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The way back. */\n back?: { href: string; label: string };\n /** A mono line above the title. */\n eyebrow?: React.ReactNode;\n /** The page's `h1` (`Status`, `Akinaza is on its way`). */\n title: React.ReactNode;\n /** One sentence under it. */\n lead?: React.ReactNode;\n /** Beside the hero: a bird (the pigeon that delivers, the duck that builds). */\n aside?: React.ReactNode;\n /** The overall state. */\n state: ServiceState;\n /** The overall state, in words (`All systems operational`). */\n stateLabel: React.ReactNode;\n /** When it was checked (`Checked 2 min ago`). */\n checked?: React.ReactNode;\n /** The services and their states, in words: `{ id, name, state, label }`. */\n services?: readonly { id: string; name: React.ReactNode; state: ServiceState; label: React.ReactNode }[];\n /** The services list's accessible name (`Services`). */\n servicesLabel?: string;\n /** Under the services: the incidents (a ChangelogPage's entries, a list), or for `building` the progress and the way to follow. */\n children?: React.ReactNode;\n /** The app's link component (Next's `Link`). */\n linkAs?: LinkComponent;\n};\n\n/**\n * A status page — or an « under construction » one: the overall state, each service, then incidents or progress.\n * @deprecated Since 3.55 (ADR-006, krizaka-ui#674): no product uses it. Removed in 4.0.\n */\nexport function StatusPage({ back, eyebrow, title, lead, aside, state, stateLabel, checked, services, servicesLabel = \"Services\", linkAs, children, ...props }: StatusPageProps) {\n warnDeprecated(\"status-page\");\n return (\n <div {...props}>\n <PageHero back={back} linkAs={linkAs} eyebrow={eyebrow} title={title} lead={lead} aside={aside} backdrop=\"plain\" />\n <Page className=\"kz-tpl-longform\">\n <div className=\"kz-tpl-state\" data-state={state} role=\"status\">\n <span className=\"kz-tpl-dot\" aria-hidden />\n <strong>{stateLabel}</strong>\n {checked && <span className=\"kz-tpl-count\">{checked}</span>}\n </div>\n {services && services.length > 0 && (\n <ul className=\"kz-tpl-services\" aria-label={servicesLabel}>\n {services.map((s) => (\n <li key={s.id}>\n <span>{s.name}</span>\n <small>\n <span className=\"kz-tpl-dot\" data-state={s.state} aria-hidden />\n {s.label}\n </small>\n </li>\n ))}\n </ul>\n )}\n </Page>\n {children && <Section spacing=\"sm\">{children}</Section>}\n </div>\n );\n}\n"
204
204
  }
205
205
  ],
206
206
  "dependencies": [],
@@ -210,7 +210,7 @@
210
210
  ],
211
211
  "demo": {
212
212
  "path": "examples/status-page/operational.tsx",
213
- "content": "import { StatusPage } from \"@krizaka/ui/status-page\";\n\n// TEMPLATE — a status page: the overall state in words and colour, each service on its line.\nexport default function StatusPageOperational() {\n return (\n <StatusPage\n eyebrow=\"Status\"\n title=\"How things are running\"\n state=\"operational\"\n stateLabel=\"All systems operational\"\n checked=\"Checked 2 min ago\"\n servicesLabel=\"Services\"\n services={[\n { id: \"web\", name: \"krizaka.com\", state: \"operational\", label: \"Operational\" },\n { id: \"orochia\", name: \"Orochia\", state: \"operational\", label: \"Operational\" },\n { id: \"cdn\", name: \"Video delivery\", state: \"degraded\", label: \"Slower than usual\" },\n ]}\n />\n );\n}\n"
213
+ "content": "import { StatusPage } from \"@krizaka/ui/status-page\";\n\n// TEMPLATE — a status page: the overall state in words and colour, each service on its line.\nexport default function StatusPageOperational() {\n return (\n <StatusPage\n eyebrow=\"Status\"\n title=\"How things are running\"\n state=\"operational\"\n stateLabel=\"All systems operational\"\n checked=\"Checked 2 min ago\"\n servicesLabel=\"Services\"\n services={[\n { id: \"web\", name: \"krizaka.com\", state: \"operational\", label: \"Operational\" },\n { id: \"orazaka\", name: \"Orazaka\", state: \"operational\", label: \"Operational\" },\n { id: \"cdn\", name: \"Video delivery\", state: \"degraded\", label: \"Slower than usual\" },\n ]}\n />\n );\n}\n"
214
214
  },
215
215
  "props": [
216
216
  {
@@ -235,7 +235,7 @@
235
235
  "name": "title",
236
236
  "type": "ReactNode",
237
237
  "default": null,
238
- "description": "The page's `h1` (`Status`, `Yasakia is on its way`).",
238
+ "description": "The page's `h1` (`Status`, `Akinaza is on its way`).",
239
239
  "required": true
240
240
  },
241
241
  {