@expressivecss/expressive 0.2.0 → 0.3.0

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 {

package/src/sass/components/_tapTarget.scss

@@ -1,104 +1,191 @@
 @use "../abstracts" as *;
 
+// Tap target (Feature Discovery). A circular spotlight centered on an
+// origin. JS writes --md-comp-tap-target-x/y/origin-size and data-edge;
+// this file does the rest.
+//
+// Tokens:
+//   --md-comp-tap-target-size           480px
+//   --md-comp-tap-target-z              1000
+//   --md-comp-tap-target-container-color
+//   --md-comp-tap-target-supporting-color
+//   --md-comp-tap-target-duration       300ms
+//   --md-comp-tap-target-easing         soft ease-in-out
+//
+// .feature-discovery is an alias of .tap-target.
+
 .tap-target-wrapper {
-  width: 800px;
-  height: 800px;
+  --md-comp-tap-target-size: 480px;
+  --md-comp-tap-target-z: 1000;
+  --md-comp-tap-target-container-color: var(--md-sys-color-primary-container);
+  --md-comp-tap-target-supporting-color: var(--md-sys-color-on-primary-container);
+  --md-comp-tap-target-duration: 300ms;
+  --md-comp-tap-target-easing: cubic-bezier(0.65, 0, 0.35, 1);
+  --md-comp-tap-target-x: 50%;
+  --md-comp-tap-target-y: 50%;
+  --md-comp-tap-target-origin-size: 56px;
+
+  box-sizing: border-box;
   position: fixed;
-  z-index: 1000;
+  inset: auto;
+  left: var(--md-comp-tap-target-x);
+  top: var(--md-comp-tap-target-y);
+  translate: -50% -50%;
+  width: var(--md-comp-tap-target-size);
+  height: var(--md-comp-tap-target-size);
+  margin: 0;
+  padding: 0;
+  overflow: visible;
+  border: 0;
+  background: transparent;
+  color: var(--md-comp-tap-target-supporting-color);
   visibility: hidden;
-  transition: visibility 0s .3s;
+  pointer-events: none;
+  z-index: var(--md-comp-tap-target-z);
+  transition:
+    visibility 0s var(--md-comp-tap-target-duration),
+    overlay var(--md-comp-tap-target-duration) allow-discrete,
+    display var(--md-comp-tap-target-duration) allow-discrete;
 }
 
-.tap-target-wrapper.open {
+.tap-target-wrapper:is(.open, :popover-open) {
   visibility: visible;
-  transition: visibility 0s;
+  pointer-events: none;
+  transition-delay: 0s;
 
-  .tap-target {
+  .tap-target,
+  .feature-discovery {
     transform: scale(1);
-    opacity: .95;
-    transition:
-      transform .3s cubic-bezier(.42,0,.58,1),
-      opacity .3s cubic-bezier(.42,0,.58,1);
+    opacity: 1;
   }
 
   .tap-target-wave::before {
     transform: scale(1);
   }
+
   .tap-target-wave::after {
     visibility: visible;
     animation: pulse-animation 1s cubic-bezier(0.24, 0, 0.38, 1) infinite;
-    transition:
-      opacity .3s,
-      transform .3s,
-      visibility 0s 1s;
   }
 }
 
-.tap-target {
+.tap-target,
+.feature-discovery {
   position: absolute;
-  font-size: 1rem;
-  border-radius: 50%;
-  background-color: var(--md-sys-color-primary-container);
-  color: var(--md-sys-color-primary);
-  box-shadow: 0 20px 20px 0 rgba(0, 0, 0, 0.14), 0 10px 50px 0 rgba(0, 0, 0, 0.12), 0 30px 10px -20px rgba(0, 0, 0, 0.2);
+  inset: 0;
+  display: grid;
+  box-sizing: border-box;
   width: 100%;
   height: 100%;
+  overflow: hidden;
+  border-radius: 50%;
+  background-color: var(--md-comp-tap-target-container-color);
+  color: var(--md-comp-tap-target-supporting-color);
   opacity: 0;
   transform: scale(0);
-  transition: transform .3s cubic-bezier(.42, 0, .58, 1),
-  opacity .3s cubic-bezier(.42, 0, .58, 1);
+  transition:
+    transform var(--md-comp-tap-target-duration) var(--md-comp-tap-target-easing),
+    opacity var(--md-comp-tap-target-duration) var(--md-comp-tap-target-easing);
+  @include z-depth("3");
+  @include typescale("body-medium");
 }
 
 .tap-target-content {
   position: relative;
-  display: table-cell;
+  z-index: 1;
+  display: grid;
+  align-content: start;
+  gap: 8px;
+  box-sizing: border-box;
+  max-width: min(18rem, 52%);
+  padding: calc(var(--md-comp-tap-target-origin-size) * 0.5 + 20px);
+  pointer-events: auto;
+
+  > :is(h1, h2, h3, h4, h5, h6) {
+    margin: 0;
+    color: inherit;
+    @include typescale("title-medium");
+  }
+
+  > p {
+    margin: 0;
+    color: inherit;
+  }
+}
+
+.tap-target-wrapper[data-edge^="top"] .tap-target-content {
+  align-self: end;
+}
+
+.tap-target-wrapper[data-edge^="bottom"] .tap-target-content {
+  align-self: start;
+}
+
+.tap-target-wrapper[data-edge$="left"] .tap-target-content {
+  justify-self: end;
+}
+
+.tap-target-wrapper[data-edge$="right"] .tap-target-content {
+  justify-self: start;
+}
+
+.tap-target-wrapper[data-edge$="center"] .tap-target-content {
+  justify-self: center;
+  max-width: min(22rem, 80%);
+  text-align: center;
 }
 
 .tap-target-wave {
   position: absolute;
+  top: 50%;
+  left: 50%;
+  z-index: 0;
+  width: calc(var(--md-comp-tap-target-origin-size) * 2);
+  height: calc(var(--md-comp-tap-target-origin-size) * 2);
+  translate: -50% -50%;
   border-radius: 50%;
-  z-index: 10001;
+  pointer-events: none;
 
   &::before,
   &::after {
-    content: '';
-    display: block;
+    content: "";
     position: absolute;
-    width: 100%;
-    height: 100%;
+    inset: 0;
+    display: block;
     border-radius: 50%;
-    background-color: var(--md-sys-color-surface)
+    background-color: var(--md-sys-color-surface);
   }
+
   &::before {
     transform: scale(0);
-    transition: transform .3s;
+    transition: transform var(--md-comp-tap-target-duration)
+      var(--md-comp-tap-target-easing);
   }
+
   &::after {
     visibility: hidden;
-    transition:
-      opacity .3s,
-      transform .3s,
-      visibility 0s;
     z-index: -1;
   }
 }
 
+// Raised only on the non-popover path so a static origin stays above the
+// circle. Never set position here — a FAB may already be fixed.
 .tap-target-origin {
-  top: 50%;
-  left: 50%;
-  z-index: 10002;
-  position: absolute !important;
-  transform: translate(-50%,-50%);
+  z-index: calc(var(--md-comp-tap-target-z, 1000) + 2);
+}
 
-  &:not(.btn),
-  &:not(.btn):hover {
-    background: none;
+@include bp-down("small") {
+  .tap-target-wrapper {
+    --md-comp-tap-target-size: 360px;
   }
 }
 
-@include bp-down("small") {
-  .tap-target, .tap-target-wrapper {
-    width: 600px;
-    height: 600px;
+@media (prefers-reduced-motion: reduce) {
+  .tap-target-wrapper {
+    --md-comp-tap-target-duration: 0s;
+  }
+
+  .tap-target-wrapper:is(.open, :popover-open) .tap-target-wave::after {
+    animation: none;
   }
 }