@office-kit/xlsx 0.9.2 → 0.10.0

package/dist/{worksheet-C6CWgvP5.mjs → worksheet-C5Ensf_j.mjs}

@@ -1,126 +1,6 @@
 import { o as OpenXmlSchemaError } from "./exceptions-D-CFwxgm.mjs";
 import { a as columnLetterFromIndex, g as tupleToCoordinate, h as rangeBoundaries, i as columnIndexFromLetter, n as MAX_ROW, r as boundariesToRangeString, s as coordinateToTuple, t as MAX_COL } from "./coordinate-96Ecci4d.mjs";
 import { o as cellValueAsString, y as makeCell } from "./cell-BucgGwl3.mjs";
-//#region src/worksheet/cell-range.ts
-/** Build a CellRange from explicit 1-based bounds. */
-function makeCellRange(minRow, minCol, maxRow, maxCol) {
-	if (!Number.isInteger(minRow) || !Number.isInteger(minCol) || !Number.isInteger(maxRow) || !Number.isInteger(maxCol)) throw new OpenXmlSchemaError("CellRange bounds must be integers");
-	if (minRow < 1 || maxRow < 1 || minRow > 1048576 || maxRow > 1048576) throw new OpenXmlSchemaError(`CellRange row bounds must be in [1, ${MAX_ROW}]`);
-	if (minCol < 1 || maxCol < 1 || minCol > 16384 || maxCol > 16384) throw new OpenXmlSchemaError(`CellRange col bounds must be in [1, ${MAX_COL}]`);
-	return {
-		minRow: Math.min(minRow, maxRow),
-		minCol: Math.min(minCol, maxCol),
-		maxRow: Math.max(minRow, maxRow),
-		maxCol: Math.max(minCol, maxCol)
-	};
-}
-/** Parse a range expression — wraps {@link rangeBoundaries}. */
-function parseRange(input) {
-	return rangeBoundaries(input);
-}
-/** Format a CellRange back into the canonical OOXML string. */
-function rangeToString(r) {
-	return boundariesToRangeString(r);
-}
-/** Inclusive containment of a single (row, col) within a range. */
-function rangeContainsCell(r, row, col) {
-	return row >= r.minRow && row <= r.maxRow && col >= r.minCol && col <= r.maxCol;
-}
-/**
-* A1-string convenience for {@link rangeContainsCell}. Parses `cellRef` (e.g.
-* `"B3"`) and `rangeRef` (e.g. `"A1:C5"`) and returns `true` iff the cell sits
-* inside the range (boundary-inclusive). Throws when either input is malformed.
-*/
-function isCellInRange(cellRef, rangeRef) {
-	const { col, row } = coordinateToTuple(cellRef);
-	return rangeContainsCell(parseRange(rangeRef), row, col);
-}
-/**
-* A1-string convenience for {@link rangeContainsRange}. Returns `true` iff the
-* `inner` range is wholly contained by `outer` (boundary-inclusive).
-* Single-cell refs are accepted on either side via parseRange. Throws on
-* malformed input.
-*/
-function isRangeInRange(inner, outer) {
-	return rangeContainsRange(parseRange(outer), parseRange(inner));
-}
-/**
-* Expand (or shrink) an A1 range by adding `deltaRows` to its bottom edge and
-* `deltaCols` to its right edge. The top-left corner is preserved. Negative
-* deltas shrink the range; the result must still have at least 1 row and 1
-* column (otherwise throws).
-*
-* Useful for "this is the data range — also reserve room for a totals row" or
-* "include one more column to the right" patterns.
-*/
-function expandRangeStr(range, deltaRows, deltaCols) {
-	if (!Number.isInteger(deltaRows) || !Number.isInteger(deltaCols)) throw new OpenXmlSchemaError("expandRangeStr: deltas must be integers");
-	const r = parseRange(range);
-	return rangeToString(makeCellRange(r.minRow, r.minCol, r.maxRow + deltaRows, r.maxCol + deltaCols));
-}
-/** Inclusive containment of `inner` within `outer`. */
-function rangeContainsRange(outer, inner) {
-	return inner.minRow >= outer.minRow && inner.maxRow <= outer.maxRow && inner.minCol >= outer.minCol && inner.maxCol <= outer.maxCol;
-}
-/**
-* Shift a range by (dr, dc) integer offsets. The returned range is clamped to
-* the OOXML grid; callers that want hard bounds should pass values that keep
-* the result inside the spec.
-*/
-function shiftRange(r, dr, dc) {
-	if (!Number.isInteger(dr) || !Number.isInteger(dc)) throw new OpenXmlSchemaError("shiftRange: dr / dc must be integers");
-	return makeCellRange(r.minRow + dr, r.minCol + dc, r.maxRow + dr, r.maxCol + dc);
-}
-/** Bounding-box union of two ranges. Always non-null. */
-function unionRange(a, b) {
-	return {
-		minRow: Math.min(a.minRow, b.minRow),
-		minCol: Math.min(a.minCol, b.minCol),
-		maxRow: Math.max(a.maxRow, b.maxRow),
-		maxCol: Math.max(a.maxCol, b.maxCol)
-	};
-}
-/** Returns the rectangular intersection of two ranges, or `null` when disjoint. */
-function intersectionRange(a, b) {
-	const minRow = Math.max(a.minRow, b.minRow);
-	const minCol = Math.max(a.minCol, b.minCol);
-	const maxRow = Math.min(a.maxRow, b.maxRow);
-	const maxCol = Math.min(a.maxCol, b.maxCol);
-	if (minRow > maxRow || minCol > maxCol) return null;
-	return {
-		minRow,
-		minCol,
-		maxRow,
-		maxCol
-	};
-}
-/** True iff two ranges share at least one cell. */
-function rangesOverlap(a, b) {
-	return intersectionRange(a, b) !== null;
-}
-/** Inclusive cell count covered by a range. */
-function rangeArea(r) {
-	return (r.maxRow - r.minRow + 1) * (r.maxCol - r.minCol + 1);
-}
-/** Parse an sqref string: `"A1:B2 D5 E10:F20"`. Whitespace-delimited. */
-function parseMultiCellRange(input) {
-	const ranges = [];
-	for (const piece of input.split(/\s+/)) {
-		if (piece.length === 0) continue;
-		ranges.push(parseRange(piece));
-	}
-	return { ranges };
-}
-/** Format a MultiCellRange back into an sqref string. */
-function multiCellRangeToString(m) {
-	return m.ranges.map(rangeToString).join(" ");
-}
-/** True iff any contained range covers (row, col). */
-function multiCellRangeContainsCell(m, row, col) {
-	for (const r of m.ranges) if (rangeContainsCell(r, row, col)) return true;
-	return false;
-}
-//#endregion
 //#region src/styles/colors.ts
 /**
 * Legacy 64-entry palette indexed colours fall back to. Verbatim from
@@ -418,6 +298,126 @@ function hslToHex(h, s, l, alpha = 255) {
 	return `${toHexByte(Math.max(0, Math.min(255, Math.round(alpha))))}${toHexByte((rp + m) * 255)}${toHexByte((gp + m) * 255)}${toHexByte((bp + m) * 255)}`;
 }
 //#endregion
+//#region src/worksheet/cell-range.ts
+/** Build a CellRange from explicit 1-based bounds. */
+function makeCellRange(minRow, minCol, maxRow, maxCol) {
+	if (!Number.isInteger(minRow) || !Number.isInteger(minCol) || !Number.isInteger(maxRow) || !Number.isInteger(maxCol)) throw new OpenXmlSchemaError("CellRange bounds must be integers");
+	if (minRow < 1 || maxRow < 1 || minRow > 1048576 || maxRow > 1048576) throw new OpenXmlSchemaError(`CellRange row bounds must be in [1, ${MAX_ROW}]`);
+	if (minCol < 1 || maxCol < 1 || minCol > 16384 || maxCol > 16384) throw new OpenXmlSchemaError(`CellRange col bounds must be in [1, ${MAX_COL}]`);
+	return {
+		minRow: Math.min(minRow, maxRow),
+		minCol: Math.min(minCol, maxCol),
+		maxRow: Math.max(minRow, maxRow),
+		maxCol: Math.max(minCol, maxCol)
+	};
+}
+/** Parse a range expression — wraps {@link rangeBoundaries}. */
+function parseRange(input) {
+	return rangeBoundaries(input);
+}
+/** Format a CellRange back into the canonical OOXML string. */
+function rangeToString(r) {
+	return boundariesToRangeString(r);
+}
+/** Inclusive containment of a single (row, col) within a range. */
+function rangeContainsCell(r, row, col) {
+	return row >= r.minRow && row <= r.maxRow && col >= r.minCol && col <= r.maxCol;
+}
+/**
+* A1-string convenience for {@link rangeContainsCell}. Parses `cellRef` (e.g.
+* `"B3"`) and `rangeRef` (e.g. `"A1:C5"`) and returns `true` iff the cell sits
+* inside the range (boundary-inclusive). Throws when either input is malformed.
+*/
+function isCellInRange(cellRef, rangeRef) {
+	const { col, row } = coordinateToTuple(cellRef);
+	return rangeContainsCell(parseRange(rangeRef), row, col);
+}
+/**
+* A1-string convenience for {@link rangeContainsRange}. Returns `true` iff the
+* `inner` range is wholly contained by `outer` (boundary-inclusive).
+* Single-cell refs are accepted on either side via parseRange. Throws on
+* malformed input.
+*/
+function isRangeInRange(inner, outer) {
+	return rangeContainsRange(parseRange(outer), parseRange(inner));
+}
+/**
+* Expand (or shrink) an A1 range by adding `deltaRows` to its bottom edge and
+* `deltaCols` to its right edge. The top-left corner is preserved. Negative
+* deltas shrink the range; the result must still have at least 1 row and 1
+* column (otherwise throws).
+*
+* Useful for "this is the data range — also reserve room for a totals row" or
+* "include one more column to the right" patterns.
+*/
+function expandRangeStr(range, deltaRows, deltaCols) {
+	if (!Number.isInteger(deltaRows) || !Number.isInteger(deltaCols)) throw new OpenXmlSchemaError("expandRangeStr: deltas must be integers");
+	const r = parseRange(range);
+	return rangeToString(makeCellRange(r.minRow, r.minCol, r.maxRow + deltaRows, r.maxCol + deltaCols));
+}
+/** Inclusive containment of `inner` within `outer`. */
+function rangeContainsRange(outer, inner) {
+	return inner.minRow >= outer.minRow && inner.maxRow <= outer.maxRow && inner.minCol >= outer.minCol && inner.maxCol <= outer.maxCol;
+}
+/**
+* Shift a range by (dr, dc) integer offsets. The returned range is clamped to
+* the OOXML grid; callers that want hard bounds should pass values that keep
+* the result inside the spec.
+*/
+function shiftRange(r, dr, dc) {
+	if (!Number.isInteger(dr) || !Number.isInteger(dc)) throw new OpenXmlSchemaError("shiftRange: dr / dc must be integers");
+	return makeCellRange(r.minRow + dr, r.minCol + dc, r.maxRow + dr, r.maxCol + dc);
+}
+/** Bounding-box union of two ranges. Always non-null. */
+function unionRange(a, b) {
+	return {
+		minRow: Math.min(a.minRow, b.minRow),
+		minCol: Math.min(a.minCol, b.minCol),
+		maxRow: Math.max(a.maxRow, b.maxRow),
+		maxCol: Math.max(a.maxCol, b.maxCol)
+	};
+}
+/** Returns the rectangular intersection of two ranges, or `null` when disjoint. */
+function intersectionRange(a, b) {
+	const minRow = Math.max(a.minRow, b.minRow);
+	const minCol = Math.max(a.minCol, b.minCol);
+	const maxRow = Math.min(a.maxRow, b.maxRow);
+	const maxCol = Math.min(a.maxCol, b.maxCol);
+	if (minRow > maxRow || minCol > maxCol) return null;
+	return {
+		minRow,
+		minCol,
+		maxRow,
+		maxCol
+	};
+}
+/** True iff two ranges share at least one cell. */
+function rangesOverlap(a, b) {
+	return intersectionRange(a, b) !== null;
+}
+/** Inclusive cell count covered by a range. */
+function rangeArea(r) {
+	return (r.maxRow - r.minRow + 1) * (r.maxCol - r.minCol + 1);
+}
+/** Parse an sqref string: `"A1:B2 D5 E10:F20"`. Whitespace-delimited. */
+function parseMultiCellRange(input) {
+	const ranges = [];
+	for (const piece of input.split(/\s+/)) {
+		if (piece.length === 0) continue;
+		ranges.push(parseRange(piece));
+	}
+	return { ranges };
+}
+/** Format a MultiCellRange back into an sqref string. */
+function multiCellRangeToString(m) {
+	return m.ranges.map(rangeToString).join(" ");
+}
+/** True iff any contained range covers (row, col). */
+function multiCellRangeContainsCell(m, row, col) {
+	for (const r of m.ranges) if (rangeContainsCell(r, row, col)) return true;
+	return false;
+}
+//#endregion
 //#region src/worksheet/dimensions.ts
 /** Build a single-column ColumnDimension entry covering `col`. */
 function makeColumnDimension(col, opts = {}) {
@@ -444,19 +444,6 @@ function makeRowDimension(opts = {}) {
 	};
 }
 //#endregion
-//#region src/worksheet/hyperlinks.ts
-function makeHyperlink(opts) {
-	if (opts.ref === void 0 || opts.ref.length === 0) throw new OpenXmlSchemaError("Hyperlink: ref is required");
-	return {
-		ref: opts.ref,
-		...opts.target !== void 0 ? { target: opts.target } : {},
-		...opts.location !== void 0 ? { location: opts.location } : {},
-		...opts.tooltip !== void 0 ? { tooltip: opts.tooltip } : {},
-		...opts.display !== void 0 ? { display: opts.display } : {},
-		...opts.rId !== void 0 ? { rId: opts.rId } : {}
-	};
-}
-//#endregion
 //#region src/worksheet/views.ts
 /** Build a SheetView with sensible defaults. */
 function makeSheetView(opts = {}) {
@@ -538,6 +525,47 @@ const makeSheetProperties = (opts = {}) => {
 	return out;
 };
 //#endregion
+//#region src/worksheet/hyperlinks.ts
+/**
+* Anything the OPC `Target` attribute (`xsd:anyURI`) cannot carry: whitespace,
+* C0/C1 controls, and DEL. Excel does not ignore the one bad link — it refuses
+* the whole package and drops content on repair.
+*/
+const ILLEGAL_TARGET_CHAR = /[\u0000-\u0020\u007f-\u009f]/;
+/** The authority of a `scheme://authority/…` target, if the target has one. */
+const AUTHORITY = /^[A-Za-z][A-Za-z0-9+.-]*:\/\/([^/?#]*)/;
+const describeChar = (ch) => ch === " " ? "a space" : `U+${ch.codePointAt(0)?.toString(16).toUpperCase().padStart(4, "0")}`;
+/**
+* Reject a target the writer would emit verbatim into the rels and Excel would
+* then refuse. Applied when the hyperlink is authored, not when one is read
+* back off disk — a file that already carries a broken target still loads, so
+* it can be inspected and repaired.
+*/
+function assertValidTarget(target) {
+	if (target.length === 0) throw new OpenXmlSchemaError("Hyperlink: target is empty — pass a URI, or use `location` for an in-workbook jump");
+	const illegal = ILLEGAL_TARGET_CHAR.exec(target);
+	if (illegal?.[0] !== void 0) throw new OpenXmlSchemaError(`Hyperlink: target "${target}" contains ${describeChar(illegal[0])} at index ${illegal.index}. The rels Target attribute is xsd:anyURI and Excel refuses the file; percent-encode it or drop it.`);
+	const authority = AUTHORITY.exec(target)?.[1];
+	if (authority !== void 0 && /[^\u0021-\u007e]/.test(authority)) throw new OpenXmlSchemaError(`Hyperlink: target "${target}" has a non-ASCII host. Percent-encoding does not rescue it — convert the host to punycode (xn--…).`);
+}
+/**
+* Build a validated {@link Hyperlink}. `target` is checked against what the
+* OPC `Target` attribute accepts, so a bad URL fails here rather than as an
+* Excel repair prompt on a package that has already been written.
+*/
+function makeHyperlink(opts) {
+	if (opts.ref === void 0 || opts.ref.length === 0) throw new OpenXmlSchemaError("Hyperlink: ref is required");
+	if (opts.target !== void 0) assertValidTarget(opts.target);
+	return {
+		ref: opts.ref,
+		...opts.target !== void 0 ? { target: opts.target } : {},
+		...opts.location !== void 0 ? { location: opts.location } : {},
+		...opts.tooltip !== void 0 ? { tooltip: opts.tooltip } : {},
+		...opts.display !== void 0 ? { display: opts.display } : {},
+		...opts.rId !== void 0 ? { rId: opts.rId } : {}
+	};
+}
+//#endregion
 //#region src/worksheet/worksheet.ts
 /** Build a Worksheet shell. */
 function makeWorksheet(title) {
@@ -1565,6 +1593,10 @@ function unhideRows(ws, fromRow, toRow) {
 * Replace any prior hyperlink on the same `ref` with the given options. Pass `{
 * target }` for an external URL, `{ location }` for an internal jump, or both.
 * Returns the resulting Hyperlink record.
+*
+* `target` is validated against what the rels `Target` attribute (`xsd:anyURI`)
+* accepts — whitespace, control characters and a non-ASCII host throw an
+* {@link OpenXmlSchemaError} here rather than producing a package Excel refuses.
 */
 function setHyperlink(ws, ref, opts) {
 	if (opts.target === void 0 && opts.location === void 0) throw new OpenXmlSchemaError("setHyperlink: one of target / location is required");
@@ -1721,6 +1753,6 @@ function removeIgnoredErrors(ws, predicate) {
 	return before - ws.ignoredErrors.length;
 }
 //#endregion
-export { iterRows as $, makeRowDimension as $t, getCellsInRow as A, unionRange as An, setRangeValues as At, getPopulatedRowIndices as B, unhideColumns as Bt, getAutoFilter as C, parseRange as Cn, setColumnWidth as Ct, getCellHyperlink as D, rangeToString as Dn, setDefaultRowHeight as Dt, getCellComment as E, rangeContainsRange as En, setDefaultColumnWidth as Et, getMaxRow as F, setSheetViewMode as Ft, groupRows as G, writeRange as Gt, getRowDimension as H, unhideRows as Ht, getMergedCells as I, setSheetZoom as It, hideRow as J, freezePaneRef as Jt, hideColumn as K, makeSheetProperties as Kt, getMergedRangeAt as L, ungroupColumns as Lt, getDataExtent as M, setRowHeight as Mt, getFreezePanes as N, setRowHeights as Nt, getCellsInColumn as O, rangesOverlap as On, setFreezePanes as Ot, getMaxCol as P, setSheetTabColor as Pt, iterCells as Q, makeColumnDimension as Qt, getNonEmptyCellCount as R, ungroupRows as Rt, freezePanes as S, parseMultiCellRange as Sn, setColumnDimension as St, getCellByCoord as T, rangeContainsCell as Tn, setComment as Tt, getTable as U, unmergeCells as Ut, getRangeValues as V, unhideRow as Vt, groupColumns as W, unmergeCellsAt as Wt, isMergedCell as X, makeSheetView as Xt, hideRows as Y, makeFreezePane as Yt, isWorksheetEmpty as Z, makeHyperlink as Zt, countCellsByKind as _, intersectionRange as _n, removeIgnoredErrors as _t, addTable as a, hexToHsl as an, makeWorksheet as at, expandRowGroup as b, multiCellRangeContainsCell as bn, setCell as bt, applyToRange as c, luminance as cn, removeAllComments as ct, clearAllCells as d, normaliseRgb as dn, removeAllHyperlinks as dt, adjustLightness as en, iterValues as et, clearRange as f, pickReadableTextColor as fn, removeAllMergedRanges as ft, countCells as g, expandRangeStr as gn, removeHyperlink as gt, copyRange as h, rotateHue as hn, removeDataValidations as ht, addIgnoredError as i, darken as in, listTables as it, getColumnDimension as j, setRowDimension as jt, getCellsInRange as k, shiftRange as kn, setHyperlink as kt, autofitColumns as l, makeColor as ln, removeAllConditionalFormatting as lt, collapseRowGroup as m, rgbColor as mn, removeCellWatches as mt, addConditionalFormatting as n, colorToHex as nn, listDataValidations as nt, appendRow as o, hslToHex as on, mergeCells as ot, collapseColumnGroup as p, resolveIndexedColor as pn, removeAllTables as pt, hideColumns as q, makeLegacyComment as qt, addDataValidation as r, contrastRatio as rn, listHyperlinks as rt, appendRows as s, lighten as sn, moveRange as st, addCellWatch as t, adjustSaturation as tn, listComments as tt, classifyCellValue as u, mixColors as un, removeAllDataValidations as ut, deleteCell as v, isCellInRange as vn, removeTable as vt, getCell as w, rangeArea as wn, setColumnWidths as wt, findCells as x, multiCellRangeToString as xn, setCellByCoord as xt, expandColumnGroup as y, isRangeInRange as yn, setAutoFilter as yt, getPopulatedColumnIndices as z, unhideColumn as zt };
+export { iterRows as $, makeRowDimension as $t, getCellsInRow as A, rotateHue as An, setRangeValues as At, getPopulatedRowIndices as B, unhideColumns as Bt, getAutoFilter as C, luminance as Cn, setColumnWidth as Ct, getCellHyperlink as D, pickReadableTextColor as Dn, setDefaultRowHeight as Dt, getCellComment as E, normaliseRgb as En, setDefaultColumnWidth as Et, getMaxRow as F, setSheetViewMode as Ft, groupRows as G, writeRange as Gt, getRowDimension as H, unhideRows as Ht, getMergedCells as I, setSheetZoom as It, hideRow as J, makeLegacyComment as Jt, hideColumn as K, makeHyperlink as Kt, getMergedRangeAt as L, ungroupColumns as Lt, getDataExtent as M, setRowHeight as Mt, getFreezePanes as N, setRowHeights as Nt, getCellsInColumn as O, resolveIndexedColor as On, setFreezePanes as Ot, getMaxCol as P, setSheetTabColor as Pt, iterCells as Q, makeColumnDimension as Qt, getNonEmptyCellCount as R, ungroupRows as Rt, freezePanes as S, lighten as Sn, setColumnDimension as St, getCellByCoord as T, mixColors as Tn, setComment as Tt, getTable as U, unmergeCells as Ut, getRangeValues as V, unhideRow as Vt, groupColumns as W, unmergeCellsAt as Wt, isMergedCell as X, makeFreezePane as Xt, hideRows as Y, freezePaneRef as Yt, isWorksheetEmpty as Z, makeSheetView as Zt, countCellsByKind as _, colorToHex as _n, removeIgnoredErrors as _t, addTable as a, multiCellRangeToString as an, makeWorksheet as at, expandRowGroup as b, hexToHsl as bn, setCell as bt, applyToRange as c, rangeArea as cn, removeAllComments as ct, clearAllCells as d, rangeToString as dn, removeAllHyperlinks as dt, expandRangeStr as en, iterValues as et, clearRange as f, rangesOverlap as fn, removeAllMergedRanges as ft, countCells as g, adjustSaturation as gn, removeHyperlink as gt, copyRange as h, adjustLightness as hn, removeDataValidations as ht, addIgnoredError as i, multiCellRangeContainsCell as in, listTables as it, getColumnDimension as j, setRowDimension as jt, getCellsInRange as k, rgbColor as kn, setHyperlink as kt, autofitColumns as l, rangeContainsCell as ln, removeAllConditionalFormatting as lt, collapseRowGroup as m, unionRange as mn, removeCellWatches as mt, addConditionalFormatting as n, isCellInRange as nn, listDataValidations as nt, appendRow as o, parseMultiCellRange as on, mergeCells as ot, collapseColumnGroup as p, shiftRange as pn, removeAllTables as pt, hideColumns as q, makeSheetProperties as qt, addDataValidation as r, isRangeInRange as rn, listHyperlinks as rt, appendRows as s, parseRange as sn, moveRange as st, addCellWatch as t, intersectionRange as tn, listComments as tt, classifyCellValue as u, rangeContainsRange as un, removeAllDataValidations as ut, deleteCell as v, contrastRatio as vn, removeTable as vt, getCell as w, makeColor as wn, setColumnWidths as wt, findCells as x, hslToHex as xn, setCellByCoord as xt, expandColumnGroup as y, darken as yn, setAutoFilter as yt, getPopulatedColumnIndices as z, unhideColumn as zt };
 
-//# sourceMappingURL=worksheet-C6CWgvP5.mjs.map
+//# sourceMappingURL=worksheet-C5Ensf_j.mjs.map