@buffercreations/levelsui 0.1.1 → 0.1.4

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 (580) hide show
  1. package/01. Elements/actions/controls/button/button.definition.json +38 -4
  2. package/01. Elements/actions/controls/button/docs/README.md +67 -0
  3. package/01. Elements/actions/controls/button/{api.json → docs/api.json } +14 -5
  4. package/01. Elements/actions/controls/button/examples/contexts/code.html +1 -3
  5. package/01. Elements/actions/controls/button/examples/contexts/preview.html +8 -2
  6. package/01. Elements/actions/controls/button/examples/icon-only/code.html +3 -0
  7. package/01. Elements/actions/controls/button/examples/icon-only/preview.html +17 -0
  8. package/01. Elements/actions/controls/button/examples/icons/code.html +2 -4
  9. package/01. Elements/actions/controls/button/examples/icons/preview.html +12 -3
  10. package/01. Elements/actions/controls/button/examples/index.json +9 -2
  11. package/01. Elements/actions/controls/button/examples/native-default/code.html +0 -8
  12. package/01. Elements/actions/controls/button/examples/native-default/preview.html +0 -4
  13. package/01. Elements/actions/controls/button/examples/states/code.html +1 -1
  14. package/01. Elements/actions/controls/button/examples/states/preview.html +2 -2
  15. package/01. Elements/actions/controls/button/src/button.scss +215 -0
  16. package/01. Elements/actions/controls/button-lumen-shift/button-lumen-shift.definition.json +95 -0
  17. package/01. Elements/actions/controls/button-lumen-shift/docs/README.md +85 -0
  18. package/01. Elements/actions/controls/button-lumen-shift/docs/api.json +134 -0
  19. package/01. Elements/actions/controls/button-lumen-shift/examples/basic/code.html +3 -0
  20. package/01. Elements/actions/controls/button-lumen-shift/examples/basic/preview.html +3 -0
  21. package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/code.html +1 -0
  22. package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/preview.html +9 -0
  23. package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/code.html +3 -0
  24. package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/preview.html +14 -0
  25. package/01. Elements/actions/controls/button-lumen-shift/examples/icons/code.html +4 -0
  26. package/01. Elements/actions/controls/button-lumen-shift/examples/icons/preview.html +14 -0
  27. package/01. Elements/actions/controls/button-lumen-shift/examples/index.json +66 -0
  28. package/01. Elements/actions/controls/button-lumen-shift/examples/links/code.html +3 -0
  29. package/01. Elements/actions/controls/button-lumen-shift/examples/links/preview.html +3 -0
  30. package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/code.html +1 -0
  31. package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/preview.html +6 -0
  32. package/01. Elements/actions/controls/button-lumen-shift/examples/states/code.html +1 -0
  33. package/01. Elements/actions/controls/button-lumen-shift/examples/states/preview.html +4 -0
  34. package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/code.html +1 -0
  35. package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/preview.html +5 -0
  36. package/01. Elements/actions/controls/button-lumen-shift/src/button-lumen-shift.scss +543 -0
  37. package/01. Elements/feedback/tooltip/docs/README.md +49 -0
  38. package/01. Elements/feedback/tooltip/docs/api.json +78 -0
  39. package/01. Elements/feedback/tooltip/examples/arrow/code.html +4 -0
  40. package/01. Elements/feedback/tooltip/examples/arrow/preview.html +4 -0
  41. package/01. Elements/feedback/tooltip/examples/comfortable/code.html +4 -0
  42. package/01. Elements/feedback/tooltip/examples/comfortable/preview.html +4 -0
  43. package/01. Elements/feedback/tooltip/examples/default/code.html +4 -0
  44. package/01. Elements/feedback/tooltip/examples/default/preview.html +4 -0
  45. package/01. Elements/feedback/tooltip/examples/delays/code.html +4 -0
  46. package/01. Elements/feedback/tooltip/examples/delays/preview.html +4 -0
  47. package/01. Elements/feedback/tooltip/examples/disabled/code.html +6 -0
  48. package/01. Elements/feedback/tooltip/examples/disabled/preview.html +6 -0
  49. package/01. Elements/feedback/tooltip/examples/index.json +66 -0
  50. package/01. Elements/feedback/tooltip/examples/multiple/code.html +8 -0
  51. package/01. Elements/feedback/tooltip/examples/multiple/preview.html +8 -0
  52. package/01. Elements/feedback/tooltip/examples/shortcut/code.html +4 -0
  53. package/01. Elements/feedback/tooltip/examples/shortcut/preview.html +4 -0
  54. package/01. Elements/feedback/tooltip/examples/sides/code.html +4 -0
  55. package/01. Elements/feedback/tooltip/examples/sides/preview.html +16 -0
  56. package/01. Elements/feedback/tooltip/src/tooltip.js +233 -0
  57. package/01. Elements/feedback/tooltip/src/tooltip.scss +117 -0
  58. package/01. Elements/feedback/tooltip/tooltip.definition.json +42 -0
  59. package/01. Elements/forms/selection/checkbox/checkbox.definition.json +65 -0
  60. package/01. Elements/forms/selection/checkbox/docs/README.md +46 -0
  61. package/01. Elements/forms/selection/checkbox/docs/api.json +102 -0
  62. package/01. Elements/forms/selection/checkbox/examples/basic/code.html +7 -0
  63. package/01. Elements/forms/selection/checkbox/examples/basic/preview.html +4 -0
  64. package/01. Elements/forms/selection/checkbox/examples/description/code.html +7 -0
  65. package/01. Elements/forms/selection/checkbox/examples/description/preview.html +7 -0
  66. package/01. Elements/forms/selection/checkbox/examples/group/code.html +9 -0
  67. package/01. Elements/forms/selection/checkbox/examples/group/preview.html +6 -0
  68. package/01. Elements/forms/selection/checkbox/examples/index.json +44 -0
  69. package/01. Elements/forms/selection/checkbox/examples/sizes/code.html +6 -0
  70. package/01. Elements/forms/selection/checkbox/examples/sizes/preview.html +5 -0
  71. package/01. Elements/forms/selection/checkbox/examples/states/code.html +6 -0
  72. package/01. Elements/forms/selection/checkbox/examples/states/preview.html +7 -0
  73. package/01. Elements/forms/selection/checkbox/examples/table/code.html +1 -0
  74. package/01. Elements/forms/selection/checkbox/examples/table/preview.html +8 -0
  75. package/01. Elements/forms/selection/checkbox/src/checkbox.scss +157 -0
  76. package/01. Elements/forms/selection/select/docs/README.md +37 -0
  77. package/01. Elements/forms/selection/select/docs/api.json +105 -0
  78. package/01. Elements/forms/selection/select/examples/default/code.html +12 -0
  79. package/01. Elements/forms/selection/select/examples/default/preview.html +12 -0
  80. package/01. Elements/forms/selection/select/examples/disabled/code.html +12 -0
  81. package/01. Elements/forms/selection/select/examples/disabled/preview.html +12 -0
  82. package/01. Elements/forms/selection/select/examples/index.json +74 -0
  83. package/01. Elements/forms/selection/select/examples/invalid/code.html +12 -0
  84. package/01. Elements/forms/selection/select/examples/invalid/preview.html +12 -0
  85. package/01. Elements/forms/selection/select/examples/leading-avatar/code.html +12 -0
  86. package/01. Elements/forms/selection/select/examples/leading-avatar/preview.html +12 -0
  87. package/01. Elements/forms/selection/select/examples/leading-icon/code.html +12 -0
  88. package/01. Elements/forms/selection/select/examples/leading-icon/preview.html +12 -0
  89. package/01. Elements/forms/selection/select/examples/native/code.html +12 -0
  90. package/01. Elements/forms/selection/select/examples/native/preview.html +12 -0
  91. package/01. Elements/forms/selection/select/examples/search/code.html +12 -0
  92. package/01. Elements/forms/selection/select/examples/search/preview.html +12 -0
  93. package/01. Elements/forms/selection/select/examples/sizes/code.html +12 -0
  94. package/01. Elements/forms/selection/select/examples/sizes/preview.html +36 -0
  95. package/01. Elements/forms/selection/select/examples/status-dot/code.html +12 -0
  96. package/01. Elements/forms/selection/select/examples/status-dot/preview.html +12 -0
  97. package/01. Elements/forms/selection/select/select.definition.json +69 -0
  98. package/01. Elements/forms/selection/select/src/select.js +477 -0
  99. package/01. Elements/forms/selection/select/src/select.scss +312 -0
  100. package/01. Elements/media/identity/avatar/avatar.definition.json +48 -5
  101. package/01. Elements/media/identity/avatar/docs/README.md +61 -0
  102. package/01. Elements/media/identity/avatar/docs/api.json +96 -0
  103. package/01. Elements/media/identity/avatar/examples/badge/code.html +7 -0
  104. package/01. Elements/media/identity/avatar/examples/badge/preview.html +7 -0
  105. package/01. Elements/media/identity/avatar/examples/badge-icon/code.html +7 -0
  106. package/01. Elements/media/identity/avatar/examples/badge-icon/preview.html +7 -0
  107. package/01. Elements/media/identity/avatar/examples/basic/code.html +6 -0
  108. package/01. Elements/media/identity/avatar/examples/basic/preview.html +6 -0
  109. package/01. Elements/media/identity/avatar/examples/dropdown/code.html +8 -0
  110. package/01. Elements/media/identity/avatar/examples/dropdown/preview.html +6 -0
  111. package/01. Elements/media/identity/avatar/examples/fallback/code.html +5 -0
  112. package/01. Elements/media/identity/avatar/examples/fallback/preview.html +5 -0
  113. package/01. Elements/media/identity/avatar/examples/index.json +68 -23
  114. package/01. Elements/media/identity/avatar/examples/notification-count/code.html +6 -0
  115. package/01. Elements/media/identity/avatar/examples/notification-count/preview.html +7 -0
  116. package/01. Elements/media/identity/avatar/examples/notification-dot/code.html +6 -0
  117. package/01. Elements/media/identity/avatar/examples/notification-dot/preview.html +7 -0
  118. package/01. Elements/media/identity/avatar/examples/sizes/code.html +2 -2
  119. package/01. Elements/media/identity/avatar/examples/sizes/preview.html +19 -26
  120. package/01. Elements/media/identity/avatar/examples/square/code.html +5 -0
  121. package/01. Elements/media/identity/avatar/examples/square/preview.html +5 -0
  122. package/01. Elements/media/identity/avatar/examples/status-contexts/code.html +6 -0
  123. package/01. Elements/media/identity/avatar/examples/status-contexts/preview.html +13 -0
  124. package/01. Elements/media/identity/avatar/src/avatar.js +42 -0
  125. package/01. Elements/media/identity/avatar/src/avatar.scss +172 -0
  126. package/01. Elements/navigation/items/navigation-item/docs/README.md +52 -0
  127. package/01. Elements/navigation/items/navigation-item/docs/api.json +84 -0
  128. package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/code.html +9 -0
  129. package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/preview.html +18 -0
  130. package/01. Elements/navigation/items/navigation-item/examples/collapsible/code.html +9 -0
  131. package/01. Elements/navigation/items/navigation-item/examples/collapsible/preview.html +18 -0
  132. package/01. Elements/navigation/items/navigation-item/examples/icon-label/code.html +6 -0
  133. package/01. Elements/navigation/items/navigation-item/examples/icon-label/preview.html +1 -0
  134. package/01. Elements/navigation/items/navigation-item/examples/icon-only/code.html +7 -0
  135. package/01. Elements/navigation/items/navigation-item/examples/icon-only/preview.html +1 -0
  136. package/01. Elements/navigation/items/navigation-item/examples/index.json +45 -0
  137. package/01. Elements/navigation/items/navigation-item/examples/label-only/code.html +3 -0
  138. package/01. Elements/navigation/items/navigation-item/examples/label-only/preview.html +1 -0
  139. package/01. Elements/navigation/items/navigation-item/examples/states/code.html +9 -0
  140. package/01. Elements/navigation/items/navigation-item/examples/states/preview.html +17 -0
  141. package/01. Elements/navigation/items/navigation-item/navigation-item.definition.json +40 -0
  142. package/01. Elements/navigation/items/navigation-item/src/navigation-item.scss +185 -0
  143. package/01. Elements/status/indicators/badge/badge.definition.json +55 -0
  144. package/01. Elements/status/indicators/badge/docs/README.md +40 -0
  145. package/01. Elements/status/indicators/badge/docs/api.json +112 -0
  146. package/01. Elements/status/indicators/badge/examples/content/code.html +1 -0
  147. package/01. Elements/status/indicators/badge/examples/content/preview.html +3 -0
  148. package/01. Elements/status/indicators/badge/examples/contexts/code.html +1 -0
  149. package/01. Elements/status/indicators/badge/examples/contexts/preview.html +3 -0
  150. package/01. Elements/status/indicators/badge/examples/icons/code.html +1 -0
  151. package/01. Elements/status/indicators/badge/examples/icons/preview.html +3 -0
  152. package/01. Elements/status/indicators/badge/examples/index.json +58 -0
  153. package/01. Elements/status/indicators/badge/examples/links/code.html +1 -0
  154. package/01. Elements/status/indicators/badge/examples/links/preview.html +3 -0
  155. package/01. Elements/status/indicators/badge/examples/loading/code.html +1 -0
  156. package/01. Elements/status/indicators/badge/examples/loading/preview.html +3 -0
  157. package/01. Elements/status/indicators/badge/examples/sizes/code.html +1 -0
  158. package/01. Elements/status/indicators/badge/examples/sizes/preview.html +3 -0
  159. package/01. Elements/status/indicators/badge/examples/status/code.html +1 -0
  160. package/01. Elements/status/indicators/badge/examples/status/preview.html +3 -0
  161. package/01. Elements/status/indicators/badge/examples/treatments/code.html +1 -0
  162. package/01. Elements/status/indicators/badge/examples/treatments/preview.html +3 -0
  163. package/01. Elements/status/indicators/badge/src/badge.scss +109 -0
  164. package/02. Layouts/REFINEMENT-REVIEW.md +82 -0
  165. package/02. Layouts/UTILITY-RECIPES.md +97 -9
  166. package/02. Layouts/application/app-shell/app-shell.definition.json +7 -6
  167. package/02. Layouts/application/app-shell/docs/README.md +64 -0
  168. package/02. Layouts/application/app-shell/docs/api.json +125 -0
  169. package/02. Layouts/application/app-shell/examples/complete/code.html +19 -0
  170. package/02. Layouts/application/app-shell/examples/complete/preview.html +28 -0
  171. package/02. Layouts/application/app-shell/examples/dual/code.html +13 -0
  172. package/02. Layouts/application/app-shell/examples/dual/preview.html +26 -0
  173. package/02. Layouts/application/app-shell/examples/header-main/code.html +10 -0
  174. package/02. Layouts/application/app-shell/examples/header-main/preview.html +19 -0
  175. package/02. Layouts/application/app-shell/examples/index.json +51 -15
  176. package/02. Layouts/application/app-shell/examples/main-only/code.html +7 -0
  177. package/02. Layouts/application/app-shell/examples/main-only/preview.html +18 -0
  178. package/02. Layouts/application/app-shell/examples/right/code.html +16 -0
  179. package/02. Layouts/application/app-shell/examples/right/preview.html +25 -0
  180. package/02. Layouts/application/app-shell/examples/sizes/code.html +16 -0
  181. package/02. Layouts/application/app-shell/examples/sizes/preview.html +27 -0
  182. package/02. Layouts/application/app-shell/examples/standard/code.html +13 -0
  183. package/02. Layouts/application/app-shell/examples/standard/preview.html +22 -0
  184. package/02. Layouts/application/app-shell/examples/sticky/code.html +16 -0
  185. package/02. Layouts/application/app-shell/examples/sticky/preview.html +23 -0
  186. package/02. Layouts/application/app-shell/src/app-shell.scss +119 -0
  187. package/02. Layouts/application/page-frame/docs/README.md +13 -0
  188. package/02. Layouts/application/page-frame/docs/api.json +33 -0
  189. package/02. Layouts/application/page-frame/examples/footer/code.html +8 -0
  190. package/02. Layouts/application/page-frame/examples/footer/preview.html +11 -0
  191. package/02. Layouts/application/page-frame/examples/header/code.html +8 -0
  192. package/02. Layouts/application/page-frame/examples/header/preview.html +11 -0
  193. package/02. Layouts/application/page-frame/examples/index.json +30 -0
  194. package/02. Layouts/application/page-frame/examples/main/code.html +5 -0
  195. package/02. Layouts/application/page-frame/examples/main/preview.html +10 -0
  196. package/02. Layouts/application/page-frame/examples/standard/code.html +11 -0
  197. package/02. Layouts/application/page-frame/examples/standard/preview.html +12 -0
  198. package/02. Layouts/application/page-frame/page-frame.definition.json +24 -0
  199. package/02. Layouts/application/page-frame/src/page-frame.html +11 -0
  200. package/02. Layouts/composition/cluster/cluster.definition.json +24 -0
  201. package/02. Layouts/composition/cluster/docs/README.md +45 -0
  202. package/02. Layouts/composition/cluster/docs/api.json +29 -0
  203. package/02. Layouts/composition/cluster/examples/basic/code.html +3 -0
  204. package/02. Layouts/composition/cluster/examples/basic/preview.html +6 -0
  205. package/02. Layouts/composition/cluster/examples/index.json +9 -0
  206. package/02. Layouts/composition/cluster/src/cluster.html +3 -0
  207. package/02. Layouts/composition/inline/docs/README.md +45 -0
  208. package/02. Layouts/composition/inline/docs/api.json +28 -0
  209. package/02. Layouts/composition/inline/examples/basic/code.html +3 -0
  210. package/02. Layouts/composition/inline/examples/basic/preview.html +4 -0
  211. package/02. Layouts/composition/inline/examples/index.json +16 -0
  212. package/02. Layouts/composition/inline/examples/scrolling/code.html +3 -0
  213. package/02. Layouts/composition/inline/examples/scrolling/preview.html +14 -0
  214. package/02. Layouts/composition/inline/inline.definition.json +24 -0
  215. package/02. Layouts/composition/inline/src/inline.html +3 -0
  216. package/02. Layouts/composition/overlap/docs/README.md +47 -0
  217. package/02. Layouts/composition/overlap/docs/api.json +59 -0
  218. package/02. Layouts/composition/overlap/examples/basic/code.html +8 -0
  219. package/02. Layouts/composition/overlap/examples/basic/preview.html +9 -0
  220. package/02. Layouts/composition/overlap/examples/index.json +44 -0
  221. package/02. Layouts/composition/overlap/examples/size-2xs/code.html +8 -0
  222. package/02. Layouts/composition/overlap/examples/size-2xs/preview.html +9 -0
  223. package/02. Layouts/composition/overlap/examples/size-lg/code.html +8 -0
  224. package/02. Layouts/composition/overlap/examples/size-lg/preview.html +9 -0
  225. package/02. Layouts/composition/overlap/examples/size-sm/code.html +8 -0
  226. package/02. Layouts/composition/overlap/examples/size-sm/preview.html +9 -0
  227. package/02. Layouts/composition/overlap/examples/size-xl/code.html +8 -0
  228. package/02. Layouts/composition/overlap/examples/size-xl/preview.html +9 -0
  229. package/02. Layouts/composition/overlap/examples/size-xs/code.html +8 -0
  230. package/02. Layouts/composition/overlap/examples/size-xs/preview.html +9 -0
  231. package/02. Layouts/composition/overlap/overlap.definition.json +26 -0
  232. package/02. Layouts/composition/overlap/src/overlap.scss +51 -0
  233. package/02. Layouts/composition/sidebar/docs/README.md +84 -0
  234. package/02. Layouts/composition/sidebar/docs/api.json +70 -0
  235. package/02. Layouts/composition/sidebar/examples/basic/code.html +8 -0
  236. package/02. Layouts/composition/sidebar/examples/basic/preview.html +14 -0
  237. package/02. Layouts/composition/sidebar/examples/index.json +37 -0
  238. package/02. Layouts/composition/sidebar/examples/large/code.html +8 -0
  239. package/02. Layouts/composition/sidebar/examples/large/preview.html +14 -0
  240. package/02. Layouts/composition/sidebar/examples/size-2xs/code.html +8 -0
  241. package/02. Layouts/composition/sidebar/examples/size-2xs/preview.html +14 -0
  242. package/02. Layouts/composition/sidebar/examples/size-xs/code.html +8 -0
  243. package/02. Layouts/composition/sidebar/examples/size-xs/preview.html +14 -0
  244. package/02. Layouts/composition/sidebar/examples/small/code.html +8 -0
  245. package/02. Layouts/composition/sidebar/examples/small/preview.html +14 -0
  246. package/02. Layouts/{sections → composition}/sidebar/sidebar.definition.json +6 -5
  247. package/02. Layouts/composition/sidebar/src/sidebar.scss +38 -0
  248. package/02. Layouts/composition/split/docs/README.md +56 -0
  249. package/02. Layouts/composition/split/docs/api.json +51 -0
  250. package/02. Layouts/composition/split/examples/basic/code.html +8 -0
  251. package/02. Layouts/composition/split/examples/basic/preview.html +10 -0
  252. package/02. Layouts/composition/split/examples/index.json +23 -0
  253. package/02. Layouts/composition/split/examples/wide-end/code.html +8 -0
  254. package/02. Layouts/composition/split/examples/wide-end/preview.html +10 -0
  255. package/02. Layouts/composition/split/examples/wide-start/code.html +8 -0
  256. package/02. Layouts/composition/split/examples/wide-start/preview.html +10 -0
  257. package/02. Layouts/{content → composition}/split/split.definition.json +6 -5
  258. package/02. Layouts/composition/split/src/split.scss +29 -0
  259. package/02. Layouts/composition/stack/docs/README.md +48 -0
  260. package/02. Layouts/composition/stack/docs/api.json +61 -0
  261. package/02. Layouts/composition/stack/examples/basic/code.html +1 -2
  262. package/02. Layouts/composition/stack/examples/basic/preview.html +12 -2
  263. package/02. Layouts/composition/stack/examples/compact/code.html +3 -0
  264. package/02. Layouts/composition/stack/examples/compact/preview.html +14 -0
  265. package/02. Layouts/composition/stack/examples/index.json +44 -1
  266. package/02. Layouts/composition/stack/examples/size-2xs/code.html +3 -0
  267. package/02. Layouts/composition/stack/examples/size-2xs/preview.html +14 -0
  268. package/02. Layouts/composition/stack/examples/size-lg/code.html +3 -0
  269. package/02. Layouts/composition/stack/examples/size-lg/preview.html +14 -0
  270. package/02. Layouts/composition/stack/examples/size-xl/code.html +3 -0
  271. package/02. Layouts/composition/stack/examples/size-xl/preview.html +14 -0
  272. package/02. Layouts/composition/stack/examples/size-xs/code.html +3 -0
  273. package/02. Layouts/composition/stack/examples/size-xs/preview.html +14 -0
  274. package/02. Layouts/composition/stack/{stack.html → src/stack.html } +1 -2
  275. package/02. Layouts/composition/stack/stack.definition.json +22 -5
  276. package/02. Layouts/composition/switcher/docs/README.md +51 -0
  277. package/02. Layouts/composition/switcher/docs/api.json +37 -0
  278. package/02. Layouts/composition/switcher/examples/basic/code.html +3 -0
  279. package/02. Layouts/composition/switcher/examples/basic/preview.html +14 -0
  280. package/02. Layouts/composition/switcher/examples/index.json +9 -0
  281. package/02. Layouts/composition/switcher/src/switcher.scss +24 -0
  282. package/02. Layouts/composition/switcher/switcher.definition.json +26 -0
  283. package/02. Layouts/content/grid/docs/README.md +77 -0
  284. package/02. Layouts/content/grid/docs/api.json +67 -0
  285. package/02. Layouts/content/grid/examples/basic/code.html +2 -4
  286. package/02. Layouts/content/grid/examples/basic/preview.html +13 -4
  287. package/02. Layouts/content/grid/examples/dense/code.html +3 -0
  288. package/02. Layouts/content/grid/examples/dense/preview.html +18 -0
  289. package/02. Layouts/content/grid/examples/index.json +30 -2
  290. package/02. Layouts/content/grid/examples/large/code.html +3 -0
  291. package/02. Layouts/content/grid/examples/large/preview.html +14 -0
  292. package/02. Layouts/content/grid/examples/size-2xs/code.html +3 -0
  293. package/02. Layouts/content/grid/examples/size-2xs/preview.html +14 -0
  294. package/02. Layouts/content/grid/examples/size-xs/code.html +3 -0
  295. package/02. Layouts/content/grid/examples/size-xs/preview.html +14 -0
  296. package/02. Layouts/content/grid/grid.definition.json +5 -4
  297. package/02. Layouts/content/grid/src/grid.scss +32 -0
  298. package/02. Layouts/content/reel/docs/README.md +81 -0
  299. package/02. Layouts/content/reel/docs/api.json +67 -0
  300. package/02. Layouts/content/reel/examples/basic/code.html +3 -0
  301. package/02. Layouts/content/reel/examples/basic/preview.html +14 -0
  302. package/02. Layouts/content/reel/examples/index.json +30 -0
  303. package/02. Layouts/content/reel/examples/size-2xs/code.html +3 -0
  304. package/02. Layouts/content/reel/examples/size-2xs/preview.html +14 -0
  305. package/02. Layouts/content/reel/examples/size-xs/code.html +3 -0
  306. package/02. Layouts/content/reel/examples/size-xs/preview.html +14 -0
  307. package/02. Layouts/content/reel/examples/small/code.html +3 -0
  308. package/02. Layouts/content/reel/examples/small/preview.html +14 -0
  309. package/02. Layouts/content/reel/reel.definition.json +26 -0
  310. package/02. Layouts/content/reel/src/reel.scss +40 -0
  311. package/02. Layouts/primitives/center/center.definition.json +24 -0
  312. package/02. Layouts/primitives/center/docs/README.md +44 -0
  313. package/02. Layouts/primitives/center/docs/api.json +28 -0
  314. package/02. Layouts/primitives/center/examples/basic/code.html +3 -0
  315. package/02. Layouts/primitives/center/examples/basic/preview.html +4 -0
  316. package/02. Layouts/primitives/center/examples/index.json +16 -0
  317. package/02. Layouts/primitives/center/examples/minimum-height/code.html +3 -0
  318. package/02. Layouts/primitives/center/examples/minimum-height/preview.html +4 -0
  319. package/02. Layouts/primitives/center/src/center.html +3 -0
  320. package/02. Layouts/primitives/container/container.definition.json +24 -0
  321. package/02. Layouts/primitives/container/docs/README.md +44 -0
  322. package/02. Layouts/primitives/container/docs/api.json +28 -0
  323. package/02. Layouts/primitives/container/examples/basic/code.html +3 -0
  324. package/02. Layouts/primitives/container/examples/basic/preview.html +6 -0
  325. package/02. Layouts/primitives/container/examples/index.json +16 -0
  326. package/02. Layouts/primitives/container/examples/reading/code.html +3 -0
  327. package/02. Layouts/primitives/container/examples/reading/preview.html +4 -0
  328. package/02. Layouts/primitives/container/src/container.html +3 -0
  329. package/02. Layouts/primitives/frame/docs/README.md +45 -0
  330. package/02. Layouts/primitives/frame/docs/api.json +29 -0
  331. package/02. Layouts/primitives/frame/examples/basic/code.html +3 -0
  332. package/02. Layouts/primitives/frame/examples/basic/preview.html +6 -0
  333. package/02. Layouts/primitives/frame/examples/index.json +16 -0
  334. package/02. Layouts/primitives/frame/examples/square/code.html +3 -0
  335. package/02. Layouts/primitives/frame/examples/square/preview.html +6 -0
  336. package/02. Layouts/primitives/frame/frame.definition.json +24 -0
  337. package/02. Layouts/primitives/frame/src/frame.html +3 -0
  338. package/02. Layouts/sections/bleed/bleed.definition.json +24 -0
  339. package/02. Layouts/sections/bleed/docs/README.md +45 -0
  340. package/02. Layouts/sections/bleed/docs/api.json +33 -0
  341. package/02. Layouts/sections/bleed/examples/basic/code.html +11 -0
  342. package/02. Layouts/sections/bleed/examples/basic/preview.html +14 -0
  343. package/02. Layouts/sections/bleed/examples/index.json +16 -0
  344. package/02. Layouts/sections/bleed/examples/reading/code.html +11 -0
  345. package/02. Layouts/sections/bleed/examples/reading/preview.html +14 -0
  346. package/02. Layouts/sections/bleed/src/bleed.html +11 -0
  347. package/02. Layouts/sections/content-grid/content-grid.definition.json +26 -0
  348. package/02. Layouts/sections/content-grid/docs/README.md +59 -0
  349. package/02. Layouts/sections/content-grid/docs/api.json +38 -0
  350. package/02. Layouts/sections/content-grid/examples/basic/code.html +11 -0
  351. package/02. Layouts/sections/content-grid/examples/basic/preview.html +10 -0
  352. package/02. Layouts/sections/content-grid/examples/index.json +9 -0
  353. package/02. Layouts/sections/content-grid/src/content-grid.scss +16 -0
  354. package/02. Layouts/sections/cover/cover.definition.json +26 -0
  355. package/02. Layouts/sections/cover/docs/README.md +60 -0
  356. package/02. Layouts/sections/cover/docs/api.json +50 -0
  357. package/02. Layouts/sections/cover/examples/basic/code.html +11 -0
  358. package/02. Layouts/sections/cover/examples/basic/preview.html +8 -0
  359. package/02. Layouts/sections/cover/examples/compact/code.html +11 -0
  360. package/02. Layouts/sections/cover/examples/compact/preview.html +8 -0
  361. package/02. Layouts/sections/cover/examples/index.json +16 -0
  362. package/02. Layouts/sections/cover/src/cover.scss +41 -0
  363. package/02. Layouts/sections/section/docs/README.md +52 -0
  364. package/02. Layouts/sections/section/docs/api.json +63 -0
  365. package/02. Layouts/sections/section/examples/basic/code.html +2 -2
  366. package/02. Layouts/sections/section/examples/basic/preview.html +5 -2
  367. package/02. Layouts/sections/section/examples/index.json +37 -2
  368. package/02. Layouts/sections/section/examples/size-2xs/code.html +5 -0
  369. package/02. Layouts/sections/section/examples/size-2xs/preview.html +8 -0
  370. package/02. Layouts/sections/section/examples/size-md/code.html +5 -0
  371. package/02. Layouts/sections/section/examples/size-md/preview.html +8 -0
  372. package/02. Layouts/sections/section/examples/size-sm/code.html +5 -0
  373. package/02. Layouts/sections/section/examples/size-sm/preview.html +8 -0
  374. package/02. Layouts/sections/section/examples/size-xl/code.html +5 -0
  375. package/02. Layouts/sections/section/examples/size-xl/preview.html +8 -0
  376. package/02. Layouts/sections/section/examples/size-xs/code.html +5 -0
  377. package/02. Layouts/sections/section/examples/size-xs/preview.html +8 -0
  378. package/02. Layouts/sections/section/section.definition.json +8 -6
  379. package/02. Layouts/sections/section/src/section.html +5 -0
  380. package/03. Components/cards/card/card.definition.json +36 -0
  381. package/03. Components/cards/card/docs/README.md +27 -0
  382. package/03. Components/cards/card/docs/api.json +64 -0
  383. package/03. Components/cards/card/examples/badge-status/code.html +9 -0
  384. package/03. Components/cards/card/examples/badge-status/preview.html +9 -0
  385. package/03. Components/cards/card/examples/basic/code.html +6 -0
  386. package/03. Components/cards/card/examples/basic/preview.html +6 -0
  387. package/03. Components/cards/card/examples/button-action/code.html +11 -0
  388. package/03. Components/cards/card/examples/button-action/preview.html +11 -0
  389. package/03. Components/cards/card/examples/header-footer/code.html +13 -0
  390. package/03. Components/cards/card/examples/header-footer/preview.html +13 -0
  391. package/03. Components/cards/card/examples/index.json +48 -0
  392. package/03. Components/cards/card/examples/media/code.html +9 -0
  393. package/03. Components/cards/card/examples/media/preview.html +9 -0
  394. package/03. Components/cards/card/src/card.scss +56 -0
  395. package/03. Components/cards/card-disclosure/card-disclosure.definition.json +27 -0
  396. package/03. Components/cards/card-disclosure/docs/README.md +24 -0
  397. package/03. Components/cards/card-disclosure/docs/api.json +58 -0
  398. package/03. Components/cards/card-disclosure/examples/basic/code.html +16 -0
  399. package/03. Components/cards/card-disclosure/examples/basic/preview.html +16 -0
  400. package/03. Components/cards/card-disclosure/examples/expanded/code.html +16 -0
  401. package/03. Components/cards/card-disclosure/examples/expanded/preview.html +16 -0
  402. package/03. Components/cards/card-disclosure/examples/index.json +17 -0
  403. package/03. Components/cards/card-disclosure/src/card-disclosure.html +16 -0
  404. package/03. Components/cards/card-utility-summary/card-utility-summary.definition.json +24 -0
  405. package/03. Components/cards/card-utility-summary/docs/README.md +23 -0
  406. package/03. Components/cards/card-utility-summary/docs/api.json +33 -0
  407. package/03. Components/cards/card-utility-summary/examples/basic/code.html +13 -0
  408. package/03. Components/cards/card-utility-summary/examples/basic/preview.html +13 -0
  409. package/03. Components/cards/card-utility-summary/examples/compact/code.html +8 -0
  410. package/03. Components/cards/card-utility-summary/examples/compact/preview.html +8 -0
  411. package/03. Components/cards/card-utility-summary/examples/index.json +17 -0
  412. package/03. Components/cards/card-utility-summary/src/card-utility-summary.html +13 -0
  413. package/03. Components/data-display/statistics/stat-card/docs/README.md +104 -0
  414. package/03. Components/data-display/statistics/stat-card/docs/api.json +153 -0
  415. package/03. Components/data-display/statistics/stat-card/examples/action/code.html +8 -0
  416. package/03. Components/data-display/statistics/stat-card/examples/action/preview.html +21 -0
  417. package/03. Components/data-display/statistics/stat-card/examples/coloured-values/code.html +4 -0
  418. package/03. Components/data-display/statistics/stat-card/examples/coloured-values/preview.html +14 -0
  419. package/03. Components/data-display/statistics/stat-card/examples/icon-led/code.html +13 -0
  420. package/03. Components/data-display/statistics/stat-card/examples/icon-led/preview.html +27 -0
  421. package/03. Components/data-display/statistics/stat-card/examples/icons/code.html +8 -0
  422. package/03. Components/data-display/statistics/stat-card/examples/icons/preview.html +27 -0
  423. package/03. Components/data-display/statistics/stat-card/examples/index.json +117 -0
  424. package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/code.html +8 -0
  425. package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/preview.html +18 -0
  426. package/03. Components/data-display/statistics/stat-card/examples/long-value/code.html +5 -0
  427. package/03. Components/data-display/statistics/stat-card/examples/long-value/preview.html +7 -0
  428. package/03. Components/data-display/statistics/stat-card/examples/minimal/code.html +4 -0
  429. package/03. Components/data-display/statistics/stat-card/examples/minimal/preview.html +14 -0
  430. package/03. Components/data-display/statistics/stat-card/examples/sentiments/code.html +11 -0
  431. package/03. Components/data-display/statistics/stat-card/examples/sentiments/preview.html +26 -0
  432. package/03. Components/data-display/statistics/stat-card/examples/sizes/code.html +4 -0
  433. package/03. Components/data-display/statistics/stat-card/examples/sizes/preview.html +14 -0
  434. package/03. Components/data-display/statistics/stat-card/examples/standard/code.html +8 -0
  435. package/03. Components/data-display/statistics/stat-card/examples/standard/preview.html +23 -0
  436. package/03. Components/data-display/statistics/stat-card/examples/states/code.html +5 -0
  437. package/03. Components/data-display/statistics/stat-card/examples/states/preview.html +17 -0
  438. package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/code.html +8 -0
  439. package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/preview.html +18 -0
  440. package/03. Components/data-display/statistics/stat-card/src/stat-card.scss +253 -0
  441. package/03. Components/data-display/statistics/stat-card/stat-card.definition.json +49 -0
  442. package/03. Components/media/identity/avatar-group/avatar-group.definition.json +39 -0
  443. package/03. Components/media/identity/avatar-group/docs/README.md +37 -0
  444. package/03. Components/media/identity/avatar-group/docs/api.json +99 -0
  445. package/03. Components/media/identity/avatar-group/examples/count/code.html +19 -0
  446. package/03. Components/media/identity/avatar-group/examples/count/preview.html +19 -0
  447. package/03. Components/media/identity/avatar-group/examples/count-icon/code.html +19 -0
  448. package/03. Components/media/identity/avatar-group/examples/count-icon/preview.html +19 -0
  449. package/03. Components/media/identity/avatar-group/examples/group/code.html +18 -0
  450. package/03. Components/media/identity/avatar-group/examples/group/preview.html +18 -0
  451. package/03. Components/media/identity/avatar-group/examples/index.json +38 -0
  452. package/03. Components/media/identity/avatar-group/examples/rtl/code.html +19 -0
  453. package/03. Components/media/identity/avatar-group/examples/rtl/preview.html +19 -0
  454. package/03. Components/media/identity/avatar-group/examples/sizes/code.html +14 -0
  455. package/03. Components/media/identity/avatar-group/examples/sizes/preview.html +27 -0
  456. package/03. Components/media/identity/avatar-group/src/avatar-group.scss +72 -0
  457. package/03. Components/navigation/menus/navigation-menu/docs/README.md +34 -0
  458. package/03. Components/navigation/menus/navigation-menu/docs/api.json +70 -0
  459. package/03. Components/navigation/menus/navigation-menu/examples/groups/code.html +27 -0
  460. package/03. Components/navigation/menus/navigation-menu/examples/groups/preview.html +27 -0
  461. package/03. Components/navigation/menus/navigation-menu/examples/horizontal/code.html +19 -0
  462. package/03. Components/navigation/menus/navigation-menu/examples/horizontal/preview.html +19 -0
  463. package/03. Components/navigation/menus/navigation-menu/examples/icon-links/code.html +36 -0
  464. package/03. Components/navigation/menus/navigation-menu/examples/icon-links/preview.html +36 -0
  465. package/03. Components/navigation/menus/navigation-menu/examples/index.json +45 -0
  466. package/03. Components/navigation/menus/navigation-menu/examples/nested/code.html +21 -0
  467. package/03. Components/navigation/menus/navigation-menu/examples/nested/preview.html +21 -0
  468. package/03. Components/navigation/menus/navigation-menu/examples/separators/code.html +22 -0
  469. package/03. Components/navigation/menus/navigation-menu/examples/separators/preview.html +22 -0
  470. package/03. Components/navigation/menus/navigation-menu/examples/vertical/code.html +19 -0
  471. package/03. Components/navigation/menus/navigation-menu/examples/vertical/preview.html +19 -0
  472. package/03. Components/navigation/menus/navigation-menu/navigation-menu.definition.json +38 -0
  473. package/03. Components/navigation/menus/navigation-menu/src/navigation-menu.scss +78 -0
  474. package/03. Components/navigation/sidebars/floating-sidebar/docs/README.md +48 -0
  475. package/03. Components/navigation/sidebars/floating-sidebar/docs/api.json +58 -0
  476. package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/code.html +42 -0
  477. package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/preview.html +42 -0
  478. package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/code.html +43 -0
  479. package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/preview.html +43 -0
  480. package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/code.html +50 -0
  481. package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/preview.html +50 -0
  482. package/03. Components/navigation/sidebars/floating-sidebar/examples/index.json +50 -0
  483. package/03. Components/navigation/sidebars/floating-sidebar/examples/long/code.html +66 -0
  484. package/03. Components/navigation/sidebars/floating-sidebar/examples/long/preview.html +66 -0
  485. package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/code.html +51 -0
  486. package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/preview.html +51 -0
  487. package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/code.html +42 -0
  488. package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/preview.html +42 -0
  489. package/03. Components/navigation/sidebars/floating-sidebar/floating-sidebar.definition.json +52 -0
  490. package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.js +73 -0
  491. package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.scss +163 -0
  492. package/README.md +60 -11
  493. package/dist/catalogue.json +442 -0
  494. package/dist/components/app-shell.css +76 -64
  495. package/dist/components/avatar-group.css +69 -0
  496. package/dist/components/avatar.css +98 -176
  497. package/dist/components/badge.css +118 -0
  498. package/dist/components/button-lumen-shift.css +388 -0
  499. package/dist/components/button.css +58 -28
  500. package/dist/components/card.css +47 -0
  501. package/dist/components/checkbox.css +129 -0
  502. package/dist/components/content-grid.css +16 -0
  503. package/dist/components/cover.css +41 -0
  504. package/dist/components/floating-sidebar.css +163 -0
  505. package/dist/components/grid.css +23 -13
  506. package/dist/components/navigation-item.css +169 -0
  507. package/dist/components/navigation-menu.css +74 -0
  508. package/dist/components/overlap.css +51 -0
  509. package/dist/components/reel.css +40 -0
  510. package/dist/components/select.css +288 -0
  511. package/dist/components/sidebar.css +33 -17
  512. package/dist/components/split.css +23 -16
  513. package/dist/components/stat-card.css +219 -0
  514. package/dist/components/switcher.css +24 -0
  515. package/dist/components/tooltip.css +101 -0
  516. package/package.json +7 -4
  517. package/schemas/reusable-ui.schema.json +145 -2
  518. package/tooling/cli/asset-organisation.mjs +126 -0
  519. package/tooling/cli/build.mjs +14 -7
  520. package/tooling/cli/cli.mjs +46 -19
  521. package/tooling/cli/commands.mjs +10 -0
  522. package/tooling/cli/configuration.mjs +60 -0
  523. package/tooling/cli/migrate.mjs +7 -4
  524. package/tooling/cli/project.mjs +188 -20
  525. package/tooling/registry/catalogue-index.mjs +54 -0
  526. package/tooling/registry/categories.mjs +3 -0
  527. package/tooling/registry/definitions.mjs +86 -9
  528. package/tooling/registry/native.mjs +32 -0
  529. package/tools/build-css.mjs +84 -30
  530. package/01. Elements/actions/controls/button/button.scss +0 -80
  531. package/01. Elements/actions/controls/button/docs.md +0 -41
  532. package/01. Elements/media/identity/avatar/api.json +0 -126
  533. package/01. Elements/media/identity/avatar/avatar.scss +0 -80
  534. package/01. Elements/media/identity/avatar/docs.md +0 -64
  535. package/01. Elements/media/identity/avatar/examples/badges/code.html +0 -10
  536. package/01. Elements/media/identity/avatar/examples/badges/preview.html +0 -29
  537. package/01. Elements/media/identity/avatar/examples/fallbacks/code.html +0 -5
  538. package/01. Elements/media/identity/avatar/examples/fallbacks/preview.html +0 -23
  539. package/01. Elements/media/identity/avatar/examples/presence/code.html +0 -6
  540. package/01. Elements/media/identity/avatar/examples/presence/preview.html +0 -26
  541. package/01. Elements/media/identity/avatar/examples/shapes/code.html +0 -5
  542. package/01. Elements/media/identity/avatar/examples/shapes/preview.html +0 -17
  543. package/02. Layouts/application/app-shell/api.json +0 -46
  544. package/02. Layouts/application/app-shell/app-shell.scss +0 -68
  545. package/02. Layouts/application/app-shell/docs.md +0 -31
  546. package/02. Layouts/application/app-shell/examples/basic/code.html +0 -17
  547. package/02. Layouts/application/app-shell/examples/basic/preview.html +0 -17
  548. package/02. Layouts/application/app-shell/examples/collapsed/code.html +0 -17
  549. package/02. Layouts/application/app-shell/examples/collapsed/preview.html +0 -17
  550. package/02. Layouts/application/app-shell/examples/hidden/code.html +0 -17
  551. package/02. Layouts/application/app-shell/examples/hidden/preview.html +0 -17
  552. package/02. Layouts/composition/stack/api.json +0 -1
  553. package/02. Layouts/composition/stack/docs.md +0 -5
  554. package/02. Layouts/content/grid/api.json +0 -23
  555. package/02. Layouts/content/grid/docs.md +0 -19
  556. package/02. Layouts/content/grid/grid.scss +0 -5
  557. package/02. Layouts/content/split/api.json +0 -23
  558. package/02. Layouts/content/split/docs.md +0 -18
  559. package/02. Layouts/content/split/examples/basic/code.html +0 -4
  560. package/02. Layouts/content/split/examples/basic/preview.html +0 -4
  561. package/02. Layouts/content/split/examples/index.json +0 -9
  562. package/02. Layouts/content/split/split.scss +0 -7
  563. package/02. Layouts/primitives/overlay/api.json +0 -23
  564. package/02. Layouts/primitives/overlay/docs.md +0 -19
  565. package/02. Layouts/primitives/overlay/examples/basic/code.html +0 -5
  566. package/02. Layouts/primitives/overlay/examples/basic/preview.html +0 -5
  567. package/02. Layouts/primitives/overlay/examples/index.json +0 -9
  568. package/02. Layouts/primitives/overlay/overlay.definition.json +0 -25
  569. package/02. Layouts/primitives/overlay/overlay.scss +0 -4
  570. package/02. Layouts/sections/section/api.json +0 -23
  571. package/02. Layouts/sections/section/docs.md +0 -19
  572. package/02. Layouts/sections/section/section.scss +0 -4
  573. package/02. Layouts/sections/sidebar/api.json +0 -23
  574. package/02. Layouts/sections/sidebar/docs.md +0 -18
  575. package/02. Layouts/sections/sidebar/examples/basic/code.html +0 -4
  576. package/02. Layouts/sections/sidebar/examples/basic/preview.html +0 -4
  577. package/02. Layouts/sections/sidebar/examples/index.json +0 -9
  578. package/02. Layouts/sections/sidebar/sidebar.scss +0 -7
  579. package/dist/components/overlay.css +0 -17
  580. package/dist/components/section.css +0 -14
@@ -0,0 +1,49 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "stat-card",
4
+ "displayName": "Stat Card",
5
+ "description": "Flexible, compact KPI card with neutral semantic surfaces and composable value, comparison, icon and trend arrangements.",
6
+ "level": "components",
7
+ "category": [
8
+ "data-display",
9
+ "statistics",
10
+ "stat-card"
11
+ ],
12
+ "className": "bcc-stat-card",
13
+ "source": {
14
+ "scss": "03. Components/data-display/statistics/stat-card/src/stat-card.scss",
15
+ "css": "dist/components/stat-card.css"
16
+ },
17
+ "dependencies": {
18
+ "css": [
19
+ "foundations"
20
+ ]
21
+ },
22
+ "documentation": {
23
+ "guide": "docs/README.md",
24
+ "api": "docs/api.json",
25
+ "examples": "examples/index.json"
26
+ },
27
+ "customisation": {
28
+ "variables": [
29
+ "--bcc-stat-card-surface",
30
+ "--bcc-stat-card-padding",
31
+ "--bcc-stat-card-gap"
32
+ ],
33
+ "notes": [
34
+ "Visual anatomy is scoped to the component; the application owns values and trend calculations."
35
+ ]
36
+ },
37
+ "previewControls": {
38
+ "colourContexts": [
39
+ "neutral",
40
+ "primary",
41
+ "secondary",
42
+ "accent",
43
+ "success",
44
+ "warning",
45
+ "error",
46
+ "info"
47
+ ]
48
+ }
49
+ }
@@ -0,0 +1,39 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "avatar-group",
4
+ "displayName": "Avatar Group",
5
+ "description": "Overlapping avatars with CSS-only RTL-aware stacking, inherited named sizes and additional-person count.",
6
+ "level": "components",
7
+ "category": [
8
+ "media",
9
+ "identity"
10
+ ],
11
+ "className": "bcc-avatar-group",
12
+ "source": {
13
+ "scss": "03. Components/media/identity/avatar-group/src/avatar-group.scss",
14
+ "css": "dist/components/avatar-group.css"
15
+ },
16
+ "dependencies": {
17
+ "css": [
18
+ "foundations"
19
+ ],
20
+ "elements": [
21
+ "avatar"
22
+ ]
23
+ },
24
+ "documentation": {
25
+ "guide": "docs/README.md",
26
+ "api": "docs/api.json",
27
+ "examples": "examples/index.json"
28
+ },
29
+ "customisation": {
30
+ "variables": [
31
+ "--bcc-avatar-group-overlap",
32
+ "--bcc-avatar-group-ring-colour",
33
+ "--bcc-avatar-group-size"
34
+ ],
35
+ "notes": [
36
+ "Overlap and count are included in the Component stylesheet; consumers do not need to write SCSS."
37
+ ]
38
+ }
39
+ }
@@ -0,0 +1,37 @@
1
+ # Avatar Group
2
+
3
+ A Level 03 Component composing the Level 01 Avatar Element, with shadcn-style overlap and count, plus named size variants and RTL support.
4
+
5
+ ## Core-first implementation
6
+
7
+ Avatar Group owns overlap, stacking order, shared Avatar sizing and an overflow-count badge. These child relationships cannot be expressed by independent spacing utilities without requiring custom consumer SCSS. Border, text, fill, shape, size and spacing use BufferCore Semantics; the three group hooks own composition-specific dimensions and the group ring surface. The group requires no JavaScript.
8
+
9
+ ## Installation
10
+
11
+ ```bash
12
+ npx levelsui add avatar-group
13
+ npx levelsui activate avatar-group
14
+ npx levelsui build
15
+ ```
16
+
17
+ The registry installs its Avatar Element dependency. No user-authored SCSS is needed for overlapping layout, rings, group sizes or a count bubble.
18
+
19
+ ```html
20
+ <div class="bcc-avatar-group" aria-label="Project team">
21
+ <span class="bce-avatar" role="img" aria-label="Alex">
22
+ <span class="bce-avatar__face">
23
+ <span class="bce-avatar__fallback" aria-hidden="true">AL</span>
24
+ </span>
25
+ </span>
26
+ <span class="bce-avatar" role="img" aria-label="Jamie">
27
+ <span class="bce-avatar__face">
28
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
29
+ </span>
30
+ </span>
31
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
32
+ </div>
33
+ ```
34
+
35
+ The count is intentionally supplied by the application and not inferred using JavaScript. Use an icon instead of `+3` when suitable, but provide an accessible label. The group supports `xs`, `sm`, `md`, `lg`, `xl`, `2xl` via `.bcc-avatar-group--SIZE`. Individual Avatars may also specify a size, but mixing sizes changes overlap aesthetics.
36
+
37
+ `dir="rtl"` works without separate RTL styles because logical inline placement is used. Use ordinary interactive HTML around an Avatar when making a dropdown trigger; menu interaction is not part of Avatar Group.
@@ -0,0 +1,99 @@
1
+ {
2
+ "variants": [
3
+ {
4
+ "id": "default",
5
+ "className": "bcc-avatar-group",
6
+ "default": true
7
+ }
8
+ ],
9
+ "sizes": [
10
+ {
11
+ "id": "xs",
12
+ "className": "bcc-avatar-group--xs"
13
+ },
14
+ {
15
+ "id": "sm",
16
+ "className": "bcc-avatar-group--sm"
17
+ },
18
+ {
19
+ "id": "md",
20
+ "className": "bcc-avatar-group--md",
21
+ "default": true
22
+ },
23
+ {
24
+ "id": "lg",
25
+ "className": "bcc-avatar-group--lg"
26
+ },
27
+ {
28
+ "id": "xl",
29
+ "className": "bcc-avatar-group--xl"
30
+ },
31
+ {
32
+ "id": "2xl",
33
+ "className": "bcc-avatar-group--2xl"
34
+ }
35
+ ],
36
+ "anatomy": [
37
+ "avatar (Avatar Element, repeated)",
38
+ "count (optional)"
39
+ ],
40
+ "properties": [
41
+ {
42
+ "name": "Overlap",
43
+ "type": "CSS custom property",
44
+ "default": "--bc-size-ui-8",
45
+ "description": "--bcc-avatar-group-overlap controls overlap using logical margin-inline-start."
46
+ },
47
+ {
48
+ "name": "Count",
49
+ "type": "child class",
50
+ "default": "none",
51
+ "description": "Place .bcc-avatar-group__count last, using text such as +3 and a descriptive aria-label. Supply the real number from app data."
52
+ },
53
+ {
54
+ "name": "Direction",
55
+ "type": "HTML dir inheritance",
56
+ "default": "document",
57
+ "description": "Layout uses logical properties and follows dir=ltr or dir=rtl automatically."
58
+ }
59
+ ],
60
+ "accessibility": [
61
+ "Provide a meaningful accessible name on each Avatar (or link/button if interactive).",
62
+ "An overflow count needs an accessible label; +3 alone does not list hidden members.",
63
+ "Do not make a non-interactive avatar a keyboard focus target."
64
+ ],
65
+ "tags": [
66
+ "people",
67
+ "identity",
68
+ "composition",
69
+ "grouping",
70
+ "overlap"
71
+ ],
72
+ "notes": [
73
+ "The group uses its own authored CSS for overlap, ring and stacking; no consumer SCSS needed.",
74
+ "Depends on the Avatar Element; it does not duplicate Avatar image/fallback styling."
75
+ ],
76
+ "anatomyContract": [
77
+ {
78
+ "name": "root",
79
+ "selector": ".bcc-avatar-group",
80
+ "required": true,
81
+ "repeatable": false,
82
+ "description": "Container for related Avatar Elements."
83
+ },
84
+ {
85
+ "name": "avatar",
86
+ "selector": ".bce-avatar",
87
+ "required": true,
88
+ "repeatable": true,
89
+ "description": "One or more independent Avatar Elements, installed through the required dependency."
90
+ },
91
+ {
92
+ "name": "count",
93
+ "selector": ".bcc-avatar-group__count",
94
+ "required": false,
95
+ "repeatable": false,
96
+ "description": "Optional overflow count supplied as real DOM content."
97
+ }
98
+ ]
99
+ }
@@ -0,0 +1,19 @@
1
+ <div class="bcc-avatar-group" aria-label="Team members">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bce-avatar" role="img" aria-label="Alex">
14
+ <span class="bce-avatar__face">
15
+ <span class="bce-avatar__fallback" aria-hidden="true">AL</span>
16
+ </span>
17
+ </span>
18
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
19
+ </div>
@@ -0,0 +1,19 @@
1
+ <div class="bcc-avatar-group" aria-label="Team members">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bce-avatar" role="img" aria-label="Alex">
14
+ <span class="bce-avatar__face">
15
+ <span class="bce-avatar__fallback" aria-hidden="true">AL</span>
16
+ </span>
17
+ </span>
18
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
19
+ </div>
@@ -0,0 +1,19 @@
1
+ <div aria-label="Team members" class="bcc-avatar-group">
2
+ <span aria-label="Chris" class="bce-avatar" role="img">
3
+ <span class="bce-avatar__face">
4
+ <img alt="" class="bce-avatar__image" loading="lazy" src="https://github.com/shadcn.png"/>
5
+ <span aria-hidden="true" class="bce-avatar__fallback">CH</span>
6
+ </span>
7
+ </span>
8
+ <span aria-label="Jamie" class="bce-avatar" role="img">
9
+ <span class="bce-avatar__face">
10
+ <span aria-hidden="true" class="bce-avatar__fallback">JA</span>
11
+ </span>
12
+ </span>
13
+ <span aria-label="Alex" class="bce-avatar" role="img">
14
+ <span class="bce-avatar__face">
15
+ <span aria-hidden="true" class="bce-avatar__fallback">AL</span>
16
+ </span>
17
+ </span>
18
+ <span aria-label="Additional people" class="bcc-avatar-group__count"><iconify-icon aria-hidden="true" icon="hugeicons:add-01"></iconify-icon></span>
19
+ </div>
@@ -0,0 +1,19 @@
1
+ <div aria-label="Team members" class="bcc-avatar-group">
2
+ <span aria-label="Chris" class="bce-avatar" role="img">
3
+ <span class="bce-avatar__face">
4
+ <img alt="" class="bce-avatar__image" loading="lazy" src="https://github.com/shadcn.png"/>
5
+ <span aria-hidden="true" class="bce-avatar__fallback">CH</span>
6
+ </span>
7
+ </span>
8
+ <span aria-label="Jamie" class="bce-avatar" role="img">
9
+ <span class="bce-avatar__face">
10
+ <span aria-hidden="true" class="bce-avatar__fallback">JA</span>
11
+ </span>
12
+ </span>
13
+ <span aria-label="Alex" class="bce-avatar" role="img">
14
+ <span class="bce-avatar__face">
15
+ <span aria-hidden="true" class="bce-avatar__fallback">AL</span>
16
+ </span>
17
+ </span>
18
+ <span aria-label="Additional people" class="bcc-avatar-group__count"><iconify-icon aria-hidden="true" icon="hugeicons:add-01"></iconify-icon></span>
19
+ </div>
@@ -0,0 +1,18 @@
1
+ <div class="bcc-avatar-group" aria-label="Team members">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bce-avatar" role="img" aria-label="Alex">
14
+ <span class="bce-avatar__face">
15
+ <span class="bce-avatar__fallback" aria-hidden="true">AL</span>
16
+ </span>
17
+ </span>
18
+ </div>
@@ -0,0 +1,18 @@
1
+ <div class="bcc-avatar-group" aria-label="Team members">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bce-avatar" role="img" aria-label="Alex">
14
+ <span class="bce-avatar__face">
15
+ <span class="bce-avatar__fallback" aria-hidden="true">AL</span>
16
+ </span>
17
+ </span>
18
+ </div>
@@ -0,0 +1,38 @@
1
+ [
2
+ {
3
+ "id": "group",
4
+ "title": "Avatar Group",
5
+ "description": "Overlapping avatars",
6
+ "preview": "examples/group/preview.html",
7
+ "code": "examples/group/code.html",
8
+ "isBase": true
9
+ },
10
+ {
11
+ "id": "count",
12
+ "title": "Group count",
13
+ "description": "Count of additional people",
14
+ "preview": "examples/count/preview.html",
15
+ "code": "examples/count/code.html"
16
+ },
17
+ {
18
+ "id": "count-icon",
19
+ "title": "Count icon",
20
+ "description": "Icon replacing the text count",
21
+ "preview": "examples/count-icon/preview.html",
22
+ "code": "examples/count-icon/code.html"
23
+ },
24
+ {
25
+ "id": "sizes",
26
+ "title": "Group sizes",
27
+ "description": "Named sizes inherited by children",
28
+ "preview": "examples/sizes/preview.html",
29
+ "code": "examples/sizes/code.html"
30
+ },
31
+ {
32
+ "id": "rtl",
33
+ "title": "RTL group",
34
+ "description": "Logical overlap follows text direction",
35
+ "preview": "examples/rtl/preview.html",
36
+ "code": "examples/rtl/code.html"
37
+ }
38
+ ]
@@ -0,0 +1,19 @@
1
+ <div class="bcc-avatar-group" aria-label="Team members" dir="rtl">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bce-avatar" role="img" aria-label="Alex">
14
+ <span class="bce-avatar__face">
15
+ <span class="bce-avatar__fallback" aria-hidden="true">AL</span>
16
+ </span>
17
+ </span>
18
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
19
+ </div>
@@ -0,0 +1,19 @@
1
+ <div class="bcc-avatar-group" aria-label="Team members" dir="rtl">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bce-avatar" role="img" aria-label="Alex">
14
+ <span class="bce-avatar__face">
15
+ <span class="bce-avatar__fallback" aria-hidden="true">AL</span>
16
+ </span>
17
+ </span>
18
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
19
+ </div>
@@ -0,0 +1,14 @@
1
+ <div class="bcc-avatar-group bcc-avatar-group--lg" aria-label="Team members">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
14
+ </div>
@@ -0,0 +1,27 @@
1
+ <div class="bc-flex bc-flex-wrap bc-items-center bc-gap-md"><div class="bcc-avatar-group bcc-avatar-group--sm" aria-label="Team members">
2
+ <span class="bce-avatar" role="img" aria-label="Chris">
3
+ <span class="bce-avatar__face">
4
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
5
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
6
+ </span>
7
+ </span>
8
+ <span class="bce-avatar" role="img" aria-label="Jamie">
9
+ <span class="bce-avatar__face">
10
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
11
+ </span>
12
+ </span>
13
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
14
+ </div><div class="bcc-avatar-group bcc-avatar-group--lg" aria-label="Team members">
15
+ <span class="bce-avatar" role="img" aria-label="Chris">
16
+ <span class="bce-avatar__face">
17
+ <img class="bce-avatar__image" src="https://github.com/shadcn.png" alt="" loading="lazy">
18
+ <span class="bce-avatar__fallback" aria-hidden="true">CH</span>
19
+ </span>
20
+ </span>
21
+ <span class="bce-avatar" role="img" aria-label="Jamie">
22
+ <span class="bce-avatar__face">
23
+ <span class="bce-avatar__fallback" aria-hidden="true">JA</span>
24
+ </span>
25
+ </span>
26
+ <span class="bcc-avatar-group__count" aria-label="3 additional people">+3</span>
27
+ </div></div>
@@ -0,0 +1,72 @@
1
+ //
2
+ // Avatar Group — Level 03 / Components
3
+ //
4
+ // Avatar handles its own face and image; Group only owns composition.
5
+ // The inherited size controls unmodified child Avatars and the count.
6
+ //
7
+ .bcc-avatar-group {
8
+ --bcc-avatar-group-size: var(--bc-size-ui-40);
9
+ --bcc-avatar-group-overlap: var(--bc-size-ui-8);
10
+ --bcc-avatar-group-ring-colour: var(--bc-color-surface-context);
11
+ display: inline-flex;
12
+ align-items: center;
13
+ flex-wrap: nowrap;
14
+ padding-inline-end: var(--bc-size-ui-4);
15
+ isolation: isolate;
16
+ }
17
+
18
+ .bcc-avatar-group > .bce-avatar,
19
+ .bcc-avatar-group > .bcc-avatar-group__count {
20
+ position: relative;
21
+ box-sizing: border-box;
22
+ flex: none;
23
+ border: var(--bc-border-width-sm) solid var(--bcc-avatar-group-ring-colour);
24
+ border-radius: var(--bc-radius-full);
25
+ }
26
+
27
+ .bcc-avatar-group > .bce-avatar + .bce-avatar,
28
+ .bcc-avatar-group > .bcc-avatar-group__count:not(:first-child) {
29
+ margin-inline-start: calc(-1 * var(--bcc-avatar-group-overlap));
30
+ }
31
+
32
+ // Later positioned children naturally paint above earlier children in DOM order.
33
+
34
+ .bcc-avatar-group > .bcc-avatar-group__count {
35
+ display: inline-flex;
36
+ align-items: center;
37
+ justify-content: center;
38
+ inline-size: var(--bcc-avatar-group-size);
39
+ block-size: var(--bcc-avatar-group-size);
40
+ background: var(--bc-color-fill-context-soft);
41
+ color: var(--bc-color-text-context-strong);
42
+ font-family: var(--bc-type-label-2-font-family);
43
+ font-size: var(--bc-type-label-3-font-size);
44
+ font-weight: var(--bc-type-label-2-font-weight);
45
+ line-height: 1;
46
+ white-space: nowrap;
47
+ }
48
+
49
+ .bcc-avatar-group--xs {
50
+ --bcc-avatar-group-size: var(--bc-size-ui-24);
51
+ --bcc-avatar-group-overlap: var(--bc-size-ui-4);
52
+ }
53
+ .bcc-avatar-group--sm {
54
+ --bcc-avatar-group-size: var(--bc-size-ui-32);
55
+ --bcc-avatar-group-overlap: var(--bc-size-ui-6);
56
+ }
57
+ .bcc-avatar-group--md {
58
+ --bcc-avatar-group-size: var(--bc-size-ui-40);
59
+ --bcc-avatar-group-overlap: var(--bc-size-ui-8);
60
+ }
61
+ .bcc-avatar-group--lg {
62
+ --bcc-avatar-group-size: var(--bc-size-ui-48);
63
+ --bcc-avatar-group-overlap: var(--bc-size-ui-12);
64
+ }
65
+ .bcc-avatar-group--xl {
66
+ --bcc-avatar-group-size: var(--bc-size-ui-56);
67
+ --bcc-avatar-group-overlap: var(--bc-size-ui-12);
68
+ }
69
+ .bcc-avatar-group--2xl {
70
+ --bcc-avatar-group-size: var(--bc-size-ui-64);
71
+ --bcc-avatar-group-overlap: var(--bc-size-ui-16);
72
+ }
@@ -0,0 +1,34 @@
1
+ # Navigation Menu — Standard
2
+
3
+ Organises the existing Navigation Item Element into semantic navigation lists. The **minimum** is a usable vertical list of links, not an empty container.
4
+
5
+ ## Dependencies
6
+
7
+ - Required: BufferCore Foundations and the `navigation-item` Element.
8
+ - No JavaScript, Runtime mount, extra Component or icon bundle.
9
+ - The `icon-links` example uses consumer-provided Iconify/Hugeicons markup.
10
+
11
+ ## Anatomy
12
+
13
+ - `.bcc-navigation-menu` — outer `<nav>`, with an accessible label.
14
+ - `.bcc-navigation-menu__list` — native `<ul>` of navigation entries.
15
+ - `.bcc-navigation-menu__item` — native `<li>`; child uses `.bce-navigation-item`.
16
+ - Optional `.bcc-navigation-menu__group` and `__heading` for sections.
17
+ - Optional `.bcc-navigation-menu__separator` inside a separator list item.
18
+ - Optional `.bcc-navigation-menu__sublist` for nested, **visible** links.
19
+
20
+ ## Variants
21
+
22
+ - Default: vertical, fluid full-width navigation links.
23
+ - `--horizontal`: row of links that wraps instead of assuming a desktop viewport.
24
+
25
+ ## Composition and responsive behaviour
26
+
27
+ - Navigation Item owns anchor appearance, hover/current states, icons, and its own optional collapsed-label presentation; this Component never duplicates that styling.
28
+ - Nested links in this Asset are visible by default. An interactive nested disclosure, mega menu, responsive drawer, or shell-level collapse must be composed separately with appropriate BufferCore Behaviours. This prevents unused features being shipped with a basic menu.
29
+ - Orientation is a design option, **not** an automatic mobile/desktop switch. Parent Sidebar/Navbar decides whether to display, collapse or substitute navigation for available space and input method.
30
+ - Do not use ARIA `menu` / `menuitem` roles for ordinary website navigation. Links stay native anchors; disclosure toggles use buttons.
31
+
32
+ ## Production
33
+
34
+ Only the active Menu + required Navigation Item CSS gets included by the standard LevelsUI build graph. This Component adds no JavaScript. CSS is scoped to `.bcc-navigation-menu` and its own anatomy.
@@ -0,0 +1,70 @@
1
+ {
2
+ "variants": [
3
+ {
4
+ "id": "vertical",
5
+ "className": "bcc-navigation-menu",
6
+ "default": true
7
+ },
8
+ {
9
+ "id": "horizontal",
10
+ "className": "bcc-navigation-menu--horizontal"
11
+ }
12
+ ],
13
+ "anatomy": [
14
+ "root nav (required)",
15
+ "list (required)",
16
+ "item containing Navigation Item (repeatable)",
17
+ "group (optional)",
18
+ "heading (optional)",
19
+ "separator (optional)",
20
+ "sublist (optional)"
21
+ ],
22
+ "properties": [
23
+ {
24
+ "name": "Orientation",
25
+ "type": "CSS class",
26
+ "default": "vertical",
27
+ "description": "Add bcc-navigation-menu--horizontal for a wrapping row layout."
28
+ },
29
+ {
30
+ "name": "Groups",
31
+ "type": "optional markup",
32
+ "default": "none",
33
+ "description": "Wrap sections in __group and add labelled headings as needed."
34
+ },
35
+ {
36
+ "name": "Nested lists",
37
+ "type": "optional markup",
38
+ "default": "none",
39
+ "description": "Add __sublist for semantic child links; interactive disclosure is separately composed."
40
+ },
41
+ {
42
+ "name": "Spacing",
43
+ "type": "CSS custom properties",
44
+ "default": "BufferCore Semantics",
45
+ "description": "Use --bcc-navigation-menu-gap, --bcc-navigation-menu-group-gap and --bcc-navigation-menu-indent."
46
+ }
47
+ ],
48
+ "accessibility": [
49
+ "Use nav with an appropriate accessible label and native list/anchor semantics.",
50
+ "Mark only the current page with aria-current=\"page\" on Navigation Item.",
51
+ "Do not add role=\"menu\" or menuitem to ordinary site navigation.",
52
+ "Nested links are visible by default; a disclosure control must have separate keyboard- and touch-operable behaviour.",
53
+ "Horizontal wrapping is not a replacement for a responsive navigation shell."
54
+ ],
55
+ "tags": [
56
+ "navigation",
57
+ "menu",
58
+ "vertical",
59
+ "horizontal",
60
+ "grouped",
61
+ "nested",
62
+ "sidebar",
63
+ "navbar"
64
+ ],
65
+ "notes": [
66
+ "CSS-only Component; requires Navigation Item Element, no JavaScript or other Component.",
67
+ "No duplicate Navigation Item, collapse, drawer, mega-menu or disclosure implementations.",
68
+ "The consumer or a navigation shell controls breakpoint adaptations, mobile disclosure and overflow."
69
+ ]
70
+ }