cenitu-table 0.2.0 → 0.4.0-beta.0

package/dist/react.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const _=require("react/jsx-runtime"),r=require("react"),C=require("./index-BJIaMXd1.cjs"),T=["fixedRowsTop","fixedColumnsStart","readOnly","columns","colHeaders","mergeCells","columnSorting","filters","fillHandle","locale","language","contextMenu"],E=r.forwardRef(function(e,g){const l=r.useRef(null),t=r.useRef(null),u=r.useRef(e);u.current=e,r.useLayoutEffect(()=>{const{className:c,style:h,onChange:S,onSelection:j,onSort:w,onFilter:v,...x}=u.current,d=new C.CenituGrid(l.current,x);return d.addHook("afterChange",(s,a)=>{var n,i;return(i=(n=u.current).onChange)==null?void 0:i.call(n,s,a)}),d.addHook("afterSelection",(s,a,n,i)=>{var y,R;return(R=(y=u.current).onSelection)==null?void 0:R.call(y,s,a,n,i)}),d.addHook("afterColumnSort",(s,a)=>{var n,i;return(i=(n=u.current).onSort)==null?void 0:i.call(n,s,a)}),d.addHook("afterFilter",s=>{var a,n;return(n=(a=u.current).onFilter)==null?void 0:n.call(a,s)}),t.current=d,()=>{d.destroy(),t.current=null}},[]),r.useImperativeHandle(g,()=>t.current,[]);const m=r.useRef(!1);r.useEffect(()=>{if(!m.current)return;const c=t.current;c&&e.data&&!H(c,e.data)&&c.loadData(e.data)},[e.data]);const f=T.map(c=>e[c]);return r.useEffect(()=>{var h;if(!m.current)return;const c={};T.forEach(S=>e[S]!==void 0&&(c[S]=e[S])),(h=t.current)==null||h.updateSettings(c)},f),r.useEffect(()=>{m.current=!0},[]),_.jsx("div",{ref:l,className:e.className,style:e.style})});function H(o,e){if(!C.isObjectData(e))return b(o.getSourceData(),e);if(o.getSourceObjects()===e)return!0;const g=Array.from({length:o.countCols()},(l,t)=>o.colToProp(t));return b(o.getBoundRows(),C.ObjectBinding.create(e,g).toRows())}function b(o,e){const g=Math.max(o.length,e.length);for(let l=0;l<g;l++){const t=o[l]??[],u=e[l]??[],m=Math.max(t.length,u.length);for(let f=0;f<m;f++)if((t[f]??null)!==(u[f]??null))return!1}return!0}exports.CenituGrid=C.CenituGrid;exports.CenituTable=E;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const b=require("react/jsx-runtime"),s=require("react"),h=require("./index-Bidvqh7P.cjs"),w=["fixedRowsTop","fixedColumnsStart","readOnly","columns","colHeaders","mergeCells","columnSorting","filters","fillHandle","locale","language","contextMenu","search","query","totalCount","loading","loadError"],H=s.forwardRef(function(e,C){const f=s.useRef(null),u=s.useRef(null),r=s.useRef(e);r.current=e,s.useLayoutEffect(()=>{const{className:a,style:y,onChange:m,onSelection:x,onSort:E,onFilter:D,onQueryChange:j,onRowClick:v,onRowDoubleClick:q,onColumnLayoutChange:L,..._}=r.current,c=new h.CenituGrid(f.current,_);return c.addHook("afterChange",(o,n)=>{var t,l;return(l=(t=r.current).onChange)==null?void 0:l.call(t,o,n)}),c.addHook("afterSelection",(o,n,t,l)=>{var R,S;return(S=(R=r.current).onSelection)==null?void 0:S.call(R,o,n,t,l)}),c.addHook("afterColumnSort",(o,n)=>{var t,l;return(l=(t=r.current).onSort)==null?void 0:l.call(t,o,n)}),c.addHook("afterFilter",o=>{var n,t;return(t=(n=r.current).onFilter)==null?void 0:t.call(n,o)}),c.addHook("afterQueryChange",(o,n)=>{var t,l;return(l=(t=r.current).onQueryChange)==null?void 0:l.call(t,o,n)}),c.addHook("afterRowClick",o=>{var n,t;return(t=(n=r.current).onRowClick)==null?void 0:t.call(n,o)}),c.addHook("afterRowDoubleClick",o=>{var n,t;return(t=(n=r.current).onRowDoubleClick)==null?void 0:t.call(n,o)}),c.addHook("afterColumnLayout",o=>{var n,t;return(t=(n=r.current).onColumnLayoutChange)==null?void 0:t.call(n,o)}),u.current=c,()=>{c.destroy(),u.current=null}},[]),s.useImperativeHandle(C,()=>u.current,[]);const g=s.useRef(!1);s.useEffect(()=>{if(!g.current)return;const a=u.current;!a||!e.data||(e.dataMode==="server"?a.setPageRows(e.data,e.totalCount):T(a,e.data)||a.loadData(e.data))},[e.data]);const d=w.map(a=>e[a]);return s.useEffect(()=>{var y;if(!g.current)return;const a={};w.forEach(m=>e[m]!==void 0&&(a[m]=e[m])),(y=u.current)==null||y.updateSettings(a)},d),s.useEffect(()=>{g.current=!0},[]),b.jsx("div",{ref:f,className:e.className,style:e.style})});function T(i,e){if(!h.isObjectData(e))return k(i.getSourceData(),e);if(i.getSourceObjects()===e)return!0;const C=Array.from({length:i.countCols()},(f,u)=>i.colToProp(u));return k(i.getBoundRows(),h.ObjectBinding.create(e,C).toRows())}function k(i,e){const C=Math.max(i.length,e.length);for(let f=0;f<C;f++){const u=i[f]??[],r=e[f]??[],g=Math.max(u.length,r.length);for(let d=0;d<g;d++)if((u[d]??null)!==(r[d]??null))return!1}return!0}exports.CenituGrid=h.CenituGrid;exports.CenituTable=H;

package/dist/react.js

@@ -1,7 +1,7 @@
-import { jsx as T } from "react/jsx-runtime";
-import { forwardRef as E, useRef as S, useLayoutEffect as O, useImperativeHandle as R, useEffect as C } from "react";
-import { C as b, i as j, O as v } from "./index-DG98ykBX.js";
-const _ = [
+import { jsx as H } from "react/jsx-runtime";
+import { forwardRef as x, useRef as g, useLayoutEffect as b, useImperativeHandle as D, useEffect as y } from "react";
+import { C as E, i as T, O as v } from "./index-BIH30fQ2.js";
+const k = [
   "fixedRowsTop",
   "fixedColumnsStart",
   "readOnly",
@@ -13,58 +13,75 @@ const _ = [
   "fillHandle",
   "locale",
   "language",
-  "contextMenu"
-], G = E(function(t, d) {
-  const a = S(null), e = S(null), o = S(t);
-  o.current = t, O(() => {
-    const { className: c, style: h, onChange: g, onSelection: N, onSort: F, onFilter: I, ...w } = o.current, f = new b(a.current, w);
-    return f.addHook("afterChange", (u, l) => {
-      var n, s;
-      return (s = (n = o.current).onChange) == null ? void 0 : s.call(n, u, l);
-    }), f.addHook("afterSelection", (u, l, n, s) => {
-      var x, y;
-      return (y = (x = o.current).onSelection) == null ? void 0 : y.call(x, u, l, n, s);
-    }), f.addHook("afterColumnSort", (u, l) => {
-      var n, s;
-      return (s = (n = o.current).onSort) == null ? void 0 : s.call(n, u, l);
-    }), f.addHook("afterFilter", (u) => {
-      var l, n;
-      return (n = (l = o.current).onFilter) == null ? void 0 : n.call(l, u);
-    }), e.current = f, () => {
-      f.destroy(), e.current = null;
+  "contextMenu",
+  "search",
+  "query",
+  "totalCount",
+  "loading",
+  "loadError"
+], P = x(function(e, d) {
+  const i = g(null), a = g(null), r = g(e);
+  r.current = e, b(() => {
+    const { className: u, style: h, onChange: m, onSelection: O, onSort: j, onFilter: M, onQueryChange: N, onRowClick: F, onRowDoubleClick: I, onColumnLayoutChange: Q, ..._ } = r.current, l = new E(i.current, _);
+    return l.addHook("afterChange", (o, n) => {
+      var t, c;
+      return (c = (t = r.current).onChange) == null ? void 0 : c.call(t, o, n);
+    }), l.addHook("afterSelection", (o, n, t, c) => {
+      var w, S;
+      return (S = (w = r.current).onSelection) == null ? void 0 : S.call(w, o, n, t, c);
+    }), l.addHook("afterColumnSort", (o, n) => {
+      var t, c;
+      return (c = (t = r.current).onSort) == null ? void 0 : c.call(t, o, n);
+    }), l.addHook("afterFilter", (o) => {
+      var n, t;
+      return (t = (n = r.current).onFilter) == null ? void 0 : t.call(n, o);
+    }), l.addHook("afterQueryChange", (o, n) => {
+      var t, c;
+      return (c = (t = r.current).onQueryChange) == null ? void 0 : c.call(t, o, n);
+    }), l.addHook("afterRowClick", (o) => {
+      var n, t;
+      return (t = (n = r.current).onRowClick) == null ? void 0 : t.call(n, o);
+    }), l.addHook("afterRowDoubleClick", (o) => {
+      var n, t;
+      return (t = (n = r.current).onRowDoubleClick) == null ? void 0 : t.call(n, o);
+    }), l.addHook("afterColumnLayout", (o) => {
+      var n, t;
+      return (t = (n = r.current).onColumnLayoutChange) == null ? void 0 : t.call(n, o);
+    }), a.current = l, () => {
+      l.destroy(), a.current = null;
     };
-  }, []), R(d, () => e.current, []);
-  const m = S(!1);
-  C(() => {
-    if (!m.current) return;
-    const c = e.current;
-    c && t.data && !D(c, t.data) && c.loadData(t.data);
-  }, [t.data]);
-  const i = _.map((c) => t[c]);
-  return C(() => {
+  }, []), D(d, () => a.current, []);
+  const C = g(!1);
+  y(() => {
+    if (!C.current) return;
+    const u = a.current;
+    !u || !e.data || (e.dataMode === "server" ? u.setPageRows(e.data, e.totalCount) : L(u, e.data) || u.loadData(e.data));
+  }, [e.data]);
+  const f = k.map((u) => e[u]);
+  return y(() => {
     var h;
-    if (!m.current) return;
-    const c = {};
-    _.forEach((g) => t[g] !== void 0 && (c[g] = t[g])), (h = e.current) == null || h.updateSettings(c);
-  }, i), C(() => {
-    m.current = !0;
-  }, []), /* @__PURE__ */ T("div", { ref: a, className: t.className, style: t.style });
+    if (!C.current) return;
+    const u = {};
+    k.forEach((m) => e[m] !== void 0 && (u[m] = e[m])), (h = a.current) == null || h.updateSettings(u);
+  }, f), y(() => {
+    C.current = !0;
+  }, []), /* @__PURE__ */ H("div", { ref: i, className: e.className, style: e.style });
 });
-function D(r, t) {
-  if (!j(t)) return H(r.getSourceData(), t);
-  if (r.getSourceObjects() === t) return !0;
-  const d = Array.from({ length: r.countCols() }, (a, e) => r.colToProp(e));
-  return H(r.getBoundRows(), v.create(t, d).toRows());
+function L(s, e) {
+  if (!T(e)) return R(s.getSourceData(), e);
+  if (s.getSourceObjects() === e) return !0;
+  const d = Array.from({ length: s.countCols() }, (i, a) => s.colToProp(a));
+  return R(s.getBoundRows(), v.create(e, d).toRows());
 }
-function H(r, t) {
-  const d = Math.max(r.length, t.length);
-  for (let a = 0; a < d; a++) {
-    const e = r[a] ?? [], o = t[a] ?? [], m = Math.max(e.length, o.length);
-    for (let i = 0; i < m; i++) if ((e[i] ?? null) !== (o[i] ?? null)) return !1;
+function R(s, e) {
+  const d = Math.max(s.length, e.length);
+  for (let i = 0; i < d; i++) {
+    const a = s[i] ?? [], r = e[i] ?? [], C = Math.max(a.length, r.length);
+    for (let f = 0; f < C; f++) if ((a[f] ?? null) !== (r[f] ?? null)) return !1;
   }
   return !0;
 }
 export {
-  b as CenituGrid,
-  G as CenituTable
+  E as CenituGrid,
+  P as CenituTable
 };

package/dist/types/export/index.d.ts

@@ -4,3 +4,5 @@ export { toXLSX, toXLSXCompressed, xlsxParts, sanitizeSheetNames, pxToColWidth,
 export { numberFormatFromMeta, isDateFormat, formatDateCode, dateCodeFromPattern } from './numberFormat.js';
 export { downloadBlob, CSV_MIME } from './download.js';
 export { crc32, zipStore, zipDeflate, type ZipEntry } from './zip.js';
+export { readXLSX, workbookEngine, type ImportOptions, type ImportSheet, type ImportWorkbook } from './xlsxRead.js';
+export { ZipReader, type UnzipOptions } from './unzip.js';

package/dist/types/export/types.d.ts

@@ -6,6 +6,7 @@ export interface ExportCellFormat {
     bold?: boolean;
     italic?: boolean;
     underline?: boolean;
+    strike?: boolean;
     /** '#rrggbb' (or '#rgb'). */
     color?: string;
     background?: string;

package/dist/types/export/unzip.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Minimal ZIP reader (PKWARE APPNOTE 6.3), enough for spreadsheet packages: finds entries through
+ * the central directory and inflates them with the platform DecompressionStream. No ZIP64 and no
+ * encryption. Sizes are enforced while inflating, so a crafted archive cannot exhaust memory.
+ */
+export interface UnzipOptions {
+    /** Upper limit for the total uncompressed size in bytes (default 1 GiB). */
+    maxSize?: number;
+}
+/** Lists a package and gives access to its entries by path. */
+export declare class ZipReader {
+    private readonly bytes;
+    private readonly entries;
+    private remaining;
+    constructor(bytes: Uint8Array, opts?: UnzipOptions);
+    has(path: string): boolean;
+    get paths(): string[];
+    /** Uncompressed content of an entry; undefined when the package has no such entry. */
+    read(path: string): Promise<Uint8Array | undefined>;
+    readText(path: string): Promise<string | undefined>;
+}

package/dist/types/export/xlsxRead.d.ts

@@ -0,0 +1,35 @@
+import { FormulaEngine } from '../formula/engine.js';
+import type { ExportCellFormat, ExportSheet } from './types.js';
+import { type UnzipOptions } from './unzip.js';
+export interface ImportOptions extends UnzipOptions {
+    /** 'keep' (default) imports formulas; 'values' replaces them with the results stored in the file. */
+    formulas?: 'keep' | 'values';
+}
+/** One worksheet of a file; the same shape the exporters take, plus what only applies to imports. */
+export interface ImportSheet extends ExportSheet {
+    hiddenColumns: number[];
+    /** Sheet is hidden in the file. */
+    hidden: boolean;
+    format: (row: number, col: number) => ExportCellFormat | undefined;
+}
+export interface ImportWorkbook {
+    sheets: ImportSheet[];
+    /** Workbook-level defined names: name -> expression (`=Sheet1!$A$1`). */
+    names: {
+        name: string;
+        expression: string;
+    }[];
+}
+type Binary = ArrayBuffer | Uint8Array | Blob;
+/**
+ * Reads an .xlsx file: values, formulas, number formats, fonts, fills, alignment, column widths,
+ * row heights, frozen panes, merges and defined names. Charts, images, comments, conditional
+ * formats and data validation are not read.
+ */
+export declare function readXLSX(file: Binary, opts?: ImportOptions): Promise<ImportWorkbook>;
+/**
+ * Engine holding all sheets of a workbook (still empty) and its defined names. Create one grid per
+ * sheet on it and call `loadSheet`, so cross-sheet formulas find each other in any order.
+ */
+export declare function workbookEngine(workbook: ImportWorkbook): FormulaEngine;
+export {};

package/dist/types/export/xlsxStyles.d.ts

@@ -0,0 +1,23 @@
+import type { CellMeta, NumericFormat } from '../grid/cellTypes.js';
+import type { ExportCellFormat } from './types.js';
+export declare function parseThemeColors(xml: string | undefined): string[];
+/** Resolved cell formats of a workbook: cell `s` attribute -> grid-independent format. */
+export declare class XlsxStyles {
+    private readonly theme;
+    private readonly codes;
+    private readonly fonts;
+    private readonly fills;
+    private readonly xfs;
+    private readonly cache;
+    constructor(xml: string | undefined, theme: string[]);
+    private parse;
+    numberFormat(style: number): string | undefined;
+    isDate(style: number): boolean;
+    format(style: number): ExportCellFormat | undefined;
+}
+/** Date pattern for a format code, when every token has a grid equivalent. */
+export declare function patternFromDateCode(code: string): string | undefined;
+/** Number display settings for a simple format code; complex codes keep the default display. */
+export declare function numericFormatFromCode(code: string): NumericFormat | undefined;
+/** Cell settings that make the grid display a format like the file does. */
+export declare function metaFromFormat(f: ExportCellFormat): CellMeta;

package/dist/types/export/xmlReader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Streaming XML scanner for package parts. Namespace prefixes are dropped from element and
+ * attribute names (`x:row` -> `row`), which is what spreadsheet parts need. DOCTYPE declarations
+ * are skipped and only the predefined and numeric entities are decoded, so a crafted file cannot
+ * expand entities or reach external resources.
+ */
+export type XmlAttrs = Record<string, string>;
+export interface XmlHandler {
+    open?(name: string, attrs: XmlAttrs, selfClosing: boolean): void;
+    close?(name: string): void;
+    text?(text: string): void;
+}
+export declare function decodeEntities(s: string): string;
+/** Reports elements and text in document order; throws on an unterminated construct. */
+export declare function scanXml(xml: string, h: XmlHandler): void;

package/dist/types/grid/cellTypes.d.ts

@@ -1,4 +1,5 @@
 import type { ConditionOp } from './filters.js';
+import type { ServerFilterDef } from './serverMode.js';
 import { type CellValue, type RawCell } from '../formula/values.js';
 export type CellType = 'text' | 'numeric' | 'date' | 'checkbox' | 'dropdown';
 export interface NumericFormat {
@@ -43,6 +44,12 @@ export interface CellRenderContext {
 }
 /** Settings that can be given per column (`columns`) or per cell (`cells`). */
 export interface CellMeta {
+    /** Stable column id used in server queries and change events; default `data`. */
+    id?: string;
+    /** Server mode: the server can sort this column. */
+    sortable?: boolean;
+    /** Server mode: what the server can filter this column by. */
+    serverFilter?: ServerFilterDef;
     /** Object mode: property path bound to this column, e.g. "qty" or "customer.name". */
     data?: string;
     type?: CellType;
@@ -51,7 +58,9 @@ export interface CellMeta {
     width?: number;
     readOnly?: boolean;
     numericFormat?: NumericFormat;
-    /** Tokens: DD, MM, YYYY, YY (default "DD.MM.YYYY" for tr, "YYYY-MM-DD" otherwise). */
+    /** Spreadsheet format code written to XLSX instead of one derived from these settings (set on import). */
+    formatCode?: string;
+    /** Tokens: DD, MM, YYYY, YY, HH, mm, ss (default "DD.MM.YYYY" for tr, "YYYY-MM-DD" otherwise). */
     dateFormat?: string;
     /** Allowed values of a dropdown cell. */
     source?: string[];

package/dist/types/grid/clipboardHtml.d.ts

@@ -0,0 +1,13 @@
+import type { CellStyle } from './cellTypes.js';
+/**
+ * The "text/html" clipboard flavour. Values always travel as tab-separated text; the HTML table
+ * only adds styling, which is what spreadsheet apps read from each other.
+ */
+export declare function styleToCss(s: CellStyle): string;
+export declare function tableHtml(texts: string[][], styles: (CellStyle | undefined)[][]): string;
+export interface HtmlTable {
+    texts: string[][];
+    styles: (CellStyle | undefined)[][];
+}
+/** First table of a clipboard document, with spans expanded; null when there is none. */
+export declare function parseHtmlTable(html: string, view: Window & typeof globalThis): HtmlTable | null;

package/dist/types/grid/columnMenu.d.ts

@@ -1,16 +1,26 @@
 import type { ColumnFilter, SortOrder } from './filters.js';
 import type { Messages } from './messages.js';
+import { type ServerFilter, type ServerFilterDef } from './serverMode.js';
 export interface ColumnMenuOptions {
     anchor: HTMLElement;
     messages: Messages;
+    locale?: string;
     sort: SortOrder | null;
+    /** Another column is sorted, so this one can be added as a further key. */
+    sortedElsewhere: boolean;
     filter: ColumnFilter | undefined;
     /** Distinct display texts of the column ("" = blanks), already sorted. */
     values: string[];
     sortable: boolean;
     filterable: boolean;
-    onSort(order: SortOrder | null): void;
+    onSort(order: SortOrder | null, add?: boolean): void;
     onFilter(filter: ColumnFilter | null): void;
+    /** Server mode: replaces the local filter controls. */
+    server?: {
+        def: ServerFilterDef;
+        value: ServerFilter | undefined;
+        onFilter(filter: ServerFilter | null): void;
+    };
     onClose(): void;
 }
 /** Excel-like column dropdown: sort buttons, a condition filter and a value checklist. */

package/dist/types/grid/filters.d.ts

@@ -9,6 +9,7 @@ export interface ColumnFilter {
     values?: string[];
 }
 export type SortOrder = 'asc' | 'desc';
-export declare function matchesFilter(value: CellValue, text: string, filter: ColumnFilter): boolean;
+/** Text comparisons follow `locale`, so Turkish I/ı and İ/i pair up correctly. */
+export declare function matchesFilter(value: CellValue, text: string, filter: ColumnFilter, locale?: string): boolean;
 /** Spreadsheet sort order: numbers, text, booleans, errors; blanks always last. */
-export declare function compareForSort(a: CellValue, b: CellValue, order: SortOrder): number;
+export declare function compareForSort(a: CellValue, b: CellValue, order: SortOrder, locale?: string): number;