@sheetxl/sdk 0.8.0-beta.1 → 0.8.0-beta.10

package/node/esm/Bsx9uijd4X_SKV3L.mjs

@@ -0,0 +1,360 @@
+/**
+* @license @sheetxl/sdk - SDK - A high-performance, embeddable spreadsheet engine. - v0.8.0-beta.10
+*
+* (C) 2026-present SheetXL Inc. & Michael T. Ford
+* License: The license can be found at https://www.sheetxl.com/license.
+*/
+import { t } from "./CnSQ7MTXAUAyBOoS.mjs";
+import { IAnchored as e, ICondition as s, R as n, d as r, f as i, m as o, p as l, u as a } from "./index.mjs";
+import { ExpectedError as u, messageKey as h, t as c } from "@sheetxl/utils";
+var d = "SlicerStyleLight1", g = "ascending", m = "showItemsWithDataAtTop", _ = h("op.setSlicerCaption"), f = h("op.setSlicerStyle"), p = h("op.setSlicerLayout"), S = h("op.setSlicerSort"), C = h("op.selectSlicerItems"), b = s.BuiltInSelectorNames.Display, v = Object.freeze({
+	selector: b,
+	scope: "column"
+}), k = Object.freeze({ transactional: !1 }), y = class extends t {
+	constructor(t) {
+		const e = i(t.json?.source)?.column ?? "";
+		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._columnName = e;
+		const n = t.json;
+		n && this._updateState({ data: { ...n } }), n?.source && this._addWatch(n.source, (t) => {
+			this._formula = t.formula, this._wired ??= t.formula.getExpression(), this._checkSource(!1);
+		});
+	}
+	getType() {
+		return "slicer";
+	}
+	getTypeDescription() {
+		return "Slicer";
+	}
+	getDefaultAnchorType() {
+		return e.Type.Absolute;
+	}
+	getSource() {
+		const t = this._data()?.source ?? "", e = this._formula?.getExpression() ?? null;
+		return null === e || e === this._wired ? t : e;
+	}
+	getTable() {
+		return this._resolve()?.table ?? null;
+	}
+	getColumn() {
+		return this._resolve()?.column ?? null;
+	}
+	setName(t) {
+		const e = this._getWorkbook();
+		if (e && o(e, t, this) !== t) throw new u(c("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 }, _, e);
+	}
+	isShowCaption() {
+		return !0 !== this._data()?.hiddenCaption;
+	}
+	setShowCaption(t, e) {
+		return this._set({ hiddenCaption: !t || void 0 }, _, e);
+	}
+	getCacheName() {
+		return this._data()?.cacheName || (l(this._getWorkbook()).get(this) ?? a(this._getColumnName()));
+	}
+	getStyle() {
+		return this._data()?.style ?? d;
+	}
+	setStyle(t, e) {
+		return this._set({ style: t && t !== d ? t : void 0 }, f, e);
+	}
+	getSortOrder() {
+		return this._data()?.sortOrder ?? g;
+	}
+	setSortOrder(t, e) {
+		return this._set({ sortOrder: t !== g ? t : void 0 }, S, e);
+	}
+	getCrossFilter() {
+		return this._data()?.crossFilter ?? m;
+	}
+	setCrossFilter(t, e) {
+		return this._set({ crossFilter: t !== m ? t : void 0 }, S, 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 }, p, 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 }, p, e);
+	}
+	isLockedPosition() {
+		return !0 === this._data()?.lockedPosition;
+	}
+	setLockedPosition(t, e) {
+		return this._set({ lockedPosition: t || void 0 }, p, e);
+	}
+	isFilterCleared() {
+		return !this.getColumn()?.getFilter()?.getCondition();
+	}
+	async getItems() {
+		const t = this.getColumn()?.getFilter();
+		if (!t) return w;
+		const e = await t.getItems(v), r = t.getCondition(), i = r ? function(t, e) {
+			const n = t.toJSON();
+			if (n.operator !== s.BuiltInOperatorNames.InSet) return () => !1;
+			const r = n.param ?? {}, i = /* @__PURE__ */ new Set(), o = r.items ?? [];
+			for (let t = 0; t < o.length; t++) null !== o[t] && i.add(String(o[t]).toLowerCase());
+			const l = r.dateGroups ?? [], a = e.dates?.[e.dates.length - 1] ?? null;
+			return (t) => {
+				if (t < 0) return !0 === r.blank;
+				if (i.has(e.items[t].text.toLowerCase())) return !0;
+				if (!a || 0 === l.length) return !1;
+				let s = null;
+				for (let e = 0; e < a.runs.length && !s; e++) {
+					const n = a.runs[e];
+					n.min <= t && t <= n.max && (s = n.value ?? null);
+				}
+				if (!s) return !1;
+				for (let t = 0; t < l.length; t++) if (I(l[t], s)) return !0;
+				return !1;
+			};
+		}(r, e) : null, o = [];
+		for (let t = 0; t < e.items.length; t++) {
+			const s = e.items[t], n = !0 === s.passesOthers;
+			o.push({
+				item: {
+					key: s.text,
+					name: s.text,
+					value: s.value,
+					hasData: n,
+					isSelected: !i || (n ? s.checked : i(t))
+				},
+				firstRow: s.firstRow
+			});
+		}
+		const l = this.getSortOrder();
+		if ("dataSource" === l) o.sort((t, e) => t.firstRow - e.firstRow);
+		else {
+			const e = t.getRange().getSheet().getRuntime().getLocaleProfile(), s = "descending" === l ? -1 : 1;
+			o.sort((t, r) => s * (n.compare(t.item.value, r.item.value, e) || n.compare(t.item.key, r.item.key, e)));
+		}
+		let a = null;
+		if (e.hasBlanks) {
+			const t = !0 === e.blanksPassOthers;
+			a = {
+				key: R,
+				name: c("slicer.blankItem"),
+				value: null,
+				hasData: t,
+				isSelected: !i || (t ? e.blanksChecked : i(-1))
+			};
+		}
+		const u = [], h = this.getCrossFilter();
+		if ("showItemsWithNoData" === h) {
+			for (let t = 0; t < o.length; t++) u.push(o[t].item);
+			return a && u.push(a), u;
+		}
+		for (let t = 0; t < o.length; t++) o[t].item.hasData && u.push(o[t].item);
+		if (a?.hasData && u.push(a), "none" === h) return u;
+		for (let t = 0; t < o.length; t++) o[t].item.hasData || u.push(o[t].item);
+		return a && !a.hasData && u.push(a), u;
+	}
+	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) {
+		const n = this.getColumn()?.getFilter();
+		if (!n) return this;
+		if (!t || 0 === t.length) return this.clearFilters(e);
+		const r = await n.getItems(v), i = new Set(t), o = r.dates?.[r.dates.length - 1] ?? null, l = o && o.runs.length > 0 ? o.runs[o.runs.length - 1].max : -1, a = [], u = [];
+		let h = !0, c = 0;
+		for (let t = 0; t < r.items.length; t++) {
+			if (!i.has(r.items[t].text)) {
+				h = !1;
+				continue;
+			}
+			if (t > l) {
+				a.push(r.items[t].text);
+				continue;
+			}
+			for (; o.runs[c].max < t;) c++;
+			const e = o.runs[c].value;
+			e && u[u.length - 1] !== e && u.push(e);
+		}
+		const d = r.hasBlanks && i.has(R);
+		if (r.hasBlanks && !d && (h = !1), h && !r.truncated) return this.clearFilters(e);
+		const g = { items: a };
+		return u.length > 0 && (g.dateGroups = u), d && (g.blank = !0), await n.setCondition({
+			selector: b,
+			operator: s.BuiltInOperatorNames.InSet,
+			param: g
+		}, !1, {
+			description: C,
+			...e
+		}), this;
+	}
+	async clearFilters(t) {
+		return await this.getColumn()?.getFilter()?.delete(t), this;
+	}
+	addListeners(t, e) {
+		const s = super.addListeners(t, e);
+		if (!this._binding) {
+			const t = this._resolve();
+			t && this._bind(t);
+		}
+		return s;
+	}
+	toJSON(t) {
+		const e = this._data();
+		if (!e) return null;
+		const s = this.getSource();
+		return s ? {
+			...e,
+			source: s
+		} : e;
+	}
+	get isISlicer() {
+		return !0;
+	}
+	get [Symbol.toStringTag]() {
+		return "[Slicer]";
+	}
+	toString() {
+		return this.getTypeDescription();
+	}
+	_attach() {
+		this._checkSource(!0);
+	}
+	_data() {
+		return this._getState()?.data ?? null;
+	}
+	_getWorkbook() {
+		try {
+			return this.getMovable()?.getRange().getSheet().getWorkbook() ?? null;
+		} catch {
+			return null;
+		}
+	}
+	_resolve() {
+		if (this._closed) return null;
+		const t = i(this.getSource());
+		if (!t) return null;
+		const e = r(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()) 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
+				}, k),
+				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, n = s ? s.getCoords() : null;
+		(n && e.coords ? n.rowStart !== e.coords.rowStart || n.rowEnd !== e.coords.rowEnd || n.colStart !== e.coords.colStart || n.colEnd !== e.coords.colEnd : n !== e.coords) && (e.removeRange?.(), e.removeRange = s?.addListener(() => {
+			this._notify("onItemsChange");
+		}, {
+			ignoreAddressChanges: !0,
+			...k
+		}) ?? null, e.coords = n, 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 n = this._data();
+		if (!n) return this;
+		const r = {
+			...n,
+			...t
+		};
+		for (const e in t) void 0 === r[e] && delete r[e];
+		return this._updateState({ data: r }, {
+			...s,
+			description: e
+		}, ["onAnyChange"]), this;
+	}
+	_processDelete() {
+		this._unbind(), super._processDelete();
+	}
+	_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(), super.close();
+	}
+}, w = Object.freeze([]), R = "";
+var D = [
+	"year",
+	"month",
+	"day",
+	"hour",
+	"minute",
+	"second"
+];
+function I(t, e) {
+	for (let s = 0; s < D.length; s++) {
+		const n = D[s];
+		if (t[n] !== e[n]) return !1;
+		if (n === t.group) return !0;
+	}
+	return !0;
+}
+export { y as Slicer };