@birdapi/velinstyle 1.0.0 → 1.2.0

package/components/velin-calendar.js

@@ -0,0 +1,212 @@
+import { escapeHTML } from './sanitize.js';
+
+const styles = `
+  :host { display: block; max-inline-size: 100%; }
+  .cal {
+    box-sizing: border-box;
+    border: 1px solid var(--velin-color-border, #ddd);
+    border-radius: var(--velin-radius-md, 0.5rem);
+    background: var(--velin-color-surface, #fff);
+    color: var(--velin-color-text, #111);
+    padding: var(--velin-space-3, 0.75rem);
+    max-inline-size: min(20rem, 100%);
+    inline-size: 100%;
+  }
+  .head {
+    display: flex; align-items: center; justify-content: space-between;
+    gap: var(--velin-space-2, 0.5rem); margin-block-end: var(--velin-space-3, 0.75rem);
+  }
+  .title { font-weight: var(--velin-weight-semibold, 600); margin: 0; font-size: var(--velin-text-base, 1rem); }
+  .nav {
+    display: inline-flex; align-items: center; justify-content: center;
+    flex-shrink: 0;
+    min-inline-size: 2.5rem; min-block-size: 2.5rem;
+    border: 1px solid var(--velin-color-border, #ddd);
+    border-radius: var(--velin-radius-sm, 0.25rem);
+    background: var(--velin-color-surface-bright, #fff);
+    color: inherit; cursor: pointer;
+  }
+  .nav:focus-visible { outline: 2px solid var(--velin-color-focus, #2563eb); outline-offset: 2px; }
+  .grid {
+    display: grid; grid-template-columns: repeat(7, minmax(0, 1fr)); gap: 0.25rem;
+  }
+  .dow {
+    text-align: center; font-size: var(--velin-text-xs, 0.75rem);
+    color: var(--velin-color-text-muted, #64748b); padding-block: 0.25rem;
+  }
+  .day {
+    inline-size: 100%;
+    min-inline-size: 0;
+    min-block-size: 2.25rem;
+    aspect-ratio: 1;
+    border: none; border-radius: var(--velin-radius-sm, 0.25rem);
+    background: transparent; color: inherit; cursor: pointer;
+    font: inherit;
+    padding: 0;
+  }
+  .day[aria-disabled="true"] { opacity: 0.35; cursor: not-allowed; }
+  .day[aria-selected="true"] {
+    background: var(--velin-color-primary, #2563eb);
+    color: var(--velin-color-on-primary, #fff);
+  }
+  .day:not([aria-disabled="true"]):hover {
+    background: var(--velin-color-primary-subtle, #eff6ff);
+  }
+  .day:focus-visible { outline: 2px solid var(--velin-color-focus, #2563eb); outline-offset: 1px; }
+  .out { color: var(--velin-color-text-muted, #94a3b8); }
+`;
+
+function iso(d) {
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, '0');
+  const day = String(d.getDate()).padStart(2, '0');
+  return `${y}-${m}-${day}`;
+}
+
+function parseISO(v) {
+  if (!v) return null;
+  const m = String(v).match(/^(\d{4})-(\d{2})-(\d{2})$/);
+  if (!m) return null;
+  const d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+  return Number.isNaN(d.getTime()) ? null : d;
+}
+
+class VelinCalendar extends HTMLElement {
+  static get observedAttributes() {
+    return ['value', 'min', 'max', 'label'];
+  }
+
+  constructor() {
+    super();
+    this.attachShadow({ mode: 'open' });
+    this._view = new Date();
+    this._view.setDate(1);
+    this._onKey = this._onKey.bind(this);
+  }
+
+  connectedCallback() {
+    const selected = parseISO(this.getAttribute('value')) || new Date();
+    this._view = new Date(selected.getFullYear(), selected.getMonth(), 1);
+    this._render();
+  }
+
+  attributeChangedCallback(name, prev, next) {
+    if (prev === next || !this.shadowRoot?.querySelector('.cal')) return;
+    if (name === 'value' && next) {
+      const d = parseISO(next);
+      if (d) this._view = new Date(d.getFullYear(), d.getMonth(), 1);
+    }
+    this._render();
+  }
+
+  get value() {
+    return this.getAttribute('value') || '';
+  }
+
+  set value(v) {
+    if (v) this.setAttribute('value', v);
+    else this.removeAttribute('value');
+  }
+
+  _inRange(d) {
+    const min = parseISO(this.getAttribute('min'));
+    const max = parseISO(this.getAttribute('max'));
+    if (min && d < min) return false;
+    if (max && d > max) return false;
+    return true;
+  }
+
+  _select(d) {
+    if (!this._inRange(d)) return;
+    const v = iso(d);
+    this.setAttribute('value', v);
+    this.dispatchEvent(new CustomEvent('velin-change', { bubbles: true, detail: { value: v, date: d } }));
+    this._render();
+  }
+
+  _shiftMonth(delta) {
+    this._view = new Date(this._view.getFullYear(), this._view.getMonth() + delta, 1);
+    this._render();
+  }
+
+  _onKey(e) {
+    const selected = parseISO(this.getAttribute('value')) || new Date();
+    let next = new Date(selected);
+    switch (e.key) {
+      case 'ArrowLeft': next.setDate(next.getDate() - 1); break;
+      case 'ArrowRight': next.setDate(next.getDate() + 1); break;
+      case 'ArrowUp': next.setDate(next.getDate() - 7); break;
+      case 'ArrowDown': next.setDate(next.getDate() + 7); break;
+      case 'Home': next = new Date(next.getFullYear(), next.getMonth(), 1); break;
+      case 'End': next = new Date(next.getFullYear(), next.getMonth() + 1, 0); break;
+      case 'PageUp': next = new Date(next.getFullYear(), next.getMonth() - 1, next.getDate()); break;
+      case 'PageDown': next = new Date(next.getFullYear(), next.getMonth() + 1, next.getDate()); break;
+      case 'Enter':
+      case ' ':
+        e.preventDefault();
+        this._select(selected);
+        return;
+      default:
+        return;
+    }
+    e.preventDefault();
+    if (!this._inRange(next)) return;
+    this._view = new Date(next.getFullYear(), next.getMonth(), 1);
+    this.setAttribute('value', iso(next));
+    this.dispatchEvent(new CustomEvent('velin-change', { bubbles: true, detail: { value: iso(next), date: next } }));
+    this._render();
+    this.shadowRoot.querySelector(`[data-iso="${iso(next)}"]`)?.focus();
+  }
+
+  _render() {
+    const label = escapeHTML(this.getAttribute('label') || 'Choose date');
+    const selected = parseISO(this.getAttribute('value'));
+    const y = this._view.getFullYear();
+    const m = this._view.getMonth();
+    const title = this._view.toLocaleString(undefined, { month: 'long', year: 'numeric' });
+    const start = new Date(y, m, 1);
+    const startDow = (start.getDay() + 6) % 7; // Monday-first
+    const daysInMonth = new Date(y, m + 1, 0).getDate();
+    const dows = ['Mo', 'Tu', 'We', 'Th', 'Fr', 'Sa', 'Su'];
+
+    let cells = dows.map((d) => `<div class="dow" aria-hidden="true">${d}</div>`).join('');
+    for (let i = 0; i < startDow; i += 1) {
+      const d = new Date(y, m, -startDow + i + 1);
+      cells += `<button type="button" class="day out" tabindex="-1" data-iso="${iso(d)}" aria-label="${iso(d)}">${d.getDate()}</button>`;
+    }
+    for (let day = 1; day <= daysInMonth; day += 1) {
+      const d = new Date(y, m, day);
+      const id = iso(d);
+      const sel = selected && iso(selected) === id;
+      const disabled = !this._inRange(d);
+      cells += `<button type="button" class="day" data-iso="${id}" aria-label="${id}" aria-selected="${sel ? 'true' : 'false'}" aria-disabled="${disabled ? 'true' : 'false'}" tabindex="${sel ? '0' : '-1'}">${day}</button>`;
+    }
+
+    this.shadowRoot.innerHTML = `
+      <style>${styles}</style>
+      <div class="cal" role="group" aria-label="${label}">
+        <div class="head">
+          <button type="button" class="nav" data-nav="-1" aria-label="Previous month">‹</button>
+          <p class="title" id="cal-title">${escapeHTML(title)}</p>
+          <button type="button" class="nav" data-nav="1" aria-label="Next month">›</button>
+        </div>
+        <div class="grid" role="grid" aria-labelledby="cal-title">${cells}</div>
+      </div>
+    `;
+
+    this.shadowRoot.querySelectorAll('[data-nav]').forEach((btn) => {
+      btn.addEventListener('click', () => this._shiftMonth(Number(btn.getAttribute('data-nav'))));
+    });
+    this.shadowRoot.querySelectorAll('.day').forEach((btn) => {
+      btn.addEventListener('click', () => {
+        if (btn.getAttribute('aria-disabled') === 'true') return;
+        const d = parseISO(btn.getAttribute('data-iso'));
+        if (d) this._select(d);
+      });
+      btn.addEventListener('keydown', this._onKey);
+    });
+  }
+}
+
+customElements.define('velin-calendar', VelinCalendar);
+export default VelinCalendar;

package/components/velin-command.js

@@ -11,9 +11,14 @@ const styles = `
     padding: 10vh var(--velin-space-4, 1rem) var(--velin-space-4, 1rem);
     background: var(--velin-color-overlay, rgba(0,0,0,0.4));
     opacity: 0; visibility: hidden;
+    pointer-events: none;
     transition: opacity 150ms ease, visibility 150ms ease;
   }
-  :host([open]) .overlay { opacity: 1; visibility: visible; }
+  :host([open]) .overlay {
+    opacity: 1;
+    visibility: visible;
+    pointer-events: auto;
+  }
   .panel {
     inline-size: min(32rem, 100%);
     background: var(--velin-color-surface-bright, #fff);
@@ -66,6 +71,7 @@ class VelinCommand extends HTMLElement {
       </div>
     `;
     this.shadowRoot.querySelector('.search').addEventListener('input', this._onInput);
+    this.shadowRoot.querySelector('.overlay')?.addEventListener('click', this._onOverlayClick);
     this.shadowRoot.querySelector('slot')?.addEventListener('slotchange', () => this._filter(''));
     this._filter('');
   }
@@ -79,6 +85,14 @@ class VelinCommand extends HTMLElement {
     this.removeAttribute('open');
     this.dispatchEvent(new CustomEvent('velin-close', { bubbles: true }));
   }
+  toggle() {
+    if (this.hasAttribute('open')) this.close();
+    else this.open();
+  }
+
+  _onOverlayClick = (event) => {
+    if (event.target === event.currentTarget) this.close();
+  };
 
   _open() {
     this._prev = saveFocus();
@@ -92,7 +106,7 @@ class VelinCommand extends HTMLElement {
 
   _close() {
     document.removeEventListener('keydown', this._onKey);
-    clearBackgroundInert();
+    clearBackgroundInert(this);
     restoreFocus(this._prev);
     const input = this.shadowRoot.querySelector('.search');
     if (input) input.value = '';
@@ -135,6 +149,8 @@ class VelinCommand extends HTMLElement {
 
   disconnectedCallback() {
     document.removeEventListener('keydown', this._onKey);
+    this.shadowRoot?.querySelector('.overlay')?.removeEventListener('click', this._onOverlayClick);
+    if (this.hasAttribute('open')) clearBackgroundInert(this);
   }
 }
 

package/components/velin-data-table.js

@@ -0,0 +1,438 @@
+import { announce } from './a11y-utils.js';
+
+/**
+ * Progressive enhancement for a light-DOM `<table>`: sorting, filtering and
+ * pagination without replacing the semantic markup.
+ *
+ * The table keeps working with JavaScript disabled — every feature is layered
+ * on top of the rows that are already in the document.
+ */
+
+const SORT_TYPES = new Set(['text', 'number', 'date']);
+
+let warnedMissingName = false;
+
+/** @param {HTMLElement} cell */
+function sortValue(cell, type) {
+  const raw = cell?.dataset?.sortValue ?? cell?.textContent ?? '';
+  const text = raw.trim();
+  if (type === 'number') {
+    const num = Number.parseFloat(text.replace(/[^\d.,-]/g, '').replace(',', '.'));
+    return Number.isNaN(num) ? Number.NEGATIVE_INFINITY : num;
+  }
+  if (type === 'date') {
+    const time = Date.parse(text);
+    return Number.isNaN(time) ? Number.NEGATIVE_INFINITY : time;
+  }
+  return text.toLowerCase();
+}
+
+class VelinDataTable extends HTMLElement {
+  static get observedAttributes() {
+    return ['page-size', 'filter-input', 'empty-text', 'label', 'editable'];
+  }
+
+  constructor() {
+    super();
+    this._table = null;
+    this._page = 1;
+    this._query = '';
+    this._sortIndex = -1;
+    this._sortDirection = 'ascending';
+    this._filterEl = null;
+    this._pagination = null;
+    this._emptyRow = null;
+    this._filterTimer = null;
+    this._onFilterInput = this._onFilterInput.bind(this);
+  }
+
+  connectedCallback() {
+    this.classList.add('velin-data-table');
+    // Rows may still be streaming in when the element upgrades.
+    requestAnimationFrame(() => this._init());
+  }
+
+  disconnectedCallback() {
+    if (this._filterEl) this._filterEl.removeEventListener('input', this._onFilterInput);
+    if (this._filterTimer) clearTimeout(this._filterTimer);
+  }
+
+  attributeChangedCallback(name, previous, next) {
+    if (previous === next || !this._table) return;
+    if (name === 'page-size') {
+      this._page = 1;
+      this._render();
+    } else if (name === 'filter-input') {
+      this._bindFilterInput();
+    } else if (name === 'label') {
+      this._ensureAccessibleName();
+    }
+  }
+
+  // ── Public API ─────────────────────────────────────────────────────────────
+
+  /** @returns {HTMLTableRowElement[]} */
+  get rows() {
+    const body = this._table?.tBodies?.[0];
+    return body ? [...body.rows].filter((row) => row !== this._emptyRow) : [];
+  }
+
+  /** Rows matching the current filter, across all pages. */
+  get matchingRows() {
+    return this.rows.filter((row) => !row.dataset.velinFiltered);
+  }
+
+  /** Rows visible on the current page. */
+  get visibleRows() {
+    return this.matchingRows.filter((row) => !row.hidden);
+  }
+
+  get page() {
+    return this._page;
+  }
+
+  get pageSize() {
+    const size = Number.parseInt(this.getAttribute('page-size') || '', 10);
+    return Number.isFinite(size) && size > 0 ? size : 0;
+  }
+
+  get pageCount() {
+    const size = this.pageSize;
+    if (!size) return 1;
+    return Math.max(1, Math.ceil(this.matchingRows.length / size));
+  }
+
+  /**
+   * @param {number} index Column index
+   * @param {'ascending' | 'descending'} [direction]
+   */
+  sort(index, direction) {
+    const headers = this._headers();
+    const header = headers[index];
+    if (!header) return;
+    const type = this._sortType(header);
+    if (type === 'none') return;
+
+    this._sortDirection = direction
+      || (this._sortIndex === index && this._sortDirection === 'ascending' ? 'descending' : 'ascending');
+    this._sortIndex = index;
+
+    const factor = this._sortDirection === 'ascending' ? 1 : -1;
+    const body = this._table.tBodies[0];
+    const sorted = this.rows.slice().sort((a, b) => {
+      const av = sortValue(a.cells[index], type);
+      const bv = sortValue(b.cells[index], type);
+      if (av < bv) return -1 * factor;
+      if (av > bv) return 1 * factor;
+      return 0;
+    });
+    for (const row of sorted) body.appendChild(row);
+
+    this._syncSortState();
+    this._page = 1;
+    this._render();
+
+    const label = header.dataset.sortLabel || header.textContent.trim();
+    announce(`${label} sorted ${this._sortDirection}`);
+    this.dispatchEvent(new CustomEvent('velin-data-table-sort', {
+      bubbles: true,
+      detail: { index, direction: this._sortDirection, column: label },
+    }));
+  }
+
+  /** @param {string} query */
+  filter(query) {
+    this._query = String(query || '').trim().toLowerCase();
+    for (const row of this.rows) {
+      const match = !this._query || this._rowText(row).includes(this._query);
+      if (match) delete row.dataset.velinFiltered;
+      else row.dataset.velinFiltered = 'true';
+    }
+    this._page = 1;
+    this._render();
+
+    const count = this.matchingRows.length;
+    announce(count === 1 ? '1 row matches' : `${count} rows match`);
+    this.dispatchEvent(new CustomEvent('velin-data-table-filter', {
+      bubbles: true,
+      detail: { query: this._query, count },
+    }));
+  }
+
+  /** @param {number} page */
+  goToPage(page) {
+    const target = Math.min(Math.max(1, Math.trunc(page) || 1), this.pageCount);
+    if (target === this._page) return;
+    this._page = target;
+    this._render();
+    announce(`Page ${this._page} of ${this.pageCount}`);
+    this.dispatchEvent(new CustomEvent('velin-data-table-page', {
+      bubbles: true,
+      detail: { page: this._page, pageCount: this.pageCount },
+    }));
+  }
+
+  // ── Setup ──────────────────────────────────────────────────────────────────
+
+  _init() {
+    this._table = this.querySelector('table');
+    if (!this._table || !this._table.tBodies.length) return;
+
+    this._ensureAccessibleName();
+    this._setupSorting();
+    this._setupEditable();
+    this._bindFilterInput();
+    this._render();
+  }
+
+  _headers() {
+    const headRow = this._table.tHead?.rows?.[0];
+    return headRow ? [...headRow.cells] : [];
+  }
+
+  /** @param {HTMLTableCellElement} header */
+  _sortType(header) {
+    const declared = (header.dataset.sort || '').toLowerCase();
+    if (declared === 'none') return 'none';
+    if (SORT_TYPES.has(declared)) return declared;
+    return this.hasAttribute('sortable') ? 'text' : 'none';
+  }
+
+  /**
+   * A table without a name is unusable with a screen reader, so surface it
+   * instead of failing silently (WCAG 1.3.1 / 2.4.6).
+   */
+  _ensureAccessibleName() {
+    const table = this._table;
+    if (!table) return;
+    const label = this.getAttribute('label');
+    const hasName = table.caption?.textContent.trim()
+      || table.getAttribute('aria-label')?.trim()
+      || table.getAttribute('aria-labelledby')?.trim();
+
+    if (!hasName && label) {
+      table.setAttribute('aria-label', label);
+      return;
+    }
+    if (!hasName && !warnedMissingName) {
+      warnedMissingName = true;
+      console.warn('[velinstyle] <velin-data-table> needs a <caption>, aria-label, or a label attribute.');
+    }
+  }
+
+  /** Sortable headers get a real button so keyboard and AT support come for free. */
+  _setupSorting() {
+    this._headers().forEach((header, index) => {
+      if (this._sortType(header) === 'none') return;
+      if (header.querySelector('.velin-data-table__sort')) return;
+
+      const label = header.textContent.trim();
+      header.dataset.sortLabel = label;
+      header.setAttribute('aria-sort', 'none');
+      header.classList.add('velin-data-table__th');
+
+      const button = document.createElement('button');
+      button.type = 'button';
+      button.className = 'velin-data-table__sort';
+      button.textContent = label;
+
+      const icon = document.createElement('span');
+      icon.className = 'velin-data-table__sort-icon';
+      icon.setAttribute('aria-hidden', 'true');
+      button.appendChild(icon);
+
+      button.addEventListener('click', () => this.sort(index));
+      header.textContent = '';
+      header.appendChild(button);
+    });
+  }
+
+  /**
+   * Inline edit: double-click or Enter on focused cell with data-editable / host editable.
+   * Enter saves, Escape cancels. Dispatches velin-data-table-edit.
+   */
+  _setupEditable() {
+    if (!this.hasAttribute('editable') && !this.querySelector('[data-editable]')) return;
+    const body = this._table.tBodies[0];
+    if (!body || body.dataset.velinEditBound) return;
+    body.dataset.velinEditBound = 'true';
+
+    body.addEventListener('dblclick', (e) => {
+      const cell = e.target.closest('td');
+      if (!cell || !body.contains(cell)) return;
+      if (!this.hasAttribute('editable') && !cell.hasAttribute('data-editable')) return;
+      this._beginEdit(cell);
+    });
+
+    body.addEventListener('keydown', (e) => {
+      const cell = e.target.closest('td');
+      if (!cell || e.target !== cell) return;
+      if (e.key === 'Enter' || e.key === 'F2') {
+        if (!this.hasAttribute('editable') && !cell.hasAttribute('data-editable')) return;
+        e.preventDefault();
+        this._beginEdit(cell);
+      }
+    });
+
+    for (const cell of body.querySelectorAll('td[data-editable], td')) {
+      if (!this.hasAttribute('editable') && !cell.hasAttribute('data-editable')) continue;
+      if (!cell.hasAttribute('tabindex')) cell.setAttribute('tabindex', '0');
+    }
+  }
+
+  /** @param {HTMLTableCellElement} cell */
+  _beginEdit(cell) {
+    if (cell.querySelector('input')) return;
+    const previous = cell.textContent.trim();
+    const input = document.createElement('input');
+    input.className = 'velin-input velin-data-table__edit';
+    input.value = previous;
+    input.setAttribute('aria-label', 'Edit cell');
+    cell.textContent = '';
+    cell.appendChild(input);
+    input.focus();
+    input.select();
+
+    const commit = (save) => {
+      const next = save ? input.value.trim() : previous;
+      cell.textContent = next;
+      if (save && next !== previous) {
+        this.dispatchEvent(new CustomEvent('velin-data-table-edit', {
+          bubbles: true,
+          detail: {
+            cell,
+            row: cell.parentElement,
+            previous,
+            value: next,
+            columnIndex: cell.cellIndex,
+          },
+        }));
+        announce('Cell updated');
+      }
+    };
+
+    input.addEventListener('keydown', (e) => {
+      if (e.key === 'Enter') {
+        e.preventDefault();
+        commit(true);
+      } else if (e.key === 'Escape') {
+        e.preventDefault();
+        commit(false);
+      }
+    });
+    input.addEventListener('blur', () => commit(true));
+  }
+
+  _syncSortState() {
+    this._headers().forEach((header, index) => {
+      if (this._sortType(header) === 'none') return;
+      const active = index === this._sortIndex;
+      header.setAttribute('aria-sort', active ? this._sortDirection : 'none');
+      header.querySelector('.velin-data-table__sort')?.classList.toggle('velin-data-table__sort--active', active);
+    });
+  }
+
+  _bindFilterInput() {
+    if (this._filterEl) this._filterEl.removeEventListener('input', this._onFilterInput);
+    const selector = this.getAttribute('filter-input');
+    this._filterEl = selector ? document.querySelector(selector) : null;
+    if (this._filterEl) this._filterEl.addEventListener('input', this._onFilterInput);
+  }
+
+  _onFilterInput(event) {
+    if (this._filterTimer) clearTimeout(this._filterTimer);
+    const value = event.target.value;
+    this._filterTimer = setTimeout(() => this.filter(value), 150);
+  }
+
+  /** @param {HTMLTableRowElement} row */
+  _rowText(row) {
+    const scoped = [...row.cells].filter((cell) => cell.hasAttribute('data-filter'));
+    const cells = scoped.length ? scoped : [...row.cells];
+    return cells.map((cell) => cell.textContent || '').join(' ').toLowerCase();
+  }
+
+  // ── Rendering ──────────────────────────────────────────────────────────────
+
+  _render() {
+    const size = this.pageSize;
+    this._page = Math.min(this._page, this.pageCount);
+    const matching = this.matchingRows;
+    const start = size ? (this._page - 1) * size : 0;
+    const end = size ? start + size : matching.length;
+
+    for (const row of this.rows) {
+      const index = matching.indexOf(row);
+      row.hidden = index === -1 || index < start || index >= end;
+    }
+
+    this._renderEmptyState(matching.length === 0);
+    this._renderPagination();
+  }
+
+  /** @param {boolean} isEmpty */
+  _renderEmptyState(isEmpty) {
+    if (!isEmpty) {
+      this._emptyRow?.remove();
+      this._emptyRow = null;
+      return;
+    }
+    if (this._emptyRow?.isConnected) return;
+
+    const columns = this._headers().length || 1;
+    const row = document.createElement('tr');
+    row.className = 'velin-data-table__empty';
+    const cell = document.createElement('td');
+    cell.colSpan = columns;
+    cell.textContent = this.getAttribute('empty-text') || 'No matching rows';
+    row.appendChild(cell);
+    this._table.tBodies[0].appendChild(row);
+    this._emptyRow = row;
+  }
+
+  _renderPagination() {
+    if (!this.pageSize || this.pageCount <= 1) {
+      this._pagination?.remove();
+      this._pagination = null;
+      return;
+    }
+
+    if (!this._pagination?.isConnected) {
+      const nav = document.createElement('nav');
+      nav.className = 'velin-data-table__pagination';
+      nav.setAttribute('aria-label', this.getAttribute('pagination-label') || 'Table pagination');
+
+      const previous = document.createElement('button');
+      previous.type = 'button';
+      previous.className = 'velin-btn velin-btn--outline velin-btn--sm';
+      previous.dataset.velinPage = 'previous';
+      previous.textContent = this.getAttribute('previous-text') || 'Previous';
+      previous.addEventListener('click', () => this.goToPage(this._page - 1));
+
+      const status = document.createElement('p');
+      status.className = 'velin-data-table__page-status';
+      status.dataset.velinPage = 'status';
+
+      const next = document.createElement('button');
+      next.type = 'button';
+      next.className = 'velin-btn velin-btn--outline velin-btn--sm';
+      next.dataset.velinPage = 'next';
+      next.textContent = this.getAttribute('next-text') || 'Next';
+      next.addEventListener('click', () => this.goToPage(this._page + 1));
+
+      nav.append(previous, status, next);
+      this.appendChild(nav);
+      this._pagination = nav;
+    }
+
+    const status = this._pagination.querySelector('[data-velin-page="status"]');
+    if (status) status.textContent = `Page ${this._page} of ${this.pageCount}`;
+    const previous = this._pagination.querySelector('[data-velin-page="previous"]');
+    const next = this._pagination.querySelector('[data-velin-page="next"]');
+    if (previous) previous.disabled = this._page <= 1;
+    if (next) next.disabled = this._page >= this.pageCount;
+  }
+}
+
+customElements.define('velin-data-table', VelinDataTable);
+export default VelinDataTable;