reamkit 1.12.0 → 1.14.0

package/dist/esm/excel/sheet-to-flow.js

@@ -1,15 +1,19 @@
 import { pt } from "../core/ir/units.js";
 import { EMPTY_STYLE_SHEET, resolveBodyStyles } from "../core/style-cascade/resolver.js";
 import "../core/style-cascade/index.js";
-import { resolvePrintArea, resolvePrintTitleRows, sectionFromWorksheet, worksheetToBody } from "./print-model.js";
+import { resolvePrintArea, resolvePrintTitleRows, sectionFromWorksheet, slicerTable, worksheetToBody } from "./print-model.js";
+import { buildHeaderFooterContent } from "./header-footer.js";
 //#region src/excel/sheet-to-flow.ts
+var HEADER_REL = "_xlsxHeaderDefault";
+var FOOTER_REL = "_xlsxFooterDefault";
 function projectSheetDoc(sheet) {
 	const body = [];
 	let firstSheetSection;
+	const headersFooters = /* @__PURE__ */ new Map();
 	const sheetGrids = new Map(sheet.sheets.map((s) => [s.name, s.grid]));
 	for (let sheetIdx = 0; sheetIdx < sheet.sheets.length; sheetIdx++) {
 		const ws = sheet.sheets[sheetIdx];
-		if (sheetIdx === 0) firstSheetSection = sectionFromWorksheet(ws.grid);
+		if (sheetIdx === 0) firstSheetSection = withHeaderFooter(sectionFromWorksheet(ws.grid), ws, headersFooters);
 		if (sheetIdx > 0) body.push({
 			kind: "paragraph",
 			paragraph: {
@@ -24,7 +28,9 @@ function projectSheetDoc(sheet) {
 			...printArea ? { printArea } : {},
 			...titleRows ? { titleRows } : {},
 			gridLines,
-			sheetGrids
+			sheetGrids,
+			...ws.hyperlinks ? { hyperlinks: ws.hyperlinks } : {},
+			...sheet.sharedStringRuns ? { sharedStringRuns: sheet.sharedStringRuns } : {}
 		}));
 		for (const ref of ws.charts ?? []) body.push({
 			kind: "chart",
@@ -35,6 +41,25 @@ function projectSheetDoc(sheet) {
 				paragraphProperties: {}
 			}
 		});
+		for (const img of ws.images ?? []) body.push({
+			kind: "image",
+			image: {
+				resource: img.resourceId,
+				width: pt(img.widthPt),
+				height: pt(img.heightPt),
+				paragraphProperties: {}
+			}
+		});
+		for (const shape of ws.shapes ?? []) body.push({
+			kind: "shape",
+			shape
+		});
+		for (const slicer of ws.slicers ?? []) body.push({
+			kind: "table",
+			table: slicerTable(slicer)
+		});
+		if (ws.comments && ws.comments.length > 0) body.push(...commentBlocks(ws.comments));
+		if (ws.formControls && ws.formControls.length > 0) body.push(...formControlBlocks(ws.formControls));
 	}
 	return {
 		kind: "flow",
@@ -44,8 +69,110 @@ function projectSheetDoc(sheet) {
 		styles: EMPTY_STYLE_SHEET,
 		resources: sheet.resources,
 		...sheet.chartData && sheet.chartData.size > 0 ? { charts: sheet.chartData } : {},
+		...headersFooters.size > 0 ? { headersFooters } : {},
 		...sheet.info ? { info: sheet.info } : {}
 	};
 }
+function commentBlocks(comments) {
+	const out = [{
+		kind: "paragraph",
+		paragraph: {
+			properties: {},
+			runs: [{
+				text: "Comments",
+				properties: { bold: true }
+			}]
+		}
+	}];
+	for (const c of comments) {
+		const body = c.text.replace(/\s+/g, " ").trim();
+		const label = c.author ? `${c.ref} — ${c.author}: ` : `${c.ref}: `;
+		out.push({
+			kind: "paragraph",
+			paragraph: {
+				properties: {},
+				runs: [{
+					text: label,
+					properties: { bold: true }
+				}, ...body.length > 0 ? [{
+					text: body,
+					properties: {}
+				}] : []]
+			}
+		});
+	}
+	return out;
+}
+function formControlBlocks(controls) {
+	const out = [{
+		kind: "paragraph",
+		paragraph: {
+			properties: {},
+			runs: [{
+				text: "Form controls",
+				properties: { bold: true }
+			}]
+		}
+	}];
+	for (const c of controls) out.push({
+		kind: "paragraph",
+		paragraph: {
+			properties: {},
+			runs: [{
+				text: formControlLabel(c),
+				properties: {}
+			}]
+		}
+	});
+	return out;
+}
+function formControlLabel(c) {
+	const name = c.name ?? c.objectType ?? "Control";
+	switch ((c.objectType ?? "").toLowerCase()) {
+		case "checkbox": return `${c.checked ? "[x]" : "[ ]"} ${name}`;
+		case "radio": return `${c.checked ? "(o)" : "( )"} ${name}`;
+		case "buttons": return `[ ${name} ]`;
+		case "spin":
+		case "scroll": return c.value !== void 0 ? `${name} (value ${c.value})` : name;
+		case "drop":
+		case "list": return `${name} (list)`;
+		default: return c.objectType ? `${name} (${c.objectType})` : name;
+	}
+}
+function withHeaderFooter(section, ws, headersFooters) {
+	const hf = ws.grid.headerFooter;
+	if (!hf || !hf.oddHeader && !hf.oddFooter) return section;
+	const headers = [];
+	const footers = [];
+	if (hf.oddHeader) {
+		const content = buildHeaderFooterContent(hf.oddHeader, ws.name);
+		if (content.length > 0) {
+			headersFooters.set(HEADER_REL, resolveBodyStyles(content, EMPTY_STYLE_SHEET));
+			headers.push({
+				type: "default",
+				relationshipId: HEADER_REL
+			});
+		}
+	}
+	if (hf.oddFooter) {
+		const content = buildHeaderFooterContent(hf.oddFooter, ws.name);
+		if (content.length > 0) {
+			headersFooters.set(FOOTER_REL, resolveBodyStyles(content, EMPTY_STYLE_SHEET));
+			footers.push({
+				type: "default",
+				relationshipId: FOOTER_REL
+			});
+		}
+	}
+	if (headers.length === 0 && footers.length === 0) return section;
+	return {
+		...section ?? {
+			headers: [],
+			footers: []
+		},
+		headers,
+		footers
+	};
+}
 //#endregion
 export { projectSheetDoc };

package/dist/esm/excel/slicer-parser.d.ts

@@ -0,0 +1,15 @@
+export interface SlicerDef {
+    readonly name: string;
+    readonly cacheName: string;
+    readonly caption: string;
+    readonly columnCount: number;
+    readonly styleName?: string;
+}
+export interface SlicerCacheDef {
+    readonly name: string;
+    readonly sourceName?: string;
+    readonly tableId?: number;
+    readonly columnId?: number;
+}
+export declare function parseSlicerPart(data: Uint8Array): Array<SlicerDef>;
+export declare function parseSlicerCachePart(data: Uint8Array): SlicerCacheDef | undefined;

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

@@ -0,0 +1,76 @@
+import { XMLParser } from "fast-xml-parser";
+//#region src/excel/slicer-parser.ts
+var decoder = new TextDecoder("utf-8");
+var parser = new XMLParser({
+	ignoreAttributes: false,
+	attributeNamePrefix: "@_",
+	parseAttributeValue: false,
+	parseTagValue: false,
+	removeNSPrefix: true
+});
+function parseSlicerPart(data) {
+	const root = asObj(parser.parse(decoder.decode(data))["slicers"]);
+	if (!root) return [];
+	const out = [];
+	for (const s of asArray(root["slicer"])) {
+		const o = asObj(s);
+		if (!o) continue;
+		const name = strAttr(o, "name");
+		const cacheName = strAttr(o, "cache");
+		if (!name || !cacheName) continue;
+		const caption = strAttr(o, "caption") ?? name;
+		const styleName = strAttr(o, "style");
+		out.push({
+			name,
+			cacheName,
+			caption,
+			columnCount: Math.max(1, numAttr(o, "columnCount") ?? 1),
+			...styleName ? { styleName } : {}
+		});
+	}
+	return out;
+}
+function parseSlicerCachePart(data) {
+	const root = asObj(parser.parse(decoder.decode(data))["slicerCacheDefinition"]);
+	if (!root) return void 0;
+	const name = strAttr(root, "name");
+	if (!name) return void 0;
+	const sourceName = strAttr(root, "sourceName");
+	let tableId;
+	let columnId;
+	const extLst = asObj(root["extLst"]);
+	if (extLst) for (const ext of asArray(extLst["ext"])) {
+		const e = asObj(ext);
+		const inner = e ? asObj(e["slicerCacheDefinition"]) : void 0;
+		const tsc = inner ? asObj(inner["tableSlicerCache"]) : void 0;
+		if (tsc) {
+			tableId = numAttr(tsc, "tableId");
+			columnId = numAttr(tsc, "column");
+			break;
+		}
+	}
+	return {
+		name,
+		...sourceName ? { sourceName } : {},
+		...tableId !== void 0 ? { tableId } : {},
+		...columnId !== void 0 ? { columnId } : {}
+	};
+}
+function asObj(v) {
+	return v && typeof v === "object" && !Array.isArray(v) ? v : void 0;
+}
+function asArray(v) {
+	return Array.isArray(v) ? v : v === void 0 || v === null ? [] : [v];
+}
+function strAttr(obj, name) {
+	const v = obj[`@_${name}`];
+	return typeof v === "string" ? v : void 0;
+}
+function numAttr(obj, name) {
+	const v = strAttr(obj, name);
+	if (v === void 0) return void 0;
+	const n = Number(v);
+	return Number.isFinite(n) ? n : void 0;
+}
+//#endregion
+export { parseSlicerCachePart, parseSlicerPart };

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

@@ -101,6 +101,12 @@ function parseBorders(root) {
 		if (right) border.right = right;
 		if (bottom) border.bottom = bottom;
 		if (left) border.left = left;
+		const diagonal = parseBorderEdge(asObject(obj["diagonal"]));
+		if (diagonal) {
+			border.diagonal = diagonal;
+			if (boolAttr(obj, "diagonalUp")) border.diagonalUp = true;
+			if (boolAttr(obj, "diagonalDown")) border.diagonalDown = true;
+		}
 		out.push(border);
 	}
 	return out;
@@ -169,6 +175,13 @@ function parseFills(root) {
 			if (fg) fill.fgColorHex = fg;
 			if (bg) fill.bgColorHex = bg;
 		}
+		if (!fill.patternType) {
+			const avg = averageGradientColor(asObject(obj["gradientFill"]));
+			if (avg) {
+				fill.patternType = "solid";
+				fill.fgColorHex = avg;
+			}
+		}
 		out.push(fill);
 	}
 	return out;
@@ -205,6 +218,11 @@ function parseCellXfs(root) {
 			if (h) a.horizontal = h;
 			if (v) a.vertical = v;
 			if (wrap !== void 0) a.wrapText = wrap;
+			const indent = numAttr(align, "indent");
+			if (indent !== void 0 && indent > 0) a.indent = indent;
+			const rotation = numAttr(align, "textRotation");
+			if (rotation !== void 0 && rotation !== 0) a.textRotation = rotation;
+			if (boolAttr(align, "shrinkToFit")) a.shrinkToFit = true;
 			if (Object.keys(a).length > 0) xf.alignment = a;
 		}
 		out.push(xf);
@@ -250,6 +268,25 @@ function childToggle(obj, childName) {
 	if (val === void 0) return true;
 	return !(val === "false" || val === "0");
 }
+function averageGradientColor(gf) {
+	if (!gf) return void 0;
+	let r = 0;
+	let g = 0;
+	let b = 0;
+	let n = 0;
+	for (const s of asArray(gf["stop"])) {
+		const so = asObject(s);
+		const hex = so ? colorOf(asObject(so["color"])) : void 0;
+		if (!hex) continue;
+		r += parseInt(hex.slice(0, 2), 16);
+		g += parseInt(hex.slice(2, 4), 16);
+		b += parseInt(hex.slice(4, 6), 16);
+		n++;
+	}
+	if (n === 0) return void 0;
+	const h = (x) => Math.round(x / n).toString(16).padStart(2, "0").toUpperCase();
+	return `${h(r)}${h(g)}${h(b)}`;
+}
 function colorOf(node) {
 	if (!node) return void 0;
 	const rgb = strAttr(node, "rgb");

package/dist/esm/excel/table-parser.d.ts

@@ -1,2 +1,12 @@
 import { ExcelTable } from '../core/spreadsheet-model/index.js';
+export interface TableFilterColumn {
+    readonly colId: number;
+    readonly values: ReadonlyArray<string>;
+}
+export interface ParsedTablePart {
+    readonly table: ExcelTable;
+    readonly id?: number;
+    readonly filters: ReadonlyArray<TableFilterColumn>;
+}
 export declare function parseTablePart(data: Uint8Array): ExcelTable | undefined;
+export declare function parseTablePartFull(data: Uint8Array): ParsedTablePart | undefined;

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

@@ -9,7 +9,7 @@ var parser = new XMLParser({
 	parseTagValue: false,
 	removeNSPrefix: true
 });
-function parseTablePart(data) {
+function parseTablePartFull(data) {
 	const t = asObj(parser.parse(decoder.decode(data))["table"]);
 	if (!t) return void 0;
 	const refStr = strAttr(t, "ref");
@@ -18,7 +18,8 @@ function parseTablePart(data) {
 	const si = asObj(t["tableStyleInfo"]);
 	const name = strAttr(t, "name");
 	const styleName = si ? strAttr(si, "name") : void 0;
-	return {
+	const af = asObj(t["autoFilter"]);
+	const table = {
 		ref,
 		...name ? { name } : {},
 		...styleName ? { styleName } : {},
@@ -27,9 +28,40 @@ function parseTablePart(data) {
 		showColumnStripes: si ? boolAttr(si, "showColumnStripes") : false,
 		showFirstColumn: si ? boolAttr(si, "showFirstColumn") : false,
 		showLastColumn: si ? boolAttr(si, "showLastColumn") : false,
-		autoFilter: asObj(t["autoFilter"]) !== void 0
+		autoFilter: af !== void 0
+	};
+	const id = numAttr(t, "id");
+	return {
+		table,
+		...id !== void 0 ? { id } : {},
+		filters: parseFilterColumns(af)
 	};
 }
+function parseFilterColumns(af) {
+	if (!af) return [];
+	const out = [];
+	for (const fc of asArray(af["filterColumn"])) {
+		const col = asObj(fc);
+		if (!col) continue;
+		const colId = numAttr(col, "colId");
+		if (colId === void 0) continue;
+		const filters = asObj(col["filters"]);
+		if (!filters) continue;
+		const values = [];
+		for (const f of asArray(filters["filter"])) {
+			const v = asObj(f) ? strAttr(asObj(f), "val") : void 0;
+			if (v !== void 0) values.push(v);
+		}
+		out.push({
+			colId,
+			values
+		});
+	}
+	return out;
+}
+function asArray(v) {
+	return Array.isArray(v) ? v : v === void 0 || v === null ? [] : [v];
+}
 function asObj(v) {
 	return v && typeof v === "object" && !Array.isArray(v) ? v : void 0;
 }
@@ -48,4 +80,4 @@ function boolAttr(obj, name) {
 	return v === "1" || v === "true";
 }
 //#endregion
-export { parseTablePart };
+export { parseTablePartFull };

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

@@ -37,6 +37,10 @@ function parseWorksheet(data) {
 	const drawingNode = wsObj["drawing"];
 	const drawingRelId = drawingNode && typeof drawingNode === "object" ? strAttr(drawingNode, "id") : void 0;
 	const conditionalFormats = parseConditionalFormatting(wsObj);
+	const dataValidations = parseDataValidations(wsObj);
+	const hyperlinks = parseHyperlinks(wsObj);
+	const headerFooter = parseHeaderFooter(wsObj);
+	const formControls = parseFormControls(wsObj);
 	const sparklines = parseSparklines(wsObj);
 	const tablePartRelIds = parseTableParts(wsObj);
 	const printModel = {
@@ -49,6 +53,10 @@ function parseWorksheet(data) {
 		...pane ? { pane } : {},
 		...drawingRelId !== void 0 ? { drawingRelId } : {},
 		...conditionalFormats.length > 0 ? { conditionalFormats } : {},
+		...dataValidations.length > 0 ? { dataValidations } : {},
+		...hyperlinks.length > 0 ? { hyperlinks } : {},
+		...headerFooter ? { headerFooter } : {},
+		...formControls.length > 0 ? { formControls } : {},
 		...sparklines.length > 0 ? { sparklines } : {},
 		...tablePartRelIds.length > 0 ? { tablePartRelIds } : {}
 	};
@@ -298,6 +306,95 @@ function parseConditionalFormatting(ws) {
 	}
 	return out;
 }
+var DV_TYPES = new Set([
+	"none",
+	"whole",
+	"decimal",
+	"list",
+	"date",
+	"time",
+	"textLength",
+	"custom"
+]);
+function parseDataValidations(ws) {
+	const node = asObjectNode(ws["dataValidations"]);
+	if (!node) return [];
+	const out = [];
+	for (const dv of toArray(node["dataValidation"])) {
+		const obj = asObjectNode(dv);
+		if (!obj) continue;
+		const sqref = strAttr(obj, "sqref");
+		if (!sqref) continue;
+		const ranges = parseSqref(sqref);
+		if (ranges.length === 0) continue;
+		const typeRaw = strAttr(obj, "type");
+		const type = typeRaw && DV_TYPES.has(typeRaw) ? typeRaw : "none";
+		const operator = strAttr(obj, "operator");
+		const errorStyle = strAttr(obj, "errorStyle");
+		const formula1 = formulaText(obj["formula1"]);
+		const formula2 = formulaText(obj["formula2"]);
+		const promptTitle = strAttr(obj, "promptTitle");
+		const prompt = strAttr(obj, "prompt");
+		const errorTitle = strAttr(obj, "errorTitle");
+		const error = strAttr(obj, "error");
+		out.push({
+			type,
+			ranges,
+			...operator !== void 0 ? { operator } : {},
+			...boolAttr(obj, "allowBlank") ? { allowBlank: true } : {},
+			...boolAttr(obj, "showDropDown") ? { showDropDown: true } : {},
+			...boolAttr(obj, "showInputMessage") ? { showInputMessage: true } : {},
+			...boolAttr(obj, "showErrorMessage") ? { showErrorMessage: true } : {},
+			...errorStyle !== void 0 ? { errorStyle } : {},
+			...formula1 !== void 0 ? { formula1 } : {},
+			...formula2 !== void 0 ? { formula2 } : {},
+			...promptTitle !== void 0 ? { promptTitle } : {},
+			...prompt !== void 0 ? { prompt } : {},
+			...errorTitle !== void 0 ? { errorTitle } : {},
+			...error !== void 0 ? { error } : {}
+		});
+	}
+	return out;
+}
+function boolAttr(obj, key) {
+	const raw = strAttr(obj, key);
+	return raw === "1" || raw === "true";
+}
+function parseHeaderFooter(ws) {
+	const node = asObjectNode(ws["headerFooter"]);
+	if (!node) return void 0;
+	const oddHeader = formulaText(node["oddHeader"]);
+	const oddFooter = formulaText(node["oddFooter"]);
+	if (!oddHeader && !oddFooter) return void 0;
+	return {
+		...oddHeader ? { oddHeader } : {},
+		...oddFooter ? { oddFooter } : {}
+	};
+}
+function parseHyperlinks(ws) {
+	const node = asObjectNode(ws["hyperlinks"]);
+	if (!node) return [];
+	const out = [];
+	for (const h of toArray(node["hyperlink"])) {
+		const obj = asObjectNode(h);
+		if (!obj) continue;
+		const ref = strAttr(obj, "ref");
+		if (!ref) continue;
+		const relId = strAttr(obj, "id");
+		const location = strAttr(obj, "location");
+		if (relId === void 0 && location === void 0) continue;
+		const display = strAttr(obj, "display");
+		const tooltip = strAttr(obj, "tooltip");
+		out.push({
+			ref,
+			...relId !== void 0 ? { relId } : {},
+			...location !== void 0 ? { location } : {},
+			...display !== void 0 ? { display } : {},
+			...tooltip !== void 0 ? { tooltip } : {}
+		});
+	}
+	return out;
+}
 function parseSqref(sqref) {
 	const out = [];
 	for (const token of sqref.split(/\s+/)) {
@@ -324,14 +421,73 @@ var CF_OPERATORS = new Set([
 ]);
 function parseCfRule(obj) {
 	const priority = parseNumericAttr(obj, "priority") ?? 0;
-	switch (strAttr(obj, "type")) {
+	const type = strAttr(obj, "type");
+	switch (type) {
 		case "cellIs": return parseCellIsRule(obj, priority);
 		case "colorScale": return parseColorScaleRule(obj, priority);
 		case "dataBar": return parseDataBarRule(obj, priority);
 		case "iconSet": return parseIconSetRule(obj, priority);
+		case "top10": return parseTop10Rule(obj, priority);
+		case "aboveAverage": return parseAboveAverageRule(obj, priority);
+		case "duplicateValues":
+		case "uniqueValues": return parseDupUniqueRule(type, obj, priority);
+		case "containsText":
+		case "notContainsText":
+		case "beginsWith":
+		case "endsWith": return parseTextRule(type, obj, priority);
 		default: return;
 	}
 }
+function parseTop10Rule(obj, priority) {
+	const dxfId = parseNumericAttr(obj, "dxfId");
+	if (dxfId === void 0) return void 0;
+	return {
+		type: "top10",
+		priority,
+		rank: parseNumericAttr(obj, "rank") ?? 10,
+		percent: boolAttr(obj, "percent"),
+		bottom: boolAttr(obj, "bottom"),
+		dxfId
+	};
+}
+function parseAboveAverageRule(obj, priority) {
+	const dxfId = parseNumericAttr(obj, "dxfId");
+	if (dxfId === void 0) return void 0;
+	const aboveRaw = strAttr(obj, "aboveAverage");
+	const aboveAverage = aboveRaw === void 0 ? true : aboveRaw === "1" || aboveRaw === "true";
+	const stdDev = parseNumericAttr(obj, "stdDev");
+	return {
+		type: "aboveAverage",
+		priority,
+		aboveAverage,
+		equalAverage: boolAttr(obj, "equalAverage"),
+		...stdDev !== void 0 ? { stdDev } : {},
+		dxfId
+	};
+}
+function parseDupUniqueRule(type, obj, priority) {
+	const dxfId = parseNumericAttr(obj, "dxfId");
+	if (dxfId === void 0) return void 0;
+	return {
+		type,
+		priority,
+		dxfId
+	};
+}
+function parseTextRule(type, obj, priority) {
+	const dxfId = parseNumericAttr(obj, "dxfId");
+	if (dxfId === void 0) return void 0;
+	const text = strAttr(obj, "text");
+	if (text === void 0) return void 0;
+	const formula = formulaText(obj["formula"]);
+	return {
+		type,
+		priority,
+		text,
+		dxfId,
+		...formula !== void 0 ? { formula } : {}
+	};
+}
 function parseIconSetRule(obj, priority) {
 	const is = obj["iconSet"];
 	if (!is || typeof is !== "object") return void 0;
@@ -489,6 +645,30 @@ function parseSparklines(ws) {
 	}
 	return out;
 }
+function parseFormControls(ws) {
+	const out = [];
+	const seen = /* @__PURE__ */ new Set();
+	collectControls(asObjectNode(ws["controls"]), out, seen);
+	for (const ext of toArray(asObjectNode(ws["extLst"])?.["ext"])) collectControls(asObjectNode(asObjectNode(ext)?.["controls"]), out, seen);
+	return out;
+}
+function collectControls(node, out, seen) {
+	if (!node) return;
+	const direct = toArray(node["control"]);
+	const fromChoice = toArray(asObjectNode(node["AlternateContent"])?.["Choice"]).flatMap((c) => toArray(asObjectNode(c)?.["control"]));
+	for (const c of [...direct, ...fromChoice]) {
+		const obj = asObjectNode(c);
+		if (!obj) continue;
+		const relId = strAttr(obj, "id");
+		if (!relId || seen.has(relId)) continue;
+		seen.add(relId);
+		const name = strAttr(obj, "name");
+		out.push({
+			relId,
+			...name ? { name } : {}
+		});
+	}
+}
 function asObjectNode(v) {
 	return v && typeof v === "object" && !Array.isArray(v) ? v : void 0;
 }