@mlola-ui/engine 1.0.10 → 1.0.12

package/generated/agents.json

@@ -255,6 +255,10 @@
       "name": "ml-chart-heading",
       "note": ""
     },
+    {
+      "name": "ml-check-list",
+      "note": "A list of benefits, each after a check. Pricing tiers and feature rows share it."
+    },
     {
       "name": "ml-cluster",
       "note": ""
@@ -337,7 +341,7 @@
     },
     {
       "name": "ml-page-shell",
-      "note": "A full page: header, main and footer stacked on the page background."
+      "note": "The navigation, main and footer are grid items; they may be narrower than their widest content (a table that scrolls), so the page never does."
     },
     {
       "name": "ml-person",
@@ -361,7 +365,7 @@
     },
     {
       "name": "ml-section",
-      "note": ""
+      "note": "A section a link jumps to clears the sticky navigation bar."
     },
     {
       "name": "ml-section-description",

package/generated/agents.md

@@ -127,10 +127,12 @@ Compose pages from these before writing layout CSS: sections, stacks,
 clusters, grids, headings, forms, stats. They read the same tokens as every
 component, so a page built from them themes with the rest.
 
-`.ml-actions` `.ml-brand` `.ml-brand-mark` `.ml-brand-name` `.ml-chart` `.ml-chart-bar` `.ml-chart-bars` `.ml-chart-heading` `.ml-cluster` `.ml-definition-list` `.ml-display` `.ml-divider` `.ml-empty-state` `.ml-eyebrow` `.ml-filter-chip` `.ml-filter-group` `.ml-fine-print` `.ml-form` `.ml-form-message` `.ml-form-options` `.ml-grid` `.ml-heading` `.ml-icon-chip` `.ml-inline-form` `.ml-inline-form-field` `.ml-label` `.ml-lede` `.ml-link` `.ml-page-shell` `.ml-person` `.ml-person-copy` `.ml-positive` `.ml-price` `.ml-required-mark` `.ml-section` `.ml-section-description` `.ml-section-header` `.ml-section-header-centered` `.ml-section-muted` `.ml-section-shell` `.ml-stack` `.ml-stat` `.ml-stat-card` `.ml-stat-grid` `.ml-stat-list` `.ml-stat-meta` `.ml-stat-value` `.ml-text-primary` `.ml-value`
+`.ml-actions` `.ml-brand` `.ml-brand-mark` `.ml-brand-name` `.ml-chart` `.ml-chart-bar` `.ml-chart-bars` `.ml-chart-heading` `.ml-check-list` `.ml-cluster` `.ml-definition-list` `.ml-display` `.ml-divider` `.ml-empty-state` `.ml-eyebrow` `.ml-filter-chip` `.ml-filter-group` `.ml-fine-print` `.ml-form` `.ml-form-message` `.ml-form-options` `.ml-grid` `.ml-heading` `.ml-icon-chip` `.ml-inline-form` `.ml-inline-form-field` `.ml-label` `.ml-lede` `.ml-link` `.ml-page-shell` `.ml-person` `.ml-person-copy` `.ml-positive` `.ml-price` `.ml-required-mark` `.ml-section` `.ml-section-description` `.ml-section-header` `.ml-section-header-centered` `.ml-section-muted` `.ml-section-shell` `.ml-stack` `.ml-stat` `.ml-stat-card` `.ml-stat-grid` `.ml-stat-list` `.ml-stat-meta` `.ml-stat-value` `.ml-text-primary` `.ml-value`
 
+- `.ml-check-list` — A list of benefits, each after a check. Pricing tiers and feature rows share it.
 - `.ml-link` — A glyph inside a link flows with the text instead of breaking the line.
-- `.ml-page-shell` — A full page: header, main and footer stacked on the page background.
+- `.ml-page-shell` — The navigation, main and footer are grid items; they may be narrower than their widest content (a table that scrolls), so the page never does.
+- `.ml-section` — A section a link jumps to clears the sticky navigation bar.
 
 ## Elements and their attributes
 
@@ -166,6 +168,7 @@ correct. This table is read out of the stylesheet, so it is never stale.
 | `.ml-calendar-day` | `data-unreachable` | _presence only_ |
 | `.ml-card` | `data-interactive` | _presence only_ |
 | `.ml-card` | `data-variant` | `elevated`, `glass`, `specular` |
+| `.ml-carousel` | `data-arrows` | _presence only_ |
 | `.ml-carousel` | `data-playing` | _presence only_ |
 | `.ml-carousel-arrow` | `data-side` | `next`, `previous` |
 | `.ml-carousel-dot` | `aria-current` | `true` |

package/generated/assets.json

@@ -1431,14 +1431,14 @@
             {
               "path": "empty-cart.svg",
               "role": "source",
-              "bytes": 4968,
-              "integrity": "sha256-D0zyZvimuFagUT0ChqyBNp2hsCjAZ4Pv7RW6cJ37gcE="
+              "bytes": 4982,
+              "integrity": "sha256-8m4Z0HWSI7KRjDc6MSHRrCI1HwbiyynBmoxgCyo2DDw="
             },
             {
               "path": "empty-cart.tsx",
               "role": "react",
-              "bytes": 5920,
-              "integrity": "sha256-fapGlGqTLVX54EYazXYKN+vxVbbYN9RP3t4qDLnN1/g="
+              "bytes": 5934,
+              "integrity": "sha256-CFip8M6D6RJdYVGIwQ6H3HwWek/dHTq9ON98SeHjS4Q="
             }
           ],
           "themeable": true,
@@ -1617,7 +1617,7 @@
           "id": "inventory",
           "kind": "2d",
           "title": "Inventory",
-          "summary": "Shelved parcels with labels, counted slots and an active stock marker.",
+          "summary": "An open shelf of labeled parcels, one empty slot and a tag marking the stock that is ready.",
           "tags": [
             "inventory",
             "warehouse",
@@ -1627,14 +1627,14 @@
             {
               "path": "inventory.svg",
               "role": "source",
-              "bytes": 4558,
-              "integrity": "sha256-lpe+xybY6if62AE7jyrc531zeQuQiZWvB6bZ8LNSAuE="
+              "bytes": 9461,
+              "integrity": "sha256-PrHqQsxeEtVKhftidsFZpr2XMIWx2oMgKhsd0dGKXSQ="
             },
             {
               "path": "inventory.tsx",
               "role": "react",
-              "bytes": 5532,
-              "integrity": "sha256-si0HLYrwRJ07wZH2lNuvUhxhhNGFtihT8S21fClz4sY="
+              "bytes": 10590,
+              "integrity": "sha256-WH+stRnsQsNF8bWuVpZAoqkjthF3JNM/FEQ3aw2G6Lg="
             }
           ],
           "themeable": true,
@@ -1869,7 +1869,7 @@
           "id": "offline",
           "kind": "2d",
           "title": "Offline",
-          "summary": "A small wireless router and a disconnected cable. Connection paused, ready to reconnect.",
+          "summary": "A wireless router that has lost its signal and a disconnected cable. Connection paused, ready to reconnect.",
           "tags": [
             "error",
             "network",
@@ -1879,14 +1879,14 @@
             {
               "path": "offline.svg",
               "role": "source",
-              "bytes": 4202,
-              "integrity": "sha256-2sWn+8fJD4xEyp/D+Po2wAIUJVufv9EGmu4cQYmFCRg="
+              "bytes": 4560,
+              "integrity": "sha256-q0ZZ4EKo8a+56sIAtcGyjni7yVhxyD6yMYwSlDaWqRQ="
             },
             {
               "path": "offline.tsx",
               "role": "react",
-              "bytes": 5132,
-              "integrity": "sha256-4fui9gRQW3U+pMsibh1vg8b3jmHvnpxQRXqmAiSNA04="
+              "bytes": 5517,
+              "integrity": "sha256-G1ys9dW4cJg6CjD3Gj1aJ2InQus4zYClR45jExmITSg="
             }
           ],
           "themeable": true,
@@ -2897,14 +2897,14 @@
             {
               "path": "measuring-tape.glb",
               "role": "source",
-              "bytes": 592628,
-              "integrity": "sha256-gjp8OVIjpEbmo0zeegc7p9W+gkYGeNqwETxuBfE43Js="
+              "bytes": 445392,
+              "integrity": "sha256-VsiwX1rsnRBGeE28vd1LuoqIZSF5OVqvDjy9fgwbLNk="
             },
             {
               "path": "measuring-tape-poster.webp",
               "role": "poster",
-              "bytes": 16086,
-              "integrity": "sha256-Ygzmwy/ttH5//dWsBUTsR+4XGQlD/YpodjI6y9caXuo="
+              "bytes": 18308,
+              "integrity": "sha256-Nmmtp3upafknGSg3V57I1GEBf+yMRCBVBmIsSGXKlks="
             }
           ],
           "themeable": true,
@@ -3209,14 +3209,14 @@
             {
               "path": "task-lamp.glb",
               "role": "source",
-              "bytes": 283168,
-              "integrity": "sha256-hAolZPXrmhkMW0DjUx/aB4iXTEBm3YFDnoTzOqsMtMc="
+              "bytes": 283120,
+              "integrity": "sha256-mQVMpISa78gjVjYSbzsY9IOzZjTQVwl2n/YrCCdVOf0="
             },
             {
               "path": "task-lamp-poster.webp",
               "role": "poster",
-              "bytes": 16676,
-              "integrity": "sha256-KczARj6DGDO6U9YrYZ5LLTKCHK922mbXLvJtcmeMEfQ="
+              "bytes": 17958,
+              "integrity": "sha256-IQot+k4DZEqTkOknca5ZxH4dqPjpE4xyeJWxGANl6yM="
             }
           ],
           "themeable": true,

package/generated/contract.json

@@ -114,6 +114,7 @@
         ]
       },
       "ml-carousel": {
+        "data-arrows": [],
         "data-playing": []
       },
       "ml-carousel-arrow": {

package/generated/recipes.css

@@ -145,8 +145,39 @@
   gap: var(--ml-space-2);
 }
 
+/* A list of benefits, each after a check. Pricing tiers and feature rows share it. */
+.ml-check-list {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+  display: grid;
+  gap: var(--ml-space-2);
+}
+
+.ml-check-list li {
+  display: flex;
+  align-items: flex-start;
+  gap: var(--ml-space-2);
+  font-size: var(--ml-type-base);
+  color: var(--ml-text-muted);
+}
+
+.ml-check-list li > svg {
+  flex: none;
+  margin-top: 0.2em;
+  color: var(--ml-success-text);
+}
+
 .ml-section {
   padding-block: clamp(3.5rem,8vw,6.5rem);
+  /* A section is a grid or flex item in a page shell; without this, a wide
+     table inside it widens the whole page instead of scrolling in place. */
+  min-width: 0;
+}
+
+/* A section a link jumps to clears the sticky navigation bar. */
+.ml-section[id] {
+  scroll-margin-block-start: calc(var(--ml-control-md) + var(--ml-space-6));
 }
 
 .ml-section-shell {
@@ -551,6 +582,12 @@
   color: var(--ml-text);
 }
 
+/* The navigation, main and footer are grid items; they may be narrower than
+   their widest content (a table that scrolls), so the page never does. */
+.ml-page-shell > * {
+  min-width: 0;
+}
+
 /* components/accordion */
 .ml-accordion {
   width: 100%;
@@ -1409,15 +1446,41 @@
 
 .ml-breadcrumb-item {
   display: inline-flex;
+  min-width: 0;
   align-items: center;
   gap: var(--ml-space-1-5);
 }
 
+/* Links, in-app buttons and the current page share one shape; a long title shortens instead of breaking the bar. */
+.ml-breadcrumb-link,
+.ml-breadcrumb-page {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--ml-space-1);
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
 .ml-breadcrumb-link {
   color: var(--ml-text-muted);
   text-decoration: none;
 }
 
+button.ml-breadcrumb-link {
+  padding: 0;
+  border: 0;
+  border-radius: var(--ml-radius-xs);
+  background: none;
+  font: inherit;
+  cursor: pointer;
+}
+
+.ml-breadcrumb-icon {
+  flex: none;
+}
+
 .ml-breadcrumb-link:hover {
   color: var(--ml-text);
 }
@@ -1933,7 +1996,24 @@
   height: 100%;
 }
 
-/* Arrows float over the edges and come forward when the reader is near. */
+/* With a pointer that hovers, the arrows sit in a gutter beside the slides,
+   never over them. On touch the reader swipes, the arrows stay hidden until
+   focused, and the slides keep the full width. */
+@media (hover: hover) and (pointer: fine) {
+  .ml-carousel[data-arrows] .ml-carousel-viewport {
+    padding-inline: calc(var(--ml-control-md) + var(--ml-space-3));
+  }
+
+  .ml-carousel[data-arrows] .ml-carousel-arrow[data-side="previous"] {
+    left: 0;
+  }
+
+  .ml-carousel[data-arrows] .ml-carousel-arrow[data-side="next"] {
+    right: 0;
+  }
+}
+
+/* The arrows come forward when the reader is near. */
 .ml-carousel-arrow {
   position: absolute;
   top: 50%;
@@ -2072,6 +2152,7 @@
   grid-template-columns: auto 1fr;
   gap: var(--ml-space-1-5) var(--ml-space-3);
   align-items: start;
+  align-content: start;
 }
 
 .ml-checkbox-control {
@@ -3061,6 +3142,7 @@
 .ml-dropzone-root {
   display: grid;
   gap: var(--ml-space-2);
+  align-content: start;
 }
 
 .ml-dropzone {
@@ -3299,6 +3381,8 @@
   grid-template-columns: minmax(0, 1fr);
   gap: var(--ml-space-1-5);
   width: 100%;
+  /* In a form row taller than itself, a field keeps its own height instead of stretching its label and control apart. */
+  align-content: start;
 }
 
 .ml-input,
@@ -3449,6 +3533,13 @@
   pointer-events: none;
 }
 
+/* A text affix ("https://", a domain, a unit) reads at the size of what is typed beside it. */
+.ml-input-leading,
+.ml-input-trailing {
+  font-size: var(--ml-type-base);
+  line-height: var(--ml-leading-snug);
+}
+
 /* components/kbd */
 .ml-kbd {
   display: inline-grid;
@@ -3637,9 +3728,12 @@
   border-inline-start: var(--ml-border-width) solid var(--ml-border-subtle);
 }
 
+/* Square at any height: where touch sizing makes the field taller, the steps
+   grow with it instead of stretching into tall slivers. */
 .ml-number-input-step {
   display: inline-grid;
-  width: var(--ml-control-md);
+  min-width: var(--ml-control-md);
+  aspect-ratio: 1;
   place-items: center;
   padding: 0;
   border: 0;
@@ -3937,6 +4031,7 @@
   display: grid;
   gap: var(--ml-space-2);
   width: 100%;
+  align-content: start;
 }
 
 .ml-progress-root[data-tone="info"] {
@@ -4284,6 +4379,7 @@
   display: grid;
   gap: var(--ml-space-3);
   width: 100%;
+  align-content: start;
 }
 
 .ml-radio-group[data-orientation="horizontal"] .ml-radio-group-items {
@@ -4305,6 +4401,7 @@
 .ml-radio-group-items {
   display: grid;
   gap: var(--ml-space-2-5);
+  align-content: start;
 }
 
 /* components/rating */
@@ -4486,6 +4583,8 @@
   position: relative;
   display: grid;
   grid-template-columns: minmax(0, 1fr);
+  /* In a form row taller than itself, the trigger keeps a field's height instead of stretching. */
+  align-content: start;
   gap: var(--ml-space-1-5);
   width: 100%;
   min-width: 0;
@@ -4510,6 +4609,10 @@
   border: var(--ml-border-width) solid var(--ml-border);
   border-radius: var(--ml-radius-md);
   box-shadow: var(--ml-shadow-xs);
+  /* The same type as a text field, so a select and an input sit level in a row. */
+  font-family: var(--ml-font-sans);
+  font-size: var(--ml-type-base);
+  line-height: var(--ml-leading-snug);
   cursor: pointer;
   text-align: start;
   transition: border-color var(--ml-duration-fast),box-shadow var(--ml-duration-fast);
@@ -4991,6 +5094,7 @@
   display: grid;
   gap: var(--ml-space-2-5);
   width: 100%;
+  align-content: start;
 }
 
 .ml-slider-header {
@@ -5339,6 +5443,9 @@ button.ml-stepper-target:focus-visible {
 
 /* components/table */
 .ml-table-container {
+  /* The containing block for anything positioned inside, such as visually
+     hidden cell text, so it scrolls with the table instead of widening the page. */
+  position: relative;
   width: 100%;
   overflow-x: auto;
   border: var(--ml-border-width) solid var(--ml-border-subtle);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mlola-ui/engine",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Framework-free CSS, spring easings, and the machine-readable contract for Mlola UI",
   "type": "module",
   "sideEffects": [