@office-kit/xlsx 0.8.0

package/dist/chartsheet/chartsheet.d.ts

@@ -0,0 +1,121 @@
+import type { Drawing } from '../drawing/drawing';
+import type { Color } from '../styles/colors';
+import type { HeaderFooter, PageMargins, PageSetup } from '../worksheet/page-setup';
+import type { WebPublishItem } from '../worksheet/web-publish';
+/** `<sheetView>` inside `<sheetViews>`. */
+export interface ChartsheetView {
+    workbookViewId: number;
+    tabSelected?: boolean;
+    zoomScale?: number;
+    zoomToFit?: boolean;
+}
+/** `<sheetPr>` chartsheet properties. */
+export interface ChartsheetProperties {
+    published?: boolean;
+    codeName?: string;
+    /**
+     * Tab strip colour. Mirrors `SheetProperties.tabColor` on worksheets so the
+     * two sheet kinds expose the same colour model (rgb / indexed / theme /
+     * auto / tint) instead of forcing callers to special-case chartsheets.
+     */
+    tabColor?: Color;
+}
+/** Subset of `<sheetProtection>` fields we round-trip on chartsheets. */
+export interface ChartsheetProtection {
+    /** Protect content (chart elements / text). */
+    content?: boolean;
+    /** Protect drawing objects (shapes / annotations). */
+    objects?: boolean;
+    algorithmName?: string;
+    hashValue?: string;
+    saltValue?: string;
+    spinCount?: number;
+}
+export interface Chartsheet {
+    /** Display title shown in Excel's tab strip. Mirrors Worksheet.title for SheetRef compatibility. */
+    title: string;
+    views: ChartsheetView[];
+    properties?: ChartsheetProperties;
+    protection?: ChartsheetProtection;
+    /**
+     * Drawing payload — typically a single absoluteAnchor with a chart
+     * graphicFrame. Mirrors Worksheet.drawing so the existing drawing-XML helpers
+     * can be reused.
+     */
+    drawing?: Drawing;
+    /** `<pageMargins>` — six required margins in inches. */
+    pageMargins?: PageMargins;
+    /** `<pageSetup>` — paper size / orientation / scale / fitToPage. */
+    pageSetup?: PageSetup;
+    /** `<headerFooter>` — odd/even/first header + footer mini-format strings. */
+    headerFooter?: HeaderFooter;
+    /** `<legacyDrawing r:id="…"/>` — VML drawing for comments / form-control overlay. */
+    legacyDrawingRId?: string;
+    /** `<legacyDrawingHF r:id="…"/>` — VML drawing for header/footer print background. */
+    legacyDrawingHFRId?: string;
+    /**
+     * `<drawingHF r:id="…" lho="N" cho="N" lhe="N" che="N" lhf="N" chf="N"
+     * rho="N" cho2="N" rhe="N" che2="N" rhf="N" chf2="N" lfo="N" cfo="N" lfe="N"
+     * cfe="N" lff="N" cff="N" rfo="N" cfo2="N" rfe="N" cfe2="N" rff="N"
+     * cff2="N"/>` — drawing slot + per-section image indices for header/footer
+     * print backgrounds (DrawingML rather than VML).
+     */
+    drawingHF?: ChartsheetDrawingHF;
+    /** `<picture r:id="…"/>` — chartsheet background image. */
+    backgroundPictureRId?: string;
+    /** `<webPublishItems>` — Excel 2007 "Publish to web" entries (rare on chartsheets). */
+    webPublishItems: WebPublishItem[];
+    /**
+     * `<customSheetViews>` — saved per-user view presets for this chartsheet
+     * (Shared Workbook era). Each entry can carry its own page margins / setup /
+     * header-footer.
+     */
+    customSheetViews: ChartsheetCustomSheetView[];
+}
+/** One `<customSheetView>` entry inside a chartsheet. */
+export interface ChartsheetCustomSheetView {
+    guid: string;
+    scale?: number;
+    state?: 'visible' | 'hidden' | 'veryHidden';
+    zoomToFit?: boolean;
+    pageMargins?: PageMargins;
+    pageSetup?: PageSetup;
+    headerFooter?: HeaderFooter;
+}
+export declare const makeChartsheetCustomSheetView: (opts: Partial<ChartsheetCustomSheetView> & {
+    guid: string;
+}) => ChartsheetCustomSheetView;
+/**
+ * `<drawingHF>` — per-section image-index map for the header/footer drawing
+ * reference. Each `*o` / `*e` / `*f` attr is a 1-based image number into the
+ * referenced drawing part. All optional.
+ */
+export interface ChartsheetDrawingHF {
+    /** Required rels link to xl/drawings/drawingN.xml carrying the actual image refs. */
+    rId: string;
+    /** Left-header image index for odd pages. */
+    lho?: number;
+    cho?: number;
+    rho?: number;
+    /** Left-header image index for even pages. */
+    lhe?: number;
+    che?: number;
+    rhe?: number;
+    /** Left-header image index for the first page (when differentFirst). */
+    lhf?: number;
+    chf?: number;
+    rhf?: number;
+    /** Left-footer image index for odd pages. */
+    lfo?: number;
+    cfo?: number;
+    rfo?: number;
+    /** Left-footer image index for even pages. */
+    lfe?: number;
+    cfe?: number;
+    rfe?: number;
+    /** Left-footer image index for first page. */
+    lff?: number;
+    cff?: number;
+    rff?: number;
+}
+export declare const makeChartsheet: (title: string) => Chartsheet;

package/dist/chartsheet/index.d.ts

@@ -0,0 +1,2 @@
+export type { Chartsheet, ChartsheetCustomSheetView, ChartsheetDrawingHF, ChartsheetProperties, ChartsheetProtection, ChartsheetView, } from './chartsheet';
+export { makeChartsheet, makeChartsheetCustomSheetView } from './chartsheet';

package/dist/chartsheet-C3-tqkPy.mjs

@@ -0,0 +1,23 @@
+//#region src/chartsheet/chartsheet.ts
+const makeChartsheetCustomSheetView = (opts) => ({
+	guid: opts.guid,
+	...opts.scale !== void 0 ? { scale: opts.scale } : {},
+	...opts.state !== void 0 ? { state: opts.state } : {},
+	...opts.zoomToFit !== void 0 ? { zoomToFit: opts.zoomToFit } : {},
+	...opts.pageMargins !== void 0 ? { pageMargins: opts.pageMargins } : {},
+	...opts.pageSetup !== void 0 ? { pageSetup: opts.pageSetup } : {},
+	...opts.headerFooter !== void 0 ? { headerFooter: opts.headerFooter } : {}
+});
+const makeChartsheet = (title) => ({
+	title,
+	views: [{
+		workbookViewId: 0,
+		zoomToFit: true
+	}],
+	webPublishItems: [],
+	customSheetViews: []
+});
+//#endregion
+export { makeChartsheetCustomSheetView as n, makeChartsheet as t };
+
+//# sourceMappingURL=chartsheet-C3-tqkPy.mjs.map

package/dist/chartsheet-C3-tqkPy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"chartsheet-C3-tqkPy.mjs","names":[],"sources":["../src/chartsheet/chartsheet.ts"],"sourcesContent":["// Chartsheet model.\n//\n// A chartsheet is a workbook child that holds a single chart instead of cells.\n// It still gets a row in `<sheets>` (with the same r:id + sheetId machinery as\n// a worksheet), but its part lives under `xl/chartsheets/sheetN.xml` and\n// references a drawing via `<drawing r:id=\"...\"/>` carrying an absoluteAnchor\n// with the chart.\n\nimport type { Drawing } from '../drawing/drawing';\nimport type { Color } from '../styles/colors';\nimport type { HeaderFooter, PageMargins, PageSetup } from '../worksheet/page-setup';\nimport type { WebPublishItem } from '../worksheet/web-publish';\n\n/** `<sheetView>` inside `<sheetViews>`. */\nexport interface ChartsheetView {\n  workbookViewId: number;\n  tabSelected?: boolean;\n  zoomScale?: number;\n  zoomToFit?: boolean;\n}\n\n/** `<sheetPr>` chartsheet properties. */\nexport interface ChartsheetProperties {\n  published?: boolean;\n  codeName?: string;\n  /**\n   * Tab strip colour. Mirrors `SheetProperties.tabColor` on worksheets so the\n   * two sheet kinds expose the same colour model (rgb / indexed / theme /\n   * auto / tint) instead of forcing callers to special-case chartsheets.\n   */\n  tabColor?: Color;\n}\n\n/** Subset of `<sheetProtection>` fields we round-trip on chartsheets. */\nexport interface ChartsheetProtection {\n  /** Protect content (chart elements / text). */\n  content?: boolean;\n  /** Protect drawing objects (shapes / annotations). */\n  objects?: boolean;\n  algorithmName?: string;\n  hashValue?: string;\n  saltValue?: string;\n  spinCount?: number;\n}\n\nexport interface Chartsheet {\n  /** Display title shown in Excel's tab strip. Mirrors Worksheet.title for SheetRef compatibility. */\n  title: string;\n  views: ChartsheetView[];\n  properties?: ChartsheetProperties;\n  protection?: ChartsheetProtection;\n  /**\n   * Drawing payload — typically a single absoluteAnchor with a chart\n   * graphicFrame. Mirrors Worksheet.drawing so the existing drawing-XML helpers\n   * can be reused.\n   */\n  drawing?: Drawing;\n  /** `<pageMargins>` — six required margins in inches. */\n  pageMargins?: PageMargins;\n  /** `<pageSetup>` — paper size / orientation / scale / fitToPage. */\n  pageSetup?: PageSetup;\n  /** `<headerFooter>` — odd/even/first header + footer mini-format strings. */\n  headerFooter?: HeaderFooter;\n  /** `<legacyDrawing r:id=\"…\"/>` — VML drawing for comments / form-control overlay. */\n  legacyDrawingRId?: string;\n  /** `<legacyDrawingHF r:id=\"…\"/>` — VML drawing for header/footer print background. */\n  legacyDrawingHFRId?: string;\n  /**\n   * `<drawingHF r:id=\"…\" lho=\"N\" cho=\"N\" lhe=\"N\" che=\"N\" lhf=\"N\" chf=\"N\"\n   * rho=\"N\" cho2=\"N\" rhe=\"N\" che2=\"N\" rhf=\"N\" chf2=\"N\" lfo=\"N\" cfo=\"N\" lfe=\"N\"\n   * cfe=\"N\" lff=\"N\" cff=\"N\" rfo=\"N\" cfo2=\"N\" rfe=\"N\" cfe2=\"N\" rff=\"N\"\n   * cff2=\"N\"/>` — drawing slot + per-section image indices for header/footer\n   * print backgrounds (DrawingML rather than VML).\n   */\n  drawingHF?: ChartsheetDrawingHF;\n  /** `<picture r:id=\"…\"/>` — chartsheet background image. */\n  backgroundPictureRId?: string;\n  /** `<webPublishItems>` — Excel 2007 \"Publish to web\" entries (rare on chartsheets). */\n  webPublishItems: WebPublishItem[];\n  /**\n   * `<customSheetViews>` — saved per-user view presets for this chartsheet\n   * (Shared Workbook era). Each entry can carry its own page margins / setup /\n   * header-footer.\n   */\n  customSheetViews: ChartsheetCustomSheetView[];\n}\n\n/** One `<customSheetView>` entry inside a chartsheet. */\nexport interface ChartsheetCustomSheetView {\n  guid: string;\n  scale?: number;\n  state?: 'visible' | 'hidden' | 'veryHidden';\n  zoomToFit?: boolean;\n  pageMargins?: PageMargins;\n  pageSetup?: PageSetup;\n  headerFooter?: HeaderFooter;\n}\n\nexport const makeChartsheetCustomSheetView = (\n  opts: Partial<ChartsheetCustomSheetView> & { guid: string },\n): ChartsheetCustomSheetView => ({\n  guid: opts.guid,\n  ...(opts.scale !== undefined ? { scale: opts.scale } : {}),\n  ...(opts.state !== undefined ? { state: opts.state } : {}),\n  ...(opts.zoomToFit !== undefined ? { zoomToFit: opts.zoomToFit } : {}),\n  ...(opts.pageMargins !== undefined ? { pageMargins: opts.pageMargins } : {}),\n  ...(opts.pageSetup !== undefined ? { pageSetup: opts.pageSetup } : {}),\n  ...(opts.headerFooter !== undefined ? { headerFooter: opts.headerFooter } : {}),\n});\n\n/**\n * `<drawingHF>` — per-section image-index map for the header/footer drawing\n * reference. Each `*o` / `*e` / `*f` attr is a 1-based image number into the\n * referenced drawing part. All optional.\n */\nexport interface ChartsheetDrawingHF {\n  /** Required rels link to xl/drawings/drawingN.xml carrying the actual image refs. */\n  rId: string;\n  /** Left-header image index for odd pages. */\n  lho?: number;\n  cho?: number;\n  rho?: number;\n  /** Left-header image index for even pages. */\n  lhe?: number;\n  che?: number;\n  rhe?: number;\n  /** Left-header image index for the first page (when differentFirst). */\n  lhf?: number;\n  chf?: number;\n  rhf?: number;\n  /** Left-footer image index for odd pages. */\n  lfo?: number;\n  cfo?: number;\n  rfo?: number;\n  /** Left-footer image index for even pages. */\n  lfe?: number;\n  cfe?: number;\n  rfe?: number;\n  /** Left-footer image index for first page. */\n  lff?: number;\n  cff?: number;\n  rff?: number;\n}\n\nexport const makeChartsheet = (title: string): Chartsheet => ({\n  title,\n  views: [{ workbookViewId: 0, zoomToFit: true }],\n  webPublishItems: [],\n  customSheetViews: [],\n});\n"],"mappings":";AAkGA,MAAa,iCACX,UAC+B;CAC/B,MAAM,KAAK;CACX,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;CACxD,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;CACxD,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;CACpE,GAAI,KAAK,gBAAgB,KAAA,IAAY,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;CAC1E,GAAI,KAAK,cAAc,KAAA,IAAY,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;CACpE,GAAI,KAAK,iBAAiB,KAAA,IAAY,EAAE,cAAc,KAAK,aAAa,IAAI,CAAC;AAC/E;AAoCA,MAAa,kBAAkB,WAA+B;CAC5D;CACA,OAAO,CAAC;EAAE,gBAAgB;EAAG,WAAW;CAAK,CAAC;CAC9C,iBAAiB,CAAC;CAClB,kBAAkB,CAAC;AACrB"}

package/dist/chartsheet.mjs

@@ -0,0 +1,2 @@
+import { n as makeChartsheetCustomSheetView, t as makeChartsheet } from "./chartsheet-C3-tqkPy.mjs";
+export { makeChartsheet, makeChartsheetCustomSheetView };

package/dist/colors-ovWAwnZI.mjs

@@ -0,0 +1,67 @@
+//#region src/drawing/dml/colors.ts
+const SCHEME_COLOR_NAMES = [
+	"bg1",
+	"tx1",
+	"bg2",
+	"tx2",
+	"accent1",
+	"accent2",
+	"accent3",
+	"accent4",
+	"accent5",
+	"accent6",
+	"hlink",
+	"folHlink",
+	"phClr",
+	"dk1",
+	"lt1",
+	"dk2",
+	"lt2"
+];
+/** Color mod kinds that take no `val` attribute (their elements are empty). */
+const VALUELESS_COLOR_MOD_KINDS = [
+	"gray",
+	"comp",
+	"inv",
+	"invGamma",
+	"gamma"
+];
+/** Color mod kinds that carry a numeric `val` attribute. */
+const VALUED_COLOR_MOD_KINDS = [
+	"lumMod",
+	"lumOff",
+	"satMod",
+	"satOff",
+	"hueMod",
+	"hueOff",
+	"tint",
+	"shade",
+	"alpha",
+	"alphaMod",
+	"alphaOff",
+	"red",
+	"green",
+	"blue",
+	"redMod",
+	"greenMod",
+	"blueMod",
+	"redOff",
+	"greenOff",
+	"blueOff"
+];
+const makeSrgbColor = (rrggbb) => ({
+	kind: "srgb",
+	value: rrggbb.toUpperCase()
+});
+const makeSchemeColor = (name) => ({
+	kind: "schemeClr",
+	value: name
+});
+const makeColor = (base, mods = []) => ({
+	base,
+	mods
+});
+//#endregion
+export { makeSchemeColor as a, makeColor as i, VALUED_COLOR_MOD_KINDS as n, makeSrgbColor as o, VALUELESS_COLOR_MOD_KINDS as r, SCHEME_COLOR_NAMES as t };
+
+//# sourceMappingURL=colors-ovWAwnZI.mjs.map

package/dist/colors-ovWAwnZI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors-ovWAwnZI.mjs","names":[],"sources":["../src/drawing/dml/colors.ts"],"sourcesContent":["// DrawingML colors.\n//\n// ECMA-376 spreads \"color\" across six element kinds (`<a:srgbClr>`,\n// `<a:sysClr>`, `<a:schemeClr>`, `<a:prstClr>`, `<a:hslClr>`, `<a:scrgbClr>`)\n// plus a long modifier list (`<a:lumMod>`, `<a:tint>`, etc.) that may follow\n// the base color. The model splits the two: a `DmlColor` discriminated union\n// for the base, and a `ColorMod[]` carrying the ordered modifier list. Wrapping\n// them in `DmlColorWithMods` keeps the modifier order — Excel re-applies them\n// in the same sequence.\n\n/** ECMA-376 scheme-color names (`<a:schemeClr val=\"...\">`). */\nexport type SchemeColorName =\n  | 'bg1'\n  | 'tx1'\n  | 'bg2'\n  | 'tx2'\n  | 'accent1'\n  | 'accent2'\n  | 'accent3'\n  | 'accent4'\n  | 'accent5'\n  | 'accent6'\n  | 'hlink'\n  | 'folHlink'\n  | 'phClr'\n  | 'dk1'\n  | 'lt1'\n  | 'dk2'\n  | 'lt2';\n\nexport const SCHEME_COLOR_NAMES: ReadonlyArray<SchemeColorName> = [\n  'bg1',\n  'tx1',\n  'bg2',\n  'tx2',\n  'accent1',\n  'accent2',\n  'accent3',\n  'accent4',\n  'accent5',\n  'accent6',\n  'hlink',\n  'folHlink',\n  'phClr',\n  'dk1',\n  'lt1',\n  'dk2',\n  'lt2',\n];\n\nexport type DmlColor =\n  | { kind: 'srgb'; value: string /* RRGGBB */ }\n  | { kind: 'sysClr'; value: string; lastClr?: string }\n  | { kind: 'schemeClr'; value: SchemeColorName }\n  | { kind: 'prstClr'; value: string }\n  | { kind: 'hslClr'; hue: number; sat: number; lum: number }\n  | { kind: 'scrgbClr'; r: number; g: number; b: number };\n\nexport type ColorMod =\n  | { kind: 'lumMod'; val: number }\n  | { kind: 'lumOff'; val: number }\n  | { kind: 'satMod'; val: number }\n  | { kind: 'satOff'; val: number }\n  | { kind: 'hueMod'; val: number }\n  | { kind: 'hueOff'; val: number }\n  | { kind: 'tint'; val: number }\n  | { kind: 'shade'; val: number }\n  | { kind: 'alpha'; val: number }\n  | { kind: 'alphaMod'; val: number }\n  | { kind: 'alphaOff'; val: number }\n  | { kind: 'red'; val: number }\n  | { kind: 'green'; val: number }\n  | { kind: 'blue'; val: number }\n  | { kind: 'redMod'; val: number }\n  | { kind: 'greenMod'; val: number }\n  | { kind: 'blueMod'; val: number }\n  | { kind: 'redOff'; val: number }\n  | { kind: 'greenOff'; val: number }\n  | { kind: 'blueOff'; val: number }\n  | { kind: 'gray' }\n  | { kind: 'comp' }\n  | { kind: 'inv' }\n  | { kind: 'invGamma' }\n  | { kind: 'gamma' };\n\n/** Color mod kinds that take no `val` attribute (their elements are empty). */\nexport const VALUELESS_COLOR_MOD_KINDS: ReadonlyArray<ColorMod['kind']> = ['gray', 'comp', 'inv', 'invGamma', 'gamma'];\n\n/** Color mod kinds that carry a numeric `val` attribute. */\nexport const VALUED_COLOR_MOD_KINDS: ReadonlyArray<ColorMod['kind']> = [\n  'lumMod',\n  'lumOff',\n  'satMod',\n  'satOff',\n  'hueMod',\n  'hueOff',\n  'tint',\n  'shade',\n  'alpha',\n  'alphaMod',\n  'alphaOff',\n  'red',\n  'green',\n  'blue',\n  'redMod',\n  'greenMod',\n  'blueMod',\n  'redOff',\n  'greenOff',\n  'blueOff',\n];\n\nexport interface DmlColorWithMods {\n  base: DmlColor;\n  mods: ColorMod[];\n}\n\nexport const makeSrgbColor = (rrggbb: string): DmlColor => ({ kind: 'srgb', value: rrggbb.toUpperCase() });\n\nexport const makeSchemeColor = (name: SchemeColorName): DmlColor => ({ kind: 'schemeClr', value: name });\n\nexport const makeColor = (base: DmlColor, mods: ColorMod[] = []): DmlColorWithMods => ({ base, mods });\n"],"mappings":";AA8BA,MAAa,qBAAqD;CAChE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;;AAsCA,MAAa,4BAA6D;CAAC;CAAQ;CAAQ;CAAO;CAAY;AAAO;;AAGrH,MAAa,yBAA0D;CACrE;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAOA,MAAa,iBAAiB,YAA8B;CAAE,MAAM;CAAQ,OAAO,OAAO,YAAY;AAAE;AAExG,MAAa,mBAAmB,UAAqC;CAAE,MAAM;CAAa,OAAO;AAAK;AAEtG,MAAa,aAAa,MAAgB,OAAmB,CAAC,OAAyB;CAAE;CAAM;AAAK"}

package/dist/compat/numbers.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `Number.isFinite` typed as a guard. Distinct from the global `isFinite()`
+ * which coerces strings. Rejects `NaN` and ±Infinity.
+ */
+export declare function isFiniteNumber(x: unknown): x is number;
+/** `Number.isInteger` typed as a guard. */
+export declare function isInteger(x: unknown): x is number;
+/**
+ * Detect any of the JS typed-array views (Int8Array, Uint8Array, Float32Array,
+ * etc.). Used at workbook-build boundaries where integration code may pass
+ * numpy-style buffers — we accept them and iterate per-element rather than
+ * refusing.
+ */
+export declare function isTypedArray(x: unknown): x is ArrayBufferView;

package/dist/coordinate-96Ecci4d.mjs

@@ -0,0 +1,276 @@
+import { o as OpenXmlSchemaError } from "./exceptions-D-CFwxgm.mjs";
+//#region src/utils/coordinate.ts
+/** Maximum column index Excel accepts (XFD). */
+const MAX_COL = 16384;
+/** Maximum row index Excel accepts. */
+const MAX_ROW = 1048576;
+const indexByLetter = /* @__PURE__ */ new Map();
+const letterByIndex = /* @__PURE__ */ new Map();
+/**
+* 1-based column index → spreadsheet column letter ("A", "Z", "AA", "XFD").
+* Throws OpenXmlSchemaError when out of range.
+*/
+function columnLetterFromIndex(n) {
+	const cached = letterByIndex.get(n);
+	if (cached !== void 0) return cached;
+	if (!Number.isInteger(n) || n < 1 || n > 16384) throw new OpenXmlSchemaError(`column index ${n} is out of range [1, ${MAX_COL}]`);
+	let m = n;
+	let out = "";
+	while (m > 0) {
+		m -= 1;
+		out = String.fromCharCode(65 + m % 26) + out;
+		m = Math.floor(m / 26);
+	}
+	letterByIndex.set(n, out);
+	return out;
+}
+/**
+* Column letter → 1-based column index. Case-insensitive but at most 3 letters
+* (the spec ceiling). Throws on empty / non-A-Z / over-range.
+*/
+function columnIndexFromLetter(letter) {
+	const cached = indexByLetter.get(letter);
+	if (cached !== void 0) return cached;
+	if (letter.length === 0 || letter.length > 3) throw new OpenXmlSchemaError(`column letter "${letter}" is empty or too long`);
+	let n = 0;
+	for (let i = 0; i < letter.length; i++) {
+		const c = letter.charCodeAt(i);
+		let v;
+		if (c >= 65 && c <= 90) v = c - 64;
+		else if (c >= 97 && c <= 122) v = c - 96;
+		else throw new OpenXmlSchemaError(`column letter "${letter}" contains non-letter char`);
+		n = n * 26 + v;
+	}
+	if (n < 1 || n > 16384) throw new OpenXmlSchemaError(`column letter "${letter}" expands to out-of-range index ${n}`);
+	const key = letter.toUpperCase();
+	indexByLetter.set(key, n);
+	if (key !== letter) indexByLetter.set(letter, n);
+	return n;
+}
+const COORD_RE = /^[$]?([A-Za-z]{1,3})[$]?([1-9][0-9]*)$/;
+const COL_RANGE_RE = /^[$]?([A-Za-z]{1,3}):[$]?([A-Za-z]{1,3})$/;
+const ROW_RANGE_RE = /^[$]?([1-9][0-9]*):[$]?([1-9][0-9]*)$/;
+const SHEET_RANGE_RE = /^(?:'((?:[^']|'')+)'|([^'!]+))!(.+)$/;
+/**
+* Parse a single-cell coordinate string ("A1", "$XFD$1048576") into its column
+* letter (always uppercased) and 1-based row.
+*/
+function coordinateFromString(coord) {
+	const m = COORD_RE.exec(coord);
+	if (m === null || m[1] === void 0 || m[2] === void 0) throw new OpenXmlSchemaError(`coordinateFromString: invalid coordinate "${coord}"`);
+	const column = m[1].toUpperCase();
+	const row = Number.parseInt(m[2], 10);
+	if (row < 1 || row > 1048576) throw new OpenXmlSchemaError(`coordinateFromString: row ${row} out of range`);
+	columnIndexFromLetter(column);
+	return {
+		column,
+		row
+	};
+}
+/**
+* Same as {@link coordinateFromString} but returning the column as its 1-based
+* numeric index. Thin convenience for the worksheet read path.
+*/
+function coordinateToTuple(coord) {
+	const c = coordinateFromString(coord);
+	return {
+		col: columnIndexFromLetter(c.column),
+		row: c.row
+	};
+}
+/** Compose `"A1"` from a 1-based (col, row). */
+function tupleToCoordinate(col, row) {
+	if (!Number.isInteger(row) || row < 1 || row > 1048576) throw new OpenXmlSchemaError(`tupleToCoordinate: row ${row} out of range`);
+	return `${columnLetterFromIndex(col)}${row}`;
+}
+/**
+* Predicate: true iff `s` is a valid single-cell A1 coordinate (`"A1"`,
+* `"XFD1048576"`). Strings with `$` absolute markers, surrounding whitespace,
+* ranges (`A1:B2`), or out-of-bound row / column return false. Useful for
+* sanitising user input before passing to {@link coordinateToTuple} or
+* `setCellByCoord`.
+*/
+function isValidCellRef(s) {
+	if (typeof s !== "string") return false;
+	const m = /^([A-Za-z]{1,3})([1-9][0-9]*)$/.exec(s);
+	if (!m) return false;
+	const colStr = m[1];
+	const rowStr = m[2];
+	if (colStr === void 0 || rowStr === void 0) return false;
+	const col = columnIndexFromLetterUnchecked(colStr);
+	if (col < 1 || col > 16384) return false;
+	const row = Number.parseInt(rowStr, 10);
+	if (!Number.isFinite(row) || row < 1 || row > 1048576) return false;
+	return true;
+}
+/**
+* Predicate: true iff `s` is a valid A1-style range expression — single cell,
+* two-corner range, whole column (`A:A`), or whole row (`1:1`). `$` markers,
+* whitespace, and out-of-bound bounds fail. Sanity-check before {@link
+* rangeBoundaries} / `parseRange`.
+*/
+function isValidRangeRef(s) {
+	if (typeof s !== "string" || s.length === 0) return false;
+	if (isValidCellRef(s)) return true;
+	const ab = /^([A-Za-z]{1,3})([1-9][0-9]*):([A-Za-z]{1,3})([1-9][0-9]*)$/.exec(s);
+	if (ab) {
+		const [, c1, r1, c2, r2] = ab;
+		if (!c1 || !r1 || !c2 || !r2) return false;
+		const col1 = columnIndexFromLetterUnchecked(c1);
+		const col2 = columnIndexFromLetterUnchecked(c2);
+		if (col1 < 1 || col1 > 16384 || col2 < 1 || col2 > 16384) return false;
+		const row1 = Number.parseInt(r1, 10);
+		const row2 = Number.parseInt(r2, 10);
+		return row1 >= 1 && row1 <= 1048576 && row2 >= 1 && row2 <= 1048576;
+	}
+	const cc = /^([A-Za-z]{1,3}):([A-Za-z]{1,3})$/.exec(s);
+	if (cc) {
+		const [, c1, c2] = cc;
+		if (!c1 || !c2) return false;
+		const col1 = columnIndexFromLetterUnchecked(c1);
+		const col2 = columnIndexFromLetterUnchecked(c2);
+		return col1 >= 1 && col1 <= 16384 && col2 >= 1 && col2 <= 16384;
+	}
+	const rr = /^([1-9][0-9]*):([1-9][0-9]*)$/.exec(s);
+	if (rr) {
+		const [, r1, r2] = rr;
+		if (!r1 || !r2) return false;
+		const row1 = Number.parseInt(r1, 10);
+		const row2 = Number.parseInt(r2, 10);
+		return row1 >= 1 && row1 <= 1048576 && row2 >= 1 && row2 <= 1048576;
+	}
+	return false;
+}
+const columnIndexFromLetterUnchecked = (letters) => {
+	let n = 0;
+	const upper = letters.toUpperCase();
+	for (let i = 0; i < upper.length; i++) {
+		const ch = upper.charCodeAt(i);
+		if (ch < 65 || ch > 90) return -1;
+		n = n * 26 + (ch - 64);
+	}
+	return n;
+};
+/**
+* Predicate: true iff `s` is a valid 1..3-char column letter (`"A"` through
+* `"XFD"`, case-insensitive). Empty / over-long / out-of-bound / non-string
+* fails.
+*/
+function isValidColumnLetter(s) {
+	if (typeof s !== "string" || s.length === 0 || s.length > 3) return false;
+	if (!/^[A-Za-z]+$/.test(s)) return false;
+	const col = columnIndexFromLetterUnchecked(s);
+	return col >= 1 && col <= 16384;
+}
+/**
+* Predicate: true iff `n` is a valid 1-based row index in `[1, 1048576]`.
+* Non-finite / non-integer / out-of-bound fails.
+*/
+function isValidRowNumber(n) {
+	return typeof n === "number" && Number.isInteger(n) && n >= 1 && n <= 1048576;
+}
+/**
+* Predicate: true iff `n` is a valid 1-based column index in `[1, 16384]`.
+* Non-finite / non-integer / out-of-bound fails.
+*/
+function isValidColumnNumber(n) {
+	return typeof n === "number" && Number.isInteger(n) && n >= 1 && n <= 16384;
+}
+/**
+* Parse "A1:B5" / "A:A" / "1:1" / single-cell into 1-based (minCol, minRow,
+* maxCol, maxRow). Whole-column ranges fill rows to [1, MAX_ROW]; whole-row
+* ranges fill cols to [1, MAX_COL].
+*/
+function rangeBoundaries(range) {
+	const trimmed = range.trim();
+	if (trimmed.length === 0) throw new OpenXmlSchemaError("rangeBoundaries: empty range");
+	const colon = trimmed.indexOf(":");
+	if (colon < 0) {
+		const c = coordinateFromString(trimmed);
+		const col = columnIndexFromLetter(c.column);
+		return {
+			minCol: col,
+			minRow: c.row,
+			maxCol: col,
+			maxRow: c.row
+		};
+	}
+	const left = trimmed.slice(0, colon);
+	const right = trimmed.slice(colon + 1);
+	const colsOnly = COL_RANGE_RE.exec(trimmed);
+	if (colsOnly !== null && colsOnly[1] !== void 0 && colsOnly[2] !== void 0) {
+		const minCol = columnIndexFromLetter(colsOnly[1]);
+		const maxCol = columnIndexFromLetter(colsOnly[2]);
+		return {
+			minCol: Math.min(minCol, maxCol),
+			minRow: 1,
+			maxCol: Math.max(minCol, maxCol),
+			maxRow: MAX_ROW
+		};
+	}
+	const rowsOnly = ROW_RANGE_RE.exec(trimmed);
+	if (rowsOnly !== null && rowsOnly[1] !== void 0 && rowsOnly[2] !== void 0) {
+		const minRow = Number.parseInt(rowsOnly[1], 10);
+		const maxRow = Number.parseInt(rowsOnly[2], 10);
+		if (minRow < 1 || maxRow < 1 || minRow > 1048576 || maxRow > 1048576) throw new OpenXmlSchemaError(`rangeBoundaries: row out of range in "${trimmed}"`);
+		return {
+			minCol: 1,
+			minRow: Math.min(minRow, maxRow),
+			maxCol: MAX_COL,
+			maxRow: Math.max(minRow, maxRow)
+		};
+	}
+	const a = coordinateFromString(left);
+	const b = coordinateFromString(right);
+	const ac = columnIndexFromLetter(a.column);
+	const bc = columnIndexFromLetter(b.column);
+	return {
+		minCol: Math.min(ac, bc),
+		minRow: Math.min(a.row, b.row),
+		maxCol: Math.max(ac, bc),
+		maxRow: Math.max(a.row, b.row)
+	};
+}
+/** Inverse of {@link rangeBoundaries} for the rectangular case. */
+function boundariesToRangeString(b) {
+	const tl = tupleToCoordinate(b.minCol, b.minRow);
+	if (b.minCol === b.maxCol && b.minRow === b.maxRow) return tl;
+	return `${tl}:${tupleToCoordinate(b.maxCol, b.maxRow)}`;
+}
+/**
+* Parse a sheet-qualified range ("Sheet1!A1:B5" / "'Quarter 1'!A1"). Sheet
+* names with single quotes inside use SQL-style doubling ("'Bob''s Sheet'!A1")
+* — we unescape on the way out.
+*/
+function parseSheetRange(input) {
+	const m = SHEET_RANGE_RE.exec(input);
+	if (m === null) throw new OpenXmlSchemaError(`parseSheetRange: missing "!" delimiter in "${input}"`);
+	const quoted = m[1];
+	const bare = m[2];
+	const range = m[3];
+	if (range === void 0) throw new OpenXmlSchemaError(`parseSheetRange: empty range part in "${input}"`);
+	return {
+		sheet: quoted !== void 0 ? quoted.replace(/''/g, "'") : bare ?? "",
+		range,
+		bounds: rangeBoundaries(range)
+	};
+}
+const BARE_SHEET_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+* Inverse of {@link parseSheetRange}: format a sheet title + range (or
+* single-cell ref) as `Sheet1!A1` or `'Quarter 1'!A1` per Excel's
+* sheet-qualified syntax. Single quotes inside the title are escaped by
+* doubling (`'Bob''s Sheet'`).
+*
+* Quoting rule: sheet titles consisting only of `[A-Za-z_][A-Za-z0-9_]*` are
+* emitted bare; everything else (spaces, digits-leading, hyphens, apostrophes,
+* punctuation…) gets wrapped in single quotes.
+*/
+function formatSheetQualifiedRef(sheet, ref) {
+	if (BARE_SHEET_NAME.test(sheet)) return `${sheet}!${ref}`;
+	return `'${sheet.replace(/'/g, "''")}'!${ref}`;
+}
+//#endregion
+export { columnLetterFromIndex as a, formatSheetQualifiedRef as c, isValidColumnNumber as d, isValidRangeRef as f, tupleToCoordinate as g, rangeBoundaries as h, columnIndexFromLetter as i, isValidCellRef as l, parseSheetRange as m, MAX_ROW as n, coordinateFromString as o, isValidRowNumber as p, boundariesToRangeString as r, coordinateToTuple as s, MAX_COL as t, isValidColumnLetter as u };
+
+//# sourceMappingURL=coordinate-96Ecci4d.mjs.map

package/dist/coordinate-96Ecci4d.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinate-96Ecci4d.mjs","names":[],"sources":["../src/utils/coordinate.ts"],"sourcesContent":["// Worksheet coordinate utilities. Mirrors openpyxl/openpyxl/utils/cell.py.\n//\n// These functions are on the worksheet read/write hot path (millions of calls\n// when streaming a sheet) so the implementations stay branch-light, regex-based\n// only at the entry points, with bounded Map caches for the bidirectional\n// column letter <-> index mapping.\n\nimport { OpenXmlSchemaError } from './exceptions';\n\n/** Maximum column index Excel accepts (XFD). */\nexport const MAX_COL = 16384;\n/** Maximum row index Excel accepts. */\nexport const MAX_ROW = 1048576;\n\n// ---- column letter <-> 1-based index ---------------------------------------\n\nconst indexByLetter = new Map<string, number>();\nconst letterByIndex = new Map<number, string>();\n\n/**\n * 1-based column index → spreadsheet column letter (\"A\", \"Z\", \"AA\", \"XFD\").\n * Throws OpenXmlSchemaError when out of range.\n */\nexport function columnLetterFromIndex(n: number): string {\n  const cached = letterByIndex.get(n);\n  if (cached !== undefined) return cached;\n  if (!Number.isInteger(n) || n < 1 || n > MAX_COL) {\n    throw new OpenXmlSchemaError(`column index ${n} is out of range [1, ${MAX_COL}]`);\n  }\n  let m = n;\n  let out = '';\n  while (m > 0) {\n    m -= 1; // shift to 0-based for the modulo\n    out = String.fromCharCode(65 + (m % 26)) + out;\n    m = Math.floor(m / 26);\n  }\n  letterByIndex.set(n, out);\n  return out;\n}\n\n/**\n * Column letter → 1-based column index. Case-insensitive but at most 3 letters\n * (the spec ceiling). Throws on empty / non-A-Z / over-range.\n */\nexport function columnIndexFromLetter(letter: string): number {\n  const cached = indexByLetter.get(letter);\n  if (cached !== undefined) return cached;\n  if (letter.length === 0 || letter.length > 3) {\n    throw new OpenXmlSchemaError(`column letter \"${letter}\" is empty or too long`);\n  }\n  let n = 0;\n  for (let i = 0; i < letter.length; i++) {\n    const c = letter.charCodeAt(i);\n    let v: number;\n    if (c >= 65 && c <= 90)\n      v = c - 64; // 'A' = 65\n    else if (c >= 97 && c <= 122)\n      v = c - 96; // 'a' = 97\n    else throw new OpenXmlSchemaError(`column letter \"${letter}\" contains non-letter char`);\n    n = n * 26 + v;\n  }\n  if (n < 1 || n > MAX_COL) {\n    throw new OpenXmlSchemaError(`column letter \"${letter}\" expands to out-of-range index ${n}`);\n  }\n  // Normalise the cache key to upper-case so 'a' / 'A' share a slot.\n  const key = letter.toUpperCase();\n  indexByLetter.set(key, n);\n  if (key !== letter) indexByLetter.set(letter, n);\n  return n;\n}\n\n// ---- coordinate parsing ----------------------------------------------------\n\n/** A single-cell coordinate split into its letter and 1-based row. */\nexport interface CellCoordinate {\n  column: string;\n  row: number;\n}\n\n/** A single-cell coordinate split into 1-based numeric (col, row). */\nexport interface CellCoordinateNumeric {\n  col: number;\n  row: number;\n}\n\n/** A 1-based rectangular boundary. */\nexport interface CellRangeBoundaries {\n  minCol: number;\n  minRow: number;\n  maxCol: number;\n  maxRow: number;\n}\n\nconst COORD_RE = /^[$]?([A-Za-z]{1,3})[$]?([1-9][0-9]*)$/;\nconst COL_RANGE_RE = /^[$]?([A-Za-z]{1,3}):[$]?([A-Za-z]{1,3})$/;\nconst ROW_RANGE_RE = /^[$]?([1-9][0-9]*):[$]?([1-9][0-9]*)$/;\nconst SHEET_RANGE_RE = /^(?:'((?:[^']|'')+)'|([^'!]+))!(.+)$/;\n\n/**\n * Parse a single-cell coordinate string (\"A1\", \"$XFD$1048576\") into its column\n * letter (always uppercased) and 1-based row.\n */\nexport function coordinateFromString(coord: string): CellCoordinate {\n  const m = COORD_RE.exec(coord);\n  if (m === null || m[1] === undefined || m[2] === undefined) {\n    throw new OpenXmlSchemaError(`coordinateFromString: invalid coordinate \"${coord}\"`);\n  }\n  const column = m[1].toUpperCase();\n  const row = Number.parseInt(m[2], 10);\n  if (row < 1 || row > MAX_ROW) {\n    throw new OpenXmlSchemaError(`coordinateFromString: row ${row} out of range`);\n  }\n  // Validate column upper bound through the cached helper.\n  columnIndexFromLetter(column);\n  return { column, row };\n}\n\n/**\n * Same as {@link coordinateFromString} but returning the column as its 1-based\n * numeric index. Thin convenience for the worksheet read path.\n */\nexport function coordinateToTuple(coord: string): CellCoordinateNumeric {\n  const c = coordinateFromString(coord);\n  return { col: columnIndexFromLetter(c.column), row: c.row };\n}\n\n/** Compose `\"A1\"` from a 1-based (col, row). */\nexport function tupleToCoordinate(col: number, row: number): string {\n  if (!Number.isInteger(row) || row < 1 || row > MAX_ROW) {\n    throw new OpenXmlSchemaError(`tupleToCoordinate: row ${row} out of range`);\n  }\n  return `${columnLetterFromIndex(col)}${row}`;\n}\n\n/**\n * Predicate: true iff `s` is a valid single-cell A1 coordinate (`\"A1\"`,\n * `\"XFD1048576\"`). Strings with `$` absolute markers, surrounding whitespace,\n * ranges (`A1:B2`), or out-of-bound row / column return false. Useful for\n * sanitising user input before passing to {@link coordinateToTuple} or\n * `setCellByCoord`.\n */\nexport function isValidCellRef(s: unknown): s is string {\n  if (typeof s !== 'string') return false;\n  const m = /^([A-Za-z]{1,3})([1-9][0-9]*)$/.exec(s);\n  if (!m) return false;\n  const colStr = m[1];\n  const rowStr = m[2];\n  if (colStr === undefined || rowStr === undefined) return false;\n  const col = columnIndexFromLetterUnchecked(colStr);\n  if (col < 1 || col > MAX_COL) return false;\n  const row = Number.parseInt(rowStr, 10);\n  if (!Number.isFinite(row) || row < 1 || row > MAX_ROW) return false;\n  return true;\n}\n\n/**\n * Predicate: true iff `s` is a valid A1-style range expression — single cell,\n * two-corner range, whole column (`A:A`), or whole row (`1:1`). `$` markers,\n * whitespace, and out-of-bound bounds fail. Sanity-check before {@link\n * rangeBoundaries} / `parseRange`.\n */\nexport function isValidRangeRef(s: unknown): s is string {\n  if (typeof s !== 'string' || s.length === 0) return false;\n  if (isValidCellRef(s)) return true;\n  const ab = /^([A-Za-z]{1,3})([1-9][0-9]*):([A-Za-z]{1,3})([1-9][0-9]*)$/.exec(s);\n  if (ab) {\n    const [, c1, r1, c2, r2] = ab;\n    if (!c1 || !r1 || !c2 || !r2) return false;\n    const col1 = columnIndexFromLetterUnchecked(c1);\n    const col2 = columnIndexFromLetterUnchecked(c2);\n    if (col1 < 1 || col1 > MAX_COL || col2 < 1 || col2 > MAX_COL) return false;\n    const row1 = Number.parseInt(r1, 10);\n    const row2 = Number.parseInt(r2, 10);\n    return row1 >= 1 && row1 <= MAX_ROW && row2 >= 1 && row2 <= MAX_ROW;\n  }\n  const cc = /^([A-Za-z]{1,3}):([A-Za-z]{1,3})$/.exec(s);\n  if (cc) {\n    const [, c1, c2] = cc;\n    if (!c1 || !c2) return false;\n    const col1 = columnIndexFromLetterUnchecked(c1);\n    const col2 = columnIndexFromLetterUnchecked(c2);\n    return col1 >= 1 && col1 <= MAX_COL && col2 >= 1 && col2 <= MAX_COL;\n  }\n  const rr = /^([1-9][0-9]*):([1-9][0-9]*)$/.exec(s);\n  if (rr) {\n    const [, r1, r2] = rr;\n    if (!r1 || !r2) return false;\n    const row1 = Number.parseInt(r1, 10);\n    const row2 = Number.parseInt(r2, 10);\n    return row1 >= 1 && row1 <= MAX_ROW && row2 >= 1 && row2 <= MAX_ROW;\n  }\n  return false;\n}\n\nconst columnIndexFromLetterUnchecked = (letters: string): number => {\n  let n = 0;\n  const upper = letters.toUpperCase();\n  for (let i = 0; i < upper.length; i++) {\n    const ch = upper.charCodeAt(i);\n    if (ch < 65 || ch > 90) return -1;\n    n = n * 26 + (ch - 64);\n  }\n  return n;\n};\n\n/**\n * Predicate: true iff `s` is a valid 1..3-char column letter (`\"A\"` through\n * `\"XFD\"`, case-insensitive). Empty / over-long / out-of-bound / non-string\n * fails.\n */\nexport function isValidColumnLetter(s: unknown): s is string {\n  if (typeof s !== 'string' || s.length === 0 || s.length > 3) return false;\n  if (!/^[A-Za-z]+$/.test(s)) return false;\n  const col = columnIndexFromLetterUnchecked(s);\n  return col >= 1 && col <= MAX_COL;\n}\n\n/**\n * Predicate: true iff `n` is a valid 1-based row index in `[1, 1048576]`.\n * Non-finite / non-integer / out-of-bound fails.\n */\nexport function isValidRowNumber(n: unknown): n is number {\n  return typeof n === 'number' && Number.isInteger(n) && n >= 1 && n <= MAX_ROW;\n}\n\n/**\n * Predicate: true iff `n` is a valid 1-based column index in `[1, 16384]`.\n * Non-finite / non-integer / out-of-bound fails.\n */\nexport function isValidColumnNumber(n: unknown): n is number {\n  return typeof n === 'number' && Number.isInteger(n) && n >= 1 && n <= MAX_COL;\n}\n\n/**\n * Parse \"A1:B5\" / \"A:A\" / \"1:1\" / single-cell into 1-based (minCol, minRow,\n * maxCol, maxRow). Whole-column ranges fill rows to [1, MAX_ROW]; whole-row\n * ranges fill cols to [1, MAX_COL].\n */\nexport function rangeBoundaries(range: string): CellRangeBoundaries {\n  const trimmed = range.trim();\n  if (trimmed.length === 0) throw new OpenXmlSchemaError('rangeBoundaries: empty range');\n\n  const colon = trimmed.indexOf(':');\n  if (colon < 0) {\n    // Single-cell shorthand: \"A1\" → A1:A1.\n    const c = coordinateFromString(trimmed);\n    const col = columnIndexFromLetter(c.column);\n    return { minCol: col, minRow: c.row, maxCol: col, maxRow: c.row };\n  }\n\n  const left = trimmed.slice(0, colon);\n  const right = trimmed.slice(colon + 1);\n\n  const colsOnly = COL_RANGE_RE.exec(trimmed);\n  if (colsOnly !== null && colsOnly[1] !== undefined && colsOnly[2] !== undefined) {\n    const minCol = columnIndexFromLetter(colsOnly[1]);\n    const maxCol = columnIndexFromLetter(colsOnly[2]);\n    return {\n      minCol: Math.min(minCol, maxCol),\n      minRow: 1,\n      maxCol: Math.max(minCol, maxCol),\n      maxRow: MAX_ROW,\n    };\n  }\n\n  const rowsOnly = ROW_RANGE_RE.exec(trimmed);\n  if (rowsOnly !== null && rowsOnly[1] !== undefined && rowsOnly[2] !== undefined) {\n    const minRow = Number.parseInt(rowsOnly[1], 10);\n    const maxRow = Number.parseInt(rowsOnly[2], 10);\n    if (minRow < 1 || maxRow < 1 || minRow > MAX_ROW || maxRow > MAX_ROW) {\n      throw new OpenXmlSchemaError(`rangeBoundaries: row out of range in \"${trimmed}\"`);\n    }\n    return {\n      minCol: 1,\n      minRow: Math.min(minRow, maxRow),\n      maxCol: MAX_COL,\n      maxRow: Math.max(minRow, maxRow),\n    };\n  }\n\n  const a = coordinateFromString(left);\n  const b = coordinateFromString(right);\n  const ac = columnIndexFromLetter(a.column);\n  const bc = columnIndexFromLetter(b.column);\n  return {\n    minCol: Math.min(ac, bc),\n    minRow: Math.min(a.row, b.row),\n    maxCol: Math.max(ac, bc),\n    maxRow: Math.max(a.row, b.row),\n  };\n}\n\n/** Inverse of {@link rangeBoundaries} for the rectangular case. */\nexport function boundariesToRangeString(b: CellRangeBoundaries): string {\n  const tl = tupleToCoordinate(b.minCol, b.minRow);\n  if (b.minCol === b.maxCol && b.minRow === b.maxRow) return tl;\n  const br = tupleToCoordinate(b.maxCol, b.maxRow);\n  return `${tl}:${br}`;\n}\n\n/**\n * Parse a sheet-qualified range (\"Sheet1!A1:B5\" / \"'Quarter 1'!A1\"). Sheet\n * names with single quotes inside use SQL-style doubling (\"'Bob''s Sheet'!A1\")\n * — we unescape on the way out.\n */\nexport function parseSheetRange(input: string): {\n  sheet: string;\n  range: string;\n  bounds: CellRangeBoundaries;\n} {\n  const m = SHEET_RANGE_RE.exec(input);\n  if (m === null) throw new OpenXmlSchemaError(`parseSheetRange: missing \"!\" delimiter in \"${input}\"`);\n  const quoted = m[1];\n  const bare = m[2];\n  const range = m[3];\n  if (range === undefined) throw new OpenXmlSchemaError(`parseSheetRange: empty range part in \"${input}\"`);\n  const sheet = quoted !== undefined ? quoted.replace(/''/g, \"'\") : (bare ?? '');\n  return { sheet, range, bounds: rangeBoundaries(range) };\n}\n\nconst BARE_SHEET_NAME = /^[A-Za-z_][A-Za-z0-9_]*$/;\n\n/**\n * Inverse of {@link parseSheetRange}: format a sheet title + range (or\n * single-cell ref) as `Sheet1!A1` or `'Quarter 1'!A1` per Excel's\n * sheet-qualified syntax. Single quotes inside the title are escaped by\n * doubling (`'Bob''s Sheet'`).\n *\n * Quoting rule: sheet titles consisting only of `[A-Za-z_][A-Za-z0-9_]*` are\n * emitted bare; everything else (spaces, digits-leading, hyphens, apostrophes,\n * punctuation…) gets wrapped in single quotes.\n */\nexport function formatSheetQualifiedRef(sheet: string, ref: string): string {\n  if (BARE_SHEET_NAME.test(sheet)) return `${sheet}!${ref}`;\n  return `'${sheet.replace(/'/g, \"''\")}'!${ref}`;\n}\n"],"mappings":"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"}

package/dist/datetime-B2ySVlXt.mjs

@@ -0,0 +1,71 @@
+import { o as OpenXmlSchemaError } from "./exceptions-D-CFwxgm.mjs";
+//#region src/utils/datetime.ts
+/** 1899-12-30 (UTC) — the Windows / 1900-system epoch in ms. */
+const WINDOWS_EPOCH_MS = Date.UTC(1899, 11, 30);
+/** 1904-01-01 (UTC) — the Mac / 1904-system epoch in ms. */
+const MAC_EPOCH_MS = Date.UTC(1904, 0, 1);
+const MS_PER_DAY = 864e5;
+/** Serial day index of the phantom 1900-02-29; absorbed onto 1900-02-28. */
+const LEAP_DUPLICATE_DAY = 60;
+const epochMs = (e) => e === "mac" ? MAC_EPOCH_MS : WINDOWS_EPOCH_MS;
+/**
+* Convert an Excel serial date into a JS `Date` (UTC). The fractional part is
+* treated as a fraction of a day. For Windows 1900 the leap-bug compensation
+* kicks in for serials in [0, 60).
+*/
+function excelToDate(serial, opts) {
+	if (!Number.isFinite(serial)) throw new OpenXmlSchemaError(`excelToDate: serial "${serial}" is not finite`);
+	const epoch = epochMs(opts?.epoch);
+	const day = Math.floor(serial);
+	const fraction = serial - day;
+	const ms = epoch + (epoch === WINDOWS_EPOCH_MS && serial >= 0 && serial < LEAP_DUPLICATE_DAY ? day + 1 : day) * MS_PER_DAY + Math.round(fraction * MS_PER_DAY);
+	return new Date(ms);
+}
+/**
+* Convert a JS `Date` into an Excel serial. The Date is read in UTC. On Windows
+* 1900, dates ≤ 1900-02-28 get a -1 day correction to account for Excel's
+* phantom leap day.
+*/
+function dateToExcel(date, opts) {
+	const t = date.getTime();
+	if (!Number.isFinite(t)) throw new OpenXmlSchemaError("dateToExcel: invalid Date");
+	const epoch = epochMs(opts?.epoch);
+	const dayStartMs = Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+	const days = Math.round((dayStartMs - epoch) / MS_PER_DAY);
+	const subDay = (t - dayStartMs) / MS_PER_DAY;
+	return (epoch === WINDOWS_EPOCH_MS && days <= LEAP_DUPLICATE_DAY ? days - 1 : days) + subDay;
+}
+/** Excel duration serial (fraction of a day) → milliseconds. */
+function excelToDuration(serial) {
+	if (!Number.isFinite(serial)) throw new OpenXmlSchemaError(`excelToDuration: serial "${serial}" is not finite`);
+	return Math.round(serial * MS_PER_DAY);
+}
+/** Milliseconds → Excel duration serial (fraction of a day). */
+function durationToExcel(ms) {
+	if (!Number.isFinite(ms)) throw new OpenXmlSchemaError(`durationToExcel: ms "${ms}" is not finite`);
+	return ms / MS_PER_DAY;
+}
+/**
+* Parse an ISO-8601 / W3CDTF datetime string into a `Date`. Same grammar as
+* `new Date(string)`; the wrapper just adds typed error reporting and a
+* stricter "must be a recognised ISO" guard.
+*/
+function fromIso8601(s) {
+	if (typeof s !== "string" || s.length === 0) throw new OpenXmlSchemaError(`fromIso8601: empty input`);
+	const d = new Date(s);
+	if (Number.isNaN(d.getTime())) throw new OpenXmlSchemaError(`fromIso8601: invalid datetime "${s}"`);
+	return d;
+}
+/**
+* Format a `Date` as ISO-8601 with second precision in UTC. Trims the
+* millisecond fragment that `Date.toISOString()` always produces, so the output
+* matches Excel / openpyxl's W3CDTF style.
+*/
+function toIso8601(d) {
+	if (Number.isNaN(d.getTime())) throw new OpenXmlSchemaError("toIso8601: invalid Date");
+	return d.toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+//#endregion
+export { excelToDate as a, toIso8601 as c, durationToExcel as i, WINDOWS_EPOCH_MS as n, excelToDuration as o, dateToExcel as r, fromIso8601 as s, MAC_EPOCH_MS as t };
+
+//# sourceMappingURL=datetime-B2ySVlXt.mjs.map