@yewdiel21/motion-kit 0.10.0 → 0.14.0

package/src/components/breadcrumb/element.ts

@@ -0,0 +1,27 @@
+import { MkElement, defineElement, type OptionType } from '../../elements/base';
+import { createBreadcrumb, type BreadcrumbInstance, type BreadcrumbItem } from './engine';
+
+/**
+ * <mk-breadcrumb class="mk-breadcrumb" items='[{"label":"Inicio","href":"/"},{"label":"Proyectos","href":"/p"},{"label":"Melon"}]'>
+ * </mk-breadcrumb> — or authored <a>/<span> children. Emits mk:navigate ({item, index}, cancelable).
+ */
+export class MkBreadcrumbElement extends MkElement<BreadcrumbInstance> {
+  static options: Record<string, OptionType> = { items: 'json', label: 'string', maxItems: 'number' };
+
+  protected create(options: Record<string, unknown>) {
+    return createBreadcrumb(this, options);
+  }
+
+  attributeChangedCallback(name: string, previous: string | null, next: string | null) {
+    if (previous === next || !this.instance) return;
+    if (name === 'items') {
+      try {
+        this.instance.setItems(JSON.parse(next ?? '[]') as BreadcrumbItem[]);
+      } catch {
+        // Malformed JSON: keep the current path.
+      }
+    } else super.attributeChangedCallback(name, previous, next);
+  }
+}
+
+export const defineBreadcrumb = () => defineElement('mk-breadcrumb', MkBreadcrumbElement);

package/src/components/breadcrumb/engine.ts

@@ -0,0 +1,249 @@
+import { gsap, EASE, Flip, registerMotion } from '../../core/gsap';
+import { reduced } from '../../core/reduced';
+import { createScope } from '../../core/scope';
+import { TIMING } from '../../core/timing';
+import { inert, type Instance } from '../../core/types';
+
+/*
+ * Breadcrumb: the path to the current page as an ordered list in a
+ * <nav aria-label>; the last item is the page itself (aria-current="page").
+ * When the items do not fit (or pass maxItems) the middle ones fold into a
+ * "…" button; pressing it shows them in place, flowing in from the left
+ * (blur 16 → 0, 40 ms apart) while the rest glides to make room. setItems()
+ * keeps the shared start of the path: the items that stay glide to their new
+ * place (layout reflow), new ones grow in, and the old current page turns into
+ * a link. Links underline from the left on hover; activating one emits a
+ * cancelable mk:navigate (onNavigate) before the browser follows it.
+ */
+
+export interface BreadcrumbItem {
+  label: string;
+  href?: string;
+}
+
+export interface BreadcrumbOptions {
+  /** The path; without it, the authored <ol> or <a>/<span> children are read. */
+  items?: BreadcrumbItem[];
+  /** Accessible name of the navigation (default 'Ruta de navegación'). */
+  label?: string;
+  /** 'auto' (default) folds the middle when it does not fit; a number keeps at most that many items. */
+  maxItems?: number | 'auto';
+  /** Called before following a link; event.preventDefault() keeps the browser where it is (SPA routing). */
+  onNavigate?: (item: BreadcrumbItem, index: number, event: Event) => void;
+}
+
+export interface BreadcrumbInstance extends Instance {
+  setItems(items: BreadcrumbItem[]): void;
+  readonly items: BreadcrumbItem[];
+}
+
+const readAuthored = (root: HTMLElement): BreadcrumbItem[] =>
+  [...root.querySelectorAll<HTMLElement>('li, :scope > a, :scope > span')]
+    .map((element) => {
+      const link = element.matches('a') ? (element as HTMLAnchorElement) : element.querySelector<HTMLAnchorElement>('a');
+      return { label: (link ?? element).textContent?.trim() ?? '', href: link?.getAttribute('href') ?? undefined };
+    })
+    .filter((item) => item.label);
+
+/** A crumb is the same one at the same place with the same label (a current page that turns into a link stays). */
+const key = (item: BreadcrumbItem, index: number) => `${index}:${item.label}`;
+
+export function createBreadcrumb(root: HTMLElement | null, options: BreadcrumbOptions = {}): BreadcrumbInstance {
+  if (!root) return inert({ setItems() {}, items: [] });
+  registerMotion();
+  const scope = createScope();
+  let items = (options.items ?? readAuthored(root)).map((item) => ({ ...item }));
+  const maxItems = typeof options.maxItems === 'number' && options.maxItems >= 2 ? Math.floor(options.maxItems) : 'auto';
+  const effects = new Set<gsap.core.Animation>();
+  const keep = (animation: gsap.core.Animation | null) => {
+    if (!animation) return;
+    effects.add(animation);
+    // Finished ones leave as new ones arrive: the animation's own onComplete stays untouched.
+    for (const effect of effects) if (effect.totalProgress() === 1) effects.delete(effect);
+  };
+
+  // Authored markup stays in the DOM but out of sight; the engine draws its own list.
+  const authored = [...root.childNodes];
+  const holder = document.createElement('div');
+  holder.hidden = true;
+  holder.append(...authored);
+  const nav = document.createElement('nav');
+  nav.dataset.mkBreadcrumbNav = '';
+  nav.setAttribute('aria-label', options.label ?? 'Ruta de navegación');
+  const list = document.createElement('ol');
+  list.dataset.mkBreadcrumbList = '';
+  nav.append(list);
+  root.append(nav);
+  scope.add(() => {
+    for (const effect of effects) effect.kill();
+    effects.clear();
+    nav.remove();
+    root.append(...holder.childNodes);
+  });
+  scope.attr(root, 'data-mk-ready', '');
+
+  /**
+   * The items that stay glide to their new place (layout reflow spring); the new ones come in from the side of
+   * travel out of a blur (from the left when the folded middle opens, from the right when the path grows).
+   */
+  const reflow = (change: () => void, from: 'left' | 'right') => {
+    const crumbs = () => [...list.querySelectorAll<HTMLElement>('[data-mk-crumb]')];
+    if (reduced()) return change();
+    const state = Flip.getState(crumbs());
+    change();
+    keep(
+      Flip.from(state, {
+        targets: crumbs(),
+        duration: TIMING.layoutTravel,
+        ease: EASE.layoutReflow,
+        onEnter: (entering) =>
+          gsap.fromTo(
+            entering,
+            { opacity: 0, x: from === 'left' ? -12 : 12, filter: 'blur(8px)' },
+            { opacity: 1, x: 0, filter: 'blur(0px)', duration: 0.35, stagger: 0.04, ease: 'power2.out', clearProps: 'opacity,transform,filter' },
+          ),
+      }),
+    );
+  };
+
+  /** Fold the middle when collapsed: which indexes are hidden. */
+  let expanded = false;
+  let hidden: number[] = [];
+
+  const crumb = (item: BreadcrumbItem, index: number) => {
+    const li = document.createElement('li');
+    li.dataset.mkCrumb = '';
+    li.dataset.flipId = key(item, index);
+    const last = index === items.length - 1;
+    if (last) {
+      const span = document.createElement('span');
+      span.dataset.mkCrumbCurrent = '';
+      span.setAttribute('aria-current', 'page');
+      span.textContent = item.label;
+      li.append(span);
+    } else if (item.href !== undefined) {
+      const link = document.createElement('a');
+      link.dataset.mkCrumbLink = '';
+      link.href = item.href;
+      link.dataset.mkIndex = String(index);
+      link.textContent = item.label;
+      li.append(link);
+    } else {
+      const span = document.createElement('span');
+      span.dataset.mkCrumbText = '';
+      span.textContent = item.label;
+      li.append(span);
+    }
+    return li;
+  };
+
+  const more = () => {
+    const li = document.createElement('li');
+    li.dataset.mkCrumb = '';
+    li.dataset.flipId = 'more';
+    const button = document.createElement('button');
+    button.type = 'button';
+    button.dataset.mkCrumbMore = '';
+    button.setAttribute('aria-expanded', 'false');
+    button.setAttribute('aria-label', hidden.length === 1 ? 'Mostrar 1 nivel oculto' : `Mostrar ${hidden.length} niveles ocultos`);
+    button.textContent = '…';
+    li.append(button);
+    return li;
+  };
+
+  const render = () => {
+    const nodes: HTMLElement[] = [];
+    items.forEach((item, index) => {
+      if (hidden.includes(index)) {
+        if (index === hidden[0]) nodes.push(more());
+        return;
+      }
+      nodes.push(crumb(item, index));
+    });
+    list.replaceChildren(...nodes);
+    nav.toggleAttribute('data-mk-expanded', expanded);
+  };
+
+  /** The middle indexes to fold, keeping the first item and the last `keepEnd`. */
+  const fold = (keepEnd: number) => {
+    const end = Math.max(1, items.length - keepEnd);
+    return Array.from({ length: Math.max(0, end - 1) }, (_, i) => i + 1);
+  };
+
+  const fits = () => list.scrollWidth <= list.clientWidth + 1;
+
+  const layout = () => {
+    if (expanded || items.length <= 2) {
+      hidden = [];
+      render();
+      return;
+    }
+    if (maxItems !== 'auto') {
+      hidden = items.length > maxItems ? fold(maxItems - 1) : [];
+      render();
+      return;
+    }
+    // Fold from the middle until the row fits with the current page whole (jsdom has no layout: it always fits);
+    // only when even the shortest fold is too long does the current page ellipsize.
+    nav.setAttribute('data-mk-measuring', '');
+    hidden = [];
+    render();
+    for (let keepEnd = items.length - 2; keepEnd >= 1 && !fits(); keepEnd--) {
+      hidden = fold(keepEnd);
+      render();
+    }
+    nav.removeAttribute('data-mk-measuring');
+  };
+
+  scope.on(list, 'click', (event) => {
+    const target = event.target as Element | null;
+    if (target?.closest('[data-mk-crumb-more]')) {
+      const shown = hidden.map((index) => key(items[index]!, index));
+      reflow(() => {
+        expanded = true;
+        hidden = [];
+        render();
+      }, 'left');
+      // The button is gone: the focus moves to the first level it revealed.
+      const first = [...list.querySelectorAll<HTMLElement>('[data-mk-crumb]')].find((li) => shown.includes(li.dataset.flipId ?? ''));
+      first?.querySelector<HTMLElement>('a')?.focus();
+      return;
+    }
+    const link = target?.closest<HTMLAnchorElement>('a[data-mk-crumb-link]');
+    if (!link) return;
+    const index = Number(link.dataset.mkIndex);
+    const item = items[index]!;
+    options.onNavigate?.(item, index, event);
+    const navigate = new CustomEvent('mk:navigate', { bubbles: true, cancelable: true, detail: { item, index } });
+    if (!root.dispatchEvent(navigate)) event.preventDefault();
+  });
+
+  if (typeof ResizeObserver === 'function') {
+    let width = 0;
+    scope.observe(
+      new ResizeObserver(() => {
+        const next = nav.clientWidth;
+        if (Math.abs(next - width) < 1) return;
+        width = next;
+        if (!expanded) layout();
+      }),
+    ).observe(nav);
+  }
+
+  layout();
+
+  return {
+    setItems(next) {
+      if (scope.disposed) return;
+      reflow(() => {
+        items = next.map((item) => ({ ...item }));
+        expanded = false;
+        layout();
+      }, 'right');
+    },
+    get items() {
+      return items.map((item) => ({ ...item }));
+    },
+    destroy: () => scope.dispose(),
+  };
+}

package/src/components/breadcrumb/react.tsx

@@ -0,0 +1,30 @@
+'use client';
+import { useRef, type HTMLAttributes } from 'react';
+import { useIsomorphicLayoutEffect, useLatest } from '../../react/use-recipe';
+import { createBreadcrumb, type BreadcrumbInstance, type BreadcrumbItem, type BreadcrumbOptions } from './engine';
+
+export interface BreadcrumbProps extends Omit<HTMLAttributes<HTMLDivElement>, 'children'>, Omit<BreadcrumbOptions, 'items'> {
+  items: BreadcrumbItem[];
+}
+
+/** <Breadcrumb items={path} onNavigate={(item, i, event) => { event.preventDefault(); go(item.href) }} />. */
+export function Breadcrumb({ items, label, maxItems, onNavigate, className, ...props }: BreadcrumbProps) {
+  const ref = useRef<HTMLDivElement>(null);
+  const instance = useRef<BreadcrumbInstance | null>(null);
+  const navigate = useLatest(onNavigate);
+  const key = JSON.stringify(items);
+  useIsomorphicLayoutEffect(() => {
+    const created = createBreadcrumb(ref.current, { items, label, maxItems, onNavigate: (item, index, event) => navigate.current?.(item, index, event) });
+    instance.current = created;
+    return () => {
+      created.destroy();
+      instance.current = null;
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [label, maxItems]);
+  useIsomorphicLayoutEffect(() => {
+    if (instance.current && JSON.stringify(instance.current.items) !== key) instance.current.setItems(items);
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [key]);
+  return <div {...props} ref={ref} className={['mk-breadcrumb', className].filter(Boolean).join(' ')} />;
+}

package/src/components/chart/README.md

@@ -0,0 +1,24 @@
+# chart
+
+Gráfica SVG reutilizable de línea, área y barras (agrupadas o apiladas) sin motor canvas ni dependencias. Sigue las gráficas de métricas de Melon Mind: base en cero, línea de 2 px, área que se desvanece de .25 a 0, barras de hasta 24 px con extremo redondeado de 4 px y huecos de 2 px, rejilla fina y tooltip con superficie invertida.
+
+```html
+<mk-chart class="mk-chart" type="bar" stacked label="Sesiones por semana"
+  labels="S1,S2,S3,S4"
+  series='[{"name":"Ana","values":[4,6,5,7]},{"name":"Luis","values":[2,3,4,1]}]'></mk-chart>
+```
+
+```ts
+const chart = createChart(root, { type: 'area', labels: days, series: [{ name: 'Ingresos', values }], formatValue: money, label: 'Ingresos de octubre' });
+chart.update({ series: [{ name: 'Ingresos', values: next }] });
+```
+
+React: `<Chart type="line" labels={days} series={series} formatValue={money} label="Ingresos" onSelect={setDay} />`.
+
+Datos: `labels` + `series: ChartSeries[]` (`{name, values: (number | null)[], color?, dash?}`; `dash` es un patrón SVG para líneas, p. ej. `'5 5'` para un ritmo o `'1 6'` para una proyección) o `points: ChartPoint[]` (`{label, value}`) para una serie. `null` es un hueco sin dato: la línea se corta y un punto aislado se muestra con marcador. Opciones: `type='line'|'area'|'bar'`, `stacked` (barras), `formatValue(n)` (ejes, tooltip y tabla), `label` (nombre accesible y título de la tabla), `height=240`, `emptyLabel`, `legend` (por defecto con dos o más series), `axis` (valores y líneas guía en el eje y; por defecto sólo la línea base), `endLabel` (líneas: el último valor de la primera serie en una píldora al final; por defecto `true`), `tooltip` (por defecto `true`; con `false` la gráfica deja la guía y los marcadores y la tarjeta la pone `chart-tooltip`), `onSelect(index | null)`. API: `update(options)` (combina y redibuja), `select(index | null)`, `selected`, `destroy()`. Evento `mk:select` con `{index, label, values, x, y, series}`: `x`/`y` son el punto señalado en píxeles del área de la gráfica y `series` trae `{name, color, value, previous}` por serie.
+
+Puntero y toque eligen el punto más cercano (el toque mantiene la selección; el ratón la quita al salir). Con foco en la gráfica, flechas/Inicio/Fin recorren los valores y Escape los oculta; un estado educado anuncia el valor elegido. La gráfica tiene un resumen como nombre accesible y una tabla para lectores de pantalla con todos los valores (y el total en barras apiladas). Sin datos muestra `emptyLabel`.
+
+Movimiento: el primer dibujo traza la línea de izquierda a derecha (barras: crecen desde la base) y cada `update` desliza los valores nuevos desde los anteriores; el tooltip aparece con un pop de cristal y se desliza entre puntos. Con movimiento reducido todo cambia sin transición.
+
+Colores: una sola serie es monocroma (`--mk-chart-mono`, el color del texto, al estilo de los indicadores de Melon Mind); con varias, cada serie usa su `color` o la ranura `--mk-chart-N` en orden fijo (paleta comprobada para daltonismo, con pasos propios en oscuro); a partir de la novena serie todas comparten `--mk-chart-other`: agrúpalas en «Otros». Los textos usan los colores de texto del tema; el color identifica la marca. Se redimensiona con su contenedor (ResizeObserver) y `destroy()` quita todo lo creado. Variables: `--mk-chart-mono`, `--mk-chart-1…8`, `--mk-chart-other`, `--mk-chart-surface` (anillo de marcadores), `--mk-chart-grid`.

package/src/components/chart/chart.css

@@ -0,0 +1,295 @@
+/* chart — Melon Mind's Indicadores: a monochrome line on the surface, the baseline only, the last value in a pill,
+   a dotted guide, the inverse glass tooltip and outlined legend pills.
+   Several series use --mk-chart-1…8 (a colour-blind-checked order, light and dark steps). */
+.mk-chart,
+mk-chart {
+  --mk-chart-mono: var(--mk-text);
+  --mk-chart-1: #2a78d6;
+  --mk-chart-2: #eb6834;
+  --mk-chart-3: #1baf7a;
+  --mk-chart-4: #eda100;
+  --mk-chart-5: #e87ba4;
+  --mk-chart-6: #008300;
+  --mk-chart-7: #6250d6;
+  --mk-chart-8: #e34948;
+  --mk-chart-other: var(--mk-muted);
+  --mk-chart-surface: var(--mk-surface-1);
+  --mk-chart-grid: color-mix(in srgb, var(--mk-text) 14%, transparent);
+  position: relative;
+  display: grid;
+  gap: 0.75rem;
+  min-width: 0;
+  color: var(--mk-text);
+  font-family: var(--mk-font);
+}
+
+@media (prefers-color-scheme: dark) {
+  :where(:root:not([data-mk-mode='light'])) :is(.mk-chart, mk-chart) {
+    --mk-chart-1: #3987e5;
+    --mk-chart-2: #d95926;
+    --mk-chart-3: #199e70;
+    --mk-chart-4: #c98500;
+    --mk-chart-5: #d55181;
+    --mk-chart-6: #008300;
+    --mk-chart-7: #9085e9;
+    --mk-chart-8: #e66767;
+  }
+}
+
+:where(:root[data-mk-mode='dark']) :is(.mk-chart, mk-chart) {
+  --mk-chart-1: #3987e5;
+  --mk-chart-2: #d95926;
+  --mk-chart-3: #199e70;
+  --mk-chart-4: #c98500;
+  --mk-chart-5: #d55181;
+  --mk-chart-6: #008300;
+  --mk-chart-7: #9085e9;
+  --mk-chart-8: #e66767;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-plot] {
+  position: relative;
+  min-width: 0;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-plot][hidden] {
+  display: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-svg] {
+  display: block;
+  width: 100%;
+  height: auto;
+  overflow: visible;
+  touch-action: pan-y;
+  border-radius: 12px;
+  cursor: crosshair;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-svg]:focus {
+  outline: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-svg]:focus-visible {
+  outline: 2px solid var(--mk-accent);
+  outline-offset: 4px;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-part='grid'] line {
+  stroke: var(--mk-chart-grid);
+  stroke-width: 1;
+  shape-rendering: crispEdges;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-part='grid'] line[data-mk-zero] {
+  stroke: color-mix(in srgb, var(--mk-text) 22%, transparent);
+}
+
+:is(.mk-chart, mk-chart) text {
+  fill: var(--mk-muted);
+  font-size: 11px;
+  font-variant-numeric: tabular-nums;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-part='total'] {
+  fill: var(--mk-text);
+  font-size: 10px;
+  font-weight: 500;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-part='line'] {
+  fill: none;
+  stroke-linecap: round;
+  stroke-linejoin: round;
+}
+
+:is(.mk-chart, mk-chart) :is([data-mk-part='dot'], [data-mk-part='marker'], [data-mk-part='end']) {
+  stroke: var(--mk-chart-surface);
+  stroke-width: 2.5;
+}
+
+/* The selection guide: Melonmind's dotted day line. */
+:is(.mk-chart, mk-chart) [data-mk-part='guide'] {
+  stroke: color-mix(in srgb, var(--mk-text) 45%, transparent);
+  stroke-width: 1;
+  stroke-dasharray: 2 4;
+  shape-rendering: crispEdges;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-part='band'] {
+  fill: color-mix(in srgb, var(--mk-text) 6%, transparent);
+}
+
+:is(.mk-chart, mk-chart) [data-mk-part='series'] path[data-mk-index] {
+  transition: opacity 0.2s ease;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-part='series'] path[data-mk-dim] {
+  opacity: 0.35;
+}
+
+/* The last value. */
+:is(.mk-chart, mk-chart) [data-mk-chart-end] {
+  position: absolute;
+  top: 0;
+  left: 0;
+  padding: 0.15rem 0.55rem;
+  border-radius: var(--mk-radius-full);
+  background: var(--mk-surface-3);
+  color: var(--mk-text);
+  font-size: 0.75rem;
+  font-weight: 500;
+  font-variant-numeric: tabular-nums;
+  white-space: nowrap;
+  pointer-events: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-end][hidden] {
+  display: none;
+}
+
+/* Tooltip: the inverse glass, 12 px radius, 8 × 12 padding (Melonmind). */
+:is(.mk-chart, mk-chart) [data-mk-chart-tooltip] {
+  position: absolute;
+  top: 0;
+  left: 0;
+  z-index: 2;
+  display: grid;
+  gap: 0.2rem;
+  min-width: 8rem;
+  max-width: 16rem;
+  padding: 0.5rem 0.75rem;
+  border-radius: 12px;
+  background: var(--mk-glass-inverse);
+  box-shadow: var(--mk-glass-bevel);
+  backdrop-filter: blur(16px);
+  color: var(--mk-on-glass-inverse);
+  font-size: 0.8125rem;
+  line-height: 1.3;
+  pointer-events: none;
+  transform-origin: 50% 100%;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-tooltip][hidden] {
+  display: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-tooltip] strong {
+  font-weight: 600;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-row] {
+  display: grid;
+  grid-template-columns: 0.6rem minmax(0, 1fr) auto;
+  align-items: center;
+  gap: 0.5rem;
+  opacity: 0.9;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-row] i {
+  width: 0.6rem;
+  height: 0.6rem;
+  border-radius: 3px;
+  box-shadow: 0 0 0 1px color-mix(in srgb, var(--mk-on-glass-inverse) 30%, transparent);
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-row] b {
+  font-weight: 500;
+  font-variant-numeric: tabular-nums;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-row] i[data-mk-mono] {
+  height: 2px;
+  border-radius: 2px;
+  background: currentColor;
+  box-shadow: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-row] i[data-mk-dash] {
+  height: 0;
+  border-top: 2px dashed currentColor;
+  border-radius: 0;
+  background: none;
+  box-shadow: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-row='total'] {
+  margin-top: 0.15rem;
+  padding-top: 0.25rem;
+  border-top: 1px solid color-mix(in srgb, var(--mk-on-glass-inverse) 25%, transparent);
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-row='total'] i {
+  box-shadow: none;
+}
+
+/* Legend: outlined pills (Melonmind «— Ingresado»). */
+:is(.mk-chart, mk-chart) [data-mk-chart-legend] {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.4rem;
+  margin: 0;
+  padding: 0;
+  color: var(--mk-text);
+  font-size: 0.8125rem;
+  list-style: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-legend][hidden] {
+  display: none;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-legend] li {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.45rem;
+  padding: 0.2rem 0.7rem;
+  border: 1px solid var(--mk-outline-soft);
+  border-radius: var(--mk-radius-full);
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-swatch] {
+  width: 0.7rem;
+  height: 0.7rem;
+  border-radius: 3px;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-swatch][data-mk-type='line'],
+:is(.mk-chart, mk-chart) [data-mk-chart-swatch][data-mk-type='area'] {
+  width: 0.9rem;
+  height: 2px;
+  border-radius: 2px;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-swatch][data-mk-dash] {
+  height: 0;
+  background: none !important;
+  border-top: 2px dashed currentColor;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-empty] {
+  display: grid;
+  place-items: center;
+  min-height: 10rem;
+  margin: 0;
+  border-radius: 24px;
+  background: var(--mk-surface-2);
+  color: var(--mk-muted);
+  font-size: 0.875rem;
+}
+
+:is(.mk-chart, mk-chart) [data-mk-chart-empty][hidden] {
+  display: none;
+}
+
+@media (prefers-reduced-motion: reduce) {
+  :is(.mk-chart, mk-chart) [data-mk-part='series'] path {
+    transition: none;
+  }
+}
+
+@media (forced-colors: active) {
+  :is(.mk-chart, mk-chart) [data-mk-part='line'] {
+    stroke: CanvasText !important;
+  }
+}

package/src/components/chart/element.ts

@@ -0,0 +1,41 @@
+import { MkElement, defineElement, type OptionType } from '../../elements/base';
+import { createChart, type ChartInstance, type ChartOptions } from './engine';
+
+/**
+ * <mk-chart class="mk-chart" type="bar" stacked label="Sesiones por semana"
+ *   labels="S1,S2,S3" series='[{"name":"Ana","values":[4,6,5]},{"name":"Luis","values":[2,3,4]}]'></mk-chart>
+ * Attribute changes redraw in place. Emits mk:select ({index, label, values, x, y, series}); tooltip="false" leaves the card to chart-tooltip.
+ */
+export class MkChartElement extends MkElement<ChartInstance> {
+  static options: Record<string, OptionType> = {
+    type: 'string',
+    labels: 'list',
+    series: 'json',
+    points: 'json',
+    stacked: 'boolean',
+    label: 'string',
+    height: 'number',
+    emptyLabel: 'string',
+    legend: 'boolean',
+    tooltip: 'boolean',
+  };
+
+  protected create(options: Record<string, unknown>) {
+    return createChart(this, options as ChartOptions);
+  }
+
+  attributeChangedCallback(_name: string, previous: string | null, next: string | null) {
+    if (previous === next || !this.instance) return;
+    this.instance.update({ stacked: false, legend: undefined, ...(this.options as ChartOptions) });
+  }
+
+  update(options: ChartOptions) {
+    this.instance?.update(options);
+  }
+
+  select(index: number | null) {
+    this.instance?.select(index);
+  }
+}
+
+export const defineChart = () => defineElement('mk-chart', MkChartElement);