@sheetxl/sdk 0.8.0-beta.15 → 0.8.0-beta.17

package/node/esm/M3jahkTgfUxGyeZv.mjs

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

package/node/esm/{-afI0SRg_vgXtea7.mjs → NnrDjio_xwTBs05n.mjs}

@@ -1,10 +1,10 @@
 /**
-* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.15
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.17
 *
 * (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 } from "./BlHlBRvKGt-4CS0A.mjs";
+import { t } from "./zh6vcRzFqdV1aYh5.mjs";
 var c = 2 * Math.PI;
 function n(t, c) {
 	const n = Math.cos(c), e = Math.sin(c), s = Math.cos(t.phi), y = Math.sin(t.phi);