@8ms/helpers 3.1.1 → 3.2.1

package/dist/xlsx/modifyXlsx.cjs

@@ -1,125 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_xlsx_cell = require("./cell.cjs");
-//#region src/xlsx/modifyXlsx.ts
-/**
-* Patches an existing .xlsx template: apply per-sheet XML transformations, add
-* sheets that are not in the template, and optionally embed a logo image.
-*
-* Takes and returns bytes rather than file paths, so it has no filesystem
-* dependency and runs anywhere. Callers that work from disk read the template
-* themselves and hand over the buffer.
-*
-* Use this when the output must keep a branded template's styling; use
-* `createXlsx` when building a workbook from nothing.
-*/
-/** 1 screen pixel at 96 DPI equals 9525 English Metric Units in OOXML. */
-const PX_TO_EMU = 9525;
-/** Default logo box, sized for a typical wide wordmark. */
-const LOGO_WIDTH_PX = 500;
-const LOGO_HEIGHT_PX = 77;
-const DRAWING_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing";
-const IMAGE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
-const WORKSHEET_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet";
-const DRAWING_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.drawing+xml";
-/**
-* Minimal valid worksheet XML used when `createIfMissing` adds a sheet.
-*
-* <sheetData></sheetData> must not be self-closing: setCell's new-row path
-* searches for the literal closing tag.
-*/
-const EMPTY_SHEET_XML = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><worksheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\"><sheetData></sheetData></worksheet>";
-/**
-* Drawing XML for one embedded image, anchored to cell B2 so it sits just below
-* the header row.
-*
-* The image relationship is assumed to be registered as "rId1" in the sibling
-* .rels file.
-*/
-const buildDrawingXml = (widthEmu, heightEmu) => {
-	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><xdr:wsDr xmlns:xdr="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><xdr:oneCellAnchor><xdr:from><xdr:col>1</xdr:col><xdr:colOff>0</xdr:colOff><xdr:row>1</xdr:row><xdr:rowOff>0</xdr:rowOff></xdr:from><xdr:ext cx="${widthEmu}" cy="${heightEmu}"/><xdr:pic><xdr:nvPicPr><xdr:cNvPr id="2" name="Logo"/><xdr:cNvPicPr><a:picLocks noChangeAspect="1"/></xdr:cNvPicPr></xdr:nvPicPr><xdr:blipFill><a:blip r:embed="rId1"/><a:stretch><a:fillRect/></a:stretch></xdr:blipFill><xdr:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="${widthEmu}" cy="${heightEmu}"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom></xdr:spPr></xdr:pic><xdr:clientData/></xdr:oneCellAnchor></xdr:wsDr>`;
-};
-/**
-* Apply per-sheet transformations to a template workbook.
-*
-* @param template The .xlsx template as raw bytes.
-* @param sheets   One entry per sheet to touch, keyed by its 1-indexed position.
-* @param logo     Optional PNG bytes, embedded into sheets with `addLogo`.
-*/
-const modifyXlsx = async (template, sheets, logo) => {
-	const zip = await (await import("jszip")).default.loadAsync(template);
-	if (logo) {
-		zip.file("xl/media/image1.png", logo);
-		const contentTypesFile = zip.file("[Content_Types].xml");
-		if (contentTypesFile) {
-			let contentTypesXml = await contentTypesFile.async("string");
-			if (!contentTypesXml.includes(`Extension="png"`)) contentTypesXml = contentTypesXml.replace("</Types>", () => {
-				return `<Default Extension="png" ContentType="image/png"/></Types>`;
-			});
-			zip.file("[Content_Types].xml", contentTypesXml);
-		}
-	}
-	let drawingCounter = 0;
-	for (const sheet of sheets) {
-		const filename = `xl/worksheets/sheet${sheet.index}.xml`;
-		let existing = zip.file(filename);
-		if (!existing && sheet.createIfMissing) {
-			const name = sheet.sheetName ?? `Sheet${sheet.index}`;
-			const rId = `rId${sheet.index + 10}`;
-			const workbookFile = zip.file("xl/workbook.xml");
-			if (workbookFile) {
-				const workbookXml = await workbookFile.async("string");
-				zip.file("xl/workbook.xml", workbookXml.replace("</sheets>", () => {
-					return `<sheet name="${require_xlsx_cell.getEscapedXml(name)}" sheetId="${sheet.index}" r:id="${rId}"/></sheets>`;
-				}));
-			}
-			const relsFile = zip.file("xl/_rels/workbook.xml.rels");
-			if (relsFile) {
-				const relsXml = await relsFile.async("string");
-				zip.file("xl/_rels/workbook.xml.rels", relsXml.replace("</Relationships>", () => {
-					return `<Relationship Id="${rId}" Type="${WORKSHEET_REL_TYPE}" Target="worksheets/sheet${sheet.index}.xml"/></Relationships>`;
-				}));
-			}
-			zip.file(filename, EMPTY_SHEET_XML);
-			existing = zip.file(filename);
-		}
-		if (!existing) continue;
-		let xml = sheet.modify(await existing.async("string"));
-		if (sheet.addLogo && logo) {
-			drawingCounter++;
-			const drawingNum = drawingCounter;
-			const logoWidthEmu = Math.round((sheet.logoWidthPx ?? LOGO_WIDTH_PX) * PX_TO_EMU);
-			const logoHeightEmu = Math.round((sheet.logoHeightPx ?? LOGO_HEIGHT_PX) * PX_TO_EMU);
-			const drawingRId = `rIdLogo${drawingNum}`;
-			zip.file(`xl/drawings/drawing${drawingNum}.xml`, buildDrawingXml(logoWidthEmu, logoHeightEmu));
-			zip.file(`xl/drawings/_rels/drawing${drawingNum}.xml.rels`, `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="${IMAGE_REL_TYPE}" Target="../media/image1.png"/></Relationships>`);
-			const contentTypesFile = zip.file("[Content_Types].xml");
-			if (contentTypesFile) {
-				let contentTypesXml = await contentTypesFile.async("string");
-				const drawingPart = `/xl/drawings/drawing${drawingNum}.xml`;
-				if (!contentTypesXml.includes(drawingPart)) contentTypesXml = contentTypesXml.replace("</Types>", () => {
-					return `<Override PartName="${drawingPart}" ContentType="${DRAWING_CONTENT_TYPE}"/></Types>`;
-				});
-				zip.file("[Content_Types].xml", contentTypesXml);
-			}
-			const sheetRelsPath = `xl/worksheets/_rels/sheet${sheet.index}.xml.rels`;
-			const sheetRelsFile = zip.file(sheetRelsPath);
-			if (sheetRelsFile) {
-				const relsXml = await sheetRelsFile.async("string");
-				zip.file(sheetRelsPath, relsXml.replace("</Relationships>", () => {
-					return `<Relationship Id="${drawingRId}" Type="${DRAWING_REL_TYPE}" Target="../drawings/drawing${drawingNum}.xml"/></Relationships>`;
-				}));
-			} else zip.file(sheetRelsPath, `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="${drawingRId}" Type="${DRAWING_REL_TYPE}" Target="../drawings/drawing${drawingNum}.xml"/></Relationships>`);
-			if (!xml.includes("xmlns:r=")) xml = xml.replace("<worksheet ", `<worksheet xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" `);
-			xml = xml.replace("</worksheet>", () => {
-				return `<drawing r:id="${drawingRId}"/></worksheet>`;
-			});
-		}
-		zip.file(filename, xml);
-	}
-	return zip.generateAsync({
-		type: "uint8array",
-		compression: "DEFLATE"
-	});
-};
-//#endregion
-exports.modifyXlsx = modifyXlsx;

package/dist/xlsx/modifyXlsx.d.cts

@@ -1,23 +0,0 @@
-//#region src/xlsx/modifyXlsx.d.ts
-export type XlsxSheetModifier = {
-  /** 1-indexed sheet number inside the ZIP (sheet1.xml, sheet2.xml, …). */
-  index: number;
-  modify: (xml: string) => string;
-  /** Create a blank sheet when the template does not contain this index. */
-  createIfMissing?: boolean;
-  /** Sheet name used when createIfMissing creates the sheet. */
-  sheetName?: string;
-  /** Embed the logo into this sheet. Requires a logo to be passed to modifyXlsx. */
-  addLogo?: boolean;
-  logoHeightPx?: number;
-  logoWidthPx?: number;
-};
-/**
- * Apply per-sheet transformations to a template workbook.
- *
- * @param template The .xlsx template as raw bytes.
- * @param sheets   One entry per sheet to touch, keyed by its 1-indexed position.
- * @param logo     Optional PNG bytes, embedded into sheets with `addLogo`.
- */
-export declare const modifyXlsx: (template: Uint8Array, sheets: XlsxSheetModifier[], logo?: Uint8Array) => Promise<Uint8Array>;
-//#endregion

package/dist/xlsx/modifyXlsx.d.mts

@@ -1,23 +0,0 @@
-//#region src/xlsx/modifyXlsx.d.ts
-export type XlsxSheetModifier = {
-  /** 1-indexed sheet number inside the ZIP (sheet1.xml, sheet2.xml, …). */
-  index: number;
-  modify: (xml: string) => string;
-  /** Create a blank sheet when the template does not contain this index. */
-  createIfMissing?: boolean;
-  /** Sheet name used when createIfMissing creates the sheet. */
-  sheetName?: string;
-  /** Embed the logo into this sheet. Requires a logo to be passed to modifyXlsx. */
-  addLogo?: boolean;
-  logoHeightPx?: number;
-  logoWidthPx?: number;
-};
-/**
- * Apply per-sheet transformations to a template workbook.
- *
- * @param template The .xlsx template as raw bytes.
- * @param sheets   One entry per sheet to touch, keyed by its 1-indexed position.
- * @param logo     Optional PNG bytes, embedded into sheets with `addLogo`.
- */
-export declare const modifyXlsx: (template: Uint8Array, sheets: XlsxSheetModifier[], logo?: Uint8Array) => Promise<Uint8Array>;
-//#endregion

package/dist/xlsx/modifyXlsx.mjs

@@ -1,124 +0,0 @@
-import { getEscapedXml } from "./cell.mjs";
-//#region src/xlsx/modifyXlsx.ts
-/**
-* Patches an existing .xlsx template: apply per-sheet XML transformations, add
-* sheets that are not in the template, and optionally embed a logo image.
-*
-* Takes and returns bytes rather than file paths, so it has no filesystem
-* dependency and runs anywhere. Callers that work from disk read the template
-* themselves and hand over the buffer.
-*
-* Use this when the output must keep a branded template's styling; use
-* `createXlsx` when building a workbook from nothing.
-*/
-/** 1 screen pixel at 96 DPI equals 9525 English Metric Units in OOXML. */
-const PX_TO_EMU = 9525;
-/** Default logo box, sized for a typical wide wordmark. */
-const LOGO_WIDTH_PX = 500;
-const LOGO_HEIGHT_PX = 77;
-const DRAWING_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/drawing";
-const IMAGE_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image";
-const WORKSHEET_REL_TYPE = "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet";
-const DRAWING_CONTENT_TYPE = "application/vnd.openxmlformats-officedocument.drawing+xml";
-/**
-* Minimal valid worksheet XML used when `createIfMissing` adds a sheet.
-*
-* <sheetData></sheetData> must not be self-closing: setCell's new-row path
-* searches for the literal closing tag.
-*/
-const EMPTY_SHEET_XML = "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><worksheet xmlns=\"http://schemas.openxmlformats.org/spreadsheetml/2006/main\"><sheetData></sheetData></worksheet>";
-/**
-* Drawing XML for one embedded image, anchored to cell B2 so it sits just below
-* the header row.
-*
-* The image relationship is assumed to be registered as "rId1" in the sibling
-* .rels file.
-*/
-const buildDrawingXml = (widthEmu, heightEmu) => {
-	return `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><xdr:wsDr xmlns:xdr="http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing" xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships"><xdr:oneCellAnchor><xdr:from><xdr:col>1</xdr:col><xdr:colOff>0</xdr:colOff><xdr:row>1</xdr:row><xdr:rowOff>0</xdr:rowOff></xdr:from><xdr:ext cx="${widthEmu}" cy="${heightEmu}"/><xdr:pic><xdr:nvPicPr><xdr:cNvPr id="2" name="Logo"/><xdr:cNvPicPr><a:picLocks noChangeAspect="1"/></xdr:cNvPicPr></xdr:nvPicPr><xdr:blipFill><a:blip r:embed="rId1"/><a:stretch><a:fillRect/></a:stretch></xdr:blipFill><xdr:spPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="${widthEmu}" cy="${heightEmu}"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom></xdr:spPr></xdr:pic><xdr:clientData/></xdr:oneCellAnchor></xdr:wsDr>`;
-};
-/**
-* Apply per-sheet transformations to a template workbook.
-*
-* @param template The .xlsx template as raw bytes.
-* @param sheets   One entry per sheet to touch, keyed by its 1-indexed position.
-* @param logo     Optional PNG bytes, embedded into sheets with `addLogo`.
-*/
-const modifyXlsx = async (template, sheets, logo) => {
-	const zip = await (await import("jszip")).default.loadAsync(template);
-	if (logo) {
-		zip.file("xl/media/image1.png", logo);
-		const contentTypesFile = zip.file("[Content_Types].xml");
-		if (contentTypesFile) {
-			let contentTypesXml = await contentTypesFile.async("string");
-			if (!contentTypesXml.includes(`Extension="png"`)) contentTypesXml = contentTypesXml.replace("</Types>", () => {
-				return `<Default Extension="png" ContentType="image/png"/></Types>`;
-			});
-			zip.file("[Content_Types].xml", contentTypesXml);
-		}
-	}
-	let drawingCounter = 0;
-	for (const sheet of sheets) {
-		const filename = `xl/worksheets/sheet${sheet.index}.xml`;
-		let existing = zip.file(filename);
-		if (!existing && sheet.createIfMissing) {
-			const name = sheet.sheetName ?? `Sheet${sheet.index}`;
-			const rId = `rId${sheet.index + 10}`;
-			const workbookFile = zip.file("xl/workbook.xml");
-			if (workbookFile) {
-				const workbookXml = await workbookFile.async("string");
-				zip.file("xl/workbook.xml", workbookXml.replace("</sheets>", () => {
-					return `<sheet name="${getEscapedXml(name)}" sheetId="${sheet.index}" r:id="${rId}"/></sheets>`;
-				}));
-			}
-			const relsFile = zip.file("xl/_rels/workbook.xml.rels");
-			if (relsFile) {
-				const relsXml = await relsFile.async("string");
-				zip.file("xl/_rels/workbook.xml.rels", relsXml.replace("</Relationships>", () => {
-					return `<Relationship Id="${rId}" Type="${WORKSHEET_REL_TYPE}" Target="worksheets/sheet${sheet.index}.xml"/></Relationships>`;
-				}));
-			}
-			zip.file(filename, EMPTY_SHEET_XML);
-			existing = zip.file(filename);
-		}
-		if (!existing) continue;
-		let xml = sheet.modify(await existing.async("string"));
-		if (sheet.addLogo && logo) {
-			drawingCounter++;
-			const drawingNum = drawingCounter;
-			const logoWidthEmu = Math.round((sheet.logoWidthPx ?? LOGO_WIDTH_PX) * PX_TO_EMU);
-			const logoHeightEmu = Math.round((sheet.logoHeightPx ?? LOGO_HEIGHT_PX) * PX_TO_EMU);
-			const drawingRId = `rIdLogo${drawingNum}`;
-			zip.file(`xl/drawings/drawing${drawingNum}.xml`, buildDrawingXml(logoWidthEmu, logoHeightEmu));
-			zip.file(`xl/drawings/_rels/drawing${drawingNum}.xml.rels`, `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="rId1" Type="${IMAGE_REL_TYPE}" Target="../media/image1.png"/></Relationships>`);
-			const contentTypesFile = zip.file("[Content_Types].xml");
-			if (contentTypesFile) {
-				let contentTypesXml = await contentTypesFile.async("string");
-				const drawingPart = `/xl/drawings/drawing${drawingNum}.xml`;
-				if (!contentTypesXml.includes(drawingPart)) contentTypesXml = contentTypesXml.replace("</Types>", () => {
-					return `<Override PartName="${drawingPart}" ContentType="${DRAWING_CONTENT_TYPE}"/></Types>`;
-				});
-				zip.file("[Content_Types].xml", contentTypesXml);
-			}
-			const sheetRelsPath = `xl/worksheets/_rels/sheet${sheet.index}.xml.rels`;
-			const sheetRelsFile = zip.file(sheetRelsPath);
-			if (sheetRelsFile) {
-				const relsXml = await sheetRelsFile.async("string");
-				zip.file(sheetRelsPath, relsXml.replace("</Relationships>", () => {
-					return `<Relationship Id="${drawingRId}" Type="${DRAWING_REL_TYPE}" Target="../drawings/drawing${drawingNum}.xml"/></Relationships>`;
-				}));
-			} else zip.file(sheetRelsPath, `<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships"><Relationship Id="${drawingRId}" Type="${DRAWING_REL_TYPE}" Target="../drawings/drawing${drawingNum}.xml"/></Relationships>`);
-			if (!xml.includes("xmlns:r=")) xml = xml.replace("<worksheet ", `<worksheet xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" `);
-			xml = xml.replace("</worksheet>", () => {
-				return `<drawing r:id="${drawingRId}"/></worksheet>`;
-			});
-		}
-		zip.file(filename, xml);
-	}
-	return zip.generateAsync({
-		type: "uint8array",
-		compression: "DEFLATE"
-	});
-};
-//#endregion
-export { modifyXlsx };

package/dist/xlsx/sheet.cjs

@@ -1,36 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/xlsx/sheet.ts
-/** Excel refuses to open a workbook whose sheet name exceeds 31 characters. */
-const SHEET_NAME_MAX_LENGTH = 31;
-/**
-* Coerce a sheet name into something Excel will accept: no []:*?/\ characters,
-* no wrapping apostrophes, at most 31 characters, and never empty.
-*
-* Uniqueness is handled separately, since that needs the whole set.
-*/
-const getSanitisedSheetName = (name) => {
-	const cleaned = (name || "").replace(/[[\]:*?/\\]/g, "_").replace(/^'+|'+$/g, "").trim().slice(0, SHEET_NAME_MAX_LENGTH);
-	return "" === cleaned ? "Sheet" : cleaned;
-};
-/**
-* Sanitise every sheet name and break collisions with _2, _3, … while staying
-* inside the 31 character limit. Excel rejects duplicate names outright, so this
-* cannot be left to chance once sheets are generated from data.
-*/
-const getUniqueSheetNames = (sheets) => {
-	const used = {};
-	return sheets.map((sheet) => {
-		const base = getSanitisedSheetName(sheet.name);
-		const key = base.toLowerCase();
-		if (!(key in used)) {
-			used[key] = 1;
-			return base;
-		}
-		used[key] += 1;
-		const suffix = `_${used[key]}`;
-		return base.slice(0, SHEET_NAME_MAX_LENGTH - suffix.length) + suffix;
-	});
-};
-//#endregion
-exports.getSanitisedSheetName = getSanitisedSheetName;
-exports.getUniqueSheetNames = getUniqueSheetNames;

package/dist/xlsx/sheet.d.cts

@@ -1,28 +0,0 @@
-import { XlsxCellValue } from "./cell.cjs";
-import { XlsxColumn } from "./column.cjs";
-//#region src/xlsx/sheet.d.ts
-export type XlsxSheet = {
-  name: string;
-  columns: XlsxColumn[];
-  data: Record<string, XlsxCellValue>[];
-  /**
-   * Optional lines written above the table — typically a client name and a
-   * reporting period. The first line is bold, the rest are plain, and a blank
-   * row separates them from the column headers.
-   */
-  heading?: string[];
-};
-/**
- * Coerce a sheet name into something Excel will accept: no []:*?/\ characters,
- * no wrapping apostrophes, at most 31 characters, and never empty.
- *
- * Uniqueness is handled separately, since that needs the whole set.
- */
-export declare const getSanitisedSheetName: (name: string) => string;
-/**
- * Sanitise every sheet name and break collisions with _2, _3, … while staying
- * inside the 31 character limit. Excel rejects duplicate names outright, so this
- * cannot be left to chance once sheets are generated from data.
- */
-export declare const getUniqueSheetNames: (sheets: XlsxSheet[]) => string[];
-//#endregion

package/dist/xlsx/sheet.d.mts

@@ -1,28 +0,0 @@
-import { XlsxCellValue } from "./cell.mjs";
-import { XlsxColumn } from "./column.mjs";
-//#region src/xlsx/sheet.d.ts
-export type XlsxSheet = {
-  name: string;
-  columns: XlsxColumn[];
-  data: Record<string, XlsxCellValue>[];
-  /**
-   * Optional lines written above the table — typically a client name and a
-   * reporting period. The first line is bold, the rest are plain, and a blank
-   * row separates them from the column headers.
-   */
-  heading?: string[];
-};
-/**
- * Coerce a sheet name into something Excel will accept: no []:*?/\ characters,
- * no wrapping apostrophes, at most 31 characters, and never empty.
- *
- * Uniqueness is handled separately, since that needs the whole set.
- */
-export declare const getSanitisedSheetName: (name: string) => string;
-/**
- * Sanitise every sheet name and break collisions with _2, _3, … while staying
- * inside the 31 character limit. Excel rejects duplicate names outright, so this
- * cannot be left to chance once sheets are generated from data.
- */
-export declare const getUniqueSheetNames: (sheets: XlsxSheet[]) => string[];
-//#endregion

package/dist/xlsx/sheet.mjs

@@ -1,34 +0,0 @@
-//#region src/xlsx/sheet.ts
-/** Excel refuses to open a workbook whose sheet name exceeds 31 characters. */
-const SHEET_NAME_MAX_LENGTH = 31;
-/**
-* Coerce a sheet name into something Excel will accept: no []:*?/\ characters,
-* no wrapping apostrophes, at most 31 characters, and never empty.
-*
-* Uniqueness is handled separately, since that needs the whole set.
-*/
-const getSanitisedSheetName = (name) => {
-	const cleaned = (name || "").replace(/[[\]:*?/\\]/g, "_").replace(/^'+|'+$/g, "").trim().slice(0, SHEET_NAME_MAX_LENGTH);
-	return "" === cleaned ? "Sheet" : cleaned;
-};
-/**
-* Sanitise every sheet name and break collisions with _2, _3, … while staying
-* inside the 31 character limit. Excel rejects duplicate names outright, so this
-* cannot be left to chance once sheets are generated from data.
-*/
-const getUniqueSheetNames = (sheets) => {
-	const used = {};
-	return sheets.map((sheet) => {
-		const base = getSanitisedSheetName(sheet.name);
-		const key = base.toLowerCase();
-		if (!(key in used)) {
-			used[key] = 1;
-			return base;
-		}
-		used[key] += 1;
-		const suffix = `_${used[key]}`;
-		return base.slice(0, SHEET_NAME_MAX_LENGTH - suffix.length) + suffix;
-	});
-};
-//#endregion
-export { getSanitisedSheetName, getUniqueSheetNames };