@buffercreations/levelsui 0.0.0-stage → 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (116) hide show
  1. package/01. Elements/.gitkeep +0 -0
  2. package/01. Elements/actions/controls/button/api.json +106 -0
  3. package/01. Elements/actions/controls/button/button.definition.json +38 -0
  4. package/01. Elements/actions/controls/button/button.scss +80 -0
  5. package/01. Elements/actions/controls/button/docs.md +41 -0
  6. package/01. Elements/actions/controls/button/examples/contexts/code.html +3 -0
  7. package/01. Elements/actions/controls/button/examples/contexts/preview.html +3 -0
  8. package/01. Elements/actions/controls/button/examples/icons/code.html +6 -0
  9. package/01. Elements/actions/controls/button/examples/icons/preview.html +5 -0
  10. package/01. Elements/actions/controls/button/examples/index.json +51 -0
  11. package/01. Elements/actions/controls/button/examples/links/code.html +1 -0
  12. package/01. Elements/actions/controls/button/examples/links/preview.html +3 -0
  13. package/01. Elements/actions/controls/button/examples/native-default/code.html +9 -0
  14. package/01. Elements/actions/controls/button/examples/native-default/preview.html +9 -0
  15. package/01. Elements/actions/controls/button/examples/sizes/code.html +1 -0
  16. package/01. Elements/actions/controls/button/examples/sizes/preview.html +7 -0
  17. package/01. Elements/actions/controls/button/examples/states/code.html +1 -0
  18. package/01. Elements/actions/controls/button/examples/states/preview.html +5 -0
  19. package/01. Elements/actions/controls/button/examples/treatments/code.html +1 -0
  20. package/01. Elements/actions/controls/button/examples/treatments/preview.html +5 -0
  21. package/01. Elements/media/identity/avatar/api.json +126 -0
  22. package/01. Elements/media/identity/avatar/avatar.definition.json +38 -0
  23. package/01. Elements/media/identity/avatar/avatar.scss +80 -0
  24. package/01. Elements/media/identity/avatar/docs.md +64 -0
  25. package/01. Elements/media/identity/avatar/examples/badges/code.html +10 -0
  26. package/01. Elements/media/identity/avatar/examples/badges/preview.html +29 -0
  27. package/01. Elements/media/identity/avatar/examples/fallbacks/code.html +5 -0
  28. package/01. Elements/media/identity/avatar/examples/fallbacks/preview.html +23 -0
  29. package/01. Elements/media/identity/avatar/examples/index.json +37 -0
  30. package/01. Elements/media/identity/avatar/examples/presence/code.html +6 -0
  31. package/01. Elements/media/identity/avatar/examples/presence/preview.html +26 -0
  32. package/01. Elements/media/identity/avatar/examples/shapes/code.html +5 -0
  33. package/01. Elements/media/identity/avatar/examples/shapes/preview.html +17 -0
  34. package/01. Elements/media/identity/avatar/examples/sizes/code.html +5 -0
  35. package/01. Elements/media/identity/avatar/examples/sizes/preview.html +32 -0
  36. package/02. Layouts/.gitkeep +0 -0
  37. package/02. Layouts/UTILITY-RECIPES.md +55 -0
  38. package/02. Layouts/application/app-shell/api.json +46 -0
  39. package/02. Layouts/application/app-shell/app-shell.definition.json +25 -0
  40. package/02. Layouts/application/app-shell/app-shell.scss +68 -0
  41. package/02. Layouts/application/app-shell/docs.md +31 -0
  42. package/02. Layouts/application/app-shell/examples/basic/code.html +17 -0
  43. package/02. Layouts/application/app-shell/examples/basic/preview.html +17 -0
  44. package/02. Layouts/application/app-shell/examples/collapsed/code.html +17 -0
  45. package/02. Layouts/application/app-shell/examples/collapsed/preview.html +17 -0
  46. package/02. Layouts/application/app-shell/examples/hidden/code.html +17 -0
  47. package/02. Layouts/application/app-shell/examples/hidden/preview.html +17 -0
  48. package/02. Layouts/application/app-shell/examples/index.json +23 -0
  49. package/02. Layouts/composition/stack/api.json +1 -0
  50. package/02. Layouts/composition/stack/docs.md +5 -0
  51. package/02. Layouts/composition/stack/examples/basic/code.html +4 -0
  52. package/02. Layouts/composition/stack/examples/basic/preview.html +4 -0
  53. package/02. Layouts/composition/stack/examples/index.json +1 -0
  54. package/02. Layouts/composition/stack/stack.definition.json +7 -0
  55. package/02. Layouts/composition/stack/stack.html +4 -0
  56. package/02. Layouts/content/grid/api.json +23 -0
  57. package/02. Layouts/content/grid/docs.md +19 -0
  58. package/02. Layouts/content/grid/examples/basic/code.html +5 -0
  59. package/02. Layouts/content/grid/examples/basic/preview.html +5 -0
  60. package/02. Layouts/content/grid/examples/index.json +9 -0
  61. package/02. Layouts/content/grid/grid.definition.json +25 -0
  62. package/02. Layouts/content/grid/grid.scss +5 -0
  63. package/02. Layouts/content/split/api.json +23 -0
  64. package/02. Layouts/content/split/docs.md +18 -0
  65. package/02. Layouts/content/split/examples/basic/code.html +4 -0
  66. package/02. Layouts/content/split/examples/basic/preview.html +4 -0
  67. package/02. Layouts/content/split/examples/index.json +9 -0
  68. package/02. Layouts/content/split/split.definition.json +25 -0
  69. package/02. Layouts/content/split/split.scss +7 -0
  70. package/02. Layouts/primitives/overlay/api.json +23 -0
  71. package/02. Layouts/primitives/overlay/docs.md +19 -0
  72. package/02. Layouts/primitives/overlay/examples/basic/code.html +5 -0
  73. package/02. Layouts/primitives/overlay/examples/basic/preview.html +5 -0
  74. package/02. Layouts/primitives/overlay/examples/index.json +9 -0
  75. package/02. Layouts/primitives/overlay/overlay.definition.json +25 -0
  76. package/02. Layouts/primitives/overlay/overlay.scss +4 -0
  77. package/02. Layouts/sections/section/api.json +23 -0
  78. package/02. Layouts/sections/section/docs.md +19 -0
  79. package/02. Layouts/sections/section/examples/basic/code.html +5 -0
  80. package/02. Layouts/sections/section/examples/basic/preview.html +5 -0
  81. package/02. Layouts/sections/section/examples/index.json +9 -0
  82. package/02. Layouts/sections/section/section.definition.json +25 -0
  83. package/02. Layouts/sections/section/section.scss +4 -0
  84. package/02. Layouts/sections/sidebar/api.json +23 -0
  85. package/02. Layouts/sections/sidebar/docs.md +18 -0
  86. package/02. Layouts/sections/sidebar/examples/basic/code.html +4 -0
  87. package/02. Layouts/sections/sidebar/examples/basic/preview.html +4 -0
  88. package/02. Layouts/sections/sidebar/examples/index.json +9 -0
  89. package/02. Layouts/sections/sidebar/sidebar.definition.json +25 -0
  90. package/02. Layouts/sections/sidebar/sidebar.scss +7 -0
  91. package/03. Components/.gitkeep +0 -0
  92. package/04. Templates/.gitkeep +0 -0
  93. package/05. Pages/.gitkeep +0 -0
  94. package/LICENSE +17 -0
  95. package/README.md +29 -2
  96. package/dist/components/app-shell.css +95 -0
  97. package/dist/components/avatar.css +232 -0
  98. package/dist/components/button.css +150 -0
  99. package/dist/components/grid.css +22 -0
  100. package/dist/components/overlay.css +17 -0
  101. package/dist/components/section.css +14 -0
  102. package/dist/components/sidebar.css +22 -0
  103. package/dist/components/split.css +22 -0
  104. package/package.json +48 -4
  105. package/schemas/reusable-ui.schema.json +351 -0
  106. package/tooling/cli/build.mjs +82 -0
  107. package/tooling/cli/cli.mjs +56 -0
  108. package/tooling/cli/migrate.mjs +57 -0
  109. package/tooling/cli/project.mjs +261 -0
  110. package/tooling/cli/registry-location.mjs +32 -0
  111. package/tooling/cli/registry.mjs +3 -0
  112. package/tooling/registry/definitions.mjs +69 -0
  113. package/tooling/registry/index.mjs +3 -0
  114. package/tooling/registry/paths.mjs +15 -0
  115. package/tools/build-css.mjs +75 -0
  116. package/tools/validate.mjs +6 -0
@@ -0,0 +1,17 @@
1
+ <div class="bcl-app-shell" data-sidebar="collapsed">
2
+ <header class="bcl-app-shell__header bc-p-md">
3
+ <strong>Application header</strong>
4
+ </header>
5
+ <div class="bcl-app-shell__body">
6
+ <aside class="bcl-app-shell__sidebar bc-p-md">
7
+ <strong>Navigation</strong>
8
+ <nav aria-label="Example navigation">
9
+ <p>Overview</p><p>Projects</p><p>Settings</p>
10
+ </nav>
11
+ </aside>
12
+ <main class="bcl-app-shell__main bc-p-lg">
13
+ <h2>Main application content</h2>
14
+ <p>This area expands to fill the remaining width.</p>
15
+ </main>
16
+ </div>
17
+ </div>
@@ -0,0 +1,17 @@
1
+ <div class="bcl-app-shell" data-sidebar="collapsed">
2
+ <header class="bcl-app-shell__header bc-p-md">
3
+ <strong>Application header</strong>
4
+ </header>
5
+ <div class="bcl-app-shell__body">
6
+ <aside class="bcl-app-shell__sidebar bc-p-md">
7
+ <strong>Navigation</strong>
8
+ <nav aria-label="Example navigation">
9
+ <p>Overview</p><p>Projects</p><p>Settings</p>
10
+ </nav>
11
+ </aside>
12
+ <main class="bcl-app-shell__main bc-p-lg">
13
+ <h2>Main application content</h2>
14
+ <p>This area expands to fill the remaining width.</p>
15
+ </main>
16
+ </div>
17
+ </div>
@@ -0,0 +1,17 @@
1
+ <div class="bcl-app-shell" data-sidebar="hidden">
2
+ <header class="bcl-app-shell__header bc-p-md">
3
+ <strong>Application header</strong>
4
+ </header>
5
+ <div class="bcl-app-shell__body">
6
+ <aside class="bcl-app-shell__sidebar bc-p-md">
7
+ <strong>Navigation</strong>
8
+ <nav aria-label="Example navigation">
9
+ <p>Overview</p><p>Projects</p><p>Settings</p>
10
+ </nav>
11
+ </aside>
12
+ <main class="bcl-app-shell__main bc-p-lg">
13
+ <h2>Main application content</h2>
14
+ <p>This area expands to fill the remaining width.</p>
15
+ </main>
16
+ </div>
17
+ </div>
@@ -0,0 +1,17 @@
1
+ <div class="bcl-app-shell" data-sidebar="hidden">
2
+ <header class="bcl-app-shell__header bc-p-md">
3
+ <strong>Application header</strong>
4
+ </header>
5
+ <div class="bcl-app-shell__body">
6
+ <aside class="bcl-app-shell__sidebar bc-p-md">
7
+ <strong>Navigation</strong>
8
+ <nav aria-label="Example navigation">
9
+ <p>Overview</p><p>Projects</p><p>Settings</p>
10
+ </nav>
11
+ </aside>
12
+ <main class="bcl-app-shell__main bc-p-lg">
13
+ <h2>Main application content</h2>
14
+ <p>This area expands to fill the remaining width.</p>
15
+ </main>
16
+ </div>
17
+ </div>
@@ -0,0 +1,23 @@
1
+ [
2
+ {
3
+ "id": "basic",
4
+ "title": "Expanded sidebar",
5
+ "description": "Header spans full width and sidebar sits beside flexible main content.",
6
+ "preview": "examples/basic/preview.html",
7
+ "code": "examples/basic/code.html"
8
+ },
9
+ {
10
+ "id": "collapsed",
11
+ "title": "Collapsed sidebar",
12
+ "description": "Layout reduces the sidebar track; sidebar content must provide its compact presentation.",
13
+ "preview": "examples/collapsed/preview.html",
14
+ "code": "examples/collapsed/code.html"
15
+ },
16
+ {
17
+ "id": "hidden",
18
+ "title": "Hidden sidebar",
19
+ "description": "Layout removes sidebar from grid and main content fills remaining area.",
20
+ "preview": "examples/hidden/preview.html",
21
+ "code": "examples/hidden/code.html"
22
+ }
23
+ ]
@@ -0,0 +1 @@
1
+ {"anatomy":["container","content"],"accessibility":["Choose native child elements appropriate to the content."],"notes":["Utility-only recipe; no additional CSS or JavaScript."]}
@@ -0,0 +1,5 @@
1
+ # Stack
2
+
3
+ A vertical composition using existing BufferCore flex and spacing utilities. It needs no className, custom stylesheet or JavaScript. Install and activate `stack` with LevelsUI, or copy its HTML directly with BufferCore CSS loaded. Children keep their native semantics. Use the existing `bc-gap-*` utilities for spacing.
4
+
5
+ Code is a single copyable composition. Stack does not introduce a new Foundation capability or a dummy `bcl-*` class.
@@ -0,0 +1,4 @@
1
+ <div class="bc-flex bc-flex-col bc-gap-md">
2
+ <p>First item</p>
3
+ <p>Second item</p>
4
+ </div>
@@ -0,0 +1,4 @@
1
+ <div class="bc-flex bc-flex-col bc-gap-md">
2
+ <p>First item</p>
3
+ <p>Second item</p>
4
+ </div>
@@ -0,0 +1 @@
1
+ [{"id":"basic","title":"Vertical content","preview":"examples/basic/preview.html","code":"examples/basic/code.html"}]
@@ -0,0 +1,7 @@
1
+ {
2
+ "schemaVersion":1,"kind":"recipe","id":"stack","displayName":"Stack","description":"A utility-only vertical composition with semantic spacing.",
3
+ "level":"layout","category":["composition"],
4
+ "source":{"html":"02. Layouts/composition/stack/stack.html"},
5
+ "dependencies":{"css":["foundations"]},
6
+ "documentation":{"guide":"docs.md","api":"api.json","examples":"examples/index.json"}
7
+ }
@@ -0,0 +1,4 @@
1
+ <div class="bc-flex bc-flex-col bc-gap-md">
2
+ <p>First item</p>
3
+ <p>Second item</p>
4
+ </div>
@@ -0,0 +1,23 @@
1
+ {
2
+ "properties": [
3
+ {
4
+ "name": "Layout configuration",
5
+ "type": "CSS custom properties or modifiers",
6
+ "description": "See docs for supported options."
7
+ }
8
+ ],
9
+ "anatomy": [
10
+ "Content regions as shown in example"
11
+ ],
12
+ "accessibility": [
13
+ "Keep DOM reading order logical; use native landmark elements for regions.",
14
+ "Layout styling never replaces focus, keyboard or ARIA behaviour."
15
+ ],
16
+ "tags": [
17
+ "layout",
18
+ "content"
19
+ ],
20
+ "notes": [
21
+ "For an ordinary grid with no constraints use bc-grid and bc-gap-*. This asset adds a reusable responsive column algorithm; CSS custom properties are configuration, not new tokens."
22
+ ]
23
+ }
@@ -0,0 +1,19 @@
1
+ # Grid
2
+
3
+ Configurable grid with responsive auto-fit columns and semantic gaps.
4
+
5
+ ## Usage
6
+
7
+ ```html
8
+ <div class="bcl-grid bcl-grid--auto">
9
+ <article class="bc-p-md bc-color-surface-context">Item one</article>
10
+ <article class="bc-p-md bc-color-surface-context">Item two</article>
11
+ <article class="bc-p-md bc-color-surface-context">Item three</article>
12
+ </div>
13
+ ```
14
+
15
+ ## Design rules
16
+
17
+ For an ordinary grid with no constraints use bc-grid and bc-gap-*. This asset adds a reusable responsive column algorithm; CSS custom properties are configuration, not new tokens.
18
+
19
+ Use semantic `--bc-*` tokens and existing `bc-*` utilities for surface, colour, padding and gap where suitable. No JavaScript is shipped by this Layout.
@@ -0,0 +1,5 @@
1
+ <div class="bcl-grid bcl-grid--auto">
2
+ <article class="bc-p-md bc-color-surface-context">Item one</article>
3
+ <article class="bc-p-md bc-color-surface-context">Item two</article>
4
+ <article class="bc-p-md bc-color-surface-context">Item three</article>
5
+ </div>
@@ -0,0 +1,5 @@
1
+ <div class="bcl-grid bcl-grid--auto">
2
+ <article class="bc-p-md bc-color-surface-context">Item one</article>
3
+ <article class="bc-p-md bc-color-surface-context">Item two</article>
4
+ <article class="bc-p-md bc-color-surface-context">Item three</article>
5
+ </div>
@@ -0,0 +1,9 @@
1
+ [
2
+ {
3
+ "id": "basic",
4
+ "title": "Basic usage",
5
+ "description": "Configurable grid with responsive auto-fit columns and semantic gaps.",
6
+ "preview": "examples/basic/preview.html",
7
+ "code": "examples/basic/code.html"
8
+ }
9
+ ]
@@ -0,0 +1,25 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "grid",
4
+ "displayName": "Grid",
5
+ "description": "Configurable grid with responsive auto-fit columns and semantic gaps.",
6
+ "level": "layout",
7
+ "category": [
8
+ "content"
9
+ ],
10
+ "className": "bcl-grid",
11
+ "source": {
12
+ "scss": "02. Layouts/content/grid/grid.scss",
13
+ "css": "dist/components/grid.css"
14
+ },
15
+ "dependencies": {
16
+ "css": [
17
+ "foundations"
18
+ ]
19
+ },
20
+ "documentation": {
21
+ "guide": "docs.md",
22
+ "api": "api.json",
23
+ "examples": "examples/index.json"
24
+ }
25
+ }
@@ -0,0 +1,5 @@
1
+ /* BufferCore Level 03 — grid; custom layout rules only. */
2
+ .bcl-grid { display: grid; min-width: 0; gap: var(--bc-fluid-md); grid-template-columns: repeat(var(--bcl-grid-columns, 1), minmax(0,1fr)); }
3
+ .bcl-grid--auto { grid-template-columns: repeat(auto-fit, minmax(min(100%, var(--bcl-grid-min, 16rem)), 1fr)); }
4
+ .bcl-grid > * { min-width: 0; }
5
+ @media (min-width: 48rem) { .bcl-grid:not(.bcl-grid--auto) { grid-template-columns: repeat(var(--bcl-grid-columns-md, var(--bcl-grid-columns, 1)), minmax(0,1fr)); } }
@@ -0,0 +1,23 @@
1
+ {
2
+ "properties": [
3
+ {
4
+ "name": "Layout configuration",
5
+ "type": "CSS custom properties or modifiers",
6
+ "description": "See docs for supported options."
7
+ }
8
+ ],
9
+ "anatomy": [
10
+ "Content regions as shown in example"
11
+ ],
12
+ "accessibility": [
13
+ "Keep DOM reading order logical; use native landmark elements for regions.",
14
+ "Layout styling never replaces focus, keyboard or ARIA behaviour."
15
+ ],
16
+ "tags": [
17
+ "layout",
18
+ "content"
19
+ ],
20
+ "notes": [
21
+ "Split is content-agnostic, not a Hero or media component. Order stays logical on narrow screens; visual reverse applies only at wide widths."
22
+ ]
23
+ }
@@ -0,0 +1,18 @@
1
+ # Split
2
+
3
+ Two-region proportional split with predictable stacking at narrow widths.
4
+
5
+ ## Usage
6
+
7
+ ```html
8
+ <div class="bcl-split">
9
+ <div class="bc-p-md">Text or content</div>
10
+ <div class="bc-p-md bc-color-surface-context">Supporting media</div>
11
+ </div>
12
+ ```
13
+
14
+ ## Design rules
15
+
16
+ Split is content-agnostic, not a Hero or media component. Order stays logical on narrow screens; visual reverse applies only at wide widths.
17
+
18
+ Use semantic `--bc-*` tokens and existing `bc-*` utilities for surface, colour, padding and gap where suitable. No JavaScript is shipped by this Layout.
@@ -0,0 +1,4 @@
1
+ <div class="bcl-split">
2
+ <div class="bc-p-md">Text or content</div>
3
+ <div class="bc-p-md bc-color-surface-context">Supporting media</div>
4
+ </div>
@@ -0,0 +1,4 @@
1
+ <div class="bcl-split">
2
+ <div class="bc-p-md">Text or content</div>
3
+ <div class="bc-p-md bc-color-surface-context">Supporting media</div>
4
+ </div>
@@ -0,0 +1,9 @@
1
+ [
2
+ {
3
+ "id": "basic",
4
+ "title": "Basic usage",
5
+ "description": "Two-region proportional split with predictable stacking at narrow widths.",
6
+ "preview": "examples/basic/preview.html",
7
+ "code": "examples/basic/code.html"
8
+ }
9
+ ]
@@ -0,0 +1,25 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "split",
4
+ "displayName": "Split",
5
+ "description": "Two-region proportional split with predictable stacking at narrow widths.",
6
+ "level": "layout",
7
+ "category": [
8
+ "content"
9
+ ],
10
+ "className": "bcl-split",
11
+ "source": {
12
+ "scss": "02. Layouts/content/split/split.scss",
13
+ "css": "dist/components/split.css"
14
+ },
15
+ "dependencies": {
16
+ "css": [
17
+ "foundations"
18
+ ]
19
+ },
20
+ "documentation": {
21
+ "guide": "docs.md",
22
+ "api": "api.json",
23
+ "examples": "examples/index.json"
24
+ }
25
+ }
@@ -0,0 +1,7 @@
1
+ /* BufferCore Level 03 — split; custom layout rules only. */
2
+ .bcl-split { display: grid; grid-template-columns: minmax(0,1fr); gap: var(--bc-fluid-lg); align-items: var(--bcl-split-align, center); min-width: 0; }
3
+ .bcl-split > * { min-width: 0; }
4
+ @media (min-width: 48rem) {
5
+ .bcl-split { grid-template-columns: minmax(0,var(--bcl-split-first, 1fr)) minmax(0,var(--bcl-split-second, 1fr)); }
6
+ .bcl-split--reverse > :first-child { order: 2; }
7
+ }
@@ -0,0 +1,23 @@
1
+ {
2
+ "properties": [
3
+ {
4
+ "name": "Layout configuration",
5
+ "type": "CSS custom properties or modifiers",
6
+ "description": "See docs for supported options."
7
+ }
8
+ ],
9
+ "anatomy": [
10
+ "Content regions as shown in example"
11
+ ],
12
+ "accessibility": [
13
+ "Keep DOM reading order logical; use native landmark elements for regions.",
14
+ "Layout styling never replaces focus, keyboard or ARIA behaviour."
15
+ ],
16
+ "tags": [
17
+ "layout",
18
+ "primitives"
19
+ ],
20
+ "notes": [
21
+ "For simple absolute positioning, bc-relative bc-absolute bc-inset-0 are already sufficient. Use this asset only when a reusable layered anatomy is required. This layout does not implement modal behaviour."
22
+ ]
23
+ }
@@ -0,0 +1,19 @@
1
+ # Overlay
2
+
3
+ A positioned overlay within a containing block, using native positioning rather than application state.
4
+
5
+ ## Usage
6
+
7
+ ```html
8
+ <div class="bcl-overlay">
9
+ <div class="bc-p-lg">Background content</div>
10
+ <div class="bcl-overlay__layer bc-color-fill-context-soft" aria-hidden="true"></div>
11
+ <div class="bcl-overlay__content bc-p-lg">Foreground content</div>
12
+ </div>
13
+ ```
14
+
15
+ ## Design rules
16
+
17
+ For simple absolute positioning, bc-relative bc-absolute bc-inset-0 are already sufficient. Use this asset only when a reusable layered anatomy is required. This layout does not implement modal behaviour.
18
+
19
+ Use semantic `--bc-*` tokens and existing `bc-*` utilities for surface, colour, padding and gap where suitable. No JavaScript is shipped by this Layout.
@@ -0,0 +1,5 @@
1
+ <div class="bcl-overlay">
2
+ <div class="bc-p-lg">Background content</div>
3
+ <div class="bcl-overlay__layer bc-color-fill-context-soft" aria-hidden="true"></div>
4
+ <div class="bcl-overlay__content bc-p-lg">Foreground content</div>
5
+ </div>
@@ -0,0 +1,5 @@
1
+ <div class="bcl-overlay">
2
+ <div class="bc-p-lg">Background content</div>
3
+ <div class="bcl-overlay__layer bc-color-fill-context-soft" aria-hidden="true"></div>
4
+ <div class="bcl-overlay__content bc-p-lg">Foreground content</div>
5
+ </div>
@@ -0,0 +1,9 @@
1
+ [
2
+ {
3
+ "id": "basic",
4
+ "title": "Basic usage",
5
+ "description": "A positioned overlay within a containing block, using native positioning rather than application state.",
6
+ "preview": "examples/basic/preview.html",
7
+ "code": "examples/basic/code.html"
8
+ }
9
+ ]
@@ -0,0 +1,25 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "overlay",
4
+ "displayName": "Overlay",
5
+ "description": "A positioned overlay within a containing block, using native positioning rather than application state.",
6
+ "level": "layout",
7
+ "category": [
8
+ "primitives"
9
+ ],
10
+ "className": "bcl-overlay",
11
+ "source": {
12
+ "scss": "02. Layouts/primitives/overlay/overlay.scss",
13
+ "css": "dist/components/overlay.css"
14
+ },
15
+ "dependencies": {
16
+ "css": [
17
+ "foundations"
18
+ ]
19
+ },
20
+ "documentation": {
21
+ "guide": "docs.md",
22
+ "api": "api.json",
23
+ "examples": "examples/index.json"
24
+ }
25
+ }
@@ -0,0 +1,4 @@
1
+ /* BufferCore Level 03 — overlay; custom layout rules only. */
2
+ .bcl-overlay { position: relative; min-width: 0; }
3
+ .bcl-overlay__layer { position: absolute; inset: 0; z-index: 1; }
4
+ .bcl-overlay__content { position: relative; z-index: 2; }
@@ -0,0 +1,23 @@
1
+ {
2
+ "properties": [
3
+ {
4
+ "name": "Layout configuration",
5
+ "type": "CSS custom properties or modifiers",
6
+ "description": "See docs for supported options."
7
+ }
8
+ ],
9
+ "anatomy": [
10
+ "Content regions as shown in example"
11
+ ],
12
+ "accessibility": [
13
+ "Keep DOM reading order logical; use native landmark elements for regions.",
14
+ "Layout styling never replaces focus, keyboard or ARIA behaviour."
15
+ ],
16
+ "tags": [
17
+ "layout",
18
+ "sections"
19
+ ],
20
+ "notes": [
21
+ "A section is structural only: Hero and feature content belong to components assembled inside it. Use bc-container for horizontal bounds."
22
+ ]
23
+ }
@@ -0,0 +1,19 @@
1
+ # Section
2
+
3
+ A consistent page section with semantic vertical spacing and optional contained content.
4
+
5
+ ## Usage
6
+
7
+ ```html
8
+ <section class="bcl-section bc-color-surface-context">
9
+ <div class="bc-container">
10
+ <h2>Section heading</h2><p>Section content</p>
11
+ </div>
12
+ </section>
13
+ ```
14
+
15
+ ## Design rules
16
+
17
+ A section is structural only: Hero and feature content belong to components assembled inside it. Use bc-container for horizontal bounds.
18
+
19
+ Use semantic `--bc-*` tokens and existing `bc-*` utilities for surface, colour, padding and gap where suitable. No JavaScript is shipped by this Layout.
@@ -0,0 +1,5 @@
1
+ <section class="bcl-section bc-color-surface-context">
2
+ <div class="bc-container">
3
+ <h2>Section heading</h2><p>Section content</p>
4
+ </div>
5
+ </section>
@@ -0,0 +1,5 @@
1
+ <section class="bcl-section bc-color-surface-context">
2
+ <div class="bc-container">
3
+ <h2>Section heading</h2><p>Section content</p>
4
+ </div>
5
+ </section>
@@ -0,0 +1,9 @@
1
+ [
2
+ {
3
+ "id": "basic",
4
+ "title": "Basic usage",
5
+ "description": "A consistent page section with semantic vertical spacing and optional contained content.",
6
+ "preview": "examples/basic/preview.html",
7
+ "code": "examples/basic/code.html"
8
+ }
9
+ ]
@@ -0,0 +1,25 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "section",
4
+ "displayName": "Section",
5
+ "description": "A consistent page section with semantic vertical spacing and optional contained content.",
6
+ "level": "layout",
7
+ "category": [
8
+ "sections"
9
+ ],
10
+ "className": "bcl-section",
11
+ "source": {
12
+ "scss": "02. Layouts/sections/section/section.scss",
13
+ "css": "dist/components/section.css"
14
+ },
15
+ "dependencies": {
16
+ "css": [
17
+ "foundations"
18
+ ]
19
+ },
20
+ "documentation": {
21
+ "guide": "docs.md",
22
+ "api": "api.json",
23
+ "examples": "examples/index.json"
24
+ }
25
+ }
@@ -0,0 +1,4 @@
1
+ /* BufferCore Level 03 — section; custom layout rules only. */
2
+ .bcl-section { padding-block: var(--bc-fluid-lg); min-width: 0; }
3
+ .bcl-section--compact { padding-block: var(--bc-fluid-md); }
4
+ .bcl-section--spacious { padding-block: var(--bc-fluid-xl); }
@@ -0,0 +1,23 @@
1
+ {
2
+ "properties": [
3
+ {
4
+ "name": "Layout configuration",
5
+ "type": "CSS custom properties or modifiers",
6
+ "description": "See docs for supported options."
7
+ }
8
+ ],
9
+ "anatomy": [
10
+ "Content regions as shown in example"
11
+ ],
12
+ "accessibility": [
13
+ "Keep DOM reading order logical; use native landmark elements for regions.",
14
+ "Layout styling never replaces focus, keyboard or ARIA behaviour."
15
+ ],
16
+ "tags": [
17
+ "layout",
18
+ "sections"
19
+ ],
20
+ "notes": [
21
+ "Not an interactive or collapsible navigation component. This is for section-scale aside/main arrangements; use App Shell for the application frame."
22
+ ]
23
+ }
@@ -0,0 +1,18 @@
1
+ # Sidebar
2
+
3
+ A flexible primary region adjacent to a bounded supporting region.
4
+
5
+ ## Usage
6
+
7
+ ```html
8
+ <div class="bcl-sidebar">
9
+ <aside class="bc-p-md bc-color-surface-context">Filters</aside>
10
+ <div class="bc-p-md">Results and primary content</div>
11
+ </div>
12
+ ```
13
+
14
+ ## Design rules
15
+
16
+ Not an interactive or collapsible navigation component. This is for section-scale aside/main arrangements; use App Shell for the application frame.
17
+
18
+ Use semantic `--bc-*` tokens and existing `bc-*` utilities for surface, colour, padding and gap where suitable. No JavaScript is shipped by this Layout.
@@ -0,0 +1,4 @@
1
+ <div class="bcl-sidebar">
2
+ <aside class="bc-p-md bc-color-surface-context">Filters</aside>
3
+ <div class="bc-p-md">Results and primary content</div>
4
+ </div>
@@ -0,0 +1,4 @@
1
+ <div class="bcl-sidebar">
2
+ <aside class="bc-p-md bc-color-surface-context">Filters</aside>
3
+ <div class="bc-p-md">Results and primary content</div>
4
+ </div>
@@ -0,0 +1,9 @@
1
+ [
2
+ {
3
+ "id": "basic",
4
+ "title": "Basic usage",
5
+ "description": "A flexible primary region adjacent to a bounded supporting region.",
6
+ "preview": "examples/basic/preview.html",
7
+ "code": "examples/basic/code.html"
8
+ }
9
+ ]
@@ -0,0 +1,25 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "id": "sidebar",
4
+ "displayName": "Sidebar",
5
+ "description": "A flexible primary region adjacent to a bounded supporting region.",
6
+ "level": "layout",
7
+ "category": [
8
+ "sections"
9
+ ],
10
+ "className": "bcl-sidebar",
11
+ "source": {
12
+ "scss": "02. Layouts/sections/sidebar/sidebar.scss",
13
+ "css": "dist/components/sidebar.css"
14
+ },
15
+ "dependencies": {
16
+ "css": [
17
+ "foundations"
18
+ ]
19
+ },
20
+ "documentation": {
21
+ "guide": "docs.md",
22
+ "api": "api.json",
23
+ "examples": "examples/index.json"
24
+ }
25
+ }