@sheetxl/primitives 0.7.28-beta.4 → 0.8.0-beta.1

package/browser/cjs/index.cjs

@@ -1 +1 @@
-var e;Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),function(e){e.MAX_TEXT_LENGTH=32767;let t=e.MAX_SIGNIFICANT_DIGITS=15;e.truncateNumberText=function(e){let n=e.length;if(n<=t)return e;let r=0,i=null;for(let a=0;a<n;a++){let n=e.charCodeAt(a);if(n>=48&&n<=57){if(r===0&&n===48)continue;r++,r>t&&((i??=e.split(``))[a]=`0`)}else if((n===69||n===101)&&r>0)break}return i===null?e:i.join(``)}}(e||={});var t,n,r,i,a={Number:`number`,String:`string`,Boolean:`boolean`,Error:`error`,RichData:`richData`,Null:`null`},o={...a,Date:`date`},s=/[.*+?^${}()|[\]\\]/,c=e=>s.test(e)?`\\`+e:e,l={isWildCard:e=>typeof e==`string`&&/[*?]/.test(e),toRegex:(e,t,n=!1)=>{let r=``,i=e.length;for(let t=0;t<i;t++){let n=e[t];if(n===`~`){let n=e[t+1];n===`*`||n===`?`||n===`~`?(r+=c(n),t++):r+=`~`;continue}n===`*`?r+=`.*`:r+=n===`?`?`.`:c(n)}return RegExp(n?`^${r}$`:r,t)}};(n=t||={}).Axis={Column:`column`,Row:`row`},n.AxisSelection={...t.Axis,Both:`both`},n.Direction={Up:`up`,Down:`down`,Left:`left`,Right:`right`},(r||={}).Aggregate={Count:`count`,NumericalCount:`numericalCount`,Sum:`sum`,Average:`average`,StdDev:`stdDev`,PopulationStdDev:`stdDevP`,Variance:`var`,PopulationVariance:`varP`,Min:`min`,Max:`max`},function(e){let t=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},n=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(e,t,n,r){super(n,r),this._label=t,this._code=e,this.details=r}static{this.code=i.Code.Unknown}get isFormulaError(){return!0}getLabel(){return this._label}getCode(){return this._code}equals(e){return!!e&&(this._code===e._code||this._code===e.code)}get[Symbol.toStringTag](){return`[FormulaError]`}toString(){return this._label}}e.Known=r;class a extends r{constructor(e,r){super(t.Parse,n.Parse,e,r)}static{this.code=i.Code.Parse}getDetails(){let e=this.details;return{line:e?.line??1,column:e?.column??1,offset:e?.offset??0,length:e?.length??0}}}e.Parse=a;class o extends r{constructor(e,r){super(t.Null,n.Null,e,r)}static{this.code=i.Code.Null}}e.Null=o;class s extends r{constructor(e,r){super(t.Div0,n.Div0,e,r)}static{this.code=i.Code.Div0}}e.Div0=s;class c extends r{constructor(e,r){super(t.Value,n.Value,e,r)}static{this.code=i.Code.Value}}e.Value=c;class l extends r{constructor(e,r){super(t.Ref,n.Ref,e,r)}static{this.code=i.Code.Ref}}e.Ref=l;class u extends r{constructor(e,r){super(t.Name,n.Name,e,r)}static{this.code=i.Code.Name}}e.Name=u;class d extends r{constructor(e,r){super(t.Num,n.Num,e,r)}static{this.code=i.Code.Num}}e.Num=d;class f extends r{constructor(e,r){super(t.NA,n.NA,e,r)}static{this.code=i.Code.NA}}e.NA=f;class p extends r{constructor(e,r){super(t.GettingData,n.GettingData,e,r)}static{this.code=i.Code.GettingData}}e.GettingData=p;class m extends r{constructor(e,r){super(t.Spill,n.Spill,e,r)}static{this.code=i.Code.Spill}}e.Spill=m;class h extends r{constructor(e,r){super(t.Connect,n.Connect,e,r)}static{this.code=i.Code.Connect}}e.Connect=h;class g extends r{constructor(e,r){super(t.Blocked,n.Blocked,e,r)}static{this.code=i.Code.Blocked}}e.Blocked=g;class _ extends r{constructor(e,r){super(t.Unknown,n.Unknown,e,r)}static{this.code=i.Code.Unknown}}e.Unknown=_;class v extends r{constructor(e,r){super(t.Field,n.Field,e,r)}static{this.code=i.Code.Field}}e.Field=v;class y extends r{constructor(e,r){super(t.Calc,n.Calc,e,r)}static{this.code=i.Code.Calc}}e.Calc=y;class b extends r{constructor(e,r){super(t.Busy,n.Busy,e,r)}static{this.code=i.Code.Busy}}e.Busy=b;class x extends r{constructor(e,r){super(t.Python,n.Python,e,r)}static{this.code=i.Code.Python}}e.Python=x;class S extends r{constructor(e,r){super(t.Timeout,n.Timeout,e,r)}static{this.code=i.Code.Timeout}}e.Timeout=S}(i||={});var u={};u[i.Code.Parse]=i.Parse,u[i.Code.Null]=i.Null,u[i.Code.Div0]=i.Div0,u[i.Code.Value]=i.Value,u[i.Code.Ref]=i.Ref,u[i.Code.Name]=i.Name,u[i.Code.Num]=i.Num,u[i.Code.NA]=i.NA,u[i.Code.GettingData]=i.GettingData,u[i.Code.Spill]=i.Spill,u[i.Code.Connect]=i.Connect,u[i.Code.Blocked]=i.Blocked,u[i.Code.Unknown]=i.Unknown,u[i.Code.Field]=i.Field,u[i.Code.Calc]=i.Calc,u[i.Code.Busy]=i.Busy,u[i.Code.Python]=i.Python,u[i.Code.Timeout]=i.Timeout;var d=new Map,f=new Map,p=new Map,m=new Map,h=Object.keys(u);for(let e=0;e<h.length;e++){let t=u[h[e]],n=new t;p.set(n.getLabel(),t),m.set(n.getCode(),t),d.set(n.getLabel(),n),f.set(n.getCode(),n)}(function(e){let t=e.getBuiltInByCode=e=>f.get(e);e.BuiltIn={Parse:t(i.Code.Parse),Null:t(i.Code.Null),Div0:t(i.Code.Div0),Value:t(i.Code.Value),Ref:t(i.Code.Ref),Name:t(i.Code.Name),Num:t(i.Code.Num),NA:t(i.Code.NA),GettingData:t(i.Code.GettingData),Spill:t(i.Code.Spill),Connect:t(i.Code.Connect),Blocked:t(i.Code.Blocked),Unknown:t(i.Code.Unknown),Field:t(i.Code.Field),Calc:t(i.Code.Calc),Busy:t(i.Code.Busy),Python:t(i.Code.Python),Timeout:t(i.Code.Timeout)},e.newTypedError=(e,t,n)=>{let r;return r=typeof e==`string`?p.get(e):m.get(e),r||=i.Unknown,new r(t,n)},e.getBuiltInByLabel=e=>d.get(e),e.isError=function(e,t){return!!e&&!0===e.isFormulaError&&(t===void 0||e.getCode()===t)}})(i||={});var g=class{createRange(e,t,n){throw new v}getReference(e,t){throw new v}getResizedReference(e,t,n){throw new v}getNumberFormat(e,t){throw new v}fromSerialDate(e,t){throw new v}toSerialDate(e,t){throw new v}getDateParts(e,t){throw new v}getSerialDate(e,t,n,r,i,a,o){throw new v}getNow(){throw new v}getValueAt(e,t,n,r){return null}getEntireCoords(){return y}isValidDate(e,t){return e instanceof Date||Object.prototype.toString.call(e)===`[object Date]`?!isNaN(e.getTime()):!t&&typeof e==`number`&&!(e<0||e>x)}getRow(){return 0}getColumn(){return 0}getFormulaAt(e,t,n){return null}getSpillAt(e,t,n){return null}getSheetIndex(e){return-1}getSheetCount(){return 1}markVolatile(){}formatResults(e){}filterHidden(e,t){return e}filterTotals(e){return e}getFunction(e){return null}getAddress(e,t){throw new v}parseAsSerialDate(e,t){throw new v}parseAsDate(e,t){throw new v}parseAsNumber(e,t){throw new v}createCriteria(e){throw new v}parseAsLiteral(e){let t=e.toUpperCase();return t===`TRUE`||t!==`FALSE`&&i.getBuiltInByLabel(t)}toText(e){return typeof e==`string`?e:e==null?``:typeof e==`boolean`?e?`TRUE`:`FALSE`:e?.isFormulaError?e.getLabel():String(e)}compare(e,t,n){if(e===t)return 0;let r=_(e),i=_(t);return r===i?e<t?-1:+(e>t):r<i?-1:1}getRuntime(){return b}},_=e=>{if(e==null)return 0;switch(typeof e){case`number`:return 1;case`string`:return 2;case`boolean`:return 3;default:return 4}},v=class extends Error{constructor(e=`Not implemented in StubbedFormulaContext`){super(e),this.name=`NotImplementedError`}},y=Object.freeze({colStart:0,rowStart:0,colEnd:2**14-1,rowEnd:2**20-1}),b={isDate1904:()=>!1,getLocale:()=>w.tag,getLocaleProfile:()=>w,isR1C1:()=>!1,getNow:()=>0,getLocation:()=>`unknown`,getVersion:()=>`1.0.0`,getOS:()=>`unknown`,getUser:()=>`unidentified`,getDescription:()=>`Stubbed Formula Context`},x=2958465,S=new g,C=class{constructor(){this._scope=S}_setScope(e){this._scope=e??S}_getScope(){return this._scope}getNumberFormat(e,t){return this._getScope().getNumberFormat(e,t)}getEntireCoords(){return this._getScope().getEntireCoords()??y}parseAsSerialDate(e,t){return this._getScope().parseAsSerialDate(e,t)}parseAsDate(e,t){return this._getScope().parseAsDate(e,t)}parseAsNumber(e,t){return this._getScope().parseAsNumber(e,t)}createCriteria(e){return this._getScope().createCriteria(e)}parseAsLiteral(e){let t=this._getScope();return t.parseAsLiteral?t.parseAsLiteral(e):S.parseAsLiteral(e)}toText(e){return this._getScope().toText(e)}isValidDate(e,t=!1){return this._getScope().isValidDate(e,t)}fromSerialDate(e,t=!1){return this._getScope().fromSerialDate(e,t)}toSerialDate(e,t=!1){return this._getScope().toSerialDate(e,t)}getDateParts(e,t){return this._getScope().getDateParts(e,t)}getSerialDate(e,t,n,r=0,i=0,a=0,o=0){return this._getScope().getSerialDate(e,t,n,r,i,a,o)}getNow(){return this._getScope().getNow()}createRange(e,t,n){return this._getScope().createRange(e,t,n)}getRow(){return this._getScope().getRow?.()??0}getColumn(){return this._getScope().getColumn?.()??0}getReference(e,t){return this._getScope().getReference(e,t)}getResizedReference(e,t,n){return this._getScope().getResizedReference(e,t,n)}getValueAt(e,t,n){return this._getScope().getValueAt(e,t,n)}getFormulaAt(e,t,n){return this._getScope().getFormulaAt?.(e,t,n)??null}getSpillAt(e,t,n){return this._getScope().getSpillAt?.(e,t,n)??null}getSheetIndex(e){return this._getScope().getSheetIndex?.(e)??-1}getSheetCount(){return this._getScope().getSheetCount?.()??1}markVolatile(){this._getScope().markVolatile?.()}formatResults(e){this._getScope().formatResults?.(e)}filterHidden(e,t){return this._getScope().filterHidden?.(e,t)??e}filterTotals(e){return this._getScope().filterTotals?.(e)??e}getFunction(e){return this._getScope().getFunction?.(e)??null}getAddress(e,t){return this._getScope().getAddress(e,t)}compare(e,t,n){return this._getScope().compare?.(e,t,n)??S.compare(e,t,n)}getRuntime(){return this._getScope().getRuntime()}get[Symbol.toStringTag](){return`[FormulaContext]`}toString(){return this._getScope()?.toString?.()??`{STUB SCOPE}`}},w=Object.freeze({tag:`en-US`,numberingSystem:`latn`,decimal:`.`,group:`,`,grouping:[3],minusSign:`-`,percentSign:`%`,permilleSign:`‰`,currencyCode:`USD`,currencySymbol:`$`,currencyDisplay:`symbol`,currencyPosition:`before`,currencySpacing:`tight`,date:Object.freeze({calendar:`gregory`,short:`M/d/yy`,medium:`MMM d, y`,long:`MMMM d, y`,timeShort:`h:mm a`,timeLong:`h:mm:ss a`,am:`AM`,pm:`PM`,firstDay:0,weekend:[6,0],monthsWide:[`January`,`February`,`March`,`April`,`May`,`June`,`July`,`August`,`September`,`October`,`November`,`December`],monthsAbbr:[`Jan`,`Feb`,`Mar`,`Apr`,`May`,`Jun`,`Jul`,`Aug`,`Sep`,`Oct`,`Nov`,`Dec`],weekdaysWide:[`Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`],weekdaysAbbr:[`Sun`,`Mon`,`Tue`,`Wed`,`Thu`,`Fri`,`Sat`],hour12:!0}),listSeparator:`,`,csvDelimiter:`,`,rtl:!1,collator:Object.freeze({sensitivity:`base`,numeric:!0})}),T=new C;exports.DEFAULT_LOCALE_PROFILE=w,exports.FormulaContext=T,Object.defineProperty(exports,"FormulaError",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"IRange",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"IRangeStats",{enumerable:!0,get:function(){return r}}),exports.InteropScalarType=o,exports.Observable=class{constructor(e){this._subscribeFn=e}subscribe(e,t,n){let r=typeof e==`object`?{next:e.next||(()=>{}),error:e.error||(()=>{}),complete:e.complete||(()=>{}),unsubscribe:()=>{}}:{next:e||(()=>{}),error:t||(()=>{}),complete:n||(()=>{}),unsubscribe:()=>{}},i=this._subscribeFn(r);return r.unsubscribe=()=>{typeof i==`function`&&i()},r}},Object.defineProperty(exports,"Scalar",{enumerable:!0,get:function(){return e}}),exports.ScalarType=a,exports.ScopedFormulaContext=C,exports.StubbedFormulaContext=g,exports.WildCard=l;
+var e;Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),function(e){e.MAX_TEXT_LENGTH=32767;let t=e.MAX_SIGNIFICANT_DIGITS=15;e.truncateNumberText=function(e){let n=e.length;if(n<=t)return e;let r=0,i=null;for(let a=0;a<n;a++){let n=e.charCodeAt(a);if(n>=48&&n<=57){if(r===0&&n===48)continue;r++,r>t&&((i??=e.split(``))[a]=`0`)}else if((n===69||n===101)&&r>0)break}return i===null?e:i.join(``)}}(e||={});var t,n,r,i,a={Number:`number`,String:`string`,Boolean:`boolean`,Error:`error`,RichData:`richData`,Null:`null`},o={...a,Date:`date`},s=/[.*+?^${}()|[\]\\]/,c=e=>s.test(e)?`\\`+e:e,l={isWildCard:e=>typeof e==`string`&&/[*?]/.test(e),toRegex:(e,t,n=!1)=>{let r=``,i=e.length;for(let t=0;t<i;t++){let n=e[t];if(n===`~`){let n=e[t+1];n===`*`||n===`?`||n===`~`?(r+=c(n),t++):r+=`~`;continue}n===`*`?r+=`.*`:r+=n===`?`?`.`:c(n)}return RegExp(n?`^${r}$`:r,t)}},u={noReferenceLift:`A multi-cell reference at a non-repeating scalar parameter is #VALUE! rather than a broadcast.`,noMemberFilter:`Members of a repeating scalar parameter are coerced rather than filtered; one that cannot be is #VALUE!.`},d={atp:[`noReferenceLift`,`noMemberFilter`]};function f(e){if(!e)return null;let t=e.trim().toLowerCase();for(let e of Object.keys(u))if(e.toLowerCase()===t)return e;return null}(n=t||={}).Axis={Column:`column`,Row:`row`},n.AxisSelection={...t.Axis,Both:`both`},n.Direction={Up:`up`,Down:`down`,Left:`left`,Right:`right`},(r||={}).Aggregate={Count:`count`,NumericalCount:`numericalCount`,Sum:`sum`,Average:`average`,StdDev:`stdDev`,PopulationStdDev:`stdDevP`,Variance:`var`,PopulationVariance:`varP`,Min:`min`,Max:`max`},function(e){let t=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},n=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(e,t,n,r){super(n,r),this._label=t,this._code=e,this.details=r}static{this.code=i.Code.Unknown}get isFormulaError(){return!0}getLabel(){return this._label}getCode(){return this._code}equals(e){return!!e&&(this._code===e._code||this._code===e.code)}get[Symbol.toStringTag](){return`[FormulaError]`}toString(){return this._label}}e.Known=r;class a extends r{constructor(e,r){super(t.Parse,n.Parse,e,r)}static{this.code=i.Code.Parse}getDetails(){let e=this.details;return{line:e?.line??1,column:e?.column??1,offset:e?.offset??0,length:e?.length??0}}}e.Parse=a;class o extends r{constructor(e,r){super(t.Null,n.Null,e,r)}static{this.code=i.Code.Null}}e.Null=o;class s extends r{constructor(e,r){super(t.Div0,n.Div0,e,r)}static{this.code=i.Code.Div0}}e.Div0=s;class c extends r{constructor(e,r){super(t.Value,n.Value,e,r)}static{this.code=i.Code.Value}}e.Value=c;class l extends r{constructor(e,r){super(t.Ref,n.Ref,e,r)}static{this.code=i.Code.Ref}}e.Ref=l;class u extends r{constructor(e,r){super(t.Name,n.Name,e,r)}static{this.code=i.Code.Name}}e.Name=u;class d extends r{constructor(e,r){super(t.Num,n.Num,e,r)}static{this.code=i.Code.Num}}e.Num=d;class f extends r{constructor(e,r){super(t.NA,n.NA,e,r)}static{this.code=i.Code.NA}}e.NA=f;class p extends r{constructor(e,r){super(t.GettingData,n.GettingData,e,r)}static{this.code=i.Code.GettingData}}e.GettingData=p;class m extends r{constructor(e,r){super(t.Spill,n.Spill,e,r)}static{this.code=i.Code.Spill}}e.Spill=m;class h extends r{constructor(e,r){super(t.Connect,n.Connect,e,r)}static{this.code=i.Code.Connect}}e.Connect=h;class g extends r{constructor(e,r){super(t.Blocked,n.Blocked,e,r)}static{this.code=i.Code.Blocked}}e.Blocked=g;class _ extends r{constructor(e,r){super(t.Unknown,n.Unknown,e,r)}static{this.code=i.Code.Unknown}}e.Unknown=_;class v extends r{constructor(e,r){super(t.Field,n.Field,e,r)}static{this.code=i.Code.Field}}e.Field=v;class y extends r{constructor(e,r){super(t.Calc,n.Calc,e,r)}static{this.code=i.Code.Calc}}e.Calc=y;class b extends r{constructor(e,r){super(t.Busy,n.Busy,e,r)}static{this.code=i.Code.Busy}}e.Busy=b;class x extends r{constructor(e,r){super(t.Python,n.Python,e,r)}static{this.code=i.Code.Python}}e.Python=x;class S extends r{constructor(e,r){super(t.Timeout,n.Timeout,e,r)}static{this.code=i.Code.Timeout}}e.Timeout=S}(i||={});var p={};p[i.Code.Parse]=i.Parse,p[i.Code.Null]=i.Null,p[i.Code.Div0]=i.Div0,p[i.Code.Value]=i.Value,p[i.Code.Ref]=i.Ref,p[i.Code.Name]=i.Name,p[i.Code.Num]=i.Num,p[i.Code.NA]=i.NA,p[i.Code.GettingData]=i.GettingData,p[i.Code.Spill]=i.Spill,p[i.Code.Connect]=i.Connect,p[i.Code.Blocked]=i.Blocked,p[i.Code.Unknown]=i.Unknown,p[i.Code.Field]=i.Field,p[i.Code.Calc]=i.Calc,p[i.Code.Busy]=i.Busy,p[i.Code.Python]=i.Python,p[i.Code.Timeout]=i.Timeout;var m=new Map,h=new Map,g=new Map,_=new Map,v=Object.keys(p);for(let e=0;e<v.length;e++){let t=p[v[e]],n=new t;g.set(n.getLabel(),t),_.set(n.getCode(),t),m.set(n.getLabel(),n),h.set(n.getCode(),n)}(function(e){let t=e.getBuiltInByCode=e=>h.get(e);e.BuiltIn={Parse:t(i.Code.Parse),Null:t(i.Code.Null),Div0:t(i.Code.Div0),Value:t(i.Code.Value),Ref:t(i.Code.Ref),Name:t(i.Code.Name),Num:t(i.Code.Num),NA:t(i.Code.NA),GettingData:t(i.Code.GettingData),Spill:t(i.Code.Spill),Connect:t(i.Code.Connect),Blocked:t(i.Code.Blocked),Unknown:t(i.Code.Unknown),Field:t(i.Code.Field),Calc:t(i.Code.Calc),Busy:t(i.Code.Busy),Python:t(i.Code.Python),Timeout:t(i.Code.Timeout)},e.newTypedError=(e,t,n)=>{let r;return r=typeof e==`string`?g.get(e):_.get(e),r||=i.Unknown,new r(t,n)},e.getBuiltInByLabel=e=>m.get(e),e.isError=function(e,t){return!!e&&!0===e.isFormulaError&&(t===void 0||e.getCode()===t)}})(i||={});var y=class{createRange(e,t,n){throw new S}getReference(e,t){throw new S}getResizedReference(e,t,n){throw new S}getNumberFormat(e,t){throw new S}fromSerialDate(e,t){throw new S}toSerialDate(e,t){throw new S}getDateParts(e,t){throw new S}getSerialDate(e,t,n,r,i,a,o){throw new S}getNow(){throw new S}getValueAt(e,t,n,r){return null}getEntireCoords(){return C}isValidDate(e,t){return e instanceof Date||Object.prototype.toString.call(e)===`[object Date]`?!isNaN(e.getTime()):!t&&typeof e==`number`&&!(e<0||e>T)}getRow(){return 0}getColumn(){return 0}getFormulaAt(e,t,n){return null}getSpillAt(e,t,n){return null}getSheetIndex(e){return-1}getSheetCount(){return 1}markVolatile(){}formatResults(e){}filterHidden(e,t){return e}filterTotals(e){return e}getFunction(e){return null}getAddress(e,t){throw new S}parseAsSerialDate(e,t){throw new S}parseAsDate(e,t){throw new S}parseAsNumber(e,t){throw new S}createCriteria(e){throw new S}parseAsLiteral(e){let t=e.toUpperCase();return t===`TRUE`||t!==`FALSE`&&i.getBuiltInByLabel(t)}toText(e){return typeof e==`string`?e:e==null?``:typeof e==`boolean`?e?`TRUE`:`FALSE`:e?.isFormulaError?e.getLabel():String(e)}compare(e,t,n){if(e===t)return 0;let r=b(e),i=b(t);return r===i?e<t?-1:+(e>t):r<i?-1:1}getRuntime(){return w}getArgs(){throw new S(x)}},b=e=>{if(e==null)return 0;switch(typeof e){case`number`:return 1;case`string`:return 2;case`boolean`:return 3;default:return 4}},x=`FormulaContext.getArgs() is only valid while a function body is running`,S=class extends Error{constructor(e=`Not implemented in StubbedFormulaContext`){super(e),this.name=`NotImplementedError`}},C=Object.freeze({colStart:0,rowStart:0,colEnd:2**14-1,rowEnd:2**20-1}),w={isDate1904:()=>!1,getLocale:()=>O.tag,getLocaleProfile:()=>O,isR1C1:()=>!1,getNow:()=>0,getLocation:()=>`unknown`,getVersion:()=>`1.0.0`,getOS:()=>`unknown`,getUser:()=>`unidentified`,getDescription:()=>`Stubbed Formula Context`},T=2958465,E=new y,D=class{constructor(){this._scope=E,this._argsFn=null}_setScope(e){this._scope=e??E}_getScope(){return this._scope}_setArgsProvider(e){this._argsFn=e}getNumberFormat(e,t){return this._getScope().getNumberFormat(e,t)}getEntireCoords(){return this._getScope().getEntireCoords()??C}parseAsSerialDate(e,t){return this._getScope().parseAsSerialDate(e,t)}parseAsDate(e,t){return this._getScope().parseAsDate(e,t)}parseAsNumber(e,t){return this._getScope().parseAsNumber(e,t)}createCriteria(e){return this._getScope().createCriteria(e)}parseAsLiteral(e){let t=this._getScope();return t.parseAsLiteral?t.parseAsLiteral(e):E.parseAsLiteral(e)}toText(e){return this._getScope().toText(e)}isValidDate(e,t=!1){return this._getScope().isValidDate(e,t)}fromSerialDate(e,t=!1){return this._getScope().fromSerialDate(e,t)}toSerialDate(e,t=!1){return this._getScope().toSerialDate(e,t)}getDateParts(e,t){return this._getScope().getDateParts(e,t)}getSerialDate(e,t,n,r=0,i=0,a=0,o=0){return this._getScope().getSerialDate(e,t,n,r,i,a,o)}getNow(){return this._getScope().getNow()}createRange(e,t,n){return this._getScope().createRange(e,t,n)}getRow(){return this._getScope().getRow?.()??0}getColumn(){return this._getScope().getColumn?.()??0}getReference(e,t){return this._getScope().getReference(e,t)}getResizedReference(e,t,n){return this._getScope().getResizedReference(e,t,n)}getValueAt(e,t,n){return this._getScope().getValueAt(e,t,n)}getFormulaAt(e,t,n){return this._getScope().getFormulaAt?.(e,t,n)??null}getSpillAt(e,t,n){return this._getScope().getSpillAt?.(e,t,n)??null}getSheetIndex(e){return this._getScope().getSheetIndex?.(e)??-1}getSheetCount(){return this._getScope().getSheetCount?.()??1}markVolatile(){this._getScope().markVolatile?.()}formatResults(e){this._getScope().formatResults?.(e)}filterHidden(e,t){return this._getScope().filterHidden?.(e,t)??e}filterTotals(e){return this._getScope().filterTotals?.(e)??e}getFunction(e){return this._getScope().getFunction?.(e)??null}getAddress(e,t){return this._getScope().getAddress(e,t)}compare(e,t,n){return this._getScope().compare?.(e,t,n)??E.compare(e,t,n)}getRuntime(){return this._getScope().getRuntime()}getArgs(){let e=this._argsFn,t=e?e():null;if(!t)throw new S(x);return t}get[Symbol.toStringTag](){return`[FormulaContext]`}toString(){return this._getScope()?.toString?.()??`{STUB SCOPE}`}},O=Object.freeze({tag:`en-US`,numberingSystem:`latn`,decimal:`.`,group:`,`,grouping:[3],minusSign:`-`,percentSign:`%`,permilleSign:`‰`,currencyCode:`USD`,currencySymbol:`$`,currencyDisplay:`symbol`,currencyPosition:`before`,currencySpacing:`tight`,date:Object.freeze({calendar:`gregory`,short:`M/d/yy`,medium:`MMM d, y`,long:`MMMM d, y`,timeShort:`h:mm a`,timeLong:`h:mm:ss a`,am:`AM`,pm:`PM`,firstDay:0,weekend:[6,0],monthsWide:[`January`,`February`,`March`,`April`,`May`,`June`,`July`,`August`,`September`,`October`,`November`,`December`],monthsAbbr:[`Jan`,`Feb`,`Mar`,`Apr`,`May`,`Jun`,`Jul`,`Aug`,`Sep`,`Oct`,`Nov`,`Dec`],weekdaysWide:[`Sunday`,`Monday`,`Tuesday`,`Wednesday`,`Thursday`,`Friday`,`Saturday`],weekdaysAbbr:[`Sun`,`Mon`,`Tue`,`Wed`,`Thu`,`Fri`,`Sat`],hour12:!0}),listSeparator:`,`,csvDelimiter:`,`,rtl:!1,collator:Object.freeze({sensitivity:`base`,numeric:!0})}),k=new D;exports.CompatAliases=d,exports.CompatFeatures=u,exports.DEFAULT_LOCALE_PROFILE=O,exports.FormulaContext=k,Object.defineProperty(exports,"FormulaError",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"IRange",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"IRangeStats",{enumerable:!0,get:function(){return r}}),exports.InteropScalarType=o,exports.Observable=class{constructor(e){this._subscribeFn=e}subscribe(e,t,n){let r=typeof e==`object`?{next:e.next||(()=>{}),error:e.error||(()=>{}),complete:e.complete||(()=>{}),unsubscribe:()=>{}}:{next:e||(()=>{}),error:t||(()=>{}),complete:n||(()=>{}),unsubscribe:()=>{}},i=this._subscribeFn(r);return r.unsubscribe=()=>{typeof i==`function`&&i()},r}},Object.defineProperty(exports,"Scalar",{enumerable:!0,get:function(){return e}}),exports.ScalarType=a,exports.ScopedFormulaContext=D,exports.StubbedFormulaContext=y,exports.WildCard=l,exports.resolveCompatFeature=f,exports.resolveCompatFeatures=function(e){let t=f(e);if(t)return[t];let n=(e??``).trim().toLowerCase();for(let e of Object.keys(d))if(e.toLowerCase()===n)return d[e];return null};

package/browser/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.7.28-beta.4
+* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.1
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.
@@ -47,7 +47,23 @@ var t, n, r, i, a = {
 		}
 		return RegExp(n ? `^${r}$` : r, t);
 	}
-};
+}, u = {
+	noReferenceLift: "A multi-cell reference at a non-repeating scalar parameter is #VALUE! rather than a broadcast.",
+	noMemberFilter: "Members of a repeating scalar parameter are coerced rather than filtered; one that cannot be is #VALUE!."
+}, d = { atp: ["noReferenceLift", "noMemberFilter"] };
+function f(e) {
+	let t = p(e);
+	if (t) return [t];
+	let n = (e ?? "").trim().toLowerCase();
+	for (let e of Object.keys(d)) if (e.toLowerCase() === n) return d[e];
+	return null;
+}
+function p(e) {
+	if (!e) return null;
+	let t = e.trim().toLowerCase();
+	for (let e of Object.keys(u)) if (e.toLowerCase() === t) return e;
+	return null;
+}
 (n = t ||= {}).Axis = {
 	Column: "column",
 	Row: "row"
@@ -309,15 +325,15 @@ var t, n, r, i, a = {
 	}
 	e.Timeout = S;
 }(i ||= {});
-var u = {};
-u[i.Code.Parse] = i.Parse, u[i.Code.Null] = i.Null, u[i.Code.Div0] = i.Div0, u[i.Code.Value] = i.Value, u[i.Code.Ref] = i.Ref, u[i.Code.Name] = i.Name, u[i.Code.Num] = i.Num, u[i.Code.NA] = i.NA, u[i.Code.GettingData] = i.GettingData, u[i.Code.Spill] = i.Spill, u[i.Code.Connect] = i.Connect, u[i.Code.Blocked] = i.Blocked, u[i.Code.Unknown] = i.Unknown, u[i.Code.Field] = i.Field, u[i.Code.Calc] = i.Calc, u[i.Code.Busy] = i.Busy, u[i.Code.Python] = i.Python, u[i.Code.Timeout] = i.Timeout;
-var d = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map(), m = /* @__PURE__ */ new Map(), h = Object.keys(u);
-for (let e = 0; e < h.length; e++) {
-	let t = u[h[e]], n = new t();
-	p.set(n.getLabel(), t), m.set(n.getCode(), t), d.set(n.getLabel(), n), f.set(n.getCode(), n);
+var m = {};
+m[i.Code.Parse] = i.Parse, m[i.Code.Null] = i.Null, m[i.Code.Div0] = i.Div0, m[i.Code.Value] = i.Value, m[i.Code.Ref] = i.Ref, m[i.Code.Name] = i.Name, m[i.Code.Num] = i.Num, m[i.Code.NA] = i.NA, m[i.Code.GettingData] = i.GettingData, m[i.Code.Spill] = i.Spill, m[i.Code.Connect] = i.Connect, m[i.Code.Blocked] = i.Blocked, m[i.Code.Unknown] = i.Unknown, m[i.Code.Field] = i.Field, m[i.Code.Calc] = i.Calc, m[i.Code.Busy] = i.Busy, m[i.Code.Python] = i.Python, m[i.Code.Timeout] = i.Timeout;
+var h = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), _ = /* @__PURE__ */ new Map(), v = /* @__PURE__ */ new Map(), y = Object.keys(m);
+for (let e = 0; e < y.length; e++) {
+	let t = m[y[e]], n = new t();
+	_.set(n.getLabel(), t), v.set(n.getCode(), t), h.set(n.getLabel(), n), g.set(n.getCode(), n);
 }
 (function(e) {
-	let t = e.getBuiltInByCode = (e) => f.get(e);
+	let t = e.getBuiltInByCode = (e) => g.get(e);
 	e.BuiltIn = {
 		Parse: t(i.Code.Parse),
 		Null: t(i.Code.Null),
@@ -339,12 +355,12 @@ for (let e = 0; e < h.length; e++) {
 		Timeout: t(i.Code.Timeout)
 	}, e.newTypedError = (e, t, n) => {
 		let r;
-		return r = typeof e == "string" ? p.get(e) : m.get(e), r ||= i.Unknown, new r(t, n);
-	}, e.getBuiltInByLabel = (e) => d.get(e), e.isError = function(e, t) {
+		return r = typeof e == "string" ? _.get(e) : v.get(e), r ||= i.Unknown, new r(t, n);
+	}, e.getBuiltInByLabel = (e) => h.get(e), e.isError = function(e, t) {
 		return !!e && !0 === e.isFormulaError && (t === void 0 || e.getCode() === t);
 	};
 })(i ||= {});
-var g = class {
+var b = class {
 	constructor(e) {
 		this._subscribeFn = e;
 	}
@@ -364,42 +380,42 @@ var g = class {
 			typeof i == "function" && i();
 		}, r;
 	}
-}, _ = class {
+}, x = class {
 	createRange(e, t, n) {
-		throw new y();
+		throw new w();
 	}
 	getReference(e, t) {
-		throw new y();
+		throw new w();
 	}
 	getResizedReference(e, t, n) {
-		throw new y();
+		throw new w();
 	}
 	getNumberFormat(e, t) {
-		throw new y();
+		throw new w();
 	}
 	fromSerialDate(e, t) {
-		throw new y();
+		throw new w();
 	}
 	toSerialDate(e, t) {
-		throw new y();
+		throw new w();
 	}
 	getDateParts(e, t) {
-		throw new y();
+		throw new w();
 	}
 	getSerialDate(e, t, n, r, i, a, o) {
-		throw new y();
+		throw new w();
 	}
 	getNow() {
-		throw new y();
+		throw new w();
 	}
 	getValueAt(e, t, n, r) {
 		return null;
 	}
 	getEntireCoords() {
-		return b;
+		return T;
 	}
 	isValidDate(e, t) {
-		return e instanceof Date || Object.prototype.toString.call(e) === "[object Date]" ? !isNaN(e.getTime()) : !t && typeof e == "number" && !(e < 0 || e > S);
+		return e instanceof Date || Object.prototype.toString.call(e) === "[object Date]" ? !isNaN(e.getTime()) : !t && typeof e == "number" && !(e < 0 || e > D);
 	}
 	getRow() {
 		return 0;
@@ -431,19 +447,19 @@ var g = class {
 		return null;
 	}
 	getAddress(e, t) {
-		throw new y();
+		throw new w();
 	}
 	parseAsSerialDate(e, t) {
-		throw new y();
+		throw new w();
 	}
 	parseAsDate(e, t) {
-		throw new y();
+		throw new w();
 	}
 	parseAsNumber(e, t) {
-		throw new y();
+		throw new w();
 	}
 	createCriteria(e) {
-		throw new y();
+		throw new w();
 	}
 	parseAsLiteral(e) {
 		let t = e.toUpperCase();
@@ -454,13 +470,16 @@ var g = class {
 	}
 	compare(e, t, n) {
 		if (e === t) return 0;
-		let r = v(e), i = v(t);
+		let r = S(e), i = S(t);
 		return r === i ? e < t ? -1 : +(e > t) : r < i ? -1 : 1;
 	}
 	getRuntime() {
-		return x;
+		return E;
 	}
-}, v = (e) => {
+	getArgs() {
+		throw new w(C);
+	}
+}, S = (e) => {
 	if (e == null) return 0;
 	switch (typeof e) {
 		case "number": return 1;
@@ -468,19 +487,19 @@ var g = class {
 		case "boolean": return 3;
 		default: return 4;
 	}
-}, y = class extends Error {
+}, C = "FormulaContext.getArgs() is only valid while a function body is running", w = class extends Error {
 	constructor(e = "Not implemented in StubbedFormulaContext") {
 		super(e), this.name = "NotImplementedError";
 	}
-}, b = Object.freeze({
+}, T = Object.freeze({
 	colStart: 0,
 	rowStart: 0,
 	colEnd: 2 ** 14 - 1,
 	rowEnd: 2 ** 20 - 1
-}), x = {
+}), E = {
 	isDate1904: () => !1,
-	getLocale: () => T.tag,
-	getLocaleProfile: () => T,
+	getLocale: () => A.tag,
+	getLocaleProfile: () => A,
 	isR1C1: () => !1,
 	getNow: () => 0,
 	getLocation: () => "unknown",
@@ -488,21 +507,24 @@ var g = class {
 	getOS: () => "unknown",
 	getUser: () => "unidentified",
 	getDescription: () => "Stubbed Formula Context"
-}, S = 2958465, C = new _(), w = class {
+}, D = 2958465, O = new x(), k = class {
 	constructor() {
-		this._scope = C;
+		this._scope = O, this._argsFn = null;
 	}
 	_setScope(e) {
-		this._scope = e ?? C;
+		this._scope = e ?? O;
 	}
 	_getScope() {
 		return this._scope;
 	}
+	_setArgsProvider(e) {
+		this._argsFn = e;
+	}
 	getNumberFormat(e, t) {
 		return this._getScope().getNumberFormat(e, t);
 	}
 	getEntireCoords() {
-		return this._getScope().getEntireCoords() ?? b;
+		return this._getScope().getEntireCoords() ?? T;
 	}
 	parseAsSerialDate(e, t) {
 		return this._getScope().parseAsSerialDate(e, t);
@@ -518,7 +540,7 @@ var g = class {
 	}
 	parseAsLiteral(e) {
 		let t = this._getScope();
-		return t.parseAsLiteral ? t.parseAsLiteral(e) : C.parseAsLiteral(e);
+		return t.parseAsLiteral ? t.parseAsLiteral(e) : O.parseAsLiteral(e);
 	}
 	toText(e) {
 		return this._getScope().toText(e);
@@ -590,18 +612,23 @@ var g = class {
 		return this._getScope().getAddress(e, t);
 	}
 	compare(e, t, n) {
-		return this._getScope().compare?.(e, t, n) ?? C.compare(e, t, n);
+		return this._getScope().compare?.(e, t, n) ?? O.compare(e, t, n);
 	}
 	getRuntime() {
 		return this._getScope().getRuntime();
 	}
+	getArgs() {
+		let e = this._argsFn, t = e ? e() : null;
+		if (!t) throw new w(C);
+		return t;
+	}
 	get [Symbol.toStringTag]() {
 		return "[FormulaContext]";
 	}
 	toString() {
 		return this._getScope()?.toString?.() ?? "{STUB SCOPE}";
 	}
-}, T = Object.freeze({
+}, A = Object.freeze({
 	tag: "en-US",
 	numberingSystem: "latn",
 	decimal: ".",
@@ -681,5 +708,5 @@ var g = class {
 		sensitivity: "base",
 		numeric: !0
 	})
-}), E = new w();
-export { T as DEFAULT_LOCALE_PROFILE, E as FormulaContext, i as FormulaError, t as IRange, r as IRangeStats, o as InteropScalarType, g as Observable, e as Scalar, a as ScalarType, w as ScopedFormulaContext, _ as StubbedFormulaContext, l as WildCard };
+}), j = new k();
+export { d as CompatAliases, u as CompatFeatures, A as DEFAULT_LOCALE_PROFILE, j as FormulaContext, i as FormulaError, t as IRange, r as IRangeStats, o as InteropScalarType, b as Observable, e as Scalar, a as ScalarType, k as ScopedFormulaContext, x as StubbedFormulaContext, l as WildCard, p as resolveCompatFeature, f as resolveCompatFeatures };

package/node/esm/index.mjs

@@ -1,5 +1,5 @@
 /**
-* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.7.28-beta.4
+* @license @sheetxl/primitives - Primitives - Base types for SheetXL functions. - v0.8.0-beta.1
 *
 * (C) 2026-present SheetXL Inc. & Michael T. Ford
 * License: The license can be found at https://www.sheetxl.com/license.
@@ -48,7 +48,23 @@ var t, r, o, n, s = {
 		}
 		return RegExp(r ? `^${o}$` : o, t);
 	}
-};
+}, l = {
+	noReferenceLift: "A multi-cell reference at a non-repeating scalar parameter is #VALUE! rather than a broadcast.",
+	noMemberFilter: "Members of a repeating scalar parameter are coerced rather than filtered; one that cannot be is #VALUE!."
+}, d = { atp: ["noReferenceLift", "noMemberFilter"] };
+function g(e) {
+	const t = p(e);
+	if (t) return [t];
+	const r = (e ?? "").trim().toLowerCase();
+	for (const e of Object.keys(d)) if (e.toLowerCase() === r) return d[e];
+	return null;
+}
+function p(e) {
+	if (!e) return null;
+	const t = e.trim().toLowerCase();
+	for (const e of Object.keys(l)) if (e.toLowerCase() === t) return e;
+	return null;
+}
 (r = t || (t = {})).Axis = {
 	Column: "column",
 	Row: "row"
@@ -264,7 +280,7 @@ var t, r, o, n, s = {
 		}
 	}
 	e.Unknown = S;
-	class N extends o {
+	class f extends o {
 		constructor(e, o) {
 			super(t.Field, r.Field, e, o);
 		}
@@ -272,7 +288,7 @@ var t, r, o, n, s = {
 			this.code = n.Code.Field;
 		}
 	}
-	e.Field = N;
+	e.Field = f;
 	class w extends o {
 		constructor(e, o) {
 			super(t.Calc, r.Calc, e, o);
@@ -282,7 +298,7 @@ var t, r, o, n, s = {
 		}
 	}
 	e.Calc = w;
-	class f extends o {
+	class b extends o {
 		constructor(e, o) {
 			super(t.Busy, r.Busy, e, o);
 		}
@@ -290,8 +306,8 @@ var t, r, o, n, s = {
 			this.code = n.Code.Busy;
 		}
 	}
-	e.Busy = f;
-	class b extends o {
+	e.Busy = b;
+	class N extends o {
 		constructor(e, o) {
 			super(t.Python, r.Python, e, o);
 		}
@@ -299,7 +315,7 @@ var t, r, o, n, s = {
 			this.code = n.Code.Python;
 		}
 	}
-	e.Python = b;
+	e.Python = N;
 	class y extends o {
 		constructor(e, o) {
 			super(t.Timeout, r.Timeout, e, o);
@@ -310,15 +326,15 @@ var t, r, o, n, s = {
 	}
 	e.Timeout = y;
 }(n || (n = {}));
-var l = {};
-l[n.Code.Parse] = n.Parse, l[n.Code.Null] = n.Null, l[n.Code.Div0] = n.Div0, l[n.Code.Value] = n.Value, l[n.Code.Ref] = n.Ref, l[n.Code.Name] = n.Name, l[n.Code.Num] = n.Num, l[n.Code.NA] = n.NA, l[n.Code.GettingData] = n.GettingData, l[n.Code.Spill] = n.Spill, l[n.Code.Connect] = n.Connect, l[n.Code.Blocked] = n.Blocked, l[n.Code.Unknown] = n.Unknown, l[n.Code.Field] = n.Field, l[n.Code.Calc] = n.Calc, l[n.Code.Busy] = n.Busy, l[n.Code.Python] = n.Python, l[n.Code.Timeout] = n.Timeout;
-var d = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), p = /* @__PURE__ */ new Map(), h = /* @__PURE__ */ new Map(), m = Object.keys(l);
-for (let e = 0; e < m.length; e++) {
-	const t = l[m[e]], r = new t();
-	p.set(r.getLabel(), t), h.set(r.getCode(), t), d.set(r.getLabel(), r), g.set(r.getCode(), r);
+var h = {};
+h[n.Code.Parse] = n.Parse, h[n.Code.Null] = n.Null, h[n.Code.Div0] = n.Div0, h[n.Code.Value] = n.Value, h[n.Code.Ref] = n.Ref, h[n.Code.Name] = n.Name, h[n.Code.Num] = n.Num, h[n.Code.NA] = n.NA, h[n.Code.GettingData] = n.GettingData, h[n.Code.Spill] = n.Spill, h[n.Code.Connect] = n.Connect, h[n.Code.Blocked] = n.Blocked, h[n.Code.Unknown] = n.Unknown, h[n.Code.Field] = n.Field, h[n.Code.Calc] = n.Calc, h[n.Code.Busy] = n.Busy, h[n.Code.Python] = n.Python, h[n.Code.Timeout] = n.Timeout;
+var m = /* @__PURE__ */ new Map(), C = /* @__PURE__ */ new Map(), S = /* @__PURE__ */ new Map(), f = /* @__PURE__ */ new Map(), w = Object.keys(h);
+for (let e = 0; e < w.length; e++) {
+	const t = h[w[e]], r = new t();
+	S.set(r.getLabel(), t), f.set(r.getCode(), t), m.set(r.getLabel(), r), C.set(r.getCode(), r);
 }
 (function(e) {
-	const t = e.getBuiltInByCode = (e) => g.get(e);
+	const t = e.getBuiltInByCode = (e) => C.get(e);
 	e.BuiltIn = {
 		Parse: t(n.Code.Parse),
 		Null: t(n.Code.Null),
@@ -340,12 +356,12 @@ for (let e = 0; e < m.length; e++) {
 		Timeout: t(n.Code.Timeout)
 	}, e.newTypedError = (e, t, r) => {
 		let o;
-		return o = "string" == typeof e ? p.get(e) : h.get(e), o || (o = n.Unknown), new o(t, r);
-	}, e.getBuiltInByLabel = (e) => d.get(e), e.isError = function(e, t) {
+		return o = "string" == typeof e ? S.get(e) : f.get(e), o || (o = n.Unknown), new o(t, r);
+	}, e.getBuiltInByLabel = (e) => m.get(e), e.isError = function(e, t) {
 		return !!e && !0 === e.isFormulaError && (void 0 === t || e.getCode() === t);
 	};
 })(n || (n = {}));
-var C = class {
+var b = class {
 	constructor(e) {
 		this._subscribeFn = e;
 	}
@@ -365,42 +381,42 @@ var C = class {
 			"function" == typeof n && n();
 		}, o;
 	}
-}, S = class {
+}, N = class {
 	createRange(e, t, r) {
-		throw new w();
+		throw new D();
 	}
 	getReference(e, t) {
-		throw new w();
+		throw new D();
 	}
 	getResizedReference(e, t, r) {
-		throw new w();
+		throw new D();
 	}
 	getNumberFormat(e, t) {
-		throw new w();
+		throw new D();
 	}
 	fromSerialDate(e, t) {
-		throw new w();
+		throw new D();
 	}
 	toSerialDate(e, t) {
-		throw new w();
+		throw new D();
 	}
 	getDateParts(e, t) {
-		throw new w();
+		throw new D();
 	}
 	getSerialDate(e, t, r, o, n, s, a) {
-		throw new w();
+		throw new D();
 	}
 	getNow() {
-		throw new w();
+		throw new D();
 	}
 	getValueAt(e, t, r, o) {
 		return null;
 	}
 	getEntireCoords() {
-		return f;
+		return _;
 	}
 	isValidDate(e, t) {
-		return e instanceof Date || "[object Date]" === Object.prototype.toString.call(e) ? !isNaN(e.getTime()) : !t && "number" == typeof e && !(e < 0 || e > y);
+		return e instanceof Date || "[object Date]" === Object.prototype.toString.call(e) ? !isNaN(e.getTime()) : !t && "number" == typeof e && !(e < 0 || e > R);
 	}
 	getRow() {
 		return 0;
@@ -432,19 +448,19 @@ var C = class {
 		return null;
 	}
 	getAddress(e, t) {
-		throw new w();
+		throw new D();
 	}
 	parseAsSerialDate(e, t) {
-		throw new w();
+		throw new D();
 	}
 	parseAsDate(e, t) {
-		throw new w();
+		throw new D();
 	}
 	parseAsNumber(e, t) {
-		throw new w();
+		throw new D();
 	}
 	createCriteria(e) {
-		throw new w();
+		throw new D();
 	}
 	parseAsLiteral(e) {
 		const t = e.toUpperCase();
@@ -455,13 +471,16 @@ var C = class {
 	}
 	compare(e, t, r) {
 		if (e === t) return 0;
-		const o = N(e), n = N(t);
+		const o = y(e), n = y(t);
 		return o !== n ? o < n ? -1 : 1 : e < t ? -1 : e > t ? 1 : 0;
 	}
 	getRuntime() {
-		return b;
+		return F;
+	}
+	getArgs() {
+		throw new D(A);
 	}
-}, N = (e) => {
+}, y = (e) => {
 	if (null == e) return 0;
 	switch (typeof e) {
 		case "number": return 1;
@@ -469,19 +488,19 @@ var C = class {
 		case "boolean": return 3;
 		default: return 4;
 	}
-}, w = class extends Error {
+}, A = "FormulaContext.getArgs() is only valid while a function body is running", D = class extends Error {
 	constructor(e = "Not implemented in StubbedFormulaContext") {
 		super(e), this.name = "NotImplementedError";
 	}
-}, f = Object.freeze({
+}, _ = Object.freeze({
 	colStart: 0,
 	rowStart: 0,
 	colEnd: Math.pow(2, 14) - 1,
 	rowEnd: Math.pow(2, 20) - 1
-}), b = {
+}), F = {
 	isDate1904: () => !1,
-	getLocale: () => _.tag,
-	getLocaleProfile: () => _,
+	getLocale: () => L.tag,
+	getLocaleProfile: () => L,
 	isR1C1: () => !1,
 	getNow: () => 0,
 	getLocation: () => "unknown",
@@ -489,21 +508,24 @@ var C = class {
 	getOS: () => "unknown",
 	getUser: () => "unidentified",
 	getDescription: () => "Stubbed Formula Context"
-}, y = 2958465, D = new S(), A = class {
+}, R = 2958465, x = new N(), T = class {
 	constructor() {
-		this._scope = D;
+		this._scope = x, this._argsFn = null;
 	}
 	_setScope(e) {
-		this._scope = e ?? D;
+		this._scope = e ?? x;
 	}
 	_getScope() {
 		return this._scope;
 	}
+	_setArgsProvider(e) {
+		this._argsFn = e;
+	}
 	getNumberFormat(e, t) {
 		return this._getScope().getNumberFormat(e, t);
 	}
 	getEntireCoords() {
-		return this._getScope().getEntireCoords() ?? f;
+		return this._getScope().getEntireCoords() ?? _;
 	}
 	parseAsSerialDate(e, t) {
 		return this._getScope().parseAsSerialDate(e, t);
@@ -519,7 +541,7 @@ var C = class {
 	}
 	parseAsLiteral(e) {
 		const t = this._getScope();
-		return t.parseAsLiteral ? t.parseAsLiteral(e) : D.parseAsLiteral(e);
+		return t.parseAsLiteral ? t.parseAsLiteral(e) : x.parseAsLiteral(e);
 	}
 	toText(e) {
 		return this._getScope().toText(e);
@@ -591,18 +613,23 @@ var C = class {
 		return this._getScope().getAddress(e, t);
 	}
 	compare(e, t, r) {
-		return this._getScope().compare?.(e, t, r) ?? D.compare(e, t, r);
+		return this._getScope().compare?.(e, t, r) ?? x.compare(e, t, r);
 	}
 	getRuntime() {
 		return this._getScope().getRuntime();
 	}
+	getArgs() {
+		const e = this._argsFn, t = e ? e() : null;
+		if (!t) throw new D(A);
+		return t;
+	}
 	get [Symbol.toStringTag]() {
 		return "[FormulaContext]";
 	}
 	toString() {
 		return this._getScope()?.toString?.() ?? "{STUB SCOPE}";
 	}
-}, _ = Object.freeze({
+}, L = Object.freeze({
 	tag: "en-US",
 	numberingSystem: "latn",
 	decimal: ".",
@@ -682,5 +709,5 @@ var C = class {
 		sensitivity: "base",
 		numeric: !0
 	})
-}), x = new A();
-export { _ as DEFAULT_LOCALE_PROFILE, x as FormulaContext, n as FormulaError, t as IRange, o as IRangeStats, a as InteropScalarType, C as Observable, e as Scalar, s as ScalarType, A as ScopedFormulaContext, S as StubbedFormulaContext, u as WildCard };
+}), P = new T();
+export { d as CompatAliases, l as CompatFeatures, L as DEFAULT_LOCALE_PROFILE, P as FormulaContext, n as FormulaError, t as IRange, o as IRangeStats, a as InteropScalarType, b as Observable, e as Scalar, s as ScalarType, T as ScopedFormulaContext, N as StubbedFormulaContext, u as WildCard, p as resolveCompatFeature, g as resolveCompatFeatures };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sheetxl/primitives",
   "description": "Primitives - Base types for SheetXL functions.",
-  "version": "0.7.28-beta.4",
+  "version": "0.8.0-beta.1",
   "license": "SEE LICENSE IN <LICENSE>",
   "type": "module",
   "exports": {

package/types/src/Compat.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The behaviors `@compat` can turn on, and what each one does.
+ *
+ * @remarks
+ * A feature earns a place here only if the BODY cannot do it — the decision happens before the
+ * body runs, or instead of running it. Everything a body can decide for itself belongs in the
+ * body, where `FormulaContext.getArgs()` and `Omittable` already reach.
+ *
+ * Function-level until a measurement forces otherwise: `noReferenceLift` is per-function in
+ * Excel, and no function is known whose parameters disagree.
+ *
+ * @see {@link https://www.sheetxl.com/docs/guides/concepts/udf | UDF authoring guide}
+ */
+export declare const CompatFeatures: {
+    /**
+     * A multi-cell REFERENCE at a non-repeating scalar parameter is `#VALUE!` rather than a
+     * broadcast.
+     *
+     * Excel's Analysis-ToolPak family answers `CUMIPMT(G1:G2,120,100000,13,24,0)` with `#VALUE!`
+     * where the native `ROUND(B1:B3,3)` spills three results. A multi-cell reference has no way to
+     * become a scalar there, because these functions never intersect. An ARRAY at the same slot
+     * still lifts (`MROUND({3,4,5},5)` spills), so the refusal is about references specifically,
+     * and a REPEATING slot absorbs a container as members either way (`GCD(C1:C3)` is 4) — so this
+     * never applies to one.
+     */
+    readonly noReferenceLift: "A multi-cell reference at a non-repeating scalar parameter is #VALUE! rather than a broadcast.";
+    /**
+     * Members of a REPEATING scalar parameter are coerced rather than filtered: numeric text
+     * parses, a blank inside a multi-cell range reads 0, and a boolean or non-numeric text member
+     * is `#VALUE!` for the whole call.
+     *
+     * The native family FILTERS — `SUM({1,"8",TRUE})` is 1, the text and the boolean skipped, and a
+     * blank cell contributes nothing. Excel's Analysis-ToolPak family coerces instead:
+     * `GCD({6,"8",12})` is 2, `GCD({6,TRUE,12})` is `#VALUE!`, `LCM(6,A1:A2)` over two blank cells
+     * is 0. A direct argument follows the same rule (`GCD(6,TRUE,12)` is `#VALUE!` where
+     * `SUM(6,TRUE,12)` is 19), and a one-cell blank reference or an omitted argument is still
+     * skipped — it never became a member.
+     */
+    readonly noMemberFilter: "Members of a repeating scalar parameter are coerced rather than filtered; one that cannot be is #VALUE!.";
+};
+/**
+ * One of the {@link CompatFeatures} names.
+ */
+export type CompatFeature = keyof typeof CompatFeatures;
+/**
+ * Family aliases: one name an author writes that expands to several {@link CompatFeatures}.
+ *
+ * @remarks
+ * Excel's Analysis-ToolPak heritage is ONE measured rule with two halves that act on disjoint
+ * parameter kinds — `noReferenceLift` at a non-repeating scalar slot, `noMemberFilter` at a
+ * repeating one — so every function in the family carries the same two bits and `@compat atp`
+ * says so in one word. The alias is expanded by the linter; only the atomic features are ever
+ * stored, so `@compat atp` and `@compat noReferenceLift noMemberFilter` emit the same declaration.
+ * The atomic names stay available for the day a function measures as disagreeing on one half.
+ */
+export declare const CompatAliases: Readonly<Record<string, readonly CompatFeature[]>>;
+/**
+ * Resolves a `@compat` name — a feature or a family alias — CASE-INSENSITIVELY, to the canonical
+ * features it turns on.
+ *
+ * @param name The name as the author wrote it.
+ * @returns The canonical features, or `null` when no feature or alias goes by that name.
+ */
+export declare function resolveCompatFeatures(name: string): readonly CompatFeature[] | null;
+/**
+ * Resolves a `@compat` feature name, CASE-INSENSITIVELY, to its canonical spelling.
+ *
+ * @param name The name as the author wrote it.
+ * @returns The canonical name, or `null` when no feature goes by it.
+ *
+ * @remarks
+ * Authors write `@compat noReferenceLift`; `@Compat NOREFERENCELIFT` means the same thing. Only
+ * the canonical spelling is ever stored, so the declaration a build emits does not depend on how
+ * the tag was typed.
+ */
+export declare function resolveCompatFeature(name: string): CompatFeature | null;
+//# sourceMappingURL=Compat.d.ts.map

package/types/src/FormulaContext.d.ts

@@ -3,6 +3,7 @@ import { FormulaError } from './FormulaError';
 import { IRange } from './IRange';
 import { IReferenceRange } from './IReferenceRange';
 import { IFunction } from './IFunction';
+import { IFunctionArguments } from './IFunctionArguments';
 import { IFormulaContext } from './IFormulaContext';
 import { IRuntime } from './IRuntime';
 import { LocaleProfile } from './LocaleProfile';
@@ -127,6 +128,8 @@ export declare class StubbedFormulaContext implements IFormulaContext {
     compare(a: Scalar, b: Scalar, options?: Intl.CollatorOptions): number;
     /** @inheritdoc IFormulaContext.getRuntime */
     getRuntime(): IRuntime;
+    /** @inheritdoc IFormulaContext.getArgs */
+    getArgs(): IFunctionArguments;
 }
 /**
  * The single, shared {@link IFormulaContext} that formula implementations use (via
@@ -144,6 +147,18 @@ export declare class ScopedFormulaContext implements IFormulaContext {
     _setScope(scope: Partial<IFormulaContext> | null): void;
     /** @hidden */
     _getScope(): Partial<IFormulaContext>;
+    /**
+     * @hidden Installed ONCE by the runtime marshaller; answers {@link getArgs} for whichever call
+     * is currently dispatching, or `null` when none is.
+     *
+     * @remarks
+     * A provider rather than a stack because the marshaller already pools one view per dispatch
+     * DEPTH and knows the current depth. Reading a function pointer costs nothing for the ~99% of
+     * calls whose body never asks.
+     */
+    protected _argsFn: (() => IFunctionArguments | null) | null;
+    /** @hidden */
+    _setArgsProvider(provider: (() => IFunctionArguments | null) | null): void;
     /** @inheritdoc IFormulaContext.getNumberFormat */
     getNumberFormat(formatText: string, value: Scalar): string | null;
     /** @inheritdoc IFormulaContext.getEntireCoords */
@@ -209,6 +224,8 @@ export declare class ScopedFormulaContext implements IFormulaContext {
     compare(a: Scalar, b: Scalar, options?: Intl.CollatorOptions): number;
     /** @inheritdoc IFormulaContext.getRuntime */
     getRuntime(): IRuntime;
+    /** @inheritdoc IFormulaContext.getArgs */
+    getArgs(): IFunctionArguments;
     get [Symbol.toStringTag](): string;
     toString(): string;
 }

package/types/src/IFormulaContext.d.ts

@@ -3,6 +3,7 @@ import { FormulaError } from './FormulaError';
 import { IRange } from './IRange';
 import { IReferenceRange } from './IReferenceRange';
 import { IFunction } from './IFunction';
+import { IFunctionArguments } from './IFunctionArguments';
 import { IRuntime } from './IRuntime';
 /**
  * Everything a formula function is allowed to know about the world outside its arguments.
@@ -28,6 +29,7 @@ import { IRuntime } from './IRuntime';
  * | Category | Key methods |
  * |---|---|
  * | Evaluation lifecycle | `markVolatile`, `getRow`, `getColumn`, `getEntireCoords` |
+ * | Argument reflection | `getArgs` |
  * | Output hints | `formatResults` |
  * | Range construction | `createRange`, `filterHidden` |
  * | Dynamic references | `getReference`, `getValueAt`, `getFormulaAt`, `getSpillAt` |
@@ -482,6 +484,22 @@ export interface IFormulaContext {
      * Mostly for diagnostics; the built-in `INFO` function is built on it.
      */
     getRuntime(): IRuntime;
+    /**
+     * The current call's arguments — how many the caller supplied, in which positions, of what kind,
+     * and what each value was BEFORE coercion.
+     *
+     * @remarks
+     * Argument REFLECTION, for the one thing a declaration cannot say: what happened at *this* call.
+     * It exists to serve Excel's declared `any`, which means "no contract, the body decides" — every
+     * other Excel type maps onto a type we already have and the marshaller handles it.
+     *
+     * The returned view is valid ONLY while the body that asked for it is running. Views are pooled
+     * by dispatch depth, so retaining one across an `await`, a callback, or a nested evaluation hands
+     * you another call's arguments.
+     *
+     * @throws If called outside a function dispatch — there are no arguments to reflect on.
+     */
+    getArgs(): IFunctionArguments;
 }
 /**
  * {@inheritDoc IFormulaContext}

package/types/src/IFunction.d.ts

@@ -1,5 +1,6 @@
 import { Scalar } from './Scalar';
 import { ScalarType } from './ScalarType';
+import { CompatFeature } from './Compat';
 /**
  * A self-describing, type-safe, executable function.
  *
@@ -603,6 +604,20 @@ export declare namespace IFunction {
          * @defaultValue false
          */
         cancelable?: boolean;
+        /**
+         * Named engine behaviors this function opts into, from the `@compat` doc tag.
+         *
+         * @remarks
+         * Canonical spellings, deduplicated and in declaration order; a family alias the author wrote
+         * (`@compat atp`) has already been expanded to its atomic features. An unknown name never
+         * reaches here — the linter fails the build on one, deliberately: a compatibility rule that
+         * silently no-ops is the worst failure available, because the fixtures keep passing and the
+         * behavior is simply absent.
+         *
+         * @see {@link CompatFeatures}
+         * @see {@link CompatAliases}
+         */
+        compat?: CompatFeature[];
     }
 }
 //# sourceMappingURL=IFunction.d.ts.map

package/types/src/IFunctionArguments.d.ts

@@ -0,0 +1,143 @@
+import { Scalar } from './Scalar';
+import { IRange } from './IRange';
+import { Lambda } from './Lambda';
+/**
+ * The current call's arguments, as the body sees them — argument **reflection**.
+ *
+ * @remarks
+ * A declaration answers "what does this parameter mean?", and the marshaller coerces every
+ * argument to it. That is right for the overwhelming majority of parameters. What it cannot answer
+ * is anything about *this particular call*:
+ *
+ * - What did the caller write there — a value, a cell, an array, nothing at all?
+ * - What was the value BEFORE the parameter's type coerced it?
+ * - Was that empty slot an omission, or a blank cell the caller pointed at?
+ *
+ * Excel has measured behaviors that turn on exactly those questions, and they cluster at the
+ * parameters Excel declares `any` — where there is nothing to express as a type, because Excel
+ * declined to express one. `CUMIPMT` refuses a boolean at every slot while `FV` coerces one at
+ * every slot; the difference is not the values, it is that `CUMIPMT`'s slots are `any` and its
+ * body decides.
+ *
+ * It is REFLECTION and nothing else — two questions, and no third:
+ *
+ * | question | answers |
+ * | --- | --- |
+ * | *what was supplied* | {@link getLength}, {@link isOmittedAt} |
+ * | *what it is* | {@link getRawAt} |
+ *
+ * Coercion is deliberately absent. A body that wants a number calls
+ * {@link IFormulaContext.parseAsNumber} on the value this hands it — that already takes a value,
+ * already propagates an incoming error with its identity, and already answers `#VALUE!` for a
+ * boolean, which IS the rule an `any` slot needs. There is no coercion an index can do that a
+ * value cannot.
+ *
+ * Obtained from `FormulaContext.getArgs()`, and valid ONLY while the body that asked for it is
+ * running. A body must not retain it across an `await`, a callback, or a nested evaluation — the
+ * views are pooled by dispatch depth, so the one at your depth is handed to the next call at that
+ * depth.
+ *
+ * ```typescript
+ * export function CUMIPMT(rate: Scalar, nper: Scalar): number {
+ *   const args = FormulaContext.getArgs();
+ *   if (args.isOmittedAt(0)) return FormulaError.BuiltIn.NA;     // `CUMIPMT(,120,…)` is #N/A
+ *   const asNumber = FormulaContext.parseAsNumber(args.getRawAt(0) as Scalar);  // TRUE is #VALUE!
+ *   // …
+ * }
+ * ```
+ *
+ * @see {@link IFormulaContext.getArgs}
+ */
+export interface IFunctionArguments {
+    /**
+     * How many PARAMETERS the caller supplied.
+     *
+     * @remarks
+     * Indexing throughout matches the BODY's own signature, never the raw call positions
+     * (see {@link getRawAt}). `index >= getLength()` is an ABSENT argument — one the caller never
+     * wrote, whose own JS initializer supplied the value. That is a different thing from an OMITTED
+     * one; see {@link isOmittedAt}.
+     */
+    getLength(): number;
+    /**
+     * This invocation's value at `index`, uncoerced.
+     *
+     * @param index The PARAMETER index — the position in the body's own signature.
+     *
+     * @remarks
+     * A `Scalar` means the argument IS a value; an {@link IRange} means a container whose members
+     * the body reads itself (a reference materializes on demand); a {@link Lambda} means a callable.
+     *
+     * At a REPEATING parameter (`Repeating<T>`, or a rest parameter) this is the ARRAY of that
+     * group's values — one entry per argument the caller wrote — and {@link getRepeatingArgsAt} is the
+     * per-argument view of the same thing. Indexing by parameter rather than by call position is
+     * what lets a body ask its questions in the vocabulary it declared:
+     *
+     * ```typescript
+     * // IFS(condition: Repeating<[logicalTest: boolean, logicalTrue: AcceptError<any>]>)
+     * args.getRawAt(0);                       // [test1, value1, test2, value2, …]
+     * args.getRepeatingArgsAt(0).getRawAt(0);     // test1
+     * ```
+     *
+     * **Under a lift** the call broadcasts and the body runs once per output cell; this reports the
+     * value for THIS invocation — the member at the current broadcast position for a lifted argument,
+     * the whole argument for one that is not lifting. That is what every identified caller wants: a
+     * body checking for a boolean must see the member, not the array around it.
+     *
+     * One boundary is worth knowing: under a lift at a parameter that declares a CONCRETE scalar
+     * type, the member has already been converted by that declaration, so the raw and coerced answers
+     * coincide there. At the `Scalar` slots this interface exists for, nothing coerces and the value
+     * is the member exactly as the caller's range holds it.
+     */
+    getRawAt(index: number): IFunctionArguments.RawArg | IFunctionArguments.RawArg[];
+    /**
+     * A nested view over one REPEATING parameter's arguments, so a body can ask the same questions
+     * one level down — `getRepeatingArgsAt(0).isOmittedAt(1)`.
+     *
+     * @param index The PARAMETER index of the repeating group (or rest parameter).
+     *
+     * @remarks
+     * The nested view is FLAT over the group's arguments: a period-2 group repeated three times reads
+     * as six, in call order. That is where "which one was omitted" has an answer at all — the group
+     * as a whole cannot be omitted, only one of its arguments can.
+     *
+     * At a non-repeating parameter this returns an EMPTY view (`getLength()` of 0) rather than
+     * throwing, so a body that folds over its groups needs no special case.
+     */
+    getRepeatingArgsAt(index: number): IFunctionArguments;
+    /**
+     * True for an OMITTED argument — one the caller supplied EMPTY, as the trailing comma of
+     * `CUMIPMT(,120,100000,13,24,0)`.
+     *
+     * @remarks
+     * There are THREE positions, not two, and Excel answers each differently:
+     *
+     * | form | position | Excel |
+     * | --- | --- | --- |
+     * | `CUMIPMT(0.01,120,100000,13,24)` | ABSENT | refused at entry |
+     * | `CUMIPMT(,120,100000,13,24,0)` | **OMITTED** | `#N/A` |
+     * | `CUMIPMT(0.01,120,100000,13,24,E1)`, E1 blank | a blank CELL | the ordinary answer |
+     *
+     * This separates the middle row from the other two. ABSENT is `index >= getLength()`; a blank
+     * cell is an ordinary value the caller pointed at and is not omitted.
+     */
+    isOmittedAt(index: number): boolean;
+}
+/**
+ * {@inheritDoc IFunctionArguments}
+ *
+ * @see
+ * ### **Interface**
+ *
+ * {@link IFunctionArguments}
+ */
+export declare namespace IFunctionArguments {
+    /**
+     * One argument as the caller wrote it — a value, a container, a callable, or nothing.
+     *
+     * @remarks
+     * `undefined` is an OMITTED or ABSENT argument; `null` is a blank, which is a value.
+     */
+    type RawArg = Scalar | IRange | Lambda | undefined;
+}
+//# sourceMappingURL=IFunctionArguments.d.ts.map

package/types/src/IRange.d.ts

@@ -244,11 +244,28 @@ export interface IRange<T extends Scalar = Scalar> {
      */
     filter<TS extends Scalar = T>(callbackFn: (value: TS, coords: IRange.CellCoords, range: IRange<T>) => MaybeError<boolean>, options?: IRange.TraversalAxis | IRange.IteratorOptions): this;
     /**
-     * Returns the values as an array of values.
+     * Linearizes the range into a single column by flattened ordinal — the member at ordinal `i`
+     * lands at row `i`, column 0.
      *
      * @param options {@link IRange.IteratorOptions}
+     *
+     * @remarks
+     * `options.axis` is the TRAVERSAL order feeding the ordinal, not the orientation of the result:
+     * the result is always Nx1, and a row is `flatten().transpose()`. The default is row-major,
+     * which is the order Excel pairs two range operands in.
+     *
+     * `options.type` carries a read type onto the result, so a member the type filters out becomes
+     * a HOLE at its ordinal rather than compacting the column. That is what lets two operands be
+     * paired position by position — see {@link alignValues}.
+     *
+     * `options.includeEmpty` has no meaning here and is ignored: a range is inherently sparse, so
+     * an empty position is simply absent. Sparsity is preserved and nothing is materialized.
+     *
+     * Equivalent to `reshape(rows * columns, 1)`, which is where the ordinal rule is stated.
+     *
+     * @see {@link getValuesFlat} for the same linearization as a JS array.
      */
-    flatten<TS extends Scalar = T>(options?: IRange.IteratorOptions): TS[];
+    flatten(options?: IRange.IteratorOptions): this;
     /**
      * Iterates over the cells within the range, applying the provided callback function to each cell.
      *
@@ -326,6 +343,16 @@ export interface IRange<T extends Scalar = Scalar> {
      * @param options {@link IRange.ValueOptions}
      */
     getValueAt<TS extends Scalar = T>(rowIndex: number, colIndex: number, options?: IRange.ValueOptions): TS;
+    /**
+     * Returns the members as a flat JS array.
+     *
+     * @param options {@link IRange.IteratorOptions}
+     *
+     * @remarks
+     * The array form of {@link flatten}. Skips empty members unless `includeEmpty` is set, where
+     * `flatten` keeps them as holes in a range.
+     */
+    getValuesFlat<TS extends Scalar = T>(options?: IRange.IteratorOptions): TS[];
     /**
      * Returns the number of columns of the range.
      */

package/types/src/index.d.ts

@@ -6,11 +6,13 @@ export * from './ErrorPolicy';
 export * from './Repeating';
 export * from './Flatten';
 export * from './Omittable';
+export * from './Compat';
 export * from './IRange';
 export * from './IReferenceRange';
 export * from './IRichData';
 export * from './IFunction';
 export * from './IFormulaContext';
+export * from './IFunctionArguments';
 export * from './LocaleProfile';
 export * from './IRuntime';
 export * from './IRangeStats';