antd-crud-table 0.7.0 → 0.8.0

package/dist/{useCrudTable-DxjnXVlQ.js → useCrudTable-BVXxakfl.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./en_US-DGCMDOdX.js";
+import { t as e } from "./en_US-DghHhwRq.js";
 import { message as t } from "antd";
 import { useCallback as n, useMemo as r, useRef as i, useState as a } from "react";
 //#region lib/core/identity.ts
@@ -138,56 +138,64 @@ var o = () => {
 			updatedAt: n
 		} : { updatedAt: n };
 	}
-}, v = {
+}, v = (e, t) => {
+	let n = t.toString();
+	return n === "" ? e : `${e}${e.includes("?") ? "&" : "?"}${n}`;
+}, y = {
 	list: "/list",
 	create: "/create",
 	update: "/update",
 	remove: "/delete"
-}, y = {
+}, b = {
 	page: "current",
 	pageSize: "pageSize",
 	sortBy: "sortBy",
 	sortOrder: "sortOrder"
-}, b = {
+}, x = {
 	create: "POST",
 	update: "PUT",
 	remove: "DELETE"
-}, x = class extends Error {
+}, S = 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;
 	}
-}, S = class {
+}, C = class {
 	baseUrl;
 	endpoints;
 	paramNames;
 	methods;
 	headers;
+	query;
+	init;
+	configureRequest;
 	serializeRequest;
 	parseResponse;
+	parseRecord;
 	fetchImpl;
 	constructor(e = {}) {
 		this.baseUrl = e.baseUrl ?? "", this.endpoints = {
-			...v,
+			...y,
 			...e.endpoints
 		}, this.paramNames = {
-			...y,
+			...b,
 			...e.paramNames
 		}, this.methods = {
-			...b,
+			...x,
 			...e.methods
-		}, this.headers = e.headers ?? {}, this.serializeRequest = e.serializeRequest ?? ((e) => e), this.parseResponse = e.parseResponse, this.fetchImpl = e.fetchImpl ?? globalThis.fetch.bind(globalThis);
+		}, this.headers = e.headers ?? {}, this.query = e.query ?? {}, this.init = e.init ?? {}, this.configureRequest = e.configureRequest, this.serializeRequest = e.serializeRequest ?? ((e) => e), this.parseResponse = e.parseResponse, this.parseRecord = e.parseRecord, 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));
 	}
+	serializeFilters(e, t) {
+		for (let [n, r] of Object.entries(e ?? {})) r != null && r !== "" && t.set(n, String(r));
+	}
 	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()}`;
+		return t.set(this.paramNames.page, String(e.page)), t.set(this.paramNames.pageSize, String(e.pageSize)), this.serializeSort(e.sort, t), this.serializeFilters(e.filters, t), v(this.endpoints.list, t);
 	}
 	buildRecordPath(e, t) {
 		return `${e}/${encodeURIComponent(String(t))}`;
@@ -210,44 +218,73 @@ var o = () => {
 		}
 		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,
+	async request(e, t, n = {}) {
+		let r = await this.configureRequest?.(t) ?? {}, i = new URLSearchParams();
+		for (let [e, t] of Object.entries({
+			...this.query,
+			...r.query
+		})) i.set(e, String(t));
+		let a = v(`${this.baseUrl}${e}`, i), o = await this.fetchImpl(a, {
+			...this.init,
+			...r.init,
+			...n,
+			method: r.method ?? n.method,
 			headers: {
 				"Content-Type": "application/json",
 				...this.headers,
-				...t.headers
+				...r.headers,
+				...n.headers
 			}
 		});
-		if (!r.ok) throw new x(r.status, await r.text().catch(() => ""), n);
-		if (r.status === 204) return;
-		let i = await r.text();
-		return i === "" ? void 0 : JSON.parse(i);
+		if (!o.ok) throw new S(o.status, await o.text().catch(() => ""), a);
+		if (o.status === 204) return;
+		let s = await o.text();
+		return s === "" ? void 0 : JSON.parse(s);
+	}
+	toRecord(e, t) {
+		return this.parseRecord ? this.parseRecord(e, t) : e;
 	}
 	async list(e) {
-		return this.toPage(await this.request(this.buildListUrl(e)));
+		let t = {
+			operation: "list",
+			query: e
+		};
+		return this.toPage(await this.request(this.buildListUrl(e), t));
 	}
 	async create(e) {
-		return await this.request(this.endpoints.create, {
+		let t = {
+			operation: "create",
+			draft: e
+		}, n = await this.request(this.endpoints.create, t, {
 			method: this.methods.create,
-			body: JSON.stringify(this.serializeRequest(e))
+			body: JSON.stringify(this.serializeRequest(e, t))
 		});
+		return this.toRecord(n, t);
 	}
 	async update(e, t) {
-		return await this.request(this.buildRecordPath(this.endpoints.update, e), {
+		let n = {
+			operation: "update",
+			id: e,
+			draft: t
+		}, r = await this.request(this.buildRecordPath(this.endpoints.update, e), n, {
 			method: this.methods.update,
-			body: JSON.stringify(this.serializeRequest(t))
+			body: JSON.stringify(this.serializeRequest(t, n))
 		});
+		return this.toRecord(r, n);
 	}
 	async remove(e) {
-		await this.request(this.buildRecordPath(this.endpoints.remove, e), { method: this.methods.remove });
+		let t = {
+			operation: "remove",
+			id: e
+		};
+		await this.request(this.buildRecordPath(this.endpoints.remove, e), t, { method: this.methods.remove });
 	}
-}, C = class extends Error {
+}, w = 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;
 	}
-}, w = class {
+}, T = class {
 	operations;
 	constructor(e) {
 		this.operations = e;
@@ -256,40 +293,40 @@ var o = () => {
 		return typeof this.operations[e] == "function";
 	}
 	async list(e) {
-		if (!this.operations.list) throw new C("list");
+		if (!this.operations.list) throw new w("list");
 		return this.operations.list(e);
 	}
 	async listAll(e) {
 		if (this.operations.listAll) return this.operations.listAll(e);
-		throw new C("listAll");
+		throw new w("listAll");
 	}
 	async create(e) {
-		if (!this.operations.create) throw new C("create");
+		if (!this.operations.create) throw new w("create");
 		return this.operations.create(e);
 	}
 	async update(e, t) {
-		if (!this.operations.update) throw new C("update");
+		if (!this.operations.update) throw new w("update");
 		return this.operations.update(e, t);
 	}
 	async remove(e) {
-		if (!this.operations.remove) throw new C("remove");
+		if (!this.operations.remove) throw new w("remove");
 		return this.operations.remove(e);
 	}
-}, T = (e) => e instanceof Error ? e : Error(typeof e == "string" ? e : "Unknown error", { cause: e }), E = (e, t) => {
+}, E = (e) => e instanceof Error ? e : Error(typeof e == "string" ? e : "Unknown error", { cause: e }), D = (e, t) => {
 	if ("dataSource" in t) return t.dataSource;
-	if ("operations" in t) return new w(t.operations);
+	if ("operations" in t) return new T(t.operations);
 	if ("storageKey" in t) return new _(t.storageKey, e, t.initialData ?? [], t.generateId);
 	if ("staticData" in t) return new g(t.staticData, e, t.generateId);
-	if ("api" in t) return new S(t.api);
+	if ("api" in t) return new C(t.api);
 	throw Error("useCrudTable: supply exactly one of `staticData`, `api`, `storageKey`, `operations` or `dataSource`.");
-}, D = (o, s) => {
+}, O = (o, s) => {
 	let c = i(void 0), { defaultPageSize: l = 10, optimisticUpdates: u = !1, refreshAfterMutation: d = !0, notifications: f = !0 } = s, p = r(() => s.locale ? {
 		...e,
 		...s.locale
 	} : e, [s.locale]), m = i(s);
 	m.current = s;
 	let h = i(null);
-	h.current === null && (h.current = E(o, s));
+	h.current === null && (h.current = D(o, s));
 	let g = h.current, [_, v] = a({
 		loading: !1,
 		error: null,
@@ -319,7 +356,7 @@ var o = () => {
 				loading: !1
 			}));
 		} catch (e) {
-			let t = T(e);
+			let t = E(e);
 			v((e) => ({
 				...e,
 				loading: !1,
@@ -348,7 +385,7 @@ var o = () => {
 		u,
 		d,
 		C
-	]), D = n(async (e) => {
+	]), T = n(async (e) => {
 		v((e) => ({
 			...e,
 			loading: !0
@@ -365,7 +402,7 @@ var o = () => {
 			return v((e) => ({
 				...e,
 				loading: !1
-			})), x("create", T(e)), null;
+			})), x("create", E(e)), null;
 		}
 	}, [
 		g,
@@ -389,7 +426,7 @@ var o = () => {
 			return v((e) => ({
 				...e,
 				loading: !1
-			})), x("update", T(e)), null;
+			})), x("update", E(e)), null;
 		}
 	}, [
 		g,
@@ -414,7 +451,7 @@ var o = () => {
 			return v((e) => ({
 				...e,
 				loading: !1
-			})), x("delete", T(e)), !1;
+			})), x("delete", E(e)), !1;
 		}
 	}, [
 		g,
@@ -437,7 +474,7 @@ var o = () => {
 	}, []);
 	return r(() => ({
 		refresh: C,
-		create: D,
+		create: T,
 		update: O,
 		remove: k,
 		dataSource: g,
@@ -447,7 +484,7 @@ var o = () => {
 		actionRef: c
 	}), [
 		C,
-		D,
+		T,
 		O,
 		k,
 		g,
@@ -457,4 +494,4 @@ var o = () => {
 	]);
 };
 //#endregion
-export { S as a, g as c, p as d, m as f, o as h, C as i, h as l, c as m, D as n, x as o, f as p, w as r, _ as s, T as t, d as u };
+export { C as a, g as c, p as d, m as f, o as h, w as i, h as l, c as m, O as n, S as o, f as p, T as r, _ as s, E as t, d as u };

package/dist/useCrudTable-Ex2Imgll.cjs

@@ -0,0 +1 @@
+const e=require("./en_US-Q8nDeJhg.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=(e,t)=>{let n=t.toString();return n===``?e:`${e}${e.includes(`?`)?`&`:`?`}${n}`},g={list:`/list`,create:`/create`,update:`/update`,remove:`/delete`},_={page:`current`,pageSize:`pageSize`,sortBy:`sortBy`,sortOrder:`sortOrder`},v={create:`POST`,update:`PUT`,remove:`DELETE`},y=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}},b=class{baseUrl;endpoints;paramNames;methods;headers;query;init;configureRequest;serializeRequest;parseResponse;parseRecord;fetchImpl;constructor(e={}){this.baseUrl=e.baseUrl??``,this.endpoints={...g,...e.endpoints},this.paramNames={..._,...e.paramNames},this.methods={...v,...e.methods},this.headers=e.headers??{},this.query=e.query??{},this.init=e.init??{},this.configureRequest=e.configureRequest,this.serializeRequest=e.serializeRequest??(e=>e),this.parseResponse=e.parseResponse,this.parseRecord=e.parseRecord,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))}serializeFilters(e,t){for(let[n,r]of Object.entries(e??{}))r!=null&&r!==``&&t.set(n,String(r))}buildListUrl(e){let t=new URLSearchParams;return t.set(this.paramNames.page,String(e.page)),t.set(this.paramNames.pageSize,String(e.pageSize)),this.serializeSort(e.sort,t),this.serializeFilters(e.filters,t),h(this.endpoints.list,t)}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,n={}){let r=await this.configureRequest?.(t)??{},i=new URLSearchParams;for(let[e,t]of Object.entries({...this.query,...r.query}))i.set(e,String(t));let a=h(`${this.baseUrl}${e}`,i),o=await this.fetchImpl(a,{...this.init,...r.init,...n,method:r.method??n.method,headers:{"Content-Type":`application/json`,...this.headers,...r.headers,...n.headers}});if(!o.ok)throw new y(o.status,await o.text().catch(()=>``),a);if(o.status===204)return;let s=await o.text();return s===``?void 0:JSON.parse(s)}toRecord(e,t){return this.parseRecord?this.parseRecord(e,t):e}async list(e){let t={operation:`list`,query:e};return this.toPage(await this.request(this.buildListUrl(e),t))}async create(e){let t={operation:`create`,draft:e},n=await this.request(this.endpoints.create,t,{method:this.methods.create,body:JSON.stringify(this.serializeRequest(e,t))});return this.toRecord(n,t)}async update(e,t){let n={operation:`update`,id:e,draft:t},r=await this.request(this.buildRecordPath(this.endpoints.update,e),n,{method:this.methods.update,body:JSON.stringify(this.serializeRequest(t,n))});return this.toRecord(r,n)}async remove(e){let t={operation:`remove`,id:e};await this.request(this.buildRecordPath(this.endpoints.remove,e),t,{method:this.methods.remove})}},x=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}},S=class{operations;constructor(e){this.operations=e}supports(e){return typeof this.operations[e]==`function`}async list(e){if(!this.operations.list)throw new x(`list`);return this.operations.list(e)}async listAll(e){if(this.operations.listAll)return this.operations.listAll(e);throw new x(`listAll`)}async create(e){if(!this.operations.create)throw new x(`create`);return this.operations.create(e)}async update(e,t){if(!this.operations.update)throw new x(`update`);return this.operations.update(e,t)}async remove(e){if(!this.operations.remove)throw new x(`remove`);return this.operations.remove(e)}},C=e=>e instanceof Error?e:Error(typeof e==`string`?e:`Unknown error`,{cause:e}),w=(e,t)=>{if(`dataSource`in t)return t.dataSource;if(`operations`in t)return new S(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 b(t.api);throw Error("useCrudTable: supply exactly one of `staticData`, `api`, `storageKey`, `operations` or `dataSource`.")},T=(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=w(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=C(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]),S=(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`,C(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`,C(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`,C(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:S,update:T,remove:E,dataSource:p,setPage:D,setPageSize:O,state:m,actionRef:a}),[b,S,T,E,p,D,O,m])};Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return b}}),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 x}}),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 T}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return c}});

package/dist/useCrudTable.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./useCrudTable-40jpmCkr.cjs");exports.toError=e.t,exports.useCrudTable=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./useCrudTable-Ex2Imgll.cjs");exports.toError=e.t,exports.useCrudTable=e.n;

package/dist/useCrudTable.js

@@ -1,2 +1,2 @@
-import { n as e, t } from "./useCrudTable-DxjnXVlQ.js";
+import { n as e, t } from "./useCrudTable-BVXxakfl.js";
 export { t as toError, e as useCrudTable };

package/dist/useLocalStorageCrud.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./useCrudTable-40jpmCkr.cjs");let t=require("react");var n=(n,r,i=[],a)=>{let o=e.n(n,{...a,storageKey:r,initialData:i}),{refresh:s}=o;return(0,t.useEffect)(()=>{s()},[]),o};exports.useLocalStorageCrud=n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./useCrudTable-Ex2Imgll.cjs");let t=require("react");var n=(n,r,i=[],a)=>{let o=e.n(n,{...a,storageKey:r,initialData:i}),{refresh:s}=o;return(0,t.useEffect)(()=>{s()},[]),o};exports.useLocalStorageCrud=n;

package/dist/useLocalStorageCrud.js

@@ -1,4 +1,4 @@
-import { n as e } from "./useCrudTable-DxjnXVlQ.js";
+import { n as e } from "./useCrudTable-BVXxakfl.js";
 import { useEffect as t } from "react";
 //#region lib/hooks/useLocalStorageCrud.ts
 var n = (n, r, i = [], a) => {

package/dist/utils/importData.d.ts

@@ -0,0 +1,130 @@
+import { FormRule } from 'antd';
+import { FieldType } from '../fields/registry';
+import { EnumOption } from '../fields/types';
+/** File formats the importer can read. */
+export type ImportFormat = 'csv' | 'xls' | 'xlsx';
+/**
+ * The column information the importer needs: how to match a header, how to
+ * coerce a cell, and how to validate the result.
+ */
+export interface ImportColumn {
+    /** Header text to match against, and the form label used in error messages. */
+    title: string;
+    /** The record property this column writes. */
+    dataIndex: string;
+    /** Drives value coercion (numbers, dates, enums, ...). */
+    fieldType?: FieldType;
+    /** Labels for `enum` columns, so an import accepts the exported label too. */
+    enumOptions?: Record<string, EnumOption>;
+    /** Resolved validation rules (registry rules + the column's own), as the form uses. */
+    rules?: FormRule[];
+}
+/** A file parsed into a header row and the data rows beneath it. */
+export interface ParsedTable {
+    /** The first row, treated as headers. */
+    headers: string[];
+    /** Every subsequent row, as raw strings. */
+    rows: string[][];
+}
+/**
+ * Header-to-column mapping: for each header position, the `dataIndex` it feeds,
+ * or `null` to ignore that column.
+ */
+export type ColumnMapping = (string | null)[];
+/** One data row prepared for creation. */
+export interface PreparedRow {
+    /** 1-based row number in the file body (excludes the header), for reporting. */
+    rowNumber: number;
+    /** The coerced record draft. */
+    record: Record<string, unknown>;
+    /** Per-field validation errors; empty when the row is valid. */
+    errors: {
+        field: string;
+        message: string;
+    }[];
+}
+/** The outcome of creating one prepared row. */
+export interface ImportRowOutcome {
+    rowNumber: number;
+    ok: boolean;
+    /** Failure reason: a validation summary or the create error message. */
+    error?: string;
+}
+/** The result of an import run. */
+export interface ImportResult {
+    /** Rows created successfully. */
+    created: number;
+    /** Rows that failed validation. */
+    invalid: number;
+    /** Rows that failed to create despite being valid. */
+    failed: number;
+    /** Per-row outcomes, in file order. */
+    outcomes: ImportRowOutcome[];
+}
+/**
+ * Parse CSV text into rows of string fields. Handles quoted fields, escaped
+ * quotes (`""`), embedded commas and newlines, `\r\n`/`\n` endings and a
+ * leading UTF-8 BOM.
+ */
+export declare const parseCsv: (text: string, delimiter?: string) => string[][];
+/** Split a grid into a header row plus data rows. */
+export declare const toParsedTable: (grid: string[][]) => ParsedTable;
+/** A parser turns raw file bytes/text into a {@link ParsedTable}. */
+export type FileParser = (input: string | ArrayBuffer | Uint8Array) => ParsedTable | Promise<ParsedTable>;
+/**
+ * Registered parsers per format. CSV is built in; `xls` and `xlsx` are
+ * registered by their own modules so each format ships independently.
+ */
+export declare const fileParsers: Partial<Record<ImportFormat, FileParser>>;
+/** Register a parser for a format (used by the xls/xlsx additions). */
+export declare const registerFileParser: (format: ImportFormat, parser: FileParser) => void;
+/** Decode raw bytes as UTF-8 text. */
+export declare const decodeText: (input: ArrayBuffer | Uint8Array) => string;
+/** Infer the import format from a filename extension. */
+export declare const detectFormat: (filename: string) => ImportFormat | undefined;
+/** Parse a file's contents into a {@link ParsedTable} using the registered parser. */
+export declare const parseTable: (input: string | ArrayBuffer | Uint8Array, format: ImportFormat) => Promise<ParsedTable>;
+/**
+ * Suggest a header-to-column mapping by matching header text against each
+ * column's title (then its `dataIndex`), case- and punctuation-insensitively.
+ * Password columns are never targeted. Unmatched headers map to `null`.
+ */
+export declare const autoMapColumns: (headers: string[], columns: ImportColumn[]) => ColumnMapping;
+/**
+ * Coerce one raw cell into the record shape for a column. Throws when the
+ * field's own conversion throws (e.g. malformed JSON), which the caller records
+ * as a per-row error.
+ */
+export declare const coerceValue: (raw: string, column: ImportColumn) => unknown;
+/**
+ * Evaluate the resolved rules for one value, returning the first failure
+ * message or `null`. Supports the rule shapes the registry and `formConfig`
+ * produce: `required`, `type: 'email' | 'url'`, `pattern`, `len`/`min`/`max`,
+ * and custom async `validator`s (which is how the `json` type validates).
+ */
+export declare const evaluateRules: (rules: FormRule[] | undefined, value: unknown, label: string) => Promise<string | null>;
+/**
+ * Turn parsed rows into validated record drafts using the given mapping.
+ * Password columns are excluded even if mapped. Cells that coerce to blank are
+ * omitted from the draft so `required` rules see a missing value.
+ */
+export declare const prepareRows: (table: ParsedTable, mapping: ColumnMapping, columns: ImportColumn[]) => Promise<PreparedRow[]>;
+/** How the importer creates rows: one at a time, or all at once server-side. */
+export interface ImportSink {
+    /** Create one record. */
+    create: (draft: Record<string, unknown>) => Promise<unknown>;
+    /** Optional batch create for sources that can do it server-side. */
+    createMany?: (drafts: Record<string, unknown>[]) => Promise<unknown>;
+}
+/** Options for {@link runImport}. */
+export interface RunImportOptions {
+    /** Max simultaneous single-row creates. Defaults to 5. */
+    concurrency?: number;
+}
+/**
+ * Create the valid prepared rows, reporting each row's outcome. Invalid rows are
+ * never sent. Uses `createMany` when the sink offers it; otherwise creates with
+ * a bounded pool so a large file does not fire thousands of simultaneous
+ * requests. Partial success is honoured: a failing row does not abort the rest.
+ */
+export declare const runImport: (prepared: PreparedRow[], sink: ImportSink, options?: RunImportOptions) => Promise<ImportResult>;

package/dist/utils/importSpreadsheetML.d.ts

@@ -0,0 +1,8 @@
+import { ParsedTable } from './importData';
+/**
+ * Parse SpreadsheetML text into a grid of string cells (first Worksheet only).
+ * `ss:Index` (1-based) on a row or cell is honoured so sparse files stay aligned.
+ */
+export declare const parseSpreadsheetML: (xml: string) => string[][];
+/** Parse SpreadsheetML content (text or bytes) into a {@link ParsedTable}. */
+export declare const parseSpreadsheetMLTable: (input: string | ArrayBuffer | Uint8Array) => ParsedTable;

package/dist/utils/importXlsx.d.ts

@@ -0,0 +1,7 @@
+import { ParsedTable } from './importData';
+/**
+ * Parse an `.xlsx` workbook's first sheet into a {@link ParsedTable}.
+ * Accepts the raw bytes (`ArrayBuffer`/`Uint8Array`) the import dialog reads
+ * from the chosen file.
+ */
+export declare const parseXlsx: (input: string | ArrayBuffer | Uint8Array) => Promise<ParsedTable>;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "antd-crud-table",
   "private": false,
-  "version": "0.7.0",
+  "version": "0.8.0",
   "type": "module",
   "homepage": "https://github.com/maifeeulasad/antd-crud-table",
   "repository": {
@@ -100,6 +100,9 @@
   "sideEffects": [
     "*.css"
   ],
+  "dependencies": {
+    "to-spreadsheet": "^1.4.0"
+  },
   "scripts": {
     "dev": "vite",
     "build:demo": "tsc -b && vite build",
@@ -114,6 +117,8 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
+    "test:integration": "vitest run --config vitest.integration.config.ts",
+    "backend": "node --experimental-strip-types backend/index.ts",
     "preview": "vite preview"
   }
 }