antd-crud-table 0.4.0 → 0.7.0

package/dist/hooks/useCrudTable.d.ts

@@ -1,69 +1,126 @@
 import { ActionType } from '@ant-design/pro-components';
-export type CrudOperation<T> = {
-    getList: (params: CrudParams) => Promise<CrudResponse<T>>;
-    create: (data: Partial<T>) => Promise<T>;
-    update: (id: any, data: Partial<T>) => Promise<T>;
-    delete: (id: any) => Promise<void>;
-};
-export type CrudParams = {
-    current?: number;
-    pageSize?: number;
-    sortBy?: string;
-    sortOrder?: 'ascend' | 'descend';
-    [key: string]: any;
-};
-export type CrudResponse<T> = {
-    data: T[];
-    total: number;
-    success?: boolean;
-};
-export type CrudState<T> = {
+import { CrudDataSource, CrudDraft, IdGenerator, RestDataSourceOptions } from '../core';
+import { CrudOperations } from '../core/CustomDataSource';
+import { PartialCrudTableLocale } from '../locale/types';
+/** The operations a table performs, used to tag success and error callbacks. */
+export type CrudOperationName = 'list' | 'create' | 'update' | 'delete';
+/**
+ * Coerce a thrown value into an Error.
+ *
+ * Callbacks receive a real Error rather than `unknown`, so consumers can read
+ * `.message` without narrowing at every call site. Non-Error throws are wrapped
+ * rather than stringified into the message, keeping the original as `cause`.
+ */
+export declare const toError: (thrown: unknown) => Error;
+/** Everything the hook tracks about the current view of the data. */
+export interface CrudTableState<T> {
+    /** Whether a read or write is in flight. */
     loading: boolean;
-    error: string | null;
-    data: T[];
+    /** The most recent failure, cleared when a read succeeds. */
+    error: Error | null;
+    /** Records from the last read. Empty until `refresh` has run. */
+    data: readonly T[];
+    /** Records matching the filters, across all pages. */
     total: number;
-    current: number;
+    /** Current 1-based page. */
+    page: number;
+    /** Current rows per page. */
     pageSize: number;
-};
-type UseCrudTableConfigBase = {
+}
+/** Options shared by every strategy. */
+interface UseCrudTableOptionsBase<T, K extends keyof T> {
+    /** Rows per page for the hook's own reads. Defaults to 10. */
     defaultPageSize?: number;
-    enableCache?: boolean;
+    /**
+     * Apply mutations to local state immediately instead of re-reading.
+     *
+     * Trades consistency for responsiveness: server-assigned fields will not be
+     * reflected until the next list.
+     */
     optimisticUpdates?: boolean;
-    onSuccess?: (operation: 'create' | 'update' | 'delete' | 'fetch', data: any) => void;
-    onError?: (operation: 'create' | 'update' | 'delete' | 'fetch', error: any) => void;
-};
-interface UseCrudTableConfigStatic<T> extends UseCrudTableConfigBase {
-    staticData: T[];
+    /**
+     * Re-read the list after a successful mutation.
+     *
+     * Defaults to true for standalone hook consumers, which render from
+     * `state.data`. `CrudTable` sets it false: it renders from ProTable's own
+     * request pipeline and reloads through `actionRef`, so leaving this on
+     * issued two list requests for every write.
+     */
+    refreshAfterMutation?: boolean;
+    /** Replaces the built-in identity policy for the in-memory strategies. */
+    generateId?: IdGenerator<T, K>;
+    /** Show antd toasts for the outcome of each operation. */
+    notifications?: boolean;
+    /**
+     * Overrides for the toast wording.
+     *
+     * `CrudTable` passes its own resolved locale down, so this is only needed
+     * when the hook is used on its own.
+     */
+    locale?: PartialCrudTableLocale;
+    /** Called after an operation succeeds, with whatever it produced. */
+    onSuccess?: (operation: CrudOperationName, payload: unknown) => void;
+    /** Called when an operation fails, with a real Error rather than the raw throw. */
+    onError?: (operation: CrudOperationName, error: Error) => void;
+}
+/** Serves records from an in-process array. */
+export interface StaticStrategy<T, K extends keyof T> extends UseCrudTableOptionsBase<T, K> {
+    /** Seed records. Copied once; later changes to the array are not picked up. */
+    staticData: readonly T[];
 }
-interface UseCrudTableConfigApi<T> extends UseCrudTableConfigBase {
-    api: {
-        baseUrl?: string;
-        endpoints?: {
-            list?: string;
-            create?: string;
-            update?: string;
-            delete?: string;
-        };
-        headers?: Record<string, string>;
-        transform?: {
-            request?: (data: any) => any;
-            response?: (data: any) => CrudResponse<T>;
-        };
-    };
+/** Serves records from a REST API. */
+export interface RestStrategy<T, K extends keyof T> extends UseCrudTableOptionsBase<T, K> {
+    /** Endpoints, parameter names, verbs and payload mapping. */
+    api: RestDataSourceOptions<T>;
 }
-interface UseCrudTableConfigCustom<T> extends UseCrudTableConfigBase {
-    operations: Partial<CrudOperation<T>>;
+/** Serves records persisted to `localStorage`. */
+export interface LocalStorageStrategy<T, K extends keyof T> extends UseCrudTableOptionsBase<T, K> {
+    /** The `localStorage` key records are stored under. */
+    storageKey: string;
+    /** Records used when the key holds nothing readable. */
+    initialData?: readonly T[];
 }
-export type UseCrudTableConfig<T> = UseCrudTableConfigStatic<T> | UseCrudTableConfigApi<T> | UseCrudTableConfigCustom<T>;
-export type CrudTableActions<T> = {
+/** Serves records through consumer-supplied operations. */
+export interface OperationsStrategy<T, K extends keyof T> extends UseCrudTableOptionsBase<T, K> {
+    /** Your own implementations. Omitted operations fail with a named error. */
+    operations: CrudOperations<T, K>;
+}
+/** Serves records from a source the consumer constructs and owns. */
+export interface DataSourceStrategy<T, K extends keyof T> extends UseCrudTableOptionsBase<T, K> {
+    /** A source the consumer constructs and owns outright. */
+    dataSource: CrudDataSource<T, K>;
+}
+/** Exactly one strategy must be supplied. */
+export type UseCrudTableOptions<T, K extends keyof T> = StaticStrategy<T, K> | RestStrategy<T, K> | LocalStorageStrategy<T, K> | OperationsStrategy<T, K> | DataSourceStrategy<T, K>;
+/** What {@link useCrudTable} returns. */
+export interface CrudTableActions<T, K extends keyof T> {
+    /** Re-read the current page into `state`. */
     refresh: () => Promise<void>;
-    create: (data: Partial<T>) => Promise<T | null>;
-    update: (id: any, data: Partial<T>) => Promise<T | null>;
-    delete: (id: any) => Promise<boolean>;
+    /** Create a record. Resolves to the stored result, or `null` on failure. */
+    create: (draft: CrudDraft<T>) => Promise<T | null>;
+    /** Update a record. Resolves to the stored result, or `null` on failure. */
+    update: (id: T[K], draft: CrudDraft<T>) => Promise<T | null>;
+    /** Delete a record. Resolves to whether it succeeded. */
+    remove: (id: T[K]) => Promise<boolean>;
+    /** The live source, for wiring a table's own request pipeline directly. */
+    dataSource: CrudDataSource<T, K>;
+    /** Move to a 1-based page. */
+    setPage: (page: number) => void;
+    /** Change the page size, returning to the first page. */
     setPageSize: (size: number) => void;
-    setCurrentPage: (page: number) => void;
-    state: CrudState<T>;
-    actionRef: React.RefObject<ActionType | null>;
-};
-export declare const useCrudTable: <T extends Record<string, any>>(rowKey: keyof T, config: UseCrudTableConfig<T>) => CrudTableActions<T>;
+    /** Current loading, error, data and pagination state. */
+    state: CrudTableState<T>;
+    /** ProTable's imperative handle, for reloading the table's own pipeline. */
+    actionRef: React.RefObject<ActionType | undefined>;
+}
+/**
+ * React state and mutation orchestration over a `CrudDataSource`.
+ *
+ * All I/O lives in the source; this hook owns only React concerns. The source
+ * is constructed once per hook instance and held in a ref, so its lifetime is
+ * tied to the component rather than to the identity of the arguments that
+ * described it - passing an inline `staticData` literal no longer discards the
+ * dataset on every parent render.
+ */
+export declare const useCrudTable: <T extends object, K extends keyof T>(rowKey: K, options: UseCrudTableOptions<T, K>) => CrudTableActions<T, K>;
 export {};

package/dist/hooks/useLocalStorageCrud.d.ts

@@ -1,9 +1,14 @@
-import { CrudTableActions } from './useCrudTable';
-export type UseLocalStorageCrudConfig = {
-    defaultPageSize?: number;
-    optimisticUpdates?: boolean;
-    onSuccess?: (operation: 'create' | 'update' | 'delete' | 'fetch', data: any) => void;
-    onError?: (operation: 'create' | 'update' | 'delete' | 'fetch', error: any) => void;
-};
-export declare const useLocalStorageCrud: <T extends Record<string, any>>(rowKey: keyof T, storageKey: string, initialData?: T[], config?: UseLocalStorageCrudConfig) => CrudTableActions<T>;
-export default useLocalStorageCrud;
+import { CrudTableActions, LocalStorageStrategy } from './useCrudTable';
+/**
+ * Options for the localStorage strategy, minus the strategy selector itself.
+ */
+/** Options for the localStorage strategy, minus the strategy selector itself. */
+export type UseLocalStorageCrudOptions<T, K extends keyof T> = Omit<LocalStorageStrategy<T, K>, 'storageKey' | 'initialData'>;
+/**
+ * A localStorage-backed CRUD hook.
+ *
+ * A thin wrapper that selects the localStorage strategy and performs the
+ * initial read. Standalone consumers render from `state.data`, so unlike the
+ * table - which drives its own request pipeline - this needs a load on mount.
+ */
+export declare const useLocalStorageCrud: <T extends object, K extends keyof T>(rowKey: K, storageKey: string, initialData?: readonly T[], options?: UseLocalStorageCrudOptions<T, K>) => CrudTableActions<T, K>;

package/dist/index.cjs

@@ -0,0 +1 @@
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});const e=require("./CrudTable-DRN70sET.cjs"),t=require("./useCrudTable-40jpmCkr.cjs"),n=require("./en_US-D3Kl6g3n.cjs"),r=require("./exportData.cjs"),i=require("./CrudTableLazy.cjs"),a=require("./useLocalStorageCrud.cjs");exports.CrudTable=e.t,exports.default=e.t,exports.CrudTableLazy=i.default,exports.CustomDataSource=t.r,exports.InMemoryDataSource=t.l,exports.LocalStorageDataSource=t.s,exports.RestDataSource=t.a,exports.RestError=t.o,exports.StaticDataSource=t.c,exports.UnsupportedOperationError=t.i,exports.defaultFieldLocale=e.r,exports.defaultIdGenerator=t.m,exports.enUS=n.t,exports.exportAllData=r.exportAllData,exports.exportData=r.exportData,exports.exportToCSV=r.exportToCSV,exports.exportToExcel=r.exportToExcel,exports.exportToJSON=r.exportToJSON,exports.fieldRegistry=e.i,exports.filterRecords=t.u,exports.getFieldDefinition=e.a,exports.paginateRecords=t.d,exports.queryRecords=t.f,exports.randomUuid=t.h,exports.sortRecords=t.p,exports.toError=t.t,exports.useCrudTable=t.n,exports.useLocalStorageCrud=a.useLocalStorageCrud,exports.useResolvedLocale=e.n;

package/dist/index.d.ts

@@ -1,9 +1,17 @@
 export { default as CrudTable } from './CrudTable';
 export { default as CrudTableLazy } from './CrudTableLazy';
-export { useCrudTable } from './hooks/useCrudTable';
+export { default } from './CrudTable';
+export type { CrudTableConfig, CrudColumn, CrudColumnFor } from './CrudTable';
+export { useCrudTable, toError } from './hooks/useCrudTable';
 export { useLocalStorageCrud } from './hooks/useLocalStorageCrud';
-export { exportData, exportToCSV, exportToJSON, exportToXLSX, exportAllData } from './utils/exportData';
-export type { CrudTableConfig, CrudColumn, DataType } from './CrudTable';
-export type { UseCrudTableConfig, CrudTableActions, CrudOperation, CrudParams, CrudResponse, CrudState } from './hooks/useCrudTable';
-export type { UseLocalStorageCrudConfig } from './hooks/useLocalStorageCrud';
-export type { ExportFormat } from './utils/exportData';
+export type { CrudOperationName, CrudTableActions, CrudTableState, UseCrudTableOptions, StaticStrategy, RestStrategy, LocalStorageStrategy, OperationsStrategy, DataSourceStrategy, } from './hooks/useCrudTable';
+export type { UseLocalStorageCrudOptions } from './hooks/useLocalStorageCrud';
+export { CustomDataSource, InMemoryDataSource, LocalStorageDataSource, RestDataSource, RestError, StaticDataSource, UnsupportedOperationError, defaultIdGenerator, filterRecords, paginateRecords, queryRecords, randomUuid, sortRecords, } from './core';
+export type { CrudDataSource, CrudDraft, CrudFilters, CrudFilterValue, CrudOperations, CrudPage, CrudQuery, CrudSort, IdGenerator, RestDataSourceOptions, RestEndpoints, RestMethods, RestParamNames, SortDirection, Timestamped, } from './core';
+export { enUS, useResolvedLocale } from './locale';
+export type { CrudTableLocale, PartialCrudTableLocale, ResolvedLocale } from './locale';
+export { fieldRegistry, getFieldDefinition, defaultFieldLocale } from './fields/registry';
+export type { FieldType, FieldTypeDefinition } from './fields/registry';
+export type { EnumOption, FieldColumn } from './fields/types';
+export { exportData, exportToCSV, exportToJSON, exportToExcel, exportAllData, } from './utils/exportData';
+export type { ColumnOption, ExportFormat, ExportOptions } from './utils/exportData';

package/dist/index.js

@@ -0,0 +1,7 @@
+import { a as e, i as t, n, r, t as i } from "./CrudTable-Btf58zof.js";
+import { a, c as o, d as s, f as c, h as l, i as u, l as d, m as f, n as p, o as m, p as h, r as g, s as _, t as v, u as y } from "./useCrudTable-DxjnXVlQ.js";
+import { t as b } from "./en_US-DGCMDOdX.js";
+import { exportAllData as x, exportData as S, exportToCSV as C, exportToExcel as w, exportToJSON as T } from "./exportData.js";
+import E from "./CrudTableLazy.js";
+import { useLocalStorageCrud as D } from "./useLocalStorageCrud.js";
+export { i as CrudTable, i as default, E as CrudTableLazy, g as CustomDataSource, d as InMemoryDataSource, _ as LocalStorageDataSource, a as RestDataSource, m as RestError, o as StaticDataSource, u as UnsupportedOperationError, r as defaultFieldLocale, f as defaultIdGenerator, b as enUS, x as exportAllData, S as exportData, C as exportToCSV, w as exportToExcel, T as exportToJSON, t as fieldRegistry, y as filterRecords, e as getFieldDefinition, s as paginateRecords, c as queryRecords, l as randomUuid, h as sortRecords, v as toError, p as useCrudTable, D as useLocalStorageCrud, n as useResolvedLocale };

package/dist/locale/en_US.d.ts

@@ -0,0 +1,10 @@
+import { CrudTableLocale } from './types';
+/**
+ * The built-in default.
+ *
+ * English is the fallback everywhere, including when no antd `ConfigProvider`
+ * is present - which is the case that previously left antd's own components
+ * rendering their built-in Chinese defaults.
+ */
+export declare const enUS: CrudTableLocale;
+export default enUS;

package/dist/locale/index.d.ts

@@ -0,0 +1,4 @@
+export { enUS } from './en_US';
+export { useResolvedLocale } from './useResolvedLocale';
+export type { ResolvedLocale } from './useResolvedLocale';
+export type { CrudTableLocale, PartialCrudTableLocale } from './types';

package/dist/locale/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Every user-visible string the library produces.
+ *
+ * Interpolated strings are functions rather than templates with placeholders,
+ * so a translation cannot silently drop a value or get the argument order
+ * wrong - the compiler checks it.
+ *
+ * antd's own chrome (pagination, empty states, date pickers) is localised
+ * through antd's `ConfigProvider`, and ProTable's chrome through its `intl`.
+ * `CrudTable` derives both from the surrounding `ConfigProvider` when there is
+ * one, so a consumer usually sets their app locale once and this object only
+ * needs supplying to override the library's own wording.
+ */
+export interface CrudTableLocale {
+    /** Header of the per-row actions column. */
+    actions: string;
+    /** Row action opening the edit form. */
+    edit: string;
+    /** Row action deleting a record. */
+    delete: string;
+    /** Toolbar button opening the create form. */
+    create: string;
+    /** Toolbar menu entry re-reading the current page. */
+    refresh: string;
+    /** Title of the create form. */
+    createTitle: string;
+    /** Title of the edit form. */
+    editTitle: string;
+    /** Confirm button in the create/edit form. */
+    ok: string;
+    /** Dismiss button in the create/edit form. */
+    cancel: string;
+    /** Validation message for a required field. */
+    requiredField: (label: string) => string;
+    /** Title of the single-delete confirmation. */
+    confirmDeleteTitle: string;
+    /** Body of both delete confirmations. */
+    confirmDeleteContent: string;
+    /** Confirm button of the single-delete confirmation. */
+    confirmDeleteOk: string;
+    /** Title of the bulk-delete confirmation. */
+    confirmBulkDeleteTitle: (count: number) => string;
+    /** Confirm button of the bulk-delete confirmation. */
+    confirmBulkDeleteOk: string;
+    /** Toolbar button opening the bulk-delete confirmation. */
+    deleteSelected: (count: number) => string;
+    /** Warning shown when bulk delete is invoked with nothing selected. */
+    selectItemsToDelete: string;
+    /** Result message when every delete in a bulk run succeeded. */
+    bulkDeleteSuccess: (count: number) => string;
+    /** Result message when only some deletes in a bulk run succeeded. */
+    bulkDeletePartial: (succeeded: number, total: number, failed: number) => string;
+    /** Menu entry writing every matching record. */
+    exportAll: (format: string) => string;
+    /** Menu entry writing only the rows on screen. */
+    exportPage: (format: string) => string;
+    /** Warning shown when there is nothing to write. */
+    nothingToExport: string;
+    /** Error shown when gathering or writing the export failed. */
+    exportFailed: (message: string) => string;
+    /** Confirmation that a record was created. */
+    createSuccess: string;
+    /** Confirmation that a record was updated. */
+    updateSuccess: string;
+    /** Confirmation that a record was deleted. */
+    deleteSuccess: string;
+    /** Placeholder while the code-split table loads. */
+    loading: string;
+    /** Cell text for a true boolean. */
+    yes: string;
+    /** Cell text for a false boolean. */
+    no: string;
+    /** Cell text for a missing value. */
+    empty: string;
+    /** Placeholder of an enum column's select control. */
+    selectPlaceholder: (title: string) => string;
+    /** Placeholder of a tags column's input. */
+    tagsPlaceholder: string;
+    /** Validation message for an `email` column. */
+    invalidEmail: string;
+    /** Validation message for a `url` column. */
+    invalidUrl: string;
+    /** Validation message for an `image` column. */
+    invalidImageUrl: string;
+    /** Validation message for a `json` column. */
+    invalidJson: string;
+}
+/** A locale override: supply only the strings that differ from the default. */
+export type PartialCrudTableLocale = Partial<CrudTableLocale>;

package/dist/locale/useResolvedLocale.d.ts

@@ -0,0 +1,35 @@
+import { Locale as AntdLocale } from 'antd/es/locale';
+import { enUSIntl } from '@ant-design/pro-components';
+import { CrudTableLocale, PartialCrudTableLocale } from './types';
+/** Everything `CrudTable` needs to render in the right language. */
+export interface ResolvedLocale {
+    /** The library's own strings, defaults merged with any override. */
+    strings: CrudTableLocale;
+    /** ProTable's message bundle, derived from the surrounding antd locale. */
+    intl: typeof enUSIntl;
+    /**
+     * The antd locale to apply, or `undefined` to inherit.
+     *
+     * `undefined` means the consumer already has a `ConfigProvider`, so the
+     * table must not override it. A value means there is none, and antd's
+     * components would otherwise fall back to their built-in defaults - which
+     * are Chinese, not English.
+     */
+    antdLocale: AntdLocale | undefined;
+    /** Whether an antd `ConfigProvider` locale was found in the tree. */
+    inherited: boolean;
+}
+/**
+ * Resolve the language for a table from three sources, in order.
+ *
+ * 1. An explicit `locale` prop, for overriding individual strings.
+ * 2. The surrounding antd `ConfigProvider`, so a table follows the app.
+ * 3. English, when there is no provider at all.
+ *
+ * Step 3 is the one that matters most in practice. antd's components read
+ * their own `ConfigProvider`, which `ProConfigProvider`'s `intl` does not
+ * feed, so a table rendered outside any provider showed English chrome from
+ * ProTable next to Chinese pagination and modal buttons from antd. Supplying
+ * an explicit antd locale in that case is what makes the default coherent.
+ */
+export declare const useResolvedLocale: (override?: PartialCrudTableLocale) => ResolvedLocale;

package/dist/useCrudTable-40jpmCkr.cjs

@@ -0,0 +1 @@
+const e=require("./en_US-D3Kl6g3n.cjs");let t=require("antd"),n=require("react");var r=()=>{let e=globalThis.crypto===void 0?void 0:globalThis.crypto;if(e&&typeof e.randomUUID==`function`)return e.randomUUID();let t=new Uint8Array(16);if(e&&typeof e.getRandomValues==`function`)e.getRandomValues(t);else for(let e=0;e<t.length;e+=1)t[e]=Math.floor(Math.random()*256);t[6]=t[6]&15|64,t[8]=t[8]&63|128;let n=Array.from(t,e=>e.toString(16).padStart(2,`0`)).join(``);return`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20)}`},i=/^\d+$/,a=e=>t=>{let n=t.map(t=>t[e]).filter(e=>e!=null);if(n.length===0)return 1;if(n.every(e=>typeof e==`number`)){let e=Math.max(...n.filter(Number.isFinite));return(Number.isFinite(e)?e:0)+1}if(n.every(e=>typeof e==`string`)){let e=n;if(e.every(e=>i.test(e))){let t=Math.max(...e.map(Number));return String(t+1)}return r()}throw Error(`Cannot derive the next id for "${String(e)}": existing keys are neither all numbers nor all strings. Supply an explicit \`generateId\` to the data source.`)},o=(e,t)=>typeof e==`number`&&typeof t==`number`?e-t:typeof e==`boolean`&&typeof t==`boolean`?Number(e)-Number(t):e instanceof Date&&t instanceof Date?e.getTime()-t.getTime():String(e).localeCompare(String(t),void 0,{numeric:!0}),s=(e,t)=>e!=null&&String(e).toLowerCase().includes(String(t).toLowerCase()),c=(e,t)=>{if(!t)return e;let n=Object.entries(t).filter(([,e])=>e!=null&&e!==``);return n.length===0?e:e.filter(e=>n.every(([t,n])=>s(e[t],n)))},l=(e,t)=>!t||t.length===0?e:[...e].sort((e,n)=>{for(let{field:r,direction:i}of t){let t=e[r],a=n[r],s=t==null,c=a==null;if(s&&c)continue;if(s)return 1;if(c)return-1;let l=o(t,a);if(l!==0)return i===`ascend`?l:-l}return 0}),u=(e,t,n)=>{let r=Math.max(0,(t-1)*n);return e.slice(r,r+n)},d=(e,t)=>{let n=l(c(e,t.filters),t.sort);return{items:u(n,t.page,t.pageSize),total:n.length}},f=class{key;generateId;constructor(e,t){this.key=e,this.generateId=t??a(e)}decorate(e,t){return{}}indexOf(e){return this.read().findIndex(t=>t[this.key]===e)}async list(e){return d(this.read(),e)}async listAll(e){return l(c(this.read(),e.filters),e.sort)}async create(e){let t=this.read(),n={[this.key]:this.generateId(t),...e,...this.decorate(e,`create`)};return this.write([...t,n]),n}async update(e,t){let n=this.read(),r=this.indexOf(e);if(r===-1)throw Error(`No record with ${String(this.key)} "${String(e)}"`);let i={...n[r],...t,...this.decorate(t,`update`),[this.key]:e},a=[...n];return a[r]=i,this.write(a),i}async remove(e){let t=this.read();if(this.indexOf(e)===-1)throw Error(`No record with ${String(this.key)} "${String(e)}"`);this.write(t.filter(t=>t[this.key]!==e))}},p=class extends f{records;constructor(e,t,n){super(t,n),this.records=[...e]}read(){return this.records}write(e){this.records=e}},m=class extends f{storageKey;seed;constructor(e,t,n=[],r){super(t,r),this.storageKey=e,this.seed=n}read(){let e;try{e=localStorage.getItem(this.storageKey)}catch{return this.seed}if(e===null)return this.seed;try{let t=JSON.parse(e);return Array.isArray(t)?t:this.seed}catch{return this.seed}}write(e){try{localStorage.setItem(this.storageKey,JSON.stringify(e))}catch(e){throw Error(`Failed to persist to localStorage key "${this.storageKey}": ${e instanceof Error?e.message:String(e)}`)}}decorate(e,t){let n=new Date().toISOString();return t===`create`?{createdAt:n,updatedAt:n}:{updatedAt:n}}},h={list:`/list`,create:`/create`,update:`/update`,remove:`/delete`},g={page:`current`,pageSize:`pageSize`,sortBy:`sortBy`,sortOrder:`sortOrder`},_={create:`POST`,update:`PUT`,remove:`DELETE`},v=class extends Error{status;body;constructor(e,t,n){super(`Request to ${n} failed with status ${e}`),this.name=`RestError`,this.status=e,this.body=t}},y=class{baseUrl;endpoints;paramNames;methods;headers;serializeRequest;parseResponse;fetchImpl;constructor(e={}){this.baseUrl=e.baseUrl??``,this.endpoints={...h,...e.endpoints},this.paramNames={...g,...e.paramNames},this.methods={..._,...e.methods},this.headers=e.headers??{},this.serializeRequest=e.serializeRequest??(e=>e),this.parseResponse=e.parseResponse,this.fetchImpl=e.fetchImpl??globalThis.fetch.bind(globalThis)}serializeSort(e,t){let n=e?.[0];n&&(t.set(this.paramNames.sortBy,String(n.field)),t.set(this.paramNames.sortOrder,n.direction))}buildListUrl(e){let t=new URLSearchParams;t.set(this.paramNames.page,String(e.page)),t.set(this.paramNames.pageSize,String(e.pageSize)),this.serializeSort(e.sort,t);for(let[n,r]of Object.entries(e.filters??{}))r!=null&&r!==``&&t.set(n,String(r));return`${this.endpoints.list}?${t.toString()}`}buildRecordPath(e,t){return`${e}/${encodeURIComponent(String(t))}`}toPage(e){if(this.parseResponse)return this.parseResponse(e);if(Array.isArray(e))return{items:e,total:e.length};if(typeof e==`object`&&e){let t=e;if(Array.isArray(t.data)){let e=t.data;return{items:e,total:typeof t.total==`number`?t.total:e.length}}}throw Error("Unrecognised list response. Provide `parseResponse` to map it to { items, total }.")}async request(e,t={}){let n=`${this.baseUrl}${e}`,r=await this.fetchImpl(n,{...t,headers:{"Content-Type":`application/json`,...this.headers,...t.headers}});if(!r.ok)throw new v(r.status,await r.text().catch(()=>``),n);if(r.status===204)return;let i=await r.text();return i===``?void 0:JSON.parse(i)}async list(e){return this.toPage(await this.request(this.buildListUrl(e)))}async create(e){return await this.request(this.endpoints.create,{method:this.methods.create,body:JSON.stringify(this.serializeRequest(e))})}async update(e,t){return await this.request(this.buildRecordPath(this.endpoints.update,e),{method:this.methods.update,body:JSON.stringify(this.serializeRequest(t))})}async remove(e){await this.request(this.buildRecordPath(this.endpoints.remove,e),{method:this.methods.remove})}},b=class extends Error{operation;constructor(e){super(`This table's data source does not support "${e}". Provide an \`${e}\` operation to enable it.`),this.name=`UnsupportedOperationError`,this.operation=e}},x=class{operations;constructor(e){this.operations=e}supports(e){return typeof this.operations[e]==`function`}async list(e){if(!this.operations.list)throw new b(`list`);return this.operations.list(e)}async listAll(e){if(this.operations.listAll)return this.operations.listAll(e);throw new b(`listAll`)}async create(e){if(!this.operations.create)throw new b(`create`);return this.operations.create(e)}async update(e,t){if(!this.operations.update)throw new b(`update`);return this.operations.update(e,t)}async remove(e){if(!this.operations.remove)throw new b(`remove`);return this.operations.remove(e)}},S=e=>e instanceof Error?e:Error(typeof e==`string`?e:`Unknown error`,{cause:e}),C=(e,t)=>{if(`dataSource`in t)return t.dataSource;if(`operations`in t)return new x(t.operations);if(`storageKey`in t)return new m(t.storageKey,e,t.initialData??[],t.generateId);if(`staticData`in t)return new p(t.staticData,e,t.generateId);if(`api`in t)return new y(t.api);throw Error("useCrudTable: supply exactly one of `staticData`, `api`, `storageKey`, `operations` or `dataSource`.")},w=(r,i)=>{let a=(0,n.useRef)(void 0),{defaultPageSize:o=10,optimisticUpdates:s=!1,refreshAfterMutation:c=!0,notifications:l=!0}=i,u=(0,n.useMemo)(()=>i.locale?{...e.t,...i.locale}:e.t,[i.locale]),d=(0,n.useRef)(i);d.current=i;let f=(0,n.useRef)(null);f.current===null&&(f.current=C(r,i));let p=f.current,[m,h]=(0,n.useState)({loading:!1,error:null,data:[],total:0,page:1,pageSize:o}),{page:g,pageSize:_}=m,v=(0,n.useCallback)((e,n)=>{d.current.onError?.(e,n),l&&t.message.error(n.message)},[l]),y=(0,n.useCallback)((e,n,r)=>{d.current.onSuccess?.(e,n),l&&t.message.success(r)},[l]),b=(0,n.useCallback)(async()=>{h(e=>({...e,loading:!0,error:null}));try{let e={page:g,pageSize:_},t=await p.list(e);h(e=>({...e,data:t.items,total:t.total,loading:!1}))}catch(e){let t=S(e);h(e=>({...e,loading:!1,error:t})),v(`list`,t)}},[p,g,_,v]),x=(0,n.useCallback)(async e=>{if(s){h(e);return}if(c){await b();return}h(e=>({...e,loading:!1}))},[s,c,b]),w=(0,n.useCallback)(async e=>{h(e=>({...e,loading:!0}));try{let t=await p.create(e);return await x(e=>({...e,data:[...e.data,t],total:e.total+1,loading:!1})),y(`create`,t,u.createSuccess),t}catch(e){return h(e=>({...e,loading:!1})),v(`create`,S(e)),null}},[p,x,v,y,u]),T=(0,n.useCallback)(async(e,t)=>{h(e=>({...e,loading:!0}));try{let n=await p.update(e,t);return await x(t=>({...t,data:t.data.map(t=>t[r]===e?n:t),loading:!1})),y(`update`,n,u.updateSuccess),n}catch(e){return h(e=>({...e,loading:!1})),v(`update`,S(e)),null}},[p,x,v,r,y,u]),E=(0,n.useCallback)(async e=>{h(e=>({...e,loading:!0}));try{return await p.remove(e),await x(t=>({...t,data:t.data.filter(t=>t[r]!==e),total:Math.max(0,t.total-1),loading:!1})),y(`delete`,e,u.deleteSuccess),!0}catch(e){return h(e=>({...e,loading:!1})),v(`delete`,S(e)),!1}},[p,x,v,r,y,u]),D=(0,n.useCallback)(e=>{h(t=>({...t,page:e}))},[]),O=(0,n.useCallback)(e=>{h(t=>({...t,pageSize:e,page:1}))},[]);return(0,n.useMemo)(()=>({refresh:b,create:w,update:T,remove:E,dataSource:p,setPage:D,setPageSize:O,state:m,actionRef:a}),[b,w,T,E,p,D,O,m])};Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return c}});