@gridsheet/functions 3.0.0-rc.10

package/dist/index.js

@@ -0,0 +1,321 @@
+import { BaseFunction as r, FormulaError as s, ensureBoolean as c, Sheet as u, ensureNumber as l, createBook as d } from "@gridsheet/core";
+import { mathFunctions as p } from "./math/index.js";
+import { statisticsFunctions as h } from "./statistics/index.js";
+import { textFunctions as m } from "./text/index.js";
+import { lookupFunctions as f } from "./lookup/index.js";
+import { timeFunctions as g } from "./time/index.js";
+const T = `Returns TRUE if an odd number of the arguments are logically true.
+Returns FALSE if an even number of the arguments are logically true.`;
+class y extends r {
+  constructor() {
+    super(...arguments), this.example = "XOR(A1=1, A2=2)", this.description = T, this.defs = [
+      { name: "expression", description: "Logical expressions to evaluate.", acceptedTypes: ["boolean"], variadic: !0 }
+    ], this.category = "logical";
+  }
+  main(...e) {
+    return e.reduce((n, i) => n !== i, !1);
+  }
+}
+const x = "Returns the first argument if it is not a #N/A error, otherwise returns the second argument.", a = class a extends r {
+  constructor() {
+    super(...arguments), this.example = 'IFNA(A1, "N/A error occurred")', this.description = x, this.defs = [
+      {
+        name: "value",
+        description: "The value to return if it is not a #N/A error.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      },
+      {
+        name: "value_if_na",
+        description: "The value to return if the first argument is a #N/A error.",
+        optional: !0,
+        acceptedTypes: ["any"]
+      }
+    ], this.category = "logical";
+  }
+  main(e, n) {
+    return s.is(e) && e.code === "#N/A" ? n : e;
+  }
+};
+a.__name = "IFNA";
+let o = a;
+const A = `Evaluates multiple conditions and returns the value corresponding to the first TRUE condition.
+Arguments must be supplied in (condition, value) pairs.`;
+class v extends r {
+  constructor() {
+    super(...arguments), this.example = 'IFS(A1>90, "A", A1>70, "B", A1>50, "C")', this.description = A, this.defs = [
+      { name: "condition", description: "Condition to evaluate.", acceptedTypes: ["boolean"], variadic: !0 },
+      { name: "value", description: "Value to return if condition is TRUE.", acceptedTypes: ["any"], variadic: !0 }
+    ], this.category = "logical";
+  }
+  validate(e) {
+    if (e.length < 2)
+      throw new s("#N/A", "IFS requires at least one condition-value pair.");
+    if (e.length % 2 !== 0)
+      throw new s("#N/A", "IFS requires an even number of arguments (condition, value) pairs.");
+    for (let n = 0; n < e.length; n += 2)
+      if (c(e[n]))
+        return [e[n + 1]];
+    throw new s("#N/A", "No condition in IFS was met.");
+  }
+  main(e) {
+    return e;
+  }
+}
+const R = {
+  xor: y,
+  ifna: o,
+  ifs: v
+}, E = "Returns TRUE if the referenced cell contains a formula.";
+class F extends r {
+  constructor() {
+    super(...arguments), this.example = "ISFORMULA(A1)", this.description = E, this.defs = [
+      {
+        name: "reference",
+        description: "The cell reference to check for a formula.",
+        acceptedTypes: ["reference"],
+        takesMatrix: !0,
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    const n = e.getCell({ y: e.top, x: e.left }, { resolution: "SYSTEM" }), i = n == null ? void 0 : n.value;
+    return typeof i == "string" && i.startsWith("=");
+  }
+}
+const N = "Returns TRUE if the referenced cell is empty.";
+class I extends r {
+  constructor() {
+    super(...arguments), this.example = "ISBLANK(A1)", this.description = N, this.defs = [
+      {
+        name: "value",
+        description: "A reference to a cell to check for emptiness.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return e == null || e === "";
+  }
+}
+const S = "Returns TRUE if the value is any error other than #N/A.";
+class b extends r {
+  constructor() {
+    super(...arguments), this.example = "ISERR(A1)", this.description = S, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for a non-#N/A error.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return e instanceof Error ? !0 : s.is(e) && e.code !== "#N/A";
+  }
+}
+const k = "Returns TRUE if the value is any error value.";
+class U extends r {
+  constructor() {
+    super(...arguments), this.example = "ISERROR(A1)", this.description = k, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for an error.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return s.is(e) || e instanceof Error;
+  }
+}
+const $ = "Returns TRUE if the value is TRUE or FALSE.";
+class w extends r {
+  constructor() {
+    super(...arguments), this.example = "ISLOGICAL(TRUE)", this.description = $, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for being logical (TRUE or FALSE).",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return typeof e == "boolean";
+  }
+}
+const L = "Returns TRUE if the value is the #N/A error value.";
+class B extends r {
+  constructor() {
+    super(...arguments), this.example = "ISNA(A1)", this.description = L, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for the #N/A error.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return s.is(e) && e.code === "#N/A";
+  }
+}
+const M = "Returns TRUE if the value is not a text string.";
+class O extends r {
+  constructor() {
+    super(...arguments), this.example = "ISNONTEXT(A1)", this.description = M, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for being non-text.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return typeof e != "string";
+  }
+}
+const X = "Returns TRUE if the value is a text string.";
+class C extends r {
+  constructor() {
+    super(...arguments), this.example = "ISTEXT(A1)", this.description = X, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for being text.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return typeof e == "string";
+  }
+}
+const _ = "Returns TRUE if the value is a valid cell reference.";
+class D extends r {
+  constructor() {
+    super(...arguments), this.example = "ISREF(A1)", this.description = _, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for being a cell reference.",
+        acceptedTypes: ["any"],
+        takesMatrix: !0,
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return u.is(e);
+  }
+}
+const q = "Returns the argument provided as a number.";
+class G extends r {
+  constructor() {
+    super(...arguments), this.example = "N(A1)", this.description = q, this.defs = [
+      {
+        name: "value",
+        description: "The value to convert to a number.",
+        acceptedTypes: ["any"]
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    if (typeof e == "boolean")
+      return e ? 1 : 0;
+    if (e instanceof Date)
+      return e.getTime();
+    if (e == null || e === "")
+      return 0;
+    try {
+      return l(e);
+    } catch {
+      return 0;
+    }
+  }
+}
+const j = 'Returns the error value #N/A, meaning "value not available".';
+class H extends r {
+  constructor() {
+    super(...arguments), this.example = "NA()", this.description = j, this.defs = [], this.category = "information";
+  }
+  main() {
+    throw new s("#N/A", "N/A");
+  }
+}
+const K = "Returns TRUE if the value is a date.";
+class V extends r {
+  constructor() {
+    super(...arguments), this.example = "ISDATE(A1)", this.description = K, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for being a date.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return e instanceof Date && !isNaN(e.getTime());
+  }
+}
+const W = /^[^\s@]+@[^\s@]+\.[^\s@]+$/, Y = "Returns TRUE if the value is a valid email address.";
+class z extends r {
+  constructor() {
+    super(...arguments), this.example = "ISEMAIL(A1)", this.description = Y, this.defs = [
+      {
+        name: "value",
+        description: "The value to check for being a valid email address.",
+        acceptedTypes: ["any"],
+        errorTolerant: !0
+      }
+    ], this.category = "information";
+  }
+  main(e) {
+    return typeof e != "string" ? !1 : W.test(e);
+  }
+}
+const J = "Returns the total number of sheets in the spreadsheet.";
+class P extends r {
+  constructor() {
+    super(...arguments), this.example = "SHEETS()", this.description = J, this.defs = [], this.category = "information";
+  }
+  main() {
+    const e = this.sheet.registry.sheetIdsByName, n = Object.keys(e).length;
+    return n === 0 ? 1 : n;
+  }
+}
+const Q = {
+  isformula: F,
+  isblank: I,
+  iserr: b,
+  iserror: U,
+  islogical: w,
+  isna: B,
+  isnontext: O,
+  istext: C,
+  isref: D,
+  n: G,
+  na: H,
+  isdate: V,
+  isemail: z,
+  sheets: P
+}, Z = {
+  ...p,
+  ...h,
+  ...m,
+  ...f,
+  ...g,
+  ...R,
+  ...Q
+}, oe = ({ additionalFunctions: t, ...e } = {}) => d({ ...e, additionalFunctions: { ...Z, ...t } });
+export {
+  Z as allFunctions,
+  oe as createSpellbook,
+  Z as default
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/logical/xor.ts","../src/logical/ifna.ts","../src/logical/ifs.ts","../src/logical/index.ts","../src/information/isformula.ts","../src/information/isblank.ts","../src/information/iserr.ts","../src/information/iserror.ts","../src/information/islogical.ts","../src/information/isna.ts","../src/information/isnontext.ts","../src/information/istext.ts","../src/information/isref.ts","../src/information/n.ts","../src/information/na.ts","../src/information/isdate.ts","../src/information/isemail.ts","../src/information/sheets.ts","../src/information/index.ts","../src/index.ts"],"sourcesContent":["import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport { ensureBoolean } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if an odd number of the arguments are logically true.\nReturns FALSE if an even number of the arguments are logically true.`;\n\nexport class XorFunction extends BaseFunction {\n  example = 'XOR(A1=1, A2=2)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    { name: 'expression', description: 'Logical expressions to evaluate.', acceptedTypes: ['boolean'], variadic: true },\n  ];\n  category: FunctionCategory = 'logical';\n\n  protected main(...values: boolean[]) {\n    // XOR is true when an odd number of arguments are true\n    return values.reduce((acc, val) => acc !== val, false as boolean);\n  }\n}\n","import { BaseFunction, FormulaError } from '@gridsheet/core';\nimport { type FunctionArgumentDefinition } from '@gridsheet/core';\n\nconst description = `Returns the first argument if it is not a #N/A error, otherwise returns the second argument.`;\n\nexport class IfnaFunction extends BaseFunction {\n  static __name = 'IFNA';\n  example = 'IFNA(A1, \"N/A error occurred\")';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to return if it is not a #N/A error.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n    {\n      name: 'value_if_na',\n      description: 'The value to return if the first argument is a #N/A error.',\n      optional: true,\n      acceptedTypes: ['any'],\n    },\n  ];\n\n  category = 'logical' as const;\n\n  protected main(value: any, valueIfNa?: any) {\n    if (FormulaError.is(value) && value.code === '#N/A') {\n      return valueIfNa;\n    }\n    return value;\n  }\n}\n","import { BaseFunction, FormulaError } from '@gridsheet/core';\nimport { type FunctionArgumentDefinition } from '@gridsheet/core';\nimport { ensureBoolean } from '@gridsheet/core';\n\nconst description = `Evaluates multiple conditions and returns the value corresponding to the first TRUE condition.\nArguments must be supplied in (condition, value) pairs.`;\n\nexport class IfsFunction extends BaseFunction {\n  example = 'IFS(A1>90, \"A\", A1>70, \"B\", A1>50, \"C\")';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    { name: 'condition', description: 'Condition to evaluate.', acceptedTypes: ['boolean'], variadic: true },\n    { name: 'value', description: 'Value to return if condition is TRUE.', acceptedTypes: ['any'], variadic: true },\n  ];\n  category = 'logical' as const;\n\n  protected validate(args: any[]): any[] {\n    if (args.length < 2) {\n      throw new FormulaError('#N/A', 'IFS requires at least one condition-value pair.');\n    }\n    if (args.length % 2 !== 0) {\n      throw new FormulaError('#N/A', 'IFS requires an even number of arguments (condition, value) pairs.');\n    }\n    for (let i = 0; i < args.length; i += 2) {\n      if (ensureBoolean(args[i])) {\n        return [args[i + 1]];\n      }\n    }\n    throw new FormulaError('#N/A', 'No condition in IFS was met.');\n  }\n\n  protected main(result: any) {\n    return result;\n  }\n}\n","import type { FunctionMapping } from '@gridsheet/core';\nimport { XorFunction } from './xor';\nimport { IfnaFunction } from './ifna';\nimport { IfsFunction } from './ifs';\n\nexport const logicalFunctions: FunctionMapping = {\n  xor: XorFunction,\n  ifna: IfnaFunction,\n  ifs: IfsFunction,\n};\n\nexport default logicalFunctions;\n","import { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport { Sheet } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the referenced cell contains a formula.`;\n\nexport class IsformulaFunction extends BaseFunction {\n  example = 'ISFORMULA(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'reference',\n      description: 'The cell reference to check for a formula.',\n      acceptedTypes: ['reference'],\n      takesMatrix: true,\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(ref: Sheet) {\n    const cell = ref.getCell({ y: ref.top, x: ref.left }, { resolution: 'SYSTEM' });\n    const raw = cell?.value;\n    return typeof raw === 'string' && raw.startsWith('=');\n  }\n}\n","import { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the referenced cell is empty.`;\n\nexport class IsblankFunction extends BaseFunction {\n  example = 'ISBLANK(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'A reference to a cell to check for emptiness.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return value === null || value === undefined || value === '';\n  }\n}\n","import { BaseFunction, FormulaError } from '@gridsheet/core';\nimport type { FunctionArgumentDefinition, FunctionProps } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\nimport { Sheet } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is any error other than #N/A.`;\n\nexport class IserrFunction extends BaseFunction {\n  example = 'ISERR(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for a non-#N/A error.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    if (value instanceof Error) {\n      return true;\n    }\n    return FormulaError.is(value) && value.code !== '#N/A';\n  }\n}\n","import { BaseFunction, FormulaError } from '@gridsheet/core';\nimport type { FunctionArgumentDefinition, FunctionProps } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is any error value.`;\n\nexport class IserrorFunction extends BaseFunction {\n  example = 'ISERROR(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for an error.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return FormulaError.is(value) || value instanceof Error;\n  }\n}\n","import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is TRUE or FALSE.`;\n\nexport class IslogicalFunction extends BaseFunction {\n  example = 'ISLOGICAL(TRUE)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for being logical (TRUE or FALSE).',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return typeof value === 'boolean';\n  }\n}\n","import { BaseFunction, FormulaError } from '@gridsheet/core';\nimport type { FunctionArgumentDefinition, FunctionProps } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\nimport { Sheet } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is the #N/A error value.`;\n\nexport class IsnaFunction extends BaseFunction {\n  example = 'ISNA(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for the #N/A error.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return FormulaError.is(value) && value.code === '#N/A';\n  }\n}\n","import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is not a text string.`;\n\nexport class IsnontextFunction extends BaseFunction {\n  example = 'ISNONTEXT(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for being non-text.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return typeof value !== 'string';\n  }\n}\n","import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is a text string.`;\n\nexport class IstextFunction extends BaseFunction {\n  example = 'ISTEXT(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for being text.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return typeof value === 'string';\n  }\n}\n","import { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport { Sheet } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is a valid cell reference.`;\n\nexport class IsrefFunction extends BaseFunction {\n  example = 'ISREF(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for being a cell reference.',\n      acceptedTypes: ['any'],\n      takesMatrix: true,\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return Sheet.is(value);\n  }\n}\n","import { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport { ensureNumber } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns the argument provided as a number.`;\n\nexport class NFunction extends BaseFunction {\n  example = 'N(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to convert to a number.',\n      acceptedTypes: ['any'],\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    if (typeof value === 'boolean') {\n      return value ? 1 : 0;\n    }\n    if (value instanceof Date) {\n      return value.getTime();\n    }\n    if (value === null || value === undefined || value === '') {\n      return 0;\n    }\n    try {\n      return ensureNumber(value);\n    } catch {\n      return 0;\n    }\n  }\n}\n","import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns the error value #N/A, meaning \"value not available\".`;\n\nexport class NaFunction extends BaseFunction {\n  example = 'NA()';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [];\n  category: FunctionCategory = 'information';\n\n  protected main() {\n    throw new FormulaError('#N/A', 'N/A');\n  }\n}\n","import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns TRUE if the value is a date.`;\n\nexport class IsdateFunction extends BaseFunction {\n  example = 'ISDATE(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for being a date.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    return value instanceof Date && !isNaN(value.getTime());\n  }\n}\n","import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst EMAIL_REGEX = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/;\n\nconst description = `Returns TRUE if the value is a valid email address.`;\n\nexport class IsemailFunction extends BaseFunction {\n  example = 'ISEMAIL(A1)';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [\n    {\n      name: 'value',\n      description: 'The value to check for being a valid email address.',\n      acceptedTypes: ['any'],\n      errorTolerant: true,\n    },\n  ];\n  category: FunctionCategory = 'information';\n\n  protected main(value: any) {\n    if (typeof value !== 'string') {\n      return false;\n    }\n    return EMAIL_REGEX.test(value);\n  }\n}\n","import { FormulaError } from '@gridsheet/core';\nimport { BaseFunction, type FunctionArgumentDefinition } from '@gridsheet/core';\nimport type { FunctionCategory } from '@gridsheet/core';\n\nconst description = `Returns the total number of sheets in the spreadsheet.`;\n\nexport class SheetsFunction extends BaseFunction {\n  example = 'SHEETS()';\n  description = description;\n  defs: FunctionArgumentDefinition[] = [];\n  category: FunctionCategory = 'information';\n\n  protected main() {\n    const sheetIdsByName = this.sheet.registry.sheetIdsByName;\n    const count = Object.keys(sheetIdsByName).length;\n    // If wire has no registered sheets (e.g. standalone sheet), return 1\n    return count === 0 ? 1 : count;\n  }\n}\n","import type { FunctionMapping } from '@gridsheet/core';\nimport { IsformulaFunction } from './isformula';\nimport { IsblankFunction } from './isblank';\nimport { IserrFunction } from './iserr';\nimport { IserrorFunction } from './iserror';\nimport { IslogicalFunction } from './islogical';\nimport { IsnaFunction } from './isna';\nimport { IsnontextFunction } from './isnontext';\nimport { IstextFunction } from './istext';\nimport { IsrefFunction } from './isref';\nimport { NFunction } from './n';\nimport { NaFunction } from './na';\nimport { IsdateFunction } from './isdate';\nimport { IsemailFunction } from './isemail';\nimport { SheetsFunction } from './sheets';\n\nexport const informationFunctions: FunctionMapping = {\n  isformula: IsformulaFunction,\n  isblank: IsblankFunction,\n  iserr: IserrFunction,\n  iserror: IserrorFunction,\n  islogical: IslogicalFunction,\n  isna: IsnaFunction,\n  isnontext: IsnontextFunction,\n  istext: IstextFunction,\n  isref: IsrefFunction,\n  n: NFunction,\n  na: NaFunction,\n  isdate: IsdateFunction,\n  isemail: IsemailFunction,\n  sheets: SheetsFunction,\n};\n\nexport default informationFunctions;\n","import type { FunctionMapping, RegistryProps } from '@gridsheet/core';\nimport { createBook } from '@gridsheet/core';\nimport { mathFunctions } from './math';\nimport { statisticsFunctions } from './statistics';\nimport { textFunctions } from './text';\nimport { lookupFunctions } from './lookup';\nimport { timeFunctions } from './time';\nimport { logicalFunctions } from './logical';\nimport { informationFunctions } from './information';\n\n/** All extended functions combined into a single FunctionMapping. */\nexport const allFunctions: FunctionMapping = {\n  ...mathFunctions,\n  ...statisticsFunctions,\n  ...textFunctions,\n  ...lookupFunctions,\n  ...timeFunctions,\n  ...logicalFunctions,\n  ...informationFunctions,\n};\n\n/** createBook with all extended functions pre-loaded. User-supplied additionalFunctions are merged on top. */\nexport const createSpellbook = ({ additionalFunctions, ...rest }: RegistryProps = {}) =>\n  createBook({ ...rest, additionalFunctions: { ...allFunctions, ...additionalFunctions } });\n\nexport default allFunctions;\n"],"names":["description","XorFunction","BaseFunction","values","acc","val","_IfnaFunction","value","valueIfNa","FormulaError","IfnaFunction","IfsFunction","args","i","ensureBoolean","result","logicalFunctions","IsformulaFunction","ref","cell","raw","IsblankFunction","IserrFunction","IserrorFunction","IslogicalFunction","IsnaFunction","IsnontextFunction","IstextFunction","IsrefFunction","Sheet","NFunction","ensureNumber","NaFunction","IsdateFunction","EMAIL_REGEX","IsemailFunction","SheetsFunction","sheetIdsByName","count","informationFunctions","allFunctions","mathFunctions","statisticsFunctions","textFunctions","lookupFunctions","timeFunctions","createSpellbook","additionalFunctions","rest","createBook"],"mappings":"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"}

package/dist/lookup/index.d.ts

@@ -0,0 +1,6 @@
+export * from '../functions/src/lookup/index'
+export {}
+import _default from '../functions/src/lookup/index'
+export default _default
+export * from '../functions/src/lookup/index'
+export {}