ooxml.js 2.5.2 → 2.6.1

package/dist/typed/xlsx/number-format.cjs

@@ -0,0 +1,324 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/typed/xlsx/number-format.ts
+const MAX_NUMBER_FORMAT_SECTIONS = 4;
+function at(chars, index) {
+	return chars[index] ?? "";
+}
+function tokenizeNumberFormat(formatCode) {
+	const chars = [...formatCode];
+	const tokens = [];
+	let index = 0;
+	while (index < chars.length) {
+		const char = at(chars, index);
+		if (char === "\"") {
+			let text = "";
+			index += 1;
+			while (index < chars.length && at(chars, index) !== "\"") {
+				text += at(chars, index);
+				index += 1;
+			}
+			index += 1;
+			tokens.push({
+				kind: "literal",
+				text
+			});
+			continue;
+		}
+		if (char === "\\" || char === "_" || char === "*") {
+			tokens.push({
+				kind: "literal",
+				text: at(chars, index + 1)
+			});
+			index += 2;
+			continue;
+		}
+		if (char === "[") {
+			let body = "";
+			index += 1;
+			while (index < chars.length && at(chars, index) !== "]") {
+				body += at(chars, index);
+				index += 1;
+			}
+			index += 1;
+			tokens.push({
+				kind: "bracket",
+				body
+			});
+			continue;
+		}
+		if (char === ";") {
+			tokens.push({ kind: "separator" });
+			index += 1;
+			continue;
+		}
+		tokens.push({
+			kind: "code",
+			char
+		});
+		index += 1;
+	}
+	return tokens;
+}
+function splitNumberFormatSections(tokens) {
+	const sections = [];
+	let current = [];
+	for (const token of tokens) {
+		if (token.kind === "separator") {
+			sections.push(current);
+			current = [];
+			continue;
+		}
+		current.push(token);
+	}
+	sections.push(current);
+	return sections.slice(0, 4);
+}
+const CURRENCY_SYMBOL = /\p{Sc}/u;
+function containsCurrencySymbol(text) {
+	return CURRENCY_SYMBOL.test(text);
+}
+function isIsoCurrencyCodeShape(marker) {
+	if (marker.length !== 3) return false;
+	for (const char of marker) {
+		const upper = char.toUpperCase();
+		if (upper < "A" || upper > "Z") return false;
+	}
+	return true;
+}
+function isElapsedBracketBody(body) {
+	let letter;
+	for (const char of body) {
+		const lower = char.toLowerCase();
+		if (letter === void 0) {
+			if (lower !== "h" && lower !== "m" && lower !== "s") return false;
+			letter = lower;
+		} else if (lower !== letter) return false;
+	}
+	return letter !== void 0;
+}
+function classifyBracket(body) {
+	if (body.startsWith("$")) {
+		const rest = body.slice(1);
+		const dashIndex = rest.indexOf("-");
+		const marker = dashIndex === -1 ? rest : rest.slice(0, dashIndex);
+		if (marker === "") return { kind: "none" };
+		return isIsoCurrencyCodeShape(marker) ? {
+			kind: "currency",
+			code: marker.toUpperCase()
+		} : { kind: "currency" };
+	}
+	return isElapsedBracketBody(body) ? { kind: "elapsed" } : { kind: "none" };
+}
+const AMPM_MARKERS = ["am/pm", "a/p"];
+const AMPM_LETTER = "ampm";
+function matchesAt(chars, index, marker) {
+	return [...marker].every((char, offset) => at(chars, index + offset).toLowerCase() === char);
+}
+function codeRunsOf(section) {
+	const chars = [];
+	for (const token of section) if (token.kind === "code") chars.push(token.char);
+	const runs = [];
+	let index = 0;
+	while (index < chars.length) {
+		const marker = AMPM_MARKERS.find((candidate) => matchesAt(chars, index, candidate));
+		if (marker !== void 0) {
+			runs.push({
+				letter: AMPM_LETTER,
+				length: marker.length
+			});
+			index += marker.length;
+			continue;
+		}
+		const char = at(chars, index).toLowerCase();
+		let length = 0;
+		while (index + length < chars.length && at(chars, index + length).toLowerCase() === char) length += 1;
+		runs.push({
+			letter: char,
+			length
+		});
+		index += length;
+	}
+	return runs;
+}
+const RESOLVING_LETTERS = [
+	"y",
+	"d",
+	"h",
+	"s"
+];
+function nearestResolvingLetter(runs, from, step) {
+	for (let index = from + step; index >= 0 && index < runs.length; index += step) {
+		const run = runs[index];
+		if (run !== void 0 && RESOLVING_LETTERS.includes(run.letter)) return run.letter;
+	}
+}
+function monthRunIsMinutes(runs, index) {
+	return nearestResolvingLetter(runs, index, -1) === "h" || nearestResolvingLetter(runs, index, 1) === "s";
+}
+const PLAIN_NUMBER = { kind: "number" };
+const NUMERIC_CODES = [
+	"0",
+	"#",
+	"?",
+	".",
+	","
+];
+function collectSignals(section) {
+	const signals = {
+		hasDate: false,
+		hasTime: false,
+		hasElapsed: false,
+		hasPercent: false,
+		hasNumeric: false,
+		hasText: false,
+		hasCurrency: false
+	};
+	for (const token of section) {
+		if (token.kind === "literal" && containsCurrencySymbol(token.text)) signals.hasCurrency = true;
+		if (token.kind === "bracket") {
+			const meaning = classifyBracket(token.body);
+			if (meaning.kind === "elapsed") signals.hasElapsed = true;
+			if (meaning.kind === "currency") {
+				signals.hasCurrency = true;
+				if (signals.currencyCode === void 0 && meaning.code !== void 0) signals.currencyCode = meaning.code;
+			}
+		}
+	}
+	const runs = codeRunsOf(section);
+	runs.forEach((run, index) => {
+		if (run.letter === "y" || run.letter === "d") {
+			signals.hasDate = true;
+			return;
+		}
+		if (run.letter === "h" || run.letter === "s" || run.letter === AMPM_LETTER) {
+			signals.hasTime = true;
+			return;
+		}
+		if (run.letter === "m") {
+			if (run.length <= 2 && monthRunIsMinutes(runs, index)) signals.hasTime = true;
+			else signals.hasDate = true;
+			return;
+		}
+		if (run.letter === "e") {
+			const next = runs[index + 1];
+			signals.hasNumeric = signals.hasNumeric || next?.letter === "+" || next?.letter === "-";
+			return;
+		}
+		if (run.letter === "%") {
+			signals.hasPercent = true;
+			return;
+		}
+		if (run.letter === "@") {
+			signals.hasText = true;
+			return;
+		}
+		if (NUMERIC_CODES.includes(run.letter)) {
+			signals.hasNumeric = true;
+			return;
+		}
+		if (containsCurrencySymbol(run.letter)) signals.hasCurrency = true;
+	});
+	return signals;
+}
+function classifySection(section) {
+	const signals = collectSignals(section);
+	if (signals.hasElapsed) return { kind: "elapsedTime" };
+	if (signals.hasDate) return signals.hasTime ? { kind: "dateTime" } : { kind: "date" };
+	if (signals.hasTime) return { kind: "time" };
+	if (signals.hasPercent) return { kind: "percentage" };
+	if (signals.hasCurrency) {
+		const code = signals.currencyCode;
+		return code === void 0 ? { kind: "currency" } : {
+			kind: "currency",
+			code
+		};
+	}
+	if (signals.hasText && !signals.hasNumeric) return { kind: "text" };
+	return PLAIN_NUMBER;
+}
+function classifyNumberFormat(formatCode) {
+	const first = splitNumberFormatSections(tokenizeNumberFormat(formatCode))[0];
+	return first === void 0 ? PLAIN_NUMBER : classifySection(first);
+}
+const BUILTIN_NUMBER_FORMATS = /* @__PURE__ */ new Map([
+	[0, "General"],
+	[1, "0"],
+	[2, "0.00"],
+	[3, "#,##0"],
+	[4, "#,##0.00"],
+	[5, "$#,##0_);($#,##0)"],
+	[6, "$#,##0_);[Red]($#,##0)"],
+	[7, "$#,##0.00_);($#,##0.00)"],
+	[8, "$#,##0.00_);[Red]($#,##0.00)"],
+	[9, "0%"],
+	[10, "0.00%"],
+	[11, "0.00E+00"],
+	[12, "# ?/?"],
+	[13, "# ??/??"],
+	[14, "mm-dd-yy"],
+	[15, "d-mmm-yy"],
+	[16, "d-mmm"],
+	[17, "mmm-yy"],
+	[18, "h:mm AM/PM"],
+	[19, "h:mm:ss AM/PM"],
+	[20, "h:mm"],
+	[21, "h:mm:ss"],
+	[22, "m/d/yy h:mm"],
+	[37, "#,##0 ;(#,##0)"],
+	[38, "#,##0 ;[Red](#,##0)"],
+	[39, "#,##0.00;(#,##0.00)"],
+	[40, "#,##0.00;[Red](#,##0.00)"],
+	[41, "_(* #,##0_);_(* \\(#,##0\\);_(* \"-\"_);_(@_)"],
+	[42, "_(\"$\"* #,##0_);_(\"$\"* \\(#,##0\\);_(\"$\"* \"-\"_);_(@_)"],
+	[43, "_(* #,##0.00_);_(* \\(#,##0.00\\);_(* \"-\"??_);_(@_)"],
+	[44, "_(\"$\"* #,##0.00_);_(\"$\"* \\(#,##0.00\\);_(\"$\"* \"-\"??_);_(@_)"],
+	[45, "mm:ss"],
+	[46, "[h]:mm:ss"],
+	[47, "mmss.0"],
+	[48, "##0.0E+0"],
+	[49, "@"]
+]);
+const PERCENTAGE_NUMBER_FORMAT = {
+	kind: "builtin",
+	id: 10
+};
+const TIME_NUMBER_FORMAT = {
+	kind: "builtin",
+	id: 21
+};
+const AMOUNT_NUMBER_FORMAT = {
+	kind: "builtin",
+	id: 4
+};
+const DATE_NUMBER_FORMAT = {
+	kind: "custom",
+	code: "yyyy\\-mm\\-dd"
+};
+const DATE_TIME_NUMBER_FORMAT = {
+	kind: "custom",
+	code: "yyyy\\-mm\\-dd hh:mm:ss"
+};
+const BOOLEAN_NUMBER_FORMAT = {
+	kind: "custom",
+	code: "\"TRUE\";\"TRUE\";\"FALSE\""
+};
+function currencyNumberFormat(code) {
+	if (code === void 0 || !isIsoCurrencyCodeShape(code)) return AMOUNT_NUMBER_FORMAT;
+	return {
+		kind: "custom",
+		code: `[$${code.toUpperCase()}]#,##0.00`
+	};
+}
+//#endregion
+exports.AMOUNT_NUMBER_FORMAT = AMOUNT_NUMBER_FORMAT;
+exports.BOOLEAN_NUMBER_FORMAT = BOOLEAN_NUMBER_FORMAT;
+exports.BUILTIN_NUMBER_FORMATS = BUILTIN_NUMBER_FORMATS;
+exports.DATE_NUMBER_FORMAT = DATE_NUMBER_FORMAT;
+exports.DATE_TIME_NUMBER_FORMAT = DATE_TIME_NUMBER_FORMAT;
+exports.MAX_NUMBER_FORMAT_SECTIONS = MAX_NUMBER_FORMAT_SECTIONS;
+exports.PERCENTAGE_NUMBER_FORMAT = PERCENTAGE_NUMBER_FORMAT;
+exports.TIME_NUMBER_FORMAT = TIME_NUMBER_FORMAT;
+exports.classifyNumberFormat = classifyNumberFormat;
+exports.currencyNumberFormat = currencyNumberFormat;
+exports.splitNumberFormatSections = splitNumberFormatSections;
+exports.tokenizeNumberFormat = tokenizeNumberFormat;

package/dist/typed/xlsx/number-format.d.cts

@@ -0,0 +1,52 @@
+//#region src/typed/xlsx/number-format.d.ts
+type NumberFormatToken = {
+  kind: 'literal';
+  text: string;
+} | {
+  kind: 'bracket';
+  body: string;
+} | {
+  kind: 'separator';
+} | {
+  kind: 'code';
+  char: string;
+};
+declare const MAX_NUMBER_FORMAT_SECTIONS = 4;
+declare function tokenizeNumberFormat(formatCode: string): NumberFormatToken[];
+declare function splitNumberFormatSections(tokens: readonly NumberFormatToken[]): NumberFormatToken[][];
+type NumberFormatClass = {
+  kind: 'number';
+} | {
+  kind: 'text';
+} | {
+  kind: 'percentage';
+} | {
+  kind: 'currency';
+  code?: string;
+} | {
+  kind: 'date';
+} | {
+  kind: 'time';
+} | {
+  kind: 'dateTime';
+} | {
+  kind: 'elapsedTime';
+};
+declare function classifyNumberFormat(formatCode: string): NumberFormatClass;
+declare const BUILTIN_NUMBER_FORMATS: ReadonlyMap<number, string>;
+type CellNumberFormat = {
+  kind: 'builtin';
+  id: number;
+} | {
+  kind: 'custom';
+  code: string;
+};
+declare const PERCENTAGE_NUMBER_FORMAT: CellNumberFormat;
+declare const TIME_NUMBER_FORMAT: CellNumberFormat;
+declare const AMOUNT_NUMBER_FORMAT: CellNumberFormat;
+declare const DATE_NUMBER_FORMAT: CellNumberFormat;
+declare const DATE_TIME_NUMBER_FORMAT: CellNumberFormat;
+declare const BOOLEAN_NUMBER_FORMAT: CellNumberFormat;
+declare function currencyNumberFormat(code: string | undefined): CellNumberFormat;
+//#endregion
+export { AMOUNT_NUMBER_FORMAT, BOOLEAN_NUMBER_FORMAT, BUILTIN_NUMBER_FORMATS, CellNumberFormat, DATE_NUMBER_FORMAT, DATE_TIME_NUMBER_FORMAT, MAX_NUMBER_FORMAT_SECTIONS, NumberFormatClass, NumberFormatToken, PERCENTAGE_NUMBER_FORMAT, TIME_NUMBER_FORMAT, classifyNumberFormat, currencyNumberFormat, splitNumberFormatSections, tokenizeNumberFormat };

package/dist/typed/xlsx/number-format.d.ts

@@ -0,0 +1,52 @@
+//#region src/typed/xlsx/number-format.d.ts
+type NumberFormatToken = {
+  kind: 'literal';
+  text: string;
+} | {
+  kind: 'bracket';
+  body: string;
+} | {
+  kind: 'separator';
+} | {
+  kind: 'code';
+  char: string;
+};
+declare const MAX_NUMBER_FORMAT_SECTIONS = 4;
+declare function tokenizeNumberFormat(formatCode: string): NumberFormatToken[];
+declare function splitNumberFormatSections(tokens: readonly NumberFormatToken[]): NumberFormatToken[][];
+type NumberFormatClass = {
+  kind: 'number';
+} | {
+  kind: 'text';
+} | {
+  kind: 'percentage';
+} | {
+  kind: 'currency';
+  code?: string;
+} | {
+  kind: 'date';
+} | {
+  kind: 'time';
+} | {
+  kind: 'dateTime';
+} | {
+  kind: 'elapsedTime';
+};
+declare function classifyNumberFormat(formatCode: string): NumberFormatClass;
+declare const BUILTIN_NUMBER_FORMATS: ReadonlyMap<number, string>;
+type CellNumberFormat = {
+  kind: 'builtin';
+  id: number;
+} | {
+  kind: 'custom';
+  code: string;
+};
+declare const PERCENTAGE_NUMBER_FORMAT: CellNumberFormat;
+declare const TIME_NUMBER_FORMAT: CellNumberFormat;
+declare const AMOUNT_NUMBER_FORMAT: CellNumberFormat;
+declare const DATE_NUMBER_FORMAT: CellNumberFormat;
+declare const DATE_TIME_NUMBER_FORMAT: CellNumberFormat;
+declare const BOOLEAN_NUMBER_FORMAT: CellNumberFormat;
+declare function currencyNumberFormat(code: string | undefined): CellNumberFormat;
+//#endregion
+export { AMOUNT_NUMBER_FORMAT, BOOLEAN_NUMBER_FORMAT, BUILTIN_NUMBER_FORMATS, CellNumberFormat, DATE_NUMBER_FORMAT, DATE_TIME_NUMBER_FORMAT, MAX_NUMBER_FORMAT_SECTIONS, NumberFormatClass, NumberFormatToken, PERCENTAGE_NUMBER_FORMAT, TIME_NUMBER_FORMAT, classifyNumberFormat, currencyNumberFormat, splitNumberFormatSections, tokenizeNumberFormat };