@iyulab/flex-table 0.58.0 → 0.60.0

package/skills/iyulab-flex-table/references/api.md

@@ -131,9 +131,13 @@ Enter/Escape and blur-to-commit behavior.
 | `setComment(dataIndex, colKey, text)` | `null` or `''` removes; undoable |
 | `getComment(dataIndex, colKey)` / `clearComments()` | |
 | `importFromFile(file)` | `Promise<void>`; `.xlsx`, `.csv`, `.tsv`; fires `data-import` |
-| `exportToString(format, { selectionOnly? })` | `string \| Uint8Array`; format `'csv' \| 'tsv' \| 'json' \| 'xlsx'` (xlsx returns uncompressed bytes — synchronous) |
-| `exportToBlob(format, { selectionOnly? })` | `Promise<Blob>` typed with the format's MIME; xlsx is DEFLATE-compressed |
-| `exportToFile(format, filename?)` | `Promise<void>` — triggers a download (xlsx compressed) |
+| `exportToString(format, { selectionOnly? } \| { rows })` | `string \| Uint8Array`; format `'csv' \| 'tsv' \| 'json' \| 'xlsx'` (xlsx returns uncompressed bytes — synchronous). `rows`: export these rows with the visible columns |
+| `exportToBlob(format, options?)` | `Promise<Blob>` typed with the format's MIME; xlsx is DEFLATE-compressed |
+| `exportToFile(format, filename?, options?)` | `Promise<void>` — triggers a download (xlsx compressed) |
+
+A server-paged table holds one page. Export the list's whole result with
+`table.exportToFile('xlsx', 'x.xlsx', { rows: await source.fetchAll() })` — never the table's own rows there.
+Table-less: `exportDataBlob(rows, columns, format)` + `downloadBlob(blob, name)` from the root entry.
 
 ## Events
 
@@ -143,14 +147,14 @@ cast, and the React `on*` props carry the same types.
 
 | Event | `detail` |
 |---|---|
-| `cell-select` | `{ row, col }` (or `null`) |
+| `cell-select` | `{ row, col, id }` (or `null`) — focus moved (also when the keyboard arrives); `row`/`col` visible positions |
 | `cell-edit-start` | `{ row, col, key, value }` |
 | `cell-edit-commit` | `{ row, col, key, oldValue, newValue }` |
 | `cell-edit-cancel` | `{ row, col }` — `row`: data index (`-1` once the row left `data`) |
 | `validation-error` | `{ row, col, key, value, error }` |
 | `row-add` | `{ row, index }` |
 | `row-delete` | `{ indices, rows }` |
-| `row-activate` | `{ row, id, index, col, key }` — Enter on a non-editable cell |
+| `row-activate` | `{ row, id, via, index, col, key }` — a plain click on a cell (`via: 'click'`) or Enter on a non-editable cell (`'keyboard'`); not a Shift/Ctrl/Cmd click, a drag, or a control in the cell |
 | `row-reorder` | `{ from, to }` |
 | `batch-update` | `{ changes }` |
 | `column-add` | `{ column, index }` |

package/skills/iyulab-flex-table/references/react.md

@@ -114,6 +114,7 @@ function Orders() {
 | `sortCriteria`, `onSortChange` | Pass `onSortChange` to the table's `sort-change` (resets to page 0) |
 | `search`, `setSearch` | Literal text (resets to page 0) |
 | `refresh` | Re-run the current request |
+| `fetchAll(options?)` | The whole result of the current sort/search/filter (no paging, follows `@odata.nextLink`) — for export. `maxRows` (default 100000) rejects with `RowLimitError` rather than cutting; `signal`, `onProgress` |
 
 Search is literal: each whitespace-separated token becomes a quoted phrase joined with `AND`
 (`red shirt` → `"red" AND "shirt"`); double quotes are stripped. If the result set shrinks below
@@ -159,7 +160,7 @@ Differences: `totalCount` is the count after search, `loading` is always `false`
 
 `useODataSource` adapts a framework-neutral source with the same options and state:
 `createODataSource(url, options)` → `getState()` · `subscribe(listener)` (the first subscriber starts loading, the last
-unsubscribe cancels) · `setPage` · `setPageSize` · `setSort(criteria)` · `setSearch` · `refresh` · `update(url, options)`. Changes in one
+unsubscribe cancels) · `setPage` · `setPageSize` · `setSort(criteria)` · `setSearch` · `refresh` · `update(url, options)` · `fetchAll(options?)`. Changes in one
 tick become one request. For Lit, `ODataSourceController` subscribes on connect, cancels on disconnect and re-renders
 the host — from a URL, or from a source you already have (`new ODataSourceController(this, source)`, so a table and a pager share it):
 

package/dist/query-Dw4iO0ir.js

@@ -1,37 +0,0 @@
-import e from "odata-query";
-//#region src/odata/query.ts
-function t(e) {
-	let t = e.split(/\s+/).map((e) => e.replace(/"/g, "")).filter((e) => e.length > 0);
-	if (t.length !== 0) return t.map((e) => `"${e}"`).join(" AND ");
-}
-function n(e) {
-	let { defaultOrderBy: t, initialPage: n = 0, initialSearch: i = "", initialSort: a } = e;
-	return {
-		page: n,
-		search: i,
-		sortCriteria: a ?? (t ? r(t) : [])
-	};
-}
-function r(e) {
-	return e.split(",").map((e) => {
-		let t = e.trim().split(/\s+/);
-		return {
-			key: t[0],
-			direction: t[1]?.toLowerCase() === "desc" ? "desc" : "asc"
-		};
-	});
-}
-function i(n) {
-	let { page: r, pageSize: i, sortCriteria: a = [], defaultOrderBy: o, search: s, fixedFilter: c } = n, l = a.length > 0 ? a.map((e) => `${e.key} ${e.direction}`).join(", ") : o, u = {
-		top: i,
-		skip: r * i,
-		count: !0
-	};
-	if (l && (u.orderBy = l), c && (u.filter = c), s) {
-		let e = t(s);
-		e && (u.search = e);
-	}
-	return e(u);
-}
-//#endregion
-export { n as i, t as n, r, i as t };

package/dist/source-DOue0Ti3.js

@@ -1,223 +0,0 @@
-import { n as e } from "./locale-Cfm-vJji.js";
-import { i as t, t as n } from "./query-Dw4iO0ir.js";
-//#region src/core/source-error.ts
-async function r(t) {
-	let n = await t.text().catch(() => ""), r = {
-		message: e("requestFailed", { status: t.status }),
-		status: t.status
-	};
-	if (!n) return r;
-	let a = n;
-	try {
-		a = JSON.parse(n);
-	} catch {}
-	if (r.body = a, !a || typeof a != "object") return r;
-	let o = a, s = o.error && typeof o.error == "object" ? o.error : o;
-	typeof s.message == "string" && s.message ? r.message = s.message : typeof o.message == "string" && o.message && (r.message = o.message), typeof s.code == "string" && s.code && (r.code = s.code);
-	let c = i(s.details);
-	return c && (r.details = c), r;
-}
-function i(e) {
-	if (!Array.isArray(e)) return;
-	let t = e.filter((e) => {
-		if (!e || typeof e != "object") return !1;
-		let t = e;
-		return typeof t.code == "string" && typeof t.message == "string";
-	});
-	return t.length > 0 ? t : void 0;
-}
-var a = class extends Error {
-	constructor(e) {
-		super(e.message), this.name = "SourceRequestError", this.failure = e;
-	}
-};
-function o(t) {
-	return new a({
-		message: e("networkFailed"),
-		cause: t
-	});
-}
-function s(e) {
-	return e instanceof a ? e.failure : e instanceof Error ? { message: e.message } : { message: String(e) };
-}
-//#endregion
-//#region src/odata/source.ts
-function c(e, i = {}) {
-	let c = e, u = i, d = l(i.fixedFilter), f = t({
-		defaultOrderBy: i.defaultOrderBy,
-		initialPage: i.initialPage ?? 0,
-		initialSearch: i.initialSearch ?? "",
-		initialSort: i.initialSort
-	}), p = {
-		data: [],
-		totalCount: 0,
-		loading: !0,
-		error: null,
-		page: f.page,
-		pageSize: i.pageSize ?? 20,
-		sortCriteria: f.sortCriteria,
-		search: f.search
-	}, m = x(), h = /* @__PURE__ */ new Set(), g = null, _ = !1, v = null;
-	function y() {
-		return u.enabled ?? !0;
-	}
-	function b() {
-		return p.pageSize;
-	}
-	function x() {
-		return {
-			...p,
-			loading: p.loading || !y()
-		};
-	}
-	function S(e) {
-		p = {
-			...p,
-			...e
-		}, C();
-	}
-	function C() {
-		let e = x();
-		if (!Object.keys(e).every((t) => e[t] === m[t])) {
-			m = e;
-			for (let e of [...h]) e();
-		}
-	}
-	function w() {
-		return JSON.stringify([
-			c,
-			u.baseUrl,
-			b(),
-			u.defaultOrderBy,
-			d,
-			p.page,
-			p.sortCriteria,
-			p.search
-		]);
-	}
-	function T() {
-		_ || (_ = !0, queueMicrotask(() => {
-			_ = !1, E();
-		}));
-	}
-	function E() {
-		if (h.size === 0) return;
-		if (!y()) {
-			g?.abort(), g = null, v = null, C();
-			return;
-		}
-		let e = w();
-		e !== v && (v = e, D());
-	}
-	function D() {
-		g?.abort();
-		let e = new AbortController();
-		g = e;
-		let { page: t, sortCriteria: i, search: l } = p, d = b(), f = u.fetcher ?? fetch, m = u.onUnauthorized;
-		S({
-			loading: !0,
-			error: null
-		});
-		let h = n({
-			page: t,
-			pageSize: d,
-			sortCriteria: i,
-			defaultOrderBy: u.defaultOrderBy,
-			search: l,
-			fixedFilter: u.fixedFilter
-		}), _ = `${u.baseUrl ?? window.location.origin}${c}${h}`, v = async (t) => {
-			let n;
-			try {
-				n = await f(t, { signal: e.signal });
-			} catch (e) {
-				throw e?.name === "AbortError" ? e : o(e);
-			}
-			if (!n.ok) throw n.status === 401 && m && m(n), new a(await r(n));
-			return n.json();
-		};
-		(async () => {
-			let e = await v(_), t = [...e.value ?? e], n = new URL(_).origin, r = /* @__PURE__ */ new Set([_]), i = _, a = e["@odata.nextLink"];
-			for (; typeof a == "string" && a && t.length < d;) {
-				let e = new URL(a, i);
-				if (e.origin !== n) throw Error(`OData nextLink points outside the source origin (${e.origin})`);
-				if (i = e.toString(), r.has(i)) throw Error(`OData nextLink repeats an already-read page (${i})`);
-				r.add(i);
-				let o = await v(i);
-				t.push(...o.value ?? []), a = o["@odata.nextLink"];
-			}
-			return {
-				count: e["@odata.count"],
-				rows: t
-			};
-		})().then(({ count: n, rows: r }) => {
-			if (e.signal.aborted) return;
-			let i = n ?? 0, a = i === 0 ? 0 : Math.ceil(i / d) - 1;
-			t > a ? (S({
-				data: r,
-				totalCount: i,
-				error: null,
-				page: a
-			}), T()) : S({
-				data: r,
-				totalCount: i,
-				error: null
-			});
-		}).catch((t) => {
-			e.signal.aborted || t?.name !== "AbortError" && S({
-				error: s(t),
-				data: [],
-				totalCount: 0
-			});
-		}).finally(() => {
-			e.signal.aborted || S({ loading: !1 });
-		});
-	}
-	return {
-		getState: () => m,
-		subscribe(e) {
-			return h.add(e), h.size === 1 && T(), () => {
-				!h.delete(e) || h.size > 0 || (g?.abort(), g = null, v = null);
-			};
-		},
-		setPage(e) {
-			S({ page: e }), T();
-		},
-		setPageSize(e) {
-			e !== p.pageSize && (S({
-				pageSize: e,
-				page: 0
-			}), T());
-		},
-		setSort(e) {
-			S({
-				sortCriteria: e,
-				page: 0
-			}), T();
-		},
-		setSearch(e) {
-			S({
-				search: e,
-				page: 0
-			}), T();
-		},
-		refresh() {
-			y() && (v = null, T());
-		},
-		update(e, t = {}) {
-			let n = l(t.fixedFilter), r = n !== d, i = t.pageSize !== void 0 && t.pageSize !== u.pageSize;
-			c = e, u = t, d = n, r && (p = {
-				...p,
-				page: 0
-			}), i && t.pageSize !== p.pageSize && (p = {
-				...p,
-				pageSize: t.pageSize,
-				page: 0
-			}), C(), T();
-		}
-	};
-}
-function l(e) {
-	return e ? JSON.stringify(e) : "";
-}
-//#endregion
-export { c as t };