@krizaka/ui 3.55.0 → 3.59.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 (576) hide show
  1. package/dist/{RotatingWord-D9s7FXFD.d.ts → RotatingWord-COSabR2c.d.ts} +2 -1
  2. package/dist/account-menu.d.ts +2 -1
  3. package/dist/account-settings.d.ts +153 -61
  4. package/dist/account-settings.js +240 -97
  5. package/dist/account-settings.js.map +1 -1
  6. package/dist/achievement.d.ts +2 -1
  7. package/dist/action-bar.d.ts +3 -2
  8. package/dist/activity-feed.d.ts +2 -1
  9. package/dist/agenda.d.ts +2 -1
  10. package/dist/alert.d.ts +2 -1
  11. package/dist/anatomy-plate.d.ts +2 -1
  12. package/dist/app-header/search.d.ts +8 -7
  13. package/dist/app-header.d.ts +2 -1
  14. package/dist/app-shell.d.ts +26 -25
  15. package/dist/argument-card.d.ts +3 -2
  16. package/dist/audio-player.d.ts +2 -1
  17. package/dist/auth-layout.d.ts +11 -10
  18. package/dist/avatar/defaults.d.ts +2 -1
  19. package/dist/avatar.d.ts +2 -1
  20. package/dist/badge.d.ts +2 -1
  21. package/dist/bird-plate.d.ts +4 -2
  22. package/dist/blocks.css +77 -4
  23. package/dist/button.d.ts +2 -1
  24. package/dist/captcha.d.ts +2 -1
  25. package/dist/captcha.js +1 -0
  26. package/dist/captcha.js.map +1 -1
  27. package/dist/card-grid.d.ts +2 -1
  28. package/dist/card.d.ts +2 -1
  29. package/dist/catalogue-page.d.ts +82 -2
  30. package/dist/catalogue-page.js +156 -13
  31. package/dist/catalogue-page.js.map +1 -1
  32. package/dist/changelog-page.d.ts +2 -1
  33. package/dist/chapter.d.ts +2 -1
  34. package/dist/chat.d.ts +14 -13
  35. package/dist/checkbox.d.ts +2 -1
  36. package/dist/chip-link.d.ts +2 -1
  37. package/dist/chip-row.d.ts +8 -7
  38. package/dist/chip.d.ts +55 -1
  39. package/dist/chip.js +10 -1
  40. package/dist/choice-grid.d.ts +3 -2
  41. package/dist/chunk-27AWSJTK.js +46 -0
  42. package/dist/chunk-27AWSJTK.js.map +1 -0
  43. package/dist/{chunk-AEP3K4YD.js → chunk-4GQH27IT.js} +2 -2
  44. package/dist/{chunk-QWKCNSPF.js → chunk-5LANVCK7.js} +125 -73
  45. package/dist/chunk-5LANVCK7.js.map +1 -0
  46. package/dist/{chunk-KDXRYUD3.js → chunk-5QEXOGO2.js} +3 -1
  47. package/dist/{chunk-KDXRYUD3.js.map → chunk-5QEXOGO2.js.map} +1 -1
  48. package/dist/chunk-7J2L4HOD.js +340 -0
  49. package/dist/chunk-7J2L4HOD.js.map +1 -0
  50. package/dist/{chunk-7U5TXA5Q.js → chunk-BQ4EOR2O.js} +74 -2
  51. package/dist/chunk-BQ4EOR2O.js.map +1 -0
  52. package/dist/chunk-F6JTHPHE.js +399 -0
  53. package/dist/chunk-F6JTHPHE.js.map +1 -0
  54. package/dist/chunk-OGWB76BR.js +90 -0
  55. package/dist/chunk-OGWB76BR.js.map +1 -0
  56. package/dist/{chunk-VIPSZXO4.js → chunk-UYGUSYIC.js} +72 -2
  57. package/dist/chunk-UYGUSYIC.js.map +1 -0
  58. package/dist/chunk-WOZP3JLW.js +51 -0
  59. package/dist/chunk-WOZP3JLW.js.map +1 -0
  60. package/dist/chunk-XVXFMVG3.js +27 -0
  61. package/dist/chunk-XVXFMVG3.js.map +1 -0
  62. package/dist/code-block.d.ts +2 -1
  63. package/dist/combobox.d.ts +20 -19
  64. package/dist/combobox.js +3 -2
  65. package/dist/command.d.ts +21 -20
  66. package/dist/comparison-table.d.ts +2 -1
  67. package/dist/component-page.d.ts +2 -1
  68. package/dist/confirm-button.d.ts +2 -1
  69. package/dist/contact-page.d.ts +2 -1
  70. package/dist/continue-prompt.d.ts +2 -1
  71. package/dist/countdown.d.ts +2 -1
  72. package/dist/cover-hero.d.ts +20 -19
  73. package/dist/cover-hero.js +25 -42
  74. package/dist/cover-hero.js.map +1 -1
  75. package/dist/cta-panel.d.ts +2 -1
  76. package/dist/dashboard-layout.d.ts +50 -2
  77. package/dist/dashboard-layout.js +66 -11
  78. package/dist/dashboard-layout.js.map +1 -1
  79. package/dist/data-table.d.ts +45 -2
  80. package/dist/data-table.js +7 -3
  81. package/dist/date-picker.d.ts +29 -28
  82. package/dist/decision-list.d.ts +2 -1
  83. package/dist/description-list.d.ts +2 -1
  84. package/dist/detail-layout.d.ts +153 -20
  85. package/dist/detail-layout.js +73 -4
  86. package/dist/detail-layout.js.map +1 -1
  87. package/dist/{dialog-D42QwYb_.d.ts → dialog-DpUwec2g.d.ts} +2 -1
  88. package/dist/dialog.d.ts +3 -2
  89. package/dist/docs-article-page.d.ts +2 -1
  90. package/dist/docs-hub-page.d.ts +2 -1
  91. package/dist/docs-layout.d.ts +2 -1
  92. package/dist/docs-nav.d.ts +3 -10
  93. package/dist/document-viewer.d.ts +5 -4
  94. package/dist/doodle.d.ts +17 -6
  95. package/dist/doodle.js +40 -9
  96. package/dist/doodle.js.map +1 -1
  97. package/dist/drop-overlay.d.ts +2 -1
  98. package/dist/dropdown-menu.d.ts +2 -1
  99. package/dist/dropdown-menu.js +13 -74
  100. package/dist/dropdown-menu.js.map +1 -1
  101. package/dist/elephant.d.ts +2 -1
  102. package/dist/empty-state.d.ts +2 -1
  103. package/dist/engine-flow.d.ts +2 -1
  104. package/dist/error-page.d.ts +2 -1
  105. package/dist/file-upload.d.ts +14 -13
  106. package/dist/filter-bar.d.ts +84 -11
  107. package/dist/filter-bar.js +6 -2
  108. package/dist/flock.d.ts +3 -2
  109. package/dist/footnote.d.ts +2 -1
  110. package/dist/force-update-screen.d.ts +8 -7
  111. package/dist/form/server.d.ts +2 -1
  112. package/dist/form.d.ts +2 -1
  113. package/dist/gallery-page.d.ts +2 -1
  114. package/dist/genui.d.ts +2 -1
  115. package/dist/genui.js +3 -3
  116. package/dist/{geometry-DX-W-Yyf.d.ts → geometry-DZ4Q3hDQ.d.ts} +2 -1
  117. package/dist/glossary-term.d.ts +2 -1
  118. package/dist/glossary.d.ts +2 -1
  119. package/dist/glow-card.d.ts +2 -1
  120. package/dist/goal-gauge.d.ts +2 -1
  121. package/dist/grade-stamp.d.ts +23 -0
  122. package/dist/grade-stamp.js +42 -0
  123. package/dist/grade-stamp.js.map +1 -0
  124. package/dist/how-it-works-page.d.ts +2 -1
  125. package/dist/image-cropper.d.ts +5 -4
  126. package/dist/index.d.ts +3 -2
  127. package/dist/index.js +4 -4
  128. package/dist/iso.d.ts +2 -1
  129. package/dist/kanban.d.ts +2 -1
  130. package/dist/kbd.d.ts +2 -1
  131. package/dist/kind-config-editor.d.ts +152 -0
  132. package/dist/kind-config-editor.js +574 -0
  133. package/dist/kind-config-editor.js.map +1 -0
  134. package/dist/kpi-explained.d.ts +2 -1
  135. package/dist/landing-page.d.ts +2 -1
  136. package/dist/landscape.d.ts +2 -1
  137. package/dist/language-switch/server.d.ts +2 -1
  138. package/dist/language-switch.d.ts +11 -10
  139. package/dist/legal-page.d.ts +2 -1
  140. package/dist/link-card.d.ts +2 -1
  141. package/dist/list.d.ts +2 -1
  142. package/dist/loader.d.ts +2 -1
  143. package/dist/longform-page.d.ts +2 -1
  144. package/dist/maintenance-screen.d.ts +5 -4
  145. package/dist/map.d.ts +8 -7
  146. package/dist/map.js +24 -0
  147. package/dist/map.js.map +1 -1
  148. package/dist/markdown.d.ts +2 -1
  149. package/dist/marketing-layout.d.ts +5 -4
  150. package/dist/marquee.d.ts +2 -1
  151. package/dist/mascot-quote.d.ts +2 -1
  152. package/dist/mascot-state.d.ts +3 -2
  153. package/dist/mascots.d.ts +4 -3
  154. package/dist/match-dialog.d.ts +2 -1
  155. package/dist/media-capture.d.ts +5 -4
  156. package/dist/media-gallery.d.ts +2 -1
  157. package/dist/media-grid.d.ts +3 -10
  158. package/dist/meta-row.d.ts +2 -1
  159. package/dist/meter.d.ts +2 -1
  160. package/dist/motion.d.ts +3 -2
  161. package/dist/native/form.d.ts +2 -1
  162. package/dist/native/list.d.ts +2 -1
  163. package/dist/native/map.d.ts +2 -1
  164. package/dist/native/map.js +24 -0
  165. package/dist/native/map.js.map +1 -1
  166. package/dist/native/markdown.d.ts +2 -1
  167. package/dist/native/media-capture.d.ts +2 -1
  168. package/dist/native/media-picker.d.ts +2 -1
  169. package/dist/native/vertical-video.d.ts +2 -1
  170. package/dist/native/video-player.d.ts +2 -1
  171. package/dist/native.d.ts +230 -1
  172. package/dist/native.js +1465 -965
  173. package/dist/native.js.map +1 -1
  174. package/dist/nav-bar/me.d.ts +2 -1
  175. package/dist/nav-bar.d.ts +2 -1
  176. package/dist/next-actions.d.ts +2 -1
  177. package/dist/notification-preferences.d.ts +23 -22
  178. package/dist/notification-preferences.js +4 -3
  179. package/dist/notification-preferences.js.map +1 -1
  180. package/dist/number-ticker.d.ts +2 -1
  181. package/dist/opening-hours.d.ts +2 -1
  182. package/dist/page-header.d.ts +2 -1
  183. package/dist/page-hero.d.ts +2 -1
  184. package/dist/page-index.d.ts +2 -1
  185. package/dist/page.d.ts +2 -1
  186. package/dist/pagination.d.ts +2 -1
  187. package/dist/photo-grid.d.ts +2 -1
  188. package/dist/pointer-light.d.ts +2 -1
  189. package/dist/popover.d.ts +2 -1
  190. package/dist/pricing-page.d.ts +2 -1
  191. package/dist/product-page.d.ts +2 -1
  192. package/dist/profile-card.d.ts +2 -1
  193. package/dist/progress.d.ts +2 -1
  194. package/dist/promise-card.d.ts +2 -1
  195. package/dist/quota-meter.d.ts +2 -1
  196. package/dist/radio-group.d.ts +2 -1
  197. package/dist/radio-group.js +3 -3
  198. package/dist/rail-nav.d.ts +17 -16
  199. package/dist/rail-nav.js +22 -56
  200. package/dist/rail-nav.js.map +1 -1
  201. package/dist/recipes.d.ts +2 -1
  202. package/dist/retro-tv.d.ts +2 -1
  203. package/dist/router.d.ts +2 -1
  204. package/dist/scroll-stage.d.ts +2 -1
  205. package/dist/search-field.d.ts +2 -1
  206. package/dist/section-backdrop.d.ts +2 -1
  207. package/dist/separator.d.ts +2 -1
  208. package/dist/service-card.d.ts +9 -8
  209. package/dist/settings-layout.d.ts +2 -1
  210. package/dist/settings-layout.js +10 -324
  211. package/dist/settings-layout.js.map +1 -1
  212. package/dist/showcase.d.ts +2 -1
  213. package/dist/signature.d.ts +2 -1
  214. package/dist/site-cahier.d.ts +187 -0
  215. package/dist/site-cahier.js +844 -0
  216. package/dist/site-cahier.js.map +1 -0
  217. package/dist/site-footer.d.ts +2 -1
  218. package/dist/sites.d.ts +2 -1
  219. package/dist/skeleton.d.ts +2 -1
  220. package/dist/skip-link.d.ts +2 -1
  221. package/dist/slider.d.ts +2 -1
  222. package/dist/slot-picker.d.ts +86 -13
  223. package/dist/slot-picker.js +98 -16
  224. package/dist/slot-picker.js.map +1 -1
  225. package/dist/specimen-tag.d.ts +2 -1
  226. package/dist/speed-lines.d.ts +19 -0
  227. package/dist/speed-lines.js +45 -0
  228. package/dist/speed-lines.js.map +1 -0
  229. package/dist/spinner.d.ts +2 -1
  230. package/dist/split-view.d.ts +2 -1
  231. package/dist/stage-banner.d.ts +2 -1
  232. package/dist/stat.d.ts +2 -1
  233. package/dist/status-chip.d.ts +44 -0
  234. package/dist/status-chip.js +137 -0
  235. package/dist/status-chip.js.map +1 -0
  236. package/dist/status-page.d.ts +2 -1
  237. package/dist/step-progress.d.ts +2 -1
  238. package/dist/step-showcase.d.ts +2 -1
  239. package/dist/stepper.d.ts +2 -1
  240. package/dist/sticky-action.d.ts +28 -5
  241. package/dist/sticky-action.js +10 -4
  242. package/dist/sticky-action.js.map +1 -1
  243. package/dist/stuck.d.ts +2 -1
  244. package/dist/swipe-deck.d.ts +2 -1
  245. package/dist/switch.d.ts +2 -1
  246. package/dist/tabs.d.ts +2 -1
  247. package/dist/tag-input.d.ts +2 -1
  248. package/dist/tag-input.js +3 -2
  249. package/dist/tag-input.js.map +1 -1
  250. package/dist/tag-selector.d.ts +30 -4
  251. package/dist/tag-selector.js +90 -8
  252. package/dist/tag-selector.js.map +1 -1
  253. package/dist/taped-photo.d.ts +2 -1
  254. package/dist/taped-photo.js +3 -20
  255. package/dist/taped-photo.js.map +1 -1
  256. package/dist/terminal-replay.d.ts +2 -1
  257. package/dist/terminal-replay.js +1 -1
  258. package/dist/text-style/server.d.ts +2 -1
  259. package/dist/text-style.d.ts +2 -1
  260. package/dist/theme.d.ts +21 -1
  261. package/dist/theme.js +37 -1
  262. package/dist/theme.js.map +1 -1
  263. package/dist/toast.d.ts +2 -1
  264. package/dist/toc.d.ts +2 -1
  265. package/dist/tooltip.d.ts +2 -1
  266. package/dist/tree-view.d.ts +2 -1
  267. package/dist/update-prompt.d.ts +11 -10
  268. package/dist/upload-queue.d.ts +2 -1
  269. package/dist/verified-badge.d.ts +2 -1
  270. package/dist/versus-card.d.ts +40 -0
  271. package/dist/versus-card.js +40 -0
  272. package/dist/versus-card.js.map +1 -0
  273. package/dist/vertical-video.d.ts +2 -1
  274. package/dist/video-player.d.ts +20 -19
  275. package/dist/video-trimmer.d.ts +2 -1
  276. package/dist/virtual.d.ts +8 -7
  277. package/dist/waveform.d.ts +2 -1
  278. package/package.json +124 -39
  279. package/registry/account-menu.json +1 -1
  280. package/registry/account-settings.json +257 -5
  281. package/registry/achievement.json +1 -1
  282. package/registry/action-bar.json +1 -1
  283. package/registry/activity-feed.json +1 -1
  284. package/registry/agenda.json +1 -1
  285. package/registry/alert.json +1 -1
  286. package/registry/anatomy-plate.json +1 -1
  287. package/registry/app-header.json +1 -1
  288. package/registry/app-shell.json +1 -1
  289. package/registry/argument-card.json +1 -1
  290. package/registry/audio-player.json +1 -1
  291. package/registry/auth-layout.json +1 -1
  292. package/registry/avatar.json +1 -1
  293. package/registry/badge.json +1 -1
  294. package/registry/bird-plate.json +1 -1
  295. package/registry/button.json +1 -1
  296. package/registry/captcha.json +1 -1
  297. package/registry/card-grid.json +1 -1
  298. package/registry/card.json +1 -1
  299. package/registry/catalogue-page.json +116 -6
  300. package/registry/changelog-page.json +1 -1
  301. package/registry/chapter.json +1 -1
  302. package/registry/chat.json +1 -1
  303. package/registry/checkbox.json +1 -1
  304. package/registry/chip-link.json +1 -1
  305. package/registry/chip-row.json +1 -1
  306. package/registry/chip.json +386 -11
  307. package/registry/choice-grid.json +1 -1
  308. package/registry/code-block.json +1 -1
  309. package/registry/combobox.json +1 -1
  310. package/registry/command.json +1 -1
  311. package/registry/comparison-table.json +1 -1
  312. package/registry/component-page.json +1 -1
  313. package/registry/confirm-button.json +1 -1
  314. package/registry/contact-page.json +1 -1
  315. package/registry/continue-prompt.json +1 -1
  316. package/registry/countdown.json +1 -1
  317. package/registry/cover-hero.json +1 -1
  318. package/registry/cta-panel.json +1 -1
  319. package/registry/dashboard-layout.json +91 -5
  320. package/registry/data-table.json +156 -5
  321. package/registry/date-picker.json +1 -1
  322. package/registry/decision-list.json +1 -1
  323. package/registry/description-list.json +1 -1
  324. package/registry/detail-layout.json +199 -5
  325. package/registry/dialog.json +1 -1
  326. package/registry/docs-article-page.json +1 -1
  327. package/registry/docs-hub-page.json +1 -1
  328. package/registry/docs-layout.json +1 -1
  329. package/registry/docs-nav.json +1 -1
  330. package/registry/document-viewer.json +1 -1
  331. package/registry/doodle.json +115 -22
  332. package/registry/drop-overlay.json +1 -1
  333. package/registry/dropdown-menu.json +1 -1
  334. package/registry/elephant.json +2 -2
  335. package/registry/empty-state.json +1 -1
  336. package/registry/engine-flow.json +1 -1
  337. package/registry/error-page.json +1 -1
  338. package/registry/examples/account-settings/appearance.d.ts +4 -0
  339. package/registry/examples/account-settings/appearance.js +40 -0
  340. package/registry/examples/account-settings/appearance.tsx +30 -0
  341. package/registry/examples/catalogue-page/clients.d.ts +4 -0
  342. package/registry/examples/catalogue-page/clients.js +49 -0
  343. package/registry/examples/catalogue-page/clients.tsx +61 -0
  344. package/registry/examples/chip/marker-picker.d.ts +4 -0
  345. package/registry/examples/chip/marker-picker.js +17 -0
  346. package/registry/examples/chip/marker-picker.tsx +17 -0
  347. package/registry/examples/chip/native/marker-picker.d.ts +4 -0
  348. package/registry/examples/chip/native/marker-picker.dark.png +0 -0
  349. package/registry/examples/chip/native/marker-picker.js +18 -0
  350. package/registry/examples/chip/native/marker-picker.light.png +0 -0
  351. package/registry/examples/chip/native/marker-picker.tsx +16 -0
  352. package/registry/examples/chip/native/tags.d.ts +4 -0
  353. package/registry/examples/chip/native/tags.dark.png +0 -0
  354. package/registry/examples/chip/native/tags.js +22 -0
  355. package/registry/examples/chip/native/tags.light.png +0 -0
  356. package/registry/examples/chip/native/tags.tsx +20 -0
  357. package/registry/examples/chip/tags.d.ts +4 -0
  358. package/registry/examples/chip/tags.js +26 -0
  359. package/registry/examples/chip/tags.tsx +23 -0
  360. package/registry/examples/dashboard-layout/today.d.ts +4 -0
  361. package/registry/examples/dashboard-layout/today.js +54 -0
  362. package/registry/examples/dashboard-layout/today.tsx +63 -0
  363. package/registry/examples/data-table/bulk.d.ts +4 -0
  364. package/registry/examples/data-table/bulk.js +45 -0
  365. package/registry/examples/data-table/bulk.tsx +34 -0
  366. package/registry/examples/detail-layout/client.d.ts +4 -0
  367. package/registry/examples/detail-layout/client.js +40 -0
  368. package/registry/examples/detail-layout/client.tsx +39 -0
  369. package/registry/examples/detail-layout/new-invoice.d.ts +4 -0
  370. package/registry/examples/detail-layout/new-invoice.js +44 -0
  371. package/registry/examples/detail-layout/new-invoice.tsx +34 -0
  372. package/registry/examples/doodle/bird-sketch.d.ts +4 -0
  373. package/registry/examples/doodle/bird-sketch.js +11 -0
  374. package/registry/examples/doodle/bird-sketch.tsx +12 -0
  375. package/registry/examples/doodle/margin-marks.d.ts +4 -0
  376. package/registry/examples/doodle/margin-marks.js +27 -0
  377. package/registry/examples/doodle/margin-marks.tsx +19 -0
  378. package/registry/examples/filter-bar/views.d.ts +4 -0
  379. package/registry/examples/filter-bar/views.js +39 -0
  380. package/registry/examples/filter-bar/views.tsx +30 -0
  381. package/registry/examples/grade-stamp/coverage.d.ts +4 -0
  382. package/registry/examples/grade-stamp/coverage.js +12 -0
  383. package/registry/examples/grade-stamp/coverage.tsx +8 -0
  384. package/registry/examples/grade-stamp/lighthouse.d.ts +4 -0
  385. package/registry/examples/grade-stamp/lighthouse.js +12 -0
  386. package/registry/examples/grade-stamp/lighthouse.tsx +14 -0
  387. package/registry/examples/kind-config-editor/derived.d.ts +4 -0
  388. package/registry/examples/kind-config-editor/derived.js +26 -0
  389. package/registry/examples/kind-config-editor/derived.tsx +16 -0
  390. package/registry/examples/kind-config-editor/native/status-set.d.ts +4 -0
  391. package/registry/examples/kind-config-editor/native/status-set.dark.png +0 -0
  392. package/registry/examples/kind-config-editor/native/status-set.js +22 -0
  393. package/registry/examples/kind-config-editor/native/status-set.light.png +0 -0
  394. package/registry/examples/kind-config-editor/native/status-set.tsx +19 -0
  395. package/registry/examples/kind-config-editor/native/tag-set.d.ts +4 -0
  396. package/registry/examples/kind-config-editor/native/tag-set.dark.png +0 -0
  397. package/registry/examples/kind-config-editor/native/tag-set.js +20 -0
  398. package/registry/examples/kind-config-editor/native/tag-set.light.png +0 -0
  399. package/registry/examples/kind-config-editor/native/tag-set.tsx +18 -0
  400. package/registry/examples/kind-config-editor/status-set.d.ts +4 -0
  401. package/registry/examples/kind-config-editor/status-set.js +29 -0
  402. package/registry/examples/kind-config-editor/status-set.tsx +25 -0
  403. package/registry/examples/kind-config-editor/tag-set.d.ts +4 -0
  404. package/registry/examples/kind-config-editor/tag-set.js +20 -0
  405. package/registry/examples/kind-config-editor/tag-set.tsx +18 -0
  406. package/registry/examples/site-cahier/java-releases.d.ts +4 -0
  407. package/registry/examples/site-cahier/java-releases.js +33 -0
  408. package/registry/examples/site-cahier/java-releases.tsx +32 -0
  409. package/registry/examples/site-cahier/motion-lab.d.ts +4 -0
  410. package/registry/examples/site-cahier/motion-lab.js +32 -0
  411. package/registry/examples/site-cahier/motion-lab.tsx +29 -0
  412. package/registry/examples/site-cahier/ts-changelog.d.ts +4 -0
  413. package/registry/examples/site-cahier/ts-changelog.js +24 -0
  414. package/registry/examples/site-cahier/ts-changelog.tsx +20 -0
  415. package/registry/examples/site-cahier/ts-doc.d.ts +4 -0
  416. package/registry/examples/site-cahier/ts-doc.js +38 -0
  417. package/registry/examples/site-cahier/ts-doc.tsx +27 -0
  418. package/registry/examples/site-cahier/ui-home.d.ts +4 -0
  419. package/registry/examples/site-cahier/ui-home.js +46 -0
  420. package/registry/examples/site-cahier/ui-home.tsx +40 -0
  421. package/registry/examples/slot-picker/weeks.d.ts +4 -0
  422. package/registry/examples/slot-picker/weeks.js +45 -0
  423. package/registry/examples/slot-picker/weeks.tsx +28 -0
  424. package/registry/examples/speed-lines/hero.d.ts +4 -0
  425. package/registry/examples/speed-lines/hero.js +11 -0
  426. package/registry/examples/speed-lines/hero.tsx +12 -0
  427. package/registry/examples/speed-lines/streaks.d.ts +4 -0
  428. package/registry/examples/speed-lines/streaks.js +11 -0
  429. package/registry/examples/speed-lines/streaks.tsx +12 -0
  430. package/registry/examples/status-chip/default.d.ts +4 -0
  431. package/registry/examples/status-chip/default.js +35 -0
  432. package/registry/examples/status-chip/default.tsx +32 -0
  433. package/registry/examples/status-chip/native/default.d.ts +4 -0
  434. package/registry/examples/status-chip/native/default.dark.png +0 -0
  435. package/registry/examples/status-chip/native/default.js +26 -0
  436. package/registry/examples/status-chip/native/default.light.png +0 -0
  437. package/registry/examples/status-chip/native/default.tsx +20 -0
  438. package/registry/examples/tag-selector/creatable.d.ts +4 -0
  439. package/registry/examples/tag-selector/creatable.js +41 -0
  440. package/registry/examples/tag-selector/creatable.tsx +29 -0
  441. package/registry/examples/tag-selector/native/tags.d.ts +4 -0
  442. package/registry/examples/tag-selector/native/tags.dark.png +0 -0
  443. package/registry/examples/tag-selector/native/tags.js +19 -0
  444. package/registry/examples/tag-selector/native/tags.light.png +0 -0
  445. package/registry/examples/tag-selector/native/tags.tsx +19 -0
  446. package/registry/examples/versus-card/alternatives.d.ts +4 -0
  447. package/registry/examples/versus-card/alternatives.js +20 -0
  448. package/registry/examples/versus-card/alternatives.tsx +14 -0
  449. package/registry/examples/versus-card/releases.d.ts +4 -0
  450. package/registry/examples/versus-card/releases.js +35 -0
  451. package/registry/examples/versus-card/releases.tsx +29 -0
  452. package/registry/field.json +1 -1
  453. package/registry/file-upload.json +1 -1
  454. package/registry/filter-bar.json +208 -8
  455. package/registry/flock.json +1 -1
  456. package/registry/footnote.json +1 -1
  457. package/registry/force-update-screen.json +1 -1
  458. package/registry/form.json +1 -1
  459. package/registry/gallery-page.json +1 -1
  460. package/registry/genui.json +1 -1
  461. package/registry/glossary-term.json +1 -1
  462. package/registry/glossary.json +1 -1
  463. package/registry/glow-card.json +1 -1
  464. package/registry/goal-gauge.json +1 -1
  465. package/registry/grade-stamp.json +227 -0
  466. package/registry/how-it-works-page.json +1 -1
  467. package/registry/image-cropper.json +1 -1
  468. package/registry/index.json +323 -30
  469. package/registry/iso.json +1 -1
  470. package/registry/kanban.json +1 -1
  471. package/registry/kbd.json +1 -1
  472. package/registry/kind-config-editor.json +565 -0
  473. package/registry/kpi-explained.json +1 -1
  474. package/registry/landing-page.json +1 -1
  475. package/registry/landscape.json +1 -1
  476. package/registry/language-switch.json +1 -1
  477. package/registry/legal-page.json +1 -1
  478. package/registry/link-card.json +1 -1
  479. package/registry/list.json +1 -1
  480. package/registry/loader.json +1 -1
  481. package/registry/longform-page.json +1 -1
  482. package/registry/maintenance-screen.json +1 -1
  483. package/registry/map.json +2 -2
  484. package/registry/markdown.json +1 -1
  485. package/registry/marketing-layout.json +1 -1
  486. package/registry/marquee.json +1 -1
  487. package/registry/mascot-quote.json +1 -1
  488. package/registry/mascot-state.json +1 -1
  489. package/registry/mascots.json +1 -1
  490. package/registry/match-dialog.json +1 -1
  491. package/registry/media-capture.json +1 -1
  492. package/registry/media-gallery.json +1 -1
  493. package/registry/media-grid.json +1 -1
  494. package/registry/meta-row.json +1 -1
  495. package/registry/meter.json +1 -1
  496. package/registry/nav-bar.json +2 -2
  497. package/registry/next-actions.json +1 -1
  498. package/registry/notification-preferences.json +1 -1
  499. package/registry/number-ticker.json +1 -1
  500. package/registry/opening-hours.json +1 -1
  501. package/registry/page-header.json +1 -1
  502. package/registry/page-hero.json +1 -1
  503. package/registry/page-index.json +1 -1
  504. package/registry/page.json +1 -1
  505. package/registry/pagination.json +1 -1
  506. package/registry/photo-grid.json +1 -1
  507. package/registry/pointer-light.json +1 -1
  508. package/registry/popover.json +1 -1
  509. package/registry/pricing-page.json +1 -1
  510. package/registry/product-page.json +1 -1
  511. package/registry/profile-card.json +1 -1
  512. package/registry/progress.json +1 -1
  513. package/registry/promise-card.json +1 -1
  514. package/registry/quota-meter.json +1 -1
  515. package/registry/radio-group.json +1 -1
  516. package/registry/rail-nav.json +2 -2
  517. package/registry/recipes.json +1 -1
  518. package/registry/retro-tv.json +1 -1
  519. package/registry/router.json +1 -1
  520. package/registry/scroll-stage.json +1 -1
  521. package/registry/search-field.json +1 -1
  522. package/registry/section-backdrop.json +1 -1
  523. package/registry/separator.json +1 -1
  524. package/registry/service-card.json +1 -1
  525. package/registry/settings-layout.json +1 -1
  526. package/registry/showcase.json +1 -1
  527. package/registry/signature.json +1 -1
  528. package/registry/site-cahier.json +548 -0
  529. package/registry/site-footer.json +2 -2
  530. package/registry/sites.json +1 -1
  531. package/registry/skeleton.json +1 -1
  532. package/registry/skip-link.json +1 -1
  533. package/registry/slider.json +1 -1
  534. package/registry/slot-picker.json +156 -10
  535. package/registry/slot.json +1 -1
  536. package/registry/specimen-tag.json +1 -1
  537. package/registry/speed-lines.json +174 -0
  538. package/registry/spinner.json +1 -1
  539. package/registry/split-view.json +1 -1
  540. package/registry/stage-banner.json +1 -1
  541. package/registry/stat.json +1 -1
  542. package/registry/status-chip.json +350 -0
  543. package/registry/status-page.json +1 -1
  544. package/registry/step-progress.json +1 -1
  545. package/registry/step-showcase.json +1 -1
  546. package/registry/stepper.json +1 -1
  547. package/registry/sticky-action.json +38 -8
  548. package/registry/stuck.json +1 -1
  549. package/registry/swipe-deck.json +1 -1
  550. package/registry/switch.json +1 -1
  551. package/registry/tabs.json +1 -1
  552. package/registry/tag-input.json +1 -1
  553. package/registry/tag-selector.json +189 -12
  554. package/registry/taped-photo.json +1 -1
  555. package/registry/terminal-replay.json +1 -1
  556. package/registry/text-style.json +1 -1
  557. package/registry/theme.json +3 -3
  558. package/registry/toast.json +1 -1
  559. package/registry/toc.json +1 -1
  560. package/registry/tooltip.json +1 -1
  561. package/registry/tree-view.json +1 -1
  562. package/registry/update-prompt.json +1 -1
  563. package/registry/upload-queue.json +1 -1
  564. package/registry/verified-badge.json +1 -1
  565. package/registry/versus-card.json +194 -0
  566. package/registry/vertical-video.json +1 -1
  567. package/registry/video-player.json +1 -1
  568. package/registry/video-trimmer.json +1 -1
  569. package/registry/virtual.json +2 -2
  570. package/registry/waveform.json +1 -1
  571. package/dist/chunk-7U5TXA5Q.js.map +0 -1
  572. package/dist/chunk-OIMXKRXF.js +0 -179
  573. package/dist/chunk-OIMXKRXF.js.map +0 -1
  574. package/dist/chunk-QWKCNSPF.js.map +0 -1
  575. package/dist/chunk-VIPSZXO4.js.map +0 -1
  576. /package/dist/{chunk-AEP3K4YD.js.map → chunk-4GQH27IT.js.map} +0 -0
@@ -0,0 +1,548 @@
1
+ {
2
+ "name": "site-cahier",
3
+ "type": "primitive",
4
+ "title": "Site Cahier",
5
+ "summary": "The template of a tool site (ui., java., ts., the motion lab) that wears krizaka.com's identity: the Cahier's paper, the site's own bird and hue, taped prints, doodles, grades — a frame and regions to compose, never a fixed page.",
6
+ "description": "The template of a tool site (ui., java., ts., the motion lab) that wears krizaka.com's identity: the Cahier's paper, the site's own bird and hue, taped prints, doodles, grades — a frame and regions to compose, never a fixed page.",
7
+ "status": "beta",
8
+ "deprecated": null,
9
+ "category": "templates",
10
+ "platforms": "web",
11
+ "parity": {
12
+ "web": {
13
+ "state": "yes"
14
+ },
15
+ "native": {
16
+ "state": "n/a",
17
+ "reason": "A whole page of a public site; a phone app's screens are built from Screen, Header and the native primitives."
18
+ },
19
+ "desktop": {
20
+ "state": "n/a",
21
+ "reason": "A public site's page, not a window of the Mac app."
22
+ }
23
+ },
24
+ "whenToUse": [
25
+ "The home, the docs index, a documentation page or the changelog of an open-source tool of the family: Krizaka UI, Java, TypeScript, Motion.",
26
+ "Any site of the family that should read as the same notebook as www.krizaka.com while keeping its own bird and its own accent."
27
+ ],
28
+ "whenNotToUse": [
29
+ {
30
+ "when": "A product's marketing page, or a plain landing page with no notebook identity.",
31
+ "use": "landing-page"
32
+ }
33
+ ],
34
+ "bestPractices": [
35
+ "Adopt the language, not the layout: pick your own hero, your own featured pieces and your own rhythm — two tool sites must not look like one page with another name.",
36
+ "One bird per site, by the brand reference: the falcon watches (security), the owl reads, the duck builds (code), the flamingo answers or gets paid, the pigeon delivers.",
37
+ "Proposed mapping: Krizaka UI → duck, Java → owl, TypeScript → pigeon, Motion → flamingo. Each site also sets its own `hue`.",
38
+ "Playful pieces stay refined: a doodle or a grade supports the content, which comes first and stays readable; every grade is measured, with its source.",
39
+ "Pass the shared `NavBar` as `bar` when the site needs search or a language switch; the simple bar is for a small site."
40
+ ],
41
+ "accessibility": {
42
+ "keyboard": [],
43
+ "notes": [
44
+ "A `header` with a named `nav` (the page being read has `aria-current=\"page\"`), one `main` and the family footer's `footer`: render the template once per page and no other `main`.",
45
+ "The bird in the bar and in the hero is decoration; the site's name is the link's text.",
46
+ "Dark is chalk on slate and light is ink on paper, both at AA; the regions keep a phone layout and never scroll sideways."
47
+ ]
48
+ },
49
+ "related": [
50
+ "page-hero",
51
+ "taped-photo",
52
+ "bird-plate",
53
+ "site-footer",
54
+ "changelog-page",
55
+ "doodle",
56
+ "grade-stamp",
57
+ "versus-card",
58
+ "speed-lines"
59
+ ],
60
+ "web": {
61
+ "entry": "@krizaka/ui/site-cahier",
62
+ "import": "import { SiteCahier, SiteCahierHero, SiteCahierDoc } from \"@krizaka/ui/site-cahier\";",
63
+ "props": [
64
+ {
65
+ "component": "SiteCahier",
66
+ "description": "A tool site's frame: the Cahier's bar with the site's bird, its hue, the page, and the family footer.",
67
+ "props": [
68
+ {
69
+ "name": "bird",
70
+ "type": "\"falcon\" | \"owl\" | \"duck\" | \"flamingo\" | \"pigeon\" | \"lovebird\" | \"crane\" | \"magpie\" | \"beaver\"",
71
+ "default": null,
72
+ "description": "The site's bird, by the brand reference: the duck builds, the owl reads, the pigeon delivers, the flamingo answers, the falcon watches.",
73
+ "required": true
74
+ },
75
+ {
76
+ "name": "name",
77
+ "type": "string",
78
+ "default": null,
79
+ "description": "The site's name, never translated (`Krizaka UI`).",
80
+ "required": true
81
+ },
82
+ {
83
+ "name": "nav",
84
+ "type": "readonly SiteCahierNavItem[]",
85
+ "default": null,
86
+ "description": "The site's pages, in the bar.",
87
+ "required": true
88
+ },
89
+ {
90
+ "name": "site",
91
+ "type": "SiteId",
92
+ "default": null,
93
+ "description": "The site (`@krizaka/ui/sites`): it chooses the footer's signature and marks the family.",
94
+ "required": true
95
+ },
96
+ {
97
+ "name": "bar",
98
+ "type": "ReactNode",
99
+ "default": null,
100
+ "description": "Your own bar (the shared `NavBar`, with search and the language), in place of the simple one.",
101
+ "required": false
102
+ },
103
+ {
104
+ "name": "footer",
105
+ "type": "false | Omit<SiteFooterProps, \"current\">",
106
+ "default": null,
107
+ "description": "The family footer's props (`version`, `legal`, `labels`, the site's own columns as `children`); `false` for none.",
108
+ "required": false
109
+ },
110
+ {
111
+ "name": "homeHref",
112
+ "type": "string",
113
+ "default": "/",
114
+ "description": "The address of the home, on the bird and the name.",
115
+ "required": false
116
+ },
117
+ {
118
+ "name": "hue",
119
+ "type": "number",
120
+ "default": null,
121
+ "description": "The site's accent hue, 0 to 360: it tints the rails and the small accents of the blocks. Unset, the brand accent.",
122
+ "required": false
123
+ },
124
+ {
125
+ "name": "linkAs",
126
+ "type": "LinkComponent",
127
+ "default": null,
128
+ "description": "The app's link component (Next's `Link`).",
129
+ "required": false
130
+ },
131
+ {
132
+ "name": "navLabel",
133
+ "type": "string",
134
+ "default": "Main",
135
+ "description": "The accessible name of the navigation.",
136
+ "required": false
137
+ }
138
+ ]
139
+ },
140
+ {
141
+ "component": "SiteCahierDoc",
142
+ "description": "A documentation page on ruled paper: the title, the article in a reading column and, beside it, the page's contents.",
143
+ "props": [
144
+ {
145
+ "name": "title",
146
+ "type": "ReactNode",
147
+ "default": null,
148
+ "description": "The page's `h1`.",
149
+ "required": true
150
+ },
151
+ {
152
+ "name": "aside",
153
+ "type": "ReactNode",
154
+ "default": null,
155
+ "description": "The beside-column (the table of contents, the notes of the margin).",
156
+ "required": false
157
+ },
158
+ {
159
+ "name": "asideLabel",
160
+ "type": "string",
161
+ "default": "On this page",
162
+ "description": "The accessible name of the beside-column.",
163
+ "required": false
164
+ },
165
+ {
166
+ "name": "eyebrow",
167
+ "type": "ReactNode",
168
+ "default": null,
169
+ "description": "A mono line above the title (`Guide · 4 min`).",
170
+ "required": false
171
+ }
172
+ ]
173
+ },
174
+ {
175
+ "component": "SiteCahierHero",
176
+ "description": "The first screen of a tool site's page: a `PageHero` on plain paper, the bird taped beside it, a doodle in the margin.",
177
+ "props": [
178
+ {
179
+ "name": "title",
180
+ "type": "ReactNode",
181
+ "default": null,
182
+ "description": "The page's title: the `h1`.",
183
+ "required": true
184
+ },
185
+ {
186
+ "name": "align",
187
+ "type": "\"center\" | \"start\"",
188
+ "default": "start",
189
+ "description": "`center` for a page that opens on its title alone (a hub, a contact page).",
190
+ "required": false
191
+ },
192
+ {
193
+ "name": "aside",
194
+ "type": "ReactNode",
195
+ "default": null,
196
+ "description": "Your own picture beside the title, in place of the bird's print: a live demo, a versus card.",
197
+ "required": false
198
+ },
199
+ {
200
+ "name": "back",
201
+ "type": "{ href: string; label: string; }",
202
+ "default": null,
203
+ "description": "The way back to the parent page, above the eyebrow.",
204
+ "required": false
205
+ },
206
+ {
207
+ "name": "bird",
208
+ "type": "\"falcon\" | \"owl\" | \"duck\" | \"flamingo\" | \"pigeon\" | \"lovebird\" | \"crane\" | \"magpie\" | \"beaver\"",
209
+ "default": null,
210
+ "description": "The site's bird, taped in the notebook beside the title.",
211
+ "required": false
212
+ },
213
+ {
214
+ "name": "birdCaption",
215
+ "type": "ReactNode",
216
+ "default": null,
217
+ "description": "The note written under the print (`Plate I · the duck builds`).",
218
+ "required": false
219
+ },
220
+ {
221
+ "name": "doodle",
222
+ "type": "ReactNode",
223
+ "default": null,
224
+ "description": "A doodle (or any mark) laid in the hero's margin, decorative.",
225
+ "required": false
226
+ },
227
+ {
228
+ "name": "eyebrow",
229
+ "type": "ReactNode",
230
+ "default": null,
231
+ "description": "A short mono line above the title (where the reader is: `Open source · building block`).",
232
+ "required": false
233
+ },
234
+ {
235
+ "name": "lead",
236
+ "type": "ReactNode",
237
+ "default": null,
238
+ "description": "One or two sentences under the title: what the page gives the reader.",
239
+ "required": false
240
+ },
241
+ {
242
+ "name": "linkAs",
243
+ "type": "LinkComponent",
244
+ "default": null,
245
+ "description": "The app's link component for internal addresses (Next's `Link`); an `<a>` otherwise.",
246
+ "required": false
247
+ },
248
+ {
249
+ "name": "size",
250
+ "type": "PageSize",
251
+ "default": "default",
252
+ "description": "The width of the content.",
253
+ "required": false
254
+ }
255
+ ]
256
+ }
257
+ ],
258
+ "examples": [
259
+ {
260
+ "name": "ui-home",
261
+ "title": "Krizaka UI — the duck builds",
262
+ "description": "A home that opens on the duck taped beside the title, a doodle arrow and a measured grade.",
263
+ "template": true,
264
+ "purpose": "convince",
265
+ "why": "A developer sees at once what the tool is, how well it is kept and where to start.",
266
+ "path": "examples/site-cahier/ui-home.tsx",
267
+ "module": "@krizaka/ui/registry/examples/site-cahier/ui-home",
268
+ "code": "import { CardGrid } from \"@krizaka/ui/card-grid\";\nimport { Doodle } from \"@krizaka/ui/doodle\";\nimport { GradeStamp } from \"@krizaka/ui/grade-stamp\";\nimport { LinkCard } from \"@krizaka/ui/link-card\";\nimport { Section } from \"@krizaka/ui/page\";\nimport { SiteCahier, SiteCahierHero } from \"@krizaka/ui/site-cahier\";\n\n// TEMPLATE — a tool site's home, the duck's: its print taped beside the title, an arrow doodle and a grade from real data.\nconst coverage = { percent: 94.1, source: \"Vitest coverage report, lines, 2026-10-23\" };\n\nexport default function SiteCahierUiHome() {\n return (\n <SiteCahier\n site=\"ui\"\n name=\"Krizaka UI\"\n bird=\"duck\"\n hue={215}\n nav={[{ href: \"/installation\", label: \"Get started\", current: true }, { href: \"/components\", label: \"Components\" }, { href: \"/templates\", label: \"Templates\" }]}\n footer={{ version: \"2.0.0\" }}\n >\n <SiteCahierHero\n bird=\"duck\"\n birdCaption=\"Plate III · the duck builds\"\n eyebrow=\"Open source · design system\"\n title=\"Build every Krizaka screen from one set of pieces\"\n lead=\"Tokens, components and templates, published once and read by every product.\"\n doodle={<Doodle kind=\"arrow\" flip place=\"inline\" label=\"Start with the installation\" />}\n >\n <GradeStamp value={Math.round((coverage.percent / 100) * 20 * 10) / 10} remark=\"Très bien, continue\" source={coverage.source} />\n </SiteCahierHero>\n <Section id=\"ways-in\" number=\"§ 1\" title=\"Three ways in\" margin paper=\"ruled\">\n <CardGrid>\n <LinkCard href=\"/installation\" title=\"Install\" description=\"The packages, the stylesheet, the first component.\" />\n <LinkCard href=\"/components\" title=\"Components\" description=\"Every piece, with its examples and its rules.\" />\n <LinkCard href=\"/templates\" title=\"Templates\" description=\"Whole pages to copy as a starting point.\" />\n </CardGrid>\n </Section>\n </SiteCahier>\n );\n}\n"
269
+ },
270
+ {
271
+ "name": "java-releases",
272
+ "title": "Java — the owl reads",
273
+ "description": "A home whose hero is a versus card of two releases, then the modules as specimen tags.",
274
+ "template": true,
275
+ "purpose": "show",
276
+ "why": "A maintainer compares two releases on real figures before upgrading.",
277
+ "path": "examples/site-cahier/java-releases.tsx",
278
+ "module": "@krizaka/ui/registry/examples/site-cahier/java-releases",
279
+ "code": "import { Doodle } from \"@krizaka/ui/doodle\";\nimport { Section } from \"@krizaka/ui/page\";\nimport { SiteCahier, SiteCahierHero } from \"@krizaka/ui/site-cahier\";\nimport { SpecimenTag } from \"@krizaka/ui/specimen-tag\";\nimport { VersusCard } from \"@krizaka/ui/versus-card\";\n\n// TEMPLATE — Java's home, the owl's: no taped print, the hero is a versus card of two releases, then the modules as tags.\nconst match = {\n label: \"Krizaka Java 3.1 versus 3.0\",\n source: \"Measured by JMH and JaCoCo on the tagged builds.\",\n left: { name: \"3.1\", bird: \"owl\", caption: \"The release that reads\", stats: [{ label: \"Startup\", value: 180, max: 400, display: \"180 ms\" }, { label: \"Coverage\", value: 91, display: \"91 %\" }] },\n right: { name: \"3.0\", bird: \"duck\", caption: \"The release that builds\", stats: [{ label: \"Startup\", value: 240, max: 400, display: \"240 ms\" }, { label: \"Coverage\", value: 86, display: \"86 %\" }] },\n} as const;\n\nexport default function SiteCahierJavaReleases() {\n return (\n <SiteCahier site=\"java\" name=\"Krizaka Java\" bird=\"owl\" hue={35} nav={[{ href: \"/modules\", label: \"Modules\" }, { href: \"/guides\", label: \"Guides\" }, { href: \"/changelog\", label: \"Releases\", current: true }]} footer={{ version: \"3.1.0\" }}>\n <SiteCahierHero\n eyebrow=\"Open source · JVM\"\n title=\"Read the release before you upgrade\"\n lead=\"Two versions, face to face, on figures the build measured.\"\n aside={<VersusCard {...match} />}\n doodle={<Doodle kind=\"star\" place=\"inline\" />}\n />\n <Section id=\"modules\" number=\"§ 1\" title=\"The modules\" margin paper=\"lines\">\n <SpecimenTag code=\"KJ-01\" title=\"krizaka-core\" status={{ label: \"stable\", tone: \"ok\" }} fields={[{ label: \"reads\", value: \"settings, secrets\" }, { label: \"since\", value: \"1.0\" }]}>\n <p>Typed settings and secrets, read once at startup.</p>\n </SpecimenTag>\n </Section>\n </SiteCahier>\n );\n}\n"
280
+ },
281
+ {
282
+ "name": "motion-lab",
283
+ "title": "Motion — the flamingo answers",
284
+ "description": "A home whose hero is a live demo in a burst of speed lines, then taped prints.",
285
+ "template": true,
286
+ "purpose": "show",
287
+ "why": "A designer feels a motion primitive before reading about it.",
288
+ "path": "examples/site-cahier/motion-lab.tsx",
289
+ "module": "@krizaka/ui/registry/examples/site-cahier/motion-lab",
290
+ "code": "import { Doodle } from \"@krizaka/ui/doodle\";\nimport { Section } from \"@krizaka/ui/page\";\nimport { SiteCahier, SiteCahierHero } from \"@krizaka/ui/site-cahier\";\nimport { SpeedLines } from \"@krizaka/ui/speed-lines\";\nimport { TapedPhoto } from \"@krizaka/ui/taped-photo\";\n\n// TEMPLATE — the motion lab's home, the flamingo's: the hero is a live demo in speed lines, the prints below lean the other way.\nexport default function SiteCahierMotionLab() {\n return (\n <SiteCahier site=\"motion\" name=\"Krizaka Motion\" bird=\"flamingo\" hue={335} nav={[{ href: \"/primitives\", label: \"Primitives\", current: true }, { href: \"/easing\", label: \"Easing\" }]} footer={{ version: \"1.4.0\" }}>\n <SiteCahierHero\n eyebrow=\"Open source · motion lab\"\n title={<>Motion that <Doodle kind=\"wave\">answers</Doodle></>}\n lead=\"Play every primitive with live knobs, then copy the code.\"\n aside={\n <SpeedLines kind=\"horizontal\" count={26} style={{ minHeight: 220, minWidth: 260 }}>\n <output style={{ padding: \"10px 22px\", fontFamily: \"var(--kz-font-mono)\", background: \"var(--kz-surface-1)\", border: \"1px solid var(--kz-border-default)\" }}>ease-kz · 200 ms</output>\n </SpeedLines>\n }\n />\n <Section id=\"prints\" number=\"§ 1\" title=\"Kept in the notebook\" margin paper=\"ruled\">\n <div style={{ display: \"flex\", flexWrap: \"wrap\", gap: 32 }}>\n <TapedPhoto tilt={-2} caption=\"The arrival of a card\"><div role=\"img\" aria-label=\"A card sliding into place\" style={{ width: 240, aspectRatio: \"4 / 3\", background: \"var(--kz-surface-0)\" }} /></TapedPhoto>\n <TapedPhoto tilt={2.2} tape=\"top\" caption=\"A number climbing\"><div role=\"img\" aria-label=\"A counter ticking up\" style={{ width: 240, aspectRatio: \"4 / 3\", background: \"var(--kz-surface-0)\" }} /></TapedPhoto>\n </div>\n </Section>\n </SiteCahier>\n );\n}\n"
291
+ },
292
+ {
293
+ "name": "ts-doc",
294
+ "title": "TypeScript — a documentation page",
295
+ "description": "A reading page on ruled paper with its contents beside it, a circled word and a margin note.",
296
+ "template": true,
297
+ "purpose": "explain",
298
+ "why": "A reader follows one guide from top to bottom and finds their place again.",
299
+ "path": "examples/site-cahier/ts-doc.tsx",
300
+ "module": "@krizaka/ui/registry/examples/site-cahier/ts-doc",
301
+ "code": "import { Doodle } from \"@krizaka/ui/doodle\";\nimport { SiteCahier, SiteCahierDoc } from \"@krizaka/ui/site-cahier\";\n\n// TEMPLATE — a documentation page of the TypeScript site, the pigeon's: ruled paper, a reading column, its contents beside it.\nexport default function SiteCahierTsDoc() {\n return (\n <SiteCahier site=\"ts\" name=\"Krizaka TypeScript\" bird=\"pigeon\" hue={200} nav={[{ href: \"/guides\", label: \"Guides\", current: true }, { href: \"/api\", label: \"API\" }]} footer={{ version: \"0.8.0\" }}>\n <SiteCahierDoc\n eyebrow=\"Guide · 4 min\"\n title=\"Typed results, no exceptions\"\n aside={\n <ol style={{ margin: 0, paddingInlineStart: 18 }}>\n <li><a href=\"#why\">Why</a></li>\n <li><a href=\"#use\">Use it</a></li>\n </ol>\n }\n >\n <h2 id=\"why\">Why</h2>\n <p>\n A function that can fail says so in its type: <Doodle kind=\"circle\">a result</Doodle>, never a surprise.\n </p>\n <h2 id=\"use\">Use it</h2>\n <p>Return <code>ok(value)</code> or <code>fail(error)</code>; the caller must look at both.</p>\n </SiteCahierDoc>\n </SiteCahier>\n );\n}\n"
302
+ },
303
+ {
304
+ "name": "ts-changelog",
305
+ "title": "TypeScript — the changelog",
306
+ "description": "The shared changelog template inside the Cahier's frame, under the pigeon's bar.",
307
+ "template": true,
308
+ "purpose": "explain",
309
+ "why": "A user checks what changed in each release and whether it concerns them.",
310
+ "path": "examples/site-cahier/ts-changelog.tsx",
311
+ "module": "@krizaka/ui/registry/examples/site-cahier/ts-changelog",
312
+ "code": "import { ChangelogPage } from \"@krizaka/ui/changelog-page\";\nimport { SiteCahier } from \"@krizaka/ui/site-cahier\";\n\n// TEMPLATE — the TypeScript site's changelog: the shared changelog template, inside the Cahier's frame and the pigeon's bar.\nexport default function SiteCahierTsChangelog() {\n return (\n <SiteCahier site=\"ts\" name=\"Krizaka TypeScript\" bird=\"pigeon\" hue={200} nav={[{ href: \"/guides\", label: \"Guides\" }, { href: \"/changelog\", label: \"Changelog\", current: true }]} footer={{ version: \"0.8.0\" }}>\n <ChangelogPage\n eyebrow=\"Krizaka TypeScript\"\n title=\"What changed\"\n lead=\"Every release, newest first.\"\n kindLabels={{ added: \"Added\", changed: \"Changed\", fixed: \"Fixed\", removed: \"Removed\", security: \"Security\", breaking: \"Breaking\" }}\n logLabel=\"Releases\"\n entries={[\n { id: \"v0-8-0\", date: \"2026-10-20\", dateLabel: \"20 Oct 2026\", version: \"0.8.0\", title: \"Typed results\", changes: [{ kind: \"added\", text: \"ok() and fail() helpers.\" }, { kind: \"fixed\", text: \"Narrowing of nested results.\" }] },\n ]}\n />\n </SiteCahier>\n );\n}\n"
313
+ }
314
+ ]
315
+ },
316
+ "native": null,
317
+ "files": [
318
+ {
319
+ "path": "block-link.tsx",
320
+ "content": "// The links of the page blocks (PageHero's back link, LinkCard, ArgumentCard, ActionBar): an internal path renders\n// through the app's router link (`linkAs`, e.g. Next's `Link`), anything else is an `<a>` that opens in a new tab.\n// Shared by the block entries; never exported on its own.\nimport type * as React from \"react\";\n\n/** The app's link component (Next's `Link`, React Router's `Link`…): receives `href`, `className` and the children. */\nexport type LinkComponent = React.ElementType<{ href: string; className?: string; children?: React.ReactNode; \"aria-label\"?: string; \"aria-describedby\"?: string }>;\n\n/** An address that leaves the app: an absolute URL or a protocol (`mailto:`). */\nexport const isExternal = (href: string) => /^[a-z][a-z0-9+.-]*:/i.test(href);\n\nexport function BlockLink({\n href,\n linkAs: Link = \"a\",\n external = isExternal(href),\n rel,\n ...props\n}: Omit<React.ComponentProps<\"a\">, \"href\"> & { href: string; linkAs?: LinkComponent; external?: boolean }) {\n if (external) return <a href={href} target=\"_blank\" rel={rel ?? \"noopener noreferrer\"} {...props} />;\n const Comp = Link as React.ElementType;\n return <Comp href={href} rel={rel} {...props} />;\n}\n"
321
+ },
322
+ {
323
+ "path": "meta.ts",
324
+ "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which ui.krizaka.com (apps/site) renders as\n// ui.krizaka.com/components/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n | \"notification-preferences\"\n | \"quota-meter\"\n | \"status-chip\"\n | \"kind-config-editor\"\n | \"agenda\"\n | \"account-settings\"\n | \"drop-overlay\"\n | \"upload-queue\"\n | \"achievement\"\n | \"anatomy-plate\"\n | \"bird-plate\"\n | \"taped-photo\"\n | \"stuck\"\n | \"doodle\"\n | \"signature\"\n | \"grade-stamp\"\n | \"versus-card\"\n | \"speed-lines\"\n | \"site-cahier\"\n | \"text-style\"\n | \"flock\"\n | \"elephant\"\n | \"footnote\"\n | \"page-index\"\n | \"chapter\"\n | \"specimen-tag\"\n | \"action-bar\"\n | \"action-sheet\"\n | \"activity-feed\"\n | \"alert\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\n | \"audio-player\"\n | \"auth-layout\"\n | \"avatar\"\n | \"badge\"\n | \"button\"\n | \"captcha\"\n | \"card\"\n | \"card-grid\"\n | \"catalogue-page\"\n | \"changelog-page\"\n | \"chat\"\n | \"checkbox\"\n | \"chip\"\n | \"chip-link\"\n | \"chip-row\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"contact-page\"\n | \"continue-prompt\"\n | \"countdown\"\n | \"cover-hero\"\n | \"cta-panel\"\n | \"dashboard-layout\"\n | \"data-table\"\n | \"date-picker\"\n | \"decision-list\"\n | \"description-list\"\n | \"detail-layout\"\n | \"dialog\"\n | \"docs-article-page\"\n | \"docs-hub-page\"\n | \"docs-layout\"\n | \"docs-nav\"\n | \"document-viewer\"\n | \"dropdown-menu\"\n | \"empty-state\"\n | \"engine-flow\"\n | \"error-page\"\n | \"fab\"\n | \"field\"\n | \"file-upload\"\n | \"filter-bar\"\n | \"force-update-screen\"\n | \"form\"\n | \"gallery-page\"\n | \"genui\"\n | \"glossary\"\n | \"glossary-term\"\n | \"glow-card\"\n | \"goal-gauge\"\n | \"header\"\n | \"how-it-works-page\"\n | \"image-cropper\"\n | \"image-viewer\"\n | \"iso\"\n | \"kanban\"\n | \"kbd\"\n | \"kpi-explained\"\n | \"landing-page\"\n | \"landscape\"\n | \"legal-page\"\n | \"link-card\"\n | \"list\"\n | \"loader\"\n | \"longform-page\"\n | \"maintenance-screen\"\n | \"map\"\n | \"markdown\"\n | \"meta-row\"\n | \"waveform\"\n | \"marketing-layout\"\n | \"marquee\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\n | \"media-grid\"\n | \"language-switch\"\n | \"media-gallery\"\n | \"media-picker\"\n | \"meter\"\n | \"nav-bar\"\n | \"number-ticker\"\n | \"onboarding\"\n | \"opening-hours\"\n | \"otp-input\"\n | \"page\"\n | \"page-header\"\n | \"page-hero\"\n | \"pagination\"\n | \"permission-prompt\"\n | \"photo-grid\"\n | \"pointer-light\"\n | \"popover\"\n | \"pricing-page\"\n | \"product-page\"\n | \"profile-card\"\n | \"progress\"\n | \"promise-card\"\n | \"pull-to-refresh\"\n | \"retro-tv\"\n | \"radio-group\"\n | \"router\"\n | \"rail-nav\"\n | \"recipes\"\n | \"screen\"\n | \"scroll-stage\"\n | \"search-field\"\n | \"section-backdrop\"\n | \"segmented\"\n | \"separator\"\n | \"service-card\"\n | \"settings-layout\"\n | \"account-menu\"\n | \"showcase\"\n | \"step-showcase\"\n | \"site-footer\"\n | \"sites\"\n | \"skeleton\"\n | \"skip-link\"\n | \"slider\"\n | \"slot-picker\"\n | \"slot\"\n | \"spinner\"\n | \"sticky-action\"\n | \"splash-handoff\"\n | \"split-view\"\n | \"stage-banner\"\n | \"stat\"\n | \"status-page\"\n | \"step-progress\"\n | \"stepper\"\n | \"swipe-deck\"\n | \"swipeable-row\"\n | \"switch\"\n | \"tab-bar\"\n | \"tabs\"\n | \"tag-input\"\n | \"tag-selector\"\n | \"terminal-replay\"\n | \"theme\"\n | \"toast\"\n | \"toc\"\n | \"tooltip\"\n | \"tree-view\"\n | \"txt\"\n | \"update-prompt\"\n | \"verified-badge\"\n | \"vertical-video\"\n | \"video-player\"\n | \"video-trimmer\"\n | \"virtual\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/**\n * Why a component is not on a platform — a decision, never a silence (the parity matrix of ui.krizaka.com/platforms):\n * - `gap` (✗): it belongs there and is not built yet; `issue` is the issue that tracks it (`krizaka/krizaka-ui#275`);\n * - `n/a`: it is not meant for that platform (a site's page block on a phone, a swipe on a desktop); `use` names the\n * component that answers there, when one does.\n */\nexport type Absence =\n | { readonly status: \"gap\"; readonly issue: string; readonly reason: string; readonly use?: undefined }\n | { readonly status: \"n/a\"; readonly reason: string; readonly use?: ComponentName; readonly issue?: undefined };\n\n/**\n * Desktop is the Orazaka Mac app (Tauri 2: the system WebView renders the web components — ADR-002). `web`: the web\n * component runs there as it is; `desktop`: it also has a desktop form (a window's title bar, a denser layout…), said in\n * its documentation; otherwise the absence and why.\n */\nexport type DesktopSupport = \"web\" | \"desktop\" | Absence;\n\n/**\n * The three platforms of Krizaka UI — web · native (React Native, Expo) · desktop — for one component. The side a\n * component has is `platforms`; the side it lacks says why here: `native` is required for (and only for) a web-only\n * component, `web` for a native-only one; `desktop` always. `scripts/registry.test.mjs` fails on a missing decision.\n */\nexport interface Parity {\n readonly web?: Absence;\n readonly native?: Absence;\n readonly desktop: DesktopSupport;\n}\n\n/**\n * `stable`: its API only changes in a major. `beta`: it may still change in a minor. `deprecated`: no product uses it and\n * no work plans to — it still works, says what replaces it, and goes in the major named by `deprecated.removedIn`.\n */\nexport type Status = \"stable\" | \"beta\" | \"deprecated\";\n\n/** What a deprecated component says (required when `status` is `deprecated`, absent otherwise). */\nexport interface Deprecation {\n /** The version that deprecated it (`3.6.0`). */\n readonly since: string;\n /** The major that removes it (`4.0.0`). */\n readonly removedIn: string;\n /** What replaces it, when a component does. */\n readonly use?: ComponentName;\n /** Why it goes: no product uses it, no planned work needs it. */\n readonly reason: string;\n}\n\n/**\n * The group of the catalogue. `media`: video, sound, camera, files, cropping. `blocks`: the page blocks — the frame,\n * the hero, sections, cards that lead or argue, decisions, code, calls to act — that every page of a site is made of.\n * `layouts`: the shells of whole screens — an application, a dashboard, settings, sign-in, an object, a list and its\n * item, a site's page, a documentation page — each with its screens. `templates`: the page templates — whole pages of a\n * site (a landing, a product, a docs hub, a long read, a changelog, pricing, status, an error…), each a distinct\n * composition of the blocks, words and content as props.\n */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"media\" | \"blocks\" | \"layouts\" | \"templates\" | \"layout\" | \"foundations\";\n\n/** Why a reader needs a template: the seven intents the templates are grouped by (sidebar sub-headings, catalogue filter). */\nexport type TemplatePurpose = \"convince\" | \"explain\" | \"show\" | \"act\" | \"operate\" | \"converse\" | \"recover\";\n\n/** The groups of templates, in reading order: the title, and the one line that says when to come to that group. */\nexport const templatePurposes = {\n convince: { title: \"Convince\", useWhen: \"You come here when a visitor must decide: a landing, a product, a price, a comparison, a proof.\" },\n explain: { title: \"Explain\", useWhen: \"You come here when a reader must understand: how it works, a documentation hub or article, a changelog, a FAQ, a policy.\" },\n show: { title: \"Show\", useWhen: \"You come here when the work itself is the argument: a gallery, a story, a case study, an object and its details.\" },\n act: { title: \"Act\", useWhen: \"You come here when a person must do something once: reach the team, sign in or up, set up, pay.\" },\n operate: { title: \"Operate\", useWhen: \"You come here when a person works every day: a dashboard, a console with a table, settings, an app shell.\" },\n converse: { title: \"Converse\", useWhen: \"You come here when people talk: an inbox, a chat, comments, a notifications centre.\" },\n recover: { title: \"Recover\", useWhen: \"You come here when the way is blocked: an empty list, an error, a missing page, maintenance, a product still being built.\" },\n} as const satisfies Record<TemplatePurpose, { readonly title: string; readonly useWhen: string }>;\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\ninterface ExampleBase {\n /** The file name, kebab-case (`primary`, `icon-button`). */\n readonly name: string;\n /** A short title (`Primary`, `Icon button`). */\n readonly title: string;\n /** One or two sentences: when this variant is the right one. */\n readonly description: string;\n}\n\n/** A plain example, or a template: a whole screen with its intent (`purpose`) and the user goal its layout serves (`why`). */\nexport type Example =\n | (ExampleBase & { readonly template?: false; readonly purpose?: undefined; readonly why?: undefined })\n | (ExampleBase & {\n /**\n * A template: a whole screen of a product composed from the platform (a layout and its blocks, real words, its\n * phone version thought out), copied as a starting point — at most 160 lines, listed on ui.krizaka.com/templates.\n */\n readonly template: true;\n /** The intent that groups it: why you need this block. */\n readonly purpose: TemplatePurpose;\n /** Why this layout: the user goal it serves, in one sentence. */\n readonly why: string;\n });\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n readonly imports: readonly string[];\n /** The examples, in reading order; the first one is the component's preview. */\n readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n /**\n * The entry to import from when it is not `@krizaka/ui/native`: a component that needs an Expo module (an optional\n * peer) has its own, `@krizaka/ui/native/<name>`, so an app that does not use it never installs the module.\n */\n readonly entry?: string;\n /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n readonly differences: readonly string[];\n /** The React Native entry alone is deprecated while the web one stays (ADR-006 §7); a deprecated component says it once, above. */\n readonly deprecated?: Deprecation;\n}\n\nexport interface KeyboardInteraction {\n /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n readonly keys: string;\n /** What they do. */\n readonly action: string;\n}\n\nexport interface ComponentMeta {\n /** The display name: `Button`, `Dropdown menu`. */\n readonly title: string;\n /** One sentence: what it is. */\n readonly summary: string;\n readonly status: Status;\n /** Required for, and only for, a `deprecated` component. */\n readonly deprecated?: Deprecation;\n readonly category: Category;\n /** Must match the sides below: `both` ⇔ `web` and `native`. */\n readonly platforms: Platform;\n /** The platforms it is not on, and why; and its desktop form (see `Parity`). */\n readonly parity: Parity;\n /** When to reach for it: concrete situations, one per item. */\n readonly whenToUse: readonly string[];\n /** When not to — and what to use instead (`use`), when another component is the answer. */\n readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n /** How to use it well: wording, placement, composition. */\n readonly bestPractices: readonly string[];\n readonly accessibility: {\n /** The keyboard, when it does more than Tab and Enter. */\n readonly keyboard: readonly KeyboardInteraction[];\n /** Roles, names and announcements: what the component does, what the app must provide. */\n readonly notes: readonly string[];\n };\n /** The components a reader of this page should know about. */\n readonly related: readonly ComponentName[];\n readonly web?: PlatformDocs;\n readonly native?: NativeDocs;\n}\n"
325
+ },
326
+ {
327
+ "path": "site-cahier/index.ts",
328
+ "content": "/** @krizaka/ui/site-cahier — `SiteCahier`: the frame of a tool site that wears krizaka.com's identity (the Cahier, its bird, its hue), with `SiteCahierHero` and `SiteCahierDoc`. Client. */\nexport { SiteCahier, SiteCahierDoc, type SiteCahierDocProps, SiteCahierHero, type SiteCahierHeroProps, type SiteCahierNavItem, type SiteCahierProps } from \"./site-cahier\";\n"
329
+ },
330
+ {
331
+ "path": "site-cahier/meta.ts",
332
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Site Cahier\",\n summary:\n \"The template of a tool site (ui., java., ts., the motion lab) that wears krizaka.com's identity: the Cahier's paper, the site's own bird and hue, taped prints, doodles, grades — a frame and regions to compose, never a fixed page.\",\n status: \"beta\",\n category: \"templates\",\n platforms: \"web\",\n parity: {\n native: { status: \"n/a\", reason: \"A whole page of a public site; a phone app's screens are built from Screen, Header and the native primitives.\" },\n desktop: { status: \"n/a\", reason: \"A public site's page, not a window of the Mac app.\" },\n },\n whenToUse: [\n \"The home, the docs index, a documentation page or the changelog of an open-source tool of the family: Krizaka UI, Java, TypeScript, Motion.\",\n \"Any site of the family that should read as the same notebook as www.krizaka.com while keeping its own bird and its own accent.\",\n ],\n whenNotToUse: [\n { when: \"A product's marketing page, or a plain landing page with no notebook identity.\", use: \"landing-page\" },\n ],\n bestPractices: [\n \"Adopt the language, not the layout: pick your own hero, your own featured pieces and your own rhythm — two tool sites must not look like one page with another name.\",\n \"One bird per site, by the brand reference: the falcon watches (security), the owl reads, the duck builds (code), the flamingo answers or gets paid, the pigeon delivers.\",\n \"Proposed mapping: Krizaka UI → duck, Java → owl, TypeScript → pigeon, Motion → flamingo. Each site also sets its own `hue`.\",\n \"Playful pieces stay refined: a doodle or a grade supports the content, which comes first and stays readable; every grade is measured, with its source.\",\n \"Pass the shared `NavBar` as `bar` when the site needs search or a language switch; the simple bar is for a small site.\",\n ],\n accessibility: {\n keyboard: [],\n notes: [\n \"A `header` with a named `nav` (the page being read has `aria-current=\\\"page\\\"`), one `main` and the family footer's `footer`: render the template once per page and no other `main`.\",\n \"The bird in the bar and in the hero is decoration; the site's name is the link's text.\",\n \"Dark is chalk on slate and light is ink on paper, both at AA; the regions keep a phone layout and never scroll sideways.\",\n ],\n },\n related: [\"page-hero\", \"taped-photo\", \"bird-plate\", \"site-footer\", \"changelog-page\", \"doodle\", \"grade-stamp\", \"versus-card\", \"speed-lines\"],\n web: {\n imports: [\"SiteCahier\", \"SiteCahierHero\", \"SiteCahierDoc\"],\n examples: [\n { name: \"ui-home\", title: \"Krizaka UI — the duck builds\", description: \"A home that opens on the duck taped beside the title, a doodle arrow and a measured grade.\", template: true, purpose: \"convince\", why: \"A developer sees at once what the tool is, how well it is kept and where to start.\" },\n { name: \"java-releases\", title: \"Java — the owl reads\", description: \"A home whose hero is a versus card of two releases, then the modules as specimen tags.\", template: true, purpose: \"show\", why: \"A maintainer compares two releases on real figures before upgrading.\" },\n { name: \"motion-lab\", title: \"Motion — the flamingo answers\", description: \"A home whose hero is a live demo in a burst of speed lines, then taped prints.\", template: true, purpose: \"show\", why: \"A designer feels a motion primitive before reading about it.\" },\n { name: \"ts-doc\", title: \"TypeScript — a documentation page\", description: \"A reading page on ruled paper with its contents beside it, a circled word and a margin note.\", template: true, purpose: \"explain\", why: \"A reader follows one guide from top to bottom and finds their place again.\" },\n { name: \"ts-changelog\", title: \"TypeScript — the changelog\", description: \"The shared changelog template inside the Cahier's frame, under the pigeon's bar.\", template: true, purpose: \"explain\", why: \"A user checks what changed in each release and whether it concerns them.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
333
+ },
334
+ {
335
+ "path": "site-cahier/site-cahier.tsx",
336
+ "content": "// Client (the birds hold an id). The template of the tool sites (ui., java., ts., the motion lab) that wear krizaka.com's\n// identity — the Cahier (ADR-004), the site's bird, taped prints — shared here, never copied per site. It carries the language,\n// not a layout: `SiteCahier` is the frame (the bar with the bird, the nav, the family footer, the site's hue), and the regions\n// (`SiteCahierHero`, `SiteCahierDoc`, and every block of the package) are composed by each site in its own order.\nimport type * as React from \"react\";\n\nimport { BlockLink, type LinkComponent } from \"../block-link\";\nimport { cn } from \"../cn\";\nimport type { MascotBird } from \"../mascots/geometry\";\nimport { Mascot } from \"../mascots/mascot\";\nimport { Page } from \"../page/page\";\nimport { PageHero, type PageHeroProps } from \"../page-hero/page-hero\";\nimport { SiteFooter, type SiteFooterProps } from \"../site-footer/site-footer\";\nimport type { SiteId } from \"../sites/sites\";\nimport { TapedPhoto } from \"../taped-photo/taped-photo\";\n\nexport interface SiteCahierNavItem {\n /** Where it goes. */\n href: string;\n /** What the reader reads. */\n label: React.ReactNode;\n /** The page being read: marked `aria-current=\"page\"`. */\n current?: boolean;\n}\n\nexport type SiteCahierProps = Omit<React.HTMLAttributes<HTMLDivElement>, \"title\"> & {\n /** The site (`@krizaka/ui/sites`): it chooses the footer's signature and marks the family. */\n site: SiteId;\n /** The site's name, never translated (`Krizaka UI`). */\n name: string;\n /** The site's bird, by the brand reference: the duck builds, the owl reads, the pigeon delivers, the flamingo answers, the falcon watches. */\n bird: MascotBird;\n /** The site's accent hue, 0 to 360: it tints the rails and the small accents of the blocks. Unset, the brand accent. */\n hue?: number;\n /** The site's pages, in the bar. */\n nav: readonly SiteCahierNavItem[];\n /** The accessible name of the navigation. @default \"Main\" */\n navLabel?: string;\n /** The address of the home, on the bird and the name. @default \"/\" */\n homeHref?: string;\n /** The app's link component (Next's `Link`). */\n linkAs?: LinkComponent;\n /** Your own bar (the shared `NavBar`, with search and the language), in place of the simple one. */\n bar?: React.ReactNode;\n /** The family footer's props (`version`, `legal`, `labels`, the site's own columns as `children`); `false` for none. */\n footer?: Omit<SiteFooterProps, \"current\"> | false;\n /** The pages: compose the regions and the blocks. */\n children?: React.ReactNode;\n};\n\n/** A tool site's frame: the Cahier's bar with the site's bird, its hue, the page, and the family footer. */\nexport function SiteCahier({ site, name, bird, hue, nav, navLabel = \"Main\", homeHref = \"/\", linkAs, bar, footer, className, style, children, ...props }: SiteCahierProps) {\n const h = hue === undefined || !Number.isFinite(hue) ? undefined : ((Math.round(hue) % 360) + 360) % 360;\n const tint =\n h === undefined\n ? undefined\n : ({\n \"--kz-hue\": `hsl(${h} 62% 52%)`,\n \"--kz-hue-2\": `hsl(${(h + 30) % 360} 62% 52%)`,\n \"--kz-hue-text\": \"var(--kz-text-primary)\",\n } as React.CSSProperties);\n return (\n <div className={cn(\"kz-cahier\", className)} data-site={site} style={{ ...tint, ...style }} {...props}>\n {bar ?? (\n <header className=\"kz-cahier-bar\">\n <Page>\n <div className=\"kz-cahier-bar-row\">\n <BlockLink href={homeHref} linkAs={linkAs} className=\"kz-cahier-brand\">\n <Mascot bird={bird} tone=\"own\" size={30} animated={false} />\n <span>{name}</span>\n </BlockLink>\n <nav aria-label={navLabel}>\n <ul className=\"kz-cahier-nav\">\n {nav.map((item, i) => (\n <li key={i}>\n <BlockLink href={item.href} linkAs={linkAs} aria-current={item.current ? \"page\" : undefined}>\n {item.label}\n </BlockLink>\n </li>\n ))}\n </ul>\n </nav>\n </div>\n </Page>\n </header>\n )}\n <main className=\"kz-cahier-main\">{children}</main>\n {footer === false ? null : <SiteFooter current={site} {...footer} />}\n </div>\n );\n}\n\nexport type SiteCahierHeroProps = Omit<PageHeroProps, \"aside\" | \"backdrop\"> & {\n /** The site's bird, taped in the notebook beside the title. */\n bird?: MascotBird;\n /** The note written under the print (`Plate I · the duck builds`). */\n birdCaption?: React.ReactNode;\n /** Your own picture beside the title, in place of the bird's print: a live demo, a versus card. */\n aside?: React.ReactNode;\n /** A doodle (or any mark) laid in the hero's margin, decorative. */\n doodle?: React.ReactNode;\n};\n\n/** The first screen of a tool site's page: a `PageHero` on plain paper, the bird taped beside it, a doodle in the margin. */\nexport function SiteCahierHero({ bird, birdCaption, aside, doodle, children, ...props }: SiteCahierHeroProps) {\n const print = aside ?? (bird ? (\n <TapedPhoto tape=\"top\" tilt={2} caption={birdCaption}>\n <div className=\"kz-cahier-print\">\n <Mascot bird={bird} tone=\"own\" size={150} animated={false} />\n </div>\n </TapedPhoto>\n ) : undefined);\n return (\n <div className=\"kz-cahier-hero\">\n <PageHero backdrop=\"plain\" aside={print} {...props}>\n {children}\n </PageHero>\n {doodle && <div className=\"kz-cahier-doodle\">{doodle}</div>}\n </div>\n );\n}\n\nexport type SiteCahierDocProps = Omit<React.HTMLAttributes<HTMLElement>, \"title\"> & {\n /** The page's `h1`. */\n title: React.ReactNode;\n /** A mono line above the title (`Guide · 4 min`). */\n eyebrow?: React.ReactNode;\n /** The beside-column (the table of contents, the notes of the margin). */\n aside?: React.ReactNode;\n /** The accessible name of the beside-column. @default \"On this page\" */\n asideLabel?: string;\n /** The article. */\n children: React.ReactNode;\n};\n\n/** A documentation page on ruled paper: the title, the article in a reading column and, beside it, the page's contents. */\nexport function SiteCahierDoc({ title, eyebrow, aside, asideLabel = \"On this page\", className, children, ...props }: SiteCahierDocProps) {\n return (\n <Page size=\"wide\" paper=\"lines\" margin>\n <div className=\"kz-cahier-doc\" data-aside={aside ? \"\" : undefined}>\n <article className={cn(\"kz-cahier-article\", className)} {...props}>\n {eyebrow && <p className=\"kz-eyebrow\">{eyebrow}</p>}\n <h1 className=\"kz-hero-title\">{title}</h1>\n <div className=\"kz-tpl-prose\">{children}</div>\n </article>\n {aside && (\n <aside className=\"kz-cahier-aside\" aria-label={asideLabel}>\n {aside}\n </aside>\n )}\n </div>\n </Page>\n );\n}\n"
337
+ }
338
+ ],
339
+ "dependencies": [],
340
+ "registryDependencies": [
341
+ "cn",
342
+ "mascots",
343
+ "page",
344
+ "page-hero",
345
+ "site-footer",
346
+ "sites",
347
+ "taped-photo"
348
+ ],
349
+ "demo": {
350
+ "path": "examples/site-cahier/ui-home.tsx",
351
+ "content": "import { CardGrid } from \"@krizaka/ui/card-grid\";\nimport { Doodle } from \"@krizaka/ui/doodle\";\nimport { GradeStamp } from \"@krizaka/ui/grade-stamp\";\nimport { LinkCard } from \"@krizaka/ui/link-card\";\nimport { Section } from \"@krizaka/ui/page\";\nimport { SiteCahier, SiteCahierHero } from \"@krizaka/ui/site-cahier\";\n\n// TEMPLATE — a tool site's home, the duck's: its print taped beside the title, an arrow doodle and a grade from real data.\nconst coverage = { percent: 94.1, source: \"Vitest coverage report, lines, 2026-10-23\" };\n\nexport default function SiteCahierUiHome() {\n return (\n <SiteCahier\n site=\"ui\"\n name=\"Krizaka UI\"\n bird=\"duck\"\n hue={215}\n nav={[{ href: \"/installation\", label: \"Get started\", current: true }, { href: \"/components\", label: \"Components\" }, { href: \"/templates\", label: \"Templates\" }]}\n footer={{ version: \"2.0.0\" }}\n >\n <SiteCahierHero\n bird=\"duck\"\n birdCaption=\"Plate III · the duck builds\"\n eyebrow=\"Open source · design system\"\n title=\"Build every Krizaka screen from one set of pieces\"\n lead=\"Tokens, components and templates, published once and read by every product.\"\n doodle={<Doodle kind=\"arrow\" flip place=\"inline\" label=\"Start with the installation\" />}\n >\n <GradeStamp value={Math.round((coverage.percent / 100) * 20 * 10) / 10} remark=\"Très bien, continue\" source={coverage.source} />\n </SiteCahierHero>\n <Section id=\"ways-in\" number=\"§ 1\" title=\"Three ways in\" margin paper=\"ruled\">\n <CardGrid>\n <LinkCard href=\"/installation\" title=\"Install\" description=\"The packages, the stylesheet, the first component.\" />\n <LinkCard href=\"/components\" title=\"Components\" description=\"Every piece, with its examples and its rules.\" />\n <LinkCard href=\"/templates\" title=\"Templates\" description=\"Whole pages to copy as a starting point.\" />\n </CardGrid>\n </Section>\n </SiteCahier>\n );\n}\n"
352
+ },
353
+ "props": [
354
+ {
355
+ "component": "SiteCahier",
356
+ "description": "A tool site's frame: the Cahier's bar with the site's bird, its hue, the page, and the family footer.",
357
+ "props": [
358
+ {
359
+ "name": "bird",
360
+ "type": "\"falcon\" | \"owl\" | \"duck\" | \"flamingo\" | \"pigeon\" | \"lovebird\" | \"crane\" | \"magpie\" | \"beaver\"",
361
+ "default": null,
362
+ "description": "The site's bird, by the brand reference: the duck builds, the owl reads, the pigeon delivers, the flamingo answers, the falcon watches.",
363
+ "required": true
364
+ },
365
+ {
366
+ "name": "name",
367
+ "type": "string",
368
+ "default": null,
369
+ "description": "The site's name, never translated (`Krizaka UI`).",
370
+ "required": true
371
+ },
372
+ {
373
+ "name": "nav",
374
+ "type": "readonly SiteCahierNavItem[]",
375
+ "default": null,
376
+ "description": "The site's pages, in the bar.",
377
+ "required": true
378
+ },
379
+ {
380
+ "name": "site",
381
+ "type": "SiteId",
382
+ "default": null,
383
+ "description": "The site (`@krizaka/ui/sites`): it chooses the footer's signature and marks the family.",
384
+ "required": true
385
+ },
386
+ {
387
+ "name": "bar",
388
+ "type": "ReactNode",
389
+ "default": null,
390
+ "description": "Your own bar (the shared `NavBar`, with search and the language), in place of the simple one.",
391
+ "required": false
392
+ },
393
+ {
394
+ "name": "footer",
395
+ "type": "false | Omit<SiteFooterProps, \"current\">",
396
+ "default": null,
397
+ "description": "The family footer's props (`version`, `legal`, `labels`, the site's own columns as `children`); `false` for none.",
398
+ "required": false
399
+ },
400
+ {
401
+ "name": "homeHref",
402
+ "type": "string",
403
+ "default": "/",
404
+ "description": "The address of the home, on the bird and the name.",
405
+ "required": false
406
+ },
407
+ {
408
+ "name": "hue",
409
+ "type": "number",
410
+ "default": null,
411
+ "description": "The site's accent hue, 0 to 360: it tints the rails and the small accents of the blocks. Unset, the brand accent.",
412
+ "required": false
413
+ },
414
+ {
415
+ "name": "linkAs",
416
+ "type": "LinkComponent",
417
+ "default": null,
418
+ "description": "The app's link component (Next's `Link`).",
419
+ "required": false
420
+ },
421
+ {
422
+ "name": "navLabel",
423
+ "type": "string",
424
+ "default": "Main",
425
+ "description": "The accessible name of the navigation.",
426
+ "required": false
427
+ }
428
+ ]
429
+ },
430
+ {
431
+ "component": "SiteCahierDoc",
432
+ "description": "A documentation page on ruled paper: the title, the article in a reading column and, beside it, the page's contents.",
433
+ "props": [
434
+ {
435
+ "name": "title",
436
+ "type": "ReactNode",
437
+ "default": null,
438
+ "description": "The page's `h1`.",
439
+ "required": true
440
+ },
441
+ {
442
+ "name": "aside",
443
+ "type": "ReactNode",
444
+ "default": null,
445
+ "description": "The beside-column (the table of contents, the notes of the margin).",
446
+ "required": false
447
+ },
448
+ {
449
+ "name": "asideLabel",
450
+ "type": "string",
451
+ "default": "On this page",
452
+ "description": "The accessible name of the beside-column.",
453
+ "required": false
454
+ },
455
+ {
456
+ "name": "eyebrow",
457
+ "type": "ReactNode",
458
+ "default": null,
459
+ "description": "A mono line above the title (`Guide · 4 min`).",
460
+ "required": false
461
+ }
462
+ ]
463
+ },
464
+ {
465
+ "component": "SiteCahierHero",
466
+ "description": "The first screen of a tool site's page: a `PageHero` on plain paper, the bird taped beside it, a doodle in the margin.",
467
+ "props": [
468
+ {
469
+ "name": "title",
470
+ "type": "ReactNode",
471
+ "default": null,
472
+ "description": "The page's title: the `h1`.",
473
+ "required": true
474
+ },
475
+ {
476
+ "name": "align",
477
+ "type": "\"center\" | \"start\"",
478
+ "default": "start",
479
+ "description": "`center` for a page that opens on its title alone (a hub, a contact page).",
480
+ "required": false
481
+ },
482
+ {
483
+ "name": "aside",
484
+ "type": "ReactNode",
485
+ "default": null,
486
+ "description": "Your own picture beside the title, in place of the bird's print: a live demo, a versus card.",
487
+ "required": false
488
+ },
489
+ {
490
+ "name": "back",
491
+ "type": "{ href: string; label: string; }",
492
+ "default": null,
493
+ "description": "The way back to the parent page, above the eyebrow.",
494
+ "required": false
495
+ },
496
+ {
497
+ "name": "bird",
498
+ "type": "\"falcon\" | \"owl\" | \"duck\" | \"flamingo\" | \"pigeon\" | \"lovebird\" | \"crane\" | \"magpie\" | \"beaver\"",
499
+ "default": null,
500
+ "description": "The site's bird, taped in the notebook beside the title.",
501
+ "required": false
502
+ },
503
+ {
504
+ "name": "birdCaption",
505
+ "type": "ReactNode",
506
+ "default": null,
507
+ "description": "The note written under the print (`Plate I · the duck builds`).",
508
+ "required": false
509
+ },
510
+ {
511
+ "name": "doodle",
512
+ "type": "ReactNode",
513
+ "default": null,
514
+ "description": "A doodle (or any mark) laid in the hero's margin, decorative.",
515
+ "required": false
516
+ },
517
+ {
518
+ "name": "eyebrow",
519
+ "type": "ReactNode",
520
+ "default": null,
521
+ "description": "A short mono line above the title (where the reader is: `Open source · building block`).",
522
+ "required": false
523
+ },
524
+ {
525
+ "name": "lead",
526
+ "type": "ReactNode",
527
+ "default": null,
528
+ "description": "One or two sentences under the title: what the page gives the reader.",
529
+ "required": false
530
+ },
531
+ {
532
+ "name": "linkAs",
533
+ "type": "LinkComponent",
534
+ "default": null,
535
+ "description": "The app's link component for internal addresses (Next's `Link`); an `<a>` otherwise.",
536
+ "required": false
537
+ },
538
+ {
539
+ "name": "size",
540
+ "type": "PageSize",
541
+ "default": "default",
542
+ "description": "The width of the content.",
543
+ "required": false
544
+ }
545
+ ]
546
+ }
547
+ ]
548
+ }