wms-spreadsheet 0.1.0 → 0.2.0

package/README.md

@@ -1,18 +1,18 @@
 # wms-spreadsheet
 
-Thư viện Spreadsheet cho React — giao diện giống Google Sheets, hỗ trợ **10.000+ dòng** mượt mà nhờ virtual window.
+React Spreadsheet library — Google Sheets-like UI, smoothly handles **10,000+ rows** via a virtual window.
 
-## Cài đặt
+## Install
 
 ```bash
 npm install wms-spreadsheet
-# hoặc
+# or
 pnpm add wms-spreadsheet
 ```
 
-**Peer dependencies:** `react` và `react-dom` (^18 hoặc ^19).
+**Peer dependencies:** `react` and `react-dom` (^18 or ^19).
 
-## Sử dụng nhanh
+## Quick start
 
 ```tsx
 import { useRef } from "react";
@@ -24,9 +24,9 @@ import {
 import "wms-spreadsheet/style.css";
 
 const COLUMNS: ISpreadsheetColumn[] = [
-  { colName: "sku", colText: "Mã SKU", width: 120, showFilter: true },
-  { colName: "qty", colText: "SL", width: 80 },
-  { colName: "active", colText: "Kích hoạt", width: 90, meta: { type: "switch" } },
+  { colName: "sku", colText: "SKU", width: 120, showFilter: true },
+  { colName: "qty", colText: "Qty", width: 80 },
+  { colName: "active", colText: "Active", width: 90, meta: { type: "switch" } },
 ];
 
 const INITIAL_DATA = [
@@ -50,17 +50,17 @@ function App() {
 }
 ```
 
-## Tính năng
+## Features
 
-- Virtual window 2 chiều — chỉ render cell trong viewport
-- API imperative qua `ref` — `setCellValue`, `loadData`, `mergeCells`, …
+- Two-dimensional virtual window — only renders cells in the viewport
+- Imperative API via `ref` — `setCellValue`, `loadData`, `mergeCells`, …
 - Cell types: `text`, `select`, `multiSelect`, `boolean`, `switch`, `date`, `custom`
-- Copy/paste range (Ctrl+C / Ctrl+V), filter & sort cột, frozen columns
-- Merge cells, resize cột/hàng, đa ngôn ngữ (`locale` prop)
+- Copy/paste range (Ctrl+C / Ctrl+V), column filter & sort, frozen columns
+- Merge cells, column/row resize, internationalization (`locale` prop)
 
-## Tài liệu đầy đủ
+## Full documentation
 
-Xem [README trên GitHub](https://github.com/truongnguyen5x/wms-spreadsheet#readme) để biết API ref, cell meta, custom cells, locale, xử lý lỗi, v.v.
+See the [README on GitHub](https://github.com/truongnguyen5x/wms-spreadsheet#readme) for ref API, cell meta, custom cells, locale, error handling, and more.
 
 ## License
 

package/dist/index.d.ts

@@ -71,6 +71,10 @@ export declare interface ICellMeta {
     minDate?: string;
     /** Ngày muộn nhất được chọn (chuỗi theo dateFormat của cell/cột) */
     maxDate?: string;
+    /** Giá trị tối đa được nhập (số không âm) */
+    maxValue?: number;
+    /** Số chữ số thập phân. Mặc định 0 (số nguyên) */
+    decimalPlaces?: number;
     customKey?: string;
     customProps?: Record<string, unknown>;
     invalid?: boolean;
@@ -264,7 +268,7 @@ export declare interface ISpreadsheetRef {
     getCellMeta(row: number, col: number | null, colName?: string): ICellMeta;
     setCellsMeta(cells: ICellMetaInput[]): void;
     mergeCells(range?: INormalizedRange): boolean;
-    unmergeCells(row?: number, col?: number): boolean;
+    unmergeCells(range?: INormalizedRange): boolean;
     getMergedRanges(): IMergedRange[];
     hasMergedCells(): boolean;
 }
@@ -291,6 +295,7 @@ export declare class MergeStore {
     canMerge(range: INormalizedRange): boolean;
     merge(range: INormalizedRange, store: CellStore, metaStore: MetaStore): boolean;
     unmerge(row: number, col: number): boolean;
+    unmergeInRange(range: INormalizedRange): number;
     clear(): void;
 }
 
@@ -310,7 +315,7 @@ export declare const ROW_HEADER_WIDTH = 46;
 
 export declare const Spreadsheet: ForwardRefExoticComponent<ISpreadsheetProps & RefAttributes<ISpreadsheetRef>>;
 
-export declare type TCellType = "text" | "select" | "multiSelect" | "boolean" | "switch" | "date" | "custom";
+export declare type TCellType = "text" | "select" | "multiSelect" | "boolean" | "switch" | "date" | "number" | "custom";
 
 export declare type TCellValue = string | string[];