logisheets-formula-editor 1.1.0

package/dist/functions.d.ts

@@ -0,0 +1,3 @@
+import { FormulaFunction } from './types';
+export declare const builtinFormulaFunctions: FormulaFunction[];
+//# sourceMappingURL=functions.d.ts.map

package/dist/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../src/lib/functions.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,SAAS,CAAA;AAG5C,eAAO,MAAM,uBAAuB,EAAE,eAAe,EACxB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * logisheets-formula-editor
+ *
+ * A spreadsheet formula editor with token-based syntax highlighting (via a
+ * host callback), function autocomplete, signature help, and cell-reference
+ * coloring. Built on CodeMirror 6.
+ *
+ * This root entry includes the React `<FormulaEditor>` component. For a
+ * framework-agnostic (vanilla / Vue / Svelte / Angular) build with no React
+ * dependency, import from `logisheets-formula-editor/core` instead.
+ */
+export { FormulaEditor } from './FormulaEditor';
+export type { FormulaEditorRef } from './FormulaEditor';
+export * from './core';
+export * from './engine';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAC,aAAa,EAAC,MAAM,iBAAiB,CAAA;AAC7C,YAAY,EAAC,gBAAgB,EAAC,MAAM,iBAAiB,CAAA;AAGrD,cAAc,QAAQ,CAAA;AAGtB,cAAc,UAAU,CAAA"}

package/dist/index.js

@@ -0,0 +1,94 @@
+import { jsx as s } from "react/jsx-runtime";
+import { forwardRef as m, useRef as a, useEffect as i, useImperativeHandle as f } from "react";
+import { createFormulaEditor as g } from "./core.js";
+import { CELL_REF_COLORS as b, EOF as x, convertToDisplayUnits as E, fuzzyMatch as V, getCellRefColor as v, isFormula as N, isLocalCellRef as S, measureText as U, simpleUuid as D } from "./core.js";
+import { b as L } from "./functions-Cxg5fTo6.js";
+import { createEngineFormulaSource as P } from "./engine.js";
+const C = m(
+  (n, o) => {
+    const r = a(null), t = a(null);
+    return i(() => {
+      if (!r.current) return;
+      const e = g(r.current, {
+        value: n.value,
+        defaultValue: n.defaultValue,
+        initialCursorPosition: n.initialCursorPosition,
+        onChange: n.onChange,
+        onBlur: n.onBlur,
+        onSubmit: n.onSubmit,
+        onCancel: n.onCancel,
+        getDisplayUnits: n.getDisplayUnits,
+        formulaFunctions: n.formulaFunctions,
+        sheetName: n.sheetName,
+        config: n.config,
+        className: n.className,
+        style: n.style
+      });
+      return t.current = e, () => {
+        e.destroy(), t.current = null;
+      };
+    }, []), i(() => {
+      var e;
+      (e = t.current) == null || e.updateOptions({
+        value: n.value,
+        onChange: n.onChange,
+        onBlur: n.onBlur,
+        onSubmit: n.onSubmit,
+        onCancel: n.onCancel,
+        getDisplayUnits: n.getDisplayUnits,
+        formulaFunctions: n.formulaFunctions,
+        sheetName: n.sheetName,
+        config: n.config
+      });
+    }), f(o, () => ({
+      focus: () => {
+        var e;
+        return (e = t.current) == null ? void 0 : e.focus();
+      },
+      blur: () => {
+        var e;
+        return (e = t.current) == null ? void 0 : e.blur();
+      },
+      getValue: () => {
+        var e;
+        return ((e = t.current) == null ? void 0 : e.getValue()) ?? "";
+      },
+      setValue: (e) => {
+        var u;
+        return (u = t.current) == null ? void 0 : u.setValue(e);
+      },
+      insertText: (e) => {
+        var u;
+        return (u = t.current) == null ? void 0 : u.insertText(e);
+      },
+      replaceRange: (e, u, c) => {
+        var l;
+        return (l = t.current) == null ? void 0 : l.replaceRange(e, u, c);
+      },
+      getCursorPosition: () => {
+        var e;
+        return ((e = t.current) == null ? void 0 : e.getCursorPosition()) ?? 0;
+      },
+      getView: () => {
+        var e;
+        return ((e = t.current) == null ? void 0 : e.getView()) ?? null;
+      }
+    })), /* @__PURE__ */ s("div", { ref: r });
+  }
+);
+C.displayName = "FormulaEditor";
+export {
+  b as CELL_REF_COLORS,
+  x as EOF,
+  C as FormulaEditor,
+  L as builtinFormulaFunctions,
+  E as convertToDisplayUnits,
+  P as createEngineFormulaSource,
+  g as createFormulaEditor,
+  V as fuzzyMatch,
+  v as getCellRefColor,
+  N as isFormula,
+  S as isLocalCellRef,
+  U as measureText,
+  D as simpleUuid
+};

package/dist/inline.d.ts

@@ -0,0 +1,53 @@
+import { EngineFormulaServices } from './engine';
+import { FormulaEditorConfig, FormulaFunction } from './types';
+import { Grid, SelectedData, Session } from 'logisheets-engine';
+export interface InlineCellEditorOptions {
+    /** Element the editor + highlight overlays mount into (the view's canvas
+     *  container; also the positioning origin and refocus target). */
+    container: HTMLElement;
+    /** Emits startEdit / selectionChange / invalidFormula for this view
+     *  (an engine `Session`, or the `Engine` itself for the main view). */
+    eventSource: Pick<Session, 'on' | 'off'>;
+    /** Engine data service — `getWorkbook()` + `checkFormula()`. */
+    dataService: EngineFormulaServices;
+    /** This view's sheet index. */
+    sheetIdx: number;
+    /** Current sheet name (read fresh; used for local cell-ref coloring). */
+    getSheetName: () => string;
+    /** Commit a cell value (the host's input/ops layer). The return value is
+     *  awaited but otherwise ignored, so `void`/any Promise is fine. */
+    inputCell: (sheetIdx: number, row: number, col: number, text: string) => unknown;
+    /** Move the view's selection (e.g. after committing). */
+    setSelection: (data: SelectedData) => void;
+    /** Initial grid; keep updated via {@link InlineCellEditorHandle.setGrid}. */
+    grid?: Grid | null;
+    /** Header panel offsets (engine config leftTopWidth/Height). Default 32/24. */
+    origin?: {
+        x: number;
+        y: number;
+    };
+    /** Permission gate before opening. Default: always editable. */
+    canEdit?: (sheetIdx: number, row: number, col: number, grid: Grid) => boolean;
+    /** Autocomplete / signature functions. Default: bundled built-ins. */
+    formulaFunctions?: FormulaFunction[];
+    /** Maps a reference index to a CSS color. Default: built-in palette. */
+    getHighlightColor?: (index: number) => string;
+    /** Base editor config (merged over the in-cell defaults). */
+    editorConfig?: FormulaEditorConfig;
+    /** Called when a committed formula fails validation. */
+    onInvalidFormula?: () => void;
+    /** Reports whether an editor is open (so the canvas can avoid stealing focus). */
+    onEditingChange?: (editing: boolean) => void;
+    /** Bumped after commits / selection moves so dependents re-read content. */
+    onContentChanged?: () => void;
+}
+export interface InlineCellEditorHandle {
+    /** Call on every grid change/render: repositions the editor and repaints
+     *  highlights (parks the editor off-screen if its cell scrolled away). */
+    setGrid(grid: Grid | null): void;
+    isEditing(): boolean;
+    isEditingFormula(): boolean;
+    destroy(): void;
+}
+export declare function createInlineCellEditor(options: InlineCellEditorOptions): InlineCellEditorHandle;
+//# sourceMappingURL=inline.d.ts.map

package/dist/inline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inline.d.ts","sourceRoot":"","sources":["../src/lib/inline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAA4B,KAAK,qBAAqB,EAAC,MAAM,UAAU,CAAA;AAG9E,OAAO,EAAkB,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAC,MAAM,SAAS,CAAA;AAQvF,OAAO,KAAK,EACR,IAAI,EACJ,YAAY,EACZ,OAAO,EAEV,MAAM,mBAAmB,CAAA;AAE1B,MAAM,WAAW,uBAAuB;IACpC;sEACkE;IAClE,SAAS,EAAE,WAAW,CAAA;IACtB;2EACuE;IACvE,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG,KAAK,CAAC,CAAA;IACxC,gEAAgE;IAChE,WAAW,EAAE,qBAAqB,CAAA;IAClC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,yEAAyE;IACzE,YAAY,EAAE,MAAM,MAAM,CAAA;IAC1B;wEACoE;IACpE,SAAS,EAAE,CACP,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,KACX,OAAO,CAAA;IACZ,yDAAyD;IACzD,YAAY,EAAE,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI,CAAA;IAC1C,6EAA6E;IAC7E,IAAI,CAAC,EAAE,IAAI,GAAG,IAAI,CAAA;IAClB,+EAA+E;IAC/E,MAAM,CAAC,EAAE;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAC,CAAA;IAC/B,gEAAgE;IAChE,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,OAAO,CAAA;IAC7E,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAA;IACpC,wEAAwE;IACxE,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IAC7C,6DAA6D;IAC7D,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,wDAAwD;IACxD,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;IAC7B,kFAAkF;IAClF,eAAe,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5C,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAA;CAChC;AAED,MAAM,WAAW,sBAAsB;IACnC;8EAC0E;IAC1E,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAA;IAChC,SAAS,IAAI,OAAO,CAAA;IACpB,gBAAgB,IAAI,OAAO,CAAA;IAC3B,OAAO,IAAI,IAAI,CAAA;CAClB;AAWD,wBAAgB,sBAAsB,CAClC,OAAO,EAAE,uBAAuB,GACjC,sBAAsB,CAoRxB"}

package/dist/inline.js

@@ -0,0 +1,164 @@
+import { getCellRefColor as Q, createFormulaEditor as Z, measureText as tt } from "./core.js";
+import { createEngineFormulaSource as et } from "./engine.js";
+import { b as it } from "./functions-Cxg5fTo6.js";
+import { getReferenceHighlightRects as ot, getReferenceString as nt, isCellInGridWindow as rt, getCellRect as B, buildSelectedDataFromCell as lt } from "logisheets-engine";
+const st = '13px Consolas, Monaco, "Courier New", monospace';
+function dt(P) {
+  const {
+    container: w,
+    eventSource: a,
+    dataService: G,
+    sheetIdx: $,
+    getSheetName: z,
+    inputCell: q,
+    setSelection: N,
+    origin: u = { x: 32, y: 24 },
+    canEdit: A = () => !0,
+    formulaFunctions: I = it,
+    getHighlightColor: O = Q,
+    editorConfig: V,
+    onInvalidFormula: f,
+    onEditingChange: d,
+    onContentChanged: g
+  } = P;
+  let l = P.grid ?? null, c = !1, e = null, s = null, E = [], r = null, m = !1, p = "", C = "", n = null;
+  const S = [], R = et(G, {
+    formulaFunctions: I,
+    onCellRefs: (t) => {
+      E = t, k();
+    }
+  });
+  function T() {
+    return c && p.trim().startsWith("=");
+  }
+  function W() {
+    const t = w.querySelector("canvas");
+    t == null || t.focus({ preventScroll: !0 });
+  }
+  function H() {
+    for (const t of S) t.remove();
+    S.length = 0;
+  }
+  function k() {
+    if (H(), !l) return;
+    const t = ot(E, l, z(), {
+      originX: u.x,
+      originY: u.y
+    });
+    for (const i of t) {
+      const o = document.createElement("div");
+      o.style.cssText = `position:absolute;pointer-events:none;opacity:0.3;z-index:0;left:${i.x}px;top:${i.y}px;width:${i.width}px;height:${i.height}px;background-color:${O(i.colorIndex)};`, w.appendChild(o), S.push(o);
+    }
+  }
+  function D() {
+    !n || !e || (n.style.left = `${e.position.x}px`, n.style.top = `${e.position.y}px`, n.style.height = `${e.position.height}px`);
+  }
+  function M(t) {
+    if (!n || !e) return;
+    const i = tt(t, st) + 20;
+    n.style.width = `${Math.max(e.position.width, i)}px`;
+  }
+  function _(t) {
+    p = t, M(t), m || (r = null), m = !1;
+  }
+  function j(t) {
+    if (!s) return;
+    const i = s.getCursorPosition();
+    m = !0, r ? s.replaceRange(
+      r.startPos,
+      r.startPos + r.text.length,
+      t
+    ) : s.insertText(t), r = { text: t, startPos: (r == null ? void 0 : r.startPos) ?? i };
+  }
+  function J() {
+    s == null || s.destroy(), s = null, n == null || n.remove(), n = null;
+  }
+  function y() {
+    c = !1, e = null, E = [], r = null, m = !1, p = "", C = "", J(), H(), d == null || d(!1);
+  }
+  function K(t, i, o, h = "end") {
+    if (!l || !A($, t, i, l)) return;
+    c && y();
+    const b = B(l, t, i, {
+      originX: u.x,
+      originY: u.y,
+      defaultWidth: 100,
+      defaultHeight: 25
+    });
+    p = o, e = { sheetName: z(), row: t, col: i, position: b }, c = !0, d == null || d(!0), n = document.createElement("div"), n.style.cssText = "position:absolute;display:flex;align-items:center;box-sizing:border-box;z-index:1000;background:#fff;overflow:hidden;border:1px solid #4a90d9;box-shadow:0 1px 4px rgba(0,0,0,0.18);", w.appendChild(n);
+    const x = document.createElement("div");
+    x.style.width = "100%", x.style.boxSizing = "border-box", n.appendChild(x), D(), M(o), s = Z(x, {
+      getDisplayUnits: R.getDisplayUnits,
+      formulaFunctions: R.formulaFunctions,
+      sheetName: e.sheetName,
+      defaultValue: o,
+      initialCursorPosition: h,
+      config: {
+        fontSize: 12,
+        lineHeight: 1.2,
+        autoFocus: !0,
+        placeholder: "",
+        showBorder: !1,
+        ...V
+      },
+      style: { width: "100%", boxSizing: "border-box" },
+      onChange: _,
+      onBlur: (F) => v(F, !1),
+      onSubmit: (F) => v(F, !0),
+      onCancel: L
+    });
+  }
+  async function v(t, i = !0) {
+    if (!e) return;
+    const o = t.trim();
+    if (o.startsWith("=") && !await R.checkFormula(o)) {
+      f == null || f();
+      return;
+    }
+    const { row: h, col: b } = e;
+    await q($, h, b, o), i && N(lt(h, b, "none")), y(), g == null || g(), W();
+  }
+  function L() {
+    y(), W();
+  }
+  const U = async (t) => {
+    await Promise.resolve(), K(t.row, t.col, t.initialText);
+  }, X = (t) => {
+    var i;
+    if (T()) {
+      const o = nt(t);
+      o && o !== C && (C = o, j(o));
+      return;
+    }
+    if (c && e && ((i = t.data) == null ? void 0 : i.ty) === "cellRange") {
+      const { startRow: o, startCol: h } = t.data.d;
+      (o !== e.row || h !== e.col) && v(p, !1);
+    }
+    N(t), g == null || g();
+  }, Y = () => f == null ? void 0 : f();
+  return a.on("startEdit", U), a.on("selectionChange", X), a.on("invalidFormula", Y), {
+    setGrid(t) {
+      if (l = t, c && e && l) {
+        if (!rt(l, e.row, e.col))
+          e.position.x = -9999, e.position.y = -9999;
+        else {
+          const { x: i, y: o } = B(l, e.row, e.col, {
+            originX: u.x,
+            originY: u.y
+          });
+          e.position.x = i, e.position.y = o;
+        }
+        D();
+      }
+      k();
+    },
+    isEditing: () => c,
+    isEditingFormula: T,
+    destroy() {
+      a.off("startEdit", U), a.off("selectionChange", X), a.off("invalidFormula", Y), y();
+    }
+  };
+}
+export {
+  dt as createInlineCellEditor
+};

package/dist/types.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Types for the Formula Editor
+ *
+ * These match the backend API types from logisheets-web
+ */
+/**
+ * Token types returned by the backend lexer.
+ * The editor does NOT tokenize formulas itself - it calls a backend API.
+ */
+export type TokenType = 'funcName' | 'funcArg' | 'cellReference' | 'errorConstant' | 'wrongSuffix' | 'other';
+/**
+ * A token unit representing a slice of the formula.
+ * The backend returns an array of these for syntax highlighting.
+ */
+export interface TokenUnit {
+    tokenType: TokenType;
+    /** Start index in the formula string (0-based, excludes leading '=') */
+    start: number;
+    /** End index in the formula string (exclusive) */
+    end: number;
+}
+/**
+ * Cell reference info parsed by the backend.
+ * Used for highlighting cell references with colors.
+ */
+export interface CellRef {
+    workbook?: string;
+    sheet1?: string;
+    sheet2?: string;
+    row1?: number;
+    col1?: number;
+    row2?: number;
+    col2?: number;
+}
+/**
+ * The complete display info returned by the backend for a formula.
+ * This is what the editor receives from `getDisplayUnitsOfFormula`.
+ */
+export interface FormulaDisplayInfo {
+    cellRefs: readonly CellRef[];
+    tokenUnits: readonly TokenUnit[];
+}
+/**
+ * Function to fetch formula display info from backend.
+ * The editor calls this whenever the text changes.
+ *
+ * @param formula - The formula text (with leading '=' stripped)
+ * @returns Promise resolving to FormulaDisplayInfo or undefined if not a formula
+ */
+export type GetDisplayUnitsFunc = (formula: string) => Promise<FormulaDisplayInfo | undefined>;
+/**
+ * A formula function definition for autocomplete.
+ */
+export interface FormulaFunction {
+    /** Function name, e.g. "SUM" */
+    name: string;
+    /** Description of what the function does */
+    description: string;
+    /** Function arguments */
+    args: FormulaArg[];
+    /** Argument count constraints */
+    argCount: {
+        eq?: number;
+        ge?: number;
+        le?: number;
+    };
+}
+/**
+ * A function argument definition.
+ */
+export interface FormulaArg {
+    argName: string;
+    description: string;
+    /** If true, this argument can repeat */
+    startRepeated?: boolean;
+}
+/**
+ * An autocomplete candidate.
+ */
+export interface Candidate {
+    /** Plain text to insert when selected */
+    text: string;
+    /** Display spans with optional highlighting */
+    spans: CandidateSpan[];
+    /** Description shown in the dropdown */
+    description?: string;
+    /** If true, pressing Enter won't insert this candidate */
+    isInfoOnly?: boolean;
+    /** Position where cursor should be placed after insertion (for adding between parentheses) */
+    cursorOffset?: number;
+}
+/**
+ * A span within a candidate's display text.
+ */
+export interface CandidateSpan {
+    text: string;
+    highlight?: boolean;
+}
+/**
+ * Editor configuration options.
+ */
+export interface FormulaEditorConfig {
+    /** Font size in pixels */
+    fontSize?: number;
+    /** Font family */
+    fontFamily?: string;
+    /** Line height multiplier */
+    lineHeight?: number;
+    /** Text alignment: 'left' | 'center' | 'right' */
+    textAlign?: 'left' | 'center' | 'right';
+    /** Enable word wrap */
+    wordWrap?: boolean;
+    /** Placeholder text when empty */
+    placeholder?: string;
+    /** Read-only mode */
+    readOnly?: boolean;
+    /** Auto-focus on mount */
+    autoFocus?: boolean;
+    /** Show border around the editor */
+    showBorder?: boolean;
+}
+/**
+ * Props for the FormulaEditor component.
+ */
+export interface FormulaEditorProps {
+    /** Current value (controlled) */
+    value?: string;
+    /** Default value (uncontrolled) */
+    defaultValue?: string;
+    /** Initial cursor position: 'start' or 'end' (default: 'end') */
+    initialCursorPosition?: 'start' | 'end';
+    /** Called when value changes */
+    onChange?: (value: string) => void;
+    /** Called when editor loses focus - use this to commit the value */
+    onBlur?: (value: string) => void;
+    /** Called when Enter is pressed (without modifier keys) */
+    onSubmit?: (value: string) => void;
+    /** Called when Escape is pressed */
+    onCancel?: () => void;
+    /** Function to get display units from backend */
+    getDisplayUnits: GetDisplayUnitsFunc;
+    /** List of available formula functions for autocomplete */
+    formulaFunctions?: FormulaFunction[];
+    /** Current sheet name (for determining if cell refs are local) */
+    sheetName?: string;
+    /** Configuration options */
+    config?: FormulaEditorConfig;
+    /** Custom class name */
+    className?: string;
+    /** Custom style */
+    style?: React.CSSProperties;
+}
+/**
+ * Colors for cell reference highlighting.
+ * Returns a different color for each reference index to distinguish them.
+ */
+export declare const CELL_REF_COLORS: string[];
+export declare function getCellRefColor(index: number): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/lib/types.ts"],"names":[],"mappings":"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"}

package/dist/utils.d.ts

@@ -0,0 +1,43 @@
+import { TokenType, FormulaDisplayInfo, CellRef } from './types';
+/**
+ * Special character used to represent line breaks in the editor.
+ */
+export declare const EOF = "\n";
+/**
+ * Display unit for rendering - combines token info with content.
+ */
+export interface DisplayUnit {
+    content: string;
+    type: TokenType | 'eof' | 'plain';
+}
+/**
+ * Convert formula display info to display units for rendering.
+ * The offset accounts for the leading '=' being stripped before sending to backend.
+ *
+ * @param formula - The full formula string (including leading '=')
+ * @param displayInfo - Token info from backend
+ * @returns Array of display units for rendering
+ */
+export declare function convertToDisplayUnits(formula: string, displayInfo: FormulaDisplayInfo): DisplayUnit[];
+/**
+ * Check if a cell reference is local to the current sheet.
+ * Local refs get colored backgrounds, external refs are plain text.
+ */
+export declare function isLocalCellRef(cellRef: CellRef, currentSheet: string): boolean;
+/**
+ * Simple fuzzy match using longest common subsequence.
+ */
+export declare function fuzzyMatch(query: string, target: string): {
+    matched: boolean;
+    indices: number[];
+};
+/**
+ * Check if text starts with '=' indicating a formula.
+ */
+export declare function isFormula(text: string): boolean;
+export declare function measureText(text: string, font: string): number;
+/**
+ * Generate a simple UUID.
+ */
+export declare function simpleUuid(): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/lib/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAC,SAAS,EAAE,kBAAkB,EAAE,OAAO,EAAC,MAAM,SAAS,CAAA;AAEnE;;GAEG;AACH,eAAO,MAAM,GAAG,OAAO,CAAA;AAEvB;;GAEG;AACH,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,SAAS,GAAG,KAAK,GAAG,OAAO,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,kBAAkB,GAChC,WAAW,EAAE,CAqCf;AAqBD;;;GAGG;AACH,wBAAgB,cAAc,CAC1B,OAAO,EAAE,OAAO,EAChB,YAAY,EAAE,MAAM,GACrB,OAAO,CAcT;AAED;;GAEG;AACH,wBAAgB,UAAU,CACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GACf;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAC,CAqBvC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ/C;AAQD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAS9D;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAMnC"}

package/package.json

@@ -0,0 +1,62 @@
+{
+    "name": "logisheets-formula-editor",
+    "version": "1.1.0",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "import": "./dist/index.js",
+            "types": "./dist/index.d.ts"
+        },
+        "./core": {
+            "import": "./dist/core.js",
+            "types": "./dist/core.d.ts"
+        },
+        "./engine": {
+            "import": "./dist/engine.js",
+            "types": "./dist/engine.d.ts"
+        },
+        "./inline": {
+            "import": "./dist/inline.js",
+            "types": "./dist/inline.d.ts"
+        },
+        "./styles.css": "./dist/styles.css"
+    },
+    "peerDependencies": {
+        "logisheets-engine": "*",
+        "react": "^18.0.0 || ^19.0.0",
+        "react-dom": "^18.0.0 || ^19.0.0"
+    },
+    "peerDependenciesMeta": {
+        "logisheets-engine": {
+            "optional": true
+        }
+    },
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "dev": "vite",
+        "build": "tsc && vite build",
+        "preview": "vite preview",
+        "typecheck": "tsc --noEmit",
+        "gen:functions": "node scripts/gen-builtin-functions.mjs",
+        "prepack": "yarn build"
+    },
+    "dependencies": {
+        "@codemirror/autocomplete": "^6.18.0",
+        "@codemirror/commands": "^6.6.0",
+        "@codemirror/language": "^6.10.0",
+        "@codemirror/state": "^6.4.0",
+        "@codemirror/view": "^6.30.0",
+        "@lezer/highlight": "^1.2.0"
+    },
+    "devDependencies": {
+        "@vitejs/plugin-react": "^4.3.1",
+        "typescript": "^5.5.3",
+        "vite": "^5.4.0",
+        "vite-plugin-dts": "^4.0.0"
+    }
+}