antd-crud-table 0.4.0 → 0.7.0

package/dist/core/RestDataSource.d.ts

@@ -0,0 +1,120 @@
+import { CrudDataSource, CrudDraft, CrudPage, CrudQuery, CrudSort } from './types';
+/** Paths appended to `baseUrl` for each operation. */
+export interface RestEndpoints {
+    /** Path listing records. */
+    list: string;
+    /** Path accepting a new record. */
+    create: string;
+    /** Path for updating one record; the id is appended by `buildRecordPath`. */
+    update: string;
+    /** Path for deleting one record; the id is appended by `buildRecordPath`. */
+    remove: string;
+}
+/** Query-string parameter names, for APIs that do not speak ProTable's vocabulary. */
+export interface RestParamNames {
+    /** Parameter carrying the 1-based page number. Defaults to `current`. */
+    page: string;
+    /** Parameter carrying the page size. Defaults to `pageSize`. */
+    pageSize: string;
+    /** Parameter carrying the field to sort by. Defaults to `sortBy`. */
+    sortBy: string;
+    /** Parameter carrying the sort direction. Defaults to `sortOrder`. */
+    sortOrder: string;
+}
+/** HTTP verbs used per mutating operation. */
+export interface RestMethods {
+    /** Verb for creating a record. Defaults to `POST`. */
+    create: 'POST' | 'PUT';
+    /** Verb for updating a record. Defaults to `PUT`. */
+    update: 'PUT' | 'PATCH' | 'POST';
+    /** Verb for deleting a record. Defaults to `DELETE`. */
+    remove: 'DELETE' | 'POST';
+}
+/** Everything needed to point a {@link RestDataSource} at an API. */
+export interface RestDataSourceOptions<T> {
+    /** Prefixed to every request path, exactly once. */
+    baseUrl?: string;
+    /** Overrides for the per-operation paths. */
+    endpoints?: Partial<RestEndpoints>;
+    /** Overrides for query-parameter names, for APIs with another vocabulary. */
+    paramNames?: Partial<RestParamNames>;
+    /** Overrides for the HTTP verb used by each mutating operation. */
+    methods?: Partial<RestMethods>;
+    /** Sent with every request, merged over the default content type. */
+    headers?: Readonly<Record<string, string>>;
+    /** Maps a draft onto the request body. Defaults to sending the draft as-is. */
+    serializeRequest?: (draft: CrudDraft<T>) => unknown;
+    /** Maps a list response onto a page. Required when the API wraps its payload. */
+    parseResponse?: (payload: unknown) => CrudPage<T>;
+    /** Injected for testing; defaults to the global `fetch`. */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Raised when the server answers with a non-2xx status.
+ *
+ * Carries the status and the raw body so consumers can branch on a 409 or
+ * surface a validation payload, rather than receiving a flattened string.
+ */
+export declare class RestError extends Error {
+    /** The HTTP status the server responded with. */
+    readonly status: number;
+    /** The raw response body, for reading a validation payload. */
+    readonly body: string;
+    constructor(status: number, body: string, url: string);
+}
+/**
+ * A source over a REST API.
+ *
+ * URL and payload construction live in `protected` methods rather than inline,
+ * so an API that does not match the default dialect is a small subclass
+ * instead of a full reimplementation of the strategy.
+ */
+export declare class RestDataSource<T extends object, K extends keyof T> implements CrudDataSource<T, K> {
+    /** Prefixed to every request path, exactly once. */
+    protected readonly baseUrl: string;
+    /** Resolved per-operation paths. */
+    protected readonly endpoints: RestEndpoints;
+    /** Resolved query-parameter names. */
+    protected readonly paramNames: RestParamNames;
+    /** Resolved HTTP verbs. */
+    protected readonly methods: RestMethods;
+    /** Headers sent with every request. */
+    protected readonly headers: Readonly<Record<string, string>>;
+    /** Maps a draft onto the request body. */
+    protected readonly serializeRequest: (draft: CrudDraft<T>) => unknown;
+    /** Maps a list payload onto a page, when the API wraps its results. */
+    protected readonly parseResponse?: (payload: unknown) => CrudPage<T>;
+    private readonly fetchImpl;
+    constructor(options?: RestDataSourceOptions<T>);
+    /**
+     * Encode sort instructions as query parameters.
+     *
+     * Only the first instruction is sent: `sortBy`/`sortOrder` is a single-sort
+     * shape, and inventing a multi-sort encoding would guess at a convention the
+     * server may not share. Override to support one.
+     */
+    protected serializeSort(sort: readonly CrudSort<T>[] | undefined, params: URLSearchParams): void;
+    /** Build the list URL, including pagination, sort and filters. */
+    protected buildListUrl(query: CrudQuery<T>): string;
+    /** Path addressing a single record. Override for `?id=` style APIs. */
+    protected buildRecordPath(endpoint: string, id: T[K]): string;
+    /**
+     * Interpret a list payload.
+     *
+     * Without a `parseResponse`, accepts either a bare array or the
+     * `{ data, total }` shape the previous implementation assumed.
+     */
+    protected toPage(payload: unknown): CrudPage<T>;
+    /**
+     * Single point where `baseUrl`, headers and error handling are applied.
+     *
+     * Every request goes through here so `baseUrl` is prefixed exactly once -
+     * building a full URL earlier and prefixing again is how it ended up
+     * duplicated for relative bases.
+     */
+    protected request(path: string, init?: RequestInit): Promise<unknown>;
+    list(query: CrudQuery<T>): Promise<CrudPage<T>>;
+    create(draft: CrudDraft<T>): Promise<T>;
+    update(id: T[K], draft: CrudDraft<T>): Promise<T>;
+    remove(id: T[K]): Promise<void>;
+}

package/dist/core/StaticDataSource.d.ts

@@ -0,0 +1,20 @@
+import { InMemoryDataSource } from './InMemoryDataSource';
+import { IdGenerator } from './types';
+/**
+ * A source over an in-process array, for fixtures, demos and tests.
+ *
+ * The collection is instance state, seeded once from the array passed to the
+ * constructor and never re-read from it. That is the fix for the old
+ * closure-factory behaviour: identity of the caller's array no longer
+ * controls the dataset's lifetime, so passing an inline literal from a
+ * component no longer discards every created and edited row when the parent
+ * happens to re-render.
+ *
+ * The seed array is copied, so mutations never write back to the caller's data.
+ */
+export declare class StaticDataSource<T extends object, K extends keyof T> extends InMemoryDataSource<T, K> {
+    private records;
+    constructor(seed: readonly T[], key: K, generateId?: IdGenerator<T, K>);
+    protected read(): readonly T[];
+    protected write(records: readonly T[]): void;
+}

package/dist/core/identity.d.ts

@@ -0,0 +1,28 @@
+import { IdGenerator } from './types';
+/**
+ * Fresh RFC-4122 v4 identifier.
+ *
+ * `crypto.randomUUID` needs a secure context and is absent in some test
+ * environments, so this falls back to `getRandomValues` and, failing that,
+ * to `Math.random`. The fallback is for uniqueness within a client-side
+ * dataset, not for anything security-bearing.
+ */
+declare const randomUuid: () => string;
+/**
+ * Default identity policy for in-memory sources.
+ *
+ * Chooses from the *runtime type of the existing keys* rather than coercing
+ * them to numbers. Coercion was the old bug: `Number('a3f9-...')` is `NaN`,
+ * `|| 0` collapsed it to `0`, and every created row came back as `1` -
+ * duplicate keys, and `update`/`remove` then resolving to the wrong record.
+ *
+ * - numeric keys      -> highest + 1
+ * - digit-like strings -> highest + 1, kept as a string
+ * - any other string  -> a fresh UUID
+ * - empty dataset     -> `1`, matching the previous behaviour for the common case
+ *
+ * Mixed or non-primitive key types cannot be continued safely, so those throw
+ * rather than silently colliding. Pass an explicit generator for those.
+ */
+export declare const defaultIdGenerator: <T, K extends keyof T>(key: K) => IdGenerator<T, K>;
+export { randomUuid };

package/dist/core/inMemoryQuery.d.ts

@@ -0,0 +1,26 @@
+import { CrudFilters, CrudPage, CrudQuery, CrudSort } from './types';
+/**
+ * Apply filters to an in-memory collection.
+ *
+ * Filters whose value is undefined, null or the empty string are ignored, so
+ * a cleared search box does not exclude everything. A record missing the
+ * filtered field never matches.
+ */
+export declare const filterRecords: <T>(records: readonly T[], filters?: CrudFilters<T>) => readonly T[];
+/**
+ * Apply an ordered list of sort instructions.
+ *
+ * Earlier entries take precedence; later ones break ties. Missing values sort
+ * last in both directions - they carry no ordering information, so surfacing
+ * them ahead of real data in one direction would be arbitrary.
+ */
+export declare const sortRecords: <T>(records: readonly T[], sort?: readonly CrudSort<T>[]) => readonly T[];
+/** Take the requested page. Pages are 1-based; out-of-range pages yield an empty slice. */
+export declare const paginateRecords: <T>(records: readonly T[], page: number, pageSize: number) => readonly T[];
+/**
+ * The shared filter-then-sort-then-paginate pipeline.
+ *
+ * Every strategy backed by a local collection routes through this, so their
+ * querying behaviour cannot drift apart.
+ */
+export declare const queryRecords: <T>(records: readonly T[], query: CrudQuery<T>) => CrudPage<T>;

package/dist/core/index.d.ts

@@ -0,0 +1,11 @@
+export type { CrudDataSource, CrudDraft, CrudFilters, CrudFilterValue, CrudPage, CrudQuery, CrudSort, IdGenerator, SortDirection, } from './types';
+export { defaultIdGenerator, randomUuid } from './identity';
+export { filterRecords, paginateRecords, queryRecords, sortRecords } from './inMemoryQuery';
+export { InMemoryDataSource } from './InMemoryDataSource';
+export { StaticDataSource } from './StaticDataSource';
+export { LocalStorageDataSource } from './LocalStorageDataSource';
+export type { Timestamped } from './LocalStorageDataSource';
+export { RestDataSource, RestError } from './RestDataSource';
+export type { RestDataSourceOptions, RestEndpoints, RestMethods, RestParamNames, } from './RestDataSource';
+export { CustomDataSource, UnsupportedOperationError } from './CustomDataSource';
+export type { CrudOperations } from './CustomDataSource';

package/dist/core/types.d.ts

@@ -0,0 +1,86 @@
+/**
+ * The core data-access contract every CRUD strategy implements.
+ *
+ * `T` is the record shape and `K` the property holding its identity, so
+ * `T[K]` is the precise type of an id throughout - never `any`, never a
+ * widened `string | number`.
+ */
+/** Sort direction, matching the vocabulary ProTable reports. */
+export type SortDirection = 'ascend' | 'descend';
+/** One sort instruction. Queries carry an ordered list to support multi-sort. */
+export interface CrudSort<T> {
+    /** The property to order by. */
+    readonly field: keyof T;
+    /** Ascending or descending. */
+    readonly direction: SortDirection;
+}
+/**
+ * A value a column can be filtered by.
+ *
+ * Deliberately narrow: filters arrive from form inputs and query strings, so
+ * this is the complete set of things a user can actually express. Anything
+ * richer belongs in a custom data source.
+ */
+export type CrudFilterValue = string | number | boolean;
+/** Field-keyed filters. Absent keys are unfiltered. */
+export type CrudFilters<T> = {
+    readonly [P in keyof T]?: CrudFilterValue;
+};
+/** A complete read request: which slice, in what order, matching what. */
+export interface CrudQuery<T> {
+    /** 1-based, matching ProTable's `current`. */
+    readonly page: number;
+    /** Rows per page. */
+    readonly pageSize: number;
+    /** Ordered sort instructions; earlier entries take precedence. */
+    readonly sort?: readonly CrudSort<T>[];
+    /** Field-keyed filters. Absent keys are unfiltered. */
+    readonly filters?: CrudFilters<T>;
+}
+/** One page of results plus the total matching the filters (not the page size). */
+export interface CrudPage<T> {
+    /** The records on this page. */
+    readonly items: readonly T[];
+    /** Records matching the filters, across all pages. */
+    readonly total: number;
+}
+/**
+ * A record being written.
+ *
+ * Partial because the identity is assigned by the source on create, and an
+ * update legitimately touches a subset of fields.
+ */
+export type CrudDraft<T> = Partial<T>;
+/**
+ * Produces the identity for a newly created record.
+ *
+ * Receives the existing records so a strategy can derive the next value
+ * (max + 1, a fresh UUID, a sequence). Supplying one replaces the built-in
+ * policy entirely.
+ */
+export type IdGenerator<T, K extends keyof T> = (existing: readonly T[]) => T[K];
+/**
+ * The interface every strategy implements: static fixtures, REST,
+ * localStorage, or a consumer's own.
+ *
+ * Implementations own their storage and lifetime. They are plain objects -
+ * no React involvement - so each is unit-testable without a renderer.
+ */
+export interface CrudDataSource<T, K extends keyof T> {
+    /** Read one page. Implementations must apply filters before paginating. */
+    list(query: CrudQuery<T>): Promise<CrudPage<T>>;
+    /** Persist a new record and return it as stored, identity included. */
+    create(draft: CrudDraft<T>): Promise<T>;
+    /** Merge `draft` into the record at `id` and return the stored result. */
+    update(id: T[K], draft: CrudDraft<T>): Promise<T>;
+    /** Delete the record at `id`. */
+    remove(id: T[K]): Promise<void>;
+    /**
+     * Every record matching the query, ignoring pagination.
+     *
+     * Exists so export can cover the whole result set rather than the current
+     * page. Optional: a source over an unbounded remote collection may have no
+     * safe way to honour it, and callers must degrade to `list` when absent.
+     */
+    listAll?(query: Omit<CrudQuery<T>, 'page' | 'pageSize'>): Promise<readonly T[]>;
+}

package/dist/en_US-D3Kl6g3n.cjs

@@ -0,0 +1 @@
+var e={actions:`Actions`,edit:`Edit`,delete:`Delete`,create:`New`,refresh:`Refresh`,createTitle:`Create Item`,editTitle:`Edit Item`,ok:`OK`,cancel:`Cancel`,requiredField:e=>`${e} is required`,confirmDeleteTitle:`Are you sure?`,confirmDeleteContent:`This action cannot be undone.`,confirmDeleteOk:`Yes, Delete`,confirmBulkDeleteTitle:e=>`Delete ${e} items?`,confirmBulkDeleteOk:`Yes, Delete All`,deleteSelected:e=>`Delete Selected (${e})`,selectItemsToDelete:`Please select items to delete`,bulkDeleteSuccess:e=>`Deleted ${e} items`,bulkDeletePartial:(e,t,n)=>`Deleted ${e} of ${t}. ${n} failed.`,exportAll:e=>`Export all as ${e}`,exportPage:e=>`Export page as ${e}`,nothingToExport:`Nothing to export`,exportFailed:e=>`Export failed: ${e}`,createSuccess:`Created successfully`,updateSuccess:`Updated successfully`,deleteSuccess:`Deleted successfully`,loading:`Loading CRUD table…`,yes:`Yes`,no:`No`,empty:`-`,selectPlaceholder:e=>`Select ${e.toLowerCase()}`,tagsPlaceholder:`Type and press enter`,invalidEmail:`Please enter a valid email`,invalidUrl:`Please enter a valid URL`,invalidImageUrl:`Please enter a valid image URL`,invalidJson:`Please enter valid JSON`};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});

package/dist/en_US-DGCMDOdX.js

@@ -0,0 +1,41 @@
+//#region lib/locale/en_US.ts
+var e = {
+	actions: "Actions",
+	edit: "Edit",
+	delete: "Delete",
+	create: "New",
+	refresh: "Refresh",
+	createTitle: "Create Item",
+	editTitle: "Edit Item",
+	ok: "OK",
+	cancel: "Cancel",
+	requiredField: (e) => `${e} is required`,
+	confirmDeleteTitle: "Are you sure?",
+	confirmDeleteContent: "This action cannot be undone.",
+	confirmDeleteOk: "Yes, Delete",
+	confirmBulkDeleteTitle: (e) => `Delete ${e} items?`,
+	confirmBulkDeleteOk: "Yes, Delete All",
+	deleteSelected: (e) => `Delete Selected (${e})`,
+	selectItemsToDelete: "Please select items to delete",
+	bulkDeleteSuccess: (e) => `Deleted ${e} items`,
+	bulkDeletePartial: (e, t, n) => `Deleted ${e} of ${t}. ${n} failed.`,
+	exportAll: (e) => `Export all as ${e}`,
+	exportPage: (e) => `Export page as ${e}`,
+	nothingToExport: "Nothing to export",
+	exportFailed: (e) => `Export failed: ${e}`,
+	createSuccess: "Created successfully",
+	updateSuccess: "Updated successfully",
+	deleteSuccess: "Deleted successfully",
+	loading: "Loading CRUD table…",
+	yes: "Yes",
+	no: "No",
+	empty: "-",
+	selectPlaceholder: (e) => `Select ${e.toLowerCase()}`,
+	tagsPlaceholder: "Type and press enter",
+	invalidEmail: "Please enter a valid email",
+	invalidUrl: "Please enter a valid URL",
+	invalidImageUrl: "Please enter a valid image URL",
+	invalidJson: "Please enter valid JSON"
+};
+//#endregion
+export { e as t };

package/dist/exportData.cjs

@@ -1,13 +1,13 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=(e,t)=>{let n=t.filter(e=>e.fieldType!==`option`&&e.dataIndex),r=n.map(e=>String(e.title||e.dataIndex)),i=e.map(e=>n.map(t=>{let n=e[t.dataIndex];return n==null?``:t.fieldType===`boolean`?n?`Yes`:`No`:t.fieldType===`date`?String(n):t.fieldType===`enum`&&t.enumOptions&&t.enumOptions[n]?.text||String(n)}));return[r.map(e=>`"${e}"`).join(`,`),...i.map(e=>e.map(e=>`"${String(e).replace(/"/g,`""`)}"`).join(`,`))].join(`
-`)},t=(e,t,n)=>{let r=new Blob([e],{type:n}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=t,document.body.appendChild(a),a.click(),document.body.removeChild(a),URL.revokeObjectURL(i)},n=n=>{let{data:r,columns:i,filename:a=`export`}=n;t(e(r,i),`${a}.csv`,`text/csv;charset=utf-8;`)},r=e=>{let{data:n,filename:r=`export`}=e;t(JSON.stringify(n,null,2),`${r}.json`,`application/json`)},i=e=>{let{data:n,columns:r,filename:i=`export`}=e,a=r.filter(e=>e.fieldType!==`option`&&e.dataIndex),o=a.map(e=>String(e.title||e.dataIndex)),s=n.map(e=>a.map(t=>{let n=e[t.dataIndex];return n==null?``:t.fieldType===`boolean`?n?`Yes`:`No`:t.fieldType===`enum`&&t.enumOptions&&t.enumOptions[n]?.text||String(n)}));t((()=>{let e=e=>e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&apos;`);return`<?xml version="1.0" encoding="UTF-8"?>
-<?xml-stylesheet type="text/xsl" href="stylesheet.xsl"?>
-<workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet">
-  <sheets>
-    <sheet name="Export">
-      <table>
-        <row>${o.map(t=>`<c t="inlineStr"><is><t>${e(t)}</t></is></c>`).join(``)}</row>
-        ${s.map(t=>`<row>${t.map(t=>`<c t="inlineStr"><is><t>${e(String(t))}</t></is></c>`).join(``)}</row>`).join(``)}
-      </table>
-    </sheet>
-  </sheets>
-</workbook>`})(),`${i}.xls`,`application/vnd.ms-excel`)},a=e=>{let{format:t=`csv`}=e;switch(t){case`csv`:n(e);break;case`json`:r(e);break;case`xlsx`:i(e);break;default:n(e)}},o=async(e,t,n=`export`,r=`csv`)=>{try{a({data:await e(),columns:t,filename:n,format:r})}catch(e){throw console.error(`Export failed:`,e),e}};exports.default=a,exports.exportData=a,exports.exportAllData=o,exports.exportToCSV=n,exports.exportToJSON=r,exports.exportToXLSX=i;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});var e=[`=`,`+`,`-`,`@`,`	`,`\r`],t=/^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/,n=n=>{if(n===``)return n;let r=n.trimStart();if(t.test(r))return n;let i=t=>t!==``&&e.includes(t[0]);return i(n)||i(r)?`'${n}`:n},r=(e,t)=>{let r=t.filter(e=>e.fieldType!==`option`&&e.dataIndex),i=r.map(e=>String(e.title||e.dataIndex)),a=e.map(e=>r.map(t=>{let n=e[t.dataIndex];return n==null?``:t.fieldType===`boolean`?n?`Yes`:`No`:t.fieldType===`date`?String(n):t.fieldType===`enum`&&t.enumOptions&&t.enumOptions[n]?.text||String(n)})),o=e=>`"${n(e).replace(/"/g,`""`)}"`;return[i.map(o).join(`,`),...a.map(e=>e.map(e=>o(String(e))).join(`,`))].join(`
+`)},i=(e,t,n)=>{let r=new Blob([e],{type:n}),i=URL.createObjectURL(r),a=document.createElement(`a`);a.href=i,a.download=t,document.body.appendChild(a),a.click(),document.body.removeChild(a),URL.revokeObjectURL(i)},a=e=>{let{data:t,columns:n,filename:a=`export`}=e;i(r(t,n),`${a}.csv`,`text/csv;charset=utf-8;`)},o=e=>{let{data:t,filename:n=`export`}=e;i(JSON.stringify(t,null,2),`${n}.json`,`application/json`)},s=e=>{let{data:t,columns:n,filename:r=`export`}=e,a=n.filter(e=>e.fieldType!==`option`&&e.dataIndex),o=a.map(e=>String(e.title||e.dataIndex)),s=t.map(e=>a.map(t=>{let n=e[t.dataIndex];return n==null?``:t.fieldType===`boolean`?n?`Yes`:`No`:t.fieldType===`enum`&&t.enumOptions?t.enumOptions[n]?.text||String(n):typeof n==`number`?n:String(n)})),c=e=>e.replace(/&/g,`&amp;`).replace(/</g,`&lt;`).replace(/>/g,`&gt;`).replace(/"/g,`&quot;`).replace(/'/g,`&apos;`),l=e=>`<Cell><Data ss:Type="${typeof e==`number`?`Number`:`String`}">${typeof e==`number`?String(e):c(e)}</Data></Cell>`;i(`<?xml version="1.0"?>
+<?mso-application progid="Excel.Sheet"?>
+<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
+ xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet">
+ <Worksheet ss:Name="Export">
+  <Table>
+${`<Row>${o.map(e=>l(e)).join(``)}</Row>`}
+${s.map(e=>`<Row>${e.map(e=>l(e)).join(``)}</Row>`).join(`
+`)}
+  </Table>
+ </Worksheet>
+</Workbook>`,`${r}.xls`,`application/vnd.ms-excel`)},c=e=>{let{format:t=`csv`}=e;switch(t){case`csv`:a(e);break;case`json`:o(e);break;case`excel`:s(e);break;default:a(e)}},l=async(e,t,n=`export`,r=`csv`)=>{try{c({data:await e(),columns:t,filename:n,format:r})}catch(e){throw console.error(`Export failed:`,e),e}};exports.exportAllData=l,exports.exportData=c,exports.exportToCSV=a,exports.exportToExcel=s,exports.exportToJSON=o;

package/dist/exportData.js

@@ -1,56 +1,65 @@
 //#region lib/utils/exportData.ts
-var e = (e, t) => {
-	let n = t.filter((e) => e.fieldType !== "option" && e.dataIndex), r = n.map((e) => String(e.title || e.dataIndex)), i = e.map((e) => n.map((t) => {
+var e = [
+	"=",
+	"+",
+	"-",
+	"@",
+	"	",
+	"\r"
+], t = /^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/, n = (n) => {
+	if (n === "") return n;
+	let r = n.trimStart();
+	if (t.test(r)) return n;
+	let i = (t) => t !== "" && e.includes(t[0]);
+	return i(n) || i(r) ? `'${n}` : n;
+}, r = (e, t) => {
+	let r = t.filter((e) => e.fieldType !== "option" && e.dataIndex), i = r.map((e) => String(e.title || e.dataIndex)), a = e.map((e) => r.map((t) => {
 		let n = e[t.dataIndex];
 		return n == null ? "" : t.fieldType === "boolean" ? n ? "Yes" : "No" : t.fieldType === "date" ? String(n) : t.fieldType === "enum" && t.enumOptions && t.enumOptions[n]?.text || String(n);
-	}));
-	return [r.map((e) => `"${e}"`).join(","), ...i.map((e) => e.map((e) => `"${String(e).replace(/"/g, "\"\"")}"`).join(","))].join("\n");
-}, t = (e, t, n) => {
+	})), o = (e) => `"${n(e).replace(/"/g, "\"\"")}"`;
+	return [i.map(o).join(","), ...a.map((e) => e.map((e) => o(String(e))).join(","))].join("\n");
+}, i = (e, t, n) => {
 	let r = new Blob([e], { type: n }), i = URL.createObjectURL(r), a = document.createElement("a");
 	a.href = i, a.download = t, document.body.appendChild(a), a.click(), document.body.removeChild(a), URL.revokeObjectURL(i);
-}, n = (n) => {
-	let { data: r, columns: i, filename: a = "export" } = n;
-	t(e(r, i), `${a}.csv`, "text/csv;charset=utf-8;");
-}, r = (e) => {
-	let { data: n, filename: r = "export" } = e;
-	t(JSON.stringify(n, null, 2), `${r}.json`, "application/json");
-}, i = (e) => {
-	let { data: n, columns: r, filename: i = "export" } = e, a = r.filter((e) => e.fieldType !== "option" && e.dataIndex), o = a.map((e) => String(e.title || e.dataIndex)), s = n.map((e) => a.map((t) => {
-		let n = e[t.dataIndex];
-		return n == null ? "" : t.fieldType === "boolean" ? n ? "Yes" : "No" : t.fieldType === "enum" && t.enumOptions && t.enumOptions[n]?.text || String(n);
-	}));
-	t((() => {
-		let e = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
-		return `<?xml version="1.0" encoding="UTF-8"?>
-<?xml-stylesheet type="text/xsl" href="stylesheet.xsl"?>
-<workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet">
-  <sheets>
-    <sheet name="Export">
-      <table>
-        <row>${o.map((t) => `<c t="inlineStr"><is><t>${e(t)}</t></is></c>`).join("")}</row>
-        ${s.map((t) => `<row>${t.map((t) => `<c t="inlineStr"><is><t>${e(String(t))}</t></is></c>`).join("")}</row>`).join("")}
-      </table>
-    </sheet>
-  </sheets>
-</workbook>`;
-	})(), `${i}.xls`, "application/vnd.ms-excel");
 }, a = (e) => {
+	let { data: t, columns: n, filename: a = "export" } = e;
+	i(r(t, n), `${a}.csv`, "text/csv;charset=utf-8;");
+}, o = (e) => {
+	let { data: t, filename: n = "export" } = e;
+	i(JSON.stringify(t, null, 2), `${n}.json`, "application/json");
+}, s = (e) => {
+	let { data: t, columns: n, filename: r = "export" } = e, a = n.filter((e) => e.fieldType !== "option" && e.dataIndex), o = a.map((e) => String(e.title || e.dataIndex)), s = t.map((e) => a.map((t) => {
+		let n = e[t.dataIndex];
+		return n == null ? "" : t.fieldType === "boolean" ? n ? "Yes" : "No" : t.fieldType === "enum" && t.enumOptions ? t.enumOptions[n]?.text || String(n) : typeof n == "number" ? n : String(n);
+	})), c = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;"), l = (e) => `<Cell><Data ss:Type="${typeof e == "number" ? "Number" : "String"}">${typeof e == "number" ? String(e) : c(e)}</Data></Cell>`;
+	i(`<?xml version="1.0"?>
+<?mso-application progid="Excel.Sheet"?>
+<Workbook xmlns="urn:schemas-microsoft-com:office:spreadsheet"
+ xmlns:ss="urn:schemas-microsoft-com:office:spreadsheet">
+ <Worksheet ss:Name="Export">
+  <Table>
+${`<Row>${o.map((e) => l(e)).join("")}</Row>`}
+${s.map((e) => `<Row>${e.map((e) => l(e)).join("")}</Row>`).join("\n")}
+  </Table>
+ </Worksheet>
+</Workbook>`, `${r}.xls`, "application/vnd.ms-excel");
+}, c = (e) => {
 	let { format: t = "csv" } = e;
 	switch (t) {
 		case "csv":
-			n(e);
+			a(e);
 			break;
 		case "json":
-			r(e);
+			o(e);
 			break;
-		case "xlsx":
-			i(e);
+		case "excel":
+			s(e);
 			break;
-		default: n(e);
+		default: a(e);
 	}
-}, o = async (e, t, n = "export", r = "csv") => {
+}, l = async (e, t, n = "export", r = "csv") => {
 	try {
-		a({
+		c({
 			data: await e(),
 			columns: t,
 			filename: n,
@@ -61,4 +70,4 @@ var e = (e, t) => {
 	}
 };
 //#endregion
-export { a as default, a as exportData, o as exportAllData, n as exportToCSV, r as exportToJSON, i as exportToXLSX };
+export { l as exportAllData, c as exportData, a as exportToCSV, s as exportToExcel, o as exportToJSON };

package/dist/fields/registry.d.ts

@@ -0,0 +1,38 @@
+import { ProColumns } from '@ant-design/pro-components';
+import { FormRule } from 'antd';
+import { EnumOption, FieldColumn } from './types';
+import { CrudTableLocale } from '../locale/types';
+/** Every column type CrudTable understands. */
+export type FieldType = 'string' | 'number' | 'date' | 'boolean' | 'enum' | 'custom' | 'textarea' | 'email' | 'url' | 'password' | 'money' | 'percent' | 'rating' | 'progress' | 'time' | 'dateRange' | 'tags' | 'image' | 'color' | 'json';
+/**
+ * A self-contained description of one field type: how it renders in the
+ * table, which control edits it in the modal form, and how values are
+ * converted between record shape and form shape. Adding a new column
+ * type to CrudTable means adding exactly one entry here.
+ */
+export interface FieldTypeDefinition {
+    /** Extra ProColumns props merged over the base column (valueType, render, ...). */
+    column?: (col: FieldColumn, locale: CrudTableLocale) => Partial<ProColumns<Record<PropertyKey, unknown>>>;
+    /** The antd control used in the create/edit modal. Return null for "no form field". */
+    formControl: (col: FieldColumn, disabled: boolean, locale: CrudTableLocale) => React.ReactNode | null;
+    /** Convert a record value into what the form control expects. */
+    toFormValue?: (value: unknown) => unknown;
+    /** Convert the submitted form value back into the record shape. */
+    fromFormValue?: (value: unknown) => unknown;
+    /** Validation rules implied by the type itself (merged before user rules). */
+    rules?: (col: FieldColumn, locale: CrudTableLocale) => FormRule[];
+    /** Form.Item valuePropName override (e.g. 'checked' for Switch). */
+    valuePropName?: string;
+}
+/**
+ * Every field type, keyed by name.
+ *
+ * Adding a column type to CrudTable means adding one entry here; nothing else
+ * dispatches on `fieldType`.
+ */
+export declare const fieldRegistry: Record<FieldType, FieldTypeDefinition>;
+/** Look up a field type, falling back to `string` so every column gets a form control. */
+export declare const getFieldDefinition: (fieldType?: FieldType) => FieldTypeDefinition;
+/** The strings a field definition falls back to when a caller passes none. */
+export declare const defaultFieldLocale: CrudTableLocale;
+export type { EnumOption, FieldColumn };

package/dist/fields/types.d.ts

@@ -0,0 +1,29 @@
+import { FieldType } from './registry';
+/** One selectable value for an `enum` column. */
+export interface EnumOption {
+    /** Label shown in the cell and in the select control. */
+    text: string;
+    /** antd Tag colour used when rendering the cell. */
+    color?: string;
+}
+/**
+ * The slice of a column definition the field registry reads.
+ *
+ * Structural rather than generic on purpose: the registry dispatches across
+ * twenty field types with unrelated value shapes, so a single definition
+ * cannot be parameterised over any one record type. `unknown` here is the
+ * strict choice, not a lax one - it forces every renderer to narrow before
+ * using a value, which `any` would not.
+ */
+export interface FieldColumn {
+    /** The record property this column reads. */
+    dataIndex: PropertyKey;
+    /** Column header, also used as the form label. */
+    title: string;
+    /** Which registry entry renders and edits this column. */
+    fieldType?: FieldType;
+    /** Selectable values, for `enum` columns. */
+    enumOptions?: Record<string, EnumOption>;
+    /** Cell renderer for `custom` columns. */
+    customRender?: (value: unknown, record: Record<PropertyKey, unknown>) => React.ReactNode;
+}