styled-exceljs 0.21.2 → 0.21.4

package/docs/visual-fidelity.md

@@ -74,6 +74,19 @@ interface CellStyle {
 XLSX and BIFF8 XLS.  The `fgColor`, `bgColor`, and `patternType` fields are
 preserved as compatibility aliases for older integrations.
 
+OOXML table definitions are exposed as `ws["!tables"]` when `cellStyles:true`
+is enabled. Built-in `TableStyleLight*`, `TableStyleMedium*`, and
+`TableStyleDark*` families as well as custom `tableStyles` differential formats
+can be resolved lazily for a visible cell:
+
+```js
+const style = XLSX.utils.resolve_table_cell_style(ws, rowIndex, columnIndex, cell.s);
+```
+
+The resolver honors header and totals rows, row and column banding, first and
+last column emphasis, and table/column differential-format overrides. It does
+not materialize blank cells or expand large table ranges during parsing.
+
 Colors may include resolved RGB as well as the original theme or palette data:
 
 ```ts

package/docs/visual-fidelity.zh-CN.md

@@ -79,6 +79,17 @@ interface CellStyle {
 和 XLS BIFF8 之间归一化。`fgColor`、`bgColor`、`patternType` 保留为
 兼容旧集成的别名字段。
 
+启用 `cellStyles:true` 后，OOXML 表对象会暴露在 `ws["!tables"]`。内置
+`TableStyleLight*`、`TableStyleMedium*`、`TableStyleDark*` 系列以及工作簿中
+自定义的 `tableStyles` 差异格式，都可以按可视单元格惰性解析：
+
+```js
+const style = XLSX.utils.resolve_table_cell_style(ws, rowIndex, columnIndex, cell.s);
+```
+
+解析器会处理标题行、汇总行、行列条纹、首末列强调，以及表级/列级差异格式，
+但不会为了表样式创建空单元格或在解析大表时展开整个表范围。
+
 颜色结构会尽量同时保留解析后的 RGB 和原始来源信息：
 
 ```ts

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "styled-exceljs",
-	"version": "0.21.2",
+	"version": "0.21.4",
 	"author": "sheetjs",
 	"description": "SheetJS CE fork with enhanced XLS/XLSX styling and browser rendering",
 	"keywords": [
@@ -27,78 +27,78 @@
 	"types": "types/index.d.ts",
 	"exports": {
 		".": {
+			"types": "./types/index.d.ts",
 			"import": "./xlsx.mjs",
-			"require": "./xlsx.js",
-			"types": "./types/index.d.ts"
+			"require": "./xlsx.js"
 		},
 		"./xlsx.mjs": {
-			"import": "./xlsx.mjs",
-			"types": "./types/index.d.ts"
+			"types": "./types/index.d.ts",
+			"import": "./xlsx.mjs"
 		},
 		"./xlsx.js": {
-			"require": "./xlsx.js",
-			"types": "./types/index.d.ts"
+			"types": "./types/index.d.ts",
+			"require": "./xlsx.js"
 		},
 		"./dist/xlsx.core.min": {
+			"types": "./types/index.d.ts",
 			"import": "./dist/xlsx.core.min.js",
-			"require": "./dist/xlsx.core.min.js",
-			"types": "./types/index.d.ts"
+			"require": "./dist/xlsx.core.min.js"
 		},
 		"./dist/xlsx.core.min.js": {
+			"types": "./types/index.d.ts",
 			"import": "./dist/xlsx.core.min.js",
-			"require": "./dist/xlsx.core.min.js",
-			"types": "./types/index.d.ts"
+			"require": "./dist/xlsx.core.min.js"
 		},
 		"./dist/xlsx.full.min": {
+			"types": "./types/index.d.ts",
 			"import": "./dist/xlsx.full.min.js",
-			"require": "./dist/xlsx.full.min.js",
-			"types": "./types/index.d.ts"
+			"require": "./dist/xlsx.full.min.js"
 		},
 		"./dist/xlsx.full.min.js": {
+			"types": "./types/index.d.ts",
 			"import": "./dist/xlsx.full.min.js",
-			"require": "./dist/xlsx.full.min.js",
-			"types": "./types/index.d.ts"
+			"require": "./dist/xlsx.full.min.js"
 		},
 		"./dist/xlsx.mini.min": {
+			"types": "./types/index.d.ts",
 			"import": "./dist/xlsx.mini.min.js",
-			"require": "./dist/xlsx.mini.min.js",
-			"types": "./types/index.d.ts"
+			"require": "./dist/xlsx.mini.min.js"
 		},
 		"./dist/xlsx.mini.min.js": {
+			"types": "./types/index.d.ts",
 			"import": "./dist/xlsx.mini.min.js",
-			"require": "./dist/xlsx.mini.min.js",
-			"types": "./types/index.d.ts"
+			"require": "./dist/xlsx.mini.min.js"
 		},
 		"./dist/xlsx.zahl": {
+			"types": "./dist/zahl.d.ts",
 			"import": "./dist/xlsx.zahl.mjs",
-			"require": "./dist/xlsx.zahl.js",
-			"types": "./dist/zahl.d.ts"
+			"require": "./dist/xlsx.zahl.js"
 		},
 		"./dist/xlsx.zahl.mjs": {
-			"import": "./dist/xlsx.zahl.mjs",
-			"types": "./dist/zahl.d.ts"
+			"types": "./dist/zahl.d.ts",
+			"import": "./dist/xlsx.zahl.mjs"
 		},
 		"./dist/xlsx.zahl.js": {
-			"require": "./dist/xlsx.zahl.js",
-			"types": "./dist/zahl.d.ts"
+			"types": "./dist/zahl.d.ts",
+			"require": "./dist/xlsx.zahl.js"
 		},
 		"./dist/cpexcel": {
+			"types": "./dist/cpexcel.d.ts",
 			"import": "./dist/cpexcel.full.mjs",
-			"require": "./dist/cpexcel.js",
-			"types": "./dist/cpexcel.d.ts"
+			"require": "./dist/cpexcel.js"
 		},
 		"./dist/cpexcel.js": {
-			"require": "./dist/cpexcel.js",
-			"types": "./dist/cpexcel.d.ts"
+			"types": "./dist/cpexcel.d.ts",
+			"require": "./dist/cpexcel.js"
 		},
 		"./dist/cpexcel.full": {
+			"types": "./dist/cpexcel.d.ts",
 			"import": "./dist/cpexcel.full.mjs",
-			"require": "./dist/cpexcel.js",
-			"types": "./dist/cpexcel.d.ts"
+			"require": "./dist/cpexcel.js"
 		},
 		"./dist/cpexcel.full.mjs": {
-			"import": "./dist/cpexcel.full.mjs",
-			"types": "./dist/cpexcel.d.ts"
+			"types": "./dist/cpexcel.d.ts",
+			"import": "./dist/cpexcel.full.mjs"
 		}
 	},
 	"browser": {
@@ -114,7 +114,7 @@
 		"@types/node": "8.5.9",
 		"acorn": "7.4.1",
 		"adler-32": "~1.3.1",
-		"alex": "8.1.1",
+		"alex": "^11.0.1",
 		"blanket": "~1.2.3",
 		"cfb": "~1.2.2",
 		"codepage": "~1.15.0",
@@ -126,21 +126,26 @@
 		"eslint-plugin-json": "^2.1.2",
 		"exit-on-epipe": "~1.0.1",
 		"fflate": "^0.7.1",
-		"jsdom": "~11.1.0",
-		"markdown-spellcheck": "^1.3.1",
-		"mocha": "~2.5.3",
+		"jsdom": "^27.4.0",
+		"mocha": "^11.8.0",
 		"sinon": "^1.17.7",
 		"ssf": "~0.11.2",
 		"typescript": "2.2.0",
 		"wmf": "~1.0.1",
 		"word": "~0.3.0"
 	},
+	"overrides": {
+		"diff": "8.0.3",
+		"serialize-javascript": "7.0.5"
+	},
 	"repository": {
 		"type": "git",
 		"url": "https://git.sheetjs.com/SheetJS/sheetjs"
 	},
 	"scripts": {
 		"test": "make travis",
+		"test:security": "node tests/security-prototype-pollution.mjs",
+		"test:table-styles": "node tests/table-styles.mjs",
 		"build": "make",
 		"lint": "make fullint",
 		"dtslint": "dtslint types"

package/types/index.d.ts

@@ -631,7 +631,7 @@ export interface CellStyle extends FillStyle {
 
 export interface TextMeasureOpts {
     /** Browser-compatible text measurement callback. Receives text, CSS font string, and resolved style. */
-    measureText?: (text: string, font: string, style: CellStyle) => number;
+    measureText?(text: string, font: string, style: CellStyle): number;
     /** Optional canvas-like object used for browser measureText fallback */
     canvas?: any;
     /** Maximum digit width in CSS pixels for Excel width conversion */
@@ -781,6 +781,42 @@ export interface DrawingInfo {
     groups?: boolean;
 }
 
+/** OOXML table style selection flags */
+export interface TableStyleInfo {
+    name?: string;
+    showFirstColumn?: boolean;
+    showLastColumn?: boolean;
+    showRowStripes?: boolean;
+    showColumnStripes?: boolean;
+}
+
+/** OOXML table column metadata used for differential styles */
+export interface TableColumnInfo {
+    id?: number;
+    name?: string;
+    headerRowDxfId?: number;
+    dataDxfId?: number;
+    totalsRowDxfId?: number;
+}
+
+/** Parsed OOXML table definition */
+export interface TableInfo {
+    id?: number;
+    name?: string;
+    displayName?: string;
+    ref: string;
+    range: Range;
+    path?: string;
+    headerRowCount?: number;
+    totalsRowCount?: number;
+    totalsRowShown?: boolean;
+    headerRowDxfId?: number;
+    dataDxfId?: number;
+    totalsRowDxfId?: number;
+    styleInfo?: TableStyleInfo;
+    columns?: TableColumnInfo[];
+}
+
 /** Merge validation error */
 export interface MergeError {
     code: string;
@@ -952,7 +988,7 @@ export interface AutoFilterInfo {
     ref: string;
 }
 
-export type WSKeys = SheetKeys | ColInfo[] | RowInfo[] | Range[] | ProtectInfo | AutoFilterInfo | ChartModel | ChartInfo[] | DrawingInfo | MergeError[];
+export type WSKeys = SheetKeys | ColInfo[] | RowInfo[] | Range[] | ProtectInfo | AutoFilterInfo | ChartModel | ChartInfo[] | DrawingInfo | TableInfo[] | MergeError[];
 
 /** Worksheet Object */
 export interface WorkSheet extends Sheet {
@@ -983,6 +1019,9 @@ export interface WorkSheet extends Sheet {
     /** Parsed drawing information */
     '!drawings'?: DrawingInfo;
 
+    /** Parsed OOXML table definitions when cellStyles is enabled */
+    '!tables'?: TableInfo[];
+
     /** Worksheet Protection info */
     '!protect'?: ProtectInfo;
 
@@ -1159,7 +1198,7 @@ export interface Sheet2HTMLOpts {
     overflow?: HTMLOverflowMode;
 
     /** Browser-compatible text measurement callback used by autoFit and shrink-to-fit */
-    measureText?: (text: string, font: string, style: CellStyle) => number;
+    measureText?(text: string, font: string, style: CellStyle): number;
 
     /** Optional canvas-like object used for text measurement */
     canvas?: any;
@@ -1313,6 +1352,9 @@ export interface XLSX$Utils {
     /** Alias for auto_fit_columns */
     autofit_columns(worksheet: WorkSheet, opts?: AutoFitColumnOpts): ColInfo[];
 
+    /** Resolve the effective table style for a worksheet cell without mutating the worksheet */
+    resolve_table_cell_style(worksheet: WorkSheet, row: number, col: number, baseStyle?: CellStyle): CellStyle | undefined;
+
     /** Convert XLSX column width to browser pixels */
     col_width_to_px(width: number): number;