@expressivecss/expressive 0.15.0 → 0.17.0

package/src/sass/base/_normalize.scss

@@ -1,5 +1,3 @@
-@use "../abstracts" as *;
-
 /*! Based on normalize.css v8.0.1 | MIT License | github.com/necolas/normalize.css */
 
 // Trimmed to the project's support baseline: the last 5 Chrome and Firefox
@@ -35,21 +33,23 @@
 //   fieldset { padding: .35em .75em .625em }           - restates the UA padding
 //   summary { display: list-item }                     - already list-item
 //
+// A third pass removed the rules base/_typography.scss overrides on the same
+// selector later in the same layer, so they never reached the page:
+//   h1 { font-size; margin }           - the display-small typescale and margin
+//   b, strong { font-weight: bolder }  - `strong, b { font-weight: 500 }`
+//   small { font-size: 80% }           - the body-small typescale
+//   kbd in `code, kbd, samp`           - the keycap rule sets both properties
+//
 // The rest of this file was measured against a bare page in both engines rather
 // than assumed, and these are the results that keep a rule here. Do not remove
 // them again without re-measuring - each one *looks* redundant and is not:
-//   b, strong { font-weight: bolder }  UA is `bold` (700). `bolder` is relative,
-//                                      so it reaches 900 inside an already-bold
-//                                      parent where the UA value would stay 700.
-//   small { font-size: 80% }           UA is `smaller`, which computes to
-//                                      13.333px against a 16px parent, not 12.8.
 //   progress { vertical-align: baseline }  UA is -3.2px, not baseline.
 //   legend { padding: 0 }              UA has padding-left: 2px.
 //   [type="search"] { ... }            UA is appearance:auto / outline-offset:0.
 //   sub, sup { ... }                   UA uses vertical-align: sub/super and no
 //                                      line-height reset; normalize's version is
 //                                      deliberately a different mechanism.
-//   code, kbd, samp, pre { font-size: 1em }  UA applies the monospace font-size
+//   code, samp, pre { font-size: 1em }  UA applies the monospace font-size
 //                                      quirk (13px Chromium, 12px Firefox).
 //   hr { box-sizing: content-box }     matches the UA, but base/_global.scss sets
 //                                      border-box globally and would override it.
@@ -57,97 +57,58 @@
 //                                      correction, and this file's policy is to
 //                                      keep those. `button` itself was dropped.
 
-/* Document
-   ========================================================================== */
+// Document
+// ==========================================================================
 
-/**
- * 1. Correct the line height in all browsers.
- * 2. Prevent adjustments of font size after orientation changes in iOS.
- */
+// 1. Correct the line height in all browsers.
+// 2. Prevent adjustments of font size after orientation changes in iOS.
 
-html {
-  line-height: 1.15; /* 1 */
-  -webkit-text-size-adjust: 100%; /* 2 */
+html,
+:host {
+  line-height: 1.15; // 1
+  -webkit-text-size-adjust: 100%; // 2
 }
 
-/* Sections
-   ========================================================================== */
+// Sections
+// ==========================================================================
 
-/**
- * Remove the margin in all browsers.
- */
+// Remove the margin in all browsers.
 
 body {
   margin: 0;
 }
 
-/**
- * Correct the font size and margin on `h1` elements within `section` and
- * `article` contexts in Chrome, Firefox, and Safari.
- */
-
-h1 {
-  font-size: 2em;
-  margin: 0.67em 0;
-}
+// Grouping content
+// ==========================================================================
 
-/* Grouping content
-   ========================================================================== */
-
-/**
- * Add the correct box sizing in Firefox. Needed because base/_global.scss sets
- * `box-sizing: border-box` globally, which would collapse a 0-height `hr`.
- */
+// Add the correct box sizing in Firefox. Needed because base/_global.scss sets
+// `box-sizing: border-box` globally, which would collapse a 0-height `hr`.
 
 hr {
   box-sizing: content-box;
   height: 0;
 }
 
-/**
- * Correct the inheritance and scaling of font size in all browsers.
- */
+// Correct the inheritance and scaling of font size in all browsers.
 
 pre {
   font-family: monospace;
   font-size: 1em;
 }
 
-/* Text-level semantics
-   ========================================================================== */
-
-/**
- * Add the correct font weight in Chrome, Edge, and Safari.
- */
+// Text-level semantics
+// ==========================================================================
 
-b,
-strong {
-  font-weight: bolder;
-}
-
-/**
- * Correct the inheritance and scaling of font size in all browsers.
- */
+// Correct the inheritance and scaling of font size in all browsers.
 
 code,
-kbd,
 samp {
   font-family: monospace;
   font-size: 1em;
 }
 
-/**
- * Add the correct font size in all browsers.
- */
-
-small {
-  font-size: 80%;
-}
-
-/**
- * Prevent `sub` and `sup` elements from affecting the line height in
- * all browsers.
- */
+// Prevent `sub` and `sup` elements from affecting the line height in
+// all browsers.
 
 sub,
 sup {
@@ -165,33 +126,29 @@ sup {
   top: -0.5em;
 }
 
-/* Forms
-   ========================================================================== */
+// Forms
+// ==========================================================================
 
-/**
- * 1. Change the font styles in all browsers.
- * 2. Remove the margin in Firefox and Safari.
- */
+// 1. Change the font styles in all browsers. The family is set from
+//    $font-stack on the same selectors in _global.scss.
+// 2. Remove the margin in Firefox and Safari.
 
 button,
 input,
 optgroup,
 select,
 textarea {
-  font-family: inherit; /* 1 */
-  font-size: 100%; /* 1 */
-  line-height: 1.15; /* 1 */
-  margin: 0; /* 2 */
+  font-size: 100%; // 1
+  line-height: 1.15; // 1
+  margin: 0; // 2
 }
 
-/**
- * Correct the inability to style clickable types in iOS and Safari.
- * Kept prefixed: this is a WebKit correction, and Safari is what needs it.
- *
- * `button` is no longer in this list. The clickable *types* are what Safari
- * renders unstyleable; a <button> element already renders as a button there,
- * and normalize carried it out of caution.
- */
+// Correct the inability to style clickable types in iOS and Safari.
+// Kept prefixed: this is a WebKit correction, and Safari is what needs it.
+//
+// `button` is no longer in this list. The clickable *types* are what Safari
+// renders unstyleable; a <button> element already renders as a button there,
+// and normalize carried it out of caution.
 
 [type="button"],
 [type="reset"],
@@ -199,59 +156,47 @@ textarea {
   -webkit-appearance: button;
 }
 
-/**
- * Remove the padding so developers are not caught out when they zero out
- * `fieldset` elements in all browsers.
- */
+// Remove the padding so developers are not caught out when they zero out
+// `fieldset` elements in all browsers.
 
 legend {
   padding: 0;
 }
 
-/**
- * Add the correct vertical alignment in Chrome, Firefox, and Opera.
- */
+// Add the correct vertical alignment in Chrome, Firefox, and Opera.
 
 progress {
   vertical-align: baseline;
 }
 
-/**
- * Correct the cursor style of increment and decrement buttons in Chrome.
- */
+// Correct the cursor style of increment and decrement buttons in Chrome.
 
 [type="number"]::-webkit-inner-spin-button,
 [type="number"]::-webkit-outer-spin-button {
   height: auto;
 }
 
-/**
- * 1. Correct the odd appearance in Chrome and Safari.
- * 2. Correct the outline style in Safari.
- */
+// 1. Correct the odd appearance in Chrome and Safari.
+// 2. Correct the outline style in Safari.
 
 [type="search"] {
-  -webkit-appearance: textfield; /* 1 */
-  outline-offset: -2px; /* 2 */
+  -webkit-appearance: textfield; // 1
+  outline-offset: -2px; // 2
 }
 
-/**
- * Remove the inner padding in Chrome and Safari on macOS.
- */
+// Remove the inner padding in Chrome and Safari on macOS.
 
 [type="search"]::-webkit-search-decoration {
   -webkit-appearance: none;
 }
 
-/**
- * 1. Correct the inability to style clickable types in iOS and Safari.
- * 2. Change font properties to `inherit` in Safari.
- *
- * `::file-selector-button` is the standardised name (Chrome 89+, Firefox 82+);
- * the `::-webkit-file-upload-button` alias it replaced is gone.
- */
+// 1. Correct the inability to style clickable types in iOS and Safari.
+// 2. Change font properties to `inherit` in Safari.
+//
+// `::file-selector-button` is the standardised name (Chrome 89+, Firefox 82+);
+// the `::-webkit-file-upload-button` alias it replaced is gone.
 
 ::file-selector-button {
-  -webkit-appearance: button; /* 1 */
-  font: inherit; /* 2 */
+  -webkit-appearance: button; // 1
+  font: inherit; // 2
 }

package/src/sass/base/_print.scss

@@ -0,0 +1,21 @@
+// Paper defaults, element level only. Components that only make sense on a
+// screen (navigation, snackbars, tooltips, the FAB menu) hide themselves in
+// their own partials; .hide-on-print and .print-only are in
+// utilities/_visibility.scss. The light scheme for print is in
+// tokens/_theme.scss, which owns color-scheme.
+@media print {
+  // Paper cannot follow a link, so print where it goes. Only external links
+  // in running text: the same set base/_global.scss underlines.
+  :where(p, dd, blockquote, figcaption, td) a[href^="http"]:not([class])::after {
+    content: " (" attr(href) ")";
+    overflow-wrap: anywhere;
+  }
+
+  // Keep a heading with what follows it, and keep small blocks whole.
+  :is(h1, h2, h3, h4, h5, h6) { break-after: avoid; }
+  :is(pre, blockquote, figure, img, video, tr, li, dt, dd) { break-inside: avoid; }
+  :is(p, h2, h3) { orphans: 3; widows: 3; }
+
+  // Repeat a table's header row on every page it spans.
+  thead { display: table-header-group; }
+}

package/src/sass/base/_prose.scss

@@ -0,0 +1,68 @@
+// .prose: long-form content written as bare HTML, such as Markdown or CMS
+// output, where the author cannot add a class to each element. Put it on a
+// <div>, <section> or <main>: every <article> is already a card.
+//
+// It lives in the base layer, not with the components, so any component
+// placed inside the content still wins over it. The element lists sit in
+// :where(), so a rule weighs `.prose` plus `:not([class])`: enough to beat
+// the element defaults beside it. Elements that carry a class are a
+// component or a deliberate style and are left alone.
+
+.prose {
+  max-inline-size: 70ch;
+
+  > :first-child { margin-block-start: 0; }
+  > :last-child { margin-block-end: 0; }
+
+  :where(h2, h3, h4, h5, h6):not([class], :first-child) { margin-block-start: 1.6em; }
+
+  :where(ul, ol):not([class]) {
+    margin-block: 0 1em;
+    padding-inline-start: 1.5em;
+  }
+
+  :where(li):not([class]) + li { margin-block-start: 0.375em; }
+  :where(li > ul, li > ol):not([class]) { margin-block: 0.375em 0; }
+
+  // base/_global.scss underlines links in paragraphs; lists and headings
+  // in long-form content are running text too.
+  :where(li, h2, h3, h4, h5, h6) a:not([class]) {
+    text-decoration: underline;
+    text-underline-offset: 0.15em;
+  }
+
+  // <kbd> keeps its keycap from base/_typography.scss.
+  :where(code, samp):not([class]) { font-size: 0.875em; }
+
+  :where(code):not([class]) {
+    padding: 0.125em 0.375em;
+    border-radius: var(--md-sys-shape-corner-extra-small);
+    background-color: var(--md-sys-color-surface-container-high);
+  }
+
+  :where(pre):not([class]) {
+    margin-block: 0 1em;
+    padding: 1rem;
+    overflow-x: auto;
+    border-radius: var(--md-sys-shape-corner-medium);
+    background-color: var(--md-sys-color-surface-container);
+
+    > code { padding: 0; background: none; font-size: inherit; }
+  }
+
+  :where(img, video):not([class]) {
+    max-inline-size: 100%;
+    block-size: auto;
+    border-radius: var(--md-sys-shape-corner-medium);
+  }
+
+  :where(figure):not([class]) { margin: 0 0 1em; }
+
+  :where(hr):not([class]) {
+    margin-block: 2em;
+    border: 0;
+    border-block-start: 1px solid var(--md-sys-color-outline-variant);
+  }
+
+  :where(table):not([class]) { margin-block: 0 1em; }
+}

package/src/sass/base/_typography.scss

@@ -14,13 +14,13 @@
 // large for a default <h1>. Component slots (app bar, card, dialog) set
 // their own roles and win on specificity.
 
-html {
+html,
+:host {
   font-family: $font-stack;
-  font-weight: var(--md-sys-typescale-body-medium-font-weight);
-  color: $text-color;
 }
 
-body {
+body,
+:host {
   @include typescale("body-medium");
 }
 
@@ -39,6 +39,11 @@ h4, h5, h6 {
   margin: 0 0 0.35em;
 }
 
+// Even out heading lines, and keep a lone word off a paragraph's last line.
+// The longhand leaves text-wrap-mode alone, so .truncate and nowrap still win.
+h1, h2, h3, h4, h5, h6 { text-wrap-style: balance; }
+p { text-wrap-style: pretty; }
+
 h1 a, h2 a, h3 a, h4 a, h5 a, h6 a {
   font-weight: inherit;
   color: inherit;
@@ -54,7 +59,6 @@ figcaption {
   @include typescale("body-small");
 }
 
-em { font-style: italic; }
 strong, b { font-weight: 500; }
 
 // Flow text: font-size scales with the viewport between two bounds.

package/src/sass/components/_accordion.scss

@@ -18,12 +18,10 @@
 //   --md-comp-accordion-header-height    56px
 //   --md-comp-accordion-padding          16px
 
-$_accordion-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");
-
 .accordion {
   --md-comp-accordion-container-color: var(--md-sys-color-surface-container);
-  --md-comp-accordion-shape: 20px;
-  --md-comp-accordion-grouped-shape: 4px;
+  --md-comp-accordion-shape: var(--md-sys-shape-corner-large-increased);
+  --md-comp-accordion-grouped-shape: var(--md-sys-shape-corner-extra-small);
   --md-comp-accordion-gap: 2px;
   --md-comp-accordion-header-height: 56px;
   --md-comp-accordion-padding: 16px;
@@ -40,7 +38,7 @@ $_accordion-chevron: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/200
     // Invisible until forced colors paint it, so the tiles stay apart there.
     outline: 1px solid transparent;
     outline-offset: -1px;
-    transition: border-radius 200ms ease-out;
+    transition: border-radius var(--md-sys-motion-duration-short4) ease-out;
 
     &:first-child {
       border-start-start-radius: var(--md-comp-accordion-shape);
@@ -84,16 +82,12 @@ $_accordion-chevron: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/200
       height: 24px;
       margin-inline-start: auto;
       background-color: var(--md-sys-color-on-surface-variant);
-      mask: $_accordion-chevron center / 24px no-repeat;
-      transition: transform 200ms ease-out;
+      mask: $expand-more center / 24px no-repeat;
+      transition: transform var(--md-sys-motion-duration-short4) ease-out;
     }
 
     &:hover {
-      background-color: color-mix(
-        in oklab,
-        var(--md-sys-color-on-surface) state-opacity("hover"),
-        transparent
-      );
+      background-color: state-layer(var(--md-sys-color-on-surface), "hover");
     }
 
     > #{$icon} {
@@ -130,8 +124,8 @@ $_accordion-chevron: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/200
       block-size: 0;
       overflow: clip;
       transition:
-        block-size 250ms cubic-bezier(0.2, 0, 0, 1),
-        content-visibility 250ms allow-discrete;
+        block-size var(--md-sys-motion-duration-medium1) var(--md-sys-motion-easing-standard),
+        content-visibility var(--md-sys-motion-duration-medium1) allow-discrete;
     }
 
     &[open]::details-content {
@@ -153,9 +147,6 @@ $_accordion-chevron: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/200
   }
 }
 
-@media (forced-colors: active) {
-  .accordion > details > summary::after {
-    forced-color-adjust: none;
-    background-color: CanvasText;
-  }
+.accordion > details > summary::after {
+  @include forced-colors-fill;
 }

package/src/sass/components/_alert.scss

@@ -0,0 +1,102 @@
+@use "../abstracts" as *;
+
+// Alert. A persistent message in the flow of the page, next to the content it
+// is about: an optional leading icon, text, an optional close button and an
+// optional row of actions. `critical` is the error-container tone. Static
+// alerts need no role; see llm.md for announcing changes.
+//
+// Anatomy is the HTML, in order:
+//   icon               leading; sits beside the first line of text
+//   h1–h6, p, ...      the message; every other child stacks in the text column
+//   .icon-button       last child, the close button
+//   .alert-actions     buttons under the text, aligned to the end
+//
+// The grid pins the icon and close button to the first row, so a long message
+// or enlarged text wraps under itself instead of under them.
+//
+// Tokens:
+//   --md-comp-alert-container-color   secondary-container / critical: error-container
+//   --md-comp-alert-color             on-secondary-container / critical: on-error-container
+//   --md-comp-alert-shape             16px
+//   --md-comp-alert-padding           16px
+
+.alert {
+  --md-comp-alert-container-color: var(--md-sys-color-secondary-container);
+  --md-comp-alert-color: var(--md-sys-color-on-secondary-container);
+  --md-comp-alert-shape: var(--md-sys-shape-corner-large);
+  --md-comp-alert-padding: 16px;
+
+  box-sizing: border-box;
+  display: grid;
+  grid-template-columns: auto minmax(0, 1fr) auto;
+  align-items: start;
+  row-gap: 4px;
+  margin-block: 8px;
+  padding: var(--md-comp-alert-padding);
+  // Transparent so forced-colors mode, which drops the fill, still draws an edge.
+  border: 1px solid transparent;
+  border-radius: var(--md-comp-alert-shape);
+  background-color: var(--md-comp-alert-container-color);
+  color: var(--md-comp-alert-color);
+  @include typescale("body-medium");
+
+  // display: grid would otherwise beat the browser's [hidden] rule, and
+  // toggling hidden is the usual way to show and dismiss an alert.
+  &[hidden] {
+    display: none;
+  }
+
+  &.critical {
+    --md-comp-alert-container-color: var(--md-sys-color-error-container);
+    --md-comp-alert-color: var(--md-sys-color-on-error-container);
+  }
+
+  > * {
+    grid-column: 2;
+    margin: 0;
+  }
+
+  > #{$icon}:first-child {
+    grid-column: 1;
+    grid-row: 1;
+    margin-inline-end: 12px;
+    font-size: rem(24px);
+    line-height: rem(20px);
+  }
+
+  > :is(h1, h2, h3, h4, h5, h6) {
+    @include typescale("title-small");
+  }
+
+  > p {
+    @include typescale("body-medium");
+  }
+
+  a:not(.button, .icon-button) {
+    color: inherit;
+    text-decoration: underline;
+  }
+
+  // The close button's 48px target overhangs the padding instead of adding a
+  // row's worth of height to a one-line alert.
+  > .icon-button:last-child {
+    grid-column: 3;
+    grid-row: 1;
+    margin-block: -12px;
+    margin-inline: 4px -12px;
+    color: inherit;
+  }
+
+  > .alert-actions {
+    grid-column: 2 / -1;
+    display: flex;
+    flex-wrap: wrap;
+    justify-content: flex-end;
+    gap: 8px;
+    margin-block-start: 8px;
+  }
+
+  @media (forced-colors: active) {
+    border-color: CanvasText;
+  }
+}

package/src/sass/components/_aura.scss

@@ -35,7 +35,7 @@
   --md-comp-aura-color: var(--md-sys-color-primary);
   --md-comp-aura-color-2: var(--md-sys-color-tertiary);
   --md-comp-aura-width: 2px;
-  --md-comp-aura-shape: 12px;
+  --md-comp-aura-shape: var(--md-sys-shape-corner-medium);
   --md-comp-aura-duration: 4s;
 
   position: relative;
@@ -46,7 +46,7 @@
   border-radius: calc(var(--md-comp-aura-shape) + var(--md-comp-aura-width));
 
   &:has(> :is(button, .button, [role="button"])) {
-    --md-comp-aura-shape: 9999px;
+    --md-comp-aura-shape: var(--md-sys-shape-corner-full);
   }
 
   &::before {
@@ -101,10 +101,16 @@
     }
   }
 
+  // Doubled to outrank the variants, so a rainbow or a glow is the same
+  // solid ring.
   @media (forced-colors: active) {
-    &::before {
+    &.aura::before {
+      animation: none;
       forced-color-adjust: none;
       background: Highlight;
+      mask: linear-gradient(#000 0 0) content-box exclude, linear-gradient(#000 0 0);
+      filter: none;
+      opacity: 1;
     }
   }
 }

package/src/sass/components/_avatar.scss

@@ -15,7 +15,7 @@
 //   --md-comp-avatar-group-ring-color  surface
 
 .avatar {
-  --md-comp-avatar-size: 40px;
+  --md-comp-avatar-size: #{rem(40px)};
   --md-comp-avatar-container-color: var(--md-sys-color-secondary-container);
   --md-comp-avatar-color: var(--md-sys-color-on-secondary-container);
 
@@ -42,11 +42,11 @@
   user-select: none;
 
   &.small {
-    --md-comp-avatar-size: 32px;
+    --md-comp-avatar-size: #{rem(32px)};
   }
 
   &.large {
-    --md-comp-avatar-size: 56px;
+    --md-comp-avatar-size: #{rem(56px)};
   }
 
   > img {

package/src/sass/components/_back-to-top.scss

@@ -0,0 +1,38 @@
+@use "../abstracts" as *;
+
+// Back-to-top link. Pair it with the FAB classes, `button circle extra`, for
+// the look: this partial only places the link and hides it. `inert` is the
+// framework's. BackToTop sets it while the page is above the threshold, so
+// a page without the script keeps the link visible.
+//
+// The FAB menu sits in the same corner on the same offset. A page with both
+// raises one of them through `--md-comp-back-to-top-offset`.
+.back-to-top {
+  --md-comp-back-to-top-offset: 16px;
+  --md-comp-back-to-top-z: 997;
+  --md-comp-back-to-top-duration: var(--md-sys-motion-spring-fast-effects-duration);
+  --md-comp-back-to-top-easing: var(--md-sys-motion-spring-fast-effects);
+
+  position: fixed;
+  inset-inline-end: var(--md-comp-back-to-top-offset);
+  bottom: var(--md-comp-back-to-top-offset);
+  z-index: var(--md-comp-back-to-top-z);
+  transition: opacity var(--md-comp-back-to-top-duration) var(--md-comp-back-to-top-easing);
+
+  // It fades in, and hides at once. A fade out would also run when the
+  // script starts on a page already painted at the top, and show the link
+  // leaving a corner where nothing had scrolled. Visibility takes it off
+  // screen readers and the page's ARIA snapshot along with `inert`.
+  &[inert] {
+    visibility: hidden;
+    opacity: 0;
+    transition: none;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .back-to-top { transition: none; }
+}
+
+// A floating link would print over the content, as the FAB menu would.
+.back-to-top { @include print-hidden; }