@krizaka/ui 3.62.0 → 3.63.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (635) hide show
  1. package/README.md +13 -16
  2. package/dist/account-menu.d.ts +1 -1
  3. package/dist/account-menu.js +1 -1
  4. package/dist/account-settings.d.ts +1 -1
  5. package/dist/account-settings.js +2 -2
  6. package/dist/achievement.d.ts +2 -2
  7. package/dist/achievement.js +1 -1
  8. package/dist/achievement.js.map +1 -1
  9. package/dist/action-bar.js +4 -4
  10. package/dist/activity-feed.d.ts +1 -1
  11. package/dist/activity-feed.js.map +1 -1
  12. package/dist/analysis-report.d.ts +274 -0
  13. package/dist/analysis-report.js +207 -0
  14. package/dist/analysis-report.js.map +1 -0
  15. package/dist/app-shell.js.map +1 -1
  16. package/dist/argument-card.d.ts +1 -1
  17. package/dist/argument-card.js +5 -5
  18. package/dist/auth-layout.d.ts +1 -1
  19. package/dist/auth-layout.js.map +1 -1
  20. package/dist/avatar/defaults.d.ts +2 -1
  21. package/dist/avatar/defaults.js.map +1 -1
  22. package/dist/{avatar-iajODANU.d.ts → avatar-BL2iG_Js.d.ts} +2 -1
  23. package/dist/avatar.d.ts +3 -2
  24. package/dist/avatar.js.map +1 -1
  25. package/dist/badge.js +4 -34
  26. package/dist/badge.js.map +1 -1
  27. package/dist/bird-plate.d.ts +1 -1
  28. package/dist/bird-plate.js +1 -1
  29. package/dist/blocks.css +99 -8
  30. package/dist/button.js +1 -1
  31. package/dist/captcha.js +1 -1
  32. package/dist/chat.js +1 -1
  33. package/dist/choice-grid.d.ts +1 -1
  34. package/dist/choice-grid.js +1 -1
  35. package/dist/choice-grid.js.map +1 -1
  36. package/dist/chunk-5PFCELGW.js +41 -0
  37. package/dist/chunk-5PFCELGW.js.map +1 -0
  38. package/dist/chunk-5RWHDX5J.js +37 -0
  39. package/dist/chunk-5RWHDX5J.js.map +1 -0
  40. package/dist/{chunk-KB7OLYIJ.js → chunk-7AZ23BUX.js} +1 -1
  41. package/dist/chunk-7AZ23BUX.js.map +1 -0
  42. package/dist/{chunk-4E5IUZHR.js → chunk-B2HS5EAH.js} +1 -1
  43. package/dist/chunk-B2HS5EAH.js.map +1 -0
  44. package/dist/{chunk-5LANVCK7.js → chunk-BG5APGX6.js} +2 -2
  45. package/dist/{chunk-WOZP3JLW.js → chunk-DJ5ZPPWL.js} +1 -1
  46. package/dist/chunk-DJ5ZPPWL.js.map +1 -0
  47. package/dist/{chunk-MHUUNC5W.js → chunk-DRTIE44Z.js} +1 -1
  48. package/dist/chunk-DRTIE44Z.js.map +1 -0
  49. package/dist/{chunk-UV4HBVH7.js → chunk-EB45EVPJ.js} +2 -2
  50. package/dist/{chunk-SJS6RJIT.js.map → chunk-EB45EVPJ.js.map} +1 -1
  51. package/dist/{chunk-555LWYIN.js → chunk-EHTXLZSM.js} +1 -1
  52. package/dist/{chunk-555LWYIN.js.map → chunk-EHTXLZSM.js.map} +1 -1
  53. package/dist/{chunk-6EAHUURY.js → chunk-GHAN7OOE.js} +2 -2
  54. package/dist/chunk-JT7ZKZT5.js +1 -0
  55. package/dist/chunk-JT7ZKZT5.js.map +1 -0
  56. package/dist/{chunk-3DHNN5V7.js → chunk-M3GEYLMR.js} +2 -2
  57. package/dist/{chunk-3DHNN5V7.js.map → chunk-M3GEYLMR.js.map} +1 -1
  58. package/dist/{chunk-7J2L4HOD.js → chunk-MTVX4RRF.js} +2 -2
  59. package/dist/{chunk-7J2L4HOD.js.map → chunk-MTVX4RRF.js.map} +1 -1
  60. package/dist/{chunk-YKEIOYJ5.js → chunk-NPMGYLJV.js} +1 -1
  61. package/dist/chunk-NPMGYLJV.js.map +1 -0
  62. package/dist/{chunk-3RVFD3UX.js → chunk-PW2FVPTV.js} +1 -1
  63. package/dist/chunk-PW2FVPTV.js.map +1 -0
  64. package/dist/{chunk-HEKDKM5Y.js → chunk-QVHSV6RA.js} +1 -1
  65. package/dist/{chunk-MIMOTE4W.js → chunk-RCHKIOVV.js} +1 -1
  66. package/dist/chunk-RCHKIOVV.js.map +1 -0
  67. package/dist/{chunk-7JG3VR4C.js → chunk-RCKXJEDQ.js} +5 -5
  68. package/dist/{chunk-XVFQZ3ZG.js → chunk-TPITVAUW.js} +1 -1
  69. package/dist/{chunk-XVFQZ3ZG.js.map → chunk-TPITVAUW.js.map} +1 -1
  70. package/dist/chunk-U4XTZMB7.js +103 -0
  71. package/dist/chunk-U4XTZMB7.js.map +1 -0
  72. package/dist/{chunk-SJS6RJIT.js → chunk-V7W4RLRW.js} +2 -2
  73. package/dist/{chunk-UV4HBVH7.js.map → chunk-V7W4RLRW.js.map} +1 -1
  74. package/dist/{chunk-RBETQO2P.js → chunk-Y5YBTHVD.js} +9 -15
  75. package/dist/chunk-Y5YBTHVD.js.map +1 -0
  76. package/dist/command.js +2 -2
  77. package/dist/confirm-button.js +1 -1
  78. package/dist/continue-prompt.js +2 -2
  79. package/dist/continue-prompt.js.map +1 -1
  80. package/dist/cover-hero.js +1 -1
  81. package/dist/dashboard-layout.js.map +1 -1
  82. package/dist/data-table.js +2 -2
  83. package/dist/detail-layout.js.map +1 -1
  84. package/dist/dialog.js +2 -2
  85. package/dist/elephant.js.map +1 -1
  86. package/dist/embed-facade.d.ts +37 -0
  87. package/dist/embed-facade.js +96 -0
  88. package/dist/embed-facade.js.map +1 -0
  89. package/dist/engine-flow.d.ts +4 -4
  90. package/dist/engine-flow.js.map +1 -1
  91. package/dist/environment-notice.d.ts +110 -0
  92. package/dist/environment-notice.js +47 -0
  93. package/dist/environment-notice.js.map +1 -0
  94. package/dist/file-upload.d.ts +2 -2
  95. package/dist/flock.js +1 -1
  96. package/dist/force-update-screen.js +1 -1
  97. package/dist/genui.js +2 -2
  98. package/dist/{geometry-DZ4Q3hDQ.d.ts → geometry-DDlFDtiQ.d.ts} +3 -4
  99. package/dist/{geometry-DncHaYP8.d.ts → geometry-DuUQyHZ1.d.ts} +3 -4
  100. package/dist/goal-gauge.d.ts +1 -1
  101. package/dist/goal-gauge.js +1 -1
  102. package/dist/goal-gauge.js.map +1 -1
  103. package/dist/index.d.ts +15 -1
  104. package/dist/index.js +1 -1
  105. package/dist/kind-config-editor.js +1 -1
  106. package/dist/landing-page.d.ts +1 -1
  107. package/dist/landing-page.js.map +1 -1
  108. package/dist/language-switch.d.ts +9 -9
  109. package/dist/link-card.js +2 -2
  110. package/dist/loader.d.ts +1 -1
  111. package/dist/loader.js.map +1 -1
  112. package/dist/maintenance-screen.js +1 -1
  113. package/dist/map.js +6 -0
  114. package/dist/map.js.map +1 -1
  115. package/dist/margin-layout.d.ts +71 -0
  116. package/dist/margin-layout.js +29 -0
  117. package/dist/margin-layout.js.map +1 -0
  118. package/dist/mascot-quote.d.ts +1 -1
  119. package/dist/mascot-quote.js +1 -1
  120. package/dist/mascot-state.js +1 -1
  121. package/dist/mascots.d.ts +2 -2
  122. package/dist/mascots.js +1 -1
  123. package/dist/match-dialog.js +2 -2
  124. package/dist/media-grid.d.ts +1 -0
  125. package/dist/media-grid.js +2 -2
  126. package/dist/meter.js +2 -1
  127. package/dist/native/map.js +6 -0
  128. package/dist/native/map.js.map +1 -1
  129. package/dist/native.d.ts +125 -10
  130. package/dist/native.js +1690 -1517
  131. package/dist/native.js.map +1 -1
  132. package/dist/nav-bar.d.ts +1 -1
  133. package/dist/nav-bar.js +3 -3
  134. package/dist/page-DPHDmDAQ.d.ts +131 -0
  135. package/dist/page-hero.js +4 -4
  136. package/dist/page.d.ts +7 -125
  137. package/dist/page.js +13 -1
  138. package/dist/page.js.map +1 -1
  139. package/dist/product-page.d.ts +1 -1
  140. package/dist/product-page.js.map +1 -1
  141. package/dist/profile-card.d.ts +1 -1
  142. package/dist/profile-card.js +1 -1
  143. package/dist/profile-card.js.map +1 -1
  144. package/dist/promise-card.js +1 -1
  145. package/dist/quota-meter.js +2 -1
  146. package/dist/quota-meter.js.map +1 -1
  147. package/dist/rail-nav.d.ts +4 -0
  148. package/dist/retro-tv.d.ts +6 -3
  149. package/dist/retro-tv.js +6 -5
  150. package/dist/retro-tv.js.map +1 -1
  151. package/dist/reviews.d.ts +49 -0
  152. package/dist/reviews.js +66 -0
  153. package/dist/reviews.js.map +1 -0
  154. package/dist/scroll-stage.d.ts +1 -1
  155. package/dist/scroll-stage.js +1 -1
  156. package/dist/scroll-stage.js.map +1 -1
  157. package/dist/separator.d.ts +26 -3
  158. package/dist/separator.js +19 -1
  159. package/dist/separator.js.map +1 -1
  160. package/dist/service-card.d.ts +56 -63
  161. package/dist/service-card.js +49 -10
  162. package/dist/service-card.js.map +1 -1
  163. package/dist/settings-layout.js +1 -1
  164. package/dist/site-cahier.d.ts +10 -2
  165. package/dist/site-cahier.js +9 -15
  166. package/dist/site-cahier.js.map +1 -1
  167. package/dist/site-footer.d.ts +1 -1
  168. package/dist/site-footer.js +2 -2
  169. package/dist/{sites-BKz1beUK.d.ts → sites-CEnywB89.d.ts} +10 -2
  170. package/dist/sites.d.ts +13 -5
  171. package/dist/sites.js +7 -13
  172. package/dist/sites.js.map +1 -1
  173. package/dist/specimen-tag.d.ts +15 -3
  174. package/dist/specimen-tag.js +4 -27
  175. package/dist/specimen-tag.js.map +1 -1
  176. package/dist/stage-banner.d.ts +1 -1
  177. package/dist/stage-banner.js +1 -1
  178. package/dist/stage-banner.js.map +1 -1
  179. package/dist/stat.d.ts +87 -5
  180. package/dist/stat.js +9 -53
  181. package/dist/stat.js.map +1 -1
  182. package/dist/status-page.d.ts +1 -1
  183. package/dist/status-page.js.map +1 -1
  184. package/dist/sticky-action.d.ts +7 -2
  185. package/dist/sticky-action.js +24 -3
  186. package/dist/sticky-action.js.map +1 -1
  187. package/dist/theme.js +1 -1
  188. package/dist/update-prompt.js +1 -1
  189. package/dist/usage.d.ts +229 -0
  190. package/dist/usage.js +189 -0
  191. package/dist/usage.js.map +1 -0
  192. package/dist/versus-card.js +1 -1
  193. package/dist/vertical-video.js +2 -2
  194. package/dist/wall.d.ts +24 -12
  195. package/dist/wall.js +106 -43
  196. package/dist/wall.js.map +1 -1
  197. package/package.json +108 -17
  198. package/registry/account-menu.json +1 -1
  199. package/registry/account-settings.json +1 -1
  200. package/registry/achievement.json +8 -8
  201. package/registry/action-bar.json +1 -1
  202. package/registry/activity-feed.json +8 -8
  203. package/registry/agenda.json +1 -1
  204. package/registry/alert.json +1 -1
  205. package/registry/analysis-report.json +445 -0
  206. package/registry/anatomy-plate.json +1 -1
  207. package/registry/app-header.json +3 -3
  208. package/registry/app-shell.json +10 -10
  209. package/registry/argument-card.json +3 -3
  210. package/registry/audio-player.json +6 -6
  211. package/registry/auth-layout.json +9 -9
  212. package/registry/avatar.json +8 -8
  213. package/registry/badge.json +1 -1
  214. package/registry/bird-plate.json +1 -1
  215. package/registry/button.json +2 -2
  216. package/registry/captcha.json +1 -1
  217. package/registry/card-grid.json +6 -6
  218. package/registry/card.json +1 -1
  219. package/registry/catalogue-page.json +1 -1
  220. package/registry/changelog-page.json +1 -1
  221. package/registry/chapter.json +1 -1
  222. package/registry/chat.json +3 -3
  223. package/registry/checkbox.json +1 -1
  224. package/registry/chip-link.json +1 -1
  225. package/registry/chip-row.json +1 -1
  226. package/registry/chip.json +1 -1
  227. package/registry/choice-grid.json +6 -6
  228. package/registry/code-block.json +1 -1
  229. package/registry/combobox.json +1 -1
  230. package/registry/command.json +1 -1
  231. package/registry/comparison-table.json +1 -1
  232. package/registry/component-page.json +1 -1
  233. package/registry/confirm-button.json +1 -1
  234. package/registry/contact-page.json +1 -1
  235. package/registry/continue-prompt.json +2 -2
  236. package/registry/countdown.json +1 -1
  237. package/registry/cover-hero.json +1 -1
  238. package/registry/cta-panel.json +1 -1
  239. package/registry/dashboard-layout.json +2 -2
  240. package/registry/data-table.json +1 -1
  241. package/registry/date-picker.json +2 -2
  242. package/registry/decision-list.json +1 -1
  243. package/registry/description-list.json +1 -1
  244. package/registry/detail-layout.json +6 -6
  245. package/registry/dialog.json +1 -1
  246. package/registry/docs-article-page.json +1 -1
  247. package/registry/docs-hub-page.json +3 -3
  248. package/registry/docs-layout.json +1 -1
  249. package/registry/docs-nav.json +1 -1
  250. package/registry/document-viewer.json +1 -1
  251. package/registry/doodle.json +1 -1
  252. package/registry/drop-overlay.json +1 -1
  253. package/registry/dropdown-menu.json +1 -1
  254. package/registry/elephant.json +7 -7
  255. package/registry/embed-facade.json +243 -0
  256. package/registry/empty-state.json +2 -2
  257. package/registry/engine-flow.json +6 -6
  258. package/registry/environment-notice.json +270 -0
  259. package/registry/error-page.json +1 -1
  260. package/registry/examples/achievement/arcade.js +1 -1
  261. package/registry/examples/achievement/arcade.tsx +1 -1
  262. package/registry/examples/activity-feed/job-activity.tsx +1 -1
  263. package/registry/examples/analysis-report/document-validation.js +47 -0
  264. package/registry/examples/analysis-report/document-validation.tsx +29 -0
  265. package/registry/examples/analysis-report/native/document-validation.dark.png +0 -0
  266. package/registry/examples/analysis-report/native/document-validation.js +48 -0
  267. package/registry/examples/analysis-report/native/document-validation.light.png +0 -0
  268. package/registry/examples/analysis-report/native/document-validation.tsx +32 -0
  269. package/registry/examples/analysis-report/streaming.d.ts +4 -0
  270. package/registry/examples/analysis-report/streaming.js +42 -0
  271. package/registry/examples/analysis-report/streaming.tsx +23 -0
  272. package/registry/examples/app-shell/admin-console.js +1 -1
  273. package/registry/examples/app-shell/admin-console.tsx +2 -2
  274. package/registry/examples/app-shell/basic.js +1 -1
  275. package/registry/examples/app-shell/basic.tsx +1 -1
  276. package/registry/examples/app-shell/creator-studio.d.ts +4 -0
  277. package/registry/examples/app-shell/{orochia-studio.js → creator-studio.js} +6 -6
  278. package/registry/examples/app-shell/{orochia-studio.tsx → creator-studio.tsx} +4 -4
  279. package/registry/examples/audio-player/podcast.js +1 -1
  280. package/registry/examples/audio-player/podcast.tsx +1 -1
  281. package/registry/examples/audio-player/voice-note.js +1 -1
  282. package/registry/examples/audio-player/voice-note.tsx +1 -1
  283. package/registry/examples/auth-layout/onboarding.js +3 -3
  284. package/registry/examples/auth-layout/onboarding.tsx +3 -3
  285. package/registry/examples/auth-layout/sign-in.js +3 -3
  286. package/registry/examples/auth-layout/sign-in.tsx +3 -3
  287. package/registry/examples/avatar/default.js +1 -1
  288. package/registry/examples/avatar/default.tsx +1 -1
  289. package/registry/examples/card-grid/aligned.js +2 -2
  290. package/registry/examples/card-grid/aligned.tsx +2 -2
  291. package/registry/examples/card-grid/foundation.js +1 -2
  292. package/registry/examples/card-grid/foundation.tsx +1 -2
  293. package/registry/examples/card-grid/hover-quiet.js +1 -1
  294. package/registry/examples/card-grid/hover-quiet.tsx +1 -1
  295. package/registry/examples/card-grid/products.js +1 -1
  296. package/registry/examples/card-grid/products.tsx +1 -1
  297. package/registry/examples/choice-grid/line-up.js +1 -1
  298. package/registry/examples/choice-grid/line-up.tsx +1 -1
  299. package/registry/examples/detail-layout/checkout.js +1 -1
  300. package/registry/examples/detail-layout/checkout.tsx +2 -2
  301. package/registry/examples/detail-layout/video.js +1 -1
  302. package/registry/examples/detail-layout/video.tsx +2 -2
  303. package/registry/examples/docs-hub-page/krizaka.js +1 -1
  304. package/registry/examples/docs-hub-page/krizaka.tsx +1 -1
  305. package/registry/examples/embed-facade/tiktok.d.ts +4 -0
  306. package/registry/examples/embed-facade/tiktok.js +20 -0
  307. package/registry/examples/embed-facade/tiktok.tsx +16 -0
  308. package/registry/examples/embed-facade/youtube.d.ts +4 -0
  309. package/registry/examples/embed-facade/youtube.js +22 -0
  310. package/registry/examples/embed-facade/youtube.tsx +20 -0
  311. package/registry/examples/empty-state/library.js +1 -1
  312. package/registry/examples/empty-state/library.tsx +1 -1
  313. package/registry/examples/engine-flow/calm.js +1 -1
  314. package/registry/examples/engine-flow/calm.tsx +1 -1
  315. package/registry/examples/engine-flow/compact.js +4 -4
  316. package/registry/examples/engine-flow/compact.tsx +4 -4
  317. package/registry/examples/engine-flow/radial.js +2 -6
  318. package/registry/examples/engine-flow/radial.tsx +1 -5
  319. package/registry/examples/environment-notice/development.d.ts +4 -0
  320. package/registry/examples/environment-notice/development.js +15 -0
  321. package/registry/examples/environment-notice/development.tsx +13 -0
  322. package/registry/examples/environment-notice/native/development.d.ts +4 -0
  323. package/registry/examples/environment-notice/native/development.dark.png +0 -0
  324. package/registry/examples/environment-notice/native/development.js +21 -0
  325. package/registry/examples/environment-notice/native/development.light.png +0 -0
  326. package/registry/examples/environment-notice/native/development.tsx +17 -0
  327. package/registry/examples/environment-notice/staging.d.ts +4 -0
  328. package/registry/examples/environment-notice/staging.js +11 -0
  329. package/registry/examples/environment-notice/staging.tsx +6 -0
  330. package/registry/examples/force-update-screen/default.js +1 -1
  331. package/registry/examples/force-update-screen/default.tsx +1 -1
  332. package/registry/examples/force-update-screen/native/default.dark.png +0 -0
  333. package/registry/examples/force-update-screen/native/default.js +1 -1
  334. package/registry/examples/force-update-screen/native/default.light.png +0 -0
  335. package/registry/examples/force-update-screen/native/default.tsx +1 -1
  336. package/registry/examples/form/native/sign-up.js +2 -2
  337. package/registry/examples/form/native/sign-up.tsx +2 -2
  338. package/registry/examples/form/sign-up.js +1 -1
  339. package/registry/examples/form/sign-up.tsx +3 -3
  340. package/registry/examples/goal-gauge/arcade.js +1 -1
  341. package/registry/examples/goal-gauge/arcade.tsx +1 -1
  342. package/registry/examples/image-cropper/avatar.js +1 -1
  343. package/registry/examples/image-cropper/avatar.tsx +1 -1
  344. package/registry/examples/image-cropper/banner.js +1 -1
  345. package/registry/examples/image-cropper/banner.tsx +1 -1
  346. package/registry/examples/image-cropper/vertical-video.js +1 -2
  347. package/registry/examples/image-cropper/vertical-video.tsx +1 -3
  348. package/registry/examples/iso/creator-hero.d.ts +4 -0
  349. package/registry/examples/iso/{orochia-hero.js → creator-hero.js} +3 -3
  350. package/registry/examples/iso/{orochia-hero.tsx → creator-hero.tsx} +1 -1
  351. package/registry/examples/landing-page/krizaka.js +2 -2
  352. package/registry/examples/landing-page/krizaka.tsx +2 -2
  353. package/registry/examples/link-card/docs-hub.js +1 -1
  354. package/registry/examples/link-card/docs-hub.tsx +1 -1
  355. package/registry/examples/link-card/hover-quiet.js +1 -1
  356. package/registry/examples/link-card/hover-quiet.tsx +1 -1
  357. package/registry/examples/loader/branded.js +2 -2
  358. package/registry/examples/loader/branded.tsx +3 -3
  359. package/registry/examples/loader/native/branded.dark.png +0 -0
  360. package/registry/examples/loader/native/branded.js +1 -1
  361. package/registry/examples/loader/native/branded.light.png +0 -0
  362. package/registry/examples/loader/native/branded.tsx +2 -2
  363. package/registry/examples/longform-page/story.js +3 -3
  364. package/registry/examples/longform-page/story.tsx +3 -3
  365. package/registry/examples/margin-layout/findings.d.ts +4 -0
  366. package/registry/examples/margin-layout/findings.js +15 -0
  367. package/registry/examples/margin-layout/findings.tsx +18 -0
  368. package/registry/examples/margin-layout/steps.d.ts +4 -0
  369. package/registry/examples/margin-layout/steps.js +15 -0
  370. package/registry/examples/margin-layout/steps.tsx +16 -0
  371. package/registry/examples/marketing-layout/docs-hub.js +1 -1
  372. package/registry/examples/marketing-layout/docs-hub.tsx +1 -1
  373. package/registry/examples/mascots/flock.tsx +2 -2
  374. package/registry/examples/nav-bar/family-admin.js +5 -5
  375. package/registry/examples/nav-bar/family-admin.tsx +4 -4
  376. package/registry/examples/nav-bar/site.js +1 -1
  377. package/registry/examples/nav-bar/site.tsx +1 -1
  378. package/registry/examples/page/kraft.d.ts +4 -0
  379. package/registry/examples/page/kraft.js +14 -0
  380. package/registry/examples/page/kraft.tsx +12 -0
  381. package/registry/examples/page/papers.d.ts +4 -0
  382. package/registry/examples/page/papers.js +14 -0
  383. package/registry/examples/page/papers.tsx +13 -0
  384. package/registry/examples/permission-prompt/native/blocked.dark.png +0 -0
  385. package/registry/examples/permission-prompt/native/blocked.js +1 -1
  386. package/registry/examples/permission-prompt/native/blocked.tsx +1 -1
  387. package/registry/examples/permission-prompt/native/camera.dark.png +0 -0
  388. package/registry/examples/permission-prompt/native/camera.js +1 -1
  389. package/registry/examples/permission-prompt/native/camera.light.png +0 -0
  390. package/registry/examples/permission-prompt/native/camera.tsx +1 -1
  391. package/registry/examples/profile-card/match.js +1 -1
  392. package/registry/examples/profile-card/match.tsx +1 -1
  393. package/registry/examples/promise-card/arcade.js +1 -1
  394. package/registry/examples/promise-card/arcade.tsx +1 -1
  395. package/registry/examples/pull-to-refresh/native/branded.dark.png +0 -0
  396. package/registry/examples/pull-to-refresh/native/branded.js +1 -1
  397. package/registry/examples/pull-to-refresh/native/branded.light.png +0 -0
  398. package/registry/examples/pull-to-refresh/native/branded.tsx +1 -1
  399. package/registry/examples/rail-nav/expandable.js +3 -3
  400. package/registry/examples/rail-nav/expandable.tsx +3 -3
  401. package/registry/examples/retro-tv/cabinet.js +1 -2
  402. package/registry/examples/retro-tv/cabinet.tsx +1 -3
  403. package/registry/examples/retro-tv/facade.d.ts +4 -0
  404. package/registry/examples/retro-tv/facade.js +12 -0
  405. package/registry/examples/retro-tv/facade.tsx +13 -0
  406. package/registry/examples/retro-tv/portable.js +1 -2
  407. package/registry/examples/retro-tv/portable.tsx +1 -3
  408. package/registry/examples/reviews/card.d.ts +4 -0
  409. package/registry/examples/reviews/card.js +23 -0
  410. package/registry/examples/reviews/card.tsx +19 -0
  411. package/registry/examples/reviews/summary.d.ts +4 -0
  412. package/registry/examples/reviews/summary.js +23 -0
  413. package/registry/examples/reviews/summary.tsx +17 -0
  414. package/registry/examples/scroll-stage/arcade.js +1 -1
  415. package/registry/examples/scroll-stage/arcade.tsx +1 -1
  416. package/registry/examples/search-field/global.js +1 -1
  417. package/registry/examples/search-field/global.tsx +1 -1
  418. package/registry/examples/separator/hand.d.ts +4 -0
  419. package/registry/examples/separator/hand.js +19 -0
  420. package/registry/examples/separator/hand.tsx +16 -0
  421. package/registry/examples/service-card/index-card.d.ts +4 -0
  422. package/registry/examples/service-card/index-card.js +15 -0
  423. package/registry/examples/service-card/index-card.tsx +12 -0
  424. package/registry/examples/service-card/index-list.d.ts +4 -0
  425. package/registry/examples/service-card/index-list.js +14 -0
  426. package/registry/examples/service-card/index-list.tsx +11 -0
  427. package/registry/examples/sites/french.js +1 -1
  428. package/registry/examples/sites/french.tsx +1 -1
  429. package/registry/examples/specimen-tag/facts.d.ts +4 -0
  430. package/registry/examples/specimen-tag/facts.js +23 -0
  431. package/registry/examples/specimen-tag/facts.tsx +18 -0
  432. package/registry/examples/specimen-tag/wire.js +2 -2
  433. package/registry/examples/specimen-tag/wire.tsx +2 -2
  434. package/registry/examples/splash-handoff/native/default.dark.png +0 -0
  435. package/registry/examples/splash-handoff/native/default.js +1 -1
  436. package/registry/examples/splash-handoff/native/default.light.png +0 -0
  437. package/registry/examples/splash-handoff/native/default.tsx +1 -1
  438. package/registry/examples/split-view/messages.tsx +1 -1
  439. package/registry/examples/split-view/notifications.js +1 -1
  440. package/registry/examples/split-view/notifications.tsx +1 -1
  441. package/registry/examples/stat/strip.d.ts +4 -0
  442. package/registry/examples/stat/strip.js +25 -0
  443. package/registry/examples/stat/strip.tsx +25 -0
  444. package/registry/examples/status-page/building.js +2 -2
  445. package/registry/examples/status-page/building.tsx +2 -2
  446. package/registry/examples/status-page/operational.js +1 -1
  447. package/registry/examples/status-page/operational.tsx +1 -1
  448. package/registry/examples/sticky-action/hide-while-visible.d.ts +4 -0
  449. package/registry/examples/sticky-action/hide-while-visible.js +16 -0
  450. package/registry/examples/sticky-action/hide-while-visible.tsx +17 -0
  451. package/registry/examples/tab-bar/native/main-sections.tsx +1 -1
  452. package/registry/examples/tree-view/docs.js +1 -1
  453. package/registry/examples/tree-view/docs.tsx +1 -1
  454. package/registry/examples/usage/credits-page.d.ts +4 -0
  455. package/registry/examples/usage/credits-page.js +45 -0
  456. package/registry/examples/usage/credits-page.tsx +40 -0
  457. package/registry/examples/usage/empty.d.ts +4 -0
  458. package/registry/examples/usage/empty.js +15 -0
  459. package/registry/examples/usage/empty.tsx +12 -0
  460. package/registry/examples/video-player/default.js +1 -2
  461. package/registry/examples/video-player/default.tsx +1 -3
  462. package/registry/examples/video-player/gated.js +2 -3
  463. package/registry/examples/video-player/gated.tsx +2 -4
  464. package/registry/examples/video-player/native/default.dark.png +0 -0
  465. package/registry/examples/video-player/native/default.js +3 -3
  466. package/registry/examples/video-player/native/default.light.png +0 -0
  467. package/registry/examples/video-player/native/default.tsx +3 -3
  468. package/registry/examples/video-player/signed-source.js +2 -3
  469. package/registry/examples/video-player/signed-source.tsx +2 -4
  470. package/registry/examples/video-player/vertical.js +1 -2
  471. package/registry/examples/video-player/vertical.tsx +1 -3
  472. package/registry/examples/video-trimmer/filmstrip.js +10 -2
  473. package/registry/examples/video-trimmer/filmstrip.tsx +11 -2
  474. package/registry/examples/video-trimmer/playhead.js +8 -1
  475. package/registry/examples/video-trimmer/playhead.tsx +9 -1
  476. package/registry/examples/wall/brick.js +1 -1
  477. package/registry/examples/wall/brick.tsx +1 -1
  478. package/registry/examples/wall/composition-fr.js +1 -1
  479. package/registry/examples/wall/composition-fr.tsx +1 -1
  480. package/registry/examples/wall/composition.js +1 -1
  481. package/registry/examples/wall/composition.tsx +1 -1
  482. package/registry/examples/wall/pinned-note.js +2 -2
  483. package/registry/examples/wall/pinned-note.tsx +3 -2
  484. package/registry/examples/wall/plaster.js +1 -1
  485. package/registry/examples/wall/plaster.tsx +1 -1
  486. package/registry/examples/wall/ridge.js +1 -1
  487. package/registry/examples/wall/ridge.tsx +1 -1
  488. package/registry/examples/wall/shop-sign.js +5 -4
  489. package/registry/examples/wall/shop-sign.tsx +7 -4
  490. package/registry/examples/wall/zellige.js +1 -1
  491. package/registry/examples/wall/zellige.tsx +1 -1
  492. package/registry/field.json +1 -1
  493. package/registry/file-upload.json +2 -2
  494. package/registry/filter-bar.json +1 -1
  495. package/registry/flock.json +1 -1
  496. package/registry/footnote.json +1 -1
  497. package/registry/force-update-screen.json +4 -4
  498. package/registry/form.json +7 -7
  499. package/registry/gallery-page.json +1 -1
  500. package/registry/genui.json +2 -2
  501. package/registry/glossary-term.json +1 -1
  502. package/registry/glossary.json +1 -1
  503. package/registry/glow-card.json +1 -1
  504. package/registry/goal-gauge.json +6 -6
  505. package/registry/grade-stamp.json +1 -1
  506. package/registry/how-it-works-page.json +1 -1
  507. package/registry/image-cropper.json +5 -5
  508. package/registry/index.json +231 -35
  509. package/registry/iso.json +7 -7
  510. package/registry/kanban.json +3 -3
  511. package/registry/kbd.json +1 -1
  512. package/registry/kind-config-editor.json +1 -1
  513. package/registry/kpi-explained.json +2 -2
  514. package/registry/landing-page.json +6 -6
  515. package/registry/landscape.json +1 -1
  516. package/registry/language-switch.json +1 -1
  517. package/registry/legal-page.json +1 -1
  518. package/registry/link-card.json +4 -4
  519. package/registry/list.json +3 -3
  520. package/registry/loader.json +11 -11
  521. package/registry/longform-page.json +3 -3
  522. package/registry/maintenance-screen.json +1 -1
  523. package/registry/map.json +2 -2
  524. package/registry/margin-layout.json +200 -0
  525. package/registry/markdown.json +1 -1
  526. package/registry/marketing-layout.json +2 -2
  527. package/registry/marquee.json +1 -1
  528. package/registry/mascot-quote.json +1 -1
  529. package/registry/mascot-state.json +1 -1
  530. package/registry/mascots.json +5 -5
  531. package/registry/match-dialog.json +1 -1
  532. package/registry/media-capture.json +1 -1
  533. package/registry/media-gallery.json +1 -1
  534. package/registry/media-grid.json +3 -3
  535. package/registry/meta-row.json +1 -1
  536. package/registry/meter.json +1 -1
  537. package/registry/nav-bar.json +9 -9
  538. package/registry/next-actions.json +1 -1
  539. package/registry/notification-preferences.json +3 -3
  540. package/registry/number-ticker.json +1 -1
  541. package/registry/onboarding.json +1 -1
  542. package/registry/opening-hours.json +1 -1
  543. package/registry/page-header.json +1 -1
  544. package/registry/page-hero.json +1 -1
  545. package/registry/page-index.json +1 -1
  546. package/registry/page.json +53 -11
  547. package/registry/pagination.json +1 -1
  548. package/registry/permission-prompt.json +3 -3
  549. package/registry/photo-grid.json +1 -1
  550. package/registry/pointer-light.json +1 -1
  551. package/registry/popover.json +1 -1
  552. package/registry/pricing-page.json +1 -1
  553. package/registry/product-page.json +6 -6
  554. package/registry/profile-card.json +7 -7
  555. package/registry/progress.json +1 -1
  556. package/registry/promise-card.json +3 -3
  557. package/registry/pull-to-refresh.json +2 -2
  558. package/registry/quota-meter.json +1 -1
  559. package/registry/radio-group.json +1 -1
  560. package/registry/rail-nav.json +10 -10
  561. package/registry/recipes.json +1 -1
  562. package/registry/retro-tv.json +48 -32
  563. package/registry/reviews.json +361 -0
  564. package/registry/router.json +1 -1
  565. package/registry/scroll-stage.json +6 -6
  566. package/registry/search-field.json +3 -3
  567. package/registry/section-backdrop.json +1 -1
  568. package/registry/separator.json +71 -6
  569. package/registry/service-card.json +55 -6
  570. package/registry/settings-layout.json +1 -1
  571. package/registry/showcase.json +1 -1
  572. package/registry/signature.json +1 -1
  573. package/registry/site-cahier.json +1 -1
  574. package/registry/site-footer.json +7 -7
  575. package/registry/sites.json +4 -4
  576. package/registry/skeleton.json +1 -1
  577. package/registry/skip-link.json +1 -1
  578. package/registry/slider.json +1 -1
  579. package/registry/slot-picker.json +1 -1
  580. package/registry/slot.json +1 -1
  581. package/registry/specimen-tag.json +58 -6
  582. package/registry/speed-lines.json +1 -1
  583. package/registry/spinner.json +1 -1
  584. package/registry/splash-handoff.json +4 -4
  585. package/registry/split-view.json +4 -4
  586. package/registry/stage-banner.json +10 -6
  587. package/registry/stat.json +62 -10
  588. package/registry/status-chip.json +1 -1
  589. package/registry/status-page.json +9 -9
  590. package/registry/step-progress.json +1 -1
  591. package/registry/step-showcase.json +1 -1
  592. package/registry/stepper.json +1 -1
  593. package/registry/sticky-action.json +27 -4
  594. package/registry/stuck.json +1 -1
  595. package/registry/swipe-deck.json +1 -1
  596. package/registry/switch.json +1 -1
  597. package/registry/tab-bar.json +2 -2
  598. package/registry/tabs.json +1 -1
  599. package/registry/tag-input.json +1 -1
  600. package/registry/tag-selector.json +1 -1
  601. package/registry/taped-photo.json +1 -1
  602. package/registry/terminal-replay.json +1 -1
  603. package/registry/text-style.json +1 -1
  604. package/registry/theme.json +1 -1
  605. package/registry/toast.json +1 -1
  606. package/registry/toc.json +1 -1
  607. package/registry/tooltip.json +1 -1
  608. package/registry/tree-view.json +3 -3
  609. package/registry/update-prompt.json +1 -1
  610. package/registry/upload-queue.json +1 -1
  611. package/registry/usage.json +542 -0
  612. package/registry/verified-badge.json +1 -1
  613. package/registry/versus-card.json +1 -1
  614. package/registry/vertical-video.json +4 -4
  615. package/registry/video-player.json +7 -7
  616. package/registry/video-trimmer.json +8 -8
  617. package/registry/virtual.json +1 -1
  618. package/registry/wall.json +128 -40
  619. package/registry/waveform.json +1 -1
  620. package/skills/form/SKILL.md +1 -1
  621. package/skills/map/SKILL.md +2 -2
  622. package/dist/chunk-3RVFD3UX.js.map +0 -1
  623. package/dist/chunk-4E5IUZHR.js.map +0 -1
  624. package/dist/chunk-KB7OLYIJ.js.map +0 -1
  625. package/dist/chunk-MHUUNC5W.js.map +0 -1
  626. package/dist/chunk-MIMOTE4W.js.map +0 -1
  627. package/dist/chunk-RBETQO2P.js.map +0 -1
  628. package/dist/chunk-WOZP3JLW.js.map +0 -1
  629. package/dist/chunk-YKEIOYJ5.js.map +0 -1
  630. /package/dist/{chunk-5LANVCK7.js.map → chunk-BG5APGX6.js.map} +0 -0
  631. /package/dist/{chunk-6EAHUURY.js.map → chunk-GHAN7OOE.js.map} +0 -0
  632. /package/dist/{chunk-HEKDKM5Y.js.map → chunk-QVHSV6RA.js.map} +0 -0
  633. /package/dist/{chunk-7JG3VR4C.js.map → chunk-RCKXJEDQ.js.map} +0 -0
  634. /package/registry/examples/{app-shell/orochia-studio.d.ts → analysis-report/document-validation.d.ts} +0 -0
  635. /package/registry/examples/{iso/orochia-hero.d.ts → analysis-report/native/document-validation.d.ts} +0 -0
@@ -37,6 +37,9 @@
37
37
  "bestPractices": [
38
38
  "Import @krizaka/ui/blocks.css once. All four components are exported from @krizaka/ui/wall.",
39
39
  "Each example includes its own words, so copied snippets are self-contained. Choose the host locale and pass its words as data; the French composition demonstrates the same surface unchanged.",
40
+ "Wall draws at most `max` items (12 by default, the first in z order) in a fixed 16:9 box on a desktop; show the rest behind a « see the whole wall » of your own. Pass `height` only for a fixed pixel height. On a phone it stacks them in z order, straight.",
41
+ "`ShopSign` renders its text children as the heading (`as=\"h1\"` by default): the page's one h1 is the sign. On a Wall a sign is a paragraph unless you pass `as`. `variant=\"none\"` is the name alone on paper; the neon flickers once, the first time it is seen, and never loops.",
42
+ "`PinnedNote`: `hold` (tape or pin, through Stuck), `ink` (blue, margin, hue) and `lines` (a fixed box of N lines, default 4, read in full by assistive technology); `attachment` still works as an alias of `hold`.",
40
43
  "Provide stable ids, explicit x/y percentages, rotation in degrees and z for every item. Positions are clamped to 0–100; z sorts the real list stably, including keyboard and phone order.",
41
44
  "Use kind polaroid with img, kind note with text, or kind sign with logo. Items carry the same props as their standalone component; no editor or random placement is added.",
42
45
  "Use height and itemWidth for layout, not style: style is intentionally omitted from the public props so percentage placement and the mobile stack cannot be overwritten accidentally.",
@@ -74,7 +77,7 @@
74
77
  "props": [
75
78
  {
76
79
  "component": "PinnedNote",
77
- "description": "A short word on a cut-corner card.",
80
+ "description": "A short word on a cut-corner card, stuck into the notebook.",
78
81
  "props": [
79
82
  {
80
83
  "name": "text",
@@ -97,6 +100,27 @@
97
100
  "description": "The tape or pin's tilt in degrees; defaults to zero.",
98
101
  "required": false
99
102
  },
103
+ {
104
+ "name": "hold",
105
+ "type": "\"pin\" | \"tape\"",
106
+ "default": "tape",
107
+ "description": "How the note is held, through `Stuck`: a strip of tape or a pin. Takes over `attachment`.",
108
+ "required": false
109
+ },
110
+ {
111
+ "name": "ink",
112
+ "type": "\"blue\" | \"margin\" | \"hue\"",
113
+ "default": "blue",
114
+ "description": "The ink of the pen: blue ink, the margin's red, or the page's hue.",
115
+ "required": false
116
+ },
117
+ {
118
+ "name": "lines",
119
+ "type": "number",
120
+ "default": "4",
121
+ "description": "The lines of the text box, fixed so a late font never shifts the page (the text is read in full by assistive technology).",
122
+ "required": false
123
+ },
100
124
  {
101
125
  "name": "rotation",
102
126
  "type": "number",
@@ -163,20 +187,34 @@
163
187
  },
164
188
  {
165
189
  "component": "ShopSign",
166
- "description": "A shop's own mark, as a plate, a neon, or a painted sign.",
190
+ "description": "A shop's own mark, as a plate, a neon, a painted sign, or the name alone.",
167
191
  "props": [
168
192
  {
169
- "name": "logo",
193
+ "name": "animated",
194
+ "type": "boolean",
195
+ "default": "true",
196
+ "description": "Allow one soft neon flicker the first time the sign is seen; defaults to true, never loops, respects reduced motion.",
197
+ "required": false
198
+ },
199
+ {
200
+ "name": "as",
201
+ "type": "\"h1\" | \"h2\" | \"h3\" | \"p\"",
202
+ "default": "h1",
203
+ "description": "The element of the name: the page's `h1` by default, `h2`/`h3` for a second sign, `p` for none. A sign on a `Wall` is a `p` unless told otherwise.",
204
+ "required": false
205
+ },
206
+ {
207
+ "name": "children",
170
208
  "type": "ReactNode",
171
209
  "default": null,
172
- "description": "The owner's logo or wordmark. Name an SVG/image accessibly, or use readable text.",
173
- "required": true
210
+ "description": "The shop's name as live text, in the sign's lettering: the page's heading (`as`). Prefer it to an image of the name.",
211
+ "required": false
174
212
  },
175
213
  {
176
- "name": "animated",
177
- "type": "boolean",
178
- "default": "true",
179
- "description": "Allow a single soft neon flicker on mount; defaults to true and respects reduced motion.",
214
+ "name": "logo",
215
+ "type": "ReactNode",
216
+ "default": null,
217
+ "description": "The owner's logo or wordmark, optional beside the name. Name an SVG/image accessibly, or use readable text.",
180
218
  "required": false
181
219
  },
182
220
  {
@@ -188,9 +226,9 @@
188
226
  },
189
227
  {
190
228
  "name": "variant",
191
- "type": "\"enamel\" | \"neon\" | \"painted\"",
229
+ "type": "\"none\" | \"enamel\" | \"neon\" | \"painted\"",
192
230
  "default": "enamel",
193
- "description": "Enamel plate and screws, softly glowing neon, or a time-worn painted sign.",
231
+ "description": "Enamel plate and screws, softly glowing neon, a time-worn painted sign, or `none` (the name alone on paper).",
194
232
  "required": false
195
233
  }
196
234
  ]
@@ -209,8 +247,8 @@
209
247
  {
210
248
  "name": "height",
211
249
  "type": "number",
212
- "default": "560",
213
- "description": "Desktop surface height in pixels (minimum 320); defaults to 560. Phones grow with content.",
250
+ "default": null,
251
+ "description": "A fixed desktop surface height in pixels (minimum 320). Absent, the surface is a fixed 16:9 box. Phones grow with content.",
214
252
  "required": false
215
253
  },
216
254
  {
@@ -220,6 +258,13 @@
220
258
  "description": "Desktop object width in pixels (minimum 120); defaults to 240 and never exceeds the surface.",
221
259
  "required": false
222
260
  },
261
+ {
262
+ "name": "max",
263
+ "type": "number",
264
+ "default": "12",
265
+ "description": "Draws at most this many items (the first in z order); defaults to 12. The rest belongs to the host's « see the whole wall ».",
266
+ "required": false
267
+ },
223
268
  {
224
269
  "name": "texture",
225
270
  "type": "\"brick\" | \"zellige\" | \"ridge\" | \"plaster\"",
@@ -237,7 +282,7 @@
237
282
  "description": "A photograph, a signed word and an enamel sign, positioned from deterministic data.",
238
283
  "path": "examples/wall/composition.tsx",
239
284
  "module": "@krizaka/ui/registry/examples/wall/composition",
240
- "code": "import { Wall, type WallItem } from \"@krizaka/ui/wall\";\n\nconst m = {\n photoAlt: \"The mountain above our workshop\", caption: \"The view from here\",\n note: \"Made slowly. Shared gladly.\", signature: \"Sam\",\n sign: \"Neighbourhood workshop\", wallLabel: \"From our workshop\",\n};\nconst items: WallItem[] = [\n { id: \"photo\", kind: \"polaroid\", x: 8, y: 18, rotation: -4, z: 1,\n img: <svg role=\"img\" aria-label={m.photoAlt} viewBox=\"0 0 240 240\"><rect width=\"240\" height=\"240\" fill=\"var(--kz-accent-soft)\" /><path d=\"m0 240 100-190 55 110 35-45 50 125Z\" fill=\"var(--kz-accent)\" /></svg>,\n caption: m.caption, attachment: \"tape\", attachmentRotation: 6 },\n { id: \"word\", kind: \"note\", x: 52, y: 75, rotation: 3, z: 2, text: m.note, signature: m.signature, attachment: \"pin\" },\n { id: \"sign\", kind: \"sign\", x: 94, y: 22, rotation: -2, z: 3, logo: m.sign, variant: \"enamel\" },\n];\n\nexport default function CompositionExample() {\n return <Wall aria-label={m.wallLabel} texture=\"brick\" items={items} height={520} itemWidth={220} />;\n}\n"
285
+ "code": "import { Wall, type WallItem } from \"@krizaka/ui/wall\";\n\nconst m = {\n photoAlt: \"The mountain above our workshop\", caption: \"The view from here\",\n note: \"Made slowly. Shared gladly.\", signature: \"Sam\",\n sign: \"Neighbourhood workshop\", wallLabel: \"From our workshop\",\n};\nconst items: WallItem[] = [\n { id: \"photo\", kind: \"polaroid\", x: 8, y: 18, rotation: -4, z: 1,\n img: <svg role=\"img\" aria-label={m.photoAlt} viewBox=\"0 0 240 240\"><rect width=\"240\" height=\"240\" fill=\"var(--kz-accent-soft)\" /><path d=\"m0 240 100-190 55 110 35-45 50 125Z\" fill=\"var(--kz-accent)\" /></svg>,\n caption: m.caption, attachment: \"tape\", attachmentRotation: 6 },\n { id: \"word\", kind: \"note\", x: 52, y: 75, rotation: 3, z: 2, text: m.note, signature: m.signature, attachment: \"pin\" },\n { id: \"sign\", kind: \"sign\", x: 94, y: 22, rotation: -2, z: 3, logo: m.sign, variant: \"enamel\" },\n];\n\nexport default function CompositionExample() {\n return <Wall aria-label={m.wallLabel} texture=\"brick\" items={items} itemWidth={220} />;\n}\n"
241
286
  },
242
287
  {
243
288
  "name": "composition-fr",
@@ -245,7 +290,7 @@
245
290
  "description": "The same deterministic layout reads its French words and alternatives from the example's local catalogue.",
246
291
  "path": "examples/wall/composition-fr.tsx",
247
292
  "module": "@krizaka/ui/registry/examples/wall/composition-fr",
248
- "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function FrenchCompositionExample() {\n const m = {\n wallLabel: \"Dans notre atelier\", photoAlt: \"La montagne au-dessus de notre atelier\",\n caption: \"La vue d’ici\", note: \"Fait avec patience. Partagé avec plaisir.\",\n signature: \"Sam\", sign: \"Atelier du coin\",\n };\n return <div lang=\"fr\"><Wall aria-label={m.wallLabel} texture=\"brick\" height={520} itemWidth={220} items={[\n { kind: \"polaroid\", id: \"photo\", z: 1, x: 8, y: 18, rotation: -4, attachment: \"tape\", attachmentRotation: 6, caption: m.caption,\n img: <svg viewBox=\"0 0 240 240\" role=\"img\" aria-label={m.photoAlt}>\n <rect width=\"240\" height=\"240\" fill=\"var(--kz-accent-soft)\" />\n <path d=\"m0 240 100-190 55 110 35-45 50 125Z\" fill=\"var(--kz-accent)\" />\n </svg> },\n { kind: \"note\", id: \"word\", z: 2, x: 52, y: 75, rotation: 3, attachment: \"pin\", text: m.note, signature: m.signature },\n { kind: \"sign\", id: \"sign\", z: 3, x: 94, y: 22, rotation: -2, variant: \"enamel\", logo: m.sign },\n ]} /></div>;\n}\n"
293
+ "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function FrenchCompositionExample() {\n const m = {\n wallLabel: \"Dans notre atelier\", photoAlt: \"La montagne au-dessus de notre atelier\",\n caption: \"La vue d’ici\", note: \"Fait avec patience. Partagé avec plaisir.\",\n signature: \"Sam\", sign: \"Atelier du coin\",\n };\n return <div lang=\"fr\"><Wall aria-label={m.wallLabel} texture=\"brick\" itemWidth={220} items={[\n { kind: \"polaroid\", id: \"photo\", z: 1, x: 8, y: 18, rotation: -4, attachment: \"tape\", attachmentRotation: 6, caption: m.caption,\n img: <svg viewBox=\"0 0 240 240\" role=\"img\" aria-label={m.photoAlt}>\n <rect width=\"240\" height=\"240\" fill=\"var(--kz-accent-soft)\" />\n <path d=\"m0 240 100-190 55 110 35-45 50 125Z\" fill=\"var(--kz-accent)\" />\n </svg> },\n { kind: \"note\", id: \"word\", z: 2, x: 52, y: 75, rotation: 3, attachment: \"pin\", text: m.note, signature: m.signature },\n { kind: \"sign\", id: \"sign\", z: 3, x: 94, y: 22, rotation: -2, variant: \"enamel\", logo: m.sign },\n ]} /></div>;\n}\n"
249
294
  },
250
295
  {
251
296
  "name": "brick",
@@ -253,7 +298,7 @@
253
298
  "description": "Staggered masonry and mortar on a warm token-based surface.",
254
299
  "path": "examples/wall/brick.tsx",
255
300
  "module": "@krizaka/ui/registry/examples/wall/brick",
256
- "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function BrickExample() {\n const m = { brickLabel: \"Brick wall\", paintedSign: \"The neighbourhood\" };\n return <Wall aria-label={m.brickLabel} texture=\"brick\" items={[\n { id: \"sign\", kind: \"sign\", x: 50, y: 50, rotation: -2, z: 1, logo: m.paintedSign, variant: \"painted\" },\n ]} height={360} />;\n}\n"
301
+ "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function BrickExample() {\n const m = { brickLabel: \"Brick wall\", paintedSign: \"The neighbourhood\" };\n return <Wall aria-label={m.brickLabel} texture=\"brick\" items={[\n { id: \"sign\", kind: \"sign\", x: 50, y: 50, rotation: -2, z: 1, logo: m.paintedSign, variant: \"painted\" },\n ]} />;\n}\n"
257
302
  },
258
303
  {
259
304
  "name": "zellige",
@@ -261,7 +306,7 @@
261
306
  "description": "A repeating deterministic eight-point SVG star, without an image download.",
262
307
  "path": "examples/wall/zellige.tsx",
263
308
  "module": "@krizaka/ui/registry/examples/wall/zellige",
264
- "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function ZelligeExample() {\n const m = { zelligeLabel: \"Zellige wall\", sunnyNote: \"A little sunshine, all year.\", sunnySignature: \"Nour\" };\n return <Wall aria-label={m.zelligeLabel} texture=\"zellige\" items={[\n { id: \"note\", kind: \"note\", x: 50, y: 50, rotation: 3, z: 1, text: m.sunnyNote, signature: m.sunnySignature, attachment: \"pin\" },\n ]} height={360} />;\n}\n"
309
+ "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function ZelligeExample() {\n const m = { zelligeLabel: \"Zellige wall\", sunnyNote: \"A little sunshine, all year.\", sunnySignature: \"Nour\" };\n return <Wall aria-label={m.zelligeLabel} texture=\"zellige\" items={[\n { id: \"note\", kind: \"note\", x: 50, y: 50, rotation: 3, z: 1, text: m.sunnyNote, signature: m.sunnySignature, attachment: \"pin\" },\n ]} />;\n}\n"
265
310
  },
266
311
  {
267
312
  "name": "ridge",
@@ -269,7 +314,7 @@
269
314
  "description": "Three layered mountain silhouettes behind the owner's words.",
270
315
  "path": "examples/wall/ridge.tsx",
271
316
  "module": "@krizaka/ui/registry/examples/wall/ridge",
272
- "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function RidgeExample() {\n const m = { ridgeLabel: \"Mountain wall\", mountainNote: \"Back after a walk in the mountains.\", mountainSignature: \"Lou\" };\n return <Wall aria-label={m.ridgeLabel} texture=\"ridge\" items={[\n { id: \"note\", kind: \"note\", x: 50, y: 50, rotation: -3, z: -2, text: m.mountainNote, signature: m.mountainSignature },\n ]} height={360} />;\n}\n"
317
+ "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function RidgeExample() {\n const m = { ridgeLabel: \"Mountain wall\", mountainNote: \"Back after a walk in the mountains.\", mountainSignature: \"Lou\" };\n return <Wall aria-label={m.ridgeLabel} texture=\"ridge\" items={[\n { id: \"note\", kind: \"note\", x: 50, y: 50, rotation: -3, z: -2, text: m.mountainNote, signature: m.mountainSignature },\n ]} />;\n}\n"
273
318
  },
274
319
  {
275
320
  "name": "plaster",
@@ -277,7 +322,7 @@
277
322
  "description": "A quiet lightly textured wall when the content should speak first.",
278
323
  "path": "examples/wall/plaster.tsx",
279
324
  "module": "@krizaka/ui/registry/examples/wall/plaster",
280
- "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function PlasterExample() {\n const m = { plasterLabel: \"Plaster wall\", welcomeNote: \"Come as you are. There is always room.\", welcomeSignature: \"Alex\" };\n return <Wall aria-label={m.plasterLabel} texture=\"plaster\" items={[\n { id: \"note\", kind: \"note\", x: 50, y: 50, rotation: 2, z: 1, text: m.welcomeNote, signature: m.welcomeSignature },\n ]} height={360} />;\n}\n"
325
+ "code": "import { Wall } from \"@krizaka/ui/wall\";\n\nexport default function PlasterExample() {\n const m = { plasterLabel: \"Plaster wall\", welcomeNote: \"Come as you are. There is always room.\", welcomeSignature: \"Alex\" };\n return <Wall aria-label={m.plasterLabel} texture=\"plaster\" items={[\n { id: \"note\", kind: \"note\", x: 50, y: 50, rotation: 2, z: 1, text: m.welcomeNote, signature: m.welcomeSignature },\n ]} />;\n}\n"
281
326
  },
282
327
  {
283
328
  "name": "polaroid",
@@ -293,7 +338,7 @@
293
338
  "description": "Short signed words on cut-corner paper, held by a pin or tape.",
294
339
  "path": "examples/wall/pinned-note.tsx",
295
340
  "module": "@krizaka/ui/registry/examples/wall/pinned-note",
296
- "code": "import { PinnedNote } from \"@krizaka/ui/wall\";\n\nexport default function PinnedNoteExample() {\n const m = { patientNote: \"Good things take time.\", signature: \"Sam\", thanksNote: \"Thanks for stopping by. See you soon!\", sunnySignature: \"Nour\" };\n return <div className=\"grid gap-8 p-8 sm:grid-cols-2\">\n <PinnedNote text={m.patientNote} signature={m.signature} attachment=\"pin\" rotation={-2} />\n <PinnedNote text={m.thanksNote} signature={m.sunnySignature} attachment=\"tape\" attachmentRotation={-6} rotation={2} />\n </div>;\n}\n"
341
+ "code": "import { PinnedNote } from \"@krizaka/ui/wall\";\n\n// `hold` (tape or pin, through Stuck), `ink` (blue, margin, hue) and `lines`: a fixed box, so a late font moves nothing.\nexport default function PinnedNoteExample() {\n const m = { patientNote: \"Good things take time.\", signature: \"Sam\", thanksNote: \"Thanks for stopping by. See you soon!\", sunnySignature: \"Nour\" };\n return <div className=\"grid gap-8 p-8 sm:grid-cols-2\">\n <PinnedNote text={m.patientNote} signature={m.signature} hold=\"pin\" ink=\"margin\" rotation={-2} />\n <PinnedNote text={m.thanksNote} signature={m.sunnySignature} hold=\"tape\" ink=\"hue\" rotation={2} lines={3} />\n </div>;\n}\n"
297
342
  },
298
343
  {
299
344
  "name": "shop-sign",
@@ -301,7 +346,7 @@
301
346
  "description": "The owner's mark as enamel with screws, soft neon, or weathered painted lettering.",
302
347
  "path": "examples/wall/shop-sign.tsx",
303
348
  "module": "@krizaka/ui/registry/examples/wall/shop-sign",
304
- "code": "import { ShopSign } from \"@krizaka/ui/wall\";\n\nexport default function ShopSignExample() {\n const m = { sign: \"Neighbourhood workshop\", neonSign: \"Still open\", oldSign: \"Since forever\" };\n return <div className=\"grid gap-8 p-8\">\n <ShopSign logo={m.sign} variant=\"enamel\" rotation={-1} />\n <ShopSign logo={m.neonSign} variant=\"neon\" />\n <ShopSign logo={m.oldSign} variant=\"painted\" rotation={1} />\n </div>;\n}\n"
349
+ "code": "import { ShopSign } from \"@krizaka/ui/wall\";\n\n// The name is live text, the page's heading (`as`, `h1` by default): enamel, neon (one flicker, the first time it is seen),\n// painted, or `none` (the name alone on paper). A logo is optional beside it.\nexport default function ShopSignExample() {\n const m = { sign: \"Neighbourhood workshop\", neonSign: \"Still open\", oldSign: \"Since forever\", plain: \"Cèdre & Ciseaux\" };\n return <div className=\"grid gap-8 p-8\">\n <ShopSign as=\"h2\" variant=\"enamel\" rotation={-1}>{m.sign}</ShopSign>\n <ShopSign as=\"h2\" variant=\"neon\">{m.neonSign}</ShopSign>\n <ShopSign as=\"h2\" variant=\"painted\" rotation={1}>{m.oldSign}</ShopSign>\n <ShopSign as=\"h2\" variant=\"none\">{m.plain}</ShopSign>\n </div>;\n}\n"
305
350
  }
306
351
  ]
307
352
  },
@@ -309,7 +354,7 @@
309
354
  "files": [
310
355
  {
311
356
  "path": "meta.ts",
312
- "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which ui.krizaka.com (apps/site) renders as\n// ui.krizaka.com/components/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n | \"notification-preferences\"\n | \"quota-meter\"\n | \"status-chip\"\n | \"kind-config-editor\"\n | \"agenda\"\n | \"account-settings\"\n | \"drop-overlay\"\n | \"upload-queue\"\n | \"achievement\"\n | \"anatomy-plate\"\n | \"bird-plate\"\n | \"taped-photo\"\n | \"stuck\"\n | \"doodle\"\n | \"signature\"\n | \"grade-stamp\"\n | \"versus-card\"\n | \"speed-lines\"\n | \"site-cahier\"\n | \"text-style\"\n | \"flock\"\n | \"elephant\"\n | \"footnote\"\n | \"page-index\"\n | \"chapter\"\n | \"specimen-tag\"\n | \"action-bar\"\n | \"action-sheet\"\n | \"activity-feed\"\n | \"alert\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\n | \"audio-player\"\n | \"auth-layout\"\n | \"avatar\"\n | \"badge\"\n | \"button\"\n | \"captcha\"\n | \"card\"\n | \"card-grid\"\n | \"catalogue-page\"\n | \"changelog-page\"\n | \"chat\"\n | \"checkbox\"\n | \"chip\"\n | \"chip-link\"\n | \"chip-row\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"contact-page\"\n | \"continue-prompt\"\n | \"countdown\"\n | \"cover-hero\"\n | \"cta-panel\"\n | \"dashboard-layout\"\n | \"data-table\"\n | \"date-picker\"\n | \"decision-list\"\n | \"description-list\"\n | \"detail-layout\"\n | \"dialog\"\n | \"docs-article-page\"\n | \"docs-hub-page\"\n | \"docs-layout\"\n | \"docs-nav\"\n | \"document-viewer\"\n | \"dropdown-menu\"\n | \"empty-state\"\n | \"engine-flow\"\n | \"error-page\"\n | \"fab\"\n | \"field\"\n | \"file-upload\"\n | \"filter-bar\"\n | \"force-update-screen\"\n | \"form\"\n | \"gallery-page\"\n | \"genui\"\n | \"glossary\"\n | \"glossary-term\"\n | \"glow-card\"\n | \"goal-gauge\"\n | \"header\"\n | \"how-it-works-page\"\n | \"image-cropper\"\n | \"image-viewer\"\n | \"iso\"\n | \"kanban\"\n | \"kbd\"\n | \"kpi-explained\"\n | \"landing-page\"\n | \"landscape\"\n | \"legal-page\"\n | \"link-card\"\n | \"list\"\n | \"loader\"\n | \"longform-page\"\n | \"maintenance-screen\"\n | \"map\"\n | \"markdown\"\n | \"meta-row\"\n | \"waveform\"\n | \"marketing-layout\"\n | \"marquee\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\n | \"media-grid\"\n | \"language-switch\"\n | \"media-gallery\"\n | \"media-picker\"\n | \"meter\"\n | \"nav-bar\"\n | \"number-ticker\"\n | \"onboarding\"\n | \"opening-hours\"\n | \"otp-input\"\n | \"page\"\n | \"page-header\"\n | \"page-hero\"\n | \"pagination\"\n | \"permission-prompt\"\n | \"photo-grid\"\n | \"pointer-light\"\n | \"popover\"\n | \"pricing-page\"\n | \"product-page\"\n | \"profile-card\"\n | \"progress\"\n | \"promise-card\"\n | \"pull-to-refresh\"\n | \"retro-tv\"\n | \"radio-group\"\n | \"router\"\n | \"rail-nav\"\n | \"recipes\"\n | \"screen\"\n | \"scroll-stage\"\n | \"search-field\"\n | \"section-backdrop\"\n | \"segmented\"\n | \"separator\"\n | \"service-card\"\n | \"settings-layout\"\n | \"account-menu\"\n | \"showcase\"\n | \"step-showcase\"\n | \"site-footer\"\n | \"sites\"\n | \"skeleton\"\n | \"skip-link\"\n | \"slider\"\n | \"slot-picker\"\n | \"slot\"\n | \"spinner\"\n | \"sticky-action\"\n | \"splash-handoff\"\n | \"split-view\"\n | \"stage-banner\"\n | \"stat\"\n | \"status-page\"\n | \"step-progress\"\n | \"stepper\"\n | \"swipe-deck\"\n | \"swipeable-row\"\n | \"switch\"\n | \"tab-bar\"\n | \"tabs\"\n | \"tag-input\"\n | \"tag-selector\"\n | \"terminal-replay\"\n | \"theme\"\n | \"toast\"\n | \"toc\"\n | \"tooltip\"\n | \"tree-view\"\n | \"txt\"\n | \"update-prompt\"\n | \"verified-badge\"\n | \"vertical-video\"\n | \"video-player\"\n | \"video-trimmer\"\n | \"virtual\"\n | \"wall\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/**\n * Why a component is not on a platform — a decision, never a silence (the parity matrix of ui.krizaka.com/platforms):\n * - `gap` (✗): it belongs there and is not built yet; `issue` is the issue that tracks it (`krizaka/krizaka-ui#275`);\n * - `n/a`: it is not meant for that platform (a site's page block on a phone, a swipe on a desktop); `use` names the\n * component that answers there, when one does.\n */\nexport type Absence =\n | { readonly status: \"gap\"; readonly issue: string; readonly reason: string; readonly use?: undefined }\n | { readonly status: \"n/a\"; readonly reason: string; readonly use?: ComponentName; readonly issue?: undefined };\n\n/**\n * Desktop is the Orazaka Mac app (Tauri 2: the system WebView renders the web components — ADR-002). `web`: the web\n * component runs there as it is; `desktop`: it also has a desktop form (a window's title bar, a denser layout…), said in\n * its documentation; otherwise the absence and why.\n */\nexport type DesktopSupport = \"web\" | \"desktop\" | Absence;\n\n/**\n * The three platforms of Krizaka UI — web · native (React Native, Expo) · desktop — for one component. The side a\n * component has is `platforms`; the side it lacks says why here: `native` is required for (and only for) a web-only\n * component, `web` for a native-only one; `desktop` always. `scripts/registry.test.mjs` fails on a missing decision.\n */\nexport interface Parity {\n readonly web?: Absence;\n readonly native?: Absence;\n readonly desktop: DesktopSupport;\n}\n\n/**\n * `stable`: its API only changes in a major. `beta`: it may still change in a minor. `deprecated`: no product uses it and\n * no work plans to — it still works, says what replaces it, and goes in the major named by `deprecated.removedIn`.\n */\nexport type Status = \"stable\" | \"beta\" | \"deprecated\";\n\n/** What a deprecated component says (required when `status` is `deprecated`, absent otherwise). */\nexport interface Deprecation {\n /** The version that deprecated it (`3.6.0`). */\n readonly since: string;\n /** The major that removes it (`4.0.0`). */\n readonly removedIn: string;\n /** What replaces it, when a component does. */\n readonly use?: ComponentName;\n /** Why it goes: no product uses it, no planned work needs it. */\n readonly reason: string;\n}\n\n/**\n * The group of the catalogue. `media`: video, sound, camera, files, cropping. `blocks`: the page blocks — the frame,\n * the hero, sections, cards that lead or argue, decisions, code, calls to act — that every page of a site is made of.\n * `layouts`: the shells of whole screens — an application, a dashboard, settings, sign-in, an object, a list and its\n * item, a site's page, a documentation page — each with its screens. `templates`: the page templates — whole pages of a\n * site (a landing, a product, a docs hub, a long read, a changelog, pricing, status, an error…), each a distinct\n * composition of the blocks, words and content as props.\n */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"media\" | \"blocks\" | \"layouts\" | \"templates\" | \"layout\" | \"foundations\";\n\n/** Why a reader needs a template: the seven intents the templates are grouped by (sidebar sub-headings, catalogue filter). */\nexport type TemplatePurpose = \"convince\" | \"explain\" | \"show\" | \"act\" | \"operate\" | \"converse\" | \"recover\";\n\n/** The groups of templates, in reading order: the title, and the one line that says when to come to that group. */\nexport const templatePurposes = {\n convince: { title: \"Convince\", useWhen: \"You come here when a visitor must decide: a landing, a product, a price, a comparison, a proof.\" },\n explain: { title: \"Explain\", useWhen: \"You come here when a reader must understand: how it works, a documentation hub or article, a changelog, a FAQ, a policy.\" },\n show: { title: \"Show\", useWhen: \"You come here when the work itself is the argument: a gallery, a story, a case study, an object and its details.\" },\n act: { title: \"Act\", useWhen: \"You come here when a person must do something once: reach the team, sign in or up, set up, pay.\" },\n operate: { title: \"Operate\", useWhen: \"You come here when a person works every day: a dashboard, a console with a table, settings, an app shell.\" },\n converse: { title: \"Converse\", useWhen: \"You come here when people talk: an inbox, a chat, comments, a notifications centre.\" },\n recover: { title: \"Recover\", useWhen: \"You come here when the way is blocked: an empty list, an error, a missing page, maintenance, a product still being built.\" },\n} as const satisfies Record<TemplatePurpose, { readonly title: string; readonly useWhen: string }>;\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\ninterface ExampleBase {\n /** The file name, kebab-case (`primary`, `icon-button`). */\n readonly name: string;\n /** A short title (`Primary`, `Icon button`). */\n readonly title: string;\n /** One or two sentences: when this variant is the right one. */\n readonly description: string;\n}\n\n/** A plain example, or a template: a whole screen with its intent (`purpose`) and the user goal its layout serves (`why`). */\nexport type Example =\n | (ExampleBase & { readonly template?: false; readonly purpose?: undefined; readonly why?: undefined })\n | (ExampleBase & {\n /**\n * A template: a whole screen of a product composed from the platform (a layout and its blocks, real words, its\n * phone version thought out), copied as a starting point — at most 160 lines, listed on ui.krizaka.com/templates.\n */\n readonly template: true;\n /** The intent that groups it: why you need this block. */\n readonly purpose: TemplatePurpose;\n /** Why this layout: the user goal it serves, in one sentence. */\n readonly why: string;\n });\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n readonly imports: readonly string[];\n /** The examples, in reading order; the first one is the component's preview. */\n readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n /**\n * The entry to import from when it is not `@krizaka/ui/native`: a component that needs an Expo module (an optional\n * peer) has its own, `@krizaka/ui/native/<name>`, so an app that does not use it never installs the module.\n */\n readonly entry?: string;\n /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n readonly differences: readonly string[];\n /** The React Native entry alone is deprecated while the web one stays (ADR-006 §7); a deprecated component says it once, above. */\n readonly deprecated?: Deprecation;\n}\n\nexport interface KeyboardInteraction {\n /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n readonly keys: string;\n /** What they do. */\n readonly action: string;\n}\n\nexport interface ComponentMeta {\n /** The display name: `Button`, `Dropdown menu`. */\n readonly title: string;\n /** One sentence: what it is. */\n readonly summary: string;\n readonly status: Status;\n /** Required for, and only for, a `deprecated` component. */\n readonly deprecated?: Deprecation;\n readonly category: Category;\n /** Must match the sides below: `both` ⇔ `web` and `native`. */\n readonly platforms: Platform;\n /** The platforms it is not on, and why; and its desktop form (see `Parity`). */\n readonly parity: Parity;\n /** When to reach for it: concrete situations, one per item. */\n readonly whenToUse: readonly string[];\n /** When not to — and what to use instead (`use`), when another component is the answer. */\n readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n /** How to use it well: wording, placement, composition. */\n readonly bestPractices: readonly string[];\n readonly accessibility: {\n /** The keyboard, when it does more than Tab and Enter. */\n readonly keyboard: readonly KeyboardInteraction[];\n /** Roles, names and announcements: what the component does, what the app must provide. */\n readonly notes: readonly string[];\n };\n /** The components a reader of this page should know about. */\n readonly related: readonly ComponentName[];\n readonly web?: PlatformDocs;\n readonly native?: NativeDocs;\n}\n"
357
+ "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which ui.krizaka.com (apps/site) renders as\n// ui.krizaka.com/components/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n | \"notification-preferences\"\n | \"quota-meter\"\n | \"environment-notice\"\n | \"embed-facade\"\n | \"reviews\"\n | \"margin-layout\"\n | \"analysis-report\"\n | \"status-chip\"\n | \"kind-config-editor\"\n | \"agenda\"\n | \"account-settings\"\n | \"drop-overlay\"\n | \"upload-queue\"\n | \"achievement\"\n | \"anatomy-plate\"\n | \"bird-plate\"\n | \"taped-photo\"\n | \"stuck\"\n | \"doodle\"\n | \"signature\"\n | \"grade-stamp\"\n | \"versus-card\"\n | \"speed-lines\"\n | \"site-cahier\"\n | \"text-style\"\n | \"flock\"\n | \"elephant\"\n | \"footnote\"\n | \"page-index\"\n | \"chapter\"\n | \"specimen-tag\"\n | \"action-bar\"\n | \"action-sheet\"\n | \"activity-feed\"\n | \"alert\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\n | \"audio-player\"\n | \"auth-layout\"\n | \"avatar\"\n | \"badge\"\n | \"button\"\n | \"captcha\"\n | \"card\"\n | \"card-grid\"\n | \"catalogue-page\"\n | \"changelog-page\"\n | \"chat\"\n | \"checkbox\"\n | \"chip\"\n | \"chip-link\"\n | \"chip-row\"\n | \"choice-grid\"\n | \"cn\"\n | \"code-block\"\n | \"combobox\"\n | \"comparison-table\"\n | \"command\"\n | \"component-page\"\n | \"confirm-button\"\n | \"contact-page\"\n | \"continue-prompt\"\n | \"countdown\"\n | \"cover-hero\"\n | \"cta-panel\"\n | \"dashboard-layout\"\n | \"data-table\"\n | \"date-picker\"\n | \"decision-list\"\n | \"description-list\"\n | \"detail-layout\"\n | \"dialog\"\n | \"docs-article-page\"\n | \"docs-hub-page\"\n | \"docs-layout\"\n | \"docs-nav\"\n | \"document-viewer\"\n | \"dropdown-menu\"\n | \"empty-state\"\n | \"engine-flow\"\n | \"error-page\"\n | \"fab\"\n | \"field\"\n | \"file-upload\"\n | \"filter-bar\"\n | \"force-update-screen\"\n | \"form\"\n | \"gallery-page\"\n | \"genui\"\n | \"glossary\"\n | \"glossary-term\"\n | \"glow-card\"\n | \"goal-gauge\"\n | \"header\"\n | \"how-it-works-page\"\n | \"image-cropper\"\n | \"image-viewer\"\n | \"iso\"\n | \"kanban\"\n | \"kbd\"\n | \"kpi-explained\"\n | \"landing-page\"\n | \"landscape\"\n | \"legal-page\"\n | \"link-card\"\n | \"list\"\n | \"loader\"\n | \"longform-page\"\n | \"maintenance-screen\"\n | \"map\"\n | \"markdown\"\n | \"meta-row\"\n | \"waveform\"\n | \"marketing-layout\"\n | \"marquee\"\n | \"mascot-quote\"\n | \"mascot-state\"\n | \"mascots\"\n | \"match-dialog\"\n | \"media-capture\"\n | \"media-grid\"\n | \"language-switch\"\n | \"media-gallery\"\n | \"media-picker\"\n | \"meter\"\n | \"nav-bar\"\n | \"number-ticker\"\n | \"onboarding\"\n | \"opening-hours\"\n | \"otp-input\"\n | \"page\"\n | \"page-header\"\n | \"page-hero\"\n | \"pagination\"\n | \"permission-prompt\"\n | \"photo-grid\"\n | \"pointer-light\"\n | \"popover\"\n | \"pricing-page\"\n | \"product-page\"\n | \"profile-card\"\n | \"progress\"\n | \"promise-card\"\n | \"pull-to-refresh\"\n | \"retro-tv\"\n | \"radio-group\"\n | \"router\"\n | \"rail-nav\"\n | \"recipes\"\n | \"screen\"\n | \"scroll-stage\"\n | \"search-field\"\n | \"section-backdrop\"\n | \"segmented\"\n | \"separator\"\n | \"service-card\"\n | \"settings-layout\"\n | \"account-menu\"\n | \"showcase\"\n | \"step-showcase\"\n | \"site-footer\"\n | \"sites\"\n | \"skeleton\"\n | \"skip-link\"\n | \"slider\"\n | \"slot-picker\"\n | \"slot\"\n | \"spinner\"\n | \"sticky-action\"\n | \"splash-handoff\"\n | \"split-view\"\n | \"stage-banner\"\n | \"stat\"\n | \"usage\"\n | \"status-page\"\n | \"step-progress\"\n | \"stepper\"\n | \"swipe-deck\"\n | \"swipeable-row\"\n | \"switch\"\n | \"tab-bar\"\n | \"tabs\"\n | \"tag-input\"\n | \"tag-selector\"\n | \"terminal-replay\"\n | \"theme\"\n | \"toast\"\n | \"toc\"\n | \"tooltip\"\n | \"tree-view\"\n | \"txt\"\n | \"update-prompt\"\n | \"verified-badge\"\n | \"vertical-video\"\n | \"video-player\"\n | \"video-trimmer\"\n | \"virtual\"\n | \"wall\";\n\n/** Where a component exists: `@krizaka/ui/<name>` (web), `@krizaka/ui/native` (React Native), or both. */\nexport type Platform = \"web\" | \"native\" | \"both\";\n\n/**\n * Why a component is not on a platform — a decision, never a silence (the parity matrix of ui.krizaka.com/platforms):\n * - `gap` (✗): it belongs there and is not built yet; `issue` is the issue that tracks it (`krizaka/krizaka-ui#275`);\n * - `n/a`: it is not meant for that platform (a site's page block on a phone, a swipe on a desktop); `use` names the\n * component that answers there, when one does.\n */\nexport type Absence =\n | { readonly status: \"gap\"; readonly issue: string; readonly reason: string; readonly use?: undefined }\n | { readonly status: \"n/a\"; readonly reason: string; readonly use?: ComponentName; readonly issue?: undefined };\n\n/**\n * Desktop is the Orazaka Mac app (Tauri 2: the system WebView renders the web components — ADR-002). `web`: the web\n * component runs there as it is; `desktop`: it also has a desktop form (a window's title bar, a denser layout…), said in\n * its documentation; otherwise the absence and why.\n */\nexport type DesktopSupport = \"web\" | \"desktop\" | Absence;\n\n/**\n * The three platforms of Krizaka UI — web · native (React Native, Expo) · desktop — for one component. The side a\n * component has is `platforms`; the side it lacks says why here: `native` is required for (and only for) a web-only\n * component, `web` for a native-only one; `desktop` always. `scripts/registry.test.mjs` fails on a missing decision.\n */\nexport interface Parity {\n readonly web?: Absence;\n readonly native?: Absence;\n readonly desktop: DesktopSupport;\n}\n\n/**\n * `stable`: its API only changes in a major. `beta`: it may still change in a minor. `deprecated`: no product uses it and\n * no work plans to — it still works, says what replaces it, and goes in the major named by `deprecated.removedIn`.\n */\nexport type Status = \"stable\" | \"beta\" | \"deprecated\";\n\n/** What a deprecated component says (required when `status` is `deprecated`, absent otherwise). */\nexport interface Deprecation {\n /** The version that deprecated it (`3.6.0`). */\n readonly since: string;\n /** The major that removes it (`4.0.0`). */\n readonly removedIn: string;\n /** What replaces it, when a component does. */\n readonly use?: ComponentName;\n /** Why it goes: no product uses it, no planned work needs it. */\n readonly reason: string;\n}\n\n/**\n * The group of the catalogue. `media`: video, sound, camera, files, cropping. `blocks`: the page blocks — the frame,\n * the hero, sections, cards that lead or argue, decisions, code, calls to act — that every page of a site is made of.\n * `layouts`: the shells of whole screens — an application, a dashboard, settings, sign-in, an object, a list and its\n * item, a site's page, a documentation page — each with its screens. `templates`: the page templates — whole pages of a\n * site (a landing, a product, a docs hub, a long read, a changelog, pricing, status, an error…), each a distinct\n * composition of the blocks, words and content as props.\n */\nexport type Category = \"actions\" | \"forms\" | \"navigation\" | \"overlays\" | \"feedback\" | \"data-display\" | \"media\" | \"blocks\" | \"layouts\" | \"templates\" | \"layout\" | \"foundations\";\n\n/** Why a reader needs a template: the seven intents the templates are grouped by (sidebar sub-headings, catalogue filter). */\nexport type TemplatePurpose = \"convince\" | \"explain\" | \"show\" | \"act\" | \"operate\" | \"converse\" | \"recover\";\n\n/** The groups of templates, in reading order: the title, and the one line that says when to come to that group. */\nexport const templatePurposes = {\n convince: { title: \"Convince\", useWhen: \"You come here when a visitor must decide: a landing, a product, a price, a comparison, a proof.\" },\n explain: { title: \"Explain\", useWhen: \"You come here when a reader must understand: how it works, a documentation hub or article, a changelog, a FAQ, a policy.\" },\n show: { title: \"Show\", useWhen: \"You come here when the work itself is the argument: a gallery, a story, a case study, an object and its details.\" },\n act: { title: \"Act\", useWhen: \"You come here when a person must do something once: reach the team, sign in or up, set up, pay.\" },\n operate: { title: \"Operate\", useWhen: \"You come here when a person works every day: a dashboard, a console with a table, settings, an app shell.\" },\n converse: { title: \"Converse\", useWhen: \"You come here when people talk: an inbox, a chat, comments, a notifications centre.\" },\n recover: { title: \"Recover\", useWhen: \"You come here when the way is blocked: an empty list, an error, a missing page, maintenance, a product still being built.\" },\n} as const satisfies Record<TemplatePurpose, { readonly title: string; readonly useWhen: string }>;\n\n/**\n * A named example: the file `registry/examples/<component>/<name>.tsx` (web) or\n * `registry/examples/<component>/native/<name>.tsx` (React Native) — at most 40 lines, imported by the stories and\n * shown (live, with its code) by the documentation.\n */\ninterface ExampleBase {\n /** The file name, kebab-case (`primary`, `icon-button`). */\n readonly name: string;\n /** A short title (`Primary`, `Icon button`). */\n readonly title: string;\n /** One or two sentences: when this variant is the right one. */\n readonly description: string;\n}\n\n/** A plain example, or a template: a whole screen with its intent (`purpose`) and the user goal its layout serves (`why`). */\nexport type Example =\n | (ExampleBase & { readonly template?: false; readonly purpose?: undefined; readonly why?: undefined })\n | (ExampleBase & {\n /**\n * A template: a whole screen of a product composed from the platform (a layout and its blocks, real words, its\n * phone version thought out), copied as a starting point — at most 160 lines, listed on ui.krizaka.com/templates.\n */\n readonly template: true;\n /** The intent that groups it: why you need this block. */\n readonly purpose: TemplatePurpose;\n /** Why this layout: the user goal it serves, in one sentence. */\n readonly why: string;\n });\n\n/** One platform's side of a component. */\nexport interface PlatformDocs {\n /** The names to import (`[\"Button\", \"IconButton\"]`): from `@krizaka/ui/<name>` on the web, `@krizaka/ui/native` in React Native. */\n readonly imports: readonly string[];\n /** The examples, in reading order; the first one is the component's preview. */\n readonly examples: readonly Example[];\n}\n\n/** The React Native side: the same concept, and what differs from the web API. */\nexport interface NativeDocs extends PlatformDocs {\n /**\n * The entry to import from when it is not `@krizaka/ui/native`: a component that needs an Expo module (an optional\n * peer) has its own, `@krizaka/ui/native/<name>`, so an app that does not use it never installs the module.\n */\n readonly entry?: string;\n /** What differs from the web API (`label` instead of children…); empty for a native-only component. */\n readonly differences: readonly string[];\n /** The React Native entry alone is deprecated while the web one stays (ADR-006 §7); a deprecated component says it once, above. */\n readonly deprecated?: Deprecation;\n}\n\nexport interface KeyboardInteraction {\n /** The keys, as written on a keyboard: `Space`, `Enter`, `Arrow keys`, `Esc`, `Tab`. */\n readonly keys: string;\n /** What they do. */\n readonly action: string;\n}\n\nexport interface ComponentMeta {\n /** The display name: `Button`, `Dropdown menu`. */\n readonly title: string;\n /** One sentence: what it is. */\n readonly summary: string;\n readonly status: Status;\n /** Required for, and only for, a `deprecated` component. */\n readonly deprecated?: Deprecation;\n readonly category: Category;\n /** Must match the sides below: `both` ⇔ `web` and `native`. */\n readonly platforms: Platform;\n /** The platforms it is not on, and why; and its desktop form (see `Parity`). */\n readonly parity: Parity;\n /** When to reach for it: concrete situations, one per item. */\n readonly whenToUse: readonly string[];\n /** When not to — and what to use instead (`use`), when another component is the answer. */\n readonly whenNotToUse: readonly { readonly when: string; readonly use?: ComponentName }[];\n /** How to use it well: wording, placement, composition. */\n readonly bestPractices: readonly string[];\n readonly accessibility: {\n /** The keyboard, when it does more than Tab and Enter. */\n readonly keyboard: readonly KeyboardInteraction[];\n /** Roles, names and announcements: what the component does, what the app must provide. */\n readonly notes: readonly string[];\n };\n /** The components a reader of this page should know about. */\n readonly related: readonly ComponentName[];\n readonly web?: PlatformDocs;\n readonly native?: NativeDocs;\n}\n"
313
358
  },
314
359
  {
315
360
  "path": "wall/attachment.tsx",
@@ -321,11 +366,11 @@
321
366
  },
322
367
  {
323
368
  "path": "wall/meta.ts",
324
- "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Wall\",\n summary: \"A read-only wall of photos, short notes and the owner's sign: Montréal brick, Moroccan eight-point zellige, Grenoble ridgelines or warm plaster, over a real keyboard-reachable list.\",\n status: \"beta\",\n category: \"blocks\",\n platforms: \"web\",\n parity: { native: { status: \"n/a\", reason: \"An ornamental storefront surface belongs to web pages; native content should stay in a scrolling gallery.\", use: \"media-grid\" }, desktop: \"web\" },\n whenToUse: [\"A shop or community page whose owner's photos, words and identity should feel personally pinned up.\"],\n whenNotToUse: [\n { when: \"A searchable or large image collection.\", use: \"photo-grid\" },\n { when: \"Rows of data to compare or sort.\", use: \"data-table\" },\n ],\n bestPractices: [\n \"Import @krizaka/ui/blocks.css once. All four components are exported from @krizaka/ui/wall.\",\n \"Each example includes its own words, so copied snippets are self-contained. Choose the host locale and pass its words as data; the French composition demonstrates the same surface unchanged.\",\n \"Provide stable ids, explicit x/y percentages, rotation in degrees and z for every item. Positions are clamped to 0–100; z sorts the real list stably, including keyboard and phone order.\",\n \"Use kind polaroid with img, kind note with text, or kind sign with logo. Items carry the same props as their standalone component; no editor or random placement is added.\",\n \"Use height and itemWidth for layout, not style: style is intentionally omitted from the public props so percentage placement and the mobile stack cannot be overwritten accidentally.\",\n \"Keep the wall sparse and tilts small. On screens narrower than 48rem it grows into an untilted single column in z order, without overlap.\",\n \"The img ReactNode accepts next/image, including fill: the square photo frame is positioned. Supply an informative alt, or an empty alt for decoration.\",\n \"Captions and signatures use the existing --kz-font-cahier handwriting role (Krizaka Cahier from @krizaka/fonts); load the font in the host.\",\n \"PinnedNote caps text at 140 Unicode code points. Keep the full message elsewhere when more detail matters.\",\n \"Set attachment and attachmentRotation for tape or a pin, rotation for the object; neon's animated=false and Polaroid's develop=false opt out of motion.\",\n \"Wall textures adapt to dark, light and brand themes. Polaroid composes TapedPhoto: its --kz-print paper stays pale in both themes, with --kz-print-ink captions and --kz-tape strips instead of a second print material.\",\n ],\n accessibility: {\n keyboard: [{ keys: \"Tab / Shift+Tab\", action: \"Visit each object in ascending z order, preserving input order for ties.\" }],\n notes: [\n \"Wall is a real ul with an explicit list role, preserving Safari semantics despite list-style:none, and focusable li objects; give it an aria-label describing the collection. Textures, tape, pins and screws are hidden from assistive technology.\",\n \"Every word and all photo/logo alternatives come from the host. Standalone objects keep their natural figure/article/div semantics; Wall supplies their focus target.\",\n \"Polaroid only develops after its first observed intersection. With reduced motion, without an observer, or before hydration the photo remains sharp; preference changes stop motion immediately.\",\n \"Neon only flickers softly once, never flashes or loops. All effects stop under prefers-reduced-motion; reading and focus order never depend on visual positions.\",\n ],\n },\n related: [\"taped-photo\", \"cover-hero\", \"media-gallery\", \"photo-grid\", \"profile-card\"],\n web: {\n imports: [\"Wall\", \"Polaroid\", \"PinnedNote\", \"ShopSign\"],\n examples: [\n { name: \"composition\", title: \"The owner's wall\", description: \"A photograph, a signed word and an enamel sign, positioned from deterministic data.\" },\n { name: \"composition-fr\", title: \"The owner's wall in French\", description: \"The same deterministic layout reads its French words and alternatives from the example's local catalogue.\" },\n { name: \"brick\", title: \"Montréal brick\", description: \"Staggered masonry and mortar on a warm token-based surface.\" },\n { name: \"zellige\", title: \"Moroccan zellige\", description: \"A repeating deterministic eight-point SVG star, without an image download.\" },\n { name: \"ridge\", title: \"Grenoble ridges\", description: \"Three layered mountain silhouettes behind the owner's words.\" },\n { name: \"plaster\", title: \"Warm plaster\", description: \"A quiet lightly textured wall when the content should speak first.\" },\n { name: \"polaroid\", title: \"Polaroids\", description: \"A photo slot, handwritten caption, deterministic tilt, and tape or pin.\" },\n { name: \"pinned-note\", title: \"Pinned notes\", description: \"Short signed words on cut-corner paper, held by a pin or tape.\" },\n { name: \"shop-sign\", title: \"Shop signs\", description: \"The owner's mark as enamel with screws, soft neon, or weathered painted lettering.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
369
+ "content": "import type { ComponentMeta } from \"../meta\";\n\nexport const meta = {\n title: \"Wall\",\n summary: \"A read-only wall of photos, short notes and the owner's sign: Montréal brick, Moroccan eight-point zellige, Grenoble ridgelines or warm plaster, over a real keyboard-reachable list.\",\n status: \"beta\",\n category: \"blocks\",\n platforms: \"web\",\n parity: { native: { status: \"n/a\", reason: \"An ornamental storefront surface belongs to web pages; native content should stay in a scrolling gallery.\", use: \"media-grid\" }, desktop: \"web\" },\n whenToUse: [\"A shop or community page whose owner's photos, words and identity should feel personally pinned up.\"],\n whenNotToUse: [\n { when: \"A searchable or large image collection.\", use: \"photo-grid\" },\n { when: \"Rows of data to compare or sort.\", use: \"data-table\" },\n ],\n bestPractices: [\n \"Import @krizaka/ui/blocks.css once. All four components are exported from @krizaka/ui/wall.\",\n \"Each example includes its own words, so copied snippets are self-contained. Choose the host locale and pass its words as data; the French composition demonstrates the same surface unchanged.\",\n \"Wall draws at most `max` items (12 by default, the first in z order) in a fixed 16:9 box on a desktop; show the rest behind a « see the whole wall » of your own. Pass `height` only for a fixed pixel height. On a phone it stacks them in z order, straight.\",\n \"`ShopSign` renders its text children as the heading (`as=\\\"h1\\\"` by default): the page's one h1 is the sign. On a Wall a sign is a paragraph unless you pass `as`. `variant=\\\"none\\\"` is the name alone on paper; the neon flickers once, the first time it is seen, and never loops.\",\n \"`PinnedNote`: `hold` (tape or pin, through Stuck), `ink` (blue, margin, hue) and `lines` (a fixed box of N lines, default 4, read in full by assistive technology); `attachment` still works as an alias of `hold`.\",\n \"Provide stable ids, explicit x/y percentages, rotation in degrees and z for every item. Positions are clamped to 0–100; z sorts the real list stably, including keyboard and phone order.\",\n \"Use kind polaroid with img, kind note with text, or kind sign with logo. Items carry the same props as their standalone component; no editor or random placement is added.\",\n \"Use height and itemWidth for layout, not style: style is intentionally omitted from the public props so percentage placement and the mobile stack cannot be overwritten accidentally.\",\n \"Keep the wall sparse and tilts small. On screens narrower than 48rem it grows into an untilted single column in z order, without overlap.\",\n \"The img ReactNode accepts next/image, including fill: the square photo frame is positioned. Supply an informative alt, or an empty alt for decoration.\",\n \"Captions and signatures use the existing --kz-font-cahier handwriting role (Krizaka Cahier from @krizaka/fonts); load the font in the host.\",\n \"PinnedNote caps text at 140 Unicode code points. Keep the full message elsewhere when more detail matters.\",\n \"Set attachment and attachmentRotation for tape or a pin, rotation for the object; neon's animated=false and Polaroid's develop=false opt out of motion.\",\n \"Wall textures adapt to dark, light and brand themes. Polaroid composes TapedPhoto: its --kz-print paper stays pale in both themes, with --kz-print-ink captions and --kz-tape strips instead of a second print material.\",\n ],\n accessibility: {\n keyboard: [{ keys: \"Tab / Shift+Tab\", action: \"Visit each object in ascending z order, preserving input order for ties.\" }],\n notes: [\n \"Wall is a real ul with an explicit list role, preserving Safari semantics despite list-style:none, and focusable li objects; give it an aria-label describing the collection. Textures, tape, pins and screws are hidden from assistive technology.\",\n \"Every word and all photo/logo alternatives come from the host. Standalone objects keep their natural figure/article/div semantics; Wall supplies their focus target.\",\n \"Polaroid only develops after its first observed intersection. With reduced motion, without an observer, or before hydration the photo remains sharp; preference changes stop motion immediately.\",\n \"Neon only flickers softly once, never flashes or loops. All effects stop under prefers-reduced-motion; reading and focus order never depend on visual positions.\",\n ],\n },\n related: [\"taped-photo\", \"cover-hero\", \"media-gallery\", \"photo-grid\", \"profile-card\"],\n web: {\n imports: [\"Wall\", \"Polaroid\", \"PinnedNote\", \"ShopSign\"],\n examples: [\n { name: \"composition\", title: \"The owner's wall\", description: \"A photograph, a signed word and an enamel sign, positioned from deterministic data.\" },\n { name: \"composition-fr\", title: \"The owner's wall in French\", description: \"The same deterministic layout reads its French words and alternatives from the example's local catalogue.\" },\n { name: \"brick\", title: \"Montréal brick\", description: \"Staggered masonry and mortar on a warm token-based surface.\" },\n { name: \"zellige\", title: \"Moroccan zellige\", description: \"A repeating deterministic eight-point SVG star, without an image download.\" },\n { name: \"ridge\", title: \"Grenoble ridges\", description: \"Three layered mountain silhouettes behind the owner's words.\" },\n { name: \"plaster\", title: \"Warm plaster\", description: \"A quiet lightly textured wall when the content should speak first.\" },\n { name: \"polaroid\", title: \"Polaroids\", description: \"A photo slot, handwritten caption, deterministic tilt, and tape or pin.\" },\n { name: \"pinned-note\", title: \"Pinned notes\", description: \"Short signed words on cut-corner paper, held by a pin or tape.\" },\n { name: \"shop-sign\", title: \"Shop signs\", description: \"The owner's mark as enamel with screws, soft neon, or weathered painted lettering.\" },\n ],\n },\n} satisfies ComponentMeta;\n"
325
370
  },
326
371
  {
327
372
  "path": "wall/pinned-note.tsx",
328
- "content": "import type * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { Attachment, rotationStyle, type WallObjectProps } from \"./attachment\";\n\nexport interface PinnedNoteProps extends Omit<React.ComponentProps<\"article\">, \"children\" | \"style\">, WallObjectProps {\n /** The short message; capped at 140 Unicode code points without an ellipsis. */\n text: string;\n /** The optional author's signature, written in the handwriting role. */\n signature?: string;\n}\n\n/** A short word on a cut-corner card. */\nexport function PinnedNote({ text, signature, rotation = 0, attachment, attachmentRotation, className, ...props }: PinnedNoteProps) {\n return (\n <article {...props} className={cn(\"kz-pinned-note kz-wall-object\", className)} style={rotationStyle(rotation)} data-shape=\"cut\">\n <Attachment attachment={attachment} attachmentRotation={attachmentRotation} />\n <div className=\"kz-pinned-note-paper\">\n <p className=\"kz-pinned-note-text\">{Array.from(text).slice(0, 140).join(\"\")}</p>\n {signature && <p className=\"kz-pinned-note-signature\">{signature}</p>}\n </div>\n </article>\n );\n}\n"
373
+ "content": "import type * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { Stuck } from \"../stuck\";\nimport type { WallObjectProps } from \"./attachment\";\n\nexport interface PinnedNoteProps extends Omit<React.ComponentProps<\"article\">, \"children\" | \"style\">, WallObjectProps {\n /** The short message; capped at 140 Unicode code points without an ellipsis. */\n text: string;\n /** The optional author's signature, written in the handwriting role. */\n signature?: string;\n /** The ink of the pen: blue ink, the margin's red, or the page's hue. @default \"blue\" */\n ink?: \"blue\" | \"margin\" | \"hue\";\n /** How the note is held, through `Stuck`: a strip of tape or a pin. Takes over `attachment`. @default \"tape\" */\n hold?: \"tape\" | \"pin\";\n /** The lines of the text box, fixed so a late font never shifts the page (the text is read in full by assistive technology). @default 4 */\n lines?: number;\n}\n\n/** A short word on a cut-corner card, stuck into the notebook. */\nexport function PinnedNote({ text, signature, rotation = 0, attachment, attachmentRotation: _attachmentRotation, ink = \"blue\", hold, lines = 4, className, ...props }: PinnedNoteProps) {\n const rows = Math.max(1, Math.round(Number.isFinite(lines) ? lines : 4));\n return (\n <Stuck hold={hold ?? attachment ?? \"tape\"} tilt={Number.isFinite(rotation) ? rotation : 0} className=\"kz-wall-object kz-pinned-stuck\">\n <article {...props} className={cn(\"kz-pinned-note\", className)} data-shape=\"cut\" data-ink={ink} style={{ \"--kz-note-lines\": rows } as React.CSSProperties}>\n <div className=\"kz-pinned-note-paper\">\n <p className=\"kz-pinned-note-text\">{Array.from(text).slice(0, 140).join(\"\")}</p>\n {signature && <p className=\"kz-pinned-note-signature\">{signature}</p>}\n </div>\n </article>\n </Stuck>\n );\n}\n"
329
374
  },
330
375
  {
331
376
  "path": "wall/polaroid.tsx",
@@ -333,26 +378,27 @@
333
378
  },
334
379
  {
335
380
  "path": "wall/shop-sign.tsx",
336
- "content": "import type * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { rotationStyle } from \"./attachment\";\n\nexport interface ShopSignProps extends Omit<React.ComponentProps<\"div\">, \"children\" | \"style\"> {\n /** The owner's logo or wordmark. Name an SVG/image accessibly, or use readable text. */\n logo: React.ReactNode;\n /** Enamel plate and screws, softly glowing neon, or a time-worn painted sign. */\n variant?: \"enamel\" | \"neon\" | \"painted\";\n /** Deterministic tilt in degrees; defaults to zero. */\n rotation?: number;\n /** Allow a single soft neon flicker on mount; defaults to true and respects reduced motion. */\n animated?: boolean;\n}\n\n/** A shop's own mark, as a plate, a neon, or a painted sign. */\nexport function ShopSign({ logo, variant = \"enamel\", rotation = 0, animated = true, className, ...props }: ShopSignProps) {\n return (\n <div {...props} className={cn(\"kz-shop-sign kz-wall-object\", className)} style={rotationStyle(rotation)} data-variant={variant} data-animated={animated ? \"\" : undefined}>\n {variant === \"enamel\" && [0, 1, 2, 3].map((corner) => <span key={corner} aria-hidden=\"true\" className=\"kz-shop-sign-screw\" data-corner={corner} />)}\n <div className=\"kz-shop-sign-logo\">{logo}</div>\n </div>\n );\n}\n"
381
+ "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { rotationStyle } from \"./attachment\";\n\nexport interface ShopSignProps extends Omit<React.ComponentProps<\"div\">, \"style\"> {\n /** The shop's name as live text, in the sign's lettering: the page's heading (`as`). Prefer it to an image of the name. */\n children?: React.ReactNode;\n /** The element of the name: the page's `h1` by default, `h2`/`h3` for a second sign, `p` for none. A sign on a `Wall` is a `p` unless told otherwise. */\n as?: \"h1\" | \"h2\" | \"h3\" | \"p\";\n /** The owner's logo or wordmark, optional beside the name. Name an SVG/image accessibly, or use readable text. */\n logo?: React.ReactNode;\n /** Enamel plate and screws, softly glowing neon, a time-worn painted sign, or `none` (the name alone on paper). */\n variant?: \"enamel\" | \"neon\" | \"painted\" | \"none\";\n /** Deterministic tilt in degrees; defaults to zero. */\n rotation?: number;\n /** Allow one soft neon flicker the first time the sign is seen; defaults to true, never loops, respects reduced motion. */\n animated?: boolean;\n}\n\n/** The neon's first view: `waiting` until it is on screen, then `ready` once. Nothing under reduced motion or without observers. */\nfunction useFirstView(enabled: boolean) {\n const ref = React.useRef<HTMLDivElement>(null);\n const [state, setState] = React.useState<\"waiting\" | \"ready\" | undefined>();\n React.useEffect(() => {\n if (!enabled || !ref.current || typeof IntersectionObserver === \"undefined\" || typeof matchMedia === \"undefined\") return;\n const preference = matchMedia(\"(prefers-reduced-motion: reduce)\");\n let seen = false;\n let observer: IntersectionObserver | undefined;\n const sync = () => {\n observer?.disconnect();\n if (preference.matches) {\n setState(undefined);\n } else if (!seen) {\n setState(\"waiting\");\n observer = new IntersectionObserver((entries) => {\n if (seen || !entries.some((entry) => entry.isIntersecting)) return;\n seen = true;\n setState(\"ready\");\n observer?.disconnect();\n }, { threshold: 0.3 });\n observer.observe(ref.current!);\n }\n };\n sync();\n preference.addEventListener(\"change\", sync);\n return () => { observer?.disconnect(); preference.removeEventListener(\"change\", sync); };\n }, [enabled]);\n return [ref, state] as const;\n}\n\n/** A shop's own mark, as a plate, a neon, a painted sign, or the name alone. */\nexport function ShopSign({ children, as: Name = \"h1\", logo, variant = \"enamel\", rotation = 0, animated = true, className, ...props }: ShopSignProps) {\n const [ref, lit] = useFirstView(variant === \"neon\" && animated);\n return (\n <div {...props} ref={ref} className={cn(\"kz-shop-sign kz-wall-object\", className)} style={rotationStyle(rotation)} data-variant={variant} data-animated={animated ? \"\" : undefined} data-lit={lit}>\n {variant === \"enamel\" && [0, 1, 2, 3].map((corner) => <span key={corner} aria-hidden=\"true\" className=\"kz-shop-sign-screw\" data-corner={corner} />)}\n {logo && <div className=\"kz-shop-sign-logo\">{logo}</div>}\n {children && <Name className=\"kz-shop-sign-name\">{children}</Name>}\n </div>\n );\n}\n"
337
382
  },
338
383
  {
339
384
  "path": "wall/wall.tsx",
340
- "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { finite } from \"./attachment\";\nimport { PinnedNote, type PinnedNoteProps } from \"./pinned-note\";\nimport { Polaroid, type PolaroidProps } from \"./polaroid\";\nimport { ShopSign, type ShopSignProps } from \"./shop-sign\";\n\nexport interface WallPosition {\n /** Stable identity for this object. */\n id: string;\n /** Horizontal placement as a percentage (0–100); clamped to the wall. */\n x: number;\n /** Vertical placement as a percentage (0–100); clamped to the wall. */\n y: number;\n /** Tilt in degrees; defaults to zero. */\n rotation?: number;\n /** Stacking and reading order, ascending; ties preserve input order. */\n z: number;\n}\n\n/** The item's kind chooses its component; its remaining fields are that component's props. */\nexport type WallItem = WallPosition & (\n | ({ /** A framed photo. */ kind: \"polaroid\" } & PolaroidProps)\n | ({ /** A short pinned message. */ kind: \"note\" } & PinnedNoteProps)\n | ({ /** The owner's sign. */ kind: \"sign\" } & ShopSignProps)\n);\n\nexport interface WallProps extends Omit<React.ComponentProps<\"ul\">, \"children\" | \"style\" | \"role\"> {\n /** The read-only objects; never mutated. Sorted by z for reading, keyboard and phone order. */\n items: readonly WallItem[];\n /** CSS/SVG texture; no image download. Defaults to plaster. */\n texture?: \"brick\" | \"zellige\" | \"ridge\" | \"plaster\";\n /** Desktop surface height in pixels (minimum 320); defaults to 560. Phones grow with content. */\n height?: number;\n /** Desktop object width in pixels (minimum 120); defaults to 240 and never exceeds the surface. */\n itemWidth?: number;\n}\n\n/** A decorative textured surface over a real keyboard-reachable list; never an editor. */\nexport function Wall({ items, texture = \"plaster\", height = 560, itemWidth = 240, className, ...props }: WallProps) {\n const patternId = React.useId().replace(/:/g, \"\");\n return (\n <ul {...props} role=\"list\" className={cn(\"kz-wall\", className)} data-texture={texture} style={{ \"--kz-wall-height\": `${Math.max(320, finite(height))}px`, \"--kz-wall-item-width\": `${Math.max(120, finite(itemWidth))}px` } as React.CSSProperties}>\n {[...items].sort((a, b) => finite(a.z) - finite(b.z)).map(({ id, x, y, rotation = 0, z: _z, ...item }, rank) => (\n <li key={id} className=\"kz-wall-item\" tabIndex={0} style={{\n \"--kz-wall-x\": `${Math.min(100, Math.max(0, finite(x)))}%`,\n \"--kz-wall-y\": `${Math.min(100, Math.max(0, finite(y)))}%`,\n \"--kz-wall-rotation\": `${finite(rotation)}deg`,\n zIndex: rank,\n } as React.CSSProperties}>\n {item.kind === \"polaroid\" ? <Polaroid {...item} rotation={0} /> : item.kind === \"note\" ? <PinnedNote {...item} rotation={0} /> : <ShopSign {...item} rotation={0} />}\n </li>\n ))}\n {texture === \"brick\" && <li className=\"kz-wall-decoration\" aria-hidden=\"true\" role=\"presentation\"><svg width=\"100%\" height=\"100%\" aria-hidden=\"true\">\n <defs><pattern id={patternId} width=\"96\" height=\"48\" patternUnits=\"userSpaceOnUse\">\n <path d=\"M0 0H96M0 24H96M0 48H96M48 0V24M0 24V48M96 24V48\" fill=\"none\" stroke=\"var(--kz-border-default)\" strokeWidth=\"2\" />\n </pattern></defs><rect width=\"100%\" height=\"100%\" fill={`url(#${patternId})`} />\n </svg></li>}\n {texture === \"zellige\" && <li className=\"kz-wall-decoration\" aria-hidden=\"true\" role=\"presentation\"><svg width=\"100%\" height=\"100%\" aria-hidden=\"true\">\n <defs><pattern id={patternId} width=\"64\" height=\"64\" patternUnits=\"userSpaceOnUse\">\n <path d=\"M32 3 39 15 52 12 49 25 61 32 49 39 52 52 39 49 32 61 25 49 12 52 15 39 3 32 15 25 12 12 25 15Z\" fill=\"var(--kz-accent-soft)\" stroke=\"var(--kz-border-default)\" />\n <path d=\"m32 18 14 14-14 14-14-14Z\" fill=\"var(--kz-surface-2)\" stroke=\"var(--kz-accent-2)\" />\n </pattern></defs><rect width=\"100%\" height=\"100%\" fill={`url(#${patternId})`} />\n </svg></li>}\n {texture === \"ridge\" && <li className=\"kz-wall-decoration\" aria-hidden=\"true\" role=\"presentation\"><svg viewBox=\"0 0 1000 600\" preserveAspectRatio=\"none\" width=\"100%\" height=\"100%\" aria-hidden=\"true\">\n <path d=\"M0 380 170 100 290 300 450 70 620 330 790 120 1000 350V600H0Z\" fill=\"var(--kz-accent-soft)\" />\n <path d=\"M0 470 200 280 370 440 600 190 760 400 920 260 1000 390V600H0Z\" fill=\"var(--kz-surface-2)\" />\n <path d=\"M0 540 180 430 360 520 540 390 760 520 900 410 1000 480V600H0Z\" fill=\"var(--kz-surface-3)\" />\n </svg></li>}\n </ul>\n );\n}\n"
385
+ "content": "\"use client\";\n\nimport * as React from \"react\";\n\nimport { cn } from \"../cn\";\nimport { finite } from \"./attachment\";\nimport { PinnedNote, type PinnedNoteProps } from \"./pinned-note\";\nimport { Polaroid, type PolaroidProps } from \"./polaroid\";\nimport { ShopSign, type ShopSignProps } from \"./shop-sign\";\n\nexport interface WallPosition {\n /** Stable identity for this object. */\n id: string;\n /** Horizontal placement as a percentage (0–100); clamped to the wall. */\n x: number;\n /** Vertical placement as a percentage (0–100); clamped to the wall. */\n y: number;\n /** Tilt in degrees; defaults to zero. */\n rotation?: number;\n /** Stacking and reading order, ascending; ties preserve input order. */\n z: number;\n}\n\n/** The item's kind chooses its component; its remaining fields are that component's props. */\nexport type WallItem = WallPosition & (\n | ({ /** A framed photo. */ kind: \"polaroid\" } & PolaroidProps)\n | ({ /** A short pinned message. */ kind: \"note\" } & PinnedNoteProps)\n | ({ /** The owner's sign. */ kind: \"sign\" } & ShopSignProps)\n);\n\ntype DistributiveOmit<T, K extends PropertyKey> = T extends unknown ? Omit<T, K> : never;\n\nexport interface WallProps extends Omit<React.ComponentProps<\"ul\">, \"children\" | \"style\" | \"role\"> {\n /** The read-only objects; never mutated. Sorted by z for reading, keyboard and phone order. */\n items: readonly WallItem[];\n /** CSS/SVG texture; no image download. Defaults to plaster. */\n texture?: \"brick\" | \"zellige\" | \"ridge\" | \"plaster\";\n /** Draws at most this many items (the first in z order); defaults to 12. The rest belongs to the host's « see the whole wall ». */\n max?: number;\n /** A fixed desktop surface height in pixels (minimum 320). Absent, the surface is a fixed 16:9 box. Phones grow with content. */\n height?: number;\n /** Desktop object width in pixels (minimum 120); defaults to 240 and never exceeds the surface. */\n itemWidth?: number;\n}\n\n/** The object of one item, straight: the wall places and tilts it. A sign on a wall is a paragraph, not a second h1. */\nfunction WallObject({ item }: { readonly item: DistributiveOmit<WallItem, keyof WallPosition> }) {\n if (item.kind === \"polaroid\") return <Polaroid {...item} rotation={0} />;\n if (item.kind === \"note\") return <PinnedNote {...item} rotation={0} />;\n return <ShopSign {...item} as={item.as ?? \"p\"} rotation={0} />;\n}\n\n/** A decorative textured surface over a real keyboard-reachable list; never an editor. */\nexport function Wall({ items, texture = \"plaster\", max = 12, height, itemWidth = 240, className, ...props }: WallProps) {\n const patternId = React.useId().replace(/:/g, \"\");\n const drawn = Math.max(0, Math.floor(finite(max)));\n return (\n <ul {...props} role=\"list\" className={cn(\"kz-wall\", className)} data-texture={texture} data-count={Math.min(items.length, drawn)} data-fixed-height={height === undefined ? undefined : \"\"} style={{ ...(height === undefined ? null : { \"--kz-wall-height\": `${Math.max(320, finite(height))}px` }), \"--kz-wall-item-width\": `${Math.max(120, finite(itemWidth))}px` } as React.CSSProperties}>\n {[...items].sort((a, b) => finite(a.z) - finite(b.z)).slice(0, drawn).map(({ id, x, y, rotation = 0, z: _z, ...item }, rank) => (\n <li key={id} className=\"kz-wall-item\" tabIndex={0} style={{\n \"--kz-wall-x\": `${Math.min(100, Math.max(0, finite(x)))}%`,\n \"--kz-wall-y\": `${Math.min(100, Math.max(0, finite(y)))}%`,\n \"--kz-wall-rotation\": `${finite(rotation)}deg`,\n zIndex: rank,\n } as React.CSSProperties}>\n <WallObject item={item} />\n </li>\n ))}\n {texture === \"brick\" && <li className=\"kz-wall-decoration\" aria-hidden=\"true\" role=\"presentation\"><svg width=\"100%\" height=\"100%\" aria-hidden=\"true\">\n <defs><pattern id={patternId} width=\"96\" height=\"48\" patternUnits=\"userSpaceOnUse\">\n <path d=\"M0 0H96M0 24H96M0 48H96M48 0V24M0 24V48M96 24V48\" fill=\"none\" stroke=\"var(--kz-border-default)\" strokeWidth=\"2\" />\n </pattern></defs><rect width=\"100%\" height=\"100%\" fill={`url(#${patternId})`} />\n </svg></li>}\n {texture === \"zellige\" && <li className=\"kz-wall-decoration\" aria-hidden=\"true\" role=\"presentation\"><svg width=\"100%\" height=\"100%\" aria-hidden=\"true\">\n <defs><pattern id={patternId} width=\"64\" height=\"64\" patternUnits=\"userSpaceOnUse\">\n <path d=\"M32 3 39 15 52 12 49 25 61 32 49 39 52 52 39 49 32 61 25 49 12 52 15 39 3 32 15 25 12 12 25 15Z\" fill=\"var(--kz-accent-soft)\" stroke=\"var(--kz-border-default)\" />\n <path d=\"m32 18 14 14-14 14-14-14Z\" fill=\"var(--kz-surface-2)\" stroke=\"var(--kz-accent-2)\" />\n </pattern></defs><rect width=\"100%\" height=\"100%\" fill={`url(#${patternId})`} />\n </svg></li>}\n {texture === \"ridge\" && <li className=\"kz-wall-decoration\" aria-hidden=\"true\" role=\"presentation\"><svg viewBox=\"0 0 1000 600\" preserveAspectRatio=\"none\" width=\"100%\" height=\"100%\" aria-hidden=\"true\">\n <path d=\"M0 380 170 100 290 300 450 70 620 330 790 120 1000 350V600H0Z\" fill=\"var(--kz-accent-soft)\" />\n <path d=\"M0 470 200 280 370 440 600 190 760 400 920 260 1000 390V600H0Z\" fill=\"var(--kz-surface-2)\" />\n <path d=\"M0 540 180 430 360 520 540 390 760 520 900 410 1000 480V600H0Z\" fill=\"var(--kz-surface-3)\" />\n </svg></li>}\n </ul>\n );\n}\n"
341
386
  }
342
387
  ],
343
388
  "dependencies": [],
344
389
  "registryDependencies": [
345
390
  "cn",
391
+ "stuck",
346
392
  "taped-photo"
347
393
  ],
348
394
  "demo": {
349
395
  "path": "examples/wall/composition.tsx",
350
- "content": "import { Wall, type WallItem } from \"@krizaka/ui/wall\";\n\nconst m = {\n photoAlt: \"The mountain above our workshop\", caption: \"The view from here\",\n note: \"Made slowly. Shared gladly.\", signature: \"Sam\",\n sign: \"Neighbourhood workshop\", wallLabel: \"From our workshop\",\n};\nconst items: WallItem[] = [\n { id: \"photo\", kind: \"polaroid\", x: 8, y: 18, rotation: -4, z: 1,\n img: <svg role=\"img\" aria-label={m.photoAlt} viewBox=\"0 0 240 240\"><rect width=\"240\" height=\"240\" fill=\"var(--kz-accent-soft)\" /><path d=\"m0 240 100-190 55 110 35-45 50 125Z\" fill=\"var(--kz-accent)\" /></svg>,\n caption: m.caption, attachment: \"tape\", attachmentRotation: 6 },\n { id: \"word\", kind: \"note\", x: 52, y: 75, rotation: 3, z: 2, text: m.note, signature: m.signature, attachment: \"pin\" },\n { id: \"sign\", kind: \"sign\", x: 94, y: 22, rotation: -2, z: 3, logo: m.sign, variant: \"enamel\" },\n];\n\nexport default function CompositionExample() {\n return <Wall aria-label={m.wallLabel} texture=\"brick\" items={items} height={520} itemWidth={220} />;\n}\n"
396
+ "content": "import { Wall, type WallItem } from \"@krizaka/ui/wall\";\n\nconst m = {\n photoAlt: \"The mountain above our workshop\", caption: \"The view from here\",\n note: \"Made slowly. Shared gladly.\", signature: \"Sam\",\n sign: \"Neighbourhood workshop\", wallLabel: \"From our workshop\",\n};\nconst items: WallItem[] = [\n { id: \"photo\", kind: \"polaroid\", x: 8, y: 18, rotation: -4, z: 1,\n img: <svg role=\"img\" aria-label={m.photoAlt} viewBox=\"0 0 240 240\"><rect width=\"240\" height=\"240\" fill=\"var(--kz-accent-soft)\" /><path d=\"m0 240 100-190 55 110 35-45 50 125Z\" fill=\"var(--kz-accent)\" /></svg>,\n caption: m.caption, attachment: \"tape\", attachmentRotation: 6 },\n { id: \"word\", kind: \"note\", x: 52, y: 75, rotation: 3, z: 2, text: m.note, signature: m.signature, attachment: \"pin\" },\n { id: \"sign\", kind: \"sign\", x: 94, y: 22, rotation: -2, z: 3, logo: m.sign, variant: \"enamel\" },\n];\n\nexport default function CompositionExample() {\n return <Wall aria-label={m.wallLabel} texture=\"brick\" items={items} itemWidth={220} />;\n}\n"
351
397
  },
352
398
  "props": [
353
399
  {
354
400
  "component": "PinnedNote",
355
- "description": "A short word on a cut-corner card.",
401
+ "description": "A short word on a cut-corner card, stuck into the notebook.",
356
402
  "props": [
357
403
  {
358
404
  "name": "text",
@@ -375,6 +421,27 @@
375
421
  "description": "The tape or pin's tilt in degrees; defaults to zero.",
376
422
  "required": false
377
423
  },
424
+ {
425
+ "name": "hold",
426
+ "type": "\"pin\" | \"tape\"",
427
+ "default": "tape",
428
+ "description": "How the note is held, through `Stuck`: a strip of tape or a pin. Takes over `attachment`.",
429
+ "required": false
430
+ },
431
+ {
432
+ "name": "ink",
433
+ "type": "\"blue\" | \"margin\" | \"hue\"",
434
+ "default": "blue",
435
+ "description": "The ink of the pen: blue ink, the margin's red, or the page's hue.",
436
+ "required": false
437
+ },
438
+ {
439
+ "name": "lines",
440
+ "type": "number",
441
+ "default": "4",
442
+ "description": "The lines of the text box, fixed so a late font never shifts the page (the text is read in full by assistive technology).",
443
+ "required": false
444
+ },
378
445
  {
379
446
  "name": "rotation",
380
447
  "type": "number",
@@ -441,20 +508,34 @@
441
508
  },
442
509
  {
443
510
  "component": "ShopSign",
444
- "description": "A shop's own mark, as a plate, a neon, or a painted sign.",
511
+ "description": "A shop's own mark, as a plate, a neon, a painted sign, or the name alone.",
445
512
  "props": [
446
513
  {
447
- "name": "logo",
514
+ "name": "animated",
515
+ "type": "boolean",
516
+ "default": "true",
517
+ "description": "Allow one soft neon flicker the first time the sign is seen; defaults to true, never loops, respects reduced motion.",
518
+ "required": false
519
+ },
520
+ {
521
+ "name": "as",
522
+ "type": "\"h1\" | \"h2\" | \"h3\" | \"p\"",
523
+ "default": "h1",
524
+ "description": "The element of the name: the page's `h1` by default, `h2`/`h3` for a second sign, `p` for none. A sign on a `Wall` is a `p` unless told otherwise.",
525
+ "required": false
526
+ },
527
+ {
528
+ "name": "children",
448
529
  "type": "ReactNode",
449
530
  "default": null,
450
- "description": "The owner's logo or wordmark. Name an SVG/image accessibly, or use readable text.",
451
- "required": true
531
+ "description": "The shop's name as live text, in the sign's lettering: the page's heading (`as`). Prefer it to an image of the name.",
532
+ "required": false
452
533
  },
453
534
  {
454
- "name": "animated",
455
- "type": "boolean",
456
- "default": "true",
457
- "description": "Allow a single soft neon flicker on mount; defaults to true and respects reduced motion.",
535
+ "name": "logo",
536
+ "type": "ReactNode",
537
+ "default": null,
538
+ "description": "The owner's logo or wordmark, optional beside the name. Name an SVG/image accessibly, or use readable text.",
458
539
  "required": false
459
540
  },
460
541
  {
@@ -466,9 +547,9 @@
466
547
  },
467
548
  {
468
549
  "name": "variant",
469
- "type": "\"enamel\" | \"neon\" | \"painted\"",
550
+ "type": "\"none\" | \"enamel\" | \"neon\" | \"painted\"",
470
551
  "default": "enamel",
471
- "description": "Enamel plate and screws, softly glowing neon, or a time-worn painted sign.",
552
+ "description": "Enamel plate and screws, softly glowing neon, a time-worn painted sign, or `none` (the name alone on paper).",
472
553
  "required": false
473
554
  }
474
555
  ]
@@ -487,8 +568,8 @@
487
568
  {
488
569
  "name": "height",
489
570
  "type": "number",
490
- "default": "560",
491
- "description": "Desktop surface height in pixels (minimum 320); defaults to 560. Phones grow with content.",
571
+ "default": null,
572
+ "description": "A fixed desktop surface height in pixels (minimum 320). Absent, the surface is a fixed 16:9 box. Phones grow with content.",
492
573
  "required": false
493
574
  },
494
575
  {
@@ -498,6 +579,13 @@
498
579
  "description": "Desktop object width in pixels (minimum 120); defaults to 240 and never exceeds the surface.",
499
580
  "required": false
500
581
  },
582
+ {
583
+ "name": "max",
584
+ "type": "number",
585
+ "default": "12",
586
+ "description": "Draws at most this many items (the first in z order); defaults to 12. The rest belongs to the host's « see the whole wall ».",
587
+ "required": false
588
+ },
501
589
  {
502
590
  "name": "texture",
503
591
  "type": "\"brick\" | \"zellige\" | \"ridge\" | \"plaster\"",