@birdapi/velinstyle 0.6.1 → 0.8.0

package/components/velin-counter.js

@@ -0,0 +1,152 @@
+/*
+ * <velin-counter from="0" to="61840" duration="900" format="currency" currency="EUR">
+ *
+ * Animated count-up/down using requestAnimationFrame plus an exponential
+ * ease-out for the classic "money fly-in" effect. Renders the current value
+ * as text content inside the element (light DOM), so it inherits typography
+ * tokens automatically.
+ *
+ * Attributes:
+ *   from        starting value (default 0)
+ *   to          target value
+ *   duration    ms (default 900)
+ *   decimals    fixed decimal places
+ *   prefix      string before the number
+ *   suffix      string after the number
+ *   format      "number" (default) | "currency" | "percent"
+ *   currency    ISO code (default EUR), used when format=currency
+ *   locale      BCP47 locale (default browser default)
+ *   autostart   "false" disables auto-start on connect/intersect
+ *
+ * Public API:
+ *   start(): runs the animation from `from` to `to`.
+ *   reset(): jumps back to `from` without animating.
+ */
+
+const easeOutExpo = (t) => (t === 1 ? 1 : 1 - Math.pow(2, -10 * t));
+
+function buildFormatter(host) {
+  const format = (host.getAttribute('format') || 'number').toLowerCase();
+  const locale = host.getAttribute('locale') || undefined;
+  const decimalsAttr = host.getAttribute('decimals');
+  const decimals = decimalsAttr != null ? Math.max(0, Number.parseInt(decimalsAttr, 10) || 0) : null;
+  const opts = {};
+  if (decimals != null) {
+    opts.minimumFractionDigits = decimals;
+    opts.maximumFractionDigits = decimals;
+  }
+  if (format === 'currency') {
+    opts.style = 'currency';
+    opts.currency = host.getAttribute('currency') || 'EUR';
+  } else if (format === 'percent') {
+    opts.style = 'percent';
+  }
+  try {
+    return new Intl.NumberFormat(locale, opts);
+  } catch {
+    return new Intl.NumberFormat(undefined, opts);
+  }
+}
+
+class VelinCounter extends HTMLElement {
+  static get observedAttributes() {
+    return ['from', 'to', 'duration', 'decimals', 'prefix', 'suffix', 'format', 'currency', 'locale'];
+  }
+
+  constructor() {
+    super();
+    this._rafId = 0;
+    this._started = false;
+    this._observer = null;
+  }
+
+  connectedCallback() {
+    this._render(this._fromValue());
+    if (this.getAttribute('autostart') === 'false') return;
+    this._scheduleStart();
+  }
+
+  disconnectedCallback() {
+    cancelAnimationFrame(this._rafId);
+    this._observer?.disconnect();
+  }
+
+  attributeChangedCallback(name) {
+    if (!this.isConnected) return;
+    if (name === 'to' || name === 'from') {
+      this.start();
+    } else {
+      this._render(this._lastValue ?? this._toValue());
+    }
+  }
+
+  _fromValue() {
+    return Number.parseFloat(this.getAttribute('from')) || 0;
+  }
+  _toValue() {
+    return Number.parseFloat(this.getAttribute('to')) || 0;
+  }
+  _duration() {
+    return Math.max(0, Number.parseFloat(this.getAttribute('duration')) || 900);
+  }
+
+  _scheduleStart() {
+    if (this._started) return;
+    if (typeof IntersectionObserver === 'undefined') {
+      this.start();
+      return;
+    }
+    this._observer = new IntersectionObserver((entries) => {
+      for (const entry of entries) {
+        if (entry.isIntersecting) {
+          this.start();
+          this._observer.disconnect();
+          this._observer = null;
+          break;
+        }
+      }
+    }, { threshold: 0.2 });
+    this._observer.observe(this);
+  }
+
+  start() {
+    cancelAnimationFrame(this._rafId);
+    this._started = true;
+    const from = this._fromValue();
+    const to = this._toValue();
+    const duration = this._duration();
+    const reduced = typeof window !== 'undefined' && window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
+    if (reduced || duration === 0) {
+      this._render(to);
+      return;
+    }
+    const start = performance.now();
+    const tick = (now) => {
+      const t = Math.min(1, (now - start) / duration);
+      const value = from + (to - from) * easeOutExpo(t);
+      this._render(value);
+      if (t < 1) this._rafId = requestAnimationFrame(tick);
+    };
+    this._rafId = requestAnimationFrame(tick);
+  }
+
+  reset() {
+    cancelAnimationFrame(this._rafId);
+    this._started = false;
+    this._render(this._fromValue());
+  }
+
+  _render(value) {
+    this._lastValue = value;
+    const formatter = buildFormatter(this);
+    const prefix = this.getAttribute('prefix') || '';
+    const suffix = this.getAttribute('suffix') || '';
+    this.textContent = `${prefix}${formatter.format(value)}${suffix}`;
+  }
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get('velin-counter')) {
+  customElements.define('velin-counter', VelinCounter);
+}
+
+export default VelinCounter;

package/components/velin-drawer.js

@@ -1,4 +1,4 @@
-import { trapFocus, saveFocus, restoreFocus, getFocusableElements } from './focus-manager.js';
+import { trapFocus, saveFocus, restoreFocus, getFocusableElements, setBackgroundInert, clearBackgroundInert } from './focus-manager.js';
 import { escapeHTML } from './sanitize.js';
 
 const styles = `
@@ -61,12 +61,13 @@ class VelinDrawer extends HTMLElement {
   connectedCallback() {
     const title = this.getAttribute('title') || '';
     const safeTitle = escapeHTML(title);
+    const titleId = 'velin-drawer-title';
     this.shadowRoot.innerHTML = `
       <style>${styles}</style>
       <div class="overlay" part="overlay"></div>
-      <div class="drawer" role="dialog" aria-modal="true" aria-label="${safeTitle}" part="drawer">
+      <div class="drawer" role="dialog" aria-modal="true" aria-labelledby="${titleId}" part="drawer">
         <div class="header" part="header">
-          <h2 class="title">${safeTitle}</h2>
+          <h2 class="title" id="${titleId}">${safeTitle}</h2>
           <button class="close-btn" aria-label="Close" part="close">&#215;</button>
         </div>
         <div class="body" part="body"><slot></slot></div>
@@ -85,6 +86,7 @@ class VelinDrawer extends HTMLElement {
 
   _open() {
     this._prev = saveFocus();
+    setBackgroundInert(this);
     document.addEventListener('keydown', this._onKey);
     document.body.style.overflow = 'hidden';
     requestAnimationFrame(() => {
@@ -96,6 +98,7 @@ class VelinDrawer extends HTMLElement {
   _close() {
     document.removeEventListener('keydown', this._onKey);
     document.body.style.overflow = '';
+    clearBackgroundInert();
     restoreFocus(this._prev);
   }
 

package/components/velin-dropdown.js

@@ -62,6 +62,8 @@ class VelinDropdown extends HTMLElement {
     this.attachShadow({ mode: 'open', delegatesFocus: true });
     this._onDocClick = this._onDocClick.bind(this);
     this._onKeydown = this._onKeydown.bind(this);
+    this._typeahead = '';
+    this._typeaheadTimer = null;
   }
 
   connectedCallback() {
@@ -75,17 +77,31 @@ class VelinDropdown extends HTMLElement {
     `;
 
     const triggerSlot = this.shadowRoot.querySelector('slot[name="trigger"]');
+    const menuSlot = this.shadowRoot.querySelector('slot:not([name])');
     triggerSlot.addEventListener('click', () => this.toggle());
     triggerSlot.addEventListener('slotchange', () => {
       const trigger = triggerSlot.assignedElements()[0];
       if (trigger) {
         trigger.setAttribute('aria-haspopup', 'menu');
         trigger.setAttribute('aria-expanded', this.hasAttribute('open') ? 'true' : 'false');
+        const menuId = this._menuId || (this._menuId = `velin-dropdown-menu-${Math.random().toString(36).slice(2, 9)}`);
+        trigger.setAttribute('aria-controls', menuId);
+        this.shadowRoot.querySelector('.menu')?.setAttribute('id', menuId);
       }
     });
+    menuSlot?.addEventListener('slotchange', () => this._normalizeMenuItems());
+    this._normalizeMenuItems();
     this.addEventListener('keydown', this._onKeydown);
   }
 
+  _normalizeMenuItems() {
+    const items = this._getMenuItems();
+    items.forEach((el, i) => {
+      if (!el.hasAttribute('role')) el.setAttribute('role', 'menuitem');
+      el.setAttribute('tabindex', i === 0 ? '0' : '-1');
+    });
+  }
+
   toggle() {
     if (this.hasAttribute('open')) {
       this.close();
@@ -138,9 +154,24 @@ class VelinDropdown extends HTMLElement {
     }
 
     const items = this._getMenuItems();
-    if (items.length > 0) {
-      rovingTabindex(this, items, event);
+    if (items.length === 0) return;
+
+    if (event.key.length === 1 && /[a-z0-9]/i.test(event.key)) {
+      clearTimeout(this._typeaheadTimer);
+      this._typeahead += event.key.toLowerCase();
+      this._typeaheadTimer = setTimeout(() => { this._typeahead = ''; }, 500);
+      const match = items.find((el) =>
+        (el.textContent?.trim().toLowerCase() || '').startsWith(this._typeahead)
+      );
+      if (match) {
+        event.preventDefault();
+        items.forEach((item) => item.setAttribute('tabindex', item === match ? '0' : '-1'));
+        match.focus();
+      }
+      return;
     }
+
+    rovingTabindex(this, items, event);
   }
 
   disconnectedCallback() {

package/components/velin-flip.js

@@ -0,0 +1,220 @@
+/*
+ * velin-flip.js — FLIP-style reorder + filter helper.
+ *
+ * FLIP (First, Last, Invert, Play) measures item rects before and after a
+ * DOM mutation, then animates the delta. Used for sorting/filtering UIs
+ * where rows reorder visibly. Pair it with the [data-velin-flip] attribute
+ * on a container plus [data-velin-filter-value] chips or [data-velin-filter-input]
+ * inputs to wire chip/search filtering with zero JS in your demo.
+ *
+ * API:
+ *   flipReorder(container, mutateFn, opts?)
+ *   filterList(container, predicateFn, opts?)
+ *
+ *   opts.duration  ms (default 250); reduced-motion forces 0
+ *   opts.easing    CSS timing function (default expo-out token)
+ *   opts.itemSelector children selector (default ':scope > *')
+ *
+ * Auto-init:
+ *   <ul data-velin-flip data-velin-filter-attr="tags" id="myList">
+ *     <li data-tags="a b">..</li> ...
+ *   </ul>
+ *   <button data-velin-filter-value="a" data-velin-filter-target="#myList">A</button>
+ *   <input data-velin-filter-input data-velin-filter-target="#myList">
+ *
+ *   Any chip or input with data-velin-filter-target pointing at a flip
+ *   container is wired automatically. The active chip carries
+ *   data-velin-filter-active so you can style it.
+ */
+
+const REDUCED_MOTION_MQ =
+  typeof window !== 'undefined' && window.matchMedia
+    ? window.matchMedia('(prefers-reduced-motion: reduce)')
+    : null;
+
+const DEFAULTS = {
+  duration: 250,
+  easing: 'var(--velin-ease-expo-out, cubic-bezier(0.16, 1, 0.3, 1))',
+  itemSelector: ':scope > *',
+};
+
+function getItems(container, selector) {
+  return Array.from(container.querySelectorAll(selector));
+}
+
+export function flipReorder(container, mutateFn, options = {}) {
+  if (!container || typeof mutateFn !== 'function') return;
+  const opts = { ...DEFAULTS, ...options };
+  const reduced = REDUCED_MOTION_MQ && REDUCED_MOTION_MQ.matches;
+
+  const items = getItems(container, opts.itemSelector);
+  const before = new Map();
+  items.forEach((el) => {
+    if (!el.hidden) before.set(el, el.getBoundingClientRect());
+  });
+
+  mutateFn();
+
+  if (reduced) return;
+
+  const items2 = getItems(container, opts.itemSelector);
+  items2.forEach((el) => {
+    if (el.hidden) return;
+    const prev = before.get(el);
+    const next = el.getBoundingClientRect();
+    if (!prev) {
+      if (typeof el.animate !== 'function') return;
+      el.animate(
+        [
+          { opacity: 0, transform: 'scale(0.96)' },
+          { opacity: 1, transform: 'scale(1)' },
+        ],
+        { duration: opts.duration, easing: opts.easing, fill: 'both' },
+      );
+      return;
+    }
+    const dx = prev.left - next.left;
+    const dy = prev.top - next.top;
+    if (dx === 0 && dy === 0) return;
+    if (typeof el.animate !== 'function') return;
+    el.animate(
+      [
+        { transform: `translate(${dx}px, ${dy}px)` },
+        { transform: 'translate(0, 0)' },
+      ],
+      { duration: opts.duration, easing: opts.easing, fill: 'both' },
+    );
+  });
+}
+
+export function filterList(container, predicate, options = {}) {
+  if (!container || typeof predicate !== 'function') return;
+  const opts = { ...DEFAULTS, ...options };
+  flipReorder(
+    container,
+    () => {
+      getItems(container, opts.itemSelector).forEach((el) => {
+        el.hidden = !predicate(el);
+      });
+    },
+    opts,
+  );
+}
+
+function readTokens(value) {
+  if (!value) return [];
+  return String(value)
+    .toLowerCase()
+    .split(/[\s,|]+/)
+    .map((s) => s.trim())
+    .filter(Boolean);
+}
+
+function matchTokens(itemTokens, queryTokens, mode) {
+  if (!queryTokens.length) return true;
+  if (mode === 'all') return queryTokens.every((q) => itemTokens.includes(q));
+  return queryTokens.some((q) => itemTokens.includes(q));
+}
+
+function matchSearch(item, query) {
+  if (!query) return true;
+  const haystack =
+    (item.getAttribute('data-tags') || '') +
+    ' ' +
+    (item.getAttribute('data-search') || '') +
+    ' ' +
+    (item.textContent || '');
+  return haystack.toLowerCase().includes(query.toLowerCase());
+}
+
+class FilterController {
+  constructor(container) {
+    this.container = container;
+    this.tag = '';
+    this.search = '';
+    this.matchMode = container.getAttribute('data-velin-filter-mode') === 'all' ? 'all' : 'any';
+    this.itemSelector = container.getAttribute('data-velin-filter-item') || ':scope > *';
+  }
+
+  apply() {
+    const queryTokens = readTokens(this.tag);
+    const term = this.search;
+    filterList(
+      this.container,
+      (el) => {
+        const tokens = readTokens(el.getAttribute('data-tags'));
+        return matchTokens(tokens, queryTokens, this.matchMode) && matchSearch(el, term);
+      },
+      { itemSelector: this.itemSelector },
+    );
+  }
+}
+
+const _controllers = new WeakMap();
+
+function getController(container) {
+  let ctrl = _controllers.get(container);
+  if (!ctrl) {
+    ctrl = new FilterController(container);
+    _controllers.set(container, ctrl);
+  }
+  return ctrl;
+}
+
+function resolveTarget(triggerEl) {
+  const sel = triggerEl.getAttribute('data-velin-filter-target');
+  if (!sel) return null;
+  try {
+    return document.querySelector(sel);
+  } catch {
+    return null;
+  }
+}
+
+function highlightActive(group, active) {
+  if (!group) return;
+  group.querySelectorAll('[data-velin-filter-value]').forEach((btn) => {
+    if (btn === active) btn.setAttribute('data-velin-filter-active', '');
+    else btn.removeAttribute('data-velin-filter-active');
+  });
+}
+
+function autoInit() {
+  if (typeof document === 'undefined') return;
+
+  document.addEventListener('click', (event) => {
+    const target = event.target.closest('[data-velin-filter-value]');
+    if (!target) return;
+    const container = resolveTarget(target);
+    if (!container) return;
+    const group = target.closest('[data-velin-filter-group]') || target.parentElement;
+    highlightActive(group, target);
+    const ctrl = getController(container);
+    ctrl.tag = target.getAttribute('data-velin-filter-value') || '';
+    if (ctrl.tag.toLowerCase() === 'all' || ctrl.tag === '*') ctrl.tag = '';
+    ctrl.apply();
+  });
+
+  const handleInput = (event) => {
+    const input = event.target.closest('[data-velin-filter-input]');
+    if (!input) return;
+    const container = resolveTarget(input);
+    if (!container) return;
+    const ctrl = getController(container);
+    const raw = input.value || (typeof input.getAttribute === 'function' ? input.getAttribute('value') : '');
+    ctrl.search = (raw || '').trim();
+    ctrl.apply();
+  };
+  document.addEventListener('input', handleInput);
+  document.addEventListener('change', handleInput);
+}
+
+if (typeof document !== 'undefined') {
+  if (document.readyState === 'loading') {
+    document.addEventListener('DOMContentLoaded', autoInit, { once: true });
+  } else {
+    autoInit();
+  }
+}
+
+export default { flipReorder, filterList };

package/components/velin-icon.js

@@ -3,14 +3,33 @@ const PROVIDER_CDNS = {
   heroicons: 'https://unpkg.com/heroicons@2/24/outline/{name}.svg',
   bootstrap: 'https://unpkg.com/bootstrap-icons@latest/icons/{name}.svg',
   material: 'https://fonts.gstatic.com/s/i/short-term/release/materialsymbolsoutlined/{name}/default/24px.svg',
-  fontawesome: 'https://raw.githubusercontent.com/FortAwesome/Font-Awesome/6.x/svgs/regular/{name}.svg',
+  fontawesome: 'https://raw.githubusercontent.com/FortAwesome/Font-Awesome/6.x/svgs/solid/{name}.svg',
 };
 
+const PROVIDER_VARIANTS = {
+  fontawesome: {
+    regular: 'https://raw.githubusercontent.com/FortAwesome/Font-Awesome/6.x/svgs/regular/{name}.svg',
+    solid: 'https://raw.githubusercontent.com/FortAwesome/Font-Awesome/6.x/svgs/solid/{name}.svg',
+    brands: 'https://raw.githubusercontent.com/FortAwesome/Font-Awesome/6.x/svgs/brands/{name}.svg',
+  },
+  heroicons: {
+    outline: 'https://unpkg.com/heroicons@2/24/outline/{name}.svg',
+    solid: 'https://unpkg.com/heroicons@2/24/solid/{name}.svg',
+    mini: 'https://unpkg.com/heroicons@2/20/solid/{name}.svg',
+  },
+};
+
+function resolveProviderUrl(provider, variant) {
+  const variants = PROVIDER_VARIANTS[provider];
+  if (variant && variants?.[variant]) return variants[variant];
+  return PROVIDER_CDNS[provider];
+}
+
 const _svgCache = new Map();
 
 class VelinIcon extends HTMLElement {
   static get observedAttributes() {
-    return ['name', 'size', 'label', 'provider', 'sprite'];
+    return ['name', 'size', 'label', 'provider', 'variant', 'sprite'];
   }
 
   constructor() {
@@ -31,14 +50,15 @@ class VelinIcon extends HTMLElement {
     const size = this.getAttribute('size') || '24';
     const label = this.getAttribute('label');
     const provider = this.getAttribute('provider');
+    const variant = this.getAttribute('variant');
 
     if (!name) {
       this.innerHTML = '';
       return;
     }
 
-    if (provider && PROVIDER_CDNS[provider]) {
-      this._renderFromCDN(name, size, label, provider);
+    if (provider && (PROVIDER_CDNS[provider] || PROVIDER_VARIANTS[provider])) {
+      this._renderFromCDN(name, size, label, provider, variant);
       return;
     }
 
@@ -60,8 +80,17 @@ class VelinIcon extends HTMLElement {
     this._applyA11y(svg, label);
 
     const use = document.createElementNS(svgNS, 'use');
-    const spriteUrl = this.getAttribute('sprite') || 'velin-icons.svg';
-    use.setAttribute('href', `${spriteUrl}#${name}`);
+    const spriteAttr = this.getAttribute('sprite');
+    const localSymbol = document.getElementById(name);
+    const isLocalSymbol = localSymbol && localSymbol.tagName && localSymbol.tagName.toLowerCase() === 'symbol';
+    let href;
+    if (spriteAttr === '' || (spriteAttr == null && isLocalSymbol)) {
+      href = `#${name}`;
+    } else {
+      const spriteUrl = spriteAttr || 'velin-icons.svg';
+      href = `${spriteUrl}#${name}`;
+    }
+    use.setAttribute('href', href);
     svg.appendChild(use);
 
     this.innerHTML = '';
@@ -69,15 +98,20 @@ class VelinIcon extends HTMLElement {
     this._rendered = true;
   }
 
-  async _renderFromCDN(name, size, label, provider) {
-    const cacheKey = `${provider}:${name}`;
+  async _renderFromCDN(name, size, label, provider, variant) {
+    const cacheKey = `${provider}:${variant || 'default'}:${name}`;
 
     if (_svgCache.has(cacheKey)) {
       this._injectSVG(_svgCache.get(cacheKey), size, label);
       return;
     }
 
-    const url = PROVIDER_CDNS[provider].replace('{name}', name);
+    const template = resolveProviderUrl(provider, variant);
+    if (!template) {
+      this._renderFromSprite(name, size, label);
+      return;
+    }
+    const url = template.replace('{name}', name);
     try {
       const res = await fetch(url);
       if (!res.ok) throw new Error(`${res.status}`);

package/components/velin-live-dot.js

@@ -0,0 +1,85 @@
+/*
+ * <velin-live-dot status="live">Realtime</velin-live-dot>
+ *
+ * Tiny status indicator: a coloured dot with an optional concentric pulse
+ * (driven by the velin-live-pulse keyframe in chart-animation.css). Slot
+ * children render after the dot for an inline "Live - Streaming" label.
+ *
+ * Attributes:
+ *   status   "live" (default) | "paused" | "warning" | "error" | "muted"
+ *            Determines dot colour via the CSS custom prop --velin-live-color.
+ *   pulse    "true" (default) | "false"   Disables the looped pulse.
+ */
+
+const STATUS_COLORS = {
+  live: 'var(--velin-color-success, oklch(60% 0.16 145))',
+  paused: 'var(--velin-color-text-muted, oklch(60% 0.02 240))',
+  warning: 'var(--velin-color-warning, oklch(75% 0.16 80))',
+  error: 'var(--velin-color-danger, oklch(60% 0.2 25))',
+  muted: 'var(--velin-color-border, oklch(85% 0.01 240))',
+};
+
+const styles = `
+  :host {
+    display: inline-flex;
+    align-items: center;
+    gap: var(--velin-space-2, 0.5rem);
+    font-size: inherit;
+    color: inherit;
+    line-height: 1.2;
+  }
+  .dot {
+    inline-size: 0.55rem;
+    block-size: 0.55rem;
+    border-radius: 50%;
+    background: var(--velin-live-color);
+    flex-shrink: 0;
+  }
+  :host([pulse="false"]) .dot { animation: none; }
+  :host(:not([pulse="false"])) .dot { animation: velin-live-pulse 1.8s var(--velin-ease-out, ease-out) infinite; }
+  @media (prefers-reduced-motion: reduce) {
+    .dot { animation: none !important; }
+  }
+`;
+
+const KEYFRAMES_FALLBACK = `
+@keyframes velin-live-pulse {
+  0% { box-shadow: 0 0 0 0 color-mix(in oklch, var(--velin-live-color) 65%, transparent); }
+  70% { box-shadow: 0 0 0 0.6rem color-mix(in oklch, var(--velin-live-color) 0%, transparent); }
+  100% { box-shadow: 0 0 0 0 transparent; }
+}`;
+
+class VelinLiveDot extends HTMLElement {
+  static get observedAttributes() {
+    return ['status', 'pulse'];
+  }
+
+  constructor() {
+    super();
+    this.attachShadow({ mode: 'open' });
+  }
+
+  connectedCallback() {
+    this._render();
+  }
+
+  attributeChangedCallback() {
+    if (this.shadowRoot) this._render();
+  }
+
+  _render() {
+    const status = this.getAttribute('status') || 'live';
+    const color = STATUS_COLORS[status] || STATUS_COLORS.live;
+    this.style.setProperty('--velin-live-color', color);
+    this.shadowRoot.innerHTML = `
+      <style>${styles}${KEYFRAMES_FALLBACK}</style>
+      <span class="dot" aria-hidden="true"></span><slot></slot>
+    `;
+  }
+}
+
+if (typeof customElements !== 'undefined' && !customElements.get('velin-live-dot')) {
+  customElements.define('velin-live-dot', VelinLiveDot);
+}
+
+export default VelinLiveDot;