@birdapi/velinstyle 0.7.0 → 0.9.0

package/components/velin-email.js

@@ -0,0 +1,94 @@
+import { escapeHTML, escapeHTMLAttribute } from './sanitize.js';
+
+const styles = `
+  :host { display: inline; }
+  button {
+    font: inherit;
+    color: var(--velin-color-primary, #4338ca);
+    background: none;
+    border: none;
+    padding: 0;
+    cursor: pointer;
+    text-decoration: underline;
+    text-underline-offset: 0.15em;
+    min-height: 2.75rem;
+    min-width: 2.75rem;
+  }
+  button:focus-visible {
+    outline: 3px solid var(--velin-color-focus, #2563eb);
+    outline-offset: 2px;
+    border-radius: 2px;
+  }
+  .revealed { text-decoration: none; user-select: text; }
+`;
+
+function decodeObfuscated(raw, method) {
+  if (!raw) return '';
+  if (method === 'rot13') {
+    return raw.replace(/[a-zA-Z]/g, (c) => {
+      const base = c <= 'Z' ? 65 : 97;
+      return String.fromCharCode(((c.charCodeAt(0) - base + 13) % 26) + base);
+    });
+  }
+  try {
+    return atob(raw);
+  } catch {
+    return raw;
+  }
+}
+
+class VelinEmail extends HTMLElement {
+  static get observedAttributes() {
+    return ['value', 'obfuscate', 'label'];
+  }
+
+  constructor() {
+    super();
+    this.attachShadow({ mode: 'open' });
+    this._revealed = false;
+  }
+
+  connectedCallback() {
+    this.render();
+  }
+
+  attributeChangedCallback() {
+    if (this.isConnected) this.render();
+  }
+
+  get email() {
+    const method = this.getAttribute('obfuscate') || '';
+    const raw = this.getAttribute('value') || '';
+    return method ? decodeObfuscated(raw, method) : raw;
+  }
+
+  render() {
+    const label = this.getAttribute('label') || 'Show email address';
+    const email = this.email;
+    const safeEmail = escapeHTML(email);
+
+    if (this._revealed) {
+      this.shadowRoot.innerHTML = `
+        <style>${styles}</style>
+        <span class="revealed" part="email"><a href="mailto:${escapeHTMLAttribute(email)}">${safeEmail}</a></span>
+      `;
+      return;
+    }
+
+    this.shadowRoot.innerHTML = `
+      <style>${styles}</style>
+      <button type="button" part="reveal" aria-label="${escapeHTMLAttribute(label)}">${escapeHTML(label)}</button>
+    `;
+    this.shadowRoot.querySelector('button').addEventListener('click', () => {
+      this._revealed = true;
+      this.render();
+      this.dispatchEvent(new CustomEvent('velin-email-reveal', { bubbles: true, detail: { email } }));
+    });
+  }
+}
+
+if (!customElements.get('velin-email')) {
+  customElements.define('velin-email', VelinEmail);
+}
+
+export default VelinEmail;

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

@@ -1,16 +1,41 @@
+import { sanitizeURL, sanitizeSVG } from './sanitize.js';
+
 const PROVIDER_CDNS = {
   lucide: 'https://unpkg.com/lucide-static@latest/icons/{name}.svg',
   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://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6/svgs/solid/{name}.svg',
+};
+
+const PROVIDER_VARIANTS = {
+  fontawesome: {
+    regular:
+      'https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6/svgs/regular/{name}.svg',
+    solid:
+      'https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6/svgs/solid/{name}.svg',
+    brands:
+      'https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@6/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() {
@@ -29,23 +54,31 @@ class VelinIcon extends HTMLElement {
   _render() {
     const name = this.getAttribute('name');
     const size = this.getAttribute('size') || '24';
-    const label = this.getAttribute('label');
+    const a11y = this._resolveA11y();
     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, a11y, provider, variant);
       return;
     }
 
-    this._renderFromSprite(name, size, label);
+    this._renderFromSprite(name, size, a11y);
   }
 
-  _renderFromSprite(name, size, label) {
+  _resolveA11y() {
+    const label = (this.getAttribute('label') || this.getAttribute('aria-label') || '').trim();
+    if (label) return { label, hidden: false };
+    const hidden = this.getAttribute('aria-hidden') !== 'false';
+    return { label: '', hidden };
+  }
+
+  _renderFromSprite(name, size, a11y) {
     const svgNS = 'http://www.w3.org/2000/svg';
     const svg = document.createElementNS(svgNS, 'svg');
     svg.setAttribute('width', size);
@@ -57,50 +90,79 @@ class VelinIcon extends HTMLElement {
     svg.setAttribute('stroke-linecap', 'round');
     svg.setAttribute('stroke-linejoin', 'round');
     this._applyStyle(svg);
-    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 = sanitizeURL(spriteAttr || '/dist/velin-icons.svg') || '/dist/velin-icons.svg';
+      href = `${spriteUrl}#${name}`;
+    }
+    use.setAttribute('href', href);
     svg.appendChild(use);
+    this._applyA11y(svg, a11y);
 
     this.innerHTML = '';
     this.appendChild(svg);
     this._rendered = true;
   }
 
-  async _renderFromCDN(name, size, label, provider) {
-    const cacheKey = `${provider}:${name}`;
+  async _renderFromCDN(name, size, a11y, provider, variant) {
+    const cacheKey = `${provider}:${variant || 'default'}:${name}`;
 
     if (_svgCache.has(cacheKey)) {
-      this._injectSVG(_svgCache.get(cacheKey), size, label);
+      this._injectSVG(_svgCache.get(cacheKey), size, a11y);
       return;
     }
 
-    const url = PROVIDER_CDNS[provider].replace('{name}', name);
+    const template = resolveProviderUrl(provider, variant);
+    if (!template) {
+      this._renderFromSprite(name, size, a11y);
+      return;
+    }
+    const url = sanitizeURL(template.replace('{name}', name));
+    if (!url) {
+      this._renderFromSprite(name, size, a11y);
+      return;
+    }
     try {
       const res = await fetch(url);
       if (!res.ok) throw new Error(`${res.status}`);
       const text = await res.text();
       if (!text.includes('<svg')) throw new Error('Not SVG');
-      _svgCache.set(cacheKey, text);
-      this._injectSVG(text, size, label);
+      const clean = await sanitizeSVG(text);
+      _svgCache.set(cacheKey, clean);
+      this._injectSVG(clean, size, a11y);
     } catch {
-      this._renderFromSprite(name, size, label);
+      this._renderFromSprite(name, size, a11y);
     }
   }
 
-  _injectSVG(svgText, size, label) {
+  _stripForeignA11y(svg) {
+    svg.removeAttribute('role');
+    svg.removeAttribute('aria-label');
+    svg.removeAttribute('aria-labelledby');
+    svg.removeAttribute('aria-hidden');
+    svg.querySelector('title')?.remove();
+    svg.querySelector('desc')?.remove();
+  }
+
+  _injectSVG(svgText, size, a11y) {
     const parser = new DOMParser();
     const doc = parser.parseFromString(svgText, 'image/svg+xml');
     const svg = doc.querySelector('svg');
     if (!svg) { this.innerHTML = ''; return; }
 
+    this._stripForeignA11y(svg);
     svg.setAttribute('width', size);
     svg.setAttribute('height', size);
     if (!svg.getAttribute('viewBox')) svg.setAttribute('viewBox', '0 0 24 24');
     this._applyStyle(svg);
-    this._applyA11y(svg, label);
+    this._applyA11y(svg, a11y);
 
     this.innerHTML = '';
     this.appendChild(document.importNode(svg, true));
@@ -113,19 +175,34 @@ class VelinIcon extends HTMLElement {
     svg.style.flexShrink = '0';
   }
 
-  _applyA11y(svg, label) {
+  _applyA11y(svg, a11y) {
+    const { label, hidden } = a11y;
+    const use = svg.querySelector('use');
     if (label) {
       svg.setAttribute('role', 'img');
       svg.setAttribute('aria-label', label);
-    } else {
+      svg.removeAttribute('aria-hidden');
+      svg.removeAttribute('focusable');
+      if (use) use.removeAttribute('aria-hidden');
+    } else if (hidden) {
+      svg.setAttribute('role', 'presentation');
       svg.setAttribute('aria-hidden', 'true');
+      svg.setAttribute('focusable', 'false');
+      svg.removeAttribute('aria-label');
+      if (use) {
+        use.setAttribute('aria-hidden', 'true');
+        use.setAttribute('focusable', 'false');
+      }
     }
   }
 
   static get providers() { return Object.keys(PROVIDER_CDNS); }
 
-  static registerProvider(name, urlTemplate) {
+  static registerProvider(name, urlTemplate, variantTemplates) {
     PROVIDER_CDNS[name] = urlTemplate;
+    if (variantTemplates && PROVIDER_VARIANTS[name]) {
+      Object.assign(PROVIDER_VARIANTS[name], variantTemplates);
+    }
   }
 }
 

package/components/velin-lightbox.js

@@ -1,4 +1,5 @@
-import { trapFocus } from './focus-manager.js';
+import { trapFocus, setBackgroundInert, clearBackgroundInert } from './focus-manager.js';
+import { announce } from './a11y-utils.js';
 import { escapeHTML, sanitizeURL } from './sanitize.js';
 
 const styles = `
@@ -61,7 +62,7 @@ class VelinLightbox extends HTMLElement {
         <div class="content" part="content"></div>
         <button class="nav nav--next" aria-label="Next">&#8250;</button>
         <button class="close" aria-label="Close">&times;</button>
-        <div class="counter" part="counter"></div>
+        <div class="counter" part="counter" aria-live="polite" aria-atomic="true"></div>
       </div>
     `;
 
@@ -89,6 +90,7 @@ class VelinLightbox extends HTMLElement {
     this._previousFocus = document.activeElement;
     this._index = index;
     this.setAttribute('open', '');
+    setBackgroundInert(this);
     this._render();
     document.body.style.overflow = 'hidden';
     const overlay = this.shadowRoot.querySelector('.overlay');
@@ -99,6 +101,7 @@ class VelinLightbox extends HTMLElement {
 
   close() {
     this.removeAttribute('open');
+    clearBackgroundInert();
     document.body.style.overflow = '';
     if (this._previousFocus) {
       this._previousFocus.focus();
@@ -122,7 +125,9 @@ class VelinLightbox extends HTMLElement {
       container.innerHTML = `<img src="${escapeHTML(src)}" alt="${alt}">`;
     }
     const counter = this.shadowRoot.querySelector('.counter');
-    counter.textContent = `${this._index + 1} / ${this._items.length}`;
+    const label = `${this._index + 1} / ${this._items.length}`;
+    counter.textContent = label;
+    announce(`Slide ${label}`, 'polite');
   }
 }
 

package/components/velin-live-dot.js

@@ -0,0 +1,90 @@
+/*
+ * <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.
+ */
+
+import { liveDotLabel } from './a11y-utils.js';
+
+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;
+    const label = this.getAttribute('aria-label') || liveDotLabel(status);
+    this.setAttribute('role', 'status');
+    this.setAttribute('aria-label', label);
+    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;