@expressivecss/expressive 0.12.0 → 0.14.1

package/src/sass/components/_tree.scss

@@ -0,0 +1,139 @@
+@use "../abstracts" as *;
+
+// Tree. A <ul class="tree"> of nested lists, for file browsers and deep
+// navigation. A branch is an <li> holding a <details>: its <summary> is the
+// row and its nested <ul> the children. A leaf is an <li> holding a link or
+// a span. aria-current marks the selected row.
+//
+// It is a set of disclosures and links, not role="tree": every row is a Tab
+// stop and the browser owns opening a branch. A tree role would promise
+// arrow-key navigation that native disclosures do not provide.
+//
+// Tokens:
+//   --md-comp-tree-row-height                 40px
+//   --md-comp-tree-row-shape                  100px (pill)
+//   --md-comp-tree-guide-color                outline-variant
+//   --md-comp-tree-selected-container-color   secondary-container
+
+$_tree-chevron: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='M12 15.4 6 9.4 7.4 8l4.6 4.6L16.6 8 18 9.4z'/%3E%3C/svg%3E");
+
+.tree {
+  --md-comp-tree-row-height: 40px;
+  --md-comp-tree-row-shape: 100px;
+  --md-comp-tree-guide-color: var(--md-sys-color-outline-variant);
+  --md-comp-tree-selected-container-color: var(--md-sys-color-secondary-container);
+
+  margin: $element-top-margin 0 $element-bottom-margin;
+  padding: 0;
+  list-style: none;
+  color: var(--md-sys-color-on-surface-variant);
+
+  // Each level hangs a guide line from the centre of its parent's chevron
+  // (12px inset + half the 20px chevron) and indents past it.
+  ul {
+    margin: 0;
+    margin-inline-start: 22px;
+    padding: 0;
+    padding-inline-start: 6px;
+    border-inline-start: 1px solid var(--md-comp-tree-guide-color);
+    list-style: none;
+  }
+
+  li {
+    margin: 0;
+  }
+
+  li > :is(a, span),
+  li > details > summary {
+    box-sizing: border-box;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    min-height: var(--md-comp-tree-row-height);
+    padding-inline: 12px 16px;
+    border-radius: var(--md-comp-tree-row-shape);
+    color: inherit;
+    text-decoration: none;
+    @include typescale("label-large");
+
+    > #{$icon} {
+      flex: none;
+      font-size: 20px;
+    }
+  }
+
+  // A leaf lines its text up with a branch's text, after the chevron.
+  li > :is(a, span) {
+    padding-inline-start: calc(12px + 20px + 8px);
+  }
+
+  li > a,
+  li > details > summary {
+    cursor: pointer;
+    @include focus-visible;
+
+    &:hover {
+      background-color: color-mix(
+        in oklab,
+        var(--md-sys-color-on-surface) state-opacity("hover"),
+        transparent
+      );
+    }
+  }
+
+  li > details > summary {
+    list-style: none;
+    user-select: none;
+
+    &::-webkit-details-marker {
+      display: none;
+    }
+
+    // Points to the end edge while closed and down once open.
+    &::before {
+      content: "";
+      flex: none;
+      width: 20px;
+      height: 20px;
+      background-color: currentColor;
+      mask: $_tree-chevron center / 20px no-repeat;
+      transform: rotate(-90deg);
+      transition: transform 150ms ease-out;
+    }
+
+    &:dir(rtl)::before {
+      transform: rotate(90deg);
+    }
+  }
+
+  li > details[open] > summary::before {
+    transform: none;
+  }
+
+  :is(li > a, li > span, li > details > summary)[aria-current]:not([aria-current="false"]) {
+    background-color: var(--md-comp-tree-selected-container-color);
+    color: var(--md-sys-color-on-secondary-container);
+
+    > #{$icon} {
+      --md-icon-fill: 1;
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    li > details > summary::before {
+      transition: none;
+    }
+  }
+
+  @media (forced-colors: active) {
+    li > details > summary::before {
+      forced-color-adjust: none;
+      background-color: CanvasText;
+    }
+
+    [aria-current]:not([aria-current="false"]) {
+      outline: 2px solid Highlight;
+      outline-offset: -2px;
+    }
+  }
+}

package/src/sass/components/forms/_checkboxes.scss

@@ -210,11 +210,16 @@ label:has(> [type="checkbox"]:disabled):not(.switch),
 // 18dp anatomy. Exclude .switch — that file paints the track on a span.
 $_cb-span: "*:not(.switch) > [type='checkbox'] + span:not(.lever, .supporting-text, .character-counter, .file-path)";
 
+// inline-block, not inline-flex: a flex span turns each text run and link
+// inside it into its own item, which drops the spaces around a link and
+// splits "I agree to the <a>Terms</a>" into columns. The block padding
+// centers one line in the 48px target, as align-items did.
 #{$_cb-span} {
   position: relative;
-  display: inline-flex;
-  align-items: center;
+  display: inline-block;
+  box-sizing: border-box;
   min-height: 48px;
+  padding-block: calc((48px - 1lh) / 2);
   padding-left: 30px;
   cursor: pointer;
   user-select: none;

package/src/sass/components/forms/_drop-zone.scss

@@ -0,0 +1,128 @@
+@use "../../abstracts" as *;
+
+// Drop zone. A .drop-zone is a large target for choosing files: a <label>
+// holding an icon, a prompt and a native <input type="file">, with an
+// optional .drop-zone-files list after it.
+//
+// The input is stretched invisibly over the whole label, so the browser
+// takes a click, a keypress or a dropped file exactly as it does on a plain
+// file input. The Forms behavior adds .dragover while files are dragged over
+// it and fills .drop-zone-files with each chosen file's name and size.
+//
+// Tokens:
+//   --md-comp-drop-zone-shape                      16px
+//   --md-comp-drop-zone-outline-color              outline
+//   --md-comp-drop-zone-dragover-container-color   primary-container
+//   --md-comp-drop-zone-dragover-color             on-primary-container
+
+.drop-zone {
+  --md-comp-drop-zone-shape: 16px;
+  --md-comp-drop-zone-outline-color: var(--md-sys-color-outline);
+  --md-comp-drop-zone-dragover-container-color: var(--md-sys-color-primary-container);
+  --md-comp-drop-zone-dragover-color: var(--md-sys-color-on-primary-container);
+
+  margin: $element-top-margin 0 $element-bottom-margin;
+
+  > label {
+    position: relative;
+    box-sizing: border-box;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 4px;
+    padding: 32px 24px;
+    border: 1px dashed var(--md-comp-drop-zone-outline-color);
+    border-radius: var(--md-comp-drop-zone-shape);
+    text-align: center;
+    color: var(--md-sys-color-on-surface-variant);
+    cursor: pointer;
+    transition: background-color 0.2s ease-out, border-color 0.2s ease-out;
+    @include typescale("body-large");
+
+    > #{$icon} {
+      margin-block-end: 8px;
+      font-size: 32px;
+      color: var(--md-sys-color-primary);
+    }
+
+    > small {
+      @include typescale("body-small");
+    }
+
+    > input[type="file"] {
+      position: absolute;
+      inset: 0;
+      width: 100%;
+      height: 100%;
+      margin: 0;
+      padding: 0;
+      opacity: 0;
+      cursor: pointer;
+    }
+
+    &:hover {
+      background-color: color-mix(
+        in oklab,
+        var(--md-sys-color-on-surface) state-opacity("hover"),
+        transparent
+      );
+    }
+
+    &:has(> input:focus-visible) {
+      @include focus-ring;
+    }
+
+    &:has(> input:disabled) {
+      opacity: 0.38;
+      cursor: default;
+      pointer-events: none;
+    }
+  }
+
+  &.dragover > label {
+    border-style: solid;
+    border-color: var(--md-sys-color-primary);
+    background-color: var(--md-comp-drop-zone-dragover-container-color);
+    color: var(--md-comp-drop-zone-dragover-color);
+  }
+
+  > .drop-zone-files {
+    display: flex;
+    flex-direction: column;
+    gap: 2px;
+    margin: 8px 0 0;
+    padding: 0;
+    list-style: none;
+
+    > li {
+      display: flex;
+      justify-content: space-between;
+      gap: 16px;
+      padding: 8px 16px;
+      border-radius: 8px;
+      background-color: var(--md-sys-color-surface-container);
+      color: var(--md-sys-color-on-surface);
+      @include typescale("body-medium");
+
+      > :first-child {
+        min-width: 0;
+        overflow-wrap: anywhere;
+      }
+
+      > :last-child:not(:first-child) {
+        flex: none;
+        color: var(--md-sys-color-on-surface-variant);
+      }
+    }
+
+    &:empty {
+      display: none;
+    }
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .drop-zone > label {
+    transition: none;
+  }
+}

package/src/sass/components/forms/_index.scss

@@ -1,9 +1,11 @@
 @forward 'input-fields';
 @forward 'radio-buttons';
+@forward 'rating';
 @forward 'checkboxes';
 @forward 'switches';
 @forward 'select';
 @forward 'file-input';
+@forward 'drop-zone';
 @forward 'slider';
 @forward 'fieldset';
 

package/src/sass/components/forms/_input-fields.scss

@@ -177,7 +177,7 @@ $_not-label: ".supporting-text, .character-counter, .file-path, .caret, .prefix,
   // .character-counter, .file-path). So the documented markup names the side
   // explicitly with .prefix / .suffix, and those rules key on nothing else.
   > i:is(.prefix, .suffix, :first-of-type, :last-of-type, :last-child),
-  > :is(.prefix, .suffix) {
+  > :is(.prefix, .suffix):not(.icon-button) {
     position: absolute;
     top: 16px;
     display: flex;
@@ -200,7 +200,7 @@ $_not-label: ".supporting-text, .character-counter, .file-path, .caret, .prefix,
   > i.suffix,
   > i:last-of-type:not(:first-of-type),
   > i:last-child:not(:first-child):not(.prefix),
-  > .suffix {
+  > .suffix:not(.icon-button) {
     right: 12px;
     // Both icons inherited this from the floating-label rule until they were
     // excluded from it. .prefix restates it below; .suffix has to as well, or
@@ -208,6 +208,15 @@ $_not-label: ".supporting-text, .character-counter, .file-path, .caret, .prefix,
     pointer-events: none;
   }
 
+  // A trailing icon button is a control, so it keeps its 40dp target and its
+  // clicks. It centres on the same point as a 24dp trailing icon.
+  > .icon-button.suffix {
+    position: absolute;
+    top: 8px;
+    right: 4px;
+    z-index: 1;
+  }
+
   &:has(> i:first-of-type:not(.suffix):not(:last-child), > i.prefix, > .prefix) {
     > :is(input, textarea) {
       padding-left: 52px;
@@ -351,3 +360,125 @@ textarea {
     }
   }
 }
+
+// Password visibility toggle. A trailing .icon-button.password-toggle with
+// aria-pressed holds two icons: the first shows while the password is hidden,
+// the second once it is shown. The Forms behavior flips the input's type.
+.password-toggle {
+  > #{$icon}:last-child:not(:first-child) {
+    display: none;
+  }
+
+  &[aria-pressed="true"] {
+    > #{$icon}:first-child:not(:last-child) {
+      display: none;
+    }
+
+    > #{$icon}:last-child:not(:first-child) {
+      display: inline-block;
+    }
+  }
+}
+
+// One-time code. A single native input drawn as a row of cells, so paste,
+// autofill from autocomplete="one-time-code", undo and the caret all stay the
+// browser's. A monospace face makes every digit 1ch wide; letter-spacing
+// moves each one to the next cell, and the input is clipped after the last.
+//
+// Tokens:
+//   --md-comp-otp-length          6
+//   --md-comp-otp-cell-width      48px
+//   --md-comp-otp-cell-height     56px
+//   --md-comp-otp-gap             8px
+//   --md-comp-otp-cell-color      surface-container-highest
+//   --md-comp-otp-indicator-color on-surface-variant / focus: primary
+//
+// :not(.browser-default) matches the weight of the shared text-input rule
+// above, which would otherwise win on width, height and letter-spacing.
+input.otp:not(.browser-default) {
+  --md-comp-otp-length: 6;
+  --md-comp-otp-cell-width: 48px;
+  --md-comp-otp-cell-height: 56px;
+  --md-comp-otp-gap: 8px;
+  --md-comp-otp-cell-color: var(--md-sys-color-surface-container-highest);
+  --md-comp-otp-indicator-color: var(--md-sys-color-on-surface-variant);
+  // Derived, not for overriding: the distance between cell starts, the
+  // inset that centres a digit in its cell, and the box past the last cell
+  // that the caret needs and the clip hides.
+  --md-comp-otp-pitch: calc(var(--md-comp-otp-cell-width) + var(--md-comp-otp-gap));
+  --md-comp-otp-inset: calc((var(--md-comp-otp-cell-width) - 1ch) / 2);
+  --md-comp-otp-overhang: calc(var(--md-comp-otp-gap) + var(--md-comp-otp-inset) + 2px);
+
+  box-sizing: border-box;
+  display: block;
+  // Room for the caret after the last digit, clipped back to the cells; the
+  // negative margin gives the overhang back to the layout.
+  width: calc(var(--md-comp-otp-length) * var(--md-comp-otp-pitch) + var(--md-comp-otp-inset) + 2px);
+  height: var(--md-comp-otp-cell-height);
+  margin: 0 calc(var(--md-comp-otp-overhang) * -1) 0 0;
+  padding: 0 0 0 var(--md-comp-otp-inset);
+  border: 0;
+  border-radius: 0;
+  outline: 0;
+  box-shadow: none;
+  clip-path: inset(0 var(--md-comp-otp-overhang) 0 0);
+  // Digits read left to right in every script.
+  direction: ltr;
+  font-family: ui-monospace, "SFMono-Regular", Menlo, Consolas, "Liberation Mono", monospace;
+  font-size: 24px;
+  font-variant-numeric: tabular-nums;
+  letter-spacing: calc(var(--md-comp-otp-pitch) - 1ch);
+  color: var(--md-sys-color-on-surface);
+  caret-color: var(--md-sys-color-primary);
+  background-color: transparent;
+  background-image:
+    linear-gradient(
+      to right,
+      var(--md-comp-otp-indicator-color) var(--md-comp-otp-cell-width),
+      transparent 0
+    ),
+    linear-gradient(
+      to right,
+      var(--md-comp-otp-cell-color) var(--md-comp-otp-cell-width),
+      transparent 0
+    );
+  background-size:
+    var(--md-comp-otp-pitch) 1px,
+    var(--md-comp-otp-pitch) 100%;
+  background-position: left bottom, left top;
+  background-repeat: repeat-x;
+
+  &::placeholder {
+    color: var(--md-sys-color-on-surface-variant);
+    opacity: 1;
+  }
+
+  // Every cell's indicator turns primary and thickens while the code has
+  // focus; the clip would cut an outline, so this is the focus ring.
+  &:focus,
+  &:focus-visible {
+    --md-comp-otp-indicator-color: var(--md-sys-color-primary);
+
+    outline: 0;
+    background-size:
+      var(--md-comp-otp-pitch) 2px,
+      var(--md-comp-otp-pitch) 100%;
+  }
+
+  &.invalid,
+  &[aria-invalid="true"] {
+    --md-comp-otp-indicator-color: var(--md-sys-color-error);
+  }
+
+  &:disabled {
+    opacity: 0.38;
+  }
+
+  @media (forced-colors: active) {
+    --md-comp-otp-indicator-color: CanvasText;
+
+    &:focus {
+      --md-comp-otp-indicator-color: Highlight;
+    }
+  }
+}

package/src/sass/components/forms/_rating.scss

@@ -0,0 +1,165 @@
+@use "../../abstracts" as *;
+
+// Rating. Two forms share the star.
+//
+// Input: a <fieldset class="rating"> with a <legend> and one radio per star,
+// each in a <label> whose visually hidden text ("3 stars") comes before the
+// radio: a span after it is the older input + span radio, which hides the
+// input. The radio itself is drawn as the star, so arrow keys, form
+// submission and the group's name stay native. A star fills when it or a
+// later star is checked; hovering previews.
+//
+// Display: <span class="rating" role="img" aria-label="Rated 4.5 out of 5">
+// with --md-comp-rating-value. The stars fill to that value, halves included.
+//
+// Loaded after radio-buttons: the input rules match the radio rules' weight
+// and win on order.
+//
+// Tokens:
+//   --md-comp-rating-size         24px (display 20px)
+//   --md-comp-rating-color        tertiary
+//   --md-comp-rating-empty-color  outline-variant
+//   --md-comp-rating-value        0 (display)
+//   --md-comp-rating-max          5 (display)
+
+$_rating-star: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24'%3E%3Cpath d='m12 17.27 6.18 3.73-1.64-7.03L22 9.24l-7.19-.61L12 2 9.19 8.63 2 9.24l5.46 4.73L5.82 21z'/%3E%3C/svg%3E");
+
+.rating {
+  --md-comp-rating-size: 24px;
+  --md-comp-rating-color: var(--md-sys-color-tertiary);
+  --md-comp-rating-empty-color: var(--md-sys-color-outline-variant);
+}
+
+fieldset.rating {
+  display: flex;
+  flex-wrap: wrap;
+  align-items: center;
+  margin: 0;
+  padding: 0;
+  border: 0;
+
+  > legend {
+    margin-block-end: 4px;
+    padding: 0;
+    color: var(--md-sys-color-on-surface-variant);
+    @include typescale("body-medium");
+  }
+
+  > label {
+    display: inline-flex;
+    gap: 0;
+    min-height: 0;
+    padding: 4px;
+    border-radius: 50%;
+    cursor: pointer;
+
+    &:has(> input:focus-visible) {
+      @include focus-ring;
+    }
+
+    &:has(> input:disabled) {
+      opacity: 0.38;
+      cursor: default;
+    }
+  }
+
+  > label > [type="radio"] {
+    flex: none;
+    width: var(--md-comp-rating-size);
+    height: var(--md-comp-rating-size);
+    border: 0;
+    border-radius: 0;
+    background-color: var(--md-comp-rating-empty-color);
+    background-image: none;
+    box-shadow: none;
+    mask: $_rating-star center / 100% no-repeat;
+    outline: 0;
+    transition: background-color 0.15s ease-out;
+
+    // The base radio draws its dot in :checked, :hover and the disabled
+    // states, some at a higher weight; the star mask would show it.
+    &:checked,
+    &:hover,
+    &:disabled,
+    &:disabled:checked {
+      border: 0;
+      background-image: none;
+      box-shadow: none;
+    }
+  }
+
+  // Filled: the checked star and every star before it.
+  > label:has(> :checked) > [type="radio"],
+  > label:has(~ label > :checked) > [type="radio"] {
+    background-color: var(--md-comp-rating-color);
+  }
+
+  // Hovering previews the rating under the pointer. Both rules sit under the
+  // same :has() so the preview outranks the reset.
+  &:has(> label:hover) {
+    > label > [type="radio"] {
+      background-color: var(--md-comp-rating-empty-color);
+    }
+
+    > label:hover > [type="radio"],
+    > label:has(~ label:hover) > [type="radio"] {
+      background-color: color-mix(in oklab, var(--md-comp-rating-color) 70%, transparent);
+    }
+  }
+
+  @media (prefers-reduced-motion: reduce) {
+    > label > [type="radio"] {
+      transition: none;
+    }
+  }
+}
+
+.rating:not(fieldset) {
+  --md-comp-rating-size: 20px;
+  --md-comp-rating-value: 0;
+  --md-comp-rating-max: 5;
+
+  display: inline-block;
+  width: calc(var(--md-comp-rating-size) * var(--md-comp-rating-max));
+  height: var(--md-comp-rating-size);
+  vertical-align: middle;
+  background: linear-gradient(
+    to right,
+    var(--md-comp-rating-color) calc(var(--md-comp-rating-value) / var(--md-comp-rating-max) * 100%),
+    var(--md-comp-rating-empty-color) 0
+  );
+  mask: $_rating-star left center / var(--md-comp-rating-size) repeat-x;
+
+  &:dir(rtl) {
+    background: linear-gradient(
+      to left,
+      var(--md-comp-rating-color) calc(var(--md-comp-rating-value) / var(--md-comp-rating-max) * 100%),
+      var(--md-comp-rating-empty-color) 0
+    );
+    mask-position: right center;
+  }
+}
+
+@media (forced-colors: active) {
+  fieldset.rating > label > [type="radio"],
+  .rating:not(fieldset) {
+    forced-color-adjust: none;
+  }
+
+  fieldset.rating > label > [type="radio"] {
+    background-color: GrayText;
+  }
+
+  fieldset.rating > label:has(> :checked) > [type="radio"],
+  fieldset.rating > label:has(~ label > :checked) > [type="radio"] {
+    background-color: Highlight;
+  }
+
+  .rating:not(fieldset) {
+    background: linear-gradient(
+      to right,
+      Highlight calc(var(--md-comp-rating-value) / var(--md-comp-rating-max) * 100%),
+      GrayText 0
+    );
+  }
+}

package/src/sass/tokens/_reference.scss

@@ -24,21 +24,9 @@
 // against #006495, the one source there is ground truth for - $md-source below
 // is a branding choice and is free to change without failing it.
 
-// The seed every generated ramp derives from. Chosen for a restaurant POS: the
-// error ramp is pinned at hue 27.7deg and both primary and tertiary (source
-// +62deg) derive from this, so the seed has to keep both clear of red. Warm
-// "appetising" hues (0-60deg) are disqualified outright - they put primary on
-// top of error, dEok 0.07-0.12 against ~0.28 here.
-//
-// Teal wins on *worst case* across both schemes rather than on either one
-// alone, which is the metric that matters: evening service runs dark mode in a
-// dim room, and that is where a confirm/void mix-up actually happens.
-//   light  primary40 vs error40  dEok 0.278
-//   dark   primary80 vs error80  dEok 0.212   <- best of the candidates
-//   light  tertiary40 vs error40 dEok 0.224
-// It also leaves green free for the "settled/paid" role a POS will want and
-// Material does not supply.
-$md-source: #006A79 !default;
+// Mist Iris is the default seed for the generated ramps. Primary, secondary,
+// tertiary and neutral colors derive from it; the error ramp stays fixed.
+$md-source: #c6a0f6 !default;
 
 // tone -> OKLCH lightness. Fitted against the reference ramps; see the test.
 $tones: (

package/src/sass/utilities/_index.scss

@@ -6,3 +6,5 @@
 @forward "spacing";          // .m-3, .pt-2, .px-4, ...
 @forward "visibility";       // .hide, .hide-on-med-and-down, .show-on-large, ...
 @forward "helpers";          // alignment, floats, truncate, responsive media
+@forward "scroll-area";      // native scrolling with themed scrollbars
+@forward "shapes";           // .shape-pebble, .shape-scallop-6, ... (masks)

package/src/sass/utilities/_scroll-area.scss

@@ -0,0 +1,35 @@
+@use "../abstracts" as *;
+
+// Keep scrolling native; use the current theme for scrollbar colors.
+.scroll-area {
+  overflow: auto;
+  scrollbar-width: thin;
+  scrollbar-color: var(--scroll-area-thumb-color, var(--md-sys-color-on-surface-variant)) var(--scroll-area-track-color, transparent);
+}
+
+// Older WebKit engines do not implement the standard scrollbar properties.
+@supports not (scrollbar-color: red blue) {
+  @media (forced-colors: none) {
+    .scroll-area::-webkit-scrollbar {
+      width: 8px;
+      height: 8px;
+    }
+
+    .scroll-area::-webkit-scrollbar-thumb {
+      background-color: var(--scroll-area-thumb-color, var(--md-sys-color-on-surface-variant));
+      border-radius: 999px;
+    }
+
+    .scroll-area::-webkit-scrollbar-track,
+    .scroll-area::-webkit-scrollbar-corner {
+      background-color: var(--scroll-area-track-color, transparent);
+    }
+  }
+}
+
+@media (forced-colors: active) {
+  .scroll-area {
+    scrollbar-width: auto;
+    scrollbar-color: auto;
+  }
+}