@mlola-ui/engine 1.0.11 → 1.0.13

package/generated/agents.json

@@ -341,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",

package/generated/agents.md

@@ -131,7 +131,7 @@ component, so a page built from them themes with the rest.
 
 - `.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
@@ -168,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

@@ -170,6 +170,9 @@
 
 .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. */
@@ -579,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%;
@@ -1437,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);
 }
@@ -1961,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%;
@@ -2100,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 {
@@ -3089,6 +3142,7 @@
 .ml-dropzone-root {
   display: grid;
   gap: var(--ml-space-2);
+  align-content: start;
 }
 
 .ml-dropzone {
@@ -3327,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,
@@ -3672,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;
@@ -3972,6 +4031,7 @@
   display: grid;
   gap: var(--ml-space-2);
   width: 100%;
+  align-content: start;
 }
 
 .ml-progress-root[data-tone="info"] {
@@ -4319,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 {
@@ -4340,6 +4401,7 @@
 .ml-radio-group-items {
   display: grid;
   gap: var(--ml-space-2-5);
+  align-content: start;
 }
 
 /* components/rating */
@@ -5032,6 +5094,7 @@
   display: grid;
   gap: var(--ml-space-2-5);
   width: 100%;
+  align-content: start;
 }
 
 .ml-slider-header {
@@ -5380,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);
@@ -6466,8 +6532,12 @@ button.ml-stepper-target:focus-visible {
   font-size: var(--ml-type-xs);
   font-weight: 500;
   line-height: 1.4;
-  white-space: nowrap;
+  /* One line when it fits; a long tip wraps within the window instead of running past it. */
+  width: max-content;
+  max-width: min(20rem, calc(100vw - 2 * var(--ml-space-2)));
+  white-space: normal;
   pointer-events: none;
+  /* Placement uses `translate`, so the pop-in's transform adds to it instead of replacing it mid-animation. */
   animation: ml-pop-in var(--ml-duration-fast) var(--ml-ease-spring);
 }
 
@@ -6475,25 +6545,25 @@ button.ml-stepper-target:focus-visible {
 .ml-tooltip:not([data-side]) {
   bottom: calc(100% + var(--ml-space-2));
   left: 50%;
-  transform: translateX(-50%);
+  translate: calc(-50% + var(--ml-tooltip-shift, 0px)) 0;
 }
 
 .ml-tooltip[data-side="bottom"] {
   top: calc(100% + var(--ml-space-2));
   left: 50%;
-  transform: translateX(-50%);
+  translate: calc(-50% + var(--ml-tooltip-shift, 0px)) 0;
 }
 
 .ml-tooltip[data-side="left"] {
   right: calc(100% + var(--ml-space-2));
   top: 50%;
-  transform: translateY(-50%);
+  translate: 0 calc(-50% + var(--ml-tooltip-shift, 0px));
 }
 
 .ml-tooltip[data-side="right"] {
   left: calc(100% + var(--ml-space-2));
   top: 50%;
-  transform: translateY(-50%);
+  translate: 0 calc(-50% + var(--ml-tooltip-shift, 0px));
 }
 
 .ml-tooltip-arrow {
@@ -6508,13 +6578,26 @@ button.ml-stepper-target:focus-visible {
 .ml-tooltip:not([data-side]) .ml-tooltip-arrow {
   bottom: -.2rem;
   left: 50%;
-  margin-left: calc(var(--ml-space-1) * -1);
+  margin-left: calc(var(--ml-space-1) * -1 - var(--ml-tooltip-shift, 0px));
 }
 
 .ml-tooltip[data-side="bottom"] .ml-tooltip-arrow {
   top: -.2rem;
   left: 50%;
-  margin-left: calc(var(--ml-space-1) * -1);
+  margin-left: calc(var(--ml-space-1) * -1 - var(--ml-tooltip-shift, 0px));
+}
+
+/* The arrow slides back by the tooltip's shift, so it keeps pointing at the trigger. */
+.ml-tooltip[data-side="left"] .ml-tooltip-arrow {
+  right: -.2rem;
+  top: 50%;
+  margin-top: calc(var(--ml-space-1) * -1 - var(--ml-tooltip-shift, 0px));
+}
+
+.ml-tooltip[data-side="right"] .ml-tooltip-arrow {
+  left: -.2rem;
+  top: 50%;
+  margin-top: calc(var(--ml-space-1) * -1 - var(--ml-tooltip-shift, 0px));
 }
 
 /* components/tour */

package/package.json

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