@iyulab/flex-table 0.59.0 → 0.61.0

package/dist/odata/query.d.ts

@@ -51,9 +51,13 @@ export declare function resolveInitialState(options: InitialSourceStateOptions):
 export declare function parseOrderBy(orderBy: string): SortCriteria[];
 /** `buildODataQuery` 가 읽는 표 상태 — `useODataSource` 가 요청마다 넘기는 것과 같은 모양. */
 export interface ODataQueryState {
-    /** 0부터 세는 페이지 번호. */
-    page: number;
-    pageSize: number;
+    /** 0부터 세는 페이지 번호. `pageSize` 와 함께 `$skip` 이 된다. */
+    page?: number;
+    /**
+     * 한 페이지의 행 수(`$top`). **생략하면 `$top`·`$skip` 없이** 조회 결과 전체를 묻는다 — 서버가 응답을 나누면
+     * (`@odata.nextLink`) 끝까지 따라가는 것은 부르는 쪽 몫이다(`ODataSource.fetchAll`).
+     */
+    pageSize?: number;
     sortCriteria?: SortCriteria[];
     /** 정렬 기준이 비었을 때 쓰는 `$orderby` 문자열. */
     defaultOrderBy?: string;

package/dist/odata/source.d.ts

@@ -1,5 +1,6 @@
 import type { SortCriteria } from '../core/sorting.js';
 import { type SourceError } from '../core/source-error.js';
+import { type FetchAllOptions } from '../core/fetch-all.js';
 /** OData 소스의 설정 — `useODataSource` 의 옵션과 같다(`initial*` 은 만들 때만 읽는다). */
 export interface ODataSourceOptions {
     pageSize?: number;
@@ -78,6 +79,14 @@ export interface ODataSource<T> {
     refresh(): void;
     /** 설정을 바꾼다 — 요청 조건이 바뀌면 다시 읽고(`fixedFilter` 값이 바뀌면 첫 장으로), `fetcher`·`onUnauthorized` 는 다음 요청부터. */
     update(url: string, options?: ODataSourceOptions): void;
+    /**
+     * **지금 조건(정렬 · 검색 · 고정 필터)의 결과 전체**를 읽는다 — 페이지 없이, 서버가 응답을 나누면(`@odata.nextLink`)
+     * 끝까지 따라가서. 내보내기처럼 «이 목록이 보여 주는 조회 결과 전부» 가 필요할 때 쓴다. 상태(`data`·`page` …)는
+     * 건드리지 않고 구독도 요구하지 않는다(`enabled: false` 여도 읽는다 — 부르는 것이 곧 요청이다).
+     *
+     * 실패는 `SourceRequestError`(`failure` 가 `SourceError`)로, 상한을 넘으면 그 하위 `RowLimitError` 로 거절한다.
+     */
+    fetchAll(options?: FetchAllOptions): Promise<T[]>;
 }
 /** OData v4 서버 사이드 데이터 소스를 만든다. flex-table 의 `dataMode="server"` 와 함께 쓴다. */
 export declare function createODataSource<T = Record<string, unknown>>(url: string, options?: ODataSourceOptions): ODataSource<T>;

package/dist/odata/types.d.ts

@@ -1,5 +1,6 @@
 import type { SortCriteria } from '../core/sorting.js';
 import type { ODataSourceOptions, ODataSourceState } from './source.js';
+import type { FetchAllOptions } from '../core/fetch-all.js';
 /** `useODataSource` 의 옵션 — 프레임워크 중립 소스(`createODataSource`)의 설정과 같다. `initial*` 은 첫 렌더에서만 읽힌다. */
 export type UseODataSourceOptions = ODataSourceOptions;
 export interface UseODataSourceResult<T> extends ODataSourceState<T> {
@@ -11,5 +12,7 @@ export interface UseODataSourceResult<T> extends ODataSourceState<T> {
     /** 검색어를 바꾸고 첫 장으로 간다. */
     setSearch: (term: string) => void;
     refresh: () => void;
+    /** 지금 조건의 결과 전체 — 페이지 없이, `@odata.nextLink` 를 끝까지(`ODataSource.fetchAll`). 내보내기에 쓴다. */
+    fetchAll: (options?: FetchAllOptions) => Promise<T[]>;
 }
 export type { SortCriteria };

package/dist/react.d.ts

@@ -71,3 +71,5 @@ export type { UseODataSourceOptions, UseODataSourceResult } from './odata/types.
 export { useArraySource } from './array/use-array-source.js';
 export type { UseArraySourceOptions, UseArraySourceResult } from './array/types.js';
 export type { SourceError, SourceErrorDetail } from './core/source-error.js';
+export { SourceRequestError, RowLimitError } from './core/source-error.js';
+export type { FetchAllOptions } from './core/fetch-all.js';

package/dist/react.js

@@ -1,81 +1,94 @@
-import { t as e } from "./flex-table-BDTykqUE.js";
-import { i as t } from "./query-Dw4iO0ir.js";
-import { t as n } from "./source-DOue0Ti3.js";
-import { t as r } from "./view-DiLr-TdY.js";
-import i, { useCallback as a, useEffect as o, useMemo as s, useState as c, useSyncExternalStore as l } from "react";
-import { createComponent as u } from "@lit/react";
+import { t as e } from "./flex-table-BD_T3SqO.js";
+import { n as t, r as n, u as r } from "./fetch-all-J37bOtgc.js";
+import { t as i } from "./source-DNPtWmC3.js";
+import { n as a, t as o } from "./view-BtoXdUGF.js";
+import s, { useCallback as c, useEffect as l, useMemo as u, useState as d, useSyncExternalStore as f } from "react";
+import { createComponent as p } from "@lit/react";
 //#region src/odata/use-odata-source.ts
-function d(e, t = {}) {
-	let [r] = c(() => n(e, t));
-	o(() => {
-		r.update(e, t);
+function m(e, t = {}) {
+	let [n] = d(() => i(e, t));
+	l(() => {
+		n.update(e, t);
 	});
-	let i = l(r.subscribe, r.getState, r.getState), s = a((e) => {
+	let r = f(n.subscribe, n.getState, n.getState), a = c((e) => {
 		let t = e.detail?.criteria;
-		t && r.setSort(t);
-	}, [r]);
+		t && n.setSort(t);
+	}, [n]);
 	return {
-		...i,
-		setPage: r.setPage,
-		setPageSize: r.setPageSize,
-		onSortChange: s,
-		setSearch: r.setSearch,
-		refresh: r.refresh
+		...r,
+		setPage: n.setPage,
+		setPageSize: n.setPageSize,
+		onSortChange: a,
+		setSearch: n.setSearch,
+		refresh: n.refresh,
+		fetchAll: n.fetchAll
 	};
 }
 //#endregion
 //#region src/array/use-array-source.ts
-function f(e, n = {}) {
-	let { pageSize: i = 20, defaultOrderBy: o, initialPage: l = 0, initialSearch: u = "", initialSort: d, columns: f, searchFields: p } = n, m = t({
-		defaultOrderBy: o,
-		initialPage: l,
-		initialSearch: u,
-		initialSort: d
-	}), [h, g] = c(m.page), [_, v] = c(m.sortCriteria), [y, b] = c(m.search), [x, S] = c(i), [C, w] = c(i);
-	i !== C && (w(i), S(i), g(0));
-	let T = a((e) => {
-		S(e), g(0);
-	}, []), E = a((e) => {
-		b(e), g(0);
-	}, []), D = a((e) => {
+function h(e, t = {}) {
+	let { pageSize: n = 20, defaultOrderBy: i, initialPage: s = 0, initialSearch: l = "", initialSort: f, columns: p, searchFields: m } = t, h = r({
+		defaultOrderBy: i,
+		initialPage: s,
+		initialSearch: l,
+		initialSort: f
+	}), [g, _] = d(h.page), [v, y] = d(h.sortCriteria), [b, x] = d(h.search), [S, C] = d(n), [w, T] = d(n);
+	n !== w && (T(n), C(n), _(0));
+	let E = c((e) => {
+		C(e), _(0);
+	}, []), D = c((e) => {
+		x(e), _(0);
+	}, []), O = c((e) => {
 		let t = e.detail?.criteria;
-		t && (v(t), g(0));
-	}, []), O = a(() => {}, []), { data: k, totalCount: A } = s(() => r(e, {
-		search: y,
-		sortCriteria: _,
-		page: h,
-		pageSize: x,
-		columns: f,
-		searchFields: p
+		t && (y(t), _(0));
+	}, []), k = c(() => {}, []), A = c((t) => a(e, {
+		search: b,
+		sortCriteria: v,
+		columns: p,
+		searchFields: m
+	}, t), [
+		e,
+		b,
+		v,
+		p,
+		m
+	]), { data: j, totalCount: M } = u(() => o(e, {
+		search: b,
+		sortCriteria: v,
+		page: g,
+		pageSize: S,
+		columns: p,
+		searchFields: m
 	}), [
 		e,
-		y,
-		_,
-		h,
-		x,
-		f,
-		p
-	]), j = A === 0 ? 0 : Math.ceil(A / x) - 1;
-	return h > j && g(j), {
-		data: k,
-		totalCount: A,
+		b,
+		v,
+		g,
+		S,
+		p,
+		m
+	]), N = M === 0 ? 0 : Math.ceil(M / S) - 1;
+	return g > N && _(N), {
+		data: j,
+		totalCount: M,
 		loading: !1,
 		error: null,
-		page: h,
-		setPage: g,
-		pageSize: x,
-		setPageSize: T,
-		sortCriteria: _,
-		onSortChange: D,
-		search: y,
-		setSearch: E,
-		refresh: O
+		page: g,
+		setPage: _,
+		pageSize: S,
+		setPageSize: E,
+		sortCriteria: v,
+		onSortChange: O,
+		search: b,
+		setSearch: D,
+		refresh: k,
+		fetchAll: A
 	};
 }
-var p = u({
+var g = p({
 	tagName: "flex-table",
 	elementClass: e,
-	react: i,
+	react: s,
 	events: {
 		onCellSelect: "cell-select",
 		onCellEditCommit: "cell-edit-commit",
@@ -111,4 +124,4 @@ var p = u({
 	}
 });
 //#endregion
-export { p as FlexTableReact, f as useArraySource, d as useODataSource };
+export { g as FlexTableReact, t as RowLimitError, n as SourceRequestError, h as useArraySource, m as useODataSource };

package/dist/source-DNPtWmC3.js

@@ -0,0 +1,202 @@
+import { a as e, i as t, n, o as r, r as i, s as a, t as o, u as s } from "./fetch-all-J37bOtgc.js";
+//#region src/odata/source.ts
+function c(e, t = {}) {
+	let i = e, c = t, d = u(t.fixedFilter), f = s({
+		defaultOrderBy: t.defaultOrderBy,
+		initialPage: t.initialPage ?? 0,
+		initialSearch: t.initialSearch ?? "",
+		initialSort: t.initialSort
+	}), p = {
+		data: [],
+		totalCount: 0,
+		loading: !0,
+		error: null,
+		page: f.page,
+		pageSize: t.pageSize ?? 20,
+		sortCriteria: f.sortCriteria,
+		search: f.search
+	}, m = x(), h = /* @__PURE__ */ new Set(), g = null, _ = !1, v = null;
+	function y() {
+		return c.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([
+			i,
+			c.baseUrl,
+			b(),
+			c.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: n, search: o } = p, s = b(), u = c.fetcher ?? fetch, d = c.onUnauthorized;
+		S({
+			loading: !0,
+			error: null
+		});
+		let f = a({
+			page: t,
+			pageSize: s,
+			sortCriteria: n,
+			defaultOrderBy: c.defaultOrderBy,
+			search: o,
+			fixedFilter: c.fixedFilter
+		});
+		l(`${c.baseUrl ?? window.location.origin}${i}${f}`, {
+			fetcher: u,
+			signal: e.signal,
+			onUnauthorized: d
+		}, (e) => e.length < s).then(({ count: n, rows: r }) => {
+			if (e.signal.aborted) return;
+			let i = n ?? 0, a = i === 0 ? 0 : Math.ceil(i / s) - 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: r(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());
+		},
+		async fetchAll({ maxRows: e = o, signal: t, onProgress: r } = {}) {
+			let { sortCriteria: s, search: u } = p, d = a({
+				sortCriteria: s,
+				defaultOrderBy: c.defaultOrderBy,
+				search: u,
+				fixedFilter: c.fixedFilter
+			}), { rows: f } = await l(`${c.baseUrl ?? window.location.origin}${i}${d}`, {
+				fetcher: c.fetcher ?? fetch,
+				signal: t,
+				onUnauthorized: c.onUnauthorized
+			}, (t, i) => {
+				if (i !== void 0 && i > e || t.length > e) throw new n(e, i);
+				return r?.(t.length, i), !0;
+			});
+			return f;
+		},
+		update(e, t = {}) {
+			let n = u(t.fixedFilter), r = n !== d, a = t.pageSize !== void 0 && t.pageSize !== c.pageSize;
+			i = e, c = t, d = n, r && (p = {
+				...p,
+				page: 0
+			}), a && t.pageSize !== p.pageSize && (p = {
+				...p,
+				pageSize: t.pageSize,
+				page: 0
+			}), C(), T();
+		}
+	};
+}
+async function l(n, { fetcher: r, signal: a, onUnauthorized: o }, s) {
+	let c = async (n) => {
+		let s;
+		try {
+			s = await r(n, { signal: a });
+		} catch (e) {
+			throw e?.name === "AbortError" ? e : t(e);
+		}
+		if (!s.ok) throw s.status === 401 && o && o(s), new i(await e(s));
+		return s.json();
+	}, l = await c(n), u = typeof l["@odata.count"] == "number" ? l["@odata.count"] : void 0, d = [...l.value ?? l], f = new URL(n).origin, p = /* @__PURE__ */ new Set([n]), m = n, h = l["@odata.nextLink"];
+	for (; s(d, u) && typeof h == "string" && h;) {
+		let e = new URL(h, m);
+		if (e.origin !== f) throw new i({ message: `OData nextLink points outside the source origin (${e.origin})` });
+		if (m = e.toString(), p.has(m)) throw new i({ message: `OData nextLink repeats an already-read page (${m})` });
+		p.add(m);
+		let t = await c(m);
+		d.push(...t.value ?? []), h = t["@odata.nextLink"];
+	}
+	return {
+		count: u,
+		rows: d
+	};
+}
+function u(e) {
+	return e ? JSON.stringify(e) : "";
+}
+//#endregion
+export { c as t };

package/dist/{view-DiLr-TdY.js → view-BtoXdUGF.js}

@@ -1,6 +1,7 @@
 import { t as e } from "./sorting-CjfjRxwL.js";
+import { n as t, t as n } from "./fetch-all-J37bOtgc.js";
 //#region src/array/view.ts
-function t(t, { search: n, sortCriteria: r, page: i, pageSize: a, columns: o, searchFields: s }) {
+function r(t, { search: n, sortCriteria: r, page: i, pageSize: a, columns: o, searchFields: s }) {
 	let c = n.trim().toLowerCase(), l = c ? t.filter((e) => (s ? s(e) : Object.values(e)).some((e) => e != null && String(e).toLowerCase().includes(c))) : t, u = l;
 	r.length > 0 && (u = e(l, r, o ?? []).map((e) => l[e]));
 	let d = u.length, f = d === 0 ? 0 : Math.ceil(d / a) - 1, p = Math.min(Math.max(i, 0), f) * a;
@@ -9,5 +10,15 @@ function t(t, { search: n, sortCriteria: r, page: i, pageSize: a, columns: o, se
 		totalCount: d
 	};
 }
+async function i(e, i, { maxRows: a = n, signal: o, onProgress: s } = {}) {
+	o?.throwIfAborted();
+	let { data: c, totalCount: l } = r(e, {
+		...i,
+		page: 0,
+		pageSize: Math.max(e.length, 1)
+	});
+	if (l > a) throw new t(a, l);
+	return s?.(c.length, l), c;
+}
 //#endregion
-export { t };
+export { i as n, r as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/flex-table",
-  "version": "0.59.0",
+  "version": "0.61.0",
   "description": "A minimalist, input-centric data grid web component",
   "type": "module",
   "main": "./dist/flex-table.js",

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

@@ -40,7 +40,7 @@ Replacing `data` with the same array reference does not trigger the clear-on-cha
 | `visibleColumns` | `ColumnDefinition[]` (non-hidden) |
 | `filteredRowCount` | `number` |
 | `filterKeys` | `string[]` |
-| `sortCriteria` | `SortCriteria[]` — `{ key, direction: 'asc' \| 'desc' }` |
+| `sortCriteria` | `SortCriteria[]` — `{ key, direction: 'asc' \| 'desc' }`. Settable too (no `sort-change`): a source's sort goes in as is |
 | `activeCell` / `editingCell` | `CellPosition \| null` — `{ row, col }` |
 | `canUndo` / `canRedo` | `boolean` |
 
@@ -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
 

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 };