@dxos/plugin-sheet 0.6.8-main.046e6cf

package/dist/lib/browser/chunk-AT2FJXQX.mjs

@@ -0,0 +1,861 @@
+import {
+  ValueTypeEnum
+} from "./chunk-6VPEAUG6.mjs";
+
+// packages/plugins/plugin-sheet/src/components/ComputeGraph/graph.ts
+import { HyperFormula } from "hyperformula";
+import { Event } from "@dxos/async";
+import { PublicKey } from "@dxos/keys";
+import { log as log2 } from "@dxos/log";
+
+// packages/plugins/plugin-sheet/src/components/ComputeGraph/async-function.ts
+import { CellError, ErrorType, EmptyValue, FunctionPlugin } from "hyperformula";
+import { debounce } from "@dxos/async";
+import { log } from "@dxos/log";
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/components/ComputeGraph/async-function.ts";
+var defaultFunctionContextOptions = {
+  defaultTtl: 5e3,
+  recalculationDelay: 200
+};
+var FunctionContext = class _FunctionContext {
+  // Mangle name with params.
+  static createInvocationKey(name, ...args) {
+    return JSON.stringify({
+      name,
+      ...args
+    });
+  }
+  constructor(_hf, _space, onUpdate, _options = defaultFunctionContextOptions) {
+    this._hf = _hf;
+    this._space = _space;
+    this._options = _options;
+    this._cache = /* @__PURE__ */ new Map();
+    this._pending = /* @__PURE__ */ new Map();
+    this._invocations = {};
+    this._onUpdate = debounce(() => {
+      this._hf.resumeEvaluation();
+      onUpdate(this);
+    }, this._options.recalculationDelay);
+  }
+  get space() {
+    return this._space;
+  }
+  get info() {
+    return {
+      cache: this._cache.size,
+      invocations: this._invocations
+    };
+  }
+  flush() {
+    this._cache.clear();
+    this._invocations = {};
+  }
+  /**
+  * Exec the function if TTL has expired.
+  * Return the cached value.
+  */
+  invokeFunction(name, state, args, cb, options) {
+    const ttl = options?.ttl ?? this._options.defaultTtl;
+    const { formulaAddress: cell } = state;
+    const invocationKey = _FunctionContext.createInvocationKey(name, ...args);
+    const { value = void 0, ts = 0 } = this._cache.get(invocationKey) ?? {};
+    const now = Date.now();
+    const delta = now - ts;
+    if ((!ts || delta > ttl) && !this._pending.has(invocationKey)) {
+      this._pending.set(invocationKey, now);
+      setTimeout(async () => {
+        this._invocations[name] = (this._invocations[name] ?? 0) + 1;
+        try {
+          const value2 = await cb(...args);
+          this._cache.set(invocationKey, {
+            value: value2,
+            ts: Date.now()
+          });
+          log("set", {
+            cell,
+            value: value2
+          }, {
+            F: __dxlog_file,
+            L: 116,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          this._onUpdate();
+        } catch (err) {
+          log.warn("failed", {
+            cell,
+            err
+          }, {
+            F: __dxlog_file,
+            L: 120,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          this._cache.set(invocationKey, {
+            value: new CellError(ErrorType.ERROR, "Function failed."),
+            ts: Date.now()
+          });
+        } finally {
+          this._pending.delete(invocationKey);
+        }
+      });
+    }
+    log("invoke", {
+      cell,
+      name,
+      args,
+      cache: value
+    }, {
+      F: __dxlog_file,
+      L: 128,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    return value;
+  }
+};
+var FunctionPluginAsync = class extends FunctionPlugin {
+  get context() {
+    return this.config.context;
+  }
+  runAsyncFunction(ast, state, cb, options) {
+    const { procedureName } = ast;
+    const metadata = this.metadata(procedureName);
+    return this.runFunction(ast.args, state, metadata, (...args) => {
+      return this.context.invokeFunction(procedureName, state, args, cb, options) ?? EmptyValue;
+    });
+  }
+};
+
+// packages/plugins/plugin-sheet/src/components/ComputeGraph/custom.ts
+import { FunctionArgumentType } from "hyperformula";
+import { getDeep } from "@dxos/util";
+var parseNumberString = (str) => {
+  return parseFloat(str.replace(/[^\d.]/g, ""));
+};
+var CustomPlugin = class extends FunctionPluginAsync {
+  test(ast, state) {
+    const handler = async () => {
+      return Math.random();
+    };
+    return this.runAsyncFunction(ast, state, handler);
+  }
+  crypto(ast, state) {
+    const handler = async (_currency) => {
+      const currency = (_currency || "USD").toUpperCase();
+      const result = await fetch(`https://api.coindesk.com/v1/bpi/currentprice/${currency}.json`);
+      const data = await result.json();
+      const rate = getDeep(data, [
+        "bpi",
+        currency,
+        "rate"
+      ]);
+      if (!rate) {
+        return NaN;
+      }
+      return parseNumberString(rate);
+    };
+    return this.runAsyncFunction(ast, state, handler, {
+      ttl: 1e4
+    });
+  }
+};
+CustomPlugin.implementedFunctions = {
+  TEST: {
+    method: "test",
+    parameters: [],
+    isVolatile: true
+  },
+  CRYPTO: {
+    method: "crypto",
+    parameters: [
+      {
+        argumentType: FunctionArgumentType.STRING,
+        optionalArg: true
+      }
+    ],
+    isVolatile: true
+  }
+};
+var CustomPluginTranslations = {
+  enGB: {
+    TEST: "TEST",
+    CRYPTO: "CRYPTO"
+  },
+  enUS: {
+    TEST: "TEST",
+    CRYPTO: "CRYPTO"
+  }
+};
+
+// packages/plugins/plugin-sheet/src/components/ComputeGraph/edge-function.ts
+import { CellError as CellError2, ErrorType as ErrorType2, FunctionArgumentType as FunctionArgumentType2 } from "hyperformula";
+import { Filter, getMeta } from "@dxos/client/echo";
+import { getUserFunctionUrlInMetadata } from "@dxos/plugin-script/edge";
+import { ScriptType } from "@dxos/plugin-script/types";
+var EdgeFunctionPlugin = class extends FunctionPluginAsync {
+  edge(ast, state) {
+    const handler = async (binding) => {
+      const space = this.context.space;
+      if (!space) {
+        return new CellError2(ErrorType2.VALUE, "No space");
+      }
+      const { objects: [script] } = await space.db.query(Filter.schema(ScriptType, {
+        binding
+      })).run();
+      if (!script) {
+        return new CellError2(ErrorType2.VALUE, "No script");
+      }
+      const path = getUserFunctionUrlInMetadata(getMeta(script));
+      const result = await fetch(`https://functions-staging.dxos.workers.dev${path}`, {
+        method: "POST"
+      });
+      return await result.text();
+    };
+    return this.runAsyncFunction(ast, state, handler, {
+      ttl: 1e4
+    });
+  }
+};
+EdgeFunctionPlugin.implementedFunctions = {
+  EDGE: {
+    method: "edge",
+    parameters: [
+      {
+        argumentType: FunctionArgumentType2.STRING
+      }
+    ],
+    isVolatile: true
+  }
+};
+var EdgeFunctionPluginTranslations = {
+  enGB: {
+    EDGE: "EDGE"
+  },
+  enUS: {
+    EDGE: "EDGE"
+  }
+};
+
+// packages/plugins/plugin-sheet/src/components/ComputeGraph/graph.ts
+var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/components/ComputeGraph/graph.ts";
+var createComputeGraph = (space) => {
+  HyperFormula.registerFunctionPlugin(CustomPlugin, CustomPluginTranslations);
+  HyperFormula.registerFunctionPlugin(EdgeFunctionPlugin, EdgeFunctionPluginTranslations);
+  const hf = HyperFormula.buildEmpty({
+    licenseKey: "gpl-v3"
+  });
+  return new ComputeGraph(hf, space);
+};
+var ComputeGraph = class {
+  constructor(hf, _space) {
+    this.hf = hf;
+    this._space = _space;
+    this.id = `graph-${PublicKey.random().truncate()}`;
+    this.update = new Event();
+    this.context = new FunctionContext(this.hf, this._space, () => {
+      this.refresh();
+    });
+    this.hf.updateConfig({
+      context: this.context
+    });
+  }
+  refresh() {
+    log2("refresh", {
+      id: this.id
+    }, {
+      F: __dxlog_file2,
+      L: 49,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    this.update.emit();
+  }
+};
+
+// packages/plugins/plugin-sheet/src/components/ComputeGraph/graph-context.tsx
+import React, { createContext, useContext, useEffect } from "react";
+var ComputeGraphContext = /* @__PURE__ */ createContext({
+  graphs: {},
+  setGraph: () => {
+  }
+});
+var ComputeGraphContextProvider = ({ children, graphs, setGraph }) => {
+  return /* @__PURE__ */ React.createElement(ComputeGraphContext.Provider, {
+    value: {
+      graphs,
+      setGraph
+    }
+  }, children);
+};
+var useComputeGraph = (space) => {
+  const { graphs, setGraph } = useContext(ComputeGraphContext);
+  const graph = graphs[space.id] ?? createComputeGraph(space);
+  useEffect(() => {
+    if (!graphs[space.id]) {
+      setGraph(space.id, graph);
+    }
+  }, [
+    space
+  ]);
+  return graph;
+};
+
+// packages/plugins/plugin-sheet/src/model/types.ts
+import { invariant } from "@dxos/invariant";
+var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/model/types.ts";
+var MAX_COLUMNS = 26 * 26;
+var posEquals = (a, b) => {
+  return a?.column === b?.column && a?.row === b?.row;
+};
+var columnLetter = (column) => {
+  invariant(column < MAX_COLUMNS, `Invalid column: ${column}`, {
+    F: __dxlog_file3,
+    L: 17,
+    S: void 0,
+    A: [
+      "column < MAX_COLUMNS",
+      "`Invalid column: ${column}`"
+    ]
+  });
+  return (column >= 26 ? String.fromCharCode("A".charCodeAt(0) + Math.floor(column / 26) - 1) : "") + String.fromCharCode("A".charCodeAt(0) + column % 26);
+};
+var addressToA1Notation = ({ column, row }) => {
+  return `${columnLetter(column)}${row + 1}`;
+};
+var addressFromA1Notation = (ref) => {
+  const match = ref.match(/([A-Z]+)(\d+)/);
+  invariant(match, `Invalid notation: ${ref}`, {
+    F: __dxlog_file3,
+    L: 30,
+    S: void 0,
+    A: [
+      "match",
+      "`Invalid notation: ${ref}`"
+    ]
+  });
+  return {
+    row: parseInt(match[2], 10) - 1,
+    column: match[1].split("").reduce((acc, c) => acc * 26 + c.charCodeAt(0) - "A".charCodeAt(0) + 1, 0) - 1
+  };
+};
+var rangeToA1Notation = (range) => {
+  return [
+    range?.from && addressToA1Notation(range?.from),
+    range?.to && addressToA1Notation(range?.to)
+  ].filter(Boolean).join(":");
+};
+var inRange = (range, cell) => {
+  if (!range) {
+    return false;
+  }
+  const { from, to } = range;
+  if (from && posEquals(from, cell) || to && posEquals(to, cell)) {
+    return true;
+  }
+  if (!from || !to) {
+    return false;
+  }
+  const { column: c1, row: r1 } = from;
+  const { column: c2, row: r2 } = to;
+  const cMin = Math.min(c1, c2);
+  const cMax = Math.max(c1, c2);
+  const rMin = Math.min(r1, r2);
+  const rMax = Math.max(r1, r2);
+  const { column, row } = cell;
+  return column >= cMin && column <= cMax && row >= rMin && row <= rMax;
+};
+
+// packages/plugins/plugin-sheet/src/model/model.ts
+import { DetailedCellError, ExportedCellChange } from "hyperformula";
+import { Event as Event2 } from "@dxos/async";
+import { Context } from "@dxos/context";
+import { invariant as invariant2 } from "@dxos/invariant";
+import { PublicKey as PublicKey2 } from "@dxos/keys";
+import { log as log3 } from "@dxos/log";
+
+// packages/plugins/plugin-sheet/src/model/util.ts
+import { randomBytes } from "@dxos/crypto";
+var ApiError = class extends Error {
+};
+var ReadonlyException = class extends ApiError {
+};
+var RangeException = class extends ApiError {
+  constructor(n) {
+    super();
+  }
+};
+var createIndex = (length = 8) => {
+  const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+  const charactersLength = characters.length;
+  const randomBuffer = randomBytes(length);
+  return Array.from(randomBuffer, (byte) => characters[byte % charactersLength]).join("");
+};
+var createIndices = (length) => Array.from({
+  length
+}).map(() => createIndex());
+
+// packages/plugins/plugin-sheet/src/model/model.ts
+var __dxlog_file4 = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/model/model.ts";
+var DEFAULT_ROWS = 500;
+var DEFAULT_COLUMNS = 26 * 2;
+var typeMap = {
+  BOOLEAN: ValueTypeEnum.Boolean,
+  NUMBER_RAW: ValueTypeEnum.Number,
+  NUMBER_PERCENT: ValueTypeEnum.Percent,
+  NUMBER_CURRENCY: ValueTypeEnum.Currency,
+  NUMBER_DATETIME: ValueTypeEnum.DateTime,
+  NUMBER_DATE: ValueTypeEnum.Date,
+  NUMBER_TIME: ValueTypeEnum.Time
+};
+var defaultOptions = {
+  rows: 50,
+  columns: 26
+};
+var getTopLeft = (range) => {
+  const to = range.to ?? range.from;
+  return {
+    row: Math.min(range.from.row, to.row),
+    column: Math.min(range.from.column, to.column)
+  };
+};
+var toSimpleCellAddress = (sheet, cell) => ({
+  sheet,
+  row: cell.row,
+  col: cell.column
+});
+var toModelRange = (sheet, range) => ({
+  start: toSimpleCellAddress(sheet, range.from),
+  end: toSimpleCellAddress(sheet, range.to ?? range.from)
+});
+var SheetModel = class {
+  constructor(_graph, _sheet, options = {}) {
+    this._graph = _graph;
+    this._sheet = _sheet;
+    this.id = `model-${PublicKey2.random().truncate()}`;
+    this._ctx = void 0;
+    this.update = new Event2();
+    const name = this._sheet.id;
+    if (!this._graph.hf.doesSheetExist(name)) {
+      this._graph.hf.addSheet(name);
+    }
+    this._sheetId = this._graph.hf.getSheetId(name);
+    this._options = {
+      ...defaultOptions,
+      ...options
+    };
+    this.reset();
+  }
+  get graph() {
+    return this._graph;
+  }
+  get sheet() {
+    return this._sheet;
+  }
+  get readonly() {
+    return this._options.readonly;
+  }
+  get bounds() {
+    return {
+      rows: this._sheet.rows.length,
+      columns: this._sheet.columns.length
+    };
+  }
+  get functions() {
+    return this._graph.hf.getRegisteredFunctionNames();
+  }
+  get initialized() {
+    return !!this._ctx;
+  }
+  /**
+  * Initialize sheet and engine.
+  */
+  async initialize() {
+    log3("initialize", {
+      id: this.id
+    }, {
+      F: __dxlog_file4,
+      L: 130,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    invariant2(!this.initialized, "Already initialized.", {
+      F: __dxlog_file4,
+      L: 131,
+      S: this,
+      A: [
+        "!this.initialized",
+        "'Already initialized.'"
+      ]
+    });
+    this._ctx = new Context(void 0, {
+      F: __dxlog_file4,
+      L: 132
+    });
+    if (!this._sheet.rows.length) {
+      this._insertIndices(this._sheet.rows, 0, this._options.rows, DEFAULT_ROWS);
+    }
+    if (!this._sheet.columns.length) {
+      this._insertIndices(this._sheet.columns, 0, this._options.columns, DEFAULT_COLUMNS);
+    }
+    this.reset();
+    const unsubscribe = this._graph.update.on(() => this.update.emit());
+    this._ctx.onDispose(unsubscribe);
+    return this;
+  }
+  async destroy() {
+    log3("destroy", {
+      id: this.id
+    }, {
+      F: __dxlog_file4,
+      L: 149,
+      S: this,
+      C: (f, a) => f(...a)
+    });
+    if (this._ctx) {
+      await this._ctx.dispose();
+      this._ctx = void 0;
+    }
+  }
+  /**
+  * Update engine.
+  * NOTE: This resets the undo history.
+  * @deprecated
+  */
+  reset() {
+    this._graph.hf.clearSheet(this._sheetId);
+    Object.entries(this._sheet.cells).forEach(([key, { value }]) => {
+      const { column, row } = this.addressFromIndex(key);
+      if (typeof value === "string" && value.charAt(0) === "=") {
+        value = this.mapFormulaIndicesToRefs(value);
+      }
+      this._graph.hf.setCellContents({
+        sheet: this._sheetId,
+        row,
+        col: column
+      }, value);
+    });
+  }
+  /**
+  * Recalculate formulas.
+  * NOTE: This resets the undo history.
+  * https://hyperformula.handsontable.com/guide/volatile-functions.html#volatile-actions
+  * @deprecated
+  */
+  // TODO(burdon): Remove.
+  recalculate() {
+    this._graph.hf.rebuildAndRecalculate();
+  }
+  insertRows(i, n = 1) {
+    this._insertIndices(this._sheet.rows, i, n, DEFAULT_ROWS);
+    this.reset();
+  }
+  insertColumns(i, n = 1) {
+    this._insertIndices(this._sheet.columns, i, n, DEFAULT_COLUMNS);
+    this.reset();
+  }
+  //
+  // Undoable actions.
+  // TODO(burdon): Group undoable methods; consistently update hf/sheet.
+  //
+  /**
+  * Clear range of values.
+  */
+  clear(range) {
+    const topLeft = getTopLeft(range);
+    const values = this._iterRange(range, () => null);
+    this._graph.hf.setCellContents(toSimpleCellAddress(this._sheetId, topLeft), values);
+    this._iterRange(range, (cell) => {
+      const idx = this.addressToIndex(cell);
+      delete this._sheet.cells[idx];
+    });
+  }
+  cut(range) {
+    this._graph.hf.cut(toModelRange(this._sheetId, range));
+    this._iterRange(range, (cell) => {
+      const idx = this.addressToIndex(cell);
+      delete this._sheet.cells[idx];
+    });
+  }
+  copy(range) {
+    this._graph.hf.copy(toModelRange(this._sheetId, range));
+  }
+  paste(cell) {
+    if (!this._graph.hf.isClipboardEmpty()) {
+      const changes = this._graph.hf.paste(toSimpleCellAddress(this._sheetId, cell));
+      for (const change of changes) {
+        if (change instanceof ExportedCellChange) {
+          const { address, newValue } = change;
+          const idx = this.addressToIndex({
+            row: address.row,
+            column: address.col
+          });
+          this._sheet.cells[idx] = {
+            value: newValue
+          };
+        }
+      }
+    }
+  }
+  // TODO(burdon): Display undo/redo state.
+  undo() {
+    if (this._graph.hf.isThereSomethingToUndo()) {
+      this._graph.hf.undo();
+      this.update.emit();
+    }
+  }
+  redo() {
+    if (this._graph.hf.isThereSomethingToRedo()) {
+      this._graph.hf.redo();
+      this.update.emit();
+    }
+  }
+  /**
+  * Get value from sheet.
+  */
+  getCellValue(cell) {
+    const idx = this.addressToIndex(cell);
+    return this._sheet.cells[idx]?.value ?? null;
+  }
+  /**
+  * Get value as a string for editing.
+  */
+  getCellText(cell) {
+    const value = this.getCellValue(cell);
+    if (value == null) {
+      return void 0;
+    }
+    if (typeof value === "string" && value.charAt(0) === "=") {
+      return this.mapFormulaIndicesToRefs(value);
+    } else {
+      return String(value);
+    }
+  }
+  /**
+  * Get array of raw values from sheet.
+  */
+  getCellValues(range) {
+    return this._iterRange(range, (cell) => this.getCellValue(cell));
+  }
+  /**
+  * Gets the regular or computed value from the engine.
+  */
+  getValue(cell) {
+    const value = this._graph.hf.getCellValue(toSimpleCellAddress(this._sheetId, cell));
+    if (value instanceof DetailedCellError) {
+      return value.toString();
+    }
+    return value;
+  }
+  /**
+  * Get value type.
+  */
+  getValueType(cell) {
+    const addr = toSimpleCellAddress(this._sheetId, cell);
+    const type = this._graph.hf.getCellValueDetailedType(addr);
+    return typeMap[type];
+  }
+  /**
+  * Sets the value, updating the sheet and engine.
+  */
+  setValue(cell, value) {
+    if (this._options.readonly) {
+      throw new ReadonlyException();
+    }
+    let refresh = false;
+    if (cell.row >= this._sheet.rows.length) {
+      this._insertIndices(this._sheet.rows, cell.row, 1, DEFAULT_ROWS);
+      refresh = true;
+    }
+    if (cell.column >= this._sheet.columns.length) {
+      this._insertIndices(this._sheet.columns, cell.column, 1, DEFAULT_COLUMNS);
+      refresh = true;
+    }
+    if (refresh) {
+      this.reset();
+    }
+    this._graph.hf.setCellContents({
+      sheet: this._sheetId,
+      row: cell.row,
+      col: cell.column
+    }, [
+      [
+        value
+      ]
+    ]);
+    const idx = this.addressToIndex(cell);
+    if (value === void 0 || value === null) {
+      delete this._sheet.cells[idx];
+    } else {
+      if (typeof value === "string" && value.charAt(0) === "=") {
+        value = this.mapFormulaRefsToIndices(value);
+      }
+      this._sheet.cells[idx] = {
+        value
+      };
+    }
+  }
+  /**
+  * Sets values from a simple map.
+  */
+  setValues(values) {
+    Object.entries(values).forEach(([key, { value }]) => {
+      this.setValue(addressFromA1Notation(key), value);
+    });
+  }
+  /**
+  * Iterate range.
+  */
+  _iterRange(range, cb) {
+    const to = range.to ?? range.from;
+    const rowRange = [
+      Math.min(range.from.row, to.row),
+      Math.max(range.from.row, to.row)
+    ];
+    const columnRange = [
+      Math.min(range.from.column, to.column),
+      Math.max(range.from.column, to.column)
+    ];
+    const rows = [];
+    for (let row = rowRange[0]; row <= rowRange[1]; row++) {
+      const rowCells = [];
+      for (let column = columnRange[0]; column <= columnRange[1]; column++) {
+        const value = cb({
+          row,
+          column
+        });
+        if (value !== void 0) {
+          rowCells.push(value);
+        }
+      }
+      rows.push(rowCells);
+    }
+    return rows;
+  }
+  /**
+  *
+  */
+  // TODO(burdon): Insert indices into sheet.
+  _insertIndices(indices, i, n, max) {
+    if (i + n > max) {
+      throw new RangeException(i + n);
+    }
+    const idx = createIndices(n);
+    indices.splice(i, 0, ...idx);
+  }
+  // TODO(burdon): Delete index.
+  _deleteIndices(indices, i, n) {
+    throw new Error("Not implemented");
+  }
+  // TODO(burdon): Move. Cannot use fractional without changing. Switch back to using unique IDs?
+  _moveIndices(indices, i, j, n) {
+    throw new Error("Not implemented");
+  }
+  //
+  // Indices.
+  //
+  /**
+  * E.g., "A1" => "x1@y1".
+  */
+  addressToIndex(cell) {
+    return `${this._sheet.columns[cell.column]}@${this._sheet.rows[cell.row]}`;
+  }
+  /**
+  * E.g., "x1@y1" => "A1".
+  */
+  addressFromIndex(idx) {
+    const [column, row] = idx.split("@");
+    return {
+      column: this._sheet.columns.indexOf(column),
+      row: this._sheet.rows.indexOf(row)
+    };
+  }
+  /**
+  * E.g., "A1:B2" => "x1@y1:x2@y2".
+  */
+  rangeToIndex(range) {
+    return [
+      range.from,
+      range.to ?? range.from
+    ].map((cell) => this.addressToIndex(cell)).join(":");
+  }
+  /**
+  * E.g., "x1@y1:x2@y2" => "A1:B2".
+  */
+  rangeFromIndex(idx) {
+    const [from, to] = idx.split(":").map((idx2) => this.addressFromIndex(idx2));
+    return {
+      from,
+      to
+    };
+  }
+  /**
+  * Map from A1 notation to indices.
+  */
+  mapFormulaRefsToIndices(formula) {
+    invariant2(formula.charAt(0) === "=", void 0, {
+      F: __dxlog_file4,
+      L: 439,
+      S: this,
+      A: [
+        "formula.charAt(0) === '='",
+        ""
+      ]
+    });
+    return formula.replace(/([a-zA-Z]+)([0-9]+)/g, (match) => {
+      return this.addressToIndex(addressFromA1Notation(match));
+    });
+  }
+  /**
+  * Map from indices to A1 notation.
+  */
+  mapFormulaIndicesToRefs(formula) {
+    invariant2(formula.charAt(0) === "=", void 0, {
+      F: __dxlog_file4,
+      L: 449,
+      S: this,
+      A: [
+        "formula.charAt(0) === '='",
+        ""
+      ]
+    });
+    return formula.replace(/([a-zA-Z0-9]+)@([a-zA-Z0-9]+)/g, (idx) => {
+      return addressToA1Notation(this.addressFromIndex(idx));
+    });
+  }
+  //
+  // Values
+  //
+  /**
+  * https://hyperformula.handsontable.com/guide/date-and-time-handling.html#example
+  * https://hyperformula.handsontable.com/api/interfaces/configparams.html#nulldate
+  * NOTE: TODAY() is number of FULL days since nullDate. It will typically be -1 days from NOW().
+  */
+  toLocalDate(num) {
+    const { year, month, day, hours, minutes, seconds } = this.toDateTime(num);
+    return new Date(year, month - 1, day, hours, minutes, seconds);
+  }
+  toDateTime(num) {
+    return this._graph.hf.numberToDateTime(num);
+  }
+  toDate(num) {
+    return this._graph.hf.numberToDate(num);
+  }
+  toTime(num) {
+    return this._graph.hf.numberToTime(num);
+  }
+};
+
+export {
+  createComputeGraph,
+  ComputeGraphContextProvider,
+  useComputeGraph,
+  posEquals,
+  columnLetter,
+  addressToA1Notation,
+  addressFromA1Notation,
+  rangeToA1Notation,
+  inRange,
+  SheetModel
+};
+//# sourceMappingURL=chunk-AT2FJXQX.mjs.map