@dxos/plugin-sheet 0.6.12-main.5cc132e → 0.6.12-main.7907542

package/dist/lib/node-esm/{chunk-GNNVBNCX.mjs → chunk-5WPZCXNS.mjs}

@@ -1,22 +1,71 @@
-import {
-  ValueTypeEnum
-} from "./chunk-WUPTZUTX.mjs";
+import { createRequire } from 'node:module';const require = createRequire(import.meta.url);
 
-// packages/plugins/plugin-sheet/src/components/ComputeGraph/graph.ts
-import { HyperFormula } from "hyperformula";
-import { Event } from "@dxos/async";
+// packages/plugins/plugin-sheet/src/graph/compute-graph.ts
+import { Event as Event2 } from "@dxos/async";
+import { Filter as Filter2, fullyQualifiedId } from "@dxos/client/echo";
+import { Resource as Resource2 } from "@dxos/context";
+import { getTypename } from "@dxos/echo-schema";
+import { invariant } from "@dxos/invariant";
 import { PublicKey } from "@dxos/keys";
-import { log as log2 } from "@dxos/log";
+import { log as log3 } from "@dxos/log";
+import { FunctionType as FunctionType2 } from "@dxos/plugin-script/types";
+import { nonNullable as nonNullable2 } from "@dxos/util";
+import { ExportedCellChange } from "#hyperformula";
 
-// packages/plugins/plugin-sheet/src/components/ComputeGraph/async-function.ts
-import { CellError, ErrorType, EmptyValue, FunctionPlugin } from "hyperformula";
+// packages/plugins/plugin-sheet/src/graph/compute-node.ts
+import { Event } from "@dxos/async";
+import { Resource } from "@dxos/context";
+import { DetailedCellError } from "#hyperformula";
+var ComputeNode = class extends Resource {
+  constructor(_graph, sheetId) {
+    super();
+    this._graph = _graph;
+    this.sheetId = sheetId;
+    this.update = new Event();
+  }
+  get graph() {
+    return this._graph;
+  }
+  clear() {
+    this._graph.hf.clearSheet(this.sheetId);
+  }
+  getValue(cell) {
+    const value = this._graph.hf.getCellValue({
+      sheet: this.sheetId,
+      row: cell.row,
+      col: cell.col
+    });
+    if (value instanceof DetailedCellError) {
+      return null;
+    }
+    return value;
+  }
+  setValue(cell, value) {
+    const mappedValue = typeof value === "string" && value.charAt(0) === "=" ? this._graph.mapFormulaToNative(value) : value;
+    this._graph.hf.setCellContents({
+      sheet: this.sheetId,
+      row: cell.row,
+      col: cell.col
+    }, [
+      [
+        mappedValue
+      ]
+    ]);
+  }
+  // TODO(burdon): Load data into sheet.
+  async _open() {
+  }
+};
+
+// packages/plugins/plugin-sheet/src/graph/functions/async-function.ts
 import defaultsDeep from "lodash.defaultsdeep";
 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";
+import { CellError, ErrorType, EmptyValue, FunctionPlugin } from "#hyperformula";
+var __dxlog_file = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/graph/functions/async-function.ts";
 var defaultFunctionContextOptions = {
   defaultTtl: 5e3,
-  recalculationDelay: 200,
+  debounceDelay: 200,
   remoteFunctionUrl: "https://edge.dxos.workers.dev/functions"
 };
 var FunctionContext = class _FunctionContext {
@@ -27,7 +76,7 @@ var FunctionContext = class _FunctionContext {
       ...args
     });
   }
-  constructor(_hf, _space, onUpdate, _options) {
+  constructor(_hf, _space, _options) {
     this._hf = _hf;
     this._space = _space;
     this._cache = /* @__PURE__ */ new Map();
@@ -35,10 +84,10 @@ var FunctionContext = class _FunctionContext {
     this._subscriptions = /* @__PURE__ */ new Map();
     this._invocations = {};
     this._options = defaultsDeep(_options ?? {}, defaultFunctionContextOptions);
-    this._onUpdate = debounce(() => {
+    this._onUpdate = debounce((update) => {
       this._hf.resumeEvaluation();
-      onUpdate(this);
-    }, this._options.recalculationDelay);
+      this._options.onUpdate?.(update);
+    }, this._options.debounceDelay);
   }
   get space() {
     return this._space;
@@ -88,18 +137,21 @@ var FunctionContext = class _FunctionContext {
             value: value2
           }, {
             F: __dxlog_file,
-            L: 136,
+            L: 143,
             S: this,
             C: (f, a) => f(...a)
           });
-          this._onUpdate();
+          this._onUpdate({
+            name,
+            cell
+          });
         } catch (err) {
           log.warn("failed", {
             cell,
             err
           }, {
             F: __dxlog_file,
-            L: 140,
+            L: 147,
             S: this,
             C: (f, a) => f(...a)
           });
@@ -119,17 +171,20 @@ var FunctionContext = class _FunctionContext {
       cache: value
     }, {
       F: __dxlog_file,
-      L: 148,
+      L: 155,
       S: this,
       C: (f, a) => f(...a)
     });
     return value;
   }
 };
-var FunctionPluginAsync = class extends FunctionPlugin {
+var AsyncFunctionPlugin = class extends FunctionPlugin {
   get context() {
     return this.config.context;
   }
+  /**
+  * Immediately returns cached value then runs the async function.
+  */
   runAsyncFunction(ast, state, cb, options) {
     const { procedureName } = ast;
     const metadata = this.metadata(procedureName);
@@ -139,53 +194,127 @@ var FunctionPluginAsync = class extends FunctionPlugin {
   }
 };
 
-// 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 = (functionPlugins = [], space, options) => {
-  functionPlugins.forEach(({ plugin, translations }) => {
-    HyperFormula.registerFunctionPlugin(plugin, translations);
-  });
-  const hf = HyperFormula.buildEmpty({
-    licenseKey: "gpl-v3"
-  });
-  return new ComputeGraph(hf, space, options);
-};
-var ComputeGraph = class {
-  constructor(hf, _space, _options) {
-    this.hf = hf;
-    this._space = _space;
-    this._options = _options;
-    this.id = `graph-${PublicKey.random().truncate()}`;
-    this.update = new Event();
-    this.context = new FunctionContext(this.hf, this._space, () => {
-      this.refresh();
-    }, this._options);
-    this.hf.updateConfig({
-      context: this.context
+// packages/plugins/plugin-sheet/src/graph/functions/edge-function.ts
+import { effect } from "@preact/signals-core";
+import { Filter, getMeta } from "@dxos/client/echo";
+import { log as log2 } from "@dxos/log";
+import { getUserFunctionUrlInMetadata } from "@dxos/plugin-script/edge";
+import { FunctionType } from "@dxos/plugin-script/types";
+import { nonNullable } from "@dxos/util";
+import { CellError as CellError2, ErrorType as ErrorType2, FunctionArgumentType } from "#hyperformula";
+var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/graph/functions/edge-function.ts";
+var EDGE_FUNCTION_NAME = "DX";
+var FUNCTION_TTL = 1e4;
+var EdgeFunctionPlugin = class extends AsyncFunctionPlugin {
+  dx(ast, state) {
+    const handler = (subscribe = false) => async (binding, ...args) => {
+      const space = this.context.space;
+      if (!space) {
+        return new CellError2(ErrorType2.REF, "Missing space");
+      }
+      const { objects: [fn] } = await space.db.query(Filter.schema(FunctionType, {
+        binding
+      })).run();
+      if (!fn) {
+        log2.info("Function not found", {
+          binding
+        }, {
+          F: __dxlog_file2,
+          L: 41,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        return new CellError2(ErrorType2.REF, "Function not found");
+      }
+      if (subscribe) {
+        const unsubscribe = effect(() => {
+          log2.info("function changed", {
+            fn
+          }, {
+            F: __dxlog_file2,
+            L: 47,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          const _ = fn?.version;
+          this.runAsyncFunction(ast, state, handler(false), {
+            ttl: FUNCTION_TTL
+          });
+        });
+        this.context.createSubscription(ast.procedureName, unsubscribe);
+      }
+      const path = getUserFunctionUrlInMetadata(getMeta(fn));
+      const result = await fetch(`${this.context.remoteFunctionUrl}${path}`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify({
+          args: args.filter(nonNullable)
+        })
+      });
+      return await result.text();
+    };
+    return this.runAsyncFunction(ast, state, handler(true), {
+      ttl: FUNCTION_TTL
     });
   }
-  refresh() {
-    log2("refresh", {
-      id: this.id
-    }, {
-      F: __dxlog_file2,
-      L: 59,
-      S: this,
-      C: (f, a) => f(...a)
-    });
-    this.update.emit();
+};
+EdgeFunctionPlugin.implementedFunctions = {
+  [EDGE_FUNCTION_NAME]: {
+    method: "dx",
+    parameters: [
+      // Binding
+      {
+        argumentType: FunctionArgumentType.STRING
+      },
+      // Remote function arguments (currently supporting up to 8).
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      },
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      },
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      },
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      },
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      },
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      },
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      },
+      {
+        argumentType: FunctionArgumentType.ANY,
+        optionalArg: true
+      }
+    ],
+    isVolatile: true
+  }
+};
+var EdgeFunctionPluginTranslations = {
+  enGB: {
+    [EDGE_FUNCTION_NAME]: "Remote function"
+  },
+  enUS: {
+    [EDGE_FUNCTION_NAME]: "Remote function"
   }
 };
 
-// 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/functions.ts
+// packages/plugins/plugin-sheet/src/graph/functions/function-defs.ts
 var defaultFunctions = [
   // Array
   {
@@ -2559,685 +2688,281 @@ var defaultFunctions = [
   }
 ];
 
-// 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
+// packages/plugins/plugin-sheet/src/graph/compute-graph.ts
+var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/graph/compute-graph.ts";
+var OBJECT_ID_LENGTH = 60;
+var createSheetName = ({ type, id }) => `${type}@${id}`;
+var parseSheetName = (name) => {
+  const [type, id] = name.split("@");
+  return id ? {
+    type,
+    id
+  } : {
+    id: type
   };
 };
-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/util.ts
-import { randomBytes } from "@dxos/crypto";
-var ApiError = class extends Error {
-};
-var ReadonlyException = class extends ApiError {
-};
-var RangeException = class extends ApiError {
-  constructor(n) {
+var ComputeGraph = class extends Resource2 {
+  constructor(_hf, _space, _options) {
     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());
-var addressToIndex = (sheet, cell) => {
-  return `${sheet.columns[cell.column]}@${sheet.rows[cell.row]}`;
-};
-var addressFromIndex = (sheet, idx) => {
-  const [column, row] = idx.split("@");
-  return {
-    column: sheet.columns.indexOf(column),
-    row: sheet.rows.indexOf(row)
-  };
-};
-var rangeFromIndex = (sheet, idx) => {
-  const [from, to] = idx.split(":").map((index) => addressFromIndex(sheet, index));
-  return {
-    from,
-    to
-  };
-};
-var closest = (cursor, cells) => {
-  let closestCell;
-  let closestDistance = Number.MAX_SAFE_INTEGER;
-  for (const cell of cells) {
-    const distance = Math.abs(cell.row - cursor.row) + Math.abs(cell.column - cursor.column);
-    if (distance < closestDistance) {
-      closestCell = cell;
-      closestDistance = distance;
-    }
-  }
-  return closestCell;
-};
-var compareIndexPositions = (sheet, indexA, indexB) => {
-  const { row: rowA, column: columnA } = addressFromIndex(sheet, indexA);
-  const { row: rowB, column: columnB } = addressFromIndex(sheet, indexB);
-  if (rowA !== rowB) {
-    return rowA - rowB;
-  } else {
-    return columnA - columnB;
-  }
-};
-
-// 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 = 100;
-var DEFAULT_COLUMNS = 26;
-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,
-  mapFormulaBindingFromId: () => (formula) => formula,
-  mapFormulaBindingToId: () => (formula) => formula
-};
-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, _space, options = {}) {
-    this._graph = _graph;
-    this._sheet = _sheet;
+    this._hf = _hf;
     this._space = _space;
-    this.id = `model-${PublicKey2.random().truncate()}`;
-    this._ctx = void 0;
-    this._functions = [];
+    this._options = _options;
+    this.id = `graph-${PublicKey.random().truncate()}`;
+    this._nodes = /* @__PURE__ */ new Map();
+    this._remoteFunctions = [];
     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.context = new FunctionContext(this._hf, this._space, this._options);
+    this._hf.updateConfig({
+      context: this.context
+    });
+    const onValuesUpdate = (changes) => {
+      for (const change of changes) {
+        if (change instanceof ExportedCellChange) {
+          const { sheet } = change;
+          const node = this._nodes.get(sheet);
+          if (node) {
+            node.update.emit({
+              type: "valuesUpdated",
+              change
+            });
+          }
+        }
+      }
     };
-    this.reset();
+    this._hf.on("valuesUpdated", onValuesUpdate);
+    this._ctx.onDispose(() => this._hf.off("valuesUpdated", onValuesUpdate));
   }
-  get graph() {
-    return this._graph;
-  }
-  get sheet() {
-    return this._sheet;
+  get hf() {
+    return this._hf;
   }
-  get readonly() {
-    return this._options.readonly;
-  }
-  get bounds() {
-    return {
-      rows: this._sheet.rows.length,
-      columns: this._sheet.columns.length
-    };
-  }
-  get functions() {
-    const hfFunctions = this._graph.hf.getRegisteredFunctionNames().map((name) => defaultFunctions.find((fn) => fn.name === name) ?? {
-      name
-    });
-    const echoFunctions = this._functions.map((fn) => ({
-      name: fn.binding
-    }));
+  getFunctions({ standard, echo } = {
+    standard: true,
+    echo: true
+  }) {
     return [
-      ...hfFunctions,
-      ...echoFunctions
+      ...standard ? this._hf.getRegisteredFunctionNames().map((name) => defaultFunctions.find((fn) => fn.name === name) ?? {
+        name
+      }) : [],
+      ...echo ? this._remoteFunctions.map((fn) => ({
+        name: fn.binding
+      })) : []
     ];
   }
-  get initialized() {
-    return !!this._ctx;
-  }
   /**
-  * Initialize sheet and engine.
+  * Get or create cell representing a sheet.
   */
-  async initialize() {
-    log3("initialize", {
-      id: this.id
-    }, {
-      F: __dxlog_file4,
-      L: 142,
-      S: this,
-      C: (f, a) => f(...a)
-    });
-    invariant2(!this.initialized, "Already initialized.", {
-      F: __dxlog_file4,
-      L: 143,
+  // TODO(burdon): Async (open node).
+  //  The graph should be an extensible factory that plugins extend with model constructors.
+  //  This would enable on-the-fly instantiation of new models when then are referenced.
+  //  E.g., Cross-object reference would be stored as "ObjectId!A1"
+  //  The graph would then load the object and create a ComputeNode (model) of the appropriate type.
+  getOrCreateNode(name) {
+    invariant(name.length, void 0, {
+      F: __dxlog_file3,
+      L: 117,
       S: this,
       A: [
-        "!this.initialized",
-        "'Already initialized.'"
+        "name.length",
+        ""
       ]
     });
-    this._ctx = new Context(void 0, {
-      F: __dxlog_file4,
-      L: 144
-    });
-    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);
-    if (this._space) {
-      const { Filter } = await import("@dxos/client/echo");
-      const { FunctionType } = await import("@dxos/plugin-script/types");
-      const query = this._space?.db.query(Filter.schema(FunctionType));
-      const unsubscribe2 = query.subscribe(({ objects }) => {
-        this._functions = objects.filter((fn) => fn.binding);
-        this.update.emit();
+    if (!this._hf.doesSheetExist(name)) {
+      log3.info("created node", {
+        space: this._space?.id,
+        sheet: name
+      }, {
+        F: __dxlog_file3,
+        L: 119,
+        S: this,
+        C: (f, a) => f(...a)
       });
-      this._ctx.onDispose(unsubscribe2);
+      this._hf.addSheet(name);
     }
-    return this;
-  }
-  async destroy() {
-    log3("destroy", {
-      id: this.id
-    }, {
-      F: __dxlog_file4,
-      L: 174,
+    const sheetId = this._hf.getSheetId(name);
+    invariant(sheetId !== void 0, void 0, {
+      F: __dxlog_file3,
+      L: 124,
       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 } = addressFromIndex(this._sheet, key);
-      if (typeof value === "string" && value.charAt(0) === "=") {
-        value = this.mapFormulaBindingToFormula(this.mapFormulaBindingFromId(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 = addressToIndex(this._sheet, cell);
-      delete this._sheet.cells[idx];
-    });
-  }
-  cut(range) {
-    this._graph.hf.cut(toModelRange(this._sheetId, range));
-    this._iterRange(range, (cell) => {
-      const idx = addressToIndex(this._sheet, 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 = addressToIndex(this._sheet, {
-            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 = addressToIndex(this._sheet, 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.mapFormulaBindingFromId(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
-    }, [
-      [
-        typeof value === "string" && value.charAt(0) === "=" ? this.mapFormulaBindingToFormula(value) : value
+      A: [
+        "sheetId !== undefined",
+        ""
       ]
-    ]);
-    const idx = addressToIndex(this._sheet, cell);
-    if (value === void 0 || value === null) {
-      delete this._sheet.cells[idx];
-    } else {
-      if (typeof value === "string" && value.charAt(0) === "=") {
-        value = this.mapFormulaBindingToId(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);
     });
+    const node = new ComputeNode(this, sheetId);
+    this._nodes.set(sheetId, node);
+    return node;
   }
   /**
-  * Iterate range.
+  * Map bound value to custom function invocation.
+  * E.g., "HELLO(...args)" => "EDGE("HELLO", ...args)".
   */
-  _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);
+  mapFormulaToNative(formula) {
+    return formula.replace(/['"]?([ \w]+)['"]?!/, (_match, name) => {
+      if (name) {
+        const objects = this._hf.getSheetNames().map((name2) => {
+          const { type, id } = parseSheetName(name2);
+          return type && id ? this._space?.db.getObjectById(id) : void 0;
+        }).filter(nonNullable2);
+        for (const obj of objects) {
+          if (obj.name === name) {
+            const type = getTypename(obj);
+            return `'${createSheetName({
+              type,
+              id: obj.id
+            })}'!`;
+          }
         }
       }
-      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., "HELLO()" => "EDGE("HELLO")".
-  */
-  mapFormulaBindingToFormula(formula) {
-    return formula.replace(/([a-zA-Z0-9]+)\((.*)\)/g, (match, binding, args) => {
-      const fn = this._functions.find((fn2) => fn2.binding === binding);
+      return `${name}!`;
+    }).replace(/(\w+)\((.*)\)/g, (match, binding, args) => {
+      const fn = this._remoteFunctions.find((fn2) => fn2.binding === binding);
       if (!fn) {
         return match;
       }
       if (args.trim() === "") {
-        return `EDGE("${binding}")`;
+        return `${EDGE_FUNCTION_NAME}("${binding}")`;
+      } else {
+        return `${EDGE_FUNCTION_NAME}("${binding}", ${args})`;
       }
-      return `EDGE("${binding}", ${args})`;
     });
   }
   /**
-  * E.g., "EDGE("HELLO")" => "HELLO()".
+  * Map from binding to fully qualified ECHO ID (to store).
+  * E.g., HELLO() => spaceId:objectId()
   */
-  mapFormulaBindingFromFormula(formula) {
-    return formula.replace(/EDGE\("([a-zA-Z0-9]+)"(.*)\)/, (_match, binding, args) => {
-      if (args.trim() === "") {
-        return `${binding}()`;
+  mapFunctionBindingToId(formula) {
+    return formula.replace(/(\w+)\((.*)\)/g, (match, binding, args) => {
+      if (binding === EDGE_FUNCTION_NAME || defaultFunctions.find((fn2) => fn2.name === binding)) {
+        return match;
+      }
+      const fn = this._remoteFunctions.find((fn2) => fn2.binding === binding);
+      if (fn) {
+        const id = fullyQualifiedId(fn);
+        return `${id}(${args})`;
+      } else {
+        return match;
       }
-      return `${binding}(${args.slice(2)})`;
-    });
-  }
-  /**
-  * Map from binding to fully qualified ECHO ID.
-  */
-  mapFormulaBindingToId(formula) {
-    return this._options.mapFormulaBindingToId(this._functions)(formula);
-  }
-  /**
-  * Map from fully qualified ECHO ID to binding.
-  */
-  mapFormulaBindingFromId(formula) {
-    return this._options.mapFormulaBindingFromId(this._functions)(formula);
-  }
-  /**
-  * Map from A1 notation to indices.
-  */
-  mapFormulaRefsToIndices(formula) {
-    invariant2(formula.charAt(0) === "=", void 0, {
-      F: __dxlog_file4,
-      L: 475,
-      S: this,
-      A: [
-        "formula.charAt(0) === '='",
-        ""
-      ]
-    });
-    return formula.replace(/([a-zA-Z]+)([0-9]+)/g, (match) => {
-      return addressToIndex(this._sheet, addressFromA1Notation(match));
     });
   }
   /**
-  * Map from indices to A1 notation.
+  * Map from fully qualified ECHO ID to binding (from store).
+  * E.g., spaceId:objectId() => HELLO()
   */
-  mapFormulaIndicesToRefs(formula) {
-    invariant2(formula.charAt(0) === "=", void 0, {
-      F: __dxlog_file4,
-      L: 485,
-      S: this,
-      A: [
-        "formula.charAt(0) === '='",
-        ""
-      ]
-    });
-    return formula.replace(/([a-zA-Z0-9]+)@([a-zA-Z0-9]+)/g, (idx) => {
-      return addressToA1Notation(addressFromIndex(this._sheet, idx));
+  mapFunctionBindingFromId(formula) {
+    return formula.replace(/(\w+):([a-zA-Z0-9]+)\((.*)\)/g, (match, spaceId, objectId, args) => {
+      const id = `${spaceId}:${objectId}`;
+      if (id.length !== OBJECT_ID_LENGTH) {
+        return match;
+      }
+      const fn = this._remoteFunctions.find((fn2) => fullyQualifiedId(fn2) === id);
+      if (fn?.binding) {
+        return `${fn.binding}(${args})`;
+      } else {
+        return match;
+      }
     });
   }
-  //
-  // 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);
+  async _open() {
+    if (this._space) {
+      const query = this._space.db.query(Filter2.schema(FunctionType2));
+      const unsubscribe = query.subscribe(({ objects }) => {
+        this._remoteFunctions = objects.filter(({ binding }) => binding);
+        this.update.emit({
+          type: "functionsUpdated"
+        });
+      });
+      this._ctx.onDispose(unsubscribe);
+    }
   }
-  toTime(num) {
-    return this._graph.hf.numberToTime(num);
+  async _close() {
+    for (const node of this._nodes.values()) {
+      await node.close();
+    }
   }
 };
 
-// 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, ""));
+// packages/plugins/plugin-sheet/src/graph/compute-graph-registry.ts
+import defaultsDeep2 from "lodash.defaultsdeep";
+import { Resource as Resource3 } from "@dxos/context";
+import { invariant as invariant2 } from "@dxos/invariant";
+import { log as log4 } from "@dxos/log";
+import { HyperFormula } from "#hyperformula";
+var __dxlog_file4 = "/home/runner/work/dxos/dxos/packages/plugins/plugin-sheet/src/graph/compute-graph-registry.ts";
+var defaultOptions = {
+  licenseKey: "gpl-v3"
 };
-var CustomPlugin = class extends FunctionPluginAsync {
-  test(ast, state) {
-    const handler = async () => {
-      return Math.random();
-    };
-    return this.runAsyncFunction(ast, state, handler);
+var defaultPlugins = [
+  {
+    plugin: EdgeFunctionPlugin,
+    translations: EdgeFunctionPluginTranslations
   }
-  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
+];
+var ComputeGraphRegistry = class extends Resource3 {
+  constructor(options = {
+    plugins: defaultPlugins
+  }) {
+    super();
+    this._graphs = /* @__PURE__ */ new Map();
+    this._options = defaultsDeep2({}, options, defaultOptions);
+    this._options.plugins?.forEach(({ plugin, translations }) => {
+      HyperFormula.registerFunctionPlugin(plugin, translations);
     });
   }
-};
-CustomPlugin.implementedFunctions = {
-  TEST: {
-    method: "test",
-    parameters: [],
-    isVolatile: true
-  },
-  CRYPTO: {
-    method: "crypto",
-    parameters: [
-      {
-        argumentType: FunctionArgumentType.STRING,
-        optionalArg: true
-      }
-    ],
-    isVolatile: true
+  getGraph(spaceId) {
+    return this._graphs.get(spaceId);
   }
-};
-var CustomPluginTranslations = {
-  enGB: {
-    TEST: "TEST",
-    CRYPTO: "CRYPTO"
-  },
-  enUS: {
-    TEST: "TEST",
-    CRYPTO: "CRYPTO"
+  getOrCreateGraph(space) {
+    let graph = this._graphs.get(space.id);
+    if (!graph) {
+      log4("create graph", {
+        space: space.id
+      }, {
+        F: __dxlog_file4,
+        L: 69,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      graph = this.createGraph(space);
+    }
+    return graph;
+  }
+  createGraph(space) {
+    invariant2(!this._graphs.has(space.id), `ComputeGraph already exists for space: ${space.id}`, {
+      F: __dxlog_file4,
+      L: 77,
+      S: this,
+      A: [
+        "!this._graphs.has(space.id)",
+        "`ComputeGraph already exists for space: ${space.id}`"
+      ]
+    });
+    const hf = HyperFormula.buildEmpty(this._options);
+    const graph = new ComputeGraph(hf, space, this._options);
+    this._graphs.set(space.id, graph);
+    return graph;
+  }
+  async _close() {
+    for (const graph of this._graphs.values()) {
+      await graph.close();
+    }
+    this._graphs.clear();
   }
 };
 
 export {
-  FunctionPluginAsync,
-  CustomPlugin,
-  CustomPluginTranslations,
-  createComputeGraph,
+  ComputeNode,
+  defaultFunctionContextOptions,
+  FunctionContext,
+  AsyncFunctionPlugin,
+  EDGE_FUNCTION_NAME,
+  EdgeFunctionPlugin,
+  EdgeFunctionPluginTranslations,
   defaultFunctions,
-  posEquals,
-  columnLetter,
-  addressToA1Notation,
-  addressFromA1Notation,
-  rangeToA1Notation,
-  inRange,
-  addressToIndex,
-  addressFromIndex,
-  rangeFromIndex,
-  closest,
-  compareIndexPositions,
-  SheetModel
+  createSheetName,
+  parseSheetName,
+  ComputeGraph,
+  defaultOptions,
+  defaultPlugins,
+  ComputeGraphRegistry
 };
-//# sourceMappingURL=chunk-GNNVBNCX.mjs.map
+//# sourceMappingURL=chunk-5WPZCXNS.mjs.map