@buffercreations/levelsui 0.1.1 → 0.1.3

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 +34 -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 +138 -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 +136 -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,52 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "floating-sidebar",
4
+ "displayName": "Floating Sidebar",
5
+ "description": "Floating app navigation with functional expandable/icon-rail states, optional reversible motion and independently composed content.",
6
+ "level": "components",
7
+ "category": [
8
+ "navigation",
9
+ "sidebars"
10
+ ],
11
+ "className": "bcc-floating-sidebar",
12
+ "source": {
13
+ "scss": "03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.scss",
14
+ "css": "dist/components/floating-sidebar.css",
15
+ "js": "03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.js"
16
+ },
17
+ "dependencies": {
18
+ "css": [
19
+ "foundations"
20
+ ],
21
+ "layout": [
22
+ "sidebar"
23
+ ],
24
+ "components": [
25
+ "navigation-menu"
26
+ ],
27
+ "elements": [
28
+ "button"
29
+ ]
30
+ },
31
+ "documentation": {
32
+ "guide": "docs/README.md",
33
+ "api": "docs/api.json",
34
+ "examples": "examples/index.json"
35
+ },
36
+ "mount": {
37
+ "export": "mountFloatingSidebar",
38
+ "selector": ".bcc-floating-sidebar"
39
+ },
40
+ "customisation": {
41
+ "variables": [
42
+ "--bcc-floating-sidebar-width",
43
+ "--bcc-floating-sidebar-rail-width",
44
+ "--bcc-floating-sidebar-gap",
45
+ "--bcc-floating-sidebar-padding",
46
+ "--bcc-floating-sidebar-surface",
47
+ "--bcc-floating-sidebar-border",
48
+ "--bcc-floating-sidebar-radius",
49
+ "--bcc-floating-sidebar-shadow"
50
+ ]
51
+ }
52
+ }
@@ -0,0 +1,73 @@
1
+ // Floating Sidebar — Level 03 / Components.
2
+ // Only manages the rail's expanded/icon-only state. Navigation remains active
3
+ // in both states, so Core Disclosure (which conceals its panel) is not suitable.
4
+ const instances = new WeakMap();
5
+
6
+ /**
7
+ * Mount a Floating Sidebar's accessible expand/collapse control.
8
+ * @param {HTMLElement} root - The component root.
9
+ * @returns {{destroy: () => void, expand: () => void, collapse: () => void, toggle: () => void}}
10
+ */
11
+ export function mountFloatingSidebar(root) {
12
+ if (!root?.querySelector) throw new TypeError('Floating Sidebar requires an element root');
13
+ if (instances.has(root)) return instances.get(root);
14
+
15
+ const toggle = root.querySelector('.bcc-floating-sidebar__toggle');
16
+ const rail = root.querySelector('.bcc-floating-sidebar__rail');
17
+ const nav = root.querySelector('.bcc-navigation-menu');
18
+ if (!toggle || !rail || !nav || !root.contains(toggle) || !root.contains(nav)) {
19
+ throw new Error('Floating Sidebar requires a toggle, rail and Navigation Menu');
20
+ }
21
+ if (toggle.closest('.bcc-floating-sidebar') !== root) {
22
+ throw new Error('Floating Sidebar toggle must belong to this instance');
23
+ }
24
+
25
+ // Reuse Navigation Item's existing reversible transition. The Sidebar
26
+ // opts in once; callers don't need to mark every navigation link.
27
+ const addedMotionClasses = [];
28
+ if (root.classList.contains('bcc-floating-sidebar--animated')) {
29
+ for (const item of nav.querySelectorAll('.bce-navigation-item--collapsible')) {
30
+ if (!item.classList.contains('bce-navigation-item--animated')) {
31
+ item.classList.add('bce-navigation-item--animated');
32
+ addedMotionClasses.push(item);
33
+ }
34
+ }
35
+ }
36
+
37
+ const initial = root.getAttribute('data-collapsed');
38
+ let collapsed = initial === 'true';
39
+ let destroyed = false;
40
+
41
+ function render() {
42
+ root.dataset.collapsed = String(collapsed);
43
+ // The control expands the rail rather than concealing navigation links.
44
+ toggle.setAttribute('aria-expanded', String(!collapsed));
45
+ toggle.setAttribute('aria-label', collapsed ? 'Expand sidebar' : 'Collapse sidebar');
46
+ toggle.setAttribute('title', collapsed ? 'Expand sidebar' : 'Collapse sidebar');
47
+ }
48
+
49
+ function setCollapsed(next) {
50
+ if (destroyed) return;
51
+ collapsed = Boolean(next);
52
+ render();
53
+ }
54
+ const onClick = () => setCollapsed(!collapsed);
55
+ toggle.addEventListener('click', onClick);
56
+ render();
57
+
58
+ const controller = {
59
+ collapse: () => setCollapsed(true),
60
+ expand: () => setCollapsed(false),
61
+ toggle: onClick,
62
+ destroy() {
63
+ if (destroyed) return;
64
+ destroyed = true;
65
+ toggle.removeEventListener('click', onClick);
66
+ // Restore any classes that this controller added during mounting.
67
+ for (const item of addedMotionClasses) item.classList.remove('bce-navigation-item--animated');
68
+ instances.delete(root);
69
+ },
70
+ };
71
+ instances.set(root, controller);
72
+ return controller;
73
+ }
@@ -0,0 +1,138 @@
1
+ // Floating Sidebar — Level 03 / Components.
2
+ // Sidebar Layout owns the two-region anatomy; Navigation Menu and Navigation Item
3
+ // own link presentation. This Asset owns floating treatment and rail state only.
4
+ .bcc-floating-sidebar {
5
+ --bcc-floating-sidebar-width: var(--bc-size-ui-256);
6
+ --bcc-floating-sidebar-rail-width: var(--bc-size-ui-96);
7
+ --bcc-floating-sidebar-gap: var(--bc-fluid-md);
8
+ --bcc-floating-sidebar-padding: var(--bc-fluid-xs);
9
+ --bcc-floating-sidebar-surface: var(--bc-color-canvas-secondary);
10
+ --bcc-floating-sidebar-radius: var(--bc-radius-lg);
11
+ --bcc-floating-sidebar-toggle-size: var(--bc-size-ui-40);
12
+
13
+ // The generic Sidebar Layout still supplies the structural regions.
14
+ // This design fixes its aside to the required width, preserving a flexible main.
15
+ gap: var(--bcc-floating-sidebar-gap);
16
+ align-items: flex-start;
17
+ flex-wrap: nowrap;
18
+ min-inline-size: 0;
19
+ }
20
+
21
+ .bcc-floating-sidebar > .bcc-floating-sidebar__rail {
22
+ position: sticky;
23
+ inset-block-start: var(--bcc-floating-sidebar-gap);
24
+ flex: 0 0 var(--bcc-floating-sidebar-width);
25
+ box-sizing: border-box;
26
+ inline-size: var(--bcc-floating-sidebar-width);
27
+ max-block-size: calc(100dvh - var(--bcc-floating-sidebar-gap) - var(--bcc-floating-sidebar-gap));
28
+ min-inline-size: 0;
29
+ padding: var(--bcc-floating-sidebar-padding);
30
+ overflow-x: clip;
31
+ overflow-y: auto;
32
+ border-radius: var(--bcc-floating-sidebar-radius);
33
+ background: var(--bcc-floating-sidebar-surface);
34
+ }
35
+
36
+ .bcc-floating-sidebar > .bcc-floating-sidebar__main {
37
+ flex: 1 1 0;
38
+ min-inline-size: 0;
39
+ overflow-wrap: anywhere;
40
+ }
41
+
42
+ .bcc-floating-sidebar__header,
43
+ .bcc-floating-sidebar__footer {
44
+ display: flex;
45
+ align-items: center;
46
+ gap: var(--bc-fluid-2xs);
47
+ min-inline-size: 0;
48
+ }
49
+
50
+ .bcc-floating-sidebar__header {
51
+ // Keep the collapse control on the same icon track in both states.
52
+ // Do not move it from end alignment to centre during the width transition.
53
+ position: relative;
54
+ min-block-size: var(--bcc-floating-sidebar-toggle-size);
55
+ margin-block-end: var(--bc-fluid-xs);
56
+ }
57
+
58
+ .bcc-floating-sidebar__brand {
59
+ flex: 1 1 auto;
60
+ // Reserve the toggle track without changing its position.
61
+ margin-inline-start: calc(var(--bcc-floating-sidebar-toggle-size) + var(--bc-fluid-2xs));
62
+ min-inline-size: 0;
63
+ overflow: hidden;
64
+ white-space: nowrap;
65
+ text-overflow: ellipsis;
66
+ }
67
+
68
+ .bcc-floating-sidebar__footer { margin-block-start: var(--bc-fluid-xs); }
69
+
70
+ // Existing Button owns visual and focus states. Keep the toggle in a fixed
71
+ // track, so switching widths never makes its icon move unexpectedly.
72
+ .bcc-floating-sidebar__toggle {
73
+ // Position the button so its 20px icon aligns with Navigation Item's
74
+ // 16px inset and 20px icon track, whether the rail is wide or narrow.
75
+ position: absolute;
76
+ inset-block-start: 0;
77
+ inset-inline-start: calc(var(--bc-size-ui-16) - (var(--bcc-floating-sidebar-toggle-size) - var(--bc-size-ui-20)) / 2);
78
+ inline-size: var(--bcc-floating-sidebar-toggle-size);
79
+ block-size: var(--bcc-floating-sidebar-toggle-size);
80
+ flex: none;
81
+ }
82
+ .bcc-floating-sidebar__toggle > .bcc-floating-sidebar__toggle-icon {
83
+ display: inline-flex;
84
+ align-items: center;
85
+ justify-content: center;
86
+ inline-size: var(--bc-size-ui-20);
87
+ block-size: var(--bc-size-ui-20);
88
+ }
89
+ .bcc-floating-sidebar__toggle-icon > iconify-icon { inline-size: 100%; block-size: 100%; }
90
+ .bcc-floating-sidebar__toggle-icon--expand { display: none; }
91
+
92
+ .bcc-floating-sidebar[data-collapsed="true"] > .bcc-floating-sidebar__rail {
93
+ flex-basis: var(--bcc-floating-sidebar-rail-width);
94
+ inline-size: var(--bcc-floating-sidebar-rail-width);
95
+ }
96
+ .bcc-floating-sidebar[data-collapsed="true"] .bcc-floating-sidebar__header {
97
+ // Header geometry remains unchanged while the rail animates.
98
+ }
99
+ .bcc-floating-sidebar[data-collapsed="true"] .bcc-floating-sidebar__brand,
100
+ .bcc-floating-sidebar[data-collapsed="true"] .bcc-floating-sidebar__footer {
101
+ display: none;
102
+ }
103
+ .bcc-floating-sidebar[data-collapsed="true"] .bcc-floating-sidebar__toggle-icon--collapse { display: none; }
104
+ .bcc-floating-sidebar[data-collapsed="true"] .bcc-floating-sidebar__toggle-icon--expand { display: inline-flex; }
105
+
106
+ // The Navigation Item retains its real text label for keyboard and assistive
107
+ // technology users. Its own collapse rule clips only the visible label.
108
+ .bcc-floating-sidebar[data-collapsed="true"] .bcc-navigation-menu__heading {
109
+ position: absolute;
110
+ inline-size: 1px;
111
+ block-size: 1px;
112
+ overflow: hidden;
113
+ clip-path: inset(50%);
114
+ }
115
+
116
+ // Motion is genuinely opt-in. Width uses the same token in both directions;
117
+ // the Navigation Item animated modifier handles its label on the same timeline.
118
+ .bcc-floating-sidebar--animated > .bcc-floating-sidebar__rail {
119
+ transition: inline-size var(--bc-motion-interaction), flex-basis var(--bc-motion-interaction);
120
+ }
121
+
122
+ // Keep links reachable on small devices without an automatic drawer or a
123
+ // break-point-dependent state change that would desynchronise aria-expanded.
124
+ @media (max-width: 40rem) {
125
+ .bcc-floating-sidebar { flex-direction: column; }
126
+ // Preserve the expanded and collapsed rail widths on narrow previews.
127
+ // Forcing both states to 100% prevented the shared width transition.
128
+ .bcc-floating-sidebar > .bcc-floating-sidebar__rail {
129
+ position: static;
130
+ max-inline-size: 100%;
131
+ max-block-size: none;
132
+ }
133
+ .bcc-floating-sidebar > .bcc-floating-sidebar__main { inline-size: 100%; }
134
+ }
135
+
136
+ @media (prefers-reduced-motion: reduce) {
137
+ .bcc-floating-sidebar--animated > .bcc-floating-sidebar__rail { transition: none; }
138
+ }
package/README.md CHANGED
@@ -6,11 +6,11 @@ Assets are designed to work with BufferCore's design tokens, utilities, Runtime
6
6
 
7
7
  ## Installation
8
8
 
9
- Install BufferCore and LevelsUI:
9
+ Install available compatible registry versions of BufferCore and LevelsUI. Check this package's `peerDependencies` for its Core range; local development versions do not establish registry availability. For unpublished candidates install the exact locally verified tarballs instead.
10
10
 
11
11
  ```bash
12
12
  npm install @buffercreations/buffercore
13
- npm install -D @buffercreations/levelsui
13
+ npm install -D @buffercreations/levelsui sass
14
14
  ```
15
15
 
16
16
  Initialise LevelsUI in your project:
@@ -25,6 +25,7 @@ Browse the available Assets:
25
25
 
26
26
  ```bash
27
27
  npx levelsui list
28
+ npx levelsui search "stat card"
28
29
  npx levelsui info button
29
30
  ```
30
31
 
@@ -34,14 +35,22 @@ Add an Asset to your project:
34
35
  npx levelsui add button
35
36
  ```
36
37
 
37
- Activate it and build your Assets:
38
+ Install and activate one or more Assets with deduplicated dependencies (the default):
38
39
 
39
40
  ```bash
40
- npx levelsui activate button
41
+ npx levelsui add button badge
41
42
  npx levelsui build
42
43
  ```
43
44
 
44
- Only active Assets and their required dependencies are included in the generated Asset output.
45
+ To install source without activating it, use `--no-activate`:
46
+
47
+ ```bash
48
+ npx levelsui add button --no-activate
49
+ ```
50
+
51
+ Use `npx levelsui activate button` later if needed. Native-tag defaults are selected separately with `npx levelsui default button button`.
52
+
53
+ Only active Assets and their required dependencies are included in the generated Asset output. Load `dist/buffercore-levels.css` once: default combined mode includes full Core CSS. Interactive graphs additionally require esbuild and explicit application mounting/cleanup of generated JavaScript; imports do not mount automatically. CSS-only graphs emit no JS. Installed snapshots control builds until explicitly updated.
45
54
 
46
55
  ## Asset Library
47
56
 
@@ -55,16 +64,28 @@ LevelsUI organises Assets into five categories:
55
64
  | Templates | Compositions for common interface structures |
56
65
  | Pages | Complete page-level compositions |
57
66
 
58
- Assets can reference other Assets and shared BufferCore Behaviours.
67
+ Assets declare direct typed dependencies; the registry resolves transitive closure, rejects missing/wrong-type references and cycles, and deduplicates shared dependencies. Machine keys are `elements`, `layout`, `components`, `templates`, `pages`; CSS prefixes are `bce-`, `bcl-`, `bcc-`, `bct-`, `bcp-`. IDs are globally unique. Utility-only recipes use `kind: "recipe"` and `source.html` without a className or stylesheet. Shared declarative Behaviour dependency `disclosure` is supported; other identifiers are not automatically inferred.
68
+
69
+ ### Avatar and Avatar Group
70
+
71
+ The `avatar` Element provides image/fallback, badges, six named sizes and an optional image-state mount. `avatar-group` is a separate Component and automatically declares `avatar` as an Element dependency. Its overlap, size inheritance, count and RTL presentation are included — no project-specific SCSS is needed.
72
+
73
+ ```bash
74
+ npx levelsui add avatar-group
75
+ npx levelsui build
76
+ ```
77
+
78
+ See each Asset’s `docs/README.md`, `docs/api.json` and examples for the full plain-HTML contract. Grouping is CSS-only; reliable image error handling uses the Avatar controller, which is mounted through the existing Runtime when the Asset JS is active.
59
79
 
60
80
  ## CLI
61
81
 
62
82
  | Command | Description |
63
83
  |---|---|
64
84
  | `init` | Initialise LevelsUI in a project |
65
- | `list` | List available or installed Assets |
85
+ | `list` | List lightweight catalogue metadata or installed Assets |
86
+ | `search <terms>` | Search Asset IDs, names, families and categories |
66
87
  | `info` | View Asset information |
67
- | `add` | Install an Asset |
88
+ | `add` | Install and activate one or more Assets by default; `--no-activate` installs source only |
68
89
  | `activate` | Enable an installed Asset |
69
90
  | `deactivate` | Disable an Asset |
70
91
  | `update` | Update an installed Asset |
@@ -74,13 +95,21 @@ Assets can reference other Assets and shared BufferCore Behaviours.
74
95
  | `build` | Build active Assets |
75
96
  | `validate` | Validate Asset definitions |
76
97
  | `doctor` | Check project configuration and installation health |
98
+ | `migrate` | Preview old consumer state migration; `--apply` writes, `--rollback --apply` restores backed-up state |
77
99
 
78
- Run `npx levelsui help` for command details.
100
+ Run `npx --no-install levelsui help` for command details. `remove`, `prune` and `migrate` preview by default; mutation requires `--apply`. Builds use active Asset closure, not HTML selector purging or automatic per-route loading.
79
101
 
80
102
  ## Requirements
81
103
 
104
+ New projects can configure paths with `init --assets <dir> --scss-entry <file.scss> --js-entry <file.mjs> --overrides-path <dir> --css-output <file.css> --js-output <file.js> --core combined|separate`. All paths stay within the project. Use `--config <project-relative.json>` consistently for a non-default manifest location. Existing manifests retain their paths and installed snapshots.
105
+
106
+ `default` inspects ownership; `default <family> <asset|none>` changes it explicitly. New projects start without native defaults. `overrides <id>` optionally creates a project-owned Sass mixin exposing verified local CSS hooks. Its selector follows the design when defaults change; update/removal never rewrite the customisation file. `doctor` reports removed hooks for manual migration. Direct catalogue CSS retains its historical native defaults.
107
+
108
+ Combined CSS includes Core once. With `--core separate`, load compatible Core first, private Flavour exports next, and the generated LevelsUI CSS last. LevelsUI does not own Flavours. Never load full Core twice. Project colour contrast still needs browser-resolved validation; the CLI does not certify custom colours.
109
+
82
110
  - Node.js 20 or later
83
- - BufferCore installed in the project
111
+ - Compatible BufferCore installed in the project
112
+ - Sass for builds; esbuild for interactive output
84
113
 
85
114
  ## Packages
86
115
 
@@ -93,4 +122,24 @@ See the included `LICENSE` file for terms of use.
93
122
 
94
123
  ---
95
124
 
96
- Developed by **BufferCreations**.
125
+ Developed by **BufferCreations**.
126
+
127
+ ## Asset families and independent designs
128
+
129
+ Each Asset belongs to a Level and a category navigation path. The final segment can group a **family of independent designs**. For example, Standard Button (`button`) and Lumen Shift (`button-lumen-shift`) both use `actions / controls / button` for discovery, but remain independently installable, documented and styled Elements. They are not variants of the same Asset, and this virtual browsing branch does not need to match an additional physical folder.
130
+
131
+ `category` is not an installation, dependency or CSS inheritance contract. `native.family` is separate: it selects which eligible independent design may style the corresponding bare native HTML element in a consumer project. Variants such as Solid, Outline and Ghost remain local to their design. Always review an Asset's own definition, guide, API and Preview/Code files rather than assuming other members share its behaviour or customisation hooks.
132
+
133
+ ## Data-driven Asset authoring
134
+
135
+ When building statistics, tables, charts, filters or other dynamic Assets, follow the canonical [Data, state and Asset APIs standard](../03.%20Documentation/docs/levels/authoring-standards/data-state-and-asset-apis.md). Application data and business logic belong to consumers; LevelsUI documents real inputs, relevant accessible states and actual interactions. `docs/api.json` and Studio do not automatically implement props or data binding.
136
+
137
+ ## Composable optional Assets
138
+
139
+ Install a minimal Asset with its required dependencies; example-only Avatar/Card/Badge integrations remain separately installed and declared on their example index entry. Copyable Code must be complete and work without bespoke demo CSS/JS. See the [composition and optional Assets authoring contract](../03.%20Documentation/docs/levels/authoring-standards/composition-and-optional-assets.md).
140
+
141
+ ### Large catalogues
142
+
143
+ The library build creates `dist/catalogue.json`, a compact searchable metadata index. Installed npm packages use it for `levelsui list` and `levelsui search`, avoiding the cost of hydrating every Preview and Code example. Explicit local `--registry` sources are read live so edits cannot be hidden by a stale index. Installation, updates and validation still use the canonical definition files and fail on invalid dependency graphs.
144
+
145
+ The existing `buffercore.assets.json` tracks installed source digests, active roots and the source package version. Updates protect locally edited source and require explicit `levelsui update`. The generated CSS and JS include only the active dependency closure. The index is metadata, not a new runtime, and there is no remote download service or separate Asset version lockfile in this release.