@krizaka/ui 4.7.0 → 4.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (965) 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 +1 -1
  34. package/dist/architecture-diagram.js.map +1 -1
  35. package/dist/argument-card.d.ts +2 -2
  36. package/dist/argument-card.js +6 -6
  37. package/dist/argument-card.js.map +1 -1
  38. package/dist/auth-layout.d.ts +1 -1
  39. package/dist/auth-layout.js.map +1 -1
  40. package/dist/avatar.d.ts +2 -2
  41. package/dist/avatar.js.map +1 -1
  42. package/dist/badge.d.ts +1 -1
  43. package/dist/badge.js +1 -1
  44. package/dist/bird-plate.d.ts +1 -1
  45. package/dist/bird-plate.js +2 -2
  46. package/dist/bird-plate.js.map +1 -1
  47. package/dist/button/text-link.d.ts +8 -0
  48. package/dist/button/text-link.js +6 -0
  49. package/dist/button/text-link.js.map +1 -0
  50. package/dist/button.d.ts +2 -2
  51. package/dist/button.js +3 -3
  52. package/dist/captcha.d.ts +2 -2
  53. package/dist/captcha.js +3 -3
  54. package/dist/captcha.js.map +1 -1
  55. package/dist/card-grid.d.ts +1 -1
  56. package/dist/card-grid.js +1 -1
  57. package/dist/card-grid.js.map +1 -1
  58. package/dist/card.d.ts +9 -9
  59. package/dist/card.js +1 -1
  60. package/dist/card.js.map +1 -1
  61. package/dist/catalogue-page.d.ts +2 -2
  62. package/dist/catalogue-page.js.map +1 -1
  63. package/dist/changelog-page.d.ts +1 -1
  64. package/dist/changelog-page.js +2 -2
  65. package/dist/changelog-page.js.map +1 -1
  66. package/dist/chapter.d.ts +3 -3
  67. package/dist/chapter.js +2 -2
  68. package/dist/chapter.js.map +1 -1
  69. package/dist/chat.d.ts +3 -3
  70. package/dist/chat.js +1 -1
  71. package/dist/chat.js.map +1 -1
  72. package/dist/checkbox.d.ts +1 -1
  73. package/dist/checkbox.js.map +1 -1
  74. package/dist/chip-link.d.ts +1 -1
  75. package/dist/chip-link.js +1 -1
  76. package/dist/chip-row.d.ts +2 -2
  77. package/dist/chip-row.js +1 -1
  78. package/dist/chip-row.js.map +1 -1
  79. package/dist/chip.d.ts +4 -5
  80. package/dist/chip.js +2 -2
  81. package/dist/choice-grid.d.ts +1 -1
  82. package/dist/choice-grid.js +2 -2
  83. package/dist/choice-grid.js.map +1 -1
  84. package/dist/{chunk-S6NYGOJT.js → chunk-22IORLB5.js} +1 -1
  85. package/dist/chunk-22IORLB5.js.map +1 -0
  86. package/dist/{chunk-QA3WETWT.js → chunk-2P7Y3LNN.js} +1 -1
  87. package/dist/chunk-2P7Y3LNN.js.map +1 -0
  88. package/dist/{chunk-OGWB76BR.js → chunk-3CEMOJBL.js} +2 -2
  89. package/dist/chunk-3CEMOJBL.js.map +1 -0
  90. package/dist/{chunk-WC3SO4CE.js → chunk-3SWWUJJL.js} +2 -2
  91. package/dist/chunk-3SWWUJJL.js.map +1 -0
  92. package/dist/{chunk-S2O4NSN5.js → chunk-3TCHVNNB.js} +1 -1
  93. package/dist/chunk-3TCHVNNB.js.map +1 -0
  94. package/dist/{chunk-7P7I5OQV.js → chunk-5KBYZLU4.js} +2 -2
  95. package/dist/chunk-5KBYZLU4.js.map +1 -0
  96. package/dist/{chunk-WKQ5CB3I.js → chunk-6ARAO3TR.js} +1 -1
  97. package/dist/{chunk-WKQ5CB3I.js.map → chunk-6ARAO3TR.js.map} +1 -1
  98. package/dist/{chunk-QHVV2JGF.js → chunk-6LF6IZZM.js} +2 -2
  99. package/dist/chunk-6LF6IZZM.js.map +1 -0
  100. package/dist/{chunk-HP7BDMVK.js → chunk-7B5Q76JR.js} +2 -2
  101. package/dist/chunk-7B5Q76JR.js.map +1 -0
  102. package/dist/{chunk-F2UZ2WWL.js → chunk-7KIIAOQH.js} +1 -1
  103. package/dist/{chunk-F2UZ2WWL.js.map → chunk-7KIIAOQH.js.map} +1 -1
  104. package/dist/{chunk-ADRUEPYC.js → chunk-7MA3UODW.js} +2 -2
  105. package/dist/{chunk-ADRUEPYC.js.map → chunk-7MA3UODW.js.map} +1 -1
  106. package/dist/{chunk-KH3JOEPY.js → chunk-7PVLEALV.js} +1 -1
  107. package/dist/chunk-7PVLEALV.js.map +1 -0
  108. package/dist/{chunk-QVHSV6RA.js → chunk-7UBLUGNW.js} +1 -1
  109. package/dist/chunk-7UBLUGNW.js.map +1 -0
  110. package/dist/{chunk-YTYNKMNS.js → chunk-BKMHN4UA.js} +5 -5
  111. package/dist/chunk-BKMHN4UA.js.map +1 -0
  112. package/dist/{chunk-4QH6CP2Y.js → chunk-BRYRZWLV.js} +1 -1
  113. package/dist/{chunk-4QH6CP2Y.js.map → chunk-BRYRZWLV.js.map} +1 -1
  114. package/dist/{chunk-43PTCDTL.js → chunk-BVN7JFOP.js} +1 -1
  115. package/dist/chunk-BVN7JFOP.js.map +1 -0
  116. package/dist/{chunk-5RWHDX5J.js → chunk-BYKA3FHX.js} +2 -2
  117. package/dist/chunk-BYKA3FHX.js.map +1 -0
  118. package/dist/{chunk-5PFCELGW.js → chunk-DIOAQOR5.js} +1 -1
  119. package/dist/chunk-DIOAQOR5.js.map +1 -0
  120. package/dist/{chunk-HJFRHYCI.js → chunk-DTGRZXYO.js} +2 -2
  121. package/dist/{chunk-P7AFIKWG.js → chunk-DVC4YQI2.js} +2 -2
  122. package/dist/chunk-DVC4YQI2.js.map +1 -0
  123. package/dist/{chunk-V5RO6JYI.js → chunk-E3LFHTUV.js} +2 -2
  124. package/dist/chunk-E3LFHTUV.js.map +1 -0
  125. package/dist/{chunk-WEVYKZIF.js → chunk-EAXIDRMB.js} +1 -1
  126. package/dist/chunk-EAXIDRMB.js.map +1 -0
  127. package/dist/{chunk-WU4VLSEA.js → chunk-EYMS6VRF.js} +1 -1
  128. package/dist/chunk-EYMS6VRF.js.map +1 -0
  129. package/dist/{chunk-LH5J3VLZ.js → chunk-F7EJZV53.js} +1 -1
  130. package/dist/chunk-F7EJZV53.js.map +1 -0
  131. package/dist/{chunk-VPO27AFS.js → chunk-G3L7AKZJ.js} +1 -1
  132. package/dist/chunk-G3L7AKZJ.js.map +1 -0
  133. package/dist/{chunk-EB45EVPJ.js → chunk-G5NROYGK.js} +3 -3
  134. package/dist/chunk-G5NROYGK.js.map +1 -0
  135. package/dist/{chunk-HKEAYSFS.js → chunk-GQMINKT3.js} +1 -1
  136. package/dist/{chunk-ENOS6ETI.js.map → chunk-GQMINKT3.js.map} +1 -1
  137. package/dist/{chunk-3X3OF4TI.js → chunk-H4NXYAL7.js} +1 -1
  138. package/dist/{chunk-3X3OF4TI.js.map → chunk-H4NXYAL7.js.map} +1 -1
  139. package/dist/{chunk-KR2W4ONJ.js → chunk-H7I6YLI6.js} +1 -1
  140. package/dist/chunk-H7I6YLI6.js.map +1 -0
  141. package/dist/{chunk-PJNR4NTS.js → chunk-HC2TY45B.js} +4 -4
  142. package/dist/{chunk-NSLXEDIS.js → chunk-HHBTM4AU.js} +1 -1
  143. package/dist/chunk-HHBTM4AU.js.map +1 -0
  144. package/dist/{chunk-XVRKKYWU.js → chunk-HVUR3UNK.js} +2 -2
  145. package/dist/{chunk-XVRKKYWU.js.map → chunk-HVUR3UNK.js.map} +1 -1
  146. package/dist/{chunk-V7W4RLRW.js → chunk-HWIDTLLO.js} +3 -3
  147. package/dist/chunk-HWIDTLLO.js.map +1 -0
  148. package/dist/{chunk-W675RFOA.js → chunk-ISC2QBXJ.js} +1 -1
  149. package/dist/chunk-ISC2QBXJ.js.map +1 -0
  150. package/dist/{chunk-7DYZTEE3.js → chunk-IWPB6SSW.js} +1 -1
  151. package/dist/chunk-IWPB6SSW.js.map +1 -0
  152. package/dist/{chunk-TVLRE7S3.js → chunk-JDVWUF5W.js} +2 -2
  153. package/dist/{chunk-TVLRE7S3.js.map → chunk-JDVWUF5W.js.map} +1 -1
  154. package/dist/{chunk-757ZTGU5.js → chunk-JE2NY4XE.js} +4 -4
  155. package/dist/chunk-JE2NY4XE.js.map +1 -0
  156. package/dist/{chunk-HLEBSAGC.js → chunk-KBSZ6JRF.js} +2 -2
  157. package/dist/chunk-KBSZ6JRF.js.map +1 -0
  158. package/dist/{chunk-Y3P5B4XS.js → chunk-KCU45KQ3.js} +3 -3
  159. package/dist/chunk-KCU45KQ3.js.map +1 -0
  160. package/dist/{chunk-ST5P5HNI.js → chunk-L4YBG5US.js} +4 -4
  161. package/dist/{chunk-ST5P5HNI.js.map → chunk-L4YBG5US.js.map} +1 -1
  162. package/dist/{chunk-NG6G6V5E.js → chunk-LFH3LEWR.js} +1 -1
  163. package/dist/chunk-LFH3LEWR.js.map +1 -0
  164. package/dist/{chunk-YATTFMDV.js → chunk-LSQQSJ6J.js} +2 -2
  165. package/dist/{chunk-YATTFMDV.js.map → chunk-LSQQSJ6J.js.map} +1 -1
  166. package/dist/{chunk-LNAAWT4Y.js → chunk-MJWOZ3JI.js} +1 -1
  167. package/dist/chunk-MJWOZ3JI.js.map +1 -0
  168. package/dist/{chunk-KID32IRJ.js → chunk-MXHJMTZ5.js} +1 -1
  169. package/dist/{chunk-KID32IRJ.js.map → chunk-MXHJMTZ5.js.map} +1 -1
  170. package/dist/{chunk-GHAN7OOE.js → chunk-N6LAWI4F.js} +2 -2
  171. package/dist/chunk-N6LAWI4F.js.map +1 -0
  172. package/dist/{chunk-5VZ37TY3.js → chunk-NFJWD5BT.js} +2 -2
  173. package/dist/chunk-NFJWD5BT.js.map +1 -0
  174. package/dist/{chunk-ZPOVOEO3.js → chunk-NJLIHGU4.js} +2 -2
  175. package/dist/chunk-NJLIHGU4.js.map +1 -0
  176. package/dist/{chunk-PRD7JRQX.js → chunk-ONCQWOTH.js} +4 -4
  177. package/dist/{chunk-PRD7JRQX.js.map → chunk-ONCQWOTH.js.map} +1 -1
  178. package/dist/{chunk-ENOS6ETI.js → chunk-OZC6CDZF.js} +1 -1
  179. package/dist/{chunk-HKEAYSFS.js.map → chunk-OZC6CDZF.js.map} +1 -1
  180. package/dist/{chunk-TXFX4PMN.js → chunk-OZY4C4W5.js} +1 -1
  181. package/dist/{chunk-TXFX4PMN.js.map → chunk-OZY4C4W5.js.map} +1 -1
  182. package/dist/{chunk-NPMGYLJV.js → chunk-PIRYDEX2.js} +3 -3
  183. package/dist/chunk-PIRYDEX2.js.map +1 -0
  184. package/dist/{chunk-C57KK5VB.js → chunk-PM23USOC.js} +1 -1
  185. package/dist/chunk-PM23USOC.js.map +1 -0
  186. package/dist/{chunk-PGBF3UBX.js → chunk-QKL5TECH.js} +1 -1
  187. package/dist/chunk-QKL5TECH.js.map +1 -0
  188. package/dist/{chunk-Z47KIPCT.js → chunk-QY5JEUJT.js} +1 -1
  189. package/dist/chunk-QY5JEUJT.js.map +1 -0
  190. package/dist/{chunk-FVGFPB73.js → chunk-RPVKF4RR.js} +1 -1
  191. package/dist/{chunk-FVGFPB73.js.map → chunk-RPVKF4RR.js.map} +1 -1
  192. package/dist/{chunk-NM2DEHFZ.js → chunk-RXYKJIC4.js} +1 -1
  193. package/dist/chunk-RXYKJIC4.js.map +1 -0
  194. package/dist/{chunk-W64RAX4N.js → chunk-TKYNYIJS.js} +5 -5
  195. package/dist/chunk-TKYNYIJS.js.map +1 -0
  196. package/dist/{chunk-S4TLZRGZ.js → chunk-UMXWOA3I.js} +1 -1
  197. package/dist/chunk-UMXWOA3I.js.map +1 -0
  198. package/dist/{chunk-VA4NPCUQ.js → chunk-VD7QFUAP.js} +3 -3
  199. package/dist/chunk-VD7QFUAP.js.map +1 -0
  200. package/dist/{chunk-MDSP7DJR.js → chunk-VQELCPQJ.js} +5 -5
  201. package/dist/chunk-VQELCPQJ.js.map +1 -0
  202. package/dist/{chunk-2FCQCWIK.js → chunk-VXNBXW3P.js} +5 -5
  203. package/dist/chunk-VXNBXW3P.js.map +1 -0
  204. package/dist/{chunk-B47WSPMP.js → chunk-WPUDPH2Q.js} +1 -1
  205. package/dist/chunk-WPUDPH2Q.js.map +1 -0
  206. package/dist/{chunk-SG2RKUVJ.js → chunk-WTZUMVJI.js} +5 -5
  207. package/dist/chunk-WTZUMVJI.js.map +1 -0
  208. package/dist/{chunk-EDQLPCM4.js → chunk-WVZF6WK3.js} +2 -2
  209. package/dist/chunk-WVZF6WK3.js.map +1 -0
  210. package/dist/{chunk-5D7NMUF6.js → chunk-XDAETKWM.js} +2 -2
  211. package/dist/chunk-XDAETKWM.js.map +1 -0
  212. package/dist/{chunk-QD6SNXF5.js → chunk-XDWSGNL4.js} +3 -3
  213. package/dist/chunk-XDWSGNL4.js.map +1 -0
  214. package/dist/{chunk-SB5WSVPI.js → chunk-ZFH2BYXW.js} +2 -2
  215. package/dist/chunk-ZFH2BYXW.js.map +1 -0
  216. package/dist/{chunk-XVLWVTQA.js → chunk-ZI7K742O.js} +1 -1
  217. package/dist/{chunk-XVLWVTQA.js.map → chunk-ZI7K742O.js.map} +1 -1
  218. package/dist/{chunk-NQENOT6L.js → chunk-ZRRWSKV3.js} +8 -8
  219. package/dist/chunk-ZRRWSKV3.js.map +1 -0
  220. package/dist/cn.js +1 -1
  221. package/dist/code-block.d.ts +2 -2
  222. package/dist/code-block.js +2 -2
  223. package/dist/code-block.js.map +1 -1
  224. package/dist/collection-switcher.d.ts +1 -1
  225. package/dist/collection-switcher.js +1 -1
  226. package/dist/collection-switcher.js.map +1 -1
  227. package/dist/columns.d.ts +2 -2
  228. package/dist/columns.js.map +1 -1
  229. package/dist/combobox.js +4 -4
  230. package/dist/command.d.ts +10 -10
  231. package/dist/command.js +4 -4
  232. package/dist/command.js.map +1 -1
  233. package/dist/comparison-table.d.ts +1 -1
  234. package/dist/comparison-table.js +1 -1
  235. package/dist/comparison-table.js.map +1 -1
  236. package/dist/component-page.d.ts +1 -1
  237. package/dist/component-page.js.map +1 -1
  238. package/dist/confirm-button.d.ts +1 -1
  239. package/dist/confirm-button.js +4 -4
  240. package/dist/contact-page.d.ts +1 -1
  241. package/dist/contact-page.js.map +1 -1
  242. package/dist/continue-prompt.d.ts +1 -1
  243. package/dist/continue-prompt.js +1 -1
  244. package/dist/continue-prompt.js.map +1 -1
  245. package/dist/copy-button.d.ts +1 -1
  246. package/dist/copy-button.js +4 -4
  247. package/dist/copy-button.js.map +1 -1
  248. package/dist/countdown.d.ts +1 -1
  249. package/dist/countdown.js.map +1 -1
  250. package/dist/cover-hero.d.ts +1 -1
  251. package/dist/cover-hero.js +5 -5
  252. package/dist/cover-hero.js.map +1 -1
  253. package/dist/cta-panel.d.ts +1 -1
  254. package/dist/cta-panel.js +1 -1
  255. package/dist/cta-panel.js.map +1 -1
  256. package/dist/dashboard-layout.d.ts +2 -2
  257. package/dist/dashboard-layout.js.map +1 -1
  258. package/dist/data-table.d.ts +5 -5
  259. package/dist/data-table.js +9 -9
  260. package/dist/date-picker.d.ts +11 -11
  261. package/dist/date-picker.js +5 -5
  262. package/dist/date-picker.js.map +1 -1
  263. package/dist/decision-list.d.ts +1 -1
  264. package/dist/decision-list.js +2 -2
  265. package/dist/decision-list.js.map +1 -1
  266. package/dist/description-list.d.ts +2 -2
  267. package/dist/description-list.js.map +1 -1
  268. package/dist/detail-layout.d.ts +5 -5
  269. package/dist/detail-layout.js +1 -1
  270. package/dist/detail-layout.js.map +1 -1
  271. package/dist/{dialog-DpUwec2g.d.ts → dialog-CFnxFGyn.d.ts} +7 -7
  272. package/dist/dialog.d.ts +2 -2
  273. package/dist/dialog.js +4 -4
  274. package/dist/dialog.js.map +1 -1
  275. package/dist/docs-article-page.d.ts +1 -1
  276. package/dist/docs-article-page.js.map +1 -1
  277. package/dist/docs-hub-page.d.ts +1 -1
  278. package/dist/docs-hub-page.js.map +1 -1
  279. package/dist/docs-layout.d.ts +1 -1
  280. package/dist/docs-layout.js +1 -1
  281. package/dist/docs-layout.js.map +1 -1
  282. package/dist/docs-nav.d.ts +1 -1
  283. package/dist/docs-nav.js +1 -1
  284. package/dist/docs-nav.js.map +1 -1
  285. package/dist/document-viewer.d.ts +2 -2
  286. package/dist/document-viewer.js +3 -3
  287. package/dist/document-viewer.js.map +1 -1
  288. package/dist/doodle.d.ts +1 -1
  289. package/dist/doodle.js +1 -1
  290. package/dist/doodle.js.map +1 -1
  291. package/dist/drop-overlay.d.ts +1 -1
  292. package/dist/drop-overlay.js +1 -1
  293. package/dist/drop-overlay.js.map +1 -1
  294. package/dist/dropdown-menu.d.ts +8 -8
  295. package/dist/dropdown-menu.js +2 -2
  296. package/dist/embed-facade.js +1 -1
  297. package/dist/empty-state.d.ts +1 -1
  298. package/dist/empty-state.js.map +1 -1
  299. package/dist/engine-flow.d.ts +1 -1
  300. package/dist/engine-flow.js +1 -1
  301. package/dist/engine-flow.js.map +1 -1
  302. package/dist/entity-header.d.ts +1 -1
  303. package/dist/entity-header.js +1 -1
  304. package/dist/entity-header.js.map +1 -1
  305. package/dist/environment-notice.d.ts +1 -1
  306. package/dist/environment-notice.js.map +1 -1
  307. package/dist/error-page.d.ts +1 -1
  308. package/dist/error-page.js +1 -1
  309. package/dist/error-page.js.map +1 -1
  310. package/dist/field.d.ts +3 -3
  311. package/dist/field.js +1 -1
  312. package/dist/field.js.map +1 -1
  313. package/dist/file-upload.d.ts +1 -1
  314. package/dist/file-upload.js +1 -1
  315. package/dist/file-upload.js.map +1 -1
  316. package/dist/filter-bar.d.ts +2 -2
  317. package/dist/filter-bar.js +4 -4
  318. package/dist/flock.d.ts +1 -1
  319. package/dist/flock.js +2 -2
  320. package/dist/flock.js.map +1 -1
  321. package/dist/footnote.d.ts +3 -3
  322. package/dist/footnote.js +1 -1
  323. package/dist/footnote.js.map +1 -1
  324. package/dist/force-update-screen.d.ts +1 -1
  325. package/dist/force-update-screen.js +3 -3
  326. package/dist/force-update-screen.js.map +1 -1
  327. package/dist/form/server.js.map +1 -1
  328. package/dist/form.d.ts +12 -12
  329. package/dist/form.js +4 -4
  330. package/dist/form.js.map +1 -1
  331. package/dist/{frame-CmDztC_y.d.ts → frame-D5HU_cG8.d.ts} +2 -2
  332. package/dist/gallery-page.d.ts +1 -1
  333. package/dist/gallery-page.js +1 -1
  334. package/dist/gallery-page.js.map +1 -1
  335. package/dist/genui.d.ts +2 -2
  336. package/dist/genui.js +9 -9
  337. package/dist/genui.js.map +1 -1
  338. package/dist/glossary-term.js +2 -2
  339. package/dist/glow-card.d.ts +1 -1
  340. package/dist/glow-card.js +1 -1
  341. package/dist/glow-card.js.map +1 -1
  342. package/dist/goal-gauge.d.ts +1 -1
  343. package/dist/goal-gauge.js +1 -1
  344. package/dist/goal-gauge.js.map +1 -1
  345. package/dist/grade-stamp.d.ts +1 -1
  346. package/dist/grade-stamp.js +2 -2
  347. package/dist/grade-stamp.js.map +1 -1
  348. package/dist/identity-card.d.ts +1 -1
  349. package/dist/identity-card.js +5 -5
  350. package/dist/identity-card.js.map +1 -1
  351. package/dist/image-cropper.d.ts +1 -1
  352. package/dist/image-cropper.js +3 -3
  353. package/dist/image-cropper.js.map +1 -1
  354. package/dist/index.d.ts +5 -5
  355. package/dist/index.js +2 -2
  356. package/dist/index.js.map +1 -1
  357. package/dist/kanban.d.ts +1 -1
  358. package/dist/kanban.js.map +1 -1
  359. package/dist/kbd.d.ts +1 -1
  360. package/dist/kbd.js.map +1 -1
  361. package/dist/kind-config-editor.js +8 -8
  362. package/dist/kind-config-editor.js.map +1 -1
  363. package/dist/kpi-explained.js +1 -1
  364. package/dist/kpi-explained.js.map +1 -1
  365. package/dist/landing-page.d.ts +1 -1
  366. package/dist/landing-page.js.map +1 -1
  367. package/dist/landscape.d.ts +1 -1
  368. package/dist/landscape.js +2 -2
  369. package/dist/landscape.js.map +1 -1
  370. package/dist/language-switch.d.ts +10 -10
  371. package/dist/language-switch.js +1 -1
  372. package/dist/legal-page.d.ts +1 -1
  373. package/dist/legal-page.js.map +1 -1
  374. package/dist/{lightbox-MRB2YZEP.js → lightbox-JLWASIJC.js} +4 -4
  375. package/dist/link-card.d.ts +1 -1
  376. package/dist/link-card.js +4 -4
  377. package/dist/list.d.ts +1 -1
  378. package/dist/list.js +2 -2
  379. package/dist/list.js.map +1 -1
  380. package/dist/loader.d.ts +2 -2
  381. package/dist/loader.js +1 -1
  382. package/dist/loader.js.map +1 -1
  383. package/dist/longform-page.d.ts +1 -1
  384. package/dist/longform-page.js +1 -1
  385. package/dist/longform-page.js.map +1 -1
  386. package/dist/maintenance-screen.d.ts +1 -1
  387. package/dist/maintenance-screen.js +3 -3
  388. package/dist/maintenance-screen.js.map +1 -1
  389. package/dist/map/cards.d.ts +2 -2
  390. package/dist/map/cards.js +1 -1
  391. package/dist/map/cards.js.map +1 -1
  392. package/dist/map/pin.js +1 -1
  393. package/dist/map/sheet.d.ts +1 -1
  394. package/dist/map/sheet.js +1 -1
  395. package/dist/map/sheet.js.map +1 -1
  396. package/dist/map.d.ts +11 -11
  397. package/dist/map.js +4 -4
  398. package/dist/map.js.map +1 -1
  399. package/dist/margin-layout.d.ts +2 -2
  400. package/dist/margin-layout.js.map +1 -1
  401. package/dist/markdown.d.ts +1 -1
  402. package/dist/markdown.js.map +1 -1
  403. package/dist/marketing-layout.d.ts +1 -1
  404. package/dist/marketing-layout.js.map +1 -1
  405. package/dist/mascot-quote.d.ts +1 -1
  406. package/dist/mascot-quote.js +2 -2
  407. package/dist/mascot-quote.js.map +1 -1
  408. package/dist/mascot-state.d.ts +5 -5
  409. package/dist/mascot-state.js +1 -1
  410. package/dist/mascot-state.js.map +1 -1
  411. package/dist/mascots.d.ts +2 -2
  412. package/dist/mascots.js +2 -2
  413. package/dist/mascots.js.map +1 -1
  414. package/dist/match-dialog.d.ts +1 -1
  415. package/dist/match-dialog.js +4 -4
  416. package/dist/match-dialog.js.map +1 -1
  417. package/dist/media-capture.d.ts +1 -1
  418. package/dist/media-capture.js +1 -1
  419. package/dist/media-capture.js.map +1 -1
  420. package/dist/media-carousel.js +5 -5
  421. package/dist/media-carousel.js.map +1 -1
  422. package/dist/media-gallery.d.ts +1 -1
  423. package/dist/media-gallery.js +1 -1
  424. package/dist/media-gallery.js.map +1 -1
  425. package/dist/media-player.d.ts +1 -1
  426. package/dist/media-player.js +4 -4
  427. package/dist/meter.d.ts +2 -2
  428. package/dist/meter.js +1 -1
  429. package/dist/money-input.d.ts +1 -1
  430. package/dist/money-input.js +3 -3
  431. package/dist/motion.d.ts +1 -1
  432. package/dist/motion.js +1 -1
  433. package/dist/native/form.d.ts +12 -12
  434. package/dist/native/form.js +4 -4
  435. package/dist/native/form.js.map +1 -1
  436. package/dist/native/list.d.ts +1 -1
  437. package/dist/native/list.js.map +1 -1
  438. package/dist/native/map.d.ts +4 -4
  439. package/dist/native/map.js +2 -2
  440. package/dist/native/map.js.map +1 -1
  441. package/dist/native/markdown.js.map +1 -1
  442. package/dist/native/media-capture.d.ts +1 -1
  443. package/dist/native/media-capture.js.map +1 -1
  444. package/dist/native/media-picker.d.ts +1 -1
  445. package/dist/native/media-picker.js.map +1 -1
  446. package/dist/native/vertical-video.d.ts +2 -2
  447. package/dist/native/vertical-video.js.map +1 -1
  448. package/dist/native/video-player.d.ts +1 -1
  449. package/dist/native/video-player.js.map +1 -1
  450. package/dist/native.d.ts +95 -95
  451. package/dist/native.js +13 -13
  452. package/dist/native.js.map +1 -1
  453. package/dist/nav-bar.d.ts +13 -13
  454. package/dist/nav-bar.js +5 -5
  455. package/dist/nav-bar.js.map +1 -1
  456. package/dist/notification-preferences.js +3 -3
  457. package/dist/number-ticker.d.ts +1 -1
  458. package/dist/number-ticker.js +1 -1
  459. package/dist/number-ticker.js.map +1 -1
  460. package/dist/opening-hours.d.ts +1 -1
  461. package/dist/opening-hours.js +1 -1
  462. package/dist/opening-hours.js.map +1 -1
  463. package/dist/{page-DPHDmDAQ.d.ts → page-Ufnb5TrQ.d.ts} +5 -5
  464. package/dist/page-header.d.ts +1 -1
  465. package/dist/page-header.js.map +1 -1
  466. package/dist/page-hero.d.ts +1 -1
  467. package/dist/page-hero.js +5 -5
  468. package/dist/page-hero.js.map +1 -1
  469. package/dist/page-index.d.ts +1 -1
  470. package/dist/page-index.js +2 -2
  471. package/dist/page-index.js.map +1 -1
  472. package/dist/page.d.ts +1 -1
  473. package/dist/page.js +3 -3
  474. package/dist/pagination.d.ts +1 -1
  475. package/dist/pagination.js +1 -1
  476. package/dist/pagination.js.map +1 -1
  477. package/dist/pausable-loop.js +2 -2
  478. package/dist/platform-bar.d.ts +102 -0
  479. package/dist/platform-bar.js +42 -0
  480. package/dist/platform-bar.js.map +1 -0
  481. package/dist/{player-lightbox-BYQ57OXT.js → player-lightbox-SJR3GB7U.js} +5 -5
  482. package/dist/player-lightbox-SJR3GB7U.js.map +1 -0
  483. package/dist/pointer-light.d.ts +1 -1
  484. package/dist/pointer-light.js.map +1 -1
  485. package/dist/popover.d.ts +1 -1
  486. package/dist/popover.js +1 -1
  487. package/dist/popover.js.map +1 -1
  488. package/dist/price-catalogue-editor.js +8 -8
  489. package/dist/price-catalogue-editor.js.map +1 -1
  490. package/dist/pricing-page.d.ts +1 -1
  491. package/dist/pricing-page.js +1 -1
  492. package/dist/pricing-page.js.map +1 -1
  493. package/dist/product-page.d.ts +1 -1
  494. package/dist/product-page.js +1 -1
  495. package/dist/product-page.js.map +1 -1
  496. package/dist/profile-card.d.ts +3 -3
  497. package/dist/profile-card.js +1 -1
  498. package/dist/profile-card.js.map +1 -1
  499. package/dist/progress.d.ts +1 -1
  500. package/dist/progress.js.map +1 -1
  501. package/dist/promise-card.d.ts +1 -1
  502. package/dist/promise-card.js +1 -1
  503. package/dist/promise-card.js.map +1 -1
  504. package/dist/promo-code-field.js +4 -4
  505. package/dist/proposal.js +5 -5
  506. package/dist/qr-code.js +6 -6
  507. package/dist/qr-code.js.map +1 -1
  508. package/dist/quota-meter.d.ts +1 -1
  509. package/dist/quota-meter.js +1 -1
  510. package/dist/quota-meter.js.map +1 -1
  511. package/dist/radio-group.d.ts +5 -5
  512. package/dist/radio-group.js +3 -3
  513. package/dist/radio-group.js.map +1 -1
  514. package/dist/rail-nav.d.ts +4 -4
  515. package/dist/rail-nav.js +3 -3
  516. package/dist/rail-nav.js.map +1 -1
  517. package/dist/recipes.js +1 -1
  518. package/dist/recipes.js.map +1 -1
  519. package/dist/retro-tv-playlist.d.ts +1 -1
  520. package/dist/retro-tv-playlist.js.map +1 -1
  521. package/dist/retro-tv.js +6 -6
  522. package/dist/retro-tv.js.map +1 -1
  523. package/dist/reviews.js +3 -3
  524. package/dist/{schema-Dkn0uX72.d.ts → schema-Dd05m48Q.d.ts} +1 -1
  525. package/dist/schema-form.js +7 -7
  526. package/dist/schema-form.js.map +1 -1
  527. package/dist/scroll-stage.d.ts +2 -2
  528. package/dist/scroll-stage.js +2 -2
  529. package/dist/scroll-stage.js.map +1 -1
  530. package/dist/search-field.d.ts +1 -1
  531. package/dist/search-field.js +2 -2
  532. package/dist/section-backdrop.d.ts +1 -1
  533. package/dist/section-backdrop.js +1 -1
  534. package/dist/separator.d.ts +1 -1
  535. package/dist/separator.js.map +1 -1
  536. package/dist/service-card.d.ts +1 -1
  537. package/dist/service-card.js +6 -6
  538. package/dist/service-card.js.map +1 -1
  539. package/dist/settings-layout.d.ts +3 -3
  540. package/dist/settings-layout.js +2 -2
  541. package/dist/shop/booking.d.ts +1 -1
  542. package/dist/shop/booking.js +4 -4
  543. package/dist/shop/booking.js.map +1 -1
  544. package/dist/shop/bulletin.d.ts +1 -1
  545. package/dist/shop/bulletin.js +2 -2
  546. package/dist/shop/bulletin.js.map +1 -1
  547. package/dist/shop/faq.d.ts +1 -1
  548. package/dist/shop/faq.js +3 -3
  549. package/dist/shop/faq.js.map +1 -1
  550. package/dist/shop/gallery.d.ts +1 -1
  551. package/dist/shop/gallery.js +3 -3
  552. package/dist/shop/gallery.js.map +1 -1
  553. package/dist/shop/hero.d.ts +1 -1
  554. package/dist/shop/hero.js +2 -2
  555. package/dist/shop/hero.js.map +1 -1
  556. package/dist/shop/policies.d.ts +1 -1
  557. package/dist/shop/policies.js +2 -2
  558. package/dist/shop/policies.js.map +1 -1
  559. package/dist/shop/reviews.d.ts +1 -1
  560. package/dist/shop/reviews.js +2 -2
  561. package/dist/shop/reviews.js.map +1 -1
  562. package/dist/shop/services.d.ts +1 -1
  563. package/dist/shop/services.js +4 -4
  564. package/dist/shop/services.js.map +1 -1
  565. package/dist/shop/social.d.ts +1 -1
  566. package/dist/shop/social.js +2 -2
  567. package/dist/shop/social.js.map +1 -1
  568. package/dist/shop/story.d.ts +1 -1
  569. package/dist/shop/story.js +2 -2
  570. package/dist/shop/story.js.map +1 -1
  571. package/dist/shop/team.d.ts +1 -1
  572. package/dist/shop/team.js +2 -2
  573. package/dist/shop/team.js.map +1 -1
  574. package/dist/shop/video.d.ts +1 -1
  575. package/dist/shop/video.js +2 -2
  576. package/dist/shop/video.js.map +1 -1
  577. package/dist/shop/visit.d.ts +1 -1
  578. package/dist/shop/visit.js +2 -2
  579. package/dist/shop/visit.js.map +1 -1
  580. package/dist/shop-composer.js +2 -2
  581. package/dist/shop-composer.js.map +1 -1
  582. package/dist/shop-gallery.d.ts +1 -1
  583. package/dist/shop-gallery.js +2 -2
  584. package/dist/shop-gallery.js.map +1 -1
  585. package/dist/shop.d.ts +3 -3
  586. package/dist/shop.js +2 -2
  587. package/dist/showcase.d.ts +1 -1
  588. package/dist/showcase.js +6 -6
  589. package/dist/showcase.js.map +1 -1
  590. package/dist/signature.d.ts +1 -1
  591. package/dist/signature.js +2 -2
  592. package/dist/signature.js.map +1 -1
  593. package/dist/site-cahier.d.ts +8 -5
  594. package/dist/site-cahier.js +24 -10
  595. package/dist/site-cahier.js.map +1 -1
  596. package/dist/site-footer.d.ts +21 -6
  597. package/dist/site-footer.js +15 -1
  598. package/dist/site-footer.js.map +1 -1
  599. package/dist/skeleton.d.ts +3 -3
  600. package/dist/skeleton.js.map +1 -1
  601. package/dist/skip-link.d.ts +1 -1
  602. package/dist/skip-link.js +1 -1
  603. package/dist/slider.d.ts +1 -1
  604. package/dist/slider.js +2 -2
  605. package/dist/slider.js.map +1 -1
  606. package/dist/slot-picker.d.ts +1 -1
  607. package/dist/slot-picker.js +1 -1
  608. package/dist/slot-picker.js.map +1 -1
  609. package/dist/specimen-tag.d.ts +2 -2
  610. package/dist/specimen-tag.js +2 -2
  611. package/dist/speed-lines.d.ts +1 -1
  612. package/dist/speed-lines.js +1 -1
  613. package/dist/speed-lines.js.map +1 -1
  614. package/dist/spinner.d.ts +2 -2
  615. package/dist/spinner.js +1 -1
  616. package/dist/spinner.js.map +1 -1
  617. package/dist/split-view.d.ts +1 -1
  618. package/dist/split-view.js.map +1 -1
  619. package/dist/stage-banner.d.ts +1 -1
  620. package/dist/stage-banner.js +1 -1
  621. package/dist/stage-banner.js.map +1 -1
  622. package/dist/stat.d.ts +2 -2
  623. package/dist/stat.js +1 -1
  624. package/dist/status-chip.js +4 -4
  625. package/dist/status-chip.js.map +1 -1
  626. package/dist/status-page.d.ts +1 -1
  627. package/dist/status-page.js.map +1 -1
  628. package/dist/step-progress.d.ts +1 -1
  629. package/dist/step-progress.js.map +1 -1
  630. package/dist/step-showcase.d.ts +2 -2
  631. package/dist/step-showcase.js +3 -3
  632. package/dist/step-showcase.js.map +1 -1
  633. package/dist/stepper.d.ts +1 -1
  634. package/dist/stepper.js +1 -1
  635. package/dist/stepper.js.map +1 -1
  636. package/dist/sticky-action.d.ts +1 -1
  637. package/dist/sticky-action.js.map +1 -1
  638. package/dist/stuck.d.ts +1 -1
  639. package/dist/stuck.js +1 -1
  640. package/dist/stuck.js.map +1 -1
  641. package/dist/swipe-deck.d.ts +2 -2
  642. package/dist/swipe-deck.js.map +1 -1
  643. package/dist/switch.d.ts +1 -1
  644. package/dist/switch.js +1 -1
  645. package/dist/tabs.d.ts +6 -6
  646. package/dist/tabs.js +1 -1
  647. package/dist/tabs.js.map +1 -1
  648. package/dist/tag-input.d.ts +1 -1
  649. package/dist/tag-input.js +4 -4
  650. package/dist/tag-input.js.map +1 -1
  651. package/dist/tag-selector.d.ts +1 -1
  652. package/dist/tag-selector.js +3 -3
  653. package/dist/tag-selector.js.map +1 -1
  654. package/dist/taped-photo.d.ts +1 -1
  655. package/dist/taped-photo.js +2 -2
  656. package/dist/terminal-replay.d.ts +1 -1
  657. package/dist/terminal-replay.js +3 -3
  658. package/dist/terminal-replay.js.map +1 -1
  659. package/dist/text-style/server.d.ts +1 -1
  660. package/dist/text-style/server.js.map +1 -1
  661. package/dist/text-style.d.ts +2 -2
  662. package/dist/text-style.js.map +1 -1
  663. package/dist/theme.d.ts +3 -3
  664. package/dist/theme.js +3 -3
  665. package/dist/theme.js.map +1 -1
  666. package/dist/toast.d.ts +1 -1
  667. package/dist/toast.js +2 -2
  668. package/dist/toast.js.map +1 -1
  669. package/dist/toc.d.ts +2 -2
  670. package/dist/toc.js +1 -1
  671. package/dist/toc.js.map +1 -1
  672. package/dist/tooltip.d.ts +1 -1
  673. package/dist/tooltip.js +2 -2
  674. package/dist/tree-view.d.ts +1 -1
  675. package/dist/tree-view.js +2 -2
  676. package/dist/tree-view.js.map +1 -1
  677. package/dist/update-prompt.d.ts +1 -1
  678. package/dist/update-prompt.js +3 -3
  679. package/dist/update-prompt.js.map +1 -1
  680. package/dist/upload-queue.d.ts +2 -2
  681. package/dist/upload-queue.js +1 -1
  682. package/dist/upload-queue.js.map +1 -1
  683. package/dist/usage.d.ts +4 -4
  684. package/dist/usage.js +3 -3
  685. package/dist/usage.js.map +1 -1
  686. package/dist/verified-badge.d.ts +1 -1
  687. package/dist/verified-badge.js.map +1 -1
  688. package/dist/versus-card.d.ts +1 -1
  689. package/dist/versus-card.js +2 -2
  690. package/dist/versus-card.js.map +1 -1
  691. package/dist/vertical-video.d.ts +2 -2
  692. package/dist/vertical-video.js +6 -6
  693. package/dist/vertical-video.js.map +1 -1
  694. package/dist/video-player.d.ts +1 -1
  695. package/dist/video-player.js +5 -5
  696. package/dist/video-trimmer.d.ts +1 -1
  697. package/dist/video-trimmer.js.map +1 -1
  698. package/dist/virtual.d.ts +2 -2
  699. package/dist/virtual.js +1 -1
  700. package/dist/wall.js +2 -2
  701. package/dist/wall.js.map +1 -1
  702. package/dist/waveform.d.ts +1 -1
  703. package/dist/waveform.js.map +1 -1
  704. package/package.json +28 -8
  705. package/registry/account-menu.json +1 -1
  706. package/registry/account-settings.json +18 -18
  707. package/registry/achievement.json +2 -2
  708. package/registry/action-bar.json +4 -4
  709. package/registry/activity-feed.json +3 -3
  710. package/registry/agenda.json +1 -1
  711. package/registry/alert.json +2 -2
  712. package/registry/analysis-report.json +2 -2
  713. package/registry/anatomy-plate.json +2 -2
  714. package/registry/app-frame.json +7 -7
  715. package/registry/app-header.json +5 -5
  716. package/registry/app-shell.json +3 -3
  717. package/registry/architecture-diagram.json +2 -2
  718. package/registry/argument-card.json +4 -4
  719. package/registry/auth-layout.json +2 -2
  720. package/registry/avatar.json +4 -4
  721. package/registry/badge.json +2 -2
  722. package/registry/bird-plate.json +2 -2
  723. package/registry/button.json +6 -2
  724. package/registry/captcha.json +2 -2
  725. package/registry/card-grid.json +2 -2
  726. package/registry/card.json +2 -2
  727. package/registry/catalogue-page.json +2 -2
  728. package/registry/changelog-page.json +3 -3
  729. package/registry/chapter.json +3 -3
  730. package/registry/chat.json +2 -2
  731. package/registry/checkbox.json +2 -2
  732. package/registry/chip-link.json +2 -2
  733. package/registry/chip-row.json +2 -2
  734. package/registry/chip.json +3 -3
  735. package/registry/choice-grid.json +3 -3
  736. package/registry/cn.json +1 -1
  737. package/registry/code-block.json +3 -3
  738. package/registry/collection-switcher.json +3 -3
  739. package/registry/columns.json +2 -2
  740. package/registry/combobox.json +3 -3
  741. package/registry/command.json +2 -2
  742. package/registry/comparison-table.json +2 -2
  743. package/registry/component-page.json +2 -2
  744. package/registry/confirm-button.json +2 -2
  745. package/registry/contact-page.json +2 -2
  746. package/registry/continue-prompt.json +2 -2
  747. package/registry/copy-button.json +3 -3
  748. package/registry/countdown.json +2 -2
  749. package/registry/cover-hero.json +4 -4
  750. package/registry/cta-panel.json +2 -2
  751. package/registry/dashboard-layout.json +3 -3
  752. package/registry/data-table.json +5 -5
  753. package/registry/date-picker.json +9 -9
  754. package/registry/decision-list.json +3 -3
  755. package/registry/description-list.json +2 -2
  756. package/registry/desktop-window.json +1 -1
  757. package/registry/detail-layout.json +2 -2
  758. package/registry/dialog.json +3 -3
  759. package/registry/docs-article-page.json +2 -2
  760. package/registry/docs-hub-page.json +2 -2
  761. package/registry/docs-layout.json +3 -3
  762. package/registry/docs-nav.json +2 -2
  763. package/registry/document-viewer.json +3 -3
  764. package/registry/doodle.json +2 -2
  765. package/registry/drop-overlay.json +2 -2
  766. package/registry/dropdown-menu.json +2 -2
  767. package/registry/elephant.json +1 -1
  768. package/registry/embed-facade.json +1 -1
  769. package/registry/empty-state.json +2 -2
  770. package/registry/engine-flow.json +2 -2
  771. package/registry/entity-header.json +3 -3
  772. package/registry/environment-notice.json +2 -2
  773. package/registry/error-page.json +2 -2
  774. package/registry/examples/platform-bar/demo.d.ts +4 -0
  775. package/registry/examples/platform-bar/demo.js +24 -0
  776. package/registry/examples/platform-bar/demo.tsx +20 -0
  777. package/registry/examples/platform-bar/live.d.ts +4 -0
  778. package/registry/examples/platform-bar/live.js +22 -0
  779. package/registry/examples/platform-bar/live.tsx +22 -0
  780. package/registry/examples/site-footer/hosted.d.ts +4 -0
  781. package/registry/examples/site-footer/hosted.js +25 -0
  782. package/registry/examples/site-footer/hosted.tsx +23 -0
  783. package/registry/field.json +2 -2
  784. package/registry/file-upload.json +3 -3
  785. package/registry/filter-bar.json +5 -5
  786. package/registry/flock.json +2 -2
  787. package/registry/footnote.json +2 -2
  788. package/registry/force-update-screen.json +2 -2
  789. package/registry/form.json +65 -65
  790. package/registry/gallery-page.json +2 -2
  791. package/registry/genui.json +3 -3
  792. package/registry/glossary-term.json +1 -1
  793. package/registry/glossary.json +1 -1
  794. package/registry/glow-card.json +2 -2
  795. package/registry/goal-gauge.json +2 -2
  796. package/registry/grade-stamp.json +2 -2
  797. package/registry/identity-card.json +2 -2
  798. package/registry/image-cropper.json +2 -2
  799. package/registry/index.json +40 -9
  800. package/registry/kanban.json +2 -2
  801. package/registry/kbd.json +2 -2
  802. package/registry/kind-config-editor.json +3 -3
  803. package/registry/kpi-explained.json +2 -2
  804. package/registry/landing-page.json +2 -2
  805. package/registry/landscape.json +2 -2
  806. package/registry/language-switch.json +2 -2
  807. package/registry/legal-page.json +2 -2
  808. package/registry/link-card.json +4 -4
  809. package/registry/list.json +3 -3
  810. package/registry/loader.json +2 -2
  811. package/registry/longform-page.json +2 -2
  812. package/registry/maintenance-screen.json +2 -2
  813. package/registry/map.json +8 -8
  814. package/registry/margin-layout.json +2 -2
  815. package/registry/markdown.json +2 -2
  816. package/registry/marketing-layout.json +2 -2
  817. package/registry/mascot-quote.json +2 -2
  818. package/registry/mascot-state.json +3 -3
  819. package/registry/mascots.json +4 -4
  820. package/registry/match-dialog.json +2 -2
  821. package/registry/media-capture.json +3 -3
  822. package/registry/media-gallery.json +5 -5
  823. package/registry/meter.json +2 -2
  824. package/registry/money-input.json +2 -2
  825. package/registry/nav-bar.json +9 -9
  826. package/registry/next-actions.json +1 -1
  827. package/registry/notification-preferences.json +1 -1
  828. package/registry/number-ticker.json +2 -2
  829. package/registry/opening-hours.json +3 -3
  830. package/registry/page-header.json +2 -2
  831. package/registry/page-hero.json +4 -4
  832. package/registry/page-index.json +3 -3
  833. package/registry/page.json +2 -2
  834. package/registry/pagination.json +3 -3
  835. package/registry/platform-bar.json +179 -0
  836. package/registry/pointer-light.json +2 -2
  837. package/registry/popover.json +2 -2
  838. package/registry/price-catalogue-editor.json +2 -2
  839. package/registry/pricing-page.json +3 -3
  840. package/registry/product-page.json +2 -2
  841. package/registry/profile-card.json +4 -4
  842. package/registry/progress.json +2 -2
  843. package/registry/promise-card.json +2 -2
  844. package/registry/promo-code-field.json +1 -1
  845. package/registry/proposal.json +1 -1
  846. package/registry/qr-code.json +3 -3
  847. package/registry/quota-meter.json +2 -2
  848. package/registry/radio-group.json +15 -15
  849. package/registry/rail-nav.json +9 -9
  850. package/registry/recipes.json +2 -2
  851. package/registry/retro-tv.json +4 -4
  852. package/registry/reviews.json +1 -1
  853. package/registry/router.json +1 -1
  854. package/registry/schema-form.json +2 -2
  855. package/registry/scroll-stage.json +2 -2
  856. package/registry/search-field.json +3 -3
  857. package/registry/section-backdrop.json +2 -2
  858. package/registry/separator.json +2 -2
  859. package/registry/service-card.json +4 -4
  860. package/registry/settings-layout.json +2 -2
  861. package/registry/shop-composer.json +4 -4
  862. package/registry/shop-gallery.json +2 -2
  863. package/registry/shop.json +18 -18
  864. package/registry/showcase.json +2 -2
  865. package/registry/signature.json +2 -2
  866. package/registry/site-cahier.json +3 -3
  867. package/registry/site-footer.json +57 -20
  868. package/registry/sites.json +1 -1
  869. package/registry/skeleton.json +2 -2
  870. package/registry/skip-link.json +2 -2
  871. package/registry/slider.json +2 -2
  872. package/registry/slot-picker.json +3 -3
  873. package/registry/slot.json +1 -1
  874. package/registry/specimen-tag.json +2 -2
  875. package/registry/speed-lines.json +2 -2
  876. package/registry/spinner.json +3 -3
  877. package/registry/split-view.json +2 -2
  878. package/registry/stage-banner.json +2 -2
  879. package/registry/stat.json +2 -2
  880. package/registry/status-chip.json +3 -3
  881. package/registry/status-page.json +2 -2
  882. package/registry/step-progress.json +2 -2
  883. package/registry/step-showcase.json +3 -3
  884. package/registry/stepper.json +2 -2
  885. package/registry/sticky-action.json +2 -2
  886. package/registry/stuck.json +2 -2
  887. package/registry/swipe-deck.json +2 -2
  888. package/registry/switch.json +2 -2
  889. package/registry/tabs.json +2 -2
  890. package/registry/tag-input.json +2 -2
  891. package/registry/tag-selector.json +2 -2
  892. package/registry/taped-photo.json +2 -2
  893. package/registry/terminal-replay.json +3 -3
  894. package/registry/text-style.json +9 -9
  895. package/registry/theme.json +2 -2
  896. package/registry/toast.json +2 -2
  897. package/registry/toc.json +2 -2
  898. package/registry/tooltip.json +2 -2
  899. package/registry/tree-view.json +3 -3
  900. package/registry/update-prompt.json +2 -2
  901. package/registry/upload-queue.json +2 -2
  902. package/registry/usage.json +3 -3
  903. package/registry/verified-badge.json +2 -2
  904. package/registry/versus-card.json +2 -2
  905. package/registry/vertical-video.json +3 -3
  906. package/registry/video-player.json +3 -3
  907. package/registry/video-trimmer.json +2 -2
  908. package/registry/virtual.json +4 -4
  909. package/registry/wall.json +2 -2
  910. package/registry/waveform.json +2 -2
  911. package/dist/chunk-2FCQCWIK.js.map +0 -1
  912. package/dist/chunk-43PTCDTL.js.map +0 -1
  913. package/dist/chunk-5D7NMUF6.js.map +0 -1
  914. package/dist/chunk-5PFCELGW.js.map +0 -1
  915. package/dist/chunk-5RWHDX5J.js.map +0 -1
  916. package/dist/chunk-5VZ37TY3.js.map +0 -1
  917. package/dist/chunk-757ZTGU5.js.map +0 -1
  918. package/dist/chunk-7DYZTEE3.js.map +0 -1
  919. package/dist/chunk-7P7I5OQV.js.map +0 -1
  920. package/dist/chunk-B47WSPMP.js.map +0 -1
  921. package/dist/chunk-C57KK5VB.js.map +0 -1
  922. package/dist/chunk-EB45EVPJ.js.map +0 -1
  923. package/dist/chunk-EDQLPCM4.js.map +0 -1
  924. package/dist/chunk-GHAN7OOE.js.map +0 -1
  925. package/dist/chunk-HLEBSAGC.js.map +0 -1
  926. package/dist/chunk-HP7BDMVK.js.map +0 -1
  927. package/dist/chunk-KH3JOEPY.js.map +0 -1
  928. package/dist/chunk-KR2W4ONJ.js.map +0 -1
  929. package/dist/chunk-LH5J3VLZ.js.map +0 -1
  930. package/dist/chunk-LNAAWT4Y.js.map +0 -1
  931. package/dist/chunk-MDSP7DJR.js.map +0 -1
  932. package/dist/chunk-NG6G6V5E.js.map +0 -1
  933. package/dist/chunk-NM2DEHFZ.js.map +0 -1
  934. package/dist/chunk-NPMGYLJV.js.map +0 -1
  935. package/dist/chunk-NQENOT6L.js.map +0 -1
  936. package/dist/chunk-NSLXEDIS.js.map +0 -1
  937. package/dist/chunk-OGWB76BR.js.map +0 -1
  938. package/dist/chunk-P7AFIKWG.js.map +0 -1
  939. package/dist/chunk-PGBF3UBX.js.map +0 -1
  940. package/dist/chunk-QA3WETWT.js.map +0 -1
  941. package/dist/chunk-QD6SNXF5.js.map +0 -1
  942. package/dist/chunk-QHVV2JGF.js.map +0 -1
  943. package/dist/chunk-QVHSV6RA.js.map +0 -1
  944. package/dist/chunk-S2O4NSN5.js.map +0 -1
  945. package/dist/chunk-S4TLZRGZ.js.map +0 -1
  946. package/dist/chunk-S6NYGOJT.js.map +0 -1
  947. package/dist/chunk-SB5WSVPI.js.map +0 -1
  948. package/dist/chunk-SG2RKUVJ.js.map +0 -1
  949. package/dist/chunk-V5RO6JYI.js.map +0 -1
  950. package/dist/chunk-V7W4RLRW.js.map +0 -1
  951. package/dist/chunk-VA4NPCUQ.js.map +0 -1
  952. package/dist/chunk-VPO27AFS.js.map +0 -1
  953. package/dist/chunk-W64RAX4N.js.map +0 -1
  954. package/dist/chunk-W675RFOA.js.map +0 -1
  955. package/dist/chunk-WC3SO4CE.js.map +0 -1
  956. package/dist/chunk-WEVYKZIF.js.map +0 -1
  957. package/dist/chunk-WU4VLSEA.js.map +0 -1
  958. package/dist/chunk-Y3P5B4XS.js.map +0 -1
  959. package/dist/chunk-YTYNKMNS.js.map +0 -1
  960. package/dist/chunk-Z47KIPCT.js.map +0 -1
  961. package/dist/chunk-ZPOVOEO3.js.map +0 -1
  962. package/dist/player-lightbox-BYQ57OXT.js.map +0 -1
  963. /package/dist/{chunk-HJFRHYCI.js.map → chunk-DTGRZXYO.js.map} +0 -0
  964. /package/dist/{chunk-PJNR4NTS.js.map → chunk-HC2TY45B.js.map} +0 -0
  965. /package/dist/{lightbox-MRB2YZEP.js.map → lightbox-JLWASIJC.js.map} +0 -0
package/registry/map.json CHANGED
@@ -1094,7 +1094,7 @@
1094
1094
  },
1095
1095
  {
1096
1096
  "path": "map/cards/map-cards.tsx",
1097
- "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { tv } from \"../../tv\";\nimport type { LngLat } from \"../geo\";\nimport { ROUTE_APPS, type RouteApp, routeLinks } from \"./route-links\";\n\nexport const mapCard = tv({\n slots: {\n root: \"flex flex-col gap-2 text-fg\",\n photo: \"aspect-[16/9] w-full overflow-hidden rounded-xl bg-surface-2 [&>img]:h-full [&>img]:w-full [&>img]:object-cover\",\n title: \"text-base font-semibold leading-snug\",\n meta: \"text-sm text-fg-secondary\",\n status: \"w-fit rounded-md bg-surface-2 px-2 py-0.5 text-xs font-medium text-fg-secondary\",\n action: \"mt-1 flex\",\n times: \"grid grid-cols-[repeat(auto-fit,minmax(5.5rem,1fr))] gap-2 text-sm\",\n time: \"flex flex-col rounded-lg bg-surface-2 px-2.5 py-1.5\",\n timeLabel: \"text-xs text-fg-secondary\",\n menu: \"flex flex-wrap gap-2\",\n link: \"rounded-md border border-border-default px-3 py-1.5 text-sm font-medium text-fg hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-border-focus\",\n },\n});\n\nexport type MapInfoCardProps = Omit<React.ComponentProps<\"article\">, \"title\"> & {\n title: React.ReactNode;\n /** The heading level of the title. Default 3. */\n titleLevel?: 2 | 3 | 4;\n /** A picture (an img or next/image); supply its alt text. Absent: no photo area. */\n photo?: React.ReactNode;\n /** One line under the title: category, distance, hours. */\n meta?: React.ReactNode;\n /** A short honest status (\"Open now\", \"In development\"). */\n status?: React.ReactNode;\n /** The one action (a Button or a link); the card carries no second one. */\n action?: React.ReactNode;\n};\n\n/** What a place says about itself on a map: photo, title, one meta line, a status and ONE action — every field optional. */\nexport function MapInfoCard({ title, titleLevel = 3, photo, meta, status, action, className, ...props }: MapInfoCardProps) {\n const s = mapCard();\n const Heading = `h${titleLevel}` as \"h3\";\n return (\n <article {...props} className={s.root({ className })}>\n {photo ? <div className={s.photo()}>{photo}</div> : null}\n <Heading className={s.title()}>{title}</Heading>\n {meta ? <p className={s.meta()}>{meta}</p> : null}\n {status ? <p className={s.status()}>{status}</p> : null}\n {action ? <div className={s.action()}>{action}</div> : null}\n </article>\n );\n}\n\nexport type RouteTime = { /** \"On foot\", \"By bike\" — translated. */ label: string; /** \"12 min\" — formatted by the host from a real source. */ value: string };\n\nexport type RouteCardProps = Omit<React.ComponentProps<\"section\">, \"title\"> & {\n /** The destination's name. */\n destination: React.ReactNode;\n /** Where it is, for the links. */\n position: LngLat;\n /** Where the person is, when known: the links then start there. */\n origin?: LngLat;\n /** The heading of the links (\"Directions\"). */\n directionsLabel: string;\n /** The apps' names, translated or not (\"Apple Maps\", \"Google Maps\", \"OpenStreetMap\", \"Waze\", \"Transit\"). */\n appLabels: Record<RouteApp, string>;\n /** Honest times, computed by the host from a real source (never invented here). Absent: no row. */\n times?: readonly RouteTime[];\n /** The apps shown, in order. Default all five. */\n apps?: readonly RouteApp[];\n};\n\n/** A destination, the times the host knows, and the « Directions » links to the person's own navigation app. */\nexport function RouteCard({ destination, position, origin, directionsLabel, appLabels, times, apps = ROUTE_APPS, className, ...props }: RouteCardProps) {\n const s = mapCard();\n const links = routeLinks(position, origin);\n const id = React.useId();\n return (\n <section {...props} aria-labelledby={id} className={s.root({ className })}>\n <h3 id={id} className={s.title()}>{destination}</h3>\n {times?.length ? (\n <dl className={s.times()}>\n {times.map((t) => (\n <div key={t.label} className={s.time()}>\n <dt className={s.timeLabel()}>{t.label}</dt>\n <dd>{t.value}</dd>\n </div>\n ))}\n </dl>\n ) : null}\n <nav aria-label={directionsLabel}>\n <ul className={s.menu()}>\n {apps.map((app) => (\n <li key={app}>\n <a className={s.link()} href={links[app]} target=\"_blank\" rel=\"noopener noreferrer\">\n {appLabels[app]}\n </a>\n </li>\n ))}\n </ul>\n </nav>\n </section>\n );\n}\n"
1097
+ "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { tv } from \"../../tv\";\nimport type { LngLat } from \"../geo\";\nimport { ROUTE_APPS, type RouteApp, routeLinks } from \"./route-links\";\n\nexport const mapCard = tv({\n slots: {\n root: \"flex flex-col gap-2 text-fg\",\n photo: \"aspect-[16/9] w-full overflow-hidden rounded-xl bg-surface-2 [&>img]:h-full [&>img]:w-full [&>img]:object-cover\",\n title: \"text-base font-semibold leading-snug\",\n meta: \"text-sm text-fg-secondary\",\n status: \"w-fit rounded-md bg-surface-2 px-2 py-0.5 text-xs font-medium text-fg-secondary\",\n action: \"mt-1 flex\",\n times: \"grid grid-cols-[repeat(auto-fit,minmax(5.5rem,1fr))] gap-2 text-sm\",\n time: \"flex flex-col rounded-lg bg-surface-2 px-2.5 py-1.5\",\n timeLabel: \"text-xs text-fg-secondary\",\n menu: \"flex flex-wrap gap-2\",\n link: \"rounded-md border border-border-default px-3 py-1.5 text-sm font-medium text-fg hover:bg-surface-2 focus-visible:outline-2 focus-visible:outline-border-focus\",\n },\n});\n\nexport type MapInfoCardProps = Omit<React.ComponentProps<\"article\">, \"title\"> & {\n title: React.ReactNode;\n /** The heading level of the title. Default 3. */\n titleLevel?: 2 | 3 | 4;\n /** A picture (an img or next/image); supply its alt text. Absent: no photo area. */\n photo?: React.ReactNode;\n /** One line under the title: category, distance, hours. */\n meta?: React.ReactNode;\n /** A short honest status (\"Open now\", \"In development\"). */\n status?: React.ReactNode;\n /** The one action (a Button or a link); the card carries no second one. */\n action?: React.ReactNode;\n};\n\n/** What a place says about itself on a map: photo, title, one meta line, a status and ONE action — every field optional. */\nexport function MapInfoCard({ title, titleLevel = 3, photo, meta, status, action, className, ...props }: Readonly<MapInfoCardProps>) {\n const s = mapCard();\n const Heading = `h${titleLevel}` as \"h3\";\n return (\n <article {...props} className={s.root({ className })}>\n {photo ? <div className={s.photo()}>{photo}</div> : null}\n <Heading className={s.title()}>{title}</Heading>\n {meta ? <p className={s.meta()}>{meta}</p> : null}\n {status ? <p className={s.status()}>{status}</p> : null}\n {action ? <div className={s.action()}>{action}</div> : null}\n </article>\n );\n}\n\nexport type RouteTime = { /** \"On foot\", \"By bike\" — translated. */ label: string; /** \"12 min\" — formatted by the host from a real source. */ value: string };\n\nexport type RouteCardProps = Omit<React.ComponentProps<\"section\">, \"title\"> & {\n /** The destination's name. */\n destination: React.ReactNode;\n /** Where it is, for the links. */\n position: LngLat;\n /** Where the person is, when known: the links then start there. */\n origin?: LngLat;\n /** The heading of the links (\"Directions\"). */\n directionsLabel: string;\n /** The apps' names, translated or not (\"Apple Maps\", \"Google Maps\", \"OpenStreetMap\", \"Waze\", \"Transit\"). */\n appLabels: Record<RouteApp, string>;\n /** Honest times, computed by the host from a real source (never invented here). Absent: no row. */\n times?: readonly RouteTime[];\n /** The apps shown, in order. Default all five. */\n apps?: readonly RouteApp[];\n};\n\n/** A destination, the times the host knows, and the « Directions » links to the person's own navigation app. */\nexport function RouteCard({ destination, position, origin, directionsLabel, appLabels, times, apps = ROUTE_APPS, className, ...props }: Readonly<RouteCardProps>) {\n const s = mapCard();\n const links = routeLinks(position, origin);\n const id = React.useId();\n return (\n <section {...props} aria-labelledby={id} className={s.root({ className })}>\n <h3 id={id} className={s.title()}>{destination}</h3>\n {times?.length ? (\n <dl className={s.times()}>\n {times.map((t) => (\n <div key={t.label} className={s.time()}>\n <dt className={s.timeLabel()}>{t.label}</dt>\n <dd>{t.value}</dd>\n </div>\n ))}\n </dl>\n ) : null}\n <nav aria-label={directionsLabel}>\n <ul className={s.menu()}>\n {apps.map((app) => (\n <li key={app}>\n <a className={s.link()} href={links[app]} target=\"_blank\" rel=\"noopener noreferrer\">\n {appLabels[app]}\n </a>\n </li>\n ))}\n </ul>\n </nav>\n </section>\n );\n}\n"
1098
1098
  },
1099
1099
  {
1100
1100
  "path": "map/cards/route-links.ts",
@@ -1110,11 +1110,11 @@
1110
1110
  },
1111
1111
  {
1112
1112
  "path": "map/location-picker.tsx",
1113
- "content": "// Client. A place chosen by moving the map under a fixed pin — a meeting point, a delivery address, the centre of a\n// search — with its distance from where the person is (a chip) and \"near me\": the browser asks for the position only when\n// the button is pressed, and every answer has its words (locating, refused, unavailable). The value is a position.\nimport * as React from \"react\";\n\nimport { tv } from \"../tv\";\nimport { distanceMeters, formatDistance, type LngLat } from \"./geo\";\nimport { Map, type MapProps, RadiusCircle, UserPosition } from \"./map\";\n\nexport const locationPicker = tv({\n slots: {\n root: \"flex flex-col gap-2\",\n frame: \"relative\",\n pin: \"pointer-events-none absolute left-1/2 top-1/2 z-10 -translate-x-1/2 -translate-y-full text-accent drop-shadow-md\",\n bar: \"absolute inset-x-3 bottom-8 z-10 flex flex-wrap items-center justify-between gap-2\",\n chip: \"rounded-sm border border-border-default bg-surface-1 px-3 py-1.5 text-xs font-semibold tabular-nums text-fg shadow-floating\",\n near:\n \"inline-flex h-10 items-center gap-2 rounded-sm border border-border-default bg-surface-1 bg-sheen px-4 text-sm font-semibold text-fg shadow-floating inset-shadow-edge \" +\n \"transition-colors hover:border-border-strong focus-visible:outline-hidden focus-visible:focus-ring disabled:opacity-60\",\n status: \"text-xs text-fg-secondary data-[tone=danger]:text-fg-danger\",\n },\n});\n\nexport type LocationPickerLabels = {\n /** The button that centres the map on the person (\"Near me\"). */\n nearMe: string;\n /** While the position is asked (\"Finding you…\"). */\n locating: string;\n /** The person refused (\"Location is off for this site. Move the map instead.\"). */\n denied: string;\n /** No position (no GPS, a timeout) (\"We could not find you. Move the map instead.\"). */\n unavailable: string;\n /** The person's place in the list of places (\"You are here\"). */\n you: string;\n /** The distance chip, from a written distance (\"1.2 km from you\"). */\n distance: (distance: string) => string;\n};\n\nexport const locationPickerLabels: LocationPickerLabels = {\n nearMe: \"Near me\",\n locating: \"Finding you…\",\n denied: \"Location is off for this site. Move the map instead.\",\n unavailable: \"We could not find you. Move the map instead.\",\n you: \"You are here\",\n distance: (d) => `${d} from you`,\n};\n\nexport type LocationPickerProps = Pick<MapProps, \"scheme\" | \"brand\" | \"lang\" | \"region\" | \"world\" | \"fallback\" | \"className\"> & {\n /** The picker's accessible name (\"Meeting point\"), passed translated. */\n label: string;\n /** The chosen position (controlled): the centre of the map. */\n value: LngLat;\n /** Called when the map rests on a new position. */\n onValueChange: (value: LngLat) => void;\n /** The BCP 47 locale of the distance. */\n locale: string;\n /** The zoom at first. Default 14. */\n zoom?: number;\n /** A radius in metres drawn around the chosen position (a delivery zone, a search radius). */\n radius?: number;\n /** Where the person is, when the app already knows it (the distance chip shows at once). */\n origin?: LngLat | null;\n /** The words, passed translated; English by default. */\n labels?: Partial<LocationPickerLabels>;\n};\n\ntype Status = \"idle\" | \"locating\" | \"denied\" | \"unavailable\";\n\n/** A position picked by moving the map under a pin; its distance from the person; \"near me\" on request. */\nexport function LocationPicker({ label, value, onValueChange, locale, zoom = 14, radius, origin: originProp = null, labels: given, className, ...map }: LocationPickerProps) {\n const labels = { ...locationPickerLabels, ...given };\n const s = locationPicker();\n const [origin, setOrigin] = React.useState<LngLat | null>(originProp);\n const [camera, setCamera] = React.useState<LngLat>(value);\n const [status, setStatus] = React.useState<Status>(\"idle\");\n const statusId = React.useId();\n const nearMe = () => {\n if (typeof navigator === \"undefined\" || !navigator.geolocation) return setStatus(\"unavailable\");\n setStatus(\"locating\");\n navigator.geolocation.getCurrentPosition(\n (p) => {\n const here: LngLat = [p.coords.longitude, p.coords.latitude];\n setOrigin(here);\n setCamera(here);\n onValueChange(here);\n setStatus(\"idle\");\n },\n (e) => setStatus(e.code === 1 ? \"denied\" : \"unavailable\"),\n { enableHighAccuracy: false, timeout: 10_000, maximumAge: 60_000 },\n );\n };\n const distance = origin ? formatDistance(distanceMeters(origin, value), locale) : null;\n const message = status === \"locating\" ? labels.locating : status === \"denied\" ? labels.denied : status === \"unavailable\" ? labels.unavailable : \"\";\n return (\n <div className={s.root({ className })} role=\"group\" aria-label={label}>\n <div className={s.frame()}>\n <Map {...map} label={label} center={camera} zoom={zoom} controlled onMoveEnd={(v) => onValueChange(v.center)} className=\"h-80\">\n {radius ? <RadiusCircle center={value} radius={radius} /> : null}\n {origin ? <UserPosition position={origin} label={labels.you} /> : null}\n </Map>\n <svg aria-hidden viewBox=\"0 0 24 32\" className={s.pin()} width=\"30\" height=\"40\">\n <path d=\"M12 0C5.4 0 0 5.2 0 11.7 0 20.4 12 32 12 32s12-11.6 12-20.3C24 5.2 18.6 0 12 0Z\" fill=\"currentColor\" />\n <circle cx=\"12\" cy=\"11.5\" r=\"4.5\" fill=\"var(--kz-on-accent)\" />\n </svg>\n <div className={s.bar()}>\n {distance ? (\n <span className={s.chip()} aria-live=\"polite\">\n {labels.distance(distance)}\n </span>\n ) : (\n <span />\n )}\n <button type=\"button\" className={s.near()} onClick={nearMe} disabled={status === \"locating\"} aria-describedby={message ? statusId : undefined}>\n <svg aria-hidden viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\">\n <circle cx=\"12\" cy=\"12\" r=\"3.5\" />\n <path d=\"M12 2v3M12 19v3M2 12h3M19 12h3\" />\n </svg>\n {status === \"locating\" ? labels.locating : labels.nearMe}\n </button>\n </div>\n </div>\n <p id={statusId} className={s.status()} data-tone={status === \"denied\" || status === \"unavailable\" ? \"danger\" : undefined} aria-live=\"polite\">\n {message}\n </p>\n </div>\n );\n}\n"
1113
+ "content": "// Client. A place chosen by moving the map under a fixed pin — a meeting point, a delivery address, the centre of a\n// search — with its distance from where the person is (a chip) and \"near me\": the browser asks for the position only when\n// the button is pressed, and every answer has its words (locating, refused, unavailable). The value is a position.\nimport * as React from \"react\";\n\nimport { tv } from \"../tv\";\nimport { distanceMeters, formatDistance, type LngLat } from \"./geo\";\nimport { Map, type MapProps, RadiusCircle, UserPosition } from \"./map\";\n\nexport const locationPicker = tv({\n slots: {\n root: \"flex flex-col gap-2\",\n frame: \"relative\",\n pin: \"pointer-events-none absolute left-1/2 top-1/2 z-10 -translate-x-1/2 -translate-y-full text-accent drop-shadow-md\",\n bar: \"absolute inset-x-3 bottom-8 z-10 flex flex-wrap items-center justify-between gap-2\",\n chip: \"rounded-sm border border-border-default bg-surface-1 px-3 py-1.5 text-xs font-semibold tabular-nums text-fg shadow-floating\",\n near:\n \"inline-flex h-10 items-center gap-2 rounded-sm border border-border-default bg-surface-1 bg-sheen px-4 text-sm font-semibold text-fg shadow-floating inset-shadow-edge \" +\n \"transition-colors hover:border-border-strong focus-visible:outline-hidden focus-visible:focus-ring disabled:opacity-60\",\n status: \"text-xs text-fg-secondary data-[tone=danger]:text-fg-danger\",\n },\n});\n\nexport type LocationPickerLabels = {\n /** The button that centres the map on the person (\"Near me\"). */\n nearMe: string;\n /** While the position is asked (\"Finding you…\"). */\n locating: string;\n /** The person refused (\"Location is off for this site. Move the map instead.\"). */\n denied: string;\n /** No position (no GPS, a timeout) (\"We could not find you. Move the map instead.\"). */\n unavailable: string;\n /** The person's place in the list of places (\"You are here\"). */\n you: string;\n /** The distance chip, from a written distance (\"1.2 km from you\"). */\n distance: (distance: string) => string;\n};\n\nexport const locationPickerLabels: LocationPickerLabels = {\n nearMe: \"Near me\",\n locating: \"Finding you…\",\n denied: \"Location is off for this site. Move the map instead.\",\n unavailable: \"We could not find you. Move the map instead.\",\n you: \"You are here\",\n distance: (d) => `${d} from you`,\n};\n\nexport type LocationPickerProps = Pick<MapProps, \"scheme\" | \"brand\" | \"lang\" | \"region\" | \"world\" | \"fallback\" | \"className\"> & {\n /** The picker's accessible name (\"Meeting point\"), passed translated. */\n label: string;\n /** The chosen position (controlled): the centre of the map. */\n value: LngLat;\n /** Called when the map rests on a new position. */\n onValueChange: (value: LngLat) => void;\n /** The BCP 47 locale of the distance. */\n locale: string;\n /** The zoom at first. Default 14. */\n zoom?: number;\n /** A radius in metres drawn around the chosen position (a delivery zone, a search radius). */\n radius?: number;\n /** Where the person is, when the app already knows it (the distance chip shows at once). */\n origin?: LngLat | null;\n /** The words, passed translated; English by default. */\n labels?: Partial<LocationPickerLabels>;\n};\n\ntype Status = \"idle\" | \"locating\" | \"denied\" | \"unavailable\";\n\n/** A position picked by moving the map under a pin; its distance from the person; \"near me\" on request. */\nexport function LocationPicker({ label, value, onValueChange, locale, zoom = 14, radius, origin: originProp = null, labels: given, className, ...map }: Readonly<LocationPickerProps>) {\n const labels = { ...locationPickerLabels, ...given };\n const s = locationPicker();\n const [origin, setOrigin] = React.useState<LngLat | null>(originProp);\n const [camera, setCamera] = React.useState<LngLat>(value);\n const [status, setStatus] = React.useState<Status>(\"idle\");\n const statusId = React.useId();\n const nearMe = () => {\n if (typeof navigator === \"undefined\" || !navigator.geolocation) return setStatus(\"unavailable\");\n setStatus(\"locating\");\n navigator.geolocation.getCurrentPosition(\n (p) => {\n const here: LngLat = [p.coords.longitude, p.coords.latitude];\n setOrigin(here);\n setCamera(here);\n onValueChange(here);\n setStatus(\"idle\");\n },\n (e) => setStatus(e.code === 1 ? \"denied\" : \"unavailable\"),\n { enableHighAccuracy: false, timeout: 10_000, maximumAge: 60_000 },\n );\n };\n const distance = origin ? formatDistance(distanceMeters(origin, value), locale) : null;\n const message = status === \"locating\" ? labels.locating : status === \"denied\" ? labels.denied : status === \"unavailable\" ? labels.unavailable : \"\";\n return (\n <div className={s.root({ className })} role=\"group\" aria-label={label}>\n <div className={s.frame()}>\n <Map {...map} label={label} center={camera} zoom={zoom} controlled onMoveEnd={(v) => onValueChange(v.center)} className=\"h-80\">\n {radius ? <RadiusCircle center={value} radius={radius} /> : null}\n {origin ? <UserPosition position={origin} label={labels.you} /> : null}\n </Map>\n <svg aria-hidden viewBox=\"0 0 24 32\" className={s.pin()} width=\"30\" height=\"40\">\n <path d=\"M12 0C5.4 0 0 5.2 0 11.7 0 20.4 12 32 12 32s12-11.6 12-20.3C24 5.2 18.6 0 12 0Z\" fill=\"currentColor\" />\n <circle cx=\"12\" cy=\"11.5\" r=\"4.5\" fill=\"var(--kz-on-accent)\" />\n </svg>\n <div className={s.bar()}>\n {distance ? (\n <span className={s.chip()} aria-live=\"polite\">\n {labels.distance(distance)}\n </span>\n ) : (\n <span />\n )}\n <button type=\"button\" className={s.near()} onClick={nearMe} disabled={status === \"locating\"} aria-describedby={message ? statusId : undefined}>\n <svg aria-hidden viewBox=\"0 0 24 24\" width=\"16\" height=\"16\" fill=\"none\" stroke=\"currentColor\" strokeWidth=\"2\" strokeLinecap=\"round\">\n <circle cx=\"12\" cy=\"12\" r=\"3.5\" />\n <path d=\"M12 2v3M12 19v3M2 12h3M19 12h3\" />\n </svg>\n {status === \"locating\" ? labels.locating : labels.nearMe}\n </button>\n </div>\n </div>\n <p id={statusId} className={s.status()} data-tone={status === \"denied\" || status === \"unavailable\" ? \"danger\" : undefined} aria-live=\"polite\">\n {message}\n </p>\n </div>\n );\n}\n"
1114
1114
  },
1115
1115
  {
1116
1116
  "path": "map/map.tsx",
1117
- "content": "// Client. A map of the Krizaka family on MapLibre GL JS (open source) over Protomaps tiles on our CDN — no API key, no\n// metered service. MapLibre and PMTiles are optional peers, loaded when a map is shown (a dynamic import: a page without\n// a map never pays for them). The style comes from the tokens (`mapStyle`), in the page's scheme, and follows it.\n//\n// What every map does: the canvas is decorative for assistive technologies — the map is a region named by `label`, its\n// places a list read in order (the text alternative, `MapPlaces`), each marker a button when it does something; the\n// attribution of OpenStreetMap (ODbL) and Protomaps is always shown; under reduced motion the camera jumps, never flies;\n// without WebGL (or while the engine loads) `fallback` stands in its place.\n/// <reference types=\"geojson\" />\nimport * as React from \"react\";\nimport { createPortal } from \"react-dom\";\n\nimport { usePrefersReducedMotion } from \"../media\";\nimport { tv } from \"../tv\";\nimport { MAP_ATTRIBUTION, setMapAssetsBase } from \"./assets\";\nimport { circlePolygon, type LngLat, pointAlong, sliceLine } from \"./geo\";\nimport { type MapBrand, mapPalette, type MapRegion, type MapScheme, mapStyle, type MapVariant } from \"./style\";\n\ntype MapLibre = typeof import(\"maplibre-gl\");\ntype MapInstance = import(\"maplibre-gl\").Map;\n\nexport const map = tv({\n slots: {\n root: \"relative isolate overflow-hidden rounded-2xl border border-border-default bg-surface-2 shadow-raised\",\n canvas: \"absolute inset-0 [&_.maplibregl-canvas]:outline-hidden\",\n fallback: \"absolute inset-0\",\n controls: \"absolute right-3 top-3 z-10 flex flex-col overflow-hidden rounded-xl border border-border-default bg-surface-1 shadow-floating\",\n control:\n \"inline-flex h-10 w-10 items-center justify-center text-lg font-semibold text-fg-secondary transition-colors hover:bg-surface-3 hover:text-fg \" +\n \"focus-visible:outline-hidden focus-visible:focus-ring-inset disabled:opacity-40 [&+&]:border-t [&+&]:border-border-subtle\",\n attribution:\n \"absolute bottom-1.5 right-1.5 z-10 rounded-md bg-surface-1 px-1.5 py-0.5 text-[10px] text-fg-secondary [&_a]:underline-offset-2 hover:[&_a]:underline\",\n places: \"sr-only\",\n marker:\n \"group relative flex -translate-y-1/2 cursor-pointer items-center justify-center rounded-full border-2 border-on-accent bg-accent shadow-floating outline-hidden \" +\n \"transition-transform hover:scale-110 focus-visible:focus-ring motion-reduce:transition-none motion-reduce:hover:scale-100 data-[selected]:scale-125\",\n markerLabel:\n \"pointer-events-none absolute bottom-full mb-2 whitespace-nowrap rounded-lg border border-border-default bg-surface-1 px-2 py-1 text-xs font-semibold text-fg shadow-floating\",\n },\n});\n\ntype Registry = { add: (id: string, text: string) => void; remove: (id: string) => void };\ntype Look = { scheme: \"dark\" | \"light\"; brand?: MapBrand; variant?: MapVariant };\ntype Ctx = { map: MapInstance | null; lib: MapLibre | null; ready: boolean; reduce: boolean; places: Registry; look: Look };\nconst MapContext = React.createContext<Ctx | null>(null);\n\n/** The map a child is drawn on (`Marker`, `RadiusCircle`, `Cluster`…): the MapLibre instance once it is ready. */\nexport function useMap(): Ctx {\n const ctx = React.useContext(MapContext);\n if (!ctx) throw new Error(\"useMap: inside a <Map> only\");\n return ctx;\n}\n\n/** The scheme of the page (`html.light`), followed as it changes. */\nfunction usePageScheme(): \"dark\" | \"light\" {\n const read = () => (typeof document !== \"undefined\" && document.documentElement.classList.contains(\"light\") ? \"light\" : \"dark\");\n const [scheme, setScheme] = React.useState<\"dark\" | \"light\">(read);\n React.useEffect(() => {\n const observer = new MutationObserver(() => setScheme(read()));\n observer.observe(document.documentElement, { attributes: true, attributeFilter: [\"class\"] });\n return () => observer.disconnect();\n }, []);\n return scheme;\n}\n\nlet protocolAdded = false;\nlet workerUrl: string | null = null;\n\n/**\n * Where MapLibre's worker comes from. A bundler (Next.js, Vite) renames MapLibre's module and leaves its worker behind:\n * by default the worker of the very version the app installed is imported from jsDelivr (free, open source, no key)\n * through a module worker of the page's own origin. An app with a strict CSP serves it itself —\n * `configureMaps({ workerUrl: \"/maplibre-gl-worker.mjs\" })` (with `maplibre-gl-shared.mjs` beside it), once, before a map.\n * `assetsBase` reads the tiles and glyphs through a same-origin proxy of the CDN (`setMapAssetsBase`).\n */\nexport function configureMaps(options: { workerUrl?: string; assetsBase?: string }) {\n if (options.workerUrl) workerUrl = options.workerUrl;\n if (options.assetsBase) setMapAssetsBase(options.assetsBase);\n}\n\n/** MapLibre, its worker and the PMTiles protocol, loaded once for the page. */\nasync function loadEngine(): Promise<MapLibre> {\n const [lib, pmtiles] = await Promise.all([import(\"maplibre-gl\"), import(\"pmtiles\")]);\n const ml = ((lib as unknown as { default?: MapLibre }).default ?? lib) as MapLibre;\n if (!protocolAdded) {\n protocolAdded = true;\n const remote = `https://cdn.jsdelivr.net/npm/maplibre-gl@${ml.getVersion()}/dist/maplibre-gl-worker.mjs`;\n ml.setWorkerUrl(workerUrl ?? URL.createObjectURL(new Blob([`import ${JSON.stringify(remote)};`], { type: \"text/javascript\" })));\n ml.addProtocol(\"pmtiles\", new pmtiles.Protocol().tile);\n }\n return ml;\n}\n\nconst hasWebGL = () => {\n try {\n const canvas = document.createElement(\"canvas\");\n return Boolean(canvas.getContext(\"webgl2\") ?? canvas.getContext(\"webgl\"));\n } catch {\n return false;\n }\n};\n\nexport type MapLabels = {\n /** The zoom-in button (\"Zoom in\"). */\n zoomIn: string;\n /** The zoom-out button (\"Zoom out\"). */\n zoomOut: string;\n /** Before the list of places read in place of the map (\"Places on the map\"). */\n places: string;\n /**\n * The words of the engine's overlay when the wheel turns over a map in a page (the page scrolls; the map zooms with Ctrl or ⌘,\n * or two fingers): MapLibre's `locale` keys `CooperativeGesturesHandler.WindowsHelpText`, `.MacHelpText` and `.MobileHelpText`.\n * Missing: the engine's English.\n */\n gestureHelp?: Partial<Record<`CooperativeGesturesHandler.${\"Windows\" | \"Mac\" | \"Mobile\"}HelpText`, string>>;\n};\n\nexport const mapLabels: MapLabels = {\n zoomIn: \"Zoom in\",\n zoomOut: \"Zoom out\",\n places: \"Places on the map\",\n};\n\n/** Who owns the gestures: `page` (default) lets the wheel and one finger scroll the page; `map` is for a map that is the screen. */\nexport type MapGestures = \"page\" | \"map\";\n\n\nexport type MapProps = {\n /** The map's accessible name (\"Pick-up points near you\"), passed translated. */\n label: string;\n /** Where the map looks at first: longitude, latitude. */\n center: LngLat;\n /** The zoom at first (0 the world, 12 a city, 16 a street). Default 12. */\n zoom?: number;\n /** The camera follows `center` and `zoom` when they change (flies, or jumps under reduced motion). */\n controlled?: boolean;\n /** The scheme: `auto` (default) follows the page (`html.light`) as it changes; `dark` or `light` pins it. */\n scheme?: MapScheme;\n /** The look: `plain` (default), `notebook` (the Cahier: paper and ink, manila tags for clusters). */\n variant?: MapVariant;\n /** The product whose accent the map carries. Default `krizaka`. */\n brand?: MapBrand;\n /** The language of the labels (`fr`, `en`). Default `en`. */\n lang?: string;\n /** The detailed region (PMTiles) drawn from zoom 6.5. Default: our Montréal–Québec extract (to zoom 14). */\n region?: MapRegion | null;\n /** The world's low zooms (PMTiles). Default: our world extract (to zoom 6). */\n world?: MapRegion | null;\n /**\n * Who owns the wheel and the fingers. `page` (default): the wheel and one finger scroll the page past the map; the map zooms\n * with Ctrl/⌘ + wheel, two fingers and the buttons, and a short hint says so. `map`: the map is the screen (full height) and\n * takes every gesture.\n */\n gestures?: MapGestures;\n /** The zoom buttons (default) — the keyboard also zooms with + and − on the focused map. */\n controls?: boolean;\n /** Moves with the hand (default); `false` makes a still picture of a place. */\n interactive?: boolean;\n /** Shown in place of the map while its engine loads, and for good without WebGL: a `StaticMap`, a picture. */\n fallback?: React.ReactNode;\n /** Called when the camera rests: its centre and zoom. */\n onMoveEnd?: (view: { center: LngLat; zoom: number }) => void;\n /** Called with the position pressed on the map (not on a marker). */\n onPress?: (position: LngLat) => void;\n /** Markers, circles, clusters, the user's position — and anything drawn over the map. */\n children?: React.ReactNode;\n /** The words, passed translated; English by default. */\n labels?: Partial<MapLabels>;\n /** Classes merged on the root (its height: `h-80`, `aspect-video`). */\n className?: string;\n};\n\n/** A map: MapLibre over our Protomaps tiles, styled from the tokens, with its places as a list for screen readers. */\nfunction MapRoot({\n label,\n center,\n zoom = 12,\n controlled,\n scheme: schemeProp = \"auto\",\n variant,\n brand,\n lang,\n region,\n world,\n gestures = \"page\",\n controls = true,\n interactive = true,\n fallback,\n onMoveEnd,\n onPress,\n children,\n labels: given,\n className,\n}: Readonly<MapProps>) {\n const labels = { ...mapLabels, ...given };\n const s = map();\n const pageScheme = usePageScheme();\n const scheme = schemeProp === \"auto\" ? pageScheme : schemeProp;\n const reduce = usePrefersReducedMotion();\n const host = React.useRef<HTMLDivElement>(null);\n const [instance, setInstance] = React.useState<MapInstance | null>(null);\n const [lib, setLib] = React.useState<MapLibre | null>(null);\n const [ready, setReady] = React.useState(false);\n const [failed, setFailed] = React.useState(false);\n const [places, setPlaces] = React.useState<Record<string, string>>({});\n const registry = React.useMemo<Registry>(\n () => ({\n add: (id, text) => setPlaces((p) => (p[id] === text ? p : { ...p, [id]: text })),\n remove: (id) =>\n setPlaces((p) => {\n const { [id]: _gone, ...rest } = p;\n return rest;\n }),\n }),\n [],\n );\n const latest = React.useRef({ onMoveEnd, onPress });\n React.useEffect(() => {\n latest.current = { onMoveEnd, onPress };\n });\n const styleOf = React.useCallback((sc: \"dark\" | \"light\") => mapStyle({ scheme: sc, brand, variant, lang, ...(region !== undefined ? { region } : {}), ...(world !== undefined ? { world } : {}) }), [brand, variant, lang, region, world]);\n\n // The style the map wears now: the engine loads asynchronously, so the scheme it is created with is read when it is ready\n // (the page's theme may have flipped since the first render), and the effect below applies whatever differs.\n const wanted = React.useRef({ scheme, styleOf });\n React.useEffect(() => {\n wanted.current = { scheme, styleOf };\n });\n const applied = React.useRef<{ scheme: \"dark\" | \"light\"; styleOf: typeof styleOf } | null>(null);\n\n // The engine and the map, once (the style follows the scheme below).\n React.useEffect(() => {\n if (!host.current) return;\n let alive = true;\n let created: MapInstance | null = null;\n (hasWebGL() ? loadEngine() : Promise.reject(new Error(\"no WebGL\")))\n .then((ml) => {\n if (!alive || !host.current) return;\n applied.current = wanted.current;\n created = new ml.Map({\n container: host.current,\n style: wanted.current.styleOf(wanted.current.scheme) as never,\n center: [...center] as [number, number],\n zoom,\n interactive,\n attributionControl: false,\n fadeDuration: reduce ? 0 : 300,\n cooperativeGestures: gestures === \"page\",\n // The engine's own overlay (styled in motion.css) says it in the words given; its English is the default.\n locale: labels.gestureHelp,\n // The engine's own overlay (styled in motion.css) says it in the words given; its English is the default.\n });\n created.getCanvas().setAttribute(\"aria-hidden\", \"true\");\n created.getCanvas().setAttribute(\"tabindex\", \"-1\");\n created.on(\"load\", () => alive && setReady(true));\n // The basemap cannot be read (offline, a blocked request): the fallback comes back rather than an empty map.\n created.on(\"error\", (e) => {\n const source = (e as { sourceId?: string }).sourceId;\n if (alive && (source === \"world\" || source === \"region\")) setFailed(true);\n });\n created.on(\"moveend\", () => {\n const c = created!.getCenter();\n latest.current.onMoveEnd?.({ center: [c.lng, c.lat], zoom: created!.getZoom() });\n });\n created.on(\"click\", (e) => {\n if ((e.originalEvent.target as Element | null)?.closest?.(\"[data-kz-marker]\")) return;\n latest.current.onPress?.([e.lngLat.lng, e.lngLat.lat]);\n });\n setLib(ml);\n setInstance(created);\n })\n .catch(() => alive && setFailed(true));\n return () => {\n alive = false;\n created?.remove();\n };\n // Created once: the props that change afterwards are followed by the effects below.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n // The scheme (and the brand, the language) change the style, not the map.\n React.useEffect(() => {\n if (!instance) return;\n if (applied.current?.scheme === scheme && applied.current.styleOf === styleOf) return;\n applied.current = { scheme, styleOf };\n instance.setStyle(styleOf(scheme) as never);\n }, [instance, scheme, styleOf]);\n\n // A controlled camera: it flies (or jumps) to the new view.\n React.useEffect(() => {\n if (!instance || !controlled) return;\n const view = { center: [...center] as [number, number], zoom };\n if (reduce) instance.jumpTo(view);\n else instance.flyTo({ ...view, speed: 1.4 });\n }, [instance, controlled, center[0], center[1], zoom, reduce]); // eslint-disable-line react-hooks/exhaustive-deps\n\n const zoomBy = (by: number) => instance && (reduce ? instance.setZoom(instance.getZoom() + by) : instance.zoomTo(instance.getZoom() + by, { duration: 250 }));\n const ctx = React.useMemo<Ctx>(() => ({ map: instance, lib, ready, reduce, places: registry, look: { scheme, brand, variant } }), [instance, lib, ready, reduce, registry, scheme, brand, variant]);\n const listed = Object.entries(places);\n return (\n <MapContext.Provider value={ctx}>\n <section\n aria-label={label}\n className={s.root({ className })}\n data-ready={ready ? \"\" : undefined}\n tabIndex={interactive ? 0 : undefined}\n onKeyDown={(e) => {\n if (e.target !== e.currentTarget || !instance) return;\n if (e.key === \"+\" || e.key === \"=\") zoomBy(1);\n else if (e.key === \"-\") zoomBy(-1);\n else if (e.key.startsWith(\"Arrow\")) {\n e.preventDefault();\n const step = 80;\n const by: Record<string, [number, number]> = { ArrowUp: [0, -step], ArrowDown: [0, step], ArrowLeft: [-step, 0], ArrowRight: [step, 0] };\n instance.panBy(by[e.key]!, { duration: reduce ? 0 : 200 });\n }\n }}\n >\n {!ready || failed ? <div className={s.fallback()}>{fallback}</div> : null}\n <div ref={host} className={s.canvas()} style={{ position: \"absolute\", inset: 0, visibility: failed ? \"hidden\" : undefined }} />\n {controls && interactive && !failed ? (\n <div className={s.controls()}>\n <button type=\"button\" className={s.control()} aria-label={labels.zoomIn} disabled={!instance} onClick={() => zoomBy(1)}>\n +\n </button>\n <button type=\"button\" className={s.control()} aria-label={labels.zoomOut} disabled={!instance} onClick={() => zoomBy(-1)}>\n −\n </button>\n </div>\n ) : null}\n <p className={s.attribution()}>\n <a href={MAP_ATTRIBUTION.protomapsUrl} target=\"_blank\" rel=\"noreferrer\">\n {MAP_ATTRIBUTION.protomaps}\n </a>\n {\" · \"}\n <a href={MAP_ATTRIBUTION.osmUrl} target=\"_blank\" rel=\"noreferrer\">\n {MAP_ATTRIBUTION.osm}\n </a>\n </p>\n {listed.length ? (\n <div className={s.places()}>\n <p>{labels.places}</p>\n <ul>\n {listed.map(([id, text]) => (\n <li key={id}>{text}</li>\n ))}\n </ul>\n </div>\n ) : null}\n {children}\n </section>\n </MapContext.Provider>\n );\n}\n\nexport type MarkerProps = {\n /** Where it stands. */\n position: LngLat;\n /** Its words: the place's name, read in the list of places and as the button's name (\"Café Olimpico, 350 m\"). */\n label: string;\n /** Pressing it (details in a panel, a sheet): the marker becomes a button. */\n onPress?: () => void;\n /** The chosen one: larger, its label shown above it. */\n selected?: boolean;\n /** Its size in pixels. Default 18. */\n size?: number;\n /** What it draws instead of the accent dot (an avatar, an icon). */\n children?: React.ReactNode;\n /** Drops onto its place once, after this many milliseconds (stagger several: `index * 90`). Still under reduced motion. */\n drop?: number;\n};\n\n/** Lists a place for screen readers while the component stands. */\nfunction usePlace(id: string, label: string, places: Registry) {\n React.useEffect(() => {\n places.add(id, label);\n return () => places.remove(id);\n }, [id, label, places]);\n}\n\nconst noSubscription = () => () => undefined;\n\n/** A place on the map: an accent dot (or your content) that is a button when it does something. */\nexport function Marker({ position, label, onPress, selected, size = 18, children, drop }: MarkerProps) {\n const { map: m, lib, places } = useMap();\n const s = map();\n const id = React.useId();\n // The marker's host element exists only in a browser: the server and the hydration pass render nothing for it, then the\n // client swaps in the element — `useSyncExternalStore`'s server snapshot, so hydration never sees a difference.\n const host = React.useRef<HTMLElement | null>(null);\n const el = React.useSyncExternalStore(\n noSubscription,\n () => (host.current ??= document.createElement(\"div\")),\n () => null,\n );\n usePlace(id, label, places);\n React.useEffect(() => {\n if (!m || !lib || !el) return;\n el.setAttribute(\"data-kz-marker\", \"\");\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...position] as [number, number]).addTo(m);\n return () => void marker.remove();\n }, [m, lib, el, position[0], position[1]]); // eslint-disable-line react-hooks/exhaustive-deps\n if (!el) return null;\n const Tag = onPress ? \"button\" : \"span\";\n return createPortal(\n <Tag\n type={onPress ? \"button\" : undefined}\n aria-label={onPress ? label : undefined}\n aria-hidden={onPress ? undefined : true}\n aria-pressed={onPress && selected !== undefined ? selected : undefined}\n data-selected={selected ? \"\" : undefined}\n data-drop={drop === undefined ? undefined : \"\"}\n className={s.marker()}\n style={{ ...(children ? null : { width: size, height: size }), ...(drop === undefined ? null : ({ \"--kz-map-drop-delay\": `${drop}ms` } as React.CSSProperties)) }}\n onClick={onPress}\n >\n {children}\n {selected ? <span className={s.markerLabel()}>{label}</span> : null}\n </Tag>,\n el,\n );\n}\n\nexport type UserPositionProps = {\n /** Where the person is. */\n position: LngLat;\n /** Its words (\"You are here\"), read in the list of places. */\n label: string;\n /** The accuracy in metres: a soft disc around the dot. */\n accuracy?: number;\n};\n\n/** The person's position: a dot that pulses (still under reduced motion), its accuracy as a soft disc. */\nexport function UserPosition({ position, label, accuracy }: UserPositionProps) {\n const { map: m, lib, places } = useMap();\n const id = React.useId();\n usePlace(id, label, places);\n React.useEffect(() => {\n if (!m || !lib) return;\n const el = document.createElement(\"div\");\n el.className = \"kz-map-user\";\n el.setAttribute(\"aria-hidden\", \"true\");\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...position] as [number, number]).addTo(m);\n return () => void marker.remove();\n }, [m, lib, position[0], position[1]]); // eslint-disable-line react-hooks/exhaustive-deps\n return accuracy ? <RadiusCircle center={position} radius={accuracy} tone=\"soft\" /> : null;\n}\n\nexport type PulseProps = {\n /** Where it beats. */\n position: LngLat;\n /** Its words (\"High demand in Mile End\"), read in the list of places. */\n label: string;\n /** The rings' reach in pixels. Default 56. */\n size?: number;\n /** `accent` (a zone that matters) or `soft`. Default `accent`. */\n tone?: \"accent\" | \"soft\";\n};\n\n/** A heat pulse: rings that swell and fade around a place (a hot spot, a demand peak). Still rings under reduced motion. */\nexport function Pulse({ position, label, size = 56, tone = \"accent\" }: PulseProps) {\n const { map: m, lib, places } = useMap();\n const id = React.useId();\n usePlace(id, label, places);\n React.useEffect(() => {\n if (!m || !lib) return;\n const el = document.createElement(\"div\");\n el.className = \"kz-map-pulse\";\n el.setAttribute(\"data-tone\", tone);\n el.setAttribute(\"aria-hidden\", \"true\");\n el.style.setProperty(\"--kz-map-pulse-size\", `${size}px`);\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...position] as [number, number]).addTo(m);\n return () => void marker.remove();\n }, [m, lib, tone, size, position[0], position[1]]); // eslint-disable-line react-hooks/exhaustive-deps\n return null;\n}\n\nexport type RouteProps = {\n /** The path, as positions in order (a polyline: a delivery, a walk, a flight). */\n path: readonly LngLat[];\n /** Its words (\"Delivery from the studio to Mile End, 2.4 km\"), read in the list of places. */\n label: string;\n /** The line draws itself once, from its start, when the map is on screen; `false` shows it whole. Default `true`. */\n draw?: boolean;\n /** How long the drawing lasts, in milliseconds. Default 1400. */\n duration?: number;\n /** A dot that travels the route once drawn (`true`, or your own content: an avatar, an icon). */\n courier?: boolean | React.ReactNode;\n /** How long a trip takes, in milliseconds. Default 3200. */\n tripDuration?: number;\n /** Start the trips again after a pause (milliseconds), only while the map is on screen. Without it the courier makes one trip. */\n repeatAfter?: number;\n /** Changing it replays the drawing and the trip. */\n replayKey?: string | number;\n /** `accent` or `soft`. Default `accent`. */\n tone?: \"accent\" | \"soft\";\n /** The timing function of the drawing and of the trips: `ease-out`, `linear`, `ease-in-out`. Default: out for the drawing, in-out for a trip. */\n easing?: \"ease-out\" | \"linear\" | \"ease-in-out\";\n /** Holds the drawing and the trips where they are (a controlled pause, on top of the off-screen one). */\n paused?: boolean;\n};\n\nconst ROUTE_CURVES = {\n linear: (t: number) => t,\n \"ease-out\": (t: number) => 1 - (1 - t) ** 3,\n \"ease-in-out\": (t: number) => (t < 0.5 ? 2 * t * t : 1 - (-2 * t + 2) ** 2 / 2),\n} as const;\n\ntype RouteSource = { setData?: (d: GeoJSON.GeoJSON) => void };\n\n/** A route on the map: a line that draws itself, and a courier that travels it. Under reduced motion the line is whole and the courier rests at the end. */\nexport function Route({ path, label, draw = true, duration = 1400, courier, tripDuration = 3200, repeatAfter, replayKey, tone = \"accent\", easing, paused = false }: RouteProps) {\n const { map: m, lib, ready, reduce, places } = useMap();\n const id = `kz-route-${React.useId().replace(/[^a-zA-Z0-9]/g, \"\")}`;\n const animated = draw && !reduce;\n // The drawing is done for this `replayKey` (a new key draws again); without animation the line is whole at once.\n const token = replayKey ?? 0;\n const [doneFor, setDoneFor] = React.useState<string | number | null>(null);\n const drawn = !animated || doneFor === token;\n const whole = React.useMemo(() => sliceLine(path, 1), [path]);\n const start = React.useMemo(() => sliceLine(path, 0), [path]);\n usePlace(id, label, places);\n useGeoLayer(id, drawn ? whole : start, (c) => [\n { id: `${id}-casing`, type: \"line\", source: id, layout: { \"line-cap\": \"round\", \"line-join\": \"round\" }, paint: { \"line-color\": c.accent, \"line-width\": 9, \"line-opacity\": tone === \"soft\" ? 0.08 : 0.16, \"line-blur\": 3 } },\n { id: `${id}-line`, type: \"line\", source: id, layout: { \"line-cap\": \"round\", \"line-join\": \"round\" }, paint: { \"line-color\": c.accent, \"line-width\": tone === \"soft\" ? 2 : 3.5, \"line-opacity\": tone === \"soft\" ? 0.6 : 1 } },\n ]);\n // Is the map on screen? The drawing waits for it, and a repeating trip does not start while it is not.\n const [seen, setSeen] = React.useState(() => typeof IntersectionObserver === \"undefined\");\n const visible = seen && !paused;\n React.useEffect(() => {\n const el = m?.getContainer?.();\n if (!el || typeof IntersectionObserver === \"undefined\") return;\n const io = new IntersectionObserver(([entry]) => setSeen(!!entry?.isIntersecting), { threshold: 0.25 });\n io.observe(el);\n return () => io.disconnect();\n }, [m]);\n // The drawing: a finite animation, one frame per paint for `duration` ms — no loop, nothing runs afterwards.\n React.useEffect(() => {\n if (!m || !ready || !animated || drawn || !visible) return;\n const source = m.getSource(id) as RouteSource | undefined;\n let frame = 0;\n const began = performance.now();\n const step = (now: number) => {\n const t = Math.min(1, (now - began) / Math.max(1, duration));\n source?.setData?.(sliceLine(path, ROUTE_CURVES[easing ?? \"ease-out\"](t)));\n if (t < 1) frame = requestAnimationFrame(step);\n else setDoneFor(token);\n };\n frame = requestAnimationFrame(step);\n return () => cancelAnimationFrame(frame);\n }, [m, ready, animated, drawn, visible, id, path, duration, token, easing]);\n // The courier: one trip once the line is drawn (finite frames), again after `repeatAfter` while on screen.\n const [trip, setTrip] = React.useState(0);\n React.useEffect(() => {\n if (!courier || !m || !lib || !ready || !drawn) return;\n const el = document.createElement(\"div\");\n el.className = \"kz-map-courier\";\n el.setAttribute(\"aria-hidden\", \"true\");\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...(path[reduce ? path.length - 1 : 0] ?? [0, 0])] as [number, number]).addTo(m);\n let frame = 0;\n let timer: ReturnType<typeof setTimeout> | undefined;\n if (!reduce && visible) {\n const began = performance.now();\n const step = (now: number) => {\n const t = Math.min(1, (now - began) / Math.max(1, tripDuration));\n const eased = ROUTE_CURVES[easing ?? \"ease-in-out\"](t);\n marker.setLngLat([...pointAlong(path, eased).position] as [number, number]);\n if (t < 1) frame = requestAnimationFrame(step);\n else if (repeatAfter !== undefined) timer = setTimeout(() => setTrip((n) => n + 1), repeatAfter);\n };\n frame = requestAnimationFrame(step);\n } else if (!reduce) marker.setLngLat([...(path[path.length - 1] ?? [0, 0])] as [number, number]);\n return () => {\n cancelAnimationFrame(frame);\n clearTimeout(timer);\n marker.remove();\n };\n }, [courier, m, lib, ready, drawn, visible, reduce, path, tripDuration, repeatAfter, trip, token, easing]);\n return null;\n}\n\n/** Adds a GeoJSON source and its layers while the map has a style (again after a change of scheme). */\nfunction useGeoLayer(id: string, data: GeoJSON.GeoJSON, layers: (palette: ReturnType<typeof mapPalette>) => object[], source: object = {}) {\n const { map: m, ready, look: { scheme, brand, variant } } = useMap();\n const dataRef = React.useRef(data);\n React.useEffect(() => {\n dataRef.current = data;\n const src = m?.getSource(id) as { setData?: (d: GeoJSON.GeoJSON) => void } | undefined;\n src?.setData?.(data);\n }, [m, id, data]);\n React.useEffect(() => {\n if (!m || !ready) return;\n const add = () => {\n if (m.getSource(id)) return;\n m.addSource(id, { type: \"geojson\", data: dataRef.current, ...source } as never);\n for (const layer of layers(mapPalette(scheme, brand, variant))) m.addLayer(layer as never);\n };\n add();\n m.on(\"styledata\", add);\n return () => {\n m.off(\"styledata\", add);\n if (!m.getStyle()) return;\n for (const layer of m.getStyle().layers.filter((l) => \"source\" in l && l.source === id)) m.removeLayer(layer.id);\n if (m.getSource(id)) m.removeSource(id);\n };\n }, [m, ready, id, scheme, brand, variant]); // eslint-disable-line react-hooks/exhaustive-deps\n}\n\nexport type RadiusCircleProps = {\n /** Its centre. */\n center: LngLat;\n /** Its radius in metres. */\n radius: number;\n /** `accent` (a zone that matters: a delivery area, a search radius) or `soft` (an accuracy). */\n tone?: \"accent\" | \"soft\";\n};\n\n/** A circle on the ground: a delivery zone, a search radius — filled with the accent, its edge drawn. */\nexport function RadiusCircle({ center, radius, tone = \"accent\" }: RadiusCircleProps) {\n const id = `kz-circle-${React.useId().replace(/[^a-zA-Z0-9]/g, \"\")}`;\n const data = React.useMemo(() => circlePolygon(center, radius), [center[0], center[1], radius]); // eslint-disable-line react-hooks/exhaustive-deps\n useGeoLayer(id, data, (c) => [\n { id: `${id}-fill`, type: \"fill\", source: id, paint: { \"fill-color\": c.accent, \"fill-opacity\": tone === \"soft\" ? 0.1 : 0.14 } },\n { id: `${id}-line`, type: \"line\", source: id, paint: { \"line-color\": c.accent, \"line-width\": tone === \"soft\" ? 1 : 2, \"line-opacity\": tone === \"soft\" ? 0.4 : 0.9, ...(tone === \"accent\" ? { \"line-dasharray\": [2, 1.5] } : {}) } },\n ]);\n return null;\n}\n\nexport type ClusterPoint = { id: string; position: LngLat; label: string };\n\nexport type ClusterProps = {\n /** The points: many of them (creators, pick-up points, events). */\n points: readonly ClusterPoint[];\n /** Pressing a single point. A group zooms in to open itself. */\n onPointPress?: (point: ClusterPoint) => void;\n /** The radius, in pixels, within which points group. Default 48. */\n radius?: number;\n};\n\n/** Many points grouped while they are close: a disc with the count, opened by zooming in; each point is listed for screen readers. */\nexport function Cluster({ points, onPointPress, radius = 48 }: ClusterProps) {\n const { map: m, ready, reduce, places } = useMap();\n const id = `kz-cluster-${React.useId().replace(/[^a-zA-Z0-9]/g, \"\")}`;\n const data = React.useMemo<GeoJSON.FeatureCollection>(\n () => ({ type: \"FeatureCollection\", features: points.map((p) => ({ type: \"Feature\", properties: { id: p.id, label: p.label }, geometry: { type: \"Point\", coordinates: [...p.position] } })) }),\n [points],\n );\n React.useEffect(() => {\n for (const p of points) places.add(`${id}-${p.id}`, p.label);\n return () => points.forEach((p) => places.remove(`${id}-${p.id}`));\n }, [points, places, id]);\n useGeoLayer(\n id,\n data,\n (c) => [\n { id: `${id}-groups`, type: \"circle\", source: id, filter: [\"has\", \"point_count\"], paint: { \"circle-color\": c.cluster.fill, \"circle-opacity\": 0.95, \"circle-radius\": [\"step\", [\"get\", \"point_count\"], 16, 10, 20, 50, 26], \"circle-stroke-width\": 3, \"circle-stroke-color\": c.cluster.stroke } },\n { id: `${id}-count`, type: \"symbol\", source: id, filter: [\"has\", \"point_count\"], layout: { \"text-field\": [\"get\", \"point_count_abbreviated\"], \"text-font\": [\"Noto Sans Medium\"], \"text-size\": 13 }, paint: { \"text-color\": c.cluster.text } },\n { id: `${id}-points`, type: \"circle\", source: id, filter: [\"!\", [\"has\", \"point_count\"]], paint: { \"circle-color\": c.point.fill, \"circle-radius\": 7, \"circle-stroke-width\": 2.5, \"circle-stroke-color\": c.point.stroke } },\n ],\n { cluster: true, clusterRadius: radius, clusterMaxZoom: 15 },\n );\n React.useEffect(() => {\n if (!m || !ready) return;\n const openGroup = async (e: { features?: { properties: Record<string, unknown>; geometry: GeoJSON.Geometry }[] }) => {\n const f = e.features?.[0];\n if (!f) return;\n const src = m.getSource(id) as unknown as { getClusterExpansionZoom: (id: number) => Promise<number> };\n const z = await src.getClusterExpansionZoom(f.properties.cluster_id as number);\n const center = (f.geometry as GeoJSON.Point).coordinates as [number, number];\n if (reduce) m.jumpTo({ center, zoom: z });\n else m.easeTo({ center, zoom: z });\n };\n const pressPoint = (e: { features?: { properties: Record<string, unknown> }[] }) => {\n const pid = e.features?.[0]?.properties.id;\n const point = points.find((p) => p.id === pid);\n if (point) onPointPress?.(point);\n };\n m.on(\"click\", `${id}-groups`, openGroup as never);\n m.on(\"click\", `${id}-points`, pressPoint as never);\n return () => {\n m.off(\"click\", `${id}-groups`, openGroup as never);\n m.off(\"click\", `${id}-points`, pressPoint as never);\n };\n }, [m, ready, id, points, onPointPress, reduce]);\n return null;\n}\n\nexport { MapRoot as Map };\n"
1117
+ "content": "// Client. A map of the Krizaka family on MapLibre GL JS (open source) over Protomaps tiles on our CDN — no API key, no\n// metered service. MapLibre and PMTiles are optional peers, loaded when a map is shown (a dynamic import: a page without\n// a map never pays for them). The style comes from the tokens (`mapStyle`), in the page's scheme, and follows it.\n//\n// What every map does: the canvas is decorative for assistive technologies — the map is a region named by `label`, its\n// places a list read in order (the text alternative, `MapPlaces`), each marker a button when it does something; the\n// attribution of OpenStreetMap (ODbL) and Protomaps is always shown; under reduced motion the camera jumps, never flies;\n// without WebGL (or while the engine loads) `fallback` stands in its place.\n/// <reference types=\"geojson\" />\nimport * as React from \"react\";\nimport { createPortal } from \"react-dom\";\n\nimport { usePrefersReducedMotion } from \"../media\";\nimport { tv } from \"../tv\";\nimport { MAP_ATTRIBUTION, setMapAssetsBase } from \"./assets\";\nimport { circlePolygon, type LngLat, pointAlong, sliceLine } from \"./geo\";\nimport { type MapBrand, mapPalette, type MapRegion, type MapScheme, mapStyle, type MapVariant } from \"./style\";\n\ntype MapLibre = typeof import(\"maplibre-gl\");\ntype MapInstance = import(\"maplibre-gl\").Map;\n\nexport const map = tv({\n slots: {\n root: \"relative isolate overflow-hidden rounded-2xl border border-border-default bg-surface-2 shadow-raised\",\n canvas: \"absolute inset-0 [&_.maplibregl-canvas]:outline-hidden\",\n fallback: \"absolute inset-0\",\n controls: \"absolute right-3 top-3 z-10 flex flex-col overflow-hidden rounded-xl border border-border-default bg-surface-1 shadow-floating\",\n control:\n \"inline-flex h-10 w-10 items-center justify-center text-lg font-semibold text-fg-secondary transition-colors hover:bg-surface-3 hover:text-fg \" +\n \"focus-visible:outline-hidden focus-visible:focus-ring-inset disabled:opacity-40 [&+&]:border-t [&+&]:border-border-subtle\",\n attribution:\n \"absolute bottom-1.5 right-1.5 z-10 rounded-md bg-surface-1 px-1.5 py-0.5 text-[10px] text-fg-secondary [&_a]:underline-offset-2 hover:[&_a]:underline\",\n places: \"sr-only\",\n marker:\n \"group relative flex -translate-y-1/2 cursor-pointer items-center justify-center rounded-full border-2 border-on-accent bg-accent shadow-floating outline-hidden \" +\n \"transition-transform hover:scale-110 focus-visible:focus-ring motion-reduce:transition-none motion-reduce:hover:scale-100 data-[selected]:scale-125\",\n markerLabel:\n \"pointer-events-none absolute bottom-full mb-2 whitespace-nowrap rounded-lg border border-border-default bg-surface-1 px-2 py-1 text-xs font-semibold text-fg shadow-floating\",\n },\n});\n\ntype Registry = { add: (id: string, text: string) => void; remove: (id: string) => void };\ntype Look = { scheme: \"dark\" | \"light\"; brand?: MapBrand; variant?: MapVariant };\ntype Ctx = { map: MapInstance | null; lib: MapLibre | null; ready: boolean; reduce: boolean; places: Registry; look: Look };\nconst MapContext = React.createContext<Ctx | null>(null);\n\n/** The map a child is drawn on (`Marker`, `RadiusCircle`, `Cluster`…): the MapLibre instance once it is ready. */\nexport function useMap(): Ctx {\n const ctx = React.useContext(MapContext);\n if (!ctx) throw new Error(\"useMap: inside a <Map> only\");\n return ctx;\n}\n\n/** The scheme of the page (`html.light`), followed as it changes. */\nfunction usePageScheme(): \"dark\" | \"light\" {\n const read = () => (typeof document !== \"undefined\" && document.documentElement.classList.contains(\"light\") ? \"light\" : \"dark\");\n const [scheme, setScheme] = React.useState<\"dark\" | \"light\">(read);\n React.useEffect(() => {\n const observer = new MutationObserver(() => setScheme(read()));\n observer.observe(document.documentElement, { attributes: true, attributeFilter: [\"class\"] });\n return () => observer.disconnect();\n }, []);\n return scheme;\n}\n\nlet protocolAdded = false;\nlet workerUrl: string | null = null;\n\n/**\n * Where MapLibre's worker comes from. A bundler (Next.js, Vite) renames MapLibre's module and leaves its worker behind:\n * by default the worker of the very version the app installed is imported from jsDelivr (free, open source, no key)\n * through a module worker of the page's own origin. An app with a strict CSP serves it itself —\n * `configureMaps({ workerUrl: \"/maplibre-gl-worker.mjs\" })` (with `maplibre-gl-shared.mjs` beside it), once, before a map.\n * `assetsBase` reads the tiles and glyphs through a same-origin proxy of the CDN (`setMapAssetsBase`).\n */\nexport function configureMaps(options: { workerUrl?: string; assetsBase?: string }) {\n if (options.workerUrl) workerUrl = options.workerUrl;\n if (options.assetsBase) setMapAssetsBase(options.assetsBase);\n}\n\n/** MapLibre, its worker and the PMTiles protocol, loaded once for the page. */\nasync function loadEngine(): Promise<MapLibre> {\n const [lib, pmtiles] = await Promise.all([import(\"maplibre-gl\"), import(\"pmtiles\")]);\n const ml = ((lib as unknown as { default?: MapLibre }).default ?? lib) as MapLibre;\n if (!protocolAdded) {\n protocolAdded = true;\n const remote = `https://cdn.jsdelivr.net/npm/maplibre-gl@${ml.getVersion()}/dist/maplibre-gl-worker.mjs`;\n ml.setWorkerUrl(workerUrl ?? URL.createObjectURL(new Blob([`import ${JSON.stringify(remote)};`], { type: \"text/javascript\" })));\n ml.addProtocol(\"pmtiles\", new pmtiles.Protocol().tile);\n }\n return ml;\n}\n\nconst hasWebGL = () => {\n try {\n const canvas = document.createElement(\"canvas\");\n return Boolean(canvas.getContext(\"webgl2\") ?? canvas.getContext(\"webgl\"));\n } catch {\n return false;\n }\n};\n\nexport type MapLabels = {\n /** The zoom-in button (\"Zoom in\"). */\n zoomIn: string;\n /** The zoom-out button (\"Zoom out\"). */\n zoomOut: string;\n /** Before the list of places read in place of the map (\"Places on the map\"). */\n places: string;\n /**\n * The words of the engine's overlay when the wheel turns over a map in a page (the page scrolls; the map zooms with Ctrl or ⌘,\n * or two fingers): MapLibre's `locale` keys `CooperativeGesturesHandler.WindowsHelpText`, `.MacHelpText` and `.MobileHelpText`.\n * Missing: the engine's English.\n */\n gestureHelp?: Partial<Record<`CooperativeGesturesHandler.${\"Windows\" | \"Mac\" | \"Mobile\"}HelpText`, string>>;\n};\n\nexport const mapLabels: MapLabels = {\n zoomIn: \"Zoom in\",\n zoomOut: \"Zoom out\",\n places: \"Places on the map\",\n};\n\n/** Who owns the gestures: `page` (default) lets the wheel and one finger scroll the page; `map` is for a map that is the screen. */\nexport type MapGestures = \"page\" | \"map\";\n\nexport type MapProps = {\n /** The map's accessible name (\"Pick-up points near you\"), passed translated. */\n label: string;\n /** Where the map looks at first: longitude, latitude. */\n center: LngLat;\n /** The zoom at first (0 the world, 12 a city, 16 a street). Default 12. */\n zoom?: number;\n /** The camera follows `center` and `zoom` when they change (flies, or jumps under reduced motion). */\n controlled?: boolean;\n /** The scheme: `auto` (default) follows the page (`html.light`) as it changes; `dark` or `light` pins it. */\n scheme?: MapScheme;\n /** The look: `plain` (default), `notebook` (the Cahier: paper and ink, manila tags for clusters). */\n variant?: MapVariant;\n /** The product whose accent the map carries. Default `krizaka`. */\n brand?: MapBrand;\n /** The language of the labels (`fr`, `en`). Default `en`. */\n lang?: string;\n /** The detailed region (PMTiles) drawn from zoom 6.5. Default: our Montréal–Québec extract (to zoom 14). */\n region?: MapRegion | null;\n /** The world's low zooms (PMTiles). Default: our world extract (to zoom 6). */\n world?: MapRegion | null;\n /**\n * Who owns the wheel and the fingers. `page` (default): the wheel and one finger scroll the page past the map; the map zooms\n * with Ctrl/⌘ + wheel, two fingers and the buttons, and a short hint says so. `map`: the map is the screen (full height) and\n * takes every gesture.\n */\n gestures?: MapGestures;\n /** The zoom buttons (default) — the keyboard also zooms with + and − on the focused map. */\n controls?: boolean;\n /** Moves with the hand (default); `false` makes a still picture of a place. */\n interactive?: boolean;\n /** Shown in place of the map while its engine loads, and for good without WebGL: a `StaticMap`, a picture. */\n fallback?: React.ReactNode;\n /** Called when the camera rests: its centre and zoom. */\n onMoveEnd?: (view: { center: LngLat; zoom: number }) => void;\n /** Called with the position pressed on the map (not on a marker). */\n onPress?: (position: LngLat) => void;\n /** Markers, circles, clusters, the user's position — and anything drawn over the map. */\n children?: React.ReactNode;\n /** The words, passed translated; English by default. */\n labels?: Partial<MapLabels>;\n /** Classes merged on the root (its height: `h-80`, `aspect-video`). */\n className?: string;\n};\n\n/** A map: MapLibre over our Protomaps tiles, styled from the tokens, with its places as a list for screen readers. */\nfunction MapRoot({\n label,\n center,\n zoom = 12,\n controlled,\n scheme: schemeProp = \"auto\",\n variant,\n brand,\n lang,\n region,\n world,\n gestures = \"page\",\n controls = true,\n interactive = true,\n fallback,\n onMoveEnd,\n onPress,\n children,\n labels: given,\n className,\n}: Readonly<MapProps>) {\n const labels = { ...mapLabels, ...given };\n const s = map();\n const pageScheme = usePageScheme();\n const scheme = schemeProp === \"auto\" ? pageScheme : schemeProp;\n const reduce = usePrefersReducedMotion();\n const host = React.useRef<HTMLDivElement>(null);\n const [instance, setInstance] = React.useState<MapInstance | null>(null);\n const [lib, setLib] = React.useState<MapLibre | null>(null);\n const [ready, setReady] = React.useState(false);\n const [failed, setFailed] = React.useState(false);\n const [places, setPlaces] = React.useState<Record<string, string>>({});\n const registry = React.useMemo<Registry>(\n () => ({\n add: (id, text) => setPlaces((p) => (p[id] === text ? p : { ...p, [id]: text })),\n remove: (id) =>\n setPlaces((p) => {\n const { [id]: _gone, ...rest } = p;\n return rest;\n }),\n }),\n [],\n );\n const latest = React.useRef({ onMoveEnd, onPress });\n React.useEffect(() => {\n latest.current = { onMoveEnd, onPress };\n });\n const styleOf = React.useCallback((sc: \"dark\" | \"light\") => mapStyle({ scheme: sc, brand, variant, lang, ...(region !== undefined ? { region } : {}), ...(world !== undefined ? { world } : {}) }), [brand, variant, lang, region, world]);\n\n // The style the map wears now: the engine loads asynchronously, so the scheme it is created with is read when it is ready\n // (the page's theme may have flipped since the first render), and the effect below applies whatever differs.\n const wanted = React.useRef({ scheme, styleOf });\n React.useEffect(() => {\n wanted.current = { scheme, styleOf };\n });\n const applied = React.useRef<{ scheme: \"dark\" | \"light\"; styleOf: typeof styleOf } | null>(null);\n\n // The engine and the map, once (the style follows the scheme below).\n React.useEffect(() => {\n if (!host.current) return;\n let alive = true;\n let created: MapInstance | null = null;\n (hasWebGL() ? loadEngine() : Promise.reject(new Error(\"no WebGL\")))\n .then((ml) => {\n if (!alive || !host.current) return;\n applied.current = wanted.current;\n created = new ml.Map({\n container: host.current,\n style: wanted.current.styleOf(wanted.current.scheme) as never,\n center: [...center] as [number, number],\n zoom,\n interactive,\n attributionControl: false,\n fadeDuration: reduce ? 0 : 300,\n cooperativeGestures: gestures === \"page\",\n // The engine's own overlay (styled in motion.css) says it in the words given; its English is the default.\n locale: labels.gestureHelp,\n // The engine's own overlay (styled in motion.css) says it in the words given; its English is the default.\n });\n created.getCanvas().setAttribute(\"aria-hidden\", \"true\");\n created.getCanvas().setAttribute(\"tabindex\", \"-1\");\n created.on(\"load\", () => alive && setReady(true));\n // The basemap cannot be read (offline, a blocked request): the fallback comes back rather than an empty map.\n created.on(\"error\", (e) => {\n const source = (e as { sourceId?: string }).sourceId;\n if (alive && (source === \"world\" || source === \"region\")) setFailed(true);\n });\n created.on(\"moveend\", () => {\n const c = created!.getCenter();\n latest.current.onMoveEnd?.({ center: [c.lng, c.lat], zoom: created!.getZoom() });\n });\n created.on(\"click\", (e) => {\n if ((e.originalEvent.target as Element | null)?.closest?.(\"[data-kz-marker]\")) return;\n latest.current.onPress?.([e.lngLat.lng, e.lngLat.lat]);\n });\n setLib(ml);\n setInstance(created);\n })\n .catch(() => alive && setFailed(true));\n return () => {\n alive = false;\n created?.remove();\n };\n // Created once: the props that change afterwards are followed by the effects below.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, []);\n\n // The scheme (and the brand, the language) change the style, not the map.\n React.useEffect(() => {\n if (!instance) return;\n if (applied.current?.scheme === scheme && applied.current.styleOf === styleOf) return;\n applied.current = { scheme, styleOf };\n instance.setStyle(styleOf(scheme) as never);\n }, [instance, scheme, styleOf]);\n\n // A controlled camera: it flies (or jumps) to the new view.\n React.useEffect(() => {\n if (!instance || !controlled) return;\n const view = { center: [...center] as [number, number], zoom };\n if (reduce) instance.jumpTo(view);\n else instance.flyTo({ ...view, speed: 1.4 });\n }, [instance, controlled, center[0], center[1], zoom, reduce]); // eslint-disable-line react-hooks/exhaustive-deps\n\n const zoomBy = (by: number) => instance && (reduce ? instance.setZoom(instance.getZoom() + by) : instance.zoomTo(instance.getZoom() + by, { duration: 250 }));\n const ctx = React.useMemo<Ctx>(() => ({ map: instance, lib, ready, reduce, places: registry, look: { scheme, brand, variant } }), [instance, lib, ready, reduce, registry, scheme, brand, variant]);\n const listed = Object.entries(places);\n return (\n <MapContext.Provider value={ctx}>\n <section\n aria-label={label}\n className={s.root({ className })}\n data-ready={ready ? \"\" : undefined}\n tabIndex={interactive ? 0 : undefined}\n onKeyDown={(e) => {\n if (e.target !== e.currentTarget || !instance) return;\n if (e.key === \"+\" || e.key === \"=\") zoomBy(1);\n else if (e.key === \"-\") zoomBy(-1);\n else if (e.key.startsWith(\"Arrow\")) {\n e.preventDefault();\n const step = 80;\n const by: Record<string, [number, number]> = { ArrowUp: [0, -step], ArrowDown: [0, step], ArrowLeft: [-step, 0], ArrowRight: [step, 0] };\n instance.panBy(by[e.key]!, { duration: reduce ? 0 : 200 });\n }\n }}\n >\n {!ready || failed ? <div className={s.fallback()}>{fallback}</div> : null}\n <div ref={host} className={s.canvas()} style={{ position: \"absolute\", inset: 0, visibility: failed ? \"hidden\" : undefined }} />\n {controls && interactive && !failed ? (\n <div className={s.controls()}>\n <button type=\"button\" className={s.control()} aria-label={labels.zoomIn} disabled={!instance} onClick={() => zoomBy(1)}>\n +\n </button>\n <button type=\"button\" className={s.control()} aria-label={labels.zoomOut} disabled={!instance} onClick={() => zoomBy(-1)}>\n −\n </button>\n </div>\n ) : null}\n <p className={s.attribution()}>\n <a href={MAP_ATTRIBUTION.protomapsUrl} target=\"_blank\" rel=\"noreferrer\">\n {MAP_ATTRIBUTION.protomaps}\n </a>\n {\" · \"}\n <a href={MAP_ATTRIBUTION.osmUrl} target=\"_blank\" rel=\"noreferrer\">\n {MAP_ATTRIBUTION.osm}\n </a>\n </p>\n {listed.length ? (\n <div className={s.places()}>\n <p>{labels.places}</p>\n <ul>\n {listed.map(([id, text]) => (\n <li key={id}>{text}</li>\n ))}\n </ul>\n </div>\n ) : null}\n {children}\n </section>\n </MapContext.Provider>\n );\n}\n\nexport type MarkerProps = {\n /** Where it stands. */\n position: LngLat;\n /** Its words: the place's name, read in the list of places and as the button's name (\"Café Olimpico, 350 m\"). */\n label: string;\n /** Pressing it (details in a panel, a sheet): the marker becomes a button. */\n onPress?: () => void;\n /** The chosen one: larger, its label shown above it. */\n selected?: boolean;\n /** Its size in pixels. Default 18. */\n size?: number;\n /** What it draws instead of the accent dot (an avatar, an icon). */\n children?: React.ReactNode;\n /** Drops onto its place once, after this many milliseconds (stagger several: `index * 90`). Still under reduced motion. */\n drop?: number;\n};\n\n/** Lists a place for screen readers while the component stands. */\nfunction usePlace(id: string, label: string, places: Registry) {\n React.useEffect(() => {\n places.add(id, label);\n return () => places.remove(id);\n }, [id, label, places]);\n}\n\nconst noSubscription = () => () => undefined;\n\n/** A place on the map: an accent dot (or your content) that is a button when it does something. */\nexport function Marker({ position, label, onPress, selected, size = 18, children, drop }: Readonly<MarkerProps>) {\n const { map: m, lib, places } = useMap();\n const s = map();\n const id = React.useId();\n // The marker's host element exists only in a browser: the server and the hydration pass render nothing for it, then the\n // client swaps in the element — `useSyncExternalStore`'s server snapshot, so hydration never sees a difference.\n const host = React.useRef<HTMLElement | null>(null);\n const el = React.useSyncExternalStore(\n noSubscription,\n () => (host.current ??= document.createElement(\"div\")),\n () => null,\n );\n usePlace(id, label, places);\n React.useEffect(() => {\n if (!m || !lib || !el) return;\n el.setAttribute(\"data-kz-marker\", \"\");\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...position] as [number, number]).addTo(m);\n return () => void marker.remove();\n }, [m, lib, el, position[0], position[1]]); // eslint-disable-line react-hooks/exhaustive-deps\n if (!el) return null;\n const Tag = onPress ? \"button\" : \"span\";\n return createPortal(\n <Tag\n type={onPress ? \"button\" : undefined}\n aria-label={onPress ? label : undefined}\n aria-hidden={onPress ? undefined : true}\n aria-pressed={onPress && selected !== undefined ? selected : undefined}\n data-selected={selected ? \"\" : undefined}\n data-drop={drop === undefined ? undefined : \"\"}\n className={s.marker()}\n style={{ ...(children ? null : { width: size, height: size }), ...(drop === undefined ? null : ({ \"--kz-map-drop-delay\": `${drop}ms` } as React.CSSProperties)) }}\n onClick={onPress}\n >\n {children}\n {selected ? <span className={s.markerLabel()}>{label}</span> : null}\n </Tag>,\n el,\n );\n}\n\nexport type UserPositionProps = {\n /** Where the person is. */\n position: LngLat;\n /** Its words (\"You are here\"), read in the list of places. */\n label: string;\n /** The accuracy in metres: a soft disc around the dot. */\n accuracy?: number;\n};\n\n/** The person's position: a dot that pulses (still under reduced motion), its accuracy as a soft disc. */\nexport function UserPosition({ position, label, accuracy }: UserPositionProps) {\n const { map: m, lib, places } = useMap();\n const id = React.useId();\n usePlace(id, label, places);\n React.useEffect(() => {\n if (!m || !lib) return;\n const el = document.createElement(\"div\");\n el.className = \"kz-map-user\";\n el.setAttribute(\"aria-hidden\", \"true\");\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...position] as [number, number]).addTo(m);\n return () => void marker.remove();\n }, [m, lib, position[0], position[1]]); // eslint-disable-line react-hooks/exhaustive-deps\n return accuracy ? <RadiusCircle center={position} radius={accuracy} tone=\"soft\" /> : null;\n}\n\nexport type PulseProps = {\n /** Where it beats. */\n position: LngLat;\n /** Its words (\"High demand in Mile End\"), read in the list of places. */\n label: string;\n /** The rings' reach in pixels. Default 56. */\n size?: number;\n /** `accent` (a zone that matters) or `soft`. Default `accent`. */\n tone?: \"accent\" | \"soft\";\n};\n\n/** A heat pulse: rings that swell and fade around a place (a hot spot, a demand peak). Still rings under reduced motion. */\nexport function Pulse({ position, label, size = 56, tone = \"accent\" }: PulseProps) {\n const { map: m, lib, places } = useMap();\n const id = React.useId();\n usePlace(id, label, places);\n React.useEffect(() => {\n if (!m || !lib) return;\n const el = document.createElement(\"div\");\n el.className = \"kz-map-pulse\";\n el.setAttribute(\"data-tone\", tone);\n el.setAttribute(\"aria-hidden\", \"true\");\n el.style.setProperty(\"--kz-map-pulse-size\", `${size}px`);\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...position] as [number, number]).addTo(m);\n return () => void marker.remove();\n }, [m, lib, tone, size, position[0], position[1]]); // eslint-disable-line react-hooks/exhaustive-deps\n return null;\n}\n\nexport type RouteProps = {\n /** The path, as positions in order (a polyline: a delivery, a walk, a flight). */\n path: readonly LngLat[];\n /** Its words (\"Delivery from the studio to Mile End, 2.4 km\"), read in the list of places. */\n label: string;\n /** The line draws itself once, from its start, when the map is on screen; `false` shows it whole. Default `true`. */\n draw?: boolean;\n /** How long the drawing lasts, in milliseconds. Default 1400. */\n duration?: number;\n /** A dot that travels the route once drawn (`true`, or your own content: an avatar, an icon). */\n courier?: boolean | React.ReactNode;\n /** How long a trip takes, in milliseconds. Default 3200. */\n tripDuration?: number;\n /** Start the trips again after a pause (milliseconds), only while the map is on screen. Without it the courier makes one trip. */\n repeatAfter?: number;\n /** Changing it replays the drawing and the trip. */\n replayKey?: string | number;\n /** `accent` or `soft`. Default `accent`. */\n tone?: \"accent\" | \"soft\";\n /** The timing function of the drawing and of the trips: `ease-out`, `linear`, `ease-in-out`. Default: out for the drawing, in-out for a trip. */\n easing?: \"ease-out\" | \"linear\" | \"ease-in-out\";\n /** Holds the drawing and the trips where they are (a controlled pause, on top of the off-screen one). */\n paused?: boolean;\n};\n\nconst ROUTE_CURVES = {\n linear: (t: number) => t,\n \"ease-out\": (t: number) => 1 - (1 - t) ** 3,\n \"ease-in-out\": (t: number) => (t < 0.5 ? 2 * t * t : 1 - (-2 * t + 2) ** 2 / 2),\n} as const;\n\ntype RouteSource = { setData?: (d: GeoJSON.GeoJSON) => void };\n\n/** A route on the map: a line that draws itself, and a courier that travels it. Under reduced motion the line is whole and the courier rests at the end. */\nexport function Route({ path, label, draw = true, duration = 1400, courier, tripDuration = 3200, repeatAfter, replayKey, tone = \"accent\", easing, paused = false }: Readonly<RouteProps>) {\n const { map: m, lib, ready, reduce, places } = useMap();\n const id = `kz-route-${React.useId().replaceAll(/[^a-zA-Z0-9]/g, \"\")}`;\n const animated = draw && !reduce;\n // The drawing is done for this `replayKey` (a new key draws again); without animation the line is whole at once.\n const token = replayKey ?? 0;\n const [doneFor, setDoneFor] = React.useState<string | number | null>(null);\n const drawn = !animated || doneFor === token;\n const whole = React.useMemo(() => sliceLine(path, 1), [path]);\n const start = React.useMemo(() => sliceLine(path, 0), [path]);\n usePlace(id, label, places);\n useGeoLayer(id, drawn ? whole : start, (c) => [\n { id: `${id}-casing`, type: \"line\", source: id, layout: { \"line-cap\": \"round\", \"line-join\": \"round\" }, paint: { \"line-color\": c.accent, \"line-width\": 9, \"line-opacity\": tone === \"soft\" ? 0.08 : 0.16, \"line-blur\": 3 } },\n { id: `${id}-line`, type: \"line\", source: id, layout: { \"line-cap\": \"round\", \"line-join\": \"round\" }, paint: { \"line-color\": c.accent, \"line-width\": tone === \"soft\" ? 2 : 3.5, \"line-opacity\": tone === \"soft\" ? 0.6 : 1 } },\n ]);\n // Is the map on screen? The drawing waits for it, and a repeating trip does not start while it is not.\n const [seen, setSeen] = React.useState(() => typeof IntersectionObserver === \"undefined\");\n const visible = seen && !paused;\n React.useEffect(() => {\n const el = m?.getContainer?.();\n if (!el || typeof IntersectionObserver === \"undefined\") return;\n const io = new IntersectionObserver(([entry]) => setSeen(!!entry?.isIntersecting), { threshold: 0.25 });\n io.observe(el);\n return () => io.disconnect();\n }, [m]);\n // The drawing: a finite animation, one frame per paint for `duration` ms — no loop, nothing runs afterwards.\n React.useEffect(() => {\n if (!m || !ready || !animated || drawn || !visible) return;\n const source = m.getSource(id) as RouteSource | undefined;\n let frame = 0;\n const began = performance.now();\n const step = (now: number) => {\n const t = Math.min(1, (now - began) / Math.max(1, duration));\n source?.setData?.(sliceLine(path, ROUTE_CURVES[easing ?? \"ease-out\"](t)));\n if (t < 1) frame = requestAnimationFrame(step);\n else setDoneFor(token);\n };\n frame = requestAnimationFrame(step);\n return () => cancelAnimationFrame(frame);\n }, [m, ready, animated, drawn, visible, id, path, duration, token, easing]);\n // The courier: one trip once the line is drawn (finite frames), again after `repeatAfter` while on screen.\n const [trip, setTrip] = React.useState(0);\n React.useEffect(() => {\n if (!courier || !m || !lib || !ready || !drawn) return;\n const el = document.createElement(\"div\");\n el.className = \"kz-map-courier\";\n el.setAttribute(\"aria-hidden\", \"true\");\n const marker = new lib.Marker({ element: el, anchor: \"center\" }).setLngLat([...(path[reduce ? path.length - 1 : 0] ?? [0, 0])] as [number, number]).addTo(m);\n let frame = 0;\n let timer: ReturnType<typeof setTimeout> | undefined;\n if (!reduce && visible) {\n const began = performance.now();\n const step = (now: number) => {\n const t = Math.min(1, (now - began) / Math.max(1, tripDuration));\n const eased = ROUTE_CURVES[easing ?? \"ease-in-out\"](t);\n marker.setLngLat([...pointAlong(path, eased).position] as [number, number]);\n if (t < 1) frame = requestAnimationFrame(step);\n else if (repeatAfter !== undefined) timer = setTimeout(() => setTrip((n) => n + 1), repeatAfter);\n };\n frame = requestAnimationFrame(step);\n } else if (!reduce) marker.setLngLat([...(path.at(-1) ?? [0, 0])] as [number, number]);\n return () => {\n cancelAnimationFrame(frame);\n clearTimeout(timer);\n marker.remove();\n };\n }, [courier, m, lib, ready, drawn, visible, reduce, path, tripDuration, repeatAfter, trip, token, easing]);\n return null;\n}\n\n/** Adds a GeoJSON source and its layers while the map has a style (again after a change of scheme). */\nfunction useGeoLayer(id: string, data: GeoJSON.GeoJSON, layers: (palette: ReturnType<typeof mapPalette>) => object[], source: object = {}) {\n const { map: m, ready, look: { scheme, brand, variant } } = useMap();\n const dataRef = React.useRef(data);\n React.useEffect(() => {\n dataRef.current = data;\n const src = m?.getSource(id) as { setData?: (d: GeoJSON.GeoJSON) => void } | undefined;\n src?.setData?.(data);\n }, [m, id, data]);\n React.useEffect(() => {\n if (!m || !ready) return;\n const add = () => {\n if (m.getSource(id)) return;\n m.addSource(id, { type: \"geojson\", data: dataRef.current, ...source } as never);\n for (const layer of layers(mapPalette(scheme, brand, variant))) m.addLayer(layer as never);\n };\n add();\n m.on(\"styledata\", add);\n return () => {\n m.off(\"styledata\", add);\n if (!m.getStyle()) return;\n for (const layer of m.getStyle().layers.filter((l) => \"source\" in l && l.source === id)) m.removeLayer(layer.id);\n if (m.getSource(id)) m.removeSource(id);\n };\n }, [m, ready, id, scheme, brand, variant]); // eslint-disable-line react-hooks/exhaustive-deps\n}\n\nexport type RadiusCircleProps = {\n /** Its centre. */\n center: LngLat;\n /** Its radius in metres. */\n radius: number;\n /** `accent` (a zone that matters: a delivery area, a search radius) or `soft` (an accuracy). */\n tone?: \"accent\" | \"soft\";\n};\n\n/** A circle on the ground: a delivery zone, a search radius — filled with the accent, its edge drawn. */\nexport function RadiusCircle({ center, radius, tone = \"accent\" }: Readonly<RadiusCircleProps>) {\n const id = `kz-circle-${React.useId().replaceAll(/[^a-zA-Z0-9]/g, \"\")}`;\n const data = React.useMemo(() => circlePolygon(center, radius), [center[0], center[1], radius]); // eslint-disable-line react-hooks/exhaustive-deps\n useGeoLayer(id, data, (c) => [\n { id: `${id}-fill`, type: \"fill\", source: id, paint: { \"fill-color\": c.accent, \"fill-opacity\": tone === \"soft\" ? 0.1 : 0.14 } },\n { id: `${id}-line`, type: \"line\", source: id, paint: { \"line-color\": c.accent, \"line-width\": tone === \"soft\" ? 1 : 2, \"line-opacity\": tone === \"soft\" ? 0.4 : 0.9, ...(tone === \"accent\" ? { \"line-dasharray\": [2, 1.5] } : {}) } },\n ]);\n return null;\n}\n\nexport type ClusterPoint = { id: string; position: LngLat; label: string };\n\nexport type ClusterProps = {\n /** The points: many of them (creators, pick-up points, events). */\n points: readonly ClusterPoint[];\n /** Pressing a single point. A group zooms in to open itself. */\n onPointPress?: (point: ClusterPoint) => void;\n /** The radius, in pixels, within which points group. Default 48. */\n radius?: number;\n};\n\n/** Many points grouped while they are close: a disc with the count, opened by zooming in; each point is listed for screen readers. */\nexport function Cluster({ points, onPointPress, radius = 48 }: ClusterProps) {\n const { map: m, ready, reduce, places } = useMap();\n const id = `kz-cluster-${React.useId().replace(/[^a-zA-Z0-9]/g, \"\")}`;\n const data = React.useMemo<GeoJSON.FeatureCollection>(\n () => ({ type: \"FeatureCollection\", features: points.map((p) => ({ type: \"Feature\", properties: { id: p.id, label: p.label }, geometry: { type: \"Point\", coordinates: [...p.position] } })) }),\n [points],\n );\n React.useEffect(() => {\n for (const p of points) places.add(`${id}-${p.id}`, p.label);\n return () => points.forEach((p) => places.remove(`${id}-${p.id}`));\n }, [points, places, id]);\n useGeoLayer(\n id,\n data,\n (c) => [\n { id: `${id}-groups`, type: \"circle\", source: id, filter: [\"has\", \"point_count\"], paint: { \"circle-color\": c.cluster.fill, \"circle-opacity\": 0.95, \"circle-radius\": [\"step\", [\"get\", \"point_count\"], 16, 10, 20, 50, 26], \"circle-stroke-width\": 3, \"circle-stroke-color\": c.cluster.stroke } },\n { id: `${id}-count`, type: \"symbol\", source: id, filter: [\"has\", \"point_count\"], layout: { \"text-field\": [\"get\", \"point_count_abbreviated\"], \"text-font\": [\"Noto Sans Medium\"], \"text-size\": 13 }, paint: { \"text-color\": c.cluster.text } },\n { id: `${id}-points`, type: \"circle\", source: id, filter: [\"!\", [\"has\", \"point_count\"]], paint: { \"circle-color\": c.point.fill, \"circle-radius\": 7, \"circle-stroke-width\": 2.5, \"circle-stroke-color\": c.point.stroke } },\n ],\n { cluster: true, clusterRadius: radius, clusterMaxZoom: 15 },\n );\n React.useEffect(() => {\n if (!m || !ready) return;\n const openGroup = async (e: { features?: { properties: Record<string, unknown>; geometry: GeoJSON.Geometry }[] }) => {\n const f = e.features?.[0];\n if (!f) return;\n const src = m.getSource(id) as unknown as { getClusterExpansionZoom: (id: number) => Promise<number> };\n const z = await src.getClusterExpansionZoom(f.properties.cluster_id as number);\n const center = (f.geometry as GeoJSON.Point).coordinates as [number, number];\n if (reduce) m.jumpTo({ center, zoom: z });\n else m.easeTo({ center, zoom: z });\n };\n const pressPoint = (e: { features?: { properties: Record<string, unknown> }[] }) => {\n const pid = e.features?.[0]?.properties.id;\n const point = points.find((p) => p.id === pid);\n if (point) onPointPress?.(point);\n };\n m.on(\"click\", `${id}-groups`, openGroup as never);\n m.on(\"click\", `${id}-points`, pressPoint as never);\n return () => {\n m.off(\"click\", `${id}-groups`, openGroup as never);\n m.off(\"click\", `${id}-points`, pressPoint as never);\n };\n }, [m, ready, id, points, onPointPress, reduce]);\n return null;\n}\n\nexport { MapRoot as Map };\n"
1118
1118
  },
1119
1119
  {
1120
1120
  "path": "map/meta.ts",
@@ -1134,15 +1134,15 @@
1134
1134
  },
1135
1135
  {
1136
1136
  "path": "map/sheet/map-sheet.tsx",
1137
- "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { tv } from \"../../tv\";\n\nexport const mapSheet = tv({\n slots: {\n root: \"absolute inset-x-0 bottom-0 z-10 flex max-h-full flex-col rounded-t-2xl border border-border-subtle bg-surface-1 text-fg shadow-lg transition-[height] duration-200 motion-reduce:transition-none md:inset-y-3 md:left-3 md:right-auto md:max-h-none md:w-[22rem] md:rounded-2xl\",\n handle: \"flex h-6 w-full shrink-0 items-center justify-center md:hidden focus-visible:outline-2 focus-visible:outline-offset-[-2px] focus-visible:outline-border-focus\",\n grip: \"h-1 w-10 rounded-full bg-border-default\",\n body: \"min-h-0 flex-1 overflow-y-auto px-4 pb-4 md:pt-4\",\n },\n variants: {\n snap: {\n peek: { root: \"h-24 md:h-auto\" },\n half: { root: \"h-1/2 md:h-auto\" },\n full: { root: \"h-[92%] md:h-auto\" },\n },\n },\n defaultVariants: { snap: \"peek\" },\n});\n\nexport type MapSheetSnap = \"peek\" | \"half\" | \"full\";\nexport const MAP_SHEET_SNAPS: readonly MapSheetSnap[] = [\"peek\", \"half\", \"full\"];\n\nexport type MapSheetProps = Omit<React.ComponentProps<\"section\">, \"children\"> & {\n /** What the sheet is, passed translated: its accessible name (\"Place details\"). */\n label: string;\n /** The content: an info card, a route card, a list. */\n children: React.ReactNode;\n /** The snap point, when controlled. */\n snap?: MapSheetSnap;\n /** The snap point at the start, when not controlled. Default \"peek\". */\n defaultSnap?: MapSheetSnap;\n /** Called with the new snap point (the handle: a press cycles, ArrowUp / ArrowDown step, Home / End jump). */\n onSnapChange?: (snap: MapSheetSnap) => void;\n /** The handle's name, translated (\"Resize the panel\"). */\n handleLabel: string;\n};\n\n/**\n * A NON-modal sheet over a map: the map stays alive and reachable behind it (no scrim, no focus trap, nothing made\n * inert). On a phone it rises from the bottom with three snap points; from the `md` breakpoint it is a card at the\n * side and the handle disappears. Place it in the map's positioned container.\n */\nexport function MapSheet({ label, children, snap, defaultSnap = \"peek\", onSnapChange, handleLabel, className, ...props }: MapSheetProps) {\n const [inner, setInner] = React.useState<MapSheetSnap>(defaultSnap);\n const current = snap ?? inner;\n const set = (next: MapSheetSnap) => {\n if (snap === undefined) setInner(next);\n onSnapChange?.(next);\n };\n const step = (by: number) => set(MAP_SHEET_SNAPS[Math.min(MAP_SHEET_SNAPS.length - 1, Math.max(0, MAP_SHEET_SNAPS.indexOf(current) + by))]!);\n const s = mapSheet({ snap: current });\n return (\n <section {...props} aria-label={label} data-snap={current} className={s.root({ className })}>\n <button\n type=\"button\"\n className={s.handle()}\n aria-label={handleLabel}\n aria-expanded={current !== \"peek\"}\n onClick={() => set(MAP_SHEET_SNAPS[(MAP_SHEET_SNAPS.indexOf(current) + 1) % MAP_SHEET_SNAPS.length]!)}\n onKeyDown={(e) => {\n const move = { ArrowUp: () => step(1), ArrowDown: () => step(-1), Home: () => set(\"peek\"), End: () => set(\"full\") }[e.key];\n if (!move) return;\n e.preventDefault();\n move();\n }}\n >\n <span className={s.grip()} aria-hidden />\n </button>\n <div className={s.body()}>{children}</div>\n </section>\n );\n}\n"
1137
+ "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { tv } from \"../../tv\";\n\nexport const mapSheet = tv({\n slots: {\n root: \"absolute inset-x-0 bottom-0 z-10 flex max-h-full flex-col rounded-t-2xl border border-border-subtle bg-surface-1 text-fg shadow-lg transition-[height] duration-200 motion-reduce:transition-none md:inset-y-3 md:left-3 md:right-auto md:max-h-none md:w-[22rem] md:rounded-2xl\",\n handle: \"flex h-6 w-full shrink-0 items-center justify-center md:hidden focus-visible:outline-2 focus-visible:outline-offset-[-2px] focus-visible:outline-border-focus\",\n grip: \"h-1 w-10 rounded-full bg-border-default\",\n body: \"min-h-0 flex-1 overflow-y-auto px-4 pb-4 md:pt-4\",\n },\n variants: {\n snap: {\n peek: { root: \"h-24 md:h-auto\" },\n half: { root: \"h-1/2 md:h-auto\" },\n full: { root: \"h-[92%] md:h-auto\" },\n },\n },\n defaultVariants: { snap: \"peek\" },\n});\n\nexport type MapSheetSnap = \"peek\" | \"half\" | \"full\";\nexport const MAP_SHEET_SNAPS: readonly MapSheetSnap[] = [\"peek\", \"half\", \"full\"];\n\nexport type MapSheetProps = Omit<React.ComponentProps<\"section\">, \"children\"> & {\n /** What the sheet is, passed translated: its accessible name (\"Place details\"). */\n label: string;\n /** The content: an info card, a route card, a list. */\n children: React.ReactNode;\n /** The snap point, when controlled. */\n snap?: MapSheetSnap;\n /** The snap point at the start, when not controlled. Default \"peek\". */\n defaultSnap?: MapSheetSnap;\n /** Called with the new snap point (the handle: a press cycles, ArrowUp / ArrowDown step, Home / End jump). */\n onSnapChange?: (snap: MapSheetSnap) => void;\n /** The handle's name, translated (\"Resize the panel\"). */\n handleLabel: string;\n};\n\n/**\n * A NON-modal sheet over a map: the map stays alive and reachable behind it (no scrim, no focus trap, nothing made\n * inert). On a phone it rises from the bottom with three snap points; from the `md` breakpoint it is a card at the\n * side and the handle disappears. Place it in the map's positioned container.\n */\nexport function MapSheet({ label, children, snap, defaultSnap = \"peek\", onSnapChange, handleLabel, className, ...props }: Readonly<MapSheetProps>) {\n const [inner, setInner] = React.useState<MapSheetSnap>(defaultSnap);\n const current = snap ?? inner;\n const set = (next: MapSheetSnap) => {\n if (snap === undefined) setInner(next);\n onSnapChange?.(next);\n };\n const step = (by: number) => set(MAP_SHEET_SNAPS[Math.min(MAP_SHEET_SNAPS.length - 1, Math.max(0, MAP_SHEET_SNAPS.indexOf(current) + by))]!);\n const s = mapSheet({ snap: current });\n return (\n <section {...props} aria-label={label} data-snap={current} className={s.root({ className })}>\n <button\n type=\"button\"\n className={s.handle()}\n aria-label={handleLabel}\n aria-expanded={current !== \"peek\"}\n onClick={() => set(MAP_SHEET_SNAPS[(MAP_SHEET_SNAPS.indexOf(current) + 1) % MAP_SHEET_SNAPS.length]!)}\n onKeyDown={(e) => {\n const move = { ArrowUp: () => step(1), ArrowDown: () => step(-1), Home: () => set(\"peek\"), End: () => set(\"full\") }[e.key];\n if (!move) return;\n e.preventDefault();\n move();\n }}\n >\n <span className={s.grip()} aria-hidden />\n </button>\n <div className={s.body()}>{children}</div>\n </section>\n );\n}\n"
1138
1138
  },
1139
1139
  {
1140
1140
  "path": "map/static-map.tsx",
1141
- "content": "// Server-safe. A still map drawn without an engine: the places projected (Web Mercator) on the map's paper — or on a\n// picture of the area (`image`, a snapshot of the real map) — in the page's tokens. What a `Map` shows while its engine\n// loads and for good without WebGL; a picture for an e-mail, a card, a list item. An image (`role=\"img\"`) named by its\n// places.\n\n\nimport { tv } from \"../tv\";\nimport { MAP_ATTRIBUTION } from \"./assets\";\nimport { type LngLat, project } from \"./geo\";\n\nexport const staticMap = tv({\n slots: {\n root: \"relative block h-full w-full overflow-hidden bg-surface-2\",\n svg: \"absolute inset-0 h-full w-full\",\n attribution: \"absolute bottom-1.5 right-1.5 rounded-md bg-surface-1/85 px-1.5 py-0.5 text-[10px] text-fg-secondary\",\n },\n});\n\nexport type StaticMapPlace = { position: LngLat; label: string };\n\nexport type StaticMapProps = {\n /** What the picture shows, in words (\"Three pick-up points in the Plateau\"), passed translated: its accessible name. */\n label: string;\n /** The centre of the picture. */\n center: LngLat;\n /** The zoom of the picture. Default 12. */\n zoom?: number;\n /** The places drawn on it (an accent dot each), listed in its name. */\n places?: readonly StaticMapPlace[];\n /** A snapshot of the real map of the area (same centre and zoom), drawn under the places; the attribution then shows. */\n image?: string;\n /** Classes merged on the root (its size). */\n className?: string;\n};\n\nconst W = 640;\nconst H = 400;\n\n/** A still map: the places on the map's paper (or on a snapshot), named in words. */\nexport function StaticMap({ label, center, zoom = 12, places = [], image, className }: StaticMapProps) {\n const s = staticMap();\n const [cx, cy] = project(center, zoom);\n const at = (p: LngLat) => {\n const [x, y] = project(p, zoom);\n return [W / 2 + x - cx, H / 2 + y - cy] as const;\n };\n const name = places.length ? `${label}: ${places.map((p) => p.label).join(\", \")}` : label;\n return (\n <span role=\"img\" aria-label={name} className={s.root({ className })}>\n <svg viewBox={`0 0 ${W} ${H}`} preserveAspectRatio=\"xMidYMid slice\" className={s.svg()} aria-hidden>\n <defs>\n <pattern id=\"kz-map-paper\" width=\"48\" height=\"48\" patternUnits=\"userSpaceOnUse\">\n <path d=\"M48 0H0V48\" fill=\"none\" stroke=\"var(--kz-border-subtle)\" strokeWidth=\"1\" />\n </pattern>\n </defs>\n <rect width={W} height={H} fill=\"var(--kz-surface-2)\" />\n {image ? <image href={image} x=\"0\" y=\"0\" width={W} height={H} preserveAspectRatio=\"xMidYMid slice\" /> : <rect width={W} height={H} fill=\"url(#kz-map-paper)\" />}\n {places.map((p) => {\n const [x, y] = at(p.position);\n return (\n <g key={`${p.position[0]},${p.position[1]}`}>\n <circle cx={x} cy={y} r=\"12\" fill=\"var(--kz-accent)\" opacity=\"0.18\" />\n <circle cx={x} cy={y} r=\"7\" fill=\"var(--kz-accent)\" stroke=\"var(--kz-on-accent)\" strokeWidth=\"2.5\" />\n </g>\n );\n })}\n </svg>\n {image ? (\n <span aria-hidden className={s.attribution()}>\n {MAP_ATTRIBUTION.protomaps} · {MAP_ATTRIBUTION.osm}\n </span>\n ) : null}\n </span>\n );\n}\n\n"
1141
+ "content": "// Server-safe. A still map drawn without an engine: the places projected (Web Mercator) on the map's paper — or on a\n// picture of the area (`image`, a snapshot of the real map) — in the page's tokens. What a `Map` shows while its engine\n// loads and for good without WebGL; a picture for an e-mail, a card, a list item. An image (`role=\"img\"`) named by its\n// places.\n\n\nimport { tv } from \"../tv\";\nimport { MAP_ATTRIBUTION } from \"./assets\";\nimport { type LngLat, project } from \"./geo\";\n\nexport const staticMap = tv({\n slots: {\n root: \"relative block h-full w-full overflow-hidden bg-surface-2\",\n svg: \"absolute inset-0 h-full w-full\",\n attribution: \"absolute bottom-1.5 right-1.5 rounded-md bg-surface-1/85 px-1.5 py-0.5 text-[10px] text-fg-secondary\",\n },\n});\n\nexport type StaticMapPlace = { position: LngLat; label: string };\n\nexport type StaticMapProps = {\n /** What the picture shows, in words (\"Three pick-up points in the Plateau\"), passed translated: its accessible name. */\n label: string;\n /** The centre of the picture. */\n center: LngLat;\n /** The zoom of the picture. Default 12. */\n zoom?: number;\n /** The places drawn on it (an accent dot each), listed in its name. */\n places?: readonly StaticMapPlace[];\n /** A snapshot of the real map of the area (same centre and zoom), drawn under the places; the attribution then shows. */\n image?: string;\n /** Classes merged on the root (its size). */\n className?: string;\n};\n\nconst W = 640;\nconst H = 400;\n\n/** A still map: the places on the map's paper (or on a snapshot), named in words. */\nexport function StaticMap({ label, center, zoom = 12, places = [], image, className }: Readonly<StaticMapProps>) {\n const s = staticMap();\n const [cx, cy] = project(center, zoom);\n const at = (p: LngLat) => {\n const [x, y] = project(p, zoom);\n return [W / 2 + x - cx, H / 2 + y - cy] as const;\n };\n const name = places.length ? `${label}: ${places.map((p) => p.label).join(\", \")}` : label;\n return (\n <span role=\"img\" aria-label={name} className={s.root({ className })}>\n <svg viewBox={`0 0 ${W} ${H}`} preserveAspectRatio=\"xMidYMid slice\" className={s.svg()} aria-hidden>\n <defs>\n <pattern id=\"kz-map-paper\" width=\"48\" height=\"48\" patternUnits=\"userSpaceOnUse\">\n <path d=\"M48 0H0V48\" fill=\"none\" stroke=\"var(--kz-border-subtle)\" strokeWidth=\"1\" />\n </pattern>\n </defs>\n <rect width={W} height={H} fill=\"var(--kz-surface-2)\" />\n {image ? <image href={image} x=\"0\" y=\"0\" width={W} height={H} preserveAspectRatio=\"xMidYMid slice\" /> : <rect width={W} height={H} fill=\"url(#kz-map-paper)\" />}\n {places.map((p) => {\n const [x, y] = at(p.position);\n return (\n <g key={`${p.position[0]},${p.position[1]}`}>\n <circle cx={x} cy={y} r=\"12\" fill=\"var(--kz-accent)\" opacity=\"0.18\" />\n <circle cx={x} cy={y} r=\"7\" fill=\"var(--kz-accent)\" stroke=\"var(--kz-on-accent)\" strokeWidth=\"2.5\" />\n </g>\n );\n })}\n </svg>\n {image ? (\n <span aria-hidden className={s.attribution()}>\n {MAP_ATTRIBUTION.protomaps} · {MAP_ATTRIBUTION.osm}\n </span>\n ) : null}\n </span>\n );\n}\n\n"
1142
1142
  },
1143
1143
  {
1144
1144
  "path": "map/style.ts",
1145
- "content": "// The Krizaka map style, generated from the tokens (no hand-written colour): Protomaps' basemap layers\n// (@protomaps/basemaps) painted with a flavour drawn from `@krizaka/tokens` — the surfaces for the land, the accent\n// softened for the water, the text roles for the labels — in dark or light, the product's accent where a brand asks.\n// Platform-neutral: the web `Map` and the native `Map` both read it.\nimport { brands, themes } from \"@krizaka/tokens/native\";\nimport { type Flavor, layers, namedFlavor } from \"@protomaps/basemaps\";\n\nimport { MAP_ATTRIBUTION, mapAssets } from \"./assets\";\n\n/** A product of the family: its accent paints the map. */\nexport type MapBrand = keyof typeof brands;\n\n/** A colour mixed into another (`#rrggbb` only): `t` = 0 gives `a`, 1 gives `b`. */\nexport function mix(a: string, b: string, t: number): string {\n const p = (h: string) => [1, 3, 5].map((i) => parseInt(h.slice(i, i + 2), 16));\n const [x, y] = [p(a), p(b)];\n return `#${x.map((v, i) => Math.round(v + (y[i]! - v) * t).toString(16).padStart(2, \"0\")).join(\"\")}`;\n}\n\n/**\n * The look of the map: `plain` (the product register) or `notebook` (the Cahier: ink lines on the paper in light, chalk on\n * the slate in dark, the margin's red for the main roads).\n */\nexport type MapVariant = \"plain\" | \"notebook\";\n\n/** The scheme a map is asked for: `auto` follows the page (web) or the app (native). */\nexport type MapScheme = \"dark\" | \"light\" | \"auto\";\n\ntype Tokens = Record<string, string>;\n\n/** A colour mixed into a base, by `d` in dark or `l` in light. */\nconst tint = (base: string, dark: boolean) => (colour: string, d: number, l: number) => mix(base, colour, dark ? d : l);\n\n/** The product register: the page's surfaces, the accent softened for the water, the roads in white (light) or a lift of the land (dark). */\nfunction plainPalette(t: Tokens, dark: boolean) {\n const land = dark ? t.surface1! : t.surface0!;\n const on = tint(land, dark);\n const text = t.textPrimary!;\n return {\n land,\n background: dark ? t.surface0! : t.surface2!,\n water: on(t.accent!, 0.18, 0.14),\n park: on(t.success!, 0.1, 0.12),\n road: dark ? on(text, 0.12, 0) : \"#ffffff\",\n roadMajor: on(text, 0.2, 0.06),\n casing: on(text, 0.05, 0.12),\n building: on(text, 0.06, 0.07),\n boundary: on(text, 0.3, 0.3),\n label: t.textSecondary!,\n labelStrong: text,\n halo: land,\n accent: t.accent!,\n onAccent: t.onAccent!,\n // The clusters and the pins' ring: a disc of the accent in the product register.\n cluster: { fill: t.accent!, stroke: land, text: t.onAccent! },\n point: { fill: t.accent!, stroke: land },\n };\n}\n\ntype Palette = ReturnType<typeof plainPalette>;\n\n/** `notebook`: the paper is the page's surface; the lines are the ink, drawn without casings, as with a pen. */\nfunction notebookPalette(plain: Palette, t: Tokens, dark: boolean): Palette {\n const paper = t.surface0!;\n const margin = t.paperRuleMargin!;\n const on = tint(paper, dark);\n const ink = t.textPrimary!;\n return {\n ...plain,\n land: paper,\n background: paper,\n water: on(t.accent!, 0.26, 0.2),\n park: on(t.paperTag!, 0.7, 0.55),\n road: on(ink, 0.32, 0.28),\n roadMajor: on(margin, 0.75, 0.7),\n casing: paper,\n halo: paper,\n // A cluster is a manila tag with its eyelet edge; a single point is the margin's red.\n cluster: { fill: t.paperTag!, stroke: t.paperTagEdge!, text: t.paperTagInk! },\n point: { fill: margin, stroke: paper },\n };\n}\n\n/** The colours of the map in a scheme (and a brand, a variant): what the style, the markers, the clusters and the static map share. */\nexport function mapPalette(scheme: \"dark\" | \"light\", brand: MapBrand = \"krizaka\", variant: MapVariant = \"plain\") {\n const t = { ...themes[scheme], ...(brands as Record<string, Partial<Record<\"dark\" | \"light\", Partial<typeof themes.dark>>>>)[brand]?.[scheme] } as unknown as Tokens;\n const dark = scheme === \"dark\";\n const plain = plainPalette(t, dark);\n if (variant === \"notebook\") return notebookPalette(plain, t, dark);\n return plain;\n}\n\n/** Which colour of the palette paints each role of the basemap flavour (the first pattern that matches the role's name; the land otherwise). */\nconst FLAVOR_ROLES: [RegExp, string][] = [\n [/halo/, \"halo\"],\n [/city_label/, \"labelStrong\"],\n [/label/, \"label\"],\n [/casing|railway/, \"casing\"],\n [/major|highway/, \"roadMajor\"],\n [/^(other|minor|link|bridges|tunnel)/, \"road\"],\n [/park|wood|scrub|zoo/, \"park\"],\n [/runway|buildings|pier/, \"building\"],\n [/water/, \"water\"],\n [/boundaries/, \"boundary\"],\n [/background/, \"background\"],\n];\n\n/** The basemap flavour of a palette: every role of Protomaps' layers filled from the tokens. */\nexport function mapFlavor(scheme: \"dark\" | \"light\", brand?: MapBrand, variant?: MapVariant): Flavor {\n const c = mapPalette(scheme, brand, variant) as unknown as Record<string, string>;\n const base = namedFlavor(scheme);\n return {\n ...base,\n ...Object.fromEntries(Object.keys(base).map((role) => [role, c[FLAVOR_ROLES.find(([re]) => re.test(role))?.[1] ?? \"land\"]])),\n regular: \"Noto Sans Regular\",\n bold: \"Noto Sans Medium\",\n italic: \"Noto Sans Italic\",\n // No point-of-interest icons (no sprite to host): the app's own markers carry the places that matter.\n pois: undefined,\n landcover: undefined,\n };\n}\n\n/** A region of the basemap: its PMTiles file and the zoom up to which it has tiles. */\nexport type MapRegion = { url: string; maxzoom: number };\n\nexport type MapStyleOptions = {\n /** `dark` or `light`: the scheme of the page or the app. */\n scheme: \"dark\" | \"light\";\n /** The product whose accent the map carries (its markers, its water's tint). Default `krizaka`. */\n brand?: MapBrand;\n /** The look: `plain` (default), or `notebook` (the Cahier's paper and ink). */\n variant?: MapVariant;\n /** The language of the labels (`fr`, `en`): the place names in it where OpenStreetMap has them. Default `en`. */\n lang?: string;\n /** The low zooms of the whole world. Default: our world extract (zoom 0–6). */\n world?: MapRegion | null;\n /** The detailed region drawn from zoom 7. Default: Montréal–Québec (up to 14, overzoomed beyond). */\n region?: MapRegion | null;\n /** The glyphs' URL template. Default: our Noto Sans on the CDN. */\n glyphs?: string;\n};\n\n/** The zoom where the detailed region takes over from the world. */\nexport const REGION_FROM_ZOOM = 6.5;\n\ntype StyleLayer = { id: string; minzoom?: number; maxzoom?: number; [k: string]: unknown };\n\n/** The world's layers: the background once, the others under `world-` and cut where the region takes over. */\nfunction worldLayers(layerList: StyleLayer[], hasRegion: boolean): StyleLayer[] {\n return layerList.map((l) => {\n if (l.id === \"background\") return l;\n const maxzoom = hasRegion ? Math.min(l.maxzoom ?? 24, REGION_FROM_ZOOM) : l.maxzoom;\n return { ...l, id: `world-${l.id}`, ...(maxzoom === undefined ? {} : { maxzoom }) };\n });\n}\n\n/** The region's layers under `region-`, from the zoom where it takes over; its background only when there is no world. */\nfunction regionLayers(layerList: StyleLayer[], hasWorld: boolean): StyleLayer[] {\n return layerList\n .filter((l) => l.id !== \"background\" || !hasWorld)\n .map((l) => (l.id === \"background\" ? l : { ...l, id: `region-${l.id}`, minzoom: hasWorld ? Math.max(l.minzoom ?? 0, REGION_FROM_ZOOM) : l.minzoom }));\n}\n\n/**\n * The MapLibre style of a Krizaka map (a `StyleSpecification`): the world's low zooms, then the detailed region,\n * painted from the tokens. The `pmtiles://` sources need the PMTiles protocol (the web `Map` registers it; MapLibre\n * Native reads it as it is).\n */\nexport function mapStyle({ scheme, brand, variant, lang = \"en\", world = { url: mapAssets().tiles.world, maxzoom: 6 }, region = { url: mapAssets().tiles.quebec, maxzoom: 14 }, glyphs = mapAssets().glyphs }: MapStyleOptions) {\n const flavor = mapFlavor(scheme, brand, variant);\n const attribution = `<a href=\"${MAP_ATTRIBUTION.protomapsUrl}\">${MAP_ATTRIBUTION.protomaps}</a> · <a href=\"${MAP_ATTRIBUTION.osmUrl}\">${MAP_ATTRIBUTION.osm}</a>`;\n const sources: Record<string, unknown> = {};\n const all: StyleLayer[] = [];\n if (world) {\n sources.world = { type: \"vector\", url: `pmtiles://${world.url}`, attribution };\n all.push(...worldLayers(layers(\"world\", flavor, { lang }) as StyleLayer[], Boolean(region)));\n }\n if (region) {\n sources.region = { type: \"vector\", url: `pmtiles://${region.url}`, attribution };\n all.push(...regionLayers(layers(\"region\", flavor, { lang }) as StyleLayer[], Boolean(world)));\n }\n // No sprite is hosted: a layer that needs an icon (points of interest) is left out — the app's markers carry the places.\n const drawn = all.filter((l) => !(l.layout as Record<string, unknown> | undefined)?.[\"icon-image\"]);\n return { version: 8 as const, glyphs, sources, layers: drawn };\n}\n"
1145
+ "content": "// The Krizaka map style, generated from the tokens (no hand-written colour): Protomaps' basemap layers\n// (@protomaps/basemaps) painted with a flavour drawn from `@krizaka/tokens` — the surfaces for the land, the accent\n// softened for the water, the text roles for the labels — in dark or light, the product's accent where a brand asks.\n// Platform-neutral: the web `Map` and the native `Map` both read it.\nimport { brands, themes } from \"@krizaka/tokens/native\";\nimport { type Flavor, layers, namedFlavor } from \"@protomaps/basemaps\";\n\nimport { MAP_ATTRIBUTION, mapAssets } from \"./assets\";\n\n/** A product of the family: its accent paints the map. */\nexport type MapBrand = keyof typeof brands;\n\n/** A colour mixed into another (`#rrggbb` only): `t` = 0 gives `a`, 1 gives `b`. */\nexport function mix(a: string, b: string, t: number): string {\n const p = (h: string) => [1, 3, 5].map((i) => Number.parseInt(h.slice(i, i + 2), 16));\n const [x, y] = [p(a), p(b)];\n return `#${x.map((v, i) => Math.round(v + (y[i]! - v) * t).toString(16).padStart(2, \"0\")).join(\"\")}`;\n}\n\n/**\n * The look of the map: `plain` (the product register) or `notebook` (the Cahier: ink lines on the paper in light, chalk on\n * the slate in dark, the margin's red for the main roads).\n */\nexport type MapVariant = \"plain\" | \"notebook\";\n\n/** The scheme a map is asked for: `auto` follows the page (web) or the app (native). */\nexport type MapScheme = \"dark\" | \"light\" | \"auto\";\n\ntype Tokens = Record<string, string>;\n\n/** A colour mixed into a base, by `d` in dark or `l` in light. */\nconst tint = (base: string, dark: boolean) => (colour: string, d: number, l: number) => mix(base, colour, dark ? d : l);\n\n/** The product register: the page's surfaces, the accent softened for the water, the roads in white (light) or a lift of the land (dark). */\nfunction plainPalette(t: Tokens, dark: boolean) {\n const land = dark ? t.surface1! : t.surface0!;\n const on = tint(land, dark);\n const text = t.textPrimary!;\n return {\n land,\n background: dark ? t.surface0! : t.surface2!,\n water: on(t.accent!, 0.18, 0.14),\n park: on(t.success!, 0.1, 0.12),\n road: dark ? on(text, 0.12, 0) : \"#ffffff\",\n roadMajor: on(text, 0.2, 0.06),\n casing: on(text, 0.05, 0.12),\n building: on(text, 0.06, 0.07),\n boundary: on(text, 0.3, 0.3),\n label: t.textSecondary!,\n labelStrong: text,\n halo: land,\n accent: t.accent!,\n onAccent: t.onAccent!,\n // The clusters and the pins' ring: a disc of the accent in the product register.\n cluster: { fill: t.accent!, stroke: land, text: t.onAccent! },\n point: { fill: t.accent!, stroke: land },\n };\n}\n\ntype Palette = ReturnType<typeof plainPalette>;\n\n/** `notebook`: the paper is the page's surface; the lines are the ink, drawn without casings, as with a pen. */\nfunction notebookPalette(plain: Palette, t: Tokens, dark: boolean): Palette {\n const paper = t.surface0!;\n const margin = t.paperRuleMargin!;\n const on = tint(paper, dark);\n const ink = t.textPrimary!;\n return {\n ...plain,\n land: paper,\n background: paper,\n water: on(t.accent!, 0.26, 0.2),\n park: on(t.paperTag!, 0.7, 0.55),\n road: on(ink, 0.32, 0.28),\n roadMajor: on(margin, 0.75, 0.7),\n casing: paper,\n halo: paper,\n // A cluster is a manila tag with its eyelet edge; a single point is the margin's red.\n cluster: { fill: t.paperTag!, stroke: t.paperTagEdge!, text: t.paperTagInk! },\n point: { fill: margin, stroke: paper },\n };\n}\n\n/** The colours of the map in a scheme (and a brand, a variant): what the style, the markers, the clusters and the static map share. */\nexport function mapPalette(scheme: \"dark\" | \"light\", brand: MapBrand = \"krizaka\", variant: MapVariant = \"plain\") {\n const t = { ...themes[scheme], ...(brands as Record<string, Partial<Record<\"dark\" | \"light\", Partial<typeof themes.dark>>>>)[brand]?.[scheme] } as unknown as Tokens;\n const dark = scheme === \"dark\";\n const plain = plainPalette(t, dark);\n if (variant === \"notebook\") return notebookPalette(plain, t, dark);\n return plain;\n}\n\n/** Which colour of the palette paints each role of the basemap flavour (the first pattern that matches the role's name; the land otherwise). */\nconst FLAVOR_ROLES: [RegExp, string][] = [\n [/halo/, \"halo\"],\n [/city_label/, \"labelStrong\"],\n [/label/, \"label\"],\n [/casing|railway/, \"casing\"],\n [/major|highway/, \"roadMajor\"],\n [/^(other|minor|link|bridges|tunnel)/, \"road\"],\n [/park|wood|scrub|zoo/, \"park\"],\n [/runway|buildings|pier/, \"building\"],\n [/water/, \"water\"],\n [/boundaries/, \"boundary\"],\n [/background/, \"background\"],\n];\n\n/** The basemap flavour of a palette: every role of Protomaps' layers filled from the tokens. */\nexport function mapFlavor(scheme: \"dark\" | \"light\", brand?: MapBrand, variant?: MapVariant): Flavor {\n const c = mapPalette(scheme, brand, variant) as unknown as Record<string, string>;\n const base = namedFlavor(scheme);\n return {\n ...base,\n ...Object.fromEntries(Object.keys(base).map((role) => [role, c[FLAVOR_ROLES.find(([re]) => re.test(role))?.[1] ?? \"land\"]])),\n regular: \"Noto Sans Regular\",\n bold: \"Noto Sans Medium\",\n italic: \"Noto Sans Italic\",\n // No point-of-interest icons (no sprite to host): the app's own markers carry the places that matter.\n pois: undefined,\n landcover: undefined,\n };\n}\n\n/** A region of the basemap: its PMTiles file and the zoom up to which it has tiles. */\nexport type MapRegion = { url: string; maxzoom: number };\n\nexport type MapStyleOptions = {\n /** `dark` or `light`: the scheme of the page or the app. */\n scheme: \"dark\" | \"light\";\n /** The product whose accent the map carries (its markers, its water's tint). Default `krizaka`. */\n brand?: MapBrand;\n /** The look: `plain` (default), or `notebook` (the Cahier's paper and ink). */\n variant?: MapVariant;\n /** The language of the labels (`fr`, `en`): the place names in it where OpenStreetMap has them. Default `en`. */\n lang?: string;\n /** The low zooms of the whole world. Default: our world extract (zoom 0–6). */\n world?: MapRegion | null;\n /** The detailed region drawn from zoom 7. Default: Montréal–Québec (up to 14, overzoomed beyond). */\n region?: MapRegion | null;\n /** The glyphs' URL template. Default: our Noto Sans on the CDN. */\n glyphs?: string;\n};\n\n/** The zoom where the detailed region takes over from the world. */\nexport const REGION_FROM_ZOOM = 6.5;\n\ntype StyleLayer = { id: string; minzoom?: number; maxzoom?: number; [k: string]: unknown };\n\n/** The world's layers: the background once, the others under `world-` and cut where the region takes over. */\nfunction worldLayers(layerList: StyleLayer[], hasRegion: boolean): StyleLayer[] {\n return layerList.map((l) => {\n if (l.id === \"background\") return l;\n const maxzoom = hasRegion ? Math.min(l.maxzoom ?? 24, REGION_FROM_ZOOM) : l.maxzoom;\n return { ...l, id: `world-${l.id}`, ...(maxzoom === undefined ? {} : { maxzoom }) };\n });\n}\n\n/** The region's layers under `region-`, from the zoom where it takes over; its background only when there is no world. */\nfunction regionLayers(layerList: StyleLayer[], hasWorld: boolean): StyleLayer[] {\n return layerList\n .filter((l) => l.id !== \"background\" || !hasWorld)\n .map((l) => (l.id === \"background\" ? l : { ...l, id: `region-${l.id}`, minzoom: hasWorld ? Math.max(l.minzoom ?? 0, REGION_FROM_ZOOM) : l.minzoom }));\n}\n\n/**\n * The MapLibre style of a Krizaka map (a `StyleSpecification`): the world's low zooms, then the detailed region,\n * painted from the tokens. The `pmtiles://` sources need the PMTiles protocol (the web `Map` registers it; MapLibre\n * Native reads it as it is).\n */\nexport function mapStyle({ scheme, brand, variant, lang = \"en\", world = { url: mapAssets().tiles.world, maxzoom: 6 }, region = { url: mapAssets().tiles.quebec, maxzoom: 14 }, glyphs = mapAssets().glyphs }: MapStyleOptions) {\n const flavor = mapFlavor(scheme, brand, variant);\n const attribution = `<a href=\"${MAP_ATTRIBUTION.protomapsUrl}\">${MAP_ATTRIBUTION.protomaps}</a> · <a href=\"${MAP_ATTRIBUTION.osmUrl}\">${MAP_ATTRIBUTION.osm}</a>`;\n const sources: Record<string, unknown> = {};\n const all: StyleLayer[] = [];\n if (world) {\n sources.world = { type: \"vector\", url: `pmtiles://${world.url}`, attribution };\n all.push(...worldLayers(layers(\"world\", flavor, { lang }) as StyleLayer[], Boolean(region)));\n }\n if (region) {\n sources.region = { type: \"vector\", url: `pmtiles://${region.url}`, attribution };\n all.push(...regionLayers(layers(\"region\", flavor, { lang }) as StyleLayer[], Boolean(world)));\n }\n // No sprite is hosted: a layer that needs an icon (points of interest) is left out — the app's markers carry the places.\n const drawn = all.filter((l) => !(l.layout as Record<string, unknown> | undefined)?.[\"icon-image\"]);\n return { version: 8 as const, glyphs, sources, layers: drawn };\n}\n"
1146
1146
  },
1147
1147
  {
1148
1148
  "path": "media.ts",
@@ -1150,7 +1150,7 @@
1150
1150
  },
1151
1151
  {
1152
1152
  "path": "meta.ts",
1153
- "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"
1153
+ "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 | \"platform-bar\"\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"
1154
1154
  },
1155
1155
  {
1156
1156
  "path": "tv.ts",
@@ -1158,7 +1158,7 @@
1158
1158
  }
1159
1159
  ],
1160
1160
  "dependencies": [
1161
- "@krizaka/tokens@^4.7.0",
1161
+ "@krizaka/tokens@^4.8.0",
1162
1162
  "@protomaps/basemaps@5.7.2",
1163
1163
  "tailwind-variants@^3.3.1"
1164
1164
  ],
@@ -138,7 +138,7 @@
138
138
  },
139
139
  {
140
140
  "path": "margin-layout/margin-layout.tsx",
141
- "content": "// Server-safe. Numbered items with margin notes for product reading pages: the number in the left margin, the note in the right\n// margin from 64 rem and folded under the item below. An ordered list, so the order a screen reader hears is number, text, note.\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const marginLayoutStyles = tv({\n slots: {\n root: \"m-0 flex list-none flex-col gap-8 p-0\",\n item: \"grid grid-cols-[2.5rem_minmax(0,1fr)] gap-x-4 gap-y-2 lg:grid-cols-[4rem_minmax(0,1fr)_16rem] lg:gap-x-8\",\n number: \"font-display text-2xl font-bold leading-none tabular-nums text-fg-accent lg:text-3xl\",\n body: \"col-start-2 min-w-0 text-fg\",\n note: \"col-start-2 min-w-0 border-l-2 border-border pl-3 text-sm text-fg-secondary lg:col-start-3 lg:row-start-1\",\n },\n});\n\nexport type MarginLayoutProps = Omit<React.ComponentProps<\"ol\">, \"children\"> & {\n /** The `MarginItem`s, in reading order. */\n children: React.ReactNode;\n};\n\n/** The list of numbered items. */\nexport function MarginLayout({ className, children, ...props }: MarginLayoutProps) {\n return (\n <ol className={marginLayoutStyles().root({ className })} {...props}>\n {children}\n </ol>\n );\n}\n\nexport type MarginItemProps = Omit<React.ComponentProps<\"li\">, \"children\"> & {\n /** The number shown in the left margin (« 1 », « 02 »). Decorative: the list already announces the position. */\n number: React.ReactNode;\n /** The note shown in the right margin from 64 rem, and under the item below it (the article cited, « See in the document »). */\n note?: React.ReactNode;\n /** The item's content. */\n children: React.ReactNode;\n};\n\n/** One item: its number, its content and, optionally, its margin note. */\nexport function MarginItem({ number, note, className, children, ...props }: MarginItemProps) {\n const s = marginLayoutStyles();\n return (\n <li className={s.item({ className })} {...props}>\n <span aria-hidden className={s.number()}>\n {number}\n </span>\n <div className={s.body()}>{children}</div>\n {note ? <div data-slot=\"note\" className={s.note()}>{note}</div> : null}\n </li>\n );\n}\n"
141
+ "content": "// Server-safe. Numbered items with margin notes for product reading pages: the number in the left margin, the note in the right\n// margin from 64 rem and folded under the item below. An ordered list, so the order a screen reader hears is number, text, note.\nimport type * as React from \"react\";\nimport { tv } from \"tailwind-variants\";\n\nexport const marginLayoutStyles = tv({\n slots: {\n root: \"m-0 flex list-none flex-col gap-8 p-0\",\n item: \"grid grid-cols-[2.5rem_minmax(0,1fr)] gap-x-4 gap-y-2 lg:grid-cols-[4rem_minmax(0,1fr)_16rem] lg:gap-x-8\",\n number: \"font-display text-2xl font-bold leading-none tabular-nums text-fg-accent lg:text-3xl\",\n body: \"col-start-2 min-w-0 text-fg\",\n note: \"col-start-2 min-w-0 border-l-2 border-border pl-3 text-sm text-fg-secondary lg:col-start-3 lg:row-start-1\",\n },\n});\n\nexport type MarginLayoutProps = Omit<React.ComponentProps<\"ol\">, \"children\"> & {\n /** The `MarginItem`s, in reading order. */\n children: React.ReactNode;\n};\n\n/** The list of numbered items. */\nexport function MarginLayout({ className, children, ...props }: Readonly<MarginLayoutProps>) {\n return (\n <ol className={marginLayoutStyles().root({ className })} {...props}>\n {children}\n </ol>\n );\n}\n\nexport type MarginItemProps = Omit<React.ComponentProps<\"li\">, \"children\"> & {\n /** The number shown in the left margin (« 1 », « 02 »). Decorative: the list already announces the position. */\n number: React.ReactNode;\n /** The note shown in the right margin from 64 rem, and under the item below it (the article cited, « See in the document »). */\n note?: React.ReactNode;\n /** The item's content. */\n children: React.ReactNode;\n};\n\n/** One item: its number, its content and, optionally, its margin note. */\nexport function MarginItem({ number, note, className, children, ...props }: Readonly<MarginItemProps>) {\n const s = marginLayoutStyles();\n return (\n <li className={s.item({ className })} {...props}>\n <span aria-hidden className={s.number()}>\n {number}\n </span>\n <div className={s.body()}>{children}</div>\n {note ? <div data-slot=\"note\" className={s.note()}>{note}</div> : null}\n </li>\n );\n}\n"
142
142
  },
143
143
  {
144
144
  "path": "margin-layout/meta.ts",
@@ -146,7 +146,7 @@
146
146
  },
147
147
  {
148
148
  "path": "meta.ts",
149
- "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"
149
+ "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 | \"platform-bar\"\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"
150
150
  }
151
151
  ],
152
152
  "dependencies": [