@krizaka/ui 3.64.1 → 3.65.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (278) hide show
  1. package/dist/account-menu.d.ts +7 -3
  2. package/dist/account-menu.js +14 -10
  3. package/dist/account-menu.js.map +1 -1
  4. package/dist/app-frame/server.d.ts +123 -0
  5. package/dist/app-frame/server.js +109 -0
  6. package/dist/app-frame/server.js.map +1 -0
  7. package/dist/app-frame.d.ts +210 -0
  8. package/dist/app-frame.js +220 -0
  9. package/dist/app-frame.js.map +1 -0
  10. package/dist/desktop-window.d.ts +223 -0
  11. package/dist/desktop-window.js +261 -0
  12. package/dist/desktop-window.js.map +1 -0
  13. package/dist/file-upload.d.ts +2 -2
  14. package/dist/filter-bar.d.ts +3 -3
  15. package/dist/language-switch.d.ts +9 -9
  16. package/dist/native.d.ts +218 -3
  17. package/dist/native.js +1638 -1450
  18. package/dist/native.js.map +1 -1
  19. package/dist/theme.d.ts +3 -1
  20. package/dist/theme.js +4 -0
  21. package/dist/theme.js.map +1 -1
  22. package/package.json +47 -5
  23. package/registry/account-menu.json +22 -8
  24. package/registry/account-settings.json +1 -1
  25. package/registry/achievement.json +1 -1
  26. package/registry/action-bar.json +1 -1
  27. package/registry/activity-feed.json +1 -1
  28. package/registry/agenda.json +1 -1
  29. package/registry/alert.json +1 -1
  30. package/registry/analysis-report.json +1 -1
  31. package/registry/anatomy-plate.json +1 -1
  32. package/registry/app-frame.json +564 -0
  33. package/registry/app-header.json +1 -1
  34. package/registry/app-shell.json +1 -1
  35. package/registry/argument-card.json +1 -1
  36. package/registry/audio-player.json +1 -1
  37. package/registry/auth-layout.json +1 -1
  38. package/registry/avatar.json +1 -1
  39. package/registry/badge.json +1 -1
  40. package/registry/bird-plate.json +1 -1
  41. package/registry/button.json +1 -1
  42. package/registry/captcha.json +1 -1
  43. package/registry/card-grid.json +1 -1
  44. package/registry/card.json +1 -1
  45. package/registry/catalogue-page.json +1 -1
  46. package/registry/changelog-page.json +1 -1
  47. package/registry/chapter.json +1 -1
  48. package/registry/chat.json +1 -1
  49. package/registry/checkbox.json +1 -1
  50. package/registry/chip-link.json +1 -1
  51. package/registry/chip-row.json +1 -1
  52. package/registry/chip.json +1 -1
  53. package/registry/choice-grid.json +1 -1
  54. package/registry/code-block.json +1 -1
  55. package/registry/combobox.json +1 -1
  56. package/registry/command.json +1 -1
  57. package/registry/comparison-table.json +1 -1
  58. package/registry/component-page.json +1 -1
  59. package/registry/confirm-button.json +1 -1
  60. package/registry/contact-page.json +1 -1
  61. package/registry/continue-prompt.json +1 -1
  62. package/registry/countdown.json +1 -1
  63. package/registry/cover-hero.json +1 -1
  64. package/registry/cta-panel.json +1 -1
  65. package/registry/dashboard-layout.json +1 -1
  66. package/registry/data-table.json +1 -1
  67. package/registry/date-picker.json +3 -3
  68. package/registry/decision-list.json +1 -1
  69. package/registry/description-list.json +1 -1
  70. package/registry/desktop-window.json +407 -0
  71. package/registry/detail-layout.json +1 -1
  72. package/registry/dialog.json +1 -1
  73. package/registry/docs-article-page.json +1 -1
  74. package/registry/docs-hub-page.json +1 -1
  75. package/registry/docs-layout.json +1 -1
  76. package/registry/docs-nav.json +1 -1
  77. package/registry/document-viewer.json +1 -1
  78. package/registry/doodle.json +1 -1
  79. package/registry/drop-overlay.json +1 -1
  80. package/registry/dropdown-menu.json +1 -1
  81. package/registry/elephant.json +2 -2
  82. package/registry/embed-facade.json +1 -1
  83. package/registry/empty-state.json +1 -1
  84. package/registry/engine-flow.json +1 -1
  85. package/registry/environment-notice.json +1 -1
  86. package/registry/error-page.json +1 -1
  87. package/registry/examples/app-frame/admin.d.ts +4 -0
  88. package/registry/examples/app-frame/admin.js +32 -0
  89. package/registry/examples/app-frame/admin.tsx +33 -0
  90. package/registry/examples/app-frame/app.d.ts +4 -0
  91. package/registry/examples/app-frame/app.js +53 -0
  92. package/registry/examples/app-frame/app.tsx +56 -0
  93. package/registry/examples/desktop-window/library.d.ts +4 -0
  94. package/registry/examples/desktop-window/library.js +49 -0
  95. package/registry/examples/desktop-window/library.tsx +58 -0
  96. package/registry/examples/form-flow/native/signup.d.ts +4 -0
  97. package/registry/examples/form-flow/native/signup.dark.png +0 -0
  98. package/registry/examples/form-flow/native/signup.js +26 -0
  99. package/registry/examples/form-flow/native/signup.light.png +0 -0
  100. package/registry/examples/form-flow/native/signup.tsx +23 -0
  101. package/registry/examples/grid/native/columns.d.ts +4 -0
  102. package/registry/examples/grid/native/columns.dark.png +0 -0
  103. package/registry/examples/grid/native/columns.js +23 -0
  104. package/registry/examples/grid/native/columns.light.png +0 -0
  105. package/registry/examples/grid/native/columns.tsx +20 -0
  106. package/registry/examples/grid/native/photos.d.ts +4 -0
  107. package/registry/examples/grid/native/photos.dark.png +0 -0
  108. package/registry/examples/grid/native/photos.js +14 -0
  109. package/registry/examples/grid/native/photos.light.png +0 -0
  110. package/registry/examples/grid/native/photos.tsx +18 -0
  111. package/registry/examples/grid/native/stats.d.ts +4 -0
  112. package/registry/examples/grid/native/stats.dark.png +0 -0
  113. package/registry/examples/grid/native/stats.js +22 -0
  114. package/registry/examples/grid/native/stats.light.png +0 -0
  115. package/registry/examples/grid/native/stats.tsx +24 -0
  116. package/registry/examples/list-detail/native/inbox.d.ts +4 -0
  117. package/registry/examples/list-detail/native/inbox.dark.png +0 -0
  118. package/registry/examples/list-detail/native/inbox.js +35 -0
  119. package/registry/examples/list-detail/native/inbox.light.png +0 -0
  120. package/registry/examples/list-detail/native/inbox.tsx +35 -0
  121. package/registry/examples/screen/native/dashboard.d.ts +4 -0
  122. package/registry/examples/screen/native/dashboard.dark.png +0 -0
  123. package/registry/examples/screen/native/dashboard.js +48 -0
  124. package/registry/examples/screen/native/dashboard.light.png +0 -0
  125. package/registry/examples/screen/native/dashboard.tsx +52 -0
  126. package/registry/examples/screen/native/settings-home.d.ts +4 -0
  127. package/registry/examples/screen/native/settings-home.dark.png +0 -0
  128. package/registry/examples/screen/native/settings-home.js +26 -0
  129. package/registry/examples/screen/native/settings-home.light.png +0 -0
  130. package/registry/examples/screen/native/settings-home.tsx +25 -0
  131. package/registry/examples/shop/hero-tv.js +1 -1
  132. package/registry/examples/shop/hero-tv.tsx +1 -1
  133. package/registry/examples/state-screen/native/empty.d.ts +4 -0
  134. package/registry/examples/state-screen/native/empty.dark.png +0 -0
  135. package/registry/examples/state-screen/native/empty.js +12 -0
  136. package/registry/examples/state-screen/native/empty.light.png +0 -0
  137. package/registry/examples/state-screen/native/empty.tsx +11 -0
  138. package/registry/examples/state-screen/native/error.d.ts +4 -0
  139. package/registry/examples/state-screen/native/error.dark.png +0 -0
  140. package/registry/examples/state-screen/native/error.js +21 -0
  141. package/registry/examples/state-screen/native/error.light.png +0 -0
  142. package/registry/examples/state-screen/native/error.tsx +17 -0
  143. package/registry/examples/state-screen/native/offline.d.ts +4 -0
  144. package/registry/examples/state-screen/native/offline.dark.png +0 -0
  145. package/registry/examples/state-screen/native/offline.js +15 -0
  146. package/registry/examples/state-screen/native/offline.light.png +0 -0
  147. package/registry/examples/state-screen/native/offline.tsx +12 -0
  148. package/registry/field.json +1 -1
  149. package/registry/file-upload.json +1 -1
  150. package/registry/filter-bar.json +1 -1
  151. package/registry/flock.json +1 -1
  152. package/registry/footnote.json +1 -1
  153. package/registry/force-update-screen.json +1 -1
  154. package/registry/form-flow.json +152 -0
  155. package/registry/form.json +1 -1
  156. package/registry/gallery-page.json +1 -1
  157. package/registry/genui.json +1 -1
  158. package/registry/glossary-term.json +1 -1
  159. package/registry/glossary.json +1 -1
  160. package/registry/glow-card.json +1 -1
  161. package/registry/goal-gauge.json +1 -1
  162. package/registry/grade-stamp.json +1 -1
  163. package/registry/grid.json +262 -0
  164. package/registry/how-it-works-page.json +1 -1
  165. package/registry/image-cropper.json +1 -1
  166. package/registry/index.json +314 -12
  167. package/registry/iso.json +1 -1
  168. package/registry/kanban.json +1 -1
  169. package/registry/kbd.json +1 -1
  170. package/registry/kind-config-editor.json +1 -1
  171. package/registry/kpi-explained.json +1 -1
  172. package/registry/landing-page.json +1 -1
  173. package/registry/landscape.json +1 -1
  174. package/registry/language-switch.json +1 -1
  175. package/registry/legal-page.json +1 -1
  176. package/registry/link-card.json +1 -1
  177. package/registry/list-detail.json +188 -0
  178. package/registry/list.json +1 -1
  179. package/registry/loader.json +1 -1
  180. package/registry/longform-page.json +1 -1
  181. package/registry/maintenance-screen.json +1 -1
  182. package/registry/map.json +2 -2
  183. package/registry/margin-layout.json +1 -1
  184. package/registry/markdown.json +1 -1
  185. package/registry/marketing-layout.json +1 -1
  186. package/registry/marquee.json +1 -1
  187. package/registry/mascot-quote.json +1 -1
  188. package/registry/mascot-state.json +1 -1
  189. package/registry/mascots.json +1 -1
  190. package/registry/match-dialog.json +1 -1
  191. package/registry/media-capture.json +1 -1
  192. package/registry/media-gallery.json +1 -1
  193. package/registry/media-grid.json +1 -1
  194. package/registry/meta-row.json +1 -1
  195. package/registry/meter.json +1 -1
  196. package/registry/nav-bar.json +2 -2
  197. package/registry/next-actions.json +1 -1
  198. package/registry/notification-preferences.json +1 -1
  199. package/registry/number-ticker.json +1 -1
  200. package/registry/onboarding.json +3 -0
  201. package/registry/opening-hours.json +1 -1
  202. package/registry/page-header.json +1 -1
  203. package/registry/page-hero.json +1 -1
  204. package/registry/page-index.json +1 -1
  205. package/registry/page.json +1 -1
  206. package/registry/pagination.json +1 -1
  207. package/registry/photo-grid.json +1 -1
  208. package/registry/pointer-light.json +1 -1
  209. package/registry/popover.json +1 -1
  210. package/registry/pricing-page.json +1 -1
  211. package/registry/product-page.json +1 -1
  212. package/registry/profile-card.json +1 -1
  213. package/registry/progress.json +1 -1
  214. package/registry/promise-card.json +1 -1
  215. package/registry/quota-meter.json +1 -1
  216. package/registry/radio-group.json +1 -1
  217. package/registry/rail-nav.json +2 -2
  218. package/registry/recipes.json +1 -1
  219. package/registry/retro-tv.json +1 -1
  220. package/registry/reviews.json +1 -1
  221. package/registry/router.json +1 -1
  222. package/registry/screen.json +68 -4
  223. package/registry/scroll-stage.json +1 -1
  224. package/registry/search-field.json +1 -1
  225. package/registry/section-backdrop.json +1 -1
  226. package/registry/separator.json +1 -1
  227. package/registry/service-card.json +1 -1
  228. package/registry/settings-layout.json +5 -2
  229. package/registry/shop-composer.json +1 -1
  230. package/registry/shop.json +3 -3
  231. package/registry/showcase.json +1 -1
  232. package/registry/signature.json +1 -1
  233. package/registry/site-cahier.json +1 -1
  234. package/registry/site-footer.json +4 -4
  235. package/registry/sites.json +1 -1
  236. package/registry/skeleton.json +1 -1
  237. package/registry/skip-link.json +1 -1
  238. package/registry/slider.json +1 -1
  239. package/registry/slot-picker.json +1 -1
  240. package/registry/slot.json +1 -1
  241. package/registry/specimen-tag.json +1 -1
  242. package/registry/speed-lines.json +1 -1
  243. package/registry/spinner.json +1 -1
  244. package/registry/split-view.json +1 -1
  245. package/registry/stage-banner.json +1 -1
  246. package/registry/stat.json +1 -1
  247. package/registry/state-screen.json +224 -0
  248. package/registry/status-chip.json +1 -1
  249. package/registry/status-page.json +1 -1
  250. package/registry/step-progress.json +1 -1
  251. package/registry/step-showcase.json +1 -1
  252. package/registry/stepper.json +1 -1
  253. package/registry/sticky-action.json +1 -1
  254. package/registry/stuck.json +1 -1
  255. package/registry/swipe-deck.json +1 -1
  256. package/registry/switch.json +1 -1
  257. package/registry/tabs.json +1 -1
  258. package/registry/tag-input.json +1 -1
  259. package/registry/tag-selector.json +1 -1
  260. package/registry/taped-photo.json +1 -1
  261. package/registry/terminal-replay.json +1 -1
  262. package/registry/text-style.json +1 -1
  263. package/registry/theme.json +3 -3
  264. package/registry/toast.json +1 -1
  265. package/registry/toc.json +1 -1
  266. package/registry/tooltip.json +1 -1
  267. package/registry/tree-view.json +1 -1
  268. package/registry/update-prompt.json +1 -1
  269. package/registry/upload-queue.json +1 -1
  270. package/registry/usage.json +1 -1
  271. package/registry/verified-badge.json +1 -1
  272. package/registry/versus-card.json +1 -1
  273. package/registry/vertical-video.json +1 -1
  274. package/registry/video-player.json +1 -1
  275. package/registry/video-trimmer.json +1 -1
  276. package/registry/virtual.json +1 -1
  277. package/registry/wall.json +1 -1
  278. package/registry/waveform.json +1 -1
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@krizaka/ui",
3
- "version": "3.64.1",
3
+ "version": "3.65.0",
4
4
  "templatePurposes": {
5
5
  "convince": {
6
6
  "title": "Convince",
@@ -167,6 +167,15 @@
167
167
  "purpose": "explain",
168
168
  "why": "A newcomer finds the right documentation from one page of grouped entry points."
169
169
  },
170
+ {
171
+ "component": "onboarding",
172
+ "platform": "native",
173
+ "name": "first-launch",
174
+ "title": "First launch",
175
+ "description": "An app's three promises.",
176
+ "purpose": "explain",
177
+ "why": "A person learns what the app does in three swipes, and can skip at any moment."
178
+ },
170
179
  {
171
180
  "component": "site-cahier",
172
181
  "platform": "web",
@@ -311,6 +320,15 @@
311
320
  "purpose": "act",
312
321
  "why": "A person fills a long form in order and always sees the total and the one action that commits it."
313
322
  },
323
+ {
324
+ "component": "form-flow",
325
+ "platform": "native",
326
+ "name": "signup",
327
+ "title": "Sign-up in steps",
328
+ "description": "Two steps, the position in words, the main action dimmed until the step is valid.",
329
+ "purpose": "act",
330
+ "why": "A person answers one question at a time with the thumb, the main action always above the keyboard."
331
+ },
314
332
  {
315
333
  "component": "screen",
316
334
  "platform": "native",
@@ -347,6 +365,24 @@
347
365
  "purpose": "operate",
348
366
  "why": "A person changes who they are in the app in one place, and sees at once that it was kept."
349
367
  },
368
+ {
369
+ "component": "app-frame",
370
+ "platform": "web",
371
+ "name": "admin",
372
+ "title": "The administration",
373
+ "description": "`variant=\"admin\"` in French: the same frame, a chip that says where you are, and no way into the administration offered again.",
374
+ "purpose": "operate",
375
+ "why": "An administrator moves from the app to its administration without the frame changing under them."
376
+ },
377
+ {
378
+ "component": "app-frame",
379
+ "platform": "web",
380
+ "name": "app",
381
+ "title": "A product's signed-in app",
382
+ "description": "Yomizaka: four sections with a count, the search, the primary action « Check a document », and the account menu with Language and Theme.",
383
+ "purpose": "operate",
384
+ "why": "A person works in a few sections all day and finds their account, language and theme in the same place in every Krizaka product."
385
+ },
350
386
  {
351
387
  "component": "app-shell",
352
388
  "platform": "web",
@@ -401,6 +437,15 @@
401
437
  "purpose": "operate",
402
438
  "why": "A small business owner sees today, the two things that wait and the four things they do most, without searching."
403
439
  },
440
+ {
441
+ "component": "desktop-window",
442
+ "platform": "web",
443
+ "name": "library",
444
+ "title": "A library window",
445
+ "description": "A source list, a list of files and the details of the selected one; ⌘B and ⌘I fold the panes, the menu bar gets the same commands.",
446
+ "purpose": "operate",
447
+ "why": "A person on a Mac works with a list and the details of what they select, with the keys and the menus of a Mac app."
448
+ },
404
449
  {
405
450
  "component": "notification-preferences",
406
451
  "platform": "web",
@@ -437,6 +482,15 @@
437
482
  "purpose": "operate",
438
483
  "why": "A person moves between the main sections of the app with one thumb, the tab bar always in reach."
439
484
  },
485
+ {
486
+ "component": "screen",
487
+ "platform": "native",
488
+ "name": "dashboard",
489
+ "title": "Dashboard",
490
+ "description": "A large title, a stat strip that is two per row on a phone and four on a tablet, the recent items, the tab bar; pull down to refresh.",
491
+ "purpose": "operate",
492
+ "why": "A person sees what needs them at a glance and refreshes with the thumb, the tab bar always in reach."
493
+ },
440
494
  {
441
495
  "component": "screen",
442
496
  "platform": "native",
@@ -446,6 +500,15 @@
446
500
  "purpose": "operate",
447
501
  "why": "A person changes a preference and sees it apply at once, grouped by what it concerns."
448
502
  },
503
+ {
504
+ "component": "screen",
505
+ "platform": "native",
506
+ "name": "settings-home",
507
+ "title": "Settings home",
508
+ "description": "One list grouped by what it concerns: rows that open a screen, switches that apply at once, a danger zone.",
509
+ "purpose": "operate",
510
+ "why": "A person finds a preference by what it concerns and changes it without leaving the list."
511
+ },
449
512
  {
450
513
  "component": "settings-layout",
451
514
  "platform": "web",
@@ -455,6 +518,15 @@
455
518
  "purpose": "operate",
456
519
  "why": "A person changes one setting at a time, saves it at once and knows where each lives."
457
520
  },
521
+ {
522
+ "component": "settings-layout",
523
+ "platform": "native",
524
+ "name": "account",
525
+ "title": "Account settings",
526
+ "description": "A group of rows: a value, a link that opens a screen, a switch, a destructive action.",
527
+ "purpose": "operate",
528
+ "why": "A person reviews their account and changes one thing, with the dangerous action set apart at the end."
529
+ },
458
530
  {
459
531
  "component": "settings-layout",
460
532
  "platform": "web",
@@ -473,6 +545,15 @@
473
545
  "purpose": "operate",
474
546
  "why": "A person with many places to go finds each under its group, and never meets a strip of chips that hides half of them."
475
547
  },
548
+ {
549
+ "component": "list-detail",
550
+ "platform": "native",
551
+ "name": "inbox",
552
+ "title": "Inbox",
553
+ "description": "Messages: the list, then the message with the way back; both side by side on a tablet.",
554
+ "purpose": "converse",
555
+ "why": "A person reads a thread of messages one at a time on a phone, and the list stays in view when the room allows it."
556
+ },
476
557
  {
477
558
  "component": "screen",
478
559
  "platform": "native",
@@ -527,6 +608,33 @@
527
608
  "purpose": "recover",
528
609
  "why": "A lost visitor gets back on track with a search and a few ways out, never a dead end."
529
610
  },
611
+ {
612
+ "component": "state-screen",
613
+ "platform": "native",
614
+ "name": "empty",
615
+ "title": "Empty",
616
+ "description": "Nothing yet, and the one way to fill it.",
617
+ "purpose": "recover",
618
+ "why": "A person who finds nothing is told why and how to start, not left on a blank screen."
619
+ },
620
+ {
621
+ "component": "state-screen",
622
+ "platform": "native",
623
+ "name": "error",
624
+ "title": "Error",
625
+ "description": "What failed in plain words, Try again, and a quieter way to get help.",
626
+ "purpose": "recover",
627
+ "why": "A person whose request failed knows nothing was lost and can retry in one tap."
628
+ },
629
+ {
630
+ "component": "state-screen",
631
+ "platform": "native",
632
+ "name": "offline",
633
+ "title": "Offline",
634
+ "description": "The slim banner over the saved data, and the full state when there is none.",
635
+ "purpose": "recover",
636
+ "why": "A person with no network still sees what was saved and knows what is stale."
637
+ },
530
638
  {
531
639
  "component": "status-page",
532
640
  "platform": "web",
@@ -560,8 +668,8 @@
560
668
  "name": "account-menu",
561
669
  "type": "primitive",
562
670
  "title": "Account menu",
563
- "summary": "The menu under a signed-in person's avatar: who they are, their profile and settings, the language as a compact submenu, Sign out.",
564
- "description": "The menu under a signed-in person's avatar: who they are, their profile and settings, the language as a compact submenu, Sign out.",
671
+ "summary": "The menu under a signed-in person's avatar: who they are, their profile and settings, the language and the theme as compact submenus, Sign out.",
672
+ "description": "The menu under a signed-in person's avatar: who they are, their profile and settings, the language and the theme as compact submenus, Sign out.",
565
673
  "status": "beta",
566
674
  "category": "navigation",
567
675
  "platforms": "web",
@@ -878,6 +986,43 @@
878
986
  "cn"
879
987
  ]
880
988
  },
989
+ {
990
+ "name": "app-frame",
991
+ "type": "primitive",
992
+ "title": "App frame",
993
+ "summary": "The one signed-in frame of a Krizaka web product: the rail (a bottom tab bar on a phone), the family's top bar and the account menu, composed from data — sections, account and the primary action. The frame owns what must not differ between products: the account menu's content and order, the preferences living in the menu, a place being on the rail or under the avatar, never both.",
994
+ "description": "The one signed-in frame of a Krizaka web product: the rail (a bottom tab bar on a phone), the family's top bar and the account menu, composed from data — sections, account and the primary action. The frame owns what must not differ between products: the account menu's content and order, the preferences living in the menu, a place being on the rail or under the avatar, never both.",
995
+ "status": "beta",
996
+ "category": "layouts",
997
+ "platforms": "web",
998
+ "parity": {
999
+ "web": {
1000
+ "state": "yes"
1001
+ },
1002
+ "native": {
1003
+ "state": "n/a",
1004
+ "reason": "On a phone the frame is a tab bar, a header and a screen: the native twin is the tabs shell template.",
1005
+ "use": "tab-bar"
1006
+ },
1007
+ "desktop": {
1008
+ "state": "yes"
1009
+ }
1010
+ },
1011
+ "examples": {
1012
+ "web": 2,
1013
+ "native": 0
1014
+ },
1015
+ "dependencies": [
1016
+ "@krizaka/tokens@^3.65.0"
1017
+ ],
1018
+ "registryDependencies": [
1019
+ "account-menu",
1020
+ "app-header",
1021
+ "badge",
1022
+ "rail-nav",
1023
+ "theme"
1024
+ ]
1025
+ },
881
1026
  {
882
1027
  "name": "app-header",
883
1028
  "type": "primitive",
@@ -2121,6 +2266,39 @@
2121
2266
  ],
2122
2267
  "registryDependencies": []
2123
2268
  },
2269
+ {
2270
+ "name": "desktop-window",
2271
+ "type": "primitive",
2272
+ "title": "Desktop window",
2273
+ "summary": "The window of a Mac app (Tauri 2 on the system WebView): a sidebar, the content and an inspector in a three-pane split — resizable by pointer and keyboard, collapsible — under a toolbar that moves the window and clears the traffic lights, at the desktop's density with a native-feeling focus ring. Its commands are written once for the menu bar, the page's shortcuts and the palette.",
2274
+ "description": "The window of a Mac app (Tauri 2 on the system WebView): a sidebar, the content and an inspector in a three-pane split — resizable by pointer and keyboard, collapsible — under a toolbar that moves the window and clears the traffic lights, at the desktop's density with a native-feeling focus ring. Its commands are written once for the menu bar, the page's shortcuts and the palette.",
2275
+ "status": "beta",
2276
+ "category": "layouts",
2277
+ "platforms": "web",
2278
+ "parity": {
2279
+ "web": {
2280
+ "state": "yes"
2281
+ },
2282
+ "native": {
2283
+ "state": "n/a",
2284
+ "reason": "A phone has no windows: its screens are the list and detail, the tabs and the sheets.",
2285
+ "use": "list-detail"
2286
+ },
2287
+ "desktop": {
2288
+ "state": "desktop"
2289
+ }
2290
+ },
2291
+ "examples": {
2292
+ "web": 1,
2293
+ "native": 0
2294
+ },
2295
+ "dependencies": [
2296
+ "tailwind-variants@^3.3.1"
2297
+ ],
2298
+ "registryDependencies": [
2299
+ "app-shell"
2300
+ ]
2301
+ },
2124
2302
  {
2125
2303
  "name": "detail-layout",
2126
2304
  "type": "primitive",
@@ -2469,7 +2647,7 @@
2469
2647
  "native": 0
2470
2648
  },
2471
2649
  "dependencies": [
2472
- "@krizaka/tokens@^3.64.1"
2650
+ "@krizaka/tokens@^3.65.0"
2473
2651
  ],
2474
2652
  "registryDependencies": []
2475
2653
  },
@@ -2894,6 +3072,37 @@
2894
3072
  "tag-input"
2895
3073
  ]
2896
3074
  },
3075
+ {
3076
+ "name": "form-flow",
3077
+ "type": "native",
3078
+ "title": "Form flow",
3079
+ "summary": "A form told in steps on a screen: the step's question, its fields, the position in words, the main action pinned above the keyboard and clear of the home indicator, dimmed until the step is valid.",
3080
+ "description": "A form told in steps on a screen: the step's question, its fields, the position in words, the main action pinned above the keyboard and clear of the home indicator, dimmed until the step is valid.",
3081
+ "status": "beta",
3082
+ "category": "layout",
3083
+ "platforms": "native",
3084
+ "parity": {
3085
+ "web": {
3086
+ "state": "n/a",
3087
+ "reason": "On the web a flow is a stepper above a form.",
3088
+ "use": "stepper"
3089
+ },
3090
+ "native": {
3091
+ "state": "yes"
3092
+ },
3093
+ "desktop": {
3094
+ "state": "n/a",
3095
+ "reason": "The Mac app's window is the web: its flow is the stepper.",
3096
+ "use": "stepper"
3097
+ }
3098
+ },
3099
+ "examples": {
3100
+ "web": 0,
3101
+ "native": 1
3102
+ },
3103
+ "dependencies": [],
3104
+ "registryDependencies": []
3105
+ },
2897
3106
  {
2898
3107
  "name": "gallery-page",
2899
3108
  "type": "primitive",
@@ -3120,6 +3329,37 @@
3120
3329
  "tooltip"
3121
3330
  ]
3122
3331
  },
3332
+ {
3333
+ "name": "grid",
3334
+ "type": "native",
3335
+ "title": "Grid and columns",
3336
+ "summary": "Layouts that choose their columns from the room they are given — compact, regular or expanded — never from a device name: a grid of equal cells that never gets narrower than `minItemWidth`, and columns that sit side by side or stack. Safe with right-to-left and with text at 200 %.",
3337
+ "description": "Layouts that choose their columns from the room they are given — compact, regular or expanded — never from a device name: a grid of equal cells that never gets narrower than `minItemWidth`, and columns that sit side by side or stack. Safe with right-to-left and with text at 200 %.",
3338
+ "status": "beta",
3339
+ "category": "layout",
3340
+ "platforms": "native",
3341
+ "parity": {
3342
+ "web": {
3343
+ "state": "n/a",
3344
+ "reason": "On the web the grid is CSS and the page's width is the container query.",
3345
+ "use": "card-grid"
3346
+ },
3347
+ "native": {
3348
+ "state": "yes"
3349
+ },
3350
+ "desktop": {
3351
+ "state": "n/a",
3352
+ "reason": "The Mac app's window is the web: its columns are the web grid's.",
3353
+ "use": "card-grid"
3354
+ }
3355
+ },
3356
+ "examples": {
3357
+ "web": 0,
3358
+ "native": 3
3359
+ },
3360
+ "dependencies": [],
3361
+ "registryDependencies": []
3362
+ },
3123
3363
  {
3124
3364
  "name": "header",
3125
3365
  "type": "native",
@@ -3597,6 +3837,37 @@
3597
3837
  "checkbox"
3598
3838
  ]
3599
3839
  },
3840
+ {
3841
+ "name": "list-detail",
3842
+ "type": "native",
3843
+ "title": "List and detail",
3844
+ "summary": "A list and the item open from it. One pane at a time on a phone — the list, then the item with the way back — and both side by side when the room holds them, decided by the width the layout is given, not by the device.",
3845
+ "description": "A list and the item open from it. One pane at a time on a phone — the list, then the item with the way back — and both side by side when the room holds them, decided by the width the layout is given, not by the device.",
3846
+ "status": "beta",
3847
+ "category": "layout",
3848
+ "platforms": "native",
3849
+ "parity": {
3850
+ "web": {
3851
+ "state": "n/a",
3852
+ "reason": "On the web the same two panes are the split view.",
3853
+ "use": "split-view"
3854
+ },
3855
+ "native": {
3856
+ "state": "yes"
3857
+ },
3858
+ "desktop": {
3859
+ "state": "n/a",
3860
+ "reason": "The Mac app's window is the web: its list and detail are the split view.",
3861
+ "use": "split-view"
3862
+ }
3863
+ },
3864
+ "examples": {
3865
+ "web": 0,
3866
+ "native": 1
3867
+ },
3868
+ "dependencies": [],
3869
+ "registryDependencies": []
3870
+ },
3600
3871
  {
3601
3872
  "name": "loader",
3602
3873
  "type": "primitive",
@@ -3717,7 +3988,7 @@
3717
3988
  "native": 2
3718
3989
  },
3719
3990
  "dependencies": [
3720
- "@krizaka/tokens@^3.64.1",
3991
+ "@krizaka/tokens@^3.65.0",
3721
3992
  "@protomaps/basemaps@5.7.2",
3722
3993
  "tailwind-variants@^3.3.1"
3723
3994
  ],
@@ -4188,7 +4459,7 @@
4188
4459
  "native": 0
4189
4460
  },
4190
4461
  "dependencies": [
4191
- "@krizaka/tokens@^3.64.1",
4462
+ "@krizaka/tokens@^3.65.0",
4192
4463
  "radix-ui@^1.8.1",
4193
4464
  "tailwind-variants@^3.3.1"
4194
4465
  ],
@@ -4951,7 +5222,7 @@
4951
5222
  "native": 0
4952
5223
  },
4953
5224
  "dependencies": [
4954
- "@krizaka/tokens@^3.64.1",
5225
+ "@krizaka/tokens@^3.65.0",
4955
5226
  "radix-ui@^1.8.1",
4956
5227
  "tailwind-variants@^3.3.1"
4957
5228
  ],
@@ -5086,8 +5357,8 @@
5086
5357
  "name": "screen",
5087
5358
  "type": "native",
5088
5359
  "title": "Screen",
5089
- "summary": "A screen of the app — a header, the content (scrolling, rising with the keyboard), a footer — and the templates built on it: app shell, sign-in, profile, feed, chat, settings, a map, notifications.",
5090
- "description": "A screen of the app — a header, the content (scrolling, rising with the keyboard), a footer — and the templates built on it: app shell, sign-in, profile, feed, chat, settings, a map, notifications.",
5360
+ "summary": "A screen of the app — a header, the content (scrolling, rising with the keyboard, refreshing on a pull), a footer — and the templates built on it: app shell, dashboard, sign-in, profile, feed, chat, settings, a map, notifications.",
5361
+ "description": "A screen of the app — a header, the content (scrolling, rising with the keyboard, refreshing on a pull), a footer — and the templates built on it: app shell, dashboard, sign-in, profile, feed, chat, settings, a map, notifications.",
5091
5362
  "status": "beta",
5092
5363
  "category": "layout",
5093
5364
  "platforms": "native",
@@ -5108,7 +5379,7 @@
5108
5379
  },
5109
5380
  "examples": {
5110
5381
  "web": 0,
5111
- "native": 8
5382
+ "native": 10
5112
5383
  },
5113
5384
  "dependencies": [],
5114
5385
  "registryDependencies": []
@@ -5363,7 +5634,7 @@
5363
5634
  "native": 0
5364
5635
  },
5365
5636
  "dependencies": [
5366
- "@krizaka/tokens@^3.64.1",
5637
+ "@krizaka/tokens@^3.65.0",
5367
5638
  "zod@^4.6.7"
5368
5639
  ],
5369
5640
  "registryDependencies": [
@@ -5550,7 +5821,7 @@
5550
5821
  "native": 0
5551
5822
  },
5552
5823
  "dependencies": [
5553
- "@krizaka/tokens@^3.64.1",
5824
+ "@krizaka/tokens@^3.65.0",
5554
5825
  "radix-ui@^1.8.1",
5555
5826
  "tailwind-variants@^3.3.1"
5556
5827
  ],
@@ -5954,6 +6225,37 @@
5954
6225
  ],
5955
6226
  "registryDependencies": []
5956
6227
  },
6228
+ {
6229
+ "name": "state-screen",
6230
+ "type": "native",
6231
+ "title": "State screen",
6232
+ "summary": "What a screen says when it has nothing to show, when it failed, or when the network is gone: an icon, a title in plain words, the reason and the way out — announced as it should be. With the slim offline banner for a screen that still shows saved data.",
6233
+ "description": "What a screen says when it has nothing to show, when it failed, or when the network is gone: an icon, a title in plain words, the reason and the way out — announced as it should be. With the slim offline banner for a screen that still shows saved data.",
6234
+ "status": "beta",
6235
+ "category": "feedback",
6236
+ "platforms": "native",
6237
+ "parity": {
6238
+ "web": {
6239
+ "state": "n/a",
6240
+ "reason": "On the web these are the empty state and the error page.",
6241
+ "use": "empty-state"
6242
+ },
6243
+ "native": {
6244
+ "state": "yes"
6245
+ },
6246
+ "desktop": {
6247
+ "state": "n/a",
6248
+ "reason": "The Mac app's window is the web: its states are the empty state and the error page.",
6249
+ "use": "empty-state"
6250
+ }
6251
+ },
6252
+ "examples": {
6253
+ "web": 0,
6254
+ "native": 3
6255
+ },
6256
+ "dependencies": [],
6257
+ "registryDependencies": []
6258
+ },
5957
6259
  {
5958
6260
  "name": "status-chip",
5959
6261
  "type": "primitive",
package/registry/iso.json CHANGED
@@ -741,7 +741,7 @@
741
741
  },
742
742
  {
743
743
  "path": "meta.ts",
744
- "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 | \"shop\"\n | \"shop-composer\"\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"
744
+ "content": "// The documentation of a component, carried by its code: each primitive has a `meta.ts` beside its source\n// (`src/<name>/meta.ts`; a component that exists only in React Native: `src/native/meta/<name>.ts`). Never built into\n// the package: `scripts/build-registry.mjs` reads them into `registry/<name>.json`, which ui.krizaka.com (apps/site) renders as\n// ui.krizaka.com/components/<name>, and `scripts/registry.test.mjs` fails when one is missing or incomplete.\n//\n// Why a typed module and not JSDoc tags: the fields are lists and links (`related`, `whenNotToUse[].use`, examples),\n// which a type checks and a comment does not; the file is plain data (erasable TypeScript), so Node reads it without a\n// compiler, and an editor completes it.\n\n/** Every documented component: the web primitives (one entry of the package each) and the native-only ones. */\nexport type ComponentName =\n | \"notification-preferences\"\n | \"quota-meter\"\n | \"environment-notice\"\n | \"embed-facade\"\n | \"reviews\"\n | \"margin-layout\"\n | \"analysis-report\"\n | \"status-chip\"\n | \"kind-config-editor\"\n | \"agenda\"\n | \"account-settings\"\n | \"drop-overlay\"\n | \"upload-queue\"\n | \"achievement\"\n | \"anatomy-plate\"\n | \"bird-plate\"\n | \"taped-photo\"\n | \"stuck\"\n | \"doodle\"\n | \"signature\"\n | \"grade-stamp\"\n | \"versus-card\"\n | \"speed-lines\"\n | \"site-cahier\"\n | \"text-style\"\n | \"flock\"\n | \"elephant\"\n | \"footnote\"\n | \"page-index\"\n | \"chapter\"\n | \"specimen-tag\"\n | \"action-bar\"\n | \"action-sheet\"\n | \"activity-feed\"\n | \"alert\"\n | \"app-frame\"\n | \"desktop-window\"\n | \"form-flow\"\n | \"grid\"\n | \"list-detail\"\n | \"state-screen\"\n | \"app-header\"\n | \"app-shell\"\n | \"argument-card\"\n | \"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 | \"shop\"\n | \"shop-composer\"\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"
745
745
  }
746
746
  ],
747
747
  "dependencies": [],