@yewdiel21/motion-kit 0.18.0 → 0.19.1

package/src/components/scroll-area/scroll-area.css

@@ -0,0 +1,260 @@
+/* scroll-area — the scroller keeps native scrolling with its system bar hidden; the kit's bars ride on top: a 6 px pill
+   (text at 32 %) that shows while hovered or scrolling, swells to 10 px over a tonal rail on the swing curve and turns the
+   accent while dragged. Edges with more content fade out; an optional tonal pill takes the view back to the top. */
+@property --mk-scroll-thickness {
+  syntax: '<length>';
+  inherits: true;
+  initial-value: 6px;
+}
+
+.mk-scroll-area,
+mk-scroll-area {
+  --mk-scroll-thumb: color-mix(in srgb, var(--mk-text) 32%, transparent);
+  --mk-scroll-thumb-hover: color-mix(in srgb, var(--mk-text) 48%, transparent);
+  --mk-scroll-rail: color-mix(in srgb, var(--mk-text) 6%, transparent);
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  min-height: 0;
+  overflow: hidden;
+}
+
+/* Its own viewport fills the area (a height or a max-height on the area both work). */
+:is(.mk-scroll-area, mk-scroll-area) > [data-mk-scroll-viewport] {
+  flex: 1 1 auto;
+  min-width: 0;
+  min-height: 0;
+  overflow: auto;
+  overscroll-behavior: contain;
+  border-radius: inherit;
+  outline: none;
+}
+
+:is(.mk-scroll-area, mk-scroll-area)[data-mk-scroll-axis='y'] > [data-mk-scroll-viewport] {
+  overflow-x: hidden;
+}
+
+:is(.mk-scroll-area, mk-scroll-area)[data-mk-scroll-axis='x'] > [data-mk-scroll-viewport] {
+  overflow-y: hidden;
+}
+
+[data-mk-scroll-anchor] {
+  position: relative;
+}
+
+/* The kit's bars replace the system's wherever the scroller's own styles asked for a thin one. */
+[data-mk-scroll-viewport] {
+  scrollbar-width: none !important;
+}
+
+[data-mk-scroll-viewport]::-webkit-scrollbar {
+  display: none !important;
+}
+
+[data-mk-scroll-area]:has(> [data-mk-scroll-viewport]:focus-visible) {
+  outline: 2px solid var(--mk-accent);
+  outline-offset: 2px;
+}
+
+/* Edge fades: as deep as what is hidden past each edge, up to 24 px (written by the engine). */
+[data-mk-fade] > [data-mk-scroll-viewport] {
+  --mk-scroll-fade-top: 0px;
+  --mk-scroll-fade-right: 0px;
+  --mk-scroll-fade-bottom: 0px;
+  --mk-scroll-fade-left: 0px;
+  -webkit-mask-image:
+    linear-gradient(to bottom, transparent, #000 var(--mk-scroll-fade-top), #000 calc(100% - var(--mk-scroll-fade-bottom)), transparent),
+    linear-gradient(to right, transparent, #000 var(--mk-scroll-fade-left), #000 calc(100% - var(--mk-scroll-fade-right)), transparent);
+  -webkit-mask-composite: source-in;
+  mask-image:
+    linear-gradient(to bottom, transparent, #000 var(--mk-scroll-fade-top), #000 calc(100% - var(--mk-scroll-fade-bottom)), transparent),
+    linear-gradient(to right, transparent, #000 var(--mk-scroll-fade-left), #000 calc(100% - var(--mk-scroll-fade-right)), transparent);
+  mask-composite: intersect;
+}
+
+/* Rails: a 14 px grip along the edge; its tonal rail and the pill inside are drawn smaller. */
+[data-mk-scroll-rail] {
+  --mk-scroll-thickness: 6px;
+  position: absolute;
+  z-index: 2;
+  opacity: 0;
+  touch-action: none;
+  -webkit-user-select: none;
+  user-select: none;
+  transition:
+    opacity 0.2s ease,
+    --mk-scroll-thickness 0.35s var(--mk-ease-swatch);
+}
+
+[data-mk-scroll-rail][hidden] {
+  display: none;
+}
+
+/* The rails run along the viewport's box inside the root (--mk-scroll-view-*, written by the engine);
+   --mk-scroll-inset keeps their ends clear of rounded corners. */
+[data-mk-scroll-rail][data-mk-axis='y'] {
+  top: calc(var(--mk-scroll-view-top, 0px) + var(--mk-scroll-inset, 6px));
+  right: var(--mk-scroll-view-right, 0px);
+  bottom: calc(var(--mk-scroll-view-bottom, 0px) + var(--mk-scroll-inset, 6px));
+  width: 14px;
+}
+
+[data-mk-scroll-rail][data-mk-axis='x'] {
+  right: calc(var(--mk-scroll-view-right, 0px) + var(--mk-scroll-inset, 6px));
+  bottom: var(--mk-scroll-view-bottom, 0px);
+  left: calc(var(--mk-scroll-view-left, 0px) + var(--mk-scroll-inset, 6px));
+  height: 14px;
+}
+
+/* Both bars: each stops short of the other, no corner square. */
+[data-mk-overflow-x] > [data-mk-scroll-rail][data-mk-axis='y'] {
+  bottom: calc(var(--mk-scroll-view-bottom, 0px) + 14px);
+}
+
+[data-mk-overflow-y] > [data-mk-scroll-rail][data-mk-axis='x'] {
+  right: calc(var(--mk-scroll-view-right, 0px) + 14px);
+}
+
+[data-mk-active] > [data-mk-scroll-rail],
+[data-mk-scroll-rail]:hover,
+[data-mk-scroll-rail][data-mk-dragging] {
+  opacity: 1;
+}
+
+[data-mk-scroll-rail]:hover,
+[data-mk-scroll-rail][data-mk-dragging] {
+  --mk-scroll-thickness: 10px;
+}
+
+[data-mk-scroll-rail]::before {
+  content: '';
+  position: absolute;
+  border-radius: 999px;
+  background: var(--mk-scroll-rail, color-mix(in srgb, var(--mk-text) 6%, transparent));
+  opacity: 0;
+  transition: opacity 0.2s ease;
+}
+
+[data-mk-scroll-rail][data-mk-axis='y']::before {
+  top: 0;
+  right: 2px;
+  bottom: 0;
+  width: 10px;
+}
+
+[data-mk-scroll-rail][data-mk-axis='x']::before {
+  right: 0;
+  bottom: 2px;
+  left: 0;
+  height: 10px;
+}
+
+[data-mk-scroll-rail]:hover::before,
+[data-mk-scroll-rail][data-mk-dragging]::before {
+  opacity: 1;
+}
+
+[data-mk-scroll-thumb] {
+  position: absolute;
+  top: 0;
+  left: 0;
+  cursor: grab;
+  will-change: transform;
+}
+
+[data-mk-scroll-rail][data-mk-axis='y'] [data-mk-scroll-thumb] {
+  width: 100%;
+}
+
+[data-mk-scroll-rail][data-mk-axis='x'] [data-mk-scroll-thumb] {
+  height: 100%;
+}
+
+[data-mk-scroll-rail][data-mk-dragging] [data-mk-scroll-thumb] {
+  cursor: grabbing;
+}
+
+/* The pill stays centred on the 10 px rail while it swells. */
+[data-mk-scroll-pill] {
+  position: absolute;
+  border-radius: 999px;
+  background: var(--mk-scroll-thumb, color-mix(in srgb, var(--mk-text) 32%, transparent));
+  transition: background-color 0.2s ease;
+}
+
+[data-mk-scroll-rail][data-mk-axis='y'] [data-mk-scroll-pill] {
+  top: 0;
+  right: calc(2px + (10px - var(--mk-scroll-thickness)) / 2);
+  bottom: 0;
+  width: var(--mk-scroll-thickness);
+}
+
+[data-mk-scroll-rail][data-mk-axis='x'] [data-mk-scroll-pill] {
+  right: 0;
+  bottom: calc(2px + (10px - var(--mk-scroll-thickness)) / 2);
+  left: 0;
+  height: var(--mk-scroll-thickness);
+}
+
+[data-mk-scroll-rail]:hover [data-mk-scroll-pill] {
+  background: var(--mk-scroll-thumb-hover, color-mix(in srgb, var(--mk-text) 48%, transparent));
+}
+
+[data-mk-scroll-rail][data-mk-dragging] [data-mk-scroll-pill] {
+  background: var(--mk-scroll-thumb-active, var(--mk-accent));
+}
+
+[data-mk-dragging] [data-mk-scroll-viewport] {
+  -webkit-user-select: none;
+  user-select: none;
+}
+
+/* Back to top: a tonal pill in the corner, clear of the bars. */
+[data-mk-scroll-top] {
+  position: absolute;
+  z-index: 3;
+  right: calc(var(--mk-scroll-view-right, 0px) + 20px);
+  bottom: calc(var(--mk-scroll-view-bottom, 0px) + 16px);
+  display: inline-grid;
+  place-items: center;
+  width: 40px;
+  height: 40px;
+  padding: 0;
+  border: 0;
+  border-radius: 999px;
+  background: var(--mk-surface-4);
+  box-shadow: 0 8px 24px -8px color-mix(in srgb, var(--mk-shadow-color, #000) 45%, transparent);
+  color: var(--mk-text);
+  cursor: pointer;
+  transition:
+    background-color 0.15s,
+    box-shadow 0.2s;
+}
+
+[data-mk-overflow-x] > [data-mk-scroll-top] {
+  bottom: calc(var(--mk-scroll-view-bottom, 0px) + 22px);
+}
+
+[data-mk-scroll-top][hidden] {
+  display: none;
+}
+
+[data-mk-scroll-top]:hover {
+  background: color-mix(in srgb, var(--mk-surface-4) 80%, var(--mk-text) 10%);
+}
+
+[data-mk-scroll-top]:focus-visible {
+  outline: none;
+  box-shadow:
+    0 0 0 3px color-mix(in srgb, var(--mk-accent) 45%, transparent),
+    0 8px 24px -8px color-mix(in srgb, var(--mk-shadow-color, #000) 45%, transparent);
+}
+
+@media (prefers-reduced-motion: reduce) {
+  [data-mk-scroll-rail],
+  [data-mk-scroll-rail]::before,
+  [data-mk-scroll-pill],
+  [data-mk-scroll-top] {
+    transition: none;
+  }
+}

package/src/components/scroll-island/engine.ts

@@ -129,7 +129,12 @@ export function createScrollIsland(root: HTMLElement | null, options: ScrollIsla
     const size = as === 'island' ? ISLAND_HEIGHT : Math.max(MIN_BAR, Math.min(height, height * (scroller.clientHeight / Math.max(1, scroller.scrollHeight))));
     const top = (height - size) * progress();
     if (as !== 'island') return { top, height: size, width: BAR_WIDTH, borderRadius: BAR_WIDTH / 2 };
-    return { top, height: size, width: Math.min(Math.max(ISLAND_HEIGHT, track().right - track().left - INSET * 2), Math.max(ISLAND_HEIGHT, content.scrollWidth + 28)), borderRadius: size / 2 };
+    // Measure at the content's natural width, independent of the collapsed bar
+    // or an interrupted expansion. Padding is already included in offsetWidth.
+    content.style.maxWidth = 'none';
+    const width = content.offsetWidth;
+    content.style.removeProperty('max-width');
+    return { top, height: size, width: Math.min(Math.max(ISLAND_HEIGHT, track().right - track().left - INSET * 2), Math.max(ISLAND_HEIGHT, width)), borderRadius: size / 2 };
   };
 
   const place = () => {
@@ -189,6 +194,10 @@ export function createScrollIsland(root: HTMLElement | null, options: ScrollIsla
   scope.on(window, 'resize', () => go(state, true));
 
   const near = (x: number, y: number) => {
+    if (state === 'island') {
+      const capsule = thumb.getBoundingClientRect();
+      if (x >= capsule.left && x <= capsule.right && y >= capsule.top && y <= capsule.bottom) return true;
+    }
     const box = track();
     return y >= box.top - INSET && y <= box.top + box.height + INSET && x <= box.right && box.right - x <= reach;
   };

package/src/components/scroll-island/scroll-island.css

@@ -73,6 +73,8 @@ mk-scroll-island {
 [data-mk-island-content] {
   display: inline-flex;
   flex: none;
+  box-sizing: border-box;
+  width: max-content;
   max-width: 100%;
   min-width: 0;
   align-items: center;
@@ -87,6 +89,10 @@ mk-scroll-island {
   transition: opacity 0.18s ease;
 }
 
+[data-mk-island-percent] {
+  flex: none;
+}
+
 [data-mk-scroll-island][data-mk-state='island'] [data-mk-island-content] {
   opacity: 1;
   transition-delay: 0.1s;

package/src/components/select/README.md

@@ -1,6 +1,6 @@
 # select
 
-Una elección de una lista que se abre como el `menu` del kit (crece desde su botón y las opciones entran escalonadas) en lugar de la lista del sistema. Mejora un `<select>` escrito a mano, o crea uno desde `options`, y lo mantiene sincronizado y oculto: los formularios lo envían y sus escuchas de `change` siguen funcionando. El valor elegido entra con un blur breve y el chevron gira.
+Una elección de una lista que se abre como el `menu` del kit (crece desde su botón y las opciones entran escalonadas) en lugar de la lista del sistema. Mejora un `<select>` escrito a mano, o crea uno desde `options`, y lo mantiene sincronizado y oculto: los formularios lo envían y sus escuchas de `change` siguen funcionando. El valor elegido entra con un blur breve y el chevron gira. Una lista larga se desplaza con la barra de [`scroll-area`](../scroll-area/README.md), no con la del sistema; respeta las esquinas redondeadas del menú y funde los bordes.
 
 ## HTML / Astro
 

package/src/components/select/engine.ts

@@ -4,6 +4,7 @@ import { createScope } from '../../core/scope';
 import { inert, type Instance } from '../../core/types';
 import { press } from '../../motion/micro';
 import { createMenu } from '../menu/engine';
+import { createScrollArea } from '../scroll-area/engine';
 
 /*
  * Select: one choice from a list, opened as the kit's menu (it grows out of its
@@ -12,8 +13,9 @@ import { createMenu } from '../menu/engine';
  * step: forms post it and its `change` listeners keep working) or builds one from
  * `options`. The chosen label slides in out of a blur, the chevron turns, typing
  * a letter on the closed button picks the next option that starts with it, and
- * ↓ ↑ Enter Space open the menu. Changes made to the select's options (by the app)
- * show up on their own.
+ * ↓ ↑ Enter Space open the menu. A long list scrolls under the kit's scroll-area
+ * bar (no system bar on the menu's rounded edge) with its edges fading out.
+ * Changes made to the select's options (by the app) show up on their own.
  */
 
 export interface SelectOption {
@@ -121,6 +123,10 @@ export function createSelect(root: HTMLElement | null, options: SelectOptions =
   dialog.className = 'mk-dialog mk-menu mk-select-menu';
   dialog.dataset.mkSelectMenu = '';
   dialog.setAttribute('aria-label', options.label ?? 'Opciones');
+  // The items scroll inside a list, so the bar rides over the menu instead of cutting its rounded edge.
+  const list = document.createElement('div');
+  list.dataset.mkSelectList = '';
+  dialog.append(list);
   root.append(dialog);
   made.push(dialog);
   scope.attr(root, 'data-mk-ready', '');
@@ -161,7 +167,7 @@ export function createSelect(root: HTMLElement | null, options: SelectOptions =
         nodes.push(heading, ...[...child.children].filter((node): node is HTMLOptionElement => node instanceof HTMLOptionElement).map(item));
       } else if (child instanceof HTMLOptionElement) nodes.push(item(child));
     }
-    dialog.replaceChildren(...nodes);
+    list.replaceChildren(...nodes);
   };
 
   const placeholderText = () => options.placeholder ?? choices().find((option) => option.value === '')?.text ?? 'Elige…';
@@ -201,13 +207,19 @@ export function createSelect(root: HTMLElement | null, options: SelectOptions =
     root.dispatchEvent(new CustomEvent('mk:change', { bubbles: true, detail: { value } }));
   };
 
+  // The menu's children must be its items: the bar stays out of assistive tech (the list scrolls with the keys).
+  const area = createScrollArea(dialog, { viewport: list, axis: 'y', focusable: false, decorative: true });
   const menu = createMenu(dialog, {
     triggers: false,
-    onOpen: markItems,
+    onOpen: () => {
+      markItems();
+      area.refresh();
+    },
     onClose: () => trigger.setAttribute('aria-expanded', 'false'),
     onSelect: (value) => choose(value, true),
   });
   scope.add(() => menu.destroy());
+  scope.add(() => area.destroy());
   // The menu's own selection stays inside: listeners on the select hear its change.
   scope.on(dialog, 'mk:select', (event) => event.stopPropagation());
 

package/src/components/select/select.css

@@ -72,20 +72,38 @@ mk-select {
   transform: rotate(180deg);
 }
 
-/* The menu: like the panels of the data table (surface-1, a hairline, 8 px items). */
+/* The menu: like the panels of the data table (surface-1, a hairline, 8 px items). The items scroll in a list with the
+   kit's scroll-area bar, kept clear of the rounded corners; the system bar never shows. */
 .mk-dialog.mk-select-menu {
   --mk-dialog-bg: var(--mk-surface-1);
   --mk-dialog-radius: 16px;
   --mk-dialog-shadow: 0 0 0 1px var(--mk-outline-soft), 0 16px 48px -12px color-mix(in srgb, var(--mk-shadow-color, #000) 35%, transparent);
-  gap: 0.125rem;
+  --mk-scroll-inset: 10px;
   min-width: max(10rem, var(--mk-select-width, 0px));
   max-height: min(20rem, 60dvh);
-  padding: 0.375rem;
-  overflow-y: auto;
+  padding: 0;
+  overflow: hidden;
   -webkit-backdrop-filter: none;
   backdrop-filter: none;
 }
 
+.mk-dialog.mk-select-menu [data-mk-select-list] {
+  display: flex;
+  flex: 1 1 auto;
+  flex-direction: column;
+  gap: 0.125rem;
+  min-height: 0;
+  padding: 0.375rem;
+  overflow-x: hidden;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+}
+
+/* A long list leaves the bar its own lane. */
+.mk-dialog.mk-select-menu[data-mk-overflow-y] [data-mk-select-list] {
+  padding-inline-end: 0.875rem;
+}
+
 .mk-dialog.mk-select-menu [data-mk-item] {
   flex: none;
   gap: 0.625rem;

package/src/core/timing.ts

@@ -200,4 +200,6 @@ export const TIMING = Object.freeze({
   repelBento: Object.freeze({ offset: 0.6, stagger: 0.006, strength: 5000, distance: 30, breakpoint: 1024 }),
   rotator: Object.freeze({ interval: 8000, duration: 0.25, y: 5 }),
   dragRuler: Object.freeze({ min: 0, max: 8, step: 0.1, pixelsPerUnit: 60 }),
+  /** scroll-area: bars hide after idleMs; edge fades up to `fade` px; a click on the rail glides (s); shortest thumb (px). */
+  scrollArea: Object.freeze({ idleMs: 900, fade: 24, glide: 0.6, minThumb: 24 }),
 });