@sheetxl/primitives 0.1.97

package/LICENSE.md

@@ -0,0 +1,11 @@
+# Repository Licensing
+
+The SheetXL monorepo contains a mix of open-source and commercially licensed packages. Each package is individually licensed and contains its own license file.
+
+For the specific terms and conditions applicable to a package, please see the `LICENSE.md` file located in that package's root directory.
+
+Generally, packages intended for public distribution (such as CLIs, adapters, and vanilla wrappers) are licensed under the MIT license. All other core packages are proprietary and require a commercial license for use.
+
+For more details on commercial licensing, please visit our website:
+
+https://www.sheetxl.com/licensing-pricing

package/README.md

@@ -0,0 +1,7 @@
+# Primitives
+
+<a href="https://www.sheetxl.com" target="_blank" rel="noopener">
+  <img src="https://www.sheetxl.com/logo-text.svg" width="150" alt="SheetXL"/>
+</a>
+
+Primitive interfaces and types for [SheetXL](https://www.sheetxl.com) functions.

package/build/browser/cjs/index.cjs

@@ -0,0 +1,6 @@
+"use strict";/**
+ * @license @sheetxl/primitives - Primitive - Base types for SheetXL functions. - v0.0.0
+ *
+ * (C) 2025-present SheetXL Inc. & Michael T. Ford
+ * License: The license can be found at https://www.sheetxl.com/license.
+ */Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});var i;exports.IRange=void 0,(i=exports.IRange||(exports.IRange={})).Orientation={Column:"column",Row:"row"},i.Orientations={...i.Orientation,Both:"both"},i.Direction={Up:"up",Down:"down",Left:"left",Right:"right"},exports.FormulaError=void 0,(e=>{e.Code={Parse:0,Null:1,Div0:2,Value:3,Ref:4,Name:5,Num:6,NA:7,GettingData:8,Spill:9,Connect:10,Blocked:11,Unknown:12,Field:13,Calc:14,Busy:16,Python:19,Timeout:20},e.Label={Parse:"#PARSE!",Null:"#NULL!",Div0:"#DIV/0!",Value:"#VALUE!",Ref:"#REF!",Name:"#NAME?",Num:"#NUM!",NA:"#N/A",GettingData:"#GETTING_DATA",Spill:"#SPILL!",Connect:"#CONNECT!",Blocked:"#BLOCKED!",Unknown:"#UNKNOWN!",Field:"#FIELD!",Calc:"#CALC!",Busy:"#BUSY!",Python:"#PYTHON!",Timeout:"#TIMEOUT!"};class r extends Error{constructor(t,o,U,C){super(U,C),this._label=o,this._code=t,this.details=C}static{this.code=e.Code.Unknown}get isFormulaError(){return!0}getLabel(){return this._label}getCode(){return this._code}equals(t){return!!t&&(this._code===t._code||this._code===t.code)}get[Symbol.toStringTag](){return"[FormulaError]"}toString(){return this.message||this._label}}e.Known=r;class s extends r{constructor(t,o){super(e.Code.Parse,e.Label.Parse,t,o)}static{this.code=e.Code.Parse}getDetails(){const t=this.details;return{line:t?.line??1,column:t?.column??1,offset:t?.offset??0,length:t?.length??0}}}e.Parse=s;class u extends r{constructor(t,o){super(e.Code.Null,e.Label.Null,t,o)}static{this.code=e.Code.Null}}e.Null=u;class c extends r{constructor(t,o){super(e.Code.Div0,e.Label.Div0,t,o)}static{this.code=e.Code.Div0}}e.Div0=c;class N extends r{constructor(t,o){super(e.Code.Value,e.Label.Value,t,o)}static{this.code=e.Code.Value}}e.Value=N;class p extends r{constructor(t,o){super(e.Code.Ref,e.Label.Ref,t,o)}static{this.code=e.Code.Ref}}e.Ref=p;class h extends r{constructor(t,o){super(e.Code.Name,e.Label.Name,t,o)}static{this.code=e.Code.Name}}e.Name=h;class D extends r{constructor(t,o){super(e.Code.Num,e.Label.Num,t,o)}static{this.code=e.Code.Num}}e.Num=D;class y extends r{constructor(t,o){super(e.Code.NA,e.Label.NA,t,o)}static{this.code=e.Code.NA}}e.NA=y;class S extends r{constructor(t,o){super(e.Code.GettingData,e.Label.GettingData,t,o)}static{this.code=e.Code.GettingData}}e.GettingData=S;class L extends r{constructor(t,o){super(e.Code.Spill,e.Label.Spill,t,o)}static{this.code=e.Code.Spill}}e.Spill=L;class x extends r{constructor(t,o){super(e.Code.Connect,e.Label.Connect,t,o)}static{this.code=e.Code.Connect}}e.Connect=x;class f extends r{constructor(t,o){super(e.Code.Blocked,e.Label.Blocked,t,o)}static{this.code=e.Code.Blocked}}e.Blocked=f;class B extends r{constructor(t,o){super(e.Code.Unknown,e.Label.Unknown,t,o)}static{this.code=e.Code.Unknown}}e.Unknown=B;class k extends r{constructor(t,o){super(e.Code.Field,e.Label.Field,t,o)}static{this.code=e.Code.Field}}e.Field=k;class P extends r{constructor(t,o){super(e.Code.Calc,e.Label.Calc,t,o)}static{this.code=e.Code.Calc}}e.Calc=P;class A extends r{constructor(t,o){super(e.Code.Busy,e.Label.Busy,t,o)}static{this.code=e.Code.Busy}}e.Busy=A;class T extends r{constructor(t,o){super(e.Code.Python,e.Label.Python,t,o)}static{this.code=e.Code.Python}}e.Python=T;class R extends r{constructor(t,o){super(e.Code.Timeout,e.Label.Timeout,t,o)}static{this.code=e.Code.Timeout}}e.Timeout=R})(exports.FormulaError||(exports.FormulaError={}));const l={};l[exports.FormulaError.Code.Parse]=exports.FormulaError.Parse,l[exports.FormulaError.Code.Null]=exports.FormulaError.Null,l[exports.FormulaError.Code.Div0]=exports.FormulaError.Div0,l[exports.FormulaError.Code.Value]=exports.FormulaError.Value,l[exports.FormulaError.Code.Ref]=exports.FormulaError.Ref,l[exports.FormulaError.Code.Name]=exports.FormulaError.Name,l[exports.FormulaError.Code.Num]=exports.FormulaError.Num,l[exports.FormulaError.Code.NA]=exports.FormulaError.NA,l[exports.FormulaError.Code.GettingData]=exports.FormulaError.GettingData,l[exports.FormulaError.Code.Spill]=exports.FormulaError.Spill,l[exports.FormulaError.Code.Connect]=exports.FormulaError.Connect,l[exports.FormulaError.Code.Blocked]=exports.FormulaError.Blocked,l[exports.FormulaError.Code.Unknown]=exports.FormulaError.Unknown,l[exports.FormulaError.Code.Field]=exports.FormulaError.Field,l[exports.FormulaError.Code.Calc]=exports.FormulaError.Calc,l[exports.FormulaError.Code.Busy]=exports.FormulaError.Busy,l[exports.FormulaError.Code.Python]=exports.FormulaError.Python,l[exports.FormulaError.Code.Timeout]=exports.FormulaError.Timeout;const g=new Map,m=new Map,E=new Map,b=new Map,F=Object.keys(l);for(let e=0;e<F.length;e++){const r=F[e],s=l[r];E.set(exports.FormulaError.Label[r],s),b.set(exports.FormulaError.Code[r],s);const u=new s;g.set(u.getLabel(),u),m.set(u.getCode(),u)}const O=m.get(exports.FormulaError.Code.Unknown);var n;(n=exports.FormulaError||(exports.FormulaError={})).BuiltIn={Parse:new n.Parse,Null:new n.Null,Div0:new n.Div0,Value:new n.Value,Ref:new n.Ref,Name:new n.Name,Num:new n.Num,NA:new n.NA,GettingData:new n.GettingData,Spill:new n.Spill,Connect:new n.Connect,Blocked:new n.Blocked,Unknown:new n.Unknown,Field:new n.Field,Calc:new n.Calc,Busy:new n.Busy,Python:new n.Python,Timeout:new n.Timeout},n.getBuiltInByLabel=e=>g.get(e),n.newTypedError=(e,r,s)=>{let u;return u=typeof e=="string"?E.get(e):b.get(e),u||(u=n.Unknown),new u(r,s)},n.getBuiltInById=e=>m.get(e)||O;class w{getRange(r){throw new d}getReference(r,s){throw new d}getNumberFormat(r,s){return s?.toString()??""}fromOADate(r){return new Date(r)}toOADate(r){return r.getTime()}getValueAt(r,s){return null}getEntireCoords(){return I}isValidDate(r){return(r instanceof Date||Object.prototype.toString.call(r)==="[object Date]")&&!isNaN(r.getTime())}getPosition(){return v}getFormulaAt(r,s){return null}getSpillAt(r,s){return null}getSheetIndex(r){return-1}getSheetCount(){return 1}markVolatile(){}formatResults(r){}getFunction(r){return null}getAddress(r,s){throw new d}parseAsDateTime(r,s){throw new d}getRuntime(){return V}}class d extends Error{constructor(r="Not implemented in StubbedFormulaContext"){super(r),this.name="NotImplementedError"}}const v=Object.freeze({colIndex:0,rowIndex:0}),I=Object.freeze({colStart:0,rowStart:0,colEnd:Math.pow(2,14)-1,rowEnd:Math.pow(2,20)-1}),V={getCurrencySymbol:()=>"$",getNumberDecimalSeparator:()=>".",getNumberGroupSeparator:()=>",",isDate1904:()=>!1,getLocation:()=>"unknown",getVersion:()=>"1.0.0",getOS:()=>"unknown",getUser:()=>"unidentified",getDescription:()=>"Stubbed Formula Context"},G=new w;exports.FormulaContext=G,exports.Observable=class{constructor(e){this._subscribeFn=e}subscribe(e,r,s){const u=typeof e=="object"?{next:e.next||(()=>{}),error:e.error||(()=>{}),complete:e.complete||(()=>{}),unsubscribe:()=>{}}:{next:e||(()=>{}),error:r||(()=>{}),complete:s||(()=>{}),unsubscribe:()=>{}},c=this._subscribeFn(u);return u.unsubscribe=()=>{typeof c=="function"&&c()},u}},exports.ScalarType={Number:"n",String:"s",Boolean:"b",Error:"e",RichData:"r",Null:"z"},exports.StubbedFormulaContext=w;

package/build/browser/esm/index.mjs

@@ -0,0 +1,309 @@
+/**
+ * @license @sheetxl/primitives - Primitive - Base types for SheetXL functions. - v0.0.0
+ *
+ * (C) 2025-present SheetXL Inc. & Michael T. Ford
+ * License: The license can be found at https://www.sheetxl.com/license.
+ */
+const M = { Number: "n", String: "s", Boolean: "b", Error: "e", RichData: "r", Null: "z" };
+var w, C, n;
+(C = w || (w = {})).Orientation = { Column: "column", Row: "row" }, C.Orientations = { ...C.Orientation, Both: "both" }, C.Direction = { Up: "up", Down: "down", Left: "left", Right: "right" }, ((e) => {
+  e.Code = { Parse: 0, Null: 1, Div0: 2, Value: 3, Ref: 4, Name: 5, Num: 6, NA: 7, GettingData: 8, Spill: 9, Connect: 10, Blocked: 11, Unknown: 12, Field: 13, Calc: 14, Busy: 16, Python: 19, Timeout: 20 }, e.Label = { Parse: "#PARSE!", Null: "#NULL!", Div0: "#DIV/0!", Value: "#VALUE!", Ref: "#REF!", Name: "#NAME?", Num: "#NUM!", NA: "#N/A", GettingData: "#GETTING_DATA", Spill: "#SPILL!", Connect: "#CONNECT!", Blocked: "#BLOCKED!", Unknown: "#UNKNOWN!", Field: "#FIELD!", Calc: "#CALC!", Busy: "#BUSY!", Python: "#PYTHON!", Timeout: "#TIMEOUT!" };
+  class t extends Error {
+    constructor(o, s, O, b) {
+      super(O, b), this._label = s, this._code = o, this.details = b;
+    }
+    static {
+      this.code = e.Code.Unknown;
+    }
+    get isFormulaError() {
+      return !0;
+    }
+    getLabel() {
+      return this._label;
+    }
+    getCode() {
+      return this._code;
+    }
+    equals(o) {
+      return !!o && (this._code === o._code || this._code === o.code);
+    }
+    get [Symbol.toStringTag]() {
+      return "[FormulaError]";
+    }
+    toString() {
+      return this.message || this._label;
+    }
+  }
+  e.Known = t;
+  class c extends t {
+    constructor(o, s) {
+      super(e.Code.Parse, e.Label.Parse, o, s);
+    }
+    static {
+      this.code = e.Code.Parse;
+    }
+    getDetails() {
+      const o = this.details;
+      return { line: o?.line ?? 1, column: o?.column ?? 1, offset: o?.offset ?? 0, length: o?.length ?? 0 };
+    }
+  }
+  e.Parse = c;
+  class u extends t {
+    constructor(o, s) {
+      super(e.Code.Null, e.Label.Null, o, s);
+    }
+    static {
+      this.code = e.Code.Null;
+    }
+  }
+  e.Null = u;
+  class i extends t {
+    constructor(o, s) {
+      super(e.Code.Div0, e.Label.Div0, o, s);
+    }
+    static {
+      this.code = e.Code.Div0;
+    }
+  }
+  e.Div0 = i;
+  class d extends t {
+    constructor(o, s) {
+      super(e.Code.Value, e.Label.Value, o, s);
+    }
+    static {
+      this.code = e.Code.Value;
+    }
+  }
+  e.Value = d;
+  class L extends t {
+    constructor(o, s) {
+      super(e.Code.Ref, e.Label.Ref, o, s);
+    }
+    static {
+      this.code = e.Code.Ref;
+    }
+  }
+  e.Ref = L;
+  class y extends t {
+    constructor(o, s) {
+      super(e.Code.Name, e.Label.Name, o, s);
+    }
+    static {
+      this.code = e.Code.Name;
+    }
+  }
+  e.Name = y;
+  class S extends t {
+    constructor(o, s) {
+      super(e.Code.Num, e.Label.Num, o, s);
+    }
+    static {
+      this.code = e.Code.Num;
+    }
+  }
+  e.Num = S;
+  class x extends t {
+    constructor(o, s) {
+      super(e.Code.NA, e.Label.NA, o, s);
+    }
+    static {
+      this.code = e.Code.NA;
+    }
+  }
+  e.NA = x;
+  class B extends t {
+    constructor(o, s) {
+      super(e.Code.GettingData, e.Label.GettingData, o, s);
+    }
+    static {
+      this.code = e.Code.GettingData;
+    }
+  }
+  e.GettingData = B;
+  class f extends t {
+    constructor(o, s) {
+      super(e.Code.Spill, e.Label.Spill, o, s);
+    }
+    static {
+      this.code = e.Code.Spill;
+    }
+  }
+  e.Spill = f;
+  class k extends t {
+    constructor(o, s) {
+      super(e.Code.Connect, e.Label.Connect, o, s);
+    }
+    static {
+      this.code = e.Code.Connect;
+    }
+  }
+  e.Connect = k;
+  class A extends t {
+    constructor(o, s) {
+      super(e.Code.Blocked, e.Label.Blocked, o, s);
+    }
+    static {
+      this.code = e.Code.Blocked;
+    }
+  }
+  e.Blocked = A;
+  class F extends t {
+    constructor(o, s) {
+      super(e.Code.Unknown, e.Label.Unknown, o, s);
+    }
+    static {
+      this.code = e.Code.Unknown;
+    }
+  }
+  e.Unknown = F;
+  class P extends t {
+    constructor(o, s) {
+      super(e.Code.Field, e.Label.Field, o, s);
+    }
+    static {
+      this.code = e.Code.Field;
+    }
+  }
+  e.Field = P;
+  class T extends t {
+    constructor(o, s) {
+      super(e.Code.Calc, e.Label.Calc, o, s);
+    }
+    static {
+      this.code = e.Code.Calc;
+    }
+  }
+  e.Calc = T;
+  class U extends t {
+    constructor(o, s) {
+      super(e.Code.Busy, e.Label.Busy, o, s);
+    }
+    static {
+      this.code = e.Code.Busy;
+    }
+  }
+  e.Busy = U;
+  class E extends t {
+    constructor(o, s) {
+      super(e.Code.Python, e.Label.Python, o, s);
+    }
+    static {
+      this.code = e.Code.Python;
+    }
+  }
+  e.Python = E;
+  class R extends t {
+    constructor(o, s) {
+      super(e.Code.Timeout, e.Label.Timeout, o, s);
+    }
+    static {
+      this.code = e.Code.Timeout;
+    }
+  }
+  e.Timeout = R;
+})(n || (n = {}));
+const a = {};
+a[n.Code.Parse] = n.Parse, a[n.Code.Null] = n.Null, a[n.Code.Div0] = n.Div0, a[n.Code.Value] = n.Value, a[n.Code.Ref] = n.Ref, a[n.Code.Name] = n.Name, a[n.Code.Num] = n.Num, a[n.Code.NA] = n.NA, a[n.Code.GettingData] = n.GettingData, a[n.Code.Spill] = n.Spill, a[n.Code.Connect] = n.Connect, a[n.Code.Blocked] = n.Blocked, a[n.Code.Unknown] = n.Unknown, a[n.Code.Field] = n.Field, a[n.Code.Calc] = n.Calc, a[n.Code.Busy] = n.Busy, a[n.Code.Python] = n.Python, a[n.Code.Timeout] = n.Timeout;
+const h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map(), D = /* @__PURE__ */ new Map(), N = Object.keys(a);
+for (let e = 0; e < N.length; e++) {
+  const t = N[e], c = a[t];
+  p.set(n.Label[t], c), D.set(n.Code[t], c);
+  const u = new c();
+  h.set(u.getLabel(), u), g.set(u.getCode(), u);
+}
+const V = g.get(n.Code.Unknown);
+var r;
+(r = n || (n = {})).BuiltIn = { Parse: new r.Parse(), Null: new r.Null(), Div0: new r.Div0(), Value: new r.Value(), Ref: new r.Ref(), Name: new r.Name(), Num: new r.Num(), NA: new r.NA(), GettingData: new r.GettingData(), Spill: new r.Spill(), Connect: new r.Connect(), Blocked: new r.Blocked(), Unknown: new r.Unknown(), Field: new r.Field(), Calc: new r.Calc(), Busy: new r.Busy(), Python: new r.Python(), Timeout: new r.Timeout() }, r.getBuiltInByLabel = (e) => h.get(e), r.newTypedError = (e, t, c) => {
+  let u;
+  return u = typeof e == "string" ? p.get(e) : D.get(e), u || (u = r.Unknown), new u(t, c);
+}, r.getBuiltInById = (e) => g.get(e) || V;
+class j {
+  constructor(t) {
+    this._subscribeFn = t;
+  }
+  subscribe(t, c, u) {
+    const i = typeof t == "object" ? { next: t.next || (() => {
+    }), error: t.error || (() => {
+    }), complete: t.complete || (() => {
+    }), unsubscribe: () => {
+    } } : { next: t || (() => {
+    }), error: c || (() => {
+    }), complete: u || (() => {
+    }), unsubscribe: () => {
+    } }, d = this._subscribeFn(i);
+    return i.unsubscribe = () => {
+      typeof d == "function" && d();
+    }, i;
+  }
+}
+class I {
+  getRange(t) {
+    throw new m();
+  }
+  getReference(t, c) {
+    throw new m();
+  }
+  getNumberFormat(t, c) {
+    return c?.toString() ?? "";
+  }
+  fromOADate(t) {
+    return new Date(t);
+  }
+  toOADate(t) {
+    return t.getTime();
+  }
+  getValueAt(t, c) {
+    return null;
+  }
+  getEntireCoords() {
+    return G;
+  }
+  isValidDate(t) {
+    return (t instanceof Date || Object.prototype.toString.call(t) === "[object Date]") && !isNaN(t.getTime());
+  }
+  getPosition() {
+    return v;
+  }
+  getFormulaAt(t, c) {
+    return null;
+  }
+  getSpillAt(t, c) {
+    return null;
+  }
+  getSheetIndex(t) {
+    return -1;
+  }
+  getSheetCount() {
+    return 1;
+  }
+  markVolatile() {
+  }
+  formatResults(t) {
+  }
+  getFunction(t) {
+    return null;
+  }
+  getAddress(t, c) {
+    throw new m();
+  }
+  parseAsDateTime(t, c) {
+    throw new m();
+  }
+  getRuntime() {
+    return _;
+  }
+}
+class m extends Error {
+  constructor(t = "Not implemented in StubbedFormulaContext") {
+    super(t), this.name = "NotImplementedError";
+  }
+}
+const v = Object.freeze({ colIndex: 0, rowIndex: 0 }), G = Object.freeze({ colStart: 0, rowStart: 0, colEnd: Math.pow(2, 14) - 1, rowEnd: Math.pow(2, 20) - 1 }), _ = { getCurrencySymbol: () => "$", getNumberDecimalSeparator: () => ".", getNumberGroupSeparator: () => ",", isDate1904: () => !1, getLocation: () => "unknown", getVersion: () => "1.0.0", getOS: () => "unknown", getUser: () => "unidentified", getDescription: () => "Stubbed Formula Context" }, z = new I();
+export {
+  z as FormulaContext,
+  n as FormulaError,
+  w as IRange,
+  j as Observable,
+  M as ScalarType,
+  I as StubbedFormulaContext
+};

package/build/licenses/dependencies.txt

@@ -0,0 +1 @@
+No third parties dependencies

package/build/node/esm/index.mjs

@@ -0,0 +1,309 @@
+/**
+ * @license @sheetxl/primitives - Primitive - Base types for SheetXL functions. - v0.0.0
+ *
+ * (C) 2025-present SheetXL Inc. & Michael T. Ford
+ * License: The license can be found at https://www.sheetxl.com/license.
+ */
+const e = { Number: "n", String: "s", Boolean: "b", Error: "e", RichData: "r", Null: "z" };
+var t, o, n;
+(o = t || (t = {})).Orientation = { Column: "column", Row: "row" }, o.Orientations = { ...o.Orientation, Both: "both" }, o.Direction = { Up: "up", Down: "down", Left: "left", Right: "right" }, ((e2) => {
+  e2.Code = { Parse: 0, Null: 1, Div0: 2, Value: 3, Ref: 4, Name: 5, Num: 6, NA: 7, GettingData: 8, Spill: 9, Connect: 10, Blocked: 11, Unknown: 12, Field: 13, Calc: 14, Busy: 16, Python: 19, Timeout: 20 }, e2.Label = { Parse: "#PARSE!", Null: "#NULL!", Div0: "#DIV/0!", Value: "#VALUE!", Ref: "#REF!", Name: "#NAME?", Num: "#NUM!", NA: "#N/A", GettingData: "#GETTING_DATA", Spill: "#SPILL!", Connect: "#CONNECT!", Blocked: "#BLOCKED!", Unknown: "#UNKNOWN!", Field: "#FIELD!", Calc: "#CALC!", Busy: "#BUSY!", Python: "#PYTHON!", Timeout: "#TIMEOUT!" };
+  class t2 extends Error {
+    constructor(e3, t3, o3, n3) {
+      super(o3, n3), this._label = t3, this._code = e3, this.details = n3;
+    }
+    static {
+      this.code = e2.Code.Unknown;
+    }
+    get isFormulaError() {
+      return true;
+    }
+    getLabel() {
+      return this._label;
+    }
+    getCode() {
+      return this._code;
+    }
+    equals(e3) {
+      return !!e3 && (this._code === e3._code || this._code === e3.code);
+    }
+    get [Symbol.toStringTag]() {
+      return "[FormulaError]";
+    }
+    toString() {
+      return this.message || this._label;
+    }
+  }
+  e2.Known = t2;
+  class o2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Parse, e2.Label.Parse, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Parse;
+    }
+    getDetails() {
+      const e3 = this.details;
+      return { line: e3?.line ?? 1, column: e3?.column ?? 1, offset: e3?.offset ?? 0, length: e3?.length ?? 0 };
+    }
+  }
+  e2.Parse = o2;
+  class n2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Null, e2.Label.Null, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Null;
+    }
+  }
+  e2.Null = n2;
+  class s2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Div0, e2.Label.Div0, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Div0;
+    }
+  }
+  e2.Div0 = s2;
+  class r2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Value, e2.Label.Value, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Value;
+    }
+  }
+  e2.Value = r2;
+  class l2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Ref, e2.Label.Ref, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Ref;
+    }
+  }
+  e2.Ref = l2;
+  class a2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Name, e2.Label.Name, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Name;
+    }
+  }
+  e2.Name = a2;
+  class c2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Num, e2.Label.Num, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Num;
+    }
+  }
+  e2.Num = c2;
+  class i2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.NA, e2.Label.NA, t3, o3);
+    }
+    static {
+      this.code = e2.Code.NA;
+    }
+  }
+  e2.NA = i2;
+  class u2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.GettingData, e2.Label.GettingData, t3, o3);
+    }
+    static {
+      this.code = e2.Code.GettingData;
+    }
+  }
+  e2.GettingData = u2;
+  class d2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Spill, e2.Label.Spill, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Spill;
+    }
+  }
+  e2.Spill = d2;
+  class C2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Connect, e2.Label.Connect, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Connect;
+    }
+  }
+  e2.Connect = C2;
+  class m2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Blocked, e2.Label.Blocked, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Blocked;
+    }
+  }
+  e2.Blocked = m2;
+  class g2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Unknown, e2.Label.Unknown, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Unknown;
+    }
+  }
+  e2.Unknown = g2;
+  class w2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Field, e2.Label.Field, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Field;
+    }
+  }
+  e2.Field = w2;
+  class N2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Calc, e2.Label.Calc, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Calc;
+    }
+  }
+  e2.Calc = N2;
+  class h2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Busy, e2.Label.Busy, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Busy;
+    }
+  }
+  e2.Busy = h2;
+  class b2 extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Python, e2.Label.Python, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Python;
+    }
+  }
+  e2.Python = b2;
+  class p extends t2 {
+    constructor(t3, o3) {
+      super(e2.Code.Timeout, e2.Label.Timeout, t3, o3);
+    }
+    static {
+      this.code = e2.Code.Timeout;
+    }
+  }
+  e2.Timeout = p;
+})(n || (n = {}));
+const s = {};
+s[n.Code.Parse] = n.Parse, s[n.Code.Null] = n.Null, s[n.Code.Div0] = n.Div0, s[n.Code.Value] = n.Value, s[n.Code.Ref] = n.Ref, s[n.Code.Name] = n.Name, s[n.Code.Num] = n.Num, s[n.Code.NA] = n.NA, s[n.Code.GettingData] = n.GettingData, s[n.Code.Spill] = n.Spill, s[n.Code.Connect] = n.Connect, s[n.Code.Blocked] = n.Blocked, s[n.Code.Unknown] = n.Unknown, s[n.Code.Field] = n.Field, s[n.Code.Calc] = n.Calc, s[n.Code.Busy] = n.Busy, s[n.Code.Python] = n.Python, s[n.Code.Timeout] = n.Timeout;
+const r = /* @__PURE__ */ new Map(), l = /* @__PURE__ */ new Map(), a = /* @__PURE__ */ new Map(), c = /* @__PURE__ */ new Map(), i = Object.keys(s);
+for (let e2 = 0; e2 < i.length; e2++) {
+  const t2 = i[e2], o2 = s[t2];
+  a.set(n.Label[t2], o2), c.set(n.Code[t2], o2);
+  const u2 = new o2();
+  r.set(u2.getLabel(), u2), l.set(u2.getCode(), u2);
+}
+const u = l.get(n.Code.Unknown);
+var d;
+(d = n || (n = {})).BuiltIn = { Parse: new d.Parse(), Null: new d.Null(), Div0: new d.Div0(), Value: new d.Value(), Ref: new d.Ref(), Name: new d.Name(), Num: new d.Num(), NA: new d.NA(), GettingData: new d.GettingData(), Spill: new d.Spill(), Connect: new d.Connect(), Blocked: new d.Blocked(), Unknown: new d.Unknown(), Field: new d.Field(), Calc: new d.Calc(), Busy: new d.Busy(), Python: new d.Python(), Timeout: new d.Timeout() }, d.getBuiltInByLabel = (e2) => r.get(e2), d.newTypedError = (e2, t2, o2) => {
+  let n2;
+  return n2 = "string" == typeof e2 ? a.get(e2) : c.get(e2), n2 || (n2 = d.Unknown), new n2(t2, o2);
+}, d.getBuiltInById = (e2) => l.get(e2) || u;
+class C {
+  constructor(e2) {
+    this._subscribeFn = e2;
+  }
+  subscribe(e2, t2, o2) {
+    const n2 = "object" == typeof e2 ? { next: e2.next || (() => {
+    }), error: e2.error || (() => {
+    }), complete: e2.complete || (() => {
+    }), unsubscribe: () => {
+    } } : { next: e2 || (() => {
+    }), error: t2 || (() => {
+    }), complete: o2 || (() => {
+    }), unsubscribe: () => {
+    } }, s2 = this._subscribeFn(n2);
+    return n2.unsubscribe = () => {
+      "function" == typeof s2 && s2();
+    }, n2;
+  }
+}
+class m {
+  getRange(e2) {
+    throw new g();
+  }
+  getReference(e2, t2) {
+    throw new g();
+  }
+  getNumberFormat(e2, t2) {
+    return t2?.toString() ?? "";
+  }
+  fromOADate(e2) {
+    return new Date(e2);
+  }
+  toOADate(e2) {
+    return e2.getTime();
+  }
+  getValueAt(e2, t2) {
+    return null;
+  }
+  getEntireCoords() {
+    return N;
+  }
+  isValidDate(e2) {
+    return (e2 instanceof Date || "[object Date]" === Object.prototype.toString.call(e2)) && !isNaN(e2.getTime());
+  }
+  getPosition() {
+    return w;
+  }
+  getFormulaAt(e2, t2) {
+    return null;
+  }
+  getSpillAt(e2, t2) {
+    return null;
+  }
+  getSheetIndex(e2) {
+    return -1;
+  }
+  getSheetCount() {
+    return 1;
+  }
+  markVolatile() {
+  }
+  formatResults(e2) {
+  }
+  getFunction(e2) {
+    return null;
+  }
+  getAddress(e2, t2) {
+    throw new g();
+  }
+  parseAsDateTime(e2, t2) {
+    throw new g();
+  }
+  getRuntime() {
+    return h;
+  }
+}
+class g extends Error {
+  constructor(e2 = "Not implemented in StubbedFormulaContext") {
+    super(e2), this.name = "NotImplementedError";
+  }
+}
+const w = Object.freeze({ colIndex: 0, rowIndex: 0 }), N = Object.freeze({ colStart: 0, rowStart: 0, colEnd: Math.pow(2, 14) - 1, rowEnd: Math.pow(2, 20) - 1 }), h = { getCurrencySymbol: () => "$", getNumberDecimalSeparator: () => ".", getNumberGroupSeparator: () => ",", isDate1904: () => false, getLocation: () => "unknown", getVersion: () => "1.0.0", getOS: () => "unknown", getUser: () => "unidentified", getDescription: () => "Stubbed Formula Context" }, b = new m();
+export {
+  b as FormulaContext,
+  n as FormulaError,
+  t as IRange,
+  C as Observable,
+  e as ScalarType,
+  m as StubbedFormulaContext
+};

package/build/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@sheetxl/primitives",
+  "description": "Primitive - Base types for SheetXL functions.",
+  "version": "0.0.0",
+  "license": "SEE LICENSE IN <LICENSE>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "browser": "./browser/esm/index.mjs",
+      "node": "./node/esm/index.mjs",
+      "import": "./browser/esm/index.mjs",
+      "require": "./browser/cjs/index.cjs"
+    }
+  },
+  "types": "./types/index.d.ts",
+  "module": "./browser/esm/index.mjs",
+  "main": "./browser/cjs/index.cjs",
+  "publishConfig": {
+    "access": "public"
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "engineStrict": true,
+  "author": "Michael T Ford",
+  "keywords": [
+    "sheetxl",
+    "spreadsheet",
+    "data-science",
+    "vector-api",
+    "formulas",
+    "primitives"
+  ],
+  "dependencies": {},
+  "peerDependencies": {},
+  "devDependencies": {}
+}