reamkit 1.13.0 → 1.15.0

package/dist/esm/excel/xls/biff-styles.d.ts

@@ -0,0 +1,8 @@
+import { XlsxStyles } from '../../core/spreadsheet-model/index.js';
+interface BiffRec {
+    readonly type: number;
+    readonly data: Uint8Array;
+}
+export declare function buildBiffPalette(records: ReadonlyArray<BiffRec>): (icv: number) => string | undefined;
+export declare function parseBiffStyles(records: ReadonlyArray<BiffRec>): XlsxStyles;
+export {};

package/dist/esm/excel/xls/biff-styles.js

@@ -0,0 +1,299 @@
+//#region src/excel/xls/biff-styles.ts
+var REC_FONT = 49;
+var REC_FORMAT = 1054;
+var REC_XF = 224;
+var REC_PALETTE = 146;
+var FILL_PATTERNS = [
+	"none",
+	"solid",
+	"mediumGray",
+	"darkGray",
+	"lightGray",
+	"darkHorizontal",
+	"darkVertical",
+	"darkDown",
+	"darkUp",
+	"darkGrid",
+	"darkTrellis",
+	"lightHorizontal",
+	"lightVertical",
+	"lightDown",
+	"lightUp",
+	"lightGrid",
+	"lightTrellis",
+	"gray125",
+	"gray0625"
+];
+var BORDER_STYLES = [
+	"none",
+	"thin",
+	"medium",
+	"dashed",
+	"dotted",
+	"thick",
+	"double",
+	"hair",
+	"mediumDashed",
+	"dashDot",
+	"mediumDashDot",
+	"dashDotDot",
+	"mediumDashDotDot",
+	"slantDashDot"
+];
+var HALIGN = [
+	void 0,
+	"left",
+	"center",
+	"right",
+	"fill",
+	"justify",
+	"centerContinuous",
+	"distributed"
+];
+var VALIGN = [
+	"top",
+	"center",
+	"bottom",
+	"justify",
+	"distributed"
+];
+var PALETTE56 = [
+	"000000",
+	"FFFFFF",
+	"FF0000",
+	"00FF00",
+	"0000FF",
+	"FFFF00",
+	"FF00FF",
+	"00FFFF",
+	"800000",
+	"008000",
+	"000080",
+	"808000",
+	"800080",
+	"008080",
+	"C0C0C0",
+	"808080",
+	"9999FF",
+	"993366",
+	"FFFFCC",
+	"CCFFFF",
+	"660066",
+	"FF8080",
+	"0066CC",
+	"CCCCFF",
+	"000080",
+	"FF00FF",
+	"FFFF00",
+	"00FFFF",
+	"800080",
+	"800000",
+	"008080",
+	"0000FF",
+	"00CCFF",
+	"CCFFFF",
+	"CCFFCC",
+	"FFFF99",
+	"99CCFF",
+	"FF99CC",
+	"CC99FF",
+	"FFCC99",
+	"3366FF",
+	"33CCCC",
+	"99CC00",
+	"FFCC00",
+	"FF9900",
+	"FF6600",
+	"666699",
+	"969696",
+	"003366",
+	"339966",
+	"003300",
+	"333300",
+	"993300",
+	"993366",
+	"333399",
+	"333333"
+];
+function buildBiffPalette(records) {
+	const palette = [...PALETTE56.slice(0, 8), ...PALETTE56];
+	for (const rec of records) if (rec.type === REC_PALETTE) applyPalette(rec.data, palette);
+	return (icv) => {
+		if (icv === 32767 || icv === 64 || icv === 65) return void 0;
+		const rgb = palette[icv];
+		return rgb ? `FF${rgb}` : void 0;
+	};
+}
+function parseBiffStyles(records) {
+	const color = buildBiffPalette(records);
+	const fonts = [];
+	let fontIdx = 0;
+	const numFmts = /* @__PURE__ */ new Map();
+	const fills = [{ patternType: "none" }, { patternType: "gray125" }];
+	const fillIds = /* @__PURE__ */ new Map();
+	const borders = [{}];
+	const borderIds = /* @__PURE__ */ new Map();
+	const cellXfs = [];
+	const internFill = (fill) => {
+		if (!fill || !fill.patternType || fill.patternType === "none") return 0;
+		const key = `${fill.patternType}|${fill.fgColorHex ?? ""}|${fill.bgColorHex ?? ""}`;
+		let id = fillIds.get(key);
+		if (id === void 0) {
+			id = fills.length;
+			fills.push(fill);
+			fillIds.set(key, id);
+		}
+		return id;
+	};
+	const internBorder = (border) => {
+		if (!border || Object.keys(border).length === 0) return 0;
+		const key = JSON.stringify(border);
+		let id = borderIds.get(key);
+		if (id === void 0) {
+			id = borders.length;
+			borders.push(border);
+			borderIds.set(key, id);
+		}
+		return id;
+	};
+	for (const rec of records) {
+		const d = rec.data;
+		if (rec.type === REC_FONT) {
+			const id = fontIdx < 4 ? fontIdx : fontIdx + 1;
+			while (fonts.length < id) fonts.push({});
+			fonts[id] = parseFont(d, color);
+			fontIdx++;
+		} else if (rec.type === REC_FORMAT) {
+			const ifmt = u16(d, 0);
+			const code = readXlUnicode(d, 2);
+			if (code) numFmts.set(ifmt, code);
+		} else if (rec.type === REC_XF) cellXfs.push(parseXf(d, color, internFill, internBorder));
+	}
+	return {
+		numFmts,
+		fonts,
+		fills,
+		borders,
+		cellXfs
+	};
+}
+function parseFont(d, color) {
+	const twips = u16(d, 0);
+	const grbit = u16(d, 2);
+	const icv = u16(d, 4);
+	const bls = u16(d, 6);
+	const uls = d[10] ?? 0;
+	const name = readShortUnicode(d, 14);
+	const out = {};
+	if (twips > 0) out.sizePt = twips / 20;
+	if (bls >= 700) out.bold = true;
+	if ((grbit & 2) !== 0) out.italic = true;
+	if (uls !== 0) out.underline = true;
+	const c = color(icv);
+	if (c) out.colorHex = c;
+	if (name) out.name = name;
+	return out;
+}
+function parseXf(d, color, internFill, internBorder) {
+	const fontId = u16(d, 0);
+	const numFmtId = u16(d, 2);
+	const align1 = d[6] ?? 0;
+	const rotation = d[7] ?? 0;
+	const indentByte = d[8] ?? 0;
+	const alignment = {};
+	const h = HALIGN[align1 & 7];
+	if (h) alignment.horizontal = h;
+	const v = VALIGN[align1 >> 4 & 7];
+	if (v && v !== "bottom") alignment.vertical = v;
+	if ((align1 & 8) !== 0) alignment.wrapText = true;
+	const indent = indentByte & 15;
+	if (indent > 0) alignment.indent = indent;
+	if ((indentByte & 16) !== 0) alignment.shrinkToFit = true;
+	if (rotation > 0 && rotation !== 255) alignment.textRotation = rotation;
+	else if (rotation === 255) alignment.textRotation = 255;
+	const brd1 = u16(d, 10);
+	const brd2 = u32(d, 12);
+	const brd3 = u32(d, 16);
+	const edge = (style, icv) => {
+		const name = BORDER_STYLES[style];
+		if (!name || name === "none") return void 0;
+		const c = color(icv);
+		return c ? {
+			style: name,
+			colorHex: c
+		} : { style: name };
+	};
+	const border = {};
+	const left = edge(brd1 & 15, brd2 & 127);
+	const right = edge(brd1 >> 4 & 15, brd2 >> 7 & 127);
+	const top = edge(brd1 >> 8 & 15, brd2 >> 16 & 127);
+	const bottom = edge(brd1 >> 12 & 15, brd2 >> 23 & 127);
+	if (left) border.left = left;
+	if (right) border.right = right;
+	if (top) border.top = top;
+	if (bottom) border.bottom = bottom;
+	const patternType = FILL_PATTERNS[brd3 >> 26 & 63];
+	let fill;
+	if (patternType && patternType !== "none") {
+		const fg = color(brd3 & 127);
+		const bg = color(brd3 >> 7 & 127);
+		fill = {
+			patternType,
+			...fg ? { fgColorHex: fg } : {},
+			...bg ? { bgColorHex: bg } : {}
+		};
+	}
+	const fillId = internFill(fill);
+	const borderId = internBorder(Object.keys(border).length > 0 ? border : void 0);
+	return {
+		numFmtId,
+		fontId,
+		fillId,
+		borderId,
+		...numFmtId > 0 ? { applyNumberFormat: true } : {},
+		...fillId > 1 ? { applyFill: true } : {},
+		...borderId > 0 ? { applyBorder: true } : {},
+		...Object.keys(alignment).length > 0 ? {
+			applyAlignment: true,
+			alignment
+		} : {}
+	};
+}
+function applyPalette(d, palette) {
+	const count = u16(d, 0);
+	for (let i = 0; i < count; i++) {
+		const o = 2 + i * 4;
+		if (o + 3 > d.length) break;
+		const hex = `${hex2(d[o])}${hex2(d[o + 1])}${hex2(d[o + 2])}`;
+		if (8 + i < palette.length) palette[8 + i] = hex;
+	}
+}
+function readShortUnicode(d, off) {
+	if (off >= d.length) return "";
+	const cch = d[off];
+	const high = (d[off + 1] & 1) !== 0;
+	return decodeChars(d, off + 2, cch, high);
+}
+function readXlUnicode(d, off) {
+	if (off + 3 > d.length) return "";
+	const cch = u16(d, off);
+	const high = (d[off + 2] & 1) !== 0;
+	return decodeChars(d, off + 3, cch, high);
+}
+function decodeChars(d, off, cch, high) {
+	let s = "";
+	if (high) for (let i = 0; i < cch && off + i * 2 + 1 < d.length; i++) s += String.fromCharCode(d[off + i * 2] | d[off + i * 2 + 1] << 8);
+	else for (let i = 0; i < cch && off + i < d.length; i++) s += String.fromCharCode(d[off + i]);
+	return s;
+}
+function hex2(n) {
+	return n.toString(16).padStart(2, "0").toUpperCase();
+}
+function u16(d, off) {
+	return (d[off] ?? 0) | (d[off + 1] ?? 0) << 8;
+}
+function u32(d, off) {
+	return ((d[off] ?? 0) | (d[off + 1] ?? 0) << 8 | (d[off + 2] ?? 0) << 16 | (d[off + 3] ?? 0) << 24) >>> 0;
+}
+//#endregion
+export { buildBiffPalette, parseBiffStyles };

package/dist/esm/excel/xls/escher.d.ts

@@ -0,0 +1,24 @@
+export interface EscherPicture {
+    readonly blipIndex: number;
+    readonly anchor?: EscherAnchor;
+}
+export interface EscherAnchor {
+    readonly col1: number;
+    readonly row1: number;
+    readonly col2: number;
+    readonly row2: number;
+    readonly dx1: number;
+    readonly dy1: number;
+    readonly dx2: number;
+    readonly dy2: number;
+}
+export declare function parseBlipStore(msoDrawingGroup: Uint8Array): Array<Uint8Array | undefined>;
+export declare function parseSheetPictures(msoDrawing: Uint8Array): Array<EscherPicture>;
+export interface EscherShape {
+    readonly shapeType: number;
+    readonly hasText: boolean;
+    readonly anchor?: EscherAnchor;
+    readonly fillColorHex?: string;
+    readonly lineColorHex?: string;
+}
+export declare function parseSheetShapes(msoDrawing: Uint8Array): Array<EscherShape>;

package/dist/esm/excel/xls/escher.js

@@ -0,0 +1,171 @@
+//#region src/excel/xls/escher.ts
+var FBT_BSTORE_CONTAINER = 61441;
+var FBT_BSE = 61447;
+var FBT_SP_CONTAINER = 61444;
+var FBT_OPT = 61451;
+var FBT_CLIENT_ANCHOR = 61456;
+var PROP_PIB = 260;
+var MAX_DEPTH = 24;
+function* records(d) {
+	let off = 0;
+	while (off + 8 <= d.length) {
+		const verInstance = u16(d, off);
+		const type = u16(d, off + 2);
+		const len = u32(d, off + 4);
+		const start = off + 8;
+		const end = Math.min(d.length, start + len);
+		yield {
+			type,
+			instance: verInstance >> 4,
+			isContainer: (verInstance & 15) === 15,
+			data: d.subarray(start, end)
+		};
+		if (end <= off) break;
+		off = end;
+	}
+}
+function parseBlipStore(msoDrawingGroup) {
+	const store = findContainer(msoDrawingGroup, FBT_BSTORE_CONTAINER, 0);
+	if (!store) return [];
+	const out = [];
+	for (const r of records(store)) if (r.type === FBT_BSE) out.push(findImageBytes(r.data));
+	return out;
+}
+function findContainer(d, type, depth) {
+	if (depth > MAX_DEPTH) return void 0;
+	for (const r of records(d)) {
+		if (r.type === type) return r.data;
+		if (r.isContainer) {
+			const found = findContainer(r.data, type, depth + 1);
+			if (found) return found;
+		}
+	}
+}
+function parseSheetPictures(msoDrawing) {
+	const out = [];
+	collectPictures(msoDrawing, out, 0);
+	return out;
+}
+function collectPictures(d, out, depth) {
+	if (depth > MAX_DEPTH) return;
+	for (const r of records(d)) if (r.type === FBT_SP_CONTAINER) {
+		let blipIndex;
+		let anchor;
+		for (const child of records(r.data)) if (child.type === FBT_OPT) blipIndex = optProperty(child.data, child.instance, PROP_PIB);
+		else if (child.type === FBT_CLIENT_ANCHOR) anchor = parseAnchor(child.data);
+		if (blipIndex !== void 0 && blipIndex > 0) out.push({
+			blipIndex,
+			...anchor ? { anchor } : {}
+		});
+	} else if (r.isContainer) collectPictures(r.data, out, depth + 1);
+}
+var FBT_SP = 61450;
+var FBT_CLIENT_TEXTBOX = 61453;
+var PROP_FILL_COLOR = 385;
+var PROP_LINE_COLOR = 448;
+function parseSheetShapes(msoDrawing) {
+	const out = [];
+	collectShapes(msoDrawing, out, 0);
+	return out;
+}
+function collectShapes(d, out, depth) {
+	if (depth > MAX_DEPTH) return;
+	for (const r of records(d)) if (r.type === FBT_SP_CONTAINER) {
+		let shapeType = 0;
+		let hasText = false;
+		let pib;
+		let anchor;
+		let fill;
+		let line;
+		for (const child of records(r.data)) if (child.type === FBT_SP) shapeType = child.instance;
+		else if (child.type === FBT_OPT) {
+			pib = optProperty(child.data, child.instance, PROP_PIB);
+			fill = optColor(child.data, child.instance, PROP_FILL_COLOR);
+			line = optColor(child.data, child.instance, PROP_LINE_COLOR);
+		} else if (child.type === FBT_CLIENT_ANCHOR) anchor = parseAnchor(child.data);
+		else if (child.type === FBT_CLIENT_TEXTBOX) hasText = true;
+		if (pib === void 0 && shapeType !== 0) out.push({
+			shapeType,
+			hasText,
+			...anchor ? { anchor } : {},
+			...fill ? { fillColorHex: fill } : {},
+			...line ? { lineColorHex: line } : {}
+		});
+	} else if (r.isContainer) collectShapes(r.data, out, depth + 1);
+}
+function optColor(d, count, wantId) {
+	const v = optProperty(d, count, wantId);
+	if (v === void 0 || v >>> 24 !== 0) return void 0;
+	return `${hex2(v & 255)}${hex2(v >> 8 & 255)}${hex2(v >> 16 & 255)}`;
+}
+function hex2(n) {
+	return n.toString(16).padStart(2, "0").toUpperCase();
+}
+function optProperty(d, count, wantId) {
+	for (let i = 0; i < count && i * 6 + 6 <= d.length; i++) {
+		const id = u16(d, i * 6);
+		if ((id & 16383) === wantId && (id & 32768) === 0) return u32(d, i * 6 + 2);
+	}
+}
+function parseAnchor(d) {
+	if (d.length < 18) return void 0;
+	return {
+		col1: u16(d, 2),
+		dx1: u16(d, 4),
+		row1: u16(d, 6),
+		dy1: u16(d, 8),
+		col2: u16(d, 10),
+		dx2: u16(d, 12),
+		row2: u16(d, 14),
+		dy2: u16(d, 16)
+	};
+}
+var MAGICS = [
+	[
+		137,
+		80,
+		78,
+		71
+	],
+	[
+		255,
+		216,
+		255
+	],
+	[
+		71,
+		73,
+		70,
+		56
+	],
+	[66, 77],
+	[
+		73,
+		73,
+		42,
+		0
+	],
+	[
+		77,
+		77,
+		0,
+		42
+	]
+];
+function findImageBytes(bse) {
+	const limit = Math.min(bse.length, 80);
+	for (let off = 0; off < limit; off++) for (const magic of MAGICS) if (matches(bse, off, magic)) return bse.subarray(off);
+}
+function matches(d, off, magic) {
+	if (off + magic.length > d.length) return false;
+	for (let i = 0; i < magic.length; i++) if (d[off + i] !== magic[i]) return false;
+	return true;
+}
+function u16(d, off) {
+	return (d[off] ?? 0) | (d[off + 1] ?? 0) << 8;
+}
+function u32(d, off) {
+	return ((d[off] ?? 0) | (d[off + 1] ?? 0) << 8 | (d[off + 2] ?? 0) << 16 | (d[off + 3] ?? 0) << 24) >>> 0;
+}
+//#endregion
+export { parseBlipStore, parseSheetPictures, parseSheetShapes };

package/dist/esm/excel/xls/xls-reader.d.ts

@@ -0,0 +1,3 @@
+import { DocumentReader } from '../../core/ir/adapters.js';
+import { SheetDoc } from '../../core/ir/sheet.js';
+export declare const xlsReader: DocumentReader<SheetDoc>;

package/dist/esm/excel/xls/xls-reader.js

@@ -0,0 +1,30 @@
+import { FEATURES } from "../../core/ir/features.js";
+import { isCfb, openCfb } from "../../core/ole/cfb.js";
+import { readXlsToSheetDoc } from "./biff-reader.js";
+//#region src/excel/xls/xls-reader.ts
+function looksLikeXls(bytes) {
+	if (!isCfb(bytes)) return false;
+	try {
+		const cfb = openCfb(bytes);
+		return cfb.hasStream("Workbook") || cfb.hasStream("Book");
+	} catch {
+		return false;
+	}
+}
+var XLS_LOSSES = [{
+	severity: "degraded",
+	feature: FEATURES.cellFormatting,
+	detail: "legacy .xls Excel tables / autofilter are not read; the sheet’s cell data, styling, images, charts, drawing shapes, conditional formatting, comments, hyperlinks, data validation, defined names, the page-setup print model, frozen panes and custom row heights are"
+}];
+var xlsReader = {
+	id: "xls",
+	produces: "sheet",
+	supports: new Set([FEATURES.text, FEATURES.tables]),
+	sniff: looksLikeXls,
+	read: (bytes) => ({
+		doc: readXlsToSheetDoc(bytes),
+		losses: XLS_LOSSES
+	})
+};
+//#endregion
+export { xlsReader };

package/dist/esm/excel/xlsx-reader.d.ts

@@ -1,6 +1,7 @@
 import { DocumentReader, ReadResult } from '../core/ir/adapters.js';
 import { FlowDoc } from '../core/ir/flow.js';
 import { SheetDoc } from '../core/ir/sheet.js';
-export declare function readXlsx(xlsx: Uint8Array): ReadResult<FlowDoc>;
+import { ProjectSheetOptions } from './sheet-to-flow.js';
+export declare function readXlsx(xlsx: Uint8Array, options?: ProjectSheetOptions): ReadResult<FlowDoc>;
 export declare function readXlsxToSheetDoc(xlsx: Uint8Array): SheetDoc;
 export declare const xlsxReader: DocumentReader<SheetDoc>;