@buffercreations/levelsui 0.1.0 → 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 +133 -18
  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
@@ -1,30 +1,145 @@
1
- # BufferCore LevelsUI
1
+ # LevelsUI
2
2
 
3
- The optional UI Asset Library and levelsui CLI, prepared locally as @buffercreations/levelsui. Not published by this implementation. BufferCore is the complete standalone design system and remains independent.
3
+ **LevelsUI** is a modular UI Asset Library built on [BufferCore](https://www.npmjs.com/package/@buffercreations/buffercore), providing reusable interface elements, layouts, components, templates and pages.
4
4
 
5
- Categories: 01. Elements, 02. Layouts, 03. Components, 04. Templates, 05. Pages. The current catalogue contains Button, Avatar, six authored Layouts and the utility-only Stack recipe. IDs/classes are preserved. Component means only the Components category.
5
+ Assets are designed to work with BufferCore's design tokens, utilities, Runtime and shared Behaviours, keeping custom CSS and JavaScript to a minimum.
6
6
 
7
- From a consumer with the locally packed packages installed:
7
+ ## Installation
8
8
 
9
- ```powershell
10
- npx --no-install levelsui init
11
- npx --no-install levelsui list
12
- npx --no-install levelsui add button
13
- npx --no-install levelsui activate button
14
- npx --no-install levelsui build --report --verbose
15
- npx --no-install levelsui doctor
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
+
11
+ ```bash
12
+ npm install @buffercreations/buffercore
13
+ npm install -D @buffercreations/levelsui sass
14
+ ```
15
+
16
+ Initialise LevelsUI in your project:
17
+
18
+ ```bash
19
+ npx levelsui init
20
+ ```
21
+
22
+ ## Usage
23
+
24
+ Browse the available Assets:
25
+
26
+ ```bash
27
+ npx levelsui list
28
+ npx levelsui search "stat card"
29
+ npx levelsui info button
30
+ ```
31
+
32
+ Add an Asset to your project:
33
+
34
+ ```bash
35
+ npx levelsui add button
16
36
  ```
17
37
 
18
- Install Sass as a consumer dev dependency; add esbuild for interactive builds. Generated buffercore-levels.css already includes full Core CSS. Generated ESM never auto-mounts: import mountBufferCoreAssets and call it explicitly; destroy its returned controller on teardown. No automatic lazy loading or CSS selector purging is claimed.
38
+ Install and activate one or more Assets with deduplicated dependencies (the default):
39
+
40
+ ```bash
41
+ npx levelsui add button badge
42
+ npx levelsui build
43
+ ```
44
+
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.
54
+
55
+ ## Asset Library
56
+
57
+ LevelsUI organises Assets into five categories:
58
+
59
+ | Category | Purpose |
60
+ |---|---|
61
+ | Elements | Fundamental interface building blocks |
62
+ | Layouts | Structure, positioning and composition |
63
+ | Components | Reusable interface patterns |
64
+ | Templates | Compositions for common interface structures |
65
+ | Pages | Complete page-level compositions |
66
+
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.
79
+
80
+ ## CLI
81
+
82
+ | Command | Description |
83
+ |---|---|
84
+ | `init` | Initialise LevelsUI in a project |
85
+ | `list` | List lightweight catalogue metadata or installed Assets |
86
+ | `search <terms>` | Search Asset IDs, names, families and categories |
87
+ | `info` | View Asset information |
88
+ | `add` | Install and activate one or more Assets by default; `--no-activate` installs source only |
89
+ | `activate` | Enable an installed Asset |
90
+ | `deactivate` | Disable an Asset |
91
+ | `update` | Update an installed Asset |
92
+ | `remove` | Remove an Asset |
93
+ | `prune` | Identify unused dependencies |
94
+ | `entries` | Generate Asset entry points |
95
+ | `build` | Build active Assets |
96
+ | `validate` | Validate Asset definitions |
97
+ | `doctor` | Check project configuration and installation health |
98
+ | `migrate` | Preview old consumer state migration; `--apply` writes, `--rollback --apply` restores backed-up state |
99
+
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.
101
+
102
+ ## Requirements
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
+
110
+ - Node.js 20 or later
111
+ - Compatible BufferCore installed in the project
112
+ - Sass for builds; esbuild for interactive output
113
+
114
+ ## Packages
115
+
116
+ - [BufferCore](https://www.npmjs.com/package/@buffercreations/buffercore) — standalone design system
117
+ - [LevelsUI](https://www.npmjs.com/package/@buffercreations/levelsui) — optional UI Asset Library
118
+
119
+ ## Licence
120
+
121
+ See the included `LICENSE` file for terms of use.
122
+
123
+ ---
124
+
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
19
134
 
20
- Commands: init, list [--installed], info <id>, add <id>, activate/deactivate <id>, update <id>, remove <id>, prune, entries, build, validate, doctor, migrate [--rollback], help, --version. Options include --project and --registry. remove/prune/migrate are previews until --apply; add/update support --dry-run. Unknown options fail. buffercore and use/unuse remain compatibility aliases in this same package.
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.
21
136
 
22
- Installed schemaVersion 3 metadata is authoritative for build dependencies/source/mount contracts. Old consumers must run levelsui migrate, review the plan, then levelsui migrate --apply. Old trees and a hashed state backup remain; levelsui migrate --rollback --apply restores state while leaving copies intact. Modified files retain original recorded hashes; collisions, missing tracked source and modified definitions require manual review. See the workspace MIGRATION-GUIDE.md.
137
+ ## Composable optional Assets
23
138
 
24
- Authored definitions require className and source.scss/source.css. Utility-only definitions use kind: recipe and source.html, with no dummy CSS. Sources must be co-located with their definition and may use different filenames. Direct typed dependencies resolve once; cycles/type mismatches fail. Canonical examples have no inline presentation styles. Arbitrary registry executable source remains trusted input; path validation and checksums are not a sandbox or signature system.
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).
25
140
 
26
- The package includes required compiled CSS, schemas, examples and tooling; excludes Studio, Figma, private Flavours and token-authoring tools. npm run build compiles catalogue SCSS; npm run validate uses the same schema/graph as Studio and CLI.
141
+ ### Large catalogues
27
142
 
28
- ## Workspace maintainer releases
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.
29
144
 
30
- From the private workspace root, `npm run release:levelsui -- --core-archive "<verified compatible Core.tgz>"` packages only LevelsUI after testing that explicit Core archive. `release:package` prepares both products; versions remain independent. Versioned archives/checksums/metadata go under NPM Releases outside public package roots. `release:verify` rechecks existing bytes; `release:publish` is separate and requires owner authorisation and exact interactive confirmation. Application `levelsui` commands never publish packages. Development dependencies and useful caches remain in place.
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.