@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,60 @@
1
+ import path from 'node:path';
2
+ import {assertWithin, safeRelative} from '../registry/paths.mjs';
3
+
4
+ export const defaultPaths = Object.freeze({
5
+ assets: 'src/buffercore', scssEntry: 'src/buffercore/_active.scss',
6
+ jsEntry: 'src/buffercore/active.mjs', overrides: 'src/levelsui-overrides',
7
+ cssOutput: 'dist/buffercore-levels.css', jsOutput: 'dist/buffercore-levels.js',
8
+ });
9
+
10
+ export function projectPath(base, value) {
11
+ if (typeof value !== 'string') throw Error('Project paths must be strings');
12
+ const relative = value.replaceAll('\\', '/');
13
+ if (!safeRelative(relative) || relative.split('/').some(part => ['node_modules', '.git'].includes(part.toLowerCase()))) {
14
+ throw Error('Unsafe project path: ' + value);
15
+ }
16
+ return assertWithin(base, path.resolve(base, relative));
17
+ }
18
+
19
+ export function resolveConfiguration(base, configuration = {}) {
20
+ if (!configuration || typeof configuration !== 'object' || Array.isArray(configuration) ||
21
+ Object.keys(configuration).some(key => !['paths', 'core'].includes(key))) throw Error('Invalid project configuration');
22
+ const supplied = configuration.paths ?? {};
23
+ if (!supplied || typeof supplied !== 'object' || Array.isArray(supplied) ||
24
+ Object.keys(supplied).some(key => !Object.hasOwn(defaultPaths, key))) throw Error('Unknown project path configuration');
25
+ const paths = Object.fromEntries(Object.entries({...defaultPaths, ...supplied}).map(([key, value]) => [key, projectPath(base, value)]));
26
+ const core = configuration.core ?? 'combined';
27
+ if (!['combined', 'separate'].includes(core)) throw Error('Core mode must be combined or separate');
28
+ for (const [key, extension] of [['scssEntry', '.scss'], ['jsEntry', '.mjs'], ['cssOutput', '.css'], ['jsOutput', '.js']]) {
29
+ if (!paths[key].endsWith(extension)) throw Error(`${key} must end in ${extension}`);
30
+ }
31
+ const within = (parent, child) => {
32
+ if(process.platform==='win32'){parent=parent.toLowerCase();child=child.toLowerCase();}
33
+ return child === parent || child.startsWith(parent + path.sep);
34
+ };
35
+ if (within(paths.assets, paths.overrides) || within(paths.overrides, paths.assets)) throw Error('Managed Assets and overrides must be separate');
36
+ const files = ['scssEntry', 'jsEntry', 'cssOutput', 'jsOutput'];
37
+ if (new Set(files.map(key => paths[key].toLowerCase())).size !== files.length) throw Error('Project output paths collide');
38
+ for(const a of files)for(const b of files)if(a!==b&&within(paths[a],paths[b]))throw Error('Project output file/directory paths collide');
39
+ for (const key of files) {
40
+ if (within(paths.overrides, paths[key])) throw Error('Generated files cannot be inside project overrides');
41
+ if (paths[key] === paths.assets) throw Error('Generated file collides with Asset directory');
42
+ if (within(paths.assets, paths[key]) &&
43
+ (!['scssEntry', 'jsEntry'].includes(key) || path.dirname(paths[key]) !== paths.assets)) {
44
+ throw Error('Generated files cannot overwrite installed Asset source');
45
+ }
46
+ }
47
+ return {paths, core};
48
+ }
49
+
50
+ export function validateManifestLocation(base, location, configuration) {
51
+ const {paths}=resolveConfiguration(base,configuration);
52
+ const comparable=value=>process.platform==='win32'?value.toLowerCase():value;
53
+ const file=comparable(location);
54
+ if(!location.endsWith('.json'))throw Error('Project manifest must end in .json');
55
+ for(const key of ['assets','overrides']){
56
+ const directory=comparable(paths[key]);
57
+ if(file===directory||file.startsWith(directory+path.sep))throw Error('Manifest must be separate from Asset source and overrides');
58
+ }
59
+ for(const key of ['scssEntry','jsEntry','cssOutput','jsOutput'])if(file===comparable(paths[key])||comparable(paths[key]).startsWith(file+path.sep)||file.startsWith(comparable(paths[key])+path.sep))throw Error('Manifest collides with generated output');
60
+ }
@@ -3,10 +3,12 @@ import path from 'node:path';
3
3
  import crypto from 'node:crypto';
4
4
  import {assertWithin,safeRelative} from '../registry/paths.mjs';
5
5
  import {validateReusableUiDefinition,resolveAssets} from '../registry/definitions.mjs';
6
+ import {projectPath,resolveConfiguration} from './configuration.mjs';
7
+ import {migrateAssetOrganisation,restoreAssetDefinitions} from './asset-organisation.mjs';
6
8
  const folders={'02. Elements':'01. Elements','03. Layout':'02. Layouts','04. Components':'03. Components','05. Templates':'04. Templates','06. Pages':'05. Pages'};
7
9
  const hash=p=>crypto.createHash('sha256').update(fs.readFileSync(p)).digest('hex');
8
- export function migrateInstalled(project,{apply=false,rollback=false}={}){
9
- const stateFile=assertWithin(project,path.join(project,'buffercore.assets.json'));
10
+ export function migrateInstalled(project,{apply=false,rollback=false,configFile='buffercore.assets.json'}={}){
11
+ const stateFile=projectPath(project,configFile);
10
12
  const journal=assertWithin(project,path.join(project,'.levelsui-migration.json'));
11
13
  if(rollback){
12
14
  if(!fs.existsSync(journal))throw Error('No migration journal');
@@ -14,14 +16,15 @@ export function migrateInstalled(project,{apply=false,rollback=false}={}){
14
16
  if(!safeRelative(j.backup))throw Error('Invalid migration backup');
15
17
  const backup=assertWithin(project,path.join(project,j.backup));
16
18
  if(hash(backup)!==j.sha256)throw Error('Migration backup changed');
19
+ if(j.kind==='asset-organisation')restoreAssetDefinitions(project,j,{apply});
17
20
  if(apply){fs.copyFileSync(backup,stateFile);fs.unlinkSync(journal);}
18
21
  return [{action:'restore-state',backup:j.backup,note:'New copies remain untouched; old source trees were retained.'}];
19
22
  }
20
23
  const state=JSON.parse(fs.readFileSync(stateFile));
21
24
  if(![1,2,3].includes(state.schemaVersion)||!state.installed||!Array.isArray(state.active))throw Error('Invalid installed state');
22
- if(state.schemaVersion===3&&Object.values(state.installed).every(e=>e.definition))return [];
25
+ if(state.schemaVersion===3&&Object.values(state.installed).every(e=>e.definition))return migrateAssetOrganisation(project,stateFile,journal,state,{apply});
23
26
  if(fs.existsSync(journal))throw Error('Existing migration journal; review or rollback first');
24
- const root=assertWithin(project,path.join(project,'src/buffercore')),plan=[];
27
+ const root=resolveConfiguration(project,state.configuration).paths.assets,plan=[];
25
28
  const next=structuredClone(state);next.schemaVersion=3;
26
29
  for(const [id,e] of Object.entries(next.installed)){
27
30
  if(!/^[a-z][a-z0-9-]*$/.test(id)||!safeRelative(e.path))throw Error('Invalid installed identity/path');
@@ -5,6 +5,8 @@ import { loadRegistry, resolveAssets } from './registry.mjs';
5
5
  import {assertWithin,safeRelative} from '../registry/paths.mjs';
6
6
  import {validateReusableUiDefinition} from '../registry/definitions.mjs';
7
7
  import {migrateInstalled} from './migrate.mjs';
8
+ import {projectPath,resolveConfiguration,validateManifestLocation} from './configuration.mjs';
9
+ import {designSelector,nativeTargets} from '../registry/native.mjs';
8
10
 
9
11
  export const STATE_FILE = 'buffercore.assets.json';
10
12
  const allowed = /\.(?:scss|css|js|json|html|md)$/i;
@@ -37,14 +39,26 @@ function normalise(state) {
37
39
  if(state.active.some(id=>typeof id!=='string'||!Object.hasOwn(state.installed,id))||new Set(state.active).size!==state.active.length)fail('Invalid active roots');
38
40
  return state;
39
41
  }
40
- export function openProject(project, registryRoot) {
41
- const base=path.resolve(project), location=path.join(base,STATE_FILE);
42
+ export function openProject(project, registryRoot, {configFile=STATE_FILE}={}) {
43
+ const base=path.resolve(project), location=projectPath(base,configFile);
44
+ assertWithin(base,location);
42
45
  const state=fs.existsSync(location)?normalise(JSON.parse(fs.readFileSync(location,'utf8'))):{schemaVersion:3,installed:{},active:[]};
43
46
  assertWithin(base,location);
44
47
  const registry=registryRoot?loadRegistry(registryRoot):new Map();
45
48
  let catalogue=null;const packageFile=registryRoot&&path.join(registryRoot,'package.json');
46
49
  if(packageFile&&fs.existsSync(packageFile)){const meta=JSON.parse(fs.readFileSync(assertWithin(registryRoot,packageFile)));catalogue={name:typeof meta.name==='string'?meta.name:null,version:typeof meta.version==='string'?meta.version:null};}
47
- const projectAssets=path.join(base,'src','buffercore');
50
+ const configuration=resolveConfiguration(base,state.configuration);
51
+ const {paths}=configuration;
52
+ const projectAssets=paths.assets;
53
+ validateManifestLocation(base,location,state.configuration);
54
+ if(state.generatedFiles!==undefined&&(!state.generatedFiles||typeof state.generatedFiles!=='object'||Array.isArray(state.generatedFiles)))fail('Invalid generated file inventory');
55
+ for(const [relative,digest] of Object.entries(state.generatedFiles||{}))if(!safeRelative(relative)||! /^[a-f0-9]{64}$/.test(digest))fail('Invalid generated file inventory');
56
+ if(state.nativeDefaults!==undefined && (!state.nativeDefaults||typeof state.nativeDefaults!=='object'||Array.isArray(state.nativeDefaults)))fail('Invalid nativeDefaults');
57
+ if(state.overrides!==undefined && (!state.overrides||typeof state.overrides!=='object'||Array.isArray(state.overrides)))fail('Invalid override inventory');
58
+ for(const [id,entry] of Object.entries(state.overrides||{})){
59
+ if(!/^[a-z][a-z0-9-]*$/.test(id)||!entry||!safeRelative(entry.path)||!Array.isArray(entry.variables)||entry.variables.some(v=>typeof v!=='string'))fail('Invalid override record');
60
+ assertWithin(paths.overrides,projectPath(base,entry.path));
61
+ }
48
62
  function destFor(asset) {
49
63
  const rel=slash(path.relative(registryRoot,path.dirname(asset.definitionFile)));
50
64
  if(rel.startsWith('../')||rel==='..'||path.isAbsolute(rel))fail('Unsafe registry entry');
@@ -75,13 +89,39 @@ export function openProject(project, registryRoot) {
75
89
  if(!previous && existing!==file.digest)fail(`Untracked file would be overwritten: ${file.target}`);
76
90
  }
77
91
  function commitState() {
78
- fs.mkdirSync(base,{recursive:true});
92
+ fs.mkdirSync(path.dirname(location),{recursive:true});
79
93
  assertWithin(base,location);
80
- const temp=location+'.tmp';assertWithin(base,temp);
81
- fs.writeFileSync(temp,JSON.stringify({...state,schemaVersion:3},null,2)+'\n');
82
- fs.renameSync(temp,location);
94
+ const temp=location+'.'+crypto.randomUUID()+'.tmp';assertWithin(base,temp);
95
+ try{
96
+ fs.writeFileSync(temp,JSON.stringify({...state,schemaVersion:3},null,2)+'\n',{flag:'wx'});
97
+ for(let attempt=0;attempt<6;attempt++){
98
+ try{fs.renameSync(temp,location);break;}
99
+ catch(error){
100
+ // Windows readers can briefly deny atomic replacement. Keep the old
101
+ // manifest intact and retry the rename without deleting its target.
102
+ if(process.platform!=='win32'||error.code!=='EPERM'||attempt===5)throw error;
103
+ Atomics.wait(new Int32Array(new SharedArrayBuffer(4)),0,0,20*(attempt+1));
104
+ }
105
+ }
106
+ }finally{if(fs.existsSync(temp))fs.unlinkSync(temp);}
107
+ }
108
+ function checkGenerated(file) {
109
+ assertWithin(base,file);
110
+ if(!fs.existsSync(file))return;
111
+ const relative=slash(path.relative(base,file)),previous=state.generatedFiles?.[relative];
112
+ if(previous){if(fileHash(file)!==previous)fail('Local modifications to generated output: '+file);return;}
113
+ // Existing legacy output is adopted only at its historical default path.
114
+ const legacyOutput=state.configuration===undefined&&[path.join(base,'dist/buffercore-levels.css'),path.join(base,'dist/buffercore-levels.js')].includes(file);
115
+ const legacyEntry=[paths.scssEntry,paths.jsEntry].includes(file)&&fs.readFileSync(file,'utf8').startsWith('// BufferCore CLI generated.');
116
+ if(!legacyOutput&&!legacyEntry)fail('Untracked file would be overwritten: '+file);
117
+ }
118
+ function trackGenerated(files) {
119
+ const previous=state.generatedFiles;
120
+ state.generatedFiles={...previous};
121
+ for(const file of files){const relative=slash(path.relative(base,file));if(fs.existsSync(file))state.generatedFiles[relative]=fileHash(assertWithin(base,file));else delete state.generatedFiles[relative];}
122
+ try{commitState();}catch(error){state.generatedFiles=previous;throw error;}
83
123
  }
84
- function add(ids,{update=false,dryRun=false}={}) {
124
+ function add(ids,{update=false,dryRun=false,activate=false}={}) {
85
125
  const resolved=resolveAssets(registry,ids);
86
126
  const plan=[];
87
127
  // Check the entire operation before changing any file.
@@ -91,7 +131,7 @@ export function openProject(project, registryRoot) {
91
131
  if(prior && prior.path!==rel)fail(`Installed ${asset.id} has a different source path; manual migration required`);
92
132
  const files=sourceFiles(asset);
93
133
  const obsolete=Object.keys(prior?.files||{}).filter(name=>!files.some(file=>file.file===name));
94
- if(obsolete.length && update)fail(`Source files were removed from ${asset.id}; manual review required: ${obsolete.join(', ')}`);
134
+ if(obsolete.length && update)fail(`Source files were removed from ${asset.id}; run levelsui migrate --dry-run, review and apply the source organisation plan before updating. Manual review required: ${obsolete.join(', ')}`);
95
135
  if(prior && !update) {
96
136
  plan.push({id:asset.id,action:'already-installed',files:0});
97
137
  continue;
@@ -99,6 +139,27 @@ export function openProject(project, registryRoot) {
99
139
  for(const file of files)checkExisting(prior,file);
100
140
  plan.push({id:asset.id,action:prior?'update':'install',files:files.filter(file=>!fs.existsSync(file.target)||fileHash(file.target)!==file.digest).length,asset,rel,items:files});
101
141
  }
142
+ const candidates=new Map(Object.entries(state.installed).map(([id,entry])=>[id,entry.definition]));
143
+ for(const item of plan)if(item.asset)candidates.set(item.id,item.asset);
144
+ for(const [family,id] of Object.entries(state.nativeDefaults||{}))if(id!==null){
145
+ const asset=candidates.get(id);
146
+ if(!asset?.native?.eligible||asset.native.family!==family)fail(`Update changes native ownership for ${family}; select none before updating`);
147
+ }
148
+ if(activate) {
149
+ // Resolve every activation root against the complete candidate graph
150
+ // before copying anything. The state update below commits in one write.
151
+ const candidateActive = [...new Set([...state.active, ...ids])];
152
+ resolveAssets(candidates, candidateActive);
153
+ const nativeOwners = new Map();
154
+ for (const asset of resolveAssets(candidates, candidateActive)) {
155
+ if (!asset.native?.eligible) continue;
156
+ const previous = nativeOwners.get(asset.native.family);
157
+ if (previous && state.nativeDefaults === undefined) {
158
+ fail(`Multiple native designs for ${asset.native.family}; select the default explicitly`);
159
+ }
160
+ nativeOwners.set(asset.native.family, asset.id);
161
+ }
162
+ }
102
163
  if(!dryRun) {
103
164
  for(const item of plan) {
104
165
  if(!item.items)continue;
@@ -109,9 +170,18 @@ export function openProject(project, registryRoot) {
109
170
  }
110
171
  state.installed[item.id]={catalogue,definition:structuredClone(item.asset),level:item.asset.level,path:item.rel,version:item.asset.version||null,dependencies:item.asset.dependencies||{},files:Object.fromEntries(item.items.map(file=>[file.file,file.digest]))};
111
172
  }
173
+ if(activate) {
174
+ state.active=[...new Set([...state.active,...ids])];
175
+ // Preserve the existing default selection policy. A newly activated
176
+ // eligible design does not silently become a global native default.
177
+ state.nativeDefaults ??= {};
178
+ }
112
179
  commitState();
113
180
  }
114
- return plan.map(({id,action,files})=>({id,action,files}));
181
+ return plan.map(({id,action,files,asset})=>{
182
+ const removed=(state.overrides?.[id]?.variables||[]).filter(variable=>asset&&!asset.customisation?.variables.includes(variable));
183
+ return {id,action,files,...(removed.length?{warnings:[`Project override hooks require manual migration: ${removed.join(', ')}`]}:{})};
184
+ });
115
185
  }
116
186
  function activeClosure(){
117
187
  const installed=new Map();
@@ -122,6 +192,51 @@ export function openProject(project, registryRoot) {
122
192
  }
123
193
  return resolveAssets(installed,state.active||[]);
124
194
  }
195
+ function nativeDefaults(assets=activeClosure()) {
196
+ const installed=Object.values(state.installed).map(entry=>entry.definition).filter(Boolean);
197
+ for(const asset of installed.filter(asset=>asset.native))for(const peer of installed)if(peer.id!==asset.id&&peer.className===asset.className)fail('Native designs require unique explicit classes: '+asset.className);
198
+ // Absent field is legacy behaviour, captured from installed metadata only.
199
+ const selections=state.nativeDefaults===undefined?Object.fromEntries(assets.filter(a=>a.native?.eligible).map(a=>[a.native.family,a.id])):{...state.nativeDefaults};
200
+ if(state.nativeDefaults===undefined){
201
+ const families=assets.filter(a=>a.native?.eligible).map(a=>a.native.family);
202
+ if(new Set(families).size!==families.length)fail('Multiple native designs in legacy project; select a default explicitly');
203
+ }
204
+ for(const [family,id] of Object.entries(selections)){
205
+ if(!Object.hasOwn(nativeTargets,family))fail('Unknown native family: '+family);
206
+ if(id===null)continue;
207
+ const asset=assets.find(a=>a.id===id);
208
+ if(!asset?.native?.eligible||asset.native.family!==family)fail(`Native default ${family}: ${id} must be an active eligible installed design; select another design or none`);
209
+ }
210
+ return selections;
211
+ }
212
+ function selectDefault(family,id) {
213
+ if(!Object.hasOwn(nativeTargets,family))fail('Unknown native family: '+family);
214
+ const selections=state.nativeDefaults===undefined?Object.fromEntries(activeClosure().filter(asset=>asset.native?.eligible).map(asset=>[asset.native.family,asset.id])):{...state.nativeDefaults};
215
+ const previous=state.nativeDefaults;
216
+ state.nativeDefaults={...selections,[family]:id==='none'?null:id};
217
+ try{nativeDefaults();}catch(error){state.nativeDefaults=previous;throw error;}
218
+ commitState();return {...state.nativeDefaults};
219
+ }
220
+ function scaffoldOverrides(id) {
221
+ const {entry}=readInstalled(id),asset=entry.definition;
222
+ if(!asset?.customisation?.variables?.length)fail(`Asset ${id} exposes no supported customisation hooks`);
223
+ const file=assertWithin(paths.overrides,path.join(paths.overrides,id,'_overrides.scss'));
224
+ const relative=slash(path.relative(base,file));
225
+ const previous=state.overrides?.[id];
226
+ if(fs.existsSync(file)){
227
+ if(previous?.path===relative)return {path:relative,action:'preserved'};
228
+ fail('Untracked override file already exists: '+relative);
229
+ }
230
+ if(previous)fail('Recorded override file is missing; restore it before generating: '+relative);
231
+ const content=[`// Project-owned ${id} overrides. Updates and default selection never rewrite this file.`,
232
+ '// $selector includes the explicit design and its selected native targets.',
233
+ '@mixin overrides($selector) {', ' #{$selector} {',
234
+ ...asset.customisation.variables.map(variable=>` // ${variable}: <project value or Core Semantic>;`),
235
+ ' }','}',''].join('\n');
236
+ fs.mkdirSync(path.dirname(file),{recursive:true});fs.writeFileSync(file,content,{flag:'wx'});
237
+ state.overrides??={};state.overrides[id]={path:relative,variables:[...asset.customisation.variables]};commitState();
238
+ return {path:relative,action:'created'};
239
+ }
125
240
  function usage(id) {
126
241
  const users=[];
127
242
  for(const [other,entry] of Object.entries(state.installed)){
@@ -160,6 +275,7 @@ export function openProject(project, registryRoot) {
160
275
  function removeEmpty(dir){if(!fs.existsSync(dir))return;for(const e of fs.readdirSync(dir,{withFileTypes:true}))if(e.isDirectory())removeEmpty(path.join(dir,e.name));if(fs.readdirSync(dir).length===0)fs.rmdirSync(dir);}
161
276
  removeEmpty(action.target);
162
277
  delete state.installed[action.id];
278
+ for(const [family,id] of Object.entries(state.nativeDefaults||{}))if(id===action.id)state.nativeDefaults[family]=null;
163
279
  }
164
280
  commitState();
165
281
  }
@@ -172,15 +288,32 @@ export function openProject(project, registryRoot) {
172
288
  return remove([...candidates],{apply});
173
289
  }
174
290
  function activate(id,enabled) {
291
+ const before=nativeDefaults();
292
+ const previousActive=[...state.active];
175
293
  if(enabled){readInstalled(id);state.active=[...new Set([...state.active,id])];}
176
294
  else state.active=state.active.filter(item=>item!==id);
177
- if(enabled)activeClosure();
295
+ if(enabled){
296
+ try{activeClosure();if(state.nativeDefaults===undefined)state.nativeDefaults=Object.keys(before).length?before:nativeDefaults();}
297
+ catch(error){state.active=previousActive;throw error;}
298
+ }
299
+ else {
300
+ const remaining=new Set(activeClosure().map(asset=>asset.id));
301
+ state.nativeDefaults=Object.fromEntries(Object.entries(before).map(([family,owner])=>[family,owner&&!remaining.has(owner)?null:owner]));
302
+ }
178
303
  commitState();
179
304
  }
180
305
  function doctor() {
181
306
  const active=activeClosure();
307
+ nativeDefaults(active);
182
308
  for(const asset of active)if(!state.installed[asset.id])fail(`Missing installed dependency: ${asset.id}`);
183
309
  const warnings=[];
310
+ for(const [id,override] of Object.entries(state.overrides||{})){
311
+ const file=projectPath(base,override.path);
312
+ if(!fs.existsSync(file))warnings.push(`${id}: missing project override ${override.path}`);
313
+ const supported=state.installed[id]?.definition?.customisation?.variables||[];
314
+ const removed=override.variables.filter(variable=>!supported.includes(variable));
315
+ if(removed.length)warnings.push(`${id}: override hooks require manual migration: ${removed.join(', ')}`);
316
+ }
184
317
  for(const [id,entry] of Object.entries(state.installed)) {
185
318
  const {target}=readInstalled(id);
186
319
  if(!entry.files) {warnings.push(`${id}: legacy manifest without tracked file hashes`);continue;}
@@ -194,6 +327,15 @@ export function openProject(project, registryRoot) {
194
327
  }
195
328
  function generate({write=true}={}) {
196
329
  const assets=activeClosure();
330
+ const selections=nativeDefaults(assets);
331
+ const installed=Object.values(state.installed).map(entry=>entry.definition).filter(Boolean);
332
+ const relativeImport=(from,to)=>{const rel=slash(path.relative(path.dirname(from),to));return rel.startsWith('.')?rel:'./'+rel;};
333
+ // Installed snapshots retain their own root-relative paths across catalogue moves.
334
+ const installedSource=(entry,source)=>{
335
+ const relative=path.posix.relative(entry.path,source);
336
+ if(!safeRelative(relative))fail('Source escapes installed Asset: '+source);
337
+ return assertWithin(projectAssets,path.join(projectAssets,entry.path,relative));
338
+ };
197
339
  // Behaviour identifiers are deliberately allowlisted to public Core exports.
198
340
  // Never transform registry metadata into arbitrary JavaScript imports.
199
341
  const knownBehaviours = new Map([
@@ -213,15 +355,29 @@ export function openProject(project, registryRoot) {
213
355
  neededBehaviours.add(name);
214
356
  }
215
357
  }
216
- const lines=['// BufferCore CLI generated. Do not edit; regenerate with `buffercore entries`.','@use "@buffercreations/buffercore/scss/buffercore";'];
358
+ const lines=['// BufferCore CLI generated. Do not edit; regenerate with `levelsui entries`.'];
359
+ if(configuration.core==='combined')lines.push('@use "@buffercreations/buffercore/scss/buffercore";');
360
+ const overrideIncludes=[];
361
+ const overrideUses=[];
217
362
  const js=['// BufferCore CLI generated. Import and call mountBufferCoreAssets(root) explicitly.'];
218
363
  const mounts=[];
219
364
  for(const asset of assets){
220
365
  const {entry}=readInstalled(asset.id);
221
- if(asset.source?.scss){const source=path.posix.basename(asset.source.scss);lines.push('@use '+JSON.stringify('./'+slash(entry.path)+'/'+source)+';');}
366
+ const selector=designSelector(asset,installed,selections);
367
+ if(asset.source?.scss){
368
+ const file=installedSource(entry,asset.source.scss);
369
+ lines.push('@use '+JSON.stringify(relativeImport(paths.scssEntry,file))+' as asset'+assets.indexOf(asset)+(asset.native?' with ($levelsui-selector: '+JSON.stringify(selector)+')':'')+';');
370
+ }
371
+ if(state.overrides?.[asset.id]){
372
+ const file=projectPath(base,state.overrides[asset.id].path);
373
+ if(!fs.existsSync(file))fail('Missing project override: '+file);
374
+ const alias='projectOverride'+overrideIncludes.length;
375
+ overrideUses.push('@use '+JSON.stringify(relativeImport(paths.scssEntry,file))+' as '+alias+';');
376
+ overrideIncludes.push('@include '+alias+'.overrides('+JSON.stringify(selector)+');');
377
+ }
222
378
  if(asset.source?.js && asset.mount?.export && asset.mount?.selector){
223
379
  const alias=`mount${mounts.length}`;
224
- js.push('import { '+asset.mount.export+' as '+alias+' } from '+JSON.stringify('./'+slash(entry.path)+'/'+path.posix.basename(asset.source.js))+';');
380
+ js.push('import { '+asset.mount.export+' as '+alias+' } from '+JSON.stringify(relativeImport(paths.jsEntry,installedSource(entry,asset.source.js)))+';');
225
381
  mounts.push({alias,selector:asset.mount.selector,id:asset.id});
226
382
  }
227
383
  }
@@ -247,15 +403,27 @@ export function openProject(project, registryRoot) {
247
403
  }else{
248
404
  js.push('export function mountBufferCoreAssets() { return { destroy() {} }; }');
249
405
  }
250
- const outputs={scss:lines.join('\n')+'\n',js:js.join('\n')+'\n',assets:assets.map(x=>x.id)};
406
+ const outputs={scss:[...lines,...overrideUses,...overrideIncludes].join('\n')+'\n',js:js.join('\n')+'\n',assets:assets.map(x=>x.id)};
251
407
  if(write){
252
408
  assertWithin(base,projectAssets);
253
- assertWithin(base,path.join(projectAssets,'_active.scss'));assertWithin(base,path.join(projectAssets,'active.mjs'));
254
- fs.mkdirSync(projectAssets,{recursive:true});
255
- fs.writeFileSync(path.join(projectAssets,'_active.scss'),outputs.scss);
256
- fs.writeFileSync(path.join(projectAssets,'active.mjs'),outputs.js);
409
+ checkGenerated(paths.scssEntry);checkGenerated(paths.jsEntry);
410
+ const entries=[[paths.scssEntry,outputs.scss],[paths.jsEntry,outputs.js]].map(([file,content])=>({file,content,previous:fs.existsSync(file)?fs.readFileSync(file):null,temporary:assertWithin(base,file+'.'+crypto.randomUUID()+'.tmp')}));
411
+ try{
412
+ for(const entry of entries){fs.mkdirSync(path.dirname(entry.file),{recursive:true});fs.writeFileSync(entry.temporary,entry.content,{flag:'wx'});}
413
+ try{
414
+ for(const entry of entries)fs.renameSync(entry.temporary,entry.file);
415
+ trackGenerated([paths.scssEntry,paths.jsEntry]);
416
+ }catch(error){
417
+ const failures=[];
418
+ for(const entry of entries)try{if(entry.previous!==null)fs.writeFileSync(entry.file,entry.previous);else if(fs.existsSync(entry.file))fs.unlinkSync(entry.file);}catch(rollback){failures.push(rollback);}
419
+ if(failures.length)throw new AggregateError([error,...failures],'Entry generation and rollback failed',{cause:error});
420
+ throw error;
421
+ }
422
+ }finally{
423
+ for(const entry of entries)if(fs.existsSync(entry.temporary))fs.unlinkSync(entry.temporary);
424
+ }
257
425
  }
258
426
  return outputs;
259
427
  }
260
- return {state,registry,add,remove,prune,activate,generate,doctor,activeClosure,migrate:options=>migrateInstalled(base,options),manifestFile:location};
428
+ return {state,registry,add,remove,prune,activate,generate,doctor,activeClosure,nativeDefaults,selectDefault,scaffoldOverrides,checkGenerated,trackGenerated,configuration,projectRoot:base,migrate:options=>migrateInstalled(base,{...options,configFile}),manifestFile:location};
261
429
  }
@@ -0,0 +1,54 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import {discoverReusableUiDefinitions} from './definitions.mjs';
4
+
5
+ /** Lightweight discoverable catalogue. Never contains executable source or example HTML.
6
+ * The registry definitions remain authoritative for installation and validation.
7
+ */
8
+ export function catalogueEntries(definitions) {
9
+ return definitions.map(asset => ({
10
+ id: asset.id,
11
+ name: asset.displayName,
12
+ level: asset.level,
13
+ category: asset.category ?? [],
14
+ family: asset.family ?? null,
15
+ description: asset.description ?? '',
16
+ version: asset.version ?? null,
17
+ dependencies: Object.fromEntries(
18
+ ['elements', 'layout', 'components', 'templates', 'pages']
19
+ .map(key => [key, asset.dependencies?.[key] ?? []])
20
+ .filter(([, value]) => value.length)
21
+ ),
22
+ })).sort((a, b) => a.id.localeCompare(b.id));
23
+ }
24
+
25
+ export function buildCatalogueIndex(root) {
26
+ return {schemaVersion: 1, assets: catalogueEntries(
27
+ discoverReusableUiDefinitions(root, {hydrate: false})
28
+ )};
29
+ }
30
+
31
+ export function readCatalogueIndex(root, {trustGenerated = false} = {}) {
32
+ const file = path.join(root, 'dist', 'catalogue.json');
33
+ // A source checkout can change after its last build. Never silently serve a
34
+ // stale index for an explicitly selected, editable local source registry.
35
+ if (trustGenerated && fs.existsSync(file)) {
36
+ const data = JSON.parse(fs.readFileSync(file, 'utf8'));
37
+ if (data.schemaVersion !== 1 || !Array.isArray(data.assets) ||
38
+ data.assets.some(asset => !/^[a-z][a-z0-9-]*$/.test(asset.id))) {
39
+ throw Error('Invalid LevelsUI catalogue index; rebuild the catalogue');
40
+ }
41
+ return data.assets;
42
+ }
43
+ return buildCatalogueIndex(root).assets;
44
+ }
45
+
46
+ export function searchCatalogue(assets, query) {
47
+ const words = String(query).toLocaleLowerCase('en-GB').trim().split(/\s+/).filter(Boolean);
48
+ return assets.filter(asset => {
49
+ const haystack = [asset.id, asset.name, asset.level, asset.description,
50
+ ...(Array.isArray(asset.category) ? asset.category : []), asset.family ?? '']
51
+ .join(' ').toLocaleLowerCase('en-GB');
52
+ return words.every(word => haystack.includes(word));
53
+ });
54
+ }
@@ -0,0 +1,3 @@
1
+ // Dependency-free category metadata shared by discovery and documentation.
2
+ export const folders=Object.freeze({elements:'01. Elements',layout:'02. Layouts',components:'03. Components',templates:'04. Templates',pages:'05. Pages'});
3
+ export const prefixes=Object.freeze({elements:'bce-',layout:'bcl-',components:'bcc-',templates:'bct-',pages:'bcp-'});
@@ -2,21 +2,33 @@ import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import Ajv2020 from 'ajv/dist/2020.js';
4
4
  import {safeRelative,assertWithin} from './paths.mjs';
5
- export const folders=Object.freeze({elements:'01. Elements',layout:'02. Layouts',components:'03. Components',templates:'04. Templates',pages:'05. Pages'});
6
- const prefixes={elements:'bce-',layout:'bcl-',components:'bcc-',templates:'bct-',pages:'bcp-'};
5
+ import {folders,prefixes} from './categories.mjs';
6
+ import {nativeDefinitionErrors} from './native.mjs';
7
+ export {folders};
7
8
  const schema=JSON.parse(fs.readFileSync(new URL('../../schemas/reusable-ui.schema.json',import.meta.url)));
8
9
  const validate=new Ajv2020({allErrors:true,strict:false}).compile(schema);
9
- export function validateReusableUiDefinition(def,{coreRoot,filename}={}){
10
+ const assetDependencyKeys=['elements','layout','components','templates','pages'];
11
+ const validateExampleDependencies=new Ajv2020({allErrors:true,strict:false}).compile({
12
+ type:'object',additionalProperties:false,
13
+ properties:Object.fromEntries(assetDependencyKeys.map(key=>[key,schema.properties.dependencies.properties[key]])),
14
+ });
15
+ export function validateReusableUiDefinition(def,{coreRoot,filename,requireBuiltCss=true}={}){
10
16
  const errors=[];
11
17
  if(!validate(def))for(const e of validate.errors)errors.push(e.keyword==='additionalProperties'?(e.instancePath?e.instancePath+' ':'')+'Unknown field '+e.params.additionalProperty:`${e.instancePath||'definition'} ${e.message}${e.keyword==='uniqueItems'?' (unique identifier array required)':''}`);
12
18
  if(!def||typeof def!=='object')return errors;
19
+ errors.push(...nativeDefinitionErrors(def));
20
+ if(Array.isArray(def.customisation?.variables)&&def.customisation.variables.some(variable=>typeof variable!=='string'||!variable.startsWith('--'+def.className+'-')))errors.push('customisation variables must belong to the Asset class namespace');
13
21
  if(def.kind!=='recipe'&&typeof def.className==='string'&&!def.className.startsWith(prefixes[def.level]))errors.push('className has wrong level prefix');
14
22
  if(filename&&filename!==def.id+'.definition.json')errors.push('Definition filename must match id');
15
23
  if(def.mount&&(!def.source?.js||!/^[A-Za-z_$][\w$]*$/.test(def.mount.export||'')))errors.push('mount requires source.js and a valid export identifier');
16
24
  for(const [key,value] of Object.entries(def.source||{})){
17
25
  if(!safeRelative(value)||!value.endsWith('.'+key))errors.push('Invalid source.'+key+' path');
18
- else if(coreRoot)try{const p=assertWithin(coreRoot,path.resolve(coreRoot,value));if(!fs.statSync(p).isFile())throw Error('not a file');}catch(e){errors.push('Missing or unsafe source.'+key+': '+e.message);}
26
+ else if(coreRoot)try{const p=assertWithin(coreRoot,path.resolve(coreRoot,value));if((key!=='css'||requireBuiltCss)&&!fs.statSync(p).isFile())throw Error('not a file');}catch(e){errors.push('Missing or unsafe source.'+key+': '+e.message);}
19
27
  }
28
+ if(coreRoot&&def.native&&safeRelative(def.source?.scss))try{
29
+ const scss=fs.readFileSync(assertWithin(coreRoot,path.resolve(coreRoot,def.source.scss)),'utf8');
30
+ if(!/\$levelsui-selector\s*:[^;]+!default\s*;/.test(scss))errors.push('native source must expose $levelsui-selector with !default');
31
+ }catch{ /* Source path diagnostics above are authoritative. */ }
20
32
  return errors;
21
33
  }
22
34
  export function resolveAssets(map,ids){
@@ -32,30 +44,67 @@ export function resolveAssets(map,ids){
32
44
  }
33
45
  ids.forEach(visit);return ordered;
34
46
  }
35
- export function discoverReusableUiDefinitions(root,{hydrate=true}={}){
47
+ export function discoverReusableUiDefinitions(root,{hydrate=true,requireBuiltCss=true}={}){
36
48
  root=path.resolve(root);const definitions=[];
37
49
  function walk(dir,level){
38
50
  assertWithin(root,dir);
39
51
  for(const e of fs.readdirSync(dir,{withFileTypes:true})){
40
52
  if(e.name.startsWith('.'))continue;const file=assertWithin(root,path.join(dir,e.name));
41
53
  if(e.isDirectory()){walk(file,level);continue;}if(!e.name.endsWith('.definition.json'))continue;
42
- const def=JSON.parse(fs.readFileSync(file,'utf8')),errors=validateReusableUiDefinition(def,{coreRoot:root,filename:e.name});
54
+ const def=JSON.parse(fs.readFileSync(file,'utf8')),errors=validateReusableUiDefinition(def,{coreRoot:root,filename:e.name,requireBuiltCss});
43
55
  if(def.level!==level||path.basename(dir)!==def.id)errors.push('Definition identity does not match level or asset folder');
44
- for(const key of ['scss','js','html'])if(def.source?.[key]&&path.dirname(path.resolve(root,def.source[key]))!==dir)errors.push('Source must be co-located with its definition');
56
+ for(const key of ['scss','js','html'])if(def.source?.[key]){
57
+ const sourceDirectory=path.dirname(path.resolve(root,def.source[key]));
58
+ if(sourceDirectory!==dir&&sourceDirectory!==path.join(dir,'src'))errors.push('Source must be in the Asset root or its src directory');
59
+ }
45
60
  if(errors.length)throw Error(file+': '+errors.join('; '));
46
61
  const read=rel=>{if(!safeRelative(rel))throw Error('Invalid documentation/example path');return fs.readFileSync(assertWithin(dir,path.resolve(dir,rel)),'utf8');};
47
62
  if(def.documentation){
48
63
  const doc=def.documentation,api=JSON.parse(read(doc.api)),specs=JSON.parse(read(doc.examples));
49
- const allowed=new Set(['variants','sizes','anatomy','properties','accessibility','tags','notes','reference','status']);
64
+ const allowed=new Set(['variants','sizes','anatomy','anatomyContract','properties','accessibility','tags','notes','reference','status']);
50
65
  if(!api||Array.isArray(api)||Object.keys(api).some(k=>!allowed.has(k)))throw Error(file+': api.json contains unsupported fields');
66
+ if(api.anatomyContract!==undefined){
67
+ const parts=api.anatomyContract;
68
+ if(!Array.isArray(parts)||!parts.length)throw Error(file+': anatomyContract must be a nonempty array');
69
+ const knownParts=new Set();
70
+ for(const part of parts){
71
+ if(!part||typeof part!=='object'||Array.isArray(part)||Object.keys(part).some(key=>!['name','selector','required','repeatable','description'].includes(key))||
72
+ !/^[a-z][a-z0-9-]*$/.test(part.name||'')||knownParts.has(part.name)||
73
+ typeof part.selector!=='string'||!part.selector.startsWith('.'+def.className)&&!/^\.(?:bce|bcl|bcc|bct|bcp)-[a-z0-9-]+$/.test(part.selector)||
74
+ typeof part.required!=='boolean'||typeof part.repeatable!=='boolean'||
75
+ typeof part.description!=='string'||!part.description.trim()){
76
+ throw Error(file+': invalid or duplicate anatomyContract part');
77
+ }
78
+ knownParts.add(part.name);
79
+ }
80
+ }
81
+
51
82
  if(!Array.isArray(specs))throw Error('examples index must be an array');
52
83
  const seen=new Set(),examples=specs.map(s=>{
53
84
  if(!s||!/^[a-z][a-z0-9-]*$/.test(s.id)||seen.has(s.id))throw Error('Invalid or duplicate example id');seen.add(s.id);
85
+ if(s.isBase!==undefined&&typeof s.isBase!=='boolean')throw Error('Invalid isBase marker');
86
+ if(s.group!==undefined&&(typeof s.group!=='string'||!s.group.trim()||s.group.length>80))throw Error('Invalid example group');
87
+ if(s.dependencies!==undefined&&!validateExampleDependencies(s.dependencies))throw Error(file+': invalid example dependencies: '+JSON.stringify(validateExampleDependencies.errors));
54
88
  for(const field of ['preview','code'])if(!s[field]?.startsWith('examples/'))throw Error('Invalid '+field+' path');
55
89
  const previewHtml=read(s.preview),codeHtml=read(s.code);
56
90
  if(/\sstyle\s*=|<style\b/i.test(previewHtml+codeHtml))throw Error(file+': inline presentation is not permitted in examples');
57
91
  return {...s,...(hydrate?{previewHtml,codeHtml}:{})};
58
92
  });
93
+ const baseExamples=examples.filter(example=>example.isBase===true);
94
+ if(baseExamples.length>1)throw Error(file+': only one example may be marked isBase');
95
+ if(baseExamples.length){
96
+ const base=baseExamples[0];
97
+ if(Object.values(base.dependencies||{}).some(ids=>ids.length))throw Error(file+': base example cannot declare optional Asset dependencies');
98
+ if(!base.codeHtml?.trim()&&!read(base.code).trim())throw Error(file+': base example requires copyable HTML');
99
+ const requiredParts=api.anatomyContract?.filter(part=>part.required)||[];
100
+ const baseCode=read(base.code);
101
+ const classes=[...baseCode.matchAll(/class=["']([^"']+)["']/g)]
102
+ .flatMap(found=>found[1].split(/\s+/));
103
+ for(const part of requiredParts){
104
+ const match=/^\.([\w-]+)$/.exec(part.selector);
105
+ if(match&&!classes.includes(match[1]))throw Error(file+': base example is missing required anatomy '+part.name);
106
+ }
107
+ }
59
108
  const guide=read(doc.guide);if(hydrate)Object.assign(def,api,{examples,usage:guide.replace(/^#.*\n+/,'').trim()});
60
109
  }
61
110
  Object.defineProperty(def,'definitionFile',{value:file,enumerable:false});definitions.push(def);
@@ -64,6 +113,34 @@ export function discoverReusableUiDefinitions(root,{hydrate=true}={}){
64
113
  for(const [level,dir] of Object.entries(folders)){const p=path.join(root,dir);if(fs.existsSync(p))walk(p,level);}
65
114
  for(const a of definitions)for(const b of definitions){if(a===b)continue;const dir=path.dirname(a.definitionFile),rel=path.relative(dir,path.dirname(b.definitionFile));if(rel&&!rel.startsWith('..'+path.sep)&&rel!=='..'&&!path.isAbsolute(rel))throw Error('Asset directories must be leaves; nested Asset: '+b.id);}
66
115
  const map=new Map();for(const def of definitions){if(map.has(def.id))throw Error('Duplicate asset: '+def.id);map.set(def.id,def);}
67
- for(const def of definitions){const css=new Set();for(const a of resolveAssets(map,[def.id])){for(const name of a.dependencies?.css||[])css.add(({foundations:'dist/buffercore.min.css',tokens:'dist/buffercore-tokens.min.css',utilities:'dist/buffercore-utilities.min.css'})[name]);if(a.source?.css)css.add(a.source.css);}if(hydrate){def.resolvedCss=[...css];def.resolvedAssets=resolveAssets(map,[def.id]).map(a=>a.id);}}
116
+ for(const def of definitions.filter(asset=>asset.native))for(const peer of definitions)if(peer.id!==def.id&&peer.className===def.className)throw Error('Native designs require unique explicit classes: '+def.className);
117
+ function resolvedStyles(assets){
118
+ const css=new Set();
119
+ for(const asset of assets){
120
+ for(const name of asset.dependencies?.css||[])css.add(({foundations:'dist/buffercore.min.css',tokens:'dist/buffercore-tokens.min.css',utilities:'dist/buffercore-utilities.min.css'})[name]);
121
+ if(asset.source?.css)css.add(asset.source.css);
122
+ }
123
+ return [...css];
124
+ }
125
+ for(const def of definitions){
126
+ const resolved=resolveAssets(map,[def.id]);
127
+ const requiredSelectors=new Set(resolved.map(asset=>'.'+asset.className));
128
+ for(const part of (def.documentation ? JSON.parse(fs.readFileSync(path.resolve(path.dirname(def.definitionFile),def.documentation.api),'utf8')).anatomyContract || [] : [])){
129
+ if(!part.selector.startsWith('.'+def.className)&&!requiredSelectors.has(part.selector)){
130
+ throw Error(`${def.id}: anatomy part ${part.name} must belong to the Asset or a required child Asset`);
131
+ }
132
+ }
133
+ if(hydrate){def.resolvedCss=resolvedStyles(resolved);def.resolvedAssets=resolved.map(asset=>asset.id);}
134
+ const specs=def.documentation?JSON.parse(fs.readFileSync(assertWithin(path.dirname(def.definitionFile),path.resolve(path.dirname(def.definitionFile),def.documentation.examples)),'utf8')):[];
135
+ for(const example of specs){
136
+ const ids=[def.id];
137
+ for(const key of assetDependencyKeys)for(const id of example.dependencies?.[key]||[]){
138
+ if(map.get(id)?.level!==key)throw Error(`${def.id}/${example.id}: invalid ${key} example dependency ${id}`);
139
+ ids.push(id);
140
+ }
141
+ const assets=resolveAssets(map,ids);
142
+ if(hydrate){const hydrated=def.examples.find(item=>item.id===example.id);hydrated.resolvedCss=resolvedStyles(assets);hydrated.resolvedAssets=assets.map(asset=>asset.id);}
143
+ }
144
+ }
68
145
  return definitions.sort((a,b)=>a.level.localeCompare(b.level)||a.displayName.localeCompare(b.displayName));
69
146
  }