@expressivecss/expressive 0.3.0 → 0.5.0

package/src/sass/components/_sidenav.scss

@@ -1,129 +1,284 @@
 @use "../abstracts" as *;
 
-.sidenav {
-  --sidenav-width: 300px;
-  --sidenav-font-size: 14px;
-  --sidenav-padding: 16px;
-  --sidenav-item-height: 48px;
-  --sidenav-line-height: var(--sidenav-item-height);
+// Navigation drawer.
+//
+// Overlay is a modal <dialog> (JS wraps a <ul class="sidenav"> in
+// dialog.sidenav-overlay, or the author writes <dialog class="sidenav">).
+// showModal() puts it on the top layer; ::backdrop is the scrim; Escape
+// and a scrim tap close it. Drag writes --md-comp-nav-drawer-shift;
+// this file does the slide.
+//
+// Nested sections are native <details>/<summary>. Same `name` is an
+// accordion. The summary is a destination row with an expand_more
+// chevron; there is no Collapsible plugin.
+//
+// .sidenav-fixed is a breakpoint, not a JS open(): at `large` the host
+// is display: contents so the list is a docked sidebar. Below that it
+// is the same overlay drawer as any other sidenav.
+//
+// Tokens:
+//   --md-comp-nav-drawer-width          300px
+//   --md-comp-nav-drawer-item-height    48px
+//   --md-comp-nav-drawer-duration       250ms
+//   --md-comp-nav-drawer-easing
+//   --md-comp-nav-drawer-shift          0px   (JS, px from fully open)
+//   --md-comp-nav-drawer-open           1     (JS, 0–1 scrim opacity)
+//   --md-comp-nav-drawer-font-size      14px
+//   --md-comp-nav-drawer-padding        16px
+//   --md-comp-nav-drawer-line-height    item height
 
-  position: fixed;
-  width: var(--sidenav-width);
-  left: 0;
-  top: 0;
+:root {
+  --md-comp-nav-drawer-width: 300px;
+}
+
+dialog.sidenav-overlay,
+dialog.sidenav {
+  --md-comp-nav-drawer-item-height: 48px;
+  --md-comp-nav-drawer-duration: 250ms;
+  --md-comp-nav-drawer-easing: ease;
+  --md-comp-nav-drawer-shift: 0px;
+  --md-comp-nav-drawer-open: 1;
+  --md-comp-nav-drawer-font-size: 14px;
+  --md-comp-nav-drawer-padding: 16px;
+  --md-comp-nav-drawer-line-height: var(--md-comp-nav-drawer-item-height);
+
+  box-sizing: border-box;
+  width: var(--md-comp-nav-drawer-width);
+  min-width: 0;
+  max-width: none;
+  max-height: none;
+  height: 100dvh;
   margin: 0;
-  transform: translateX(-100%);
-  height: 100vh;
   padding: 0;
-  z-index: 999;
-  overflow-y: auto;
-  will-change: transform;
-  backface-visibility: hidden;
-  transform: translateX(-105%); 
-  user-select: none;
-  
-  color: var(--md-sys-color-on-secondary-container);
-  background-color: var(--md-sys-color-surface);
+  border: none;
+  border-radius: 0;
+  inset: 0 auto 0 0;
+  overflow: hidden;
+  color: var(--md-sys-color-on-surface);
+  background-color: var(--md-sys-color-surface-container-low);
+  outline: none;
   @include z-depth("1");
 
-  // Right Align
+  transform: translateX(calc(-100% + var(--md-comp-nav-drawer-shift)));
+  transition:
+    transform var(--md-comp-nav-drawer-duration) var(--md-comp-nav-drawer-easing),
+    display var(--md-comp-nav-drawer-duration) allow-discrete,
+    overlay var(--md-comp-nav-drawer-duration) allow-discrete;
+
+  &:modal {
+    display: flex;
+    flex-direction: column;
+    transform: translateX(var(--md-comp-nav-drawer-shift));
+  }
+
   &.right-aligned {
-    right: 0;
-    transform: translateX(105%);
-    left: auto;
+    inset: 0 0 0 auto;
+    transform: translateX(calc(100% - var(--md-comp-nav-drawer-shift)));
+
+    &:modal {
+      transform: translateX(calc(-1 * var(--md-comp-nav-drawer-shift)));
+    }
+  }
+
+  &.dragging {
+    transition: none;
+  }
+
+  &::backdrop {
+    background-color: color-mix(in oklab, var(--md-sys-color-scrim) 32%, transparent);
+    opacity: var(--md-comp-nav-drawer-open, 1);
+    backdrop-filter: none;
+    transition:
+      opacity var(--md-comp-nav-drawer-duration) var(--md-comp-nav-drawer-easing),
+      display var(--md-comp-nav-drawer-duration) allow-discrete,
+      overlay var(--md-comp-nav-drawer-duration) allow-discrete;
+  }
+}
+
+@starting-style {
+  :is(dialog.sidenav-overlay, dialog.sidenav):modal {
+    transform: translateX(-100%);
+  }
+
+  :is(dialog.sidenav-overlay, dialog.sidenav).right-aligned:modal {
     transform: translateX(100%);
   }
 
-  .collapsible {
-    margin: 0;
+  :is(dialog.sidenav-overlay, dialog.sidenav):modal::backdrop {
+    opacity: 0;
   }
+}
 
-  /* Hover only on top row */
-  /*a:hover {
-    //color: red;
-    //background-color: var(--md-sys-color-on-secondary-container);
-    //md.sys.color.on-secondary-container
-  }*/
-  a:focus {
-    background-color: rgba(0, 0, 0, 0.12);
+@media (prefers-reduced-motion: reduce) {
+  dialog.sidenav-overlay,
+  dialog.sidenav {
+    transition: none;
+
+    &::backdrop {
+      transition: none;
+    }
   }
+}
 
-  li.active > a:not(.collapsible-header):not(.btn):not(.btn-large):not(.btn-small):not(.btn-flat):not(.btn-large):not(.btn-floating)  {
-    //color: var(--md-sys-color-on-secondary-container); //var(--md-sys-color-on-secondary-container);
-    //background-color: var(--md-sys-color-secondary-container);
-    background-color: color-mix(in oklab, var(--md-sys-color-secondary) 10%, transparent);
+// Docked sidebar: the host must not be a box, or it would steal the
+// list's position:fixed. Closed, so it is not :modal and does not
+// lock the page.
+@include bp-up("large") {
+  dialog.sidenav-overlay:has(> .sidenav-fixed):not(:modal) {
+    display: contents;
   }
+}
+
+.sidenav {
+  --md-comp-nav-drawer-item-height: 48px;
+  --md-comp-nav-drawer-font-size: 14px;
+  --md-comp-nav-drawer-padding: 16px;
+  --md-comp-nav-drawer-line-height: var(--md-comp-nav-drawer-item-height);
+
+  box-sizing: border-box;
+  position: fixed;
+  width: var(--md-comp-nav-drawer-width);
+  inset: 0 auto 0 0;
+  margin: 0;
+  padding: 0;
+  height: 100dvh;
+  z-index: 999;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  user-select: none;
+  color: var(--md-sys-color-on-surface);
+  background-color: var(--md-sys-color-surface-container-low);
+  transform: translateX(-100%);
+  @include z-depth("1");
 
-  .collapsible-body > ul { padding-left: 10px; }
+  &.right-aligned {
+    inset: 0 0 0 auto;
+    transform: translateX(100%);
+  }
 
-  li {    
+  li {
     list-style: none;
     display: grid;
     align-content: center;
   }
-  li > a {
-    /* https://stackoverflow.com/questions/5848090/full-width-hover-background-for-nested-lists */
-    //padding-left: calc(100% + var(--sidenav-padding));
-    //margin-left: -100%;
-    margin: 0 12px;
-    padding: 0 var(--sidenav-padding);
-    //padding-left: var(--sidenav-padding);
-    // Truncate too long text
-    /*
-    min-width: 0;
-    white-space: nowrap;
-    overflow: hidden;
-    text-overflow: ellipsis;
-    */
+
+  li.active > a:not(.button, .circle, .extra) {
+    background-color: var(--md-sys-color-secondary-container);
+    color: var(--md-sys-color-on-secondary-container);
+  }
+
+  :is(li > a, summary) {
     display: flex;
-    height: var(--sidenav-item-height);
-    font-size: var(--sidenav-font-size);
-    font-weight: 500;
     align-items: center;
+    margin: 0 12px;
+    padding: 0 var(--md-comp-nav-drawer-padding);
+    height: var(--md-comp-nav-drawer-item-height);
     overflow: hidden;
     border-radius: 100px;
+    font-size: var(--md-comp-nav-drawer-font-size);
+    font-weight: 500;
 
-    &:not(.btn):not(.button):not(.btn-flat):not(.btn-large):not(.btn-floating) {
-      color: var(--md-sys-color-on-secondary-container);
-      &:hover {
-        //color: var(--md-sys-color-on-secondary-container);
-        //md.sys.color.on-secondary-container
-        background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
-      }
+    > :is(
+      .material-symbols,
+      .material-symbols-outlined,
+      .material-symbols-rounded,
+      .material-symbols-sharp,
+      .material-icons
+    ) {
+      display: inline-flex;
+      flex-shrink: 0;
+      margin-right: 12px;
     }
+  }
 
-    &.btn, &.button, &.btn-large, &.btn-flat, &.btn-floating {
-      margin: 10px 15px;
+  li > a:not(.button, .circle, .extra),
+  summary {
+    color: var(--md-sys-color-on-surface-variant);
+
+    &:hover {
+      background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
     }
 
-    /* TODO: Use special class in future like "mw-icon" */
-    & > :is(.material-symbols, .material-symbols-outlined, .material-symbols-rounded, .material-symbols-sharp, .material-icons) {
-      display: inline-flex;
-      vertical-align: middle;
-      margin-right: 12px;
+    @include focus-visible;
+  }
+
+  li > a.button,
+  li > a.circle,
+  li > a.extra {
+    margin: 10px 15px;
+  }
+
+  summary {
+    box-sizing: border-box;
+    border: 0;
+    background: transparent;
+    font: inherit;
+    text-align: start;
+    list-style: none;
+    cursor: pointer;
+    appearance: none;
+
+    &::-webkit-details-marker {
+      display: none;
+    }
+
+    &::marker {
+      content: none;
     }
+
+    &::after {
+      content: "expand_more";
+      flex-shrink: 0;
+      margin-inline-start: auto;
+      font-family: var(--md-icon-font);
+      font-size: 24px;
+      font-style: normal;
+      font-variation-settings:
+        "FILL" var(--md-icon-fill),
+        "wght" var(--md-icon-weight),
+        "GRAD" var(--md-icon-grade),
+        "opsz" var(--md-icon-optical-size);
+      line-height: 1;
+      -webkit-font-smoothing: antialiased;
+      transition: transform var(--md-comp-nav-drawer-duration, 250ms)
+        var(--md-comp-nav-drawer-easing, ease);
+    }
+  }
+
+  details {
+    margin: 0;
+  }
+
+  details[open] > summary::after {
+    transform: rotate(180deg);
+  }
+
+  details > ul {
+    margin: 0;
+    padding: 0;
+    padding-inline-start: 10px;
+    list-style: none;
   }
 
   .divider {
-    margin: calc(var(--sidenav-padding) * 0.5) 0 0 0;
+    margin: calc(var(--md-comp-nav-drawer-padding) * 0.5) 0 0;
   }
 
   .subheader {
     cursor: initial;
     pointer-events: none;
-    color: red;
-    font-size: var(--sidenav-font-size);
+    color: var(--md-sys-color-on-surface-variant);
+    font-size: var(--md-comp-nav-drawer-font-size);
     font-weight: 500;
-    line-height: var(--sidenav-line-height);
+    line-height: var(--md-comp-nav-drawer-line-height);
   }
 
-  // Remove this? is very custom
   .user-view {
     position: relative;
-    padding: calc(var(--sidenav-padding) * 2) calc(var(--sidenav-padding) * 2) 0;
-    margin-bottom: calc(var(--sidenav-padding) * 0.5);
+    padding: calc(var(--md-comp-nav-drawer-padding) * 2) calc(var(--md-comp-nav-drawer-padding) * 2) 0;
+    margin-bottom: calc(var(--md-comp-nav-drawer-padding) * 0.5);
 
-    & > a {
+    > a {
       height: auto;
       padding: 0;
 
@@ -135,14 +290,13 @@
     .background {
       overflow: hidden;
       position: absolute;
-      top: 0;
-      right: 0;
-      bottom: 0;
-      left: 0;
+      inset: 0;
       z-index: -1;
     }
 
-    .circle, .name, .email {
+    .circle,
+    .name,
+    .email {
       display: block;
     }
 
@@ -153,8 +307,8 @@
 
     .name,
     .email {
-      font-size: var(--sidenav-font-size);
-      line-height: calc(var(--sidenav-line-height) * 0.5);
+      font-size: var(--md-comp-nav-drawer-font-size);
+      line-height: calc(var(--md-comp-nav-drawer-line-height) * 0.5);
     }
 
     .name {
@@ -169,83 +323,64 @@
   }
 }
 
-// Touch interaction
-.drag-target {
+// Overlay only: the dialog is the panel, so the list fills it. When the
+// host is `display: contents` (a docked .sidenav-fixed) this must not
+// apply — static positioning would drop the list into the header flow
+// and it would read as part of the app bar.
+dialog.sidenav-overlay:modal > .sidenav {
+  position: static;
+  inset: auto;
+  width: 100%;
   height: 100%;
-  position: fixed;
-  top: 0;
-  left: 0;
-  z-index: 998;
-
-  &.right-aligned {
-    right: 0;
-  }
+  transform: none;
+  box-shadow: none;
+  background-color: transparent;
+  z-index: auto;
 }
 
-// Fixed Sidenav shown
 .sidenav.sidenav-fixed {
-  left: 0;
-  transform: translateX(0);
-  position: fixed;
+  transform: none;
 
   &.right-aligned {
-    right: 0;
-    left: auto;
+    transform: none;
   }
 }
 
-// Fixed Sidenav hide on smaller
 @include bp-down("large") {
-  .sidenav {
-    &.sidenav-fixed {
-      transform: translateX(-105%);
+  // Uninitialized / no-js: keep a fixed drawer off-canvas. Once JS wraps
+  // it, the host's display:none hides the closed drawer and this must
+  // not also hide the list inside an open dialog.
+  .sidenav.sidenav-fixed {
+    transform: translateX(-100%);
 
-      &.right-aligned {
-        transform: translateX(105%);
-      }
-    }
-    > a {
-      padding: 0 var(--sidenav-padding);
-    }
-    .user-view {
-      padding: var(--sidenav-padding) var(--sidenav-padding) 0;
+    &.right-aligned {
+      transform: translateX(100%);
     }
   }
-}
 
-.sidenav .collapsible-body,
-.sidenav details::details-content {
-  padding: 0;
+  .sidenav .user-view {
+    padding: var(--md-comp-nav-drawer-padding) var(--md-comp-nav-drawer-padding) 0;
+  }
 }
 
-.sidenav-overlay {
+.drag-target {
   position: fixed;
-  top: 0;
-  left: 0;
-  right: 0;
-  opacity: 0;
-  height: 120vh;
-  background-color: rgba(0, 0, 0, .5);
-  z-index: 997;
-  display: none;
-}
+  inset: 0 auto 0 0;
+  width: var(--md-comp-nav-drawer-drag-width, 10px);
+  height: 100%;
+  z-index: 998;
+  touch-action: pan-y;
 
-// Sidenav collapsible styling (Taken from Collapsible.scss)
-.sidenav,
-.sidenav.sidenav-fixed {
-  .collapsible {
-    overflow: visible;
-    border: none;
-    border-radius: 0;
-    background: transparent;
-    box-shadow: none;
-  }
-  .collapsible-header,
-  summary {
-    border: none;
+  &.right-aligned {
+    inset: 0 0 0 auto;
   }
-  .collapsible-body,
-  details::details-content {
-    border: none;
+}
+
+@include bp-up("large") {
+  .drag-target[data-fixed] {
+    display: none;
+    pointer-events: none;
   }
 }
+
+

package/src/sass/components/{_toast.scss → _snackbar.scss}

@@ -1,11 +1,11 @@
 @use "../abstracts" as *;
 
-// Snackbars (toasts).
+// Snackbars.
 //
-// Anatomy is the HTML. A .snackbar / .toast is the container. A <p> (or
-// <span>, or loose text) is the supporting text. A trailing <button> is
-// the action; a .circle button is the optional close. An optional leading
-// <i> is an icon. .toast-action stays as an alias on the action control.
+// Anatomy is the HTML. A .snackbar is the container. A <p> (or <span>,
+// or loose text) is the supporting text. A trailing <button> is the
+// action; a .circle button is the optional close. An optional leading
+// <i> is an icon.
 //
 // Tokens follow https://m3.material.io/components/snackbar/specs
 //   container    inverse-surface, 4dp corners, elevation 3, min 48dp
@@ -13,15 +13,18 @@
 //   text         body-medium / inverse-on-surface, two lines max
 //   action       label-large / inverse-primary text button
 //   close        24dp icon, inverse-on-surface
-//   inset        8dp compact, 24dp from start+bottom on larger screens
+//   inset        8dp compact, 24dp from the bottom on larger screens
+//   placement    bottom of the UI; centered from the small breakpoint
 //
-// The constructor always adds both .toast and .snackbar. A static
-// .snackbar is in-flow (docs previews). .active pins it to the viewport.
-// There is no AutoInit and no toast() helper.
+// Snackbars must not interrupt browsing: the container is pointer-events
+// none except on the bar, and the live region is polite. One at a time
+// is a JS concern. The constructor adds .snackbar. A static .snackbar
+// is in-flow (docs previews). .active pins it to the viewport. There
+// is no AutoInit.
 
-$_bar: ":is(.toast, .snackbar)";
+$_bar: ".snackbar";
 
-#toast-container {
+#snackbar-container {
   --md-comp-snackbar-container-margin-leading: 8px;
   --md-comp-snackbar-container-margin-trailing: 8px;
   --md-comp-snackbar-container-margin-bottom: 8px;
@@ -34,10 +37,11 @@ $_bar: ":is(.toast, .snackbar)";
   position: fixed;
   z-index: 10000;
   inset: auto var(--md-comp-snackbar-container-margin-trailing)
-    var(--md-comp-snackbar-container-margin-bottom)
+    max(var(--md-comp-snackbar-container-margin-bottom), env(safe-area-inset-bottom, 0px))
     var(--md-comp-snackbar-container-margin-leading);
   width: auto;
   max-width: calc(100% - var(--md-comp-snackbar-container-margin-leading) - var(--md-comp-snackbar-container-margin-trailing));
+  // The page stays browsable — only the bar itself receives pointer events.
   pointer-events: none;
 
   > * {
@@ -49,26 +53,20 @@ $_bar: ":is(.toast, .snackbar)";
     --md-comp-snackbar-container-margin-trailing: 24px;
     --md-comp-snackbar-container-margin-bottom: 24px;
     --md-comp-snackbar-container-margin-top: 24px;
-    align-items: flex-start;
+    align-items: center;
+    left: 50%;
+    right: auto;
     width: max-content;
     min-width: min(344px, calc(100% - 48px));
     max-width: min(672px, calc(100% - 48px));
+    transform: translateX(-50%);
   }
 
-  // Position helpers on the container, or on a child via :has().
+  // Opt-in: M3 places snackbars at the bottom. `.top` is the exception.
   &:has(> .top),
   &.top {
-    inset: var(--md-comp-snackbar-container-margin-top)
-      var(--md-comp-snackbar-container-margin-trailing)
-      auto
-      var(--md-comp-snackbar-container-margin-leading);
-  }
-
-  &:has(> .center),
-  &.center {
-    left: 50%;
-    right: auto;
-    transform: translateX(-50%);
+    inset-block-start: var(--md-comp-snackbar-container-margin-top);
+    inset-block-end: auto;
   }
 }
 
@@ -128,7 +126,7 @@ $_bar: ":is(.toast, .snackbar)";
   }
 
   // Inline links in the supporting text use the action color.
-  a:not(.button, .toast-action) {
+  a:not(.button) {
     color: var(--md-comp-snackbar-action-label-text-color);
   }
 
@@ -147,8 +145,8 @@ $_bar: ":is(.toast, .snackbar)";
   }
 
   // Text action — inverse-primary, not the filled common-button default.
-  > :is(button, a.button, a.toast-action, .toast-action):not(.circle),
-  > nav > :is(button, a.button, a.toast-action, .toast-action):not(.circle) {
+  > :is(button, a.button):not(.circle),
+  > nav > :is(button, a.button):not(.circle) {
     flex: 0 0 auto;
     height: 40px;
     min-width: 48px;
@@ -216,45 +214,47 @@ $_bar: ":is(.toast, .snackbar)";
   }
 }
 
-// Stacked in-flow previews. JS toasts use the container gap instead.
+// Stacked in-flow previews. JS-created snackbars use the container gap instead.
 #{$_bar} + #{$_bar} {
   margin-top: 8px;
 }
 
-// JS enter animation starts the bar 35px below its rest position.
-#toast-container #{$_bar} {
+#snackbar-container #{$_bar} {
   position: relative;
-  top: 35px;
   margin-top: 0;
 }
 
 // Static overlay. In-flow without this (docs previews). Not AutoInit —
 // add and remove the class yourself, or use the constructor for timing.
+// Default: bottom of the UI, centered from the small breakpoint.
 #{$_bar}.active {
   position: fixed;
   z-index: 10000;
-  inset: auto auto 16px 16px;
+  left: 50%;
+  right: auto;
+  bottom: 24px;
   top: auto;
+  transform: translateX(-50%);
   width: max-content;
-  max-width: min(672px, calc(100% - 32px));
+  max-width: min(672px, calc(100% - 48px));
 
   @include bp-down("small") {
-    inset: auto 8px 8px 8px;
+    left: 8px;
+    right: 8px;
+    bottom: max(8px, env(safe-area-inset-bottom, 0px));
+    transform: none;
     width: auto;
     max-width: none;
   }
 
   &.top {
-    inset: 16px auto auto 16px;
+    top: 24px;
+    bottom: auto;
 
     @include bp-down("small") {
-      inset: 8px 8px auto 8px;
+      top: 8px;
+      left: 8px;
+      right: 8px;
     }
   }
-
-  &.center {
-    left: 50%;
-    right: auto;
-    transform: translateX(-50%);
-  }
 }