@iyulab/flex-table 0.60.0 → 0.62.0

package/dist/flex-table.d.ts

@@ -11,12 +11,18 @@ import type { TemplateResult } from 'lit';
  * 표 내보내기의 대상 — 선택 범위(`selectionOnly`) 또는 바깥에서 준 행(`rows`, 예: `await source.fetchAll()`). 둘은
  * 함께 쓰지 않는다(바깥 행에는 표의 선택 범위가 없다).
  */
-export type TableExportOptions = {
+export type TableExportOptions = ({
     selectionOnly?: boolean;
     rows?: undefined;
 } | {
     rows: DataRow[];
     selectionOnly?: undefined;
+}) & {
+    /**
+     * CSV/TSV — start with a UTF-8 byte order mark so spreadsheet apps (Excel) read non-ASCII text correctly.
+     * Default: `true` for `exportToFile` (a file a person opens), `false` for `exportToString`/`exportToBlob`.
+     */
+    bom?: boolean;
 };
 export declare class FlexTable extends LitElement {
     static styles: import("lit").CSSResult;
@@ -199,7 +205,14 @@ export declare class FlexTable extends LitElement {
     get canRedo(): boolean;
     get activeCell(): CellPosition | null;
     get editingCell(): CellPosition | null;
+    /**
+     * The active sort — `[{ key, direction }]`, the first is the primary. Setting it shows that sort (the header
+     * indicators) and, in client mode, re-sorts; it does not fire `sort-change`, which is the user's act. A data
+     * source's `sortCriteria` goes here as is — the initial or restored sort of a server-paged list, the same as
+     * `u-rich-table`'s `sortCriteria`.
+     */
     get sortCriteria(): SortCriteria[];
+    set sortCriteria(criteria: SortCriteria[]);
     /** Number of rows after filtering (before pagination). */
     get filteredRowCount(): number;
     /**

package/dist/flex-table.js

@@ -1,3 +1,3 @@
-import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "./flex-table-kM69-hSo.js";
+import { a as e, c as t, i as n, n as r, o as i, r as a, s as o, t as s } from "./flex-table-CbBVOhRQ.js";
 import { t as c } from "./locale-D9g0ksXq.js";
 export { s as FlexTable, o as RowSelectionState, i as UndoStack, a as downloadBlob, r as effectiveAlign, n as exportData, e as exportDataBlob, c as flexTableLocale, t as renderCell };

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export type { ColumnFilter, FilterPredicate, FilterErrorCallback } from './core/
 export { RowSelectionState } from './core/row-selection.js';
 export { UndoStack } from './core/undo.js';
 export type { UndoAction } from './core/undo.js';
-export type { ExportFormat } from './export/export.js';
+export type { ExportFormat, ExportOptions } from './export/export.js';
 export { exportData, exportDataBlob, downloadBlob } from './export/export.js';
 export { renderCell } from './renderers/cell-renderer.js';
 export { flexTableLocale } from './locale.js';

package/dist/models/types.d.ts

@@ -102,6 +102,12 @@ export interface ColumnDefinition<T = DataRow> {
      * - Function: custom formatter receiving (value, row, col)
      */
     format?: string | ((value: unknown, row: T, col: ColumnDefinition<T>) => string);
+    /**
+     * The value export writes for this column — CSV/TSV/JSON/XLSX. Without it export writes the raw value (as
+     * `format`/`render` do not apply to export). Give it where the file should say what the list shows, e.g. a status
+     * code shown as a label: `exportValue: (v) => statusLabel(v)`. A returned `Date` becomes a date cell in XLSX.
+     */
+    exportValue?: (value: unknown, row: T) => string | number | boolean | Date | null | undefined;
     /** Per-column conditional formatting rules applied during cell rendering */
     conditionalRules?: ConditionalRule<T>[];
     /**

package/dist/react.js

@@ -1,4 +1,4 @@
-import { t as e } from "./flex-table-kM69-hSo.js";
+import { t as e } from "./flex-table-CbBVOhRQ.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";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/flex-table",
-  "version": "0.60.0",
+  "version": "0.62.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` |
 
@@ -133,11 +133,14 @@ Enter/Escape and blur-to-commit behavior.
 | `importFromFile(file)` | `Promise<void>`; `.xlsx`, `.csv`, `.tsv`; fires `data-import` |
 | `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) |
+| `exportToFile(format, filename?, options?)` | `Promise<void>` — triggers a download (xlsx compressed); CSV/TSV start with a UTF-8 BOM unless `{ bom: false }` |
 
 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.
+Table-less: `exportDataBlob(rows, columns, format, { bom? })` + `downloadBlob(blob, name)` from the root entry.
+
+A column's `exportValue(value, row)` is what export writes for it (default: the raw value — `format`/`render` do not
+apply). In XLSX a `date`/`datetime` column's ISO strings become date cells, at the wall-clock time the table shows.
 
 ## Events