cenitu-table 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cenitu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,137 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# CenituTable
+
+[![CI](https://github.com/cenitu/cenitu-table/actions/workflows/ci.yml/badge.svg)](https://github.com/cenitu/cenitu-table/actions/workflows/ci.yml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+A spreadsheet-like data grid with a built-in, multi-sheet formula engine. Written in TypeScript with **zero runtime dependencies**; an optional React component is included.
+
+**[Live demo](https://cenitu.github.io/cenitu-table/)** · [Türkçe](README.tr.md) · [Design notes](docs/SPEC.md)
+
+## Features
+
+- **Grid:** virtual scrolling (only visible cells are in the DOM), keyboard navigation (Ctrl+arrows jump to data edges), spreadsheet-compatible copy/cut/paste (TSV), undo/redo, column and row resizing, row/column insert and delete, right-click context menu.
+- **Sorting and filtering:** a column menu with condition and value filters. Only the view changes; data and formulas stay where they are.
+- **Autofill:** drag the fill handle to continue number and text series and to copy formulas with relative references; double-click to fill down; Ctrl+D.
+- **Cell types:** numeric (Intl formats: currency, percent), date, checkbox, dropdown; validators, read-only cells, custom renderers.
+- **Formatting:** bold, italic, underline, strike-through, colors, alignment, wrapping (Ctrl+B / I / U), conditional formatting for cells or whole rows.
+- **Layout:** frozen rows and columns, merged cells, hidden columns, column drag-and-drop.
+- **Formula engine:** 100+ functions (SUM, IF, XLOOKUP, SUMIFS, TEXT, date functions…), dynamic arrays that spill (FILTER, SORT, UNIQUE, SEQUENCE), cross-sheet references (`'Other sheet'!A1`), named expressions, incremental recalculation, cycle detection.
+- **Data binding:** rows as arrays or as objects bound to columns by property path; edits are written back to your objects.
+- **Export:** CSV (with protection against formula injection) and XLSX (formulas, formats, styles, frozen panes, merges) without any library.
+- **Accessibility:** ARIA grid roles and an announced active cell for screen readers.
+- **React:** `<CenituTable />` from `cenitu-table/react`.
+
+## Install
+
+```bash
+npm install cenitu-table
+```
+
+## Usage
+
+```ts
+import { CenituGrid } from 'cenitu-table';
+
+const grid = new CenituGrid(document.getElementById('grid')!, {
+  data: [
+    ['Product', 'Qty', 'Price', 'Total'],
+    ['Screw', 10, 2.5, '=B2*C2'],
+    ['Nut', 20, 1.25, '=B3*C3'],
+  ],
+  fixedRowsTop: 1,
+  columnSorting: true,
+  filters: true,
+  contextMenu: true,
+  columns: [
+    { type: 'dropdown', source: ['Screw', 'Nut', 'Washer'] },
+    { type: 'numeric', validator: (v) => Number(v) > 0 || 'Must be positive' },
+    { type: 'numeric', numericFormat: { style: 'currency', currency: 'EUR' } },
+    { type: 'numeric', numericFormat: { style: 'currency', currency: 'EUR' }, readOnly: true },
+  ],
+  height: 400,
+});
+
+grid.addHook('afterChange', (changes, source) => console.log(changes, source));
+grid.getDataAtCell(1, 3);       // 25 (computed value)
+grid.getSourceDataAtCell(1, 3); // "=B2*C2"
+```
+
+### Objects instead of arrays
+
+```ts
+const orders = [{ product: 'Screw', qty: 10, customer: { name: 'Acme' } }];
+
+new CenituGrid(el, {
+  data: orders,
+  columns: [{ data: 'product' }, { data: 'qty', type: 'numeric' }, { data: 'customer.name', title: 'Customer' }],
+  dataSchema: () => ({ product: '', qty: 0, customer: { name: '' } }),
+});
+// Edits are written back: orders[0].qty changes when the cell changes.
+```
+
+Formula cells write their computed value into the object and keep it current, so your properties stay plain values. Set `bindFormulas: 'text'` to store the formula text instead.
+
+### Several sheets
+
+Give one engine to several grids — one grid per sheet:
+
+```ts
+import { CenituGrid, FormulaEngine } from 'cenitu-table';
+
+const engine = FormulaEngine.buildEmpty();
+engine.addNamedExpression('VatRate', 0.2);
+new CenituGrid(el1, { formulas: engine, sheetName: 'Orders', data: orders });
+new CenituGrid(el2, { formulas: engine, sheetName: 'Summary', data: [['=SUM(Orders!F2:F100)*(1+VatRate)']] });
+```
+
+### Export
+
+```ts
+grid.downloadCSV('orders.csv');                      // ";" fields and "," decimals for decimal-comma locales
+await grid.downloadXLSX('book.xlsx', [summaryGrid]); // several sheets in one workbook
+```
+
+### React
+
+```tsx
+import { CenituTable } from 'cenitu-table/react';
+
+<CenituTable ref={gridRef} data={data} fixedRowsTop={1} onChange={(changes) => save(changes)} />;
+```
+
+### Formula engine on its own
+
+```ts
+import { FormulaEngine, registerFunction } from 'cenitu-table';
+
+const engine = FormulaEngine.buildFromArray([[1, 2, '=A1+B1']]);
+engine.setCellContents({ row: 0, col: 0 }, 10); // returns the changed cells
+engine.getCellValue({ row: 0, col: 2 });         // 12
+registerFunction('DOUBLE', { minArgs: 1, maxArgs: 1, impl: ([x]) => (x as number) * 2 });
+```
+
+### Localization
+
+```ts
+import { trTR } from 'cenitu-table';
+
+new CenituGrid(el, { locale: 'tr-TR', language: trTR, data });
+```
+
+`locale` drives number and date formatting; `language` holds the UI texts (English by default, Turkish included).
+
+## Development
+
+```bash
+npm install
+npm run dev        # demo at http://localhost:5180
+npm test           # unit tests (vitest + jsdom)
+npm run test:e2e   # browser tests (Playwright: Chromium, Firefox, WebKit)
+npm run build      # type check, ESM/CJS bundles and .d.ts in dist/
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md). Notable changes are listed in [CHANGELOG.md](CHANGELOG.md).
+
+## License
+
+[MIT](LICENSE)

package/README.tr.md

@@ -0,0 +1,126 @@
+# CenituTable
+
+Spreadsheet benzeri bir data grid ve ona bağlı, çok sayfalı bir formül motoru. TypeScript ile yazıldı, **çalışma zamanı bağımlılığı yok**. İsteğe bağlı bir React bileşeni de içeriyor.
+
+**[Canlı demo](https://cenitu.github.io/cenitu-table/)** · [English](README.md) · [Tasarım notları](docs/SPEC.md)
+
+## Özellikler
+
+- **Grid:** sanal kaydırma (yalnızca görünen hücreler DOM'da), klavye gezinmesi (Ctrl+ok ile veri bloğu sonuna atlama), Excel uyumlu kopyala/kes/yapıştır, geri al/yinele, sütun ve satır boyutlandırma, satır/sütun ekleme-silme, sağ tık menüsü.
+- **Sıralama ve filtre:** koşula ve değer listesine göre filtreleyen sütun menüsü. Yalnızca görünüm değişir; veri ve formüller yerinde kalır.
+- **Doldurma tutamacı:** sayı ve metin serileri, göreli kayan formüller, çift tıklamayla otomatik doldurma, Ctrl+D.
+- **Hücre tipleri:** sayı (para, yüzde gibi Intl biçimleri), tarih, onay kutusu, açılır liste; doğrulayıcılar, salt-okunur hücreler, özel çiziciler.
+- **Biçimlendirme:** kalın, italik, altı çizili, üstü çizili, renkler, hizalama, metin kaydırma (Ctrl+B / I / U); hücre ya da tüm satır için koşullu biçimlendirme.
+- **Yerleşim:** sabit satır ve sütunlar, birleştirilmiş hücreler, gizli sütunlar, sürükleyerek sütun taşıma.
+- **Formül motoru:** 100'den fazla fonksiyon (SUM, IF, XLOOKUP, SUMIFS, TEXT, tarih fonksiyonları…), taşan dinamik diziler (FILTER, SORT, UNIQUE, SEQUENCE), sayfalar arası referanslar (`'Diğer Sayfa'!A1`), isimli ifadeler, artımlı yeniden hesaplama, döngü tespiti.
+- **Veri bağlama:** satırlar dizi ya da nesne olarak verilebilir. Nesnelerde sütunlar alan yoluna bağlanır ve düzenlemeler nesnelerinize geri yazılır.
+- **Dışa aktarma:** CSV (formül enjeksiyonuna karşı korumalı) ve XLSX (formüller, biçimler, stiller, sabit bölmeler, birleştirmeler); hiçbir kütüphane kullanmadan.
+- **Erişilebilirlik:** ARIA grid rolleri, ekran okuyucuya duyurulan aktif hücre.
+- **React:** `cenitu-table/react` içinden `<CenituTable />`.
+
+## Kurulum
+
+```bash
+npm install cenitu-table
+```
+
+## Kullanım
+
+```ts
+import { CenituGrid, trTR } from 'cenitu-table';
+
+const grid = new CenituGrid(document.getElementById('grid')!, {
+  data: [
+    ['Ürün', 'Adet', 'Fiyat', 'Tutar'],
+    ['Vida', 10, 2.5, '=B2*C2'],
+    ['Somun', 20, 1.25, '=B3*C3'],
+  ],
+  fixedRowsTop: 1,
+  columnSorting: true,
+  filters: true,
+  contextMenu: true,
+  locale: 'tr-TR',
+  language: trTR,
+  columns: [
+    { type: 'dropdown', source: ['Vida', 'Somun', 'Pul'] },
+    { type: 'numeric', validator: (v) => Number(v) > 0 || 'Pozitif olmalı' },
+    { type: 'numeric', numericFormat: { style: 'currency', currency: 'TRY' } },
+    { type: 'numeric', numericFormat: { style: 'currency', currency: 'TRY' }, readOnly: true },
+  ],
+  height: 400,
+});
+
+grid.addHook('afterChange', (changes, source) => console.log(changes, source));
+grid.getDataAtCell(1, 3);       // 25 (hesaplanmış değer)
+grid.getSourceDataAtCell(1, 3); // "=B2*C2"
+```
+
+### Dizi yerine nesneler
+
+```ts
+const siparisler = [{ urun: 'Vida', adet: 10, musteri: { ad: 'Acme' } }];
+
+new CenituGrid(el, {
+  data: siparisler,
+  columns: [{ data: 'urun' }, { data: 'adet', type: 'numeric' }, { data: 'musteri.ad', title: 'Müşteri' }],
+  dataSchema: () => ({ urun: '', adet: 0, musteri: { ad: '' } }),
+});
+// Düzenlemeler geri yazılır: hücre değişince siparisler[0].adet de değişir.
+```
+
+Formül hücreleri nesneye hesaplanmış değeri yazar ve güncel tutar; böylece alanlarınız düz değer olarak kalır. Formül metnini saklamak için `bindFormulas: 'text'` kullanın.
+
+### Birden fazla sayfa
+
+Tek bir motoru birden fazla grid'e verin (her grid bir sayfa):
+
+```ts
+import { CenituGrid, FormulaEngine } from 'cenitu-table';
+
+const engine = FormulaEngine.buildEmpty();
+engine.addNamedExpression('KdvOrani', 0.2);
+new CenituGrid(el1, { formulas: engine, sheetName: 'Siparişler', data: siparisler });
+new CenituGrid(el2, { formulas: engine, sheetName: 'Özet', data: [['=SUM(Siparişler!F2:F100)*(1+KdvOrani)']] });
+```
+
+### Dışa aktarma
+
+```ts
+grid.downloadCSV('siparisler.csv');                   // tr-TR'de ";" ayraç ve "," ondalık
+await grid.downloadXLSX('kitap.xlsx', [ozetGrid]);    // birden fazla sayfa tek dosyada
+```
+
+### React
+
+```tsx
+import { CenituTable } from 'cenitu-table/react';
+
+<CenituTable ref={gridRef} data={data} fixedRowsTop={1} onChange={(changes) => kaydet(changes)} />;
+```
+
+### Yalnızca formül motoru
+
+```ts
+import { FormulaEngine, registerFunction } from 'cenitu-table';
+
+const engine = FormulaEngine.buildFromArray([[1, 2, '=A1+B1']]);
+engine.setCellContents({ row: 0, col: 0 }, 10); // değişen hücreleri döndürür
+engine.getCellValue({ row: 0, col: 2 });         // 12
+registerFunction('DOUBLE', { minArgs: 1, maxArgs: 1, impl: ([x]) => (x as number) * 2 });
+```
+
+## Geliştirme
+
+```bash
+npm install
+npm run dev        # demo: http://localhost:5180
+npm test           # birim testleri (vitest + jsdom)
+npm run test:e2e   # tarayıcı testleri (Playwright: Chromium, Firefox, WebKit)
+npm run build      # tip denetimi, ESM/CJS paketleri ve dist/ altında .d.ts
+```
+
+Bkz. [CONTRIBUTING.md](CONTRIBUTING.md). Önemli değişiklikler [CHANGELOG.md](CHANGELOG.md)'de.
+
+## Lisans
+
+[MIT](LICENSE)

package/dist/cenitu-table.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BJIaMXd1.cjs");exports.CSV_MIME=e.CSV_MIME;exports.CellError=e.CellError;exports.CenituGrid=e.CenituGrid;exports.FormulaEngine=e.FormulaEngine;exports.FormulaSyntaxError=e.FormulaSyntaxError;exports.MAX_COLS=e.MAX_COLS;exports.MAX_ROWS=e.MAX_ROWS;exports.RangeValue=e.RangeValue;exports.SHEET_SPAN=e.SHEET_SPAN;exports.XLSX_MIME=e.XLSX_MIME;exports.cellKey=e.cellKey;exports.columnIndex=e.columnIndex;exports.columnLabel=e.columnLabel;exports.crc32=e.crc32;exports.dateCodeFromPattern=e.dateCodeFromPattern;exports.dateToSerial=e.dateToSerial;exports.downloadBlob=e.downloadBlob;exports.enUS=e.enUS;exports.formatDateCode=e.formatDateCode;exports.formatSerialDate=e.formatSerialDate;exports.getRegisteredFunctionNames=e.getRegisteredFunctionNames;exports.inverseMove=e.inverseMove;exports.isDateFormat=e.isDateFormat;exports.isError=e.isError;exports.isFormula=e.isFormula;exports.keyToAddress=e.keyToAddress;exports.normalizeRange=e.normalizeRange;exports.numberFormatFromMeta=e.numberFormatFromMeta;exports.parseA1=e.parseA1;exports.parseDateString=e.parseDateString;exports.parseFormula=e.parseFormula;exports.pxToColWidth=e.pxToColWidth;exports.quoteSheetName=e.quoteSheetName;exports.rangeContains=e.rangeContains;exports.registerFunction=e.registerFunction;exports.sanitizeSheetNames=e.sanitizeSheetNames;exports.serialToDate=e.serialToDate;exports.setClock=e.setClock;exports.setRandom=e.setRandom;exports.toA1=e.toA1;exports.toCSV=e.toCSV;exports.toXLSX=e.toXLSX;exports.toXLSXCompressed=e.toXLSXCompressed;exports.trTR=e.trTR;exports.unparse=e.unparse;exports.unregisterFunction=e.unregisterFunction;exports.xlsxParts=e.xlsxParts;exports.zipDeflate=e.zipDeflate;exports.zipStore=e.zipStore;

package/dist/cenitu-table.js

@@ -0,0 +1,52 @@
+import { a as e, b as r, C as o, F as t, c as n, M as i, d as l, R as m, S, X as u, e as d, f as C, g as F, h as c, j as g, k as p, l as E, m as M, n as X, o as x, p as A, q as D, r as R, s as T, t as L, u as f, v as z, w as N, x as _, y as b, z as h, A as y, B as I, D as P, E as V, G as k, H as v, I as W, J as q, K as w, L as B, N as G, P as H, Q as K, T as O, U, V as j, W as J, Y as Q } from "./index-DG98ykBX.js";
+export {
+  e as CSV_MIME,
+  r as CellError,
+  o as CenituGrid,
+  t as FormulaEngine,
+  n as FormulaSyntaxError,
+  i as MAX_COLS,
+  l as MAX_ROWS,
+  m as RangeValue,
+  S as SHEET_SPAN,
+  u as XLSX_MIME,
+  d as cellKey,
+  C as columnIndex,
+  F as columnLabel,
+  c as crc32,
+  g as dateCodeFromPattern,
+  p as dateToSerial,
+  E as downloadBlob,
+  M as enUS,
+  X as formatDateCode,
+  x as formatSerialDate,
+  A as getRegisteredFunctionNames,
+  D as inverseMove,
+  R as isDateFormat,
+  T as isError,
+  L as isFormula,
+  f as keyToAddress,
+  z as normalizeRange,
+  N as numberFormatFromMeta,
+  _ as parseA1,
+  b as parseDateString,
+  h as parseFormula,
+  y as pxToColWidth,
+  I as quoteSheetName,
+  P as rangeContains,
+  V as registerFunction,
+  k as sanitizeSheetNames,
+  v as serialToDate,
+  W as setClock,
+  q as setRandom,
+  w as toA1,
+  B as toCSV,
+  G as toXLSX,
+  H as toXLSXCompressed,
+  K as trTR,
+  O as unparse,
+  U as unregisterFunction,
+  j as xlsxParts,
+  J as zipDeflate,
+  Q as zipStore
+};