@buffercreations/levelsui 0.1.1 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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 +48 -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 +163 -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 +163 -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 @@
|
|
|
1
|
+
<span class="bce-badge bc-is-success">Active</span>
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
<span class="bce-badge">Soft</span>
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
// Badge — Level 01 / Elements. Passive, framework-neutral and Core Semantic-only.
|
|
2
|
+
// Intentionally no native default: <span> and <a> are too broad to style globally.
|
|
3
|
+
.bce-badge {
|
|
4
|
+
--bce-badge-pad-block: var(--bc-size-ui-4);
|
|
5
|
+
--bce-badge-pad-inline: var(--bc-size-ui-8);
|
|
6
|
+
--bce-badge-gap: var(--bc-size-ui-4);
|
|
7
|
+
--bce-badge-icon-size: var(--bc-size-ui-12);
|
|
8
|
+
--bce-badge-radius: var(--bc-radius-sm);
|
|
9
|
+
--bce-badge-background: var(--bc-color-fill-context-soft);
|
|
10
|
+
--bce-badge-colour: var(--bc-color-text-context-strong);
|
|
11
|
+
--bce-badge-border: transparent;
|
|
12
|
+
display: inline-flex;
|
|
13
|
+
box-sizing: border-box;
|
|
14
|
+
inline-size: fit-content;
|
|
15
|
+
max-inline-size: 100%;
|
|
16
|
+
padding: var(--bce-badge-pad-block) var(--bce-badge-pad-inline);
|
|
17
|
+
align-items: center;
|
|
18
|
+
justify-content: center;
|
|
19
|
+
gap: var(--bce-badge-gap);
|
|
20
|
+
border: var(--bc-border-width-xs) solid var(--bce-badge-border);
|
|
21
|
+
border-radius: var(--bce-badge-radius);
|
|
22
|
+
background: var(--bce-badge-background);
|
|
23
|
+
color: var(--bce-badge-colour);
|
|
24
|
+
font-family: var(--bc-type-label-4-font-family);
|
|
25
|
+
font-size: var(--bc-type-label-4-font-size);
|
|
26
|
+
font-weight: var(--bc-type-label-4-font-weight);
|
|
27
|
+
line-height: var(--bc-type-label-4-line-height);
|
|
28
|
+
letter-spacing: var(--bc-type-label-4-letter-spacing);
|
|
29
|
+
text-align: center;
|
|
30
|
+
text-decoration: none;
|
|
31
|
+
vertical-align: middle;
|
|
32
|
+
white-space: normal;
|
|
33
|
+
overflow-wrap: anywhere;
|
|
34
|
+
}
|
|
35
|
+
// Treatments map only to existing context Semantics: consumers may override hooks.
|
|
36
|
+
.bce-badge--solid {
|
|
37
|
+
--bce-badge-background: var(--bc-color-fill-context-strong);
|
|
38
|
+
--bce-badge-colour: var(--bc-color-text-context-inverse-strong);
|
|
39
|
+
}
|
|
40
|
+
.bce-badge--outline {
|
|
41
|
+
--bce-badge-background: transparent;
|
|
42
|
+
--bce-badge-colour: var(--bc-color-text-context-strong);
|
|
43
|
+
--bce-badge-border: var(--bc-color-border-context-strong);
|
|
44
|
+
}
|
|
45
|
+
.bce-badge--ghost {
|
|
46
|
+
--bce-badge-background: transparent;
|
|
47
|
+
--bce-badge-colour: var(--bc-color-text-context-strong);
|
|
48
|
+
}
|
|
49
|
+
// Small uses Label/L4, matching the default typography with tighter spacing.
|
|
50
|
+
.bce-badge--sm {
|
|
51
|
+
--bce-badge-pad-block: var(--bc-size-ui-2);
|
|
52
|
+
--bce-badge-pad-inline: var(--bc-size-ui-6);
|
|
53
|
+
--bce-badge-gap: var(--bc-size-ui-4);
|
|
54
|
+
--bce-badge-icon-size: var(--bc-size-ui-12);
|
|
55
|
+
font-family: var(--bc-type-label-4-font-family);
|
|
56
|
+
font-size: var(--bc-type-label-4-font-size);
|
|
57
|
+
font-weight: var(--bc-type-label-4-font-weight);
|
|
58
|
+
line-height: var(--bc-type-label-4-line-height);
|
|
59
|
+
letter-spacing: var(--bc-type-label-4-letter-spacing);
|
|
60
|
+
}
|
|
61
|
+
.bce-badge--lg {
|
|
62
|
+
--bce-badge-pad-block: var(--bc-size-ui-6);
|
|
63
|
+
--bce-badge-pad-inline: var(--bc-size-ui-12);
|
|
64
|
+
--bce-badge-gap: var(--bc-size-ui-6);
|
|
65
|
+
--bce-badge-icon-size: var(--bc-size-ui-16);
|
|
66
|
+
font-family: var(--bc-type-label-3-font-family);
|
|
67
|
+
font-size: var(--bc-type-label-3-font-size);
|
|
68
|
+
font-weight: var(--bc-type-label-3-font-weight);
|
|
69
|
+
line-height: var(--bc-type-label-3-line-height);
|
|
70
|
+
letter-spacing: var(--bc-type-label-3-letter-spacing);
|
|
71
|
+
}
|
|
72
|
+
.bce-badge__icon,
|
|
73
|
+
.bce-badge__spinner {
|
|
74
|
+
display: inline-flex;
|
|
75
|
+
flex: none;
|
|
76
|
+
inline-size: var(--bce-badge-icon-size);
|
|
77
|
+
block-size: var(--bce-badge-icon-size);
|
|
78
|
+
align-items: center;
|
|
79
|
+
justify-content: center;
|
|
80
|
+
}
|
|
81
|
+
.bce-badge__icon > :is(svg, iconify-icon),
|
|
82
|
+
.bce-badge__spinner > :is(svg, iconify-icon) {
|
|
83
|
+
display: block;
|
|
84
|
+
inline-size: 100%;
|
|
85
|
+
block-size: 100%;
|
|
86
|
+
}
|
|
87
|
+
.bce-badge__label {
|
|
88
|
+
min-inline-size: 0;
|
|
89
|
+
}
|
|
90
|
+
// Spinner motion is optional and decorative; status must also be conveyed in text.
|
|
91
|
+
@media (prefers-reduced-motion: no-preference) {
|
|
92
|
+
.bce-badge__spinner[data-animate="spin"] {
|
|
93
|
+
animation: bce-badge-spin 1s linear infinite;
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
@keyframes bce-badge-spin { to { transform: rotate(360deg); } }
|
|
97
|
+
// A link is a link; do not turn ordinary badges into pseudo-controls.
|
|
98
|
+
a.bce-badge[href] {
|
|
99
|
+
cursor: pointer;
|
|
100
|
+
transition: background-color var(--bc-motion-interaction), border-color var(--bc-motion-interaction);
|
|
101
|
+
}
|
|
102
|
+
a.bce-badge[href]:hover {
|
|
103
|
+
text-decoration: underline;
|
|
104
|
+
text-underline-offset: 0.15em;
|
|
105
|
+
}
|
|
106
|
+
a.bce-badge[href]:focus-visible {
|
|
107
|
+
outline: var(--bc-border-width-md) solid var(--bc-color-focus);
|
|
108
|
+
outline-offset: var(--bc-size-ui-2);
|
|
109
|
+
}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
# Layout refinement review
|
|
2
|
+
|
|
3
|
+
The collection contains 18 Layouts. Nine use Core utility recipes and nine own scoped arrangement CSS. All Code examples retain structural insertion comments and each authored base supplies its defaults.
|
|
4
|
+
|
|
5
|
+
## Review of the existing collection
|
|
6
|
+
|
|
7
|
+
| Layout | Refinement and intended constraint |
|
|
8
|
+
|---|---|
|
|
9
|
+
| Container | Reviewed the page and reading measures, fluid gutters and nested use. The recipe continues to use the existing Core container utilities. Exceptional unbroken text follows the content guidance below. |
|
|
10
|
+
| Center | Reviewed available-space centring, optional UI minimum height and narrow parents. The complete composition remains a Core recipe. |
|
|
11
|
+
| Frame | Reviewed media ratios, cropping and bounded dimensions. Use the documented width/height/object-fit utilities on replaced media. |
|
|
12
|
+
| Stack | Existing named spacing choices already scale the relevant vertical gap through fluid Semantics. Reviewed empty and varying item counts. |
|
|
13
|
+
| Inline | Retains a non-wrapping row and now contains excess width through accessible native scrolling. Its Core recipe adds an overflow region with an accessible label and keyboard focus. |
|
|
14
|
+
| Cluster | Reviewed native wrapping, variable item counts and narrow-parent behaviour. Its gap uses the existing fluid scale. |
|
|
15
|
+
| Split | Replaced viewport tracks with intrinsic flex bases. Equal and two-to-one arrangements wrap when their complete bases and fluid gap need more room. |
|
|
16
|
+
| Sidebar | Preserved secondary width meanings and the parent-capped main minimum. Sizes now coordinate the secondary basis and fluid gap. The md gap uses fluid-md. |
|
|
17
|
+
| Switcher | Derives its nominal threshold from the inferred two-to-four item count, semantic UI construction basis and fluid gaps. This makes the threshold specific to the group. |
|
|
18
|
+
| Grid | Preserved auto-fit tracks and width meanings. Size modifiers coordinate track minima and fluid gaps. Scoped wrapping handles unbroken text. |
|
|
19
|
+
| Reel | Sizes coordinate item cap, gap and block padding. Logical overscroll containment, native touch/keyboard scrolling and focus visibility are exercised. |
|
|
20
|
+
| Section | Existing spacing choices already scale block padding through the fluid scale. The recipe composes the Container boundary. |
|
|
21
|
+
| Cover | Compact now coordinates viewport minimum, structural gaps, padding and body gap. Padding is capped against available width. |
|
|
22
|
+
| Content Grid | Retains reading/full-width named lines. Fluid gutter minima are capped for narrow parent regions and text can wrap within the track. |
|
|
23
|
+
| Page Frame | Reviewed short pages, long pages, native landmarks and footer placement. Core flex and viewport-minimum utilities provide the arrangement. |
|
|
24
|
+
| App Shell | Uses the body group for named optional regions and intrinsic header/footer height. The main track now enforces its declared 20rem minimum alongside sidebars, and configuration-specific 60rem (dual) / 40rem (single) container queries reflow built-in width presets in source order. No direct-part compatibility or content-dependent rail/drawer logic is claimed. |
|
|
25
|
+
|
|
26
|
+
## Added Layouts
|
|
27
|
+
|
|
28
|
+
Bleed establishes an outer page-width boundary with explicit guttered regions and full-width children. It uses Core width, maximum-width, margin, flex, gap and gutter utilities. Its HTML wrappers make the boundary explicit in normal flow. Content Grid remains useful when ordinary children should automatically occupy a reading track and a named part should span the full grid.
|
|
29
|
+
|
|
30
|
+
Overlap shares a fluid grid row between the media and following content region. Both regions contribute to the document height. Insets follow the gutter family and are capped against available width. Size presets coordinate overlap depth and inset family using the existing 2xs through xl fluid roles.
|
|
31
|
+
|
|
32
|
+
## Proportional sizing and overrides
|
|
33
|
+
|
|
34
|
+
Grid and Sidebar sizes combine their established width roles with the matching fluid gap. Reel combines its established item caps with the matching gap and an appropriate smaller block-padding step. Stable item minima remain deliberate construction constraints. Existing Core fluid roles already provide Stack gap and Section padding scales.
|
|
35
|
+
|
|
36
|
+
Preset selectors use zero specificity. The existing example below therefore applies small Grid construction values and an explicit extra-large gap.
|
|
37
|
+
|
|
38
|
+
```html
|
|
39
|
+
<div class="bcl-grid bcl-grid--sm bc-gap-xl">
|
|
40
|
+
<!-- Grid items go here as direct children. -->
|
|
41
|
+
</div>
|
|
42
|
+
```
|
|
43
|
+
|
|
44
|
+
Switcher computes a nominal threshold from its default gap variable. A Core gap utility changes the visible gap. A consuming stylesheet can map `--bcl-switcher-gap` to the same approved Semantic when a threshold coordinated with that override is required. The group infers its two-to-four item count from the DOM.
|
|
45
|
+
|
|
46
|
+
## App Shell structure and compatibility
|
|
47
|
+
|
|
48
|
+
Place sidebar and main inside `bcl-app-shell__body`. Header, body and footer are the root regions. The body groups the intrinsic pair between the full-width chrome and allows the main region to use the available width after wrapping.
|
|
49
|
+
|
|
50
|
+
The current catalogue requires sidebar/main/aside regions inside `bcl-app-shell__body`. Earlier direct-part markup is not supported by the current stylesheet. The body structure provides container-dependent reflow; migrate direct-part markup explicitly when updating an installed snapshot. Review existing consumer markup when adopting the refined catalogue snapshot. Installed snapshots update only through an explicit consumer update.
|
|
51
|
+
|
|
52
|
+
The Preview includes a native skip link to main content. Consumers supply their own navigation, headings and accessible labels in the Code insertion points.
|
|
53
|
+
|
|
54
|
+
## Long content and Foundation gap
|
|
55
|
+
|
|
56
|
+
Authored Layouts reset their intrinsic inline minima and inherit scoped `overflow-wrap: anywhere`. This supports long labels, links and identifiers while preserving normal DOM order. Preformatted blocks, tables and intrinsically wide media retain their own content requirements. An accessible local `bc-overflow-x-auto` wrapper can contain intentionally wide content.
|
|
57
|
+
|
|
58
|
+
Core currently has no general wrap-anywhere or zero logical minimum utility. Pure utility recipes therefore require a content-level strategy for exceptional unbroken strings. Native `wbr` opportunities preserve the string while allowing wrapping. A focusable, labelled local overflow region supports deliberate horizontal reading. The regression suite records raw recipe overflow cases and verifies the native wrapping composition. It keeps this limitation visible in its evidence.
|
|
59
|
+
|
|
60
|
+
A shared logical minimum-size reset and a text-wrap utility are Foundation candidates. Existing structural CSS values provide their behaviour and require no new Primitive. Core SCSS changes need explicit owner approval. The existing collection audit also records proposed larger UI-size Semantic mappings.
|
|
61
|
+
|
|
62
|
+
## Evaluated additions
|
|
63
|
+
|
|
64
|
+
Masonry remains deferred. Native Grid Level 3 feature support is probed in the installed browser and recorded in the browser evidence. A multicolumn fallback changes the spatial reading progression, and a script-driven packer adds measurement and lifecycle responsibilities. Cross-engine verification and an agreed reading/focus model are needed before introducing that contract. The Grid Level 3 editor draft describes the placement and reading-order considerations. [CSS Grid Layout Module Level 3](https://drafts.csswg.org/css-grid-3/)
|
|
65
|
+
|
|
66
|
+
Dock was reviewed against Core positioning, layering, height and overflow utilities. The common sticky-region case is already expressible as a small recipe in consuming markup.
|
|
67
|
+
|
|
68
|
+
```html
|
|
69
|
+
<aside class="bc-sticky bc-top-0 bc-layer-sticky">
|
|
70
|
+
<!-- Sticky region content goes here. -->
|
|
71
|
+
</aside>
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
Sticky regions depend on their scroll ancestor and available height. Review tall content and zoom before selecting sticky placement. A new registered Dock Asset would currently repeat this existing capability, so it was omitted from the catalogue.
|
|
75
|
+
|
|
76
|
+
## Validation scope
|
|
77
|
+
|
|
78
|
+
The browser suite exercises 320, 375, 768, 1024, 1440 and 1920 CSS-pixel viewports, narrow parents, nested compositions, empty regions, varying counts, long strings, RTL, text enlargement, keyboard scrolling and touch scrolling. Every size is measured for an ordered dimension change and related spacing. Explicit Core gap and padding overrides are checked on each applicable preset.
|
|
79
|
+
|
|
80
|
+
Native 200% and 400% desktop page zoom uses the browser tabs zoom API in an isolated Microsoft Edge profile with a temporary test extension. The test asserts the zoom factor, CSS viewport reflow, device-pixel-ratio change and page overflow. Text enlargement is exercised separately. Set `BC_ZOOM_BROWSER_EXECUTABLE` to another extension-capable Chromium executable when required. The isolated profile and extension are disposed after verification.
|
|
81
|
+
|
|
82
|
+
Run the existing Layout contract, browser and packed-consumer commands together with the LevelsUI verification gate, Documentation tests and `verify:source`. Browser results identify the actual engine and executed checks. Firefox, WebKit and assistive-technology certification require their own acceptance runs.
|
|
@@ -1,45 +1,131 @@
|
|
|
1
|
-
#
|
|
1
|
+
# Layout collection
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
The collection provides spatial contracts, not a visual theme. Each Asset owns its definition, API, guide and Preview/Code examples. Discover the current catalogue through `levelsui list`; this guide is a selection aid, not another registry.
|
|
4
|
+
|
|
5
|
+
| Need | Layout | Implementation |
|
|
6
|
+
|---|---|---|
|
|
7
|
+
| Page or reading-width boundary | [Container](primitives/container/docs/README.md) | Recipe |
|
|
8
|
+
| Centre a group within available space | [Center](primitives/center/docs/README.md) | Recipe |
|
|
9
|
+
| Aspect-ratio media | [Frame](primitives/frame/docs/README.md) | Recipe |
|
|
10
|
+
| Vertical rhythm | [Stack](composition/stack/docs/README.md) | Recipe |
|
|
11
|
+
| Native scrolling non-wrapping row | [Inline](composition/inline/docs/README.md) | Recipe |
|
|
12
|
+
| Naturally wrapping items | [Cluster](composition/cluster/docs/README.md) | Recipe |
|
|
13
|
+
| Two intrinsic proportional regions | [Split](composition/split/docs/README.md) | Authored flex bases |
|
|
14
|
+
| Secondary region beside readable main content | [Sidebar](composition/sidebar/docs/README.md) | Intrinsic flex sizing |
|
|
15
|
+
| All columns switch to a stack together | [Switcher](composition/switcher/docs/README.md) | Intrinsic flex sizing |
|
|
16
|
+
| Arbitrary-length responsive collection | [Grid](content/grid/docs/README.md) | Auto-fit tracks |
|
|
17
|
+
| Native horizontal browsing | [Reel](content/reel/docs/README.md) | Item sizing and scroll snap |
|
|
18
|
+
| Full-width surface with contained content | [Section](sections/section/docs/README.md) | Recipe |
|
|
19
|
+
| Header/body/footer distributed over a tall region | [Cover](sections/cover/docs/README.md) | Expanding middle row |
|
|
20
|
+
| Reading measure with full-width interruptions | [Content Grid](sections/content-grid/docs/README.md) | Named grid lines |
|
|
21
|
+
| Footer following short or long page content | [Page Frame](application/page-frame/docs/README.md) | Recipe |
|
|
22
|
+
| Responsive application chrome and navigation | [App Shell](application/app-shell/docs/README.md) | Named responsive areas |
|
|
23
|
+
| Guttered content and full-width bands | [Bleed](sections/bleed/docs/README.md) | Recipe |
|
|
24
|
+
| Media and an overlapping content region | [Overlap](composition/overlap/docs/README.md) | Shared grid row |
|
|
25
|
+
|
|
26
|
+
## Compose before authoring
|
|
27
|
+
|
|
28
|
+
Recipes add no CSS: their Core utility markup is the complete Layout. An authored Layout works with its `bcl-*` base class and required anatomy alone. It supplies default display, wrapping, semantic spacing, overflow and sizing where needed. Modifiers change an already working Layout; Core utilities remain optional overrides. Defaults use low-specificity selectors so those overrides work without `!important`. Every authored guide records the alternatives checked.
|
|
29
|
+
|
|
30
|
+
Ordinary Layout Code examples contain only the Layout structure and comments identifying consumer content regions. Preview retains populated demonstrations. Future integration examples use explicit example-only dependencies and do not impose extra Layout-wide components. Recipe source HTML matches its structural basic Code example; Section retains its direct Container dependency.
|
|
31
|
+
|
|
32
|
+
Core owns spacing, container measures, typography, colour contexts, surfaces, borders, radius, shadows and motion. Authored dimensions use existing Semantics. Structural ratios, zero minima, grid counts and viewport proportions describe layout relationships. No Foundation files, Primitive mappings or Behaviours are added.
|
|
33
|
+
|
|
34
|
+
No Layout loads JavaScript. Reel uses native scrolling; App Shell is document flow, not a drawer or fixed application viewport. Compose native controls and verified shared Behaviours separately when an interaction is needed.
|
|
35
|
+
|
|
36
|
+
## Foundation candidates
|
|
37
|
+
|
|
38
|
+
These are proposals from the audit, not exported classes or approved token additions. Existing spacing, UI dimensions, container widths, gutters, breakpoints and focus tokens already cover the current default values. No new Primitive is justified by this collection.
|
|
39
|
+
|
|
40
|
+
| Candidate | Affected Layouts and evidence | Layer and proposed direction | Responsive/accessibility/cost review |
|
|
41
|
+
|---|---|---|---|
|
|
42
|
+
| Logical shrink/reset helpers | Grid, Split, Sidebar, Switcher, Content Grid, Cover and App Shell need zero child inline minima; Core sizing utilities lack the zero logical minimum. | Structural Utility; no token or Primitive is needed for zero. Consider a logical minimum-size reset with a deliberate name. | Must work in RTL/vertical writing and nested flex/grid; small selector cost. Child application stays explicit. |
|
|
43
|
+
| Intrinsic equal-column grid | Grid requires auto-fit/minmax tracks; bc-grid supplies display only. | Utility with approved semantic minimum sizes. A purpose-led collection minimum Semantic could map to existing size-ui roles if generic UI sizing proves too broad. | Cap the minimum to container width, test text zoom and long content. Could make Grid a recipe; avoid a speculative combinatorial column API. |
|
|
44
|
+
| Intrinsic proportional regions | Split uses weighted construction bases and growth factors to preserve equal or asymmetric proportions when they fit. | Structural flex Utilities with existing UI sizing Semantics. | Preserve DOM order and zero minima. Review a small set of ratios and their wrap thresholds. |
|
|
45
|
+
| Intrinsic paired-region sizing | Sidebar pairs a secondary basis with a flexible main minimum; existing flex/width utilities cannot express the full contract. | Reusable intrinsic flex Utilities; consider minimum-main/secondary-basis Semantics only if multiple consumers need intent-specific roles. Existing size-ui tokens remain sufficient for this version. | Wrapping must include gaps and cap minima to the parent. No visual reordering. Could make Sidebar a recipe if the paired API stays understandable. |
|
|
46
|
+
| Group switching threshold | Switcher derives its threshold from the group count, semantic UI basis and nominal fluid gaps. | Intrinsic switching Utility using construction dimensions. | Review two-to-four items, CSS group-count inference, translation and explicit gap adjustments. |
|
|
47
|
+
| Logical scrolling collection | Reel needs non-shrinking capped item bases, proximity snapping and a focus indicator. Core has flex/overflow but not this combination. | Utilities for logical snap/alignment and semantic item sizing, with a reusable focus treatment reviewed separately. | Preserve native keyboard scrolling, visible scrollbars, LTR/RTL and reduced motion. Do not introduce a carousel controller. Could make Reel a recipe. |
|
|
48
|
+
| Small-viewport minimums | Cover and App Shell need svh with a vh fallback; Core currently exposes vh minimum-height helpers only. | Viewport/logical sizing Utilities; viewport proportions need no new Primitive. | Test browser chrome, large text and growing content. This would remove one authored gap, not the named grid-row/area contracts. |
|
|
49
|
+
| Named reading/full-width tracks | Content Grid needs semantic gutters and named spanning lines. Existing Container cannot span selected children beyond its boundary. | Review a reusable grid capability; keep it in Layouts unless several unrelated consumers justify a Foundation API. | Parent-relative widths, no scrollbar breakout or reading-order change. Higher API/selector cost than simple Utilities. |
|
|
50
|
+
|
|
51
|
+
Cover's named header/body/footer rows and App Shell's named responsive application regions remain appropriate Layout-owned anatomy. Missing isolated helpers do not automatically justify moving their complete contracts into Foundations. Reassess utility-only feasibility after any approved Foundation additions; do not keep an authored class merely to preserve a name.
|
|
52
|
+
|
|
53
|
+
## Size range audit
|
|
54
|
+
|
|
55
|
+
The naming convention is `2xs`, `xs`, `sm`, `md`, `lg`, `xl`, `2xl`. Each Layout exposes useful steps supported by existing Semantics. Width meanings and default size names are preserved. Related gaps and padding now follow each preset. Smaller widths suit compact content, with the Preview examples showing appropriately compact regions.
|
|
56
|
+
|
|
57
|
+
| Layout / dimension | Shipped range | Default | Limit / decision |
|
|
58
|
+
|---|---|---|---|
|
|
59
|
+
| Grid minimum track width | 2xs, xs, sm, md, lg | md | UI width Semantics currently end at size-ui-320. |
|
|
60
|
+
| Sidebar basis and gap | 2xs, xs, sm, md, lg | md | Sizes coordinate the secondary basis and fluid gap. The main minimum retains its purpose. |
|
|
61
|
+
| Reel item cap, gap and padding | 2xs, xs, sm, md | md | Size-ui-320 remains the md cap. Presets also adjust fluid gap and block padding. |
|
|
62
|
+
| Stack vertical gap | 2xs, xs, sm, md, lg, xl | md | Uses existing bc-gap-* utilities; no fluid-2xl Semantic exists. |
|
|
63
|
+
| Section block padding | 2xs, xs, sm, md, lg, xl | lg | Uses existing bc-py-* utilities; no fluid-2xl Semantic exists. |
|
|
64
|
+
| Overlap depth and inset | 2xs, xs, sm, md, lg, xl | md | Uses existing fluid spacing and gutter families. |
|
|
65
|
+
| Other Layouts | Their existing arrangement, measure, aspect-ratio or content-dependent controls | Unchanged | Do not force a size axis onto Split proportions, Cover variants, viewport structure or content measures. Existing Core spacing utilities remain available for optional adjustments. |
|
|
66
|
+
|
|
67
|
+
### Proposed larger width mappings — not shipped
|
|
68
|
+
|
|
69
|
+
Larger minimum/item widths are reasonable future needs. Existing internal rem Primitives include 400, 480 and 560, but there are no corresponding public UI sizing Semantics. Proposed Foundation mappings are `--bc-size-ui-400` → `--bc-size-rem-400`, `--bc-size-ui-480` → `--bc-size-rem-480`, and `--bc-size-ui-560` → `--bc-size-rem-560`. These are Semantic-definition proposals only; Assets do not reference those Primitives.
|
|
70
|
+
|
|
71
|
+
After review, Grid/Sidebar could use UI 400/480 for xl/2xl; Reel could use UI 400/480/560 for lg/xl/2xl. Validate each against real content and Flavours before adding it. No new Primitive is needed for those proposed mappings. Do not substitute container maximum-width roles for collection minima or sidebar bases, and do not derive arbitrary large values from unrelated tokens just to complete the labels. Any 2xl fluid spacing role needs its own reviewed mapping; it is not inferred from the UI-width proposals.
|
|
72
|
+
|
|
73
|
+
## Validation
|
|
74
|
+
|
|
75
|
+
The [refinement review](REFINEMENT-REVIEW.md) records the 18-Layout audit, compatibility details, Foundation wrap candidate and evaluated additions.
|
|
76
|
+
|
|
77
|
+
Run `npm run build`, `npm run validate --workspace "02. LevelsUI"`, `npm run test:layouts --workspace "02. LevelsUI"`, `npm run test:layouts:browser --workspace "02. LevelsUI"`, `npm test --workspace "03. Documentation"` and `npm run verify:source` from the workspace root.
|
|
78
|
+
|
|
79
|
+
The collection checks exercise layout geometry, narrow containers, shared breakpoints, RTL, larger text, long content, reduced motion, native scrolling and Studio previews in Chromium. The browser command fails if no browser is available; `BC_BROWSER_EXECUTABLE` can select one. Firefox/WebKit and complete assistive-technology certification remain separate qualifications. Use `verify:levelsui -- --core-archive "<selected Core.tgz>"` for the independent package gate. Publication remains owner-controlled.
|
|
80
|
+
|
|
81
|
+
For the actual collection in an isolated tarball consumer, run `npm run test:layouts:consumer --workspace "02. LevelsUI" -- --core-archive "<Core.tgz>" --levels-archive "<LevelsUI.tgz>"` with absolute archive paths prepared by the canonical root verification/release scripts. This installs the exact packages, compiles all Layouts using real Sass, reruns Chromium geometry against the consumer CSS, and checks exclusion of inactive assets and deduplication of recipe dependencies.
|
|
82
|
+
|
|
83
|
+
## Small utility compositions
|
|
84
|
+
|
|
85
|
+
The following are additional copyable Core compositions. Registered recipes have their full documentation and dependencies in the folders linked above.
|
|
4
86
|
|
|
5
87
|
## Container
|
|
6
88
|
```html
|
|
7
|
-
<div class="bc-container">
|
|
89
|
+
<div class="bc-container">
|
|
90
|
+
<!-- Container content goes here. -->
|
|
91
|
+
</div>
|
|
8
92
|
```
|
|
9
93
|
Alternatives: `bc-container-content`, `bc-container-content-wide`.
|
|
10
94
|
|
|
11
95
|
## Stack
|
|
12
96
|
```html
|
|
13
97
|
<div class="bc-flex bc-flex-col bc-gap-md">
|
|
14
|
-
|
|
98
|
+
<!-- Stack items go here as direct children. -->
|
|
15
99
|
</div>
|
|
16
100
|
```
|
|
17
101
|
|
|
18
102
|
## Inline
|
|
19
103
|
```html
|
|
20
104
|
<div class="bc-flex bc-flex-row bc-items-center bc-gap-sm">
|
|
21
|
-
|
|
105
|
+
<!-- Inline items go here as direct children. -->
|
|
22
106
|
</div>
|
|
23
107
|
```
|
|
24
108
|
|
|
25
109
|
## Cluster
|
|
26
110
|
```html
|
|
27
111
|
<div class="bc-flex bc-flex-wrap bc-items-center bc-gap-sm">
|
|
28
|
-
|
|
112
|
+
<!-- Wrapping items go here as direct children. -->
|
|
29
113
|
</div>
|
|
30
114
|
```
|
|
31
115
|
|
|
32
116
|
## Simple Grid
|
|
33
117
|
```html
|
|
34
118
|
<div class="bc-grid bc-gap-md">
|
|
35
|
-
|
|
119
|
+
<!-- Grid items go here as direct children. -->
|
|
36
120
|
</div>
|
|
37
121
|
```
|
|
38
122
|
Use `bcl-grid` only if its grid-column behaviour is needed.
|
|
39
123
|
|
|
40
124
|
## Sticky region
|
|
41
125
|
```html
|
|
42
|
-
<aside class="bc-sticky bc-top-0">
|
|
126
|
+
<aside class="bc-sticky bc-top-0">
|
|
127
|
+
<!-- Sticky content goes here. -->
|
|
128
|
+
</aside>
|
|
43
129
|
```
|
|
44
130
|
Ensure scroll-container constraints are appropriate.
|
|
45
131
|
|
|
@@ -47,7 +133,9 @@ Ensure scroll-container constraints are appropriate.
|
|
|
47
133
|
```html
|
|
48
134
|
<div class="bc-relative">
|
|
49
135
|
<div class="bc-absolute bc-inset-0" aria-hidden="true"></div>
|
|
50
|
-
<div class="bc-relative">
|
|
136
|
+
<div class="bc-relative">
|
|
137
|
+
<!-- Foreground content goes here. -->
|
|
138
|
+
</div>
|
|
51
139
|
</div>
|
|
52
140
|
```
|
|
53
141
|
|
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
{
|
|
2
2
|
"schemaVersion": 1,
|
|
3
|
+
"kind": "authored",
|
|
3
4
|
"id": "app-shell",
|
|
4
5
|
"displayName": "App Shell",
|
|
5
|
-
"description": "
|
|
6
|
+
"description": "Structural application regions with optional header, left/right panels and footer; no content-dependent collapsing.",
|
|
6
7
|
"level": "layout",
|
|
7
8
|
"category": [
|
|
8
9
|
"application"
|
|
9
10
|
],
|
|
10
|
-
"className": "bcl-app-shell",
|
|
11
11
|
"source": {
|
|
12
|
-
"scss": "02. Layouts/application/app-shell/app-shell.scss",
|
|
12
|
+
"scss": "02. Layouts/application/app-shell/src/app-shell.scss",
|
|
13
13
|
"css": "dist/components/app-shell.css"
|
|
14
14
|
},
|
|
15
15
|
"dependencies": {
|
|
@@ -18,8 +18,9 @@
|
|
|
18
18
|
]
|
|
19
19
|
},
|
|
20
20
|
"documentation": {
|
|
21
|
-
"guide": "docs.md",
|
|
22
|
-
"api": "api.json",
|
|
21
|
+
"guide": "docs/README.md",
|
|
22
|
+
"api": "docs/api.json",
|
|
23
23
|
"examples": "examples/index.json"
|
|
24
|
-
}
|
|
24
|
+
},
|
|
25
|
+
"className": "bcl-app-shell"
|
|
25
26
|
}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
# App Shell
|
|
2
|
+
|
|
3
|
+
A document-scrolling application structure for header, main, footer and optional left/right **regions**. Not a navigation component, sidebar widget, drawer, overlay, or icon rail.
|
|
4
|
+
|
|
5
|
+
## Core-first implementation
|
|
6
|
+
|
|
7
|
+
App Shell is an authored application-region Layout because responsive named tracks, sticky regions must work together under a single Layout contract. Its widths, responsive sizing and transition values consume Core Semantics wherever a corresponding role exists. The grid and region selectors are structural rules, not reusable global utilities. Optional navigation or other content is supplied by independent Assets; App Shell never chooses or installs a specific one.
|
|
8
|
+
|
|
9
|
+
## Use App Shell when
|
|
10
|
+
|
|
11
|
+
- The application has persistent structural chrome, possibly two side regions.
|
|
12
|
+
- Main content should grow into space unused by omitted regions.
|
|
13
|
+
- The overall document normally scrolls; for a viewport-managed canvas, compose explicit scrolling/viewport regions from existing Layouts and Components.
|
|
14
|
+
|
|
15
|
+
## Basic usage
|
|
16
|
+
|
|
17
|
+
```html
|
|
18
|
+
<div class="bcl-app-shell">
|
|
19
|
+
<header class="bcl-app-shell__header">App header</header>
|
|
20
|
+
<div class="bcl-app-shell__body">
|
|
21
|
+
<aside class="bcl-app-shell__sidebar" aria-label="Navigation">Content-aware navigation</aside>
|
|
22
|
+
<main class="bcl-app-shell__main" id="main">Main content</main>
|
|
23
|
+
<aside class="bcl-app-shell__aside" aria-label="Inspector">Inspector content</aside>
|
|
24
|
+
</div>
|
|
25
|
+
<footer class="bcl-app-shell__footer">Status</footer>
|
|
26
|
+
</div>
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
## Responsive contract
|
|
30
|
+
|
|
31
|
+
- On wider containers, left/main/right use explicit tracks. No left or right region means no reserved column.
|
|
32
|
+
- At or below `60rem` **container width**, layouts with **both** side regions switch to one column. At or below `40rem`, layouts with **one** side region also switch to one column. These thresholds preserve a `20rem` main-content minimum with every built-in size preset. Regions appear in source order and remain present and focusable; this is a safe **non-interactive fallback**, not a recommended mobile dashboard design for every sidebar.
|
|
33
|
+
- Sidebar content must adapt *itself*; e.g. the example nav wraps links instead of squeezing vertical headings into a 64px rail.
|
|
34
|
+
- **Never** shrink an unknown sidebar to a fixed icon rail, hide it in CSS without a trigger, or silently convert it into a drawer. Those require content-aware Components and Core Behaviours.
|
|
35
|
+
- If a product needs a mobile drawer, its Component/application must provide the trigger, accessible name, inert/visibility, focus return, Escape/dismissal and animation orchestration. Do not assume the Layout provides these.
|
|
36
|
+
- When a configuration stacks (dual sidebars at `60rem`, single sidebar at `40rem`), its sticky side regions revert to normal flow. The header can remain sticky independently.
|
|
37
|
+
|
|
38
|
+
## Width and position
|
|
39
|
+
|
|
40
|
+
Default left/right width is the Core 256 size token (fallback `16rem`). `bcl-app-shell--left-sm` / `--left-lg` and `--right-sm` / `--right-lg` supply `12rem` / `20rem` presets. CSS custom properties `--bcl-app-shell-left-width` and `--bcl-app-shell-right-width` override sizing. Header/footer heights are intrinsic; main fills remaining width.
|
|
41
|
+
|
|
42
|
+
While regions sit side by side, `--bcl-app-shell-main-min` (default `20rem`) sets the minimum main grid track. Custom panel widths larger than `20rem`, or a custom main minimum, require a consumer-chosen reflow threshold; the built-in container query thresholds cover the supplied presets, not arbitrary custom widths.
|
|
43
|
+
|
|
44
|
+
`bcl-app-shell--sticky-header`, `--sticky-left`, and `--sticky-right` affect **structural positioning only**. For combined sticky regions, consumers must set `--bcl-app-shell-sticky-top` to a suitable offset and ensure appropriate surface backgrounds, scrolling ancestors and focus visibility.
|
|
45
|
+
|
|
46
|
+
## Boundaries
|
|
47
|
+
|
|
48
|
+
Page Frame is the simpler Foundation-only recipe for ordinary pages. Inset or sticky supporting panels and editor canvas arrangements should be compositions of existing Layouts and Components rather than additional application Layout assets. Sidebars and inspectors can contain any content and are not intrinsically LevelsUI Components.
|
|
49
|
+
|
|
50
|
+
No JS required. No background, padding or fixed typography in production App Shell CSS. Styling in the examples comes from Core utilities.
|
|
51
|
+
|
|
52
|
+
## Options and composition
|
|
53
|
+
|
|
54
|
+
`--left-sm`, `--left-lg`, `--right-sm` and `--right-lg` independently size the two regions. App Shell requires Foundation styling only. Place any independently installed navigation, profile, callout or other Asset into the appropriate region; those Assets own their own styles, interactions and accessible states. The Layout never creates an icon rail or drawer.
|
|
55
|
+
|
|
56
|
+
## BufferCore sizing contract
|
|
57
|
+
|
|
58
|
+
Built-in region widths (`--bc-size-ui-192`, `--bc-size-ui-256`, `--bc-size-ui-320`), 64px compact rail (`--bc-size-ui-64`) and default minimum main track (`--bc-size-ui-320`) use Core UI semantic sizing. The App Shell custom properties remain available for project-specific overrides. Responsive container thresholds and viewport/sticky offsets are structural conditions rather than UI element sizes. Motion and sticky layering use Core semantics.
|
|
59
|
+
|
|
60
|
+
Compatible Core Foundations are required; hard-coded Semantic fallback values have been removed. Scoped `overflow-wrap: anywhere` on structural regions permits unbroken content to wrap without hiding it or changing DOM/focus order. Explicit Core utilities can still override these low-specificity defaults.
|
|
61
|
+
|
|
62
|
+
## Why authored CSS is needed
|
|
63
|
+
|
|
64
|
+
Core utilities provide spacing, colour and typography, but App Shell needs structural grid-track allocation, optional regions, container-based reflow and sticky region positioning. Those rules are specific to this Layout; its contents continue to use Core utilities and their own Component styling. Structural regions permit long unbroken text to wrap so their intrinsic minimum does not widen the document.
|
|
@@ -0,0 +1,125 @@
|
|
|
1
|
+
{
|
|
2
|
+
"variants": [],
|
|
3
|
+
"sizes": [],
|
|
4
|
+
"anatomy": [
|
|
5
|
+
"header (optional)",
|
|
6
|
+
"body (required)",
|
|
7
|
+
"sidebar (optional left)",
|
|
8
|
+
"main (required)",
|
|
9
|
+
"aside (optional right)",
|
|
10
|
+
"footer (optional)"
|
|
11
|
+
],
|
|
12
|
+
"properties": [
|
|
13
|
+
{
|
|
14
|
+
"name": "Left/right panel presence",
|
|
15
|
+
"type": "HTML regions",
|
|
16
|
+
"description": "Omit the left/right aside entirely to omit its grid track; no visibility switch required."
|
|
17
|
+
},
|
|
18
|
+
{
|
|
19
|
+
"name": "Expanded panel widths",
|
|
20
|
+
"type": "CSS custom properties",
|
|
21
|
+
"description": "--bcl-app-shell-left-width and --bcl-app-shell-right-width; default 16rem, overrides allowed."
|
|
22
|
+
},
|
|
23
|
+
{
|
|
24
|
+
"name": "Width presets",
|
|
25
|
+
"type": "CSS modifier classes",
|
|
26
|
+
"description": "Independent left/right modifier classes: --left-sm / --left-lg and --right-sm / --right-lg. The base size is medium (16rem); the modifiers are composable, not mutually exclusive variants. CSS variables allow custom widths."
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
"name": "Main content minimum",
|
|
30
|
+
"type": "CSS custom property",
|
|
31
|
+
"default": "20rem",
|
|
32
|
+
"description": "--bcl-app-shell-main-min controls the minimum width of the main grid track while sidebars sit beside it. The built-in 40rem (one panel) and 60rem (two panels) container reflow thresholds cover all shipped 12/16/20rem panel presets."
|
|
33
|
+
},
|
|
34
|
+
{
|
|
35
|
+
"name": "Sticky positions",
|
|
36
|
+
"type": "CSS modifier classes",
|
|
37
|
+
"description": "--sticky-header, --sticky-left, --sticky-right; supply --bcl-app-shell-sticky-top where needed."
|
|
38
|
+
},
|
|
39
|
+
{
|
|
40
|
+
"name": "Compact/drawer/overlay interactions",
|
|
41
|
+
"type": "Out of scope",
|
|
42
|
+
"description": "Must be provided by a content-aware Component or application using Core Behaviours; Layout never automatically hides content."
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
"name": "Motion",
|
|
46
|
+
"type": "optional data attribute",
|
|
47
|
+
"default": "on",
|
|
48
|
+
"description": "Add data-motion=\"off\" to the App Shell root to disable structural grid-track transitions. Otherwise transitions use Core semantic --bc-motion-expand-* tokens and respect prefers-reduced-motion."
|
|
49
|
+
}
|
|
50
|
+
],
|
|
51
|
+
"accessibility": [
|
|
52
|
+
"Use semantic regions appropriate to actual content; include exactly one main landmark per document.",
|
|
53
|
+
"Preserve logical document and keyboard reading order across responsive arrangements.",
|
|
54
|
+
"Never hide or disable interactive region content without an accessible alternative and appropriate focus management.",
|
|
55
|
+
"Test 320px container widths, 200% and 400% zoom, long content, keyboard focus and horizontal overflow."
|
|
56
|
+
],
|
|
57
|
+
"tags": [
|
|
58
|
+
"layout",
|
|
59
|
+
"application",
|
|
60
|
+
"authored",
|
|
61
|
+
"shell",
|
|
62
|
+
"responsive"
|
|
63
|
+
],
|
|
64
|
+
"notes": [
|
|
65
|
+
"Main region occupies unallocated width; absent panels reserve zero tracks.",
|
|
66
|
+
"Header/footer take intrinsic height; do not expose fake size presets.",
|
|
67
|
+
"Single-panel shells stack at 40rem container width; dual-panel shells stack at 60rem, preserving a 20rem main minimum with every shipped size preset. The main minimum must not be mistaken for a responsive breakpoint.",
|
|
68
|
+
"The consuming interface may opt into controlled compact, overlay or drawer presentation only when it provides controls and accessibility handling.",
|
|
69
|
+
"Sticky is CSS-only; sticky regions require a non-transparent surface and correct offsets from the consumer.",
|
|
70
|
+
"Custom panel widths greater than the 20rem large preset, or a custom main minimum, may require a consumer-specific container threshold; CSS container query thresholds cannot read custom-property values.",
|
|
71
|
+
"The independent left and right size classes are not representable as a single exclusive sizes/variants selection in the current API schema. They remain documented in properties and markup examples; do not mislabel them as a one-choice size control.",
|
|
72
|
+
"Optional navigation, profile and callout content is owned by separately installed Assets; App Shell only arranges its semantic regions."
|
|
73
|
+
],
|
|
74
|
+
"anatomyContract": [
|
|
75
|
+
{
|
|
76
|
+
"name": "root",
|
|
77
|
+
"selector": ".bcl-app-shell",
|
|
78
|
+
"required": true,
|
|
79
|
+
"repeatable": false,
|
|
80
|
+
"description": "Application-level structural container."
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
"name": "body",
|
|
84
|
+
"selector": ".bcl-app-shell__body",
|
|
85
|
+
"required": true,
|
|
86
|
+
"repeatable": false,
|
|
87
|
+
"description": "Grid grouping for the main and optional side regions."
|
|
88
|
+
},
|
|
89
|
+
{
|
|
90
|
+
"name": "main",
|
|
91
|
+
"selector": ".bcl-app-shell__main",
|
|
92
|
+
"required": true,
|
|
93
|
+
"repeatable": false,
|
|
94
|
+
"description": "Primary content landmark; exactly one main per document."
|
|
95
|
+
},
|
|
96
|
+
{
|
|
97
|
+
"name": "header",
|
|
98
|
+
"selector": ".bcl-app-shell__header",
|
|
99
|
+
"required": false,
|
|
100
|
+
"repeatable": false,
|
|
101
|
+
"description": "Optional application-wide header."
|
|
102
|
+
},
|
|
103
|
+
{
|
|
104
|
+
"name": "sidebar",
|
|
105
|
+
"selector": ".bcl-app-shell__sidebar",
|
|
106
|
+
"required": false,
|
|
107
|
+
"repeatable": false,
|
|
108
|
+
"description": "Optional structural left region for consumer-owned content."
|
|
109
|
+
},
|
|
110
|
+
{
|
|
111
|
+
"name": "aside",
|
|
112
|
+
"selector": ".bcl-app-shell__aside",
|
|
113
|
+
"required": false,
|
|
114
|
+
"repeatable": false,
|
|
115
|
+
"description": "Optional structural right region."
|
|
116
|
+
},
|
|
117
|
+
{
|
|
118
|
+
"name": "footer",
|
|
119
|
+
"selector": ".bcl-app-shell__footer",
|
|
120
|
+
"required": false,
|
|
121
|
+
"repeatable": false,
|
|
122
|
+
"description": "Optional application footer."
|
|
123
|
+
}
|
|
124
|
+
]
|
|
125
|
+
}
|
|
@@ -0,0 +1,19 @@
|
|
|
1
|
+
<div class="bcl-app-shell">
|
|
2
|
+
<header class="bcl-app-shell__header">
|
|
3
|
+
<!-- Application header goes here. -->
|
|
4
|
+
</header>
|
|
5
|
+
<div class="bcl-app-shell__body">
|
|
6
|
+
<aside class="bcl-app-shell__sidebar" aria-label="Workspace navigation">
|
|
7
|
+
<!-- Secondary region goes here. -->
|
|
8
|
+
</aside>
|
|
9
|
+
<main class="bcl-app-shell__main" id="shell-main" tabindex="-1">
|
|
10
|
+
<!-- Main content goes here. -->
|
|
11
|
+
</main>
|
|
12
|
+
<aside class="bcl-app-shell__aside" aria-label="Inspector">
|
|
13
|
+
<!-- Supporting region goes here. -->
|
|
14
|
+
</aside>
|
|
15
|
+
</div>
|
|
16
|
+
<footer class="bcl-app-shell__footer">
|
|
17
|
+
<!-- Application footer goes here. -->
|
|
18
|
+
</footer>
|
|
19
|
+
</div>
|