reamkit 1.31.0 → 1.32.0

package/dist/esm/excel/styles-parser.js

@@ -1,7 +1,7 @@
 import { INDEXED_COLORS } from "../core/indexed-colors.js";
-import { applyColorMods } from "../core/drawingml/colors.js";
 import { resolveAlternateContent } from "../core/opc/alternate-content.js";
 import { resolveInternalEntities } from "../core/opc/xml-entities.js";
+import { applyTint } from "./tint.js";
 import { XMLParser } from "fast-xml-parser";
 //#region src/excel/styles-parser.ts
 var decoder = new TextDecoder("utf-8");
@@ -43,15 +43,55 @@ function parseXlsxStyles(data, theme) {
 		indexed: parseIndexedColors(root)
 	};
 	const dxfs = parseDxfs(root, colors);
+	const tableStyles = parseTableStyles(root);
 	return {
 		numFmts: parseNumFmts(root),
 		fonts: parseFonts(root, colors),
 		fills: parseFills(root, colors),
 		borders: parseBorders(root, colors),
 		cellXfs: parseCellXfs(root),
-		...dxfs.length > 0 ? { dxfs } : {}
+		...dxfs.length > 0 ? { dxfs } : {},
+		...tableStyles.size > 0 ? { tableStyles } : {}
 	};
 }
+var TABLE_STYLE_TYPES = new Set([
+	"wholeTable",
+	"firstColumnStripe",
+	"secondColumnStripe",
+	"firstRowStripe",
+	"secondRowStripe",
+	"lastColumn",
+	"firstColumn",
+	"headerRow",
+	"totalRow",
+	"firstHeaderCell",
+	"lastHeaderCell",
+	"firstTotalCell",
+	"lastTotalCell"
+]);
+function parseTableStyles(root) {
+	const out = /* @__PURE__ */ new Map();
+	for (const raw of asArray(asObject(root["tableStyles"])?.["tableStyle"])) {
+		const style = asObject(raw);
+		const name = style ? strAttr(style, "name") : void 0;
+		if (!style || name === void 0) continue;
+		const elements = [];
+		for (const el of asArray(style["tableStyleElement"])) {
+			const node = asObject(el);
+			const type = node ? strAttr(node, "type") : void 0;
+			const dxfId = node ? numAttr(node, "dxfId") : void 0;
+			if (!node || type === void 0 || !TABLE_STYLE_TYPES.has(type) || dxfId === void 0) continue;
+			const size = numAttr(node, "size");
+			elements.push({
+				type,
+				dxfId,
+				...size !== void 0 && size > 1 ? { size } : {}
+			});
+		}
+		out.set(name, { elements });
+	}
+	return out;
+}
 function parseDxfs(root, colors) {
 	const node = asObject(root["dxfs"]);
 	if (!node) return [];
@@ -103,7 +143,9 @@ function parseDxf(item, colors) {
 				"top",
 				"right",
 				"bottom",
-				"left"
+				"left",
+				"vertical",
+				"horizontal"
 			]) {
 				const edge = parseBorderEdge(asObject(borderObj[side]), colors);
 				if (edge) border[side] = edge;
@@ -201,8 +243,11 @@ function parseFonts(root, colors) {
 		if (hasChild(obj, "i")) font.italic = childToggle(obj, "i");
 		if (hasChild(obj, "u")) font.underline = childUnderline(obj);
 		if (hasChild(obj, "strike")) font.strike = childToggle(obj, "strike");
-		const colorRgb = colorOf(asObject(obj["color"]), colors);
+		const colorNode = asObject(obj["color"]);
+		const colorRgb = colorOf(colorNode, colors);
 		if (colorRgb) font.colorHex = colorRgb;
+		const colorRef = colorNode ? colorRefOf(colorNode) : void 0;
+		if (colorRef !== void 0) font.colorRef = colorRef;
 		const nameVal = childValAttr(obj, "name");
 		if (nameVal) font.name = nameVal;
 		out.push(font);
@@ -285,6 +330,9 @@ function parseCellXfs(root) {
 			const rotation = numAttr(align, "textRotation");
 			if (rotation !== void 0 && rotation !== 0) a.textRotation = rotation;
 			if (boolAttr(align, "shrinkToFit")) a.shrinkToFit = true;
+			const order = numAttr(align, "readingOrder");
+			if (order === 1) a.readingOrder = "ltr";
+			else if (order === 2) a.readingOrder = "rtl";
 			if (Object.keys(a).length > 0) xf.alignment = a;
 		}
 		out.push(xf);
@@ -357,8 +405,34 @@ function averageGradientColor(gf, colors) {
 	const h = (x) => Math.round(x / n).toString(16).padStart(2, "0").toUpperCase();
 	return `${h(r)}${h(g)}${h(b)}`;
 }
+/**
+* A `<color>` of this workbook as 6-hex: its `rgb`, its `indexed` entry or its
+* `theme` slot, with the `tint` applied (§18.8.3).
+*
+* @param node   The `<color>` element, parsed.
+* @param colors What the workbook's colours point at.
+* @returns The colour, or undefined for one that names nothing reachable.
+*/
+function workbookColorHex(node, colors) {
+	return colorOf(asObject(node), colors);
+}
 function colorOf(node, colors) {
 	if (!node) return void 0;
+	const base = baseColorOf(node, colors);
+	return base === void 0 ? void 0 : applyTint(base, Number(strAttr(node, "tint") ?? "0"));
+}
+/** A `<color>` element's own spelling of its colour (see {@link XlsxFont.colorRef}). */
+function colorRefOf(node) {
+	const theme = strAttr(node, "theme");
+	const tint = Number(strAttr(node, "tint") ?? "0") || 0;
+	if (theme !== void 0) return `theme:${theme}:${tint}`;
+	const rgb = strAttr(node, "rgb");
+	if (rgb !== void 0) return `rgb:${rgb.toUpperCase()}:${tint}`;
+	const indexed = strAttr(node, "indexed");
+	if (indexed !== void 0) return `indexed:${indexed}:${tint}`;
+	return "auto";
+}
+function baseColorOf(node, colors) {
 	const rgb = strAttr(node, "rgb");
 	if (rgb) {
 		if (/^[0-9A-Fa-f]{8}$/.test(rgb)) return rgb.substring(2).toUpperCase();
@@ -372,8 +446,7 @@ function colorOf(node, colors) {
 	const themeIdx = strAttr(node, "theme");
 	if (themeIdx !== void 0 && colors.theme) {
 		const slot = THEME_SLOTS[Number(themeIdx)];
-		const base = slot ? colors.theme.get(slot) : void 0;
-		if (base) return applyTint(base, Number(strAttr(node, "tint") ?? "0"));
+		return slot ? colors.theme.get(slot) : void 0;
 	}
 }
 /** §18.8.27 — the indexed palette proper; 56 and 57+ are system colours. */
@@ -421,24 +494,5 @@ var THEME_SLOTS = [
 	"hlink",
 	"folHlink"
 ];
-/**
-* §18.8.19 `tint` — lighten (positive) or darken (negative) a theme colour by
-* scaling its HSL luminance. Excel writes it on nearly every theme colour it
-* uses, so ignoring it is not much better than ignoring the colour: a `theme="2"
-* tint="-0.5"` band is half as light as its slot.
-*/
-function applyTint(hex, tint) {
-	if (!Number.isFinite(tint) || tint === 0) return hex;
-	return tint < 0 ? applyColorMods(hex, [{
-		kind: "lumMod",
-		val: 1 + tint
-	}]) : applyColorMods(hex, [{
-		kind: "lumMod",
-		val: 1 - tint
-	}, {
-		kind: "lumOff",
-		val: tint
-	}]);
-}
 //#endregion
-export { EMPTY_XLSX_STYLES, parseDxf, parseXlsxStyles };
+export { EMPTY_XLSX_STYLES, parseDxf, parseXlsxStyles, workbookColorHex };

package/dist/esm/excel/table-parser.js

@@ -25,11 +25,16 @@ function parseTablePartFull(data) {
 	const name = strAttr(t, "name");
 	const styleName = si ? strAttr(si, "name") : void 0;
 	const af = asObj(t["autoFilter"]);
+	const totalsRowCount = numAttr(t, "totalsRowCount");
+	const named = asArray(asObj(t["tableColumns"])?.["tableColumn"]).map((c) => asObj(c) ? strAttr(asObj(c), "name") : void 0);
+	const columns = Array.from({ length: ref.endColumn - ref.startColumn + 1 }, (_, i) => named[i] ?? `Column${i + 1}`);
 	const table = {
 		ref,
 		...name ? { name } : {},
 		...styleName ? { styleName } : {},
 		headerRowCount: numAttr(t, "headerRowCount") ?? 1,
+		...totalsRowCount !== void 0 && totalsRowCount > 0 ? { totalsRowCount } : {},
+		...columns.length > 0 ? { columns } : {},
 		showRowStripes: si ? boolAttr(si, "showRowStripes") : false,
 		showColumnStripes: si ? boolAttr(si, "showColumnStripes") : false,
 		showFirstColumn: si ? boolAttr(si, "showFirstColumn") : false,

package/dist/esm/excel/table-style-presets.d.ts

@@ -0,0 +1,26 @@
+import { TableStyleElementType } from '../core/spreadsheet-model/index.js';
+/** A theme colour: its slot and the tint applied to it (0 = none). */
+export type PresetColor = readonly [theme: number, tint: number];
+/** One line of a preset: its style and colour. */
+export type PresetEdge = readonly ['thin' | 'medium' | 'thick' | 'double', PresetColor];
+/** A preset's differential format: what one region of a table takes. */
+export interface PresetDxf {
+    readonly bold?: boolean;
+    readonly color?: PresetColor;
+    readonly fill?: PresetColor;
+    readonly border?: {
+        readonly left?: PresetEdge;
+        readonly right?: PresetEdge;
+        readonly top?: PresetEdge;
+        readonly bottom?: PresetEdge;
+        readonly vertical?: PresetEdge;
+        readonly horizontal?: PresetEdge;
+    };
+}
+/**
+ * A built-in table style by its name, each region with its format.
+ *
+ * @param name The style's name as a workbook gives it (`TableStyleMedium2`).
+ * @returns Its regions' formats, or undefined for a name Excel does not build in.
+ */
+export declare function presetTableStyle(name: string): Partial<Record<TableStyleElementType, PresetDxf>> | undefined;