@yewdiel21/motion-kit 0.10.0 → 0.15.0

package/src/components/pill-button/react.tsx

@@ -0,0 +1,32 @@
+'use client';
+import { useRef, type ButtonHTMLAttributes, type ReactNode } from 'react';
+import { useIsomorphicLayoutEffect } from '../../react/use-recipe';
+import { createPillButton, PILL_ARROW } from './engine';
+
+export interface PillButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+  /** Start as the circle and spread into the pill on hover. */
+  expand?: boolean;
+  /** The icon (default: an arrow). */
+  icon?: ReactNode;
+}
+
+/** <PillButton onClick={ask}>Haz una pregunta</PillButton> */
+export function PillButton({ expand, icon, className, children, type = 'button', ...props }: PillButtonProps) {
+  const ref = useRef<HTMLButtonElement>(null);
+  useIsomorphicLayoutEffect(() => {
+    const instance = createPillButton(ref.current, { expand });
+    return () => instance.destroy();
+  }, [expand]);
+  return (
+    <button {...props} type={type} ref={ref} className={['mk-pill-button', className].filter(Boolean).join(' ')}>
+      <span data-mk-pill-label="">{children}</span>
+      {icon ? (
+        <span data-mk-pill-icon="" aria-hidden="true">
+          {icon}
+        </span>
+      ) : (
+        <span data-mk-pill-icon="" aria-hidden="true" dangerouslySetInnerHTML={{ __html: PILL_ARROW }} />
+      )}
+    </button>
+  );
+}

package/src/components/popover/README.md

@@ -0,0 +1,44 @@
+# popover
+
+Panel flotante interactivo anclado a su botón, sobre la misma superficie que `menu` y `color-picker`: crece desde el botón (transformación de contenedor de `motion/morph.ts`) mientras su contenido entra en cascada como las opciones de un menú (desde 90 % y un blur de 4 px, 40 ms entre piezas), y al cerrar se pliega de vuelta en él. Se cierra con Escape, con un clic fuera o con cualquier `[data-mk-close]` de dentro, y el foco vuelve al botón.
+
+Importa también `css/components/dialog.css` (o el CSS completo). La CLI lo copia: la entrada `requires` dialog.
+
+## HTML / Astro
+
+```html
+<mk-popover class="mk-popover">
+  <button class="mk-button" data-mk-popover-trigger>Filtros</button>
+  <div data-mk-popover-content>
+    <label class="mk-field">Estado <select>…</select></label>
+    <button class="mk-button mk-button--primary" data-mk-close>Aplicar</button>
+  </div>
+</mk-popover>
+```
+
+`[data-mk-popover-content]` pasa a un `<dialog>` que crea el motor y vuelve a su sitio al destruirlo. También puedes escribir directamente `<dialog data-mk-popover-panel>`.
+
+## React
+
+```tsx
+<Popover trigger={<button className="mk-button">Filtros</button>} onOpenChange={setOpen}>
+  <FiltersForm />
+</Popover>
+```
+
+Con `open` es controlado. `ref` da `open()` y `close()`.
+
+## Opciones
+
+| Opción | Atributo | Por defecto | Qué hace |
+|---|---|---|---|
+| `label` | `label` | el texto del botón | Nombre accesible del panel. |
+| `onOpenChange(open)` | — | — | Al abrirse o cerrarse. |
+
+## API y eventos
+
+`open()`, `close()`, `toggle()`, `isOpen`, `panel` (el `<dialog>`), `destroy()`. Evento `mk:open-change` con `{ open }`.
+
+## Estilo
+
+Esquinas de 20 px sobre `--mk-surface-1`, tan ancho como su contenido hasta 22rem, con 1rem de relleno. Se estiliza por clase (`.mk-popover-panel`), así la copia que se pliega al cerrar conserva su aspecto. En teléfonos el diálogo anclado se centra. Con movimiento reducido aparece sin crecer.

package/src/components/popover/element.ts

@@ -0,0 +1,31 @@
+import { MkElement, defineElement, type OptionType } from '../../elements/base';
+import { createPopover, type PopoverInstance } from './engine';
+
+/**
+ * <mk-popover class="mk-popover">
+ *   <button data-mk-popover-trigger>Filtros</button>
+ *   <div data-mk-popover-content>…</div>
+ * </mk-popover>
+ * Emits mk:open-change ({open}).
+ */
+export class MkPopoverElement extends MkElement<PopoverInstance> {
+  static options: Record<string, OptionType> = { label: 'string' };
+
+  protected create(options: Record<string, unknown>) {
+    return createPopover(this, options);
+  }
+
+  open() {
+    this.instance?.open();
+  }
+
+  close() {
+    this.instance?.close();
+  }
+
+  get isOpen() {
+    return this.instance?.isOpen ?? false;
+  }
+}
+
+export const definePopover = () => defineElement('mk-popover', MkPopoverElement);

package/src/components/popover/engine.ts

@@ -0,0 +1,114 @@
+import { createScope } from '../../core/scope';
+import { inert, type Instance } from '../../core/types';
+import { flowInMenu } from '../../motion/entrances';
+import { createDialog } from '../dialog/engine';
+
+/*
+ * Popover: an interactive panel anchored to its trigger, on the same anchored
+ * dialog surface as menu and color-picker. It grows out of the trigger
+ * (motion/morph.ts container transform) while its content flows in like a
+ * menu's options (from 90 % out of a 4 px blur, 40 ms apart), folds back into
+ * the trigger on close, closes with Escape, a click outside or any
+ * [data-mk-close] inside, and gives the focus back to the trigger. A
+ * dialog[data-mk-popover-panel] is used as it is; [data-mk-popover-content] is
+ * moved into a dialog the engine creates and put back on destroy.
+ */
+
+export interface PopoverOptions {
+  /** Accessible name of the panel (default: the trigger's text). */
+  label?: string;
+  onOpenChange?: (open: boolean) => void;
+}
+
+export interface PopoverInstance extends Instance {
+  open(): void;
+  close(): void;
+  toggle(): void;
+  readonly isOpen: boolean;
+  /** The panel (a <dialog>). */
+  readonly panel: HTMLElement | null;
+}
+
+let sequence = 0;
+
+export function createPopover(root: HTMLElement | null, options: PopoverOptions = {}): PopoverInstance {
+  const inertInstance = inert<PopoverInstance>({ open() {}, close() {}, toggle() {}, isOpen: false, panel: null });
+  if (!root) return inertInstance;
+  let dialog = root.querySelector<HTMLDialogElement>('dialog[data-mk-popover-panel]');
+  const content = dialog ? null : root.querySelector<HTMLElement>('[data-mk-popover-content]');
+  const trigger =
+    root.querySelector<HTMLElement>('[data-mk-popover-trigger]') ??
+    [...root.querySelectorAll<HTMLElement>('button, a[href], [role="button"]')].find((element) => !dialog?.contains(element) && !content?.contains(element)) ??
+    null;
+  if (!trigger || (!dialog && !content)) return inertInstance;
+  const scope = createScope();
+
+  if (!dialog) {
+    // The authored content moves into a dialog in its place, and back on destroy.
+    const created = document.createElement('dialog');
+    const anchor = content!.nextSibling;
+    const parent = content!.parentNode!;
+    parent.insertBefore(created, content);
+    created.append(content!);
+    dialog = created;
+    scope.add(() => {
+      if (content!.isConnected || created.isConnected) parent.insertBefore(content!, created.isConnected ? created : anchor);
+      created.remove();
+    });
+  }
+  const panel = dialog;
+  // Classes, not only attributes: the copy that folds back into the trigger on close keeps classes only.
+  scope.attr(panel, 'class', [panel.getAttribute('class'), 'mk-dialog', 'mk-popover-panel'].filter(Boolean).join(' '));
+  if (!panel.id) scope.attr(panel, 'id', `mk-popover-${++sequence}`);
+  if (!panel.hasAttribute('aria-label') && !panel.hasAttribute('aria-labelledby')) scope.attr(panel, 'aria-label', options.label ?? trigger.textContent?.trim() ?? 'Panel');
+  scope.attr(trigger, 'aria-haspopup', 'dialog');
+  scope.attr(trigger, 'aria-expanded', 'false');
+  scope.attr(trigger, 'aria-controls', panel.id);
+  scope.attr(root, 'data-mk-ready', '');
+
+  const announce = (open: boolean) => {
+    trigger.setAttribute('aria-expanded', String(open));
+    options.onOpenChange?.(open);
+    root.dispatchEvent(new CustomEvent('mk:open-change', { bubbles: true, detail: { open } }));
+  };
+  let flow: ReturnType<typeof flowInMenu> = null;
+  const surface = createDialog(panel, {
+    placement: 'anchor',
+    backdrop: false,
+    drag: false,
+    autoResize: false,
+    triggers: false,
+    animateContent: false,
+    // Like a menu's options: the content flows in while the surface grows out of the trigger.
+    onOpen: () => {
+      flow?.kill();
+      flow = flowInMenu([...panel.children].filter((child) => !child.classList.contains('mk-morph-face')));
+      announce(true);
+    },
+    onClose: () => announce(false),
+  });
+  scope.add(() => {
+    flow?.kill();
+    surface.destroy();
+  });
+
+  const open = () => {
+    if (!surface.isOpen) surface.open(trigger);
+  };
+  scope.on(trigger, 'click', (event) => {
+    event.preventDefault();
+    if (surface.isOpen) surface.close();
+    else open();
+  });
+
+  return {
+    open,
+    close: () => surface.close(),
+    toggle: () => (surface.isOpen ? surface.close() : open()),
+    get isOpen() {
+      return surface.isOpen;
+    },
+    panel,
+    destroy: () => scope.dispose(),
+  };
+}

package/src/components/popover/popover.css

@@ -0,0 +1,24 @@
+/* popover — an anchored .mk-dialog (needs dialog.css): 20 px corners on surface-1, as wide as its content up to
+   22rem, 1rem padding. Styled by class: the copy that folds back into the trigger keeps classes only. */
+.mk-popover,
+mk-popover {
+  display: inline-block;
+}
+
+.mk-dialog.mk-popover-panel {
+  --mk-dialog-radius: 20px;
+  --mk-dialog-bg: var(--mk-surface-1);
+  --mk-dialog-shadow: 0 16px 48px -12px color-mix(in srgb, var(--mk-shadow-color, #000) 35%, transparent);
+  gap: 0.75rem;
+  width: max-content;
+  min-width: min(14rem, calc(100vw - 32px));
+  max-width: min(22rem, calc(100vw - 32px));
+  padding: 1rem;
+}
+
+/* Phones: the anchored dialog is centred by dialog.css; keep it a panel, not a sheet. */
+@media (max-width: 679px) {
+  .mk-dialog.mk-popover-panel {
+    max-width: calc(100vw - 32px);
+  }
+}

package/src/components/popover/react.tsx

@@ -0,0 +1,50 @@
+'use client';
+import { forwardRef, useImperativeHandle, useRef, type HTMLAttributes, type ReactNode } from 'react';
+import { useIsomorphicLayoutEffect, useLatest } from '../../react/use-recipe';
+import { createPopover, type PopoverInstance, type PopoverOptions } from './engine';
+
+export interface PopoverProps extends Omit<HTMLAttributes<HTMLDivElement>, 'content'>, PopoverOptions {
+  /** The control that opens it (a button). */
+  trigger: ReactNode;
+  /** Controlled open state (optional). */
+  open?: boolean;
+  /** Extra class for the panel. */
+  panelClassName?: string;
+}
+
+export interface PopoverHandle {
+  open(): void;
+  close(): void;
+}
+
+/** <Popover trigger={<button>Filtros</button>}>…</Popover>: the panel grows out of the trigger. */
+export const Popover = forwardRef<PopoverHandle, PopoverProps>(function Popover({ trigger, open, label, onOpenChange, panelClassName, className, children, ...props }, handle) {
+  const ref = useRef<HTMLDivElement>(null);
+  const instance = useRef<PopoverInstance | null>(null);
+  const change = useLatest(onOpenChange);
+  useImperativeHandle(handle, () => ({ open: () => instance.current?.open(), close: () => instance.current?.close() }), []);
+  useIsomorphicLayoutEffect(() => {
+    const created = createPopover(ref.current, { label, onOpenChange: (value) => change.current?.(value) });
+    instance.current = created;
+    return () => {
+      created.destroy();
+      instance.current = null;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [label]);
+  useIsomorphicLayoutEffect(() => {
+    if (open === undefined || !instance.current || instance.current.isOpen === open) return;
+    if (open) instance.current.open();
+    else instance.current.close();
+  }, [open]);
+  return (
+    <div {...props} ref={ref} className={['mk-popover', className].filter(Boolean).join(' ')}>
+      <span data-mk-popover-trigger-slot="" style={{ display: 'contents' }}>
+        {trigger}
+      </span>
+      <dialog data-mk-popover-panel="" className={panelClassName}>
+        {children}
+      </dialog>
+    </div>
+  );
+});

package/src/components/progress/README.md

@@ -0,0 +1,17 @@
+# progress
+
+Barra o anillo de progreso con valor determinado o indeterminado. El anillo sigue el `MetricsRing` de Melon Mind: radio `(tamaño − trazo) / 2`, `stroke-dasharray` derivado del ratio y arranque a las 12.
+
+```html
+<mk-progress class="mk-progress" value="40" label="Subiendo informe" show-value></mk-progress>
+<mk-progress class="mk-progress" variant="ring" value="72" label="Meta mensual" show-value></mk-progress>
+<mk-progress class="mk-progress" label="Procesando"></mk-progress> <!-- indeterminado -->
+```
+
+`defineElements()` desde `/elements`, `createProgress(root, options)` o `<Progress value={42} label="Subida" showValue />` desde `/react`.
+
+Opciones: `value` (número o `null` = indeterminado; por defecto `min`), `min=0`, `max=100`, `label` (aria-label), `variant='linear'|'ring'`, `showValue`, `formatValue(value, ratio)` (texto visible y `aria-valuetext`), `duration=.7` (segundos del deslizamiento). API: `setValue(number | null)`, `value`, `destroy()`.
+
+El root recibe `role="progressbar"`, `aria-valuemin/max/now` (sin `aria-valuenow` cuando es indeterminado). Valores no finitos se ignoran y los demás se acotan a los límites. No hay región viva: el valor se lee al llegar a la barra, sin anunciar cada cambio.
+
+El dibujo es un único hijo decorativo `[data-mk-progress-visual]`; el contenido que ya tenga el root se conserva y `destroy()` restaura atributos y estilos. Al subir o bajar, el relleno (o el arco) se desliza con GSAP, las cifras ruedan, la punta brilla al avanzar, el anillo respira y llegar al máximo lanza un estallido. Variables: `--mk-progress-height` (10px), `--mk-progress-size` (anillo, 4.5rem), `--mk-progress-track`, `--mk-progress-fill`. Movimiento reducido: el valor cambia sin transición y el indeterminado queda como relleno parcial estático.

package/src/components/progress/element.ts

@@ -0,0 +1,30 @@
+import { MkElement, defineElement, type OptionType } from '../../elements/base';
+import { createProgress, type ProgressInstance } from './engine';
+
+/**
+ * <mk-progress class="mk-progress" value="40" label="Subida" show-value></mk-progress>
+ * Without `value` (or value="indeterminate") it is indeterminate. A new value moves the fill.
+ */
+export class MkProgressElement extends MkElement<ProgressInstance> {
+  static options: Record<string, OptionType> = { value: 'number', min: 'number', max: 'number', label: 'string', variant: 'string', showValue: 'boolean' };
+
+  protected create(options: Record<string, unknown>) {
+    return createProgress(this, { ...options, value: typeof options.value === 'number' ? options.value : null });
+  }
+
+  attributeChangedCallback(name: string, previous: string | null, next: string | null) {
+    if (previous === next || !this.instance) return;
+    if (name === 'value') this.instance.setValue(next === null || !Number.isFinite(Number(next)) ? null : Number(next));
+    else super.attributeChangedCallback(name, previous, next);
+  }
+
+  setValue(value: number | null) {
+    this.instance?.setValue(value);
+  }
+
+  get value() {
+    return this.instance?.value ?? null;
+  }
+}
+
+export const defineProgress = () => defineElement('mk-progress', MkProgressElement);

package/src/components/progress/engine.ts

@@ -0,0 +1,173 @@
+import { gsap, EASE, registerMotion } from '../../core/gsap';
+import { reduced } from '../../core/reduced';
+import { createScope } from '../../core/scope';
+import { inert, type Instance } from '../../core/types';
+import { burst, rollDigits } from '../../motion/micro';
+
+/*
+ * Progress: a bar or a ring (Melon Mind's MetricsRing: radius (size - stroke) / 2,
+ * dasharray from the ratio, starting at 12 o'clock). The root is the progressbar;
+ * the drawing is one decorative [data-mk-progress-visual] child. ARIA follows a
+ * new value at once; the drawing glides to it with GSAP (Melonmind's playful
+ * swing, .38,.49,0,1.5): going up, a light runs at the head and the figure rolls
+ * up; going down, the figure rolls down. Reaching the maximum fires a small burst.
+ * null is indeterminate. Nothing is live: assistive tech reads the value on arrival.
+ */
+
+export type ProgressVariant = 'linear' | 'ring';
+
+export interface ProgressOptions {
+  /** Current value; null is indeterminate. Default: min. */
+  value?: number | null;
+  min?: number;
+  max?: number;
+  label?: string;
+  variant?: ProgressVariant;
+  /** Write the percentage beside the bar (inside the ring). */
+  showValue?: boolean;
+  /** Text for the value (also aria-valuetext). Default: rounded percentage. */
+  formatValue?: (value: number, ratio: number) => string;
+  /** Glide duration in seconds (default .7). */
+  duration?: number;
+}
+
+export interface ProgressInstance extends Instance {
+  setValue(value: number | null): void;
+  readonly value: number | null;
+}
+
+const SVG = 'http://www.w3.org/2000/svg';
+const RING_SIZE = 48;
+const RING_STROKE = 5;
+const RADIUS = (RING_SIZE - RING_STROKE) / 2;
+const CIRCUMFERENCE = 2 * Math.PI * RADIUS;
+
+const finite = (value: unknown): value is number => typeof value === 'number' && Number.isFinite(value);
+
+export function createProgress(root: HTMLElement | null, options: ProgressOptions = {}): ProgressInstance {
+  if (!root) return inert({ setValue() {}, value: null });
+  registerMotion();
+  const scope = createScope();
+  const min = finite(options.min) ? options.min : 0;
+  const max = finite(options.max) && options.max > min ? options.max : Math.max(min + 1, 100);
+  const variant: ProgressVariant = options.variant === 'ring' ? 'ring' : 'linear';
+  const duration = finite(options.duration) ? Math.max(0, options.duration) : 0.7;
+  const clamp = (n: number) => Math.min(max, Math.max(min, n));
+  let value: number | null = options.value === null ? null : clamp(finite(options.value) ? options.value : min);
+
+  const visual = document.createElement('span');
+  visual.dataset.mkProgressVisual = '';
+  visual.setAttribute('aria-hidden', 'true');
+  let arc: SVGCircleElement | null = null;
+  let head: HTMLElement | null = null;
+  let ring: SVGSVGElement | null = null;
+  if (variant === 'ring') {
+    ring = document.createElementNS(SVG, 'svg');
+    ring.setAttribute('viewBox', `0 0 ${RING_SIZE} ${RING_SIZE}`);
+    ring.dataset.mkPart = 'ring';
+    const circle = (part: string) => {
+      const element = document.createElementNS(SVG, 'circle');
+      element.setAttribute('cx', String(RING_SIZE / 2));
+      element.setAttribute('cy', String(RING_SIZE / 2));
+      element.setAttribute('r', String(RADIUS));
+      element.setAttribute('fill', 'none');
+      element.setAttribute('stroke-width', String(RING_STROKE));
+      element.dataset.mkPart = part;
+      ring!.append(element);
+      return element;
+    };
+    circle('track');
+    arc = circle('arc');
+    arc.setAttribute('stroke-linecap', 'round');
+    visual.append(ring);
+  } else {
+    const track = document.createElement('span');
+    track.dataset.mkPart = 'track';
+    const bar = document.createElement('span');
+    bar.dataset.mkPart = 'bar';
+    head = document.createElement('span');
+    head.dataset.mkPart = 'head';
+    track.append(bar, head);
+    visual.append(track);
+  }
+  const text = options.showValue ? document.createElement('span') : null;
+  if (text) {
+    text.dataset.mkPart = 'value';
+    visual.append(text);
+  }
+  root.append(visual);
+
+  scope.attr(root, 'style', root.getAttribute('style'));
+  scope.attr(root, 'role', 'progressbar');
+  scope.attr(root, 'aria-valuemin', String(min));
+  scope.attr(root, 'aria-valuemax', String(max));
+  if (options.label) scope.attr(root, 'aria-label', options.label);
+  scope.attr(root, 'data-mk-variant', variant);
+  scope.attr(root, 'data-mk-ready', '');
+
+  const ratioOf = (n: number | null) => (n === null ? 0 : (n - min) / (max - min));
+  const labelOf = (n: number | null) => (n === null ? '' : options.formatValue ? options.formatValue(n, ratioOf(n)) : `${Math.round(ratioOf(n) * 100)} %`);
+  /** What is drawn now (it trails `value` while gliding). */
+  const shown = { ratio: ratioOf(value) };
+  const draw = () => {
+    const ratio = Math.min(1, Math.max(0, shown.ratio));
+    root.style.setProperty('--mk-progress', ratio.toFixed(4));
+    if (arc) {
+      const length = value === null ? CIRCUMFERENCE * 0.25 : CIRCUMFERENCE * ratio;
+      arc.setAttribute('stroke-dasharray', `${length.toFixed(2)} ${CIRCUMFERENCE.toFixed(2)}`);
+    }
+  };
+  let glide: gsap.core.Tween | null = null;
+  const motion: gsap.core.Animation[] = [];
+  scope.add(() => {
+    glide?.kill();
+    for (const animation of motion.splice(0)) animation.progress(1).kill();
+    visual.remove();
+  });
+
+  const render = (previous: number | null, animate: boolean) => {
+    const label = labelOf(value);
+    scope.attr(root, 'aria-valuenow', value === null ? null : String(value));
+    scope.attr(root, 'aria-valuetext', value !== null && options.formatValue ? label : null);
+    scope.attr(root, 'data-mk-indeterminate', value === null ? '' : null);
+    scope.attr(root, 'data-mk-complete', value !== null && value >= max ? '' : null);
+    const target = ratioOf(value);
+    const direction: 1 | -1 = previous === null || value === null || value >= previous ? 1 : -1;
+    glide?.kill();
+    if (!animate || reduced() || value === null || previous === null || duration === 0) {
+      shown.ratio = target;
+      draw();
+      if (text) text.textContent = label;
+      return;
+    }
+    glide = gsap.to(shown, { ratio: target, duration, ease: EASE.swatch, onUpdate: draw });
+    if (text) {
+      const roll = rollDigits(text, label, direction);
+      if (roll) motion.push(roll);
+    }
+    // Going up: a light runs at the head of the bar; the ring breathes.
+    if (direction > 0 && head) motion.push(gsap.fromTo(head, { opacity: 1, scale: 0.4 }, { opacity: 0, scale: 1.6, duration: 0.6, ease: 'power2.out' }));
+    if (ring) motion.push(gsap.fromTo(ring, { scale: direction > 0 ? 1.06 : 0.95 }, { scale: 1, duration: 0.5, ease: EASE.click, clearProps: 'scale,transform' }));
+    if (value >= max && previous < max) {
+      const done = burst(variant === 'ring' ? visual : (text ?? visual), { count: 6, distance: 22, ring: variant === 'ring' });
+      if (done) motion.push(done);
+    }
+    if (motion.length > 12) motion.splice(0, motion.length - 12);
+  };
+  render(null, false);
+
+  return {
+    setValue(next) {
+      if (scope.disposed) return;
+      const previous = value;
+      if (next === null) value = null;
+      else if (finite(next)) value = clamp(next);
+      else return;
+      render(previous, true);
+    },
+    get value() {
+      return value;
+    },
+    destroy: () => scope.dispose(),
+  };
+}

package/src/components/progress/progress.css

@@ -0,0 +1,139 @@
+/* progress — Melonmind line: a neutral track, the accent only for the value; a ring (MetricsRing) with the figure inside.
+   The fill is drawn from --mk-progress, which the engine glides with GSAP. */
+.mk-progress,
+mk-progress {
+  --mk-progress-height: 10px;
+  --mk-progress-size: 4.5rem;
+  --mk-progress-track: var(--mk-surface-4);
+  --mk-progress-fill: var(--mk-accent);
+  display: block;
+  color: var(--mk-text);
+  font-family: var(--mk-font);
+}
+
+:is(.mk-progress, mk-progress) [data-mk-progress-visual] {
+  display: flex;
+  align-items: center;
+  gap: 0.875rem;
+}
+
+/* Linear */
+:is(.mk-progress, mk-progress) span[data-mk-part='track'] {
+  position: relative;
+  flex: 1;
+  height: var(--mk-progress-height);
+  border-radius: var(--mk-radius-full);
+  background: var(--mk-progress-track);
+}
+
+:is(.mk-progress, mk-progress) [data-mk-part='bar'] {
+  position: absolute;
+  inset: 0;
+  border-radius: inherit;
+  background: var(--mk-progress-fill);
+  clip-path: inset(0 calc((1 - var(--mk-progress, 0)) * 100%) 0 0 round var(--mk-radius-full));
+}
+
+/* The light at the head of the bar (flashes when the value goes up). */
+:is(.mk-progress, mk-progress) [data-mk-part='head'] {
+  position: absolute;
+  top: 50%;
+  left: calc(var(--mk-progress, 0) * 100%);
+  width: calc(var(--mk-progress-height) * 2.4);
+  aspect-ratio: 1;
+  border-radius: 50%;
+  background: radial-gradient(circle, color-mix(in srgb, var(--mk-progress-fill) 70%, white) 0%, transparent 70%);
+  opacity: 0;
+  pointer-events: none;
+  translate: -50% -50%;
+}
+
+:is(.mk-progress, mk-progress)[data-mk-indeterminate] [data-mk-part='bar'] {
+  clip-path: none;
+  width: 38%;
+  animation: mk-progress-slide 1.4s cubic-bezier(0.65, 0, 0.35, 1) infinite;
+}
+
+:is(.mk-progress, mk-progress) [data-mk-part='value'] {
+  min-width: 4.5ch;
+  color: var(--mk-muted);
+  font-size: 0.875rem;
+  font-weight: 500;
+  font-variant-numeric: tabular-nums;
+  text-align: right;
+}
+
+:is(.mk-progress, mk-progress)[data-mk-complete] [data-mk-part='value'] {
+  color: var(--mk-text);
+}
+
+/* Ring */
+:is(.mk-progress, mk-progress)[data-mk-variant='ring'] {
+  display: inline-block;
+  width: var(--mk-progress-size);
+}
+
+:is(.mk-progress, mk-progress)[data-mk-variant='ring'] [data-mk-progress-visual] {
+  position: relative;
+  display: grid;
+  place-items: center;
+  aspect-ratio: 1;
+}
+
+:is(.mk-progress, mk-progress) [data-mk-part='ring'] {
+  grid-area: 1 / 1;
+  width: 100%;
+  height: 100%;
+  overflow: visible;
+  rotate: -90deg;
+}
+
+:is(.mk-progress, mk-progress) circle[data-mk-part='track'] {
+  stroke: var(--mk-progress-track);
+}
+
+:is(.mk-progress, mk-progress) [data-mk-part='arc'] {
+  stroke: var(--mk-progress-fill);
+}
+
+:is(.mk-progress, mk-progress)[data-mk-variant='ring'][data-mk-indeterminate] [data-mk-part='ring'] {
+  animation: mk-progress-spin 1.1s linear infinite;
+}
+
+:is(.mk-progress, mk-progress)[data-mk-variant='ring'] [data-mk-part='value'] {
+  grid-area: 1 / 1;
+  min-width: 0;
+  color: var(--mk-text);
+  font-size: calc(var(--mk-progress-size) * 0.24);
+  letter-spacing: -0.02em;
+  text-align: center;
+}
+
+@keyframes mk-progress-slide {
+  from {
+    translate: -100% 0;
+  }
+  to {
+    translate: 265% 0;
+  }
+}
+
+@keyframes mk-progress-spin {
+  from {
+    rotate: -90deg;
+  }
+  to {
+    rotate: 270deg;
+  }
+}
+
+/* Reduced motion: values jump; indeterminate becomes a still, partial fill. */
+@media (prefers-reduced-motion: reduce) {
+  :is(.mk-progress, mk-progress) :is([data-mk-part='bar'], [data-mk-part='ring']) {
+    animation: none !important;
+  }
+
+  :is(.mk-progress, mk-progress)[data-mk-indeterminate] [data-mk-part='bar'] {
+    opacity: 0.55;
+  }
+}