documonster 0.1.0 → 0.1.1

package/dist/browser/modules/excel/surface/workbook.browser.d.ts

@@ -6,7 +6,7 @@
  * Node file-path `readFile` / `writeFile`). The `.browser` same-name swap
  * selects the browser xlsx binding.
  */
-export { createWorkbook as create, addWorksheet, getWorksheet, getWorksheets, removeWorksheet, addChartsheet, addPivotChartsheet, getChartsheet, getChartsheets, removeChartsheet, renameChartsheet, copyChartsheet, replaceChartsheetChart, getDefinedNames, eachSheet, importSheet, protectWorkbook as protect, unprotectWorkbook as unprotect, addExternalLink, getExternalLink, registerPerson, registerFunction, unregisterFunction, getWorkbookModel as getModel, setWorkbookModel as setModel, createStreamWriter, createStreamReader } from "../core/workbook.browser.js";
+export { createWorkbook as create, addWorksheet, getWorksheet, getWorksheets, removeWorksheet, addChartsheet, addPivotChartsheet, getChartsheet, getChartsheets, removeChartsheet, renameChartsheet, copyChartsheet, replaceChartsheetChart, getDefinedNames, eachSheet, importSheet, protectWorkbook as protect, unprotectWorkbook as unprotect, addExternalLink, getExternalLink, registerPerson, registerFunction, unregisterFunction, defineCellStyle, getCellStyle, listCellStyles, removeCellStyle, useBuiltinCellStyle, getWorkbookModel as getModel, setWorkbookModel as setModel, createStreamWriter, createStreamReader } from "../core/workbook.browser.js";
 export { toBuffer, read, readStream, writeStream, getXlsxIo } from "../core/xlsx-io.js";
 /** A workbook handle (opaque to consumers). */
 export type { WorkbookData as Handle } from "../core/workbook-core.js";

package/dist/browser/modules/excel/surface/workbook.browser.js

@@ -6,5 +6,5 @@
  * Node file-path `readFile` / `writeFile`). The `.browser` same-name swap
  * selects the browser xlsx binding.
  */
-export { createWorkbook as create, addWorksheet, getWorksheet, getWorksheets, removeWorksheet, addChartsheet, addPivotChartsheet, getChartsheet, getChartsheets, removeChartsheet, renameChartsheet, copyChartsheet, replaceChartsheetChart, getDefinedNames, eachSheet, importSheet, protectWorkbook as protect, unprotectWorkbook as unprotect, addExternalLink, getExternalLink, registerPerson, registerFunction, unregisterFunction, getWorkbookModel as getModel, setWorkbookModel as setModel, createStreamWriter, createStreamReader } from "../core/workbook.browser.js";
+export { createWorkbook as create, addWorksheet, getWorksheet, getWorksheets, removeWorksheet, addChartsheet, addPivotChartsheet, getChartsheet, getChartsheets, removeChartsheet, renameChartsheet, copyChartsheet, replaceChartsheetChart, getDefinedNames, eachSheet, importSheet, protectWorkbook as protect, unprotectWorkbook as unprotect, addExternalLink, getExternalLink, registerPerson, registerFunction, unregisterFunction, defineCellStyle, getCellStyle, listCellStyles, removeCellStyle, useBuiltinCellStyle, getWorkbookModel as getModel, setWorkbookModel as setModel, createStreamWriter, createStreamReader } from "../core/workbook.browser.js";
 export { toBuffer, read, readStream, writeStream, getXlsxIo } from "../core/xlsx-io.browser.js";

package/dist/cjs/modules/excel/surface/workbook.browser.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getXlsxIo = exports.writeStream = exports.readStream = exports.read = exports.toBuffer = exports.createStreamReader = exports.createStreamWriter = exports.setModel = exports.getModel = exports.unregisterFunction = exports.registerFunction = exports.registerPerson = exports.getExternalLink = exports.addExternalLink = exports.unprotect = exports.protect = exports.importSheet = exports.eachSheet = exports.getDefinedNames = exports.replaceChartsheetChart = exports.copyChartsheet = exports.renameChartsheet = exports.removeChartsheet = exports.getChartsheets = exports.getChartsheet = exports.addPivotChartsheet = exports.addChartsheet = exports.removeWorksheet = exports.getWorksheets = exports.getWorksheet = exports.addWorksheet = exports.create = void 0;
+exports.getXlsxIo = exports.writeStream = exports.readStream = exports.read = exports.toBuffer = exports.createStreamReader = exports.createStreamWriter = exports.setModel = exports.getModel = exports.useBuiltinCellStyle = exports.removeCellStyle = exports.listCellStyles = exports.getCellStyle = exports.defineCellStyle = exports.unregisterFunction = exports.registerFunction = exports.registerPerson = exports.getExternalLink = exports.addExternalLink = exports.unprotect = exports.protect = exports.importSheet = exports.eachSheet = exports.getDefinedNames = exports.replaceChartsheetChart = exports.copyChartsheet = exports.renameChartsheet = exports.removeChartsheet = exports.getChartsheets = exports.getChartsheet = exports.addPivotChartsheet = exports.addChartsheet = exports.removeWorksheet = exports.getWorksheets = exports.getWorksheet = exports.addWorksheet = exports.create = void 0;
 /**
  * `Workbook` namespace surface — browser entry.
  *
@@ -33,6 +33,11 @@ Object.defineProperty(exports, "getExternalLink", { enumerable: true, get: funct
 Object.defineProperty(exports, "registerPerson", { enumerable: true, get: function () { return workbook_browser_1.registerPerson; } });
 Object.defineProperty(exports, "registerFunction", { enumerable: true, get: function () { return workbook_browser_1.registerFunction; } });
 Object.defineProperty(exports, "unregisterFunction", { enumerable: true, get: function () { return workbook_browser_1.unregisterFunction; } });
+Object.defineProperty(exports, "defineCellStyle", { enumerable: true, get: function () { return workbook_browser_1.defineCellStyle; } });
+Object.defineProperty(exports, "getCellStyle", { enumerable: true, get: function () { return workbook_browser_1.getCellStyle; } });
+Object.defineProperty(exports, "listCellStyles", { enumerable: true, get: function () { return workbook_browser_1.listCellStyles; } });
+Object.defineProperty(exports, "removeCellStyle", { enumerable: true, get: function () { return workbook_browser_1.removeCellStyle; } });
+Object.defineProperty(exports, "useBuiltinCellStyle", { enumerable: true, get: function () { return workbook_browser_1.useBuiltinCellStyle; } });
 Object.defineProperty(exports, "getModel", { enumerable: true, get: function () { return workbook_browser_1.getWorkbookModel; } });
 Object.defineProperty(exports, "setModel", { enumerable: true, get: function () { return workbook_browser_1.setWorkbookModel; } });
 Object.defineProperty(exports, "createStreamWriter", { enumerable: true, get: function () { return workbook_browser_1.createStreamWriter; } });

package/dist/esm/modules/excel/surface/workbook.browser.js

@@ -6,5 +6,5 @@
  * Node file-path `readFile` / `writeFile`). The `.browser` same-name swap
  * selects the browser xlsx binding.
  */
-export { createWorkbook as create, addWorksheet, getWorksheet, getWorksheets, removeWorksheet, addChartsheet, addPivotChartsheet, getChartsheet, getChartsheets, removeChartsheet, renameChartsheet, copyChartsheet, replaceChartsheetChart, getDefinedNames, eachSheet, importSheet, protectWorkbook as protect, unprotectWorkbook as unprotect, addExternalLink, getExternalLink, registerPerson, registerFunction, unregisterFunction, getWorkbookModel as getModel, setWorkbookModel as setModel, createStreamWriter, createStreamReader } from "../core/workbook.browser.js";
+export { createWorkbook as create, addWorksheet, getWorksheet, getWorksheets, removeWorksheet, addChartsheet, addPivotChartsheet, getChartsheet, getChartsheets, removeChartsheet, renameChartsheet, copyChartsheet, replaceChartsheetChart, getDefinedNames, eachSheet, importSheet, protectWorkbook as protect, unprotectWorkbook as unprotect, addExternalLink, getExternalLink, registerPerson, registerFunction, unregisterFunction, defineCellStyle, getCellStyle, listCellStyles, removeCellStyle, useBuiltinCellStyle, getWorkbookModel as getModel, setWorkbookModel as setModel, createStreamWriter, createStreamReader } from "../core/workbook.browser.js";
 export { toBuffer, read, readStream, writeStream, getXlsxIo } from "../core/xlsx-io.js";

package/dist/iife/documonster.archive.iife.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.1.0
+* documonster v0.1.1
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.archive.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.1.0
+* documonster v0.1.1
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.csv.iife.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.1.0
+* documonster v0.1.1
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.csv.iife.min.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.1.0
+* documonster v0.1.1
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License

package/dist/iife/documonster.excel.iife.js

@@ -1,5 +1,5 @@
 /*!
-* documonster v0.1.0
+* documonster v0.1.1
 * Zero-dependency TypeScript toolkit for Excel, Word, PDF, CSV, Markdown, XML & ZIP — one API across Node.js, Bun & browsers.
 * (c) 2026 cjnoname
 * Released under the Apache-2.0 License
@@ -9072,6 +9072,90 @@ this.Documonster = this.Documonster || {};
 		return type === "histogram" || type === "pareto" || type === "waterfall" || type === "boxWhisker";
 	}
 	//#endregion
+	//#region src/modules/excel/core/builtin-cell-styles.ts
+	const THEME_DARK1 = { theme: 1 };
+	const HEADING_BLUE = { argb: "FF1F4E79" };
+	const TITLE_BLUE = { argb: "FF1F4E79" };
+	const GOOD_TEXT = { argb: "FF006100" };
+	const GOOD_FILL = { argb: "FFC6EFCE" };
+	const BAD_TEXT = { argb: "FF9C0006" };
+	const BAD_FILL = { argb: "FFFFC7CE" };
+	const NEUTRAL_TEXT = { argb: "FF9C6500" };
+	const NEUTRAL_FILL = { argb: "FFFFEB9C" };
+	function solidFill(argb) {
+		return {
+			type: "pattern",
+			pattern: "solid",
+			fgColor: { argb }
+		};
+	}
+	const BUILTIN_CELL_STYLES = {
+		Title: {
+			name: "Title",
+			builtinId: 15,
+			font: {
+				name: "Calibri Light",
+				size: 18,
+				bold: false,
+				color: TITLE_BLUE
+			}
+		},
+		Heading1: {
+			name: "Heading 1",
+			builtinId: 16,
+			font: {
+				size: 15,
+				bold: true,
+				color: HEADING_BLUE
+			}
+		},
+		Heading2: {
+			name: "Heading 2",
+			builtinId: 17,
+			font: {
+				size: 13,
+				bold: true,
+				color: HEADING_BLUE
+			}
+		},
+		Heading3: {
+			name: "Heading 3",
+			builtinId: 18,
+			font: {
+				size: 11,
+				bold: true,
+				color: HEADING_BLUE
+			}
+		},
+		Heading4: {
+			name: "Heading 4",
+			builtinId: 19,
+			font: {
+				size: 11,
+				bold: true,
+				color: THEME_DARK1
+			}
+		},
+		Good: {
+			name: "Good",
+			builtinId: 26,
+			font: { color: GOOD_TEXT },
+			fill: solidFill(GOOD_FILL.argb)
+		},
+		Bad: {
+			name: "Bad",
+			builtinId: 27,
+			font: { color: BAD_TEXT },
+			fill: solidFill(BAD_FILL.argb)
+		},
+		Neutral: {
+			name: "Neutral",
+			builtinId: 28,
+			font: { color: NEUTRAL_TEXT },
+			fill: solidFill(NEUTRAL_FILL.argb)
+		}
+	};
+	//#endregion
 	//#region src/modules/excel/xlsx/rel-type.ts
 	var RelType;
 	var init_rel_type = __esmMin((() => {
@@ -9165,10 +9249,44 @@ this.Documonster = this.Documonster || {};
 		if (typeof name !== "string" || name === "") throw new WorksheetNameError("Named cell style name must be a non-empty string.");
 		if (name === "Normal") throw new WorksheetNameError("The built-in \"Normal\" cell style cannot be redefined.");
 	}
+	/**
+	* Define (or replace) a workbook-level named cell style such as "Heading 1".
+	* Cells reference it via `Style.styleName` (e.g. `Cell.applyCellStyle`).
+	*
+	* The reserved built-in "Normal" style (builtinId 0) cannot be redefined; it is
+	* always emitted implicitly as `cellStyleXfs[0]`.
+	*/
+	function defineCellStyle(wb, name, style) {
+		validateCellStyleName(name);
+		if (!wb._cellStyles) wb._cellStyles = /* @__PURE__ */ new Map();
+		wb._cellStyles.set(name, {
+			...style,
+			name
+		});
+	}
 	/** Get a workbook-level named cell style by name, or `undefined` if absent. */
 	function getCellStyle(wb, name) {
 		return wb._cellStyles?.get(name);
 	}
+	/** List all workbook-level named cell styles in definition order. */
+	function listCellStyles(wb) {
+		return wb._cellStyles ? [...wb._cellStyles.values()] : [];
+	}
+	/** Remove a named cell style. Returns `true` if it existed. */
+	function removeCellStyle(wb, name) {
+		return wb._cellStyles ? wb._cellStyles.delete(name) : false;
+	}
+	/**
+	* Define one of the built-in Excel cell-style presets (e.g. "Heading1") on the
+	* workbook and return its OOXML style name (e.g. "Heading 1") for use with
+	* `Cell.applyCellStyle`. Built-in presets carry the correct `builtinId`, which
+	* accessibility software relies on to recognise the style's semantic role.
+	*/
+	function useBuiltinCellStyle(wb, id) {
+		const { name, ...style } = BUILTIN_CELL_STYLES[id];
+		defineCellStyle(wb, name, style);
+		return name;
+	}
 	function removeWorksheetEx(wb, worksheet) {
 		const tables = worksheet.tables;
 		if (tables) for (const tableName of Object.keys(tables)) wb._tableNames.delete(tableName.toLowerCase());
@@ -73764,7 +73882,9 @@ self.onmessage = async function(event) {
 		create: () => createWorkbook,
 		createStreamReader: () => createStreamReader,
 		createStreamWriter: () => createStreamWriter,
+		defineCellStyle: () => defineCellStyle,
 		eachSheet: () => eachSheet,
+		getCellStyle: () => getCellStyle,
 		getChartsheet: () => getChartsheet,
 		getChartsheets: () => getChartsheets,
 		getDefinedNames: () => getDefinedNames,
@@ -73774,11 +73894,13 @@ self.onmessage = async function(event) {
 		getWorksheets: () => getWorksheets,
 		getXlsxIo: () => getXlsxIo,
 		importSheet: () => importSheet,
+		listCellStyles: () => listCellStyles,
 		protect: () => protectWorkbook,
 		read: () => read,
 		readStream: () => readStream,
 		registerFunction: () => registerFunction,
 		registerPerson: () => registerPerson,
+		removeCellStyle: () => removeCellStyle,
 		removeChartsheet: () => removeChartsheet,
 		removeWorksheet: () => removeWorksheet,
 		renameChartsheet: () => renameChartsheet,
@@ -73787,6 +73909,7 @@ self.onmessage = async function(event) {
 		toBuffer: () => toBuffer,
 		unprotect: () => unprotectWorkbook,
 		unregisterFunction: () => unregisterFunction,
+		useBuiltinCellStyle: () => useBuiltinCellStyle,
 		writeStream: () => writeStream
 	});
 	//#endregion