@expressivecss/expressive 0.4.0 → 0.5.0

package/src/sass/components/_navigation-bar.scss

@@ -0,0 +1,165 @@
+@use "../abstracts" as *;
+
+// Navigation bar. Destinations, not the app bar (header:has(> nav)).
+// Anatomy is the HTML: a nav.navigation-bar of <a> or <button> items.
+// A leading <i> is the icon; the remaining text is the label.
+// aria-current (or .active) is the selected destination.
+//
+// Two layouts (M3 Expressive):
+//   (default)     stacked — icon above label, pill on the icon
+//   .horizontal   icon beside label, pill around both (medium windows)
+//
+// 3–5 destinations of equal importance. They do not change per screen.
+//
+// Tokens:
+//   --md-comp-nav-bar-container-color
+//   --md-comp-nav-bar-container-height          64px
+//   --md-comp-nav-bar-icon-size                 24px
+//   --md-comp-nav-bar-indicator-width           56px
+//   --md-comp-nav-bar-indicator-height          32px
+//   --md-comp-nav-bar-indicator-shape           16px / 100px horizontal
+//   --md-comp-nav-bar-active-indicator-color    secondary-container
+//   --md-comp-nav-bar-active-color              on-secondary-container
+//
+// Nest descendants inside this block.
+
+.navigation-bar {
+  --md-comp-nav-bar-container-color: var(--md-sys-color-surface-container);
+  --md-comp-nav-bar-container-height: 64px;
+  --md-comp-nav-bar-icon-size: 24px;
+  --md-comp-nav-bar-indicator-width: 56px;
+  --md-comp-nav-bar-indicator-height: 32px;
+  --md-comp-nav-bar-indicator-shape: 16px;
+  --md-comp-nav-bar-active-indicator-color: var(--md-sys-color-secondary-container);
+  --md-comp-nav-bar-active-color: var(--md-sys-color-on-secondary-container);
+
+  box-sizing: border-box;
+  display: flex;
+  align-items: center;
+  justify-content: space-evenly;
+  width: 100%;
+  min-height: var(--md-comp-nav-bar-container-height);
+  margin: 0;
+  padding: 6px 8px;
+  padding-bottom: max(6px, env(safe-area-inset-bottom, 0px));
+  background-color: var(--md-comp-nav-bar-container-color);
+  color: var(--md-sys-color-on-surface);
+
+  > :is(a, button) {
+    position: relative;
+    box-sizing: border-box;
+    display: flex;
+    flex: 1 1 0;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 4px;
+    min-width: 0;
+    margin: 0;
+    padding: 4px 0 6px;
+    border: 0;
+    background: transparent;
+    color: var(--md-sys-color-on-surface-variant);
+    cursor: pointer;
+    appearance: none;
+    text-decoration: none;
+    @include typescale("label-medium");
+    @include focus-visible;
+
+    > i {
+      display: flex;
+      flex-shrink: 0;
+      align-items: center;
+      justify-content: center;
+      box-sizing: border-box;
+      width: var(--md-comp-nav-bar-indicator-width);
+      height: var(--md-comp-nav-bar-indicator-height);
+      border-radius: var(--md-comp-nav-bar-indicator-shape);
+      font-size: var(--md-comp-nav-bar-icon-size);
+      color: inherit;
+      transition: background-color 0.2s ease-out;
+    }
+
+    &:hover:not(.active, [aria-current]) > i {
+      background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
+    }
+
+    &.active,
+    &[aria-current] {
+      color: var(--md-sys-color-on-surface);
+
+      > i {
+        background-color: var(--md-comp-nav-bar-active-indicator-color);
+        color: var(--md-comp-nav-bar-active-color);
+        --md-icon-fill: 1;
+      }
+    }
+
+    &.disabled,
+    &[aria-disabled="true"] {
+      pointer-events: none;
+      color: color-mix(in oklab, var(--md-sys-color-on-surface) 38%, transparent);
+    }
+
+    // Sibling badge. Child-of-icon is handled in _badges.scss.
+    > .badge {
+      position: absolute;
+      z-index: 1;
+      top: calc(4px + (var(--md-comp-nav-bar-indicator-height) - 24px) / 2);
+      left: calc(50% + 12px);
+      transform: translate(-50%, -50%);
+    }
+  }
+
+  &.horizontal {
+    --md-comp-nav-bar-indicator-shape: 100px;
+    min-height: 56px;
+
+    > :is(a, button) {
+      flex: 0 1 auto;
+      flex-direction: row;
+      gap: 8px;
+      min-height: 40px;
+      padding: 8px 16px;
+      border-radius: var(--md-comp-nav-bar-indicator-shape);
+
+      > i {
+        width: var(--md-comp-nav-bar-icon-size);
+        height: var(--md-comp-nav-bar-icon-size);
+        border-radius: 0;
+      }
+
+      > .badge {
+        top: calc(50% - 12px);
+        left: auto;
+        inset-inline-start: calc(16px + 24px);
+        transform: translate(-50%, -50%);
+      }
+
+      &:hover:not(.active, [aria-current]) {
+        background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
+
+        > i {
+          background-color: transparent;
+        }
+      }
+
+      &.active,
+      &[aria-current] {
+        background-color: var(--md-comp-nav-bar-active-indicator-color);
+        color: var(--md-comp-nav-bar-active-color);
+
+        > i {
+          background-color: transparent;
+          color: inherit;
+        }
+      }
+    }
+  }
+
+  &.fixed {
+    position: sticky;
+    bottom: 0;
+    z-index: 997;
+  }
+}

package/src/sass/components/_navigation-rail.scss

@@ -0,0 +1,308 @@
+@use "../abstracts" as *;
+
+// Navigation rail. Destinations on mid-size screens, not the bottom
+// navigation bar and not the sidenav drawer.
+//
+// Anatomy is the HTML: a nav.navigation-rail. The first
+// button:not(.button) is the menu toggle. A .button child is the
+// optional FAB. Other <a>/<button> are destinations (leading <i>,
+// remaining text is the label, optional .badge). A heading is a
+// section header (expanded only). aria-current / .active is selected.
+//
+// .expanded widens the rail (icon+label on one row, extended FAB).
+// Below `small`, .expanded is modal (scrim). .modal forces that
+// overlay at every breakpoint. JS toggles .expanded from the menu
+// button; the class is also valid set by the author.
+//
+// Tokens:
+//   --md-comp-nav-rail-collapsed-width     96px
+//   --md-comp-nav-rail-expanded-width      280px (clamped 220–360)
+//   --md-comp-nav-rail-icon-size           24px
+//   --md-comp-nav-rail-indicator-width     56px
+//   --md-comp-nav-rail-indicator-height    32px / 56px expanded
+//   --md-comp-nav-rail-fab-size            56px
+//
+// Nest descendants inside this block.
+
+:root {
+  --md-comp-nav-rail-collapsed-width: 96px;
+  --md-comp-nav-rail-expanded-width: 280px;
+}
+
+.navigation-rail {
+  --md-comp-nav-rail-icon-size: 24px;
+  --md-comp-nav-rail-indicator-width: 56px;
+  --md-comp-nav-rail-indicator-height: 32px;
+  --md-comp-nav-rail-indicator-shape: 16px;
+  --md-comp-nav-rail-fab-size: 56px;
+  --md-comp-nav-rail-active-indicator-color: var(--md-sys-color-secondary-container);
+  --md-comp-nav-rail-active-color: var(--md-sys-color-on-secondary-container);
+  --md-comp-nav-rail-duration: 250ms;
+
+  box-sizing: border-box;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  gap: 4px;
+  width: var(--md-comp-nav-rail-collapsed-width);
+  min-width: var(--md-comp-nav-rail-collapsed-width);
+  min-height: 100dvh;
+  margin: 0;
+  padding: 20px 8px 16px;
+  overflow-x: hidden;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  background-color: var(--md-sys-color-surface-container);
+  color: var(--md-sys-color-on-surface);
+  transition: width var(--md-comp-nav-rail-duration) ease,
+    min-width var(--md-comp-nav-rail-duration) ease,
+    padding var(--md-comp-nav-rail-duration) ease;
+
+  // Menu toggle.
+  > button:not(.button):first-child {
+    display: flex;
+    flex: 0 0 auto;
+    align-items: center;
+    justify-content: center;
+    width: var(--md-comp-nav-rail-indicator-width);
+    height: 48px;
+    margin: 0 0 8px;
+    padding: 0;
+    border: 0;
+    border-radius: var(--md-comp-nav-rail-indicator-shape);
+    background: transparent;
+    color: var(--md-sys-color-on-surface-variant);
+    cursor: pointer;
+    appearance: none;
+    @include focus-visible;
+
+    > i {
+      font-size: var(--md-comp-nav-rail-icon-size);
+      width: var(--md-comp-nav-rail-icon-size);
+      height: var(--md-comp-nav-rail-icon-size);
+    }
+
+    &:hover {
+      background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
+    }
+  }
+
+  // Optional FAB. Collapsed: icon-only 56dp. Expanded: extended.
+  > :is(a, button).button {
+    display: inline-flex;
+    flex: 0 0 auto;
+    align-items: center;
+    justify-content: center;
+    gap: 8px;
+    box-sizing: border-box;
+    width: var(--md-comp-nav-rail-fab-size);
+    height: var(--md-comp-nav-rail-fab-size);
+    margin: 4px 0 16px;
+    padding: 0;
+    overflow: hidden;
+    border-radius: 16px;
+    color: var(--md-sys-color-on-primary-container);
+    background-color: var(--md-sys-color-primary-container);
+    text-decoration: none;
+
+    > :not(i) {
+      position: absolute;
+      width: 1px;
+      height: 1px;
+      overflow: hidden;
+      clip-path: inset(50%);
+    }
+  }
+
+  // Destinations.
+  > a:not(.button),
+  > button:not(.button):not(:first-child) {
+    position: relative;
+    display: flex;
+    flex: 0 0 auto;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: 4px;
+    box-sizing: border-box;
+    width: 100%;
+    margin: 0;
+    padding: 6px 0;
+    border: 0;
+    background: transparent;
+    color: var(--md-sys-color-on-surface-variant);
+    cursor: pointer;
+    appearance: none;
+    text-decoration: none;
+    text-align: center;
+    @include typescale("label-medium");
+    @include focus-visible;
+
+    > i {
+      display: flex;
+      flex-shrink: 0;
+      align-items: center;
+      justify-content: center;
+      box-sizing: border-box;
+      width: var(--md-comp-nav-rail-indicator-width);
+      height: var(--md-comp-nav-rail-indicator-height);
+      border-radius: var(--md-comp-nav-rail-indicator-shape);
+      font-size: var(--md-comp-nav-rail-icon-size);
+      color: inherit;
+      transition: background-color var(--md-comp-nav-rail-duration) ease;
+    }
+
+    &:hover:not(.active, [aria-current]) > i {
+      background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
+    }
+
+    &.active,
+    &[aria-current] {
+      color: var(--md-sys-color-on-surface);
+
+      > i {
+        background-color: var(--md-comp-nav-rail-active-indicator-color);
+        color: var(--md-comp-nav-rail-active-color);
+        --md-icon-fill: 1;
+      }
+    }
+
+    // Sibling badge (icon + label + .badge). Child-of-icon is handled
+    // in _badges.scss. Sit on the upper trailing corner of the 24dp glyph.
+    > .badge {
+      position: absolute;
+      z-index: 1;
+      top: calc(6px + (var(--md-comp-nav-rail-indicator-height) - 24px) / 2);
+      left: calc(50% + 12px);
+      transform: translate(-50%, -50%);
+    }
+  }
+
+  > :is(h1, h2, h3, h4, h5, h6) {
+    display: none;
+    box-sizing: border-box;
+    width: 100%;
+    margin: 0;
+    padding: 12px 16px 8px;
+    color: var(--md-sys-color-on-surface-variant);
+    @include typescale("title-small");
+  }
+
+  &.expanded {
+    --md-comp-nav-rail-indicator-height: 56px;
+    --md-comp-nav-rail-indicator-shape: 28px;
+
+    align-items: stretch;
+    width: clamp(220px, var(--md-comp-nav-rail-expanded-width), 360px);
+    min-width: 220px;
+    padding-inline: 16px;
+
+    > button:not(.button):first-child {
+      justify-content: flex-start;
+      width: auto;
+      padding-inline: 16px;
+    }
+
+    > :is(a, button).button {
+      width: 100%;
+      justify-content: flex-start;
+      padding-inline: 16px 20px;
+      color: var(--md-sys-color-on-primary-container);
+      background-color: var(--md-sys-color-primary-container);
+
+      > :not(i) {
+        position: static;
+        width: auto;
+        height: auto;
+        overflow: visible;
+        clip-path: none;
+        @include typescale("label-large");
+      }
+    }
+
+    > a:not(.button),
+    > button:not(.button):not(:first-child) {
+      flex-direction: row;
+      justify-content: flex-start;
+      gap: 12px;
+      min-height: var(--md-comp-nav-rail-indicator-height);
+      padding: 0 16px;
+      border-radius: var(--md-comp-nav-rail-indicator-shape);
+      text-align: start;
+
+      > i {
+        width: var(--md-comp-nav-rail-icon-size);
+        height: var(--md-comp-nav-rail-icon-size);
+        border-radius: 0;
+      }
+
+      &:hover:not(.active, [aria-current]) {
+        background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
+
+        > i {
+          background-color: transparent;
+        }
+      }
+
+      &.active,
+      &[aria-current] {
+        background-color: var(--md-comp-nav-rail-active-indicator-color);
+        color: var(--md-comp-nav-rail-active-color);
+
+        > i {
+          background-color: transparent;
+          color: inherit;
+        }
+      }
+
+      > .badge {
+        top: calc((var(--md-comp-nav-rail-indicator-height) - 24px) / 2);
+        left: auto;
+        inset-inline-start: calc(16px + 24px);
+        transform: translate(-50%, -50%);
+      }
+    }
+
+    > :is(h1, h2, h3, h4, h5, h6) {
+      display: block;
+    }
+  }
+
+  &.expanded.modal {
+    position: fixed;
+    inset: 0 auto 0 0;
+    z-index: 998;
+    @include z-depth("1");
+
+    &::before {
+      content: "";
+      position: fixed;
+      inset: 0;
+      background-color: color-mix(in oklab, var(--md-sys-color-scrim) 32%, transparent);
+      z-index: -1;
+    }
+  }
+
+  @include bp-down("small") {
+    &.expanded:not(.modal) {
+      position: fixed;
+      inset: 0 auto 0 0;
+      z-index: 998;
+      @include z-depth("1");
+
+      &::before {
+        content: "";
+        position: fixed;
+        inset: 0;
+        background-color: color-mix(in oklab, var(--md-sys-color-scrim) 32%, transparent);
+        z-index: -1;
+      }
+    }
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .navigation-rail {
+    transition: none;
+  }
+}

package/src/sass/components/_page-footer.scss

@@ -4,8 +4,8 @@
 //
 // Anatomy is the HTML. A <footer> is the landmark. A heading is a column
 // title. A <nav> (or ul) is a link list. The last child <small> is the
-// legal bar. A footer whose only child is a <nav> is the bottom app bar,
-// not this component.
+// legal bar. A footer whose only child is nav.navigation-bar is the
+// navigation bar, not this component.
 //
 // Tokens:
 //   --md-comp-footer-padding-block     3rem
@@ -16,7 +16,7 @@
 // Unfilled by default (dashed hairline). .filled uses surface-container.
 // There is no JavaScript.
 
-footer:not(:has(> nav:only-child)) {
+footer:not(:has(> .navigation-bar:only-child)) {
   --md-comp-footer-padding-block: 3rem;
   --md-comp-footer-padding-inline: 1rem;
   --md-comp-footer-gap: 2rem;
@@ -80,6 +80,10 @@ footer:not(:has(> nav:only-child)):not(:has(> .container)) {
   @include bp-up("xlarge") {
     grid-template-columns: repeat(5, 1fr);
   }
+
+  @include bp-up("xxlarge") {
+    grid-template-columns: repeat(6, 1fr);
+  }
 }
 
 footer:not(:has(> nav:only-child)) > .container > .row,

package/src/sass/components/_side-sheet.scss

@@ -0,0 +1,193 @@
+@use "../abstracts" as *;
+
+// Side sheets.
+//
+// Anatomy is the HTML. A dialog.side-sheet (or .right / .left) is the
+// surface, docked to the trailing edge by default. showModal() is the
+// modal variant (scrim, rounded inner corners). show() is the standard
+// variant (no scrim, a divider on the inner edge, page stays interactive).
+//
+// A <header> is the top bar: an optional back button, a heading, and a
+// close control (form[method=dialog] with an icon button). Body content
+// is a <div> or <p>. A last-child form[method=dialog] is the action row.
+//
+// Tokens follow https://m3.material.io/components/side-sheets
+//   container    surface-container-low, 400dp, full height
+//   standard     coplanar, 1dp outline-variant rule on the inner edge
+//   modal        28dp inner corners, elevation 1, scrim
+//   header       64dp, title-large, 24dp inset, 48dp icon buttons
+//   actions      16dp pad, outline-variant rule above
+//
+// Standard is for large windows next to the main pane. Modal is for
+// compact/medium, or whenever the sheet should interrupt.
+
+$_sheet: "dialog.side-sheet, dialog.right, dialog.right-sheet, dialog.left, dialog.left-sheet";
+
+#{$_sheet} {
+  --md-comp-side-sheet-container-color: var(--md-sys-color-surface-container-low);
+  --md-comp-side-sheet-container-shape: 28px;
+  --md-comp-side-sheet-container-width: 400px;
+  --md-comp-side-sheet-shift: 0px;
+
+  box-sizing: border-box;
+  position: fixed;
+  float: none !important;
+  inset-block: 0;
+  inset-inline-start: auto;
+  inset-inline-end: 0;
+  width: min(var(--md-comp-side-sheet-container-width), 85%);
+  max-width: var(--md-comp-side-sheet-container-width);
+  height: auto;
+  max-height: none;
+  min-width: 0;
+  min-height: 0;
+  margin: 0;
+  padding: 0;
+  border: none;
+  background-color: var(--md-comp-side-sheet-container-color);
+  color: var(--md-sys-color-on-surface);
+  outline: none;
+  translate: var(--md-comp-side-sheet-shift) 0;
+  transition: translate 280ms ease, border-radius 200ms ease;
+
+  &:not(:modal) {
+    z-index: 1100;
+    border-radius: 0;
+    box-shadow: none;
+    // Standard: attached to the page, inner edge is a divider.
+    border-inline-start: 1px solid var(--md-sys-color-outline-variant);
+  }
+
+  &:modal {
+    border-radius: var(--md-comp-side-sheet-container-shape) 0 0
+      var(--md-comp-side-sheet-container-shape);
+    @include z-depth("1");
+  }
+
+  &:not(:modal)::backdrop {
+    background: none;
+    backdrop-filter: none;
+  }
+
+  // Leading-edge dock.
+  &.left,
+  &.left-sheet,
+  &.start {
+    inset-inline-start: 0;
+    inset-inline-end: auto;
+
+    &:not(:modal) {
+      border-inline-start: 0;
+      border-inline-end: 1px solid var(--md-sys-color-outline-variant);
+    }
+
+    &:modal {
+      border-radius: 0 var(--md-comp-side-sheet-container-shape)
+        var(--md-comp-side-sheet-container-shape) 0;
+    }
+  }
+
+  > header {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    flex: 0 0 auto;
+    box-sizing: border-box;
+    min-height: 64px;
+    margin: 0;
+    padding: 8px 12px 8px 24px;
+    background: none;
+    box-shadow: none;
+  }
+
+  > header:has(> :is(button, a):first-child) {
+    padding-inline-start: 8px;
+  }
+
+  > header > :is(h1, h2, h3, h4, h5, h6) {
+    flex: 1 1 auto;
+    min-width: 0;
+    margin: 0;
+    padding: 0;
+    color: var(--md-sys-color-on-surface);
+    @include typescale("title-large");
+  }
+
+  > header > form {
+    display: flex;
+    flex: 0 0 auto;
+    align-items: center;
+    margin: 0;
+    padding: 0;
+    border: 0;
+    background: none;
+    box-shadow: none;
+  }
+
+  > header :is(button, a.button) {
+    flex: 0 0 48px;
+    box-sizing: border-box;
+    width: 48px;
+    height: 48px;
+    min-width: 48px;
+    padding: 0;
+    border: none;
+    border-radius: 50%;
+    background-color: transparent;
+    color: var(--md-sys-color-on-surface-variant);
+    box-shadow: none;
+
+    > i {
+      font-size: 24px;
+      width: 24px;
+      height: 24px;
+      line-height: 24px;
+    }
+
+    &:hover {
+      background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
+    }
+
+    &:focus-visible {
+      outline: 3px solid var(--md-sys-color-secondary);
+      outline-offset: 2px;
+    }
+  }
+
+  > :is(form, nav):last-child {
+    justify-content: flex-start;
+    gap: 8px;
+    padding: 16px 24px;
+    border-block-start: 1px solid var(--md-sys-color-outline-variant);
+  }
+}
+
+// :is() so [open] applies to every alternative. `#{$_sheet}[open]` only
+// suffixes the last selector and would paint a closed .side-sheet.
+:is(#{$_sheet}):not([open]) {
+  display: none;
+}
+
+:is(#{$_sheet})[open] {
+  display: flex;
+  flex-direction: column;
+}
+
+@starting-style {
+  dialog.side-sheet[open],
+  dialog.right[open],
+  dialog.right-sheet[open] {
+    translate: 100% 0;
+  }
+
+  dialog.left[open],
+  dialog.left-sheet[open] {
+    translate: -100% 0;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  #{$_sheet} {
+    transition: none;
+  }
+}