@kerfjs/ui 5.0.0-beta.97 → 5.0.0-beta.99

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 (416) hide show
  1. package/README.md +42 -1
  2. package/ai/application-ui-diagnostic-ids-v1.json +1 -0
  3. package/ai/component-catalog.json +487 -66
  4. package/ai/component-catalog.schema.json +1 -1
  5. package/ai/component-composition-rules.json +22 -2
  6. package/ai/component-composition.json +360 -33
  7. package/ai/component-composition.schema.json +1 -1
  8. package/ai/components/README.md +18 -17
  9. package/ai/components/anchored-surface.md +13 -0
  10. package/ai/components/application-tabs.md +1 -1
  11. package/ai/components/chip.md +9 -5
  12. package/ai/components/choice-chips.md +15 -8
  13. package/ai/components/collapsible-panel.md +3 -2
  14. package/ai/components/composer.md +83 -0
  15. package/ai/components/content-item.md +2 -2
  16. package/ai/components/corner-status.md +1 -1
  17. package/ai/components/document-baseline.md +3 -3
  18. package/ai/components/foundation.md +2 -2
  19. package/ai/components/layout.md +1 -1
  20. package/ai/components/list-action-row.md +5 -1
  21. package/ai/components/list-item.md +5 -1
  22. package/ai/components/list.md +19 -3
  23. package/ai/components/nav-stack.md +11 -2
  24. package/ai/components/pane.md +13 -4
  25. package/ai/components/popup-menu.md +4 -4
  26. package/ai/components/recipe-app-shell.md +3 -3
  27. package/ai/components/recipe-collapsible-sidebar.md +3 -3
  28. package/ai/components/recipe-compact-toolbar.md +1 -1
  29. package/ai/components/recipe-composer-form.md +3 -3
  30. package/ai/components/recipe-list-detail-dialog.md +2 -2
  31. package/ai/components/recipe-list-workspace-states.md +3 -3
  32. package/ai/components/recipe-loading-inspector.md +1 -1
  33. package/ai/components/recipe-navigation-sidebar.md +3 -3
  34. package/ai/components/recipe-navigation-stack.md +3 -3
  35. package/ai/components/recipe-workspace-header.md +3 -3
  36. package/ai/components/resize.md +2 -2
  37. package/ai/components/split-view.md +4 -2
  38. package/ai/components/sunken-panel.md +2 -2
  39. package/ai/components/surface-scaffold.md +15 -3
  40. package/ai/components/tab-bar.md +1 -0
  41. package/ai/components/tab-navigator.md +4 -0
  42. package/ai/components/toolbar-control-group.md +2 -0
  43. package/ai/components/toolbar-text.md +1 -0
  44. package/ai/components/toolbar.md +1 -0
  45. package/ai/components/workbench.md +1 -0
  46. package/ai/public-api-signatures-v1.md +504 -80
  47. package/ai/skill.md +41 -14
  48. package/ai/webawesome-jsx-signatures-v1.md +1 -1
  49. package/analyzer/component-ownership.mjs +1 -1
  50. package/analyzer/index.mjs +41 -14
  51. package/dist/anchored-surface.d.ts +30 -2
  52. package/dist/anchored-surface.js +1 -1
  53. package/dist/app-tab.js +1 -1
  54. package/dist/browser/composer.js +4 -0
  55. package/dist/catalog-resources.d.ts +3 -2
  56. package/dist/catalog-resources.js +4 -4
  57. package/dist/catalog-resources.js.map +1 -1
  58. package/dist/catalog.d.ts +39 -8
  59. package/dist/catalog.js +55 -32
  60. package/dist/catalog.js.map +1 -1
  61. package/dist/chip.d.ts +41 -9
  62. package/dist/chip.js +1 -1
  63. package/dist/choice-chips.d.ts +40 -16
  64. package/dist/choice-chips.js +1 -1
  65. package/dist/chunk-34U4ANDJ.js +119 -0
  66. package/dist/chunk-34U4ANDJ.js.map +1 -0
  67. package/dist/{chunk-36TL6BCR.js → chunk-3GLYIIFR.js} +34 -6
  68. package/dist/chunk-3GLYIIFR.js.map +1 -0
  69. package/dist/{chunk-HWY4BSLS.js → chunk-3VXDSIBJ.js} +2 -2
  70. package/dist/{chunk-HWY4BSLS.js.map → chunk-3VXDSIBJ.js.map} +1 -1
  71. package/dist/chunk-3WYREXW4.js +120 -0
  72. package/dist/chunk-3WYREXW4.js.map +1 -0
  73. package/dist/chunk-AV7CPAPT.js +82 -0
  74. package/dist/chunk-AV7CPAPT.js.map +1 -0
  75. package/dist/{chunk-XK4E225T.js → chunk-B53PS2LE.js} +2 -2
  76. package/dist/{chunk-XK4E225T.js.map → chunk-B53PS2LE.js.map} +1 -1
  77. package/dist/{chunk-R42D2BAO.js → chunk-CA7LNX3J.js} +2 -2
  78. package/dist/{chunk-R42D2BAO.js.map → chunk-CA7LNX3J.js.map} +1 -1
  79. package/dist/{chunk-AYHC62OZ.js → chunk-CMETHPKR.js} +26 -29
  80. package/dist/chunk-CMETHPKR.js.map +1 -0
  81. package/dist/{chunk-Y43B6DS3.js → chunk-CVD5IZGB.js} +2 -2
  82. package/dist/{chunk-Y43B6DS3.js.map → chunk-CVD5IZGB.js.map} +1 -1
  83. package/dist/{chunk-6STQXRT4.js → chunk-CXZXHZTR.js} +121 -12
  84. package/dist/chunk-CXZXHZTR.js.map +1 -0
  85. package/dist/{chunk-GZE2XVKC.js → chunk-DZJ4GBSP.js} +3 -3
  86. package/dist/{chunk-GZE2XVKC.js.map → chunk-DZJ4GBSP.js.map} +1 -1
  87. package/dist/chunk-ELCMSQNJ.js +49 -0
  88. package/dist/chunk-ELCMSQNJ.js.map +1 -0
  89. package/dist/{chunk-P74VXMB6.js → chunk-EOO6PYGF.js} +7 -14
  90. package/dist/chunk-EOO6PYGF.js.map +1 -0
  91. package/dist/{chunk-PRG4CL3Q.js → chunk-FR76ZJQC.js} +21 -19
  92. package/dist/chunk-FR76ZJQC.js.map +1 -0
  93. package/dist/{chunk-QQ3TTWFH.js → chunk-G3J7JDP6.js} +1 -1
  94. package/dist/{chunk-QQ3TTWFH.js.map → chunk-G3J7JDP6.js.map} +1 -1
  95. package/dist/{chunk-IGTWXPTN.js → chunk-HGV7J4T6.js} +3 -3
  96. package/dist/{chunk-IGTWXPTN.js.map → chunk-HGV7J4T6.js.map} +1 -1
  97. package/dist/{chunk-YWQGSUF2.js → chunk-HLDRH23D.js} +3 -3
  98. package/dist/{chunk-YWQGSUF2.js.map → chunk-HLDRH23D.js.map} +1 -1
  99. package/dist/{chunk-PBT3CPPY.js → chunk-HQZYKJ56.js} +24 -4
  100. package/dist/chunk-HQZYKJ56.js.map +1 -0
  101. package/dist/{chunk-V6W56V3N.js → chunk-HZPHCSCS.js} +16 -3
  102. package/dist/chunk-HZPHCSCS.js.map +1 -0
  103. package/dist/{chunk-GJYQ27C2.js → chunk-INI4WDWC.js} +8 -1
  104. package/dist/chunk-INI4WDWC.js.map +1 -0
  105. package/dist/{chunk-U657IHFB.js → chunk-IQSRHXZR.js} +10 -4
  106. package/dist/chunk-IQSRHXZR.js.map +1 -0
  107. package/dist/{chunk-KQDU7Z7P.js → chunk-K4AT3V3J.js} +2 -1
  108. package/dist/chunk-K4AT3V3J.js.map +1 -0
  109. package/dist/{chunk-QIAPOWHH.js → chunk-KCS6NJ3O.js} +2 -2
  110. package/dist/{chunk-QIAPOWHH.js.map → chunk-KCS6NJ3O.js.map} +1 -1
  111. package/dist/{chunk-UKKRPP56.js → chunk-LOSRXZAH.js} +2 -2
  112. package/dist/{chunk-UKKRPP56.js.map → chunk-LOSRXZAH.js.map} +1 -1
  113. package/dist/{chunk-ROZLJULF.js → chunk-MF6ZUUJZ.js} +8 -3
  114. package/dist/chunk-MF6ZUUJZ.js.map +1 -0
  115. package/dist/{chunk-6IVNMC6R.js → chunk-MHMWQ7RB.js} +2 -2
  116. package/dist/{chunk-6IVNMC6R.js.map → chunk-MHMWQ7RB.js.map} +1 -1
  117. package/dist/{chunk-JYD7G4RG.js → chunk-PIVY32AE.js} +15 -5
  118. package/dist/chunk-PIVY32AE.js.map +1 -0
  119. package/dist/{chunk-BU23Z5HZ.js → chunk-PYBBYSZ3.js} +13 -18
  120. package/dist/chunk-PYBBYSZ3.js.map +1 -0
  121. package/dist/chunk-QDSZTQXL.js +28 -0
  122. package/dist/chunk-QDSZTQXL.js.map +1 -0
  123. package/dist/{chunk-YXOMI7ES.js → chunk-QIG4IGUP.js} +2 -2
  124. package/dist/{chunk-YXOMI7ES.js.map → chunk-QIG4IGUP.js.map} +1 -1
  125. package/dist/{chunk-6BRRUPJY.js → chunk-QROYYGWU.js} +3 -3
  126. package/dist/chunk-QROYYGWU.js.map +1 -0
  127. package/dist/{chunk-FOQK4F3L.js → chunk-RHD7RKGI.js} +28 -7
  128. package/dist/chunk-RHD7RKGI.js.map +1 -0
  129. package/dist/{chunk-BBU2SPRE.js → chunk-T4WJ5VGP.js} +4 -4
  130. package/dist/{chunk-BBU2SPRE.js.map → chunk-T4WJ5VGP.js.map} +1 -1
  131. package/dist/{chunk-6NOLL5KG.js → chunk-TGLUDQP2.js} +3 -3
  132. package/dist/{chunk-6NOLL5KG.js.map → chunk-TGLUDQP2.js.map} +1 -1
  133. package/dist/{chunk-HO6FU3G7.js → chunk-TLMMFQWM.js} +4 -4
  134. package/dist/{chunk-HO6FU3G7.js.map → chunk-TLMMFQWM.js.map} +1 -1
  135. package/dist/chunk-UMKV7YVQ.js +20 -0
  136. package/dist/chunk-UMKV7YVQ.js.map +1 -0
  137. package/dist/{chunk-M2NRCFRO.js → chunk-VFYO3UGZ.js} +2 -2
  138. package/dist/{chunk-M2NRCFRO.js.map → chunk-VFYO3UGZ.js.map} +1 -1
  139. package/dist/{chunk-YOKEL75M.js → chunk-WVS6CUCT.js} +2 -2
  140. package/dist/{chunk-YOKEL75M.js.map → chunk-WVS6CUCT.js.map} +1 -1
  141. package/dist/{chunk-MN3POJFN.js → chunk-YMUIQRWK.js} +2 -2
  142. package/dist/{chunk-MN3POJFN.js.map → chunk-YMUIQRWK.js.map} +1 -1
  143. package/dist/{chunk-Y3LC7JQO.js → chunk-YOA5W5ZH.js} +2 -2
  144. package/dist/{chunk-Y3LC7JQO.js.map → chunk-YOA5W5ZH.js.map} +1 -1
  145. package/dist/{chunk-44A6LP54.js → chunk-YQ2AC4E2.js} +2 -2
  146. package/dist/{chunk-44A6LP54.js.map → chunk-YQ2AC4E2.js.map} +1 -1
  147. package/dist/chunk-ZNROKDSZ.js +54 -0
  148. package/dist/chunk-ZNROKDSZ.js.map +1 -0
  149. package/dist/collapsible-panel.d.ts +3 -2
  150. package/dist/collapsible-panel.js +4 -3
  151. package/dist/collapsible-panel.js.map +1 -1
  152. package/dist/composer.d.ts +62 -0
  153. package/dist/composer.js +5 -0
  154. package/dist/composer.js.map +1 -0
  155. package/dist/corner-status.d.ts +1 -1
  156. package/dist/corner-status.js +1 -1
  157. package/dist/css-values.d.ts +9 -1
  158. package/dist/css-values.js +1 -1
  159. package/dist/disclosure-arrow.js +1 -1
  160. package/dist/empty-state.js +1 -1
  161. package/dist/grid.js +1 -1
  162. package/dist/icon-button.js +1 -1
  163. package/dist/icon-toggle-button.js +1 -1
  164. package/dist/index.d.ts +10 -5
  165. package/dist/index.js +40 -37
  166. package/dist/list-action-row.d.ts +10 -2
  167. package/dist/list-action-row.js +1 -1
  168. package/dist/list-header.js +1 -1
  169. package/dist/list-icon-tile-B8dr97OW.d.ts +18 -0
  170. package/dist/list-item.d.ts +10 -3
  171. package/dist/list-item.js +1 -1
  172. package/dist/list.d.ts +36 -4
  173. package/dist/list.js +1 -1
  174. package/dist/loading-spinner.js +1 -1
  175. package/dist/lucide-icon.js +1 -1
  176. package/dist/{nav-stack-BvSKY448.d.ts → nav-stack-VXTumzKa.d.ts} +53 -4
  177. package/dist/nav-stack.d.ts +3 -2
  178. package/dist/nav-stack.js +2 -1
  179. package/dist/pane.d.ts +40 -3
  180. package/dist/pane.js +1 -1
  181. package/dist/{panel-toolbar-CL9tYOkh.d.ts → panel-toolbar-vg6Ir5Dy.d.ts} +6 -1
  182. package/dist/popup-menu-register.d.ts +2 -1
  183. package/dist/popup-menu-register.js +97 -22
  184. package/dist/popup-menu-register.js.map +1 -1
  185. package/dist/popup-menu.js +1 -1
  186. package/dist/row.js +1 -1
  187. package/dist/scroll-clearance-BikHljTc.d.ts +14 -0
  188. package/dist/select-register.js +11 -0
  189. package/dist/select-register.js.map +1 -1
  190. package/dist/select.js +1 -1
  191. package/dist/skeleton.js +1 -1
  192. package/dist/spacer.js +1 -1
  193. package/dist/split-button.js +1 -1
  194. package/dist/split-view.d.ts +7 -5
  195. package/dist/split-view.js +6 -3
  196. package/dist/split-view.js.map +1 -1
  197. package/dist/state-banner.d.ts +6 -1
  198. package/dist/state-banner.js +1 -1
  199. package/dist/styles/anchored-surface.css +27 -1
  200. package/dist/styles/catalog/components/catalog-example-stack.css +5 -0
  201. package/dist/styles/catalog/components/catalog-example.css +33 -0
  202. package/dist/styles/catalog/components/catalog-stage.css +7 -0
  203. package/dist/styles/chip.css +70 -0
  204. package/dist/styles/components/actions/popup-menu/popup-menu.css +21 -4
  205. package/dist/styles/components/actions/toolbar/toolbar.css +19 -0
  206. package/dist/styles/components/actions/toolbar-control-group/toolbar-control-group.css +75 -1
  207. package/dist/styles/components/actions/toolbar-text/toolbar-text.css +75 -0
  208. package/dist/styles/components/collections/list/list.css +77 -7
  209. package/dist/styles/components/collections/list-action-row/list-action-row.css +177 -22
  210. package/dist/styles/components/collections/list-item/list-item.css +158 -11
  211. package/dist/styles/components/feedback/anchored-surface/anchored-surface.css +27 -1
  212. package/dist/styles/components/feedback/chip/chip.css +70 -0
  213. package/dist/styles/components/feedback/state-banner/state-banner.css +24 -13
  214. package/dist/styles/components/forms/composer/composer.css +100 -0
  215. package/dist/styles/components/forms/select/select.css +1 -0
  216. package/dist/styles/components/forms/token-search-field/token-search-field.css +13 -2
  217. package/dist/styles/components/layout/pane/pane.css +81 -2
  218. package/dist/styles/components/navigation/nav-stack/nav-stack.css +84 -0
  219. package/dist/styles/components/navigation/tab-bar/tab-bar.css +15 -4
  220. package/dist/styles/components/navigation/tab-navigator/tab-navigator.css +79 -4
  221. package/dist/styles/components/surfaces/surface-scaffold/surface-scaffold.css +195 -0
  222. package/dist/styles/composer.css +100 -0
  223. package/dist/styles/foundation.css +66 -0
  224. package/dist/styles/list-action-row.css +177 -22
  225. package/dist/styles/list-item.css +158 -11
  226. package/dist/styles/list.css +77 -7
  227. package/dist/styles/nav-stack.css +84 -0
  228. package/dist/styles/pane.css +81 -2
  229. package/dist/styles/popup-menu.css +21 -4
  230. package/dist/styles/select.css +1 -0
  231. package/dist/styles/state-banner.css +24 -13
  232. package/dist/styles/styles.css +1 -0
  233. package/dist/styles/surface-scaffold.css +195 -0
  234. package/dist/styles/tab-bar.css +15 -4
  235. package/dist/styles/tab-navigator.css +79 -4
  236. package/dist/styles/token-search-field.css +13 -2
  237. package/dist/styles/toolbar-control-group.css +75 -1
  238. package/dist/styles/toolbar-text.css +75 -0
  239. package/dist/styles/toolbar.css +19 -0
  240. package/dist/styles/webawesome.css +18 -0
  241. package/dist/surface-scaffold-register.d.ts +6 -1
  242. package/dist/surface-scaffold-register.js +89 -3
  243. package/dist/surface-scaffold-register.js.map +1 -1
  244. package/dist/surface-scaffold.d.ts +66 -7
  245. package/dist/surface-scaffold.js +1 -1
  246. package/dist/tab-navigator.d.ts +23 -2
  247. package/dist/tab-navigator.js +2 -0
  248. package/dist/tab-navigator.js.map +1 -1
  249. package/dist/token-search-field.d.ts +1 -1
  250. package/dist/token-search-field.js +1 -1
  251. package/dist/{token-search-model-DTcTXWMS.d.ts → token-search-model-aYR0YAei.d.ts} +32 -2
  252. package/dist/token-search-model.d.ts +1 -1
  253. package/dist/toolbar-control-group.js +1 -1
  254. package/dist/toolbar-text.js +1 -1
  255. package/dist/toolbar.d.ts +1 -0
  256. package/dist/value-table.js +1 -1
  257. package/dist/wire-catalog.d.ts +3 -2
  258. package/dist/wire-catalog.js +2 -2
  259. package/dist/wire-composers.d.ts +16 -0
  260. package/dist/wire-composers.js +3 -0
  261. package/dist/wire-composers.js.map +1 -0
  262. package/dist/wire-list-focus-scroll.d.ts +16 -0
  263. package/dist/wire-list-focus-scroll.js +3 -0
  264. package/dist/wire-list-focus-scroll.js.map +1 -0
  265. package/dist/wire-nav-stack.js +135 -0
  266. package/dist/wire-nav-stack.js.map +1 -1
  267. package/dist/wire-scroll-dividers.d.ts +9 -0
  268. package/dist/wire-scroll-dividers.js +1 -1
  269. package/dist/wire-tab-bars.js +1 -1
  270. package/dist/wire-tab-navigator.d.ts +3 -1
  271. package/dist/wire-tab-navigator.js +133 -1
  272. package/dist/wire-tab-navigator.js.map +1 -1
  273. package/dist/wire-token-search-fields.d.ts +1 -1
  274. package/dist/wire-token-search-fields.js +1 -1
  275. package/dist/workbench.d.ts +8 -3
  276. package/dist/workbench.js +2 -1
  277. package/docs/accessibility.md +132 -3
  278. package/docs/anchored-surface.md +46 -4
  279. package/docs/app-layouts.md +23 -2
  280. package/docs/apple-hig.md +1 -0
  281. package/docs/catalog.md +61 -9
  282. package/docs/collapsible-panel.md +9 -6
  283. package/docs/component-contract.md +46 -13
  284. package/docs/component-selection.md +147 -20
  285. package/docs/composer.md +143 -0
  286. package/docs/design/templates/choice-chips/multiple-dark.svg +1 -0
  287. package/docs/design/templates/choice-chips/multiple.svg +1 -0
  288. package/docs/design/templates/choice-chips-dark.svg +1 -1
  289. package/docs/design/templates/choice-chips.svg +1 -1
  290. package/docs/design/templates/composer/chat-dark.svg +1 -0
  291. package/docs/design/templates/composer/chat.svg +1 -0
  292. package/docs/design/templates/composer/prompt-dark.svg +1 -0
  293. package/docs/design/templates/composer/prompt.svg +1 -0
  294. package/docs/design/templates/composer-dark.svg +1 -0
  295. package/docs/design/templates/composer.svg +1 -0
  296. package/docs/design/templates/empty-state/filtered-dark.svg +1 -1
  297. package/docs/design/templates/empty-state/filtered.svg +1 -1
  298. package/docs/design/templates/empty-state/with-action-dark.svg +1 -1
  299. package/docs/design/templates/empty-state/with-action.svg +1 -1
  300. package/docs/design/templates/empty-state-dark.svg +1 -1
  301. package/docs/design/templates/empty-state.svg +1 -1
  302. package/docs/design/templates/list/compact-dark.svg +1 -1
  303. package/docs/design/templates/list/compact.svg +1 -1
  304. package/docs/design/templates/list-action-row/default-dark.svg +1 -1
  305. package/docs/design/templates/list-action-row/default.svg +1 -1
  306. package/docs/design/templates/list-action-row/icon-tile-dark.svg +1 -0
  307. package/docs/design/templates/list-action-row/icon-tile.svg +1 -0
  308. package/docs/design/templates/list-action-row/selected-dark.svg +1 -1
  309. package/docs/design/templates/list-action-row/selected.svg +1 -1
  310. package/docs/design/templates/list-action-row/trailing-menu-dark.svg +1 -1
  311. package/docs/design/templates/list-action-row/trailing-menu.svg +1 -1
  312. package/docs/design/templates/list-action-row-dark.svg +1 -1
  313. package/docs/design/templates/list-action-row.svg +1 -1
  314. package/docs/design/templates/list-dark.svg +1 -1
  315. package/docs/design/templates/list-header/size-l-dark.svg +1 -1
  316. package/docs/design/templates/list-header/size-l.svg +1 -1
  317. package/docs/design/templates/list-header/size-m-dark.svg +1 -1
  318. package/docs/design/templates/list-header/size-m.svg +1 -1
  319. package/docs/design/templates/list-header/size-xl-dark.svg +1 -1
  320. package/docs/design/templates/list-header/size-xl.svg +1 -1
  321. package/docs/design/templates/list-header-dark.svg +1 -1
  322. package/docs/design/templates/list-header.svg +1 -1
  323. package/docs/design/templates/list-item/icon-tile-dark.svg +1 -0
  324. package/docs/design/templates/list-item/icon-tile.svg +1 -0
  325. package/docs/design/templates/list-item/selected-dark.svg +1 -1
  326. package/docs/design/templates/list-item/selected.svg +1 -1
  327. package/docs/design/templates/list-item-dark.svg +1 -1
  328. package/docs/design/templates/list-item.svg +1 -1
  329. package/docs/design/templates/list.svg +1 -1
  330. package/docs/design/templates/segmented-control-dark.svg +1 -1
  331. package/docs/design/templates/segmented-control.svg +1 -1
  332. package/docs/design/templates/skeleton-dark.svg +1 -1
  333. package/docs/design/templates/skeleton.svg +1 -1
  334. package/docs/design/templates/state-banner/danger-dark.svg +1 -1
  335. package/docs/design/templates/state-banner/danger.svg +1 -1
  336. package/docs/design/templates/state-banner/info-badge-dark.svg +1 -1
  337. package/docs/design/templates/state-banner/info-badge.svg +1 -1
  338. package/docs/design/templates/state-banner/info-dark.svg +1 -1
  339. package/docs/design/templates/state-banner/info.svg +1 -1
  340. package/docs/design/templates/state-banner/strip-dark.svg +1 -1
  341. package/docs/design/templates/state-banner/strip.svg +1 -1
  342. package/docs/design/templates/state-banner/success-dark.svg +1 -1
  343. package/docs/design/templates/state-banner/success.svg +1 -1
  344. package/docs/design/templates/state-banner/warning-dark.svg +1 -1
  345. package/docs/design/templates/state-banner/warning.svg +1 -1
  346. package/docs/design/templates/state-banner-dark.svg +1 -1
  347. package/docs/design/templates/state-banner.svg +1 -1
  348. package/docs/design/templates/tab-bar-dark.svg +1 -1
  349. package/docs/design/templates/tab-bar.svg +1 -1
  350. package/docs/design/templates/token-search-field-dark.svg +1 -1
  351. package/docs/design/templates/token-search-field.svg +1 -1
  352. package/docs/design/templates/toolbar-control-group-dark.svg +1 -1
  353. package/docs/design/templates/toolbar-control-group.svg +1 -1
  354. package/docs/design/templates/toolbar-dark.svg +1 -1
  355. package/docs/design/templates/toolbar-text/default-dark.svg +1 -1
  356. package/docs/design/templates/toolbar-text/default.svg +1 -1
  357. package/docs/design/templates/toolbar-text/large-dark.svg +1 -1
  358. package/docs/design/templates/toolbar-text/large.svg +1 -1
  359. package/docs/design/templates/toolbar-text-dark.svg +1 -1
  360. package/docs/design/templates/toolbar-text.svg +1 -1
  361. package/docs/design/templates/toolbar.svg +1 -1
  362. package/docs/design/templates/value-table/details-dark.svg +1 -1
  363. package/docs/design/templates/value-table/details.svg +1 -1
  364. package/docs/design/templates/value-table-dark.svg +1 -1
  365. package/docs/design/templates/value-table.svg +1 -1
  366. package/docs/design-philosophy.md +9 -1
  367. package/docs/examples/command-palette-adapter.tsx +3 -3
  368. package/docs/layout.md +147 -14
  369. package/docs/nav-stack.md +132 -8
  370. package/docs/recipes.md +9 -9
  371. package/docs/split-view.md +3 -3
  372. package/docs/sunken-panel.md +2 -2
  373. package/docs/surface-scaffold.md +138 -7
  374. package/docs/tab-navigator.md +38 -1
  375. package/docs/type-contracts.md +16 -16
  376. package/docs/ui-analyzer.md +3 -1
  377. package/docs/ui-doctor.md +71 -0
  378. package/docs/ux-demo.md +6 -6
  379. package/docs/webawesome-theme.md +7 -0
  380. package/docs/workbench.md +10 -6
  381. package/docs/writing.md +152 -0
  382. package/doctor/copy-capitalization-checks.mjs +591 -0
  383. package/doctor/index.mjs +17 -8
  384. package/llms.txt +105 -11
  385. package/package.json +15 -1
  386. package/ux-demo/recipes/app-shell.tsx +11 -11
  387. package/ux-demo/recipes/collapsible-sidebar.tsx +12 -11
  388. package/ux-demo/recipes/compact-toolbar.tsx +10 -10
  389. package/ux-demo/recipes/composer-form.tsx +8 -8
  390. package/ux-demo/recipes/list-detail-dialog.tsx +13 -13
  391. package/ux-demo/recipes/list-workspace-states.tsx +13 -13
  392. package/ux-demo/recipes/loading-inspector.tsx +10 -10
  393. package/ux-demo/recipes/navigation-sidebar.tsx +7 -7
  394. package/ux-demo/recipes/navigation-stack.tsx +5 -5
  395. package/ux-demo/recipes/workspace-header.tsx +5 -5
  396. package/dist/chunk-36TL6BCR.js.map +0 -1
  397. package/dist/chunk-4LOK4634.js +0 -21
  398. package/dist/chunk-4LOK4634.js.map +0 -1
  399. package/dist/chunk-6BRRUPJY.js.map +0 -1
  400. package/dist/chunk-6STQXRT4.js.map +0 -1
  401. package/dist/chunk-76PWEN5Y.js +0 -64
  402. package/dist/chunk-76PWEN5Y.js.map +0 -1
  403. package/dist/chunk-AYHC62OZ.js.map +0 -1
  404. package/dist/chunk-BU23Z5HZ.js.map +0 -1
  405. package/dist/chunk-DQDTZE4W.js +0 -70
  406. package/dist/chunk-DQDTZE4W.js.map +0 -1
  407. package/dist/chunk-FOQK4F3L.js.map +0 -1
  408. package/dist/chunk-GJYQ27C2.js.map +0 -1
  409. package/dist/chunk-JYD7G4RG.js.map +0 -1
  410. package/dist/chunk-KQDU7Z7P.js.map +0 -1
  411. package/dist/chunk-P74VXMB6.js.map +0 -1
  412. package/dist/chunk-PBT3CPPY.js.map +0 -1
  413. package/dist/chunk-PRG4CL3Q.js.map +0 -1
  414. package/dist/chunk-ROZLJULF.js.map +0 -1
  415. package/dist/chunk-U657IHFB.js.map +0 -1
  416. package/dist/chunk-V6W56V3N.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/components/navigation/nav-stack/wiring/wire-nav-stack.ts"],"names":[],"mappings":"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","file":"wire-nav-stack.js","sourcesContent":["import { delegate } from 'kerfjs';\n\nexport interface WireNavStackOptions {\n /** Invoked when the back control is activated. The app pops its own stack. */\n onBack?: () => void;\n /** Transition duration in ms (default 200). Set 0 to disable animation. */\n duration?: number;\n}\n\nconst DEFAULT_DURATION = 200;\nconst FOCUSABLE_SELECTOR = [\n 'a[href]',\n 'button:not([disabled])',\n 'input:not([disabled])',\n 'select:not([disabled])',\n 'textarea:not([disabled])',\n '[tabindex]:not([tabindex=\"-1\"])',\n].join(',');\n\nfunction viewsOf(viewport: Element): HTMLElement[] {\n return Array.from(\n viewport.querySelectorAll<HTMLElement>(':scope > .kui-nav-stack__view'),\n );\n}\n\nfunction topView(viewport: Element): HTMLElement | undefined {\n const live = viewsOf(viewport).filter(\n (view) => view.dataset.navExiting !== 'true',\n );\n return live[live.length - 1];\n}\n\nfunction reducedMotion(view: Window): boolean {\n return (\n typeof view.matchMedia === 'function' &&\n view.matchMedia('(prefers-reduced-motion: reduce)').matches\n );\n}\n\nfunction chromeOf(section: HTMLElement): HTMLElement[] {\n return Array.from(\n section.querySelectorAll<HTMLElement>(\n ':scope > [data-nav-stack-chrome]:not([data-nav-chrome-copy]), :scope > [data-nav-stack-bottom]:not([data-nav-chrome-copy])',\n ),\n );\n}\n\nfunction availableFocusTarget(\n element: Element | null | undefined,\n): element is HTMLElement {\n return (\n element instanceof HTMLElement &&\n element.isConnected &&\n !element.matches('[disabled], [aria-disabled=\"true\"]') &&\n !element.closest('[inert], [hidden], [aria-hidden=\"true\"]')\n );\n}\n\n/**\n * Animate a `NavStack`'s push/pop transitions and wire its back control. The app\n * owns the stack (a signal of `NavStackView[]`) and re-renders `NavStack` when it\n * changes; this helper slides the content and settles the chrome across each\n * change, moves focus into every new top view, restores that view's last focused\n * descendant on pop, and calls `onBack` when the back control is used. Mark a\n * preferred initial target with `data-nav-focus`; otherwise the first focusable\n * descendant (or the view itself) receives focus. Returns a disposer.\n */\nexport function wireNavStack(\n root: Element,\n options: WireNavStackOptions = {},\n): () => void {\n const section = root.matches('[data-component=\"nav-stack\"]')\n ? root\n : root.querySelector('[data-component=\"nav-stack\"]');\n const viewport = section?.querySelector('[data-nav-stack-viewport]');\n if (!(section instanceof HTMLElement) || !viewport) return () => {};\n\n const view = section.ownerDocument.defaultView ?? window;\n const duration = options.duration ?? DEFAULT_DURATION;\n const previousDuration = section.style.getPropertyValue(\n '--kui-nav-stack-transition-duration',\n );\n section.style.setProperty(\n '--kui-nav-stack-transition-duration',\n `${Math.max(0, duration)}ms`,\n );\n const disposeBack = delegate(section, 'click', '[data-nav-back]', () =>\n options.onBack?.(),\n );\n\n let activeKey = topView(viewport)?.dataset.navKey;\n const timers = new Set<number>();\n const frames = new Set<number>();\n const frame = (fn: () => void): void => {\n const id = view.requestAnimationFrame(() => {\n frames.delete(id);\n fn();\n });\n frames.add(id);\n };\n const finishTransition = (): void => {\n for (const id of frames) view.cancelAnimationFrame(id);\n frames.clear();\n for (const id of timers) view.clearTimeout(id);\n timers.clear();\n section\n .querySelectorAll<HTMLElement>(':scope > [data-nav-chrome-copy]')\n .forEach((element) => element.remove());\n chromeOf(section).forEach((element) =>\n element.classList.remove('kui-nav-stack__chrome--entering'),\n );\n viewsOf(viewport).forEach((element) => {\n if (element.dataset.navExiting === 'true') element.remove();\n else {\n element.classList.remove('kui-nav-stack__view--entering');\n delete element.dataset.navRevealed;\n }\n });\n delete section.dataset.navChromeTransition;\n };\n const rememberedFocus = new Map<string, HTMLElement>();\n const generatedFallbacks = new Map<HTMLElement, string | null>();\n let chromeSnapshots = chromeOf(section).map((element) =>\n element.cloneNode(true),\n ) as HTMLElement[];\n\n const settle = (fn: () => void): void => {\n if (duration <= 0 || reducedMotion(view)) {\n fn();\n return;\n }\n const timer = view.setTimeout(() => {\n timers.delete(timer);\n fn();\n }, duration);\n timers.add(timer);\n };\n\n const play = (el: HTMLElement, kind: 'entering' | 'exiting'): void => {\n const animated = duration > 0 && !reducedMotion(view);\n if (kind === 'entering') {\n // Push: start the incoming view off the trailing edge, then release it so\n // it slides to rest (translateX(100%) → 0).\n el.classList.add('kui-nav-stack__view--entering');\n if (animated) {\n // Force a reflow so the starting transform applies before we clear it.\n void el.offsetWidth;\n frame(() => el.classList.remove('kui-nav-stack__view--entering'));\n } else {\n el.classList.remove('kui-nav-stack__view--entering');\n }\n } else if (animated) {\n // Pop: the outgoing view is at rest; add the off-edge class on the next\n // frame so it slides OUT (translateX(0) → 100%), not in.\n frame(() => el.classList.add('kui-nav-stack__view--exiting'));\n } else {\n el.classList.add('kui-nav-stack__view--exiting');\n }\n };\n\n const rememberFocusedView = (target: Element | null): void => {\n if (!(target instanceof HTMLElement)) return;\n const owner = target.closest<HTMLElement>('.kui-nav-stack__view');\n const key = owner?.dataset.navKey;\n if (key && owner !== target && viewport.contains(owner))\n rememberedFocus.set(key, target);\n };\n\n const focusInto = (targetView: HTMLElement): void => {\n const key = targetView.dataset.navKey;\n const remembered = key ? rememberedFocus.get(key) : undefined;\n const preferred = Array.from(\n targetView.querySelectorAll<HTMLElement>('[data-nav-focus]'),\n ).find(availableFocusTarget);\n const first = Array.from(\n targetView.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR),\n ).find(availableFocusTarget);\n const target =\n (availableFocusTarget(remembered) && targetView.contains(remembered)\n ? remembered\n : undefined) ??\n preferred ??\n first;\n if (target) {\n target.focus({ preventScroll: true });\n return;\n }\n\n if (!generatedFallbacks.has(targetView)) {\n generatedFallbacks.set(\n targetView,\n targetView.hasAttribute('tabindex')\n ? targetView.getAttribute('tabindex')\n : null,\n );\n targetView.tabIndex = -1;\n }\n targetView.focus({ preventScroll: true });\n };\n\n const onFocusIn = (event: Event): void =>\n rememberFocusedView(event.target as Element | null);\n section.addEventListener('focusin', onFocusIn);\n rememberFocusedView(section.ownerDocument.activeElement);\n\n const crossFadeChrome = (): void => {\n const current = chromeOf(section);\n const animated = duration > 0 && !reducedMotion(view);\n if (!animated) {\n chromeSnapshots = current.map((element) =>\n element.cloneNode(true),\n ) as HTMLElement[];\n return;\n }\n\n section.dataset.navChromeTransition = 'true';\n const copies = chromeSnapshots.map((snapshot) => {\n const copy = snapshot.cloneNode(true) as HTMLElement;\n copy.classList.add('kui-nav-stack__chrome-copy');\n copy.dataset.navChromeCopy = '';\n copy.setAttribute('aria-hidden', 'true');\n copy.setAttribute('inert', '');\n if (copy.hasAttribute('data-nav-stack-bottom'))\n copy.classList.add('kui-nav-stack__chrome-copy--bottom');\n section.append(copy);\n return copy;\n });\n\n current.forEach((element) =>\n element.classList.add('kui-nav-stack__chrome--entering'),\n );\n void section.offsetWidth;\n frame(() => {\n current.forEach((element) =>\n element.classList.remove('kui-nav-stack__chrome--entering'),\n );\n copies.forEach((copy) =>\n copy.classList.add('kui-nav-stack__chrome-copy--exiting'),\n );\n });\n settle(() => {\n copies.forEach((copy) => copy.remove());\n delete section.dataset.navChromeTransition;\n });\n chromeSnapshots = current.map((element) => {\n const snapshot = element.cloneNode(true) as HTMLElement;\n snapshot.classList.remove('kui-nav-stack__chrome--entering');\n return snapshot;\n });\n };\n\n const observer = new MutationObserver((records) => {\n const removed: HTMLElement[] = [];\n for (const record of records) {\n if (record.target !== viewport) continue;\n record.removedNodes.forEach((node) => {\n if (\n node instanceof HTMLElement &&\n node.classList.contains('kui-nav-stack__view') &&\n node.dataset.navExiting !== 'true'\n )\n removed.push(node);\n });\n }\n\n const top = topView(viewport);\n const currentKey = top?.dataset.navKey;\n const poppedTop = removed.find((node) => node.dataset.navKey === activeKey);\n\n if (poppedTop && currentKey !== activeKey) {\n finishTransition();\n // Pop: bring the removed node back briefly to slide it out over the revealed view.\n poppedTop.classList.remove(\n 'kui-nav-stack__view--entering',\n 'kui-nav-stack__view--exiting',\n );\n poppedTop.dataset.navExiting = 'true';\n poppedTop.setAttribute('aria-hidden', 'true');\n viewport.append(poppedTop);\n void poppedTop.offsetWidth;\n play(poppedTop, 'exiting');\n crossFadeChrome();\n if (top) focusInto(top);\n settle(() => poppedTop.remove());\n } else if (currentKey !== activeKey && top) {\n finishTransition();\n const previous = viewsOf(viewport).find(\n (element) => element.dataset.navKey === activeKey,\n );\n if (previous) {\n previous.dataset.navRevealed = 'true';\n settle(() => delete previous.dataset.navRevealed);\n }\n // Push: slide the new top in.\n rememberFocusedView(section.ownerDocument.activeElement);\n play(top, 'entering');\n crossFadeChrome();\n focusInto(top);\n }\n\n activeKey = currentKey;\n });\n observer.observe(viewport, {\n childList: true,\n subtree: true,\n attributes: true,\n attributeFilter: ['data-nav-key', 'data-nav-active'],\n });\n\n return () => {\n disposeBack();\n section.removeEventListener('focusin', onFocusIn);\n observer.disconnect();\n finishTransition();\n for (const [element, previousTabIndex] of generatedFallbacks) {\n if (!element.isConnected || element.tabIndex !== -1) continue;\n if (previousTabIndex === null) element.removeAttribute('tabindex');\n else element.setAttribute('tabindex', previousTabIndex);\n }\n generatedFallbacks.clear();\n rememberedFocus.clear();\n if (previousDuration)\n section.style.setProperty(\n '--kui-nav-stack-transition-duration',\n previousDuration,\n );\n else section.style.removeProperty('--kui-nav-stack-transition-duration');\n };\n}\n"]}
1
+ {"version":3,"sources":["../src/components/navigation/nav-stack/wiring/wire-nav-stack.ts"],"names":[],"mappings":"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","file":"wire-nav-stack.js","sourcesContent":["import { delegate } from 'kerfjs';\n\nexport interface WireNavStackOptions {\n /** Invoked when the back control is activated. The app pops its own stack. */\n onBack?: () => void;\n /** Transition duration in ms (default 200). Set 0 to disable animation. */\n duration?: number;\n}\n\nconst DEFAULT_DURATION = 200;\n/** On an overlay-chrome NavStack: the wiring has measured its live chrome. */\nconst CHROME_OVERLAY = 'data-chrome-overlay';\n/** On an overlay-bottom-toolbar NavStack: the wiring has measured it. */\nconst BOTTOM_TOOLBAR_OVERLAY = 'data-bottom-toolbar-overlay';\n/**\n * One overlay-capable chrome edge of a NavStack: the top chrome\n * (`chromePresentation`) or the bottom toolbar (`bottomToolbarPresentation`).\n * Each names the root attribute that opts it in, its live element (never a\n * cross-fading copy), the border-box block size the wiring publishes on the\n * root once it has measured that element (beside its gate), the root\n * property for the classic scrollbar inline size it leaves uncovered, and\n * the sole-Pane slot that, when present, keeps the Pane's scroller clear of\n * it.\n */\ninterface OverlayEdge {\n readonly presentation: string;\n readonly element: string;\n readonly blockSize: string;\n readonly scrollbarInlineSize: string;\n readonly paneChrome: string;\n}\n\nconst OVERLAY_EDGES: readonly OverlayEdge[] = [\n {\n presentation: 'data-chrome-presentation',\n element: ':scope > [data-nav-stack-chrome]:not([data-nav-chrome-copy])',\n blockSize: '--_kui-nav-stack-chrome-block-size',\n scrollbarInlineSize: '--_kui-nav-stack-scrollbar-inline-size',\n // A Pane header lies beneath the chrome and starts its content below it.\n paneChrome: ':scope > :is(.kui-pane__header, .kui-pane__toolbar)',\n },\n {\n presentation: 'data-bottom-toolbar-presentation',\n element: ':scope > [data-nav-stack-bottom]:not([data-nav-chrome-copy])',\n blockSize: '--_kui-nav-stack-bottom-block-size',\n scrollbarInlineSize: '--_kui-nav-stack-bottom-scrollbar-inline-size',\n // A Pane footer lies beneath the toolbar and ends its content above it.\n paneChrome: ':scope > .kui-pane__footer',\n },\n];\n/** A layout that, as a view's only child, owns its own chrome and scroller. */\nconst NESTED_LAYOUT = ['nav-stack', 'split-view', 'workbench', 'tab-scaffold']\n .map((name) => `[data-component=\"${name}\"]`)\n .join(', ');\nconst FOCUSABLE_SELECTOR = [\n 'a[href]',\n 'button:not([disabled])',\n 'input:not([disabled])',\n 'select:not([disabled])',\n 'textarea:not([disabled])',\n '[tabindex]:not([tabindex=\"-1\"])',\n].join(',');\n\nfunction viewsOf(viewport: Element): HTMLElement[] {\n return Array.from(\n viewport.querySelectorAll<HTMLElement>(':scope > .kui-nav-stack__view'),\n );\n}\n\nfunction topView(viewport: Element): HTMLElement | undefined {\n const live = viewsOf(viewport).filter(\n (view) => view.dataset.navExiting !== 'true',\n );\n return live[live.length - 1];\n}\n\nfunction reducedMotion(view: Window): boolean {\n return (\n typeof view.matchMedia === 'function' &&\n view.matchMedia('(prefers-reduced-motion: reduce)').matches\n );\n}\n\nfunction chromeOf(section: HTMLElement): HTMLElement[] {\n return Array.from(\n section.querySelectorAll<HTMLElement>(\n ':scope > [data-nav-stack-chrome]:not([data-nav-chrome-copy]), :scope > [data-nav-stack-bottom]:not([data-nav-chrome-copy])',\n ),\n );\n}\n\nfunction availableFocusTarget(\n element: Element | null | undefined,\n): element is HTMLElement {\n return (\n element instanceof HTMLElement &&\n element.isConnected &&\n !element.matches('[disabled], [aria-disabled=\"true\"]') &&\n !element.closest('[inert], [hidden], [aria-hidden=\"true\"]')\n );\n}\n\n/**\n * Animate a `NavStack`'s push/pop transitions and wire its back control. The app\n * owns the stack (a signal of `NavStackView[]`) and re-renders `NavStack` when it\n * changes; this helper slides the content and settles the chrome across each\n * change, moves focus into every new top view, restores that view's last focused\n * descendant on pop, and calls `onBack` when the back control is used. Mark a\n * preferred initial target with `data-nav-focus`; otherwise the first focusable\n * descendant (or the view itself) receives focus. Returns a disposer.\n */\nexport function wireNavStack(\n root: Element,\n options: WireNavStackOptions = {},\n): () => void {\n const section = root.matches('[data-component=\"nav-stack\"]')\n ? root\n : root.querySelector('[data-component=\"nav-stack\"]');\n const viewport = section?.querySelector('[data-nav-stack-viewport]');\n if (!(section instanceof HTMLElement) || !viewport) return () => {};\n\n const view = section.ownerDocument.defaultView ?? window;\n const duration = options.duration ?? DEFAULT_DURATION;\n const previousDuration = section.style.getPropertyValue(\n '--kui-nav-stack-transition-duration',\n );\n section.style.setProperty(\n '--kui-nav-stack-transition-duration',\n `${Math.max(0, duration)}ms`,\n );\n const disposeBack = delegate(section, 'click', '[data-nav-back]', () =>\n options.onBack?.(),\n );\n\n let activeKey = topView(viewport)?.dataset.navKey;\n const timers = new Set<number>();\n const frames = new Set<number>();\n const frame = (fn: () => void): void => {\n const id = view.requestAnimationFrame(() => {\n frames.delete(id);\n fn();\n });\n frames.add(id);\n };\n const finishTransition = (): void => {\n for (const id of frames) view.cancelAnimationFrame(id);\n frames.clear();\n for (const id of timers) view.clearTimeout(id);\n timers.clear();\n section\n .querySelectorAll<HTMLElement>(':scope > [data-nav-chrome-copy]')\n .forEach((element) => element.remove());\n chromeOf(section).forEach((element) =>\n element.classList.remove('kui-nav-stack__chrome--entering'),\n );\n viewsOf(viewport).forEach((element) => {\n if (element.dataset.navExiting === 'true') element.remove();\n else {\n element.classList.remove('kui-nav-stack__view--entering');\n delete element.dataset.navRevealed;\n }\n });\n delete section.dataset.navChromeTransition;\n };\n const rememberedFocus = new Map<string, HTMLElement>();\n const generatedFallbacks = new Map<HTMLElement, string | null>();\n let chromeSnapshots = chromeOf(section).map((element) =>\n element.cloneNode(true),\n ) as HTMLElement[];\n\n const settle = (fn: () => void): void => {\n if (duration <= 0 || reducedMotion(view)) {\n fn();\n return;\n }\n const timer = view.setTimeout(() => {\n timers.delete(timer);\n fn();\n }, duration);\n timers.add(timer);\n };\n\n const play = (el: HTMLElement, kind: 'entering' | 'exiting'): void => {\n const animated = duration > 0 && !reducedMotion(view);\n if (kind === 'entering') {\n // Push: start the incoming view off the trailing edge, then release it so\n // it slides to rest (translateX(100%) → 0).\n el.classList.add('kui-nav-stack__view--entering');\n if (animated) {\n // Force a reflow so the starting transform applies before we clear it.\n void el.offsetWidth;\n frame(() => el.classList.remove('kui-nav-stack__view--entering'));\n } else {\n el.classList.remove('kui-nav-stack__view--entering');\n }\n } else if (animated) {\n // Pop: the outgoing view is at rest; add the off-edge class on the next\n // frame so it slides OUT (translateX(0) → 100%), not in.\n frame(() => el.classList.add('kui-nav-stack__view--exiting'));\n } else {\n el.classList.add('kui-nav-stack__view--exiting');\n }\n };\n\n const rememberFocusedView = (target: Element | null): void => {\n if (!(target instanceof HTMLElement)) return;\n const owner = target.closest<HTMLElement>('.kui-nav-stack__view');\n const key = owner?.dataset.navKey;\n if (key && owner !== target && viewport.contains(owner))\n rememberedFocus.set(key, target);\n };\n\n const focusInto = (targetView: HTMLElement): void => {\n const key = targetView.dataset.navKey;\n const remembered = key ? rememberedFocus.get(key) : undefined;\n const preferred = Array.from(\n targetView.querySelectorAll<HTMLElement>('[data-nav-focus]'),\n ).find(availableFocusTarget);\n const first = Array.from(\n targetView.querySelectorAll<HTMLElement>(FOCUSABLE_SELECTOR),\n ).find(availableFocusTarget);\n const target =\n (availableFocusTarget(remembered) && targetView.contains(remembered)\n ? remembered\n : undefined) ??\n preferred ??\n first;\n if (target) {\n target.focus({ preventScroll: true });\n return;\n }\n\n if (!generatedFallbacks.has(targetView)) {\n generatedFallbacks.set(\n targetView,\n targetView.hasAttribute('tabindex')\n ? targetView.getAttribute('tabindex')\n : null,\n );\n targetView.tabIndex = -1;\n }\n targetView.focus({ preventScroll: true });\n };\n\n // Overlay chrome (`chromePresentation=\"overlay\"` for the top chrome,\n // `bottomToolbarPresentation=\"overlay\"` for the bottom toolbar): measure\n // each live edge element, never a cross-fading copy, and publish its\n // border-box block size with the gate that lays it over the viewport. The\n // size follows the element as it wraps, zooms, or changes with the active\n // view, and a re-render that strips the published state gets it back\n // before paint. The active view's classic (space-taking) vertical\n // scrollbar is measured too, so each overlaid edge ends where its track\n // begins.\n interface EdgeState {\n element?: HTMLElement;\n size?: number;\n /** The active scroller's track lies beneath this edge. */\n covers: boolean;\n }\n const edges = OVERLAY_EDGES.map((edge): [OverlayEdge, EdgeState] => [\n edge,\n { covers: false },\n ]);\n const measuredEdge = (state: EdgeState): boolean =>\n state.element !== undefined && state.size !== undefined;\n let measuredScroller: HTMLElement | undefined;\n let scrollbarSize = 0;\n const writeProperty = (name: string, value: string): void => {\n if (section.style.getPropertyValue(name) === value) return;\n if (value) section.style.setProperty(name, value);\n else section.style.removeProperty(name);\n };\n const publishOverlay = (): void => {\n for (const [edge, state] of edges) {\n const measured = measuredEdge(state);\n writeProperty(edge.blockSize, measured ? `${state.size}px` : '');\n writeProperty(\n edge.scrollbarInlineSize,\n measured && state.covers && scrollbarSize > 0\n ? `${scrollbarSize}px`\n : '',\n );\n }\n if (section.getAttribute('style') === '') section.removeAttribute('style');\n // Each gate changes only when it must, so the root observer settles.\n const [top, bottom] = edges.map(([, state]) => measuredEdge(state));\n if (top && section.getAttribute(CHROME_OVERLAY) !== 'measured')\n section.setAttribute(CHROME_OVERLAY, 'measured');\n else if (!top && section.hasAttribute(CHROME_OVERLAY))\n section.removeAttribute(CHROME_OVERLAY);\n if (bottom && section.getAttribute(BOTTOM_TOOLBAR_OVERLAY) !== 'measured')\n section.setAttribute(BOTTOM_TOOLBAR_OVERLAY, 'measured');\n else if (!bottom && section.hasAttribute(BOTTOM_TOOLBAR_OVERLAY))\n section.removeAttribute(BOTTOM_TOOLBAR_OVERLAY);\n };\n /**\n * The element that scrolls beneath the overlaid edges in the active view\n * (the view itself, or a sole Pane's content), and that sole Pane, whose\n * own header or footer keeps its scroller clear of the matching edge.\n */\n const activeScroller = (): { scroller?: HTMLElement; pane?: Element } => {\n const top = topView(viewport);\n const only = top?.children.length === 1 ? top.children[0] : undefined;\n if (!only) return { scroller: top };\n if (only.matches('.kui-pane'))\n return {\n scroller:\n only.querySelector<HTMLElement>(':scope > .kui-pane__content') ??\n undefined,\n pane: only,\n };\n return { scroller: only.matches(NESTED_LAYOUT) ? undefined : top };\n };\n const measureScrollbar = (): void => {\n const scroller = measuredScroller;\n if (!scroller) {\n scrollbarSize = 0;\n return;\n }\n const style = view.getComputedStyle(scroller);\n scrollbarSize = Math.max(\n 0,\n scroller.offsetWidth -\n scroller.clientWidth -\n (Number.parseFloat(style.borderLeftWidth) || 0) -\n (Number.parseFloat(style.borderRightWidth) || 0),\n );\n };\n const chromeObserver = view.ResizeObserver\n ? new view.ResizeObserver((entries) => {\n for (const entry of entries) {\n const state = edges.find(\n ([, edgeState]) => edgeState.element === entry.target,\n )?.[1];\n if (state)\n state.size =\n entry.borderBoxSize?.[0]?.blockSize ??\n entry.target.getBoundingClientRect().height;\n else if (entry.target === measuredScroller) measureScrollbar();\n }\n publishOverlay();\n })\n : undefined;\n const syncOverlay = (): void => {\n for (const [edge, state] of edges) {\n const element =\n section.getAttribute(edge.presentation) === 'overlay'\n ? (section.querySelector<HTMLElement>(edge.element) ?? undefined)\n : undefined;\n if (element === state.element) continue;\n if (state.element) chromeObserver?.unobserve(state.element);\n state.element = element;\n if (!element) state.size = undefined;\n else {\n // A replacement keeps the last size until the observer reports it\n // after layout; a first one (or one with no observer to report it)\n // is measured at once.\n if (state.size === undefined || !chromeObserver)\n state.size = element.getBoundingClientRect().height;\n // The border box: a forced-colors edge changes no content box.\n chromeObserver?.observe(element, { box: 'border-box' });\n }\n }\n // A scrollbar appearing or leaving resizes the scroller's content box.\n const { scroller, pane } = activeScroller();\n for (const [edge, state] of edges)\n state.covers =\n state.element !== undefined &&\n scroller !== undefined &&\n !pane?.querySelector(edge.paneChrome);\n const covered = edges.some(([, state]) => state.covers)\n ? scroller\n : undefined;\n if (covered !== measuredScroller) {\n if (measuredScroller) chromeObserver?.unobserve(measuredScroller);\n measuredScroller = covered;\n measureScrollbar();\n if (measuredScroller) chromeObserver?.observe(measuredScroller);\n }\n publishOverlay();\n };\n const overlayObserver = new MutationObserver(syncOverlay);\n overlayObserver.observe(section, {\n childList: true,\n attributes: true,\n attributeFilter: [\n ...OVERLAY_EDGES.map((edge) => edge.presentation),\n CHROME_OVERLAY,\n BOTTOM_TOOLBAR_OVERLAY,\n 'style',\n ],\n });\n syncOverlay();\n\n const onFocusIn = (event: Event): void =>\n rememberFocusedView(event.target as Element | null);\n section.addEventListener('focusin', onFocusIn);\n rememberFocusedView(section.ownerDocument.activeElement);\n\n const crossFadeChrome = (): void => {\n const current = chromeOf(section);\n const animated = duration > 0 && !reducedMotion(view);\n if (!animated) {\n chromeSnapshots = current.map((element) =>\n element.cloneNode(true),\n ) as HTMLElement[];\n return;\n }\n\n section.dataset.navChromeTransition = 'true';\n const copies = chromeSnapshots.map((snapshot) => {\n const copy = snapshot.cloneNode(true) as HTMLElement;\n copy.classList.add('kui-nav-stack__chrome-copy');\n copy.dataset.navChromeCopy = '';\n copy.setAttribute('aria-hidden', 'true');\n copy.setAttribute('inert', '');\n if (copy.hasAttribute('data-nav-stack-bottom'))\n copy.classList.add('kui-nav-stack__chrome-copy--bottom');\n section.append(copy);\n return copy;\n });\n\n current.forEach((element) =>\n element.classList.add('kui-nav-stack__chrome--entering'),\n );\n void section.offsetWidth;\n frame(() => {\n current.forEach((element) =>\n element.classList.remove('kui-nav-stack__chrome--entering'),\n );\n copies.forEach((copy) =>\n copy.classList.add('kui-nav-stack__chrome-copy--exiting'),\n );\n });\n settle(() => {\n copies.forEach((copy) => copy.remove());\n delete section.dataset.navChromeTransition;\n });\n chromeSnapshots = current.map((element) => {\n const snapshot = element.cloneNode(true) as HTMLElement;\n snapshot.classList.remove('kui-nav-stack__chrome--entering');\n return snapshot;\n });\n };\n\n const observer = new MutationObserver((records) => {\n const removed: HTMLElement[] = [];\n for (const record of records) {\n if (record.target !== viewport) continue;\n record.removedNodes.forEach((node) => {\n if (\n node instanceof HTMLElement &&\n node.classList.contains('kui-nav-stack__view') &&\n node.dataset.navExiting !== 'true'\n )\n removed.push(node);\n });\n }\n\n const top = topView(viewport);\n const currentKey = top?.dataset.navKey;\n const poppedTop = removed.find((node) => node.dataset.navKey === activeKey);\n\n if (poppedTop && currentKey !== activeKey) {\n finishTransition();\n // Pop: bring the removed node back briefly to slide it out over the revealed view.\n poppedTop.classList.remove(\n 'kui-nav-stack__view--entering',\n 'kui-nav-stack__view--exiting',\n );\n poppedTop.dataset.navExiting = 'true';\n poppedTop.setAttribute('aria-hidden', 'true');\n viewport.append(poppedTop);\n void poppedTop.offsetWidth;\n play(poppedTop, 'exiting');\n crossFadeChrome();\n if (top) focusInto(top);\n settle(() => poppedTop.remove());\n } else if (currentKey !== activeKey && top) {\n finishTransition();\n const previous = viewsOf(viewport).find(\n (element) => element.dataset.navKey === activeKey,\n );\n if (previous) {\n previous.dataset.navRevealed = 'true';\n settle(() => delete previous.dataset.navRevealed);\n }\n // Push: slide the new top in.\n rememberFocusedView(section.ownerDocument.activeElement);\n play(top, 'entering');\n crossFadeChrome();\n focusInto(top);\n }\n\n activeKey = currentKey;\n // The active view, and so the scroller beneath the chrome, may change.\n syncOverlay();\n });\n observer.observe(viewport, {\n childList: true,\n subtree: true,\n attributes: true,\n attributeFilter: ['data-nav-key', 'data-nav-active'],\n });\n\n return () => {\n disposeBack();\n section.removeEventListener('focusin', onFocusIn);\n observer.disconnect();\n overlayObserver.disconnect();\n chromeObserver?.disconnect();\n for (const [, state] of edges) {\n state.element = undefined;\n state.size = undefined;\n state.covers = false;\n }\n measuredScroller = undefined;\n scrollbarSize = 0;\n publishOverlay();\n finishTransition();\n for (const [element, previousTabIndex] of generatedFallbacks) {\n if (!element.isConnected || element.tabIndex !== -1) continue;\n if (previousTabIndex === null) element.removeAttribute('tabindex');\n else element.setAttribute('tabindex', previousTabIndex);\n }\n generatedFallbacks.clear();\n rememberedFocus.clear();\n if (previousDuration)\n section.style.setProperty(\n '--kui-nav-stack-transition-duration',\n previousDuration,\n );\n else section.style.removeProperty('--kui-nav-stack-transition-duration');\n };\n}\n"]}
@@ -59,6 +59,15 @@ type Root = HTMLElement | Document;
59
59
  * - each app-owned `targets` pairing: a `Toolbar` or `List` named as chrome
60
60
  * draws the divider on its facing side.
61
61
  *
62
+ * It also measures every `Pane` header laid over its content
63
+ * (`headerPresentation="overlay"`, with fixed chrome placement): it publishes
64
+ * the header's border-box block size on the Pane root as the inherited
65
+ * `--kui-scroll-clearance-block-start` context, and marks the root
66
+ * `data-header-overlay="measured"`, which moves the header over the content
67
+ * and has the content clear it. The measurement follows the header as it
68
+ * wraps, zooms, or changes content, and both are restored before paint if a
69
+ * re-render drops them.
70
+ *
62
71
  * Structure is re-read after every DOM change below root that can change a
63
72
  * pairing — a structural element or target id added, removed, or re-classed;
64
73
  * mutations inside scrolled content (a row's class, a list's rows) do not
@@ -1,3 +1,3 @@
1
- export { wireScrollDividers } from './chunk-6STQXRT4.js';
1
+ export { wireScrollDividers } from './chunk-CXZXHZTR.js';
2
2
 
3
3
  //# sourceMappingURL=wire-scroll-dividers.js.map
@@ -1,3 +1,3 @@
1
- export { reorderTabs, wireTabBars } from './chunk-KQDU7Z7P.js';
1
+ export { reorderTabs, wireTabBars } from './chunk-K4AT3V3J.js';
2
2
 
3
3
  //# sourceMappingURL=wire-tab-bars.js.map
@@ -4,7 +4,9 @@ interface WireTabNavigatorOptions {
4
4
  }
5
5
  /**
6
6
  * Wire a `TabNavigator`'s bottom tab bar: clicking a tab calls `onSelect` with its
7
- * id (the app then updates its controlled `active`). Returns a disposer.
7
+ * id (the app then updates its controlled `active`). With
8
+ * `barPresentation="overlay"` it also measures the live bar and lays it over
9
+ * the scenes (see `TabNavigatorProps.barPresentation`). Returns a disposer.
8
10
  */
9
11
  declare function wireTabNavigator(root: Element, options: WireTabNavigatorOptions): () => void;
10
12
 
@@ -1,11 +1,138 @@
1
1
  import { delegate } from 'kerfjs';
2
2
 
3
3
  // src/components/navigation/tab-navigator/wiring/wire-tab-navigator.ts
4
+ var BAR_OVERLAY = "data-bar-overlay";
5
+ var BAR_BLOCK_SIZE = "--_kui-tab-scaffold-bar-block-size";
6
+ var BAR_SCROLLBAR_INLINE_SIZE = "--_kui-tab-scaffold-bar-scrollbar-inline-size";
7
+ var NESTED_LAYOUT = ["nav-stack", "split-view", "workbench", "tab-scaffold"].map((name) => `[data-component="${name}"]`).join(", ");
8
+ function paneScroller(pane) {
9
+ if (pane.querySelector(":scope > .kui-pane__footer")) return void 0;
10
+ return pane.querySelector(":scope > .kui-pane__content") ?? void 0;
11
+ }
12
+ function activeScroller(section) {
13
+ const scene = section.querySelector(
14
+ ':scope > .kui-tab-scaffold__scenes > .kui-tab-scaffold__scene[data-active="true"]'
15
+ );
16
+ if (!scene) return void 0;
17
+ const only = scene.children.length === 1 ? scene.children[0] : void 0;
18
+ if (!only?.matches(`[data-component="pane"], ${NESTED_LAYOUT}`)) return scene;
19
+ if (only.matches('[data-component="pane"]')) return paneScroller(only);
20
+ if (!only.matches('[data-component="nav-stack"]')) return void 0;
21
+ if (only.querySelector(":scope > [data-nav-stack-bottom]") && only.getAttribute("data-bottom-toolbar-presentation") !== "overlay")
22
+ return void 0;
23
+ const views = [
24
+ ...only.querySelectorAll(
25
+ ':scope > [data-nav-stack-viewport] > [data-nav-active="true"]:not([data-nav-exiting="true"])'
26
+ )
27
+ ];
28
+ const view = views.at(-1);
29
+ if (!view) return void 0;
30
+ const child = view.children.length === 1 ? view.children[0] : void 0;
31
+ if (child?.matches('[data-component="pane"]')) return paneScroller(child);
32
+ return child?.matches(NESTED_LAYOUT) ? void 0 : view;
33
+ }
34
+ function wireBarOverlay(section) {
35
+ const view = section.ownerDocument.defaultView ?? window;
36
+ let bar;
37
+ let size;
38
+ let scroller;
39
+ let scrollbarSize = 0;
40
+ const writeProperty = (name, value) => {
41
+ if (section.style.getPropertyValue(name) === value) return;
42
+ if (value) section.style.setProperty(name, value);
43
+ else section.style.removeProperty(name);
44
+ };
45
+ const publish = () => {
46
+ const measured = bar !== void 0 && size !== void 0;
47
+ writeProperty(BAR_BLOCK_SIZE, measured ? `${size}px` : "");
48
+ writeProperty(
49
+ BAR_SCROLLBAR_INLINE_SIZE,
50
+ measured && scrollbarSize > 0 ? `${scrollbarSize}px` : ""
51
+ );
52
+ if (section.getAttribute("style") === "") section.removeAttribute("style");
53
+ if (measured && section.getAttribute(BAR_OVERLAY) !== "measured")
54
+ section.setAttribute(BAR_OVERLAY, "measured");
55
+ else if (!measured && section.hasAttribute(BAR_OVERLAY))
56
+ section.removeAttribute(BAR_OVERLAY);
57
+ };
58
+ const measureScrollbar = () => {
59
+ if (!scroller) {
60
+ scrollbarSize = 0;
61
+ return;
62
+ }
63
+ const style = view.getComputedStyle(scroller);
64
+ scrollbarSize = Math.max(
65
+ 0,
66
+ scroller.offsetWidth - scroller.clientWidth - (Number.parseFloat(style.borderLeftWidth) || 0) - (Number.parseFloat(style.borderRightWidth) || 0)
67
+ );
68
+ };
69
+ const resizeObserver = view.ResizeObserver ? new view.ResizeObserver((entries) => {
70
+ for (const entry of entries)
71
+ if (entry.target === bar)
72
+ size = entry.borderBoxSize?.[0]?.blockSize ?? entry.target.getBoundingClientRect().height;
73
+ else if (entry.target === scroller) measureScrollbar();
74
+ publish();
75
+ }) : void 0;
76
+ const sync = () => {
77
+ const next = section.getAttribute("data-bar-presentation") === "overlay" ? section.querySelector(
78
+ ":scope > .kui-tab-scaffold__bar"
79
+ ) ?? void 0 : void 0;
80
+ if (next !== bar) {
81
+ if (bar) resizeObserver?.unobserve(bar);
82
+ bar = next;
83
+ if (!bar) size = void 0;
84
+ else {
85
+ if (size === void 0 || !resizeObserver)
86
+ size = bar.getBoundingClientRect().height;
87
+ resizeObserver?.observe(bar, { box: "border-box" });
88
+ }
89
+ }
90
+ const covered = bar ? activeScroller(section) : void 0;
91
+ if (covered !== scroller) {
92
+ if (scroller) resizeObserver?.unobserve(scroller);
93
+ scroller = covered;
94
+ measureScrollbar();
95
+ if (scroller) resizeObserver?.observe(scroller);
96
+ }
97
+ publish();
98
+ };
99
+ const mutationObserver = new MutationObserver(sync);
100
+ mutationObserver.observe(section, {
101
+ childList: true,
102
+ attributes: true,
103
+ attributeFilter: ["data-bar-presentation", BAR_OVERLAY, "style"]
104
+ });
105
+ const sceneObserver = new MutationObserver(sync);
106
+ const scenes = section.querySelector(":scope > .kui-tab-scaffold__scenes");
107
+ if (scenes)
108
+ sceneObserver.observe(scenes, {
109
+ childList: true,
110
+ subtree: true,
111
+ attributes: true,
112
+ attributeFilter: [
113
+ "data-active",
114
+ "data-nav-active",
115
+ "data-nav-exiting",
116
+ "data-bottom-toolbar-presentation"
117
+ ]
118
+ });
119
+ sync();
120
+ return () => {
121
+ mutationObserver.disconnect();
122
+ sceneObserver.disconnect();
123
+ resizeObserver?.disconnect();
124
+ bar = void 0;
125
+ size = void 0;
126
+ scroller = void 0;
127
+ scrollbarSize = 0;
128
+ publish();
129
+ };
130
+ }
4
131
  function wireTabNavigator(root, options) {
5
132
  const section = root.matches('[data-component="tab-scaffold"]') ? root : root.querySelector('[data-component="tab-scaffold"]');
6
133
  if (!(section instanceof HTMLElement)) return () => {
7
134
  };
8
- return delegate(
135
+ const stopClicks = delegate(
9
136
  section,
10
137
  "click",
11
138
  "[data-tab-scaffold-tab]",
@@ -14,6 +141,11 @@ function wireTabNavigator(root, options) {
14
141
  if (tabId) options.onSelect(tabId);
15
142
  }
16
143
  );
144
+ const stopOverlay = wireBarOverlay(section);
145
+ return () => {
146
+ stopClicks();
147
+ stopOverlay();
148
+ };
17
149
  }
18
150
 
19
151
  export { wireTabNavigator };
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/components/navigation/tab-navigator/wiring/wire-tab-navigator.ts"],"names":[],"mappings":";;;AAWO,SAAS,gBAAA,CACd,MACA,OAAA,EACY;AACZ,EAAA,MAAM,OAAA,GAAU,KAAK,OAAA,CAAQ,iCAAiC,IAC1D,IAAA,GACA,IAAA,CAAK,cAAc,iCAAiC,CAAA;AACxD,EAAA,IAAI,EAAE,OAAA,YAAmB,WAAA,CAAA,EAAc,OAAO,MAAM;AAAA,EAAC,CAAA;AACrD,EAAA,OAAO,QAAA;AAAA,IACL,OAAA;AAAA,IACA,OAAA;AAAA,IACA,yBAAA;AAAA,IACA,CAAC,QAAQ,MAAA,KAAW;AAClB,MAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,YAAA,CAAa,uBAAuB,CAAA;AACzD,MAAA,IAAI,KAAA,EAAO,OAAA,CAAQ,QAAA,CAAS,KAAK,CAAA;AAAA,IACnC;AAAA,GACF;AACF","file":"wire-tab-navigator.js","sourcesContent":["import { delegate } from 'kerfjs';\n\nexport interface WireTabNavigatorOptions {\n /** Invoked with the selected tab id when a bottom-bar tab is activated. */\n onSelect: (tabId: string) => void;\n}\n\n/**\n * Wire a `TabNavigator`'s bottom tab bar: clicking a tab calls `onSelect` with its\n * id (the app then updates its controlled `active`). Returns a disposer.\n */\nexport function wireTabNavigator(\n root: Element,\n options: WireTabNavigatorOptions,\n): () => void {\n const section = root.matches('[data-component=\"tab-scaffold\"]')\n ? root\n : root.querySelector('[data-component=\"tab-scaffold\"]');\n if (!(section instanceof HTMLElement)) return () => {};\n return delegate(\n section,\n 'click',\n '[data-tab-scaffold-tab]',\n (_event, target) => {\n const tabId = target.getAttribute('data-tab-scaffold-tab');\n if (tabId) options.onSelect(tabId);\n },\n );\n}\n"]}
1
+ {"version":3,"sources":["../src/components/navigation/tab-navigator/wiring/wire-tab-navigator.ts"],"names":[],"mappings":"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","file":"wire-tab-navigator.js","sourcesContent":["import { delegate } from 'kerfjs';\n\n/** On an overlay-bar TabNavigator: the wiring has measured its live bar. */\nconst BAR_OVERLAY = 'data-bar-overlay';\n/** The measured bar's border-box block size, published on the root. */\nconst BAR_BLOCK_SIZE = '--_kui-tab-scaffold-bar-block-size';\n/**\n * The inline size of the active scene's classic (space-taking) vertical\n * scrollbar running beneath the bar, which the bar leaves uncovered. Unset for\n * an overlay scrollbar, which takes no space.\n */\nconst BAR_SCROLLBAR_INLINE_SIZE =\n '--_kui-tab-scaffold-bar-scrollbar-inline-size';\n/** A layout that, as a scene's (or view's) only child, owns its scroller. */\nconst NESTED_LAYOUT = ['nav-stack', 'split-view', 'workbench', 'tab-scaffold']\n .map((name) => `[data-component=\"${name}\"]`)\n .join(', ');\n\n/**\n * A sole Pane's scroller when it reaches the bottom edge: its content, unless\n * a footer sits between the content and the bar.\n */\nfunction paneScroller(pane: Element): HTMLElement | undefined {\n if (pane.querySelector(':scope > .kui-pane__footer')) return undefined;\n return (\n pane.querySelector<HTMLElement>(':scope > .kui-pane__content') ?? undefined\n );\n}\n\n/**\n * The element whose vertical scrollbar runs beneath the bar in the active\n * scene: the scene itself; a sole Pane's content; or, in a sole NavStack\n * without a docked bottom toolbar, its active view (or that view's sole Pane's\n * content). Undefined when chrome (a Pane footer, a docked stack toolbar) or a\n * nested layout's own scroller ends above the bar.\n */\nfunction activeScroller(section: Element): HTMLElement | undefined {\n const scene = section.querySelector<HTMLElement>(\n ':scope > .kui-tab-scaffold__scenes > .kui-tab-scaffold__scene[data-active=\"true\"]',\n );\n if (!scene) return undefined;\n const only = scene.children.length === 1 ? scene.children[0]! : undefined;\n if (!only?.matches(`[data-component=\"pane\"], ${NESTED_LAYOUT}`)) return scene;\n if (only.matches('[data-component=\"pane\"]')) return paneScroller(only);\n if (!only.matches('[data-component=\"nav-stack\"]')) return undefined;\n if (\n only.querySelector(':scope > [data-nav-stack-bottom]') &&\n only.getAttribute('data-bottom-toolbar-presentation') !== 'overlay'\n )\n return undefined;\n const views = [\n ...only.querySelectorAll<HTMLElement>(\n ':scope > [data-nav-stack-viewport] > [data-nav-active=\"true\"]:not([data-nav-exiting=\"true\"])',\n ),\n ];\n const view = views.at(-1);\n if (!view) return undefined;\n const child = view.children.length === 1 ? view.children[0]! : undefined;\n if (child?.matches('[data-component=\"pane\"]')) return paneScroller(child);\n return child?.matches(NESTED_LAYOUT) ? undefined : view;\n}\n\n/**\n * `barPresentation=\"overlay\"`: measure the live tab bar's border box (bottom\n * safe area and its 1px top edge included) and publish it on the root with\n * the gate that lays the bar over the scenes. The size follows the bar as\n * labels wrap, text zooms, or the safe area changes, and a re-render that\n * replaces the bar or strips the published state gets it back before paint.\n */\nfunction wireBarOverlay(section: HTMLElement): () => void {\n const view = section.ownerDocument.defaultView ?? window;\n let bar: HTMLElement | undefined;\n let size: number | undefined;\n let scroller: HTMLElement | undefined;\n let scrollbarSize = 0;\n const writeProperty = (name: string, value: string): void => {\n if (section.style.getPropertyValue(name) === value) return;\n if (value) section.style.setProperty(name, value);\n else section.style.removeProperty(name);\n };\n const publish = (): void => {\n const measured = bar !== undefined && size !== undefined;\n writeProperty(BAR_BLOCK_SIZE, measured ? `${size}px` : '');\n writeProperty(\n BAR_SCROLLBAR_INLINE_SIZE,\n measured && scrollbarSize > 0 ? `${scrollbarSize}px` : '',\n );\n if (section.getAttribute('style') === '') section.removeAttribute('style');\n // The gate changes only when it must, so the observer below settles.\n if (measured && section.getAttribute(BAR_OVERLAY) !== 'measured')\n section.setAttribute(BAR_OVERLAY, 'measured');\n else if (!measured && section.hasAttribute(BAR_OVERLAY))\n section.removeAttribute(BAR_OVERLAY);\n };\n const measureScrollbar = (): void => {\n if (!scroller) {\n scrollbarSize = 0;\n return;\n }\n const style = view.getComputedStyle(scroller);\n scrollbarSize = Math.max(\n 0,\n scroller.offsetWidth -\n scroller.clientWidth -\n (Number.parseFloat(style.borderLeftWidth) || 0) -\n (Number.parseFloat(style.borderRightWidth) || 0),\n );\n };\n const resizeObserver = view.ResizeObserver\n ? new view.ResizeObserver((entries) => {\n for (const entry of entries)\n if (entry.target === bar)\n size =\n entry.borderBoxSize?.[0]?.blockSize ??\n entry.target.getBoundingClientRect().height;\n // A scrollbar appearing or leaving resizes the content box.\n else if (entry.target === scroller) measureScrollbar();\n publish();\n })\n : undefined;\n const sync = (): void => {\n const next =\n section.getAttribute('data-bar-presentation') === 'overlay'\n ? (section.querySelector<HTMLElement>(\n ':scope > .kui-tab-scaffold__bar',\n ) ?? undefined)\n : undefined;\n if (next !== bar) {\n if (bar) resizeObserver?.unobserve(bar);\n bar = next;\n if (!bar) size = undefined;\n else {\n // A replacement keeps the last size until the observer reports it\n // after layout; a first bar (or one with no observer) is measured now.\n if (size === undefined || !resizeObserver)\n size = bar.getBoundingClientRect().height;\n // The border box: a forced-colors edge changes no content box.\n resizeObserver?.observe(bar, { box: 'border-box' });\n }\n }\n // The active scroller changes with the active tab, a stack's push or pop,\n // or a re-render of the scene.\n const covered = bar ? activeScroller(section) : undefined;\n if (covered !== scroller) {\n if (scroller) resizeObserver?.unobserve(scroller);\n scroller = covered;\n measureScrollbar();\n if (scroller) resizeObserver?.observe(scroller);\n }\n publish();\n };\n const mutationObserver = new MutationObserver(sync);\n mutationObserver.observe(section, {\n childList: true,\n attributes: true,\n attributeFilter: ['data-bar-presentation', BAR_OVERLAY, 'style'],\n });\n // Scene switches and nested stack transitions below the root.\n const sceneObserver = new MutationObserver(sync);\n const scenes = section.querySelector(':scope > .kui-tab-scaffold__scenes');\n if (scenes)\n sceneObserver.observe(scenes, {\n childList: true,\n subtree: true,\n attributes: true,\n attributeFilter: [\n 'data-active',\n 'data-nav-active',\n 'data-nav-exiting',\n 'data-bottom-toolbar-presentation',\n ],\n });\n sync();\n return () => {\n mutationObserver.disconnect();\n sceneObserver.disconnect();\n resizeObserver?.disconnect();\n bar = undefined;\n size = undefined;\n scroller = undefined;\n scrollbarSize = 0;\n publish();\n };\n}\n\nexport interface WireTabNavigatorOptions {\n /** Invoked with the selected tab id when a bottom-bar tab is activated. */\n onSelect: (tabId: string) => void;\n}\n\n/**\n * Wire a `TabNavigator`'s bottom tab bar: clicking a tab calls `onSelect` with its\n * id (the app then updates its controlled `active`). With\n * `barPresentation=\"overlay\"` it also measures the live bar and lays it over\n * the scenes (see `TabNavigatorProps.barPresentation`). Returns a disposer.\n */\nexport function wireTabNavigator(\n root: Element,\n options: WireTabNavigatorOptions,\n): () => void {\n const section = root.matches('[data-component=\"tab-scaffold\"]')\n ? root\n : root.querySelector('[data-component=\"tab-scaffold\"]');\n if (!(section instanceof HTMLElement)) return () => {};\n const stopClicks = delegate(\n section,\n 'click',\n '[data-tab-scaffold-tab]',\n (_event, target) => {\n const tabId = target.getAttribute('data-tab-scaffold-tab');\n if (tabId) options.onSelect(tabId);\n },\n );\n const stopOverlay = wireBarOverlay(section);\n return () => {\n stopClicks();\n stopOverlay();\n };\n}\n"]}
@@ -1,5 +1,5 @@
1
1
  import { Signal } from 'kerfjs';
2
- import { d as TokenSearchModel } from './token-search-model-DTcTXWMS.js';
2
+ import { d as TokenSearchModel } from './token-search-model-aYR0YAei.js';
3
3
  import './semantic-content-BbzjvSu9.js';
4
4
 
5
5
  interface TokenSearchSubmit {
@@ -1,4 +1,4 @@
1
- export { wireTokenSearchFields } from './chunk-Y3LC7JQO.js';
1
+ export { wireTokenSearchFields } from './chunk-YOA5W5ZH.js';
2
2
 
3
3
 
4
4
 
@@ -1,15 +1,16 @@
1
1
  import { SafeHtml } from 'kerfjs';
2
2
  import { K as KerfUiContent } from './semantic-content-BbzjvSu9.js';
3
- import { b as NavPane, N as NavStackProps } from './nav-stack-BvSKY448.js';
3
+ import { b as NavPane, N as NavStackProps } from './nav-stack-VXTumzKa.js';
4
4
  import { ListConfig } from './list.js';
5
5
  import { PaneConfig } from './pane.js';
6
6
  import { ResizableRegionSeparator, ResizableRegionCollapseMotion, ResizableRegionContentOverflow, ResizableRegionPresentation, ResizableRegionRestorePosition } from './resizable-region.js';
7
- import { a as PanelToolbar, c as PanelBottomToolbar, b as PanelChromePlacement, d as PanelToggle } from './panel-toolbar-CL9tYOkh.js';
7
+ import { a as PanelToolbar, c as PanelBottomToolbar, b as PanelChromePlacement, d as PanelToggle } from './panel-toolbar-vg6Ir5Dy.js';
8
8
  import { ToolbarConfig } from './toolbar.js';
9
9
  import './toolbar-text.js';
10
10
  import './css-values.js';
11
11
  import './extension-attributes-mu8MFUl0.js';
12
12
  import './flex-alignment-4ms8ZbV8.js';
13
+ import './scroll-clearance-BikHljTc.js';
13
14
  import './sides-BPSWde0A.js';
14
15
  import './lucide-icon.js';
15
16
  import 'lucide';
@@ -100,7 +101,11 @@ interface WorkbenchPanelBase {
100
101
  * with `wireWorkbench` from `@kerfjs/ui/wire-workbench`.
101
102
  */
102
103
  resizable?: boolean | WorkbenchPanelResizable;
103
- /** Accessible name for the panel region. */
104
+ /**
105
+ * Accessible name for the panel region, in title style. A resizable
106
+ * panel's handle is named "Resize {label}", or "Resize Left Rail" /
107
+ * "Resize Right Rail" / "Resize Bottom Drawer" without one.
108
+ */
104
109
  label?: string;
105
110
  /** Opt into keyboard (`0`) or programmatic (`-1`) focus on the panel region. */
106
111
  tabIndex?: 0 | -1;
package/dist/workbench.js CHANGED
@@ -1,4 +1,5 @@
1
- export { Workbench } from './chunk-BU23Z5HZ.js';
1
+ export { Workbench } from './chunk-PYBBYSZ3.js';
2
+
2
3
 
3
4
 
4
5
 
@@ -18,7 +18,7 @@ These are normative contracts for package components and consuming applications.
18
18
  - Interactive `ContentItem` cards are keyboard reachable. Set `selectionMode="toggle"` for a pressed button, `selectionMode="single"` for an option inside a listbox, or `selectionMode="multiple"` for a selectable row with a gridcell that can contain native controls. Place multiple-mode rows inside a labeled `List` or `Grid` with `selectionMode="multiple"`; the app owns the selection set and range gestures. Wire `wireContentItems` once so Enter and Space on the card activate its delegated action without activating it from a nested control. Disabled cards expose `aria-disabled` and leave the Tab order.
19
19
  - An unlabeled `Skeleton` (including the value slots a component's `placeholder` prop renders) is decorative loading chrome: it is `aria-hidden`, conveys no information a user needs to act on, and is deliberately exempt from the WCAG 3:1 non-text-contrast target. Inside a solid `Badge` it stays subtle (about 2.1–4.4:1 in light, 2.4–2.8:1 in dark, depending on tone); `tests/browser/tone-contrast.spec.ts` holds those values as a regression floor rather than an accessibility threshold. Announce loading through a labeled `Skeleton`, `LoadingSpinner`, or `aria-busy` on the owning region, never through the skeleton's visibility.
20
20
  - `StateBanner` defaults to polite `role="status"`; use `urgency="alert"` only for an attention-requiring failure. Its optional `badge` is persistent inline status/count content beside the title and is announced as part of the banner; keep it terse and do not rely on color alone for its meaning.
21
- - A removable `Chip` has a native button with a specific `removeLabel`, such as "Remove Urgent tag". The button is absent for a plain chip and disabled for a disabled chip. Its leading `icon` is decorative; the visible label names the tag. `truncate` retains the full plain-text label as a native tooltip. Tag text remains visible because tone does not convey meaning alone.
21
+ - A removable `Chip` has a native button with a specific `removeLabel`, such as "Remove Urgent tag". The button is absent for a plain chip and disabled for a disabled chip. Its leading `icon` is decorative; the visible label names the tag. `truncate` retains the full plain-text label as a native tooltip. Tag text remains visible because tone does not convey meaning alone. A link `Chip` (`href`) is a native anchor named by its visible label, with no remove button; `external` adds `target="_blank"`, `rel="noopener noreferrer"`, and an "(opens in new tab)" name suffix for a text label, and a disabled link chip drops `href`, sets `aria-disabled`, and leaves the tab order. `tone="inherit"` paints no fill, so its label keeps the surrounding text's contrast (a brand-loud bubble's white text included), and its focus ring is drawn in the surrounding foreground so it stays visible on a brand-colored surface.
22
22
  - `EmptyState` reports busy state through `aria-busy` and never relies on an illustration as its label.
23
23
  - `Select` follows the Web Awesome host's standard `input`/`change` events. Application tests verify the live `value`, focus, and events—not attributes alone. Its decorative option icons and value-dependent selected content remain present after controlled rerenders, so the visible choice does not silently lose its non-text cue.
24
24
  - `DisclosureArrow` is an 18px root-scaled decorative visual by default, not an interaction target. Its owning native control supplies a stable accessible name, pointer and keyboard interaction, and `aria-expanded`; multiple arrows keep independently controlled state. Consumers may resize it with the typed `size` prop without changing that ownership. Configured directions animate over the shortest path; a 180-degree closed-to-open tie uses counterclockwise rotation.
@@ -220,7 +220,18 @@ name from its content and ignores an `aria-label` on the host, so an icon-only
220
220
  trigger requires `label`, which renders as visually hidden text inside the
221
221
  button; a trigger with visible `text` is named by that text. An icon-only
222
222
  trigger also shows its `label` as an `aria-hidden` help tag on hover and
223
- keyboard focus (see [Help tags on icon-only triggers](#help-tags-on-icon-only-triggers)). Group headings
223
+ keyboard focus (see [Help tags on icon-only triggers](#help-tags-on-icon-only-triggers)).
224
+ The open menu carries that same name. Web Awesome renders the `role="menu"`
225
+ panel inside the dropdown's shadow root, where no ID reference can reach the
226
+ trigger (the context anchor is `aria-hidden` light DOM, and a button trigger's
227
+ real `<button>` sits in `wa-button`'s own shadow root). So `PopupMenu` renders
228
+ the name it already knows (a context or icon-only `label`, or the visible
229
+ `text`) as `data-menu-label` on the dropdown, and the register copies it to the
230
+ panel as `aria-label` on first render and on every open. A submenu panel shares
231
+ a shadow root with its parent item's label and is `aria-labelledby` it, so it
232
+ is announced as, for example, "More Actions, menu".
233
+ `tests/browser/popup-menu-accessible-name.spec.ts` finds each panel with
234
+ `getByRole('menu', { name })` in Chromium, Firefox, and WebKit. Group headings
224
235
  render as the same uppercase group titles a grouped `Select` shows, and dividers
225
236
  are presentational. A keyboard-focused item is the menu's current row, painted
226
237
  with the Select's current-option fill rather than a second focus ring inside the
@@ -466,6 +477,41 @@ focused radio, and the checked pill adds a second pixel of border so the
466
477
  selection does not rely on hue alone; forced-colors mode paints it with
467
478
  `Highlight`.
468
479
 
480
+ With `multiple`, the group renders `role="group"` with the same naming, and
481
+ each choice is a native `<input type="checkbox">` inside its pill. Every pill
482
+ is its own Tab stop, Space toggles it, assistive technology reads its native
483
+ checked state, and every checked box submits its value under `name`
484
+ (`FormData.getAll(name)`). Native `required` on a checkbox demands that one
485
+ box, so a multiple group takes no `required`; validate an "at least one" rule
486
+ in the application. Every chip color is a theme token resolved through
487
+ `light-dark()`, so inside a dark appearance scope (`.wa-dark`, `.wa-invert`,
488
+ or any `color-scheme: dark` ancestor) the pills, labels, checked tint, and
489
+ focus ring read on inverse chrome without overrides.
490
+
491
+ ## Composer
492
+
493
+ `Composer`'s message field is a native `<textarea>` named by `label`
494
+ (`aria-label`, title style). With an `id`, the `hint` renders with the id
495
+ `<id>-hint` and becomes the field's `aria-describedby`; without an `id`, the
496
+ hint is visible only. The field draws no border or outline of its own: the
497
+ frame is its boundary, and while focus is anywhere within the composer the
498
+ frame's border turns brand (`Highlight` in forced-colors mode, with a 2px
499
+ outline). Each trailing action keeps its own name and focus ring. `disabled`
500
+ disables the field only; the app disables its actions. Sending and
501
+ announcing a sent message stay with the app.
502
+
503
+ With `submitOnEnter` and `wireComposers`, the field carries
504
+ `aria-keyshortcuts="Enter"`, so assistive technology announces the shortcut.
505
+ Enter and Cmd/Ctrl+Enter activate the first trailing action, the same control
506
+ a pointer or Tab-and-Space user reaches; Shift+Enter inserts a newline. An
507
+ Enter that commits an IME composition (`isComposing`, keyCode 229, or between
508
+ `compositionstart` and `compositionend`) is left to the input method, so
509
+ people composing Japanese, Chinese, or Korean text never send a half-written
510
+ message. An empty or whitespace-only message, an auto-repeating key, a
511
+ disabled field, or a disabled, loading, or `aria-disabled` action sends
512
+ nothing. A visible hint may also state the shortcut when the audience may not
513
+ expect it.
514
+
469
515
  ## TokenSearchField
470
516
 
471
517
  Use `presentation="form-field"` when a structured search query sits beside
@@ -481,7 +527,10 @@ form-control tokens, so the two controls read as one form.
481
527
 
482
528
  `TokenSearchField` exposes the editable surface as a named `searchbox`. Each
483
529
  chip is atomic (`contenteditable="false"`) and contains separately named edit
484
- and remove buttons; the clear action is also named. Disabled fields publish
530
+ and remove buttons; the clear action is also named. A `trailingAction` is a
531
+ named button whose `label` is also its tooltip; a help toggle sets `expanded`
532
+ (`aria-expanded`, with `haspopup` and `controls` for the surface it opens) and
533
+ an on/off toggle sets `pressed` (`aria-pressed`). Disabled fields publish
485
534
  `aria-disabled` and stop editing without hiding the current expression. The
486
535
  application owns query parsing and must announce result-count or loading
487
536
  changes separately when that feedback is useful. Use `readTokenSearchField()`
@@ -612,6 +661,86 @@ opened it, else the restore control, else a control whose `aria-controls` names
612
661
  panel; an open overlay panel takes focus and keeps Tab inside it (the ARIA dialog
613
662
  pattern). See [`workbench.md`](workbench.md).
614
663
 
664
+ ## Chrome material
665
+
666
+ Translucent chrome, such as a `Pane` header with
667
+ `headerPresentation="overlay"`, a `NavStack` top bar with
668
+ `chromePresentation="overlay"`, or a `NavStack` bottom toolbar with
669
+ `bottomToolbarPresentation="overlay"`, or a `TabNavigator` tab bar with
670
+ `barPresentation="overlay"`, paints `--kui-chrome-material`: the surface at
671
+ 80% opacity behind a blur-and-saturate backdrop filter
672
+ (`--kui-chrome-material-filter`). Content scrolls visibly beneath it, so the
673
+ backdrop under its text is not a fixed color. The contrast rule measures the
674
+ worst case: the material composited over a solid black backdrop in the light
675
+ theme and a solid white backdrop in the dark theme. The blur only averages the
676
+ content, so it can never be darker or lighter than that.
677
+
678
+ Chrome on a raised surface, such as a `DialogSurface` title bar with
679
+ `headerPresentation="floating"`, paints `--kui-chrome-material-raised`
680
+ instead: the raised surface at the same 80%, so the bar matches the dialog
681
+ panel behind it. The same rule and fallbacks apply.
682
+
683
+ - **Normal text and icons pass AA over any content.** `--kui-color-text`
684
+ measures about 10.5:1 (light) and 8.3:1 (dark) on that worst case, and
685
+ about 10.5:1 (light) and 6.7:1 (dark) over the raised material. 80% is
686
+ above the minimum opacity that keeps 4.5:1 there (about 55% light and 60%
687
+ dark). A theme that overrides `--kui-chrome-material` or
688
+ `--kui-chrome-material-raised` must keep its text at 4.5:1 or better
689
+ against the same backdrops.
690
+ - **Quiet text does not, so `ToolbarText` lifts it.** `--kui-color-text-quiet`
691
+ falls to about 3.2:1 (light) and 4.1:1 (dark) over the worst case, and the
692
+ default-size title color to about 3.8:1 (light). Inside an overlay `Pane`
693
+ header or overlay `NavStack` chrome or bottom toolbar, or slotted as the `label` (or into
694
+ `header-actions`) of a `DialogSurface` floating header, an untoned
695
+ `ToolbarText` therefore takes
696
+ `--kui-color-text` for its title at every size, and its `description` mixes
697
+ the quiet color halfway toward the normal one, about 5.9:1 in both themes
698
+ (about 4.9:1 dark over the raised material). That keeps AA while the
699
+ description still reads as secondary. Controls lift the same way in an
700
+ overlay `Pane` header, overlay `NavStack` chrome or bottom toolbar, and a
701
+ `DialogSurface` floating header's `header-actions`: a default-tone
702
+ `ToolbarControlGroup`'s quiet control color over its own translucent fill
703
+ measures about 3.0:1 (light) and 3.5:1 (dark) over the worst case, so its
704
+ controls take `--kui-color-text` there. An overlay `TabNavigator` bar's
705
+ unselected labels lift halfway toward `--kui-color-text`, and its selected
706
+ label mixes 40% of it into the brand color: the plain brand color measured
707
+ about 3.2:1 (light) over the worst case. `wa-dialog`'s own close button is an
708
+ icon, held to the 3:1 non-text bar, and measures about 3.8:1 (light) and
709
+ 4.1:1 (dark) over the raised material. Any other quiet copy you place in
710
+ overlay chrome yourself has no such lift; keep it in the content.
711
+ - **The material turns opaque when transparency would hurt.** Under
712
+ `prefers-reduced-transparency: reduce` or `prefers-contrast: more`, and where
713
+ `backdrop-filter` is unsupported, it resolves to the opaque surface. In forced
714
+ colors, the header (or NavStack chrome) paints `Canvas` with a `CanvasText`
715
+ bottom edge, and an overlay NavStack bottom toolbar paints `Canvas` with a
716
+ `CanvasText` top edge, so content passing beneath it never shows through.
717
+
718
+ `tests/browser/overlay-header.spec.ts` (Pane),
719
+ `tests/browser/overlay-nav-stack.spec.ts` (NavStack top chrome),
720
+ `tests/browser/overlay-nav-stack-bottom.spec.ts` (NavStack bottom toolbar,
721
+ which also measures its description, a control, the top chrome's back
722
+ control, and increased contrast), and
723
+ `tests/browser/dialog-floating-header.spec.ts` (DialogSurface) measure the
724
+ title over the material on both worst-case backdrops in Chromium, Firefox, and
725
+ WebKit, and the Pane and DialogSurface specs also measure the description and
726
+ a header control group (DialogSurface also its close button). In
727
+ Chromium they also check the opaque fallbacks for reduced transparency and
728
+ forced colors, and the Pane and DialogSurface specs check increased contrast.
729
+
730
+ **Firefox and WebKit screenshots omit the blur.** In Playwright's Firefox and
731
+ WebKit, `page.screenshot()` (headless or headed) shows the content beneath the
732
+ material crisp, as if `backdrop-filter` did nothing. Stock Firefox's own
733
+ `--headless --screenshot` does the same. The filter is still applied: a
734
+ `recordVideo` frame of the same page in the same session, which records the
735
+ compositor's output, shows the content blurred. Firefox and WebKit draw
736
+ `backdrop-filter` only when compositing (WebRender in Firefox, Core Animation
737
+ in WebKit), and their snapshot paths repaint the page without it. Chromium's
738
+ screenshot shows the blur. Plain test pages with no kerf CSS behave the same
739
+ way, so no ancestor style in these components is blocking the filter. When
740
+ you review the blur in Firefox or WebKit, use a `recordVideo` frame, not a
741
+ screenshot. A crisp screenshot is not a defect, and contrast is unaffected
742
+ because the rule above already assumes no blur.
743
+
615
744
  ## Verification matrix
616
745
 
617
746
  For each changed component, inspect default, hover, focus, disabled, selected/pressed, busy/error, long-content, wide, narrow, light, dark, increased-contrast, reduced-motion, keyboard-only, and 200%-zoom states where applicable. DOM order must match reading and focus order, with no clipping or unreachable action.