mote.css 0.10.8 → 0.11.0

package/CHANGELOG.md

@@ -5,6 +5,93 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.11.0] - 2026-10-29
+
+### Added (components — round-15 findings)
+
+- `.mote-card-media` now sizes a direct inline SVG cover while preserving the
+  SVG's own `viewBox` ratio. Nested SVG icons remain unaffected.
+- `.mote-card-actions` bottom-aligns a card action row without owning the
+  row's display, gap, or wrapping.
+- `.mote-row-status` paints a status row's direct cells with
+  `background-color`, preserving semantic row headers and background-image
+  layers. Status classes remain token carriers without the helper.
+
+### Fixed (docs — round-15 findings)
+
+- The phone-record recipe now requires a non-empty `data-label` on every
+  transformed data cell and warns that a missing label renders blank.
+- The recipe states that its breakpoint is an example, that media-query
+  thresholds cannot be parameterized with CSS variables, and that the
+  transform and cap-release queries must use the same chosen threshold.
+- Table documentation now distinguishes page and wrapper scrolling and
+  explains that the 60vh cap does not crop content.
+- Print guidance now includes a practical paper checklist covering content,
+  tables, pagination, forms, and generated-PDF inspection.
+- Card documentation now covers direct inline SVG covers and the
+  `.mote-card-actions` helper.
+
+### Tests
+
+- The regression fixture asserts direct SVG cover sizing and ratio, nested SVG
+  isolation, card-action bottom alignment, status-row painting, background
+  image preservation, and gated badge behavior.
+- Documentation source checks cover the new guidance, reject leaked live
+  tags in copy-ready samples, and pin both the encoded and live SVG card-cover
+  structures, including their wrapper, SVG, rectangle, and circle elements.
+- The fixture's screen-only status and card probes stay off paper through a
+  fixture-local print rule, so the print-emulation PDF remains a focused
+  four-page regression artifact without repurposing `.mote-no-print`.
+
+### Evaluation
+
+- Fifteenth round: ten independent agents built ten new page types against
+  v0.10.9. All ten would use mote again. The final pages had no confirmed
+  library failures; these changes address the recurring authoring friction
+  and documentation gaps surfaced by the round.
+
+## [0.10.9] - 2026-10-29
+
+### Fixed (components — round-14 findings)
+
+- Scrollable-table header cells now become static on paper. The print
+  override follows the sticky-cell rule, so Chromium can repeat the semantic
+  `<thead>` at the top of continuation pages instead of painting it after the
+  rows.
+
+### Fixed (docs — round-14 findings)
+
+- The phone-record recipe now start-aligns numeric values in its label/value
+  branch, removes generated labels during narrow-viewport print emulation,
+  and resets sticky header cells while restoring the table.
+- The row-status recipe now includes semantic row headers
+  (`th[scope="row"]`) and uses `background-color`, preserving background
+  image layers such as the documented weekend-column shading.
+- The narrow-header recipe now states that it applies to mote's canonical
+  composition, where `.mote-row` owns the header row. Custom flex headers
+  need page-owned rules for their own structure.
+- Print guidance no longer implies that restoring `position: sticky`
+  guarantees a repeated running head; repetition depends on the browser's
+  paged-media implementation and the generated PDF must be inspected.
+- Clarified card flex behavior and bottom-aligned actions, inline SVG media
+  sizing, prose-heavy card-grid density, and badge scaling.
+
+### Tests
+
+- The regression fixture asserts that scrollable-table header cells are
+  static on paper.
+- Docs-source checks pin the phone-record print and numeric-alignment rules,
+  the row-header and background-color contract, and the canonical narrow
+  header row owner.
+
+### Evaluation
+
+- Fourteenth round: ten independent agents built ten new page types against
+  v0.10.8. All ten would use mote again. The builders' final pages had no
+  confirmed failures; remediation confirmed one library-facing print defect in
+  the scrollable-table header, fixed here alongside the documentation gaps
+  surfaced by the round.
+
 ## [0.10.8] - 2026-10-28
 
 ### Fixed (components — round-13 findings)
@@ -843,7 +930,9 @@ Components:
 - Opt-in helpers: `.mote-container`, `.mote-muted`, `.mote-note` surfaces.
 - Element gallery demo page (`demo.html`).
 
-[Unreleased]: https://gitlab.com/abmach/mote/compare/v0.10.8...HEAD
+[Unreleased]: https://gitlab.com/abmach/mote/compare/v0.11.0...HEAD
+[0.11.0]: https://gitlab.com/abmach/mote/compare/v0.10.9...v0.11.0
+[0.10.9]: https://gitlab.com/abmach/mote/compare/v0.10.8...v0.10.9
 [0.10.8]: https://gitlab.com/abmach/mote/compare/v0.10.7...v0.10.8
 [0.10.7]: https://gitlab.com/abmach/mote/compare/v0.10.6...v0.10.7
 [0.10.6]: https://gitlab.com/abmach/mote/compare/v0.10.5...v0.10.6

package/README.md

@@ -157,7 +157,7 @@ mote is class-optional by design — elements are styled from tags alone; these
 | Solid button on any element | `.mote-btn` — the full solid recipe for anchors, spans; status classes gated |
 | Hero centering | `.mote-hero` — vertically centers content for error/login/empty-state pages |
 | CTA bands | `.mote-band` — full-bleed tinted section; opaque in both themes, reads `--mote-status` |
-| Card cover media | `.mote-card-media` — flush-top cover images with matched radius |
+| Card cover media | `.mote-card-media` — flush-top cover images, video, or direct inline SVG with matched radius |
 | Brand/wordmark | `.mote-brand` — quiet non-nav link for site headers |
 | Media objects | `.mote-media` — avatar/icon beside body (flex, last child grows) |
 | Display text | `.mote-display` — opt-in hero/error-code scale via `--mote-display` |
@@ -170,6 +170,7 @@ mote is class-optional by design — elements are styled from tags alone; these
 | Pagination | `nav[aria-label="pagination"]` — semantic, no class |
 | Table of contents | `nav[aria-label="toc"]` — semantic, no class |
 | Current table row | `tr[aria-current]` — accent-tinted row, reads over zebra |
+| Status table row | `.mote-row-status` + a status class — paints direct cells while preserving background-image layers |
 | Footer baseline | `body > footer` — semantic top-border + padding; its `nav` renders as a quiet wrapped row |
 | Screen-reader helper | `.mote-sr-only` — pure hiding, never appears |
 | Skip link | `.mote-skip-link` — sr-only until focused, then a fixed pill |
@@ -184,7 +185,8 @@ mote is class-optional by design — elements are styled from tags alone; these
 | Breadcrumbs | `nav[aria-label="breadcrumb"]` — semantic, no class |
 | Card grids | `.mote-grid` — auto-fill columns from the container, no breakpoints |
 | Cards | `.mote-card` — normalizes content: alignment reads start even inside centered regions |
-| Badges | `.mote-badge` — gated: status from the badge's own class, never inherited; never grows past body scale |
+| Card actions | `.mote-card-actions` — bottom-aligns an action row inside a card without owning the row layout |
+| Badges | `.mote-badge` — gated: status from the badge's own class, never inherited; scales with surrounding text but never enlarges with headings |
 | Avatars | `.mote-avatar` |
 | Skeleton / spinner | `.mote-skeleton`, `.mote-spinner` |
 | Tooltips | `[popover].mote-tooltip` + `popovertarget` button |

package/mote.components.css

@@ -1,6 +1,6 @@
 /*!
  * mote.components.css — opt-in components for mote.css.
- * v0.10.8 · MIT
+ * v0.11.0 · MIT
  * https://gitlab.com/abmach/mote · mirror: https://github.com/abmach/mote
  *
  * Requires mote.css loaded first (provides the --mote-* tokens).
@@ -36,6 +36,13 @@
   margin-block-end: 0;
 }
 
+/* Bottom-align a card's action row without owning the row's layout.
+   .mote-card is a vertical flex column, so the auto margin consumes the
+   space above the actions. Pair with .mote-row for the row itself. */
+.mote-card-actions {
+  margin-block-start: auto;
+}
+
 /* Band: a full-bleed tinted section — CTA bands, section dividers,
    announcement strips. An opaque mix (unlike --mote-accent-soft, which is
    transparent and can vanish over dark backgrounds), so it reads as a
@@ -66,8 +73,8 @@
   display: inline-block;
   padding: 0.1rem 0.6rem;
   border-radius: 999px;
-  /* Never past body scale: 0.8em inside a heading balloons,
-     so clamp it — small contexts still scale down. */
+  /* Scale with the surrounding text, but never enlarge with headings:
+     0.8em balloons inside a heading, so cap it at 0.8rem. */
   font-size: min(0.8em, 0.8rem);
   font-weight: 500;
   line-height: 1.4;
@@ -169,8 +176,9 @@ a:where(.mote-badge):hover {
 }
 
 /* On paper the bar must not repeat over every sheet: a sticky header is
-   screen chrome, and the browser paints it on each page it can. Pages that
-   want a running head re-apply position: sticky in their own print CSS. */
+   screen chrome. A print-specific layout may restore sticky positioning,
+   but repeated running heads depend on the browser's paged-media behavior
+   and are not guaranteed by this library. */
 @media print {
   :where(body > header, .mote-header) {
     position: static;
@@ -392,6 +400,25 @@ nav[aria-label="toc"] a:hover {
   border-radius: inherit;
 }
 
+/* A direct inline SVG is a card cover too. Keep this direct-child only:
+   nested icons must keep their own dimensions. No fixed aspect ratio —
+   the SVG's viewBox determines the rendered height. */
+.mote-card-media > svg {
+  display: block;
+  width: 100%;
+  height: auto;
+  max-width: none;
+  border-radius: inherit;
+}
+
+/* Paint a status row's direct cells when the row opts in. Status classes
+   remain token carriers; this helper is the visual step. background-color
+   deliberately preserves any existing background-image layer. */
+tr.mote-row-status:is(.mote-success, .mote-warning, .mote-error, .mote-info)
+  > :is(td, th[scope="row"]) {
+  background-color: var(--mote-status-soft);
+}
+
 /* Scrollable table wrapper: sticky thead, no page scroll, no margin jump */
 .mote-table-scroll {
   overflow-x: auto;
@@ -399,13 +426,6 @@ nav[aria-label="toc"] a:hover {
   overflow-y: auto;
 }
 
-/* The components file owns this component's print behavior. Keep the
-   override after the screen rule so loading the optional file cannot
-   undo the core print promise. */
-@media print {
-  .mote-table-scroll { max-height: none; overflow: visible; }
-}
-
 /* Chromium paints collapsed borders at the original flow position,
    not with the sticky cell — separate borders belong to the cell. */
 .mote-table-scroll table {
@@ -420,6 +440,20 @@ nav[aria-label="toc"] a:hover {
   background: var(--mote-bg);
 }
 
+/* The components file owns this component's print behavior. Keep the
+   override after the sticky-cell rule so paper restores a normal table:
+   Chromium can repeat the semantic thead without sticky positioning. */
+@media print {
+  .mote-table-scroll {
+    max-height: none;
+    overflow: visible;
+  }
+
+  .mote-table-scroll thead th {
+    position: static;
+  }
+}
+
 /* Page footer: the quiet sibling of the site header */
 :where(body > footer, .mote-footer) {
   margin-block-start: 3rem;

package/mote.css

@@ -1,6 +1,6 @@
 /*!
  * mote.css — a mote of styling for plain HTML.
- * v0.10.8 · MIT
+ * v0.11.0 · MIT
  * https://gitlab.com/abmach/mote · mirror: https://github.com/abmach/mote
  *
  * The smallest thing that can carry style:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mote.css",
-  "version": "0.10.8",
+  "version": "0.11.0",
   "bugs": {
     "url": "https://gitlab.com/abmach/mote/-/issues"
   },