@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,16 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"id": "basic",
|
|
4
|
+
"title": "In use",
|
|
5
|
+
"description": "Compose guttered content with bounded full-width media and breakout regions.",
|
|
6
|
+
"preview": "examples/basic/preview.html",
|
|
7
|
+
"code": "examples/basic/code.html"
|
|
8
|
+
},
|
|
9
|
+
{
|
|
10
|
+
"id": "reading",
|
|
11
|
+
"title": "Reading measure inside the boundary",
|
|
12
|
+
"description": "Reading-width text and a full-width band share one outer boundary.",
|
|
13
|
+
"preview": "examples/reading/preview.html",
|
|
14
|
+
"code": "examples/reading/code.html"
|
|
15
|
+
}
|
|
16
|
+
]
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<div class="bc-flex bc-flex-col bc-gap-md bc-w-100 bc-max-width-page bc-mx-auto">
|
|
2
|
+
<div class="bc-container-content">
|
|
3
|
+
<!-- Content within normal gutters goes here. -->
|
|
4
|
+
</div>
|
|
5
|
+
<div>
|
|
6
|
+
<!-- Edge-to-edge media or breakout content goes here. -->
|
|
7
|
+
</div>
|
|
8
|
+
<div class="bc-container-content">
|
|
9
|
+
<!-- Further guttered content goes here. -->
|
|
10
|
+
</div>
|
|
11
|
+
</div>
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<div class="bc-flex bc-flex-col bc-gap-md bc-w-100 bc-max-width-page bc-mx-auto">
|
|
2
|
+
<div class="bc-container-content">
|
|
3
|
+
<h2 class="bc-h3">An editorial opening</h2>
|
|
4
|
+
<p class="bc-p2">Text follows the page gutters.</p>
|
|
5
|
+
</div>
|
|
6
|
+
<div class="bc-color-fill-context-subtle bc-py-lg">
|
|
7
|
+
<div class="bc-container-content">
|
|
8
|
+
<p class="bc-p1">A full-width band shares the outer boundary.</p>
|
|
9
|
+
</div>
|
|
10
|
+
</div>
|
|
11
|
+
<div class="bc-container-content">
|
|
12
|
+
<p class="bc-p2">The story continues within the normal gutters.</p>
|
|
13
|
+
</div>
|
|
14
|
+
</div>
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<div class="bc-flex bc-flex-col bc-gap-md bc-w-100 bc-max-width-page bc-mx-auto">
|
|
2
|
+
<div class="bc-gutter">
|
|
3
|
+
<!-- Content within normal gutters goes here. -->
|
|
4
|
+
</div>
|
|
5
|
+
<div>
|
|
6
|
+
<!-- Edge-to-edge media or breakout content goes here. -->
|
|
7
|
+
</div>
|
|
8
|
+
<div class="bc-gutter">
|
|
9
|
+
<!-- Further guttered content goes here. -->
|
|
10
|
+
</div>
|
|
11
|
+
</div>
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"kind": "authored",
|
|
4
|
+
"id": "content-grid",
|
|
5
|
+
"displayName": "Content Grid",
|
|
6
|
+
"description": "Mix a readable content column and full-width regions without viewport-width breakout hacks.",
|
|
7
|
+
"level": "layout",
|
|
8
|
+
"category": [
|
|
9
|
+
"sections"
|
|
10
|
+
],
|
|
11
|
+
"className": "bcl-content-grid",
|
|
12
|
+
"source": {
|
|
13
|
+
"scss": "02. Layouts/sections/content-grid/src/content-grid.scss",
|
|
14
|
+
"css": "dist/components/content-grid.css"
|
|
15
|
+
},
|
|
16
|
+
"dependencies": {
|
|
17
|
+
"css": [
|
|
18
|
+
"foundations"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
"documentation": {
|
|
22
|
+
"guide": "docs/README.md",
|
|
23
|
+
"api": "docs/api.json",
|
|
24
|
+
"examples": "examples/index.json"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
# Content Grid
|
|
2
|
+
|
|
3
|
+
Mix a readable content column and full-width regions without viewport-width breakout hacks. This is a category 02 Layout.
|
|
4
|
+
|
|
5
|
+
## Core-first implementation
|
|
6
|
+
|
|
7
|
+
Content Grid defines named CSS grid tracks and direct-child placement for content and full-bleed regions. Those named line contracts are specific to the Layout. Container maxima, gutters and row gaps use existing Core Semantics.
|
|
8
|
+
|
|
9
|
+
## Composition and usage
|
|
10
|
+
|
|
11
|
+
```html
|
|
12
|
+
<div class="bcl-content-grid">
|
|
13
|
+
<div>
|
|
14
|
+
<!-- Reading-column content goes here. -->
|
|
15
|
+
</div>
|
|
16
|
+
<div class="bcl-content-grid__full">
|
|
17
|
+
<!-- Full-width content goes here. -->
|
|
18
|
+
</div>
|
|
19
|
+
<div>
|
|
20
|
+
<!-- Further reading-column content goes here. -->
|
|
21
|
+
</div>
|
|
22
|
+
</div>
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Why authored CSS is needed
|
|
26
|
+
|
|
27
|
+
Checked Container, max-width, Core grid and positioning utilities. They do not expose named reading/full-width grid lines. The authored base supplies those lines, grid display, semantic row spacing and shrink safety. Semantic gutters bound the reading track without viewport-width breakout hacks.
|
|
28
|
+
|
|
29
|
+
The base is independently usable once Core tokens and this Asset stylesheet are loaded. Supporting default declarations are part of the authored contract; consumers must not add redundant utility classes to make it work. Defaults use low-specificity selectors so optional Core utilities remain effective.
|
|
30
|
+
|
|
31
|
+
## Options and constraints
|
|
32
|
+
|
|
33
|
+
- Ordinary direct children use the shared reading track. The __full part spans the parent-relative full track.
|
|
34
|
+
- Fluid gutter minima are capped against available inline space so narrow nested compositions retain usable content width.
|
|
35
|
+
- Use row-gap utilities for vertical rhythm. A column-gap override also changes the separation between gutter tracks.
|
|
36
|
+
- Text can wrap at otherwise unbroken strings. Intrinsically wide media, code and tables should use their content-specific sizing or local overflow wrapper.
|
|
37
|
+
|
|
38
|
+
## Dependencies and installation
|
|
39
|
+
|
|
40
|
+
Uses Core Foundations. No other Layout is required by this structural contract. In a consumer with compatible packed Core/LevelsUI and Sass installed, run `npx --no-install levelsui init`, `npx --no-install levelsui add content-grid`, `npx --no-install levelsui activate content-grid` and `npx --no-install levelsui build`. Load `dist/buffercore-levels.css` once; it already includes Core. Installed snapshots control builds until explicitly updated.
|
|
41
|
+
|
|
42
|
+
## Accessibility and behaviour
|
|
43
|
+
|
|
44
|
+
- Keep DOM order consistent with the reading and keyboard order.
|
|
45
|
+
- Choose semantic HTML for the content; the Layout does not assign landmarks or interactive roles.
|
|
46
|
+
|
|
47
|
+
Content, meaningful states and interactions belong to the consuming HTML or application. Colour contexts inherit through Core; use semantic text/fill pairings with appropriate contrast. There is no animation or automatic DOM observation.
|
|
48
|
+
|
|
49
|
+
## Examples and verification
|
|
50
|
+
|
|
51
|
+
The Code files contain only the Layout structure and comments identifying where consumer content goes. Populated content and its visual styling remain in Preview. Required anatomy and accessibility attributes are retained. Consult the Layout collection guide for responsive, consumer-build and browser verification coverage; an example is not release certification.
|
|
52
|
+
|
|
53
|
+
## Foundation review
|
|
54
|
+
|
|
55
|
+
See the [collection audit and Foundation candidates](../../../UTILITY-RECIPES.md#foundation-candidates) for the existing capabilities checked and the proposed shared gaps. Proposals are not shipped APIs. No new Primitive or Foundation source change is made here.
|
|
56
|
+
|
|
57
|
+
## Responsive refinement
|
|
58
|
+
|
|
59
|
+
The scoped arrangement permits unbroken text to wrap and resets intrinsic inline minima. Deliberate minimum widths remain stable construction constraints. See the [refinement review](../../../REFINEMENT-REVIEW.md) for nested composition, zoom coverage and the remaining content responsibilities.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
{
|
|
2
|
+
"variants": [],
|
|
3
|
+
"sizes": [],
|
|
4
|
+
"anatomy": [
|
|
5
|
+
"direct children — reading column",
|
|
6
|
+
"bcl-content-grid__full — direct full-width region"
|
|
7
|
+
],
|
|
8
|
+
"properties": [
|
|
9
|
+
{
|
|
10
|
+
"name": "Base layout",
|
|
11
|
+
"type": "CSS class",
|
|
12
|
+
"default": "bcl-content-grid",
|
|
13
|
+
"description": "The base class and documented anatomy provide the complete default layout. No companion display, gap, overflow or height utilities are required."
|
|
14
|
+
},
|
|
15
|
+
{
|
|
16
|
+
"name": "Optional adjustments",
|
|
17
|
+
"type": "CSS classes",
|
|
18
|
+
"description": "Use documented modifiers for alternate sizes or arrangements. Core utilities are optional overrides, not prerequisites for the layout."
|
|
19
|
+
}
|
|
20
|
+
],
|
|
21
|
+
"accessibility": [
|
|
22
|
+
"Keep DOM order consistent with the reading and keyboard order.",
|
|
23
|
+
"Choose semantic HTML for the content; the Layout does not assign landmarks or interactive roles."
|
|
24
|
+
],
|
|
25
|
+
"tags": [
|
|
26
|
+
"layout",
|
|
27
|
+
"sections",
|
|
28
|
+
"authored"
|
|
29
|
+
],
|
|
30
|
+
"notes": [
|
|
31
|
+
"Ordinary direct children use the shared reading track. The __full part spans the parent-relative full track.",
|
|
32
|
+
"Fluid gutter minima are capped against available inline space so narrow nested compositions retain usable content width.",
|
|
33
|
+
"Use row-gap utilities for vertical rhythm. A column-gap override also changes the separation between gutter tracks.",
|
|
34
|
+
"Text can wrap at otherwise unbroken strings. Intrinsically wide media, code and tables should use their content-specific sizing or local overflow wrapper.",
|
|
35
|
+
"Existing Core Semantics supply dimensions, spacing and gutters.",
|
|
36
|
+
"Scoped overflow-wrap and zero inline minima support nested regions and long strings. Tables and preformatted content can use a local Core overflow wrapper."
|
|
37
|
+
]
|
|
38
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<div class="bcl-content-grid">
|
|
2
|
+
<div>
|
|
3
|
+
<!-- Reading-column content goes here. -->
|
|
4
|
+
</div>
|
|
5
|
+
<div class="bcl-content-grid__full">
|
|
6
|
+
<!-- Full-width content goes here. -->
|
|
7
|
+
</div>
|
|
8
|
+
<div>
|
|
9
|
+
<!-- Further reading-column content goes here. -->
|
|
10
|
+
</div>
|
|
11
|
+
</div>
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
<div class="bcl-content-grid">
|
|
2
|
+
<div class="bc-flex bc-flex-col bc-gap-md">
|
|
3
|
+
<h2 class="bc-h3">A story with space to breathe</h2>
|
|
4
|
+
<p class="bc-p2">Ordinary children follow the shared reading measure.</p>
|
|
5
|
+
</div>
|
|
6
|
+
<div class="bcl-content-grid__full bc-color-surface-general-secondary bc-py-lg">
|
|
7
|
+
<div class="bc-container">A full-width region can contain its own page-width content.</div>
|
|
8
|
+
</div>
|
|
9
|
+
<p class="bc-p2">Continue the story in the reading column.</p>
|
|
10
|
+
</div>
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
:where(.bcl-content-grid) {
|
|
2
|
+
display: grid;
|
|
3
|
+
row-gap: var(--bc-fluid-lg);
|
|
4
|
+
min-inline-size: 0;
|
|
5
|
+
overflow-wrap: anywhere;
|
|
6
|
+
grid-template-columns: [full-start] minmax(min(var(--bc-container-gutter-md), 10%), 1fr) [content-start] minmax(0, var(--bc-container-max-content)) [content-end] minmax(min(var(--bc-container-gutter-md), 10%), 1fr) [full-end];
|
|
7
|
+
}
|
|
8
|
+
|
|
9
|
+
:where(.bcl-content-grid) > * {
|
|
10
|
+
grid-column: content;
|
|
11
|
+
min-inline-size: 0;
|
|
12
|
+
}
|
|
13
|
+
|
|
14
|
+
:where(.bcl-content-grid) > :where(.bcl-content-grid__full) {
|
|
15
|
+
grid-column: full;
|
|
16
|
+
}
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{
|
|
2
|
+
"schemaVersion": 1,
|
|
3
|
+
"kind": "authored",
|
|
4
|
+
"id": "cover",
|
|
5
|
+
"displayName": "Cover",
|
|
6
|
+
"description": "Distribute a header, central body and footer over at least a viewport-height region while allowing content to grow.",
|
|
7
|
+
"level": "layout",
|
|
8
|
+
"category": [
|
|
9
|
+
"sections"
|
|
10
|
+
],
|
|
11
|
+
"className": "bcl-cover",
|
|
12
|
+
"source": {
|
|
13
|
+
"scss": "02. Layouts/sections/cover/src/cover.scss",
|
|
14
|
+
"css": "dist/components/cover.css"
|
|
15
|
+
},
|
|
16
|
+
"dependencies": {
|
|
17
|
+
"css": [
|
|
18
|
+
"foundations"
|
|
19
|
+
]
|
|
20
|
+
},
|
|
21
|
+
"documentation": {
|
|
22
|
+
"guide": "docs/README.md",
|
|
23
|
+
"api": "docs/api.json",
|
|
24
|
+
"examples": "examples/index.json"
|
|
25
|
+
}
|
|
26
|
+
}
|
|
@@ -0,0 +1,60 @@
|
|
|
1
|
+
# Cover
|
|
2
|
+
|
|
3
|
+
Distribute a header, central body and footer over at least a viewport-height region while allowing content to grow. This is a category 02 Layout.
|
|
4
|
+
|
|
5
|
+
## Core-first implementation
|
|
6
|
+
|
|
7
|
+
Cover defines a three-region page composition with a flexible centre row and supported compact height. The row placement is authored because consumers must not reconstruct its anatomy with extra utilities. Existing Core fluid-spacing Semantics supply its padding and gap values.
|
|
8
|
+
|
|
9
|
+
## Composition and usage
|
|
10
|
+
|
|
11
|
+
```html
|
|
12
|
+
<div class="bcl-cover">
|
|
13
|
+
<header class="bcl-cover__header">
|
|
14
|
+
<!-- Optional top content goes here. -->
|
|
15
|
+
</header>
|
|
16
|
+
<div class="bcl-cover__body">
|
|
17
|
+
<!-- Main cover content goes here. -->
|
|
18
|
+
</div>
|
|
19
|
+
<footer class="bcl-cover__footer">
|
|
20
|
+
<!-- Optional bottom content goes here. -->
|
|
21
|
+
</footer>
|
|
22
|
+
</div>
|
|
23
|
+
```
|
|
24
|
+
|
|
25
|
+
## Why authored CSS is needed
|
|
26
|
+
|
|
27
|
+
Checked Core viewport minimum-height utilities, flex column, justification and Page Frame. They do not supply an expanding central grid row between optional edge regions with a small-viewport minimum. The authored base includes those rows, grid display, semantic spacing/padding, viewport fallbacks and the central body alignment. Compact is an optional single modifier.
|
|
28
|
+
|
|
29
|
+
The base is independently usable once Core tokens and this Asset stylesheet are loaded. Supporting default declarations are part of the authored contract; consumers must not add redundant utility classes to make it work. Defaults use low-specificity selectors so optional Core utilities remain effective.
|
|
30
|
+
|
|
31
|
+
## Options and constraints
|
|
32
|
+
|
|
33
|
+
- Use named header, body and footer parts. Omit unneeded optional parts.
|
|
34
|
+
- The base uses a full small-viewport minimum, fluid large structural gaps and medium padding capped against available width.
|
|
35
|
+
- Compact adjusts the minimum to half a small viewport, structural gap to medium, and padding and body gap to small.
|
|
36
|
+
- Long content expands the grid. Core gap, padding and height utilities can override the low-specificity defaults.
|
|
37
|
+
|
|
38
|
+
## Dependencies and installation
|
|
39
|
+
|
|
40
|
+
Uses Core Foundations. No other Layout is required by this structural contract. In a consumer with compatible packed Core/LevelsUI and Sass installed, run `npx --no-install levelsui init`, `npx --no-install levelsui add cover`, `npx --no-install levelsui activate cover` and `npx --no-install levelsui build`. Load `dist/buffercore-levels.css` once; it already includes Core. Installed snapshots control builds until explicitly updated.
|
|
41
|
+
|
|
42
|
+
## Accessibility and behaviour
|
|
43
|
+
|
|
44
|
+
- Keep DOM order consistent with the reading and keyboard order.
|
|
45
|
+
- Choose semantic HTML for the content; the Layout does not assign landmarks or interactive roles.
|
|
46
|
+
- Use a heading level appropriate to the document; a Cover does not require an h1.
|
|
47
|
+
|
|
48
|
+
Content, meaningful states and interactions belong to the consuming HTML or application. Colour contexts inherit through Core; use semantic text/fill pairings with appropriate contrast. There is no animation or automatic DOM observation.
|
|
49
|
+
|
|
50
|
+
## Examples and verification
|
|
51
|
+
|
|
52
|
+
The Code files contain only the Layout structure and comments identifying where consumer content goes. Populated content and its visual styling remain in Preview. Required anatomy and accessibility attributes are retained. Consult the Layout collection guide for responsive, consumer-build and browser verification coverage; an example is not release certification.
|
|
53
|
+
|
|
54
|
+
## Foundation review
|
|
55
|
+
|
|
56
|
+
See the [collection audit and Foundation candidates](../../../UTILITY-RECIPES.md#foundation-candidates) for the existing capabilities checked and the proposed shared gaps. Proposals are not shipped APIs. No new Primitive or Foundation source change is made here.
|
|
57
|
+
|
|
58
|
+
## Responsive refinement
|
|
59
|
+
|
|
60
|
+
The scoped arrangement permits unbroken text to wrap and resets intrinsic inline minima. Deliberate minimum widths remain stable construction constraints. See the [refinement review](../../../REFINEMENT-REVIEW.md) for nested composition, zoom coverage and the remaining content responsibilities.
|
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
{
|
|
2
|
+
"variants": [
|
|
3
|
+
{
|
|
4
|
+
"id": "full",
|
|
5
|
+
"className": "bcl-cover",
|
|
6
|
+
"default": true
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"id": "compact",
|
|
10
|
+
"className": "bcl-cover--compact"
|
|
11
|
+
}
|
|
12
|
+
],
|
|
13
|
+
"sizes": [],
|
|
14
|
+
"anatomy": [
|
|
15
|
+
"bcl-cover__header — optional top region",
|
|
16
|
+
"bcl-cover__body — required central content",
|
|
17
|
+
"bcl-cover__footer — optional bottom region"
|
|
18
|
+
],
|
|
19
|
+
"properties": [
|
|
20
|
+
{
|
|
21
|
+
"name": "Base layout",
|
|
22
|
+
"type": "CSS class",
|
|
23
|
+
"default": "bcl-cover",
|
|
24
|
+
"description": "The base class and documented anatomy provide the complete default layout. No companion display, gap, overflow or height utilities are required."
|
|
25
|
+
},
|
|
26
|
+
{
|
|
27
|
+
"name": "Optional adjustments",
|
|
28
|
+
"type": "CSS classes",
|
|
29
|
+
"description": "Use documented modifiers for alternate sizes or arrangements. Core utilities are optional overrides, not prerequisites for the layout."
|
|
30
|
+
}
|
|
31
|
+
],
|
|
32
|
+
"accessibility": [
|
|
33
|
+
"Keep DOM order consistent with the reading and keyboard order.",
|
|
34
|
+
"Choose semantic HTML for the content; the Layout does not assign landmarks or interactive roles.",
|
|
35
|
+
"Use a heading level appropriate to the document; a Cover does not require an h1."
|
|
36
|
+
],
|
|
37
|
+
"tags": [
|
|
38
|
+
"layout",
|
|
39
|
+
"sections",
|
|
40
|
+
"authored"
|
|
41
|
+
],
|
|
42
|
+
"notes": [
|
|
43
|
+
"Use named header, body and footer parts. Omit unneeded optional parts.",
|
|
44
|
+
"The base uses a full small-viewport minimum, fluid large structural gaps and medium padding capped against available width.",
|
|
45
|
+
"Compact adjusts the minimum to half a small viewport, structural gap to medium, and padding and body gap to small.",
|
|
46
|
+
"Long content expands the grid. Core gap, padding and height utilities can override the low-specificity defaults.",
|
|
47
|
+
"Existing Core Semantics supply dimensions, spacing and gutters.",
|
|
48
|
+
"Scoped overflow-wrap and zero inline minima support nested regions and long strings. Tables and preformatted content can use a local Core overflow wrapper."
|
|
49
|
+
]
|
|
50
|
+
}
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<div class="bcl-cover">
|
|
2
|
+
<header class="bcl-cover__header">
|
|
3
|
+
<!-- Optional top content goes here. -->
|
|
4
|
+
</header>
|
|
5
|
+
<div class="bcl-cover__body">
|
|
6
|
+
<!-- Main cover content goes here. -->
|
|
7
|
+
</div>
|
|
8
|
+
<footer class="bcl-cover__footer">
|
|
9
|
+
<!-- Optional bottom content goes here. -->
|
|
10
|
+
</footer>
|
|
11
|
+
</div>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
<section class="bcl-cover" aria-label="Welcome">
|
|
2
|
+
<header class="bcl-cover__header bc-l2">Field notes</header>
|
|
3
|
+
<div class="bcl-cover__body">
|
|
4
|
+
<h1 class="bc-h1">Make room for the next chapter</h1>
|
|
5
|
+
<p class="bc-p1">A content-safe cover grows when the words need more space.</p>
|
|
6
|
+
</div>
|
|
7
|
+
<footer class="bcl-cover__footer bc-p3">Explore the collection below.</footer>
|
|
8
|
+
</section>
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
<div class="bcl-cover bcl-cover--compact">
|
|
2
|
+
<header class="bcl-cover__header">
|
|
3
|
+
<!-- Optional top content goes here. -->
|
|
4
|
+
</header>
|
|
5
|
+
<div class="bcl-cover__body">
|
|
6
|
+
<!-- Main cover content goes here. -->
|
|
7
|
+
</div>
|
|
8
|
+
<footer class="bcl-cover__footer">
|
|
9
|
+
<!-- Optional bottom content goes here. -->
|
|
10
|
+
</footer>
|
|
11
|
+
</div>
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
<section class="bcl-cover bcl-cover--compact" aria-label="Welcome">
|
|
2
|
+
<header class="bcl-cover__header bc-l2">Field notes</header>
|
|
3
|
+
<div class="bcl-cover__body">
|
|
4
|
+
<h1 class="bc-h1">Make room for the next chapter</h1>
|
|
5
|
+
<p class="bc-p1">A content-safe cover grows when the words need more space.</p>
|
|
6
|
+
</div>
|
|
7
|
+
<footer class="bcl-cover__footer bc-p3">Explore the collection below.</footer>
|
|
8
|
+
</section>
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
[
|
|
2
|
+
{
|
|
3
|
+
"id": "basic",
|
|
4
|
+
"title": "In use",
|
|
5
|
+
"description": "Distribute a header, central body and footer over at least a viewport-height region while allowing content to grow.",
|
|
6
|
+
"preview": "examples/basic/preview.html",
|
|
7
|
+
"code": "examples/basic/code.html"
|
|
8
|
+
},
|
|
9
|
+
{
|
|
10
|
+
"id": "compact",
|
|
11
|
+
"title": "A shorter cover",
|
|
12
|
+
"description": "A shorter cover. The underlying composition remains the same.",
|
|
13
|
+
"preview": "examples/compact/preview.html",
|
|
14
|
+
"code": "examples/compact/code.html"
|
|
15
|
+
}
|
|
16
|
+
]
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
:where(.bcl-cover) {
|
|
2
|
+
display: grid;
|
|
3
|
+
gap: var(--bc-fluid-lg);
|
|
4
|
+
padding: min(var(--bc-fluid-md), 10%);
|
|
5
|
+
min-inline-size: 0;
|
|
6
|
+
overflow-wrap: anywhere;
|
|
7
|
+
min-block-size: 100vh;
|
|
8
|
+
min-block-size: 100svh;
|
|
9
|
+
grid-template-rows: auto 1fr auto;
|
|
10
|
+
}
|
|
11
|
+
|
|
12
|
+
:where(.bcl-cover) > * {
|
|
13
|
+
min-inline-size: 0;
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
:where(.bcl-cover__header) {
|
|
17
|
+
grid-row: 1;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
:where(.bcl-cover__body) {
|
|
21
|
+
grid-row: 2;
|
|
22
|
+
display: flex;
|
|
23
|
+
flex-direction: column;
|
|
24
|
+
justify-content: center;
|
|
25
|
+
gap: var(--bc-fluid-md);
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
:where(.bcl-cover__footer) {
|
|
29
|
+
grid-row: 3;
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
:where(.bcl-cover--compact) {
|
|
33
|
+
min-block-size: 50vh;
|
|
34
|
+
min-block-size: 50svh;
|
|
35
|
+
gap: var(--bc-fluid-md);
|
|
36
|
+
padding: min(var(--bc-fluid-sm), 10%);
|
|
37
|
+
}
|
|
38
|
+
|
|
39
|
+
:where(.bcl-cover--compact) > :where(.bcl-cover__body) {
|
|
40
|
+
gap: var(--bc-fluid-sm);
|
|
41
|
+
}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
# Section
|
|
2
|
+
|
|
3
|
+
Give a page region semantic vertical rhythm while keeping its background full width. This is a category 02 Layout.
|
|
4
|
+
|
|
5
|
+
## Composition and usage
|
|
6
|
+
|
|
7
|
+
```html
|
|
8
|
+
<section class="bc-py-lg">
|
|
9
|
+
<div class="bc-container">
|
|
10
|
+
<!-- Section content goes here. -->
|
|
11
|
+
</div>
|
|
12
|
+
</section>
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Reuse decision
|
|
16
|
+
|
|
17
|
+
The complete contract is expressed by the verified Core utilities in the structural example. This is a utility-only recipe: no base class, stylesheet or mount script is required.
|
|
18
|
+
|
|
19
|
+
## Options and constraints
|
|
20
|
+
|
|
21
|
+
- Apply background/surface utilities to the outer section and place Container inside it.
|
|
22
|
+
- Use the supported bc-py-2xs through bc-py-xl utilities to suit the surrounding rhythm. Do not add an authored padding modifier.
|
|
23
|
+
- Use a heading or a suitable accessible label when the section should be a named region.
|
|
24
|
+
- The recipe composes Container directly. Inner demo content belongs only in Preview.
|
|
25
|
+
|
|
26
|
+
## Size scale
|
|
27
|
+
|
|
28
|
+
This recipe uses the existing fluid spacing scale: `2xs`, `xs`, `sm`, `md`, `lg`, `xl`. Replace the default `bc-py-lg` with another `bc-py-*` utility from this supported set; do not stack competing spacing classes. The default remains `lg`. No authored size class or stylesheet is added. Core has no `--bc-fluid-2xl` Semantic, so no `2xl` spacing preset is advertised.
|
|
29
|
+
|
|
30
|
+
## Dependencies and installation
|
|
31
|
+
|
|
32
|
+
Uses Core Foundations and the direct `container` Layout dependency. In a consumer with compatible packed Core/LevelsUI and Sass installed, run `npx --no-install levelsui init`, `npx --no-install levelsui add section`, `npx --no-install levelsui activate section` and `npx --no-install levelsui build`. Load `dist/buffercore-levels.css` once; it already includes Core. Installed snapshots control builds until explicitly updated.
|
|
33
|
+
|
|
34
|
+
## Accessibility and behaviour
|
|
35
|
+
|
|
36
|
+
- Keep DOM order consistent with the reading and keyboard order.
|
|
37
|
+
- Choose semantic HTML for the content; the Layout does not assign landmarks or interactive roles.
|
|
38
|
+
- Use a heading or a suitable accessible label when the section should be a named region.
|
|
39
|
+
|
|
40
|
+
Content, meaningful states and interactions belong to the consuming HTML or application. Colour contexts inherit through Core; use semantic text/fill pairings with appropriate contrast. There is no animation or automatic DOM observation.
|
|
41
|
+
|
|
42
|
+
## Examples and verification
|
|
43
|
+
|
|
44
|
+
The Code files contain only the Layout structure and comments identifying where consumer content goes. Populated content and its visual styling remain in Preview. Required anatomy and accessibility attributes are retained. Consult the Layout collection guide for responsive, consumer-build and browser verification coverage; an example is not release certification.
|
|
45
|
+
|
|
46
|
+
## Foundation review
|
|
47
|
+
|
|
48
|
+
See the [collection audit and Foundation candidates](../../../UTILITY-RECIPES.md#foundation-candidates) for the existing capabilities checked and the proposed shared gaps. Proposals are not shipped APIs. No new Primitive or Foundation source change is made here.
|
|
49
|
+
|
|
50
|
+
## Responsive refinement
|
|
51
|
+
|
|
52
|
+
The recipe uses existing Core capabilities. Long unbroken content needs native break opportunities or a suitable accessible overflow region. The shared wrap-anywhere utility is recorded as a Foundation candidate. See the [refinement review](../../../REFINEMENT-REVIEW.md) for nested composition, zoom coverage and the remaining content responsibilities.
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
{
|
|
2
|
+
"variants": [],
|
|
3
|
+
"sizes": [
|
|
4
|
+
{
|
|
5
|
+
"id": "2xs",
|
|
6
|
+
"className": "bc-py-2xs"
|
|
7
|
+
},
|
|
8
|
+
{
|
|
9
|
+
"id": "xs",
|
|
10
|
+
"className": "bc-py-xs"
|
|
11
|
+
},
|
|
12
|
+
{
|
|
13
|
+
"id": "sm",
|
|
14
|
+
"className": "bc-py-sm"
|
|
15
|
+
},
|
|
16
|
+
{
|
|
17
|
+
"id": "md",
|
|
18
|
+
"className": "bc-py-md"
|
|
19
|
+
},
|
|
20
|
+
{
|
|
21
|
+
"id": "lg",
|
|
22
|
+
"className": "bc-py-lg",
|
|
23
|
+
"default": true
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"id": "xl",
|
|
27
|
+
"className": "bc-py-xl"
|
|
28
|
+
}
|
|
29
|
+
],
|
|
30
|
+
"anatomy": [],
|
|
31
|
+
"properties": [
|
|
32
|
+
{
|
|
33
|
+
"name": "Utility recipe",
|
|
34
|
+
"type": "HTML classes",
|
|
35
|
+
"description": "The shown Core classes are the complete layout. No bcl-* base class or authored stylesheet is needed."
|
|
36
|
+
},
|
|
37
|
+
{
|
|
38
|
+
"name": "Spacing size",
|
|
39
|
+
"type": "CSS class",
|
|
40
|
+
"default": "lg",
|
|
41
|
+
"description": "Use the bc-py-lg utility by default; replace it with another supported spacing utility. This recipe adds no stylesheet."
|
|
42
|
+
}
|
|
43
|
+
],
|
|
44
|
+
"accessibility": [
|
|
45
|
+
"Keep DOM order consistent with the reading and keyboard order.",
|
|
46
|
+
"Choose semantic HTML for the content; the Layout does not assign landmarks or interactive roles.",
|
|
47
|
+
"Use a heading or a suitable accessible label when the section should be a named region."
|
|
48
|
+
],
|
|
49
|
+
"tags": [
|
|
50
|
+
"layout",
|
|
51
|
+
"sections",
|
|
52
|
+
"recipe"
|
|
53
|
+
],
|
|
54
|
+
"notes": [
|
|
55
|
+
"CSS/HTML only: no JavaScript, Behaviour dependency or mounting is required.",
|
|
56
|
+
"Apply background/surface utilities to the outer section and place Container inside it.",
|
|
57
|
+
"Use bc-py-sm, bc-py-md or bc-py-lg to suit the surrounding rhythm. Do not add an authored padding modifier.",
|
|
58
|
+
"Use a heading or a suitable accessible label when the section should be a named region.",
|
|
59
|
+
"The recipe composes Container directly. Inner demo content belongs only in Preview.",
|
|
60
|
+
"Spacing presets use existing fluid Semantics from 2xs through xl. There is no fluid-2xl Semantic; a 2xl spacing preset is not shipped.",
|
|
61
|
+
"Review long unbroken content in its consuming region. Core currently lacks a general wrap-anywhere utility. Native wbr opportunities or an accessible local overflow region handle that content."
|
|
62
|
+
]
|
|
63
|
+
}
|
|
@@ -1,5 +1,8 @@
|
|
|
1
|
-
<section class="
|
|
1
|
+
<section class="bc-py-lg bc-color-surface-general-secondary" aria-label="Introduction">
|
|
2
2
|
<div class="bc-container">
|
|
3
|
-
<
|
|
3
|
+
<div class="bc-flex bc-flex-col bc-gap-md">
|
|
4
|
+
<h2 class="bc-h3">Built for your next idea</h2>
|
|
5
|
+
<p class="bc-p2">A section adds vertical rhythm while a nested Container owns the content boundary.</p>
|
|
6
|
+
</div>
|
|
4
7
|
</div>
|
|
5
8
|
</section>
|