@buffercreations/levelsui 0.1.1 → 0.1.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/01. Elements/actions/controls/button/button.definition.json +38 -4
- package/01. Elements/actions/controls/button/docs/README.md +67 -0
- package/01. Elements/actions/controls/button/{api.json → docs/api.json } +14 -5
- package/01. Elements/actions/controls/button/examples/contexts/code.html +1 -3
- package/01. Elements/actions/controls/button/examples/contexts/preview.html +8 -2
- package/01. Elements/actions/controls/button/examples/icon-only/code.html +3 -0
- package/01. Elements/actions/controls/button/examples/icon-only/preview.html +17 -0
- package/01. Elements/actions/controls/button/examples/icons/code.html +2 -4
- package/01. Elements/actions/controls/button/examples/icons/preview.html +12 -3
- package/01. Elements/actions/controls/button/examples/index.json +9 -2
- package/01. Elements/actions/controls/button/examples/native-default/code.html +0 -8
- package/01. Elements/actions/controls/button/examples/native-default/preview.html +0 -4
- package/01. Elements/actions/controls/button/examples/states/code.html +1 -1
- package/01. Elements/actions/controls/button/examples/states/preview.html +2 -2
- package/01. Elements/actions/controls/button/src/button.scss +215 -0
- package/01. Elements/actions/controls/button-lumen-shift/button-lumen-shift.definition.json +95 -0
- package/01. Elements/actions/controls/button-lumen-shift/docs/README.md +85 -0
- package/01. Elements/actions/controls/button-lumen-shift/docs/api.json +134 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/basic/code.html +3 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/basic/preview.html +3 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/code.html +1 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/contexts/preview.html +9 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/code.html +3 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/icon-only/preview.html +14 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/icons/code.html +4 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/icons/preview.html +14 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/index.json +66 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/links/code.html +3 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/links/preview.html +3 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/code.html +1 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/sizes/preview.html +6 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/states/code.html +1 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/states/preview.html +4 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/code.html +1 -0
- package/01. Elements/actions/controls/button-lumen-shift/examples/treatments/preview.html +5 -0
- package/01. Elements/actions/controls/button-lumen-shift/src/button-lumen-shift.scss +543 -0
- package/01. Elements/feedback/tooltip/docs/README.md +49 -0
- package/01. Elements/feedback/tooltip/docs/api.json +78 -0
- package/01. Elements/feedback/tooltip/examples/arrow/code.html +4 -0
- package/01. Elements/feedback/tooltip/examples/arrow/preview.html +4 -0
- package/01. Elements/feedback/tooltip/examples/comfortable/code.html +4 -0
- package/01. Elements/feedback/tooltip/examples/comfortable/preview.html +4 -0
- package/01. Elements/feedback/tooltip/examples/default/code.html +4 -0
- package/01. Elements/feedback/tooltip/examples/default/preview.html +4 -0
- package/01. Elements/feedback/tooltip/examples/delays/code.html +4 -0
- package/01. Elements/feedback/tooltip/examples/delays/preview.html +4 -0
- package/01. Elements/feedback/tooltip/examples/disabled/code.html +6 -0
- package/01. Elements/feedback/tooltip/examples/disabled/preview.html +6 -0
- package/01. Elements/feedback/tooltip/examples/index.json +66 -0
- package/01. Elements/feedback/tooltip/examples/multiple/code.html +8 -0
- package/01. Elements/feedback/tooltip/examples/multiple/preview.html +8 -0
- package/01. Elements/feedback/tooltip/examples/shortcut/code.html +4 -0
- package/01. Elements/feedback/tooltip/examples/shortcut/preview.html +4 -0
- package/01. Elements/feedback/tooltip/examples/sides/code.html +4 -0
- package/01. Elements/feedback/tooltip/examples/sides/preview.html +16 -0
- package/01. Elements/feedback/tooltip/src/tooltip.js +233 -0
- package/01. Elements/feedback/tooltip/src/tooltip.scss +117 -0
- package/01. Elements/feedback/tooltip/tooltip.definition.json +42 -0
- package/01. Elements/forms/selection/checkbox/checkbox.definition.json +65 -0
- package/01. Elements/forms/selection/checkbox/docs/README.md +46 -0
- package/01. Elements/forms/selection/checkbox/docs/api.json +102 -0
- package/01. Elements/forms/selection/checkbox/examples/basic/code.html +7 -0
- package/01. Elements/forms/selection/checkbox/examples/basic/preview.html +4 -0
- package/01. Elements/forms/selection/checkbox/examples/description/code.html +7 -0
- package/01. Elements/forms/selection/checkbox/examples/description/preview.html +7 -0
- package/01. Elements/forms/selection/checkbox/examples/group/code.html +9 -0
- package/01. Elements/forms/selection/checkbox/examples/group/preview.html +6 -0
- package/01. Elements/forms/selection/checkbox/examples/index.json +44 -0
- package/01. Elements/forms/selection/checkbox/examples/sizes/code.html +6 -0
- package/01. Elements/forms/selection/checkbox/examples/sizes/preview.html +5 -0
- package/01. Elements/forms/selection/checkbox/examples/states/code.html +6 -0
- package/01. Elements/forms/selection/checkbox/examples/states/preview.html +7 -0
- package/01. Elements/forms/selection/checkbox/examples/table/code.html +1 -0
- package/01. Elements/forms/selection/checkbox/examples/table/preview.html +8 -0
- package/01. Elements/forms/selection/checkbox/src/checkbox.scss +157 -0
- package/01. Elements/forms/selection/select/docs/README.md +37 -0
- package/01. Elements/forms/selection/select/docs/api.json +105 -0
- package/01. Elements/forms/selection/select/examples/default/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/default/preview.html +12 -0
- package/01. Elements/forms/selection/select/examples/disabled/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/disabled/preview.html +12 -0
- package/01. Elements/forms/selection/select/examples/index.json +74 -0
- package/01. Elements/forms/selection/select/examples/invalid/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/invalid/preview.html +12 -0
- package/01. Elements/forms/selection/select/examples/leading-avatar/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/leading-avatar/preview.html +12 -0
- package/01. Elements/forms/selection/select/examples/leading-icon/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/leading-icon/preview.html +12 -0
- package/01. Elements/forms/selection/select/examples/native/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/native/preview.html +12 -0
- package/01. Elements/forms/selection/select/examples/search/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/search/preview.html +12 -0
- package/01. Elements/forms/selection/select/examples/sizes/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/sizes/preview.html +36 -0
- package/01. Elements/forms/selection/select/examples/status-dot/code.html +12 -0
- package/01. Elements/forms/selection/select/examples/status-dot/preview.html +12 -0
- package/01. Elements/forms/selection/select/select.definition.json +69 -0
- package/01. Elements/forms/selection/select/src/select.js +477 -0
- package/01. Elements/forms/selection/select/src/select.scss +312 -0
- package/01. Elements/media/identity/avatar/avatar.definition.json +48 -5
- package/01. Elements/media/identity/avatar/docs/README.md +61 -0
- package/01. Elements/media/identity/avatar/docs/api.json +96 -0
- package/01. Elements/media/identity/avatar/examples/badge/code.html +7 -0
- package/01. Elements/media/identity/avatar/examples/badge/preview.html +7 -0
- package/01. Elements/media/identity/avatar/examples/badge-icon/code.html +7 -0
- package/01. Elements/media/identity/avatar/examples/badge-icon/preview.html +7 -0
- package/01. Elements/media/identity/avatar/examples/basic/code.html +6 -0
- package/01. Elements/media/identity/avatar/examples/basic/preview.html +6 -0
- package/01. Elements/media/identity/avatar/examples/dropdown/code.html +8 -0
- package/01. Elements/media/identity/avatar/examples/dropdown/preview.html +6 -0
- package/01. Elements/media/identity/avatar/examples/fallback/code.html +5 -0
- package/01. Elements/media/identity/avatar/examples/fallback/preview.html +5 -0
- package/01. Elements/media/identity/avatar/examples/index.json +68 -23
- package/01. Elements/media/identity/avatar/examples/notification-count/code.html +6 -0
- package/01. Elements/media/identity/avatar/examples/notification-count/preview.html +7 -0
- package/01. Elements/media/identity/avatar/examples/notification-dot/code.html +6 -0
- package/01. Elements/media/identity/avatar/examples/notification-dot/preview.html +7 -0
- package/01. Elements/media/identity/avatar/examples/sizes/code.html +2 -2
- package/01. Elements/media/identity/avatar/examples/sizes/preview.html +19 -26
- package/01. Elements/media/identity/avatar/examples/square/code.html +5 -0
- package/01. Elements/media/identity/avatar/examples/square/preview.html +5 -0
- package/01. Elements/media/identity/avatar/examples/status-contexts/code.html +6 -0
- package/01. Elements/media/identity/avatar/examples/status-contexts/preview.html +13 -0
- package/01. Elements/media/identity/avatar/src/avatar.js +42 -0
- package/01. Elements/media/identity/avatar/src/avatar.scss +172 -0
- package/01. Elements/navigation/items/navigation-item/docs/README.md +52 -0
- package/01. Elements/navigation/items/navigation-item/docs/api.json +84 -0
- package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/code.html +9 -0
- package/01. Elements/navigation/items/navigation-item/examples/animated-collapse/preview.html +18 -0
- package/01. Elements/navigation/items/navigation-item/examples/collapsible/code.html +9 -0
- package/01. Elements/navigation/items/navigation-item/examples/collapsible/preview.html +18 -0
- package/01. Elements/navigation/items/navigation-item/examples/icon-label/code.html +6 -0
- package/01. Elements/navigation/items/navigation-item/examples/icon-label/preview.html +1 -0
- package/01. Elements/navigation/items/navigation-item/examples/icon-only/code.html +7 -0
- package/01. Elements/navigation/items/navigation-item/examples/icon-only/preview.html +1 -0
- package/01. Elements/navigation/items/navigation-item/examples/index.json +45 -0
- package/01. Elements/navigation/items/navigation-item/examples/label-only/code.html +3 -0
- package/01. Elements/navigation/items/navigation-item/examples/label-only/preview.html +1 -0
- package/01. Elements/navigation/items/navigation-item/examples/states/code.html +9 -0
- package/01. Elements/navigation/items/navigation-item/examples/states/preview.html +17 -0
- package/01. Elements/navigation/items/navigation-item/navigation-item.definition.json +40 -0
- package/01. Elements/navigation/items/navigation-item/src/navigation-item.scss +185 -0
- package/01. Elements/status/indicators/badge/badge.definition.json +55 -0
- package/01. Elements/status/indicators/badge/docs/README.md +40 -0
- package/01. Elements/status/indicators/badge/docs/api.json +112 -0
- package/01. Elements/status/indicators/badge/examples/content/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/content/preview.html +3 -0
- package/01. Elements/status/indicators/badge/examples/contexts/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/contexts/preview.html +3 -0
- package/01. Elements/status/indicators/badge/examples/icons/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/icons/preview.html +3 -0
- package/01. Elements/status/indicators/badge/examples/index.json +58 -0
- package/01. Elements/status/indicators/badge/examples/links/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/links/preview.html +3 -0
- package/01. Elements/status/indicators/badge/examples/loading/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/loading/preview.html +3 -0
- package/01. Elements/status/indicators/badge/examples/sizes/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/sizes/preview.html +3 -0
- package/01. Elements/status/indicators/badge/examples/status/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/status/preview.html +3 -0
- package/01. Elements/status/indicators/badge/examples/treatments/code.html +1 -0
- package/01. Elements/status/indicators/badge/examples/treatments/preview.html +3 -0
- package/01. Elements/status/indicators/badge/src/badge.scss +109 -0
- package/02. Layouts/REFINEMENT-REVIEW.md +82 -0
- package/02. Layouts/UTILITY-RECIPES.md +97 -9
- package/02. Layouts/application/app-shell/app-shell.definition.json +7 -6
- package/02. Layouts/application/app-shell/docs/README.md +64 -0
- package/02. Layouts/application/app-shell/docs/api.json +125 -0
- package/02. Layouts/application/app-shell/examples/complete/code.html +19 -0
- package/02. Layouts/application/app-shell/examples/complete/preview.html +28 -0
- package/02. Layouts/application/app-shell/examples/dual/code.html +13 -0
- package/02. Layouts/application/app-shell/examples/dual/preview.html +26 -0
- package/02. Layouts/application/app-shell/examples/header-main/code.html +10 -0
- package/02. Layouts/application/app-shell/examples/header-main/preview.html +19 -0
- package/02. Layouts/application/app-shell/examples/index.json +51 -15
- package/02. Layouts/application/app-shell/examples/main-only/code.html +7 -0
- package/02. Layouts/application/app-shell/examples/main-only/preview.html +18 -0
- package/02. Layouts/application/app-shell/examples/right/code.html +16 -0
- package/02. Layouts/application/app-shell/examples/right/preview.html +25 -0
- package/02. Layouts/application/app-shell/examples/sizes/code.html +16 -0
- package/02. Layouts/application/app-shell/examples/sizes/preview.html +27 -0
- package/02. Layouts/application/app-shell/examples/standard/code.html +13 -0
- package/02. Layouts/application/app-shell/examples/standard/preview.html +22 -0
- package/02. Layouts/application/app-shell/examples/sticky/code.html +16 -0
- package/02. Layouts/application/app-shell/examples/sticky/preview.html +23 -0
- package/02. Layouts/application/app-shell/src/app-shell.scss +119 -0
- package/02. Layouts/application/page-frame/docs/README.md +13 -0
- package/02. Layouts/application/page-frame/docs/api.json +33 -0
- package/02. Layouts/application/page-frame/examples/footer/code.html +8 -0
- package/02. Layouts/application/page-frame/examples/footer/preview.html +11 -0
- package/02. Layouts/application/page-frame/examples/header/code.html +8 -0
- package/02. Layouts/application/page-frame/examples/header/preview.html +11 -0
- package/02. Layouts/application/page-frame/examples/index.json +30 -0
- package/02. Layouts/application/page-frame/examples/main/code.html +5 -0
- package/02. Layouts/application/page-frame/examples/main/preview.html +10 -0
- package/02. Layouts/application/page-frame/examples/standard/code.html +11 -0
- package/02. Layouts/application/page-frame/examples/standard/preview.html +12 -0
- package/02. Layouts/application/page-frame/page-frame.definition.json +24 -0
- package/02. Layouts/application/page-frame/src/page-frame.html +11 -0
- package/02. Layouts/composition/cluster/cluster.definition.json +24 -0
- package/02. Layouts/composition/cluster/docs/README.md +45 -0
- package/02. Layouts/composition/cluster/docs/api.json +29 -0
- package/02. Layouts/composition/cluster/examples/basic/code.html +3 -0
- package/02. Layouts/composition/cluster/examples/basic/preview.html +6 -0
- package/02. Layouts/composition/cluster/examples/index.json +9 -0
- package/02. Layouts/composition/cluster/src/cluster.html +3 -0
- package/02. Layouts/composition/inline/docs/README.md +45 -0
- package/02. Layouts/composition/inline/docs/api.json +28 -0
- package/02. Layouts/composition/inline/examples/basic/code.html +3 -0
- package/02. Layouts/composition/inline/examples/basic/preview.html +4 -0
- package/02. Layouts/composition/inline/examples/index.json +16 -0
- package/02. Layouts/composition/inline/examples/scrolling/code.html +3 -0
- package/02. Layouts/composition/inline/examples/scrolling/preview.html +14 -0
- package/02. Layouts/composition/inline/inline.definition.json +24 -0
- package/02. Layouts/composition/inline/src/inline.html +3 -0
- package/02. Layouts/composition/overlap/docs/README.md +47 -0
- package/02. Layouts/composition/overlap/docs/api.json +59 -0
- package/02. Layouts/composition/overlap/examples/basic/code.html +8 -0
- package/02. Layouts/composition/overlap/examples/basic/preview.html +9 -0
- package/02. Layouts/composition/overlap/examples/index.json +44 -0
- package/02. Layouts/composition/overlap/examples/size-2xs/code.html +8 -0
- package/02. Layouts/composition/overlap/examples/size-2xs/preview.html +9 -0
- package/02. Layouts/composition/overlap/examples/size-lg/code.html +8 -0
- package/02. Layouts/composition/overlap/examples/size-lg/preview.html +9 -0
- package/02. Layouts/composition/overlap/examples/size-sm/code.html +8 -0
- package/02. Layouts/composition/overlap/examples/size-sm/preview.html +9 -0
- package/02. Layouts/composition/overlap/examples/size-xl/code.html +8 -0
- package/02. Layouts/composition/overlap/examples/size-xl/preview.html +9 -0
- package/02. Layouts/composition/overlap/examples/size-xs/code.html +8 -0
- package/02. Layouts/composition/overlap/examples/size-xs/preview.html +9 -0
- package/02. Layouts/composition/overlap/overlap.definition.json +26 -0
- package/02. Layouts/composition/overlap/src/overlap.scss +51 -0
- package/02. Layouts/composition/sidebar/docs/README.md +84 -0
- package/02. Layouts/composition/sidebar/docs/api.json +70 -0
- package/02. Layouts/composition/sidebar/examples/basic/code.html +8 -0
- package/02. Layouts/composition/sidebar/examples/basic/preview.html +14 -0
- package/02. Layouts/composition/sidebar/examples/index.json +37 -0
- package/02. Layouts/composition/sidebar/examples/large/code.html +8 -0
- package/02. Layouts/composition/sidebar/examples/large/preview.html +14 -0
- package/02. Layouts/composition/sidebar/examples/size-2xs/code.html +8 -0
- package/02. Layouts/composition/sidebar/examples/size-2xs/preview.html +14 -0
- package/02. Layouts/composition/sidebar/examples/size-xs/code.html +8 -0
- package/02. Layouts/composition/sidebar/examples/size-xs/preview.html +14 -0
- package/02. Layouts/composition/sidebar/examples/small/code.html +8 -0
- package/02. Layouts/composition/sidebar/examples/small/preview.html +14 -0
- package/02. Layouts/{sections → composition}/sidebar/sidebar.definition.json +6 -5
- package/02. Layouts/composition/sidebar/src/sidebar.scss +38 -0
- package/02. Layouts/composition/split/docs/README.md +56 -0
- package/02. Layouts/composition/split/docs/api.json +51 -0
- package/02. Layouts/composition/split/examples/basic/code.html +8 -0
- package/02. Layouts/composition/split/examples/basic/preview.html +10 -0
- package/02. Layouts/composition/split/examples/index.json +23 -0
- package/02. Layouts/composition/split/examples/wide-end/code.html +8 -0
- package/02. Layouts/composition/split/examples/wide-end/preview.html +10 -0
- package/02. Layouts/composition/split/examples/wide-start/code.html +8 -0
- package/02. Layouts/composition/split/examples/wide-start/preview.html +10 -0
- package/02. Layouts/{content → composition}/split/split.definition.json +6 -5
- package/02. Layouts/composition/split/src/split.scss +29 -0
- package/02. Layouts/composition/stack/docs/README.md +48 -0
- package/02. Layouts/composition/stack/docs/api.json +61 -0
- package/02. Layouts/composition/stack/examples/basic/code.html +1 -2
- package/02. Layouts/composition/stack/examples/basic/preview.html +12 -2
- package/02. Layouts/composition/stack/examples/compact/code.html +3 -0
- package/02. Layouts/composition/stack/examples/compact/preview.html +14 -0
- package/02. Layouts/composition/stack/examples/index.json +44 -1
- package/02. Layouts/composition/stack/examples/size-2xs/code.html +3 -0
- package/02. Layouts/composition/stack/examples/size-2xs/preview.html +14 -0
- package/02. Layouts/composition/stack/examples/size-lg/code.html +3 -0
- package/02. Layouts/composition/stack/examples/size-lg/preview.html +14 -0
- package/02. Layouts/composition/stack/examples/size-xl/code.html +3 -0
- package/02. Layouts/composition/stack/examples/size-xl/preview.html +14 -0
- package/02. Layouts/composition/stack/examples/size-xs/code.html +3 -0
- package/02. Layouts/composition/stack/examples/size-xs/preview.html +14 -0
- package/02. Layouts/composition/stack/{stack.html → src/stack.html } +1 -2
- package/02. Layouts/composition/stack/stack.definition.json +22 -5
- package/02. Layouts/composition/switcher/docs/README.md +51 -0
- package/02. Layouts/composition/switcher/docs/api.json +37 -0
- package/02. Layouts/composition/switcher/examples/basic/code.html +3 -0
- package/02. Layouts/composition/switcher/examples/basic/preview.html +14 -0
- package/02. Layouts/composition/switcher/examples/index.json +9 -0
- package/02. Layouts/composition/switcher/src/switcher.scss +24 -0
- package/02. Layouts/composition/switcher/switcher.definition.json +26 -0
- package/02. Layouts/content/grid/docs/README.md +77 -0
- package/02. Layouts/content/grid/docs/api.json +67 -0
- package/02. Layouts/content/grid/examples/basic/code.html +2 -4
- package/02. Layouts/content/grid/examples/basic/preview.html +13 -4
- package/02. Layouts/content/grid/examples/dense/code.html +3 -0
- package/02. Layouts/content/grid/examples/dense/preview.html +18 -0
- package/02. Layouts/content/grid/examples/index.json +30 -2
- package/02. Layouts/content/grid/examples/large/code.html +3 -0
- package/02. Layouts/content/grid/examples/large/preview.html +14 -0
- package/02. Layouts/content/grid/examples/size-2xs/code.html +3 -0
- package/02. Layouts/content/grid/examples/size-2xs/preview.html +14 -0
- package/02. Layouts/content/grid/examples/size-xs/code.html +3 -0
- package/02. Layouts/content/grid/examples/size-xs/preview.html +14 -0
- package/02. Layouts/content/grid/grid.definition.json +5 -4
- package/02. Layouts/content/grid/src/grid.scss +32 -0
- package/02. Layouts/content/reel/docs/README.md +81 -0
- package/02. Layouts/content/reel/docs/api.json +67 -0
- package/02. Layouts/content/reel/examples/basic/code.html +3 -0
- package/02. Layouts/content/reel/examples/basic/preview.html +14 -0
- package/02. Layouts/content/reel/examples/index.json +30 -0
- package/02. Layouts/content/reel/examples/size-2xs/code.html +3 -0
- package/02. Layouts/content/reel/examples/size-2xs/preview.html +14 -0
- package/02. Layouts/content/reel/examples/size-xs/code.html +3 -0
- package/02. Layouts/content/reel/examples/size-xs/preview.html +14 -0
- package/02. Layouts/content/reel/examples/small/code.html +3 -0
- package/02. Layouts/content/reel/examples/small/preview.html +14 -0
- package/02. Layouts/content/reel/reel.definition.json +26 -0
- package/02. Layouts/content/reel/src/reel.scss +40 -0
- package/02. Layouts/primitives/center/center.definition.json +24 -0
- package/02. Layouts/primitives/center/docs/README.md +44 -0
- package/02. Layouts/primitives/center/docs/api.json +28 -0
- package/02. Layouts/primitives/center/examples/basic/code.html +3 -0
- package/02. Layouts/primitives/center/examples/basic/preview.html +4 -0
- package/02. Layouts/primitives/center/examples/index.json +16 -0
- package/02. Layouts/primitives/center/examples/minimum-height/code.html +3 -0
- package/02. Layouts/primitives/center/examples/minimum-height/preview.html +4 -0
- package/02. Layouts/primitives/center/src/center.html +3 -0
- package/02. Layouts/primitives/container/container.definition.json +24 -0
- package/02. Layouts/primitives/container/docs/README.md +44 -0
- package/02. Layouts/primitives/container/docs/api.json +28 -0
- package/02. Layouts/primitives/container/examples/basic/code.html +3 -0
- package/02. Layouts/primitives/container/examples/basic/preview.html +6 -0
- package/02. Layouts/primitives/container/examples/index.json +16 -0
- package/02. Layouts/primitives/container/examples/reading/code.html +3 -0
- package/02. Layouts/primitives/container/examples/reading/preview.html +4 -0
- package/02. Layouts/primitives/container/src/container.html +3 -0
- package/02. Layouts/primitives/frame/docs/README.md +45 -0
- package/02. Layouts/primitives/frame/docs/api.json +29 -0
- package/02. Layouts/primitives/frame/examples/basic/code.html +3 -0
- package/02. Layouts/primitives/frame/examples/basic/preview.html +6 -0
- package/02. Layouts/primitives/frame/examples/index.json +16 -0
- package/02. Layouts/primitives/frame/examples/square/code.html +3 -0
- package/02. Layouts/primitives/frame/examples/square/preview.html +6 -0
- package/02. Layouts/primitives/frame/frame.definition.json +24 -0
- package/02. Layouts/primitives/frame/src/frame.html +3 -0
- package/02. Layouts/sections/bleed/bleed.definition.json +24 -0
- package/02. Layouts/sections/bleed/docs/README.md +45 -0
- package/02. Layouts/sections/bleed/docs/api.json +33 -0
- package/02. Layouts/sections/bleed/examples/basic/code.html +11 -0
- package/02. Layouts/sections/bleed/examples/basic/preview.html +14 -0
- package/02. Layouts/sections/bleed/examples/index.json +16 -0
- package/02. Layouts/sections/bleed/examples/reading/code.html +11 -0
- package/02. Layouts/sections/bleed/examples/reading/preview.html +14 -0
- package/02. Layouts/sections/bleed/src/bleed.html +11 -0
- package/02. Layouts/sections/content-grid/content-grid.definition.json +26 -0
- package/02. Layouts/sections/content-grid/docs/README.md +59 -0
- package/02. Layouts/sections/content-grid/docs/api.json +38 -0
- package/02. Layouts/sections/content-grid/examples/basic/code.html +11 -0
- package/02. Layouts/sections/content-grid/examples/basic/preview.html +10 -0
- package/02. Layouts/sections/content-grid/examples/index.json +9 -0
- package/02. Layouts/sections/content-grid/src/content-grid.scss +16 -0
- package/02. Layouts/sections/cover/cover.definition.json +26 -0
- package/02. Layouts/sections/cover/docs/README.md +60 -0
- package/02. Layouts/sections/cover/docs/api.json +50 -0
- package/02. Layouts/sections/cover/examples/basic/code.html +11 -0
- package/02. Layouts/sections/cover/examples/basic/preview.html +8 -0
- package/02. Layouts/sections/cover/examples/compact/code.html +11 -0
- package/02. Layouts/sections/cover/examples/compact/preview.html +8 -0
- package/02. Layouts/sections/cover/examples/index.json +16 -0
- package/02. Layouts/sections/cover/src/cover.scss +41 -0
- package/02. Layouts/sections/section/docs/README.md +52 -0
- package/02. Layouts/sections/section/docs/api.json +63 -0
- package/02. Layouts/sections/section/examples/basic/code.html +2 -2
- package/02. Layouts/sections/section/examples/basic/preview.html +5 -2
- package/02. Layouts/sections/section/examples/index.json +37 -2
- package/02. Layouts/sections/section/examples/size-2xs/code.html +5 -0
- package/02. Layouts/sections/section/examples/size-2xs/preview.html +8 -0
- package/02. Layouts/sections/section/examples/size-md/code.html +5 -0
- package/02. Layouts/sections/section/examples/size-md/preview.html +8 -0
- package/02. Layouts/sections/section/examples/size-sm/code.html +5 -0
- package/02. Layouts/sections/section/examples/size-sm/preview.html +8 -0
- package/02. Layouts/sections/section/examples/size-xl/code.html +5 -0
- package/02. Layouts/sections/section/examples/size-xl/preview.html +8 -0
- package/02. Layouts/sections/section/examples/size-xs/code.html +5 -0
- package/02. Layouts/sections/section/examples/size-xs/preview.html +8 -0
- package/02. Layouts/sections/section/section.definition.json +8 -6
- package/02. Layouts/sections/section/src/section.html +5 -0
- package/03. Components/cards/card/card.definition.json +36 -0
- package/03. Components/cards/card/docs/README.md +27 -0
- package/03. Components/cards/card/docs/api.json +64 -0
- package/03. Components/cards/card/examples/badge-status/code.html +9 -0
- package/03. Components/cards/card/examples/badge-status/preview.html +9 -0
- package/03. Components/cards/card/examples/basic/code.html +6 -0
- package/03. Components/cards/card/examples/basic/preview.html +6 -0
- package/03. Components/cards/card/examples/button-action/code.html +11 -0
- package/03. Components/cards/card/examples/button-action/preview.html +11 -0
- package/03. Components/cards/card/examples/header-footer/code.html +13 -0
- package/03. Components/cards/card/examples/header-footer/preview.html +13 -0
- package/03. Components/cards/card/examples/index.json +48 -0
- package/03. Components/cards/card/examples/media/code.html +9 -0
- package/03. Components/cards/card/examples/media/preview.html +9 -0
- package/03. Components/cards/card/src/card.scss +56 -0
- package/03. Components/cards/card-disclosure/card-disclosure.definition.json +27 -0
- package/03. Components/cards/card-disclosure/docs/README.md +24 -0
- package/03. Components/cards/card-disclosure/docs/api.json +58 -0
- package/03. Components/cards/card-disclosure/examples/basic/code.html +16 -0
- package/03. Components/cards/card-disclosure/examples/basic/preview.html +16 -0
- package/03. Components/cards/card-disclosure/examples/expanded/code.html +16 -0
- package/03. Components/cards/card-disclosure/examples/expanded/preview.html +16 -0
- package/03. Components/cards/card-disclosure/examples/index.json +17 -0
- package/03. Components/cards/card-disclosure/src/card-disclosure.html +16 -0
- package/03. Components/cards/card-utility-summary/card-utility-summary.definition.json +24 -0
- package/03. Components/cards/card-utility-summary/docs/README.md +23 -0
- package/03. Components/cards/card-utility-summary/docs/api.json +33 -0
- package/03. Components/cards/card-utility-summary/examples/basic/code.html +13 -0
- package/03. Components/cards/card-utility-summary/examples/basic/preview.html +13 -0
- package/03. Components/cards/card-utility-summary/examples/compact/code.html +8 -0
- package/03. Components/cards/card-utility-summary/examples/compact/preview.html +8 -0
- package/03. Components/cards/card-utility-summary/examples/index.json +17 -0
- package/03. Components/cards/card-utility-summary/src/card-utility-summary.html +13 -0
- package/03. Components/data-display/statistics/stat-card/docs/README.md +104 -0
- package/03. Components/data-display/statistics/stat-card/docs/api.json +153 -0
- package/03. Components/data-display/statistics/stat-card/examples/action/code.html +8 -0
- package/03. Components/data-display/statistics/stat-card/examples/action/preview.html +21 -0
- package/03. Components/data-display/statistics/stat-card/examples/coloured-values/code.html +4 -0
- package/03. Components/data-display/statistics/stat-card/examples/coloured-values/preview.html +14 -0
- package/03. Components/data-display/statistics/stat-card/examples/icon-led/code.html +13 -0
- package/03. Components/data-display/statistics/stat-card/examples/icon-led/preview.html +27 -0
- package/03. Components/data-display/statistics/stat-card/examples/icons/code.html +8 -0
- package/03. Components/data-display/statistics/stat-card/examples/icons/preview.html +27 -0
- package/03. Components/data-display/statistics/stat-card/examples/index.json +117 -0
- package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/code.html +8 -0
- package/03. Components/data-display/statistics/stat-card/examples/inline-comparison/preview.html +18 -0
- package/03. Components/data-display/statistics/stat-card/examples/long-value/code.html +5 -0
- package/03. Components/data-display/statistics/stat-card/examples/long-value/preview.html +7 -0
- package/03. Components/data-display/statistics/stat-card/examples/minimal/code.html +4 -0
- package/03. Components/data-display/statistics/stat-card/examples/minimal/preview.html +14 -0
- package/03. Components/data-display/statistics/stat-card/examples/sentiments/code.html +11 -0
- package/03. Components/data-display/statistics/stat-card/examples/sentiments/preview.html +26 -0
- package/03. Components/data-display/statistics/stat-card/examples/sizes/code.html +4 -0
- package/03. Components/data-display/statistics/stat-card/examples/sizes/preview.html +14 -0
- package/03. Components/data-display/statistics/stat-card/examples/standard/code.html +8 -0
- package/03. Components/data-display/statistics/stat-card/examples/standard/preview.html +23 -0
- package/03. Components/data-display/statistics/stat-card/examples/states/code.html +5 -0
- package/03. Components/data-display/statistics/stat-card/examples/states/preview.html +17 -0
- package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/code.html +8 -0
- package/03. Components/data-display/statistics/stat-card/examples/trailing-trend/preview.html +18 -0
- package/03. Components/data-display/statistics/stat-card/src/stat-card.scss +253 -0
- package/03. Components/data-display/statistics/stat-card/stat-card.definition.json +49 -0
- package/03. Components/media/identity/avatar-group/avatar-group.definition.json +39 -0
- package/03. Components/media/identity/avatar-group/docs/README.md +37 -0
- package/03. Components/media/identity/avatar-group/docs/api.json +99 -0
- package/03. Components/media/identity/avatar-group/examples/count/code.html +19 -0
- package/03. Components/media/identity/avatar-group/examples/count/preview.html +19 -0
- package/03. Components/media/identity/avatar-group/examples/count-icon/code.html +19 -0
- package/03. Components/media/identity/avatar-group/examples/count-icon/preview.html +19 -0
- package/03. Components/media/identity/avatar-group/examples/group/code.html +18 -0
- package/03. Components/media/identity/avatar-group/examples/group/preview.html +18 -0
- package/03. Components/media/identity/avatar-group/examples/index.json +38 -0
- package/03. Components/media/identity/avatar-group/examples/rtl/code.html +19 -0
- package/03. Components/media/identity/avatar-group/examples/rtl/preview.html +19 -0
- package/03. Components/media/identity/avatar-group/examples/sizes/code.html +14 -0
- package/03. Components/media/identity/avatar-group/examples/sizes/preview.html +27 -0
- package/03. Components/media/identity/avatar-group/src/avatar-group.scss +72 -0
- package/03. Components/navigation/menus/navigation-menu/docs/README.md +34 -0
- package/03. Components/navigation/menus/navigation-menu/docs/api.json +70 -0
- package/03. Components/navigation/menus/navigation-menu/examples/groups/code.html +27 -0
- package/03. Components/navigation/menus/navigation-menu/examples/groups/preview.html +27 -0
- package/03. Components/navigation/menus/navigation-menu/examples/horizontal/code.html +19 -0
- package/03. Components/navigation/menus/navigation-menu/examples/horizontal/preview.html +19 -0
- package/03. Components/navigation/menus/navigation-menu/examples/icon-links/code.html +36 -0
- package/03. Components/navigation/menus/navigation-menu/examples/icon-links/preview.html +36 -0
- package/03. Components/navigation/menus/navigation-menu/examples/index.json +45 -0
- package/03. Components/navigation/menus/navigation-menu/examples/nested/code.html +21 -0
- package/03. Components/navigation/menus/navigation-menu/examples/nested/preview.html +21 -0
- package/03. Components/navigation/menus/navigation-menu/examples/separators/code.html +22 -0
- package/03. Components/navigation/menus/navigation-menu/examples/separators/preview.html +22 -0
- package/03. Components/navigation/menus/navigation-menu/examples/vertical/code.html +19 -0
- package/03. Components/navigation/menus/navigation-menu/examples/vertical/preview.html +19 -0
- package/03. Components/navigation/menus/navigation-menu/navigation-menu.definition.json +38 -0
- package/03. Components/navigation/menus/navigation-menu/src/navigation-menu.scss +78 -0
- package/03. Components/navigation/sidebars/floating-sidebar/docs/README.md +34 -0
- package/03. Components/navigation/sidebars/floating-sidebar/docs/api.json +58 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/code.html +42 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/animated/preview.html +42 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/code.html +43 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/branded/preview.html +43 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/code.html +50 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/grouped/preview.html +50 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/index.json +50 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/long/code.html +66 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/long/preview.html +66 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/code.html +51 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/profile/preview.html +51 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/code.html +42 -0
- package/03. Components/navigation/sidebars/floating-sidebar/examples/standard/preview.html +42 -0
- package/03. Components/navigation/sidebars/floating-sidebar/floating-sidebar.definition.json +52 -0
- package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.js +73 -0
- package/03. Components/navigation/sidebars/floating-sidebar/src/floating-sidebar.scss +138 -0
- package/README.md +60 -11
- package/dist/catalogue.json +442 -0
- package/dist/components/app-shell.css +76 -64
- package/dist/components/avatar-group.css +69 -0
- package/dist/components/avatar.css +98 -176
- package/dist/components/badge.css +118 -0
- package/dist/components/button-lumen-shift.css +388 -0
- package/dist/components/button.css +58 -28
- package/dist/components/card.css +47 -0
- package/dist/components/checkbox.css +129 -0
- package/dist/components/content-grid.css +16 -0
- package/dist/components/cover.css +41 -0
- package/dist/components/floating-sidebar.css +136 -0
- package/dist/components/grid.css +23 -13
- package/dist/components/navigation-item.css +169 -0
- package/dist/components/navigation-menu.css +74 -0
- package/dist/components/overlap.css +51 -0
- package/dist/components/reel.css +40 -0
- package/dist/components/select.css +288 -0
- package/dist/components/sidebar.css +33 -17
- package/dist/components/split.css +23 -16
- package/dist/components/stat-card.css +219 -0
- package/dist/components/switcher.css +24 -0
- package/dist/components/tooltip.css +101 -0
- package/package.json +7 -4
- package/schemas/reusable-ui.schema.json +145 -2
- package/tooling/cli/asset-organisation.mjs +126 -0
- package/tooling/cli/build.mjs +14 -7
- package/tooling/cli/cli.mjs +46 -19
- package/tooling/cli/commands.mjs +10 -0
- package/tooling/cli/configuration.mjs +60 -0
- package/tooling/cli/migrate.mjs +7 -4
- package/tooling/cli/project.mjs +188 -20
- package/tooling/registry/catalogue-index.mjs +54 -0
- package/tooling/registry/categories.mjs +3 -0
- package/tooling/registry/definitions.mjs +86 -9
- package/tooling/registry/native.mjs +32 -0
- package/tools/build-css.mjs +84 -30
- package/01. Elements/actions/controls/button/button.scss +0 -80
- package/01. Elements/actions/controls/button/docs.md +0 -41
- package/01. Elements/media/identity/avatar/api.json +0 -126
- package/01. Elements/media/identity/avatar/avatar.scss +0 -80
- package/01. Elements/media/identity/avatar/docs.md +0 -64
- package/01. Elements/media/identity/avatar/examples/badges/code.html +0 -10
- package/01. Elements/media/identity/avatar/examples/badges/preview.html +0 -29
- package/01. Elements/media/identity/avatar/examples/fallbacks/code.html +0 -5
- package/01. Elements/media/identity/avatar/examples/fallbacks/preview.html +0 -23
- package/01. Elements/media/identity/avatar/examples/presence/code.html +0 -6
- package/01. Elements/media/identity/avatar/examples/presence/preview.html +0 -26
- package/01. Elements/media/identity/avatar/examples/shapes/code.html +0 -5
- package/01. Elements/media/identity/avatar/examples/shapes/preview.html +0 -17
- package/02. Layouts/application/app-shell/api.json +0 -46
- package/02. Layouts/application/app-shell/app-shell.scss +0 -68
- package/02. Layouts/application/app-shell/docs.md +0 -31
- package/02. Layouts/application/app-shell/examples/basic/code.html +0 -17
- package/02. Layouts/application/app-shell/examples/basic/preview.html +0 -17
- package/02. Layouts/application/app-shell/examples/collapsed/code.html +0 -17
- package/02. Layouts/application/app-shell/examples/collapsed/preview.html +0 -17
- package/02. Layouts/application/app-shell/examples/hidden/code.html +0 -17
- package/02. Layouts/application/app-shell/examples/hidden/preview.html +0 -17
- package/02. Layouts/composition/stack/api.json +0 -1
- package/02. Layouts/composition/stack/docs.md +0 -5
- package/02. Layouts/content/grid/api.json +0 -23
- package/02. Layouts/content/grid/docs.md +0 -19
- package/02. Layouts/content/grid/grid.scss +0 -5
- package/02. Layouts/content/split/api.json +0 -23
- package/02. Layouts/content/split/docs.md +0 -18
- package/02. Layouts/content/split/examples/basic/code.html +0 -4
- package/02. Layouts/content/split/examples/basic/preview.html +0 -4
- package/02. Layouts/content/split/examples/index.json +0 -9
- package/02. Layouts/content/split/split.scss +0 -7
- package/02. Layouts/primitives/overlay/api.json +0 -23
- package/02. Layouts/primitives/overlay/docs.md +0 -19
- package/02. Layouts/primitives/overlay/examples/basic/code.html +0 -5
- package/02. Layouts/primitives/overlay/examples/basic/preview.html +0 -5
- package/02. Layouts/primitives/overlay/examples/index.json +0 -9
- package/02. Layouts/primitives/overlay/overlay.definition.json +0 -25
- package/02. Layouts/primitives/overlay/overlay.scss +0 -4
- package/02. Layouts/sections/section/api.json +0 -23
- package/02. Layouts/sections/section/docs.md +0 -19
- package/02. Layouts/sections/section/section.scss +0 -4
- package/02. Layouts/sections/sidebar/api.json +0 -23
- package/02. Layouts/sections/sidebar/docs.md +0 -18
- package/02. Layouts/sections/sidebar/examples/basic/code.html +0 -4
- package/02. Layouts/sections/sidebar/examples/basic/preview.html +0 -4
- package/02. Layouts/sections/sidebar/examples/index.json +0 -9
- package/02. Layouts/sections/sidebar/sidebar.scss +0 -7
- package/dist/components/overlay.css +0 -17
- 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
|
+
}
|
package/tooling/cli/migrate.mjs
CHANGED
|
@@ -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=
|
|
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=
|
|
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');
|
package/tooling/cli/project.mjs
CHANGED
|
@@ -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=
|
|
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
|
|
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(
|
|
92
|
+
fs.mkdirSync(path.dirname(location),{recursive:true});
|
|
79
93
|
assertWithin(base,location);
|
|
80
|
-
const temp=location+'.tmp';assertWithin(base,temp);
|
|
81
|
-
|
|
82
|
-
|
|
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};
|
|
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})=>
|
|
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)
|
|
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 `
|
|
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
|
-
|
|
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(
|
|
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
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
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
|
-
|
|
6
|
-
|
|
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
|
-
|
|
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(
|
|
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]
|
|
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
|
|
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
|
}
|