@iyulab/flex-table 0.50.2 → 0.50.4

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## [0.50.4] - 2026-10-06
+
+### Fixed
+
+- **`useODataSource` reports `loading: true` from the first render** until the first response settles. The first
+  render used to return `loading: false` with no rows before the request went out, so a screen that shows an empty
+  state on `!loading && totalCount === 0` flashed "no results" for a frame on every mount. Mounting with
+  `enabled: false` already reported `loading: true`; both paths now follow one rule.
+
+## [0.50.3] - 2026-10-06
+
+### Documentation
+
+- README Quick Start looks the table up by its tag (`document.querySelector('flex-table')`), so the element is
+  typed in TypeScript and its `columns` / `data` are checked — `getElementById` gives a plain `HTMLElement`.
+
 ## [0.50.2] - 2026-10-06
 
 ### Documentation

package/README.md

@@ -20,12 +20,12 @@ npm install @iyulab/flex-table
 
 ```html
 <!-- The table is its own scroll container, so give it a height — see Sizing below. -->
-<flex-table id="table" style="height: 400px" row-height="32" show-row-numbers></flex-table>
+<flex-table style="height: 400px" row-height="32" show-row-numbers></flex-table>
 
 <script type="module">
   import '@iyulab/flex-table';
 
-  const table = document.getElementById('table');
+  const table = document.querySelector('flex-table'); // the tag gives the element its type
 
   table.columns = [
     { key: 'name', label: 'Name', type: 'text', width: 200 },
@@ -815,7 +815,7 @@ The hook returns:
 | Field | Description |
 |---|---|
 | `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 |
+| `loading` | A request is in flight, or none has answered yet (true from the first render until the first response settles, and while `enabled: false`) |
 | `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 |

package/dist/odata/types.d.ts

@@ -43,6 +43,10 @@ export interface UseODataSourceOptions {
 export interface UseODataSourceResult<T> {
     data: T[];
     totalCount: number;
+    /**
+     * 조회 중이거나 아직 한 번도 답을 받지 않았으면 `true` — 첫 렌더부터 첫 응답(성공·실패)이 정착할 때까지,
+     * 그리고 `enabled: false` 인 동안. 그래서 `!loading && totalCount === 0` 이 곧 «결과 없음» 이다.
+     */
     loading: boolean;
     /**
      * 마지막 요청의 실패, 없으면 `null`. 화면에는 `error.message` 를 그린다. «어떤 실패인가» 는

package/dist/react.js

@@ -40,7 +40,7 @@ function m(e) {
 //#endregion
 //#region src/odata/use-odata-source.ts
 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({
+	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(!0), [O, k] = l(null), A = t({
 		defaultOrderBy: s,
 		initialPage: u,
 		initialSearch: f,

package/package.json

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

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

@@ -110,7 +110,7 @@ function Orders() {
 | Field | Notes |
 |---|---|
 | `data`, `totalCount` | Current page and `@odata.count`; `@odata.nextLink` is followed to fill a page |
-| `loading` | Request in flight |
+| `loading` | Request in flight, or no answer yet (true from the first render until the first response settles, and while `enabled: false`) — so `!loading && totalCount === 0` means "no results" |
 | `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) |