@iyulab/flex-table 0.46.0 → 0.47.0

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## [0.47.0] - 2026-10-05
+
+### Changed
+
+- **Breaking: `error` from `useODataSource` and `useArraySource` is a structured failure, not a
+  string** — `SourceError | null`, where `SourceError` is `{ message, status?, code?, details?, body? }`
+  (exported from `@iyulab/flex-table/react` with `SourceErrorDetail`). The message alone lost which
+  failure it was, so an app could not tell a 403 the server marked with its own code (for example
+  "password change required") from any other 403, or a 404 from a 409, without wrapping `fetcher`
+  to watch the status. Now `status` is the HTTP status, `code` the server's rejection code (OData
+  `error.code`), `details` the OData `error.details` entries, and `body` the parsed response (or its
+  text). A failure with no response — a network error, or a `@odata.nextLink` the hook refused — has
+  a `message` only. The message itself is unchanged.
+
+  Migration: render `error.message` where you rendered `error`
+  (`{source.error && <p role="alert">{source.error.message}</p>}`), and compare `error?.message`
+  where you compared the string.
+
+- **Date and datetime column filters use `u-date-picker`** for their From and To bounds, like the
+  cell editor since 0.46. The native date inputs they replace showed the browser's UI language
+  (`10/02/2026` in an English browser) while the table shows ISO; the bounds now read and show
+  `YYYY-MM-DD` (`YYYY-MM-DD HH:mm`) everywhere, with a calendar beside each. The bounds are labelled
+  (**From**, **To**), each calendar stops at the other bound, and either bound may still stay empty.
+  A bound now applies when it is committed — Enter, leaving the box, or a day picked in the calendar —
+  rather than on every keystroke. While a calendar is open, Escape closes the calendar and the next
+  Escape closes the filter. Opening the filter from the column menu focuses the From bound.
+
 ## [0.46.0] - 2026-10-05
 
 ### Changed

package/README.md

@@ -684,8 +684,13 @@ button is highlighted while its column has an active filter.
 - **text**: case-insensitive substring search
 - **number**: min/max range inputs
 - **boolean**: All / True / False select
-- **date**: from/to date range picker (`<input type="date">`)
-- **datetime**: from/to datetime range picker (`<input type="datetime-local">`)
+- **date**: **From** and **To** `u-date-picker`s (`@iyulab/components`) — the cell editor's control, so the
+  bounds read and show `YYYY-MM-DD` in every browser language, with a calendar beside each. Either
+  bound may stay empty; the end day is inclusive, and each calendar stops at the other bound.
+- **datetime**: the same pickers with a time (`YYYY-MM-DD HH:mm`)
+
+A bound applies when it is committed — Enter, leaving the box, or a day picked in its calendar. While a
+calendar is open, Escape closes the calendar; the next Escape closes the filter.
 
 Filters set via the UI and the programmatic API (`setFilter()`) share the same filter state. Filter dropdowns automatically flip upward when near the viewport bottom.
 
@@ -787,7 +792,7 @@ The hook returns:
 |---|---|
 | `data` / `totalCount` | Current page rows and the server's total (`@odata.count`). When the server pages its response (`@odata.nextLink`, e.g. a page size smaller than `pageSize`), the hook follows the link until the page is filled; a link outside the request's origin, or one that returns to a page already read, is reported through `error` instead of showing a short page |
 | `loading` | A request is in flight |
-| `error` | Message of the last failed request, or `null`. **Render this** — a failed request otherwise leaves the grid silently empty |
+| `error` | The last failed request, or `null`: `{ message, status?, code?, details?, body? }`. **Render `error.message`** — a failed request otherwise leaves the grid silently empty. Branch on `status` (HTTP), `code` (the server's rejection code, OData `error.code`) and `details` (OData `error.details`); `body` is the parsed response (or its text). A failure with no response — a network error, or a `@odata.nextLink` the hook refused — has a `message` only |
 | `page` / `setPage` | Zero-based page index |
 | `sortCriteria` / `onSortChange` | Bind `onSortChange` to the table's `sort-change` event |
 | `search` / `setSearch` | Current search term and its setter (resets to page 0) |

package/dist/array/types.d.ts

@@ -1,4 +1,5 @@
 import type { SortCriteria } from '../core/sorting.js';
+import type { SourceError } from '../core/source-error.js';
 export interface UseArraySourceOptions<T> {
     /** 페이지당 행 수. `useODataSource`와 동일 기본값. */
     pageSize?: number;
@@ -36,7 +37,7 @@ export interface UseArraySourceResult<T> {
     /** 항상 `false` — 로컬 배열은 동기 처리라 로딩 상태가 없다. `useODataSource`와의 반환 형태 동일성을 위해 유지. */
     loading: boolean;
     /** 항상 `null` — 로컬 배열 처리는 실패하지 않는다. 위와 같은 이유로 유지. */
-    error: string | null;
+    error: SourceError | null;
     page: number;
     setPage: (page: number) => void;
     sortCriteria: SortCriteria[];

package/dist/core/source-error.d.ts

@@ -0,0 +1,35 @@
+/** OData v4 오류 봉투의 `error.details` 항목 — 필드별 검증 실패 상세. */
+export interface SourceErrorDetail {
+    code: string;
+    message: string;
+    target?: string;
+}
+/**
+ * 데이터 소스 훅(`useODataSource`/`useArraySource`)의 실패 값.
+ *
+ * 문자열 하나가 아니라 구조로 싣는 이유: 소비자는 «어떤 실패인가» 로 갈라야 한다 — 403 중에서도
+ * 서버가 코드로 구분한 거절(«비밀번호를 바꿔야 한다»), 404(지워진 행), 409(동시성), 429(제한).
+ * 메시지만 남기면 그 정보가 소스 경계에서 사라지고, 소비자는 전송(`fetcher`)을 감싸 상태를
+ * 엿보는 것 말고는 길이 없다.
+ */
+export interface SourceError {
+    /** 보여 줄 문장 — 서버가 준 메시지가 있으면 그것, 없으면 `Request failed (<status>)`. */
+    message: string;
+    /** HTTP 상태. 응답이 없던 실패(네트워크 오류 · `@odata.nextLink` 검사)에는 없다. */
+    status?: number;
+    /** 서버가 정한 거절 코드 — OData 오류 봉투의 `error.code`(또는 최상위 `code`). */
+    code?: string;
+    /** 오류 봉투의 `error.details` 중 `code`·`message` 가 둘 다 문자열인 항목. */
+    details?: SourceErrorDetail[];
+    /** 응답 본문 — JSON 이면 파싱한 값, 아니면 텍스트. 비어 있으면 없다. */
+    body?: unknown;
+}
+/** 실패 응답을 `SourceError` 로 읽는다. 본문을 읽을 수 없어도 상태와 기본 문장은 남긴다. */
+export declare function readFailedResponse(res: Response): Promise<SourceError>;
+/** 실패 응답을 실어 나르는 내부 예외 — `catch` 가 상태를 잃지 않고 `SourceError` 를 꺼낸다. */
+export declare class SourceRequestError extends Error {
+    readonly failure: SourceError;
+    constructor(failure: SourceError);
+}
+/** 잡힌 예외를 `SourceError` 로 — 응답이 있던 실패는 그 구조 그대로, 나머지는 메시지만. */
+export declare function toSourceError(err: unknown): SourceError;

package/dist/{flex-table-DIQhqj12.js → flex-table-h2noRChg.js}

@@ -567,6 +567,19 @@ var v = r`
     width: 50%;
   }
 
+  /* Date bounds stack: side by side, half of the dropdown is narrower than a date (and far narrower
+     than a date and a time) plus the calendar button. */
+  .ft-filter-range-dates {
+    flex-direction: column;
+    gap: 6px;
+  }
+
+  .ft-filter-date {
+    display: block;
+    width: 100%;
+    min-width: 0;
+  }
+
   .ft-filter-actions {
     margin-top: 6px;
     text-align: right;
@@ -1464,19 +1477,19 @@ function N(e, t) {
 		default: return e;
 	}
 }
-function P(e) {
+function se(e) {
 	let t = String(e);
 	if (!Number.isFinite(e) || t.includes("e")) return t;
 	let n = new Intl.NumberFormat(l.get()).formatToParts(1.5).find((e) => e.type === "decimal")?.value;
 	return n && n !== "." ? t.replace(".", n) : t;
 }
-function se(e) {
+function ce(e) {
 	if (e == null || e === "") return "";
 	if (e instanceof Date) return Number.isNaN(e.getTime()) ? "" : `${e.getFullYear()}-${String(e.getMonth() + 1).padStart(2, "0")}-${String(e.getDate()).padStart(2, "0")}`;
 	let t = String(e), n = /^(\d{4}-\d{2}-\d{2})(?:$|T)/.exec(t);
 	return n ? n[1] : t;
 }
-function ce(e) {
+function le(e) {
 	if (e == null || e === "") return "";
 	let t = e instanceof Date ? "" : String(e), n = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})(?::\d{2}(?:\.\d+)?)?$/.exec(t);
 	if (n) return `${n[1]} ${n[2]}`;
@@ -1487,7 +1500,7 @@ function ce(e) {
 }
 //#endregion
 //#region src/export/xlsx-writer.ts
-var le = (() => {
+var ue = (() => {
 	let e = /* @__PURE__ */ new Uint32Array(256);
 	for (let t = 0; t < 256; t++) {
 		let n = t;
@@ -1496,23 +1509,23 @@ var le = (() => {
 	}
 	return e;
 })();
-function ue(e) {
+function de(e) {
 	let t = 4294967295;
-	for (let n = 0; n < e.length; n++) t = le[(t ^ e[n]) & 255] ^ t >>> 8;
+	for (let n = 0; n < e.length; n++) t = ue[(t ^ e[n]) & 255] ^ t >>> 8;
 	return (t ^ 4294967295) >>> 0;
 }
-var F = new TextEncoder();
-function de(e) {
-	return I(e.map((e) => ({
+var P = new TextEncoder();
+function fe(e) {
+	return F(e.map((e) => ({
 		...e,
 		body: e.data,
 		method: 0
 	})));
 }
-async function fe(e) {
+async function pe(e) {
 	let t = [];
 	for (let n of e) {
-		let e = await pe(n.data);
+		let e = await me(n.data);
 		t.push(e.length < n.data.length ? {
 			...n,
 			body: e,
@@ -1523,9 +1536,9 @@ async function fe(e) {
 			method: 0
 		});
 	}
-	return I(t);
+	return F(t);
 }
-async function pe(e) {
+async function me(e) {
 	let t = new CompressionStream("deflate-raw"), n = t.writable.getWriter(), r = t.readable.getReader();
 	n.write(e), n.close();
 	let i = [];
@@ -1534,52 +1547,52 @@ async function pe(e) {
 		if (e) break;
 		i.push(t);
 	}
-	return L(i);
+	return I(i);
 }
-function I(e) {
+function F(e) {
 	let t = [], n = [], r = 0;
 	for (let i of e) {
-		let e = F.encode(i.name), a = ue(i.data), o = i.data.length, s = i.body.length, c = i.method === 8 ? 20 : 10, l = new ArrayBuffer(30 + e.length), u = new DataView(l);
+		let e = P.encode(i.name), a = de(i.data), o = i.data.length, s = i.body.length, c = i.method === 8 ? 20 : 10, l = new ArrayBuffer(30 + e.length), u = new DataView(l);
 		u.setUint32(0, 67324752, !0), u.setUint16(4, c, !0), u.setUint16(6, 0, !0), u.setUint16(8, i.method, !0), u.setUint16(10, 0, !0), u.setUint16(12, 33, !0), u.setUint32(14, a, !0), u.setUint32(18, s, !0), u.setUint32(22, o, !0), u.setUint16(26, e.length, !0), u.setUint16(28, 0, !0), new Uint8Array(l, 30).set(e), t.push(new Uint8Array(l)), t.push(i.body);
 		let d = new ArrayBuffer(46 + e.length), f = new DataView(d);
 		f.setUint32(0, 33639248, !0), f.setUint16(4, 20, !0), f.setUint16(6, c, !0), f.setUint16(8, 0, !0), f.setUint16(10, i.method, !0), f.setUint16(12, 0, !0), f.setUint16(14, 33, !0), f.setUint32(16, a, !0), f.setUint32(20, s, !0), f.setUint32(24, o, !0), f.setUint16(28, e.length, !0), f.setUint16(30, 0, !0), f.setUint16(32, 0, !0), f.setUint16(34, 0, !0), f.setUint16(36, 0, !0), f.setUint32(38, 0, !0), f.setUint32(42, r, !0), new Uint8Array(d, 46).set(e), n.push(new Uint8Array(d)), r += 30 + e.length + s;
 	}
-	let i = L(n), a = /* @__PURE__ */ new ArrayBuffer(22), o = new DataView(a);
-	return o.setUint32(0, 101010256, !0), o.setUint16(4, 0, !0), o.setUint16(6, 0, !0), o.setUint16(8, e.length, !0), o.setUint16(10, e.length, !0), o.setUint32(12, i.length, !0), o.setUint32(16, r, !0), o.setUint16(20, 0, !0), L([
+	let i = I(n), a = /* @__PURE__ */ new ArrayBuffer(22), o = new DataView(a);
+	return o.setUint32(0, 101010256, !0), o.setUint16(4, 0, !0), o.setUint16(6, 0, !0), o.setUint16(8, e.length, !0), o.setUint16(10, e.length, !0), o.setUint32(12, i.length, !0), o.setUint32(16, r, !0), o.setUint16(20, 0, !0), I([
 		...t,
 		i,
 		new Uint8Array(a)
 	]);
 }
-function L(e) {
+function I(e) {
 	let t = e.reduce((e, t) => e + t.length, 0), n = new Uint8Array(t), r = 0;
 	for (let t of e) n.set(t, r), r += t.length;
 	return n;
 }
-function R(e) {
+function L(e) {
 	return e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function me(e) {
+function he(e) {
 	let t = "";
 	for (e++; e > 0;) t = String.fromCharCode(64 + (e % 26 || 26)) + t, e = Math.floor((e - 1) / 26);
 	return t;
 }
-function z(e, t) {
-	return me(t) + (e + 1);
+function R(e, t) {
+	return he(t) + (e + 1);
 }
-function he(e) {
+function ge(e) {
 	let t = Date.UTC(1899, 11, 30);
 	return (e.getTime() - t) / 864e5;
 }
-var ge = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\">\n  <Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/>\n  <Default Extension=\"xml\" ContentType=\"application/xml\"/>\n  <Override PartName=\"/xl/workbook.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml\"/>\n  <Override PartName=\"/xl/worksheets/sheet1.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml\"/>\n  <Override PartName=\"/xl/styles.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml\"/>\n</Types>", _e = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">\n  <Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument\" Target=\"xl/workbook.xml\"/>\n</Relationships>", ve = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<workbook xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">\n  <sheets><sheet name=\"Sheet1\" sheetId=\"1\" r:id=\"rId1\"/></sheets>\n</workbook>", ye = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">\n  <Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet\" Target=\"worksheets/sheet1.xml\"/>\n  <Relationship Id=\"rId2\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles\" Target=\"styles.xml\"/>\n</Relationships>", be = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<styleSheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\">\n  <numFmts count=\"1\"><numFmt numFmtId=\"164\" formatCode=\"yyyy-mm-dd\"/></numFmts>\n  <fonts count=\"2\">\n    <font><sz val=\"11\"/><name val=\"Calibri\"/></font>\n    <font><sz val=\"11\"/><b/><name val=\"Calibri\"/></font>\n  </fonts>\n  <fills count=\"2\">\n    <fill><patternFill patternType=\"none\"/></fill>\n    <fill><patternFill patternType=\"gray125\"/></fill>\n  </fills>\n  <borders count=\"1\"><border><left/><right/><top/><bottom/><diagonal/></border></borders>\n  <cellStyleXfs count=\"1\"><xf numFmtId=\"0\" fontId=\"0\" fillId=\"0\" borderId=\"0\"/></cellStyleXfs>\n  <cellXfs count=\"3\">\n    <xf numFmtId=\"0\" fontId=\"0\" fillId=\"0\" borderId=\"0\" xfId=\"0\"/>\n    <xf numFmtId=\"164\" fontId=\"0\" fillId=\"0\" borderId=\"0\" xfId=\"0\" applyNumberFormat=\"1\"/>\n    <xf numFmtId=\"0\" fontId=\"1\" fillId=\"0\" borderId=\"0\" xfId=\"0\" applyFont=\"1\"/>\n  </cellXfs>\n</styleSheet>";
-function xe(e, t) {
-	let n = [], r = t.map((e, t) => `<c r="${z(0, t)}" t="str" s="2"><v>${R(e.label)}</v></c>`);
+var _e = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Types xmlns=\"http://schemas.openxmlformats.org/package/2006/content-types\">\n  <Default Extension=\"rels\" ContentType=\"application/vnd.openxmlformats-package.relationships+xml\"/>\n  <Default Extension=\"xml\" ContentType=\"application/xml\"/>\n  <Override PartName=\"/xl/workbook.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet.main+xml\"/>\n  <Override PartName=\"/xl/worksheets/sheet1.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.worksheet+xml\"/>\n  <Override PartName=\"/xl/styles.xml\" ContentType=\"application/vnd.openxmlformats-officedocument.spreadsheetml.styles+xml\"/>\n</Types>", ve = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">\n  <Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument\" Target=\"xl/workbook.xml\"/>\n</Relationships>", ye = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<workbook xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\">\n  <sheets><sheet name=\"Sheet1\" sheetId=\"1\" r:id=\"rId1\"/></sheets>\n</workbook>", be = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<Relationships xmlns=\"http://schemas.openxmlformats.org/package/2006/relationships\">\n  <Relationship Id=\"rId1\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet\" Target=\"worksheets/sheet1.xml\"/>\n  <Relationship Id=\"rId2\" Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/styles\" Target=\"styles.xml\"/>\n</Relationships>", xe = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<styleSheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\">\n  <numFmts count=\"1\"><numFmt numFmtId=\"164\" formatCode=\"yyyy-mm-dd\"/></numFmts>\n  <fonts count=\"2\">\n    <font><sz val=\"11\"/><name val=\"Calibri\"/></font>\n    <font><sz val=\"11\"/><b/><name val=\"Calibri\"/></font>\n  </fonts>\n  <fills count=\"2\">\n    <fill><patternFill patternType=\"none\"/></fill>\n    <fill><patternFill patternType=\"gray125\"/></fill>\n  </fills>\n  <borders count=\"1\"><border><left/><right/><top/><bottom/><diagonal/></border></borders>\n  <cellStyleXfs count=\"1\"><xf numFmtId=\"0\" fontId=\"0\" fillId=\"0\" borderId=\"0\"/></cellStyleXfs>\n  <cellXfs count=\"3\">\n    <xf numFmtId=\"0\" fontId=\"0\" fillId=\"0\" borderId=\"0\" xfId=\"0\"/>\n    <xf numFmtId=\"164\" fontId=\"0\" fillId=\"0\" borderId=\"0\" xfId=\"0\" applyNumberFormat=\"1\"/>\n    <xf numFmtId=\"0\" fontId=\"1\" fillId=\"0\" borderId=\"0\" xfId=\"0\" applyFont=\"1\"/>\n  </cellXfs>\n</styleSheet>";
+function Se(e, t) {
+	let n = [], r = t.map((e, t) => `<c r="${R(0, t)}" t="str" s="2"><v>${L(e.label)}</v></c>`);
 	return n.push(`<row r="1">${r.join("")}</row>`), e.forEach((e, r) => {
 		let i = t.map((t, n) => {
-			let i = z(r + 1, n), a = e[t.key];
+			let i = R(r + 1, n), a = e[t.key];
 			if (a == null) return `<c r="${i}" t="str"><v></v></c>`;
 			let o = t.type ?? "text";
-			return o === "number" && typeof a == "number" ? `<c r="${i}"><v>${a}</v></c>` : (o === "date" || o === "datetime") && a instanceof Date ? `<c r="${i}" s="1"><v>${he(a).toFixed(6)}</v></c>` : o === "boolean" ? `<c r="${i}" t="b"><v>${+!!a}</v></c>` : `<c r="${i}" t="str"><v>${R(String(a))}</v></c>`;
+			return o === "number" && typeof a == "number" ? `<c r="${i}"><v>${a}</v></c>` : (o === "date" || o === "datetime") && a instanceof Date ? `<c r="${i}" s="1"><v>${ge(a).toFixed(6)}</v></c>` : o === "boolean" ? `<c r="${i}" t="b"><v>${+!!a}</v></c>` : `<c r="${i}" t="str"><v>${L(String(a))}</v></c>`;
 		});
 		n.push(`<row r="${r + 2}">${i.join("")}</row>`);
 	}), `<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
@@ -1587,65 +1600,65 @@ function xe(e, t) {
   <sheetData>${n.join("")}</sheetData>
 </worksheet>`;
 }
-function Se(e, t) {
-	return de(B(e, t));
-}
 function Ce(e, t) {
-	return fe(B(e, t));
+	return fe(z(e, t));
+}
+function we(e, t) {
+	return pe(z(e, t));
 }
-function B(e, t) {
-	let n = xe(e, t);
+function z(e, t) {
+	let n = Se(e, t);
 	return [
 		{
 			name: "[Content_Types].xml",
-			data: F.encode(ge)
+			data: P.encode(_e)
 		},
 		{
 			name: "_rels/.rels",
-			data: F.encode(_e)
+			data: P.encode(ve)
 		},
 		{
 			name: "xl/workbook.xml",
-			data: F.encode(ve)
+			data: P.encode(ye)
 		},
 		{
 			name: "xl/_rels/workbook.xml.rels",
-			data: F.encode(ye)
+			data: P.encode(be)
 		},
 		{
 			name: "xl/worksheets/sheet1.xml",
-			data: F.encode(n)
+			data: P.encode(n)
 		},
 		{
 			name: "xl/styles.xml",
-			data: F.encode(be)
+			data: P.encode(xe)
 		}
 	];
 }
 //#endregion
 //#region src/export/export.ts
-function V(e, t, n) {
+function B(e, t, n) {
 	switch (n) {
-		case "csv": return H(e, t, ",");
-		case "tsv": return H(e, t, "	");
-		case "json": return Ee(e, t);
-		case "xlsx": return Se(e, t);
+		case "csv": return V(e, t, ",");
+		case "tsv": return V(e, t, "	");
+		case "json": return De(e, t);
+		case "xlsx": return Ce(e, t);
 	}
 }
-async function we(e, t, n) {
-	let r = n === "xlsx" ? await Ce(e, t) : V(e, t, n);
-	return new Blob([r], { type: Ae(n) });
+async function Te(e, t, n) {
+	let r = n === "xlsx" ? await we(e, t) : B(e, t, n);
+	return new Blob([r], { type: je(n) });
 }
-function Te(e, t) {
+function Ee(e, t) {
 	return e == null ? "" : (t.type === "date" || t.type === "datetime") && e instanceof Date ? e.toISOString() : String(e);
 }
-function H(e, t, n) {
-	return [t.map((e) => U(e.label, n)).join(n), ...e.map((e) => t.map((t) => U(Te(e[t.key], t), n)).join(n))].join("\n");
+function V(e, t, n) {
+	return [t.map((e) => H(e.label, n)).join(n), ...e.map((e) => t.map((t) => H(Ee(e[t.key], t), n)).join(n))].join("\n");
 }
-function U(e, t) {
+function H(e, t) {
 	return e.includes(t) || e.includes("\"") || e.includes("\n") || e.includes("\r") ? "\"" + e.replace(/"/g, "\"\"") + "\"" : e;
 }
-function Ee(e, t) {
+function De(e, t) {
 	let n = e.map((e) => {
 		let n = {};
 		for (let r of t) {
@@ -1656,35 +1669,35 @@ function Ee(e, t) {
 	});
 	return JSON.stringify(n, null, 2);
 }
-function De(e, t) {
+function Oe(e, t) {
 	let n = URL.createObjectURL(e), r = document.createElement("a");
 	r.href = n, r.download = t, r.style.display = "none", document.body.appendChild(r), r.click(), document.body.removeChild(r), setTimeout(() => URL.revokeObjectURL(n), 100);
 }
-var Oe = {
+var ke = {
 	csv: "text/csv;charset=utf-8",
 	tsv: "text/tab-separated-values;charset=utf-8",
 	json: "application/json;charset=utf-8",
 	xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"
-}, ke = {
+}, Ae = {
 	csv: ".csv",
 	tsv: ".tsv",
 	json: ".json",
 	xlsx: ".xlsx"
 };
-function Ae(e) {
-	return Oe[e];
-}
 function je(e) {
 	return ke[e];
 }
+function Me(e) {
+	return Ae[e];
+}
 //#endregion
 //#region src/export/xlsx-reader.ts
-function Me(e) {
+function Ne(e) {
 	for (let t = e.byteLength - 22; t >= 0; t--) if (e.getUint32(t, !0) === 101010256) return t;
 	throw Error("XLSX: End of central directory not found — not a valid ZIP file");
 }
-function Ne(e) {
-	let t = Me(e), n = e.getUint32(t + 16, !0), r = e.getUint32(t + 12, !0), i = new TextDecoder("utf-8"), a = [], o = n, s = n + r;
+function Pe(e) {
+	let t = Ne(e), n = e.getUint32(t + 16, !0), r = e.getUint32(t + 12, !0), i = new TextDecoder("utf-8"), a = [], o = n, s = n + r;
 	for (; o < s && e.getUint32(o, !0) === 33639248;) {
 		let t = e.getUint16(o + 10, !0), n = e.getUint32(o + 20, !0), r = e.getUint32(o + 24, !0), s = e.getUint16(o + 28, !0), c = e.getUint16(o + 30, !0), l = e.getUint16(o + 32, !0), u = e.getUint32(o + 42, !0), d = i.decode(new Uint8Array(e.buffer, o + 46, s));
 		a.push({
@@ -1697,7 +1710,7 @@ function Ne(e) {
 	}
 	return a;
 }
-async function Pe(e) {
+async function Fe(e) {
 	let t = new DecompressionStream("deflate-raw"), n = t.writable.getWriter(), r = t.readable.getReader();
 	n.write(e), n.close();
 	let i = [];
@@ -1710,28 +1723,28 @@ async function Pe(e) {
 	for (let e of i) o.set(e, s), s += e.length;
 	return o;
 }
-async function Fe(e, t) {
+async function Ie(e, t) {
 	let n = t.localHeaderOffset, r = e.getUint16(n + 26, !0), i = e.getUint16(n + 28, !0), a = n + 30 + r + i, o = new Uint8Array(e.buffer, a, t.compressedSize);
 	if (t.compressionMethod === 0) return o.slice();
-	if (t.compressionMethod === 8) return Pe(o);
+	if (t.compressionMethod === 8) return Fe(o);
 	throw Error(`XLSX: Unsupported compression method ${t.compressionMethod}`);
 }
-async function Ie(e) {
-	let t = new DataView(e), n = Ne(t), r = /* @__PURE__ */ new Map();
-	for (let e of n) e.compressedSize === 0 && e.name.endsWith("/") || r.set(e.name, await Fe(t, e));
+async function Le(e) {
+	let t = new DataView(e), n = Pe(t), r = /* @__PURE__ */ new Map();
+	for (let e of n) e.compressedSize === 0 && e.name.endsWith("/") || r.set(e.name, await Ie(t, e));
 	return r;
 }
-var Le = new TextDecoder("utf-8");
-function W(e) {
-	let t = Le.decode(e);
+var Re = new TextDecoder("utf-8");
+function U(e) {
+	let t = Re.decode(e);
 	return new DOMParser().parseFromString(t, "application/xml");
 }
-function Re(e) {
+function ze(e) {
 	if (!e) return [];
-	let t = W(e);
+	let t = U(e);
 	return Array.from(t.querySelectorAll("si")).map((e) => Array.from(e.querySelectorAll("t")).map((e) => e.textContent ?? "").join(""));
 }
-var ze = /* @__PURE__ */ new Set([
+var Be = /* @__PURE__ */ new Set([
 	14,
 	15,
 	16,
@@ -1751,37 +1764,37 @@ var ze = /* @__PURE__ */ new Set([
 	57,
 	58
 ]);
-function Be(e) {
+function Ve(e) {
 	let t = e.replace(/"[^"]*"/g, "").replace(/\\./g, "").replace(/\[[^\]]*\]/g, "").split(";")[0];
 	return /[dy]/i.test(t);
 }
-function Ve(e) {
+function He(e) {
 	let t = /* @__PURE__ */ new Set();
 	if (!e) return t;
-	let n = W(e), r = /* @__PURE__ */ new Map();
+	let n = U(e), r = /* @__PURE__ */ new Map();
 	for (let e of Array.from(n.querySelectorAll("numFmts > numFmt"))) r.set(parseInt(e.getAttribute("numFmtId") ?? "", 10), e.getAttribute("formatCode") ?? "");
 	return Array.from(n.querySelectorAll("cellXfs > xf")).forEach((e, n) => {
 		let i = parseInt(e.getAttribute("numFmtId") ?? "0", 10), a = r.get(i);
-		(a === void 0 ? ze.has(i) : Be(a)) && t.add(n);
+		(a === void 0 ? Be.has(i) : Ve(a)) && t.add(n);
 	}), t;
 }
-function He(e) {
+function Ue(e) {
 	if (!e) return !1;
-	let t = W(e).querySelector("workbookPr")?.getAttribute("date1904");
+	let t = U(e).querySelector("workbookPr")?.getAttribute("date1904");
 	return t === "1" || t === "true";
 }
-function Ue(e, t) {
+function We(e, t) {
 	return new Date((t ? Date.UTC(1904, 0, 1) : Date.UTC(1899, 11, 30)) + Math.floor(e) * 864e5).toISOString().slice(0, 10);
 }
-function We(e, t, n, r) {
-	let i = W(e).querySelectorAll("row");
+function Ge(e, t, n, r) {
+	let i = U(e).querySelectorAll("row");
 	if (i.length === 0) return [];
 	let a = 0, o = /* @__PURE__ */ new Map();
 	for (let e of i) {
 		let i = parseInt(e.getAttribute("r") ?? "1", 10) - 1, s = /* @__PURE__ */ new Map();
 		o.set(i, s);
 		for (let i of e.querySelectorAll("c")) {
-			let e = Ge(i.getAttribute("r") ?? "");
+			let e = Ke(i.getAttribute("r") ?? "");
 			e > a && (a = e);
 			let o = i.getAttribute("t") ?? "", c = i.getAttribute("s") ?? "", l = i.querySelector("v")?.textContent ?? "", u = i.querySelector("is > t")?.textContent ?? null, d;
 			if (o === "s") d = t[parseInt(l, 10)] ?? "";
@@ -1790,7 +1803,7 @@ function We(e, t, n, r) {
 			else if (l === "") d = "";
 			else {
 				let e = parseFloat(l);
-				d = c !== "" && n.has(parseInt(c, 10)) && !isNaN(e) && e >= 0 ? Ue(e, r) : l;
+				d = c !== "" && n.has(parseInt(c, 10)) && !isNaN(e) && e >= 0 ? We(e, r) : l;
 			}
 			s.set(e, d);
 		}
@@ -1804,13 +1817,13 @@ function We(e, t, n, r) {
 	}
 	return c;
 }
-function Ge(e) {
+function Ke(e) {
 	let t = 0, n = 0;
 	for (; n < e.length && e[n] >= "A" && e[n] <= "Z";) t = t * 26 + (e.charCodeAt(n) - 64), n++;
 	return t - 1;
 }
-async function Ke(e) {
-	let t = await Ie(e), n = Re(t.get("xl/sharedStrings.xml")), r = t.get("xl/worksheets/sheet1.xml");
+async function qe(e) {
+	let t = await Le(e), n = ze(t.get("xl/sharedStrings.xml")), r = t.get("xl/worksheets/sheet1.xml");
 	if (!r) {
 		for (let [e, n] of t) if (e.toLowerCase().includes("worksheets/sheet")) {
 			r = n;
@@ -1818,7 +1831,7 @@ async function Ke(e) {
 		}
 	}
 	if (!r) throw Error("XLSX: No worksheet found");
-	let i = Ve(t.get("xl/styles.xml")), a = He(t.get("xl/workbook.xml")), o = We(r, n, i, a);
+	let i = He(t.get("xl/styles.xml")), a = Ue(t.get("xl/workbook.xml")), o = Ge(r, n, i, a);
 	return o.length === 0 ? {
 		headers: [],
 		rows: []
@@ -1829,12 +1842,12 @@ async function Ke(e) {
 }
 //#endregion
 //#region src/models/types.ts
-function G(e) {
+function W(e) {
 	return e.align ? e.align : e.type === "number" ? "end" : e.type === "boolean" ? "center" : "start";
 }
 //#endregion
 //#region \0@oxc-project+runtime@0.152.0/helpers/esm/decorate.js
-function K(e, t, n, r) {
+function G(e, t, n, r) {
 	var i = arguments.length, a = i < 3 ? t : r === null ? r = Object.getOwnPropertyDescriptor(t, n) : r, o;
 	if (typeof Reflect == "object" && typeof Reflect.decorate == "function") a = Reflect.decorate(e, t, n, r);
 	else for (var s = e.length - 1; s >= 0; s--) (o = e[s]) && (a = (i < 3 ? o(a) : i > 3 ? o(t, n, a) : o(t, n)) || a);
@@ -1842,16 +1855,16 @@ function K(e, t, n, r) {
 }
 //#endregion
 //#region src/flex-table.ts
-var q = {
+var K = {
 	eq: "=",
 	neq: "≠",
 	gt: ">",
 	lt: "<",
 	gte: "≥",
 	lte: "≤"
-}, J = 120, Y = 40, X = 20, Z = 32, Q = 5, qe = 200, $ = class extends n {
+}, q = 120, J = 40, Y = 20, X = 32, Z = 5, Je = 200, Q = class extends n {
 	constructor(...e) {
-		super(...e), this.columns = [], this._data = [], this._inUndoRedo = !1, this.clearUndoOnDataChange = !1, this.clearSelectionOnDataChange = !1, this._rowHeightFromCss = Z, this._targetFloor = 0, this.showRowNumbers = !1, this.theme = void 0, this.maxRows = 0, this.editable = !0, this.showFilters = !1, this.showContextMenu = !1, this.frozenRows = 0, this.emptyMessage = "No data", this.noMatchingMessage = "No matching data", this.loading = !1, this.importEnabled = !1, this.selectable = !1, this.dataMode = "client", this.footerData = null, this.stylesheets = [], this._scrollTop = 0, this._scrollLeft = 0, this._viewportHeight = 0, this._viewportWidth = 0, this._colLeftOffsets = [], this._totalRowWidth = 0, this._baseStyleSheets = [], this._activeCell = null, this._editingCell = null, this._sortCriteria = [], this._selection = new ne(), this._editing = new re(), this._rowSelection = new j(), this._undo = new M(), this._filters = [], this._filteredIndices = [], this._sortedIndices = [], this._openFilterKey = null, this._rowSelectionVersion = 0, this._lastCheckboxRowIndex = null, this._checkboxShiftPending = !1, this._autocompleteState = null, this._headerMenu = null, this._bodyContextMenu = null, this._commentPopup = null, this._viewDirty = !0, this._isDragging = !1, this._wasDrag = !1, this._resizing = null, this._resizeCleanup = null, this._wasHeaderDrag = !1, this._wasRowDrag = !1, this._colDrag = null, this._colDragIndicatorLeft = null, this._fillDrag = null, this._rowDrag = null, this._rowDragIndicatorY = null, this._findState = null, this._columnWidths = /* @__PURE__ */ new Map(), this._hostResizeObserver = null, this._comments = /* @__PURE__ */ new Map(), this._isDragOver = !1, this._warnedUnconstrained = !1, this._onCommentPopupOutsideClick = () => {
+		super(...e), this.columns = [], this._data = [], this._inUndoRedo = !1, this.clearUndoOnDataChange = !1, this.clearSelectionOnDataChange = !1, this._rowHeightFromCss = X, this._targetFloor = 0, this.showRowNumbers = !1, this.theme = void 0, this.maxRows = 0, this.editable = !0, this.showFilters = !1, this.showContextMenu = !1, this.frozenRows = 0, this.emptyMessage = "No data", this.noMatchingMessage = "No matching data", this.loading = !1, this.importEnabled = !1, this.selectable = !1, this.dataMode = "client", this.footerData = null, this.stylesheets = [], this._scrollTop = 0, this._scrollLeft = 0, this._viewportHeight = 0, this._viewportWidth = 0, this._colLeftOffsets = [], this._totalRowWidth = 0, this._baseStyleSheets = [], this._activeCell = null, this._editingCell = null, this._sortCriteria = [], this._selection = new ne(), this._editing = new re(), this._rowSelection = new j(), this._undo = new M(), this._filters = [], this._filteredIndices = [], this._sortedIndices = [], this._openFilterKey = null, this._rowSelectionVersion = 0, this._lastCheckboxRowIndex = null, this._checkboxShiftPending = !1, this._autocompleteState = null, this._headerMenu = null, this._bodyContextMenu = null, this._commentPopup = null, this._viewDirty = !0, this._isDragging = !1, this._wasDrag = !1, this._resizing = null, this._resizeCleanup = null, this._wasHeaderDrag = !1, this._wasRowDrag = !1, this._colDrag = null, this._colDragIndicatorLeft = null, this._fillDrag = null, this._rowDrag = null, this._rowDragIndicatorY = null, this._findState = null, this._columnWidths = /* @__PURE__ */ new Map(), this._hostResizeObserver = null, this._comments = /* @__PURE__ */ new Map(), this._isDragOver = !1, this._warnedUnconstrained = !1, this._onCommentPopupOutsideClick = () => {
 			this._commitCommentPopup();
 		}, this._invalidCells = /* @__PURE__ */ new Map(), this._textFilterState = /* @__PURE__ */ new Map(), this._numberFilterState = /* @__PURE__ */ new Map(), this._dateFilterState = /* @__PURE__ */ new Map(), this._emptyFilterState = /* @__PURE__ */ new Map();
 	}
@@ -1866,7 +1879,7 @@ var q = {
 		this._data = e, n && !this._inUndoRedo && (this.clearUndoOnDataChange && this._undo.clear(), this.clearSelectionOnDataChange && this._rowSelection.selectedCount > 0 && (this._rowSelection.deselectAll(), this._rowSelectionVersion++, this._dispatchRowSelectionEvent())), this.requestUpdate("data", t);
 	}
 	get rowHeight() {
-		let e = this._rowHeightExplicit ?? this._rowHeightFromCss ?? Z;
+		let e = this._rowHeightExplicit ?? this._rowHeightFromCss ?? X;
 		return Math.max(e, this._targetFloor);
 	}
 	set rowHeight(e) {
@@ -2216,17 +2229,17 @@ var q = {
 	}
 	exportToString(e, t) {
 		let n = this._exportSlice(t);
-		return n ? V(n.rows, n.cols, e) : "";
+		return n ? B(n.rows, n.cols, e) : "";
 	}
 	async exportToBlob(e, t) {
 		let n = this._exportSlice(t) ?? {
 			rows: [],
 			cols: []
 		};
-		return we(n.rows, n.cols, e);
+		return Te(n.rows, n.cols, e);
 	}
 	async exportToFile(e, t) {
-		De(await this.exportToBlob(e), t ?? `export${je(e)}`);
+		Oe(await this.exportToBlob(e), t ?? `export${Me(e)}`);
 	}
 	_exportSlice(e) {
 		if (e?.selectionOnly) {
@@ -2299,7 +2312,7 @@ var q = {
 	async importFromFile(e) {
 		let t = e.name.toLowerCase();
 		if (t.endsWith(".xlsx")) {
-			let t = await Ke(await e.arrayBuffer());
+			let t = await qe(await e.arrayBuffer());
 			this._applyImportedSheet(t);
 		} else if (t.endsWith(".csv") || t.endsWith(".tsv")) {
 			let t = await e.text(), n = h(t);
@@ -2391,8 +2404,8 @@ var q = {
 		return this._columnWidths.get(e);
 	}
 	_getColWidth(e) {
-		let t = this._columnWidths.get(e.key) ?? e.width ?? J;
-		return Math.max(t, e.minWidth ?? Y);
+		let t = this._columnWidths.get(e.key) ?? e.width ?? q;
+		return Math.max(t, e.minWidth ?? J);
 	}
 	get headerHeight() {
 		return this.rowHeight + 8;
@@ -2418,10 +2431,10 @@ var q = {
 		return Math.max(0, this._visibleRowCount - this._frozenRowCount) * this.rowHeight;
 	}
 	get visibleRange() {
-		let e = this._frozenRowCount, t = e + Math.floor(Math.max(0, this._scrollTop) / this.rowHeight), n = Math.max(e, t - Q), r = Math.max(0, this._viewportHeight - this.headerHeight - this.frozenRowsHeight), i = Math.ceil(r / this.rowHeight) + 1;
+		let e = this._frozenRowCount, t = e + Math.floor(Math.max(0, this._scrollTop) / this.rowHeight), n = Math.max(e, t - Z), r = Math.max(0, this._viewportHeight - this.headerHeight - this.frozenRowsHeight), i = Math.ceil(r / this.rowHeight) + 1;
 		return {
 			start: n,
-			end: Math.min(this._visibleRowCount, t + i + Q)
+			end: Math.min(this._visibleRowCount, t + i + Z)
 		};
 	}
 	connectedCallback() {
@@ -2464,13 +2477,13 @@ var q = {
 			i = r;
 			break;
 		}
-		i = Math.max(0, i - Q);
+		i = Math.max(0, i - Z);
 		let a = e.length;
 		for (let e = i; e < t.length; e++) if (t[e] > r) {
 			a = e;
 			break;
 		}
-		return a = Math.min(e.length, a + Q), {
+		return a = Math.min(e.length, a + Z), {
 			start: i,
 			end: a
 		};
@@ -2530,7 +2543,7 @@ var q = {
 		e !== this._viewportHeight && (this._viewportHeight = e), t !== this._viewportWidth && (this._viewportWidth = t), this._warnIfUnconstrained();
 	}
 	_warnIfUnconstrained() {
-		this._warnedUnconstrained || process.env.NODE_ENV === "production" || this._visibleRowCount < qe || this.scrollHeight > this.clientHeight + 1 || (this._warnedUnconstrained = !0, console.warn(`[@iyulab/flex-table] ${this._visibleRowCount} rows but the host has no height constraint — it grew to fit every row, so virtual scrolling is off and all rows are rendered. Give the host a height (e.g. height: 400px, or flex: 1 1 auto with min-height: 0 inside a sized parent) so it becomes the scroll container.`));
+		this._warnedUnconstrained || process.env.NODE_ENV === "production" || this._visibleRowCount < Je || this.scrollHeight > this.clientHeight + 1 || (this._warnedUnconstrained = !0, console.warn(`[@iyulab/flex-table] ${this._visibleRowCount} rows but the host has no height constraint — it grew to fit every row, so virtual scrolling is off and all rows are rendered. Give the host a height (e.g. height: 400px, or flex: 1 1 auto with min-height: 0 inside a sized parent) so it becomes the scroll container.`));
 	}
 	_onScroll() {
 		this._scrollTop = this.scrollTop, this._scrollLeft = this.scrollLeft;
@@ -2766,7 +2779,7 @@ var q = {
 	_onEditorKeyDown(e) {
 		if (_(e)) return;
 		let t = e.currentTarget;
-		if (!(t?.localName === "u-date-picker" && (e.composedPath().some((e) => e instanceof Element && e.part?.contains("popover")) || e.key === "Escape" && Ye(t)))) {
+		if (!(t?.localName === "u-date-picker" && (e.composedPath().some((e) => e instanceof Element && e.part?.contains("popover")) || e.key === "Escape" && $(t)))) {
 			if (this._autocompleteState && this._autocompleteState.candidates.length > 0) {
 				if (e.key === "ArrowDown") {
 					e.preventDefault(), e.stopPropagation();
@@ -2822,7 +2835,7 @@ var q = {
 		this._activeCell = this._selection.activeCell ? { ...this._selection.activeCell } : null, this._scrollToActiveCell(), this._dispatchSelectionEvent();
 	}
 	_onKeyDown(e) {
-		if (this._editing.current) return;
+		if (this._editing.current || this._openFilterKey && e.composedPath().some((e) => e instanceof Element && e.classList.contains("ft-filter-dropdown"))) return;
 		let t = this.visibleColumns;
 		if ((e.ctrlKey || e.metaKey) && !e.altKey) {
 			let t = e.key.toLowerCase();
@@ -2888,12 +2901,12 @@ var q = {
 		if (!e.altKey || !this._activeCell || e.key !== "ArrowLeft" && e.key !== "ArrowRight") return !1;
 		e.preventDefault();
 		let n = t[this._activeCell.col];
-		return n && this._resizeColumnBy(n.key, e.key === "ArrowRight" ? X : -20), !0;
+		return n && this._resizeColumnBy(n.key, e.key === "ArrowRight" ? Y : -20), !0;
 	}
 	_resizeColumnBy(e, t) {
 		let n = this.visibleColumns.findIndex((t) => t.key === e), r = this.visibleColumns[n];
 		if (!r) return;
-		let i = this._columnWidths.get(r.key) ?? r.width ?? J, a = r.minWidth ?? Y, o = Math.max(a, i + t);
+		let i = this._columnWidths.get(r.key) ?? r.width ?? q, a = r.minWidth ?? J, o = Math.max(a, i + t);
 		this._columnWidths.set(r.key, o), this.requestUpdate(), this.dispatchEvent(new CustomEvent("column-resize", {
 			detail: {
 				key: r.key,
@@ -3215,7 +3228,7 @@ var q = {
 		return Math.min(n, i);
 	}
 	_renderHeaderCell(e, t) {
-		let n = e.sortable !== !1, r = this._sortCriteria.find((t) => t.key === e.key), o = this._sortCriteria.length > 1 ? this._sortCriteria.findIndex((t) => t.key === e.key) : -1, s = this._filters.some((t) => t.key === e.key), c = e.pinned === "left", l = e.pinned === "right", u = c || l, d = e.headerAlign ?? G(e), f = [
+		let n = e.sortable !== !1, r = this._sortCriteria.find((t) => t.key === e.key), o = this._sortCriteria.length > 1 ? this._sortCriteria.findIndex((t) => t.key === e.key) : -1, s = this._filters.some((t) => t.key === e.key), c = e.pinned === "left", l = e.pinned === "right", u = c || l, d = e.headerAlign ?? W(e), f = [
 			"ft-header-cell",
 			n ? "ft-sortable" : "",
 			u ? "ft-pinned" : "",
@@ -3349,8 +3362,9 @@ var q = {
 	_openFilterFromMenu(e) {
 		this._headerMenu = null, this._openFilterKey = e, requestAnimationFrame(() => {
 			document.addEventListener("click", this._onDocumentClick, { once: !0 });
-		}), this.updateComplete.then(() => {
-			this.shadowRoot?.querySelector(".ft-filter-dropdown input, .ft-filter-dropdown select")?.focus();
+		}), this.updateComplete.then(async () => {
+			let e = this.shadowRoot?.querySelector(".ft-filter-dropdown input, .ft-filter-dropdown select, .ft-filter-dropdown u-date-picker");
+			await e?.updateComplete, e?.focus();
 		});
 	}
 	_showHiddenBefore(e) {
@@ -3386,7 +3400,7 @@ var q = {
         ${r.map((e) => c("show", A("showColumn", { header: e.label }), () => this._setColumnHidden(e.key, !1)))}
         <div class="ft-header-menu-separator" role="separator"></div>
         ${c("autofit", A("autoFitWidth"), () => this._autoFitColumn(e))}
-        ${c("wider", A("wider"), () => this._resizeColumnBy(e, X), !0)}
+        ${c("wider", A("wider"), () => this._resizeColumnBy(e, Y), !0)}
         ${c("narrower", A("narrower"), () => this._resizeColumnBy(e, -20), !0)}
       </div>
     `;
@@ -3675,10 +3689,10 @@ var q = {
           @keydown=${(e) => {
 			e.key === "Escape" && (this._openFilterKey = null), e.stopPropagation();
 		}}>
-          ${Object.keys(q).map((e) => i`<option value=${e}>${q[e]}</option>`)}
+          ${Object.keys(K).map((e) => i`<option value=${e}>${K[e]}</option>`)}
         </select>
         <input class="ft-filter-input ft-num-cond-input" type="text" inputmode="decimal" placeholder=${A("valuePlaceholder")}
-          .value=${n.text ?? (n.value == null ? "" : P(n.value))}
+          .value=${n.text ?? (n.value == null ? "" : se(n.value))}
           aria-invalid=${n.text && n.value == null ? "true" : "false"}
           @input=${(n) => {
 			let r = n.target.value, i = this._numberFilterState.get(e) ?? this._defaultNumState();
@@ -3737,21 +3751,21 @@ var q = {
 		return n ? n.error : null;
 	}
 	_renderDateFilter(e) {
-		let t = e.type === "datetime" ? "datetime-local" : "date", n = this._dateFilterState.get(e.key) ?? {};
+		let t = e.type === "datetime", n = this._dateFilterState.get(e.key) ?? {}, r = (e) => e?.slice(0, 10), o = (e) => {
+			e.key === "Escape" && $(e.currentTarget) || (e.stopPropagation(), e.key === "Escape" && (this._openFilterKey = null));
+		};
 		return i`
-      <div class="ft-filter-range">
-        <input class="ft-filter-input" type=${t} placeholder=${A("fromPlaceholder")}
-          .value=${n.from ?? ""}
-          @input=${(t) => this._applyDateFilter(e.key, t, "from")}
-          @keydown=${(e) => {
-			e.key === "Escape" && (this._openFilterKey = null), e.stopPropagation();
-		}}>
-        <input class="ft-filter-input" type=${t} placeholder=${A("toPlaceholder")}
-          .value=${n.to ?? ""}
-          @input=${(t) => this._applyDateFilter(e.key, t, "to")}
-          @keydown=${(e) => {
-			e.key === "Escape" && (this._openFilterKey = null), e.stopPropagation();
-		}}>
+      <div class="ft-filter-range ft-filter-range-dates">
+        <u-date-picker class="ft-filter-date" size="sm" clearable
+          mode=${t ? "datetime" : "date"} label=${A("fromPlaceholder")}
+          .value=${n.from ?? ""} max=${r(n.to) ?? a}
+          @change=${(t) => this._applyDateFilter(e.key, t, "from")}
+          @keydown=${o}></u-date-picker>
+        <u-date-picker class="ft-filter-date" size="sm" clearable
+          mode=${t ? "datetime" : "date"} label=${A("toPlaceholder")}
+          .value=${n.to ?? ""} min=${r(n.from) ?? a}
+          @change=${(t) => this._applyDateFilter(e.key, t, "to")}
+          @keydown=${o}></u-date-picker>
       </div>
       ${this._renderEmptyFilterRow(e.key, () => {
 			this._dateFilterState.delete(e.key);
@@ -3759,7 +3773,7 @@ var q = {
     `;
 	}
 	_applyDateFilter(e, t, n) {
-		let r = t.target.value, i = this._dateFilterState.get(e) ?? {};
+		let r = t.target.value ?? "", i = this._dateFilterState.get(e) ?? {};
 		r === "" ? delete i[n] : i[n] = r, this._dateFilterState.set(e, i), this._emptyFilterState.delete(e), this._applyFilterForKey(e);
 	}
 	_renderBooleanFilter(e) {
@@ -3787,7 +3801,7 @@ var q = {
 		if (!n) return;
 		let r = this.shadowRoot?.querySelectorAll(`.ft-cell[data-col-index="${t}"]`), i = 0, a = this.shadowRoot?.querySelector(`.ft-header-cell[data-col-index="${t}"]`);
 		if (a && (i = Math.max(i, a.scrollWidth)), r) for (let e of r) i = Math.max(i, e.scrollWidth);
-		let o = n.minWidth ?? Y, s = Math.max(o, i + 8);
+		let o = n.minWidth ?? J, s = Math.max(o, i + 8);
 		this._columnWidths.set(n.key, s), this.requestUpdate(), this.dispatchEvent(new CustomEvent("column-resize", {
 			detail: {
 				key: n.key,
@@ -3800,7 +3814,7 @@ var q = {
 	}
 	_onResizeStart(e, t) {
 		e.preventDefault(), e.stopPropagation();
-		let n = this.visibleColumns[t], r = this._columnWidths.get(n.key) ?? n.width ?? J;
+		let n = this.visibleColumns[t], r = this._columnWidths.get(n.key) ?? n.width ?? q;
 		this._resizing = {
 			colIndex: t,
 			startX: e.clientX,
@@ -3808,13 +3822,13 @@ var q = {
 		};
 		let i = (e) => {
 			if (!this._resizing) return;
-			let t = e.clientX - this._resizing.startX, r = n.minWidth ?? Y, i = Math.max(r, this._resizing.startWidth + t);
+			let t = e.clientX - this._resizing.startX, r = n.minWidth ?? J, i = Math.max(r, this._resizing.startWidth + t);
 			this._columnWidths.set(n.key, i), this.requestUpdate();
 		}, a = () => {
 			document.removeEventListener("mousemove", i), document.removeEventListener("mouseup", o), this._resizeCleanup = null;
 		}, o = () => {
 			if (a(), this._resizing) {
-				let e = this._columnWidths.get(n.key) ?? J;
+				let e = this._columnWidths.get(n.key) ?? q;
 				this.dispatchEvent(new CustomEvent("column-resize", {
 					detail: {
 						key: n.key,
@@ -4406,7 +4420,7 @@ var q = {
 		let v = s || l, y = this._isCellInvalid(n, r), b = (this._findState?.results ?? []).findIndex((e) => e.row === n && e.col === r), x = b >= 0, S = x && b === this._findState.currentIndex, w = [
 			"ft-cell",
 			`ft-type-${t.type ?? "text"}`,
-			`ft-align-${G(t)}`,
+			`ft-align-${W(t)}`,
 			s ? "ft-active" : "",
 			l ? "ft-selected" : "",
 			f ? "ft-pinned" : "",
@@ -4441,7 +4455,7 @@ var q = {
 		let n = e[t.key], r = n == null ? "" : String(n);
 		if (t.type === "number") return i`
         <input class="ft-editor ft-editor-number" type="text" inputmode="decimal"
-          .value=${typeof n == "number" ? P(n) : r}
+          .value=${typeof n == "number" ? se(n) : r}
           @keydown=${this._onEditorKeyDown}
           @blur=${() => this._commitEdit()}>
       `;
@@ -4450,7 +4464,7 @@ var q = {
 			return i`
         <u-date-picker class="ft-editor ft-editor-${t.type}" size="sm"
           mode=${e ? "datetime" : "date"} ?confirm=${e}
-          .value=${Je(n, e)}
+          .value=${Ye(n, e)}
           @keydown=${this._onEditorKeyDown}
           @change=${() => this._commitEdit()}
           @blur=${() => this._commitEdit()}></u-date-picker>
@@ -4497,70 +4511,70 @@ var q = {
     `;
 	}
 };
-K([s({ type: Array })], $.prototype, "columns", void 0), K([s({
+G([s({ type: Array })], Q.prototype, "columns", void 0), G([s({
 	type: Array,
 	hasChanged: () => !0
-})], $.prototype, "data", null), K([s({
+})], Q.prototype, "data", null), G([s({
 	type: Boolean,
 	attribute: "clear-undo-on-data-change"
-})], $.prototype, "clearUndoOnDataChange", void 0), K([s({
+})], Q.prototype, "clearUndoOnDataChange", void 0), G([s({
 	type: Boolean,
 	attribute: "clear-selection-on-data-change"
-})], $.prototype, "clearSelectionOnDataChange", void 0), K([s({
+})], Q.prototype, "clearSelectionOnDataChange", void 0), G([s({
 	type: Number,
 	attribute: "row-height"
-})], $.prototype, "rowHeight", null), K([s({
+})], Q.prototype, "rowHeight", null), G([s({
 	type: Boolean,
 	attribute: "show-row-numbers"
-})], $.prototype, "showRowNumbers", void 0), K([s({
+})], Q.prototype, "showRowNumbers", void 0), G([s({
 	type: String,
 	reflect: !0
-})], $.prototype, "theme", void 0), K([s({
+})], Q.prototype, "theme", void 0), G([s({
 	type: Number,
 	attribute: "max-rows"
-})], $.prototype, "maxRows", void 0), K([s({ type: Boolean })], $.prototype, "editable", void 0), K([s({
+})], Q.prototype, "maxRows", void 0), G([s({ type: Boolean })], Q.prototype, "editable", void 0), G([s({
 	type: Boolean,
 	attribute: "show-filters"
-})], $.prototype, "showFilters", void 0), K([s({
+})], Q.prototype, "showFilters", void 0), G([s({
 	type: Boolean,
 	attribute: "show-context-menu"
-})], $.prototype, "showContextMenu", void 0), K([s({
+})], Q.prototype, "showContextMenu", void 0), G([s({
 	type: Number,
 	attribute: "frozen-rows"
-})], $.prototype, "frozenRows", void 0), K([s({
+})], Q.prototype, "frozenRows", void 0), G([s({
 	type: String,
 	attribute: "empty-message"
-})], $.prototype, "emptyMessage", void 0), K([s({
+})], Q.prototype, "emptyMessage", void 0), G([s({
 	type: String,
 	attribute: "no-matching-message"
-})], $.prototype, "noMatchingMessage", void 0), K([s({
+})], Q.prototype, "noMatchingMessage", void 0), G([s({
 	type: Boolean,
 	reflect: !0
-})], $.prototype, "loading", void 0), K([s({
+})], Q.prototype, "loading", void 0), G([s({
 	type: Boolean,
 	attribute: "import-enabled"
-})], $.prototype, "importEnabled", void 0), K([s({ type: Boolean })], $.prototype, "selectable", void 0), K([s({
+})], Q.prototype, "importEnabled", void 0), G([s({ type: Boolean })], Q.prototype, "selectable", void 0), G([s({
 	type: String,
 	attribute: "selection-mode"
-})], $.prototype, "selectionMode", null), K([s({
+})], Q.prototype, "selectionMode", null), G([s({
 	type: String,
 	attribute: "data-mode"
-})], $.prototype, "dataMode", void 0), K([s({
+})], Q.prototype, "dataMode", void 0), G([s({
 	type: Object,
 	attribute: "footer-data"
-})], $.prototype, "footerData", void 0), K([s({ attribute: !1 })], $.prototype, "stylesheets", void 0), K([s({
+})], Q.prototype, "footerData", void 0), G([s({ attribute: !1 })], Q.prototype, "stylesheets", void 0), G([s({
 	type: Number,
 	attribute: "max-undo-size"
-})], $.prototype, "maxUndoSize", null), K([c()], $.prototype, "_scrollTop", void 0), K([c()], $.prototype, "_scrollLeft", void 0), K([c()], $.prototype, "_viewportHeight", void 0), K([c()], $.prototype, "_viewportWidth", void 0), K([c()], $.prototype, "_activeCell", void 0), K([c()], $.prototype, "_editingCell", void 0), K([c()], $.prototype, "_sortCriteria", void 0), K([c()], $.prototype, "_openFilterKey", void 0), K([c()], $.prototype, "_rowSelectionVersion", void 0), K([c()], $.prototype, "_autocompleteState", void 0), K([c()], $.prototype, "_headerMenu", void 0), K([c()], $.prototype, "_bodyContextMenu", void 0), K([c()], $.prototype, "_commentPopup", void 0), K([c()], $.prototype, "_isDragOver", void 0), $ = K([o("flex-table")], $);
-function Je(e, t) {
+})], Q.prototype, "maxUndoSize", null), G([c()], Q.prototype, "_scrollTop", void 0), G([c()], Q.prototype, "_scrollLeft", void 0), G([c()], Q.prototype, "_viewportHeight", void 0), G([c()], Q.prototype, "_viewportWidth", void 0), G([c()], Q.prototype, "_activeCell", void 0), G([c()], Q.prototype, "_editingCell", void 0), G([c()], Q.prototype, "_sortCriteria", void 0), G([c()], Q.prototype, "_openFilterKey", void 0), G([c()], Q.prototype, "_rowSelectionVersion", void 0), G([c()], Q.prototype, "_autocompleteState", void 0), G([c()], Q.prototype, "_headerMenu", void 0), G([c()], Q.prototype, "_bodyContextMenu", void 0), G([c()], Q.prototype, "_commentPopup", void 0), G([c()], Q.prototype, "_isDragOver", void 0), Q = G([o("flex-table")], Q);
+function Ye(e, t) {
 	if (t) {
-		let t = ce(e);
+		let t = le(e);
 		return /^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/.test(t) ? t.replace(" ", "T") : void 0;
 	}
-	let n = se(e);
+	let n = ce(e);
 	return /^\d{4}-\d{2}-\d{2}$/.test(n) ? n : void 0;
 }
-function Ye(e) {
+function $(e) {
 	try {
 		return e.matches(":state(open)");
 	} catch {
@@ -4568,4 +4582,4 @@ function Ye(e) {
 	}
 }
 //#endregion
-export { j as a, M as i, G as n, k as o, V as r, C as s, $ as t };
+export { j as a, M as i, W as n, k as o, B as r, C as s, Q as t };

package/dist/flex-table.d.ts

@@ -492,6 +492,12 @@ export declare class FlexTable extends LitElement {
     private _numberFilterState;
     private _dateFilterState;
     private _emptyFilterState;
+    /**
+     * From/to bounds as two `u-date-picker`s — the cell editor's control, for the same reason: the native
+     * date inputs show the browser's UI language (`10/02/2026` in an English browser) while the table
+     * shows ISO. Two pickers, not one `u-date-range-picker`: either bound may be left open ("from this
+     * day on"), which a range value cannot say. Each bound's calendar stops at the other bound.
+     */
     private _renderDateFilter;
     private _applyDateFilter;
     private _renderBooleanFilter;

package/dist/flex-table.js

@@ -1,2 +1,2 @@
-import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./flex-table-DIQhqj12.js";
+import { a as e, i as t, n, o as r, r as i, s as a, t as o } from "./flex-table-h2noRChg.js";
 export { o as FlexTable, e as RowSelectionState, t as UndoStack, n as effectiveAlign, i as exportData, r as flexTableLocale, a as renderCell };

package/dist/odata/types.d.ts

@@ -1,4 +1,5 @@
 import type { SortCriteria } from '../core/sorting.js';
+import type { SourceError } from '../core/source-error.js';
 export interface UseODataSourceOptions {
     pageSize?: number;
     defaultOrderBy?: string;
@@ -43,7 +44,11 @@ export interface UseODataSourceResult<T> {
     data: T[];
     totalCount: number;
     loading: boolean;
-    error: string | null;
+    /**
+     * 마지막 요청의 실패, 없으면 `null`. 화면에는 `error.message` 를 그린다. «어떤 실패인가» 는
+     * `status`(HTTP) · `code`(서버의 거절 코드) · `details` 로 가른다 — 401 은 `onUnauthorized` 도 부른다.
+     */
+    error: SourceError | null;
     page: number;
     setPage: (page: number) => void;
     sortCriteria: SortCriteria[];

package/dist/react.d.ts

@@ -69,3 +69,4 @@ export { useODataSource } from './odata/use-odata-source.js';
 export type { UseODataSourceOptions, UseODataSourceResult } from './odata/types.js';
 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';

package/dist/react.js

@@ -1,47 +1,74 @@
-import { t as e } from "./flex-table-DIQhqj12.js";
+import { t as e } from "./flex-table-h2noRChg.js";
 import { i as t, t as n } from "./query-Dw4iO0ir.js";
 import { t as r } from "./view-DiLr-TdY.js";
 import i, { useCallback as a, useEffect as o, useMemo as s, useRef as c, useState as l } from "react";
 import { createComponent as u } from "@lit/react";
+//#region src/core/source-error.ts
+async function d(e) {
+	let t = await e.text().catch(() => ""), n = {
+		message: `Request failed (${e.status})`,
+		status: e.status
+	};
+	if (!t) return n;
+	let r = t;
+	try {
+		r = JSON.parse(t);
+	} catch {}
+	if (n.body = r, !r || typeof r != "object") return n;
+	let i = r, a = i.error && typeof i.error == "object" ? i.error : i;
+	typeof a.message == "string" && a.message ? n.message = a.message : typeof i.message == "string" && i.message && (n.message = i.message), typeof a.code == "string" && a.code && (n.code = a.code);
+	let o = f(a.details);
+	return o && (n.details = o), n;
+}
+function f(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 p = class extends Error {
+	constructor(e) {
+		super(e.message), this.name = "SourceRequestError", this.failure = e;
+	}
+};
+function m(e) {
+	return e instanceof p ? e.failure : e instanceof Error ? { message: e.message } : { message: String(e) };
+}
+//#endregion
 //#region src/odata/use-odata-source.ts
-function d(e, r = {}) {
-	let { pageSize: i = 20, defaultOrderBy: s, initialPage: u = 0, initialSearch: d = "", initialSort: f, fixedFilter: p, baseUrl: m, fetcher: h = fetch, onUnauthorized: g, enabled: _ = !0 } = r, v = p ? JSON.stringify(p) : "", [y, b] = l([]), [x, S] = l(0), [C, w] = l(!1), [T, E] = l(null), D = t({
+function h(e, r = {}) {
+	let { pageSize: i = 20, defaultOrderBy: s, initialPage: u = 0, initialSearch: f = "", initialSort: h, fixedFilter: g, baseUrl: _, fetcher: v = fetch, onUnauthorized: y, enabled: b = !0 } = r, x = g ? JSON.stringify(g) : "", [S, C] = l([]), [w, T] = l(0), [E, D] = l(!1), [O, k] = l(null), A = t({
 		defaultOrderBy: s,
 		initialPage: u,
-		initialSearch: d,
-		initialSort: f
-	}), [O, k] = l(D.page), [A, j] = l(D.sortCriteria), [M, N] = l(D.search), [P, F] = l(0), [I, L] = l(v);
-	v !== I && (L(v), k(0));
-	let R = c(null), z = a(() => {
-		F((e) => e + 1);
-	}, []), B = a((e) => {
-		N(e), k(0);
-	}, []), V = a((e) => {
+		initialSearch: f,
+		initialSort: h
+	}), [j, M] = l(A.page), [N, P] = l(A.sortCriteria), [F, I] = l(A.search), [L, R] = l(0), [z, B] = l(x);
+	x !== z && (B(x), M(0));
+	let V = c(null), H = a(() => {
+		R((e) => e + 1);
+	}, []), U = a((e) => {
+		I(e), M(0);
+	}, []), W = a((e) => {
 		let t = e.detail?.criteria;
-		t && (j(t), k(0));
+		t && (P(t), M(0));
 	}, []);
 	return o(() => {
-		if (R.current?.abort(), !_) return;
+		if (V.current?.abort(), !b) return;
 		let t = new AbortController();
-		R.current = t, w(!0), E(null);
+		V.current = t, D(!0), k(null);
 		let r = n({
-			page: O,
+			page: j,
 			pageSize: i,
-			sortCriteria: A,
+			sortCriteria: N,
 			defaultOrderBy: s,
-			search: M,
-			fixedFilter: p
-		}), a = `${m ?? window.location.origin}${e}${r}`, o = async (e) => {
-			let n = await h(e, { signal: t.signal });
-			if (!n.ok) {
-				n.status === 401 && g && g(n);
-				let e = await n.text().catch(() => ""), t = `Request failed (${n.status})`;
-				try {
-					let n = JSON.parse(e);
-					t = n?.error?.message ?? n?.message ?? t;
-				} catch {}
-				throw Error(t);
-			}
+			search: F,
+			fixedFilter: g
+		}), a = `${_ ?? window.location.origin}${e}${r}`, o = async (e) => {
+			let n = await v(e, { signal: t.signal });
+			if (!n.ok) throw n.status === 401 && y && y(n), new p(await d(n));
 			return n.json();
 		};
 		return (async () => {
@@ -61,42 +88,42 @@ function d(e, r = {}) {
 		})().then(({ count: e, rows: n }) => {
 			if (t.signal.aborted) return;
 			let r = e ?? 0;
-			b(n), S(r), E(null);
+			C(n), T(r), k(null);
 			let a = r === 0 ? 0 : Math.ceil(r / i) - 1;
-			O > a && k(a);
+			j > a && M(a);
 		}).catch((e) => {
-			t.signal.aborted || e.name !== "AbortError" && (E(e.message), b([]), S(0));
+			t.signal.aborted || e.name !== "AbortError" && (k(m(e)), C([]), T(0));
 		}).finally(() => {
-			t.signal.aborted || w(!1);
+			t.signal.aborted || D(!1);
 		}), () => t.abort();
 	}, [
-		_,
+		b,
 		e,
-		O,
+		j,
 		i,
-		A,
-		M,
-		v,
+		N,
+		F,
+		x,
 		s,
-		P,
-		m
+		L,
+		_
 	]), {
-		data: y,
-		totalCount: x,
-		loading: C || !_,
-		error: T,
-		page: O,
-		setPage: k,
-		sortCriteria: A,
-		onSortChange: V,
-		search: M,
-		setSearch: B,
-		refresh: z
+		data: S,
+		totalCount: w,
+		loading: E || !b,
+		error: O,
+		page: j,
+		setPage: M,
+		sortCriteria: N,
+		onSortChange: W,
+		search: F,
+		setSearch: U,
+		refresh: H
 	};
 }
 //#endregion
 //#region src/array/use-array-source.ts
-function f(e, n = {}) {
+function g(e, n = {}) {
 	let { pageSize: i = 20, defaultOrderBy: o, initialPage: c = 0, initialSearch: u = "", initialSort: d, columns: f, searchFields: p } = n, m = t({
 		defaultOrderBy: o,
 		initialPage: c,
@@ -137,7 +164,7 @@ function f(e, n = {}) {
 		refresh: C
 	};
 }
-var p = u({
+var _ = u({
 	tagName: "flex-table",
 	elementClass: e,
 	react: i,
@@ -176,4 +203,4 @@ var p = u({
 	}
 });
 //#endregion
-export { p as FlexTableReact, f as useArraySource, d as useODataSource };
+export { _ as FlexTableReact, g as useArraySource, h as useODataSource };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/flex-table",
-  "version": "0.46.0",
+  "version": "0.47.0",
   "description": "A minimalist, input-centric data grid web component",
   "type": "module",
   "main": "./dist/flex-table.js",
@@ -45,6 +45,7 @@
     "build": "npm run typecheck && vite build && tsc --emitDeclarationOnly",
     "build:demo": "vite build --config vite.config.demo.ts",
     "typecheck": "tsc --noEmit && tsc -p tsconfig.test.json",
+    "pretest": "node -e \"if(require('fs').existsSync('../../scripts/sibling-dist-check.js'))require('child_process').execFileSync('node',['../../scripts/sibling-dist-check.js'],{stdio:'inherit'})\"",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/",

package/skills/iyulab-flex-table/SKILL.md

@@ -127,7 +127,7 @@ Server paging from OData or an in-memory array uses the same binding — see `re
 - Styles for elements returned by `render` must be passed through the `stylesheets` property
   (constructable `CSSStyleSheet[]`); document CSS does not cross the shadow boundary.
 - `useODataSource` `fetcher` / `onUnauthorized` must be stable references (`useCallback`).
-- Always render `error` from `useODataSource`; a failed request otherwise leaves the grid empty.
+- Always render `error.message` from `useODataSource`; a failed request otherwise leaves the grid empty. Branch on `error.status` / `error.code` rather than parsing the message.
 
 ## References
 

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

@@ -73,7 +73,7 @@ function Orders() {
   return (
     <>
       <input value={source.search} onChange={(e) => source.setSearch(e.target.value)} />
-      {source.error && <p role="alert">{source.error}</p>}
+      {source.error && <p role="alert">{source.error.message}</p>}
       <FlexTableReact<Order>
         dataMode="server"
         columns={columns}
@@ -111,7 +111,7 @@ function Orders() {
 |---|---|
 | `data`, `totalCount` | Current page and `@odata.count`; `@odata.nextLink` is followed to fill a page |
 | `loading` | Request in flight |
-| `error` | `string \| null` — render it |
+| `error` | `SourceError \| null` — `{ message, status?, code?, details?, body? }`; render `error.message`, branch on `status` / `code` (OData `error.code`) |
 | `page`, `setPage` | Zero-based |
 | `sortCriteria`, `onSortChange` | Pass `onSortChange` to the table's `sort-change` (resets to page 0) |
 | `search`, `setSearch` | Literal text (resets to page 0) |