@iyulab/flex-table 0.63.0 → 0.64.1

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.64.1] - 2026-10-08
+
+### Fixed
+
+- **CSV/TSV write dates as the wall clock the table shows.** A `date`/`datetime` column's value — a `Date`, or an ISO
+  string as JSON sources (OData) send it — was written raw or as `toISOString()`: UTC, so outside UTC the time in the
+  file differed from the screen (9 hours in Korea), a local-midnight `Date` in a `date` column became the day before,
+  and Excel did not read `…T…Z` as a date. It is now `YYYY-MM-DD` in a `date` column and `YYYY-MM-DD HH:mm:ss`
+  otherwise — the value an XLSX export already puts in its date cell. A string that does not read as a date stays as
+  it is; JSON is unchanged.
+- **A copied range writes dates the same way** — not the UTC string or `Date#toString()` — so it pastes into a
+  spreadsheet as a date and back into the table as the same local time.
+
+## [0.64.0] - 2026-10-08
+
+### Added
+
+- **`useODataSource` and `useArraySource` return `source`** — the source the hook binds, the same object every render.
+  A React screen hands it to a list skeleton that binds its views itself (`<ListPage source={orders.source}>`,
+  `bindSource(orders.source, el)`) and keeps its options as props, instead of building the source with `useMemo`,
+  reading it with `useSyncExternalStore` and calling `update` from an effect. `useArraySource`'s `source` reads the
+  hook's state and notifies its subscribers after each commit.
+
 ## [0.63.0] - 2026-10-08
 
 ### Added

package/README.md

@@ -316,7 +316,9 @@ What goes into the file:
   status code shown as a label: `{ key: 'status', render: …, exportValue: (v) => statusLabel(v) }`.
 - **Dates**: in XLSX a `date`/`datetime` column is a date cell — a `Date`, or an ISO string as JSON sources (OData) send
   it (`YYYY-MM-DD` is that day; a full ISO string is read with its offset), the same rule the cells display with. The
-  cell holds the wall-clock time the table shows. A string that does not read as a date stays text.
+  cell holds the wall-clock time the table shows. In CSV/TSV (and a copied range) the same date is wall-clock text —
+  `YYYY-MM-DD` in a `date` column, `YYYY-MM-DD HH:mm:ss` otherwise — which spreadsheets read as a date. JSON keeps
+  `Date` values as ISO instants. A string that does not read as a date stays text.
 - **BOM**: `{ bom: true }` starts CSV/TSV with a UTF-8 byte order mark so Excel on a non-UTF-8 system code page reads
   non-ASCII text correctly — the default for `exportToFile`, off for `exportToString`/`exportToBlob`.
 
@@ -911,6 +913,7 @@ The hook returns:
 | `search` / `setSearch` | Current search term and its setter (resets to page 0) |
 | `refresh` | Re-run the current request |
 | `fetchAll` | The whole result of the current conditions — the source's `fetchAll` (below), for exporting what the list shows |
+| `source` | The source the hook binds (the same object every render) — hand it to a list skeleton that binds views itself: `<ListPage source={orders.source}>` (`@iyulab/enterprise/react`) or `bindSource(orders.source, element)`. `useArraySource` returns one too, over its own state |
 
 #### Search semantics
 

package/dist/array/types.d.ts

@@ -1,6 +1,7 @@
 import type { SortCriteria } from '../core/sorting.js';
 import type { SourceError } from '../core/source-error.js';
 import type { FetchAllOptions } from '../core/fetch-all.js';
+import type { ArraySource } from './source.js';
 export interface UseArraySourceOptions<T> {
     /** 페이지당 행 수. `useODataSource`와 동일 기본값. */
     pageSize?: number;
@@ -30,7 +31,11 @@ export interface UseArraySourceOptions<T> {
      */
     searchFields?: (row: T) => Array<string | number | boolean | null | undefined>;
 }
+/** `useArraySource` 의 `source` — 목록 골격(`ListPage` · `bindSource`)에 넘기는 소스. 이 훅의 상태를 읽고 조작은 훅으로 간다. */
+export type HookArraySource<T> = Omit<ArraySource<T>, 'update'>;
 export interface UseArraySourceResult<T> {
+    /** 이 훅의 상태를 소스 모양으로 — `<ListPage source={orders.source}>` · `bindSource(orders.source, el)`. 늘 같은 객체다. */
+    source: HookArraySource<T>;
     /** 현재 페이지의 행(검색+정렬 적용 후 slice). */
     data: T[];
     /** 검색+정렬 적용 후, 페이지 나누기 전의 총 건수(`useODataSource`의 `@odata.count`와 동일 의미). */

package/dist/clipboard/clipboard.d.ts

@@ -2,7 +2,8 @@ import type { CellRange } from '../core/selection.js';
 import type { ColumnDefinition, DataRow } from '../models/types.js';
 /**
  * Copy selected range to clipboard as TSV — the spreadsheet clipboard format (see `encodeTsv`):
- * a cell containing a tab, a line break or a quote is quoted, so it pastes into Excel as one cell.
+ * a cell containing a tab, a line break or a quote is quoted, so it pastes into Excel as one cell. A date is its
+ * wall-clock text (as in a CSV export), which a spreadsheet reads as a date and a paste here reads back.
  */
 export declare function copyToClipboard(data: DataRow[], columns: ColumnDefinition[], range: CellRange): string;
 export declare function parseValueForColumn(raw: string, col: ColumnDefinition): unknown;

package/dist/export/values.d.ts

@@ -15,3 +15,9 @@ export declare function exportDate(value: unknown, col: ColumnDefinition): Date
  * 세면 로컬 자정의 날짜가 UTC 와 다른 시간대(한국 +09)에서 전날 오후로 들어가 날짜 서식에 전날이 보였다.
  */
 export declare function excelSerial(d: Date): number;
+/**
+ * 글자 형식(CSV·TSV)의 날짜 — **벽시계 글자**다(표가 보여 주는 로컬 날짜·시각, XLSX 의 날짜 셀과 같은 값). `date` 열은
+ * `YYYY-MM-DD`, 그 밖은 `YYYY-MM-DD HH:mm:ss` — 스프레드시트가 날짜로 읽는 모양이다. ISO(`toISOString`)는 UTC 라 UTC 가
+ * 아닌 시간대에서 시각이 화면과 달랐고, 로컬 자정의 날짜는 전날이 됐다.
+ */
+export declare function exportDateText(d: Date, col: ColumnDefinition): string;