@buffercreations/levelsui 0.1.1 → 0.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (580) hide show
  1. package/01. Elements/actions/controls/button/button.definition.json +38 -4
  2. package/01. Elements/actions/controls/button/docs/README.md +67 -0
  3. package/01. Elements/actions/controls/button/{api.json → docs/api.json } +14 -5
  4. package/01. Elements/actions/controls/button/examples/contexts/code.html +1 -3
  5. package/01. Elements/actions/controls/button/examples/contexts/preview.html +8 -2
  6. package/01. Elements/actions/controls/button/examples/icon-only/code.html +3 -0
  7. package/01. Elements/actions/controls/button/examples/icon-only/preview.html +17 -0
  8. package/01. Elements/actions/controls/button/examples/icons/code.html +2 -4
  9. package/01. Elements/actions/controls/button/examples/icons/preview.html +12 -3
  10. package/01. Elements/actions/controls/button/examples/index.json +9 -2
  11. package/01. Elements/actions/controls/button/examples/native-default/code.html +0 -8
  12. package/01. Elements/actions/controls/button/examples/native-default/preview.html +0 -4
  13. package/01. Elements/actions/controls/button/examples/states/code.html +1 -1
  14. package/01. Elements/actions/controls/button/examples/states/preview.html +2 -2
  15. package/01. Elements/actions/controls/button/src/button.scss +215 -0
  16. package/01. Elements/actions/controls/button-lumen-shift/button-lumen-shift.definition.json +95 -0
  17. package/01. Elements/actions/controls/button-lumen-shift/docs/README.md +85 -0
  18. package/01. Elements/actions/controls/button-lumen-shift/docs/api.json +134 -0
  19. package/01. Elements/actions/controls/button-lumen-shift/examples/basic/code.html +3 -0
  20. package/01. Elements/actions/controls/button-lumen-shift/examples/basic/preview.html +3 -0
  21. package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/code.html +1 -0
  22. package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/preview.html +9 -0
  23. package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/code.html +3 -0
  24. package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/preview.html +14 -0
  25. package/01. Elements/actions/controls/button-lumen-shift/examples/icons/code.html +4 -0
  26. package/01. Elements/actions/controls/button-lumen-shift/examples/icons/preview.html +14 -0
  27. package/01. Elements/actions/controls/button-lumen-shift/examples/index.json +66 -0
  28. package/01. Elements/actions/controls/button-lumen-shift/examples/links/code.html +3 -0
  29. package/01. Elements/actions/controls/button-lumen-shift/examples/links/preview.html +3 -0
  30. package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/code.html +1 -0
  31. package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/preview.html +6 -0
  32. package/01. Elements/actions/controls/button-lumen-shift/examples/states/code.html +1 -0
  33. package/01. Elements/actions/controls/button-lumen-shift/examples/states/preview.html +4 -0
  34. package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/code.html +1 -0
  35. package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/preview.html +5 -0
  36. package/01. Elements/actions/controls/button-lumen-shift/src/button-lumen-shift.scss +543 -0
  37. package/01. Elements/feedback/tooltip/docs/README.md +49 -0
  38. package/01. Elements/feedback/tooltip/docs/api.json +78 -0
  39. package/01. Elements/feedback/tooltip/examples/arrow/code.html +4 -0
  40. package/01. Elements/feedback/tooltip/examples/arrow/preview.html +4 -0
  41. package/01. Elements/feedback/tooltip/examples/comfortable/code.html +4 -0
  42. package/01. Elements/feedback/tooltip/examples/comfortable/preview.html +4 -0
  43. package/01. Elements/feedback/tooltip/examples/default/code.html +4 -0
  44. package/01. Elements/feedback/tooltip/examples/default/preview.html +4 -0
  45. package/01. Elements/feedback/tooltip/examples/delays/code.html +4 -0
  46. package/01. Elements/feedback/tooltip/examples/delays/preview.html +4 -0
  47. package/01. Elements/feedback/tooltip/examples/disabled/code.html +6 -0
  48. package/01. Elements/feedback/tooltip/examples/disabled/preview.html +6 -0
  49. package/01. Elements/feedback/tooltip/examples/index.json +66 -0
  50. package/01. Elements/feedback/tooltip/examples/multiple/code.html +8 -0
  51. package/01. Elements/feedback/tooltip/examples/multiple/preview.html +8 -0
  52. package/01. Elements/feedback/tooltip/examples/shortcut/code.html +4 -0
  53. package/01. Elements/feedback/tooltip/examples/shortcut/preview.html +4 -0
  54. package/01. Elements/feedback/tooltip/examples/sides/code.html +4 -0
  55. package/01. Elements/feedback/tooltip/examples/sides/preview.html +16 -0
  56. package/01. Elements/feedback/tooltip/src/tooltip.js +233 -0
  57. package/01. Elements/feedback/tooltip/src/tooltip.scss +117 -0
  58. package/01. Elements/feedback/tooltip/tooltip.definition.json +42 -0
  59. package/01. Elements/forms/selection/checkbox/checkbox.definition.json +65 -0
  60. package/01. Elements/forms/selection/checkbox/docs/README.md +46 -0
  61. package/01. Elements/forms/selection/checkbox/docs/api.json +102 -0
  62. package/01. Elements/forms/selection/checkbox/examples/basic/code.html +7 -0
  63. package/01. Elements/forms/selection/checkbox/examples/basic/preview.html +4 -0
  64. package/01. Elements/forms/selection/checkbox/examples/description/code.html +7 -0
  65. package/01. Elements/forms/selection/checkbox/examples/description/preview.html +7 -0
  66. package/01. Elements/forms/selection/checkbox/examples/group/code.html +9 -0
  67. package/01. Elements/forms/selection/checkbox/examples/group/preview.html +6 -0
  68. package/01. Elements/forms/selection/checkbox/examples/index.json +44 -0
  69. package/01. Elements/forms/selection/checkbox/examples/sizes/code.html +6 -0
  70. package/01. Elements/forms/selection/checkbox/examples/sizes/preview.html +5 -0
  71. package/01. Elements/forms/selection/checkbox/examples/states/code.html +6 -0
  72. package/01. Elements/forms/selection/checkbox/examples/states/preview.html +7 -0
  73. package/01. Elements/forms/selection/checkbox/examples/table/code.html +1 -0
  74. package/01. Elements/forms/selection/checkbox/examples/table/preview.html +8 -0
  75. package/01. Elements/forms/selection/checkbox/src/checkbox.scss +157 -0
  76. package/01. Elements/forms/selection/select/docs/README.md +37 -0
  77. package/01. Elements/forms/selection/select/docs/api.json +105 -0
  78. package/01. Elements/forms/selection/select/examples/default/code.html +12 -0
  79. package/01. Elements/forms/selection/select/examples/default/preview.html +12 -0
  80. package/01. Elements/forms/selection/select/examples/disabled/code.html +12 -0
  81. package/01. Elements/forms/selection/select/examples/disabled/preview.html +12 -0
  82. package/01. Elements/forms/selection/select/examples/index.json +74 -0
  83. package/01. Elements/forms/selection/select/examples/invalid/code.html +12 -0
  84. package/01. Elements/forms/selection/select/examples/invalid/preview.html +12 -0
  85. package/01. Elements/forms/selection/select/examples/leading-avatar/code.html +12 -0
  86. package/01. Elements/forms/selection/select/examples/leading-avatar/preview.html +12 -0
  87. package/01. Elements/forms/selection/select/examples/leading-icon/code.html +12 -0
  88. package/01. Elements/forms/selection/select/examples/leading-icon/preview.html +12 -0
  89. package/01. Elements/forms/selection/select/examples/native/code.html +12 -0
  90. package/01. Elements/forms/selection/select/examples/native/preview.html +12 -0
  91. package/01. Elements/forms/selection/select/examples/search/code.html +12 -0
  92. package/01. Elements/forms/selection/select/examples/search/preview.html +12 -0
  93. package/01. Elements/forms/selection/select/examples/sizes/code.html +12 -0
  94. package/01. Elements/forms/selection/select/examples/sizes/preview.html +36 -0
  95. package/01. Elements/forms/selection/select/examples/status-dot/code.html +12 -0
  96. package/01. Elements/forms/selection/select/examples/status-dot/preview.html +12 -0
  97. package/01. Elements/forms/selection/select/select.definition.json +69 -0
  98. package/01. Elements/forms/selection/select/src/select.js +477 -0
  99. package/01. Elements/forms/selection/select/src/select.scss +312 -0
  100. package/01. Elements/media/identity/avatar/avatar.definition.json +48 -5
  101. package/01. Elements/media/identity/avatar/docs/README.md +61 -0
  102. package/01. Elements/media/identity/avatar/docs/api.json +96 -0
  103. package/01. Elements/media/identity/avatar/examples/badge/code.html +7 -0
  104. package/01. Elements/media/identity/avatar/examples/badge/preview.html +7 -0
  105. package/01. Elements/media/identity/avatar/examples/badge-icon/code.html +7 -0
  106. package/01. Elements/media/identity/avatar/examples/badge-icon/preview.html +7 -0
  107. package/01. Elements/media/identity/avatar/examples/basic/code.html +6 -0
  108. package/01. Elements/media/identity/avatar/examples/basic/preview.html +6 -0
  109. package/01. Elements/media/identity/avatar/examples/dropdown/code.html +8 -0
  110. package/01. Elements/media/identity/avatar/examples/dropdown/preview.html +6 -0
  111. package/01. Elements/media/identity/avatar/examples/fallback/code.html +5 -0
  112. package/01. Elements/media/identity/avatar/examples/fallback/preview.html +5 -0
  113. package/01. Elements/media/identity/avatar/examples/index.json +68 -23
  114. package/01. Elements/media/identity/avatar/examples/notification-count/code.html +6 -0
  115. package/01. Elements/media/identity/avatar/examples/notification-count/preview.html +7 -0
  116. package/01. Elements/media/identity/avatar/examples/notification-dot/code.html +6 -0
  117. package/01. Elements/media/identity/avatar/examples/notification-dot/preview.html +7 -0
  118. package/01. Elements/media/identity/avatar/examples/sizes/code.html +2 -2
  119. package/01. Elements/media/identity/avatar/examples/sizes/preview.html +19 -26
  120. package/01. Elements/media/identity/avatar/examples/square/code.html +5 -0
  121. package/01. Elements/media/identity/avatar/examples/square/preview.html +5 -0
  122. package/01. Elements/media/identity/avatar/examples/status-contexts/code.html +6 -0
  123. package/01. Elements/media/identity/avatar/examples/status-contexts/preview.html +13 -0
  124. package/01. Elements/media/identity/avatar/src/avatar.js +42 -0
  125. package/01. Elements/media/identity/avatar/src/avatar.scss +172 -0
  126. package/01. Elements/navigation/items/navigation-item/docs/README.md +52 -0
  127. package/01. Elements/navigation/items/navigation-item/docs/api.json +84 -0
  128. package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/code.html +9 -0
  129. package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/preview.html +18 -0
  130. package/01. Elements/navigation/items/navigation-item/examples/collapsible/code.html +9 -0
  131. package/01. Elements/navigation/items/navigation-item/examples/collapsible/preview.html +18 -0
  132. package/01. Elements/navigation/items/navigation-item/examples/icon-label/code.html +6 -0
  133. package/01. Elements/navigation/items/navigation-item/examples/icon-label/preview.html +1 -0
  134. package/01. Elements/navigation/items/navigation-item/examples/icon-only/code.html +7 -0
  135. package/01. Elements/navigation/items/navigation-item/examples/icon-only/preview.html +1 -0
  136. package/01. Elements/navigation/items/navigation-item/examples/index.json +45 -0
  137. package/01. Elements/navigation/items/navigation-item/examples/label-only/code.html +3 -0
  138. package/01. Elements/navigation/items/navigation-item/examples/label-only/preview.html +1 -0
  139. package/01. Elements/navigation/items/navigation-item/examples/states/code.html +9 -0
  140. package/01. Elements/navigation/items/navigation-item/examples/states/preview.html +17 -0
  141. package/01. Elements/navigation/items/navigation-item/navigation-item.definition.json +40 -0
  142. package/01. Elements/navigation/items/navigation-item/src/navigation-item.scss +185 -0
  143. package/01. Elements/status/indicators/badge/badge.definition.json +55 -0
  144. package/01. Elements/status/indicators/badge/docs/README.md +40 -0
  145. package/01. Elements/status/indicators/badge/docs/api.json +112 -0
  146. package/01. Elements/status/indicators/badge/examples/content/code.html +1 -0
  147. package/01. Elements/status/indicators/badge/examples/content/preview.html +3 -0
  148. package/01. Elements/status/indicators/badge/examples/contexts/code.html +1 -0
  149. package/01. Elements/status/indicators/badge/examples/contexts/preview.html +3 -0
  150. package/01. Elements/status/indicators/badge/examples/icons/code.html +1 -0
  151. package/01. Elements/status/indicators/badge/examples/icons/preview.html +3 -0
  152. package/01. Elements/status/indicators/badge/examples/index.json +58 -0
  153. package/01. Elements/status/indicators/badge/examples/links/code.html +1 -0
  154. package/01. Elements/status/indicators/badge/examples/links/preview.html +3 -0
  155. package/01. Elements/status/indicators/badge/examples/loading/code.html +1 -0
  156. package/01. Elements/status/indicators/badge/examples/loading/preview.html +3 -0
  157. package/01. Elements/status/indicators/badge/examples/sizes/code.html +1 -0
  158. package/01. Elements/status/indicators/badge/examples/sizes/preview.html +3 -0
  159. package/01. Elements/status/indicators/badge/examples/status/code.html +1 -0
  160. package/01. Elements/status/indicators/badge/examples/status/preview.html +3 -0
  161. package/01. Elements/status/indicators/badge/examples/treatments/code.html +1 -0
  162. package/01. Elements/status/indicators/badge/examples/treatments/preview.html +3 -0
  163. package/01. Elements/status/indicators/badge/src/badge.scss +109 -0
  164. package/02. Layouts/REFINEMENT-REVIEW.md +82 -0
  165. package/02. Layouts/UTILITY-RECIPES.md +97 -9
  166. package/02. Layouts/application/app-shell/app-shell.definition.json +7 -6
  167. package/02. Layouts/application/app-shell/docs/README.md +64 -0
  168. package/02. Layouts/application/app-shell/docs/api.json +125 -0
  169. package/02. Layouts/application/app-shell/examples/complete/code.html +19 -0
  170. package/02. Layouts/application/app-shell/examples/complete/preview.html +28 -0
  171. package/02. Layouts/application/app-shell/examples/dual/code.html +13 -0
  172. package/02. Layouts/application/app-shell/examples/dual/preview.html +26 -0
  173. package/02. Layouts/application/app-shell/examples/header-main/code.html +10 -0
  174. package/02. Layouts/application/app-shell/examples/header-main/preview.html +19 -0
  175. package/02. Layouts/application/app-shell/examples/index.json +51 -15
  176. package/02. Layouts/application/app-shell/examples/main-only/code.html +7 -0
  177. package/02. Layouts/application/app-shell/examples/main-only/preview.html +18 -0
  178. package/02. Layouts/application/app-shell/examples/right/code.html +16 -0
  179. package/02. Layouts/application/app-shell/examples/right/preview.html +25 -0
  180. package/02. Layouts/application/app-shell/examples/sizes/code.html +16 -0
  181. package/02. Layouts/application/app-shell/examples/sizes/preview.html +27 -0
  182. package/02. Layouts/application/app-shell/examples/standard/code.html +13 -0
  183. package/02. Layouts/application/app-shell/examples/standard/preview.html +22 -0
  184. package/02. Layouts/application/app-shell/examples/sticky/code.html +16 -0
  185. package/02. Layouts/application/app-shell/examples/sticky/preview.html +23 -0
  186. package/02. Layouts/application/app-shell/src/app-shell.scss +119 -0
  187. package/02. Layouts/application/page-frame/docs/README.md +13 -0
  188. package/02. Layouts/application/page-frame/docs/api.json +33 -0
  189. package/02. Layouts/application/page-frame/examples/footer/code.html +8 -0
  190. package/02. Layouts/application/page-frame/examples/footer/preview.html +11 -0
  191. package/02. Layouts/application/page-frame/examples/header/code.html +8 -0
  192. package/02. Layouts/application/page-frame/examples/header/preview.html +11 -0
  193. package/02. Layouts/application/page-frame/examples/index.json +30 -0
  194. package/02. Layouts/application/page-frame/examples/main/code.html +5 -0
  195. package/02. Layouts/application/page-frame/examples/main/preview.html +10 -0
  196. package/02. Layouts/application/page-frame/examples/standard/code.html +11 -0
  197. package/02. Layouts/application/page-frame/examples/standard/preview.html +12 -0
  198. package/02. Layouts/application/page-frame/page-frame.definition.json +24 -0
  199. package/02. Layouts/application/page-frame/src/page-frame.html +11 -0
  200. package/02. Layouts/composition/cluster/cluster.definition.json +24 -0
  201. package/02. Layouts/composition/cluster/docs/README.md +45 -0
  202. package/02. Layouts/composition/cluster/docs/api.json +29 -0
  203. package/02. Layouts/composition/cluster/examples/basic/code.html +3 -0
  204. package/02. Layouts/composition/cluster/examples/basic/preview.html +6 -0
  205. package/02. Layouts/composition/cluster/examples/index.json +9 -0
  206. package/02. Layouts/composition/cluster/src/cluster.html +3 -0
  207. package/02. Layouts/composition/inline/docs/README.md +45 -0
  208. package/02. Layouts/composition/inline/docs/api.json +28 -0
  209. package/02. Layouts/composition/inline/examples/basic/code.html +3 -0
  210. package/02. Layouts/composition/inline/examples/basic/preview.html +4 -0
  211. package/02. Layouts/composition/inline/examples/index.json +16 -0
  212. package/02. Layouts/composition/inline/examples/scrolling/code.html +3 -0
  213. package/02. Layouts/composition/inline/examples/scrolling/preview.html +14 -0
  214. package/02. Layouts/composition/inline/inline.definition.json +24 -0
  215. package/02. Layouts/composition/inline/src/inline.html +3 -0
  216. package/02. Layouts/composition/overlap/docs/README.md +47 -0
  217. package/02. Layouts/composition/overlap/docs/api.json +59 -0
  218. package/02. Layouts/composition/overlap/examples/basic/code.html +8 -0
  219. package/02. Layouts/composition/overlap/examples/basic/preview.html +9 -0
  220. package/02. Layouts/composition/overlap/examples/index.json +44 -0
  221. package/02. Layouts/composition/overlap/examples/size-2xs/code.html +8 -0
  222. package/02. Layouts/composition/overlap/examples/size-2xs/preview.html +9 -0
  223. package/02. Layouts/composition/overlap/examples/size-lg/code.html +8 -0
  224. package/02. Layouts/composition/overlap/examples/size-lg/preview.html +9 -0
  225. package/02. Layouts/composition/overlap/examples/size-sm/code.html +8 -0
  226. package/02. Layouts/composition/overlap/examples/size-sm/preview.html +9 -0
  227. package/02. Layouts/composition/overlap/examples/size-xl/code.html +8 -0
  228. package/02. Layouts/composition/overlap/examples/size-xl/preview.html +9 -0
  229. package/02. Layouts/composition/overlap/examples/size-xs/code.html +8 -0
  230. package/02. Layouts/composition/overlap/examples/size-xs/preview.html +9 -0
  231. package/02. Layouts/composition/overlap/overlap.definition.json +26 -0
  232. package/02. Layouts/composition/overlap/src/overlap.scss +51 -0
  233. package/02. Layouts/composition/sidebar/docs/README.md +84 -0
  234. package/02. Layouts/composition/sidebar/docs/api.json +70 -0
  235. package/02. Layouts/composition/sidebar/examples/basic/code.html +8 -0
  236. package/02. Layouts/composition/sidebar/examples/basic/preview.html +14 -0
  237. package/02. Layouts/composition/sidebar/examples/index.json +37 -0
  238. package/02. Layouts/composition/sidebar/examples/large/code.html +8 -0
  239. package/02. Layouts/composition/sidebar/examples/large/preview.html +14 -0
  240. package/02. Layouts/composition/sidebar/examples/size-2xs/code.html +8 -0
  241. package/02. Layouts/composition/sidebar/examples/size-2xs/preview.html +14 -0
  242. package/02. Layouts/composition/sidebar/examples/size-xs/code.html +8 -0
  243. package/02. Layouts/composition/sidebar/examples/size-xs/preview.html +14 -0
  244. package/02. Layouts/composition/sidebar/examples/small/code.html +8 -0
  245. package/02. Layouts/composition/sidebar/examples/small/preview.html +14 -0
  246. package/02. Layouts/{sections → composition}/sidebar/sidebar.definition.json +6 -5
  247. package/02. Layouts/composition/sidebar/src/sidebar.scss +38 -0
  248. package/02. Layouts/composition/split/docs/README.md +56 -0
  249. package/02. Layouts/composition/split/docs/api.json +51 -0
  250. package/02. Layouts/composition/split/examples/basic/code.html +8 -0
  251. package/02. Layouts/composition/split/examples/basic/preview.html +10 -0
  252. package/02. Layouts/composition/split/examples/index.json +23 -0
  253. package/02. Layouts/composition/split/examples/wide-end/code.html +8 -0
  254. package/02. Layouts/composition/split/examples/wide-end/preview.html +10 -0
  255. package/02. Layouts/composition/split/examples/wide-start/code.html +8 -0
  256. package/02. Layouts/composition/split/examples/wide-start/preview.html +10 -0
  257. package/02. Layouts/{content → composition}/split/split.definition.json +6 -5
  258. package/02. Layouts/composition/split/src/split.scss +29 -0
  259. package/02. Layouts/composition/stack/docs/README.md +48 -0
  260. package/02. Layouts/composition/stack/docs/api.json +61 -0
  261. package/02. Layouts/composition/stack/examples/basic/code.html +1 -2
  262. package/02. Layouts/composition/stack/examples/basic/preview.html +12 -2
  263. package/02. Layouts/composition/stack/examples/compact/code.html +3 -0
  264. package/02. Layouts/composition/stack/examples/compact/preview.html +14 -0
  265. package/02. Layouts/composition/stack/examples/index.json +44 -1
  266. package/02. Layouts/composition/stack/examples/size-2xs/code.html +3 -0
  267. package/02. Layouts/composition/stack/examples/size-2xs/preview.html +14 -0
  268. package/02. Layouts/composition/stack/examples/size-lg/code.html +3 -0
  269. package/02. Layouts/composition/stack/examples/size-lg/preview.html +14 -0
  270. package/02. Layouts/composition/stack/examples/size-xl/code.html +3 -0
  271. package/02. Layouts/composition/stack/examples/size-xl/preview.html +14 -0
  272. package/02. Layouts/composition/stack/examples/size-xs/code.html +3 -0
  273. package/02. Layouts/composition/stack/examples/size-xs/preview.html +14 -0
  274. package/02. Layouts/composition/stack/{stack.html → src/stack.html } +1 -2
  275. package/02. Layouts/composition/stack/stack.definition.json +22 -5
  276. package/02. Layouts/composition/switcher/docs/README.md +51 -0
  277. package/02. Layouts/composition/switcher/docs/api.json +37 -0
  278. package/02. Layouts/composition/switcher/examples/basic/code.html +3 -0
  279. package/02. Layouts/composition/switcher/examples/basic/preview.html +14 -0
  280. package/02. Layouts/composition/switcher/examples/index.json +9 -0
  281. package/02. Layouts/composition/switcher/src/switcher.scss +24 -0
  282. package/02. Layouts/composition/switcher/switcher.definition.json +26 -0
  283. package/02. Layouts/content/grid/docs/README.md +77 -0
  284. package/02. Layouts/content/grid/docs/api.json +67 -0
  285. package/02. Layouts/content/grid/examples/basic/code.html +2 -4
  286. package/02. Layouts/content/grid/examples/basic/preview.html +13 -4
  287. package/02. Layouts/content/grid/examples/dense/code.html +3 -0
  288. package/02. Layouts/content/grid/examples/dense/preview.html +18 -0
  289. package/02. Layouts/content/grid/examples/index.json +30 -2
  290. package/02. Layouts/content/grid/examples/large/code.html +3 -0
  291. package/02. Layouts/content/grid/examples/large/preview.html +14 -0
  292. package/02. Layouts/content/grid/examples/size-2xs/code.html +3 -0
  293. package/02. Layouts/content/grid/examples/size-2xs/preview.html +14 -0
  294. package/02. Layouts/content/grid/examples/size-xs/code.html +3 -0
  295. package/02. Layouts/content/grid/examples/size-xs/preview.html +14 -0
  296. package/02. Layouts/content/grid/grid.definition.json +5 -4
  297. package/02. Layouts/content/grid/src/grid.scss +32 -0
  298. package/02. Layouts/content/reel/docs/README.md +81 -0
  299. package/02. Layouts/content/reel/docs/api.json +67 -0
  300. package/02. Layouts/content/reel/examples/basic/code.html +3 -0
  301. package/02. Layouts/content/reel/examples/basic/preview.html +14 -0
  302. package/02. Layouts/content/reel/examples/index.json +30 -0
  303. package/02. Layouts/content/reel/examples/size-2xs/code.html +3 -0
  304. package/02. Layouts/content/reel/examples/size-2xs/preview.html +14 -0
  305. package/02. Layouts/content/reel/examples/size-xs/code.html +3 -0
  306. package/02. Layouts/content/reel/examples/size-xs/preview.html +14 -0
  307. package/02. Layouts/content/reel/examples/small/code.html +3 -0
  308. package/02. Layouts/content/reel/examples/small/preview.html +14 -0
  309. package/02. Layouts/content/reel/reel.definition.json +26 -0
  310. package/02. Layouts/content/reel/src/reel.scss +40 -0
  311. package/02. Layouts/primitives/center/center.definition.json +24 -0
  312. package/02. Layouts/primitives/center/docs/README.md +44 -0
  313. package/02. Layouts/primitives/center/docs/api.json +28 -0
  314. package/02. Layouts/primitives/center/examples/basic/code.html +3 -0
  315. package/02. Layouts/primitives/center/examples/basic/preview.html +4 -0
  316. package/02. Layouts/primitives/center/examples/index.json +16 -0
  317. package/02. Layouts/primitives/center/examples/minimum-height/code.html +3 -0
  318. package/02. Layouts/primitives/center/examples/minimum-height/preview.html +4 -0
  319. package/02. Layouts/primitives/center/src/center.html +3 -0
  320. package/02. Layouts/primitives/container/container.definition.json +24 -0
  321. package/02. Layouts/primitives/container/docs/README.md +44 -0
  322. package/02. Layouts/primitives/container/docs/api.json +28 -0
  323. package/02. Layouts/primitives/container/examples/basic/code.html +3 -0
  324. package/02. Layouts/primitives/container/examples/basic/preview.html +6 -0
  325. package/02. Layouts/primitives/container/examples/index.json +16 -0
  326. package/02. Layouts/primitives/container/examples/reading/code.html +3 -0
  327. package/02. Layouts/primitives/container/examples/reading/preview.html +4 -0
  328. package/02. Layouts/primitives/container/src/container.html +3 -0
  329. package/02. Layouts/primitives/frame/docs/README.md +45 -0
  330. package/02. Layouts/primitives/frame/docs/api.json +29 -0
  331. package/02. Layouts/primitives/frame/examples/basic/code.html +3 -0
  332. package/02. Layouts/primitives/frame/examples/basic/preview.html +6 -0
  333. package/02. Layouts/primitives/frame/examples/index.json +16 -0
  334. package/02. Layouts/primitives/frame/examples/square/code.html +3 -0
  335. package/02. Layouts/primitives/frame/examples/square/preview.html +6 -0
  336. package/02. Layouts/primitives/frame/frame.definition.json +24 -0
  337. package/02. Layouts/primitives/frame/src/frame.html +3 -0
  338. package/02. Layouts/sections/bleed/bleed.definition.json +24 -0
  339. package/02. Layouts/sections/bleed/docs/README.md +45 -0
  340. package/02. Layouts/sections/bleed/docs/api.json +33 -0
  341. package/02. Layouts/sections/bleed/examples/basic/code.html +11 -0
  342. package/02. Layouts/sections/bleed/examples/basic/preview.html +14 -0
  343. package/02. Layouts/sections/bleed/examples/index.json +16 -0
  344. package/02. Layouts/sections/bleed/examples/reading/code.html +11 -0
  345. package/02. Layouts/sections/bleed/examples/reading/preview.html +14 -0
  346. package/02. Layouts/sections/bleed/src/bleed.html +11 -0
  347. package/02. Layouts/sections/content-grid/content-grid.definition.json +26 -0
  348. package/02. Layouts/sections/content-grid/docs/README.md +59 -0
  349. package/02. Layouts/sections/content-grid/docs/api.json +38 -0
  350. package/02. Layouts/sections/content-grid/examples/basic/code.html +11 -0
  351. package/02. Layouts/sections/content-grid/examples/basic/preview.html +10 -0
  352. package/02. Layouts/sections/content-grid/examples/index.json +9 -0
  353. package/02. Layouts/sections/content-grid/src/content-grid.scss +16 -0
  354. package/02. Layouts/sections/cover/cover.definition.json +26 -0
  355. package/02. Layouts/sections/cover/docs/README.md +60 -0
  356. package/02. Layouts/sections/cover/docs/api.json +50 -0
  357. package/02. Layouts/sections/cover/examples/basic/code.html +11 -0
  358. package/02. Layouts/sections/cover/examples/basic/preview.html +8 -0
  359. package/02. Layouts/sections/cover/examples/compact/code.html +11 -0
  360. package/02. Layouts/sections/cover/examples/compact/preview.html +8 -0
  361. package/02. Layouts/sections/cover/examples/index.json +16 -0
  362. package/02. Layouts/sections/cover/src/cover.scss +41 -0
  363. package/02. Layouts/sections/section/docs/README.md +52 -0
  364. package/02. Layouts/sections/section/docs/api.json +63 -0
  365. package/02. Layouts/sections/section/examples/basic/code.html +2 -2
  366. package/02. Layouts/sections/section/examples/basic/preview.html +5 -2
  367. package/02. Layouts/sections/section/examples/index.json +37 -2
  368. package/02. Layouts/sections/section/examples/size-2xs/code.html +5 -0
  369. package/02. Layouts/sections/section/examples/size-2xs/preview.html +8 -0
  370. package/02. Layouts/sections/section/examples/size-md/code.html +5 -0
  371. package/02. Layouts/sections/section/examples/size-md/preview.html +8 -0
  372. package/02. Layouts/sections/section/examples/size-sm/code.html +5 -0
  373. package/02. Layouts/sections/section/examples/size-sm/preview.html +8 -0
  374. package/02. Layouts/sections/section/examples/size-xl/code.html +5 -0
  375. package/02. Layouts/sections/section/examples/size-xl/preview.html +8 -0
  376. package/02. Layouts/sections/section/examples/size-xs/code.html +5 -0
  377. package/02. Layouts/sections/section/examples/size-xs/preview.html +8 -0
  378. package/02. Layouts/sections/section/section.definition.json +8 -6
  379. package/02. Layouts/sections/section/src/section.html +5 -0
  380. package/03. Components/cards/card/card.definition.json +36 -0
  381. package/03. Components/cards/card/docs/README.md +27 -0
  382. package/03. Components/cards/card/docs/api.json +64 -0
  383. package/03. Components/cards/card/examples/badge-status/code.html +9 -0
  384. package/03. Components/cards/card/examples/badge-status/preview.html +9 -0
  385. package/03. Components/cards/card/examples/basic/code.html +6 -0
  386. package/03. Components/cards/card/examples/basic/preview.html +6 -0
  387. package/03. Components/cards/card/examples/button-action/code.html +11 -0
  388. package/03. Components/cards/card/examples/button-action/preview.html +11 -0
  389. package/03. Components/cards/card/examples/header-footer/code.html +13 -0
  390. package/03. Components/cards/card/examples/header-footer/preview.html +13 -0
  391. package/03. Components/cards/card/examples/index.json +48 -0
  392. package/03. Components/cards/card/examples/media/code.html +9 -0
  393. package/03. Components/cards/card/examples/media/preview.html +9 -0
  394. package/03. Components/cards/card/src/card.scss +56 -0
  395. package/03. Components/cards/card-disclosure/card-disclosure.definition.json +27 -0
  396. package/03. Components/cards/card-disclosure/docs/README.md +24 -0
  397. package/03. Components/cards/card-disclosure/docs/api.json +58 -0
  398. package/03. Components/cards/card-disclosure/examples/basic/code.html +16 -0
  399. package/03. Components/cards/card-disclosure/examples/basic/preview.html +16 -0
  400. package/03. Components/cards/card-disclosure/examples/expanded/code.html +16 -0
  401. package/03. Components/cards/card-disclosure/examples/expanded/preview.html +16 -0
  402. package/03. Components/cards/card-disclosure/examples/index.json +17 -0
  403. package/03. Components/cards/card-disclosure/src/card-disclosure.html +16 -0
  404. package/03. Components/cards/card-utility-summary/card-utility-summary.definition.json +24 -0
  405. package/03. Components/cards/card-utility-summary/docs/README.md +23 -0
  406. package/03. Components/cards/card-utility-summary/docs/api.json +33 -0
  407. package/03. Components/cards/card-utility-summary/examples/basic/code.html +13 -0
  408. package/03. Components/cards/card-utility-summary/examples/basic/preview.html +13 -0
  409. package/03. Components/cards/card-utility-summary/examples/compact/code.html +8 -0
  410. package/03. Components/cards/card-utility-summary/examples/compact/preview.html +8 -0
  411. package/03. Components/cards/card-utility-summary/examples/index.json +17 -0
  412. package/03. Components/cards/card-utility-summary/src/card-utility-summary.html +13 -0
  413. package/03. Components/data-display/statistics/stat-card/docs/README.md +104 -0
  414. package/03. Components/data-display/statistics/stat-card/docs/api.json +153 -0
  415. package/03. Components/data-display/statistics/stat-card/examples/action/code.html +8 -0
  416. package/03. Components/data-display/statistics/stat-card/examples/action/preview.html +21 -0
  417. package/03. Components/data-display/statistics/stat-card/examples/coloured-values/code.html +4 -0
  418. package/03. Components/data-display/statistics/stat-card/examples/coloured-values/preview.html +14 -0
  419. package/03. Components/data-display/statistics/stat-card/examples/icon-led/code.html +13 -0
  420. package/03. Components/data-display/statistics/stat-card/examples/icon-led/preview.html +27 -0
  421. package/03. Components/data-display/statistics/stat-card/examples/icons/code.html +8 -0
  422. package/03. Components/data-display/statistics/stat-card/examples/icons/preview.html +27 -0
  423. package/03. Components/data-display/statistics/stat-card/examples/index.json +117 -0
  424. package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/code.html +8 -0
  425. package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/preview.html +18 -0
  426. package/03. Components/data-display/statistics/stat-card/examples/long-value/code.html +5 -0
  427. package/03. Components/data-display/statistics/stat-card/examples/long-value/preview.html +7 -0
  428. package/03. Components/data-display/statistics/stat-card/examples/minimal/code.html +4 -0
  429. package/03. Components/data-display/statistics/stat-card/examples/minimal/preview.html +14 -0
  430. package/03. Components/data-display/statistics/stat-card/examples/sentiments/code.html +11 -0
  431. package/03. Components/data-display/statistics/stat-card/examples/sentiments/preview.html +26 -0
  432. package/03. Components/data-display/statistics/stat-card/examples/sizes/code.html +4 -0
  433. package/03. Components/data-display/statistics/stat-card/examples/sizes/preview.html +14 -0
  434. package/03. Components/data-display/statistics/stat-card/examples/standard/code.html +8 -0
  435. package/03. Components/data-display/statistics/stat-card/examples/standard/preview.html +23 -0
  436. package/03. Components/data-display/statistics/stat-card/examples/states/code.html +5 -0
  437. package/03. Components/data-display/statistics/stat-card/examples/states/preview.html +17 -0
  438. package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/code.html +8 -0
  439. package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/preview.html +18 -0
  440. package/03. Components/data-display/statistics/stat-card/src/stat-card.scss +253 -0
  441. package/03. Components/data-display/statistics/stat-card/stat-card.definition.json +49 -0
  442. package/03. Components/media/identity/avatar-group/avatar-group.definition.json +39 -0
  443. package/03. Components/media/identity/avatar-group/docs/README.md +37 -0
  444. package/03. Components/media/identity/avatar-group/docs/api.json +99 -0
  445. package/03. Components/media/identity/avatar-group/examples/count/code.html +19 -0
  446. package/03. Components/media/identity/avatar-group/examples/count/preview.html +19 -0
  447. package/03. Components/media/identity/avatar-group/examples/count-icon/code.html +19 -0
  448. package/03. Components/media/identity/avatar-group/examples/count-icon/preview.html +19 -0
  449. package/03. Components/media/identity/avatar-group/examples/group/code.html +18 -0
  450. package/03. Components/media/identity/avatar-group/examples/group/preview.html +18 -0
  451. package/03. Components/media/identity/avatar-group/examples/index.json +38 -0
  452. package/03. Components/media/identity/avatar-group/examples/rtl/code.html +19 -0
  453. package/03. Components/media/identity/avatar-group/examples/rtl/preview.html +19 -0
  454. package/03. Components/media/identity/avatar-group/examples/sizes/code.html +14 -0
  455. package/03. Components/media/identity/avatar-group/examples/sizes/preview.html +27 -0
  456. package/03. Components/media/identity/avatar-group/src/avatar-group.scss +72 -0
  457. package/03. Components/navigation/menus/navigation-menu/docs/README.md +34 -0
  458. package/03. Components/navigation/menus/navigation-menu/docs/api.json +70 -0
  459. package/03. Components/navigation/menus/navigation-menu/examples/groups/code.html +27 -0
  460. package/03. Components/navigation/menus/navigation-menu/examples/groups/preview.html +27 -0
  461. package/03. Components/navigation/menus/navigation-menu/examples/horizontal/code.html +19 -0
  462. package/03. Components/navigation/menus/navigation-menu/examples/horizontal/preview.html +19 -0
  463. package/03. Components/navigation/menus/navigation-menu/examples/icon-links/code.html +36 -0
  464. package/03. Components/navigation/menus/navigation-menu/examples/icon-links/preview.html +36 -0
  465. package/03. Components/navigation/menus/navigation-menu/examples/index.json +45 -0
  466. package/03. Components/navigation/menus/navigation-menu/examples/nested/code.html +21 -0
  467. package/03. Components/navigation/menus/navigation-menu/examples/nested/preview.html +21 -0
  468. package/03. Components/navigation/menus/navigation-menu/examples/separators/code.html +22 -0
  469. package/03. Components/navigation/menus/navigation-menu/examples/separators/preview.html +22 -0
  470. package/03. Components/navigation/menus/navigation-menu/examples/vertical/code.html +19 -0
  471. package/03. Components/navigation/menus/navigation-menu/examples/vertical/preview.html +19 -0
  472. package/03. Components/navigation/menus/navigation-menu/navigation-menu.definition.json +38 -0
  473. package/03. Components/navigation/menus/navigation-menu/src/navigation-menu.scss +78 -0
  474. package/03. Components/navigation/sidebars/floating-sidebar/docs/README.md +48 -0
  475. package/03. Components/navigation/sidebars/floating-sidebar/docs/api.json +58 -0
  476. package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/code.html +42 -0
  477. package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/preview.html +42 -0
  478. package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/code.html +43 -0
  479. package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/preview.html +43 -0
  480. package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/code.html +50 -0
  481. package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/preview.html +50 -0
  482. package/03. Components/navigation/sidebars/floating-sidebar/examples/index.json +50 -0
  483. package/03. Components/navigation/sidebars/floating-sidebar/examples/long/code.html +66 -0
  484. package/03. Components/navigation/sidebars/floating-sidebar/examples/long/preview.html +66 -0
  485. package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/code.html +51 -0
  486. package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/preview.html +51 -0
  487. package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/code.html +42 -0
  488. package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/preview.html +42 -0
  489. package/03. Components/navigation/sidebars/floating-sidebar/floating-sidebar.definition.json +52 -0
  490. package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.js +73 -0
  491. package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.scss +163 -0
  492. package/README.md +60 -11
  493. package/dist/catalogue.json +442 -0
  494. package/dist/components/app-shell.css +76 -64
  495. package/dist/components/avatar-group.css +69 -0
  496. package/dist/components/avatar.css +98 -176
  497. package/dist/components/badge.css +118 -0
  498. package/dist/components/button-lumen-shift.css +388 -0
  499. package/dist/components/button.css +58 -28
  500. package/dist/components/card.css +47 -0
  501. package/dist/components/checkbox.css +129 -0
  502. package/dist/components/content-grid.css +16 -0
  503. package/dist/components/cover.css +41 -0
  504. package/dist/components/floating-sidebar.css +163 -0
  505. package/dist/components/grid.css +23 -13
  506. package/dist/components/navigation-item.css +169 -0
  507. package/dist/components/navigation-menu.css +74 -0
  508. package/dist/components/overlap.css +51 -0
  509. package/dist/components/reel.css +40 -0
  510. package/dist/components/select.css +288 -0
  511. package/dist/components/sidebar.css +33 -17
  512. package/dist/components/split.css +23 -16
  513. package/dist/components/stat-card.css +219 -0
  514. package/dist/components/switcher.css +24 -0
  515. package/dist/components/tooltip.css +101 -0
  516. package/package.json +7 -4
  517. package/schemas/reusable-ui.schema.json +145 -2
  518. package/tooling/cli/asset-organisation.mjs +126 -0
  519. package/tooling/cli/build.mjs +14 -7
  520. package/tooling/cli/cli.mjs +46 -19
  521. package/tooling/cli/commands.mjs +10 -0
  522. package/tooling/cli/configuration.mjs +60 -0
  523. package/tooling/cli/migrate.mjs +7 -4
  524. package/tooling/cli/project.mjs +188 -20
  525. package/tooling/registry/catalogue-index.mjs +54 -0
  526. package/tooling/registry/categories.mjs +3 -0
  527. package/tooling/registry/definitions.mjs +86 -9
  528. package/tooling/registry/native.mjs +32 -0
  529. package/tools/build-css.mjs +84 -30
  530. package/01. Elements/actions/controls/button/button.scss +0 -80
  531. package/01. Elements/actions/controls/button/docs.md +0 -41
  532. package/01. Elements/media/identity/avatar/api.json +0 -126
  533. package/01. Elements/media/identity/avatar/avatar.scss +0 -80
  534. package/01. Elements/media/identity/avatar/docs.md +0 -64
  535. package/01. Elements/media/identity/avatar/examples/badges/code.html +0 -10
  536. package/01. Elements/media/identity/avatar/examples/badges/preview.html +0 -29
  537. package/01. Elements/media/identity/avatar/examples/fallbacks/code.html +0 -5
  538. package/01. Elements/media/identity/avatar/examples/fallbacks/preview.html +0 -23
  539. package/01. Elements/media/identity/avatar/examples/presence/code.html +0 -6
  540. package/01. Elements/media/identity/avatar/examples/presence/preview.html +0 -26
  541. package/01. Elements/media/identity/avatar/examples/shapes/code.html +0 -5
  542. package/01. Elements/media/identity/avatar/examples/shapes/preview.html +0 -17
  543. package/02. Layouts/application/app-shell/api.json +0 -46
  544. package/02. Layouts/application/app-shell/app-shell.scss +0 -68
  545. package/02. Layouts/application/app-shell/docs.md +0 -31
  546. package/02. Layouts/application/app-shell/examples/basic/code.html +0 -17
  547. package/02. Layouts/application/app-shell/examples/basic/preview.html +0 -17
  548. package/02. Layouts/application/app-shell/examples/collapsed/code.html +0 -17
  549. package/02. Layouts/application/app-shell/examples/collapsed/preview.html +0 -17
  550. package/02. Layouts/application/app-shell/examples/hidden/code.html +0 -17
  551. package/02. Layouts/application/app-shell/examples/hidden/preview.html +0 -17
  552. package/02. Layouts/composition/stack/api.json +0 -1
  553. package/02. Layouts/composition/stack/docs.md +0 -5
  554. package/02. Layouts/content/grid/api.json +0 -23
  555. package/02. Layouts/content/grid/docs.md +0 -19
  556. package/02. Layouts/content/grid/grid.scss +0 -5
  557. package/02. Layouts/content/split/api.json +0 -23
  558. package/02. Layouts/content/split/docs.md +0 -18
  559. package/02. Layouts/content/split/examples/basic/code.html +0 -4
  560. package/02. Layouts/content/split/examples/basic/preview.html +0 -4
  561. package/02. Layouts/content/split/examples/index.json +0 -9
  562. package/02. Layouts/content/split/split.scss +0 -7
  563. package/02. Layouts/primitives/overlay/api.json +0 -23
  564. package/02. Layouts/primitives/overlay/docs.md +0 -19
  565. package/02. Layouts/primitives/overlay/examples/basic/code.html +0 -5
  566. package/02. Layouts/primitives/overlay/examples/basic/preview.html +0 -5
  567. package/02. Layouts/primitives/overlay/examples/index.json +0 -9
  568. package/02. Layouts/primitives/overlay/overlay.definition.json +0 -25
  569. package/02. Layouts/primitives/overlay/overlay.scss +0 -4
  570. package/02. Layouts/sections/section/api.json +0 -23
  571. package/02. Layouts/sections/section/docs.md +0 -19
  572. package/02. Layouts/sections/section/section.scss +0 -4
  573. package/02. Layouts/sections/sidebar/api.json +0 -23
  574. package/02. Layouts/sections/sidebar/docs.md +0 -18
  575. package/02. Layouts/sections/sidebar/examples/basic/code.html +0 -4
  576. package/02. Layouts/sections/sidebar/examples/basic/preview.html +0 -4
  577. package/02. Layouts/sections/sidebar/examples/index.json +0 -9
  578. package/02. Layouts/sections/sidebar/sidebar.scss +0 -7
  579. package/dist/components/overlay.css +0 -17
  580. package/dist/components/section.css +0 -14
@@ -0,0 +1,101 @@
1
+ .bce-tooltip {
2
+ --bce-tooltip-background: var(--bc-color-surface-general-primary);
3
+ --bce-tooltip-colour: var(--bc-color-text);
4
+ --bce-tooltip-border: var(--bc-color-border-neutral-subtle);
5
+ --bce-tooltip-shadow: var(--bc-shadow-soft-fallen);
6
+ --bce-tooltip-radius: var(--bc-radius-sm);
7
+ --bce-tooltip-offset: var(--bc-size-ui-8);
8
+ --bce-tooltip-max-width: var(--bc-size-ui-256);
9
+ display: inline-flex;
10
+ max-width: 100%;
11
+ vertical-align: middle;
12
+ }
13
+
14
+ .bce-tooltip__trigger {
15
+ display: inline-flex;
16
+ align-items: center;
17
+ max-width: 100%;
18
+ }
19
+
20
+ .bce-tooltip__offset {
21
+ position: absolute;
22
+ width: var(--bce-tooltip-offset);
23
+ height: 0;
24
+ visibility: hidden;
25
+ pointer-events: none;
26
+ }
27
+
28
+ .bce-tooltip__content {
29
+ position: fixed;
30
+ z-index: var(--bc-layer-floating);
31
+ box-sizing: border-box;
32
+ width: max-content;
33
+ max-width: min(var(--bce-tooltip-max-width), 100vw - var(--bc-size-ui-16));
34
+ padding: var(--bc-size-ui-6) var(--bc-size-ui-8);
35
+ border: var(--bc-border-width-xs) solid var(--bce-tooltip-border);
36
+ border-radius: var(--bce-tooltip-radius);
37
+ background: var(--bce-tooltip-background);
38
+ color: var(--bce-tooltip-colour);
39
+ box-shadow: var(--bce-tooltip-shadow);
40
+ font-family: var(--bc-type-label-4-font-family);
41
+ font-size: var(--bc-type-label-4-font-size);
42
+ font-weight: var(--bc-type-label-4-font-weight);
43
+ line-height: var(--bc-type-label-4-line-height);
44
+ letter-spacing: var(--bc-type-label-4-letter-spacing);
45
+ text-align: start;
46
+ overflow-wrap: anywhere;
47
+ pointer-events: auto;
48
+ }
49
+
50
+ .bce-tooltip__content[hidden] {
51
+ display: none;
52
+ }
53
+
54
+ .bce-tooltip__shortcut {
55
+ margin-left: var(--bc-size-ui-8);
56
+ color: var(--bc-color-text-muted);
57
+ white-space: nowrap;
58
+ }
59
+
60
+ .bce-tooltip__arrow {
61
+ position: absolute;
62
+ width: var(--bc-size-ui-8);
63
+ height: var(--bc-size-ui-8);
64
+ background: var(--bce-tooltip-background);
65
+ border-right: var(--bc-border-width-xs) solid var(--bce-tooltip-border);
66
+ border-bottom: var(--bc-border-width-xs) solid var(--bce-tooltip-border);
67
+ pointer-events: none;
68
+ }
69
+
70
+ .bce-tooltip[data-tooltip-resolved-side=top] .bce-tooltip__arrow {
71
+ bottom: calc(var(--bc-size-ui-4) * -1);
72
+ left: 50%;
73
+ transform: translateX(-50%) rotate(45deg);
74
+ }
75
+
76
+ .bce-tooltip[data-tooltip-resolved-side=bottom] .bce-tooltip__arrow {
77
+ top: calc(var(--bc-size-ui-4) * -1);
78
+ left: 50%;
79
+ transform: translateX(-50%) rotate(225deg);
80
+ }
81
+
82
+ .bce-tooltip[data-tooltip-resolved-side=left] .bce-tooltip__arrow {
83
+ right: calc(var(--bc-size-ui-4) * -1);
84
+ top: 50%;
85
+ transform: translateY(-50%) rotate(-45deg);
86
+ }
87
+
88
+ .bce-tooltip[data-tooltip-resolved-side=right] .bce-tooltip__arrow {
89
+ left: calc(var(--bc-size-ui-4) * -1);
90
+ top: 50%;
91
+ transform: translateY(-50%) rotate(135deg);
92
+ }
93
+
94
+ .bce-tooltip--comfortable .bce-tooltip__content {
95
+ padding: var(--bc-size-ui-8) var(--bc-size-ui-12);
96
+ font-family: var(--bc-type-label-3-font-family);
97
+ font-size: var(--bc-type-label-3-font-size);
98
+ font-weight: var(--bc-type-label-3-font-weight);
99
+ line-height: var(--bc-type-label-3-line-height);
100
+ letter-spacing: var(--bc-type-label-3-letter-spacing);
101
+ }
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@buffercreations/levelsui",
3
3
  "private": false,
4
- "version": "0.1.1",
4
+ "version": "0.1.4",
5
5
  "type": "module",
6
6
  "description": "BufferCore LevelsUI: optional Assets and management tooling",
7
7
  "scripts": {
@@ -9,11 +9,14 @@
9
9
  "validate": "node tools/validate.mjs",
10
10
  "test": "node --test tests/*.test.mjs",
11
11
  "test:avatar": "node tools/test-avatar.mjs",
12
+ "test:layouts": "node --test tools/layouts.test.mjs",
13
+ "test:layouts:browser": "node tools/test-layouts-browser.mjs",
14
+ "test:layouts:consumer": "node tools/test-layouts-consumer.mjs",
12
15
  "prepack": "npm run build && npm run validate"
13
16
  },
14
17
  "devDependencies": {
15
- "sass": "1.93.3",
16
- "@buffercreations/buffercore": "file:../01. BufferCore"
18
+ "@buffercreations/buffercore": "file:../01. BufferCore",
19
+ "sass": "1.93.3"
17
20
  },
18
21
  "files": [
19
22
  "01. Elements/",
@@ -42,7 +45,7 @@
42
45
  "ajv": "8.20.0"
43
46
  },
44
47
  "peerDependencies": {
45
- "@buffercreations/buffercore": "^0.8.0"
48
+ "@buffercreations/buffercore": "^0.8.2"
46
49
  },
47
50
  "publishConfig": {
48
51
  "access": "public"
@@ -71,7 +71,8 @@
71
71
  "type": "string",
72
72
  "pattern": "^[a-zA-Z0-9_ ./-]+\\.html$"
73
73
  }
74
- }
74
+ },
75
+ "description": "Registry-root-relative paths. New authored inputs live in the Asset src directory. Legacy co-located inputs remain supported. CSS stays in dist."
75
76
  },
76
77
  "dependencies": {
77
78
  "type": "object",
@@ -192,7 +193,8 @@
192
193
  "type": "string",
193
194
  "minLength": 1
194
195
  }
195
- }
196
+ },
197
+ "description": "Asset-relative guide, API and example paths. New Assets use docs/README.md, docs/api.json and examples/index.json."
196
198
  },
197
199
  "previewControls": {
198
200
  "type": "object",
@@ -217,6 +219,84 @@
217
219
  "info"
218
220
  ]
219
221
  }
222
+ },
223
+ "fields": {
224
+ "type": "array",
225
+ "maxItems": 8,
226
+ "items": {
227
+ "type": "object",
228
+ "additionalProperties": false,
229
+ "required": [
230
+ "label",
231
+ "selector",
232
+ "type"
233
+ ],
234
+ "properties": {
235
+ "label": {
236
+ "type": "string",
237
+ "minLength": 1,
238
+ "maxLength": 80
239
+ },
240
+ "selector": {
241
+ "type": "string",
242
+ "pattern": "^\\.(?:bce|bcl|bcc|bct|bcp)-[a-z0-9_-]+$"
243
+ },
244
+ "type": {
245
+ "enum": [
246
+ "select",
247
+ "text",
248
+ "content",
249
+ "context"
250
+ ]
251
+ },
252
+ "attribute": {
253
+ "type": "string",
254
+ "pattern": "^data-[a-z][a-z0-9-]*$"
255
+ },
256
+ "options": {
257
+ "type": "array",
258
+ "minItems": 1,
259
+ "uniqueItems": true,
260
+ "items": {
261
+ "type": "string",
262
+ "maxLength": 80
263
+ }
264
+ }
265
+ },
266
+ "allOf": [
267
+ {
268
+ "if": {
269
+ "properties": {
270
+ "type": {
271
+ "enum": [
272
+ "select",
273
+ "text"
274
+ ]
275
+ }
276
+ }
277
+ },
278
+ "then": {
279
+ "required": [
280
+ "attribute"
281
+ ]
282
+ }
283
+ },
284
+ {
285
+ "if": {
286
+ "properties": {
287
+ "type": {
288
+ "const": "select"
289
+ }
290
+ }
291
+ },
292
+ "then": {
293
+ "required": [
294
+ "options"
295
+ ]
296
+ }
297
+ }
298
+ ]
299
+ }
220
300
  }
221
301
  }
222
302
  },
@@ -275,6 +355,69 @@
275
355
  },
276
356
  "version": {
277
357
  "type": "string"
358
+ },
359
+ "native": {
360
+ "type": "object",
361
+ "additionalProperties": false,
362
+ "required": [
363
+ "family",
364
+ "selectors",
365
+ "eligible"
366
+ ],
367
+ "properties": {
368
+ "family": {
369
+ "enum": [
370
+ "button",
371
+ "text-input",
372
+ "checkbox",
373
+ "radio",
374
+ "select",
375
+ "textarea",
376
+ "table"
377
+ ]
378
+ },
379
+ "selectors": {
380
+ "type": "array",
381
+ "minItems": 1,
382
+ "uniqueItems": true,
383
+ "items": {
384
+ "type": "string"
385
+ }
386
+ },
387
+ "eligible": {
388
+ "type": "boolean"
389
+ },
390
+ "restrictions": {
391
+ "type": "array",
392
+ "items": {
393
+ "type": "string"
394
+ }
395
+ }
396
+ }
397
+ },
398
+ "customisation": {
399
+ "type": "object",
400
+ "additionalProperties": false,
401
+ "required": [
402
+ "variables"
403
+ ],
404
+ "properties": {
405
+ "variables": {
406
+ "type": "array",
407
+ "minItems": 1,
408
+ "uniqueItems": true,
409
+ "items": {
410
+ "type": "string",
411
+ "pattern": "^--(?:bce|bcl|bcc|bct|bcp)-[a-z0-9-]+$"
412
+ }
413
+ },
414
+ "notes": {
415
+ "type": "array",
416
+ "items": {
417
+ "type": "string"
418
+ }
419
+ }
420
+ }
278
421
  }
279
422
  },
280
423
  "$defs": {
@@ -0,0 +1,126 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import crypto from 'node:crypto';
4
+ import {assertWithin, safeRelative} from '../registry/paths.mjs';
5
+ import {resolveConfiguration} from './configuration.mjs';
6
+ import {validateReusableUiDefinition} from '../registry/definitions.mjs';
7
+
8
+ const digest = contents => crypto.createHash('sha256').update(contents).digest('hex');
9
+ const fileDigest = file => digest(fs.readFileSync(file));
10
+
11
+ // Copy from the installed snapshot only. Catalogue updates remain a separate action.
12
+ export function migrateAssetOrganisation(project, stateFile, journal, state, {apply = false} = {}) {
13
+ const root = resolveConfiguration(project, state.configuration).paths.assets;
14
+ const next = structuredClone(state);
15
+ const plans = [];
16
+ for (const [id, entry] of Object.entries(next.installed)) {
17
+ const definition = entry.definition;
18
+ const changes = [];
19
+ if (!safeRelative(entry.path) || definition?.id !== id) throw Error('Invalid installed identity/path');
20
+ const errors = validateReusableUiDefinition(definition);
21
+ if (errors.length) throw Error(id + ': invalid installed definition: ' + errors.join(', '));
22
+ for (const kind of ['scss', 'js', 'html']) {
23
+ const source = definition.source[kind];
24
+ if (!source) continue;
25
+ const relative = path.posix.relative(entry.path, source);
26
+ if (!safeRelative(relative)) throw Error(id + ': source escapes installed Asset');
27
+ if (!relative.includes('/')) {
28
+ changes.push([relative, 'src/' + relative]);
29
+ definition.source[kind] = entry.path + '/src/' + relative;
30
+ }
31
+ }
32
+ for (const [key, oldName, newName] of [['guide', 'docs.md', 'docs/README.md'], ['api', 'api.json', 'docs/api.json']]) {
33
+ if (definition.documentation?.[key] === oldName) {
34
+ changes.push([oldName, newName]);
35
+ definition.documentation[key] = newName;
36
+ }
37
+ }
38
+ if (!changes.length) continue;
39
+ const target = assertWithin(root, path.join(root, entry.path));
40
+ const definitionName = id + '.definition.json';
41
+ if (!entry.files?.[definitionName]) throw Error(id + ': tracked definition required before source migration');
42
+ // Validate every tracked file, including examples, before any mutation.
43
+ for (const [name, hash] of Object.entries(entry.files)) {
44
+ if (!safeRelative(name)) throw Error('Invalid tracked path');
45
+ const file = assertWithin(target, path.join(target, name));
46
+ if (!fs.existsSync(file) || fileDigest(file) !== hash) throw Error(id + ': missing or locally modified ' + name + '. Reconcile the installed files before migrating.');
47
+ }
48
+ for (const [from, to] of changes) {
49
+ const source = assertWithin(target, path.join(target, from));
50
+ const destination = assertWithin(target, path.join(target, to));
51
+ if (!entry.files[from]) throw Error(id + ': untracked migration source ' + from);
52
+ if (fs.existsSync(destination)) throw Error(id + ': migration destination already exists ' + to);
53
+ if (/\.(scss|js)$/.test(from) && /(?:@(?:use|forward)|\bfrom|\bimport)\s*['"]\./.test(fs.readFileSync(source, 'utf8'))) {
54
+ throw Error(id + ': relative implementation imports require manual review before moving ' + from);
55
+ }
56
+ entry.files[to] = entry.files[from];
57
+ delete entry.files[from];
58
+ }
59
+ // Persist a plain definition, preserving hydrated API fields in the manifest.
60
+ const definitionFile = assertWithin(target, path.join(target, definitionName));
61
+ const stored = JSON.parse(fs.readFileSync(definitionFile, 'utf8'));
62
+ stored.source = definition.source;
63
+ if (definition.documentation) stored.documentation = definition.documentation;
64
+ const content = JSON.stringify(stored, null, 2) + '\n';
65
+ entry.files[definitionName] = digest(content);
66
+ plans.push({id, target, definitionFile, content, changes, assetPath: entry.path, guideContents: null});
67
+ }
68
+ if (!plans.length) return [];
69
+ const relocations = new Map(plans.flatMap(plan => plan.changes.map(([from, to]) => [plan.assetPath + '/' + from, plan.assetPath + '/' + to])));
70
+ for (const plan of plans) {
71
+ if (!plan.changes.some(([from]) => from === 'docs.md')) continue;
72
+ const guide = fs.readFileSync(path.join(plan.target, 'docs.md'), 'utf8');
73
+ plan.guideContents = guide.replace(/(!?\[[^\]]*\])\(([^)]+)\)/g, (match, label, href) => {
74
+ if (/^(https?:|mailto:|#)/i.test(href)) return match;
75
+ const [pathname, fragment] = href.split('#');
76
+ const target = path.posix.normalize(path.posix.join(plan.assetPath, decodeURIComponent(pathname)));
77
+ const relocated = relocations.get(target) || target;
78
+ const relative = path.posix.relative(plan.assetPath + '/docs', relocated);
79
+ return label + '(' + relative.split('/').map(encodeURIComponent).join('/') + (fragment ? '#' + fragment : '') + ')';
80
+ });
81
+ next.installed[plan.id].files['docs/README.md'] = digest(plan.guideContents);
82
+ }
83
+ if (fs.existsSync(journal)) throw Error('Existing migration journal. Review or rollback before migrating again.');
84
+ if (apply) {
85
+ const backupDirectory = 'levelsui-source-backup-' + crypto.randomUUID();
86
+ const backupRoot = assertWithin(project, path.join(project, backupDirectory));
87
+ fs.mkdirSync(backupRoot);
88
+ const backup = backupDirectory + '/manifest.json';
89
+ fs.copyFileSync(stateFile, path.join(project, backup), fs.constants.COPYFILE_EXCL);
90
+ const definitions = plans.map(plan => {
91
+ const backup = backupDirectory + '/' + plan.id + '.json';
92
+ fs.copyFileSync(plan.definitionFile, path.join(project, backup), fs.constants.COPYFILE_EXCL);
93
+ return {path: path.relative(project, plan.definitionFile).split(path.sep).join('/'), backup,
94
+ before: fileDigest(plan.definitionFile), after: digest(plan.content)};
95
+ });
96
+ fs.writeFileSync(journal, JSON.stringify({schemaVersion: 1, kind: 'asset-organisation', backup,
97
+ sha256: fileDigest(stateFile), definitions}, null, 2), {flag: 'wx'});
98
+ // Originals and the recovery journal survive interruption. Re-running requires rollback.
99
+ for (const plan of plans) {
100
+ for (const [from, to] of plan.changes) {
101
+ const destination = assertWithin(plan.target, path.join(plan.target, to));
102
+ fs.mkdirSync(path.dirname(destination), {recursive: true});
103
+ if (from === 'docs.md') fs.writeFileSync(destination, plan.guideContents, {flag: 'wx'});
104
+ else fs.copyFileSync(path.join(plan.target, from), destination, fs.constants.COPYFILE_EXCL);
105
+ }
106
+ fs.writeFileSync(plan.definitionFile, plan.content);
107
+ }
108
+ const temporary = assertWithin(project, stateFile + '.' + crypto.randomUUID() + '.tmp');
109
+ fs.writeFileSync(temporary, JSON.stringify(next, null, 2) + '\n', {flag: 'wx'});
110
+ fs.renameSync(temporary, stateFile);
111
+ }
112
+ return plans.map(({id, changes}) => ({id, action: 'organise-source', copies: changes,
113
+ note: 'Original source files remain as untracked recovery copies. Review the migration journal before updating.'}));
114
+ }
115
+
116
+ export function restoreAssetDefinitions(project, journal, {apply = false} = {}) {
117
+ const files = journal.definitions.map(record => {
118
+ if (!safeRelative(record.path) || !safeRelative(record.backup)) throw Error('Invalid definition recovery path');
119
+ const target = assertWithin(project, path.join(project, record.path));
120
+ const backup = assertWithin(project, path.join(project, record.backup));
121
+ if (fileDigest(backup) !== record.before) throw Error('Definition backup changed');
122
+ if (![record.before, record.after].includes(fileDigest(target))) throw Error('Migrated definition changed. Reconcile before rollback.');
123
+ return {target, backup};
124
+ });
125
+ if (apply) for (const file of files) fs.copyFileSync(file.backup, file.target);
126
+ }
@@ -2,6 +2,7 @@ import fs from 'node:fs';
2
2
  import {assertWithin} from '../registry/paths.mjs';
3
3
  import path from 'node:path';
4
4
  import {createRequire} from 'node:module';
5
+ import {randomUUID} from 'node:crypto';
5
6
 
6
7
  function dependency(project, name) {
7
8
  const require=createRequire(path.join(project,'package.json'));
@@ -19,15 +20,17 @@ function dependency(project, name) {
19
20
  * the optional JS bundle has completed. Temporary artefacts are always removed.
20
21
  */
21
22
  export async function buildProject(app,{minify=true}={}) {
22
- const project=path.dirname(app.manifestFile);
23
+ const project=app.projectRoot;
24
+ const {paths}=app.configuration;
25
+ app.checkGenerated(paths.cssOutput);app.checkGenerated(paths.jsOutput);
23
26
  const entries=app.generate();
24
27
  const sass=dependency(project,'sass');
25
28
  const scriptAssets=app.activeClosure().filter(asset=>asset.source?.js && asset.mount?.export && asset.mount?.selector);
26
29
  const needsJs=scriptAssets.length>0 || app.activeClosure().some(asset=>asset.dependencies?.behaviours?.length>0);
27
30
  const esbuild=needsJs?dependency(project,'esbuild'):null;
28
- const input=path.join(project,'src/buffercore/_active.scss');
29
- const output=path.join(project,'dist/buffercore-levels.css');
30
- const jsOutput=path.join(project,'dist/buffercore-levels.js');
31
+ const input=paths.scssEntry;
32
+ const output=paths.cssOutput;
33
+ const jsOutput=paths.jsOutput;
31
34
  const css=sass.compile(input,{
32
35
  style:minify?'compressed':'expanded',
33
36
  loadPaths:[path.join(project,'node_modules'),path.join(project,'src')],
@@ -37,14 +40,17 @@ export async function buildProject(app,{minify=true}={}) {
37
40
  assertWithin(project,output);assertWithin(project,jsOutput);
38
41
  const outputDir=path.dirname(output);
39
42
  fs.mkdirSync(outputDir,{recursive:true});
40
- const cssTemporary=path.join(outputDir,`.buffercore-levels-${process.pid}.css.tmp`);
41
- const jsTemporary=path.join(outputDir,`.buffercore-levels-${process.pid}.js.tmp`);
43
+ if(needsJs)fs.mkdirSync(path.dirname(jsOutput),{recursive:true});
44
+ const buildId=randomUUID();
45
+ const cssTemporary=path.join(outputDir,`.buffercore-levels-${buildId}.css.tmp`);
46
+ const jsTemporary=assertWithin(project,path.join(path.dirname(jsOutput),`.buffercore-levels-${buildId}.js.tmp`));
47
+ assertWithin(project,cssTemporary);
42
48
  let bundleReport = null;
43
49
  try {
44
50
  fs.writeFileSync(cssTemporary,css.css);
45
51
  if(needsJs) {
46
52
  const bundled = await esbuild.build({
47
- entryPoints:[path.join(project,'src/buffercore/active.mjs')],
53
+ entryPoints:[paths.jsEntry],
48
54
  outfile:jsTemporary,bundle:true,format:'esm',platform:'browser',
49
55
  target:'es2020',minify,logLevel:'silent',metafile:true,
50
56
  });
@@ -69,6 +75,7 @@ export async function buildProject(app,{minify=true}={}) {
69
75
  if(needsJs)fs.renameSync(jsTemporary,jsOutput);
70
76
  else if(fs.existsSync(jsOutput))fs.unlinkSync(jsOutput);
71
77
  fs.renameSync(cssTemporary,output);
78
+ app.trackGenerated([output,jsOutput]);
72
79
  } catch(error) {
73
80
  const cleanup=[];
74
81
  for(const [file,previous] of [[output,previousCss],[jsOutput,previousJs]])try{if(previous!==null)fs.writeFileSync(file,previous);else if(fs.existsSync(file))fs.unlinkSync(file);}catch(e){cleanup.push(e);}
@@ -7,45 +7,72 @@ import {openProject} from './project.mjs';
7
7
  import {buildProject} from './build.mjs';
8
8
  import {resolveRegistryLocation} from './registry-location.mjs';
9
9
  import {migrateInstalled} from './migrate.mjs';
10
+ import {readCatalogueIndex, searchCatalogue} from '../registry/catalogue-index.mjs';
10
11
  import {assertWithin} from '../registry/paths.mjs';
12
+ import {commandOptions,commandAliases,assetCommands} from './commands.mjs';
13
+ import {projectPath,resolveConfiguration,validateManifestLocation} from './configuration.mjs';
11
14
  const packageRoot=fileURLToPath(new URL('../../',import.meta.url));
12
15
  const pkg=JSON.parse(fs.readFileSync(path.join(packageRoot,'package.json')));
13
16
  const help=`LevelsUI ${pkg.version}
14
17
  Usage: levelsui <command> [asset] [options]
15
- Commands: init, list [--installed], info <asset>, add <asset>, activate <asset>,
16
- deactivate <asset>, update <asset>, remove <asset>, prune, entries, build,
17
- validate, doctor, migrate [--rollback], help, --version
18
- Options: --project <dir>, --registry <dir>, --dry-run, --apply,
18
+ Commands:
19
+ ${Object.entries(commandOptions).map(([name,flags])=>' '+name+(name==='default'?' [<family> <asset|none>]':name==='search'?' <terms>':name==='add'||name==='update'?' <asset...>':assetCommands.includes(name)?' <asset>':'')+flags.map(flag=>' [--'+flag+(name==='init'?' <value>':'')+']').join('')).join('\n')}
20
+ help, --version
21
+ Options: --project <dir>, --config <project-relative.json>, --registry <dir>, --dry-run, --apply,
19
22
  --expanded, --report, --verbose. remove/prune/migrate preview until --apply.
20
23
  Compatibility: buffercore executable and use/unuse verbs delegate to LevelsUI.
21
- Installed source is not activated, bundled or mounted automatically.`;
24
+ Adding an Asset activates it by default. Use add --no-activate to install its source without enabling it. Only active Assets enter generated bundles.`;
22
25
  try{
23
- const {values:v,positionals:p}=parseArgs({allowPositionals:true,strict:true,options:{project:{type:'string'},registry:{type:'string'},'dry-run':{type:'boolean'},apply:{type:'boolean'},expanded:{type:'boolean'},report:{type:'boolean'},verbose:{type:'boolean'},installed:{type:'boolean'},rollback:{type:'boolean'},help:{type:'boolean'},version:{type:'boolean'}}});
26
+ const strings=Object.fromEntries(['config','assets','scss-entry','js-entry','overrides-path','css-output','js-output','core'].map(key=>[key,{type:'string'}]));
27
+ const {values:v,positionals:p}=parseArgs({allowPositionals:true,strict:true,options:{...strings,project:{type:'string'},registry:{type:'string'},'dry-run':{type:'boolean'},apply:{type:'boolean'},'no-activate':{type:'boolean'},expanded:{type:'boolean'},report:{type:'boolean'},verbose:{type:'boolean'},installed:{type:'boolean'},rollback:{type:'boolean'},help:{type:'boolean'},version:{type:'boolean'}}});
24
28
  if(v.help||(!p.length&&!v.version)||p[0]==='help'){console.log(help);}
25
29
  else if(v.version){console.log(pkg.version);}
26
30
  else {
27
- const command=({use:'activate',unuse:'deactivate'})[p[0]]||p[0],id=p[1];
28
- const opts={init:[],list:['installed'],info:[],add:['dry-run'],activate:[],deactivate:[],update:['dry-run'],remove:['apply','dry-run'],prune:['apply','dry-run'],entries:['dry-run'],build:['expanded','report','verbose'],validate:[],doctor:[],migrate:['apply','dry-run','rollback']};
31
+ const command=commandAliases[p[0]]||p[0],id=p[1];
32
+ const opts=commandOptions;
29
33
  if(!(command in opts))throw Error('Unknown command: '+command);
30
- for(const key of Object.keys(v))if(!['project','registry'].includes(key)&&!opts[command].includes(key))throw Error(`--${key} is not supported by ${command}`);
34
+ for(const key of Object.keys(v))if(!['project','registry','config'].includes(key)&&!opts[command].includes(key))throw Error(`--${key} is not supported by ${command}`);
31
35
  if(v.apply&&v['dry-run'])throw Error('--apply and --dry-run are mutually exclusive');
32
- const needsId=['info','add','activate','deactivate','update','remove'].includes(command);
33
- if(needsId&&(!id||!/^[a-z][a-z0-9-]*$/.test(id)))throw Error('Specify a valid asset id');
34
- if(p.length>(needsId?2:1))throw Error('Unexpected positional argument');
36
+ const needsId=assetCommands.includes(command);
37
+ const batchCommand=['add','update'].includes(command);
38
+ const ids=batchCommand?p.slice(1):[id];
39
+ if(needsId&&(!id||ids.some(value=>!/^[a-z][a-z0-9-]*$/.test(value))))throw Error('Specify valid asset ids');
40
+ if(p.length>(command==='default'?3:batchCommand?Infinity:command==='search'?Infinity:needsId?2:1))throw Error('Unexpected positional argument');
41
+ if(command==='search'&&p.length<2)throw Error('Usage: levelsui search <terms>');
42
+ if(command==='default'&&p.length===2)throw Error('Use default <family> <asset|none>, or default to inspect');
35
43
  const project=path.resolve(v.project||process.cwd());
44
+ const configFile=v.config||'buffercore.assets.json';
36
45
  if(command==='init'){
37
- const f=assertWithin(project,path.join(project,'buffercore.assets.json'));
38
- if(fs.existsSync(f))openProject(project).doctor();else {fs.mkdirSync(project,{recursive:true});fs.writeFileSync(f,JSON.stringify({schemaVersion:3,installed:{},active:[]},null,2)+'\n',{flag:'wx'});}
46
+ const f=projectPath(project,configFile);
47
+ const pathFlags={'assets':'assets','scss-entry':'scssEntry','js-entry':'jsEntry','overrides-path':'overrides','css-output':'cssOutput','js-output':'jsOutput'};
48
+ const configuration={paths:Object.fromEntries(Object.entries(pathFlags).filter(([flag])=>v[flag]!==undefined).map(([flag,key])=>[key,v[flag]])),core:v.core||'combined'};
49
+ resolveConfiguration(project,configuration);
50
+ if(fs.existsSync(f)){
51
+ if(Object.keys(configuration.paths).length||v.core)throw Error('Project already configured; edit configuration in its manifest after reviewing owned paths');
52
+ openProject(project,undefined,{configFile}).doctor();
53
+ }else {
54
+ validateManifestLocation(project,f,configuration);
55
+ fs.mkdirSync(path.dirname(f),{recursive:true});fs.writeFileSync(f,JSON.stringify({schemaVersion:3,configuration,nativeDefaults:{},installed:{},active:[]},null,2)+'\n',{flag:'wx'});
56
+ }
39
57
  console.log('Project ready. Install BufferCore and Sass; esbuild is needed for interactive builds.');
40
- } else if(command==='migrate')console.log(JSON.stringify(migrateInstalled(project,{apply:!!v.apply,rollback:!!v.rollback}),null,2));
58
+ } else if(command==='migrate')console.log(JSON.stringify(migrateInstalled(project,{apply:!!v.apply,rollback:!!v.rollback,configFile}),null,2));
41
59
  else {
42
- const needsRegistry=['info','add','update','validate'].includes(command)||(command==='list'&&!v.installed);
60
+ const browsing=['search','list'].includes(command)&&!v.installed;
61
+ const needsRegistry=['info','add','update','validate'].includes(command)||(browsing&&!!v.registry);
43
62
  const registry=needsRegistry?resolveRegistryLocation({project,explicit:v.registry,packageRoot}):undefined;
44
- const app=openProject(project,registry);
45
- if(command==='list')console.log(JSON.stringify(v.installed?Object.entries(app.state.installed).map(([id,e])=>({id,level:e.level,version:e.version,catalogue:e.catalogue,active:app.state.active.includes(id)})):[...app.registry.values()],null,2));
63
+ const app=openProject(project,registry,{configFile});
64
+ const browse=()=>{
65
+ const root=registry||resolveRegistryLocation({project,explicit:v.registry,packageRoot});
66
+ const installedPackage=!v.registry && path.resolve(root)!==path.resolve(packageRoot);
67
+ return readCatalogueIndex(root,{trustGenerated:installedPackage});
68
+ };
69
+ if(command==='default')console.log(JSON.stringify(id?app.selectDefault(id,p[2]):app.nativeDefaults(),null,2));
70
+ else if(command==='overrides')console.log(JSON.stringify(app.scaffoldOverrides(id),null,2));
71
+ else if(command==='list')console.log(JSON.stringify(v.installed?Object.entries(app.state.installed).map(([id,e])=>({id,level:e.level,version:e.version,catalogue:e.catalogue,active:app.state.active.includes(id)})):browse(),null,2));
72
+ else if(command==='search')console.log(JSON.stringify(searchCatalogue(browse(),p.slice(1).join(' ')),null,2));
46
73
  else if(command==='info'){if(!app.registry.has(id))throw Error('Unknown asset: '+id);console.log(JSON.stringify(app.registry.get(id),null,2));}
47
74
  else if(command==='validate')console.log(`Valid LevelsUI catalogue: ${app.registry.size} Assets`);
48
- else if(command==='add'||command==='update')console.log(JSON.stringify(app.add([id],{update:command==='update',dryRun:!!v['dry-run']}),null,2));
75
+ else if(command==='add'||command==='update')console.log(JSON.stringify(app.add(ids,{update:command==='update',dryRun:!!v['dry-run'],activate:command==='add'&&!v['no-activate']}),null,2));
49
76
  else if(command==='activate'||command==='deactivate'){app.activate(id,command==='activate');console.log(command+': '+id);}
50
77
  else if(command==='remove'||command==='prune')console.log(JSON.stringify(command==='remove'?app.remove([id],{apply:!!v.apply}):app.prune({apply:!!v.apply}),null,2));
51
78
  else if(command==='entries')console.log(JSON.stringify(app.generate({write:!v['dry-run']}),null,2));
@@ -0,0 +1,10 @@
1
+ // Shared internal CLI contract. Help, dispatch and documentation checks use
2
+ // the same options/aliases; importing this module never opens a project.
3
+ export const commandOptions = Object.freeze({
4
+ init: ['assets','scss-entry','js-entry','overrides-path','css-output','js-output','core'], list: ['installed'], search: [], info: [], add: ['dry-run','no-activate'], activate: [], deactivate: [],
5
+ update: ['dry-run'], remove: ['apply','dry-run'], prune: ['apply','dry-run'], entries: ['dry-run'],
6
+ build: ['expanded','report','verbose'], validate: [], doctor: [], migrate: ['apply','dry-run','rollback'],
7
+ default: [], overrides: [],
8
+ });
9
+ export const commandAliases = Object.freeze({ use:'activate', unuse:'deactivate' });
10
+ export const assetCommands = Object.freeze(['info','add','activate','deactivate','update','remove','overrides']);