@krizaka/ui 4.6.0 → 4.7.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 (959) hide show
  1. package/README.md +1 -0
  2. package/dist/{RotatingWord-D3tpDLE4.d.ts → RotatingWord-CkDcPH9x.d.ts} +2 -2
  3. package/dist/account-menu.js +2 -2
  4. package/dist/account-menu.js.map +1 -1
  5. package/dist/account-settings.d.ts +9 -9
  6. package/dist/account-settings.js +4 -4
  7. package/dist/account-settings.js.map +1 -1
  8. package/dist/achievement.d.ts +3 -3
  9. package/dist/achievement.js +1 -1
  10. package/dist/achievement.js.map +1 -1
  11. package/dist/action-bar.d.ts +1 -1
  12. package/dist/action-bar.js +5 -5
  13. package/dist/action-bar.js.map +1 -1
  14. package/dist/activity-feed.d.ts +2 -2
  15. package/dist/activity-feed.js +1 -1
  16. package/dist/activity-feed.js.map +1 -1
  17. package/dist/alert.d.ts +1 -1
  18. package/dist/alert.js.map +1 -1
  19. package/dist/analysis-report.d.ts +1 -1
  20. package/dist/analysis-report.js +4 -4
  21. package/dist/analysis-report.js.map +1 -1
  22. package/dist/anatomy-plate.d.ts +1 -1
  23. package/dist/anatomy-plate.js +1 -1
  24. package/dist/anatomy-plate.js.map +1 -1
  25. package/dist/app-header/search.d.ts +1 -1
  26. package/dist/app-header/search.js +2 -2
  27. package/dist/app-header/search.js.map +1 -1
  28. package/dist/app-header.d.ts +2 -2
  29. package/dist/app-header.js.map +1 -1
  30. package/dist/app-shell.d.ts +8 -8
  31. package/dist/app-shell.js +4 -4
  32. package/dist/app-shell.js.map +1 -1
  33. package/dist/architecture-diagram.d.ts +46 -0
  34. package/dist/architecture-diagram.js +324 -0
  35. package/dist/architecture-diagram.js.map +1 -0
  36. package/dist/argument-card.d.ts +2 -2
  37. package/dist/argument-card.js +8 -8
  38. package/dist/argument-card.js.map +1 -1
  39. package/dist/auth-layout.d.ts +1 -1
  40. package/dist/auth-layout.js.map +1 -1
  41. package/dist/avatar.d.ts +2 -2
  42. package/dist/avatar.js.map +1 -1
  43. package/dist/badge.d.ts +1 -1
  44. package/dist/badge.js +1 -1
  45. package/dist/bird-plate.d.ts +1 -1
  46. package/dist/bird-plate.js +2 -2
  47. package/dist/bird-plate.js.map +1 -1
  48. package/dist/blocks.css +33 -0
  49. package/dist/button.d.ts +2 -2
  50. package/dist/button.js +3 -3
  51. package/dist/captcha.d.ts +2 -2
  52. package/dist/captcha.js +3 -3
  53. package/dist/captcha.js.map +1 -1
  54. package/dist/card-grid.d.ts +1 -1
  55. package/dist/card-grid.js +1 -1
  56. package/dist/card-grid.js.map +1 -1
  57. package/dist/card.d.ts +9 -9
  58. package/dist/card.js +1 -1
  59. package/dist/card.js.map +1 -1
  60. package/dist/catalogue-page.d.ts +2 -2
  61. package/dist/catalogue-page.js.map +1 -1
  62. package/dist/changelog-page.d.ts +1 -1
  63. package/dist/changelog-page.js +2 -2
  64. package/dist/changelog-page.js.map +1 -1
  65. package/dist/chapter.d.ts +3 -3
  66. package/dist/chapter.js +2 -2
  67. package/dist/chapter.js.map +1 -1
  68. package/dist/chat.d.ts +3 -3
  69. package/dist/chat.js +1 -1
  70. package/dist/chat.js.map +1 -1
  71. package/dist/checkbox.d.ts +1 -1
  72. package/dist/checkbox.js.map +1 -1
  73. package/dist/chip-link.d.ts +1 -1
  74. package/dist/chip-link.js +1 -1
  75. package/dist/chip-row.d.ts +2 -2
  76. package/dist/chip-row.js +1 -1
  77. package/dist/chip-row.js.map +1 -1
  78. package/dist/chip.d.ts +4 -5
  79. package/dist/chip.js +2 -2
  80. package/dist/choice-grid.d.ts +1 -1
  81. package/dist/choice-grid.js +2 -2
  82. package/dist/choice-grid.js.map +1 -1
  83. package/dist/{chunk-S6NYGOJT.js → chunk-22IORLB5.js} +1 -1
  84. package/dist/chunk-22IORLB5.js.map +1 -0
  85. package/dist/{chunk-QA3WETWT.js → chunk-2P7Y3LNN.js} +1 -1
  86. package/dist/chunk-2P7Y3LNN.js.map +1 -0
  87. package/dist/{chunk-OGWB76BR.js → chunk-3CEMOJBL.js} +2 -2
  88. package/dist/chunk-3CEMOJBL.js.map +1 -0
  89. package/dist/{chunk-WC3SO4CE.js → chunk-3SWWUJJL.js} +2 -2
  90. package/dist/chunk-3SWWUJJL.js.map +1 -0
  91. package/dist/{chunk-S2O4NSN5.js → chunk-3TCHVNNB.js} +1 -1
  92. package/dist/chunk-3TCHVNNB.js.map +1 -0
  93. package/dist/{chunk-7P7I5OQV.js → chunk-5KBYZLU4.js} +2 -2
  94. package/dist/chunk-5KBYZLU4.js.map +1 -0
  95. package/dist/{chunk-WKQ5CB3I.js → chunk-6ARAO3TR.js} +1 -1
  96. package/dist/{chunk-WKQ5CB3I.js.map → chunk-6ARAO3TR.js.map} +1 -1
  97. package/dist/{chunk-QHVV2JGF.js → chunk-6LF6IZZM.js} +2 -2
  98. package/dist/chunk-6LF6IZZM.js.map +1 -0
  99. package/dist/{chunk-HP7BDMVK.js → chunk-7B5Q76JR.js} +2 -2
  100. package/dist/chunk-7B5Q76JR.js.map +1 -0
  101. package/dist/{chunk-F2UZ2WWL.js → chunk-7KIIAOQH.js} +1 -1
  102. package/dist/{chunk-F2UZ2WWL.js.map → chunk-7KIIAOQH.js.map} +1 -1
  103. package/dist/{chunk-ADRUEPYC.js → chunk-7MA3UODW.js} +2 -2
  104. package/dist/{chunk-ADRUEPYC.js.map → chunk-7MA3UODW.js.map} +1 -1
  105. package/dist/{chunk-KH3JOEPY.js → chunk-7PVLEALV.js} +1 -1
  106. package/dist/chunk-7PVLEALV.js.map +1 -0
  107. package/dist/{chunk-QVHSV6RA.js → chunk-7UBLUGNW.js} +1 -1
  108. package/dist/chunk-7UBLUGNW.js.map +1 -0
  109. package/dist/{chunk-YTYNKMNS.js → chunk-BKMHN4UA.js} +5 -5
  110. package/dist/chunk-BKMHN4UA.js.map +1 -0
  111. package/dist/{chunk-4QH6CP2Y.js → chunk-BRYRZWLV.js} +1 -1
  112. package/dist/{chunk-4QH6CP2Y.js.map → chunk-BRYRZWLV.js.map} +1 -1
  113. package/dist/{chunk-43PTCDTL.js → chunk-BVN7JFOP.js} +1 -1
  114. package/dist/chunk-BVN7JFOP.js.map +1 -0
  115. package/dist/{chunk-5RWHDX5J.js → chunk-BYKA3FHX.js} +2 -2
  116. package/dist/chunk-BYKA3FHX.js.map +1 -0
  117. package/dist/{chunk-5PFCELGW.js → chunk-DIOAQOR5.js} +1 -1
  118. package/dist/chunk-DIOAQOR5.js.map +1 -0
  119. package/dist/{chunk-HJFRHYCI.js → chunk-DTGRZXYO.js} +2 -2
  120. package/dist/{chunk-P7AFIKWG.js → chunk-DVC4YQI2.js} +2 -2
  121. package/dist/chunk-DVC4YQI2.js.map +1 -0
  122. package/dist/{chunk-V5RO6JYI.js → chunk-E3LFHTUV.js} +2 -2
  123. package/dist/chunk-E3LFHTUV.js.map +1 -0
  124. package/dist/{chunk-WEVYKZIF.js → chunk-EAXIDRMB.js} +1 -1
  125. package/dist/chunk-EAXIDRMB.js.map +1 -0
  126. package/dist/{chunk-WU4VLSEA.js → chunk-EYMS6VRF.js} +1 -1
  127. package/dist/chunk-EYMS6VRF.js.map +1 -0
  128. package/dist/{chunk-LH5J3VLZ.js → chunk-F7EJZV53.js} +1 -1
  129. package/dist/chunk-F7EJZV53.js.map +1 -0
  130. package/dist/{chunk-VPO27AFS.js → chunk-G3L7AKZJ.js} +1 -1
  131. package/dist/chunk-G3L7AKZJ.js.map +1 -0
  132. package/dist/{chunk-EB45EVPJ.js → chunk-G5NROYGK.js} +3 -3
  133. package/dist/chunk-G5NROYGK.js.map +1 -0
  134. package/dist/{chunk-HKEAYSFS.js → chunk-GQMINKT3.js} +1 -1
  135. package/dist/{chunk-ENOS6ETI.js.map → chunk-GQMINKT3.js.map} +1 -1
  136. package/dist/{chunk-3X3OF4TI.js → chunk-H4NXYAL7.js} +1 -1
  137. package/dist/{chunk-3X3OF4TI.js.map → chunk-H4NXYAL7.js.map} +1 -1
  138. package/dist/{chunk-KR2W4ONJ.js → chunk-H7I6YLI6.js} +1 -1
  139. package/dist/chunk-H7I6YLI6.js.map +1 -0
  140. package/dist/{chunk-PJNR4NTS.js → chunk-HC2TY45B.js} +4 -4
  141. package/dist/{chunk-NSLXEDIS.js → chunk-HHBTM4AU.js} +1 -1
  142. package/dist/chunk-HHBTM4AU.js.map +1 -0
  143. package/dist/{chunk-XVRKKYWU.js → chunk-HVUR3UNK.js} +2 -2
  144. package/dist/{chunk-XVRKKYWU.js.map → chunk-HVUR3UNK.js.map} +1 -1
  145. package/dist/{chunk-V7W4RLRW.js → chunk-HWIDTLLO.js} +3 -3
  146. package/dist/chunk-HWIDTLLO.js.map +1 -0
  147. package/dist/{chunk-W675RFOA.js → chunk-ISC2QBXJ.js} +1 -1
  148. package/dist/chunk-ISC2QBXJ.js.map +1 -0
  149. package/dist/{chunk-7DYZTEE3.js → chunk-IWPB6SSW.js} +1 -1
  150. package/dist/chunk-IWPB6SSW.js.map +1 -0
  151. package/dist/{chunk-TVLRE7S3.js → chunk-JDVWUF5W.js} +2 -2
  152. package/dist/{chunk-TVLRE7S3.js.map → chunk-JDVWUF5W.js.map} +1 -1
  153. package/dist/{chunk-757ZTGU5.js → chunk-JE2NY4XE.js} +4 -4
  154. package/dist/chunk-JE2NY4XE.js.map +1 -0
  155. package/dist/{chunk-HLEBSAGC.js → chunk-KBSZ6JRF.js} +2 -2
  156. package/dist/chunk-KBSZ6JRF.js.map +1 -0
  157. package/dist/{chunk-Y3P5B4XS.js → chunk-KCU45KQ3.js} +3 -3
  158. package/dist/chunk-KCU45KQ3.js.map +1 -0
  159. package/dist/{chunk-ST5P5HNI.js → chunk-L4YBG5US.js} +4 -4
  160. package/dist/{chunk-ST5P5HNI.js.map → chunk-L4YBG5US.js.map} +1 -1
  161. package/dist/{chunk-NG6G6V5E.js → chunk-LFH3LEWR.js} +1 -1
  162. package/dist/chunk-LFH3LEWR.js.map +1 -0
  163. package/dist/{chunk-YATTFMDV.js → chunk-LSQQSJ6J.js} +2 -2
  164. package/dist/{chunk-YATTFMDV.js.map → chunk-LSQQSJ6J.js.map} +1 -1
  165. package/dist/{chunk-LNAAWT4Y.js → chunk-MJWOZ3JI.js} +1 -1
  166. package/dist/chunk-MJWOZ3JI.js.map +1 -0
  167. package/dist/{chunk-KID32IRJ.js → chunk-MXHJMTZ5.js} +1 -1
  168. package/dist/{chunk-KID32IRJ.js.map → chunk-MXHJMTZ5.js.map} +1 -1
  169. package/dist/{chunk-GHAN7OOE.js → chunk-N6LAWI4F.js} +2 -2
  170. package/dist/chunk-N6LAWI4F.js.map +1 -0
  171. package/dist/{chunk-5VZ37TY3.js → chunk-NFJWD5BT.js} +2 -2
  172. package/dist/chunk-NFJWD5BT.js.map +1 -0
  173. package/dist/{chunk-ZPOVOEO3.js → chunk-NJLIHGU4.js} +2 -2
  174. package/dist/chunk-NJLIHGU4.js.map +1 -0
  175. package/dist/{chunk-PRD7JRQX.js → chunk-ONCQWOTH.js} +4 -4
  176. package/dist/{chunk-PRD7JRQX.js.map → chunk-ONCQWOTH.js.map} +1 -1
  177. package/dist/{chunk-ENOS6ETI.js → chunk-OZC6CDZF.js} +1 -1
  178. package/dist/{chunk-HKEAYSFS.js.map → chunk-OZC6CDZF.js.map} +1 -1
  179. package/dist/{chunk-TXFX4PMN.js → chunk-OZY4C4W5.js} +1 -1
  180. package/dist/{chunk-TXFX4PMN.js.map → chunk-OZY4C4W5.js.map} +1 -1
  181. package/dist/{chunk-NPMGYLJV.js → chunk-PIRYDEX2.js} +3 -3
  182. package/dist/chunk-PIRYDEX2.js.map +1 -0
  183. package/dist/{chunk-C57KK5VB.js → chunk-PM23USOC.js} +1 -1
  184. package/dist/chunk-PM23USOC.js.map +1 -0
  185. package/dist/{chunk-PGBF3UBX.js → chunk-QKL5TECH.js} +1 -1
  186. package/dist/chunk-QKL5TECH.js.map +1 -0
  187. package/dist/{chunk-Z47KIPCT.js → chunk-QY5JEUJT.js} +1 -1
  188. package/dist/chunk-QY5JEUJT.js.map +1 -0
  189. package/dist/{chunk-FVGFPB73.js → chunk-RPVKF4RR.js} +1 -1
  190. package/dist/{chunk-FVGFPB73.js.map → chunk-RPVKF4RR.js.map} +1 -1
  191. package/dist/{chunk-NM2DEHFZ.js → chunk-RXYKJIC4.js} +1 -1
  192. package/dist/chunk-RXYKJIC4.js.map +1 -0
  193. package/dist/{chunk-W64RAX4N.js → chunk-TKYNYIJS.js} +5 -5
  194. package/dist/chunk-TKYNYIJS.js.map +1 -0
  195. package/dist/{chunk-S4TLZRGZ.js → chunk-UMXWOA3I.js} +1 -1
  196. package/dist/chunk-UMXWOA3I.js.map +1 -0
  197. package/dist/{chunk-VA4NPCUQ.js → chunk-VD7QFUAP.js} +3 -3
  198. package/dist/chunk-VD7QFUAP.js.map +1 -0
  199. package/dist/{chunk-MDSP7DJR.js → chunk-VQELCPQJ.js} +5 -5
  200. package/dist/chunk-VQELCPQJ.js.map +1 -0
  201. package/dist/{chunk-2FCQCWIK.js → chunk-VXNBXW3P.js} +5 -5
  202. package/dist/chunk-VXNBXW3P.js.map +1 -0
  203. package/dist/{chunk-B47WSPMP.js → chunk-WPUDPH2Q.js} +1 -1
  204. package/dist/chunk-WPUDPH2Q.js.map +1 -0
  205. package/dist/{chunk-SG2RKUVJ.js → chunk-WTZUMVJI.js} +5 -5
  206. package/dist/chunk-WTZUMVJI.js.map +1 -0
  207. package/dist/{chunk-EDQLPCM4.js → chunk-WVZF6WK3.js} +2 -2
  208. package/dist/chunk-WVZF6WK3.js.map +1 -0
  209. package/dist/{chunk-5D7NMUF6.js → chunk-XDAETKWM.js} +2 -2
  210. package/dist/chunk-XDAETKWM.js.map +1 -0
  211. package/dist/{chunk-QD6SNXF5.js → chunk-XDWSGNL4.js} +3 -3
  212. package/dist/chunk-XDWSGNL4.js.map +1 -0
  213. package/dist/{chunk-SB5WSVPI.js → chunk-ZFH2BYXW.js} +2 -2
  214. package/dist/chunk-ZFH2BYXW.js.map +1 -0
  215. package/dist/{chunk-XVLWVTQA.js → chunk-ZI7K742O.js} +1 -1
  216. package/dist/{chunk-XVLWVTQA.js.map → chunk-ZI7K742O.js.map} +1 -1
  217. package/dist/{chunk-NQENOT6L.js → chunk-ZRRWSKV3.js} +8 -8
  218. package/dist/chunk-ZRRWSKV3.js.map +1 -0
  219. package/dist/cn.js +1 -1
  220. package/dist/code-block.d.ts +2 -2
  221. package/dist/code-block.js +2 -2
  222. package/dist/code-block.js.map +1 -1
  223. package/dist/collection-switcher.d.ts +1 -1
  224. package/dist/collection-switcher.js +1 -1
  225. package/dist/collection-switcher.js.map +1 -1
  226. package/dist/columns.d.ts +2 -2
  227. package/dist/columns.js.map +1 -1
  228. package/dist/combobox.js +4 -4
  229. package/dist/command.d.ts +10 -10
  230. package/dist/command.js +4 -4
  231. package/dist/command.js.map +1 -1
  232. package/dist/comparison-table.d.ts +1 -1
  233. package/dist/comparison-table.js +1 -1
  234. package/dist/comparison-table.js.map +1 -1
  235. package/dist/component-page.d.ts +1 -1
  236. package/dist/component-page.js.map +1 -1
  237. package/dist/confirm-button.d.ts +1 -1
  238. package/dist/confirm-button.js +4 -4
  239. package/dist/contact-page.d.ts +1 -1
  240. package/dist/contact-page.js.map +1 -1
  241. package/dist/continue-prompt.d.ts +1 -1
  242. package/dist/continue-prompt.js +1 -1
  243. package/dist/continue-prompt.js.map +1 -1
  244. package/dist/copy-button.d.ts +1 -1
  245. package/dist/copy-button.js +4 -4
  246. package/dist/copy-button.js.map +1 -1
  247. package/dist/countdown.d.ts +1 -1
  248. package/dist/countdown.js.map +1 -1
  249. package/dist/cover-hero.d.ts +1 -1
  250. package/dist/cover-hero.js +5 -5
  251. package/dist/cover-hero.js.map +1 -1
  252. package/dist/cta-panel.d.ts +1 -1
  253. package/dist/cta-panel.js +1 -1
  254. package/dist/cta-panel.js.map +1 -1
  255. package/dist/dashboard-layout.d.ts +2 -2
  256. package/dist/dashboard-layout.js.map +1 -1
  257. package/dist/data-table.d.ts +5 -5
  258. package/dist/data-table.js +9 -9
  259. package/dist/date-picker.d.ts +11 -11
  260. package/dist/date-picker.js +5 -5
  261. package/dist/date-picker.js.map +1 -1
  262. package/dist/decision-list.d.ts +1 -1
  263. package/dist/decision-list.js +2 -2
  264. package/dist/decision-list.js.map +1 -1
  265. package/dist/description-list.d.ts +2 -2
  266. package/dist/description-list.js.map +1 -1
  267. package/dist/detail-layout.d.ts +5 -5
  268. package/dist/detail-layout.js +1 -1
  269. package/dist/detail-layout.js.map +1 -1
  270. package/dist/{dialog-DpUwec2g.d.ts → dialog-CFnxFGyn.d.ts} +7 -7
  271. package/dist/dialog.d.ts +2 -2
  272. package/dist/dialog.js +4 -4
  273. package/dist/dialog.js.map +1 -1
  274. package/dist/docs-article-page.d.ts +1 -1
  275. package/dist/docs-article-page.js.map +1 -1
  276. package/dist/docs-hub-page.d.ts +1 -1
  277. package/dist/docs-hub-page.js.map +1 -1
  278. package/dist/docs-layout.d.ts +1 -1
  279. package/dist/docs-layout.js +1 -1
  280. package/dist/docs-layout.js.map +1 -1
  281. package/dist/docs-nav.d.ts +1 -1
  282. package/dist/docs-nav.js +1 -1
  283. package/dist/docs-nav.js.map +1 -1
  284. package/dist/document-viewer.d.ts +2 -2
  285. package/dist/document-viewer.js +3 -3
  286. package/dist/document-viewer.js.map +1 -1
  287. package/dist/doodle.d.ts +1 -1
  288. package/dist/doodle.js +1 -1
  289. package/dist/doodle.js.map +1 -1
  290. package/dist/drop-overlay.d.ts +1 -1
  291. package/dist/drop-overlay.js +1 -1
  292. package/dist/drop-overlay.js.map +1 -1
  293. package/dist/dropdown-menu.d.ts +8 -8
  294. package/dist/dropdown-menu.js +2 -2
  295. package/dist/embed-facade.js +1 -1
  296. package/dist/empty-state.d.ts +1 -1
  297. package/dist/empty-state.js.map +1 -1
  298. package/dist/engine-flow.d.ts +1 -1
  299. package/dist/engine-flow.js +1 -1
  300. package/dist/engine-flow.js.map +1 -1
  301. package/dist/entity-header.d.ts +1 -1
  302. package/dist/entity-header.js +1 -1
  303. package/dist/entity-header.js.map +1 -1
  304. package/dist/environment-notice.d.ts +1 -1
  305. package/dist/environment-notice.js.map +1 -1
  306. package/dist/error-page.d.ts +1 -1
  307. package/dist/error-page.js +1 -1
  308. package/dist/error-page.js.map +1 -1
  309. package/dist/field.d.ts +3 -3
  310. package/dist/field.js +1 -1
  311. package/dist/field.js.map +1 -1
  312. package/dist/file-upload.d.ts +1 -1
  313. package/dist/file-upload.js +1 -1
  314. package/dist/file-upload.js.map +1 -1
  315. package/dist/filter-bar.d.ts +2 -2
  316. package/dist/filter-bar.js +4 -4
  317. package/dist/flock.d.ts +1 -1
  318. package/dist/flock.js +2 -2
  319. package/dist/flock.js.map +1 -1
  320. package/dist/footnote.d.ts +3 -3
  321. package/dist/footnote.js +1 -1
  322. package/dist/footnote.js.map +1 -1
  323. package/dist/force-update-screen.d.ts +1 -1
  324. package/dist/force-update-screen.js +3 -3
  325. package/dist/force-update-screen.js.map +1 -1
  326. package/dist/form/server.js.map +1 -1
  327. package/dist/form.d.ts +12 -12
  328. package/dist/form.js +4 -4
  329. package/dist/form.js.map +1 -1
  330. package/dist/{frame-CmDztC_y.d.ts → frame-D5HU_cG8.d.ts} +2 -2
  331. package/dist/gallery-page.d.ts +1 -1
  332. package/dist/gallery-page.js +1 -1
  333. package/dist/gallery-page.js.map +1 -1
  334. package/dist/genui.d.ts +2 -2
  335. package/dist/genui.js +9 -9
  336. package/dist/genui.js.map +1 -1
  337. package/dist/glossary-term.js +2 -2
  338. package/dist/glow-card.d.ts +1 -1
  339. package/dist/glow-card.js +1 -1
  340. package/dist/glow-card.js.map +1 -1
  341. package/dist/goal-gauge.d.ts +1 -1
  342. package/dist/goal-gauge.js +1 -1
  343. package/dist/goal-gauge.js.map +1 -1
  344. package/dist/grade-stamp.d.ts +1 -1
  345. package/dist/grade-stamp.js +2 -2
  346. package/dist/grade-stamp.js.map +1 -1
  347. package/dist/identity-card.d.ts +1 -1
  348. package/dist/identity-card.js +5 -5
  349. package/dist/identity-card.js.map +1 -1
  350. package/dist/image-cropper.d.ts +1 -1
  351. package/dist/image-cropper.js +3 -3
  352. package/dist/image-cropper.js.map +1 -1
  353. package/dist/index.d.ts +5 -5
  354. package/dist/index.js +2 -2
  355. package/dist/index.js.map +1 -1
  356. package/dist/kanban.d.ts +1 -1
  357. package/dist/kanban.js.map +1 -1
  358. package/dist/kbd.d.ts +1 -1
  359. package/dist/kbd.js.map +1 -1
  360. package/dist/kind-config-editor.js +8 -8
  361. package/dist/kind-config-editor.js.map +1 -1
  362. package/dist/kpi-explained.js +1 -1
  363. package/dist/kpi-explained.js.map +1 -1
  364. package/dist/landing-page.d.ts +1 -1
  365. package/dist/landing-page.js.map +1 -1
  366. package/dist/landscape.d.ts +1 -1
  367. package/dist/landscape.js +2 -2
  368. package/dist/landscape.js.map +1 -1
  369. package/dist/language-switch.d.ts +1 -1
  370. package/dist/language-switch.js +1 -1
  371. package/dist/legal-page.d.ts +1 -1
  372. package/dist/legal-page.js.map +1 -1
  373. package/dist/{lightbox-MRB2YZEP.js → lightbox-JLWASIJC.js} +4 -4
  374. package/dist/link-card.d.ts +1 -1
  375. package/dist/link-card.js +4 -4
  376. package/dist/list.d.ts +1 -1
  377. package/dist/list.js +2 -2
  378. package/dist/list.js.map +1 -1
  379. package/dist/loader.d.ts +2 -2
  380. package/dist/loader.js +1 -1
  381. package/dist/loader.js.map +1 -1
  382. package/dist/longform-page.d.ts +1 -1
  383. package/dist/longform-page.js +1 -1
  384. package/dist/longform-page.js.map +1 -1
  385. package/dist/maintenance-screen.d.ts +1 -1
  386. package/dist/maintenance-screen.js +3 -3
  387. package/dist/maintenance-screen.js.map +1 -1
  388. package/dist/map/cards.d.ts +2 -2
  389. package/dist/map/cards.js +1 -1
  390. package/dist/map/cards.js.map +1 -1
  391. package/dist/map/pin.js +1 -1
  392. package/dist/map/sheet.d.ts +1 -1
  393. package/dist/map/sheet.js +1 -1
  394. package/dist/map/sheet.js.map +1 -1
  395. package/dist/map.d.ts +5 -5
  396. package/dist/map.js +4 -4
  397. package/dist/map.js.map +1 -1
  398. package/dist/margin-layout.d.ts +2 -2
  399. package/dist/margin-layout.js.map +1 -1
  400. package/dist/markdown.d.ts +1 -1
  401. package/dist/markdown.js.map +1 -1
  402. package/dist/marketing-layout.d.ts +1 -1
  403. package/dist/marketing-layout.js.map +1 -1
  404. package/dist/mascot-quote.d.ts +1 -1
  405. package/dist/mascot-quote.js +2 -2
  406. package/dist/mascot-quote.js.map +1 -1
  407. package/dist/mascot-state.d.ts +5 -5
  408. package/dist/mascot-state.js +1 -1
  409. package/dist/mascot-state.js.map +1 -1
  410. package/dist/mascots.d.ts +2 -2
  411. package/dist/mascots.js +2 -2
  412. package/dist/mascots.js.map +1 -1
  413. package/dist/match-dialog.d.ts +1 -1
  414. package/dist/match-dialog.js +4 -4
  415. package/dist/match-dialog.js.map +1 -1
  416. package/dist/media-capture.d.ts +1 -1
  417. package/dist/media-capture.js +1 -1
  418. package/dist/media-capture.js.map +1 -1
  419. package/dist/media-carousel.js +5 -5
  420. package/dist/media-carousel.js.map +1 -1
  421. package/dist/media-gallery.d.ts +1 -1
  422. package/dist/media-gallery.js +1 -1
  423. package/dist/media-gallery.js.map +1 -1
  424. package/dist/media-player.d.ts +1 -1
  425. package/dist/media-player.js +4 -4
  426. package/dist/meter.d.ts +2 -2
  427. package/dist/meter.js +1 -1
  428. package/dist/money-input.d.ts +1 -1
  429. package/dist/money-input.js +3 -3
  430. package/dist/motion.d.ts +1 -1
  431. package/dist/motion.js +1 -1
  432. package/dist/native/form.d.ts +12 -12
  433. package/dist/native/form.js +4 -4
  434. package/dist/native/form.js.map +1 -1
  435. package/dist/native/list.d.ts +1 -1
  436. package/dist/native/list.js.map +1 -1
  437. package/dist/native/map.d.ts +4 -4
  438. package/dist/native/map.js +2 -2
  439. package/dist/native/map.js.map +1 -1
  440. package/dist/native/markdown.js.map +1 -1
  441. package/dist/native/media-capture.d.ts +1 -1
  442. package/dist/native/media-capture.js.map +1 -1
  443. package/dist/native/media-picker.d.ts +1 -1
  444. package/dist/native/media-picker.js.map +1 -1
  445. package/dist/native/vertical-video.d.ts +2 -2
  446. package/dist/native/vertical-video.js.map +1 -1
  447. package/dist/native/video-player.d.ts +1 -1
  448. package/dist/native/video-player.js.map +1 -1
  449. package/dist/native.d.ts +95 -95
  450. package/dist/native.js +13 -13
  451. package/dist/native.js.map +1 -1
  452. package/dist/nav-bar.d.ts +13 -13
  453. package/dist/nav-bar.js +5 -5
  454. package/dist/nav-bar.js.map +1 -1
  455. package/dist/notification-preferences.js +3 -3
  456. package/dist/number-ticker.d.ts +1 -1
  457. package/dist/number-ticker.js +1 -1
  458. package/dist/number-ticker.js.map +1 -1
  459. package/dist/opening-hours.d.ts +1 -1
  460. package/dist/opening-hours.js +1 -1
  461. package/dist/opening-hours.js.map +1 -1
  462. package/dist/{page-DPHDmDAQ.d.ts → page-Ufnb5TrQ.d.ts} +5 -5
  463. package/dist/page-header.d.ts +1 -1
  464. package/dist/page-header.js.map +1 -1
  465. package/dist/page-hero.d.ts +1 -1
  466. package/dist/page-hero.js +5 -5
  467. package/dist/page-hero.js.map +1 -1
  468. package/dist/page-index.d.ts +1 -1
  469. package/dist/page-index.js +2 -2
  470. package/dist/page-index.js.map +1 -1
  471. package/dist/page.d.ts +1 -1
  472. package/dist/page.js +3 -3
  473. package/dist/pagination.d.ts +1 -1
  474. package/dist/pagination.js +1 -1
  475. package/dist/pagination.js.map +1 -1
  476. package/dist/pausable-loop.js +2 -2
  477. package/dist/{player-lightbox-BYQ57OXT.js → player-lightbox-SJR3GB7U.js} +5 -5
  478. package/dist/player-lightbox-SJR3GB7U.js.map +1 -0
  479. package/dist/pointer-light.d.ts +1 -1
  480. package/dist/pointer-light.js.map +1 -1
  481. package/dist/popover.d.ts +1 -1
  482. package/dist/popover.js +1 -1
  483. package/dist/popover.js.map +1 -1
  484. package/dist/price-catalogue-editor.js +8 -8
  485. package/dist/price-catalogue-editor.js.map +1 -1
  486. package/dist/pricing-page.d.ts +1 -1
  487. package/dist/pricing-page.js +1 -1
  488. package/dist/pricing-page.js.map +1 -1
  489. package/dist/product-page.d.ts +1 -1
  490. package/dist/product-page.js +1 -1
  491. package/dist/product-page.js.map +1 -1
  492. package/dist/profile-card.d.ts +3 -3
  493. package/dist/profile-card.js +1 -1
  494. package/dist/profile-card.js.map +1 -1
  495. package/dist/progress.d.ts +1 -1
  496. package/dist/progress.js.map +1 -1
  497. package/dist/promise-card.d.ts +1 -1
  498. package/dist/promise-card.js +1 -1
  499. package/dist/promise-card.js.map +1 -1
  500. package/dist/promo-code-field.js +4 -4
  501. package/dist/proposal.js +5 -5
  502. package/dist/qr-code.js +6 -6
  503. package/dist/qr-code.js.map +1 -1
  504. package/dist/quota-meter.d.ts +1 -1
  505. package/dist/quota-meter.js +1 -1
  506. package/dist/quota-meter.js.map +1 -1
  507. package/dist/radio-group.d.ts +5 -5
  508. package/dist/radio-group.js +3 -3
  509. package/dist/radio-group.js.map +1 -1
  510. package/dist/rail-nav.d.ts +4 -4
  511. package/dist/rail-nav.js +3 -3
  512. package/dist/rail-nav.js.map +1 -1
  513. package/dist/recipes.js +1 -1
  514. package/dist/recipes.js.map +1 -1
  515. package/dist/retro-tv-playlist.d.ts +1 -1
  516. package/dist/retro-tv-playlist.js.map +1 -1
  517. package/dist/retro-tv.js +6 -6
  518. package/dist/retro-tv.js.map +1 -1
  519. package/dist/reviews.js +3 -3
  520. package/dist/schema-form.js +7 -7
  521. package/dist/schema-form.js.map +1 -1
  522. package/dist/scroll-stage.d.ts +2 -2
  523. package/dist/scroll-stage.js +2 -2
  524. package/dist/scroll-stage.js.map +1 -1
  525. package/dist/search-field.d.ts +1 -1
  526. package/dist/search-field.js +2 -2
  527. package/dist/section-backdrop.d.ts +1 -1
  528. package/dist/section-backdrop.js +1 -1
  529. package/dist/separator.d.ts +1 -1
  530. package/dist/separator.js.map +1 -1
  531. package/dist/service-card.d.ts +1 -1
  532. package/dist/service-card.js +6 -6
  533. package/dist/service-card.js.map +1 -1
  534. package/dist/settings-layout.d.ts +3 -3
  535. package/dist/settings-layout.js +2 -2
  536. package/dist/shop/booking.d.ts +1 -1
  537. package/dist/shop/booking.js +4 -4
  538. package/dist/shop/booking.js.map +1 -1
  539. package/dist/shop/bulletin.d.ts +1 -1
  540. package/dist/shop/bulletin.js +2 -2
  541. package/dist/shop/bulletin.js.map +1 -1
  542. package/dist/shop/faq.d.ts +1 -1
  543. package/dist/shop/faq.js +3 -3
  544. package/dist/shop/faq.js.map +1 -1
  545. package/dist/shop/gallery.d.ts +1 -1
  546. package/dist/shop/gallery.js +3 -3
  547. package/dist/shop/gallery.js.map +1 -1
  548. package/dist/shop/hero.d.ts +1 -1
  549. package/dist/shop/hero.js +2 -2
  550. package/dist/shop/hero.js.map +1 -1
  551. package/dist/shop/policies.d.ts +1 -1
  552. package/dist/shop/policies.js +2 -2
  553. package/dist/shop/policies.js.map +1 -1
  554. package/dist/shop/reviews.d.ts +1 -1
  555. package/dist/shop/reviews.js +2 -2
  556. package/dist/shop/reviews.js.map +1 -1
  557. package/dist/shop/services.d.ts +1 -1
  558. package/dist/shop/services.js +4 -4
  559. package/dist/shop/services.js.map +1 -1
  560. package/dist/shop/social.d.ts +1 -1
  561. package/dist/shop/social.js +2 -2
  562. package/dist/shop/social.js.map +1 -1
  563. package/dist/shop/story.d.ts +1 -1
  564. package/dist/shop/story.js +2 -2
  565. package/dist/shop/story.js.map +1 -1
  566. package/dist/shop/team.d.ts +1 -1
  567. package/dist/shop/team.js +2 -2
  568. package/dist/shop/team.js.map +1 -1
  569. package/dist/shop/video.d.ts +1 -1
  570. package/dist/shop/video.js +2 -2
  571. package/dist/shop/video.js.map +1 -1
  572. package/dist/shop/visit.d.ts +1 -1
  573. package/dist/shop/visit.js +2 -2
  574. package/dist/shop/visit.js.map +1 -1
  575. package/dist/shop-composer.js +2 -2
  576. package/dist/shop-composer.js.map +1 -1
  577. package/dist/shop-gallery.d.ts +1 -1
  578. package/dist/shop-gallery.js +2 -2
  579. package/dist/shop-gallery.js.map +1 -1
  580. package/dist/shop.d.ts +1 -1
  581. package/dist/shop.js +2 -2
  582. package/dist/showcase.d.ts +1 -1
  583. package/dist/showcase.js +6 -6
  584. package/dist/showcase.js.map +1 -1
  585. package/dist/signature.d.ts +1 -1
  586. package/dist/signature.js +2 -2
  587. package/dist/signature.js.map +1 -1
  588. package/dist/site-cahier.d.ts +3 -3
  589. package/dist/site-cahier.js +10 -10
  590. package/dist/site-cahier.js.map +1 -1
  591. package/dist/site-footer.d.ts +4 -4
  592. package/dist/site-footer.js +1 -1
  593. package/dist/site-footer.js.map +1 -1
  594. package/dist/skeleton.d.ts +3 -3
  595. package/dist/skeleton.js.map +1 -1
  596. package/dist/skip-link.d.ts +1 -1
  597. package/dist/skip-link.js +1 -1
  598. package/dist/slider.d.ts +1 -1
  599. package/dist/slider.js +2 -2
  600. package/dist/slider.js.map +1 -1
  601. package/dist/slot-picker.d.ts +1 -1
  602. package/dist/slot-picker.js +1 -1
  603. package/dist/slot-picker.js.map +1 -1
  604. package/dist/specimen-tag.d.ts +2 -2
  605. package/dist/specimen-tag.js +2 -2
  606. package/dist/speed-lines.d.ts +1 -1
  607. package/dist/speed-lines.js +1 -1
  608. package/dist/speed-lines.js.map +1 -1
  609. package/dist/spinner.d.ts +2 -2
  610. package/dist/spinner.js +1 -1
  611. package/dist/spinner.js.map +1 -1
  612. package/dist/split-view.d.ts +1 -1
  613. package/dist/split-view.js.map +1 -1
  614. package/dist/stage-banner.d.ts +1 -1
  615. package/dist/stage-banner.js +1 -1
  616. package/dist/stage-banner.js.map +1 -1
  617. package/dist/stat.d.ts +2 -2
  618. package/dist/stat.js +1 -1
  619. package/dist/status-chip.js +4 -4
  620. package/dist/status-chip.js.map +1 -1
  621. package/dist/status-page.d.ts +1 -1
  622. package/dist/status-page.js.map +1 -1
  623. package/dist/step-progress.d.ts +1 -1
  624. package/dist/step-progress.js.map +1 -1
  625. package/dist/step-showcase.d.ts +2 -2
  626. package/dist/step-showcase.js +3 -3
  627. package/dist/step-showcase.js.map +1 -1
  628. package/dist/stepper.d.ts +1 -1
  629. package/dist/stepper.js +1 -1
  630. package/dist/stepper.js.map +1 -1
  631. package/dist/sticky-action.d.ts +1 -1
  632. package/dist/sticky-action.js.map +1 -1
  633. package/dist/stuck.d.ts +1 -1
  634. package/dist/stuck.js +1 -1
  635. package/dist/stuck.js.map +1 -1
  636. package/dist/swipe-deck.d.ts +2 -2
  637. package/dist/swipe-deck.js.map +1 -1
  638. package/dist/switch.d.ts +1 -1
  639. package/dist/switch.js +1 -1
  640. package/dist/tabs.d.ts +6 -6
  641. package/dist/tabs.js +1 -1
  642. package/dist/tabs.js.map +1 -1
  643. package/dist/tag-input.d.ts +1 -1
  644. package/dist/tag-input.js +4 -4
  645. package/dist/tag-input.js.map +1 -1
  646. package/dist/tag-selector.d.ts +1 -1
  647. package/dist/tag-selector.js +3 -3
  648. package/dist/tag-selector.js.map +1 -1
  649. package/dist/taped-photo.d.ts +1 -1
  650. package/dist/taped-photo.js +2 -2
  651. package/dist/terminal-replay.d.ts +1 -1
  652. package/dist/terminal-replay.js +3 -3
  653. package/dist/terminal-replay.js.map +1 -1
  654. package/dist/text-style/server.d.ts +1 -1
  655. package/dist/text-style/server.js.map +1 -1
  656. package/dist/text-style.d.ts +2 -2
  657. package/dist/text-style.js.map +1 -1
  658. package/dist/theme.d.ts +3 -3
  659. package/dist/theme.js +3 -3
  660. package/dist/theme.js.map +1 -1
  661. package/dist/toast.d.ts +1 -1
  662. package/dist/toast.js +2 -2
  663. package/dist/toast.js.map +1 -1
  664. package/dist/toc.d.ts +2 -2
  665. package/dist/toc.js +1 -1
  666. package/dist/toc.js.map +1 -1
  667. package/dist/tooltip.d.ts +1 -1
  668. package/dist/tooltip.js +2 -2
  669. package/dist/tree-view.d.ts +1 -1
  670. package/dist/tree-view.js +2 -2
  671. package/dist/tree-view.js.map +1 -1
  672. package/dist/update-prompt.d.ts +1 -1
  673. package/dist/update-prompt.js +3 -3
  674. package/dist/update-prompt.js.map +1 -1
  675. package/dist/upload-queue.d.ts +2 -2
  676. package/dist/upload-queue.js +1 -1
  677. package/dist/upload-queue.js.map +1 -1
  678. package/dist/usage.d.ts +4 -4
  679. package/dist/usage.js +3 -3
  680. package/dist/usage.js.map +1 -1
  681. package/dist/verified-badge.d.ts +1 -1
  682. package/dist/verified-badge.js.map +1 -1
  683. package/dist/versus-card.d.ts +1 -1
  684. package/dist/versus-card.js +2 -2
  685. package/dist/versus-card.js.map +1 -1
  686. package/dist/vertical-video.d.ts +2 -2
  687. package/dist/vertical-video.js +6 -6
  688. package/dist/vertical-video.js.map +1 -1
  689. package/dist/video-player.d.ts +1 -1
  690. package/dist/video-player.js +5 -5
  691. package/dist/video-trimmer.d.ts +1 -1
  692. package/dist/video-trimmer.js.map +1 -1
  693. package/dist/virtual.d.ts +2 -2
  694. package/dist/virtual.js +1 -1
  695. package/dist/wall.js +2 -2
  696. package/dist/wall.js.map +1 -1
  697. package/dist/waveform.d.ts +1 -1
  698. package/dist/waveform.js.map +1 -1
  699. package/package.json +26 -7
  700. package/registry/account-menu.json +1 -1
  701. package/registry/account-settings.json +18 -18
  702. package/registry/achievement.json +2 -2
  703. package/registry/action-bar.json +4 -4
  704. package/registry/activity-feed.json +3 -3
  705. package/registry/agenda.json +1 -1
  706. package/registry/alert.json +2 -2
  707. package/registry/analysis-report.json +2 -2
  708. package/registry/anatomy-plate.json +2 -2
  709. package/registry/app-frame.json +7 -7
  710. package/registry/app-header.json +5 -5
  711. package/registry/app-shell.json +3 -3
  712. package/registry/architecture-diagram.json +239 -0
  713. package/registry/argument-card.json +4 -4
  714. package/registry/auth-layout.json +2 -2
  715. package/registry/avatar.json +4 -4
  716. package/registry/badge.json +2 -2
  717. package/registry/bird-plate.json +2 -2
  718. package/registry/button.json +2 -2
  719. package/registry/captcha.json +2 -2
  720. package/registry/card-grid.json +2 -2
  721. package/registry/card.json +2 -2
  722. package/registry/catalogue-page.json +2 -2
  723. package/registry/changelog-page.json +3 -3
  724. package/registry/chapter.json +3 -3
  725. package/registry/chat.json +2 -2
  726. package/registry/checkbox.json +2 -2
  727. package/registry/chip-link.json +2 -2
  728. package/registry/chip-row.json +2 -2
  729. package/registry/chip.json +3 -3
  730. package/registry/choice-grid.json +3 -3
  731. package/registry/cn.json +1 -1
  732. package/registry/code-block.json +3 -3
  733. package/registry/collection-switcher.json +3 -3
  734. package/registry/columns.json +2 -2
  735. package/registry/combobox.json +3 -3
  736. package/registry/command.json +2 -2
  737. package/registry/comparison-table.json +2 -2
  738. package/registry/component-page.json +2 -2
  739. package/registry/confirm-button.json +2 -2
  740. package/registry/contact-page.json +2 -2
  741. package/registry/continue-prompt.json +2 -2
  742. package/registry/copy-button.json +3 -3
  743. package/registry/countdown.json +2 -2
  744. package/registry/cover-hero.json +4 -4
  745. package/registry/cta-panel.json +2 -2
  746. package/registry/dashboard-layout.json +3 -3
  747. package/registry/data-table.json +5 -5
  748. package/registry/date-picker.json +9 -9
  749. package/registry/decision-list.json +3 -3
  750. package/registry/description-list.json +2 -2
  751. package/registry/desktop-window.json +1 -1
  752. package/registry/detail-layout.json +2 -2
  753. package/registry/dialog.json +3 -3
  754. package/registry/docs-article-page.json +2 -2
  755. package/registry/docs-hub-page.json +2 -2
  756. package/registry/docs-layout.json +3 -3
  757. package/registry/docs-nav.json +2 -2
  758. package/registry/document-viewer.json +3 -3
  759. package/registry/doodle.json +2 -2
  760. package/registry/drop-overlay.json +2 -2
  761. package/registry/dropdown-menu.json +2 -2
  762. package/registry/elephant.json +1 -1
  763. package/registry/embed-facade.json +1 -1
  764. package/registry/empty-state.json +2 -2
  765. package/registry/engine-flow.json +2 -2
  766. package/registry/entity-header.json +3 -3
  767. package/registry/environment-notice.json +2 -2
  768. package/registry/error-page.json +2 -2
  769. package/registry/examples/architecture-diagram/containers.d.ts +4 -0
  770. package/registry/examples/architecture-diagram/containers.js +28 -0
  771. package/registry/examples/architecture-diagram/containers.tsx +24 -0
  772. package/registry/examples/architecture-diagram/context.d.ts +4 -0
  773. package/registry/examples/architecture-diagram/context.js +26 -0
  774. package/registry/examples/architecture-diagram/context.tsx +22 -0
  775. package/registry/examples/architecture-diagram/dynamic.d.ts +4 -0
  776. package/registry/examples/architecture-diagram/dynamic.js +27 -0
  777. package/registry/examples/architecture-diagram/dynamic.tsx +23 -0
  778. package/registry/field.json +2 -2
  779. package/registry/file-upload.json +3 -3
  780. package/registry/filter-bar.json +5 -5
  781. package/registry/flock.json +2 -2
  782. package/registry/footnote.json +2 -2
  783. package/registry/force-update-screen.json +2 -2
  784. package/registry/form.json +65 -65
  785. package/registry/gallery-page.json +2 -2
  786. package/registry/genui.json +3 -3
  787. package/registry/glossary-term.json +1 -1
  788. package/registry/glossary.json +1 -1
  789. package/registry/glow-card.json +2 -2
  790. package/registry/goal-gauge.json +2 -2
  791. package/registry/grade-stamp.json +2 -2
  792. package/registry/identity-card.json +2 -2
  793. package/registry/image-cropper.json +2 -2
  794. package/registry/index.json +37 -8
  795. package/registry/kanban.json +2 -2
  796. package/registry/kbd.json +2 -2
  797. package/registry/kind-config-editor.json +3 -3
  798. package/registry/kpi-explained.json +2 -2
  799. package/registry/landing-page.json +2 -2
  800. package/registry/landscape.json +2 -2
  801. package/registry/language-switch.json +2 -2
  802. package/registry/legal-page.json +2 -2
  803. package/registry/link-card.json +4 -4
  804. package/registry/list.json +3 -3
  805. package/registry/loader.json +2 -2
  806. package/registry/longform-page.json +2 -2
  807. package/registry/maintenance-screen.json +2 -2
  808. package/registry/map.json +8 -8
  809. package/registry/margin-layout.json +2 -2
  810. package/registry/markdown.json +2 -2
  811. package/registry/marketing-layout.json +2 -2
  812. package/registry/mascot-quote.json +2 -2
  813. package/registry/mascot-state.json +3 -3
  814. package/registry/mascots.json +4 -4
  815. package/registry/match-dialog.json +2 -2
  816. package/registry/media-capture.json +3 -3
  817. package/registry/media-gallery.json +5 -5
  818. package/registry/meter.json +2 -2
  819. package/registry/money-input.json +2 -2
  820. package/registry/nav-bar.json +9 -9
  821. package/registry/next-actions.json +1 -1
  822. package/registry/notification-preferences.json +1 -1
  823. package/registry/number-ticker.json +2 -2
  824. package/registry/opening-hours.json +3 -3
  825. package/registry/page-header.json +2 -2
  826. package/registry/page-hero.json +4 -4
  827. package/registry/page-index.json +3 -3
  828. package/registry/page.json +2 -2
  829. package/registry/pagination.json +3 -3
  830. package/registry/pointer-light.json +2 -2
  831. package/registry/popover.json +2 -2
  832. package/registry/price-catalogue-editor.json +2 -2
  833. package/registry/pricing-page.json +3 -3
  834. package/registry/product-page.json +2 -2
  835. package/registry/profile-card.json +4 -4
  836. package/registry/progress.json +2 -2
  837. package/registry/promise-card.json +2 -2
  838. package/registry/promo-code-field.json +1 -1
  839. package/registry/proposal.json +1 -1
  840. package/registry/qr-code.json +3 -3
  841. package/registry/quota-meter.json +2 -2
  842. package/registry/radio-group.json +15 -15
  843. package/registry/rail-nav.json +9 -9
  844. package/registry/recipes.json +2 -2
  845. package/registry/retro-tv.json +4 -4
  846. package/registry/reviews.json +1 -1
  847. package/registry/router.json +1 -1
  848. package/registry/schema-form.json +2 -2
  849. package/registry/scroll-stage.json +2 -2
  850. package/registry/search-field.json +3 -3
  851. package/registry/section-backdrop.json +2 -2
  852. package/registry/separator.json +2 -2
  853. package/registry/service-card.json +4 -4
  854. package/registry/settings-layout.json +2 -2
  855. package/registry/shop-composer.json +4 -4
  856. package/registry/shop-gallery.json +2 -2
  857. package/registry/shop.json +18 -18
  858. package/registry/showcase.json +2 -2
  859. package/registry/signature.json +2 -2
  860. package/registry/site-cahier.json +3 -3
  861. package/registry/site-footer.json +11 -11
  862. package/registry/sites.json +1 -1
  863. package/registry/skeleton.json +2 -2
  864. package/registry/skip-link.json +2 -2
  865. package/registry/slider.json +2 -2
  866. package/registry/slot-picker.json +3 -3
  867. package/registry/slot.json +1 -1
  868. package/registry/specimen-tag.json +2 -2
  869. package/registry/speed-lines.json +2 -2
  870. package/registry/spinner.json +3 -3
  871. package/registry/split-view.json +2 -2
  872. package/registry/stage-banner.json +2 -2
  873. package/registry/stat.json +2 -2
  874. package/registry/status-chip.json +3 -3
  875. package/registry/status-page.json +2 -2
  876. package/registry/step-progress.json +2 -2
  877. package/registry/step-showcase.json +3 -3
  878. package/registry/stepper.json +2 -2
  879. package/registry/sticky-action.json +2 -2
  880. package/registry/stuck.json +2 -2
  881. package/registry/swipe-deck.json +2 -2
  882. package/registry/switch.json +2 -2
  883. package/registry/tabs.json +2 -2
  884. package/registry/tag-input.json +2 -2
  885. package/registry/tag-selector.json +2 -2
  886. package/registry/taped-photo.json +2 -2
  887. package/registry/terminal-replay.json +3 -3
  888. package/registry/text-style.json +9 -9
  889. package/registry/theme.json +2 -2
  890. package/registry/toast.json +2 -2
  891. package/registry/toc.json +2 -2
  892. package/registry/tooltip.json +2 -2
  893. package/registry/tree-view.json +3 -3
  894. package/registry/update-prompt.json +2 -2
  895. package/registry/upload-queue.json +2 -2
  896. package/registry/usage.json +3 -3
  897. package/registry/verified-badge.json +2 -2
  898. package/registry/versus-card.json +2 -2
  899. package/registry/vertical-video.json +3 -3
  900. package/registry/video-player.json +3 -3
  901. package/registry/video-trimmer.json +2 -2
  902. package/registry/virtual.json +4 -4
  903. package/registry/wall.json +2 -2
  904. package/registry/waveform.json +2 -2
  905. package/dist/chunk-2FCQCWIK.js.map +0 -1
  906. package/dist/chunk-43PTCDTL.js.map +0 -1
  907. package/dist/chunk-5D7NMUF6.js.map +0 -1
  908. package/dist/chunk-5PFCELGW.js.map +0 -1
  909. package/dist/chunk-5RWHDX5J.js.map +0 -1
  910. package/dist/chunk-5VZ37TY3.js.map +0 -1
  911. package/dist/chunk-757ZTGU5.js.map +0 -1
  912. package/dist/chunk-7DYZTEE3.js.map +0 -1
  913. package/dist/chunk-7P7I5OQV.js.map +0 -1
  914. package/dist/chunk-B47WSPMP.js.map +0 -1
  915. package/dist/chunk-C57KK5VB.js.map +0 -1
  916. package/dist/chunk-EB45EVPJ.js.map +0 -1
  917. package/dist/chunk-EDQLPCM4.js.map +0 -1
  918. package/dist/chunk-GHAN7OOE.js.map +0 -1
  919. package/dist/chunk-HLEBSAGC.js.map +0 -1
  920. package/dist/chunk-HP7BDMVK.js.map +0 -1
  921. package/dist/chunk-KH3JOEPY.js.map +0 -1
  922. package/dist/chunk-KR2W4ONJ.js.map +0 -1
  923. package/dist/chunk-LH5J3VLZ.js.map +0 -1
  924. package/dist/chunk-LNAAWT4Y.js.map +0 -1
  925. package/dist/chunk-MDSP7DJR.js.map +0 -1
  926. package/dist/chunk-NG6G6V5E.js.map +0 -1
  927. package/dist/chunk-NM2DEHFZ.js.map +0 -1
  928. package/dist/chunk-NPMGYLJV.js.map +0 -1
  929. package/dist/chunk-NQENOT6L.js.map +0 -1
  930. package/dist/chunk-NSLXEDIS.js.map +0 -1
  931. package/dist/chunk-OGWB76BR.js.map +0 -1
  932. package/dist/chunk-P7AFIKWG.js.map +0 -1
  933. package/dist/chunk-PGBF3UBX.js.map +0 -1
  934. package/dist/chunk-QA3WETWT.js.map +0 -1
  935. package/dist/chunk-QD6SNXF5.js.map +0 -1
  936. package/dist/chunk-QHVV2JGF.js.map +0 -1
  937. package/dist/chunk-QVHSV6RA.js.map +0 -1
  938. package/dist/chunk-S2O4NSN5.js.map +0 -1
  939. package/dist/chunk-S4TLZRGZ.js.map +0 -1
  940. package/dist/chunk-S6NYGOJT.js.map +0 -1
  941. package/dist/chunk-SB5WSVPI.js.map +0 -1
  942. package/dist/chunk-SG2RKUVJ.js.map +0 -1
  943. package/dist/chunk-V5RO6JYI.js.map +0 -1
  944. package/dist/chunk-V7W4RLRW.js.map +0 -1
  945. package/dist/chunk-VA4NPCUQ.js.map +0 -1
  946. package/dist/chunk-VPO27AFS.js.map +0 -1
  947. package/dist/chunk-W64RAX4N.js.map +0 -1
  948. package/dist/chunk-W675RFOA.js.map +0 -1
  949. package/dist/chunk-WC3SO4CE.js.map +0 -1
  950. package/dist/chunk-WEVYKZIF.js.map +0 -1
  951. package/dist/chunk-WU4VLSEA.js.map +0 -1
  952. package/dist/chunk-Y3P5B4XS.js.map +0 -1
  953. package/dist/chunk-YTYNKMNS.js.map +0 -1
  954. package/dist/chunk-Z47KIPCT.js.map +0 -1
  955. package/dist/chunk-ZPOVOEO3.js.map +0 -1
  956. package/dist/player-lightbox-BYQ57OXT.js.map +0 -1
  957. /package/dist/{chunk-HJFRHYCI.js.map → chunk-DTGRZXYO.js.map} +0 -0
  958. /package/dist/{chunk-PJNR4NTS.js.map → chunk-HC2TY45B.js.map} +0 -0
  959. /package/dist/{lightbox-MRB2YZEP.js.map → lightbox-JLWASIJC.js.map} +0 -0
@@ -218,7 +218,7 @@
218
218
  "files": [
219
219
  {
220
220
  "path": "catalogue-page/catalogue-page.tsx",
221
- "content": "// Server-safe. A catalogue or an index (blocks.css `.kz-tpl-catalogue`): the hero, then the filters in a sticky column\n// beside the results — folded into a disclosure above them on a phone — the count of what matches and the sort, and\n// the results (a CardGrid of LinkCards, a list). The filters live in the address: a link per choice, no client state.\nimport { Page } from \"@krizaka/ui/page\";\nimport type { LinkComponent } from \"@krizaka/ui/page-hero\";\nimport { PageHero } from \"@krizaka/ui/page-hero\";\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nimport { Meter, type MeterProps } from \"../meter\";\n\nconst plan = tv({\n slots: {\n root: \"mb-4 flex flex-wrap items-center gap-x-8 gap-y-3 rounded-xl border border-border-default bg-surface-1 p-4\",\n figures: \"m-0 flex min-w-0 flex-wrap gap-x-8 gap-y-2\",\n figure: \"flex min-w-0 flex-col\",\n value: \"font-display text-2xl font-extrabold tabular-nums text-fg\",\n label: \"text-xs text-fg-secondary\",\n meter: \"min-w-40 flex-1\",\n },\n});\n\nexport type PlanFigure = { id: string; label: string; value: React.ReactNode };\n\nexport type PlanStripProps = Omit<React.ComponentProps<\"section\">, \"children\"> & {\n /** Names the strip (`Your plan`). */\n label: string;\n /** Two or three figures (`12 clients`, `3 invoices to send`). */\n figures: readonly PlanFigure[];\n /** The measure of the plan beside them (`Meter`): clients used of the plan, storage. */\n meter?: MeterProps;\n};\n\n/** The plan strip of a catalogue: two or three figures and a `Meter` — where the account stands, at a glance. */\nexport function PlanStrip({ label, figures, meter, className, ...props }: PlanStripProps) {\n const p = plan();\n return (\n <section aria-label={label} className={p.root({ className })} {...props}>\n <dl className={p.figures()}>\n {figures.slice(0, 3).map((f) => (\n <div key={f.id} className={p.figure()}>\n <dd className={p.value()}>{f.value}</dd>\n <dt className={p.label()}>{f.label}</dt>\n </div>\n ))}\n </dl>\n {meter && <Meter {...meter} className={p.meter({ className: meter.className })} />}\n </section>\n );\n}\n\nexport type CataloguePageProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The way back. */\n back?: { href: string; label: string };\n /** A mono line above the title. */\n eyebrow?: React.ReactNode;\n /** The page's `h1`. */\n title: React.ReactNode;\n /** One sentence under it. */\n lead?: React.ReactNode;\n /** In the hero: a search field. */\n search?: React.ReactNode;\n /** The filters (groups of ChipLinks, a FilterBar): sticky on a desktop. */\n filters: React.ReactNode;\n /** On a phone, the words that open the filters (`Filters`). */\n filtersLabel: string;\n /** Above the results: the plan strip (`PlanStrip`) — where the account stands. */\n plan?: React.ReactNode;\n /** Above the count: the binder dividers (tabs of the shelves: all · active · archived). */\n dividers?: React.ReactNode;\n /** After the results (the bar docks itself at the bottom edge): the selection bar (`SelectionBar`, `DataTable bulkActions`). */\n selection?: React.ReactNode;\n /** What matches, in words (`24 components`). */\n count?: React.ReactNode;\n /** On the right of the count: the sort, a view switch. */\n toolbar?: React.ReactNode;\n /** The results: a CardGrid, a list, an empty state. */\n children: React.ReactNode;\n /** The app's link component (Next's `Link`). */\n linkAs?: LinkComponent;\n /**\n * From which window width the filters stay in their column beside the results. `default`: 900 px and above. `wide`:\n * 1280 px and above — a wide table (DataTable) needs the room; under it the filters are a bar above the results.\n */\n railFrom?: \"default\" | \"wide\";\n};\n\n/** A catalogue: hero, sticky filters beside the results (folded on a phone), the count, the results. */\nexport function CataloguePage({ back, eyebrow, title, lead, search, filters, filtersLabel, plan, dividers, selection, count, toolbar, linkAs, railFrom = \"default\", children, ...props }: CataloguePageProps) {\n return (\n <div {...props}>\n <PageHero back={back} linkAs={linkAs} eyebrow={eyebrow} title={title} lead={lead} backdrop=\"plain\">\n {search}\n </PageHero>\n <Page className=\"kz-tpl-catalogue-frame\">\n <div className=\"kz-tpl-catalogue\" data-rail={railFrom}>\n <details className=\"kz-tpl-catalogue-filters\" open>\n <summary>{filtersLabel}</summary>\n <div>{filters}</div>\n </details>\n <div className=\"min-w-0\">\n {plan}\n {dividers}\n {(count || toolbar) && (\n <div className=\"kz-tpl-catalogue-head\">\n {count && (\n <p className=\"kz-tpl-count\" aria-live=\"polite\">\n {count}\n </p>\n )}\n {toolbar}\n </div>\n )}\n {children}\n {selection && <div className=\"mt-3\">{selection}</div>}\n </div>\n </div>\n </Page>\n </div>\n );\n}\n"
221
+ "content": "// Server-safe. A catalogue or an index (blocks.css `.kz-tpl-catalogue`): the hero, then the filters in a sticky column\n// beside the results — folded into a disclosure above them on a phone — the count of what matches and the sort, and\n// the results (a CardGrid of LinkCards, a list). The filters live in the address: a link per choice, no client state.\nimport { Page } from \"@krizaka/ui/page\";\nimport type { LinkComponent } from \"@krizaka/ui/page-hero\";\nimport { PageHero } from \"@krizaka/ui/page-hero\";\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nimport { Meter, type MeterProps } from \"../meter\";\n\nconst plan = tv({\n slots: {\n root: \"mb-4 flex flex-wrap items-center gap-x-8 gap-y-3 rounded-xl border border-border-default bg-surface-1 p-4\",\n figures: \"m-0 flex min-w-0 flex-wrap gap-x-8 gap-y-2\",\n figure: \"flex min-w-0 flex-col\",\n value: \"font-display text-2xl font-extrabold tabular-nums text-fg\",\n label: \"text-xs text-fg-secondary\",\n meter: \"min-w-40 flex-1\",\n },\n});\n\nexport type PlanFigure = { id: string; label: string; value: React.ReactNode };\n\nexport type PlanStripProps = Omit<React.ComponentProps<\"section\">, \"children\"> & {\n /** Names the strip (`Your plan`). */\n label: string;\n /** Two or three figures (`12 clients`, `3 invoices to send`). */\n figures: readonly PlanFigure[];\n /** The measure of the plan beside them (`Meter`): clients used of the plan, storage. */\n meter?: MeterProps;\n};\n\n/** The plan strip of a catalogue: two or three figures and a `Meter` — where the account stands, at a glance. */\nexport function PlanStrip({ label, figures, meter, className, ...props }: Readonly<PlanStripProps>) {\n const p = plan();\n return (\n <section aria-label={label} className={p.root({ className })} {...props}>\n <dl className={p.figures()}>\n {figures.slice(0, 3).map((f) => (\n <div key={f.id} className={p.figure()}>\n <dd className={p.value()}>{f.value}</dd>\n <dt className={p.label()}>{f.label}</dt>\n </div>\n ))}\n </dl>\n {meter && <Meter {...meter} className={p.meter({ className: meter.className })} />}\n </section>\n );\n}\n\nexport type CataloguePageProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The way back. */\n back?: { href: string; label: string };\n /** A mono line above the title. */\n eyebrow?: React.ReactNode;\n /** The page's `h1`. */\n title: React.ReactNode;\n /** One sentence under it. */\n lead?: React.ReactNode;\n /** In the hero: a search field. */\n search?: React.ReactNode;\n /** The filters (groups of ChipLinks, a FilterBar): sticky on a desktop. */\n filters: React.ReactNode;\n /** On a phone, the words that open the filters (`Filters`). */\n filtersLabel: string;\n /** Above the results: the plan strip (`PlanStrip`) — where the account stands. */\n plan?: React.ReactNode;\n /** Above the count: the binder dividers (tabs of the shelves: all · active · archived). */\n dividers?: React.ReactNode;\n /** After the results (the bar docks itself at the bottom edge): the selection bar (`SelectionBar`, `DataTable bulkActions`). */\n selection?: React.ReactNode;\n /** What matches, in words (`24 components`). */\n count?: React.ReactNode;\n /** On the right of the count: the sort, a view switch. */\n toolbar?: React.ReactNode;\n /** The results: a CardGrid, a list, an empty state. */\n children: React.ReactNode;\n /** The app's link component (Next's `Link`). */\n linkAs?: LinkComponent;\n /**\n * From which window width the filters stay in their column beside the results. `default`: 900 px and above. `wide`:\n * 1280 px and above — a wide table (DataTable) needs the room; under it the filters are a bar above the results.\n */\n railFrom?: \"default\" | \"wide\";\n};\n\n/** A catalogue: hero, sticky filters beside the results (folded on a phone), the count, the results. */\nexport function CataloguePage({ back, eyebrow, title, lead, search, filters, filtersLabel, plan, dividers, selection, count, toolbar, linkAs, railFrom = \"default\", children, ...props }: Readonly<CataloguePageProps>) {\n return (\n <div {...props}>\n <PageHero back={back} linkAs={linkAs} eyebrow={eyebrow} title={title} lead={lead} backdrop=\"plain\">\n {search}\n </PageHero>\n <Page className=\"kz-tpl-catalogue-frame\">\n <div className=\"kz-tpl-catalogue\" data-rail={railFrom}>\n <details className=\"kz-tpl-catalogue-filters\" open>\n <summary>{filtersLabel}</summary>\n <div>{filters}</div>\n </details>\n <div className=\"min-w-0\">\n {plan}\n {dividers}\n {(count || toolbar) && (\n <div className=\"kz-tpl-catalogue-head\">\n {count && (\n <p className=\"kz-tpl-count\" aria-live=\"polite\">\n {count}\n </p>\n )}\n {toolbar}\n </div>\n )}\n {children}\n {selection && <div className=\"mt-3\">{selection}</div>}\n </div>\n </div>\n </Page>\n </div>\n );\n}\n"
222
222
  },
223
223
  {
224
224
  "path": "catalogue-page/index.ts",
@@ -230,7 +230,7 @@
230
230
  },
231
231
  {
232
232
  "path": "meta.ts",
233
- "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-frame\"\n | \"desktop-window\"\n | \"form-flow\"\n | \"grid\"\n | \"list-detail\"\n | \"state-screen\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\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 | \"columns\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"copy-button\"\n | \"money-input\"\n | \"price-catalogue-editor\"\n | \"promo-code-field\"\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 | \"image-cropper\"\n | \"image-viewer\"\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 | \"waveform\"\n | \"proposal\"\n | \"qr-code\"\n | \"identity-card\"\n | \"entity-header\"\n | \"collection-switcher\"\n | \"marketing-layout\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\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 | \"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 | \"shop-gallery\"\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 | \"shop\"\n | \"shop-composer\"\n | \"schema-form\"\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 Sovkora 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 * `experimental`: created for a filed need (ADR-008 §4), it may change or go in any minor until its first consumer imports it; `adoption`\n * names that consumer's issue. `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 = \"experimental\" | \"stable\" | \"beta\" | \"deprecated\";\n\n/**\n * What a component is for (ADR-008 §3): the thirteen domains the documentation, the size budgets and the guards are\n * organised by. The domain is metadata: the entries stay flat (`@krizaka/ui/<name>`). `cahier` is the sites' register\n * (ADR-004): a product never imports it.\n */\nexport type Domain =\n | \"foundations\"\n | \"forms\"\n | \"data-display\"\n | \"navigation-shell\"\n | \"feedback\"\n | \"maps\"\n | \"media\"\n | \"commerce\"\n | \"identity\"\n | \"abuse\"\n | \"conversation\"\n | \"page-blocks\"\n | \"cahier\";\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 /** What it is for: one of the twelve domains (ADR-008 §3). */\n readonly domain: Domain;\n /** The `<repo>#<n>` issue of its first consumer: required for, and only for, an `experimental` component. */\n readonly adoption?: string;\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"
233
+ "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 | \"architecture-diagram\"\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-frame\"\n | \"desktop-window\"\n | \"form-flow\"\n | \"grid\"\n | \"list-detail\"\n | \"state-screen\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\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 | \"columns\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"copy-button\"\n | \"money-input\"\n | \"price-catalogue-editor\"\n | \"promo-code-field\"\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 | \"image-cropper\"\n | \"image-viewer\"\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 | \"waveform\"\n | \"proposal\"\n | \"qr-code\"\n | \"identity-card\"\n | \"entity-header\"\n | \"collection-switcher\"\n | \"marketing-layout\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\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 | \"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 | \"shop-gallery\"\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 | \"shop\"\n | \"shop-composer\"\n | \"schema-form\"\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 Sovkora 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 * `experimental`: created for a filed need (ADR-008 §4), it may change or go in any minor until its first consumer imports it; `adoption`\n * names that consumer's issue. `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 = \"experimental\" | \"stable\" | \"beta\" | \"deprecated\";\n\n/**\n * What a component is for (ADR-008 §3): the thirteen domains the documentation, the size budgets and the guards are\n * organised by. The domain is metadata: the entries stay flat (`@krizaka/ui/<name>`). `cahier` is the sites' register\n * (ADR-004): a product never imports it.\n */\nexport type Domain =\n | \"foundations\"\n | \"forms\"\n | \"data-display\"\n | \"navigation-shell\"\n | \"feedback\"\n | \"maps\"\n | \"media\"\n | \"commerce\"\n | \"identity\"\n | \"abuse\"\n | \"conversation\"\n | \"page-blocks\"\n | \"cahier\";\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 /** What it is for: one of the twelve domains (ADR-008 §3). */\n readonly domain: Domain;\n /** The `<repo>#<n>` issue of its first consumer: required for, and only for, an `experimental` component. */\n readonly adoption?: string;\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"
234
234
  }
235
235
  ],
236
236
  "dependencies": [
@@ -144,11 +144,11 @@
144
144
  "files": [
145
145
  {
146
146
  "path": "changelog-page/adapter.ts",
147
- "content": "/* The changelog's data, one shape for every source — pure, server-safe.\n Sources: a changesets CHANGELOG.md (the @krizaka packages), a GitHub Release body (the products), conventional PR\n titles (the draft generator). Nothing is hand-written: a site reads its sources at build into a JSON and maps it to\n `ChangelogPage` entries with `kindOfTag` (krizaka/krizaka-ui#307). */\nimport type { ChangeKind } from \"./changelog-page\";\n\nexport type ChangeTag = \"feature\" | \"fix\" | \"security\" | \"breaking\" | \"change\";\n\nexport interface ChangeItem {\n tag: ChangeTag;\n /** Plain user language, markdown links and backticks removed. */\n text: string;\n /** The pull request that made it, when the source names one. */\n pr?: { number: number; url: string };\n}\n\nexport interface Release {\n /** What was released: `@krizaka/ui`, `Sovkora`. */\n source: string;\n version: string;\n /** ISO date, `2026-10-17`. */\n date: string;\n /** The release's page (GitHub release, npm). */\n url?: string;\n changes: ChangeItem[];\n}\n\nexport const CHANGE_TAGS: readonly ChangeTag[] = [\"breaking\", \"security\", \"feature\", \"fix\", \"change\"];\n\nconst GITHUB = \"https://github.com/\";\nconst LINK_START = \"https://\";\n\n/** A line of markdown as a reader reads it: links keep their words, backticks and emphasis go. */\nexport function plain(md: string): string {\n return md\n .replace(/\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n .replace(/`([^`]*)`/g, \"$1\")\n .replace(/\\*\\*([^*]+)\\*\\*/g, \"$1\")\n .replace(/\\s+/g, \" \")\n .trim();\n}\n\n/** The tag a sentence deserves when its source does not say (security and breaking words win). */\nexport function tagOf(text: string, fallback: ChangeTag): ChangeTag {\n if (/\\bBREAKING\\b|^\\w+(\\([^)]*\\))?!:/.test(text)) return \"breaking\";\n if (/\\b(security|vulnerabilit\\w*|CVE-\\d+|XSS|CSRF)\\b/i.test(text)) return \"security\";\n return fallback;\n}\n\n/** A highlight, not the whole note: the first sentence when it is short enough, else the text cut at a word. */\nconst clip = (s: string, max = 220) => {\n const first = /^(.{20,}?[.!?])(\\s|$)/.exec(s)?.[1];\n if (first && first.length <= max) return first;\n return s.length <= max ? s : `${s.slice(0, max).replace(/\\s+\\S*$/, \"\")}…`;\n};\n\n/** The first PR a line links to, read from its markdown (`[#293](…/pull/293)`) or a bare URL. */\nexport function prOf(line: string): ChangeItem[\"pr\"] {\n for (let at = line.indexOf(GITHUB); at >= 0; at = line.indexOf(GITHUB, at + 1)) {\n const [owner, repo, kind, rest] = (line.slice(at + GITHUB.length).split(/[\\s)\\]>]/, 1)[0] ?? \"\").split(\"/\");\n const digits = /^\\d+/.exec(rest ?? \"\")?.[0];\n if (owner && repo && kind === \"pull\" && digits) return { number: Number(digits), url: GITHUB + [owner, repo, kind, digits].join(\"/\") };\n }\n return undefined;\n}\n\n/** The words of a release line, without its trailing link and GitHub's credit (`… by @someone in https://…`). */\nfunction titleOf(line: string): string {\n const words = line.trimEnd();\n const space = words.lastIndexOf(\" \");\n if (!words.startsWith(LINK_START, space + 1)) return words;\n const rest = words.slice(0, Math.max(space, 0));\n const by = rest.lastIndexOf(\" by @\");\n return by >= 0 && rest.endsWith(\" in\") ? rest.slice(0, by) : rest.trimEnd();\n}\n\nconst CHANGESET_TAG: Record<string, ChangeTag> = { major: \"breaking\", minor: \"feature\", patch: \"fix\" };\n\n/** The releases of a changesets CHANGELOG.md, newest first as written. Dates are not in the file: `dateOf(version)`. */\nexport function parseChangesets(md: string, source: string, dateOf: (version: string) => string | undefined): Release[] {\n const releases: Release[] = [];\n let current: Release | undefined;\n let level: ChangeTag = \"change\";\n for (const raw of md.split(\"\\n\")) {\n const h2 = /^## (\\d+\\.\\d+\\.\\d+\\S*)\\s*$/.exec(raw);\n if (h2) {\n const date = dateOf(h2[1]);\n current = date ? { source, version: h2[1], date, changes: [] } : undefined;\n if (current) releases.push(current);\n continue;\n }\n const h3 = /^### (\\w+) Changes/.exec(raw);\n if (h3) {\n level = CHANGESET_TAG[h3[1].toLowerCase()] ?? \"change\";\n continue;\n }\n // top-level bullets only: \"Updated dependencies\" and its nested list are plumbing, not news\n const bullet = /^- (.+)$/.exec(raw);\n if (!current || !bullet || /^Updated dependencies/.test(bullet[1])) continue;\n const text = plain(bullet[1].replace(/^(\\[[^\\]]*\\]\\([^)]*\\)\\s*)+(Thanks \\[[^\\]]*\\]\\([^)]*\\)!\\s*)?-\\s*/, \"\"));\n if (!text) continue;\n current.changes.push({ tag: tagOf(text, level === \"feature\" ? \"feature\" : level), text: clip(text), pr: prOf(bullet[1]) });\n }\n return releases.filter((r) => r.changes.length > 0);\n}\n\nconst CONVENTIONAL = /^(feat|fix|perf|security|sec|revert|refactor|docs|chore|ci|test|build|style|deps)(\\([^)]*\\))?(!)?:\\s*(.+)$/i;\nconst TAG_OF_TYPE: Record<string, ChangeTag> = { feat: \"feature\", fix: \"fix\", perf: \"change\", security: \"security\", sec: \"security\", revert: \"change\" };\n/** Types that are the team's housekeeping, not news for a reader. */\nconst QUIET_TYPES = new Set([\"refactor\", \"docs\", \"chore\", \"ci\", \"test\", \"build\", \"style\", \"deps\"]);\n\n/** One conventional PR title as a change, or `null` when it is housekeeping (chore, ci, test, docs…). */\nexport function changeFromTitle(title: string, prUrl?: string): ChangeItem | null {\n const m = CONVENTIONAL.exec(title.trim());\n const type = m?.[1].toLowerCase();\n if (m && type && QUIET_TYPES.has(type) && !m[3]) return null;\n const body = (m ? m[4] : title).replace(/\\s*\\(#\\d+\\)\\s*$/, \"\").trim();\n const sentence = plain(body.replace(/^./, (c) => c.toUpperCase()));\n const tag = tagOf(m?.[3] ? `${type}!: ${body}` : sentence, type ? (TAG_OF_TYPE[type] ?? \"change\") : \"change\");\n const num = /\\(#(\\d+)\\)\\s*$/.exec(title)?.[1];\n const pr = prUrl ? prOf(prUrl) : num ? { number: Number(num), url: \"\" } : undefined;\n return { tag, text: sentence.replace(/[.\\s]*$/, \".\"), pr };\n}\n\n/** A GitHub Release body: bullets (`* feat: … by @x in <PR url>`, `- Fix …`), conventional titles tagged, the rest «change». */\nexport function parseReleaseBody(body: string): ChangeItem[] {\n const items: ChangeItem[] = [];\n for (const raw of body.split(\"\\n\")) {\n const bullet = /^\\s*[-*] (.+)$/.exec(raw);\n if (!bullet) continue;\n const pr = prOf(bullet[1]);\n const title = titleOf(bullet[1]);\n const item = changeFromTitle(plain(title), pr?.url);\n if (item) items.push({ ...item, pr: pr ?? item.pr, text: clip(item.text) });\n }\n return items;\n}\n\n/** The draft generator: conventional PR titles → a plain-language draft entry (Markdown) for a human or an agent to polish. */\nexport function draftFromTitles(titles: readonly string[], heading: string): string {\n const groups = new Map<ChangeTag, string[]>();\n for (const title of titles) {\n const item = changeFromTitle(title);\n if (!item) continue;\n groups.set(item.tag, [...(groups.get(item.tag) ?? []), item.pr?.number ? `${item.text} (#${item.pr.number})` : item.text]);\n }\n const names: Record<ChangeTag, string> = { breaking: \"Breaking\", security: \"Security\", feature: \"New\", fix: \"Fixed\", change: \"Changed\" };\n const out = [`## ${heading}`];\n for (const tag of CHANGE_TAGS) {\n const lines = groups.get(tag);\n if (lines?.length) out.push(\"\", `### ${names[tag]}`, ...lines.map((l) => `- ${l}`));\n }\n return `${out.join(\"\\n\")}\\n`;\n}\n\n/** Semver-aware, newest first; falls back to the date. */\nexport function newestFirst(a: Release, b: Release): number {\n return b.date.localeCompare(a.date) || b.version.localeCompare(a.version, undefined, { numeric: true });\n}\n\n/** A stable anchor: `krizaka-ui-3-22-0`; the bare version is the anchor of the site's own entry. */\nexport const anchorOf = (r: Pick<Release, \"source\" | \"version\">): string =>\n `${r.source}-${r.version}`.toLowerCase().replace(/[^a-z0-9]+/g, \"-\").replace(/^-|-$/g, \"\");\n\nconst esc = (s: string) => s.replace(/&/g, \"&amp;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\").replace(/\"/g, \"&quot;\");\n\n/** The changelog as an RSS 2.0 feed. `tagLabel` words the tags in the feed's language. */\nexport function changelogRss(opts: {\n releases: readonly Release[];\n title: string;\n description: string;\n siteUrl: string;\n pageUrl: string;\n feedUrl: string;\n language: string;\n tagLabel: Record<ChangeTag, string>;\n}): string {\n const items = opts.releases\n .map((r) => {\n const list = r.changes.map((c) => `<li><b>${esc(opts.tagLabel[c.tag])}</b> ${esc(c.text)}</li>`).join(\"\");\n const link = `${opts.pageUrl}#${anchorOf(r)}`;\n return `<item><title>${esc(`${r.source} ${r.version}`)}</title><link>${esc(link)}</link><guid isPermaLink=\"true\">${esc(link)}</guid><pubDate>${new Date(`${r.date}T12:00:00Z`).toUTCString()}</pubDate><description>${esc(`<ul>${list}</ul>`)}</description></item>`;\n })\n .join(\"\");\n return `<?xml version=\"1.0\" encoding=\"UTF-8\"?><rss version=\"2.0\" xmlns:atom=\"http://www.w3.org/2005/Atom\"><channel><title>${esc(opts.title)}</title><link>${esc(opts.pageUrl)}</link><description>${esc(opts.description)}</description><language>${opts.language}</language><atom:link href=\"${esc(opts.feedUrl)}\" rel=\"self\" type=\"application/rss+xml\"/>${items}</channel></rss>`;\n}\n\n/** The template's kind for a tag: feature → added, fix → fixed, security and breaking stay themselves, the rest → changed. */\nexport const kindOfTag = (tag: ChangeTag): ChangeKind =>\n tag === \"feature\" ? \"added\" : tag === \"fix\" ? \"fixed\" : tag === \"change\" ? \"changed\" : tag;\n\nexport interface MergedPull {\n title: string;\n html_url: string;\n /** ISO timestamp, `null` for a pull request closed without merging. */\n merged_at: string | null;\n}\n\nconst mondayOf = (iso: string): string => {\n const d = new Date(`${iso.slice(0, 10)}T12:00:00Z`);\n d.setUTCDate(d.getUTCDate() - ((d.getUTCDay() + 6) % 7));\n return d.toISOString().slice(0, 10);\n};\n\n/**\n * For a repository that publishes no releases (a product still in development): its merged pull requests, by week.\n * Each week is one entry (`version` = the Monday, `date` = the last merge), its changes the conventional titles in plain\n * language — housekeeping (chore, ci, test, docs…) is left out, weeks with nothing to say are dropped.\n */\nexport function releasesFromPulls(pulls: readonly MergedPull[], source: string, url?: string): Release[] {\n const weeks = new Map<string, { date: string; changes: ChangeItem[] }>();\n for (const p of pulls) {\n if (!p.merged_at) continue;\n const item = changeFromTitle(p.title, p.html_url);\n if (!item) continue;\n const key = mondayOf(p.merged_at);\n const week = weeks.get(key) ?? { date: p.merged_at.slice(0, 10), changes: [] };\n if (p.merged_at.slice(0, 10) > week.date) week.date = p.merged_at.slice(0, 10);\n week.changes.push(item);\n weeks.set(key, week);\n }\n return [...weeks].map(([version, w]) => ({ source, version, date: w.date, url, changes: w.changes })).sort(newestFirst);\n}\n"
147
+ "content": "/* The changelog's data, one shape for every source — pure, server-safe.\n Sources: a changesets CHANGELOG.md (the @krizaka packages), a GitHub Release body (the products), conventional PR\n titles (the draft generator). Nothing is hand-written: a site reads its sources at build into a JSON and maps it to\n `ChangelogPage` entries with `kindOfTag` (krizaka/krizaka-ui#307). */\nimport type { ChangeKind } from \"./changelog-page\";\n\nexport type ChangeTag = \"feature\" | \"fix\" | \"security\" | \"breaking\" | \"change\";\n\nexport interface ChangeItem {\n tag: ChangeTag;\n /** Plain user language, markdown links and backticks removed. */\n text: string;\n /** The pull request that made it, when the source names one. */\n pr?: { number: number; url: string };\n}\n\nexport interface Release {\n /** What was released: `@krizaka/ui`, `Sovkora`. */\n source: string;\n version: string;\n /** ISO date, `2026-10-17`. */\n date: string;\n /** The release's page (GitHub release, npm). */\n url?: string;\n changes: ChangeItem[];\n}\n\nexport const CHANGE_TAGS: readonly ChangeTag[] = [\"breaking\", \"security\", \"feature\", \"fix\", \"change\"];\n\nconst GITHUB = \"https://github.com/\";\nconst LINK_START = \"https://\";\n\n/** A line of markdown as a reader reads it: links keep their words, backticks and emphasis go. */\nexport function plain(md: string): string {\n return md\n .replace(/\\[([^\\]]*)\\]\\([^)]*\\)/g, \"$1\")\n .replace(/`([^`]*)`/g, \"$1\")\n .replace(/\\*\\*([^*]+)\\*\\*/g, \"$1\")\n .replace(/\\s+/g, \" \")\n .trim();\n}\n\n/** The tag a sentence deserves when its source does not say (security and breaking words win). */\nexport function tagOf(text: string, fallback: ChangeTag): ChangeTag {\n if (/\\bBREAKING\\b|^\\w+(\\([^)]*\\))?!:/.test(text)) return \"breaking\";\n if (/\\b(security|vulnerabilit\\w*|CVE-\\d+|XSS|CSRF)\\b/i.test(text)) return \"security\";\n return fallback;\n}\n\n/** A highlight, not the whole note: the first sentence when it is short enough, else the text cut at a word. */\nconst clip = (s: string, max = 220) => {\n const first = /^(.{20,}?[.!?])(\\s|$)/.exec(s)?.[1];\n if (first && first.length <= max) return first;\n return s.length <= max ? s : `${s.slice(0, max).replace(/\\s+\\S*$/, \"\")}…`;\n};\n\n/** The first PR a line links to, read from its markdown (`[#293](…/pull/293)`) or a bare URL. */\nexport function prOf(line: string): ChangeItem[\"pr\"] {\n for (let at = line.indexOf(GITHUB); at >= 0; at = line.indexOf(GITHUB, at + 1)) {\n const [owner, repo, kind, rest] = (line.slice(at + GITHUB.length).split(/[\\s)\\]>]/, 1)[0] ?? \"\").split(\"/\");\n const digits = /^\\d+/.exec(rest ?? \"\")?.[0];\n if (owner && repo && kind === \"pull\" && digits) return { number: Number(digits), url: GITHUB + [owner, repo, kind, digits].join(\"/\") };\n }\n return undefined;\n}\n\n/** The words of a release line, without its trailing link and GitHub's credit (`… by @someone in https://…`). */\nfunction titleOf(line: string): string {\n const words = line.trimEnd();\n const space = words.lastIndexOf(\" \");\n if (!words.startsWith(LINK_START, space + 1)) return words;\n const rest = words.slice(0, Math.max(space, 0));\n const by = rest.lastIndexOf(\" by @\");\n return by >= 0 && rest.endsWith(\" in\") ? rest.slice(0, by) : rest.trimEnd();\n}\n\nconst CHANGESET_TAG: Record<string, ChangeTag> = { major: \"breaking\", minor: \"feature\", patch: \"fix\" };\n\n/** The releases of a changesets CHANGELOG.md, newest first as written. Dates are not in the file: `dateOf(version)`. */\nexport function parseChangesets(md: string, source: string, dateOf: (version: string) => string | undefined): Release[] {\n const releases: Release[] = [];\n let current: Release | undefined;\n let level: ChangeTag = \"change\";\n for (const raw of md.split(\"\\n\")) {\n const h2 = /^## (\\d+\\.\\d+\\.\\d+\\S*)\\s*$/.exec(raw);\n if (h2) {\n const date = dateOf(h2[1]);\n current = date ? { source, version: h2[1], date, changes: [] } : undefined;\n if (current) releases.push(current);\n continue;\n }\n const h3 = /^### (\\w+) Changes/.exec(raw);\n if (h3) {\n level = CHANGESET_TAG[h3[1].toLowerCase()] ?? \"change\";\n continue;\n }\n // top-level bullets only: \"Updated dependencies\" and its nested list are plumbing, not news\n const bullet = /^- (.+)$/.exec(raw);\n if (!current || !bullet || /^Updated dependencies/.test(bullet[1])) continue;\n const text = plain(bullet[1].replace(/^(\\[[^\\]]*\\]\\([^)]*\\)\\s*)+(Thanks \\[[^\\]]*\\]\\([^)]*\\)!\\s*)?-\\s*/, \"\"));\n if (!text) continue;\n current.changes.push({ tag: tagOf(text, level === \"feature\" ? \"feature\" : level), text: clip(text), pr: prOf(bullet[1]) });\n }\n return releases.filter((r) => r.changes.length > 0);\n}\n\nconst CONVENTIONAL = /^(feat|fix|perf|security|sec|revert|refactor|docs|chore|ci|test|build|style|deps)(\\([^)]*\\))?(!)?:\\s*(.+)$/i;\nconst TAG_OF_TYPE: Record<string, ChangeTag> = { feat: \"feature\", fix: \"fix\", perf: \"change\", security: \"security\", sec: \"security\", revert: \"change\" };\n/** Types that are the team's housekeeping, not news for a reader. */\nconst QUIET_TYPES = new Set([\"refactor\", \"docs\", \"chore\", \"ci\", \"test\", \"build\", \"style\", \"deps\"]);\n\n/** One conventional PR title as a change, or `null` when it is housekeeping (chore, ci, test, docs…). */\nexport function changeFromTitle(title: string, prUrl?: string): ChangeItem | null {\n const m = CONVENTIONAL.exec(title.trim());\n const type = m?.[1].toLowerCase();\n if (m && type && QUIET_TYPES.has(type) && !m[3]) return null;\n const body = (m ? m[4] : title).replace(/\\s*\\(#\\d+\\)\\s*$/, \"\").trim();\n const sentence = plain(body.replace(/^./, (c) => c.toUpperCase()));\n const tag = tagOf(m?.[3] ? `${type}!: ${body}` : sentence, type ? (TAG_OF_TYPE[type] ?? \"change\") : \"change\");\n const num = /\\(#(\\d+)\\)\\s*$/.exec(title)?.[1];\n const pr = prUrl ? prOf(prUrl) : num ? { number: Number(num), url: \"\" } : undefined;\n return { tag, text: sentence.replace(/[.\\s]*$/, \".\"), pr };\n}\n\n/** A GitHub Release body: bullets (`* feat: … by @x in <PR url>`, `- Fix …`), conventional titles tagged, the rest «change». */\nexport function parseReleaseBody(body: string): ChangeItem[] {\n const items: ChangeItem[] = [];\n for (const raw of body.split(\"\\n\")) {\n const bullet = /^\\s*[-*] (.+)$/.exec(raw);\n if (!bullet) continue;\n const pr = prOf(bullet[1]);\n const title = titleOf(bullet[1]);\n const item = changeFromTitle(plain(title), pr?.url);\n if (item) items.push({ ...item, pr: pr ?? item.pr, text: clip(item.text) });\n }\n return items;\n}\n\n/** The draft generator: conventional PR titles → a plain-language draft entry (Markdown) for a human or an agent to polish. */\nexport function draftFromTitles(titles: readonly string[], heading: string): string {\n const groups = new Map<ChangeTag, string[]>();\n for (const title of titles) {\n const item = changeFromTitle(title);\n if (!item) continue;\n groups.set(item.tag, [...(groups.get(item.tag) ?? []), item.pr?.number ? `${item.text} (#${item.pr.number})` : item.text]);\n }\n const names: Record<ChangeTag, string> = { breaking: \"Breaking\", security: \"Security\", feature: \"New\", fix: \"Fixed\", change: \"Changed\" };\n const out = [`## ${heading}`];\n for (const tag of CHANGE_TAGS) {\n const lines = groups.get(tag);\n if (lines?.length) out.push(\"\", `### ${names[tag]}`, ...lines.map((l) => `- ${l}`));\n }\n return `${out.join(\"\\n\")}\\n`;\n}\n\n/** Semver-aware, newest first; falls back to the date. */\nexport function newestFirst(a: Release, b: Release): number {\n return b.date.localeCompare(a.date) || b.version.localeCompare(a.version, undefined, { numeric: true });\n}\n\n/** A stable anchor: `krizaka-ui-3-22-0`; the bare version is the anchor of the site's own entry. */\nexport const anchorOf = (r: Pick<Release, \"source\" | \"version\">): string =>\n `${r.source}-${r.version}`.toLowerCase().replaceAll(/[^a-z0-9]+/g, \"-\").replaceAll(/^-|-$/g, \"\");\n\nconst esc = (s: string) => s.replaceAll('&', \"&amp;\").replaceAll('<', \"&lt;\").replaceAll('>', \"&gt;\").replaceAll('\"', \"&quot;\");\n\n/** The changelog as an RSS 2.0 feed. `tagLabel` words the tags in the feed's language. */\nexport function changelogRss(opts: {\n releases: readonly Release[];\n title: string;\n description: string;\n siteUrl: string;\n pageUrl: string;\n feedUrl: string;\n language: string;\n tagLabel: Record<ChangeTag, string>;\n}): string {\n const items = opts.releases\n .map((r) => {\n const list = r.changes.map((c) => `<li><b>${esc(opts.tagLabel[c.tag])}</b> ${esc(c.text)}</li>`).join(\"\");\n const link = `${opts.pageUrl}#${anchorOf(r)}`;\n return `<item><title>${esc(`${r.source} ${r.version}`)}</title><link>${esc(link)}</link><guid isPermaLink=\"true\">${esc(link)}</guid><pubDate>${new Date(`${r.date}T12:00:00Z`).toUTCString()}</pubDate><description>${esc(`<ul>${list}</ul>`)}</description></item>`;\n })\n .join(\"\");\n return `<?xml version=\"1.0\" encoding=\"UTF-8\"?><rss version=\"2.0\" xmlns:atom=\"http://www.w3.org/2005/Atom\"><channel><title>${esc(opts.title)}</title><link>${esc(opts.pageUrl)}</link><description>${esc(opts.description)}</description><language>${opts.language}</language><atom:link href=\"${esc(opts.feedUrl)}\" rel=\"self\" type=\"application/rss+xml\"/>${items}</channel></rss>`;\n}\n\n/** The template's kind for a tag: feature → added, fix → fixed, security and breaking stay themselves, the rest → changed. */\nexport const kindOfTag = (tag: ChangeTag): ChangeKind =>\n tag === \"feature\" ? \"added\" : tag === \"fix\" ? \"fixed\" : tag === \"change\" ? \"changed\" : tag;\n\nexport interface MergedPull {\n title: string;\n html_url: string;\n /** ISO timestamp, `null` for a pull request closed without merging. */\n merged_at: string | null;\n}\n\nconst mondayOf = (iso: string): string => {\n const d = new Date(`${iso.slice(0, 10)}T12:00:00Z`);\n d.setUTCDate(d.getUTCDate() - ((d.getUTCDay() + 6) % 7));\n return d.toISOString().slice(0, 10);\n};\n\n/**\n * For a repository that publishes no releases (a product still in development): its merged pull requests, by week.\n * Each week is one entry (`version` = the Monday, `date` = the last merge), its changes the conventional titles in plain\n * language — housekeeping (chore, ci, test, docs…) is left out, weeks with nothing to say are dropped.\n */\nexport function releasesFromPulls(pulls: readonly MergedPull[], source: string, url?: string): Release[] {\n const weeks = new Map<string, { date: string; changes: ChangeItem[] }>();\n for (const p of pulls) {\n if (!p.merged_at) continue;\n const item = changeFromTitle(p.title, p.html_url);\n if (!item) continue;\n const key = mondayOf(p.merged_at);\n const week = weeks.get(key) ?? { date: p.merged_at.slice(0, 10), changes: [] };\n if (p.merged_at.slice(0, 10) > week.date) week.date = p.merged_at.slice(0, 10);\n week.changes.push(item);\n weeks.set(key, week);\n }\n return [...weeks].map(([version, w]) => ({ source, version, date: w.date, url, changes: w.changes })).sort(newestFirst);\n}\n"
148
148
  },
149
149
  {
150
150
  "path": "changelog-page/changelog-page.tsx",
151
- "content": "// Server-safe. What changed and why (blocks.css `.kz-tpl-log`): the hero, then the entries — the date and version\n// sticking beside them while they scroll, a title, the changes by kind (added · changed · fixed · removed · security · breaking, in words and\n// colour) — and, when a change was a decision, its reasons (a DecisionList) under it.\nimport { Page } from \"@krizaka/ui/page\";\nimport type { LinkComponent } from \"@krizaka/ui/page-hero\";\nimport { PageHero } from \"@krizaka/ui/page-hero\";\nimport type * as React from \"react\";\n\nexport type ChangeKind = \"added\" | \"changed\" | \"fixed\" | \"removed\" | \"security\" | \"breaking\";\n\nexport interface ChangelogEntry {\n /** A stable key (the entry's anchor). */\n id: string;\n /** Its date, ISO (`2026-10-11`): shown as `dateLabel`. */\n date: string;\n /** The date as the reader reads it (`11 October 2026`). */\n dateLabel: React.ReactNode;\n /** The version or the release (`@krizaka/ui 2.6.0`): a fact beside the date. */\n version?: React.ReactNode;\n /** The entry's title. */\n title: React.ReactNode;\n /** The changes, each with its kind. */\n changes: readonly { kind: ChangeKind; text: React.ReactNode }[];\n /** Under the changes: why (a DecisionList, a quote), a link to the pull request. */\n children?: React.ReactNode;\n}\n\nexport type ChangelogPageProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The way back. */\n back?: { href: string; label: string };\n /** A mono line above the title. */\n eyebrow?: React.ReactNode;\n /** The page's `h1`. */\n title: React.ReactNode;\n /** One sentence under it. */\n lead?: React.ReactNode;\n /** In the hero: a subscribe action, the feed. */\n actions?: React.ReactNode;\n /** The words of the kinds: `{ added: \"Added\", security: \"Security\", … }`. */\n kindLabels: Record<ChangeKind, string>;\n /** The log's accessible name (`Changes`). */\n logLabel: string;\n /** The entries, newest first. */\n entries: readonly ChangelogEntry[];\n /** The app's link component (Next's `Link`). */\n linkAs?: LinkComponent;\n};\n\n/** A changelog: entries with a sticky date and version, changes by kind, the reasons under them. */\nexport function ChangelogPage({ back, eyebrow, title, lead, actions, kindLabels, logLabel, entries, linkAs, ...props }: ChangelogPageProps) {\n return (\n <div {...props}>\n <PageHero back={back} linkAs={linkAs} eyebrow={eyebrow} title={title} lead={lead} backdrop=\"plain\">\n {actions}\n </PageHero>\n <Page className=\"kz-tpl-longform\">\n <ol className=\"kz-tpl-log\" aria-label={logLabel}>\n {entries.map((e) => (\n <li key={e.id} id={e.id} className=\"kz-tpl-log-entry\">\n <div className=\"kz-tpl-log-when\">\n <time dateTime={e.date}>{e.dateLabel}</time>\n {e.version && <span className=\"kz-fact\">{e.version}</span>}\n </div>\n <div>\n <h2>{e.title}</h2>\n <ul className=\"kz-tpl-log-items\">\n {e.changes.map((c, i) => (\n <li key={i}>\n <span className=\"kz-tpl-log-kind\" data-kind={c.kind}>\n {kindLabels[c.kind]}\n </span>\n <span>{c.text}</span>\n </li>\n ))}\n </ul>\n {e.children}\n </div>\n </li>\n ))}\n </ol>\n </Page>\n </div>\n );\n}\n"
151
+ "content": "// Server-safe. What changed and why (blocks.css `.kz-tpl-log`): the hero, then the entries — the date and version\n// sticking beside them while they scroll, a title, the changes by kind (added · changed · fixed · removed · security · breaking, in words and\n// colour) — and, when a change was a decision, its reasons (a DecisionList) under it.\nimport { Page } from \"@krizaka/ui/page\";\nimport type { LinkComponent } from \"@krizaka/ui/page-hero\";\nimport { PageHero } from \"@krizaka/ui/page-hero\";\nimport type * as React from \"react\";\n\nexport type ChangeKind = \"added\" | \"changed\" | \"fixed\" | \"removed\" | \"security\" | \"breaking\";\n\nexport interface ChangelogEntry {\n /** A stable key (the entry's anchor). */\n id: string;\n /** Its date, ISO (`2026-10-11`): shown as `dateLabel`. */\n date: string;\n /** The date as the reader reads it (`11 October 2026`). */\n dateLabel: React.ReactNode;\n /** The version or the release (`@krizaka/ui 2.6.0`): a fact beside the date. */\n version?: React.ReactNode;\n /** The entry's title. */\n title: React.ReactNode;\n /** The changes, each with its kind. */\n changes: readonly { kind: ChangeKind; text: React.ReactNode }[];\n /** Under the changes: why (a DecisionList, a quote), a link to the pull request. */\n children?: React.ReactNode;\n}\n\nexport type ChangelogPageProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The way back. */\n back?: { href: string; label: string };\n /** A mono line above the title. */\n eyebrow?: React.ReactNode;\n /** The page's `h1`. */\n title: React.ReactNode;\n /** One sentence under it. */\n lead?: React.ReactNode;\n /** In the hero: a subscribe action, the feed. */\n actions?: React.ReactNode;\n /** The words of the kinds: `{ added: \"Added\", security: \"Security\", … }`. */\n kindLabels: Record<ChangeKind, string>;\n /** The log's accessible name (`Changes`). */\n logLabel: string;\n /** The entries, newest first. */\n entries: readonly ChangelogEntry[];\n /** The app's link component (Next's `Link`). */\n linkAs?: LinkComponent;\n};\n\n/** A changelog: entries with a sticky date and version, changes by kind, the reasons under them. */\nexport function ChangelogPage({ back, eyebrow, title, lead, actions, kindLabels, logLabel, entries, linkAs, ...props }: Readonly<ChangelogPageProps>) {\n return (\n <div {...props}>\n <PageHero back={back} linkAs={linkAs} eyebrow={eyebrow} title={title} lead={lead} backdrop=\"plain\">\n {actions}\n </PageHero>\n <Page className=\"kz-tpl-longform\">\n <ol className=\"kz-tpl-log\" aria-label={logLabel}>\n {entries.map((e) => (\n <li key={e.id} id={e.id} className=\"kz-tpl-log-entry\">\n <div className=\"kz-tpl-log-when\">\n <time dateTime={e.date}>{e.dateLabel}</time>\n {e.version && <span className=\"kz-fact\">{e.version}</span>}\n </div>\n <div>\n <h2>{e.title}</h2>\n <ul className=\"kz-tpl-log-items\">\n {e.changes.map((c, i) => (\n <li key={i}>\n <span className=\"kz-tpl-log-kind\" data-kind={c.kind}>\n {kindLabels[c.kind]}\n </span>\n <span>{c.text}</span>\n </li>\n ))}\n </ul>\n {e.children}\n </div>\n </li>\n ))}\n </ol>\n </Page>\n </div>\n );\n}\n"
152
152
  },
153
153
  {
154
154
  "path": "changelog-page/index.ts",
@@ -160,7 +160,7 @@
160
160
  },
161
161
  {
162
162
  "path": "meta.ts",
163
- "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-frame\"\n | \"desktop-window\"\n | \"form-flow\"\n | \"grid\"\n | \"list-detail\"\n | \"state-screen\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\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 | \"columns\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"copy-button\"\n | \"money-input\"\n | \"price-catalogue-editor\"\n | \"promo-code-field\"\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 | \"image-cropper\"\n | \"image-viewer\"\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 | \"waveform\"\n | \"proposal\"\n | \"qr-code\"\n | \"identity-card\"\n | \"entity-header\"\n | \"collection-switcher\"\n | \"marketing-layout\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\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 | \"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 | \"shop-gallery\"\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 | \"shop\"\n | \"shop-composer\"\n | \"schema-form\"\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 Sovkora 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 * `experimental`: created for a filed need (ADR-008 §4), it may change or go in any minor until its first consumer imports it; `adoption`\n * names that consumer's issue. `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 = \"experimental\" | \"stable\" | \"beta\" | \"deprecated\";\n\n/**\n * What a component is for (ADR-008 §3): the thirteen domains the documentation, the size budgets and the guards are\n * organised by. The domain is metadata: the entries stay flat (`@krizaka/ui/<name>`). `cahier` is the sites' register\n * (ADR-004): a product never imports it.\n */\nexport type Domain =\n | \"foundations\"\n | \"forms\"\n | \"data-display\"\n | \"navigation-shell\"\n | \"feedback\"\n | \"maps\"\n | \"media\"\n | \"commerce\"\n | \"identity\"\n | \"abuse\"\n | \"conversation\"\n | \"page-blocks\"\n | \"cahier\";\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 /** What it is for: one of the twelve domains (ADR-008 §3). */\n readonly domain: Domain;\n /** The `<repo>#<n>` issue of its first consumer: required for, and only for, an `experimental` component. */\n readonly adoption?: string;\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"
163
+ "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 | \"architecture-diagram\"\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-frame\"\n | \"desktop-window\"\n | \"form-flow\"\n | \"grid\"\n | \"list-detail\"\n | \"state-screen\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\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 | \"columns\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"copy-button\"\n | \"money-input\"\n | \"price-catalogue-editor\"\n | \"promo-code-field\"\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 | \"image-cropper\"\n | \"image-viewer\"\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 | \"waveform\"\n | \"proposal\"\n | \"qr-code\"\n | \"identity-card\"\n | \"entity-header\"\n | \"collection-switcher\"\n | \"marketing-layout\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\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 | \"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 | \"shop-gallery\"\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 | \"shop\"\n | \"shop-composer\"\n | \"schema-form\"\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 Sovkora 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 * `experimental`: created for a filed need (ADR-008 §4), it may change or go in any minor until its first consumer imports it; `adoption`\n * names that consumer's issue. `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 = \"experimental\" | \"stable\" | \"beta\" | \"deprecated\";\n\n/**\n * What a component is for (ADR-008 §3): the thirteen domains the documentation, the size budgets and the guards are\n * organised by. The domain is metadata: the entries stay flat (`@krizaka/ui/<name>`). `cahier` is the sites' register\n * (ADR-004): a product never imports it.\n */\nexport type Domain =\n | \"foundations\"\n | \"forms\"\n | \"data-display\"\n | \"navigation-shell\"\n | \"feedback\"\n | \"maps\"\n | \"media\"\n | \"commerce\"\n | \"identity\"\n | \"abuse\"\n | \"conversation\"\n | \"page-blocks\"\n | \"cahier\";\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 /** What it is for: one of the twelve domains (ADR-008 §3). */\n readonly domain: Domain;\n /** The `<repo>#<n>` issue of its first consumer: required for, and only for, an `experimental` component. */\n readonly adoption?: string;\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"
164
164
  }
165
165
  ],
166
166
  "dependencies": [],
@@ -313,11 +313,11 @@
313
313
  "files": [
314
314
  {
315
315
  "path": "block-link.tsx",
316
- "content": "// The links of the page blocks (PageHero's back link, LinkCard, ArgumentCard, ActionBar): an internal path renders\n// through the app's router link (`linkAs`, e.g. Next's `Link`), anything else is an `<a>` that opens in a new tab.\n// Shared by the block entries; never exported on its own.\nimport type * as React from \"react\";\n\n/** The app's link component (Next's `Link`, React Router's `Link`…): receives `href`, `className` and the children. */\nexport type LinkComponent = React.ElementType<{ href: string; className?: string; children?: React.ReactNode; \"aria-label\"?: string; \"aria-describedby\"?: string }>;\n\n/** An address that leaves the app: an absolute URL or a protocol (`mailto:`). */\nexport const isExternal = (href: string) => /^[a-z][a-z0-9+.-]*:/i.test(href);\n\nexport function BlockLink({\n href,\n linkAs: Link = \"a\",\n external = isExternal(href),\n rel,\n ...props\n}: Omit<React.ComponentProps<\"a\">, \"href\"> & { href: string; linkAs?: LinkComponent; external?: boolean }) {\n if (external) return <a href={href} target=\"_blank\" rel={rel ?? \"noopener noreferrer\"} {...props} />;\n const Comp = Link as React.ElementType;\n return <Comp href={href} rel={rel} {...props} />;\n}\n"
316
+ "content": "// The links of the page blocks (PageHero's back link, LinkCard, ArgumentCard, ActionBar): an internal path renders\n// through the app's router link (`linkAs`, e.g. Next's `Link`), anything else is an `<a>` that opens in a new tab.\n// Shared by the block entries; never exported on its own.\nimport type * as React from \"react\";\n\n/** The app's link component (Next's `Link`, React Router's `Link`…): receives `href`, `className` and the children. */\nexport type LinkComponent = React.ElementType<{ href: string; className?: string; children?: React.ReactNode; \"aria-label\"?: string; \"aria-describedby\"?: string }>;\n\n/** An address that leaves the app: an absolute URL or a protocol (`mailto:`). */\nexport const isExternal = (href: string) => /^[a-z][a-z0-9+.-]*:/i.test(href);\n\nexport function BlockLink({\n href,\n linkAs: Link = \"a\",\n external = isExternal(href),\n rel,\n ...props\n}: Readonly<Omit<React.ComponentProps<\"a\">, \"href\"> & { href: string; linkAs?: LinkComponent; external?: boolean }>) {\n if (external) return <a href={href} target=\"_blank\" rel={rel ?? \"noopener noreferrer\"} {...props} />;\n const Comp = Link as React.ElementType;\n return <Comp href={href} rel={rel} {...props} />;\n}\n"
317
317
  },
318
318
  {
319
319
  "path": "chapter/chapter.tsx",
320
- "content": "// Server-safe. The chapters of a story on the Cahier (ADR-004, blocks.css, krizaka-ui#617): a sober timeline, never a\n// stack of boxes. The rows sit on the notebook's ruled lines (`data-paper=\"lines\"`, the ruling of `Page`), the number\n// hangs in the margin beside its red rule (`data-margin`), the serif title is the link, the period is quiet.\n// - `ChapterIndex` — the chapters in reading order, one ruled line each (two at most), the latest marked « New »;\n// - `ChapterHead` — the head of a chapter's page: number in the margin, title, one quiet meta line, the standfirst;\n// - `ChapterFoot` — its foot: the previous and next chapters on the lines, then one line back to the story.\n// No border per row, no card, no button: the paper carries the rhythm. Every word arrives as a prop.\n// `ChapterIndex variant=\"album\"` (#621): each row is the chapter's cover as a `TapedPhoto`, the prints facing each other\n// from left to right, and beside it the same number, title, line and period — light, on the same lines.\nimport type * as React from \"react\";\n\nimport { BlockLink, type LinkComponent } from \"../block-link\";\nimport { cn } from \"../cn\";\nimport { TapedPhoto } from \"../taped-photo\";\n\n/** The notebook under the rows: `lines` (the ruling of `Page`, aligned on the rows) or `false` (the page's own paper). */\ntype ChapterPaper = \"lines\" | false;\n\nexport interface ChapterEntry {\n /** Its number, hung in the margin: `01`, `§ 1`. */\n number: React.ReactNode;\n /** The title, in the serif: the link. */\n title: React.ReactNode;\n /** Where it leads. */\n href: string;\n /** When it happened, quiet on the right (under the title on a phone): `janv. – mars 2026`, or a `<time>`. */\n period?: React.ReactNode;\n /** One more line under the title (what was faced → what was built). Off unless given: the chapter's page says it. */\n detail?: React.ReactNode;\n /** The latest chapter: a small mark after the title, in the hue (`newLabel`). */\n isNew?: boolean;\n /** The page the reader is on. */\n current?: boolean;\n /** Its cover, drawn by the `album` variant as a taped print. Decorative there (`alt=\"\"`): the title carries the link. */\n cover?: ChapterCover;\n}\n\n/** A chapter's cover: its intrinsic size gives the print its aspect-ratio, so nothing shifts while it loads. */\nexport interface ChapterCover {\n src: string;\n width: number;\n height: number;\n srcSet?: string;\n /** @default \"(max-width: 34rem) 60vw, 26rem\" */\n sizes?: string;\n}\n\n/** The covers above the fold load at once; the rest wait for the reader. */\nconst EAGER_COVERS = 2;\n/** The prints face each other: the left one leans left, the right one leans right (TapedPhoto's practice). */\nconst ALBUM_TILT = 1.4;\n\nfunction ChapterPrint({ cover, index }: Readonly<{ cover: ChapterCover; index: number }>) {\n return (\n <TapedPhoto className=\"kz-chapter-print\" tilt={index % 2 === 0 ? -ALBUM_TILT : ALBUM_TILT} aria-hidden>\n <img\n src={cover.src}\n srcSet={cover.srcSet}\n sizes={cover.srcSet ? (cover.sizes ?? \"(max-width: 34rem) 60vw, 26rem\") : undefined}\n width={cover.width}\n height={cover.height}\n alt=\"\"\n loading={index < EAGER_COVERS ? \"eager\" : \"lazy\"}\n decoding=\"async\"\n />\n </TapedPhoto>\n );\n}\n\n/** One ruled row: number in the margin, the title as the link (its hit area the whole row), an aside on the right. */\nfunction ChapterRow({\n number,\n title,\n href,\n aside,\n mark,\n detail,\n current,\n rel,\n linkAs,\n}: Readonly<{\n number?: React.ReactNode;\n title: React.ReactNode;\n href: string;\n aside?: React.ReactNode;\n mark?: React.ReactNode;\n detail?: React.ReactNode;\n current?: boolean;\n rel?: string;\n linkAs?: LinkComponent;\n}>) {\n return (\n <>\n <span className=\"kz-chapter-no\">{number}</span>\n <BlockLink href={href} linkAs={linkAs} rel={rel} className=\"kz-chapter-link\" aria-current={current ? \"page\" : undefined}>\n <span className=\"kz-chapter-title\">{title}</span>\n {mark && (\n <>\n {\" \"}\n <span className=\"kz-chapter-new\">{mark}</span>\n </>\n )}\n </BlockLink>\n {aside && (\n <>\n {/* A space, not a margin: in a narrow column the period runs on after the title, and starts flush when it wraps. */}{\" \"}\n <span className=\"kz-chapter-period\">{aside}</span>\n </>\n )}\n {detail && <span className=\"kz-chapter-detail\">{detail}</span>}\n </>\n );\n}\n\nexport type ChapterIndexProps = Omit<React.OlHTMLAttributes<HTMLOListElement>, \"children\"> & {\n /** The chapters, in reading order. */\n chapters: readonly ChapterEntry[];\n /** The word of the latest chapter's mark. @default \"New\" */\n newLabel?: React.ReactNode;\n /** The accessible name of the list, when no heading names it (`aria-labelledby`). */\n label?: string;\n /** The ruling under the rows. `false` when the page is ruled already and the list starts on its module. @default \"lines\" */\n paper?: ChapterPaper;\n /** The app's router link (Next's `Link`), so internal chapters prefetch. */\n linkAs?: LinkComponent;\n /**\n * `lines` — one ruled line per chapter (the compact index); `album` — each chapter's `cover` as a taped print beside\n * its title, its `detail` (one short line) and its period, the rows alternating left and right.\n * @default \"lines\"\n */\n variant?: \"lines\" | \"album\";\n};\n\n/** The chapters of a story as a sober timeline: one ruled line each (or a taped print each), the number in the margin, the title the link. */\nexport function ChapterIndex({ chapters, newLabel = \"New\", label, paper = \"lines\", linkAs, variant = \"lines\", className, ...props }: ChapterIndexProps) {\n const album = variant === \"album\";\n return (\n // `role=\"list\"`: a list without bullets is still a list to VoiceOver.\n <ol\n role=\"list\"\n aria-label={label}\n data-paper={paper || undefined}\n data-margin=\"\"\n data-variant={album ? \"album\" : undefined}\n className={cn(\"kz-chapters\", className)}\n {...props}\n >\n {chapters.map((c, i) => (\n <li key={c.href} className=\"kz-chapter-row\" data-new={c.isNew ? \"\" : undefined} data-detail={c.detail ? \"\" : undefined}>\n {album && c.cover && <ChapterPrint cover={c.cover} index={i} />}\n <ChapterRow number={c.number} title={c.title} href={c.href} aside={c.period} mark={c.isNew ? newLabel : undefined} detail={c.detail} current={c.current} linkAs={linkAs} />\n </li>\n ))}\n </ol>\n );\n}\n\nexport type ChapterHeadProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The chapter's number, hung in the margin: `01`, `Chapitre 1`. */\n number: React.ReactNode;\n /** The title: the page's `h1`. */\n title: React.ReactNode;\n /** When it happened: `janv. – mars 2026`. */\n period?: React.ReactNode;\n /** How long it reads: `8 min`. */\n readingTime?: React.ReactNode;\n /** What was faced: the first half of the standfirst. */\n faced?: React.ReactNode;\n /** What was built: its second half, after the arrow. */\n built?: React.ReactNode;\n /** The words a screen reader says before each half (the arrow is drawn, not read): `[\"What I faced\", \"What we built\"]`. */\n versusLabels?: readonly [string, string];\n /** The level of the title. @default 1 */\n level?: 1 | 2;\n};\n\n/** The head of a chapter: the number in the margin, the title, the period and the reading time, the standfirst once. */\nexport function ChapterHead({ number, title, period, readingTime, faced, built, versusLabels, level = 1, className, children, ...props }: ChapterHeadProps) {\n const H = level === 1 ? \"h1\" : \"h2\";\n const meta = [\n { key: \"period\", value: period },\n { key: \"readingTime\", value: readingTime },\n ].filter((m) => m.value !== undefined && m.value !== null && m.value !== \"\");\n return (\n <header data-margin=\"\" className={cn(\"kz-chapter-head\", className)} {...props}>\n <p className=\"kz-chapter-no\">{number}</p>\n <H className=\"kz-chapter-head-title\">{title}</H>\n {meta.length > 0 && (\n <p className=\"kz-chapter-meta\">\n {meta.map((m, i) => (\n <span key={m.key}>\n {i > 0 && <span aria-hidden> · </span>}\n {m.value}\n </span>\n ))}\n </p>\n )}\n {faced && built && (\n <p className=\"kz-chapter-standfirst\">\n {versusLabels && <span className=\"kz-sr-only\">{versusLabels[0]}, </span>}\n {faced}\n <span className=\"kz-chapter-arrow\" aria-hidden>\n {\" → \"}\n </span>\n {versusLabels && <span className=\"kz-sr-only\">; {versusLabels[1]}, </span>}\n {built}\n </p>\n )}\n {children}\n </header>\n );\n}\n\nexport interface ChapterLink {\n /** Its number, in the margin: `02`. */\n number?: React.ReactNode;\n /** Its title, the link. */\n title: React.ReactNode;\n /** Where it leads. */\n href: string;\n}\n\nexport type ChapterFootProps = Omit<React.HTMLAttributes<HTMLElement>, \"children\"> & {\n /** The chapter before this one (none on the first). */\n previous?: ChapterLink;\n /** The chapter after this one (none on the latest). */\n next?: ChapterLink;\n /** The line back to the story: `{ href: \"/\", label: \"Back to the story\" }`. */\n back?: { href: string; label: React.ReactNode };\n /** The quiet words beside each link. @default { previous: \"Previous\", next: \"Next\" } */\n labels?: { previous: React.ReactNode; next: React.ReactNode };\n /** The accessible name of the navigation. @default \"Chapters\" */\n label?: string;\n /** The ruling under the links. @default \"lines\" */\n paper?: ChapterPaper;\n /** The app's router link (Next's `Link`). */\n linkAs?: LinkComponent;\n};\n\n/** The foot of a chapter: the previous and the next on the ruled lines, then one line back to the story. */\nexport function ChapterFoot({\n previous,\n next,\n back,\n labels = { previous: \"Previous\", next: \"Next\" },\n label = \"Chapters\",\n paper = \"lines\",\n linkAs,\n className,\n ...props\n}: ChapterFootProps) {\n return (\n <nav aria-label={label} data-paper={paper || undefined} data-margin=\"\" className={cn(\"kz-chapters kz-chapter-foot\", className)} {...props}>\n <ul role=\"list\">\n {previous && (\n <li className=\"kz-chapter-row\" data-dir=\"previous\">\n <ChapterRow\n number={previous.number}\n title={previous.title}\n href={previous.href}\n rel=\"prev\"\n linkAs={linkAs}\n aside={\n <>\n <span aria-hidden>← </span>\n {labels.previous}\n </>\n }\n />\n </li>\n )}\n {next && (\n <li className=\"kz-chapter-row\" data-dir=\"next\">\n <ChapterRow\n number={next.number}\n title={next.title}\n href={next.href}\n rel=\"next\"\n linkAs={linkAs}\n aside={\n <>\n {labels.next}\n <span aria-hidden> →</span>\n </>\n }\n />\n </li>\n )}\n </ul>\n {back && (\n <p className=\"kz-chapter-back\">\n <BlockLink href={back.href} linkAs={linkAs} className=\"kz-chapter-back-link\">\n <span aria-hidden>↩ </span>\n {back.label}\n </BlockLink>\n </p>\n )}\n </nav>\n );\n}\n"
320
+ "content": "// Server-safe. The chapters of a story on the Cahier (ADR-004, blocks.css, krizaka-ui#617): a sober timeline, never a\n// stack of boxes. The rows sit on the notebook's ruled lines (`data-paper=\"lines\"`, the ruling of `Page`), the number\n// hangs in the margin beside its red rule (`data-margin`), the serif title is the link, the period is quiet.\n// - `ChapterIndex` — the chapters in reading order, one ruled line each (two at most), the latest marked « New »;\n// - `ChapterHead` — the head of a chapter's page: number in the margin, title, one quiet meta line, the standfirst;\n// - `ChapterFoot` — its foot: the previous and next chapters on the lines, then one line back to the story.\n// No border per row, no card, no button: the paper carries the rhythm. Every word arrives as a prop.\n// `ChapterIndex variant=\"album\"` (#621): each row is the chapter's cover as a `TapedPhoto`, the prints facing each other\n// from left to right, and beside it the same number, title, line and period — light, on the same lines.\nimport type * as React from \"react\";\n\nimport { BlockLink, type LinkComponent } from \"../block-link\";\nimport { cn } from \"../cn\";\nimport { TapedPhoto } from \"../taped-photo\";\n\n/** The notebook under the rows: `lines` (the ruling of `Page`, aligned on the rows) or `false` (the page's own paper). */\ntype ChapterPaper = \"lines\" | false;\n\nexport interface ChapterEntry {\n /** Its number, hung in the margin: `01`, `§ 1`. */\n number: React.ReactNode;\n /** The title, in the serif: the link. */\n title: React.ReactNode;\n /** Where it leads. */\n href: string;\n /** When it happened, quiet on the right (under the title on a phone): `janv. – mars 2026`, or a `<time>`. */\n period?: React.ReactNode;\n /** One more line under the title (what was faced → what was built). Off unless given: the chapter's page says it. */\n detail?: React.ReactNode;\n /** The latest chapter: a small mark after the title, in the hue (`newLabel`). */\n isNew?: boolean;\n /** The page the reader is on. */\n current?: boolean;\n /** Its cover, drawn by the `album` variant as a taped print. Decorative there (`alt=\"\"`): the title carries the link. */\n cover?: ChapterCover;\n}\n\n/** A chapter's cover: its intrinsic size gives the print its aspect-ratio, so nothing shifts while it loads. */\nexport interface ChapterCover {\n src: string;\n width: number;\n height: number;\n srcSet?: string;\n /** @default \"(max-width: 34rem) 60vw, 26rem\" */\n sizes?: string;\n}\n\n/** The covers above the fold load at once; the rest wait for the reader. */\nconst EAGER_COVERS = 2;\n/** The prints face each other: the left one leans left, the right one leans right (TapedPhoto's practice). */\nconst ALBUM_TILT = 1.4;\n\nfunction ChapterPrint({ cover, index }: Readonly<{ cover: ChapterCover; index: number }>) {\n return (\n <TapedPhoto className=\"kz-chapter-print\" tilt={index % 2 === 0 ? -ALBUM_TILT : ALBUM_TILT} aria-hidden>\n <img\n src={cover.src}\n srcSet={cover.srcSet}\n sizes={cover.srcSet ? (cover.sizes ?? \"(max-width: 34rem) 60vw, 26rem\") : undefined}\n width={cover.width}\n height={cover.height}\n alt=\"\"\n loading={index < EAGER_COVERS ? \"eager\" : \"lazy\"}\n decoding=\"async\"\n />\n </TapedPhoto>\n );\n}\n\n/** One ruled row: number in the margin, the title as the link (its hit area the whole row), an aside on the right. */\nfunction ChapterRow({\n number,\n title,\n href,\n aside,\n mark,\n detail,\n current,\n rel,\n linkAs,\n}: Readonly<{\n number?: React.ReactNode;\n title: React.ReactNode;\n href: string;\n aside?: React.ReactNode;\n mark?: React.ReactNode;\n detail?: React.ReactNode;\n current?: boolean;\n rel?: string;\n linkAs?: LinkComponent;\n}>) {\n return (\n <>\n <span className=\"kz-chapter-no\">{number}</span>\n <BlockLink href={href} linkAs={linkAs} rel={rel} className=\"kz-chapter-link\" aria-current={current ? \"page\" : undefined}>\n <span className=\"kz-chapter-title\">{title}</span>\n {mark && (\n <>\n {\" \"}\n <span className=\"kz-chapter-new\">{mark}</span>\n </>\n )}\n </BlockLink>\n {aside && (\n <>\n {/* A space, not a margin: in a narrow column the period runs on after the title, and starts flush when it wraps. */}{\" \"}\n <span className=\"kz-chapter-period\">{aside}</span>\n </>\n )}\n {detail && <span className=\"kz-chapter-detail\">{detail}</span>}\n </>\n );\n}\n\nexport type ChapterIndexProps = Omit<React.OlHTMLAttributes<HTMLOListElement>, \"children\"> & {\n /** The chapters, in reading order. */\n chapters: readonly ChapterEntry[];\n /** The word of the latest chapter's mark. @default \"New\" */\n newLabel?: React.ReactNode;\n /** The accessible name of the list, when no heading names it (`aria-labelledby`). */\n label?: string;\n /** The ruling under the rows. `false` when the page is ruled already and the list starts on its module. @default \"lines\" */\n paper?: ChapterPaper;\n /** The app's router link (Next's `Link`), so internal chapters prefetch. */\n linkAs?: LinkComponent;\n /**\n * `lines` — one ruled line per chapter (the compact index); `album` — each chapter's `cover` as a taped print beside\n * its title, its `detail` (one short line) and its period, the rows alternating left and right.\n * @default \"lines\"\n */\n variant?: \"lines\" | \"album\";\n};\n\n/** The chapters of a story as a sober timeline: one ruled line each (or a taped print each), the number in the margin, the title the link. */\nexport function ChapterIndex({ chapters, newLabel = \"New\", label, paper = \"lines\", linkAs, variant = \"lines\", className, ...props }: Readonly<ChapterIndexProps>) {\n const album = variant === \"album\";\n return (\n // `role=\"list\"`: a list without bullets is still a list to VoiceOver.\n <ol\n role=\"list\"\n aria-label={label}\n data-paper={paper || undefined}\n data-margin=\"\"\n data-variant={album ? \"album\" : undefined}\n className={cn(\"kz-chapters\", className)}\n {...props}\n >\n {chapters.map((c, i) => (\n <li key={c.href} className=\"kz-chapter-row\" data-new={c.isNew ? \"\" : undefined} data-detail={c.detail ? \"\" : undefined}>\n {album && c.cover && <ChapterPrint cover={c.cover} index={i} />}\n <ChapterRow number={c.number} title={c.title} href={c.href} aside={c.period} mark={c.isNew ? newLabel : undefined} detail={c.detail} current={c.current} linkAs={linkAs} />\n </li>\n ))}\n </ol>\n );\n}\n\nexport type ChapterHeadProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The chapter's number, hung in the margin: `01`, `Chapitre 1`. */\n number: React.ReactNode;\n /** The title: the page's `h1`. */\n title: React.ReactNode;\n /** When it happened: `janv. – mars 2026`. */\n period?: React.ReactNode;\n /** How long it reads: `8 min`. */\n readingTime?: React.ReactNode;\n /** What was faced: the first half of the standfirst. */\n faced?: React.ReactNode;\n /** What was built: its second half, after the arrow. */\n built?: React.ReactNode;\n /** The words a screen reader says before each half (the arrow is drawn, not read): `[\"What I faced\", \"What we built\"]`. */\n versusLabels?: readonly [string, string];\n /** The level of the title. @default 1 */\n level?: 1 | 2;\n};\n\n/** The head of a chapter: the number in the margin, the title, the period and the reading time, the standfirst once. */\nexport function ChapterHead({ number, title, period, readingTime, faced, built, versusLabels, level = 1, className, children, ...props }: Readonly<ChapterHeadProps>) {\n const H = level === 1 ? \"h1\" : \"h2\";\n const meta = [\n { key: \"period\", value: period },\n { key: \"readingTime\", value: readingTime },\n ].filter((m) => m.value !== undefined && m.value !== null && m.value !== \"\");\n return (\n <header data-margin=\"\" className={cn(\"kz-chapter-head\", className)} {...props}>\n <p className=\"kz-chapter-no\">{number}</p>\n <H className=\"kz-chapter-head-title\">{title}</H>\n {meta.length > 0 && (\n <p className=\"kz-chapter-meta\">\n {meta.map((m, i) => (\n <span key={m.key}>\n {i > 0 && <span aria-hidden> · </span>}\n {m.value}\n </span>\n ))}\n </p>\n )}\n {faced && built && (\n <p className=\"kz-chapter-standfirst\">\n {versusLabels && <span className=\"kz-sr-only\">{versusLabels[0]}, </span>}\n {faced}\n <span className=\"kz-chapter-arrow\" aria-hidden>\n {\" → \"}\n </span>\n {versusLabels && <span className=\"kz-sr-only\">; {versusLabels[1]}, </span>}\n {built}\n </p>\n )}\n {children}\n </header>\n );\n}\n\nexport interface ChapterLink {\n /** Its number, in the margin: `02`. */\n number?: React.ReactNode;\n /** Its title, the link. */\n title: React.ReactNode;\n /** Where it leads. */\n href: string;\n}\n\nexport type ChapterFootProps = Omit<React.HTMLAttributes<HTMLElement>, \"children\"> & {\n /** The chapter before this one (none on the first). */\n previous?: ChapterLink;\n /** The chapter after this one (none on the latest). */\n next?: ChapterLink;\n /** The line back to the story: `{ href: \"/\", label: \"Back to the story\" }`. */\n back?: { href: string; label: React.ReactNode };\n /** The quiet words beside each link. @default { previous: \"Previous\", next: \"Next\" } */\n labels?: { previous: React.ReactNode; next: React.ReactNode };\n /** The accessible name of the navigation. @default \"Chapters\" */\n label?: string;\n /** The ruling under the links. @default \"lines\" */\n paper?: ChapterPaper;\n /** The app's router link (Next's `Link`). */\n linkAs?: LinkComponent;\n};\n\n/** The foot of a chapter: the previous and the next on the ruled lines, then one line back to the story. */\nexport function ChapterFoot({\n previous,\n next,\n back,\n labels = { previous: \"Previous\", next: \"Next\" },\n label = \"Chapters\",\n paper = \"lines\",\n linkAs,\n className,\n ...props\n}: Readonly<ChapterFootProps>) {\n return (\n <nav aria-label={label} data-paper={paper || undefined} data-margin=\"\" className={cn(\"kz-chapters kz-chapter-foot\", className)} {...props}>\n <ul role=\"list\">\n {previous && (\n <li className=\"kz-chapter-row\" data-dir=\"previous\">\n <ChapterRow\n number={previous.number}\n title={previous.title}\n href={previous.href}\n rel=\"prev\"\n linkAs={linkAs}\n aside={\n <>\n <span aria-hidden>← </span>\n {labels.previous}\n </>\n }\n />\n </li>\n )}\n {next && (\n <li className=\"kz-chapter-row\" data-dir=\"next\">\n <ChapterRow\n number={next.number}\n title={next.title}\n href={next.href}\n rel=\"next\"\n linkAs={linkAs}\n aside={\n <>\n {labels.next}\n <span aria-hidden> →</span>\n </>\n }\n />\n </li>\n )}\n </ul>\n {back && (\n <p className=\"kz-chapter-back\">\n <BlockLink href={back.href} linkAs={linkAs} className=\"kz-chapter-back-link\">\n <span aria-hidden>↩ </span>\n {back.label}\n </BlockLink>\n </p>\n )}\n </nav>\n );\n}\n"
321
321
  },
322
322
  {
323
323
  "path": "chapter/index.ts",
@@ -329,7 +329,7 @@
329
329
  },
330
330
  {
331
331
  "path": "meta.ts",
332
- "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-frame\"\n | \"desktop-window\"\n | \"form-flow\"\n | \"grid\"\n | \"list-detail\"\n | \"state-screen\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\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 | \"columns\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"copy-button\"\n | \"money-input\"\n | \"price-catalogue-editor\"\n | \"promo-code-field\"\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 | \"image-cropper\"\n | \"image-viewer\"\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 | \"waveform\"\n | \"proposal\"\n | \"qr-code\"\n | \"identity-card\"\n | \"entity-header\"\n | \"collection-switcher\"\n | \"marketing-layout\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\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 | \"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 | \"shop-gallery\"\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 | \"shop\"\n | \"shop-composer\"\n | \"schema-form\"\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 Sovkora 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 * `experimental`: created for a filed need (ADR-008 §4), it may change or go in any minor until its first consumer imports it; `adoption`\n * names that consumer's issue. `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 = \"experimental\" | \"stable\" | \"beta\" | \"deprecated\";\n\n/**\n * What a component is for (ADR-008 §3): the thirteen domains the documentation, the size budgets and the guards are\n * organised by. The domain is metadata: the entries stay flat (`@krizaka/ui/<name>`). `cahier` is the sites' register\n * (ADR-004): a product never imports it.\n */\nexport type Domain =\n | \"foundations\"\n | \"forms\"\n | \"data-display\"\n | \"navigation-shell\"\n | \"feedback\"\n | \"maps\"\n | \"media\"\n | \"commerce\"\n | \"identity\"\n | \"abuse\"\n | \"conversation\"\n | \"page-blocks\"\n | \"cahier\";\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 /** What it is for: one of the twelve domains (ADR-008 §3). */\n readonly domain: Domain;\n /** The `<repo>#<n>` issue of its first consumer: required for, and only for, an `experimental` component. */\n readonly adoption?: string;\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"
332
+ "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 | \"architecture-diagram\"\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-frame\"\n | \"desktop-window\"\n | \"form-flow\"\n | \"grid\"\n | \"list-detail\"\n | \"state-screen\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\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 | \"columns\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"copy-button\"\n | \"money-input\"\n | \"price-catalogue-editor\"\n | \"promo-code-field\"\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 | \"image-cropper\"\n | \"image-viewer\"\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 | \"waveform\"\n | \"proposal\"\n | \"qr-code\"\n | \"identity-card\"\n | \"entity-header\"\n | \"collection-switcher\"\n | \"marketing-layout\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\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 | \"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 | \"shop-gallery\"\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 | \"shop\"\n | \"shop-composer\"\n | \"schema-form\"\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 Sovkora 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 * `experimental`: created for a filed need (ADR-008 §4), it may change or go in any minor until its first consumer imports it; `adoption`\n * names that consumer's issue. `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 = \"experimental\" | \"stable\" | \"beta\" | \"deprecated\";\n\n/**\n * What a component is for (ADR-008 §3): the thirteen domains the documentation, the size budgets and the guards are\n * organised by. The domain is metadata: the entries stay flat (`@krizaka/ui/<name>`). `cahier` is the sites' register\n * (ADR-004): a product never imports it.\n */\nexport type Domain =\n | \"foundations\"\n | \"forms\"\n | \"data-display\"\n | \"navigation-shell\"\n | \"feedback\"\n | \"maps\"\n | \"media\"\n | \"commerce\"\n | \"identity\"\n | \"abuse\"\n | \"conversation\"\n | \"page-blocks\"\n | \"cahier\";\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 /** What it is for: one of the twelve domains (ADR-008 §3). */\n readonly domain: Domain;\n /** The `<repo>#<n>` issue of its first consumer: required for, and only for, an `experimental` component. */\n readonly adoption?: string;\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"
333
333
  }
334
334
  ],
335
335
  "dependencies": [],