@dou-ui/sheet 0.0.0-stage → 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 daidr
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @dou-ui/sheet
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[DouUI](https://github.com/daidr/dou-ui) 的电子表格：虚拟滚动的单元格网格、公式、格式、评论、历史版本与协同编辑。
+
+```sh
+bun add @dou-ui/sheet dou-ui @dou-ui/code
+```
+
+用法见 [文档](https://ui.daidr.me/sheet/)。
+
+许可证：MIT

package/dist/cell-types.js

@@ -0,0 +1,20 @@
+import { plainCellTypes } from "./core/plain-cell-types.js";
+import { CellCheck, CellOption } from "./components/cell-renders.js";
+import date_panel_default from "./components/date-panel.js";
+import option_panel_default from "./components/option-panel.js";
+// src/cell-types.ts
+var editors = {
+	date: { panel: date_panel_default },
+	select: {
+		render: CellOption,
+		panel: option_panel_default
+	},
+	checkbox: { render: CellCheck }
+};
+var builtinCellTypes = plainCellTypes.map((type) => ({
+	...type,
+	...editors[type.name]
+}));
+export { builtinCellTypes };
+
+//# sourceMappingURL=cell-types.js.map

package/dist/cell-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-types.js","names":["DatePanel","OptionPanel"],"sources":["../src/cell-types.ts"],"sourcesContent":["import { CellCheck, CellOption } from './components/cell-renders'\nimport DatePanel from './components/date-panel.vue'\nimport OptionPanel from './components/option-panel.vue'\nimport type { SheetCellType } from './core/cell-type'\nimport { plainCellTypes } from './core/plain-cell-types'\n\n// what the grid draws and edits the built-in types with\nconst editors: Record<string, Partial<SheetCellType>> = {\n  date: { panel: DatePanel },\n  select: { render: CellOption, panel: OptionPanel },\n  checkbox: { render: CellCheck },\n}\n\nexport const builtinCellTypes: readonly SheetCellType[] = plainCellTypes.map((type) => ({\n  ...type,\n  ...editors[type.name],\n}))\n"],"mappings":";;;;;AAOA,IAAM,UAAkD;CACtD,MAAM,EAAE,OAAOA,mBAAU;CACzB,QAAQ;EAAE,QAAQ;EAAY,OAAOC;CAAY;CACjD,UAAU,EAAE,QAAQ,UAAU;AAChC;AAEA,IAAa,mBAA6C,eAAe,KAAK,UAAU;CACtF,GAAG;CACH,GAAG,QAAQ,KAAK;AAClB,EAAE"}

package/dist/code/code-formula-bar.js

@@ -0,0 +1,6 @@
+import code_formula_bar_vue_vue_type_script_setup_true_lang_default from "./code-formula-bar.vue_vue_type_script_setup_true_lang.js";
+// src/code/code-formula-bar.vue
+var code_formula_bar_default = code_formula_bar_vue_vue_type_script_setup_true_lang_default;
+export { code_formula_bar_default as default };
+
+//# sourceMappingURL=code-formula-bar.js.map

package/dist/code/code-formula-bar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-formula-bar.js","names":["_sfc_main"],"sources":["../../src/code/code-formula-bar.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport {\n  DouCodeInput,\n  defineCodeExtension,\n  type CodeDecoration,\n  type CodeDiagnostic,\n  type CodeEditorExpose,\n  type CodeTransactionResult,\n} from '@dou-ui/code'\nimport { FunctionIcon } from '@dou-ui/icons'\nimport {\n  computed,\n  onBeforeUnmount,\n  onMounted,\n  shallowRef,\n  useTemplateRef,\n  watch,\n  watchEffect,\n} from 'vue'\nimport SheetNameBox from '../components/sheet-name-box.vue'\nimport { useSheet } from '../context'\nimport { formulaReferences } from '../formula/edit'\nimport { formulaTokens, parseFormula, SheetFormulaSyntaxError } from '../formula/parse'\nimport { format } from '../locale'\nimport { sheetFormula } from './language'\n\n/**\n * The formula bar, with the formula in `@dou-ui/code`'s code input:\n * colored as it is typed, brackets matched, and mistakes underlined. It\n * edits the cell the way the built-in bar does, with the same function\n * list, argument hints and pointing at cells.\n */\ndefineOptions({ name: 'DouSheetCodeFormulaBar' })\n\nconst sheet = useSheet()\nconst { editor, messages: m } = sheet\n\nconst root = useTemplateRef<HTMLElement>('root')\nconst input = shallowRef<CodeEditorExpose>()\n\nconst editingHere = computed(() => !!editor.cell.value)\nconst text = computed(() =>\n  editingHere.value ? editor.text.value : editor.textAt(sheet.active.value),\n)\nconst isFormula = computed(() => text.value.startsWith('='))\n\n/** Each reference in the color it has on the cells. */\nconst references = computed(() => (editingHere.value ? formulaReferences(text.value) : []))\n\nconst functionNames = computed(() => new Set(editor.functions.value.map((f) => f.name)))\n\n/** Text that can't be read as a formula, and functions there are none of. */\nfunction lint(doc: string): CodeDiagnostic[] {\n  if (!doc.startsWith('=') || doc.trim() === '=') return []\n  const out: CodeDiagnostic[] = []\n  try {\n    parseFormula(doc)\n  } catch (error) {\n    if (!(error instanceof SheetFormulaSyntaxError)) throw error\n    const at = Math.min(doc.length, error.at + 1)\n    out.push({\n      from: at,\n      to: Math.min(doc.length, at + 1),\n      severity: 'error',\n      message: m.value.formulaSyntax,\n    })\n  }\n  const tokens = formulaTokens(doc)\n  for (const [i, token] of tokens.entries()) {\n    const next = tokens[i + 1]\n    if (token.kind !== 'name' || next?.text !== '(') continue\n    if (functionNames.value.has(token.text.toUpperCase())) continue\n    out.push({\n      from: token.start,\n      to: token.end,\n      severity: 'warning',\n      message: format(m.value.unknownFunction, {\n        name: token.text.toUpperCase(),\n      }),\n    })\n  }\n  return out\n}\n\nconst extension = defineCodeExtension({\n  name: 'sheet-formula',\n  decorations: (): CodeDecoration[] =>\n    references.value.map((ref) => ({\n      type: 'mark',\n      from: ref.start,\n      to: ref.end,\n      class: `dou-sheet-code-bar__ref is-ref-${ref.color}`,\n    })),\n  lint: (ctx) => lint(ctx.doc.toString()),\n})\nconst extensions = [extension]\n\n// ---------------------------------------------------------------- the cell's edit, both ways\n\n/** Set while the cell's text is written into the box, so it isn't sent back. */\nlet syncing = false\n\nfunction onTransaction(result: CodeTransactionResult) {\n  if (syncing || sheet.readonly.value) return\n  const head = result.state.selection.ranges[result.state.selection.main]!.head\n  if (!result.changes.empty) {\n    const value = result.state.doc.toString()\n    if (!editor.input(value, head)) {\n      // the cell can't be edited: back to what it holds\n      writeBox(text.value, editor.caret.value)\n    }\n  } else if (editingHere.value) editor.moveCaret(head)\n}\n\n/** Puts the cell's text and caret in the box, unless they are there already. */\nfunction writeBox(value: string, caret: number) {\n  const box = input.value\n  if (!box) return\n  syncing = true\n  try {\n    if (box.doc.toString() !== value)\n      box.transact((tr) => tr.replace(0, tr.doc.length, value), {\n        action: 'external',\n        history: false,\n      })\n    const main = box.selection.ranges[box.selection.main]!\n    if (editingHere.value && (main.head !== caret || main.anchor !== caret))\n      box.select(Math.min(caret, value.length))\n  } finally {\n    syncing = false\n  }\n}\n\n// pointing at cells, Tab completing a name: the cell's edit moves, the box follows\nwatch([text, () => editor.caret.value], ([value, caret]) => writeBox(value, caret), {\n  flush: 'sync',\n})\n\n// Enter, Tab, Escape, the function list and pointing work as in the cell: before the box's own keys\nfunction onKey(event: KeyboardEvent) {\n  if (event.isComposing) return\n  if (editingHere.value) {\n    // a new line in the formula, as Alt + Enter does in the cell\n    if (event.key === 'Enter' && event.altKey) {\n      event.preventDefault()\n      event.stopPropagation()\n      input.value?.transact((tr) => tr.replaceSelection('\\n'), {\n        action: 'input',\n        scroll: true,\n      })\n      return\n    }\n    if (editor.key(event)) {\n      event.stopPropagation()\n      if (!editor.cell.value) sheet.focus()\n    }\n    return\n  }\n  if (event.key === 'Escape' || event.key === 'Enter') {\n    event.preventDefault()\n    event.stopPropagation()\n    sheet.focus()\n  }\n}\n\nfunction onBlur(event: FocusEvent) {\n  // a press on a cell finished the edit already; going elsewhere saves it, as leaving the cell does\n  const next = event.relatedTarget as Element | null\n  if (!editor.cell.value || !document.hasFocus()) return\n  if (next?.closest('.dou-sheet__input, .dou-sheet__assist')) return\n  editor.commit()\n}\n\nlet detach: (() => void) | undefined\nonMounted(() => {\n  const textarea = root.value?.querySelector('textarea')\n  const anchor = root.value?.querySelector<HTMLElement>('.dou-code-editor') ?? undefined\n  if (textarea) detach = editor.attach(textarea, { managed: true, anchor })\n})\n// the function list under the cell belongs to the box while it edits\nwatchEffect(() => {\n  const textarea = root.value?.querySelector('textarea')\n  if (!textarea) return\n  if (editingHere.value) {\n    textarea.setAttribute('aria-autocomplete', 'list')\n    textarea.setAttribute('aria-controls', editor.helpId)\n  } else {\n    textarea.removeAttribute('aria-autocomplete')\n    textarea.removeAttribute('aria-controls')\n  }\n})\nonBeforeUnmount(() => detach?.())\n</script>\n\n<template>\n  <div ref=\"root\" class=\"dou-sheet-formula-bar dou-sheet-code-bar\">\n    <SheetNameBox />\n    <span class=\"dou-sheet-formula-bar__mark\" aria-hidden=\"true\"><FunctionIcon /></span>\n    <div class=\"dou-sheet-code-bar__box\" @keydown.capture=\"onKey\">\n      <DouCodeInput\n        ref=\"input\"\n        :model-value=\"text\"\n        class=\"dou-sheet-code-bar__input\"\n        multiline\n        :autosize=\"{ minRows: 1, maxRows: 5 }\"\n        :language=\"isFormula ? sheetFormula : null\"\n        :extensions=\"extensions\"\n        :readonly=\"sheet.readonly.value\"\n        :aria-label=\"m.formulaBox\"\n        @transaction=\"onTransaction\"\n        @blur=\"onBlur\"\n      />\n    </div>\n  </div>\n</template>\n"],"mappings":""}

package/dist/code/code-formula-bar.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,192 @@
+import { SheetFormulaSyntaxError, formulaTokens, parseFormula } from "../formula/parse.js";
+import { formulaReferences } from "../formula/edit.js";
+import { format } from "../locale.js";
+import { useSheet } from "../context.js";
+import sheet_name_box_default from "../components/sheet-name-box.js";
+import { sheetFormula } from "./language.js";
+import { computed, createElementBlock, createElementVNode, createVNode, defineComponent, onBeforeUnmount, onMounted, openBlock, shallowRef, unref, useTemplateRef, watch, watchEffect } from "vue";
+import { FunctionIcon } from "@dou-ui/icons";
+import { DouCodeInput, defineCodeExtension } from "@dou-ui/code";
+// src/code/code-formula-bar.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = {
+	class: "dou-sheet-formula-bar__mark",
+	"aria-hidden": "true"
+};
+/**
+* The formula bar, with the formula in `@dou-ui/code`'s code input:
+* colored as it is typed, brackets matched, and mistakes underlined. It
+* edits the cell the way the built-in bar does, with the same function
+* list, argument hints and pointing at cells.
+*/
+var code_formula_bar_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	name: "DouSheetCodeFormulaBar",
+	__name: "code-formula-bar",
+	setup(__props) {
+		const sheet = useSheet();
+		const { editor, messages: m } = sheet;
+		const root = useTemplateRef("root");
+		const input = shallowRef();
+		const editingHere = computed(() => !!editor.cell.value);
+		const text = computed(() => editingHere.value ? editor.text.value : editor.textAt(sheet.active.value));
+		const isFormula = computed(() => text.value.startsWith("="));
+		/** Each reference in the color it has on the cells. */
+		const references = computed(() => editingHere.value ? formulaReferences(text.value) : []);
+		const functionNames = computed(() => new Set(editor.functions.value.map((f) => f.name)));
+		/** Text that can't be read as a formula, and functions there are none of. */
+		function lint(doc) {
+			if (!doc.startsWith("=") || doc.trim() === "=") return [];
+			const out = [];
+			try {
+				parseFormula(doc);
+			} catch (error) {
+				if (!(error instanceof SheetFormulaSyntaxError)) throw error;
+				const at = Math.min(doc.length, error.at + 1);
+				out.push({
+					from: at,
+					to: Math.min(doc.length, at + 1),
+					severity: "error",
+					message: m.value.formulaSyntax
+				});
+			}
+			const tokens = formulaTokens(doc);
+			for (const [i, token] of tokens.entries()) {
+				const next = tokens[i + 1];
+				if (token.kind !== "name" || next?.text !== "(") continue;
+				if (functionNames.value.has(token.text.toUpperCase())) continue;
+				out.push({
+					from: token.start,
+					to: token.end,
+					severity: "warning",
+					message: format(m.value.unknownFunction, { name: token.text.toUpperCase() })
+				});
+			}
+			return out;
+		}
+		const extensions = [defineCodeExtension({
+			name: "sheet-formula",
+			decorations: () => references.value.map((ref) => ({
+				type: "mark",
+				from: ref.start,
+				to: ref.end,
+				class: `dou-sheet-code-bar__ref is-ref-${ref.color}`
+			})),
+			lint: (ctx) => lint(ctx.doc.toString())
+		})];
+		/** Set while the cell's text is written into the box, so it isn't sent back. */
+		let syncing = false;
+		function onTransaction(result) {
+			if (syncing || sheet.readonly.value) return;
+			const head = result.state.selection.ranges[result.state.selection.main].head;
+			if (!result.changes.empty) {
+				const value = result.state.doc.toString();
+				if (!editor.input(value, head)) writeBox(text.value, editor.caret.value);
+			} else if (editingHere.value) editor.moveCaret(head);
+		}
+		/** Puts the cell's text and caret in the box, unless they are there already. */
+		function writeBox(value, caret) {
+			const box = input.value;
+			if (!box) return;
+			syncing = true;
+			try {
+				if (box.doc.toString() !== value) box.transact((tr) => tr.replace(0, tr.doc.length, value), {
+					action: "external",
+					history: false
+				});
+				const main = box.selection.ranges[box.selection.main];
+				if (editingHere.value && (main.head !== caret || main.anchor !== caret)) box.select(Math.min(caret, value.length));
+			} finally {
+				syncing = false;
+			}
+		}
+		watch([text, () => editor.caret.value], ([value, caret]) => writeBox(value, caret), { flush: "sync" });
+		function onKey(event) {
+			if (event.isComposing) return;
+			if (editingHere.value) {
+				if (event.key === "Enter" && event.altKey) {
+					event.preventDefault();
+					event.stopPropagation();
+					input.value?.transact((tr) => tr.replaceSelection("\n"), {
+						action: "input",
+						scroll: true
+					});
+					return;
+				}
+				if (editor.key(event)) {
+					event.stopPropagation();
+					if (!editor.cell.value) sheet.focus();
+				}
+				return;
+			}
+			if (event.key === "Escape" || event.key === "Enter") {
+				event.preventDefault();
+				event.stopPropagation();
+				sheet.focus();
+			}
+		}
+		function onBlur(event) {
+			const next = event.relatedTarget;
+			if (!editor.cell.value || !document.hasFocus()) return;
+			if (next?.closest(".dou-sheet__input, .dou-sheet__assist")) return;
+			editor.commit();
+		}
+		let detach;
+		onMounted(() => {
+			const textarea = root.value?.querySelector("textarea");
+			const anchor = root.value?.querySelector(".dou-code-editor") ?? void 0;
+			if (textarea) detach = editor.attach(textarea, {
+				managed: true,
+				anchor
+			});
+		});
+		watchEffect(() => {
+			const textarea = root.value?.querySelector("textarea");
+			if (!textarea) return;
+			if (editingHere.value) {
+				textarea.setAttribute("aria-autocomplete", "list");
+				textarea.setAttribute("aria-controls", editor.helpId);
+			} else {
+				textarea.removeAttribute("aria-autocomplete");
+				textarea.removeAttribute("aria-controls");
+			}
+		});
+		onBeforeUnmount(() => detach?.());
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", {
+				ref_key: "root",
+				ref: root,
+				class: "dou-sheet-formula-bar dou-sheet-code-bar"
+			}, [
+				createVNode(sheet_name_box_default),
+				createElementVNode("span", _hoisted_1, [createVNode(unref(FunctionIcon))]),
+				createElementVNode("div", {
+					class: "dou-sheet-code-bar__box",
+					onKeydownCapture: onKey
+				}, [createVNode(unref(DouCodeInput), {
+					ref_key: "input",
+					ref: input,
+					"model-value": text.value,
+					class: "dou-sheet-code-bar__input",
+					multiline: "",
+					autosize: {
+						minRows: 1,
+						maxRows: 5
+					},
+					language: isFormula.value ? unref(sheetFormula) : null,
+					extensions,
+					readonly: unref(sheet).readonly.value,
+					"aria-label": unref(m).formulaBox,
+					onTransaction,
+					onBlur
+				}, null, 8, [
+					"model-value",
+					"language",
+					"readonly",
+					"aria-label"
+				])], 32)
+			], 512);
+		};
+	}
+});
+export { code_formula_bar_vue_vue_type_script_setup_true_lang_default as default };
+
+//# sourceMappingURL=code-formula-bar.vue_vue_type_script_setup_true_lang.js.map

package/dist/code/code-formula-bar.vue_vue_type_script_setup_true_lang.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-formula-bar.vue_vue_type_script_setup_true_lang.js","names":["_openBlock","_createElementBlock","_createVNode","SheetNameBox","_createElementVNode","_unref"],"sources":["../../src/code/code-formula-bar.vue"],"sourcesContent":["<script setup lang=\"ts\">\nimport {\n  DouCodeInput,\n  defineCodeExtension,\n  type CodeDecoration,\n  type CodeDiagnostic,\n  type CodeEditorExpose,\n  type CodeTransactionResult,\n} from '@dou-ui/code'\nimport { FunctionIcon } from '@dou-ui/icons'\nimport {\n  computed,\n  onBeforeUnmount,\n  onMounted,\n  shallowRef,\n  useTemplateRef,\n  watch,\n  watchEffect,\n} from 'vue'\nimport SheetNameBox from '../components/sheet-name-box.vue'\nimport { useSheet } from '../context'\nimport { formulaReferences } from '../formula/edit'\nimport { formulaTokens, parseFormula, SheetFormulaSyntaxError } from '../formula/parse'\nimport { format } from '../locale'\nimport { sheetFormula } from './language'\n\n/**\n * The formula bar, with the formula in `@dou-ui/code`'s code input:\n * colored as it is typed, brackets matched, and mistakes underlined. It\n * edits the cell the way the built-in bar does, with the same function\n * list, argument hints and pointing at cells.\n */\ndefineOptions({ name: 'DouSheetCodeFormulaBar' })\n\nconst sheet = useSheet()\nconst { editor, messages: m } = sheet\n\nconst root = useTemplateRef<HTMLElement>('root')\nconst input = shallowRef<CodeEditorExpose>()\n\nconst editingHere = computed(() => !!editor.cell.value)\nconst text = computed(() =>\n  editingHere.value ? editor.text.value : editor.textAt(sheet.active.value),\n)\nconst isFormula = computed(() => text.value.startsWith('='))\n\n/** Each reference in the color it has on the cells. */\nconst references = computed(() => (editingHere.value ? formulaReferences(text.value) : []))\n\nconst functionNames = computed(() => new Set(editor.functions.value.map((f) => f.name)))\n\n/** Text that can't be read as a formula, and functions there are none of. */\nfunction lint(doc: string): CodeDiagnostic[] {\n  if (!doc.startsWith('=') || doc.trim() === '=') return []\n  const out: CodeDiagnostic[] = []\n  try {\n    parseFormula(doc)\n  } catch (error) {\n    if (!(error instanceof SheetFormulaSyntaxError)) throw error\n    const at = Math.min(doc.length, error.at + 1)\n    out.push({\n      from: at,\n      to: Math.min(doc.length, at + 1),\n      severity: 'error',\n      message: m.value.formulaSyntax,\n    })\n  }\n  const tokens = formulaTokens(doc)\n  for (const [i, token] of tokens.entries()) {\n    const next = tokens[i + 1]\n    if (token.kind !== 'name' || next?.text !== '(') continue\n    if (functionNames.value.has(token.text.toUpperCase())) continue\n    out.push({\n      from: token.start,\n      to: token.end,\n      severity: 'warning',\n      message: format(m.value.unknownFunction, {\n        name: token.text.toUpperCase(),\n      }),\n    })\n  }\n  return out\n}\n\nconst extension = defineCodeExtension({\n  name: 'sheet-formula',\n  decorations: (): CodeDecoration[] =>\n    references.value.map((ref) => ({\n      type: 'mark',\n      from: ref.start,\n      to: ref.end,\n      class: `dou-sheet-code-bar__ref is-ref-${ref.color}`,\n    })),\n  lint: (ctx) => lint(ctx.doc.toString()),\n})\nconst extensions = [extension]\n\n// ---------------------------------------------------------------- the cell's edit, both ways\n\n/** Set while the cell's text is written into the box, so it isn't sent back. */\nlet syncing = false\n\nfunction onTransaction(result: CodeTransactionResult) {\n  if (syncing || sheet.readonly.value) return\n  const head = result.state.selection.ranges[result.state.selection.main]!.head\n  if (!result.changes.empty) {\n    const value = result.state.doc.toString()\n    if (!editor.input(value, head)) {\n      // the cell can't be edited: back to what it holds\n      writeBox(text.value, editor.caret.value)\n    }\n  } else if (editingHere.value) editor.moveCaret(head)\n}\n\n/** Puts the cell's text and caret in the box, unless they are there already. */\nfunction writeBox(value: string, caret: number) {\n  const box = input.value\n  if (!box) return\n  syncing = true\n  try {\n    if (box.doc.toString() !== value)\n      box.transact((tr) => tr.replace(0, tr.doc.length, value), {\n        action: 'external',\n        history: false,\n      })\n    const main = box.selection.ranges[box.selection.main]!\n    if (editingHere.value && (main.head !== caret || main.anchor !== caret))\n      box.select(Math.min(caret, value.length))\n  } finally {\n    syncing = false\n  }\n}\n\n// pointing at cells, Tab completing a name: the cell's edit moves, the box follows\nwatch([text, () => editor.caret.value], ([value, caret]) => writeBox(value, caret), {\n  flush: 'sync',\n})\n\n// Enter, Tab, Escape, the function list and pointing work as in the cell: before the box's own keys\nfunction onKey(event: KeyboardEvent) {\n  if (event.isComposing) return\n  if (editingHere.value) {\n    // a new line in the formula, as Alt + Enter does in the cell\n    if (event.key === 'Enter' && event.altKey) {\n      event.preventDefault()\n      event.stopPropagation()\n      input.value?.transact((tr) => tr.replaceSelection('\\n'), {\n        action: 'input',\n        scroll: true,\n      })\n      return\n    }\n    if (editor.key(event)) {\n      event.stopPropagation()\n      if (!editor.cell.value) sheet.focus()\n    }\n    return\n  }\n  if (event.key === 'Escape' || event.key === 'Enter') {\n    event.preventDefault()\n    event.stopPropagation()\n    sheet.focus()\n  }\n}\n\nfunction onBlur(event: FocusEvent) {\n  // a press on a cell finished the edit already; going elsewhere saves it, as leaving the cell does\n  const next = event.relatedTarget as Element | null\n  if (!editor.cell.value || !document.hasFocus()) return\n  if (next?.closest('.dou-sheet__input, .dou-sheet__assist')) return\n  editor.commit()\n}\n\nlet detach: (() => void) | undefined\nonMounted(() => {\n  const textarea = root.value?.querySelector('textarea')\n  const anchor = root.value?.querySelector<HTMLElement>('.dou-code-editor') ?? undefined\n  if (textarea) detach = editor.attach(textarea, { managed: true, anchor })\n})\n// the function list under the cell belongs to the box while it edits\nwatchEffect(() => {\n  const textarea = root.value?.querySelector('textarea')\n  if (!textarea) return\n  if (editingHere.value) {\n    textarea.setAttribute('aria-autocomplete', 'list')\n    textarea.setAttribute('aria-controls', editor.helpId)\n  } else {\n    textarea.removeAttribute('aria-autocomplete')\n    textarea.removeAttribute('aria-controls')\n  }\n})\nonBeforeUnmount(() => detach?.())\n</script>\n\n<template>\n  <div ref=\"root\" class=\"dou-sheet-formula-bar dou-sheet-code-bar\">\n    <SheetNameBox />\n    <span class=\"dou-sheet-formula-bar__mark\" aria-hidden=\"true\"><FunctionIcon /></span>\n    <div class=\"dou-sheet-code-bar__box\" @keydown.capture=\"onKey\">\n      <DouCodeInput\n        ref=\"input\"\n        :model-value=\"text\"\n        class=\"dou-sheet-code-bar__input\"\n        multiline\n        :autosize=\"{ minRows: 1, maxRows: 5 }\"\n        :language=\"isFormula ? sheetFormula : null\"\n        :extensions=\"extensions\"\n        :readonly=\"sheet.readonly.value\"\n        :aria-label=\"m.formulaBox\"\n        @transaction=\"onTransaction\"\n        @blur=\"onBlur\"\n      />\n    </div>\n  </div>\n</template>\n"],"mappings":"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"}

package/dist/code/index.js

@@ -0,0 +1,12 @@
+import { sheetFormula } from "./language.js";
+import code_formula_bar_default from "./code-formula-bar.js";
+import { withInstall } from "dou-ui";
+// src/code/index.ts
+/**
+* The formula bar with the formula in `@dou-ui/code`'s code input. Use it
+* in place of `DouSheetFormulaBar`; needs `@dou-ui/code` and its styles.
+*/
+var DouSheetCodeFormulaBar = withInstall(code_formula_bar_default);
+export { DouSheetCodeFormulaBar, sheetFormula };
+
+//# sourceMappingURL=index.js.map

package/dist/code/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["CodeFormulaBar"],"sources":["../../src/code/index.ts"],"sourcesContent":["import { withInstall } from 'dou-ui'\nimport CodeFormulaBar from './code-formula-bar.vue'\n\n/**\n * The formula bar with the formula in `@dou-ui/code`'s code input. Use it\n * in place of `DouSheetFormulaBar`; needs `@dou-ui/code` and its styles.\n */\nexport const DouSheetCodeFormulaBar = withInstall(CodeFormulaBar)\nexport { sheetFormula } from './language'\nexport type { SheetFormulaState } from './language'\n\ndeclare module 'vue' {\n  export interface GlobalComponents {\n    DouSheetCodeFormulaBar: typeof DouSheetCodeFormulaBar\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,yBAAyB,YAAYA,wBAAc"}

package/dist/code/language.js

@@ -0,0 +1,51 @@
+import { defineCodeLanguage } from "@dou-ui/code";
+// src/code/language.ts
+var SHEET = String.raw`(?:'(?:[^']|'')+'|[\p{L}_][\p{L}\p{N}_.]*)!`;
+var CELL = String.raw`\$?[A-Za-z]{1,3}\$?\d+`;
+var REF = new RegExp(String.raw`^(?:${SHEET})?(?:${CELL}(?::${CELL})?|\$?[A-Za-z]{1,3}:\$?[A-Za-z]{1,3}|\$?\d+:\$?\d+)(?![\p{L}\p{N}_(])`, "u");
+var ERROR = /^#(?:NULL!|DIV\/0!|VALUE!|REF!|NAME\?|NUM!|N\/A|SPILL!|CALC!)/i;
+var NUMBER = /^(?:\d+\.?\d*|\.\d+)(?:[eE][+-]?\d+)?%?/;
+var NAME = /^[\p{L}_][\p{L}\p{N}_.]*/u;
+/**
+* Spreadsheet formulas, as the sheet writes them: `=SUM(A1:B2, "text")`.
+* Function names, references, "text", numbers, error values and
+* `TRUE` / `FALSE` each have their color. For the text after the `=`, or
+* with it; a value typed into a cell isn't a formula, so leave the
+* language out for it.
+*/
+var sheetFormula = defineCodeLanguage({
+	name: "sheet-formula",
+	startState: () => ({ quote: false }),
+	copyState: (state) => ({ ...state }),
+	sameState: (a, b) => a.quote === b.quote,
+	token(stream, state) {
+		if (state.quote || stream.peek() === "\"") {
+			if (!state.quote) stream.next();
+			state.quote = true;
+			while (!stream.eol()) if (stream.next() === "\"") {
+				if (stream.eat("\"")) continue;
+				state.quote = false;
+				break;
+			}
+			return "string";
+		}
+		if (stream.eatSpace()) return null;
+		if (stream.match(ERROR)) return "invalid";
+		if (stream.match(REF)) return "variable";
+		if (stream.match(NUMBER)) return "number";
+		const name = stream.match(NAME);
+		if (name) {
+			if (stream.match(/^\s*\(/, false)) return "function";
+			return /^(?:TRUE|FALSE)$/i.test(name[0]) ? "keyword" : "variable";
+		}
+		if (stream.match(/^(?:<>|<=|>=|[-+*/^&=<>%])/)) return "operator";
+		if (stream.eat(/[(),;{}]/)) return "punctuation";
+		stream.next();
+		return null;
+	},
+	brackets: "(){}",
+	autoClose: "(\""
+});
+export { sheetFormula };
+
+//# sourceMappingURL=language.js.map

package/dist/code/language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language.js","names":[],"sources":["../../src/code/language.ts"],"sourcesContent":["import { defineCodeLanguage, type CodeLanguage, type CodeTokenType } from '@dou-ui/code'\n\nexport interface SheetFormulaState {\n  /** A \"text\" value still open at the line's end. */\n  quote: boolean\n}\n\nconst SHEET = String.raw`(?:'(?:[^']|'')+'|[\\p{L}_][\\p{L}\\p{N}_.]*)!`\nconst CELL = String.raw`\\$?[A-Za-z]{1,3}\\$?\\d+`\nconst REF = new RegExp(\n  String.raw`^(?:${SHEET})?(?:${CELL}(?::${CELL})?|\\$?[A-Za-z]{1,3}:\\$?[A-Za-z]{1,3}|\\$?\\d+:\\$?\\d+)(?![\\p{L}\\p{N}_(])`,\n  'u',\n)\nconst ERROR = /^#(?:NULL!|DIV\\/0!|VALUE!|REF!|NAME\\?|NUM!|N\\/A|SPILL!|CALC!)/i\nconst NUMBER = /^(?:\\d+\\.?\\d*|\\.\\d+)(?:[eE][+-]?\\d+)?%?/\nconst NAME = /^[\\p{L}_][\\p{L}\\p{N}_.]*/u\n\n/**\n * Spreadsheet formulas, as the sheet writes them: `=SUM(A1:B2, \"text\")`.\n * Function names, references, \"text\", numbers, error values and\n * `TRUE` / `FALSE` each have their color. For the text after the `=`, or\n * with it; a value typed into a cell isn't a formula, so leave the\n * language out for it.\n */\nexport const sheetFormula: CodeLanguage<SheetFormulaState> = defineCodeLanguage<SheetFormulaState>({\n  name: 'sheet-formula',\n  startState: () => ({ quote: false }),\n  copyState: (state) => ({ ...state }),\n  sameState: (a, b) => a.quote === b.quote,\n  token(stream, state): CodeTokenType | null {\n    if (state.quote || stream.peek() === '\"') {\n      if (!state.quote) stream.next()\n      state.quote = true\n      while (!stream.eol()) {\n        if (stream.next() === '\"') {\n          if (stream.eat('\"')) continue\n          state.quote = false\n          break\n        }\n      }\n      return 'string'\n    }\n    if (stream.eatSpace()) return null\n    if (stream.match(ERROR)) return 'invalid'\n    if (stream.match(REF)) return 'variable'\n    if (stream.match(NUMBER)) return 'number'\n    const name = stream.match(NAME)\n    if (name) {\n      if (stream.match(/^\\s*\\(/, false)) return 'function'\n      return /^(?:TRUE|FALSE)$/i.test(name[0]) ? 'keyword' : 'variable'\n    }\n    if (stream.match(/^(?:<>|<=|>=|[-+*/^&=<>%])/)) return 'operator'\n    if (stream.eat(/[(),;{}]/)) return 'punctuation'\n    stream.next()\n    return null\n  },\n  brackets: '(){}',\n  autoClose: '(\"',\n})\n"],"mappings":";;AAOA,IAAM,QAAQ,OAAO,GAAG;AACxB,IAAM,OAAO,OAAO,GAAG;AACvB,IAAM,MAAM,IAAI,OACd,OAAO,GAAG,OAAO,MAAM,OAAO,KAAK,MAAM,KAAK,wEAC9C,GACF;AACA,IAAM,QAAQ;AACd,IAAM,SAAS;AACf,IAAM,OAAO;;;;;;;;AASb,IAAa,eAAgD,mBAAsC;CACjG,MAAM;CACN,mBAAmB,EAAE,OAAO,MAAM;CAClC,YAAY,WAAW,EAAE,GAAG,MAAM;CAClC,YAAY,GAAG,MAAM,EAAE,UAAU,EAAE;CACnC,MAAM,QAAQ,OAA6B;EACzC,IAAI,MAAM,SAAS,OAAO,KAAK,MAAM,MAAK;GACxC,IAAI,CAAC,MAAM,OAAO,OAAO,KAAK;GAC9B,MAAM,QAAQ;GACd,OAAO,CAAC,OAAO,IAAI,GACjB,IAAI,OAAO,KAAK,MAAM,MAAK;IACzB,IAAI,OAAO,IAAI,IAAG,GAAG;IACrB,MAAM,QAAQ;IACd;GACF;GAEF,OAAO;EACT;EACA,IAAI,OAAO,SAAS,GAAG,OAAO;EAC9B,IAAI,OAAO,MAAM,KAAK,GAAG,OAAO;EAChC,IAAI,OAAO,MAAM,GAAG,GAAG,OAAO;EAC9B,IAAI,OAAO,MAAM,MAAM,GAAG,OAAO;EACjC,MAAM,OAAO,OAAO,MAAM,IAAI;EAC9B,IAAI,MAAM;GACR,IAAI,OAAO,MAAM,UAAU,KAAK,GAAG,OAAO;GAC1C,OAAO,oBAAoB,KAAK,KAAK,EAAE,IAAI,YAAY;EACzD;EACA,IAAI,OAAO,MAAM,4BAA4B,GAAG,OAAO;EACvD,IAAI,OAAO,IAAI,UAAU,GAAG,OAAO;EACnC,OAAO,KAAK;EACZ,OAAO;CACT;CACA,UAAU;CACV,WAAW;AACb,CAAC"}

package/dist/code/style.d.ts

@@ -0,0 +1 @@
+export {}

package/dist/code/style.js

@@ -0,0 +1,2 @@
+import '@dou-ui/code/style'
+import '../style.css'

package/dist/collaboration/anchor.js

@@ -0,0 +1,143 @@
+import { eachRef, writeRef } from "../core/address.js";
+import { compactCell } from "../core/model.js";
+// src/collaboration/anchor.ts
+/** The ids of a sheet's rows or columns, in order, with a lookup of each one's number. */
+var SheetLines = class {
+	ids;
+	at = null;
+	constructor(ids) {
+		this.ids = ids;
+	}
+	/** The number of a line, `-1` when it is gone. */
+	indexOf(id) {
+		if (!this.at) {
+			this.at = /* @__PURE__ */ new Map();
+			this.ids.forEach((line, index) => this.at.set(line, index));
+		}
+		return this.at.get(id) ?? -1;
+	}
+	/** Call after changing `ids`. */
+	changed() {
+		this.at = null;
+	}
+};
+/** The sheets of a workbook, by id and by name. */
+var SheetLayout = class {
+	sheets = /* @__PURE__ */ new Map();
+	byName(name) {
+		for (const sheet of this.sheets.values()) if (sheet.name === name) return sheet;
+	}
+};
+/** The anchors of a formula's references, or `undefined` when it has none to keep. */
+function anchorFormula(formula, here, layout) {
+	const refs = [];
+	let any = false;
+	eachRef(formula, (named, a, b, text) => {
+		const target = named == null ? here : layout.byName(named);
+		if (!target) {
+			refs.push(0);
+			return text;
+		}
+		any = true;
+		const row = (n) => n == null ? null : target.rows.ids[n] ?? n;
+		const col = (n) => n == null ? null : target.cols.ids[n] ?? n;
+		refs.push([
+			named == null ? null : target.id,
+			row(a.row),
+			col(a.col),
+			row(b.row),
+			col(b.col)
+		]);
+		return text;
+	});
+	return any ? refs : void 0;
+}
+function lineOf(lines, end) {
+	return end == null ? void 0 : typeof end === "number" ? end : lines.indexOf(end);
+}
+/**
+* A formula with its references where their lines are now. A reference
+* whose line or sheet is gone reads `#REF!`; one whose sheet was renamed
+* names it anew. Unchanged references keep their text as written.
+*/
+function resolveFormula(formula, refs, here, layout) {
+	let i = 0;
+	return eachRef(formula, (named, a, b, text) => {
+		const ref = refs[i++];
+		if (!ref) return text;
+		const [sheetId, rowA, colA, rowB, colB] = ref;
+		const target = sheetId == null ? here : layout.sheets.get(sheetId);
+		if (!target) return "#REF!";
+		const renamed = named != null && target.name !== named;
+		const prefix = renamed ? void 0 : text.includes("!") ? text.slice(0, text.lastIndexOf("!") + 1) : void 0;
+		const r1 = lineOf(target.rows, rowA);
+		const c1 = lineOf(target.cols, colA);
+		const r2 = lineOf(target.rows, rowB);
+		const c2 = lineOf(target.cols, colB);
+		if (r1 === -1 || c1 === -1 || r2 === -1 || c2 === -1) return `${prefix ?? (named != null ? `${target.name}!` : "")}#REF!`;
+		if (!renamed && r1 === a.row && c1 === a.col && r2 === b.row && c2 === b.col) return text;
+		const single = a === b;
+		const from = {
+			...a,
+			row: r1,
+			col: c1
+		};
+		const to = single ? from : {
+			...b,
+			row: r2,
+			col: c2
+		};
+		return writeRef(named == null ? void 0 : target.name, from, to, single, prefix);
+	});
+}
+/** A range such as `A1:C4`, anchored. */
+function anchorRange(range, here, layout) {
+	const r = anchorFormula(`=${range}`, here, layout);
+	return r ? {
+		t: range,
+		r
+	} : { t: range };
+}
+/** A range where its lines are now; `null` when they are gone. */
+function resolveRange(stored, here, layout) {
+	if (!stored.r) return stored.t;
+	const text = resolveFormula(`=${stored.t}`, stored.r, here, layout).slice(1);
+	return text.includes("#REF!") ? null : text;
+}
+/** A formula, or text that may be one, anchored. */
+function anchorText(text, here, layout) {
+	const r = text.startsWith("=") ? anchorFormula(text, here, layout) : void 0;
+	return r ? {
+		t: text,
+		r
+	} : { t: text };
+}
+function resolveText(stored, here, layout) {
+	return stored.r ? resolveFormula(stored.t, stored.r, here, layout) : stored.t;
+}
+/** Where a cell keeps the anchors of its formula in the shared document. */
+var REFS = "$refs";
+var isFormula = (value) => typeof value === "string" && value.startsWith("=");
+/** A cell as the shared document keeps it: as it is, with the anchors of its formula beside. */
+function anchorCell(cell, here, layout) {
+	const value = typeof cell === "object" && cell !== null ? cell.value : cell;
+	if (!isFormula(value)) return cell ?? void 0;
+	const refs = anchorFormula(value, here, layout);
+	if (!refs) return cell;
+	return {
+		...typeof cell === "object" && cell !== null ? cell : { value },
+		[REFS]: refs
+	};
+}
+/** Whether a cell kept in the shared document has references to resolve. */
+var hasRefs = (stored) => typeof stored === "object" && stored !== null && "$refs" in stored;
+/** A cell kept in the shared document, with its formula's references where they are now. */
+function resolveCell(stored, here, layout) {
+	if (!hasRefs(stored)) return stored;
+	const { [REFS]: refs, ...cell } = stored;
+	if (isFormula(cell.value)) cell.value = resolveFormula(cell.value, refs, here, layout);
+	return compactCell(cell);
+}
+export { REFS, SheetLayout, SheetLines, anchorCell, anchorFormula, anchorRange, anchorText, hasRefs, lineOf, resolveCell, resolveFormula, resolveRange, resolveText };
+
+//# sourceMappingURL=anchor.js.map

package/dist/collaboration/anchor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anchor.js","names":[],"sources":["../../src/collaboration/anchor.ts"],"sourcesContent":["import { eachRef, writeRef } from '../core/address'\nimport { compactCell, type SheetCell, type SheetCellInput } from '../core/model'\n\n/*\n * Formulas and ranges are written with row and column numbers, which change\n * when someone inserts or deletes lines. In the shared document each\n * reference is kept with the ids of its rows and columns besides the text,\n * so it reads right again once the lines it points at have moved, also by\n * changes this side has not seen yet when it is written.\n */\n\n/** The ids of a sheet's rows or columns, in order, with a lookup of each one's number. */\nexport class SheetLines {\n  private at: Map<string, number> | null = null\n\n  constructor(public ids: string[]) {}\n\n  /** The number of a line, `-1` when it is gone. */\n  indexOf(id: string) {\n    if (!this.at) {\n      this.at = new Map()\n      this.ids.forEach((line, index) => this.at!.set(line, index))\n    }\n    return this.at.get(id) ?? -1\n  }\n\n  /** Call after changing `ids`. */\n  changed() {\n    this.at = null\n  }\n}\n\n/** A sheet as references see it: its id, its name and its lines. */\nexport interface LayoutSheet {\n  id: string\n  name: string\n  rows: SheetLines\n  cols: SheetLines\n}\n\n/** The sheets of a workbook, by id and by name. */\nexport class SheetLayout {\n  readonly sheets = new Map<string, LayoutSheet>()\n\n  byName(name: string) {\n    for (const sheet of this.sheets.values()) if (sheet.name === name) return sheet\n    return undefined\n  }\n}\n\n/** One end of a reference: a line id, a number past the sheet's lines, or `null` for none (`B:B` has no row). */\ntype End = string | number | null\n\n/**\n * A reference held by ids: the sheet it names (`null`: the formula's own\n * sheet), then the rows and columns of its two ends. `0` for a reference\n * to a sheet that isn't there, kept as written.\n */\nexport type AnchoredRef = 0 | [sheet: string | null, rowA: End, colA: End, rowB: End, colB: End]\n\n/** Text with references, and their anchors in the order they come. */\nexport interface AnchoredText {\n  t: string\n  r?: AnchoredRef[]\n}\n\n/** The anchors of a formula's references, or `undefined` when it has none to keep. */\nexport function anchorFormula(\n  formula: string,\n  here: LayoutSheet,\n  layout: SheetLayout,\n): AnchoredRef[] | undefined {\n  const refs: AnchoredRef[] = []\n  let any = false\n  eachRef(formula, (named, a, b, text) => {\n    const target = named == null ? here : layout.byName(named)\n    if (!target) {\n      refs.push(0)\n      return text\n    }\n    any = true\n    const row = (n?: number): End => (n == null ? null : (target.rows.ids[n] ?? n))\n    const col = (n?: number): End => (n == null ? null : (target.cols.ids[n] ?? n))\n    refs.push([named == null ? null : target.id, row(a.row), col(a.col), row(b.row), col(b.col)])\n    return text\n  })\n  return any ? refs : undefined\n}\n\n/** The number of a line: its id's place, `-1` when it is gone, or the number kept for one past the ids. */\nexport function lineOf(lines: SheetLines, end: string | number): number\nexport function lineOf(lines: SheetLines, end: End): number | undefined\nexport function lineOf(lines: SheetLines, end: End) {\n  return end == null ? undefined : typeof end === 'number' ? end : lines.indexOf(end)\n}\n\n/**\n * A formula with its references where their lines are now. A reference\n * whose line or sheet is gone reads `#REF!`; one whose sheet was renamed\n * names it anew. Unchanged references keep their text as written.\n */\nexport function resolveFormula(\n  formula: string,\n  refs: readonly AnchoredRef[],\n  here: LayoutSheet,\n  layout: SheetLayout,\n) {\n  let i = 0\n  return eachRef(formula, (named, a, b, text) => {\n    const ref = refs[i++]\n    if (!ref) return text\n    const [sheetId, rowA, colA, rowB, colB] = ref\n    const target = sheetId == null ? here : layout.sheets.get(sheetId)\n    if (!target) return '#REF!'\n    const renamed = named != null && target.name !== named\n    const prefix = renamed\n      ? undefined\n      : text.includes('!')\n        ? text.slice(0, text.lastIndexOf('!') + 1)\n        : undefined\n    const r1 = lineOf(target.rows, rowA)\n    const c1 = lineOf(target.cols, colA)\n    const r2 = lineOf(target.rows, rowB)\n    const c2 = lineOf(target.cols, colB)\n    if (r1 === -1 || c1 === -1 || r2 === -1 || c2 === -1)\n      return `${prefix ?? (named != null ? `${target.name}!` : '')}#REF!`\n    if (!renamed && r1 === a.row && c1 === a.col && r2 === b.row && c2 === b.col) return text\n    const single = a === b\n    const from = { ...a, row: r1, col: c1 }\n    const to = single ? from : { ...b, row: r2, col: c2 }\n    return writeRef(named == null ? undefined : target.name, from, to, single, prefix)\n  })\n}\n\n/** A range such as `A1:C4`, anchored. */\nexport function anchorRange(range: string, here: LayoutSheet, layout: SheetLayout): AnchoredText {\n  const r = anchorFormula(`=${range}`, here, layout)\n  return r ? { t: range, r } : { t: range }\n}\n\n/** A range where its lines are now; `null` when they are gone. */\nexport function resolveRange(stored: AnchoredText, here: LayoutSheet, layout: SheetLayout) {\n  if (!stored.r) return stored.t\n  const text = resolveFormula(`=${stored.t}`, stored.r, here, layout).slice(1)\n  return text.includes('#REF!') ? null : text\n}\n\n/** A formula, or text that may be one, anchored. */\nexport function anchorText(text: string, here: LayoutSheet, layout: SheetLayout): AnchoredText {\n  const r = text.startsWith('=') ? anchorFormula(text, here, layout) : undefined\n  return r ? { t: text, r } : { t: text }\n}\n\nexport function resolveText(stored: AnchoredText, here: LayoutSheet, layout: SheetLayout) {\n  return stored.r ? resolveFormula(stored.t, stored.r, here, layout) : stored.t\n}\n\n/** Where a cell keeps the anchors of its formula in the shared document. */\nexport const REFS = '$refs'\n\nconst isFormula = (value: unknown): value is string =>\n  typeof value === 'string' && value.startsWith('=')\n\n/** A cell as the shared document keeps it: as it is, with the anchors of its formula beside. */\nexport function anchorCell(cell: SheetCellInput, here: LayoutSheet, layout: SheetLayout): unknown {\n  const value = typeof cell === 'object' && cell !== null ? cell.value : cell\n  if (!isFormula(value)) return cell ?? undefined\n  const refs = anchorFormula(value, here, layout)\n  if (!refs) return cell\n  const fields = typeof cell === 'object' && cell !== null ? cell : { value }\n  return { ...fields, [REFS]: refs }\n}\n\n/** Whether a cell kept in the shared document has references to resolve. */\nexport const hasRefs = (stored: unknown): stored is SheetCell & { [REFS]: AnchoredRef[] } =>\n  typeof stored === 'object' && stored !== null && REFS in stored\n\n/** A cell kept in the shared document, with its formula's references where they are now. */\nexport function resolveCell(stored: unknown, here: LayoutSheet, layout: SheetLayout) {\n  if (!hasRefs(stored)) return stored as SheetCellInput\n  const { [REFS]: refs, ...cell } = stored\n  if (isFormula(cell.value)) cell.value = resolveFormula(cell.value, refs, here, layout)\n  return compactCell(cell)\n}\n"],"mappings":"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"}