@expressivecss/expressive 0.3.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

@@ -1,27 +1,150 @@
 @use "../abstracts" as *;
 
-.page-footer {
+// Site footer.
+//
+// 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 nav.navigation-bar is the
+// navigation bar, not this component.
+//
+// Tokens:
+//   --md-comp-footer-padding-block     3rem
+//   --md-comp-footer-padding-inline    1rem
+//   --md-comp-footer-gap               2rem
+//   --md-comp-footer-legal-height      48px
+//
+// Unfilled by default (dashed hairline). .filled uses surface-container.
+// There is no JavaScript.
+
+footer:not(:has(> .navigation-bar:only-child)) {
+  --md-comp-footer-padding-block: 3rem;
+  --md-comp-footer-padding-inline: 1rem;
+  --md-comp-footer-gap: 2rem;
+  --md-comp-footer-legal-height: 48px;
+
+  box-sizing: border-box;
   margin-top: 5rem;
-  padding-top: 3rem;
+  padding: var(--md-comp-footer-padding-block) var(--md-comp-footer-padding-inline) 1rem;
   border-top: 1px dashed var(--md-sys-color-outline-variant);
+  color: var(--md-sys-color-on-surface);
+
   p {
-    color: var(--md-sys-color-outline);
+    margin: 0 0 8px;
+    color: var(--md-sys-color-on-surface-variant);
+    @include typescale("body-medium");
+    font-family: $font-stack;
   }
-  a {
+
+  a:not(.button, .circle, .extra) {
     color: var(--md-sys-color-primary);
+    text-decoration: none;
+    @include focus-visible;
+  }
+
+  :is(h1, h2, h3, h4, h5, h6) {
+    margin: 0 0 8px;
+    color: var(--md-sys-color-on-surface);
+    @include typescale("title-small");
+    font-family: $font-stack;
+  }
+
+  ul {
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+}
+
+footer:not(:has(> nav:only-child)).filled,
+footer:not(:has(> nav:only-child)).surface {
+  background-color: var(--md-sys-color-surface-container);
+  border-top: 1px solid var(--md-sys-color-outline-variant);
+}
+
+// Columns: direct <nav> children. A wrapping .container is the grid
+// when the author uses one. Legacy .row still spans the full measure.
+footer:not(:has(> nav:only-child)) > .container,
+footer:not(:has(> nav:only-child)):not(:has(> .container)) {
+  display: grid;
+  gap: var(--md-comp-footer-gap);
+  grid-template-columns: 1fr;
+
+  @include bp-up("small") {
+    grid-template-columns: repeat(2, 1fr);
+  }
+
+  @include bp-up("large") {
+    grid-template-columns: repeat(4, 1fr);
+  }
+
+  @include bp-up("xlarge") {
+    grid-template-columns: repeat(5, 1fr);
   }
-  .footer-copyright,
-  .footer-copyright a {
-    overflow: hidden;
-    min-height: 50px;
-    display: flex;
-    align-items: center;
-    justify-content: space-between;
-    padding: 10px 0px;
+
+  @include bp-up("xxlarge") {
+    grid-template-columns: repeat(6, 1fr);
   }
 }
 
-.page-footer ul {
-  padding-left: 0;
-  list-style-type: none;
+footer:not(:has(> nav:only-child)) > .container > .row,
+footer:not(:has(> nav:only-child)) > .row {
+  grid-column: 1 / -1;
+}
+
+footer:not(:has(> nav:only-child)) nav {
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  gap: 0;
+  min-width: 0;
+}
+
+footer:not(:has(> nav:only-child)) nav > a:not(.button, .circle, .extra),
+footer:not(:has(> nav:only-child)) ul a:not(.button, .circle, .extra) {
+  display: inline-flex;
+  align-items: center;
+  box-sizing: border-box;
+  min-height: 48px;
+  padding: 0 12px;
+  margin-inline-start: -12px;
+  border-radius: 2rem;
+  @include typescale("label-large");
+  font-family: $font-stack;
+
+  &:hover {
+    background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
+  }
+}
+
+footer:not(:has(> nav:only-child)) > small:last-child {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  justify-content: space-between;
+  gap: 8px 16px;
+  box-sizing: border-box;
+  min-height: var(--md-comp-footer-legal-height);
+  margin: 0;
+  padding-block: 12px;
+  grid-column: 1 / -1;
+  border-top: 1px solid var(--md-sys-color-outline-variant);
+  color: var(--md-sys-color-on-surface-variant);
+  @include typescale("body-small");
+  font-family: $font-stack;
+
+  a:not(.button) {
+    color: var(--md-sys-color-primary);
+  }
+}
+
+// Sticky: pin the footer to the bottom of a short page. Only when the
+// landmark is a direct child of body — not a footer nested in a demo.
+body:has(> footer:not(:has(> nav:only-child))) {
+  min-height: 100dvh;
+  display: flex;
+  flex-direction: column;
+}
+
+body:has(> footer:not(:has(> nav:only-child))) > main {
+  flex: 1 0 auto;
 }