@expressivecss/expressive 0.4.0 → 0.6.0

package/src/sass/components/_panes.scss

@@ -0,0 +1,294 @@
+@use "../abstracts" as *;
+
+// Material 3 Canonical Pane Layouts.
+//
+// Anatomy is the HTML. A container (`.panes` or `.pane-layout` or `.list-detail`)
+// contains two (or three) `.pane` children.
+//
+// Canonical Layouts:
+//   1. List-Detail (.list-detail, .panes.list-detail):
+//      - Compact (< 840px / < 601px): Single pane visible at a time.
+//      - Expanded (>= 840px): 360dp list pane + 1fr detail pane.
+//   2. Supporting Pane (.supporting-pane-layout, .panes.supporting):
+//      - 1fr primary pane + 360-400dp supporting pane (on trailing or leading side).
+//   3. Equal / Proportional (.panes.equal, .panes.proportional):
+//      - 1fr 1fr side-by-side.
+//
+// Appearances:
+//   - Coplanar (default): Full-bleed surfaces with a 1px outline-variant divider.
+//   - Separated / Floating (.separated, .floating): 16dp/24dp rounded surfaces
+//     with surface-container-low and a 24dp gap.
+//
+// Tokens follow https://m3.material.io/foundations/adaptive-design/canonical-layouts
+//   --md-comp-pane-gap                       24px
+//   --md-comp-pane-divider-color             outline-variant
+//   --md-comp-pane-container-color           surface
+//   --md-comp-pane-container-shape           0px
+//   --md-comp-pane-list-width                360px
+//   --md-comp-pane-supporting-width          360px
+//   --md-comp-pane-primary-min-width         360px
+
+.panes,
+.pane-layout,
+.list-detail,
+.supporting-pane-layout {
+  --md-comp-pane-gap: 24px;
+  --md-comp-pane-divider-color: var(--md-sys-color-outline-variant);
+  --md-comp-pane-container-color: var(--md-sys-color-surface);
+  --md-comp-pane-container-shape: 0px;
+  --md-comp-pane-list-width: 360px;
+  --md-comp-pane-supporting-width: 360px;
+  --md-comp-pane-primary-min-width: 360px;
+
+  box-sizing: border-box;
+  display: grid;
+  width: 100%;
+  height: 100%;
+  min-height: 0;
+  margin: 0;
+  padding: 0;
+  container-type: inline-size;
+  background-color: var(--md-comp-pane-container-color);
+  color: var(--md-sys-color-on-surface);
+
+  // Default (Single-Pane on compact screens < 840px / < 601px)
+  grid-template-columns: 1fr;
+  gap: 0;
+
+  // Panes in compact mode: list/primary visible by default, detail/supporting hidden
+  // unless marked .active
+  > :is(.pane, .list-pane, .primary-pane, .detail-pane, .supporting-pane) {
+    display: none;
+    min-width: 0;
+    min-height: 0;
+    overflow: hidden;
+
+    &.active {
+      display: flex;
+    }
+  }
+
+  &:not(:has(> :is(.pane, .list-pane, .primary-pane, .detail-pane, .supporting-pane).active)) {
+    > :is(.pane, .list-pane, .primary-pane, .detail-pane, .supporting-pane):first-child {
+      display: flex;
+    }
+  }
+
+  // Expanded Viewports: Dual-pane side-by-side (via container query or breakpoint)
+  @media (width >= 840px) {
+    grid-template-columns: var(--md-comp-pane-list-width) 1fr;
+    gap: 0;
+
+    > :is(.pane, .list-pane, .primary-pane, .detail-pane, .supporting-pane) {
+      display: flex !important;
+    }
+  }
+
+  @container (min-width: 840px) {
+    grid-template-columns: var(--md-comp-pane-list-width) 1fr;
+    gap: 0;
+
+    > :is(.pane, .list-pane, .primary-pane, .detail-pane, .supporting-pane) {
+      display: flex !important;
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Canonical Variants
+// ---------------------------------------------------------------------------
+
+// 1. Supporting Pane Layout
+.supporting-pane-layout,
+.panes.supporting {
+  @media (width >= 840px) {
+    grid-template-columns: 1fr var(--md-comp-pane-supporting-width);
+  }
+
+  @container (min-width: 840px) {
+    grid-template-columns: 1fr var(--md-comp-pane-supporting-width);
+  }
+
+  // Leading supporting pane (.start / .left)
+  &.start,
+  &.left {
+    @media (width >= 840px) {
+      grid-template-columns: var(--md-comp-pane-supporting-width) 1fr;
+    }
+
+    @container (min-width: 840px) {
+      grid-template-columns: var(--md-comp-pane-supporting-width) 1fr;
+    }
+  }
+}
+
+// 2. Equal / Proportional Pane Layout
+.panes.equal,
+.pane-layout.equal {
+  @media (width >= 840px) {
+    grid-template-columns: 1fr 1fr;
+  }
+
+  @container (min-width: 840px) {
+    grid-template-columns: 1fr 1fr;
+  }
+}
+
+// 3. Three-Pane Layout (List + Primary Focus + Supporting)
+.panes.three-pane,
+.pane-layout.three-pane {
+  @media (width >= 1200px) {
+    grid-template-columns: var(--md-comp-pane-list-width) 1fr var(--md-comp-pane-supporting-width);
+  }
+
+  @container (min-width: 1200px) {
+    grid-template-columns: var(--md-comp-pane-list-width) 1fr var(--md-comp-pane-supporting-width);
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Separated / Floating Appearance
+// ---------------------------------------------------------------------------
+.panes.separated,
+.panes.floating,
+.pane-layout.separated,
+.pane-layout.floating {
+  --md-comp-pane-container-shape: 16px;
+  --md-comp-pane-container-color: transparent;
+  gap: var(--md-comp-pane-gap);
+  padding: var(--md-comp-pane-gap);
+
+  > :is(.pane, .list-pane, .primary-pane, .detail-pane, .supporting-pane) {
+    border: none;
+    border-radius: var(--md-comp-pane-container-shape);
+    background-color: var(--md-sys-color-surface-container-low);
+    @include z-depth("0");
+
+    &.elevated {
+      background-color: var(--md-sys-color-surface-container-low);
+      @include z-depth("1");
+    }
+
+    &.outlined {
+      background-color: var(--md-sys-color-surface);
+      border: 1px solid var(--md-comp-pane-divider-color);
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Coplanar / Docked Dividers (Default)
+// ---------------------------------------------------------------------------
+:is(.panes, .pane-layout, .list-detail, .supporting-pane-layout):not(.separated, .floating) {
+  > :is(.pane, .list-pane, .primary-pane, .detail-pane, .supporting-pane):not(:last-child) {
+    @media (width >= 840px) {
+      border-inline-end: 1px solid var(--md-comp-pane-divider-color);
+    }
+
+    @container (min-width: 840px) {
+      border-inline-end: 1px solid var(--md-comp-pane-divider-color);
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Pane Internal Anatomy
+// ---------------------------------------------------------------------------
+.pane,
+.list-pane,
+.primary-pane,
+.detail-pane,
+.supporting-pane {
+  box-sizing: border-box;
+  flex-direction: column;
+  position: relative;
+  width: 100%;
+  height: 100%;
+  min-width: 0;
+  min-height: 0;
+
+  // Header Bar (64dp height, Title Large, action icons)
+  > :is(header, .pane-header) {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+    flex: 0 0 auto;
+    box-sizing: border-box;
+    min-height: 64px;
+    margin: 0;
+    padding: 8px 16px;
+    background: none;
+
+    > :is(h1, h2, h3, h4, h5, h6, .pane-title) {
+      flex: 1 1 auto;
+      min-width: 0;
+      margin: 0;
+      padding: 0;
+      color: var(--md-sys-color-on-surface);
+      @include typescale("title-large");
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+    }
+
+    > :is(button, a.button):has(> i:only-child) {
+      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;
+      }
+    }
+  }
+
+  // Scrollable Content Body
+  > :is(main, .pane-content, .pane-body, div:not(.pane-header, .pane-footer)) {
+    flex: 1 1 auto;
+    min-height: 0;
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    padding: 16px 24px;
+  }
+
+  // Direct list inside pane (fills list seamlessly without padding clip)
+  > .list {
+    flex: 1 1 auto;
+    min-height: 0;
+    overflow-y: auto;
+    overscroll-behavior: contain;
+    margin: 0;
+  }
+
+  // Footer / Action Bar
+  > :is(footer, .pane-footer, nav:last-child) {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    flex: 0 0 auto;
+    box-sizing: border-box;
+    min-height: 56px;
+    padding: 8px 16px;
+    border-block-start: 1px solid var(--md-comp-pane-divider-color);
+  }
+}

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;
+  }
+}

package/src/sass/components/_sidenav.scss

@@ -8,6 +8,10 @@
 // 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.
@@ -51,7 +55,7 @@ dialog.sidenav {
   inset: 0 auto 0 0;
   overflow: hidden;
   color: var(--md-sys-color-on-surface);
-  background-color: var(--md-sys-color-surface);
+  background-color: var(--md-sys-color-surface-container-low);
   outline: none;
   @include z-depth("1");
 
@@ -143,7 +147,7 @@ dialog.sidenav {
   overscroll-behavior: contain;
   user-select: none;
   color: var(--md-sys-color-on-surface);
-  background-color: var(--md-sys-color-surface);
+  background-color: var(--md-sys-color-surface-container-low);
   transform: translateX(-100%);
   @include z-depth("1");
 
@@ -152,10 +156,6 @@ dialog.sidenav {
     transform: translateX(100%);
   }
 
-  .collapsible {
-    margin: 0;
-  }
-
   li {
     list-style: none;
     display: grid;
@@ -163,14 +163,11 @@ dialog.sidenav {
   }
 
   li.active > a:not(.button, .circle, .extra) {
-    background-color: color-mix(in oklab, var(--md-sys-color-secondary) 10%, transparent);
+    background-color: var(--md-sys-color-secondary-container);
+    color: var(--md-sys-color-on-secondary-container);
   }
 
-  details > div > ul {
-    padding-left: 10px;
-  }
-
-  li > a {
+  :is(li > a, summary) {
     display: flex;
     align-items: center;
     margin: 0 12px;
@@ -181,22 +178,6 @@ dialog.sidenav {
     font-size: var(--md-comp-nav-drawer-font-size);
     font-weight: 500;
 
-    &:not(.button, .circle, .extra) {
-      color: var(--md-sys-color-on-secondary-container);
-
-      &:hover {
-        background-color: color-mix(in oklab, var(--md-sys-color-on-surface) 8%, transparent);
-      }
-
-      @include focus-visible;
-    }
-
-    &.button,
-    &.circle,
-    &.extra {
-      margin: 10px 15px;
-    }
-
     > :is(
       .material-symbols,
       .material-symbols-outlined,
@@ -210,6 +191,75 @@ dialog.sidenav {
     }
   }
 
+  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);
+    }
+
+    @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(--md-comp-nav-drawer-padding) * 0.5) 0 0;
   }
@@ -333,25 +383,4 @@ dialog.sidenav-overlay:modal > .sidenav {
   }
 }
 
-.sidenav details > :not(summary) {
-  padding: 0;
-}
 
-.sidenav,
-.sidenav.sidenav-fixed {
-  .collapsible {
-    overflow: visible;
-    border: none;
-    border-radius: 0;
-    background: transparent;
-    box-shadow: none;
-  }
-
-  summary {
-    border: none;
-  }
-
-  details > :not(summary) {
-    border: none;
-  }
-}