@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
@@ -18,7 +18,7 @@
18
18
  },
19
19
  "native": {
20
20
  "state": "gap",
21
- "reason": "Orochia's upload from the phone will need it.",
21
+ "reason": "An upload from the phone will need it.",
22
22
  "issue": "krizaka/krizaka-ui#278"
23
23
  },
24
24
  "desktop": {
@@ -95,7 +95,7 @@
95
95
  },
96
96
  {
97
97
  "name": "classNames",
98
- "type": "Partial<Record<\"base\" | \"header\" | \"track\" | \"root\" | \"range\" | \"frame\" | \"kept\" | \"strip\" | \"shade\" | \"grip\" | \"handle\" | \"playhead\", string>>",
98
+ "type": "Partial<Record<\"base\" | \"header\" | \"track\" | \"root\" | \"range\" | \"frame\" | \"strip\" | \"kept\" | \"shade\" | \"grip\" | \"handle\" | \"playhead\", string>>",
99
99
  "default": "{}",
100
100
  "description": "Classes per part: `root`, `header`, `kept`, `track`, `strip`, `frame`, `shade`, `range`, `handle`, `grip`, `playhead`.",
101
101
  "required": false
@@ -215,7 +215,7 @@
215
215
  "description": "A 42-second clip, 12 seconds kept, frames in the track.",
216
216
  "path": "examples/video-trimmer/filmstrip.tsx",
217
217
  "module": "@krizaka/ui/registry/examples/video-trimmer/filmstrip",
218
- "code": "\"use client\";\n\nimport { VideoTrimmer } from \"@krizaka/ui/video-trimmer\";\nimport * as React from \"react\";\n\nconst TOUR = \"https://www.krizaka.com/assets/orochia/tour\";\nconst FRAMES = [\"alex-discover\", \"alex-story\", \"alex-bid\", \"elena-earnings\", \"elena-publish\", \"alex-unlock\", \"elena-live\", \"alex-back\"].map((n) => `${TOUR}/${n}.jpg`);\n\n// A 42-second clip: keep 12 seconds of it. Render the preview on commit, not on every move.\nexport default function VideoTrimmerFilmstrip() {\n const [kept, setKept] = React.useState<[number, number]>([8, 20]);\n return <VideoTrimmer duration={42} value={kept} onValueChange={setKept} frames={FRAMES} labels={{ kept: (length) => `${length} kept` }} />;\n}\n"
218
+ "code": "\"use client\";\n\nimport { VideoTrimmer } from \"@krizaka/ui/video-trimmer\";\nimport * as React from \"react\";\n\n// Frames of the Krizaka films on the CDN (hashed: a URL never changes content).\nconst FRAMES = [\n \"https://krizaka-assets.b-cdn.net/site/brand-films/film/le-monde-de-krizaka-16x9.f3ec7dbb08.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/film/le-monde-de-krizaka-9x16.8133fbbaa5.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-16x9-dark.257f7e2c5d.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-16x9-light.4e71f09920.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-4x5-dark.b6f2a4ae2f.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-4x5-light.31a0ae9e3a.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/epic/le-monde-de-krizaka-la-tournee-16x9.97d42bd916.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/home/kit/challenge-v.7f6f208377.jpg\",\n];\n\n// A 42-second clip: keep 12 seconds of it. Render the preview on commit, not on every move.\nexport default function VideoTrimmerFilmstrip() {\n const [kept, setKept] = React.useState<[number, number]>([8, 20]);\n return <VideoTrimmer duration={42} value={kept} onValueChange={setKept} frames={FRAMES} labels={{ kept: (length) => `${length} kept` }} />;\n}\n"
219
219
  },
220
220
  {
221
221
  "name": "playhead",
@@ -223,7 +223,7 @@
223
223
  "description": "`time` and `onSeek`: the playhead stays within the part kept.",
224
224
  "path": "examples/video-trimmer/playhead.tsx",
225
225
  "module": "@krizaka/ui/registry/examples/video-trimmer/playhead",
226
- "code": "\"use client\";\n\nimport { VideoTrimmer } from \"@krizaka/ui/video-trimmer\";\nimport * as React from \"react\";\n\nconst FRAMES = [\"alex-discover\", \"alex-story\", \"alex-bid\", \"elena-earnings\", \"elena-publish\", \"alex-unlock\"].map((n) => `https://www.krizaka.com/assets/orochia/tour/${n}.jpg`);\n\n// The playhead follows the video's time; a drag on the track (or its arrows) seeks within the part kept.\nexport default function VideoTrimmerPlayhead() {\n const [kept, setKept] = React.useState<[number, number]>([3, 24]);\n const [time, setTime] = React.useState(11.5);\n return <VideoTrimmer duration={30} value={kept} onValueChange={setKept} time={time} onSeek={setTime} frames={FRAMES} minLength={2} />;\n}\n"
226
+ "code": "\"use client\";\n\nimport { VideoTrimmer } from \"@krizaka/ui/video-trimmer\";\nimport * as React from \"react\";\n\n// Frames of the Krizaka films on the CDN (hashed: a URL never changes content).\nconst FRAMES = [\n \"https://krizaka-assets.b-cdn.net/site/brand-films/film/le-monde-de-krizaka-16x9.f3ec7dbb08.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/film/le-monde-de-krizaka-9x16.8133fbbaa5.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-16x9-dark.257f7e2c5d.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-16x9-light.4e71f09920.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-4x5-dark.b6f2a4ae2f.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-4x5-light.31a0ae9e3a.jpg\",\n];\n\n// The playhead follows the video's time; a drag on the track (or its arrows) seeks within the part kept.\nexport default function VideoTrimmerPlayhead() {\n const [kept, setKept] = React.useState<[number, number]>([3, 24]);\n const [time, setTime] = React.useState(11.5);\n return <VideoTrimmer duration={30} value={kept} onValueChange={setKept} time={time} onSeek={setTime} frames={FRAMES} minLength={2} />;\n}\n"
227
227
  },
228
228
  {
229
229
  "name": "custom",
@@ -247,7 +247,7 @@
247
247
  },
248
248
  {
249
249
  "path": "meta.ts",
250
- "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"
250
+ "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"
251
251
  },
252
252
  {
253
253
  "path": "video-trimmer/index.ts",
@@ -255,7 +255,7 @@
255
255
  },
256
256
  {
257
257
  "path": "video-trimmer/meta.ts",
258
- "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Video trimmer\",\n summary: \"The trim timeline of a video editor: two edge handles over a filmstrip frame the part kept, the outside dimmed, a playhead to scrub — every part stylable, the keyboard included.\",\n status: \"deprecated\",\n deprecated: {\n since: \"3.55.0\",\n removedIn: \"4.0.0\",\n reason: \"No product or site imports it and no filed need names it (ADR-006 audit, 2026-10-25): there is no replacement.\",\n },\n category: \"media\",\n platforms: \"web\",\n parity: { native: { status: \"gap\", issue: \"krizaka/krizaka-ui#278\", reason: \"Orochia's upload from the phone will need it.\" }, desktop: \"web\" },\n whenToUse: [\n \"To keep a part of a clip before publishing it: a story, a highlight, a reply.\",\n \"To choose a segment of any timeline (a sound with a waveform as `children`, a recording).\",\n ],\n whenNotToUse: [\n { when: \"For one value or a range of numbers without a media: a slider.\", use: \"slider\" },\n { when: \"To play a video: the video player.\", use: \"video-player\" },\n ],\n bestPractices: [\n \"Render the preview on `onValueCommit` (the end of a drag), not on every move.\",\n \"Set `minLength` to the shortest clip the product accepts, and `largeStep` to a second.\",\n \"Make the filmstrip from a few frames of the clip (8 to 12), the same width each.\",\n \"Restyle any part with `classNames` and the handles with `renderHandle`; the alignment stays (each handle on its value by its outer edge).\",\n ],\n accessibility: {\n keyboard: [\n { keys: \"Arrow keys\", action: \"Move the focused handle (or the playhead) by `step`; with Shift by `largeStep`.\" },\n { keys: \"Page Up / Page Down\", action: \"Move by `largeStep`.\" },\n { keys: \"Home / End\", action: \"To the start or the end, as far as the other handle allows.\" },\n ],\n notes: [\n \"Each handle is a `slider` named by a prop (“Start”, “End”), its bounds set by the other handle and `minLength`.\",\n \"The values are read as times (`aria-valuetext`, `formatTime`), not as seconds.\",\n \"The playhead is a slider too when `onSeek` is given; read-only otherwise.\",\n ],\n },\n related: [\"slider\", \"video-player\", \"audio-player\"],\n web: {\n imports: [\"VideoTrimmer\"],\n examples: [\n { name: \"filmstrip\", title: \"Filmstrip\", description: \"A 42-second clip, 12 seconds kept, frames in the track.\" },\n { name: \"playhead\", title: \"With the playhead\", description: \"`time` and `onSeek`: the playhead stays within the part kept.\" },\n { name: \"custom\", title: \"Custom parts\", description: \"`classNames` and `renderHandle`: thin handles over a waveform band.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
258
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Video trimmer\",\n summary: \"The trim timeline of a video editor: two edge handles over a filmstrip frame the part kept, the outside dimmed, a playhead to scrub — every part stylable, the keyboard included.\",\n status: \"deprecated\",\n deprecated: {\n since: \"3.55.0\",\n removedIn: \"4.0.0\",\n reason: \"No product or site imports it and no filed need names it (ADR-006 audit, 2026-10-25): there is no replacement.\",\n },\n category: \"media\",\n platforms: \"web\",\n parity: { native: { status: \"gap\", issue: \"krizaka/krizaka-ui#278\", reason: \"An upload from the phone will need it.\" }, desktop: \"web\" },\n whenToUse: [\n \"To keep a part of a clip before publishing it: a story, a highlight, a reply.\",\n \"To choose a segment of any timeline (a sound with a waveform as `children`, a recording).\",\n ],\n whenNotToUse: [\n { when: \"For one value or a range of numbers without a media: a slider.\", use: \"slider\" },\n { when: \"To play a video: the video player.\", use: \"video-player\" },\n ],\n bestPractices: [\n \"Render the preview on `onValueCommit` (the end of a drag), not on every move.\",\n \"Set `minLength` to the shortest clip the product accepts, and `largeStep` to a second.\",\n \"Make the filmstrip from a few frames of the clip (8 to 12), the same width each.\",\n \"Restyle any part with `classNames` and the handles with `renderHandle`; the alignment stays (each handle on its value by its outer edge).\",\n ],\n accessibility: {\n keyboard: [\n { keys: \"Arrow keys\", action: \"Move the focused handle (or the playhead) by `step`; with Shift by `largeStep`.\" },\n { keys: \"Page Up / Page Down\", action: \"Move by `largeStep`.\" },\n { keys: \"Home / End\", action: \"To the start or the end, as far as the other handle allows.\" },\n ],\n notes: [\n \"Each handle is a `slider` named by a prop (“Start”, “End”), its bounds set by the other handle and `minLength`.\",\n \"The values are read as times (`aria-valuetext`, `formatTime`), not as seconds.\",\n \"The playhead is a slider too when `onSeek` is given; read-only otherwise.\",\n ],\n },\n related: [\"slider\", \"video-player\", \"audio-player\"],\n web: {\n imports: [\"VideoTrimmer\"],\n examples: [\n { name: \"filmstrip\", title: \"Filmstrip\", description: \"A 42-second clip, 12 seconds kept, frames in the track.\" },\n { name: \"playhead\", title: \"With the playhead\", description: \"`time` and `onSeek`: the playhead stays within the part kept.\" },\n { name: \"custom\", title: \"Custom parts\", description: \"`classNames` and `renderHandle`: thin handles over a waveform band.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
259
259
  },
260
260
  {
261
261
  "path": "video-trimmer/video-trimmer.tsx",
@@ -268,7 +268,7 @@
268
268
  "registryDependencies": [],
269
269
  "demo": {
270
270
  "path": "examples/video-trimmer/filmstrip.tsx",
271
- "content": "\"use client\";\n\nimport { VideoTrimmer } from \"@krizaka/ui/video-trimmer\";\nimport * as React from \"react\";\n\nconst TOUR = \"https://www.krizaka.com/assets/orochia/tour\";\nconst FRAMES = [\"alex-discover\", \"alex-story\", \"alex-bid\", \"elena-earnings\", \"elena-publish\", \"alex-unlock\", \"elena-live\", \"alex-back\"].map((n) => `${TOUR}/${n}.jpg`);\n\n// A 42-second clip: keep 12 seconds of it. Render the preview on commit, not on every move.\nexport default function VideoTrimmerFilmstrip() {\n const [kept, setKept] = React.useState<[number, number]>([8, 20]);\n return <VideoTrimmer duration={42} value={kept} onValueChange={setKept} frames={FRAMES} labels={{ kept: (length) => `${length} kept` }} />;\n}\n"
271
+ "content": "\"use client\";\n\nimport { VideoTrimmer } from \"@krizaka/ui/video-trimmer\";\nimport * as React from \"react\";\n\n// Frames of the Krizaka films on the CDN (hashed: a URL never changes content).\nconst FRAMES = [\n \"https://krizaka-assets.b-cdn.net/site/brand-films/film/le-monde-de-krizaka-16x9.f3ec7dbb08.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/film/le-monde-de-krizaka-9x16.8133fbbaa5.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-16x9-dark.257f7e2c5d.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-16x9-light.4e71f09920.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-4x5-dark.b6f2a4ae2f.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/ambient/home-valley-4x5-light.31a0ae9e3a.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/brand-films/epic/le-monde-de-krizaka-la-tournee-16x9.97d42bd916.jpg\",\n \"https://krizaka-assets.b-cdn.net/site/home/kit/challenge-v.7f6f208377.jpg\",\n];\n\n// A 42-second clip: keep 12 seconds of it. Render the preview on commit, not on every move.\nexport default function VideoTrimmerFilmstrip() {\n const [kept, setKept] = React.useState<[number, number]>([8, 20]);\n return <VideoTrimmer duration={42} value={kept} onValueChange={setKept} frames={FRAMES} labels={{ kept: (length) => `${length} kept` }} />;\n}\n"
272
272
  },
273
273
  "props": [
274
274
  {
@@ -291,7 +291,7 @@
291
291
  },
292
292
  {
293
293
  "name": "classNames",
294
- "type": "Partial<Record<\"base\" | \"header\" | \"track\" | \"root\" | \"range\" | \"frame\" | \"kept\" | \"strip\" | \"shade\" | \"grip\" | \"handle\" | \"playhead\", string>>",
294
+ "type": "Partial<Record<\"base\" | \"header\" | \"track\" | \"root\" | \"range\" | \"frame\" | \"strip\" | \"kept\" | \"shade\" | \"grip\" | \"handle\" | \"playhead\", string>>",
295
295
  "default": "{}",
296
296
  "description": "Classes per part: `root`, `header`, `kept`, `track`, `strip`, `frame`, `shade`, `range`, `handle`, `grip`, `playhead`.",
297
297
  "required": false
@@ -332,7 +332,7 @@
332
332
  },
333
333
  {
334
334
  "path": "meta.ts",
335
- "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"
335
+ "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"
336
336
  },
337
337
  {
338
338
  "path": "virtual/index.ts",