@sheetxl/sdk 0.8.0-beta.14 → 0.8.0-beta.16

package/browser/esm/{DnR0xY7_iE3TmMcg.mjs → BtNuoQIrrHw_jnbJ.mjs}

@@ -1,11 +1,11 @@
 /**
-* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.14
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.16
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
-* License: The license can be found at https://www.sheetxl.com/license.
+* License: SheetXL EULA — https://www.sheetxl.com/eula
 */
-import { t as e } from "./qCqzZW74-fhaIG2V.mjs";
-import { D as t, E as n, T as r, _ as i, a, c as o, d as s, h as c, i as l, k as u, m as d, r as f, u as p, ut as m } from "./AXlD9K1gCwPU4gCO.mjs";
+import { t as e } from "./D807piM0VSokWz-L.mjs";
+import { D as t, E as n, T as r, _ as i, a, c as o, d as s, h as c, i as l, k as u, m as d, r as f, u as p, ut as m } from "./CMChv-fCFh68VQQt.mjs";
 import { ExpectedError as h, messageKey as g } from "@sheetxl/utils";
 var _ = Object.freeze({}), v = /^(line|lineInv|straightConnector\d|bentConnector\d|curvedConnector\d)$/, y = () => {}, b = class extends e {
 	constructor(e) {

package/browser/esm/BxFzcCYhvo9NXFjC.mjs

@@ -0,0 +1,527 @@
+/**
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.16
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: SheetXL EULA — https://www.sheetxl.com/eula
+*/
+import { t as e } from "./D807piM0VSokWz-L.mjs";
+import { an as t, br as n, gr as r, hr as i, in as a, nn as o, rn as s, vr as c, wa as l, wi as u, xi as d, yr as f } from "./CkZoDPUCK5jMUaeJ.mjs";
+import { ExpectedError as p, messageKey as m, t as h } from "@sheetxl/utils";
+var g = "SlicerStyleLight1", _ = "ascending", v = "showItemsWithDataAtTop", y = m("op.setSlicerCaption"), b = m("op.setSlicerStyle"), x = m("op.setSlicerLayout"), S = m("op.setSlicerSort"), C = m("op.selectSlicerItems"), w = d.BuiltInSelectorNames.Display, T = Object.freeze({
+	selector: w,
+	scope: "column"
+}), E = Object.freeze({ transactional: !1 }), D = class extends e {
+	constructor(e) {
+		let t = c(e.json?.source)?.column ?? e.json?.pivot?.sourceName ?? "", n = e.name;
+		!n && e.getMovable && (n = t || null), super({
+			...e,
+			name: n
+		}), this._formula = null, this._wired = null, this._binding = null, this._lossPending = !1, this._pivotTables = null, this._pivotBinding = null, this._columnName = t;
+		let r = e.json;
+		r && this._updateState({ data: { ...r } }), r?.source && this._addWatch(r.source, (e) => {
+			this._formula = e.formula, this._wired ??= e.formula.getExpression(), this._checkSource(!1);
+		});
+	}
+	getType() {
+		return "slicer";
+	}
+	getTypeDescription() {
+		return "Slicer";
+	}
+	getDefaultAnchorType() {
+		return u.Type.Absolute;
+	}
+	getSourceName() {
+		return this._data()?.pivot?.sourceName ?? this._getColumnName();
+	}
+	getTable() {
+		return this._data()?.pivot ? this._getPivotTables()?.[0] ?? null : this._resolve()?.table ?? null;
+	}
+	getColumn() {
+		return this._resolve()?.column ?? null;
+	}
+	getPivotTables() {
+		return this._getPivotTables() ?? A;
+	}
+	getPivotField() {
+		let e = this._getPivotTables()?.[0];
+		if (!e) return null;
+		let n = t(e._getCache(), this.getSourceName());
+		return n < 0 ? null : e.getFields()[n] ?? null;
+	}
+	_getSource() {
+		let e = this._data()?.source ?? "", t = this._formula?.getExpression() ?? null;
+		return t === null || t === this._wired ? e : t;
+	}
+	setName(e) {
+		let t = this._getWorkbook();
+		if (t && n(t, e, this) !== e) throw new p(h("error.slicer.nameTaken", { name: e }));
+		return super.setName(e);
+	}
+	getCaption() {
+		return this._data()?.caption ?? this._getColumnName();
+	}
+	setCaption(e, t) {
+		return this._set({ caption: e ?? void 0 }, y, t);
+	}
+	isShowCaption() {
+		return !0 !== this._data()?.hiddenCaption;
+	}
+	setShowCaption(e, t) {
+		return this._set({ hiddenCaption: !e || void 0 }, y, t);
+	}
+	getCacheName() {
+		return this._data()?.cacheName || (f(this._getWorkbook()).get(this) ?? i(this._getColumnName()));
+	}
+	getStyle() {
+		return this._data()?.style ?? g;
+	}
+	setStyle(e, t) {
+		return this._set({ style: e && e !== g ? e : void 0 }, b, t);
+	}
+	getSortOrder() {
+		return this._data()?.sortOrder ?? _;
+	}
+	setSortOrder(e, t) {
+		if (e === "dataSource" && this._data()?.pivot) throw new p(h("error.slicer.pivotSortOrder"));
+		return this._set({ sortOrder: e === _ ? void 0 : e }, S, t);
+	}
+	getCrossFilter() {
+		return this._data()?.crossFilter ?? v;
+	}
+	setCrossFilter(e, t) {
+		return this._set({ crossFilter: e === v ? void 0 : e }, S, t);
+	}
+	getColumnCount() {
+		return this._data()?.columnCount ?? 1;
+	}
+	setColumnCount(e, t) {
+		let n = Math.max(1, Math.trunc(e));
+		return this._set({ columnCount: n === 1 ? void 0 : n }, x, t);
+	}
+	getRowHeight() {
+		return this._data()?.rowHeight ?? 27;
+	}
+	setRowHeight(e, t) {
+		let n = Math.max(1, e);
+		return this._set({ rowHeight: n === 27 ? void 0 : n }, x, t);
+	}
+	isLockedPosition() {
+		return !0 === this._data()?.lockedPosition;
+	}
+	setLockedPosition(e, t) {
+		return this._set({ lockedPosition: e || void 0 }, x, t);
+	}
+	isFilterCleared() {
+		if (this.isITimeline) {
+			let e = this._timelineField();
+			return !e?.table._getModel()?.filters?.some((t) => t.field === e.field && t.dataField === void 0);
+		}
+		return this._data()?.pivot ? this._getPivotItems()?.items.every((e) => e.isSelected) ?? !0 : !this.getColumn()?.getFilter()?.getCondition();
+	}
+	async getItems() {
+		let e = this._data()?.pivot;
+		if (e?.timeline) return O;
+		if (e) {
+			let t = this.getCrossFilter();
+			return (this._getPivotItems()?.items ?? k).flatMap((n) => {
+				if (t === "none" && !n.hasData || e.tabular?.hideMissing && n.missing) return [];
+				let { id: r, missing: i, ...a } = n;
+				return [a];
+			});
+		}
+		let t = this.getColumn()?.getFilter();
+		if (!t) return O;
+		let n = await t.getItems(T), r = t.getCondition(), i = r ? function(e, t) {
+			let n = e.toJSON();
+			if (n.operator !== d.BuiltInOperatorNames.InSet) return () => !1;
+			let r = n.param ?? {}, i = /* @__PURE__ */ new Set(), a = r.items ?? [];
+			for (let e = 0; e < a.length; e++) a[e] !== null && i.add(String(a[e]).toLowerCase());
+			let o = r.dateGroups ?? [], s = t.dates?.[t.dates.length - 1] ?? null;
+			return (e) => {
+				if (e < 0) return !0 === r.blank;
+				if (i.has(t.items[e].text.toLowerCase())) return !0;
+				if (!s || o.length === 0) return !1;
+				let n = null;
+				for (let t = 0; t < s.runs.length && !n; t++) {
+					let r = s.runs[t];
+					r.min <= e && e <= r.max && (n = r.value ?? null);
+				}
+				if (!n) return !1;
+				for (let e = 0; e < o.length; e++) if (N(o[e], n)) return !0;
+				return !1;
+			};
+		}(r, n) : null, a = [];
+		for (let e = 0; e < n.items.length; e++) {
+			let t = n.items[e], r = !0 === t.passesOthers;
+			a.push({
+				item: {
+					key: t.text,
+					name: t.text,
+					value: t.value,
+					hasData: r,
+					isSelected: !i || (r ? t.checked : i(e))
+				},
+				firstRow: t.firstRow
+			});
+		}
+		let o = this.getSortOrder();
+		if (o === "dataSource") a.sort((e, t) => e.firstRow - t.firstRow);
+		else {
+			let e = t.getRange().getWorksheet().getRuntime().getLocaleProfile(), n = o === "descending" ? -1 : 1;
+			a.sort((t, r) => n * (l.compare(t.item.value, r.item.value, e) || l.compare(t.item.key, r.item.key, e)));
+		}
+		let s = null;
+		if (n.hasBlanks) {
+			let e = !0 === n.blanksPassOthers;
+			s = {
+				key: j,
+				name: h("slicer.blankItem"),
+				value: null,
+				hasData: e,
+				isSelected: !i || (e ? n.blanksChecked : i(-1))
+			};
+		}
+		let c = [], u = this.getCrossFilter();
+		if (u === "showItemsWithNoData") {
+			for (let e = 0; e < a.length; e++) c.push(a[e].item);
+			return s && c.push(s), c;
+		}
+		for (let e = 0; e < a.length; e++) a[e].item.hasData && c.push(a[e].item);
+		if (s?.hasData && c.push(s), u === "none") return c;
+		for (let e = 0; e < a.length; e++) a[e].item.hasData || c.push(a[e].item);
+		return s && !s.hasData && c.push(s), c;
+	}
+	async getItem(e) {
+		let t = await this.getItems();
+		for (let n = 0; n < t.length; n++) if (t[n].key === e) return t[n];
+		return null;
+	}
+	async selectItems(e, t) {
+		if (this.isITimeline) return this;
+		if (this._data()?.pivot) {
+			let n = this._getPivotItems()?.items;
+			if (!n) return this;
+			let r = new Set(e), i = new Set(n.flatMap((e) => r.has(e.key) ? [e.id] : []));
+			return await this._showPivotItems(i.size === 0 || i.size === n.length ? null : i, t), this;
+		}
+		let n = this.getColumn()?.getFilter();
+		if (!n) return this;
+		if (!e || e.length === 0) return this.clearFilters(t);
+		let r = await n.getItems(T), i = new Set(e), a = r.dates?.[r.dates.length - 1] ?? null, o = a && a.runs.length > 0 ? a.runs[a.runs.length - 1].max : -1, s = [], c = [], l = !0, u = 0;
+		for (let e = 0; e < r.items.length; e++) {
+			if (!i.has(r.items[e].text)) {
+				l = !1;
+				continue;
+			}
+			if (e > o) {
+				s.push(r.items[e].text);
+				continue;
+			}
+			for (; a.runs[u].max < e;) u++;
+			let t = a.runs[u].value;
+			t && c[c.length - 1] !== t && c.push(t);
+		}
+		let f = r.hasBlanks && i.has(j);
+		if (r.hasBlanks && !f && (l = !1), l && !r.truncated) return this.clearFilters(t);
+		let p = { items: s };
+		return c.length > 0 && (p.dateGroups = c), f && (p.blank = !0), await n.setCondition({
+			selector: w,
+			operator: d.BuiltInOperatorNames.InSet,
+			param: p
+		}, !1, {
+			description: C,
+			...t
+		}), this;
+	}
+	async clearFilters(e) {
+		return this.isITimeline ? this.setDateRange(null, e) : this._data()?.pivot ? (await this._showPivotItems(null, e), this) : (await this.getColumn()?.getFilter()?.delete(e), this);
+	}
+	addListeners(e, t) {
+		let n = super.addListeners(e, t);
+		if (this._data()?.pivot) return this._bindPivot(), n;
+		if (!this._binding) {
+			let e = this._resolve();
+			e && this._bind(e);
+		}
+		return n;
+	}
+	toJSON(e) {
+		let t = this._data();
+		if (!t) return null;
+		if (t.pivot) {
+			let e = this._getPivotTables();
+			if (!e) return t;
+			let n = {
+				...t.pivot,
+				tables: e.map((e) => ({
+					sheet: e.getWorksheet().getName(),
+					name: e.getName()
+				}))
+			};
+			return n.tabular && e.length > 0 && (n.cacheId = e[0].getCacheId()), {
+				...t,
+				pivot: n
+			};
+		}
+		let n = this._getSource();
+		return n ? {
+			...t,
+			source: n
+		} : t;
+	}
+	get isISlicer() {
+		return !0;
+	}
+	get isITimeline() {
+		return this._data()?.pivot?.timeline !== void 0;
+	}
+	getDateRange() {
+		let e = this._timelineField(), t = e?.table._getModel();
+		return t ? s(t, e.field) : null;
+	}
+	async setDateRange(e, n) {
+		let r = this.isITimeline ? this._getPivotTables() ?? [] : [], i = this._getWorkbook();
+		if (!i || r.length === 0) return this;
+		let a = this.getSourceName();
+		return await i.doBatch(async () => {
+			for (let n of r) {
+				let r = t(n._getCache(), a);
+				r >= 0 && await n._setDateRange(r, a, e);
+			}
+		}, {
+			description: C,
+			...n
+		}), this;
+	}
+	_getTimelineState() {
+		let e = this._data()?.pivot;
+		if (!e?.timeline || !e.tabular) return null;
+		let n = this._timelineField();
+		if (n) {
+			let e = n.table._getModel(), t = n.table._getCache();
+			return {
+				cacheId: n.table.getCacheId(),
+				range: e ? s(e, n.field) : null,
+				filtered: !!e?.filters?.some((e) => e.field === n.field && e.dataField === void 0),
+				dates: o(t, n.field)
+			};
+		}
+		if (e.cacheId === void 0) return null;
+		let r = this._getWorkbook()?._getPivotCache?.(e.cacheId)?.toJSON() ?? null, i = t(r, e.sourceName);
+		return {
+			cacheId: e.cacheId,
+			range: null,
+			filtered: !1,
+			dates: r && i >= 0 ? o(r, i) : null
+		};
+	}
+	_timelineField() {
+		if (!this.isITimeline) return null;
+		let e = this._getPivotTables()?.[0], n = e ? t(e._getCache(), this.getSourceName()) : -1;
+		return n >= 0 ? {
+			table: e,
+			field: n
+		} : null;
+	}
+	get [Symbol.toStringTag]() {
+		return "[Slicer]";
+	}
+	toString() {
+		return this.getTypeDescription();
+	}
+	_attach() {
+		this._checkSource(!0);
+	}
+	_getPivotTables() {
+		if (!this._data()?.pivot) return null;
+		if (!this._pivotTables) {
+			let e = this._getWorkbook();
+			if (!e) return null;
+			this._holdPivotTables((t, n) => e.getWorksheets().getByName(t)?.getPivotTables().getByName(n) ?? null);
+		}
+		return this._pivotTables.filter((e) => !e.isDeleted());
+	}
+	_holdPivotTables(e) {
+		let t = this._data()?.pivot;
+		if (!t) return;
+		let n = [];
+		for (let r = 0; r < t.tables.length; r++) {
+			let i = e(t.tables[r].sheet, t.tables[r].name);
+			i && !n.includes(i) && n.push(i);
+		}
+		this._pivotTables = n;
+	}
+	_getPivotItems() {
+		let e = this._data()?.pivot;
+		if (!e?.tabular || e.timeline) return null;
+		let n = this._getPivotTables()?.[0], r = n ? n.getCacheId() : e.cacheId;
+		if (r === void 0) return null;
+		let i = this._getWorkbook(), o = n ? n._getModel() : {}, s = n ? n._getCache() : i?._getPivotCache?.(r)?.toJSON() ?? null, c = t(s, e.sourceName), l = (n?.getWorksheet() ?? this.getMovable()?.getRange().getWorksheet())?.getRuntime();
+		return !o || !s || c < 0 || !l ? null : {
+			cacheId: r,
+			items: a(o, s, c, this.getSortOrder(), this.getCrossFilter(), l.getLocaleProfile())
+		};
+	}
+	async _showPivotItems(e, n) {
+		let r = this._getPivotTables() ?? [], i = this._getWorkbook();
+		if (!i || r.length === 0) return;
+		let a = this.getSourceName();
+		await i.doBatch(async () => {
+			for (let n of r) {
+				let r = t(n._getCache(), a);
+				r >= 0 && await n._showSlicerItems(r, e);
+			}
+		}, {
+			description: C,
+			...n
+		});
+	}
+	_bindPivot() {
+		let e = this._getPivotTables() ?? [], t = this._pivotBinding;
+		if (t && t.tables.length === e.length && t.tables.every((t, n) => t === e[n])) return;
+		this._unbindPivot();
+		let n = () => {
+			this._notify("onSelectionChange"), this._notify("onItemsChange");
+		};
+		this._pivotBinding = {
+			tables: [...e],
+			removes: e.map((e) => e.addListeners({
+				onAnyChange: n,
+				onDelete: n
+			}, E))
+		};
+	}
+	_unbindPivot() {
+		let e = this._pivotBinding;
+		if (e) {
+			this._pivotBinding = null;
+			for (let t of e.removes) t();
+		}
+	}
+	_data() {
+		return this._getState()?.data ?? null;
+	}
+	_getWorkbook() {
+		try {
+			return this.getMovable()?.getRange().getWorksheet().getWorkbook() ?? null;
+		} catch {
+			return null;
+		}
+	}
+	_resolve() {
+		if (this._closed) return null;
+		let e = c(this._getSource());
+		if (!e) return null;
+		let t = r(this._getWorkbook(), e.table), n = t?.getColumnByName(e.column) ?? null;
+		return n ? (this._columnName = n.getName(), {
+			table: t,
+			column: n
+		}) : null;
+	}
+	_getColumnName() {
+		return this._resolve()?.column.getName() ?? this._columnName;
+	}
+	_checkSource(e) {
+		if (this._closed || this.isDeleted() || this._data()?.pivot) return;
+		let t = this._resolve();
+		if (t) return void this._bind(t);
+		let n = this._getTransactions();
+		n.isRestoring() || (n.isOpenTransaction() ? this.delete() : e && !this._lossPending && (this._lossPending = !0, queueMicrotask(() => {
+			if (this._lossPending = !1, this._closed || this.isDeleted() || n.isOpenTransaction() || n.isRestoring()) return;
+			let e = this._resolve();
+			e ? this._bind(e) : n.amend(n.getCurrentCommit(!1).getId(), () => {
+				this.delete();
+			});
+		})));
+	}
+	_bind(e) {
+		let t = e.table;
+		if (this._binding?.table !== t) {
+			this._unbind();
+			let e = () => {
+				this._checkSource(!0);
+			};
+			this._binding = {
+				table: t,
+				removeTable: t.addListeners({
+					onFilterChange: () => {
+						this._notify("onSelectionChange");
+					},
+					onAnyChange: () => {
+						this._checkSource(!0), this._bindRange(!0);
+					},
+					onAnchorCoordsChange: () => {
+						this._bindRange(!0);
+					},
+					onDelete: e
+				}, E),
+				coords: null,
+				removeRange: null
+			};
+		}
+		this._bindRange(!1);
+	}
+	_bindRange(e) {
+		let t = this._binding;
+		if (!t || this._closed) return;
+		let n = this.getColumn()?.getFilter()?.getRange() ?? null, r = n ? n.getCoords() : null;
+		(r && t.coords ? r.rowStart !== t.coords.rowStart || r.rowEnd !== t.coords.rowEnd || r.colStart !== t.coords.colStart || r.colEnd !== t.coords.colEnd : r !== t.coords) && (t.removeRange?.(), t.removeRange = n?.addListener(() => {
+			this._notify("onItemsChange");
+		}, {
+			ignoreAddressChanges: !0,
+			...E
+		}) ?? null, t.coords = r, e && this._notify("onItemsChange"));
+	}
+	_unbind() {
+		let e = this._binding;
+		e && (this._binding = null, e.removeTable(), e.removeRange?.());
+	}
+	_notify(e) {
+		this._closed || this.isDeleted() || (this._emitter.notify(e), this._emitter.notify("onAnyChange"));
+	}
+	_set(e, t, n) {
+		this._protectionCheck(t);
+		let r = this._data();
+		if (!r) return this;
+		let i = {
+			...r,
+			...e
+		};
+		for (let t in e) i[t] === void 0 && delete i[t];
+		return this._updateState({ data: i }, {
+			...n,
+			description: t
+		}, ["onAnyChange"]), this;
+	}
+	_processDelete() {
+		this._unbind(), this._unbindPivot();
+		let e = this._data()?.pivot?.tabular ? this._getPivotTables() ?? [] : [];
+		super._processDelete();
+		for (let t of e) t._relayForSlicers?.();
+	}
+	_processRestoreOrRevert(e, t) {
+		if (super._processRestoreOrRevert(e, t), this.isDeleted()) return void this._unbind();
+		let n = this._resolve();
+		n && this._bind(n);
+	}
+	close() {
+		this._unbind(), this._unbindPivot(), super.close();
+	}
+}, O = Object.freeze([]), k = Object.freeze([]), A = Object.freeze([]), j = "", M = [
+	"year",
+	"month",
+	"day",
+	"hour",
+	"minute",
+	"second"
+];
+function N(e, t) {
+	for (let n = 0; n < M.length; n++) {
+		let r = M[n];
+		if (e[r] !== t[r]) return !1;
+		if (r === e.group) return !0;
+	}
+	return !0;
+}
+export { D as Slicer };

package/browser/esm/{DonQz2Tc3k9lNT8E.mjs → BxYuRTSF9ykc-Tpz.mjs}

@@ -1,10 +1,10 @@
 /**
-* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.14
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.16
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
-* License: The license can be found at https://www.sheetxl.com/license.
+* License: SheetXL EULA — https://www.sheetxl.com/eula
 */
-import { i as e, n as t, r as n, t as r } from "./CImFKFaYToUH-bSE.mjs";
+import { i as e, n as t, r as n, t as r } from "./BF_QwkZ_hs2rFoTT.mjs";
 var i = 6e4, a = Math.PI / 180 / i, o = 108e5 / Math.PI, s = /^[+-]?\d+$/, c = (e) => s.test(e) ? Number(e) : e, l = /* @__PURE__ */ new WeakMap();
 function u(e) {
 	let t = l.get(e);

package/browser/esm/{aRXqxIzjuSLwawMh.mjs → C2PvZwqK-uvsugVS.mjs}

@@ -1,8 +1,8 @@
 /**
-* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.14
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.16
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
-* License: The license can be found at https://www.sheetxl.com/license.
+* License: SheetXL EULA — https://www.sheetxl.com/eula
 */
 function e(e, t, n) {
 	let r = e.metrics(t);