@vuecs/table 1.0.0

package/dist/style.css

@@ -0,0 +1,145 @@
+.vc-table {
+  border-collapse: collapse;
+  box-sizing: border-box;
+  width: 100%;
+}
+
+.vc-table-scroll-container {
+  position: relative;
+  overflow: auto;
+}
+
+.vc-table-row[tabindex="0"] {
+  cursor: pointer;
+}
+
+.vc-table-row[tabindex="0"]:focus-visible {
+  outline-offset: -2px;
+  outline: 2px solid;
+}
+
+.vc-table-cell, .vc-table-head-cell {
+  box-sizing: border-box;
+  text-align: left;
+  vertical-align: middle;
+}
+
+.vc-table-head-cell[role="columnheader"][tabindex="0"] {
+  cursor: pointer;
+  user-select: none;
+}
+
+.vc-table-head-cell-sort-icon {
+  vertical-align: baseline;
+  margin-left: .25rem;
+  font-size: .75em;
+  line-height: 1;
+  display: inline-block;
+}
+
+.vc-table-head-cell[data-sort-index]:after {
+  content: attr(data-sort-index);
+  vertical-align: super;
+  opacity: .75;
+  margin-inline-start: .125rem;
+  font-size: .6em;
+  line-height: 1;
+  display: inline-block;
+}
+
+.vc-table-loading-overlay {
+  pointer-events: auto;
+  z-index: 1;
+  justify-content: center;
+  align-items: center;
+  display: flex;
+  position: absolute;
+  inset: 0;
+}
+
+.vc-table-head-cell[data-sticky-column], .vc-table-cell[data-sticky-column] {
+  position: sticky;
+  left: 0;
+}
+
+@media (width <= 640px) {
+  .vc-table[data-responsive="true"] thead {
+    clip-path: inset(50%);
+    white-space: nowrap;
+    border: 0;
+    width: 1px;
+    height: 1px;
+    margin: -1px;
+    padding: 0;
+    position: absolute;
+    overflow: hidden;
+  }
+
+  .vc-table[data-responsive="true"] tbody, .vc-table[data-responsive="true"] tr {
+    width: 100%;
+    display: block;
+  }
+
+  .vc-table[data-responsive="true"] tr {
+    margin-bottom: .75rem;
+  }
+
+  .vc-table[data-responsive="true"] tbody td, .vc-table[data-responsive="true"] tbody th {
+    text-align: left;
+    align-items: baseline;
+    gap: .75rem;
+    padding: .5rem .75rem;
+    display: flex;
+  }
+
+  .vc-table[data-responsive="true"] tbody td:before, .vc-table[data-responsive="true"] tbody th:before {
+    content: attr(data-label);
+    color: inherit;
+    flex: 0 0 8rem;
+    font-weight: 600;
+  }
+
+  .vc-table[data-responsive="true"] tbody td:not([data-label]):before, .vc-table[data-responsive="true"] tbody th:not([data-label]):before, .vc-table[data-responsive="true"] tbody td[data-label=""]:before, .vc-table[data-responsive="true"] tbody th[data-label=""]:before {
+    content: none;
+  }
+}
+
+.vc-table-sort-indicators {
+  flex-wrap: wrap;
+  align-items: center;
+  gap: .375rem;
+  display: flex;
+}
+
+.vc-table-sort-indicators-chip {
+  font: inherit;
+  align-items: center;
+  display: inline-flex;
+}
+
+.vc-table-sort-indicators-chip-toggle {
+  font: inherit;
+  cursor: pointer;
+  align-items: center;
+  gap: .375rem;
+  display: inline-flex;
+}
+
+.vc-table-sort-indicators-chip-remove {
+  cursor: pointer;
+  justify-content: center;
+  align-items: center;
+  line-height: 1;
+  display: inline-flex;
+}
+
+.vc-table-sort-indicators-add, .vc-table-sort-indicators-clear {
+  font: inherit;
+  cursor: pointer;
+}
+
+.vc-table-selector-checkbox {
+  cursor: pointer;
+  vertical-align: middle;
+  accent-color: var(--vc-color-primary-600);
+}

package/dist/theme.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentThemeDefinition } from '@vuecs/core';
+import type { TableBodyThemeClasses, TableCellThemeClasses, TableEmptyThemeClasses, TableFooterThemeClasses, TableHeadCellThemeClasses, TableHeaderThemeClasses, TableLoadingThemeClasses, TableRowThemeClasses, TableSortIndicatorsThemeClasses, TableThemeClasses } from './types';
+export declare const tableThemeDefaults: ComponentThemeDefinition<TableThemeClasses>;
+export declare const tableHeaderThemeDefaults: ComponentThemeDefinition<TableHeaderThemeClasses>;
+export declare const tableBodyThemeDefaults: ComponentThemeDefinition<TableBodyThemeClasses>;
+export declare const tableFooterThemeDefaults: ComponentThemeDefinition<TableFooterThemeClasses>;
+export declare const tableRowThemeDefaults: ComponentThemeDefinition<TableRowThemeClasses>;
+export declare const tableCellThemeDefaults: ComponentThemeDefinition<TableCellThemeClasses>;
+export declare const tableHeadCellThemeDefaults: ComponentThemeDefinition<TableHeadCellThemeClasses>;
+export declare const tableEmptyThemeDefaults: ComponentThemeDefinition<TableEmptyThemeClasses>;
+export declare const tableLoadingThemeDefaults: ComponentThemeDefinition<TableLoadingThemeClasses>;
+export declare const tableSortIndicatorsThemeDefaults: ComponentThemeDefinition<TableSortIndicatorsThemeClasses>;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../src/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,KAAK,EACR,qBAAqB,EACrB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,oBAAoB,EACpB,+BAA+B,EAC/B,iBAAiB,EACpB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,kBAAkB,EAAE,wBAAwB,CAAC,iBAAiB,CAK1E,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,wBAAwB,CAAC,uBAAuB,CAA4C,CAAC;AAEpI,eAAO,MAAM,sBAAsB,EAAE,wBAAwB,CAAC,qBAAqB,CAA0C,CAAC;AAE9H,eAAO,MAAM,wBAAwB,EAAE,wBAAwB,CAAC,uBAAuB,CAA4C,CAAC;AAEpI,eAAO,MAAM,qBAAqB,EAAE,wBAAwB,CAAC,oBAAoB,CAAyC,CAAC;AAE3H,eAAO,MAAM,sBAAsB,EAAE,wBAAwB,CAAC,qBAAqB,CAA0C,CAAC;AAE9H,eAAO,MAAM,0BAA0B,EAAE,wBAAwB,CAAC,yBAAyB,CAK1F,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,wBAAwB,CAAC,sBAAsB,CAA2C,CAAC;AAEjI,eAAO,MAAM,yBAAyB,EAAE,wBAAwB,CAAC,wBAAwB,CAKxF,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,wBAAwB,CAAC,+BAA+B,CAetG,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,248 @@
+import type { ThemeElementDefinition, VNodeClass } from '@vuecs/core';
+/**
+ * Bare-string shorthand: `'name'` is equivalent to
+ * `{ key: 'name', label: startCase('name') }`.
+ */
+export type TableColumnRaw<Row = unknown, K extends string = string> = K | TableColumn<Row, K>;
+export type TableColumnFormatterCtx<Row, K extends string = string> = {
+    value: unknown;
+    key: K;
+    row: Row;
+};
+export type TableColumnHeaderAttrsCtx<K extends string = string> = {
+    key: K;
+    type: 'top' | 'bottom';
+};
+export interface TableColumn<Row = unknown, K extends string = string> {
+    /** Key into the row object. Used as the cell value default and the slot suffix. */
+    key: K;
+    /** Heading text. Defaults to `startCase(key)`. Override per-column via `#header-<key>` slot. */
+    label?: string;
+    /** Optional class string applied to BOTH `<th>` AND `<td>` for this column. */
+    class?: VNodeClass;
+    /** Class concatenated onto the `<th>` (in addition to `class`). Additive, not replacing. */
+    headerClass?: VNodeClass;
+    /** Class concatenated onto the `<td>` (in addition to `class`). Additive, not replacing. */
+    cellClass?: VNodeClass;
+    /** Marks the column sortable. Click / Enter / Space cycles sort state and emits `update:sort`. */
+    sortable?: boolean;
+    /**
+     * Value accessor when the row's value isn't `row[key]`.
+     * - String: dot-path (e.g. `'profile.email'`) — resolved against `row` at render time.
+     * - Function: `(row) => unknown` — full custom resolution.
+     */
+    accessor?: string | ((row: Row) => unknown);
+    /**
+     * Default cell renderer when `#cell-<key>` slot isn't provided.
+     * Object-arg shape (matches `cellAttrs` / `headerAttrs`).
+     */
+    formatter?: (ctx: TableColumnFormatterCtx<Row, K>) => string;
+    /**
+     * Render this column's `<td>` as `<th scope="row">` instead.
+     * Highest-leverage a11y switch for entity-name columns: screen readers
+     * announce row-header + column-header for every other cell in the row.
+     */
+    isRowHeader?: boolean;
+    /**
+     * Per-cell attribute escape hatch — applied to the `<td>` (or `<th>` when
+     * `isRowHeader`). Object form is static; function form receives the same
+     * ctx as `formatter`. Common uses: `data-testid`, ARIA labels.
+     */
+    cellAttrs?: Record<string, unknown> | ((ctx: TableColumnFormatterCtx<Row, K>) => Record<string, unknown>);
+    /**
+     * Per-header attribute escape hatch — applied to the `<th>`. Object form
+     * is static; function form receives `{ key, type }` where `type` is
+     * `'top'` (header band) or `'bottom'` (footer band, when present).
+     */
+    headerAttrs?: Record<string, unknown> | ((ctx: TableColumnHeaderAttrsCtx<K>) => Record<string, unknown>);
+    /** Native `<th title="…">`. */
+    headerTitle?: string;
+    /** Native `<th abbr="…">`. */
+    headerAbbr?: string;
+    /**
+     * `position: sticky; left: 0` on this column's `<th>` + `<td>`. Theme owns
+     * the CSS (each shipping theme adds a `stickyColumn` variant axis on
+     * `tableCell` / `tableHeadCell`).
+     */
+    stickyColumn?: boolean;
+    /** Default direction when this column is sorted for the first time. Defaults to `'asc'`. */
+    initialSortDirection?: 'asc' | 'desc';
+    /**
+     * Custom comparator for client-side sort (plan 033 v1.x-B). Receives
+     * the two resolved values from `accessor` (or `formatter` output when
+     * `sortByFormatted: true`) — same ergonomics as
+     * `Array.prototype.sort`. Return a negative number when `a` should
+     * come first, positive for `b`, zero when equal.
+     *
+     * Use for semver, IP addresses, locale-aware strings, custom epochs,
+     * or any value where the default `<` / `>` ordering is wrong.
+     */
+    sortFn?: (a: unknown, b: unknown) => number;
+    /**
+     * When `true`, client-side sort compares the formatter output rather
+     * than the raw accessor value. Default `false` — sort by raw value
+     * so dates / numbers sort chronologically / numerically even when
+     * the cell displays "2 days ago" / "$1,234.56". (plan 033 v1.x-B)
+     */
+    sortByFormatted?: boolean;
+    /**
+     * Client-side sort null-handling override. By default, `null` /
+     * `undefined` values sort to the END regardless of direction
+     * ("missing data lives at the bottom"). Set `true` to float them to
+     * the start instead. (plan 033 v1.x-B)
+     */
+    nullsFirst?: boolean;
+}
+export type RowVariant = 'success' | 'warning' | 'error' | 'info' | 'neutral' | 'primary';
+/**
+ * Row-meta escape hatch. Underscore-prefixed fields on the data row itself
+ * control visual state without forcing consumers to wire a function prop or
+ * additional column.
+ *
+ *   const users: WithRowMeta<User>[] = [
+ *       { id: 1, name: 'Alice', _rowVariant: 'warning' },
+ *       { id: 2, name: 'Bob',   _cellVariants: { email: 'error' } },
+ *   ];
+ *
+ * Underscore prefix prevents collision with real data keys. Consumers that
+ * send rows back to a server should strip these client-side fields.
+ */
+export type WithRowMeta<T> = T & {
+    /** Applied to the entire `<tr>` via `tableRow.rowVariant.<value>`. */
+    _rowVariant?: RowVariant | null;
+    /** Applied per-cell — keyed by column key — via `tableCell.cellVariant.<value>`. */
+    _cellVariants?: Partial<Record<keyof T & string, RowVariant>>;
+};
+export type SortDirection = 'asc' | 'desc';
+/**
+ * A single sort step. The array form `SortDescriptor[]` is the public
+ * shape of `v-model:sort` from v1.x-B onward — single-column sort
+ * becomes an array of length 0 or 1.
+ */
+export type SortDescriptor = {
+    key: string;
+    direction: SortDirection;
+};
+/**
+ * Public sort state shape — always an array since v1.x-B (breaking
+ * change from v0.1's `{ key, direction } | null`). An empty array
+ * means "no sort active". Multi-key sort appends additional descriptors;
+ * the first descriptor is the primary key, the second is the
+ * tie-breaker, etc.
+ */
+export type TableSortState = SortDescriptor[];
+export type TableThemeClasses = {
+    /** The outer `<table>` (or its `<div class="scrollContainer">` wrapper when `:scrollable`). */
+    root: string;
+    /** The overflow wrapper rendered when `:scrollable` is set. */
+    scrollContainer: string;
+};
+export type TableHeaderThemeClasses = {
+    /** The `<thead>` band. */
+    root: string;
+};
+export type TableBodyThemeClasses = {
+    /** The `<tbody>` band. */
+    root: string;
+};
+export type TableFooterThemeClasses = {
+    /** The `<tfoot>` band. */
+    root: string;
+};
+export type TableRowThemeClasses = {
+    /** The `<tr>` element. */
+    root: string;
+};
+export type TableCellThemeClasses = {
+    /** The `<td>` element. */
+    root: string;
+};
+export type TableHeadCellThemeClasses = {
+    /** The `<th>` element. */
+    root: string;
+    /** The sort-indicator wrapper rendered alongside the label when `sortable`. */
+    sortIcon: string;
+};
+export type TableEmptyThemeClasses = {
+    /** The `<tbody>` (or `<td>` child) carrying the empty-state message. */
+    root: string;
+};
+export type TableLoadingThemeClasses = {
+    /** The `<tbody>` band (default) OR the overlay `<div>` (when `:overlay`). */
+    root: string;
+    /** Applied only in overlay mode. */
+    overlay: string;
+};
+export type TableSortIndicatorsThemeClasses = {
+    /** The bar container `<div>`. */
+    root: string;
+    /** The leading `"Sort:"` label. */
+    label: string;
+    /** The empty-state hint shown when no descriptors are active. */
+    empty: string;
+    /** The chip wrapper `<div>` (non-interactive — holds the two buttons). */
+    chip: string;
+    /** The toggle `<button>` inside a chip (cycles asc ↔ desc on click). */
+    chipToggle: string;
+    /** The 1-based position prefix (`1.`, `2.`, …) inside the toggle button. */
+    chipPosition: string;
+    /** The column label inside the toggle button. */
+    chipLabel: string;
+    /** The direction arrow inside the toggle button (↑ / ↓). */
+    chipArrow: string;
+    /** The `×` remove `<button>` at the trailing edge of a chip. */
+    chipRemove: string;
+    /**
+     * Wrapper element around the "Add column" `<select>`. Optional —
+     * themes that style the `<select>` directly leave it empty
+     * (Tailwind, Bootstrap). Bulma's `.select` is a wrapper pattern,
+     * so theme-bulma populates this slot.
+     */
+    addWrapper: string;
+    /** The "Add column" `<select>` element. */
+    add: string;
+    /** The "Clear all" trigger. */
+    clear: string;
+};
+declare module '@vuecs/core' {
+    interface ThemeElements {
+        table?: ThemeElementDefinition<TableThemeClasses>;
+        tableHeader?: ThemeElementDefinition<TableHeaderThemeClasses>;
+        tableBody?: ThemeElementDefinition<TableBodyThemeClasses>;
+        tableFooter?: ThemeElementDefinition<TableFooterThemeClasses>;
+        tableRow?: ThemeElementDefinition<TableRowThemeClasses>;
+        tableCell?: ThemeElementDefinition<TableCellThemeClasses>;
+        tableHeadCell?: ThemeElementDefinition<TableHeadCellThemeClasses>;
+        tableEmpty?: ThemeElementDefinition<TableEmptyThemeClasses>;
+        tableLoading?: ThemeElementDefinition<TableLoadingThemeClasses>;
+        tableSortIndicators?: ThemeElementDefinition<TableSortIndicatorsThemeClasses>;
+    }
+}
+export type TableSlotProps<Row = unknown> = {
+    data: Row[];
+    busy: boolean;
+    columns: TableColumn<Row>[];
+    sort: TableSortState;
+    setSort: (key: string, opts?: {
+        append?: boolean;
+        direction?: SortDirection;
+    }) => void;
+};
+export type TableBodyRowSlotProps<Row = unknown> = {
+    row: Row;
+    index: number;
+};
+export type TableCellSlotProps<Row = unknown> = {
+    row: Row;
+    value: unknown;
+    key: string;
+    column: TableColumn<Row>;
+    index: number;
+};
+export type TableHeadCellSlotProps<Row = unknown> = {
+    column: TableColumn<Row>;
+    key: string;
+    sort: SortDirection | null;
+    setSort: (direction?: SortDirection) => void;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/utils/auto-render.d.ts

@@ -0,0 +1,31 @@
+import type { TableColumn } from '../types';
+/**
+ * Recursively check whether `nodes` (a slot return) contains a vnode
+ * whose `type` equals `target`. Recurses into Vue `Fragment` vnodes so
+ * `<template v-if>` / `<template v-for>` wrapping around a part
+ * doesn't hide it from the auto-render check.
+ *
+ * Used by `<VCTable>` and `<VCTableLite>` to detect whether the
+ * consumer wrote a manual `<VCTableHeader>` / `<VCTableBody>` in the
+ * default slot — if not, and `:columns` is set, the table renders the
+ * missing band itself.
+ */
+export declare function containsComponent(nodes: unknown, target: unknown): boolean;
+/**
+ * Compose the inner children of a `<table>` for the driver auto-render
+ * path (plan 033 v0.2-B). Returns the array of vnodes in the order
+ * the table should render them:
+ *
+ *   caption? · colgroup? · autoHeader? · slotChildren · autoBody?
+ *
+ * Header / body auto-render fires when `columns.length > 0` AND the
+ * matching part isn't already present in `slotChildren` (Fragment-
+ * aware via `containsComponent`).
+ */
+export declare function composeTableInner(opts: {
+    cols: TableColumn<unknown>[];
+    slotChildren: unknown;
+    captionSlot?: (() => unknown) | undefined;
+    colgroupSlot?: (() => unknown) | undefined;
+}): unknown[];
+//# sourceMappingURL=auto-render.d.ts.map

package/dist/utils/auto-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-render.d.ts","sourceRoot":"","sources":["../../src/utils/auto-render.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAa1E;AAkDD;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACpC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;IAC7B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,CAAC;IAC1C,YAAY,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,GAAG,SAAS,CAAC;CAC9C,GAAG,OAAO,EAAE,CAiEZ"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './render-utils';
+export * from './sort-rows';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC"}

package/dist/utils/render-utils.d.ts

@@ -0,0 +1,49 @@
+import type { TableColumn, TableColumnRaw } from '../types';
+/**
+ * Convert a key like `'firstName'` / `'first_name'` / `'first-name'` to
+ * `'First Name'`. Used by the bare-string column shorthand to derive
+ * a label when only the key is given.
+ */
+export declare function startCase(input: string): string;
+/**
+ * Normalize the `:columns` prop into a uniform `TableColumn[]`.
+ *
+ * - **Explicit array** (including empty `[]`): pass through, fill `label`
+ *   from `startCase(key)`. Treating `[]` as authoritative lets consumers
+ *   deliberately render a header-less table during loading without the
+ *   auto-derive kicking in the moment data arrives.
+ * - **Bare-string shorthand**: `['id', 'name']` → `[{ key, label }, ...]`.
+ * - **Auto-derive**: only when `columns` is `undefined` AND `data[0]` is an
+ *   object, derive the columns from `Object.keys(data[0])`, skipping
+ *   underscore-prefixed row-meta keys (`_rowVariant` / `_cellVariants`).
+ */
+export declare function normalizeColumns<Row>(columns: ReadonlyArray<TableColumnRaw<Row>> | undefined, data: ReadonlyArray<Row>): TableColumn<Row>[];
+/**
+ * Resolve a column's value against a row.
+ *
+ * - String accessor: dot-path lookup (e.g. `'profile.email'` → `row.profile.email`)
+ * - Function accessor: invoked with the row
+ * - Falls back to `row[column.key]`
+ */
+export declare function resolveCellValue<Row>(column: TableColumn<Row>, row: Row): unknown;
+/**
+ * Resolve attribute objects, supporting both static-object and function forms
+ * used by `cellAttrs` and `headerAttrs`.
+ */
+export declare function resolveAttrs<Ctx>(attrs: Record<string, unknown> | ((ctx: Ctx) => Record<string, unknown>) | undefined, ctx: Ctx): Record<string, unknown> | undefined;
+/**
+ * Returns `true` when a row-level click should be suppressed because the
+ * event originated inside an interactive descendant — a button, anchor,
+ * form input, role=button/link, an explicitly-focusable element, or a
+ * portal'd overlay rendered into the document body (e.g. a
+ * `<VCDropdownMenu>` action menu inside the row).
+ *
+ * Pass the `<tr>` element as `rowEl` so the helper can disambiguate
+ * legitimate row clicks (where the `closest()` ancestor walk reaches the
+ * `<tr>` itself, which carries `tabindex="0"` when the row is clickable)
+ * from clicks on a genuine interactive descendant.
+ *
+ * Use at the row click handler: `if (filterRowClickEvent(event, tr)) return;`.
+ */
+export declare function filterRowClickEvent(event: Event, rowEl?: Element | null): boolean;
+//# sourceMappingURL=render-utils.d.ts.map

package/dist/utils/render-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-utils.d.ts","sourceRoot":"","sources":["../../src/utils/render-utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE5D;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU/C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAChC,OAAO,EAAE,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,GAAG,SAAS,EACvD,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GACzB,WAAW,CAAC,GAAG,CAAC,EAAE,CAoBpB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAYjF;AAYD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,EACpF,GAAG,EAAE,GAAG,GACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGrC;AA4BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,GAAG,OAAO,CAUjF"}

package/dist/utils/sort-rows.d.ts

@@ -0,0 +1,29 @@
+import type { SortDescriptor, TableColumn } from '../types';
+export type SortRowsOptions<Row = unknown> = {
+    columns: ReadonlyArray<TableColumn<Row>>;
+    sorts: ReadonlyArray<SortDescriptor>;
+};
+/**
+ * Client-side row sort (plan 033 v1.x-B).
+ *
+ * Returns a new array — the input is untouched. Honors:
+ *
+ * - **Sort key**: `column.sortByFormatted` → use `formatter` output;
+ *   else → use `accessor` resolved value (default, matches v0.1
+ *   `resolveCellValue`).
+ * - **Comparator**: `column.sortFn(a, b) => number` when present;
+ *   else a built-in compare that handles numbers, Dates, booleans,
+ *   and uses `localeCompare` (with `numeric: true`) for everything
+ *   else — so `'item 2'` sorts before `'item 10'`.
+ * - **Null handling**: `null` / `undefined` sort LAST regardless of
+ *   direction. Per-column `nullsFirst: true` floats them to the top.
+ * - **Multi-key tie-break**: descriptors are applied in order. The
+ *   first non-zero comparison wins.
+ * - **Stability**: relies on `Array.prototype.sort`'s stable
+ *   guarantee (ES2019+, every supported runtime).
+ *
+ * Empty `sorts` returns a shallow copy — never the input reference
+ * itself, so callers can safely mutate the result.
+ */
+export declare function sortRows<Row>(rows: ReadonlyArray<Row>, options: SortRowsOptions<Row>): Row[];
+//# sourceMappingURL=sort-rows.d.ts.map

package/dist/utils/sort-rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort-rows.d.ts","sourceRoot":"","sources":["../../src/utils/sort-rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,cAAc,EAEd,WAAW,EACd,MAAM,UAAU,CAAC;AAGlB,MAAM,MAAM,eAAe,CAAC,GAAG,GAAG,OAAO,IAAI;IACzC,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EACxB,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,EACxB,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,GAC9B,GAAG,EAAE,CAcP"}

package/dist/vue.d.ts

@@ -0,0 +1,27 @@
+import type VCTable from './components/Table.vue';
+import type VCTableBody from './components/TableBody.vue';
+import type VCTableCell from './components/TableCell.vue';
+import type VCTableEmpty from './components/TableEmpty.vue';
+import type VCTableFooter from './components/TableFooter.vue';
+import type VCTableHeadCell from './components/TableHeadCell.vue';
+import type VCTableHeader from './components/TableHeader.vue';
+import type VCTableLite from './components/TableLite.vue';
+import type VCTableLoading from './components/TableLoading.vue';
+import type VCTableRow from './components/TableRow.vue';
+import type VCTableSortIndicators from './components/TableSortIndicators.vue';
+declare module '@vue/runtime-core' {
+    interface GlobalComponents {
+        VCTable: typeof VCTable;
+        VCTableLite: typeof VCTableLite;
+        VCTableHeader: typeof VCTableHeader;
+        VCTableBody: typeof VCTableBody;
+        VCTableFooter: typeof VCTableFooter;
+        VCTableRow: typeof VCTableRow;
+        VCTableCell: typeof VCTableCell;
+        VCTableHeadCell: typeof VCTableHeadCell;
+        VCTableEmpty: typeof VCTableEmpty;
+        VCTableLoading: typeof VCTableLoading;
+        VCTableSortIndicators: typeof VCTableSortIndicators;
+    }
+}
+//# sourceMappingURL=vue.d.ts.map

package/dist/vue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.d.ts","sourceRoot":"","sources":["../src/vue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,wBAAwB,CAAC;AAClD,OAAO,KAAK,WAAW,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,WAAW,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,YAAY,MAAM,6BAA6B,CAAC;AAC5D,OAAO,KAAK,aAAa,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,eAAe,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,aAAa,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,WAAW,MAAM,4BAA4B,CAAC;AAC1D,OAAO,KAAK,cAAc,MAAM,+BAA+B,CAAC;AAChE,OAAO,KAAK,UAAU,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,qBAAqB,MAAM,sCAAsC,CAAC;AAE9E,OAAO,QAAQ,mBAAmB,CAAC;IAC/B,UAAiB,gBAAgB;QAC7B,OAAO,EAAE,OAAO,OAAO,CAAC;QACxB,WAAW,EAAE,OAAO,WAAW,CAAC;QAChC,aAAa,EAAE,OAAO,aAAa,CAAC;QACpC,WAAW,EAAE,OAAO,WAAW,CAAC;QAChC,aAAa,EAAE,OAAO,aAAa,CAAC;QACpC,UAAU,EAAE,OAAO,UAAU,CAAC;QAC9B,WAAW,EAAE,OAAO,WAAW,CAAC;QAChC,eAAe,EAAE,OAAO,eAAe,CAAC;QACxC,YAAY,EAAE,OAAO,YAAY,CAAC;QAClC,cAAc,EAAE,OAAO,cAAc,CAAC;QACtC,qBAAqB,EAAE,OAAO,qBAAqB,CAAC;KACvD;CACJ"}

package/package.json

@@ -0,0 +1,62 @@
+{
+    "name": "@vuecs/table",
+    "version": "1.0.0",
+    "type": "module",
+    "description": "Compound table for vuecs (Table / Header / Body / Footer / Row / Cell / HeadCell / Empty / Loading) + columns/data driver with sortable headers, row-meta variants, and row keyboard navigation. Semantic-HTML compound — no Reka primitive dependency.",
+    "exports": {
+        "./package.json": "./package.json",
+        ".": {
+            "types": "./dist/index.d.ts",
+            "style": "./dist/style.css",
+            "import": "./dist/index.mjs"
+        },
+        "./style.css": "./dist/style.css",
+        "./dist/style.css": "./dist/style.css"
+    },
+    "style": "./dist/style.css",
+    "files": [
+        "dist"
+    ],
+    "keywords": [
+        "vue",
+        "vuecs",
+        "table",
+        "compound",
+        "columns",
+        "sortable"
+    ],
+    "author": {
+        "name": "Peter Placzek",
+        "email": "contact@tada5hi.net",
+        "url": "https://tada5hi.net"
+    },
+    "license": "Apache-2.0",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/tada5hi/vuecs.git",
+        "directory": "packages/table"
+    },
+    "scripts": {
+        "build:js": "tsdown",
+        "build:types": "vue-tsc --declaration --emitDeclarationOnly -p tsconfig.build.json",
+        "build": "rimraf dist && npm run build:js && npm run build:types",
+        "test": "vitest --config test/vitest.config.ts --run",
+        "test:coverage": "vitest --config test/vitest.config.ts --run --coverage"
+    },
+    "devDependencies": {
+        "@vue/test-utils": "^2.4.10",
+        "@vuecs/core": "^3.0.0",
+        "jsdom": "^29.1.1",
+        "vue": "^3.5.34"
+    },
+    "peerDependencies": {
+        "@vuecs/core": "^3.0.0",
+        "vue": "^3.x"
+    },
+    "engines": {
+        "node": ">=22.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    }
+}