vectis-ui 0.1.0 → 0.8.0

package/dist/components/VDataTable/VDataTable.d.ts

@@ -1,21 +1,4 @@
 import { IconSource } from '../VIcon/types.js';
-/**
- * A table of data, with everything usually built around one: a title, a search field,
- * sortable columns, a selection, and pagination.
- *
- * It is a real `<table>` underneath, with a caption, proper column headers and the
- * attribute announcing how each is sorted — which is what lets a screen reader say "row
- * 3 of 40, column Name" rather than reading a grid of unrelated text. Everything around
- * it is assembled from the design system's own components rather than reinvented here.
- *
- * The JavaScript is almost all derivation — filter, then sort, then cut into pages —
- * plus two effects explained where they sit.
- *
- * How the table reacts to a narrow space, and how it fills a height, are both entirely
- * CSS: in the stacked mode each row becomes a card once the COMPONENT is narrow, with
- * nothing measured from code, and the whole thing is a column in which only the scrolling
- * area stretches.
- */
 /** One column of the table. */
 export interface DataTableColumn {
     /** Which field of a row it shows, and the name its slots are addressed by. */
@@ -27,24 +10,31 @@ export interface DataTableColumn {
     /** How its content is aligned — numbers usually belong at the end. */
     align?: 'start' | 'center' | 'end';
 }
+/** Which way a column is sorted: A to Z, or Z to A. */
+export type DataTableSortDirection = 'asc' | 'desc';
 /** Which column the table is sorted by, and in which direction. */
 export interface DataTableSort {
     key: string;
-    direction: 'asc' | 'desc';
+    direction: DataTableSortDirection;
 }
 /** How a row is identified: by the field named in `rowKey`, or failing that by its position. */
 export type DataTableRowId = string | number;
 /**
  * Everything the table is currently being asked for, reported whenever it changes so a
- * server can answer it.
+ * server can answer it. What is not set is `null` rather than left out, so the object keeps
+ * the same keys once serialized into a request.
  */
 export interface DataTableParams {
     page: number;
     perPage: number | null;
     sortKey: string | null;
-    sortDirection: 'asc' | 'desc' | null;
+    sortDirection: DataTableSortDirection | null;
     search: string;
 }
+/** How much decoration the table carries. */
+export type DataTableVariant = 'flat' | 'outlined';
+/** What a narrow container does to the rows. */
+export type DataTableResponsive = 'scroll' | 'stack';
 export interface DataTableProps<Row extends Record<string, unknown>> {
     /** The columns to show, in order. */
     columns: DataTableColumn[];
@@ -65,14 +55,19 @@ export interface DataTableProps<Row extends Record<string, unknown>> {
      * How the table is framed: nothing at all, or a card with a raised background, a border
      * and rounded corners.
      */
-    variant?: 'flat' | 'outlined';
+    variant?: DataTableVariant;
     /**
      * What happens when the component is too narrow: the table scrolls sideways, or each
      * row becomes a card with its column headings repeated inside it.
      */
-    responsive?: 'scroll' | 'stack';
+    responsive?: DataTableResponsive;
     /** Shows that the rows are being loaded. */
     loading?: boolean;
+    /**
+     * What is written beside the spinner while the rows are loading. It falls back to the design
+     * system dictionary.
+     */
+    loadingText?: string;
     /** What is said when there is no row to show. It falls back to the design system dictionary. */
     emptyText?: string;
     /**
@@ -125,7 +120,7 @@ export interface DataTableProps<Row extends Record<string, unknown>> {
     /** The choices offered for how many rows a page holds. */
     perPageOptions?: number[];
     /** What that choice is called. It falls back to the design system dictionary. */
-    perPageLabel?: string;
+    perPageText?: string;
     /**
      * How many rows there are in all on the server. It is what lets the pagination and the
      * range be right when the table only ever holds one page.
@@ -134,7 +129,7 @@ export interface DataTableProps<Row extends Record<string, unknown>> {
     /** Shows which rows are being looked at — "1–10 of 42" — in the footer. */
     showRange?: boolean;
     /** Rephrases that range. It falls back to the design system dictionary. */
-    rangeLabel?: (range: {
+    rangeText?: (range: {
         start: number;
         end: number;
         total: number;
@@ -150,7 +145,7 @@ export interface DataTableProps<Row extends Record<string, unknown>> {
      * How the selection is summed up in the footer. It says nothing at all when nothing is
      * selected, and falls back to the design system dictionary.
      */
-    selectionLabel?: (count: number) => string;
+    selectionText?: (count: number) => string;
     /**
      * What a row's checkbox is announced as. "Select row" tells a screen reader user
      * nothing about WHICH row, so this is worth supplying with something from the row
@@ -166,16 +161,34 @@ export interface DataTableProps<Row extends Record<string, unknown>> {
 }
 declare const __VLS_export: <Row extends Record<string, unknown>>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
     props: import('vue').PublicProps & __VLS_PrettifyLocal<(DataTableProps<Row> & {
-        /** The current sort. It may be driven from outside, or simply left to the table. */
+        /**
+         * Which column the rows are sorted by, and in which direction. Nothing is sorted to begin
+         * with. It may be driven from outside or simply left to the table, which sets it as headers
+         * are clicked; changing it does not send the reader back to the first page.
+         */
         sort?: DataTableSort | null;
-        /** The page being shown. */
+        /**
+         * The page being shown, counted from 1. It starts on the first, and searching or changing
+         * the page size sends it back there. It is clamped by derivation rather than written to, so
+         * a page beyond the last simply displays the last.
+         */
         page?: number;
         /**
          * How many rows a page holds. Any value above zero turns the pagination on, so passing
          * one down without binding it is enough to enable it.
          */
         perPage?: number | undefined;
+        /**
+         * The selected rows, as the identities `rowKey` gives them — never the row objects
+         * themselves. Nothing is selected to begin with, and a selection SURVIVES a change of page:
+         * the header checkbox covers the visible page alone, which is why it can be indeterminate.
+         */
         selected?: DataTableRowId[];
+        /**
+         * What is typed in the search field, empty to begin with. Only the declared columns are
+         * searched, accent- and case-insensitively; in `serverSide` mode nothing is filtered here
+         * and the term is reported through `update:params` instead.
+         */
         search?: string;
     }) & {
         "onUpdate:selected"?: ((value: DataTableRowId[]) => any) | undefined;
@@ -199,7 +212,16 @@ declare const __VLS_export: <Row extends Record<string, unknown>>(__VLS_props: N
             column: DataTableColumn;
         }) => unknown;
         /** The left side of the toolbar, replacing the `title` prop. */
-        header?: () => unknown;
+        title?(): unknown;
+        /** What the table shows while its rows are loading, replacing the spinner and its text. */
+        loading?(): unknown;
+        /**
+         * What the table shows when there is no row to show, replacing `emptyText`. It receives the
+         * search that produced the empty result, empty when nothing was searched for.
+         */
+        empty?(scope: {
+            search: string;
+        }): unknown;
     };
     emit: ((evt: "update:params", params: DataTableParams) => void) & (((event: "update:selected", value: DataTableRowId[]) => void) & ((event: "update:sort", value: DataTableSort | null) => void) & ((event: "update:page", value: number) => void) & ((event: "update:perPage", value: number | undefined) => void) & ((event: "update:search", value: string) => void));
 }>) => import('vue').VNode & {

package/dist/components/VDataTable/VDataTable.js.map

@@ -1 +1 @@
-{"version":3,"file":"VDataTable.js","names":[],"sources":["../../../src/components/VDataTable/VDataTable.vue"],"sourcesContent":["<script setup lang=\"ts\" generic=\"Row extends Record<string, unknown>\">\nimport { computed, ref, watch } from 'vue'\nimport type { StyleValue } from 'vue'\n\nimport VButton from '../VButton/VButton.vue'\nimport VCheckbox from '../VCheckbox/VCheckbox.vue'\nimport VIcon from '../VIcon/VIcon.vue'\nimport { iconProps } from '../VIcon/iconProps'\nimport { arrow_downward as arrowDownwardIcon } from '../VIcon/icons/arrow_downward'\nimport { arrow_drop_down as arrowDropDownIcon } from '../VIcon/icons/arrow_drop_down'\nimport { arrow_upward as arrowUpwardIcon } from '../VIcon/icons/arrow_upward'\nimport { search as searchIcon } from '../VIcon/icons/search'\nimport { swap_vert as swapVertIcon } from '../VIcon/icons/swap_vert'\nimport type { IconSource } from '../VIcon/types'\nimport VInput from '../VInput/VInput.vue'\nimport VMenu from '../VMenu/VMenu.vue'\nimport VMenuItem from '../VMenu/VMenuItem.vue'\nimport VPagination from '../VPagination/VPagination.vue'\nimport VSpinner from '../VSpinner/VSpinner.vue'\nimport VTypography from '../VTypography/VTypography.vue'\n\nimport { toggleValue } from '../../utils/array'\nimport { cssSize } from '../../utils/css'\nimport { isDev } from '../../utils/env'\nimport { clamp } from '../../utils/number'\nimport { normalizeText } from '../../utils/text'\n\nimport { useRootAttrs } from '../../composables/useRootAttrs'\n\nimport { useTimer } from '../../composables/useTimer'\nimport { useLocale, useMessages } from '../../i18n/state'\n\n// @core\n/**\n * A table of data, with everything usually built around one: a title, a search field,\n * sortable columns, a selection, and pagination.\n *\n * It is a real `<table>` underneath, with a caption, proper column headers and the\n * attribute announcing how each is sorted — which is what lets a screen reader say \"row\n * 3 of 40, column Name\" rather than reading a grid of unrelated text. Everything around\n * it is assembled from the design system's own components rather than reinvented here.\n *\n * The JavaScript is almost all derivation — filter, then sort, then cut into pages —\n * plus two effects explained where they sit.\n *\n * How the table reacts to a narrow space, and how it fills a height, are both entirely\n * CSS: in the stacked mode each row becomes a card once the COMPONENT is narrow, with\n * nothing measured from code, and the whole thing is a column in which only the scrolling\n * area stretches.\n */\n/** One column of the table. */\nexport interface DataTableColumn {\n  /** Which field of a row it shows, and the name its slots are addressed by. */\n  key: string\n  /** Its heading. */\n  label: string\n  /** Lets the reader sort by this column. */\n  sortable?: boolean\n  /** How its content is aligned — numbers usually belong at the end. */\n  align?: 'start' | 'center' | 'end'\n}\n\n/** Which column the table is sorted by, and in which direction. */\nexport interface DataTableSort {\n  key: string\n  direction: 'asc' | 'desc'\n}\n\n/** How a row is identified: by the field named in `rowKey`, or failing that by its position. */\nexport type DataTableRowId = string | number\n\n/**\n * Everything the table is currently being asked for, reported whenever it changes so a\n * server can answer it.\n */\nexport interface DataTableParams {\n  page: number\n  perPage: number | null\n  sortKey: string | null\n  sortDirection: 'asc' | 'desc' | null\n  search: string\n}\n\n// TRAP — this interface is exported rather than kept local, and it is generic rather than\n// referring to the component's own type parameter.\n//\n// A component typed over its rows inlines the whole signature of its props into the\n// declarations it emits, so a name that is not exported cannot be written there and the\n// build of the type declarations fails. And being lifted out of the component's scope, it\n// has no access to that parameter and must take one of its own.\nexport interface DataTableProps<Row extends Record<string, unknown>> {\n  /** The columns to show, in order. */\n  columns: DataTableColumn[]\n  /** The rows to show. */\n  rows: Row[]\n  /**\n   * Which field identifies a row. Without it a row is identified by its position, which\n   * is enough for display but not for a selection: it must be given as soon as rows can\n   * be selected, or the selection follows the positions rather than the rows.\n   */\n  rowKey?: string\n  /**\n   * A sentence describing what the table holds. It is announced before the table itself,\n   * and is what tells a screen reader user whether it is worth exploring.\n   */\n  caption?: string\n  /**\n   * How the table is framed: nothing at all, or a card with a raised background, a border\n   * and rounded corners.\n   */\n  variant?: 'flat' | 'outlined'\n  /**\n   * What happens when the component is too narrow: the table scrolls sideways, or each\n   * row becomes a card with its column headings repeated inside it.\n   */\n  responsive?: 'scroll' | 'stack'\n  /** Shows that the rows are being loaded. */\n  loading?: boolean\n  /** What is said when there is no row to show. It falls back to the design system dictionary. */\n  emptyText?: string\n  /**\n   * A title above the table, on the left of its toolbar.\n   *\n   * Note that this prop shadows the HTML attribute of the same name on the component\n   * itself, an accepted trade-off — a tooltip over a whole table would be of little\n   * use.\n   */\n  title?: string\n  /** Adds a search field to the toolbar. */\n  searchable?: boolean\n  /** What that field says while empty. It falls back to the design system dictionary. */\n  searchPlaceholder?: string\n  /**\n   * What screen readers announce for the search field. It falls back to the design\n   * system dictionary.\n   */\n  searchLabel?: string\n  /**\n   * When a server does the searching, how long to wait after a keystroke before asking\n   * it, in milliseconds. Zero asks at once.\n   */\n  searchDebounce?: number\n  /** Tints every other row, which helps the eye follow a long line across the table. */\n  striped?: boolean\n  /**\n   * Keeps the column headings in place while the rows scroll under them. It needs a\n   * bounded scrolling area to work: either the `height` prop, or a parent with a height\n   * of its own.\n   */\n  stickyHeader?: boolean\n  /** Tightens the cells by one step, and everything the table renders with them. */\n  compact?: boolean\n  /**\n   * The height of the WHOLE component, toolbar and pagination included: a number is read\n   * as pixels, anything else as a CSS length. Left out, the table takes its parent's\n   * height whenever the parent has one.\n   */\n  height?: number | string\n  /** The heading icon of a column that can be sorted but currently is not. */\n  sortIcon?: IconSource\n  /**\n   * The icon of an ascending sort. It points DOWN by default, the spreadsheet\n   * convention: sorting A to Z reads downwards.\n   */\n  sortAscIcon?: IconSource\n  /** The icon of a descending sort. */\n  sortDescIcon?: IconSource\n  /** The choices offered for how many rows a page holds. */\n  perPageOptions?: number[]\n  /** What that choice is called. It falls back to the design system dictionary. */\n  perPageLabel?: string\n  /**\n   * How many rows there are in all on the server. It is what lets the pagination and the\n   * range be right when the table only ever holds one page.\n   */\n  total?: number\n  /** Shows which rows are being looked at — \"1–10 of 42\" — in the footer. */\n  showRange?: boolean\n  /** Rephrases that range. It falls back to the design system dictionary. */\n  rangeLabel?: (range: { start: number; end: number; total: number }) => string\n  /** Adds a checkbox to every row, and one in the heading to take the whole page. */\n  selectable?: boolean\n  /**\n   * What the heading checkbox is announced as. It falls back to the design system\n   * dictionary.\n   */\n  selectAllLabel?: string\n  /**\n   * How the selection is summed up in the footer. It says nothing at all when nothing is\n   * selected, and falls back to the design system dictionary.\n   */\n  selectionLabel?: (count: number) => string\n  /**\n   * What a row's checkbox is announced as. \"Select row\" tells a screen reader user\n   * nothing about WHICH row, so this is worth supplying with something from the row\n   * itself. It falls back to the design system dictionary.\n   */\n  selectRowLabel?: (row: Row, index: number) => string\n  /**\n   * Hands the searching, the sorting and the paging over to a server: the rows are shown\n   * exactly as they arrive, and every change of what is being asked for is reported so\n   * the server can answer it.\n   */\n  serverSide?: boolean\n}\n\nconst props = withDefaults(defineProps<DataTableProps<Row>>(), {\n  rowKey: undefined,\n  caption: undefined,\n  variant: 'flat',\n  responsive: 'scroll',\n  loading: false,\n  emptyText: undefined,\n  title: undefined,\n  searchable: false,\n  searchPlaceholder: undefined,\n  searchLabel: undefined,\n  searchDebounce: 250,\n  striped: false,\n  stickyHeader: false,\n  compact: false,\n  height: undefined,\n  sortIcon: () => swapVertIcon,\n  sortAscIcon: () => arrowDownwardIcon,\n  sortDescIcon: () => arrowUpwardIcon,\n  perPageOptions: undefined,\n  perPageLabel: undefined,\n  total: undefined,\n  showRange: false,\n  rangeLabel: undefined,\n  selectable: false,\n  selectAllLabel: undefined,\n  selectionLabel: undefined,\n  selectRowLabel: undefined,\n  serverSide: false,\n})\n\nconst m = useMessages()\nconst vectisLocale = useLocale()\nconst resolvedEmptyText = computed(() => props.emptyText ?? m.value.dataTable.empty)\nconst resolvedSearchPlaceholder = computed(\n  () => props.searchPlaceholder ?? m.value.dataTable.searchPlaceholder,\n)\nconst resolvedSearchLabel = computed(() => props.searchLabel ?? m.value.dataTable.searchLabel)\nconst resolvedPerPageLabel = computed(() => props.perPageLabel ?? m.value.dataTable.perPage)\nconst resolvedSelectAllLabel = computed(() => props.selectAllLabel ?? m.value.dataTable.selectAll)\n\n/** The current sort. It may be driven from outside, or simply left to the table. */\nconst sort = defineModel<DataTableSort | null>('sort', { default: null })\n/** The page being shown. */\nconst page = defineModel<number>('page', { default: 1 })\n/**\n * How many rows a page holds. Any value above zero turns the pagination on, so passing\n * one down without binding it is enough to enable it.\n */\nconst perPage = defineModel<number | undefined>('perPage', { default: undefined })\nconst selected = defineModel<DataTableRowId[]>('selected', { default: () => [] })\nconst search = defineModel<string>('search', { default: '' })\n\nconst emit = defineEmits<{\n  /**\n   * What the table is now being asked for, when a server is answering: the page, the\n   * page size, the sort or the search has changed — the last one after its delay.\n   *\n   * Nothing is emitted when the component appears: fetching the first page is the\n   * consumer's own business, and emitting would make every table fetch twice.\n   */\n  'update:params': [params: DataTableParams]\n}>()\n\ndefineSlots<{\n  /** What a cell of a given column shows: a slot named after that column's key. */\n  [name: `cell-${string}`]: (scope: {\n    row: Row\n    value: unknown\n    column: DataTableColumn\n  }) => unknown\n  /** What a column's heading shows: a slot named after that column's key. */\n  [name: `head-${string}`]: (scope: { column: DataTableColumn }) => unknown\n  /** The left side of the toolbar, replacing the `title` prop. */\n  header?: () => unknown\n}>()\n\n// `class` and `style` stay on the wrapper, where a consumer expects to place the\n// component; everything else — an id, the aria-* — goes to the `<table>` itself, the only\n// element they validly describe.\ndefineOptions({ inheritAttrs: false })\nconst { rootClass, rootStyle, forwardedAttrs } = useRootAttrs()\n\n// @devwarn\nif (isDev) {\n  if (props.selectable && !props.rowKey)\n    console.warn(\n      '[VDataTable] `selectable` without `rowKey` — index-based identities are corrupted by sorting, filtering and pagination.',\n    )\n}\n\nfunction rowIdentity(row: Row, index: number): DataTableRowId {\n  return props.rowKey ? String(row[props.rowKey]) : index\n}\n\n// From here on: filter, then sort, then cut into pages — three derivations, each reading\n// the one before it.\n//\n// The search only ever looks at the columns that are DISPLAYED. Searching fields the\n// reader cannot see would return rows for reasons nothing on screen explains.\n/*\n * The cells in their accent-insensitive form, remembered per row and column, and\n * re-checked against the raw value.\n *\n * Normalizing a string means decomposing it, stripping what it decomposed into, and\n * lowercasing it — and the filter below re-reads the entire table on every keystroke.\n * Ten thousand rows across five columns is fifty thousand of those per character typed.\n *\n * Reading the cell on every call, rather than deriving the whole table once, is what\n * keeps the filter reactive against a value edited in place. The memory is keyed by ROW,\n * so replacing the rows lets the old entries be collected with no invalidation to write\n * anywhere.\n */\nconst normalizedCells = new WeakMap<Row, Map<string, { raw: string; normalized: string }>>()\nfunction normalizedCell(row: Row, key: string): string {\n  const raw = String(row[key] ?? '')\n  let cells = normalizedCells.get(row)\n  if (!cells) {\n    cells = new Map()\n    normalizedCells.set(row, cells)\n  }\n  const hit = cells.get(key)\n  if (hit && hit.raw === raw) return hit.normalized\n  const normalized = normalizeText(raw)\n  cells.set(key, { raw, normalized })\n  return normalized\n}\n\nconst filteredRows = computed(() => {\n  if (props.serverSide || !props.searchable) return props.rows\n  const needle = normalizeText(search.value.trim())\n  if (!needle) return props.rows\n  return props.rows.filter((row) =>\n    props.columns.some((column) => normalizedCell(row, column.key).includes(needle)),\n  )\n})\n\n/*\n * The collator is built ONCE per locale rather than per comparison.\n *\n * `String.localeCompare` reuses an engine-cached collator only when both the locale and the\n * options are `undefined`; passing either — and this passes both, deliberately, since the\n * locale must stay explicit — takes the slow path and constructs an `Intl.Collator` on every\n * call. That is the cost class `utils/date.ts` already fights: construction runs one to two\n * orders of magnitude longer than use. It is not paid once, either: `search` feeds\n * `filteredRows`, which feeds this, so a sorted table re-sorts on every keystroke.\n *\n * The locale stays explicit for the reason it always was — an `undefined` locale resolves\n * differently in Node and in the browser, so the row order would diverge across hydration.\n */\nconst collator = computed(() => new Intl.Collator(vectisLocale.value, { numeric: true }))\n\nconst sortedRows = computed(() => {\n  const current = sort.value\n  if (!current || props.serverSide) return filteredRows.value\n  const factor = current.direction === 'asc' ? 1 : -1\n  const compare = collator.value.compare\n  return [...filteredRows.value].sort((a, b) => {\n    const av = a[current.key]\n    const bv = b[current.key]\n    if (typeof av === 'number' && typeof bv === 'number') return (av - bv) * factor\n    return compare(String(av ?? ''), String(bv ?? '')) * factor\n  })\n})\n\nconst paginated = computed(() => (perPage.value ?? 0) > 0)\nconst totalCount = computed(() =>\n  props.serverSide ? (props.total ?? props.rows.length) : filteredRows.value.length,\n)\nconst pageCount = computed(() =>\n  paginated.value ? Math.max(1, Math.ceil(totalCount.value / (perPage.value ?? 1))) : 1,\n)\n// The page actually shown is CLAMPED by derivation and the model is never rewritten: a\n// search that leaves fewer pages simply falls back to the last one, and typing a\n// character that would have emptied the table does not silently move the consumer's own\n// page number.\nconst currentPage = computed(() => clamp(page.value, 1, pageCount.value))\n\nconst displayedRows = computed(() => {\n  // With a server answering, the rows received ARE the current page: cutting them again\n  // would show a tenth of a page.\n  if (props.serverSide || !paginated.value) return sortedRows.value\n  const start = (currentPage.value - 1) * (perPage.value ?? 0)\n  return sortedRows.value.slice(start, start + (perPage.value ?? 0))\n})\n\nfunction toggleSort(key: string) {\n  const current = sort.value\n  if (!current || current.key !== key) sort.value = { key, direction: 'asc' }\n  else if (current.direction === 'asc') sort.value = { key, direction: 'desc' }\n  else sort.value = null\n}\n\n// @a11y — only the column actually sorted carries the attribute. Setting it on every\n// heading would have a screen reader announce \"not sorted\" on each one in turn, drowning\n// the single piece of information that matters: which column the order comes from.\nfunction ariaSort(column: DataTableColumn): 'ascending' | 'descending' | undefined {\n  if (sort.value?.key !== column.key) return undefined\n  return sort.value.direction === 'asc' ? 'ascending' : 'descending'\n}\n\n/**\n * Which icon a column's heading shows: a neutral one on any sortable column, and the\n * arrow of the current direction on the one being sorted by.\n *\n * It is deliberately named differently from the prop it falls back to: written the same,\n * the function would shadow the prop inside the template and the icons would never be\n * overridable.\n */\nfunction sortIconFor(column: DataTableColumn): IconSource {\n  if (sort.value?.key !== column.key) return props.sortIcon\n  return sort.value.direction === 'asc' ? props.sortAscIcon : props.sortDescIcon\n}\n\n// The two effects the search needs.\n//\n// A changed search invalidates where one was: page 4 of the old results has nothing to\n// do with page 4 of the new ones, so the reader goes back to the first. And when a server\n// answers, nothing native waits before asking it, so that has to be written.\n//\n// The waiting is delegated to `useTimer` — a delay of zero running at once, cancellation\n// when the component goes away — and the term that was actually committed is what the\n// parameters below report.\nconst committedSearch = ref('')\nconst searchTimer = useTimer()\n\nfunction commitSearch() {\n  committedSearch.value = search.value\n  page.value = 1\n}\n\nwatch(search, () => {\n  if (!props.serverSide) {\n    page.value = 1\n    return\n  }\n  searchTimer.start(commitSearch, props.searchDebounce)\n})\n\n// What the table is asking for, as one value.\nconst params = computed<DataTableParams>(() => ({\n  page: currentPage.value,\n  perPage: perPage.value ?? null,\n  sortKey: sort.value?.key ?? null,\n  sortDirection: sort.value?.direction ?? null,\n  search: committedSearch.value,\n}))\n\n// Committing a search and going back to the first page happen one after the other, but\n// both land in the same flush, so this runs ONCE on the final values — never two requests\n// for what the reader experienced as a single action.\nwatch(params, (value) => {\n  if (props.serverSide) emit('update:params', value)\n})\n\n// The selection. The heading checkbox covers the rows currently VISIBLE and not the whole\n// table: a box that silently selected forty thousand rows would be a trap.\nconst selectedSet = computed(() => new Set<DataTableRowId>(selected.value))\nconst visibleIds = computed(() => displayedRows.value.map((row, index) => rowIdentity(row, index)))\nconst allVisibleSelected = computed(\n  () => visibleIds.value.length > 0 && visibleIds.value.every((id) => selectedSet.value.has(id)),\n)\nconst masterIndeterminate = computed(\n  () => !allVisibleSelected.value && visibleIds.value.some((id) => selectedSet.value.has(id)),\n)\n\nfunction isSelected(row: Row, index: number): boolean {\n  return selectedSet.value.has(rowIdentity(row, index))\n}\n\nfunction toggleRow(row: Row, index: number) {\n  selected.value = toggleValue(selected.value, rowIdentity(row, index))\n}\n\n// It only ever touches the rows on screen, so what was selected on the other pages\n// survives moving between them.\nfunction toggleMaster() {\n  const ids = visibleIds.value\n  if (allVisibleSelected.value) {\n    const visible = new Set(ids)\n    selected.value = selected.value.filter((id) => !visible.has(id))\n  } else {\n    const current = selectedSet.value\n    selected.value = [...selected.value, ...ids.filter((id) => !current.has(id))]\n  }\n}\n\n// @a11y — without this every checkbox in the column would be announced identically, and\n// a screen reader user would have no way of knowing which row they were about to select.\nfunction rowSelectLabel(row: Row, index: number): string {\n  // The dictionary is given the position as a HUMAN would count it, from one, while the\n  // prop keeps the position as code counts it — changing that would break every consumer\n  // already using it.\n  return props.selectRowLabel?.(row, index) ?? m.value.dataTable.selectRow(index + 1)\n}\n\nfunction setPerPage(option: number) {\n  perPage.value = option\n  page.value = 1\n}\n\nconst colCount = computed(() => props.columns.length + (props.selectable ? 1 : 0))\n\n// @a11y\n/**\n * What the footer says about the selection.\n *\n * TRAP — it is rendered, EMPTY, as soon as rows can be selected at all. A region meant to\n * announce its own changes must already exist before the first change: inserted into the\n * page at the same moment as its text, it announces nothing, and the first row selected\n * would pass in silence.\n */\nconst selectionText = computed(() => {\n  const count = selected.value.length\n  if (props.selectionLabel) return props.selectionLabel(count)\n  if (count === 0) return ''\n  return m.value.dataTable.selection(count)\n})\n\nconst rangeText = computed(() => {\n  const per = perPage.value ?? 0\n  const total = totalCount.value\n  const start = total === 0 ? 0 : (currentPage.value - 1) * per + 1\n  const end = Math.min(currentPage.value * per, total)\n  return props.rangeLabel?.({ start, end, total }) ?? m.value.dataTable.range({ start, end, total })\n})\n\n// The height is applied to the WHOLE component and not as a ceiling on the scrolling\n// area. The component then takes exactly the height asked for and the scrolling area\n// absorbs whatever is left, so a page with three rows on it no longer makes the table\n// shrink around them.\n//\n// A soft ceiling remains available to the consumer through a maximum height of their own:\n// the component is a column whose scrolling area can be compressed.\nconst heightStyle = computed<StyleValue | undefined>(() =>\n  props.height !== undefined ? { blockSize: cssSize(props.height) } : undefined,\n)\n</script>\n\n<template>\n  <div\n    class=\"v-table-wrapper\"\n    :class=\"rootClass\"\n    :style=\"[heightStyle, rootStyle]\"\n    :data-variant=\"variant\"\n    :data-responsive=\"responsive\"\n    :data-striped=\"striped ? '' : undefined\"\n    :data-compact=\"compact ? '' : undefined\"\n    :data-sticky-header=\"stickyHeader ? '' : undefined\"\n    :data-selectable=\"selectable ? '' : undefined\"\n  >\n    <div v-if=\"title || $slots.header || searchable\" class=\"v-table-toolbar\">\n      <VTypography as=\"div\" variant=\"heading-4\" class=\"v-table-title\">\n        <slot name=\"header\">{{ title }}</slot>\n      </VTypography>\n      <VInput\n        v-if=\"searchable\"\n        v-model=\"search\"\n        class=\"v-table-search\"\n        type=\"search\"\n        size=\"sm\"\n        :compact=\"compact\"\n        :icon-start=\"searchIcon\"\n        clearable\n        :placeholder=\"resolvedSearchPlaceholder\"\n        :aria-label=\"resolvedSearchLabel\"\n      />\n    </div>\n\n    <!-- Only the table itself scrolls; the toolbar above and the footer below stay\n         where they are. -->\n    <div class=\"v-table-scroller\">\n      <table class=\"v-table\" v-bind=\"forwardedAttrs\">\n        <caption v-if=\"caption\" class=\"v-table-caption\">\n          {{\n            caption\n          }}\n        </caption>\n        <thead class=\"v-table-head\">\n          <tr>\n            <th v-if=\"selectable\" scope=\"col\" class=\"v-table-select\">\n              <VCheckbox\n                :model-value=\"allVisibleSelected\"\n                :indeterminate=\"masterIndeterminate\"\n                :aria-label=\"resolvedSelectAllLabel\"\n                @update:model-value=\"toggleMaster\"\n              />\n            </th>\n            <th\n              v-for=\"column in columns\"\n              :key=\"column.key\"\n              scope=\"col\"\n              :data-align=\"column.align\"\n              :aria-sort=\"ariaSort(column)\"\n            >\n              <button\n                v-if=\"column.sortable\"\n                type=\"button\"\n                class=\"v-table-sort\"\n                :data-direction=\"sort?.key === column.key ? sort.direction : undefined\"\n                @click=\"toggleSort(column.key)\"\n              >\n                <slot :name=\"`head-${column.key}`\" :column=\"column\">{{ column.label }}</slot>\n                <!-- Decorative, and deliberately so: given no label, an icon hides itself\n                     from screen readers. What the sort state is, is already carried by\n                     the heading itself. -->\n                <VIcon class=\"v-table-sort-icon\" v-bind=\"iconProps(sortIconFor(column))\" />\n              </button>\n              <template v-else>\n                <slot :name=\"`head-${column.key}`\" :column=\"column\">{{ column.label }}</slot>\n              </template>\n            </th>\n          </tr>\n        </thead>\n        <tbody>\n          <!-- The order matters: loading is checked BEFORE emptiness, so a table waiting\n               for its rows never claims there are none. -->\n          <tr v-if=\"loading\">\n            <td :colspan=\"colCount\" class=\"v-table-state\">\n              <VSpinner :label=\"m.dataTable.loading\" />\n            </td>\n          </tr>\n          <tr v-else-if=\"displayedRows.length === 0\">\n            <td :colspan=\"colCount\" class=\"v-table-state\">{{ resolvedEmptyText }}</td>\n          </tr>\n          <template v-else>\n            <tr\n              v-for=\"(row, index) in displayedRows\"\n              :key=\"rowIdentity(row, index)\"\n              :data-selected=\"selectable && isSelected(row, index) ? '' : undefined\"\n            >\n              <!-- TRAP — the selection is marked with a plain attribute and NOT with the\n                   ARIA selected state, which is invalid on the row of a table: it belongs\n                   to a grid. What tells assistive technology that a row is selected is\n                   its checkbox being checked. -->\n              <td v-if=\"selectable\" class=\"v-table-select\">\n                <VCheckbox\n                  :model-value=\"isSelected(row, index)\"\n                  :aria-label=\"rowSelectLabel(row, index)\"\n                  @update:model-value=\"toggleRow(row, index)\"\n                />\n              </td>\n              <td\n                v-for=\"column in columns\"\n                :key=\"column.key\"\n                :data-label=\"column.label\"\n                :data-align=\"column.align\"\n              >\n                <slot\n                  :name=\"`cell-${column.key}`\"\n                  :row=\"row\"\n                  :value=\"row[column.key]\"\n                  :column=\"column\"\n                >\n                  {{ row[column.key] }}\n                </slot>\n              </td>\n            </tr>\n          </template>\n        </tbody>\n      </table>\n    </div>\n\n    <!-- The footer has two zones: what is selected on the left, and on the right the page\n         size, the range and the pagination, in that order. -->\n    <div v-if=\"paginated || selectable\" class=\"v-table-footer\">\n      <span v-if=\"selectable\" class=\"v-table-selection\" aria-live=\"polite\">{{\n        selectionText\n      }}</span>\n      <div v-if=\"paginated\" class=\"v-table-footer-end\">\n        <div v-if=\"perPageOptions?.length\" class=\"v-table-per-page\">\n          <span class=\"v-table-per-page-label\" aria-hidden=\"true\">{{ resolvedPerPageLabel }}</span>\n          <!-- The panel is told to match its trigger, which here replaces the default\n               minimum width with something sensible: a menu of \"10\", \"25\", \"50\" has no\n               use for the width a menu of commands assumes, and it still cannot end up\n               narrower than the button opening it. -->\n          <VMenu size=\"sm\" :compact=\"compact\" placement=\"top-end\" match-trigger>\n            <template #trigger=\"{ triggerProps }\">\n              <VButton\n                variant=\"ghost\"\n                tone=\"neutral\"\n                size=\"sm\"\n                :compact=\"compact\"\n                v-bind=\"triggerProps\"\n                :aria-label=\"m.dataTable.perPageValue(resolvedPerPageLabel, perPage ?? 0)\"\n              >\n                {{ perPage }}\n                <VIcon :name=\"arrowDropDownIcon\" />\n              </VButton>\n            </template>\n            <VMenuItem\n              v-for=\"option in perPageOptions\"\n              :key=\"option\"\n              :label=\"String(option)\"\n              :selected=\"option === perPage\"\n              @select=\"setPerPage(option)\"\n            />\n          </VMenu>\n        </div>\n        <span v-if=\"showRange\" class=\"v-table-range\" aria-live=\"polite\">{{ rangeText }}</span>\n        <!-- Named after the table rather than with the generic pagination wording: a page\n             holding this table AND a pagination of its own would otherwise expose two\n             navigation landmarks with the same name, and a screen reader user could not\n             tell them apart. -->\n        <VPagination\n          v-model=\"page\"\n          :label=\"m.dataTable.pagination\"\n          :length=\"pageCount\"\n          size=\"sm\"\n          :compact=\"compact\"\n          align=\"end\"\n          variant=\"ghost\"\n          :total-visible=\"7\"\n        />\n      </div>\n    </div>\n  </div>\n</template>\n\n<style>\n@layer vectis.components {\n  .v-table-wrapper {\n    /* The density, expressed as the cells' padding and tightened by one step in the\n       compact form. It does not go through the shared control scale — there is no single\n       control height in a table — which is the same case VAccordion is in. */\n    --table-pad-block: var(--vectis-space-3);\n    --table-pad-inline: var(--vectis-space-3);\n    --table-head-pad-block: var(--vectis-space-2);\n\n    /* The gutter between the frame and what it holds: nothing when the table is\n       unframed, so the caption, the toolbar and the footer sit flush with the edge, and\n       the cells' own inline padding as soon as a frame appears. */\n    --table-frame-pad: 0px;\n    /* The colour a frozen heading is painted with. It follows the frame's own background:\n       any other value would show as a visible seam in the dark theme, where the two\n       surfaces differ. */\n    --table-surface: var(--vectis-color-surface);\n\n    container-type: inline-size;\n    font-family: var(--vectis-text-family);\n\n    /*\n     * A column of three: toolbar, scrolling area, footer. The component takes its\n     * parent's height and the scrolling area absorbs whatever is left, which is what\n     * stops a last page holding two rows from shrinking the whole table, and what keeps\n     * the footer at the bottom.\n     *\n     * When the parent imposes no height at all, a percentage of an undefined height\n     * simply resolves to automatic — so this costs nothing and needs no measurement.\n     *\n     * TRAP — there is deliberately no zero minimum here. Inside a flex column parent too\n     * short for it, that minimum is what keeps the table at its natural height instead of\n     * letting it be crushed to nothing.\n     */\n    display: flex;\n    flex-direction: column;\n    block-size: 100%;\n  }\n\n  .v-table-wrapper[data-compact] {\n    --table-pad-block: var(--vectis-space-2);\n    --table-pad-inline: var(--vectis-space-2);\n    --table-head-pad-block: var(--vectis-space-1);\n  }\n\n  /* The card. The unframed default has nothing to undo, since it declares no decoration\n     at all — whatever surrounds the table is what provides the surface then. */\n  .v-table-wrapper[data-variant='outlined'] {\n    --table-frame-pad: var(--table-pad-inline);\n    --table-surface: var(--vectis-color-surface-raised);\n\n    background: var(--table-surface);\n    border: 1px solid var(--vectis-color-border);\n    border-radius: var(--vectis-radius-surface);\n    /*\n     * The price of the rounded corners: the striped and selected row backgrounds, the\n     * opaque background of a frozen heading and the square corners of the scrolling area\n     * would all spill past them.\n     *\n     * TRAP — clipped and not hidden. Hiding the overflow would make this element a\n     * scrolling box of its own, and the frozen heading would then stick to IT rather than\n     * to the area that actually scrolls, which is to say it would not stick at all.\n     *\n     * It is confined to the framed form on purpose: unframed, the toolbar and the footer\n     * sit flush with the edge and the clip would crop their focus rings. The page-size\n     * menu is drawn above the page and is never affected either way.\n     */\n    overflow: clip;\n  }\n\n  /*\n   * The ONE part that scrolls, taking whatever room the toolbar and the footer leave.\n   *\n   * It grows from its CONTENT's height rather than from zero, which makes the whole thing\n   * inert as long as there is no free space to hand out — a table shorter than its\n   * container is left exactly as tall as it is.\n   *\n   * The zero minimum is load-bearing: a flex item refuses by default to shrink below its\n   * content, and without it the area would never compress, so the table would overflow\n   * instead of scrolling.\n   *\n   * It is deliberately not confined to one responsive mode: a table taller than its host\n   * must scroll in the stacked form too, or the clip of the framed variant would crop it\n   * and make the rows below unreachable.\n   */\n  .v-table-scroller {\n    flex: 1 1 auto;\n    min-block-size: 0;\n    overflow: auto;\n  }\n\n  .v-table-toolbar {\n    flex: none; /* stays at the top, outside whatever scrolls */\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    justify-content: space-between;\n    gap: var(--vectis-space-3);\n    padding-block-start: var(--table-frame-pad);\n    padding-block-end: var(--vectis-space-3);\n    padding-inline: var(--table-frame-pad);\n  }\n\n  /* The title is rendered by VTypography, and its colour is stated explicitly because the\n     toolbar may well sit inside a context whose text is dimmed.\n\n     TRAP — it is set through the colour VARIABLE that component reads, and not with a\n     plain colour declaration. That declaration would collide with VTypography's own at\n     equal specificity, and the winner would be decided by whichever sheet the consumer's\n     bundler put last. */\n  .v-table-title {\n    --typography-color: var(--vectis-color-text);\n  }\n\n  /* The search field is given a width of its own, overriding the full width VInput takes\n     by default. The selector is qualified by its context, which makes it one step more\n     specific than VInput's own rule and therefore independent of the order the two sheets\n     end up in. */\n  .v-table-toolbar .v-input {\n    inline-size: var(--vectis-control-size-table-search);\n    max-inline-size: 100%;\n  }\n\n  .v-table {\n    width: 100%;\n    border-collapse: collapse;\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text);\n  }\n\n  .v-table-caption {\n    padding-block-end: var(--vectis-space-3);\n    padding-inline: var(--table-frame-pad);\n    text-align: start;\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-table th {\n    padding: var(--table-head-pad-block) var(--table-pad-inline);\n    text-align: start;\n    font-size: var(--vectis-text-body-md-size);\n    /* The heavier weight distinguishes a heading from the data under it, which is\n       emphasis rather than a typographic role — hence a font token read directly. */\n    font-weight: var(--vectis-font-weight-semibold);\n    color: var(--vectis-color-text-muted);\n    border-block-end: 1px solid var(--vectis-color-border);\n  }\n\n  .v-table td {\n    padding: var(--table-pad-block) var(--table-pad-inline);\n    border-block-end: 1px solid var(--vectis-color-border);\n  }\n\n  .v-table tbody tr:last-child td {\n    border-block-end: none;\n  }\n\n  .v-table [data-align='end'] {\n    text-align: end;\n  }\n\n  .v-table [data-align='center'] {\n    text-align: center;\n  }\n\n  /* The checkbox column is reduced to the width of its content. A table lays its columns\n     out automatically, so asking for no width at all is what makes it take the least\n     possible. */\n  .v-table .v-table-select {\n    inline-size: 0;\n  }\n\n  .v-table-wrapper[data-striped] tbody tr:nth-child(even) {\n    background-color: var(--vectis-color-surface-sunken);\n  }\n\n  /* Placed after the striping on purpose: the specificity is the same, so it is the order\n     that makes a selected row keep its tint on both odd and even rows. */\n  .v-table-wrapper[data-selectable] tbody tr[data-selected] {\n    background-color: var(--vectis-color-accent-surface);\n  }\n\n  /* A frozen heading MUST be opaque: the rows scroll underneath it, and without a\n     background they would show through. Its colour is read from the variable holding the\n     table's real surface — a fixed value would leave a visible seam along the frame's\n     edge in the dark theme, where the two surfaces differ. */\n  .v-table-wrapper[data-sticky-header] th {\n    position: sticky;\n    inset-block-start: 0;\n    z-index: 1;\n    background-color: var(--table-surface);\n  }\n\n  .v-table-sort {\n    /* The icon context for the sort glyph. Without it the icon would fall back to one em\n       — the heading's own text size — and come out visibly smaller than every other icon\n       in the component. */\n    --vectis-icon-size: var(--vectis-icon-size-md);\n    --vectis-icon-opsz: 20;\n\n    display: inline-flex;\n    align-items: center;\n    gap: var(--vectis-space-1);\n    border: none;\n    background: transparent;\n    padding: 0;\n    color: inherit;\n    font: inherit;\n    cursor: pointer;\n    border-radius: var(--vectis-radius-xs);\n  }\n\n  .v-table-sort:hover {\n    color: var(--vectis-color-text);\n  }\n\n  .v-table-sort:focus-visible {\n    outline: var(--vectis-focus-ring-width) solid var(--vectis-focus-ring-color);\n    outline-offset: var(--vectis-focus-ring-offset);\n  }\n\n  /* The glyph stays faint on every column that merely COULD be sorted: it announces that\n     the heading can be clicked without competing for attention with the one column\n     actually carrying the order. */\n  .v-table-sort-icon {\n    opacity: 0.35;\n  }\n\n  .v-table-sort[data-direction] .v-table-sort-icon {\n    opacity: 1;\n  }\n\n  .v-table-state {\n    padding: var(--vectis-space-6);\n    text-align: center;\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-table-footer {\n    flex: none; /* stays at the bottom, outside whatever scrolls */\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    justify-content: flex-end;\n    gap: var(--vectis-space-4);\n    padding-block-start: var(--vectis-space-3);\n    padding-block-end: var(--table-frame-pad);\n    padding-inline: var(--table-frame-pad);\n  }\n\n  /*\n   * The right-hand zone is pushed to the edge by an automatic margin rather than by an\n   * alignment on the footer. The two zones are siblings in the same row, and the count on\n   * the left has to stay at the OPPOSITE edge: any alignment set on the footer would move\n   * both of them together.\n   *\n   * The margin also does the right thing when there is no count at all, the zone simply\n   * being pushed against the far edge on its own.\n   */\n  .v-table-footer-end {\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    justify-content: flex-end;\n    gap: var(--vectis-space-4);\n    margin-inline-start: auto;\n  }\n\n  .v-table-selection,\n  .v-table-range,\n  .v-table-per-page-label {\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-table-per-page {\n    display: flex;\n    align-items: center;\n    gap: var(--vectis-space-2);\n  }\n\n  /* The stacked form: once the COMPONENT is narrow, each row becomes a card carrying its\n     own headings. It is entirely CSS, and the threshold is written as a literal length —\n     these queries accept no variables.\n\n     The column headings are not removed but hidden the way visually hidden text is: they\n     still name each column for a screen reader, which reads the cells in the same order\n     either way. */\n  @container (max-width: 640px) {\n    .v-table-wrapper[data-responsive='stack'] .v-table-head {\n      position: absolute;\n      width: 1px;\n      height: 1px;\n      margin: -1px;\n      overflow: hidden;\n      clip-path: inset(50%);\n    }\n\n    .v-table-wrapper[data-responsive='stack'] tbody tr {\n      display: block;\n      padding-block: var(--vectis-space-2);\n      border-block-end: 1px solid var(--vectis-color-border);\n    }\n\n    .v-table-wrapper[data-responsive='stack'] tbody tr:last-child {\n      border-block-end: none;\n    }\n\n    .v-table-wrapper[data-responsive='stack'] td {\n      display: flex;\n      justify-content: space-between;\n      align-items: baseline;\n      gap: var(--vectis-space-4);\n      padding: var(--vectis-space-1) var(--vectis-space-2);\n      border: none;\n      text-align: end;\n    }\n\n    /* Each cell writes its own column's name before itself, taken from the attribute the\n       template put there. It takes the overline type role, without forcing capitals. */\n    .v-table-wrapper[data-responsive='stack'] td::before {\n      content: attr(data-label);\n      font-size: var(--vectis-text-overline-size);\n      font-weight: var(--vectis-text-overline-weight);\n      letter-spacing: var(--vectis-text-overline-tracking);\n      color: var(--vectis-color-text-muted);\n    }\n\n    /* The checkbox cell carries no column name — there is none — so it gets no heading\n       and opens the card on its own line. */\n    .v-table-wrapper[data-responsive='stack'] td.v-table-select {\n      justify-content: flex-start;\n    }\n\n    .v-table-wrapper[data-responsive='stack'] td.v-table-select::before {\n      content: none;\n    }\n\n    /* In a narrow component the search field drops under the title and takes the whole\n       width. This applies to both responsive forms, the toolbar never being part of what\n       scrolls. */\n    .v-table-search {\n      flex: 1 1 100%;\n    }\n  }\n}\n</style>\n"],"mappings":""}
+{"version":3,"file":"VDataTable.js","names":[],"sources":["../../../src/components/VDataTable/VDataTable.vue"],"sourcesContent":["<script setup lang=\"ts\" generic=\"Row extends Record<string, unknown>\">\n// @core\n/**\n * A table of data with everything usually built around one: a title, a search field, sortable\n * columns, a selection and pagination.\n *\n * A real `<table>` underneath, with a caption, proper column headers and `aria-sort` — which\n * is what lets a screen reader say \"row 3 of 40, column Name\" rather than read a grid of\n * unrelated text. The furniture is composed from the library's own components.\n *\n * The JS is almost all derivation — filter, then sort, then slice — plus two effects\n * explained where they sit.\n *\n * Narrow-space behaviour and height-filling are both entirely CSS: `stack` turns each row\n * into a card once the COMPONENT is narrow, measured by a container query rather than by\n * code, and the root is a flex column in which only the scroller stretches.\n */\n\nimport { computed, ref, watch } from 'vue'\nimport type { StyleValue } from 'vue'\n\nimport VButton from '../VButton/VButton.vue'\nimport VCheckbox from '../VCheckbox/VCheckbox.vue'\nimport VIcon from '../VIcon/VIcon.vue'\nimport { iconProps } from '../VIcon/iconProps'\nimport { arrow_downward as arrowDownwardIcon } from '../VIcon/icons/arrow_downward'\nimport { arrow_drop_down as arrowDropDownIcon } from '../VIcon/icons/arrow_drop_down'\nimport { arrow_upward as arrowUpwardIcon } from '../VIcon/icons/arrow_upward'\nimport { search as searchIcon } from '../VIcon/icons/search'\nimport { swap_vert as swapVertIcon } from '../VIcon/icons/swap_vert'\nimport type { IconSource } from '../VIcon/types'\nimport VInput from '../VInput/VInput.vue'\nimport VMenu from '../VMenu/VMenu.vue'\nimport VMenuItem from '../VMenu/VMenuItem.vue'\nimport VPagination from '../VPagination/VPagination.vue'\nimport VSpinner from '../VSpinner/VSpinner.vue'\nimport VTypography from '../VTypography/VTypography.vue'\n\nimport { toggleValue } from '../../utils/array'\nimport { cssSize } from '../../utils/css'\nimport { isDev } from '../../utils/env'\nimport { clamp } from '../../utils/number'\nimport { createNormalizedCache, normalizeText } from '../../utils/text'\n\nimport { useRootAttrs } from '../../composables/useRootAttrs'\n\nimport { useTimer } from '../../composables/useTimer'\nimport { useLocale, useMessages } from '../../i18n/state'\n\n/** One column of the table. */\nexport interface DataTableColumn {\n  /** Which field of a row it shows, and the name its slots are addressed by. */\n  key: string\n  /** Its heading. */\n  label: string\n  /** Lets the reader sort by this column. */\n  sortable?: boolean\n  /** How its content is aligned — numbers usually belong at the end. */\n  align?: 'start' | 'center' | 'end'\n}\n\n/** Which way a column is sorted: A to Z, or Z to A. */\nexport type DataTableSortDirection = 'asc' | 'desc'\n\n/** Which column the table is sorted by, and in which direction. */\nexport interface DataTableSort {\n  key: string\n  direction: DataTableSortDirection\n}\n\n/** How a row is identified: by the field named in `rowKey`, or failing that by its position. */\nexport type DataTableRowId = string | number\n\n/**\n * Everything the table is currently being asked for, reported whenever it changes so a\n * server can answer it. What is not set is `null` rather than left out, so the object keeps\n * the same keys once serialized into a request.\n */\nexport interface DataTableParams {\n  page: number\n  perPage: number | null\n  sortKey: string | null\n  sortDirection: DataTableSortDirection | null\n  search: string\n}\n\n/** How much decoration the table carries. */\nexport type DataTableVariant = 'flat' | 'outlined'\n\n/** What a narrow container does to the rows. */\nexport type DataTableResponsive = 'scroll' | 'stack'\n\n// TRAP — this interface is exported rather than kept local, and it is generic rather than\n// referring to the component's own type parameter.\n//\n// A component typed over its rows inlines the whole signature of its props into the\n// declarations it emits, so a name that is not exported cannot be written there and the\n// build of the type declarations fails. And being lifted out of the component's scope, it\n// has no access to that parameter and must take one of its own.\nexport interface DataTableProps<Row extends Record<string, unknown>> {\n  /** The columns to show, in order. */\n  columns: DataTableColumn[]\n  /** The rows to show. */\n  rows: Row[]\n  /**\n   * Which field identifies a row. Without it a row is identified by its position, which\n   * is enough for display but not for a selection: it must be given as soon as rows can\n   * be selected, or the selection follows the positions rather than the rows.\n   */\n  rowKey?: string\n  /**\n   * A sentence describing what the table holds. It is announced before the table itself,\n   * and is what tells a screen reader user whether it is worth exploring.\n   */\n  caption?: string\n  /**\n   * How the table is framed: nothing at all, or a card with a raised background, a border\n   * and rounded corners.\n   */\n  variant?: DataTableVariant\n  /**\n   * What happens when the component is too narrow: the table scrolls sideways, or each\n   * row becomes a card with its column headings repeated inside it.\n   */\n  responsive?: DataTableResponsive\n  /** Shows that the rows are being loaded. */\n  loading?: boolean\n  /**\n   * What is written beside the spinner while the rows are loading. It falls back to the design\n   * system dictionary.\n   */\n  loadingText?: string\n  /** What is said when there is no row to show. It falls back to the design system dictionary. */\n  emptyText?: string\n  /**\n   * A title above the table, on the left of its toolbar.\n   *\n   * Note that this prop shadows the HTML attribute of the same name on the component\n   * itself, an accepted trade-off — a tooltip over a whole table would be of little\n   * use.\n   */\n  title?: string\n  /** Adds a search field to the toolbar. */\n  searchable?: boolean\n  /** What that field says while empty. It falls back to the design system dictionary. */\n  searchPlaceholder?: string\n  /**\n   * What screen readers announce for the search field. It falls back to the design\n   * system dictionary.\n   */\n  searchLabel?: string\n  /**\n   * When a server does the searching, how long to wait after a keystroke before asking\n   * it, in milliseconds. Zero asks at once.\n   */\n  searchDebounce?: number\n  /** Tints every other row, which helps the eye follow a long line across the table. */\n  striped?: boolean\n  /**\n   * Keeps the column headings in place while the rows scroll under them. It needs a\n   * bounded scrolling area to work: either the `height` prop, or a parent with a height\n   * of its own.\n   */\n  stickyHeader?: boolean\n  /** Tightens the cells by one step, and everything the table renders with them. */\n  compact?: boolean\n  /**\n   * The height of the WHOLE component, toolbar and pagination included: a number is read\n   * as pixels, anything else as a CSS length. Left out, the table takes its parent's\n   * height whenever the parent has one.\n   */\n  height?: number | string\n  /** The heading icon of a column that can be sorted but currently is not. */\n  sortIcon?: IconSource\n  /**\n   * The icon of an ascending sort. It points DOWN by default, the spreadsheet\n   * convention: sorting A to Z reads downwards.\n   */\n  sortAscIcon?: IconSource\n  /** The icon of a descending sort. */\n  sortDescIcon?: IconSource\n  /** The choices offered for how many rows a page holds. */\n  perPageOptions?: number[]\n  /** What that choice is called. It falls back to the design system dictionary. */\n  perPageText?: string\n  /**\n   * How many rows there are in all on the server. It is what lets the pagination and the\n   * range be right when the table only ever holds one page.\n   */\n  total?: number\n  /** Shows which rows are being looked at — \"1–10 of 42\" — in the footer. */\n  showRange?: boolean\n  /** Rephrases that range. It falls back to the design system dictionary. */\n  rangeText?: (range: { start: number; end: number; total: number }) => string\n  /** Adds a checkbox to every row, and one in the heading to take the whole page. */\n  selectable?: boolean\n  /**\n   * What the heading checkbox is announced as. It falls back to the design system\n   * dictionary.\n   */\n  selectAllLabel?: string\n  /**\n   * How the selection is summed up in the footer. It says nothing at all when nothing is\n   * selected, and falls back to the design system dictionary.\n   */\n  selectionText?: (count: number) => string\n  /**\n   * What a row's checkbox is announced as. \"Select row\" tells a screen reader user\n   * nothing about WHICH row, so this is worth supplying with something from the row\n   * itself. It falls back to the design system dictionary.\n   */\n  selectRowLabel?: (row: Row, index: number) => string\n  /**\n   * Hands the searching, the sorting and the paging over to a server: the rows are shown\n   * exactly as they arrive, and every change of what is being asked for is reported so\n   * the server can answer it.\n   */\n  serverSide?: boolean\n}\n\nconst props = withDefaults(defineProps<DataTableProps<Row>>(), {\n  rowKey: undefined,\n  caption: undefined,\n  variant: 'flat',\n  responsive: 'scroll',\n  loading: false,\n  loadingText: undefined,\n  emptyText: undefined,\n  title: undefined,\n  searchable: false,\n  searchPlaceholder: undefined,\n  searchLabel: undefined,\n  searchDebounce: 250,\n  striped: false,\n  stickyHeader: false,\n  compact: false,\n  height: undefined,\n  sortIcon: () => swapVertIcon,\n  sortAscIcon: () => arrowDownwardIcon,\n  sortDescIcon: () => arrowUpwardIcon,\n  perPageOptions: undefined,\n  perPageText: undefined,\n  total: undefined,\n  showRange: false,\n  rangeText: undefined,\n  selectable: false,\n  selectAllLabel: undefined,\n  selectionText: undefined,\n  selectRowLabel: undefined,\n  serverSide: false,\n})\n\nconst m = useMessages()\nconst vectisLocale = useLocale()\nconst resolvedEmptyText = computed(() => props.emptyText ?? m.value.dataTable.empty)\nconst resolvedLoadingText = computed(() => props.loadingText ?? m.value.dataTable.loading)\nconst resolvedSearchPlaceholder = computed(\n  () => props.searchPlaceholder ?? m.value.dataTable.searchPlaceholder,\n)\nconst resolvedSearchLabel = computed(() => props.searchLabel ?? m.value.dataTable.searchLabel)\nconst resolvedPerPageText = computed(() => props.perPageText ?? m.value.dataTable.perPage)\nconst resolvedSelectAllLabel = computed(() => props.selectAllLabel ?? m.value.dataTable.selectAll)\n\n/**\n * Which column the rows are sorted by, and in which direction. Nothing is sorted to begin\n * with. It may be driven from outside or simply left to the table, which sets it as headers\n * are clicked; changing it does not send the reader back to the first page.\n */\nconst sort = defineModel<DataTableSort | null>('sort', { default: null })\n/**\n * The page being shown, counted from 1. It starts on the first, and searching or changing\n * the page size sends it back there. It is clamped by derivation rather than written to, so\n * a page beyond the last simply displays the last.\n */\nconst page = defineModel<number>('page', { default: 1 })\n/**\n * How many rows a page holds. Any value above zero turns the pagination on, so passing\n * one down without binding it is enough to enable it.\n */\nconst perPage = defineModel<number | undefined>('perPage', { default: undefined })\n/*\n * \"No value\" is spelled two ways on purpose. `sort` is `null` because the TABLE writes that\n * state itself, a third click on a heading clearing the order, and a model the component\n * writes needs a value a consumer can store and compare. `perPage` is `undefined` because\n * nothing here ever clears it: it is simply a model that was not given. `DataTableParams`\n * reports both as `null`, being a request body rather than a model.\n */\n/**\n * The selected rows, as the identities `rowKey` gives them — never the row objects\n * themselves. Nothing is selected to begin with, and a selection SURVIVES a change of page:\n * the header checkbox covers the visible page alone, which is why it can be indeterminate.\n */\nconst selected = defineModel<DataTableRowId[]>('selected', { default: () => [] })\n/**\n * What is typed in the search field, empty to begin with. Only the declared columns are\n * searched, accent- and case-insensitively; in `serverSide` mode nothing is filtered here\n * and the term is reported through `update:params` instead.\n */\nconst search = defineModel<string>('search', { default: '' })\n\nconst emit = defineEmits<{\n  /**\n   * What the table is now being asked for, when a server is answering: the page, the\n   * page size, the sort or the search has changed — the last one after its delay.\n   *\n   * Nothing is emitted when the component appears: fetching the first page is the\n   * consumer's own business, and emitting would make every table fetch twice.\n   */\n  'update:params': [params: DataTableParams]\n}>()\n\ndefineSlots<{\n  /** What a cell of a given column shows: a slot named after that column's key. */\n  [name: `cell-${string}`]: (scope: {\n    row: Row\n    value: unknown\n    column: DataTableColumn\n  }) => unknown\n  /** What a column's heading shows: a slot named after that column's key. */\n  [name: `head-${string}`]: (scope: { column: DataTableColumn }) => unknown\n  /** The left side of the toolbar, replacing the `title` prop. */\n  title?(): unknown\n  /** What the table shows while its rows are loading, replacing the spinner and its text. */\n  loading?(): unknown\n  /**\n   * What the table shows when there is no row to show, replacing `emptyText`. It receives the\n   * search that produced the empty result, empty when nothing was searched for.\n   */\n  empty?(scope: { search: string }): unknown\n}>()\n\n// `class` and `style` stay on the wrapper, where a consumer expects to place the\n// component; everything else — an id, the aria-* — goes to the `<table>` itself, the only\n// element they validly describe.\ndefineOptions({ inheritAttrs: false })\nconst { rootClass, rootStyle, forwardedAttrs } = useRootAttrs()\n\n// @devwarn\nif (isDev) {\n  if (props.selectable && !props.rowKey)\n    console.warn(\n      '[VDataTable] `selectable` without `rowKey` — index-based identities are corrupted by sorting, filtering and pagination.',\n    )\n}\n\n/*\n * TRAP — a key that is already a string or a number is returned AS IT IS. The selection\n * holds these identities and is looked up with a Set, which tells the number 7 from the\n * string \"7\": turned into text, a table keyed by numeric ids never found a selected row\n * again, so every checkbox stayed unticked.\n */\nfunction rowIdentity(row: Row, index: number): DataTableRowId {\n  if (!props.rowKey) return index\n  const key = row[props.rowKey]\n  return typeof key === 'string' || typeof key === 'number' ? key : String(key)\n}\n\n// From here on: filter, then sort, then cut into pages — three derivations, each reading\n// the one before it.\n//\n// The search only ever looks at the columns that are DISPLAYED. Searching fields the\n// reader cannot see would return rows for reasons nothing on screen explains.\n/*\n * The cells in accent-insensitive form, memoized per row and column and re-checked against\n * the raw value, so a value edited in place is noticed. The filter below re-reads the whole\n * table on every keystroke: ten thousand rows across five columns is fifty thousand\n * normalizations per character typed without it.\n */\nconst normalizedOf = createNormalizedCache<Row>()\nconst normalizedCell = (row: Row, key: string) => normalizedOf(row, String(row[key] ?? ''), key)\n\nconst filteredRows = computed(() => {\n  if (props.serverSide || !props.searchable) return props.rows\n  const needle = normalizeText(search.value.trim())\n  if (!needle) return props.rows\n  return props.rows.filter((row) =>\n    props.columns.some((column) => normalizedCell(row, column.key).includes(needle)),\n  )\n})\n\n/*\n * The collator is built ONCE per locale rather than per comparison.\n *\n * `String.localeCompare` reuses an engine-cached collator only when the locale AND the\n * options are both `undefined`; passing either takes the slow path and constructs an\n * `Intl.Collator` per call — the cost class `utils/date.ts` fights, construction running one\n * to two orders of magnitude longer than use. Nor is it paid once: `search` feeds\n * `filteredRows` feeds this, so a sorted table re-sorts on every keystroke.\n *\n * The locale must nonetheless stay EXPLICIT: an `undefined` one resolves differently in Node\n * and in the browser, so the row order would diverge across hydration.\n */\nconst collator = computed(() => new Intl.Collator(vectisLocale.value, { numeric: true }))\n\nconst sortedRows = computed(() => {\n  const current = sort.value\n  if (!current || props.serverSide) return filteredRows.value\n  const factor = current.direction === 'asc' ? 1 : -1\n  const compare = collator.value.compare\n  return [...filteredRows.value].sort((a, b) => {\n    const av = a[current.key]\n    const bv = b[current.key]\n    if (typeof av === 'number' && typeof bv === 'number') return (av - bv) * factor\n    return compare(String(av ?? ''), String(bv ?? '')) * factor\n  })\n})\n\nconst paginated = computed(() => (perPage.value ?? 0) > 0)\nconst totalCount = computed(() =>\n  props.serverSide ? (props.total ?? props.rows.length) : filteredRows.value.length,\n)\nconst pageCount = computed(() =>\n  paginated.value ? Math.max(1, Math.ceil(totalCount.value / (perPage.value ?? 1))) : 1,\n)\n// The page actually shown is CLAMPED by derivation and the model is never rewritten: a\n// search that leaves fewer pages simply falls back to the last one, and typing a\n// character that would have emptied the table does not silently move the consumer's own\n// page number.\nconst currentPage = computed(() => clamp(page.value, 1, pageCount.value))\n\nconst displayedRows = computed(() => {\n  // With a server answering, the rows received ARE the current page: cutting them again\n  // would show a tenth of a page.\n  if (props.serverSide || !paginated.value) return sortedRows.value\n  const start = (currentPage.value - 1) * (perPage.value ?? 0)\n  return sortedRows.value.slice(start, start + (perPage.value ?? 0))\n})\n\nfunction toggleSort(key: string) {\n  const current = sort.value\n  if (!current || current.key !== key) sort.value = { key, direction: 'asc' }\n  else if (current.direction === 'asc') sort.value = { key, direction: 'desc' }\n  else sort.value = null\n}\n\n// @a11y — only the column actually sorted carries the attribute. Setting it on every\n// heading would have a screen reader announce \"not sorted\" on each one in turn, drowning\n// the single piece of information that matters: which column the order comes from.\nfunction ariaSort(column: DataTableColumn): 'ascending' | 'descending' | undefined {\n  if (sort.value?.key !== column.key) return undefined\n  return sort.value.direction === 'asc' ? 'ascending' : 'descending'\n}\n\n/**\n * Which icon a column's heading shows: a neutral one on any sortable column, and the\n * arrow of the current direction on the one being sorted by.\n *\n * It is deliberately named differently from the prop it falls back to: written the same,\n * the function would shadow the prop inside the template and the icons would never be\n * overridable.\n */\nfunction sortIconFor(column: DataTableColumn): IconSource {\n  if (sort.value?.key !== column.key) return props.sortIcon\n  return sort.value.direction === 'asc' ? props.sortAscIcon : props.sortDescIcon\n}\n\n// The two effects the search needs.\n//\n// A changed search invalidates where one was: page 4 of the old results has nothing to\n// do with page 4 of the new ones, so the reader goes back to the first. And when a server\n// answers, nothing native waits before asking it, so that has to be written.\n//\n// The waiting is delegated to `useTimer` — a delay of zero running at once, cancellation\n// when the component goes away — and the term that was actually committed is what the\n// parameters below report.\n// It starts from the search the table was GIVEN: starting empty, a table mounted with a\n// search already in place reported an empty one in every request until the reader typed.\nconst committedSearch = ref(search.value)\nconst searchTimer = useTimer()\n\nfunction commitSearch() {\n  committedSearch.value = search.value\n  page.value = 1\n}\n\nwatch(search, () => {\n  if (!props.serverSide) {\n    page.value = 1\n    return\n  }\n  searchTimer.start(commitSearch, props.searchDebounce)\n})\n\n// The search the rows on show answer to: the committed one when a server does the searching.\nconst emptySearch = computed(() => (props.serverSide ? committedSearch.value : search.value))\n\n// What the table is asking for, as one value.\nconst params = computed<DataTableParams>(() => ({\n  page: currentPage.value,\n  perPage: perPage.value ?? null,\n  sortKey: sort.value?.key ?? null,\n  sortDirection: sort.value?.direction ?? null,\n  search: committedSearch.value,\n}))\n\n// Committing a search and going back to the first page happen one after the other, but\n// both land in the same flush, so this runs ONCE on the final values — never two requests\n// for what the reader experienced as a single action.\nwatch(params, (value) => {\n  if (props.serverSide) emit('update:params', value)\n})\n\n// The selection. The heading checkbox covers the rows currently VISIBLE and not the whole\n// table: a box that silently selected forty thousand rows would be a trap.\nconst selectedSet = computed(() => new Set<DataTableRowId>(selected.value))\nconst visibleIds = computed(() => displayedRows.value.map((row, index) => rowIdentity(row, index)))\nconst allVisibleSelected = computed(\n  () => visibleIds.value.length > 0 && visibleIds.value.every((id) => selectedSet.value.has(id)),\n)\nconst masterIndeterminate = computed(\n  () => !allVisibleSelected.value && visibleIds.value.some((id) => selectedSet.value.has(id)),\n)\n\n/*\n * A row is asked about by the identity `visibleIds` already holds for it: the template reads\n * `visibleIds[index]` for the key, the tint and the checkbox alike, rather than deriving it\n * again three or four times per row per render.\n */\nconst isSelected = (id: DataTableRowId) => selectedSet.value.has(id)\n\nfunction toggleRow(id: DataTableRowId) {\n  selected.value = toggleValue(selected.value, id)\n}\n\n// It only ever touches the rows on screen, so what was selected on the other pages\n// survives moving between them.\nfunction toggleMaster() {\n  const ids = visibleIds.value\n  if (allVisibleSelected.value) {\n    const visible = new Set(ids)\n    selected.value = selected.value.filter((id) => !visible.has(id))\n  } else {\n    const current = selectedSet.value\n    selected.value = [...selected.value, ...ids.filter((id) => !current.has(id))]\n  }\n}\n\n// @a11y — without this every checkbox in the column would be announced identically, and\n// a screen reader user would have no way of knowing which row they were about to select.\nfunction rowSelectLabel(row: Row, index: number): string {\n  // The dictionary is given the position as a HUMAN would count it, from one, while the\n  // prop keeps the position as code counts it — changing that would break every consumer\n  // already using it.\n  return props.selectRowLabel?.(row, index) ?? m.value.dataTable.selectRow(index + 1)\n}\n\nfunction setPerPage(option: number) {\n  perPage.value = option\n  page.value = 1\n}\n\nconst colCount = computed(() => props.columns.length + (props.selectable ? 1 : 0))\n\n// @a11y\n/**\n * What the footer says about the selection.\n *\n * TRAP — it is rendered, EMPTY, as soon as rows can be selected at all. A region meant to\n * announce its own changes must already exist before the first change: inserted into the\n * page at the same moment as its text, it announces nothing, and the first row selected\n * would pass in silence.\n */\nconst selectionSummary = computed(() => {\n  const count = selected.value.length\n  if (props.selectionText) return props.selectionText(count)\n  if (count === 0) return ''\n  return m.value.dataTable.selection(count)\n})\n\nconst rangeSummary = computed(() => {\n  const per = perPage.value ?? 0\n  const total = totalCount.value\n  const start = total === 0 ? 0 : (currentPage.value - 1) * per + 1\n  const end = Math.min(currentPage.value * per, total)\n  return props.rangeText?.({ start, end, total }) ?? m.value.dataTable.range({ start, end, total })\n})\n\n// The height is applied to the WHOLE component and not as a ceiling on the scrolling\n// area. The component then takes exactly the height asked for and the scrolling area\n// absorbs whatever is left, so a page with three rows on it no longer makes the table\n// shrink around them.\n//\n// A soft ceiling remains available to the consumer through a maximum height of their own:\n// the component is a column whose scrolling area can be compressed.\nconst heightStyle = computed<StyleValue | undefined>(() =>\n  props.height !== undefined ? { blockSize: cssSize(props.height) } : undefined,\n)\n</script>\n\n<template>\n  <div\n    class=\"v-data-table\"\n    :class=\"rootClass\"\n    :style=\"[heightStyle, rootStyle]\"\n    :data-variant=\"variant\"\n    :data-responsive=\"responsive\"\n    :data-striped=\"striped ? '' : undefined\"\n    :data-compact=\"compact ? '' : undefined\"\n    :data-sticky-header=\"stickyHeader ? '' : undefined\"\n    :data-selectable=\"selectable ? '' : undefined\"\n  >\n    <div v-if=\"title || $slots.title || searchable\" class=\"v-data-table-toolbar\">\n      <VTypography as=\"div\" variant=\"heading-4\" class=\"v-data-table-title\">\n        <slot name=\"title\">{{ title }}</slot>\n      </VTypography>\n      <VInput\n        v-if=\"searchable\"\n        v-model=\"search\"\n        class=\"v-data-table-search\"\n        type=\"search\"\n        size=\"sm\"\n        :compact=\"compact\"\n        :icon-start=\"searchIcon\"\n        clearable\n        :placeholder=\"resolvedSearchPlaceholder\"\n        :aria-label=\"resolvedSearchLabel\"\n      />\n    </div>\n\n    <!-- Only the table itself scrolls; the toolbar above and the footer below stay\n         where they are. -->\n    <div class=\"v-data-table-scroller\">\n      <table class=\"v-data-table-table\" v-bind=\"forwardedAttrs\">\n        <caption v-if=\"caption\" class=\"v-data-table-caption\">\n          {{\n            caption\n          }}\n        </caption>\n        <thead class=\"v-data-table-head\">\n          <tr>\n            <th v-if=\"selectable\" scope=\"col\" class=\"v-data-table-select\">\n              <VCheckbox\n                :model-value=\"allVisibleSelected\"\n                :indeterminate=\"masterIndeterminate\"\n                :aria-label=\"resolvedSelectAllLabel\"\n                @update:model-value=\"toggleMaster\"\n              />\n            </th>\n            <th\n              v-for=\"column in columns\"\n              :key=\"column.key\"\n              scope=\"col\"\n              :data-align=\"column.align\"\n              :aria-sort=\"ariaSort(column)\"\n            >\n              <button\n                v-if=\"column.sortable\"\n                type=\"button\"\n                class=\"v-data-table-sort\"\n                :data-direction=\"sort?.key === column.key ? sort.direction : undefined\"\n                @click=\"toggleSort(column.key)\"\n              >\n                <slot :name=\"`head-${column.key}`\" :column=\"column\">{{ column.label }}</slot>\n                <!-- Decorative, and deliberately so: given no label, an icon hides itself\n                     from screen readers. What the sort state is, is already carried by\n                     the heading itself. -->\n                <VIcon class=\"v-data-table-sort-icon\" v-bind=\"iconProps(sortIconFor(column))\" />\n              </button>\n              <template v-else>\n                <slot :name=\"`head-${column.key}`\" :column=\"column\">{{ column.label }}</slot>\n              </template>\n            </th>\n          </tr>\n        </thead>\n        <tbody>\n          <!-- The order matters: loading is checked BEFORE emptiness, so a table waiting\n               for its rows never claims there are none. -->\n          <tr v-if=\"loading\">\n            <td :colspan=\"colCount\" class=\"v-data-table-state\">\n              <slot name=\"loading\">\n                <!-- The spinner carries the text for a screen reader, so the visible copy is\n                     hidden from it: read twice, the cell would say it is loading twice. -->\n                <span class=\"v-data-table-state-loading\">\n                  <VSpinner :label=\"resolvedLoadingText\" />\n                  <span aria-hidden=\"true\">{{ resolvedLoadingText }}</span>\n                </span>\n              </slot>\n            </td>\n          </tr>\n          <tr v-else-if=\"displayedRows.length === 0\">\n            <td :colspan=\"colCount\" class=\"v-data-table-state\">\n              <slot name=\"empty\" :search=\"emptySearch\">{{ resolvedEmptyText }}</slot>\n            </td>\n          </tr>\n          <template v-else>\n            <tr\n              v-for=\"(row, index) in displayedRows\"\n              :key=\"visibleIds[index]\"\n              :data-selected=\"selectable && isSelected(visibleIds[index]!) ? '' : undefined\"\n            >\n              <!-- TRAP — the selection is marked with a plain attribute and NOT with the\n                   ARIA selected state, which is invalid on the row of a table: it belongs\n                   to a grid. What tells assistive technology that a row is selected is\n                   its checkbox being checked. -->\n              <td v-if=\"selectable\" class=\"v-data-table-select\">\n                <VCheckbox\n                  :model-value=\"isSelected(visibleIds[index]!)\"\n                  :aria-label=\"rowSelectLabel(row, index)\"\n                  @update:model-value=\"toggleRow(visibleIds[index]!)\"\n                />\n              </td>\n              <td\n                v-for=\"column in columns\"\n                :key=\"column.key\"\n                :data-label=\"column.label\"\n                :data-align=\"column.align\"\n              >\n                <slot\n                  :name=\"`cell-${column.key}`\"\n                  :row=\"row\"\n                  :value=\"row[column.key]\"\n                  :column=\"column\"\n                >\n                  {{ row[column.key] }}\n                </slot>\n              </td>\n            </tr>\n          </template>\n        </tbody>\n      </table>\n    </div>\n\n    <!-- The footer has two zones: what is selected on the left, and on the right the page\n         size, the range and the pagination, in that order. -->\n    <div v-if=\"paginated || selectable\" class=\"v-data-table-footer\">\n      <span v-if=\"selectable\" class=\"v-data-table-selection\" aria-live=\"polite\">{{\n        selectionSummary\n      }}</span>\n      <div v-if=\"paginated\" class=\"v-data-table-footer-end\">\n        <div v-if=\"perPageOptions?.length\" class=\"v-data-table-per-page\">\n          <span class=\"v-data-table-per-page-label\" aria-hidden=\"true\">{{\n            resolvedPerPageText\n          }}</span>\n          <!-- The panel is told to match its trigger, which here replaces the default\n               minimum width with something sensible: a menu of \"10\", \"25\", \"50\" has no\n               use for the width a menu of commands assumes, and it still cannot end up\n               narrower than the button opening it. -->\n          <VMenu size=\"sm\" :compact=\"compact\" placement=\"top-end\" match-trigger>\n            <template #trigger=\"{ triggerProps }\">\n              <VButton\n                variant=\"ghost\"\n                tone=\"neutral\"\n                size=\"sm\"\n                :compact=\"compact\"\n                v-bind=\"triggerProps\"\n                :aria-label=\"m.dataTable.perPageValue(resolvedPerPageText, perPage ?? 0)\"\n              >\n                {{ perPage }}\n                <VIcon :name=\"arrowDropDownIcon\" />\n              </VButton>\n            </template>\n            <VMenuItem\n              v-for=\"option in perPageOptions\"\n              :key=\"option\"\n              :label=\"String(option)\"\n              :selected=\"option === perPage\"\n              @select=\"setPerPage(option)\"\n            />\n          </VMenu>\n        </div>\n        <span v-if=\"showRange\" class=\"v-data-table-range\" aria-live=\"polite\">{{\n          rangeSummary\n        }}</span>\n        <!-- Named after the table rather than with the generic pagination wording: a page\n             holding this table AND a pagination of its own would otherwise expose two\n             navigation landmarks with the same name, and a screen reader user could not\n             tell them apart. -->\n        <VPagination\n          v-model=\"page\"\n          :label=\"m.dataTable.pagination\"\n          :length=\"pageCount\"\n          size=\"sm\"\n          :compact=\"compact\"\n          align=\"end\"\n          :total-visible=\"7\"\n        />\n      </div>\n    </div>\n  </div>\n</template>\n\n<style>\n@layer vectis.components {\n  .v-data-table {\n    /* The density, expressed as the cells' padding and tightened by one step in the\n       compact form. It does not go through the shared control scale — there is no single\n       control height in a table — which is the same case VAccordion is in. */\n    --data-table-pad-block: var(--vectis-space-3);\n    --data-table-pad-inline: var(--vectis-space-3);\n    --data-table-head-pad-block: var(--vectis-space-2);\n\n    /* The gutter between the frame and what it holds: nothing when the table is\n       unframed, so the caption, the toolbar and the footer sit flush with the edge, and\n       the cells' own inline padding as soon as a frame appears. */\n    --data-table-frame-pad: 0px;\n\n    container-type: inline-size;\n    font-family: var(--vectis-text-family);\n\n    /*\n     * A column of three: toolbar, scroller, footer. The root takes its parent's height and\n     * the scroller absorbs what is left, which stops a last page of two rows shrinking the\n     * whole table and keeps the footer at the bottom. With no height on the parent, a\n     * percentage of `auto` resolves to `auto`, so this costs nothing and measures nothing.\n     *\n     * TRAP — deliberately NO `min-block-size: 0` here. Inside a flex column parent too short\n     * for it, the automatic minimum is what keeps the table at its natural height instead of\n     * letting it be crushed to nothing.\n     */\n    display: flex;\n    flex-direction: column;\n    block-size: 100%;\n  }\n\n  .v-data-table[data-compact] {\n    --data-table-pad-block: var(--vectis-space-2);\n    --data-table-pad-inline: var(--vectis-space-2);\n    --data-table-head-pad-block: var(--vectis-space-1);\n  }\n\n  /* The card. The unframed default has nothing to undo, since it declares no decoration\n     at all — whatever surrounds the table is what provides the surface then. */\n  .v-data-table[data-variant='outlined'] {\n    --data-table-frame-pad: var(--data-table-pad-inline);\n\n    background: var(--vectis-color-surface-raised);\n    border: 1px solid var(--vectis-color-border);\n    border-radius: var(--vectis-radius-surface);\n    /*\n     * The price of the rounded corners: striped and selected row backgrounds, the sticky\n     * heading's opaque background and the scroller's square corners would all spill past.\n     *\n     * TRAP — `clip` and not `hidden`. Hiding the overflow would make this element a scroll\n     * container of its own, and the sticky heading would then anchor to IT rather than to\n     * the area that actually scrolls — which is to say it would not stick at all.\n     *\n     * Confined to the framed form on purpose: unframed, the toolbar and footer sit flush\n     * with the edge and the clip would crop their focus rings.\n     */\n    overflow: clip;\n  }\n\n  /*\n   * The ONE part that scrolls, taking whatever the toolbar and footer leave. The `auto`\n   * basis grows it from its CONTENT, so the whole arrangement is inert while there is no\n   * free space: a table shorter than its container stays exactly as tall as it is.\n   *\n   * `min-block-size: 0` is load-bearing — a flex item refuses by default to shrink below its\n   * content, so without it the area never compresses and the table overflows instead of\n   * scrolling.\n   *\n   * Deliberately NOT confined to `data-responsive='scroll'`: a table taller than its host\n   * must scroll in `stack` too, or `outlined`'s clip crops it and the rows below become\n   * unreachable.\n   */\n  .v-data-table-scroller {\n    flex: 1 1 auto;\n    min-block-size: 0;\n    overflow: auto;\n  }\n\n  .v-data-table-toolbar {\n    flex: none; /* stays at the top, outside whatever scrolls */\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    justify-content: space-between;\n    gap: var(--vectis-space-3);\n    padding-block-start: var(--data-table-frame-pad);\n    padding-block-end: var(--vectis-space-3);\n    padding-inline: var(--data-table-frame-pad);\n  }\n\n  /* The title is rendered by VTypography, and its colour is stated explicitly because the\n     toolbar may well sit inside a context whose text is dimmed.\n\n     TRAP — it is set through the colour VARIABLE that component reads, and not with a\n     plain colour declaration. That declaration would collide with VTypography's own at\n     equal specificity, and the winner would be decided by whichever sheet the consumer's\n     bundler put last. */\n  .v-data-table-title {\n    --typography-color: var(--vectis-color-text);\n  }\n\n  /* The search field is given a width of its own, overriding the full width VInput takes\n     by default. The selector is qualified by its context, which makes it one step more\n     specific than VInput's own rule and therefore independent of the order the two sheets\n     end up in. */\n  .v-data-table-toolbar .v-input {\n    inline-size: var(--vectis-control-size-table-search);\n    max-inline-size: 100%;\n  }\n\n  .v-data-table-table {\n    width: 100%;\n    border-collapse: collapse;\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text);\n  }\n\n  .v-data-table-caption {\n    padding-block-end: var(--vectis-space-3);\n    padding-inline: var(--data-table-frame-pad);\n    text-align: start;\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-data-table-table th {\n    padding: var(--data-table-head-pad-block) var(--data-table-pad-inline);\n    text-align: start;\n    font-size: var(--vectis-text-body-md-size);\n    /* The heavier weight distinguishes a heading from the data under it, which is\n       emphasis rather than a typographic role — hence a font token read directly. */\n    font-weight: var(--vectis-font-weight-semibold);\n    color: var(--vectis-color-text-muted);\n    /* The heading row gets a tint of its own so it reads apart from the data. `muted` and\n       not `sunken`: the striped rows already take `sunken`, and a heading painted the same\n       would read as one more stripe. Opaque in both themes, which is also what a frozen\n       heading needs, the rows scrolling underneath it. */\n    background-color: var(--vectis-color-surface-muted);\n    border-block-end: 1px solid var(--vectis-color-border);\n  }\n\n  .v-data-table-table td {\n    padding: var(--data-table-pad-block) var(--data-table-pad-inline);\n    border-block-end: 1px solid var(--vectis-color-border);\n  }\n\n  .v-data-table-table tbody tr:last-child td {\n    border-block-end: none;\n  }\n\n  .v-data-table-table [data-align='end'] {\n    text-align: end;\n  }\n\n  .v-data-table-table [data-align='center'] {\n    text-align: center;\n  }\n\n  /* The checkbox column is reduced to the width of its content. A table lays its columns\n     out automatically, so asking for no width at all is what makes it take the least\n     possible. */\n  .v-data-table-table .v-data-table-select {\n    inline-size: 0;\n  }\n\n  .v-data-table[data-striped] tbody tr:nth-child(even) {\n    background-color: var(--vectis-color-surface-sunken);\n  }\n\n  /* Placed after the striping on purpose: the specificity is the same, so it is the order\n     that makes a selected row keep its tint on both odd and even rows. */\n  .v-data-table[data-selectable] tbody tr[data-selected] {\n    background-color: var(--vectis-color-accent-surface);\n  }\n\n  /* TRAP — a frozen heading relies on the opaque background every `th` already carries: the\n     rows scroll underneath it, and a consumer restyling that background with a translucent\n     colour will see them through. */\n  .v-data-table[data-sticky-header] th {\n    position: sticky;\n    inset-block-start: 0;\n    z-index: 1;\n  }\n\n  .v-data-table-sort {\n    /* The icon context for the sort glyph. Without it the icon would fall back to one em\n       — the heading's own text size — and come out visibly smaller than every other icon\n       in the component. */\n    --vectis-icon-size: var(--vectis-icon-size-md);\n    --vectis-icon-opsz: 20;\n\n    display: inline-flex;\n    align-items: center;\n    gap: var(--vectis-space-1);\n    border: none;\n    background: transparent;\n    padding: 0;\n    color: inherit;\n    font: inherit;\n    cursor: pointer;\n    /* Seen only on the focus ring: the control radius capped at half a line, VBreadcrumb's\n       link recipe, since a heading that wraps would otherwise round to half its height. */\n    border-radius: min(var(--vectis-radius-interactive), 0.5lh);\n  }\n\n  .v-data-table-sort:hover {\n    color: var(--vectis-color-text);\n  }\n\n  .v-data-table-sort:focus-visible {\n    outline: var(--vectis-focus-ring-width) solid var(--vectis-focus-ring-color);\n    outline-offset: var(--vectis-focus-ring-offset);\n  }\n\n  /* The glyph stays faint on every column that merely COULD be sorted: it announces that\n     the heading can be clicked without competing for attention with the one column\n     actually carrying the order. */\n  .v-data-table-sort-icon {\n    opacity: 0.35;\n  }\n\n  .v-data-table-sort[data-direction] .v-data-table-sort-icon {\n    opacity: 1;\n  }\n\n  .v-data-table-state {\n    padding: var(--vectis-space-6);\n    text-align: center;\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-data-table-state-loading {\n    display: inline-flex;\n    align-items: center;\n    gap: var(--vectis-space-2);\n  }\n\n  .v-data-table-footer {\n    flex: none; /* stays at the bottom, outside whatever scrolls */\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    justify-content: flex-end;\n    gap: var(--vectis-space-4);\n    padding-block-start: var(--vectis-space-3);\n    padding-block-end: var(--data-table-frame-pad);\n    padding-inline: var(--data-table-frame-pad);\n  }\n\n  /*\n   * The right-hand zone is pushed to the edge by an automatic margin rather than by an\n   * alignment on the footer. The two zones are siblings in the same row, and the count on\n   * the left has to stay at the OPPOSITE edge: any alignment set on the footer would move\n   * both of them together.\n   *\n   * The margin also does the right thing when there is no count at all, the zone simply\n   * being pushed against the far edge on its own.\n   */\n  .v-data-table-footer-end {\n    display: flex;\n    flex-wrap: wrap;\n    align-items: center;\n    justify-content: flex-end;\n    gap: var(--vectis-space-4);\n    margin-inline-start: auto;\n  }\n\n  .v-data-table-selection,\n  .v-data-table-range,\n  .v-data-table-per-page-label {\n    font-size: var(--vectis-text-body-md-size);\n    color: var(--vectis-color-text-muted);\n  }\n\n  .v-data-table-per-page {\n    display: flex;\n    align-items: center;\n    gap: var(--vectis-space-2);\n  }\n\n  /* The stacked form: once the COMPONENT is narrow, each row becomes a card carrying its\n     own headings. It is entirely CSS, and the threshold is written as a literal length —\n     these queries accept no variables.\n\n     The column headings are not removed but hidden the way visually hidden text is: they\n     still name each column for a screen reader, which reads the cells in the same order\n     either way. */\n  @container (max-width: 640px) {\n    .v-data-table[data-responsive='stack'] .v-data-table-head {\n      position: absolute;\n      width: 1px;\n      height: 1px;\n      margin: -1px;\n      overflow: hidden;\n      clip-path: inset(50%);\n    }\n\n    .v-data-table[data-responsive='stack'] tbody tr {\n      display: block;\n      padding-block: var(--vectis-space-2);\n      border-block-end: 1px solid var(--vectis-color-border);\n    }\n\n    .v-data-table[data-responsive='stack'] tbody tr:last-child {\n      border-block-end: none;\n    }\n\n    .v-data-table[data-responsive='stack'] td {\n      display: flex;\n      justify-content: space-between;\n      align-items: baseline;\n      gap: var(--vectis-space-4);\n      padding: var(--vectis-space-1) var(--vectis-space-2);\n      border: none;\n      text-align: end;\n    }\n\n    /* Each cell writes its own column's name before itself, taken from the attribute the\n       template put there. It takes the overline type role, without forcing capitals. */\n    .v-data-table[data-responsive='stack'] td::before {\n      content: attr(data-label);\n      font-size: var(--vectis-text-overline-size);\n      font-weight: var(--vectis-text-overline-weight);\n      letter-spacing: var(--vectis-text-overline-tracking);\n      color: var(--vectis-color-text-muted);\n    }\n\n    /* The checkbox cell carries no column name — there is none — so it gets no heading\n       and opens the card on its own line. */\n    .v-data-table[data-responsive='stack'] td.v-data-table-select {\n      justify-content: flex-start;\n    }\n\n    .v-data-table[data-responsive='stack'] td.v-data-table-select::before {\n      content: none;\n    }\n\n    /* In a narrow component the search field drops under the title and takes the whole\n       width. This applies to both responsive forms, the toolbar never being part of what\n       scrolls. */\n    .v-data-table-search {\n      flex: 1 1 100%;\n    }\n  }\n}\n</style>\n"],"mappings":""}