@iyulab/flex-table 0.38.2 → 0.39.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## [0.39.0] - 2026-09-27
+
+### Added
+
+- **`enabled` option on `useODataSource`** (default `true`). While `false` the hook makes no
+  request and reports `loading: true`; the first request goes out when it turns `true`, with that
+  render's conditions. For lists whose query depends on a value that arrives asynchronously (a
+  server-decided default filter, the current user, a selected parent): without it the first render
+  sent a wasted request with the wrong conditions — often the heaviest one, unfiltered — before the
+  real one. Turning it `false` mid-request cancels the request; `refresh()` does nothing while
+  disabled.
+
 ## [0.38.2] - 2026-09-24
 
 ### Fixed

package/README.md

@@ -688,6 +688,7 @@ const source = useODataSource('/api/orders', {
 | `baseUrl` | `window.location.origin` | Override the request origin (proxy/BFF setups) |
 | `fetcher` | global `fetch` | Custom transport — pass a wrapper that injects auth headers |
 | `onUnauthorized` | — | Called on `401`/`403` responses, before the generic error is set |
+| `enabled` | `true` | While `false`, no request is made and `loading` stays `true` — see below |
 
 `fetcher`/`onUnauthorized` should be stable references (e.g. wrap in `useCallback`) — they are intentionally excluded from the hook's internal effect dependencies to avoid refetch loops on every render.
 
@@ -704,6 +705,22 @@ rows, a `refresh` landing after a change), and holding the old `$skip` would lea
 table next to a non-zero total. Reaching that state costs one extra request, only in that
 case; the page only ever moves down, so it cannot loop.
 
+Set `enabled: false` while the query depends on a value that has not arrived yet — a default
+filter the server decides, the current user, a selected parent record. Without it, the first
+render requests with the wrong conditions (often the heaviest query: no filter) and then again
+once the value arrives. The first request goes out the moment `enabled` turns `true`, with the
+conditions of that render; until then `loading` is `true`, so the table shows loading rather
+than "no data". Turning it `false` mid-request cancels that request, and `refresh()` does nothing
+while disabled.
+
+```tsx
+const season = useDefaultSeason();   // resolves asynchronously
+const source = useODataSource('/api/orders', {
+  fixedFilter: season ? { Season: season } : undefined,
+  enabled: season !== undefined,
+});
+```
+
 The three `initial*` options are read **on the first render only** (the same contract
 `defaultOrderBy` has always had); use `setPage`/`setSearch` to move afterwards. Reach for
 them when a list has to come back the way the user left it — going to a detail screen and

package/dist/array/index.js

@@ -1,5 +1,5 @@
 import { t as e } from "../sorting-CjfjRxwL.js";
-import { r as t } from "../use-odata-source-l9dVCi9l.js";
+import { r as t } from "../use-odata-source-BiZrIEVV.js";
 import { useCallback as n, useMemo as r, useState as i } from "react";
 //#region src/array/use-array-source.ts
 function a(t, { search: n, sortCriteria: r, page: i, pageSize: a, columns: o, searchFields: s }) {

package/dist/odata/index.js

@@ -1,2 +1,2 @@
-import { i as e, n as t, t as n } from "../use-odata-source-l9dVCi9l.js";
+import { i as e, n as t, t as n } from "../use-odata-source-BiZrIEVV.js";
 export { n as buildSearchExpression, t as parseOrderBy, e as useODataSource };

package/dist/odata/types.d.ts

@@ -25,6 +25,16 @@ export interface UseODataSourceOptions {
     fetcher?: (input: string, init: RequestInit) => Promise<Response>;
     /** 응답이 401/403일 때 호출(세션 만료 리다이렉트 등). 호출 후에도 기존 에러 처리는 계속 진행된다. */
     onUnauthorized?: (response: Response) => void;
+    /**
+     * `false` 인 동안 요청하지 않는다. 기본값 `true`.
+     *
+     * 조회 조건이 다른 비동기 값(현재 사용자·기본 필터·선택된 부모 레코드)에 달린 목록에서
+     * 그 값이 오기 전에 «틀린 조건의 첫 조회» 가 나가지 않게 한다. `false → true` 가 되는 순간
+     * 첫 조회가 나가고, 그 사이 `loading` 은 `true` 다(표가 «데이터 없음» 이 아니라 «불러오는 중»
+     * 을 보인다). 조회 중에 `false` 가 되면 진행 중 요청을 취소한다. `false` 인 동안의 `refresh()` 는
+     * 아무 일도 하지 않는다 — 켜지는 순간의 조회가 이미 최신 조건이다.
+     */
+    enabled?: boolean;
 }
 export interface UseODataSourceResult<T> {
     data: T[];

package/dist/{use-odata-source-l9dVCi9l.js → use-odata-source-BiZrIEVV.js}

@@ -14,32 +14,32 @@ function o(e) {
 	};
 }
 function s(s, c = {}) {
-	let { pageSize: l = 20, defaultOrderBy: u, initialPage: d = 0, initialSearch: f = "", initialSort: p, fixedFilter: m, baseUrl: h, fetcher: g = fetch, onUnauthorized: _ } = c, v = m ? JSON.stringify(m) : "", [y, b] = r([]), [x, S] = r(0), [C, w] = r(!1), [T, E] = r(null), D = o({
+	let { pageSize: l = 20, defaultOrderBy: u, initialPage: d = 0, initialSearch: f = "", initialSort: p, fixedFilter: m, baseUrl: h, fetcher: g = fetch, onUnauthorized: _, enabled: v = !0 } = c, y = m ? JSON.stringify(m) : "", [b, x] = r([]), [S, C] = r(0), [w, T] = r(!1), [E, D] = r(null), O = o({
 		defaultOrderBy: u,
 		initialPage: d,
 		initialSearch: f,
 		initialSort: p
-	}), [O, k] = r(D.page), [A, j] = r(D.sortCriteria), [M, N] = r(D.search), [P, F] = r(0), [I, L] = r(v);
-	v !== I && (L(v), k(0));
-	let R = n(null), z = e(() => {
-		F((e) => e + 1);
-	}, []), B = e((e) => {
-		N(e), k(0);
+	}), [k, A] = r(O.page), [j, M] = r(O.sortCriteria), [N, P] = r(O.search), [F, I] = r(0), [L, R] = r(y);
+	y !== L && (R(y), A(0));
+	let z = n(null), B = e(() => {
+		I((e) => e + 1);
 	}, []), V = e((e) => {
+		P(e), A(0);
+	}, []), H = e((e) => {
 		let t = e.detail?.criteria;
-		t && (j(t), k(0));
+		t && (M(t), A(0));
 	}, []);
 	return t(() => {
-		R.current?.abort();
+		if (z.current?.abort(), !v) return;
 		let e = new AbortController();
-		R.current = e, w(!0), E(null);
-		let t = A.length > 0 ? A.map((e) => `${e.key} ${e.direction}`).join(", ") : u, n = {
+		z.current = e, T(!0), D(null);
+		let t = j.length > 0 ? j.map((e) => `${e.key} ${e.direction}`).join(", ") : u, n = {
 			top: l,
-			skip: O * l,
+			skip: k * l,
 			count: !0
 		};
-		if (t && (n.orderBy = t), m && (n.filter = m), M) {
-			let e = a(M);
+		if (t && (n.orderBy = t), m && (n.filter = m), N) {
+			let e = a(N);
 			e && (n.search = e);
 		}
 		let r = i(n), o = `${h ?? window.location.origin}${s}${r}`, c = async (t) => {
@@ -72,36 +72,37 @@ function s(s, c = {}) {
 		})().then(({ count: t, rows: n }) => {
 			if (e.signal.aborted) return;
 			let r = t ?? 0;
-			b(n), S(r), E(null);
+			x(n), C(r), D(null);
 			let i = r === 0 ? 0 : Math.ceil(r / l) - 1;
-			O > i && k(i);
+			k > i && A(i);
 		}).catch((t) => {
-			e.signal.aborted || t.name !== "AbortError" && (E(t.message), b([]), S(0));
+			e.signal.aborted || t.name !== "AbortError" && (D(t.message), x([]), C(0));
 		}).finally(() => {
-			e.signal.aborted || w(!1);
+			e.signal.aborted || T(!1);
 		}), () => e.abort();
 	}, [
+		v,
 		s,
-		O,
+		k,
 		l,
-		A,
-		M,
-		v,
+		j,
+		N,
+		y,
 		u,
-		P,
+		F,
 		h
 	]), {
-		data: y,
-		totalCount: x,
-		loading: C,
-		error: T,
-		page: O,
-		setPage: k,
-		sortCriteria: A,
-		onSortChange: V,
-		search: M,
-		setSearch: B,
-		refresh: z
+		data: b,
+		totalCount: S,
+		loading: w || !v,
+		error: E,
+		page: k,
+		setPage: A,
+		sortCriteria: j,
+		onSortChange: H,
+		search: N,
+		setSearch: V,
+		refresh: B
 	};
 }
 function c(e) {

package/package.json

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