@vobs/table 1.1.0 → 1.2.0

package/dist/persistence.cjs

@@ -0,0 +1,86 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// packages/table/src/persistence.ts
+function createColumnSettingsPersistence(storage, key) {
+  const normalizedKey = key.trim();
+  if (!normalizedKey) throw new Error("VOBS_TABLE001: column settings key \u4E0D\u80FD\u4E3A\u7A7A");
+  return {
+    load() {
+      return storage.get(normalizedKey);
+    },
+    save(settings) {
+      storage.set(normalizedKey, settings);
+    },
+    reset() {
+      storage.remove(normalizedKey);
+    }
+  };
+}
+__name(createColumnSettingsPersistence, "createColumnSettingsPersistence");
+function createLocalColumnSettingsPersistence(key, storage) {
+  const normalizedKey = key.trim();
+  if (!normalizedKey) throw new Error("VOBS_TABLE001: column settings key \u4E0D\u80FD\u4E3A\u7A7A");
+  const memory = /* @__PURE__ */ new Map();
+  let backend = storage ?? resolveLocalStorage();
+  return {
+    load() {
+      const raw = read();
+      if (!raw) return void 0;
+      try {
+        const value = JSON.parse(raw);
+        return isColumnSettings(value) ? value : void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    save(settings) {
+      const raw = JSON.stringify(settings);
+      memory.set(normalizedKey, raw);
+      try {
+        backend?.setItem(normalizedKey, raw);
+      } catch {
+        backend = void 0;
+      }
+    },
+    reset() {
+      memory.delete(normalizedKey);
+      try {
+        backend?.removeItem(normalizedKey);
+      } catch {
+        backend = void 0;
+      }
+    }
+  };
+  function read() {
+    try {
+      return backend?.getItem(normalizedKey) ?? memory.get(normalizedKey) ?? null;
+    } catch {
+      backend = void 0;
+      return memory.get(normalizedKey) ?? null;
+    }
+  }
+}
+__name(createLocalColumnSettingsPersistence, "createLocalColumnSettingsPersistence");
+function resolveLocalStorage() {
+  if (typeof window === "undefined") return void 0;
+  try {
+    return window.localStorage;
+  } catch {
+    return void 0;
+  }
+}
+__name(resolveLocalStorage, "resolveLocalStorage");
+function isColumnSettings(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return Array.isArray(candidate.visibleColumnIds) && candidate.visibleColumnIds.every((id) => typeof id === "string") && Array.isArray(candidate.columnOrder) && candidate.columnOrder.every((id) => typeof id === "string") && Boolean(candidate.columnWidths) && typeof candidate.columnWidths === "object" && !Array.isArray(candidate.columnWidths);
+}
+__name(isColumnSettings, "isColumnSettings");
+
+exports.createColumnSettingsPersistence = createColumnSettingsPersistence;
+exports.createLocalColumnSettingsPersistence = createLocalColumnSettingsPersistence;
+//# sourceMappingURL=persistence.cjs.map
+//# sourceMappingURL=persistence.cjs.map

package/dist/persistence.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/persistence.ts"],"names":[],"mappings":"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","file":"persistence.cjs","sourcesContent":["import type {\n  DataTableColumnSettings,\n  DataTableColumnSettingsPersistence,\n  DataTableColumnSettingsStorage\n} from './types'\n\nexport function createColumnSettingsPersistence(\n  storage: DataTableColumnSettingsStorage,\n  key: string\n): DataTableColumnSettingsPersistence {\n  const normalizedKey = key.trim()\n  if (!normalizedKey) throw new Error('VOBS_TABLE001: column settings key 不能为空')\n\n  return {\n    load(): DataTableColumnSettings | null | undefined {\n      return storage.get<DataTableColumnSettings>(normalizedKey)\n    },\n    save(settings: DataTableColumnSettings): void {\n      storage.set(normalizedKey, settings)\n    },\n    reset(): void {\n      storage.remove(normalizedKey)\n    }\n  }\n}\n\nexport function createLocalColumnSettingsPersistence(\n  key: string,\n  storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>\n): DataTableColumnSettingsPersistence {\n  const normalizedKey = key.trim()\n  if (!normalizedKey) throw new Error('VOBS_TABLE001: column settings key 不能为空')\n  const memory = new Map<string, string>()\n  let backend = storage ?? resolveLocalStorage()\n\n  return {\n    load(): DataTableColumnSettings | undefined {\n      const raw = read()\n      if (!raw) return undefined\n      try {\n        const value: unknown = JSON.parse(raw)\n        return isColumnSettings(value) ? value : undefined\n      } catch {\n        return undefined\n      }\n    },\n    save(settings: DataTableColumnSettings): void {\n      const raw = JSON.stringify(settings)\n      memory.set(normalizedKey, raw)\n      try {\n        backend?.setItem(normalizedKey, raw)\n      } catch {\n        backend = undefined\n      }\n    },\n    reset(): void {\n      memory.delete(normalizedKey)\n      try {\n        backend?.removeItem(normalizedKey)\n      } catch {\n        backend = undefined\n      }\n    }\n  }\n\n  function read(): string | null {\n    try {\n      return backend?.getItem(normalizedKey) ?? memory.get(normalizedKey) ?? null\n    } catch {\n      backend = undefined\n      return memory.get(normalizedKey) ?? null\n    }\n  }\n}\n\nfunction resolveLocalStorage(): Pick<Storage, 'getItem' | 'setItem' | 'removeItem'> | undefined {\n  if (typeof window === 'undefined') return undefined\n  try {\n    return window.localStorage\n  } catch {\n    return undefined\n  }\n}\n\nfunction isColumnSettings(value: unknown): value is DataTableColumnSettings {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as {\n    visibleColumnIds?: unknown\n    columnOrder?: unknown\n    columnWidths?: unknown\n  }\n  return Array.isArray(candidate.visibleColumnIds)\n    && candidate.visibleColumnIds.every(id => typeof id === 'string')\n    && Array.isArray(candidate.columnOrder)\n    && candidate.columnOrder.every(id => typeof id === 'string')\n    && Boolean(candidate.columnWidths)\n    && typeof candidate.columnWidths === 'object'\n    && !Array.isArray(candidate.columnWidths)\n}\n"]}

package/dist/persistence.d.cts

@@ -0,0 +1,8 @@
+import { DataTableColumnSettingsStorage, DataTableColumnSettingsPersistence } from './types.cjs';
+import '@vobs/reactivity';
+import '@vobs/vobs';
+
+declare function createColumnSettingsPersistence(storage: DataTableColumnSettingsStorage, key: string): DataTableColumnSettingsPersistence;
+declare function createLocalColumnSettingsPersistence(key: string, storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>): DataTableColumnSettingsPersistence;
+
+export { createColumnSettingsPersistence, createLocalColumnSettingsPersistence };

package/dist/persistence.d.ts

@@ -0,0 +1,8 @@
+import { DataTableColumnSettingsStorage, DataTableColumnSettingsPersistence } from './types.js';
+import '@vobs/reactivity';
+import '@vobs/vobs';
+
+declare function createColumnSettingsPersistence(storage: DataTableColumnSettingsStorage, key: string): DataTableColumnSettingsPersistence;
+declare function createLocalColumnSettingsPersistence(key: string, storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>): DataTableColumnSettingsPersistence;
+
+export { createColumnSettingsPersistence, createLocalColumnSettingsPersistence };

package/dist/persistence.js

@@ -0,0 +1,83 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// packages/table/src/persistence.ts
+function createColumnSettingsPersistence(storage, key) {
+  const normalizedKey = key.trim();
+  if (!normalizedKey) throw new Error("VOBS_TABLE001: column settings key \u4E0D\u80FD\u4E3A\u7A7A");
+  return {
+    load() {
+      return storage.get(normalizedKey);
+    },
+    save(settings) {
+      storage.set(normalizedKey, settings);
+    },
+    reset() {
+      storage.remove(normalizedKey);
+    }
+  };
+}
+__name(createColumnSettingsPersistence, "createColumnSettingsPersistence");
+function createLocalColumnSettingsPersistence(key, storage) {
+  const normalizedKey = key.trim();
+  if (!normalizedKey) throw new Error("VOBS_TABLE001: column settings key \u4E0D\u80FD\u4E3A\u7A7A");
+  const memory = /* @__PURE__ */ new Map();
+  let backend = storage ?? resolveLocalStorage();
+  return {
+    load() {
+      const raw = read();
+      if (!raw) return void 0;
+      try {
+        const value = JSON.parse(raw);
+        return isColumnSettings(value) ? value : void 0;
+      } catch {
+        return void 0;
+      }
+    },
+    save(settings) {
+      const raw = JSON.stringify(settings);
+      memory.set(normalizedKey, raw);
+      try {
+        backend?.setItem(normalizedKey, raw);
+      } catch {
+        backend = void 0;
+      }
+    },
+    reset() {
+      memory.delete(normalizedKey);
+      try {
+        backend?.removeItem(normalizedKey);
+      } catch {
+        backend = void 0;
+      }
+    }
+  };
+  function read() {
+    try {
+      return backend?.getItem(normalizedKey) ?? memory.get(normalizedKey) ?? null;
+    } catch {
+      backend = void 0;
+      return memory.get(normalizedKey) ?? null;
+    }
+  }
+}
+__name(createLocalColumnSettingsPersistence, "createLocalColumnSettingsPersistence");
+function resolveLocalStorage() {
+  if (typeof window === "undefined") return void 0;
+  try {
+    return window.localStorage;
+  } catch {
+    return void 0;
+  }
+}
+__name(resolveLocalStorage, "resolveLocalStorage");
+function isColumnSettings(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  return Array.isArray(candidate.visibleColumnIds) && candidate.visibleColumnIds.every((id) => typeof id === "string") && Array.isArray(candidate.columnOrder) && candidate.columnOrder.every((id) => typeof id === "string") && Boolean(candidate.columnWidths) && typeof candidate.columnWidths === "object" && !Array.isArray(candidate.columnWidths);
+}
+__name(isColumnSettings, "isColumnSettings");
+
+export { createColumnSettingsPersistence, createLocalColumnSettingsPersistence };
+//# sourceMappingURL=persistence.js.map
+//# sourceMappingURL=persistence.js.map

package/dist/persistence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/persistence.ts"],"names":[],"mappings":"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","file":"persistence.js","sourcesContent":["import type {\n  DataTableColumnSettings,\n  DataTableColumnSettingsPersistence,\n  DataTableColumnSettingsStorage\n} from './types'\n\nexport function createColumnSettingsPersistence(\n  storage: DataTableColumnSettingsStorage,\n  key: string\n): DataTableColumnSettingsPersistence {\n  const normalizedKey = key.trim()\n  if (!normalizedKey) throw new Error('VOBS_TABLE001: column settings key 不能为空')\n\n  return {\n    load(): DataTableColumnSettings | null | undefined {\n      return storage.get<DataTableColumnSettings>(normalizedKey)\n    },\n    save(settings: DataTableColumnSettings): void {\n      storage.set(normalizedKey, settings)\n    },\n    reset(): void {\n      storage.remove(normalizedKey)\n    }\n  }\n}\n\nexport function createLocalColumnSettingsPersistence(\n  key: string,\n  storage?: Pick<Storage, 'getItem' | 'setItem' | 'removeItem'>\n): DataTableColumnSettingsPersistence {\n  const normalizedKey = key.trim()\n  if (!normalizedKey) throw new Error('VOBS_TABLE001: column settings key 不能为空')\n  const memory = new Map<string, string>()\n  let backend = storage ?? resolveLocalStorage()\n\n  return {\n    load(): DataTableColumnSettings | undefined {\n      const raw = read()\n      if (!raw) return undefined\n      try {\n        const value: unknown = JSON.parse(raw)\n        return isColumnSettings(value) ? value : undefined\n      } catch {\n        return undefined\n      }\n    },\n    save(settings: DataTableColumnSettings): void {\n      const raw = JSON.stringify(settings)\n      memory.set(normalizedKey, raw)\n      try {\n        backend?.setItem(normalizedKey, raw)\n      } catch {\n        backend = undefined\n      }\n    },\n    reset(): void {\n      memory.delete(normalizedKey)\n      try {\n        backend?.removeItem(normalizedKey)\n      } catch {\n        backend = undefined\n      }\n    }\n  }\n\n  function read(): string | null {\n    try {\n      return backend?.getItem(normalizedKey) ?? memory.get(normalizedKey) ?? null\n    } catch {\n      backend = undefined\n      return memory.get(normalizedKey) ?? null\n    }\n  }\n}\n\nfunction resolveLocalStorage(): Pick<Storage, 'getItem' | 'setItem' | 'removeItem'> | undefined {\n  if (typeof window === 'undefined') return undefined\n  try {\n    return window.localStorage\n  } catch {\n    return undefined\n  }\n}\n\nfunction isColumnSettings(value: unknown): value is DataTableColumnSettings {\n  if (!value || typeof value !== 'object') return false\n  const candidate = value as {\n    visibleColumnIds?: unknown\n    columnOrder?: unknown\n    columnWidths?: unknown\n  }\n  return Array.isArray(candidate.visibleColumnIds)\n    && candidate.visibleColumnIds.every(id => typeof id === 'string')\n    && Array.isArray(candidate.columnOrder)\n    && candidate.columnOrder.every(id => typeof id === 'string')\n    && Boolean(candidate.columnWidths)\n    && typeof candidate.columnWidths === 'object'\n    && !Array.isArray(candidate.columnWidths)\n}\n"]}

package/dist/styles/styles.css

@@ -0,0 +1 @@
+@import './table.css';

package/dist/styles/table.css

@@ -0,0 +1,209 @@
+.vobs-data-table {
+  background: var(--vobs-table-surface, var(--bg-base-secondary, #fff));
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: var(--vobs-table-radius, 4px);
+  color: var(--vobs-table-text, var(--text-default, #1f2328));
+  overflow: hidden;
+}
+
+.vobs-data-table__toolbar,
+.vobs-data-table__footer {
+  padding: var(--vobs-table-space, 12px);
+  border-color: var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+}
+
+.vobs-data-table__toolbar { border-bottom: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de)); }
+.vobs-data-table__footer { border-top: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de)); }
+.vobs-data-table__viewport { width: 100%; overflow-x: auto; }
+.vobs-data-table__table { width: 100%; border-collapse: collapse; table-layout: fixed; }
+.vobs-data-table th,
+.vobs-data-table td {
+  padding: var(--vobs-table-cell-padding, 10px 12px);
+  border-bottom: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  text-align: start;
+  vertical-align: middle;
+}
+.vobs-data-table th { color: var(--vobs-table-muted, var(--text-tertiary, #57606a)); font-size: 0.85em; font-weight: 600; }
+.vobs-data-table--sticky-header thead th {
+  position: sticky;
+  top: var(--vobs-table-sticky-top, 0px);
+  z-index: 2;
+  background: var(--vobs-table-header-surface, var(--vobs-table-surface, var(--bg-base-secondary, #fff)));
+  box-shadow: 0 1px 0 var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+}
+.vobs-data-table tbody tr:last-child td { border-bottom: 0; }
+.vobs-data-table [data-align="center"] { text-align: center; }
+.vobs-data-table [data-align="end"] { text-align: end; font-variant-numeric: tabular-nums; }
+.vobs-data-table tr[data-clickable="true"] { cursor: pointer; }
+.vobs-data-table tr[data-clickable="true"]:hover { background: var(--vobs-table-row-hover, var(--bg-overlay-l2, rgba(0, 0, 0, .04))); }
+.vobs-data-table__sort,
+.vobs-data-table__page-button {
+  border: 0;
+  background: transparent;
+  color: inherit;
+  cursor: pointer;
+  font: inherit;
+}
+.vobs-data-table__sort { display: inline-flex; align-items: center; gap: 6px; padding: 0; }
+.vobs-data-table__sort:hover,
+.vobs-data-table__sort:focus-visible { color: var(--vobs-table-sort-active, var(--text-brand, #32F08C)); }
+.vobs-data-table__sort-icon {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-width: 1em;
+  color: var(--vobs-table-muted, var(--text-tertiary, #57606a));
+}
+.vobs-data-table th[data-sort-direction] .vobs-data-table__sort-icon {
+  color: var(--vobs-table-sort-active, var(--text-brand, #32F08C));
+}
+.vobs-data-table__state { padding: 32px 12px; color: var(--vobs-table-muted, var(--text-tertiary, #57606a)); text-align: center; }
+.vobs-data-table__spacer { padding: 0; border: 0; }
+.vobs-data-table__footer-content,
+.vobs-data-table__pagination { display: flex; align-items: center; gap: 8px; }
+.vobs-data-table__footer-content { justify-content: space-between; flex-wrap: wrap; }
+.vobs-data-table__summary {
+  color: var(--vobs-table-muted, var(--text-tertiary, #57606a));
+  font-size: 0.85em;
+  font-weight: 600;
+  white-space: nowrap;
+}
+.vobs-data-table__pagination { flex-wrap: wrap; justify-content: flex-end; }
+.vobs-data-table__pagination-pages { display: inline-flex; align-items: center; gap: 4px; }
+.vobs-data-table__page-button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: 2px;
+  min-width: 24px;
+  height: 24px;
+  padding: 0 6px;
+}
+.vobs-data-table__page-button.is-active {
+  background: var(--vobs-table-active, var(--bg-overlay-l2, rgba(0, 0, 0, .06)));
+  border-color: var(--vobs-table-active-border, var(--border-neutral-l2, #afb8c1));
+}
+.vobs-data-table__page-button:disabled { cursor: not-allowed; opacity: .45; }
+.vobs-data-table__page-ellipsis { min-width: 24px; text-align: center; color: var(--vobs-table-muted, var(--text-tertiary, #57606a)); }
+.vobs-data-table__pagination-jump { display: inline-flex; align-items: center; gap: 6px; }
+.vobs-data-table__page-size { display: inline-flex; align-items: center; gap: 6px; margin-left: 4px; color: var(--vobs-table-muted, var(--text-tertiary, #57606a)); font-size: 0.85em; font-weight: 600; white-space: nowrap; }
+.vobs-data-table__page-size-select {
+  box-sizing: border-box;
+  height: 24px;
+  padding: 0 20px 0 6px;
+  color: inherit;
+  background: var(--bg-overlay-l1, transparent);
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: 2px;
+  font: inherit;
+  font-weight: 400;
+}
+.vobs-data-table__jump-label { display: inline-flex; align-items: center; gap: 6px; color: var(--vobs-table-muted, var(--text-tertiary, #57606a)); font-size: 0.85em; font-weight: 600; }
+.vobs-data-table__jump-input {
+  box-sizing: border-box;
+  width: 52px;
+  height: 24px;
+  padding: 0 5px;
+  color: inherit;
+  background: transparent;
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: 2px;
+  font: inherit;
+  font-weight: 400;
+  text-align: center;
+}
+.vobs-data-table__jump-submit { min-width: 32px; }
+
+.vobs-column-settings { position: relative; display: inline-block; }
+.vobs-column-settings__trigger { cursor: pointer; list-style: none; }
+.vobs-column-settings__trigger::-webkit-details-marker { display: none; }
+.vobs-column-settings__panel {
+  position: absolute;
+  z-index: 10;
+  right: 0;
+  min-width: 160px;
+  margin-top: 4px;
+  padding: 8px;
+  background: var(--vobs-table-surface, var(--bg-base-secondary, #fff));
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: var(--vobs-table-radius, 4px);
+  box-shadow: 0 8px 24px rgba(0, 0, 0, .16);
+}
+.vobs-column-settings__option { display: flex; align-items: center; gap: 8px; padding: 4px; white-space: nowrap; }
+.vobs-column-settings__reset {
+  display: block;
+  width: 100%;
+  margin-bottom: 8px;
+  padding: 4px 6px;
+  color: var(--vobs-table-muted, var(--text-tertiary, #57606a));
+  background: transparent;
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: 2px;
+  cursor: pointer;
+  font: inherit;
+  text-align: start;
+}
+.vobs-column-settings__reset:hover,
+.vobs-column-settings__move:hover:not(:disabled) {
+  color: var(--vobs-table-text, var(--text-default, #1f2328));
+  background: var(--vobs-table-row-hover, var(--bg-overlay-l2, rgba(0, 0, 0, .04)));
+}
+.vobs-column-settings__visibility,
+.vobs-column-settings__layout {
+  display: grid;
+  gap: 2px;
+}
+.vobs-column-settings__layout {
+  margin-top: 8px;
+  padding-top: 8px;
+  border-top: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+}
+.vobs-column-settings__layout-option {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 4px;
+}
+.vobs-column-settings__layout-label {
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.vobs-column-settings__layout-controls {
+  display: inline-flex;
+  align-items: center;
+  gap: 3px;
+  flex: 0 0 auto;
+}
+.vobs-column-settings__move {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 24px;
+  height: 24px;
+  padding: 0;
+  color: inherit;
+  background: transparent;
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: 2px;
+  cursor: pointer;
+  font: inherit;
+  line-height: 1;
+}
+.vobs-column-settings__move:disabled { cursor: not-allowed; opacity: .45; }
+.vobs-column-settings__width {
+  box-sizing: border-box;
+  width: 64px;
+  height: 24px;
+  padding: 0 5px;
+  color: inherit;
+  background: transparent;
+  border: 1px solid var(--vobs-table-border, var(--border-neutral-l1, #d0d7de));
+  border-radius: 2px;
+  font: inherit;
+  text-align: end;
+}
+.vobs-column-settings__width::placeholder { color: var(--vobs-table-muted, var(--text-tertiary, #57606a)); }

package/dist/types.cjs

@@ -0,0 +1,4 @@
+'use strict';
+
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"types.cjs"}

package/dist/types.d.cts

@@ -0,0 +1,164 @@
+import { Signal } from '@vobs/reactivity';
+import { VobsNode } from '@vobs/vobs';
+
+type DataTableAlign = 'start' | 'center' | 'end';
+type DataTableSortDirection = 'asc' | 'desc';
+type DataTableSortType = 'text' | 'number' | 'date' | 'boolean';
+type DataTableSortingMode = 'client' | 'server';
+type DataTablePaginationMode = 'simple' | 'standard' | 'all';
+interface DataTableSort {
+    readonly columnId: string;
+    readonly direction: DataTableSortDirection;
+    /** Optional backend field supplied by the column definition. */
+    readonly sortKey?: string;
+}
+interface DataTableQuery {
+    readonly page: number;
+    readonly pageSize: number;
+    readonly sort: DataTableSort | null;
+    readonly filters: Readonly<Record<string, unknown>>;
+}
+interface DataTablePage<Row> {
+    readonly rows: readonly Row[];
+    readonly total?: number;
+}
+type DataTableResourceData<Row> = readonly Row[] | DataTablePage<Row>;
+interface DataTableResource<Row> {
+    readonly data: {
+        readonly value: DataTableResourceData<Row> | null;
+    };
+    readonly error: {
+        readonly value: Error | null;
+    };
+    readonly loading: {
+        readonly value: boolean;
+    };
+    refetch(): Promise<unknown>;
+}
+type DataTableChildren = VobsNode | string | number | readonly DataTableChildren[] | (() => DataTableChildren | null | undefined);
+interface DataTableColumn<Row = Record<string, unknown>> {
+    readonly id: string;
+    readonly label: string;
+    readonly key?: keyof Row;
+    readonly render?: (row: Row, index: number) => DataTableChildren;
+    readonly compare?: (left: Row, right: Row) => number;
+    /** Value used by the built-in client sorter when compare is not provided. */
+    readonly sortValue?: (row: Row) => unknown;
+    /** Optional value kind for deterministic client-side sorting. */
+    readonly sortType?: DataTableSortType;
+    /** Backend field mapping; emitted together with the stable column id in DataTableSort. */
+    readonly sortKey?: string;
+    /** Apply a filter value supplied by the page or another external filter control. */
+    readonly filter?: (row: Row, value: unknown) => boolean;
+    readonly sortable?: boolean;
+    /** Marks a column as supported by an external filter UI; no control is rendered in the table. */
+    readonly filterable?: boolean;
+    readonly visible?: boolean;
+    readonly align?: DataTableAlign;
+    readonly width?: string | number;
+    readonly minWidth?: string | number;
+}
+interface DataTableColumnSettings {
+    readonly visibleColumnIds: readonly string[];
+    readonly columnOrder: readonly string[];
+    readonly columnWidths: Readonly<Record<string, string | number>>;
+}
+interface DataTableColumnSettingsPersistence {
+    load(): DataTableColumnSettings | null | undefined;
+    save(settings: DataTableColumnSettings): void;
+    reset?(): void;
+}
+/** Minimal storage shape accepted by createColumnSettingsPersistence. */
+interface DataTableColumnSettingsStorage {
+    get<T>(key: string): T | null | undefined;
+    set<T>(key: string, value: T): void;
+    remove(key: string): void;
+}
+interface DataTableIcons {
+    readonly ascending?: DataTableChildren;
+    readonly descending?: DataTableChildren;
+    readonly unsorted?: DataTableChildren;
+    readonly previous?: DataTableChildren;
+    readonly next?: DataTableChildren;
+}
+interface DataTablePaginationContext {
+    readonly page: number;
+    readonly pageCount: number;
+    readonly pageSize: number;
+    readonly pageSizeOptions: readonly number[];
+    readonly total: number;
+    readonly visibleCount: number;
+    readonly goToPage: (page: number) => void;
+    readonly setPageSize: (pageSize: number) => void;
+}
+type DataTablePagination = DataTableChildren | ((context: DataTablePaginationContext) => DataTableChildren | null | undefined);
+interface DataTableCommonProps {
+    readonly class?: string;
+    readonly className?: string;
+    readonly style?: string;
+    readonly id?: string;
+    readonly title?: string;
+    readonly role?: string;
+    readonly tabIndex?: number;
+    readonly [name: `aria-${string}`]: string | number | boolean | undefined;
+    readonly [name: `data-${string}`]: string | number | boolean | undefined;
+}
+interface KitDataTableProps<Row = Record<string, unknown>> extends DataTableCommonProps {
+    readonly columns?: readonly DataTableColumn<Row>[];
+    readonly rows?: readonly Row[];
+    readonly resource?: DataTableResource<Row>;
+    readonly rowKey?: (row: Row, index: number) => unknown;
+    /** 传入 Signal 时受控分页：表格翻页后自动写回信号。 */
+    readonly page?: number | Signal<number>;
+    readonly pageSize?: number | Signal<number>;
+    readonly total?: number;
+    readonly sort?: DataTableSort | null;
+    /** Client sorts loaded rows; server leaves row order to the resource owner. */
+    readonly sortingMode?: DataTableSortingMode;
+    /** Query state is owned by the caller when provided and is never edited by table-owned inputs. */
+    readonly filters?: Readonly<Record<string, unknown>>;
+    readonly columnSettings?: DataTableColumnSettings;
+    readonly visibleColumnIds?: readonly string[];
+    readonly virtual?: boolean;
+    readonly stickyHeader?: boolean;
+    readonly virtualHeight?: number;
+    readonly rowHeight?: number;
+    readonly overscan?: number;
+    readonly loading?: DataTableChildren;
+    readonly empty?: DataTableChildren;
+    readonly error?: (error: Error, retry: () => Promise<unknown>) => DataTableChildren;
+    readonly toolbar?: DataTableChildren;
+    readonly footer?: DataTableChildren;
+    readonly pagination?: DataTablePagination;
+    readonly paginationMode?: DataTablePaginationMode;
+    readonly pageSizeOptions?: readonly number[];
+    readonly pageSizeLabel?: string;
+    readonly icons?: DataTableIcons;
+    readonly previousLabel?: string;
+    readonly nextLabel?: string;
+    readonly jumpToLabel?: string;
+    readonly jumpToPlaceholder?: string;
+    readonly jumpToSubmitLabel?: string;
+    /** Formats the footer summary. The last two arguments are visible row count and page size. */
+    readonly pageLabel?: (page: number, pageCount: number, total: number, visibleCount: number, pageSize: number) => string;
+    /** Receives table-originated sort and pagination changes for a page-level query controller. */
+    readonly onQueryChange?: (query: DataTableQuery) => void;
+    readonly onRowClick?: (row: Row, index: number) => void;
+    readonly onVisibleColumnIdsChange?: (ids: readonly string[]) => void;
+}
+interface KitColumnSettingsProps<Row = Record<string, unknown>> extends DataTableCommonProps {
+    readonly columns?: readonly DataTableColumn<Row>[];
+    readonly settings?: DataTableColumnSettings;
+    readonly persistence?: DataTableColumnSettingsPersistence;
+    readonly visibleColumnIds?: readonly string[];
+    readonly trigger?: DataTableChildren;
+    readonly label?: string;
+    readonly closeLabel?: string;
+    readonly resetLabel?: string;
+    readonly onChange?: (ids: readonly string[]) => void;
+    readonly onSettingsChange?: (settings: DataTableColumnSettings) => void;
+    readonly onReset?: () => void;
+    readonly onPersistenceError?: (error: unknown) => void;
+}
+
+export type { DataTableAlign, DataTableChildren, DataTableColumn, DataTableColumnSettings, DataTableColumnSettingsPersistence, DataTableColumnSettingsStorage, DataTableCommonProps, DataTableIcons, DataTablePage, DataTablePagination, DataTablePaginationContext, DataTablePaginationMode, DataTableQuery, DataTableResource, DataTableResourceData, DataTableSort, DataTableSortDirection, DataTableSortType, DataTableSortingMode, KitColumnSettingsProps, KitDataTableProps };