@expressivecss/expressive 0.1.0 → 0.3.0

package/src/sass/components/_modal.scss

@@ -13,7 +13,7 @@
 //   body         body-medium / on-surface-variant
 //   icon         24dp, on-secondary
 //   actions      end-aligned, 8dp gap
-//   scrim        32%
+//   scrim        32% + 12px blur
 //   padding      24dp
 
 dialog,
@@ -22,6 +22,8 @@ dialog,
   --md-comp-basic-dialog-container-shape: 28px;
   --md-comp-basic-dialog-container-min-width: 280px;
   --md-comp-basic-dialog-container-max-width: 560px;
+  --md-comp-basic-dialog-sheet-width: 400px;
+  --md-comp-basic-dialog-scrim-blur: 12px;
 
   box-sizing: border-box;
   width: min(var(--md-comp-basic-dialog-container-max-width), calc(100% - 48px));
@@ -38,14 +40,23 @@ dialog,
 
   &::backdrop {
     background-color: color-mix(in oklab, var(--md-sys-color-scrim) 32%, transparent);
+    backdrop-filter: blur(var(--md-comp-basic-dialog-scrim-blur));
   }
 }
 
+// showModal() puts the dialog in the top layer but does not lock the
+// document scroller. :modal is the modal-only match — a modeless
+// dialog.show() must not freeze the page.
+html:has(dialog:modal) {
+  overflow: hidden;
+}
+
 dialog[open],
 .modal[open] {
   display: flex;
   flex-direction: column;
   overflow: hidden;
+  overscroll-behavior: contain;
 }
 
 // Optional leading icon (M3 basic dialog).
@@ -84,6 +95,7 @@ dialog > div,
   flex: 1 1 auto;
   min-height: 0;
   overflow: auto;
+  overscroll-behavior: contain;
   margin: 0;
   padding: 0 24px 16px;
   font-family: var(--md-sys-typescale-body-medium-font-family-name);
@@ -119,9 +131,13 @@ dialog > :is(form, nav):last-child,
 }
 
 // Full-screen (M3). Takes the viewport; no corners.
+// UA `dialog:modal` sets max-width: calc(100% - 2em - 6px). Without
+// clearing it, width: 100% is capped and a strip of scrim shows on the
+// right. Bottom sheet already overrides this.
 dialog.max,
 .modal.max {
   width: 100%;
+  max-width: none;
   height: 100%;
   min-width: 0;
   max-height: none;
@@ -129,8 +145,9 @@ dialog.max,
   border-radius: 0;
 }
 
-// Bottom sheet. M3 sheets are a sibling component; this keeps the existing
-// Expressive helper and BeerCSS's `bottom` name.
+// Sheets. Docked to one edge; the inner corners keep the dialog shape,
+// the edge against the viewport is square. `left` / `right` also float
+// via the helper utilities (`!important`), so sheets reset that.
 dialog.bottom,
 dialog.bottom-sheet,
 .modal.bottom-sheet {
@@ -142,3 +159,50 @@ dialog.bottom-sheet,
   border-radius: var(--md-comp-basic-dialog-container-shape)
     var(--md-comp-basic-dialog-container-shape) 0 0;
 }
+
+dialog.top,
+dialog.top-sheet,
+.modal.top-sheet {
+  width: 100%;
+  min-width: 0;
+  max-width: none;
+  max-height: 50%;
+  margin: 0 0 auto;
+  border-radius: 0 0 var(--md-comp-basic-dialog-container-shape)
+    var(--md-comp-basic-dialog-container-shape);
+}
+
+dialog.left,
+dialog.left-sheet,
+.modal.left-sheet,
+dialog.right,
+dialog.right-sheet,
+.modal.right-sheet {
+  float: none !important;
+  width: min(var(--md-comp-basic-dialog-sheet-width), 85%);
+  max-width: none;
+  height: auto;
+  max-height: none;
+  min-width: 0;
+  min-height: 0;
+  margin: 0;
+  inset-block: 0;
+}
+
+dialog.left,
+dialog.left-sheet,
+.modal.left-sheet {
+  inset-inline-start: 0;
+  inset-inline-end: auto;
+  border-radius: 0 var(--md-comp-basic-dialog-container-shape)
+    var(--md-comp-basic-dialog-container-shape) 0;
+}
+
+dialog.right,
+dialog.right-sheet,
+.modal.right-sheet {
+  inset-inline-start: auto;
+  inset-inline-end: 0;
+  border-radius: var(--md-comp-basic-dialog-container-shape) 0 0
+    var(--md-comp-basic-dialog-container-shape);
+}

package/src/sass/components/_navbar.scss

@@ -122,6 +122,21 @@ header:has(> nav) {
     }
   }
 
+  // Breadcrumb trail. Layout only — colors stay on the breadcrumb tokens
+  // (which this header remaps to inherit). Do not treat the crumbs as
+  // destinations.
+  > nav:not(.tabs) > ol {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    align-self: center;
+    flex: 1 1 auto;
+    min-width: 0;
+    list-style: none;
+    margin: 0;
+    padding-inline: 12px;
+  }
+
   > nav:not(.tabs) > form {
     display: flex;
     flex: 1 1 auto;

package/src/sass/components/_pagination.scss

@@ -1,46 +1,152 @@
 @use "../abstracts" as *;
 
+// Pagination. Anatomy is the HTML: a nav.pagination whose child is an
+// <ol> (or <ul>) of page links. The current page is aria-current="page".
+// A bare <ul class="pagination"> stays as an alias.
+//
+// .active / .disabled / .prev / .next / .pages still work.
+// .nowrap (or the old li.pages nest) scrolls a long run instead of wrapping.
+//
+// Tokens (defaults match the original compact pager):
+//   --md-comp-pagination-size                 2rem
+//   --md-comp-pagination-shape                2rem (stadium / disc)
+//   --md-comp-pagination-gap                  0
+//   --md-comp-pagination-padding              0.66rem
+//   --md-comp-pagination-icon-size            2rem
+//   --md-comp-pagination-selected-color       primary
+//   --md-comp-pagination-selected-on-color    on-primary
+//
+// Nest descendants inside this block.
+
 .pagination {
+  --md-comp-pagination-size: 2rem;
+  --md-comp-pagination-shape: 2rem;
+  --md-comp-pagination-gap: 0px;
+  --md-comp-pagination-padding: 0.66rem;
+  --md-comp-pagination-icon-size: 2rem;
+  --md-comp-pagination-selected-color: var(--md-sys-color-primary);
+  --md-comp-pagination-selected-on-color: var(--md-sys-color-on-primary);
+
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+  color: var(--md-sys-color-on-surface);
+  font-size: 1.2rem;
+  line-height: 1;
+
+  &,
+  > :is(ul, ol) {
+    display: flex;
+    flex-wrap: wrap;
+    align-items: center;
+    gap: var(--md-comp-pagination-gap);
+    list-style: none;
+    margin: 0;
+    padding: 0;
+  }
+
+  &.nowrap,
+  &.nowrap > :is(ul, ol) {
+    flex-wrap: nowrap;
+    min-width: 0;
+    overflow-x: auto;
+    scrollbar-width: none;
+
+    &::-webkit-scrollbar {
+      display: none;
+    }
+  }
+
   li {
-    display: inline-block;
-    vertical-align: top;
+    display: flex;
+    flex-shrink: 0;
+    margin: 0;
+    padding: 0;
+  }
 
-    a {
-      @include btn($height: 2rem, $padding-left: .66rem, $padding-right: .66rem, $font-size: 1.2rem);
+  :is(a, button) {
+    box-sizing: border-box;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    gap: 4px;
+    min-width: var(--md-comp-pagination-size);
+    height: var(--md-comp-pagination-size);
+    padding: 0 var(--md-comp-pagination-padding);
+    border: 0;
+    border-radius: var(--md-comp-pagination-shape);
+    background: transparent;
+    color: inherit;
+    font: inherit;
+    line-height: inherit;
+    text-decoration: none;
+    cursor: pointer;
+    -webkit-tap-highlight-color: transparent;
+    transition: background-color 0.2s ease-out;
+    @include focus-visible;
+
+    &:hover {
+      background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
     }
 
-    &.active a {
-      @include btn-filled;
+    &:has(> span) {
+      width: auto;
     }
 
-    &.disabled a {
-      @include btn-disabled;
+    > i {
+      font-size: var(--md-comp-pagination-icon-size);
+      width: var(--md-comp-pagination-icon-size);
+      height: var(--md-comp-pagination-icon-size);
+      line-height: 1;
     }
+  }
 
-    i {
-      font-size: 2rem;
+  :is(a, button)[aria-current="page"],
+  .active > :is(a, button),
+  li:has(> [aria-current="page"]) > :is(a, button) {
+    background-color: var(--md-comp-pagination-selected-color);
+    color: var(--md-comp-pagination-selected-on-color);
+
+    &:hover {
+      background-color: color-mix(
+        in oklab,
+        var(--md-comp-pagination-selected-on-color) 8%,
+        var(--md-comp-pagination-selected-color)
+      );
     }
   }
 
-  li.pages ul li {
-    display: inline-block;
-    float: none;
+  :is(a, button)[aria-disabled="true"],
+  .disabled > :is(a, button) {
+    color: color-mix(in oklab, var(--md-sys-color-on-surface) 38%, transparent);
+    background-color: transparent;
+    pointer-events: none;
+    cursor: default;
   }
-}
 
-@include bp-down("large") {
-  .pagination {
-    width: 100%;
+  li > span {
+    box-sizing: border-box;
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: var(--md-comp-pagination-size);
+    height: var(--md-comp-pagination-size);
+    color: var(--md-sys-color-on-surface-variant);
+  }
 
-    li.prev,
-    li.next {
-      width: 10%;
-    }
+  // Old nested-pages markup. Scroll, do not clip to 80%.
+  .pages {
+    min-width: 0;
 
-    li.pages {
-      width: 80%;
-      overflow: hidden;
-      white-space: nowrap;
+    > :is(ul, ol) {
+      display: flex;
+      flex-wrap: inherit;
+      align-items: center;
+      gap: var(--md-comp-pagination-gap);
+      list-style: none;
+      min-width: 0;
+      margin: 0;
+      padding: 0;
     }
   }
 }

package/src/sass/components/_parallax.scss

@@ -1,29 +1,125 @@
 @use "../abstracts" as *;
 
-// Paired with components/parallax.ts, which positions the image on scroll.
+// Parallax. Anatomy is the HTML: a .parallax (or <figure class="parallax">)
+// clips an <img>, <picture>, or <video>. A heading / <p> / <figcaption> is
+// the overlay. .parallax-container is the old wrapper and still works.
+//
+// Motion is CSS. A named view timeline on the clip drives the image; without
+// animation-timeline the image is just object-fit: cover. JS does not scroll.
+//
+// Tokens:
+//   --md-comp-parallax-height   visible window (500px)
+//   --md-comp-parallax-travel   how far the image moves (64px)
+//   --md-comp-parallax-shape    12px, same as media / lightbox / slider
 
+.parallax,
 .parallax-container {
+  --md-comp-parallax-height: 500px;
+  --md-comp-parallax-travel: 120px;
+  --md-comp-parallax-shape: 12px;
+
   position: relative;
+  isolation: isolate;
   overflow: hidden;
-  height: 500px;
-
-  .parallax {
-    position: absolute;
-    top: 0;
-    left: 0;
-    right: 0;
-    bottom: 0;
-    z-index: -1;
-
-    img {
-      opacity: 0;
-      position: absolute;
-      left: 50%;
-      bottom: 0;
-      min-width: 100%;
-      min-height: 100%;
-      transform: translate3d(0, 0, 0);
-      transform: translateX(-50%);
+  box-sizing: border-box;
+  height: var(--md-comp-parallax-height);
+  margin: 0;
+  border-radius: var(--md-comp-parallax-shape);
+  view-timeline-name: --parallax;
+  view-timeline-axis: block;
+}
+
+// Old markup: container > .parallax > img. The outer box is the clip;
+// the inner .parallax is just a fill, not a second 500px window.
+.parallax-container > .parallax {
+  position: absolute;
+  inset: 0;
+  height: auto;
+  margin: 0;
+  border-radius: 0;
+  overflow: visible;
+  view-timeline-name: none;
+}
+
+.parallax > :is(img, video),
+.parallax > picture,
+.parallax-container .parallax > :is(img, video),
+.parallax-container .parallax > picture {
+  position: absolute;
+  inset: 0;
+  display: block;
+  width: 100%;
+  height: 100%;
+  border: 0;
+}
+
+.parallax > picture img,
+.parallax-container .parallax > picture img {
+  display: block;
+  width: 100%;
+  height: 100%;
+  border: 0;
+}
+
+.parallax > :is(img, video),
+.parallax > picture img,
+.parallax-container .parallax > :is(img, video),
+.parallax-container .parallax > picture img {
+  object-fit: cover;
+  object-position: center;
+}
+
+// Overlay. A heading or <p> is a centered hero; figcaption docks to the
+// bottom on a translucent surface, same idea as a card figure.
+.parallax > :is(h1, h2, h3, h4, h5, h6),
+.parallax > p {
+  position: absolute;
+  inset: 0;
+  z-index: 1;
+  display: grid;
+  place-items: center;
+  margin: 0;
+  padding: 24px;
+  color: var(--md-sys-color-on-surface);
+  text-align: center;
+}
+
+.parallax > figcaption {
+  position: absolute;
+  inset: auto 0 0;
+  z-index: 1;
+  margin: 0;
+  padding: 16px 24px;
+  color: var(--md-sys-color-on-surface);
+  background: color-mix(in oklab, var(--md-sys-color-surface) 72%, transparent);
+}
+
+// Full-bleed hero. Meets the viewport edges; no corners.
+.parallax.max,
+.parallax-container.max {
+  height: 100vh;
+  height: 100dvh;
+  border-radius: 0;
+}
+
+// Progressive enhancement: without animation-timeline the image stays a
+// static cover. Named timeline is the clip, not the (taller) image.
+@supports (animation-timeline: view()) {
+  @media (prefers-reduced-motion: no-preference) {
+    .parallax > :is(img, video),
+    .parallax > picture img,
+    .parallax-container .parallax > :is(img, video),
+    .parallax-container .parallax > picture img {
+      height: calc(100% + 2 * var(--md-comp-parallax-travel));
+      inset: calc(-1 * var(--md-comp-parallax-travel)) 0 auto;
+      animation: parallax-shift linear both;
+      animation-timeline: --parallax;
+      animation-range: cover;
     }
   }
 }
+
+@keyframes parallax-shift {
+  from { transform: translateY(var(--md-comp-parallax-travel)); }
+  to { transform: translateY(calc(-1 * var(--md-comp-parallax-travel))); }
+}

package/src/sass/components/_sidenav.scss

@@ -97,8 +97,7 @@
     }
 
     /* TODO: Use special class in future like "mw-icon" */
-    & > .material-icons, & > .material-symbols-outlined,
-    & > .material-symbols-rounded, & > .material-symbols-sharp {
+    & > :is(.material-symbols, .material-symbols-outlined, .material-symbols-rounded, .material-symbols-sharp, .material-icons) {
       display: inline-flex;
       vertical-align: middle;
       margin-right: 12px;
@@ -214,7 +213,8 @@
   }
 }
 
-.sidenav .collapsible-body {
+.sidenav .collapsible-body,
+.sidenav details::details-content {
   padding: 0;
 }
 
@@ -234,13 +234,18 @@
 .sidenav,
 .sidenav.sidenav-fixed {
   .collapsible {
+    overflow: visible;
     border: none;
+    border-radius: 0;
+    background: transparent;
     box-shadow: none;
   }
-  .collapsible-header {
+  .collapsible-header,
+  summary {
     border: none;
   }
-  .collapsible-body {
+  .collapsible-body,
+  details::details-content {
     border: none;
   }
 }

package/src/sass/components/_slider.scss

@@ -4,6 +4,14 @@
   position: relative;
   height: 400px;
   width: 100%;
+  // Same 12px as .responsive-img / .lightboxed. Applied to the slide
+  // stack, not the slider: init() adds 40px under the slides for the
+  // indicators, so a radius on the outer box never meets the photo.
+  // Fullscreen stays square so it can meet the viewport edges.
+  &:not(.fullscreen) .slides,
+  &:not(.fullscreen) .slides li {
+    border-radius: 12px;
+  }
 
   // Fullscreen slider
   &.fullscreen {