@bilig/formula 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Greg Konush
+
+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

@@ -0,0 +1,16 @@
+# @bilig/formula
+
+Excel-style formula parsing, binding, compilation, and evaluation for bilig.
+
+## Install
+
+```bash
+npm install @bilig/formula
+```
+
+## Package entrypoints
+
+- ESM: `./dist/index.js`
+- Types: `./dist/index.d.ts`
+
+This package is part of the [bilig](https://github.com/proompteng/bilig) monorepo.

package/dist/addressing.d.ts

@@ -0,0 +1,66 @@
+export interface CellAddress {
+    sheetName?: string;
+    row: number;
+    col: number;
+    text: string;
+}
+export interface RowAddress {
+    sheetName?: string;
+    row: number;
+    text: string;
+}
+export interface ColumnAddress {
+    sheetName?: string;
+    col: number;
+    text: string;
+}
+export type ParsedReference = CellReference | RowReference | ColumnReference;
+interface CellReference {
+    kind: "cell";
+    sheetName?: string;
+    row: number;
+    col: number;
+    text: string;
+}
+interface RowReference {
+    kind: "row";
+    sheetName?: string;
+    row: number;
+    text: string;
+}
+interface ColumnReference {
+    kind: "col";
+    sheetName?: string;
+    col: number;
+    text: string;
+}
+export type RangeAddress = CellRangeAddress | RowRangeAddress | ColumnRangeAddress;
+export interface CellRangeAddress {
+    kind: "cells";
+    sheetName?: string;
+    start: CellAddress;
+    end: CellAddress;
+}
+export interface RowRangeAddress {
+    kind: "rows";
+    sheetName?: string;
+    start: RowAddress;
+    end: RowAddress;
+}
+export interface ColumnRangeAddress {
+    kind: "cols";
+    sheetName?: string;
+    start: ColumnAddress;
+    end: ColumnAddress;
+}
+export declare function columnToIndex(column: string): number;
+export declare function indexToColumn(index: number): string;
+export declare function formatAddress(row: number, col: number): string;
+export declare function isCellReferenceText(value: string): boolean;
+export declare function isColumnReferenceText(value: string): boolean;
+export declare function isRowReferenceText(value: string): boolean;
+export declare function parseCellAddress(raw: string, defaultSheetName?: string): CellAddress;
+export declare function parseRangeAddress(raw: string, defaultSheetName?: string): RangeAddress;
+export declare function toQualifiedAddress(sheetName: string, addr: string): string;
+export declare function formatRangeAddress(range: RangeAddress): string;
+export {};

package/dist/addressing.js

@@ -0,0 +1,179 @@
+const CELL_RE = /^\$?([A-Z]+)\$?([1-9][0-9]*)$/;
+const COLUMN_RE = /^\$?([A-Z]+)$/;
+const ROW_RE = /^\$?([1-9][0-9]*)$/;
+const QUALIFIED_RE = /^(?:(?:'((?:[^']|'')+)'|([^!]+))!)?(.+)$/;
+export function columnToIndex(column) {
+    let value = 0;
+    for (const char of column) {
+        value = value * 26 + (char.charCodeAt(0) - 64);
+    }
+    return value - 1;
+}
+export function indexToColumn(index) {
+    let current = index + 1;
+    let output = "";
+    while (current > 0) {
+        const rem = (current - 1) % 26;
+        output = String.fromCharCode(65 + rem) + output;
+        current = Math.floor((current - 1) / 26);
+    }
+    return output;
+}
+export function formatAddress(row, col) {
+    return `${indexToColumn(col)}${row + 1}`;
+}
+export function isCellReferenceText(value) {
+    return CELL_RE.test(value.toUpperCase());
+}
+export function isColumnReferenceText(value) {
+    return COLUMN_RE.test(value.toUpperCase());
+}
+export function isRowReferenceText(value) {
+    return ROW_RE.test(value);
+}
+export function parseCellAddress(raw, defaultSheetName) {
+    const parsed = parseReference(raw, defaultSheetName);
+    if (parsed.kind !== "cell") {
+        throw new Error(`Invalid cell address: ${raw}`);
+    }
+    const result = {
+        col: parsed.col,
+        row: parsed.row,
+        text: parsed.text,
+    };
+    if (parsed.sheetName !== undefined) {
+        result.sheetName = parsed.sheetName;
+    }
+    return result;
+}
+export function parseRangeAddress(raw, defaultSheetName) {
+    const separator = raw.indexOf(":");
+    if (separator <= 0 || separator >= raw.length - 1) {
+        throw new Error(`Invalid range address: ${raw}`);
+    }
+    const left = raw.slice(0, separator).trim();
+    const right = raw.slice(separator + 1).trim();
+    const start = parseReference(left, defaultSheetName);
+    const end = parseReference(right, start.sheetName ?? defaultSheetName);
+    const sheetName = start.sheetName ?? end.sheetName ?? defaultSheetName;
+    if (start.kind !== end.kind) {
+        throw new Error(`Range endpoints must use the same reference type: ${raw}`);
+    }
+    if (start.sheetName && end.sheetName && start.sheetName !== end.sheetName) {
+        throw new Error(`Range endpoints must target the same sheet: ${raw}`);
+    }
+    switch (start.kind) {
+        case "cell": {
+            if (end.kind !== "cell") {
+                throw new Error(`Range endpoints must use the same reference type: ${raw}`);
+            }
+            const endCell = end;
+            const row1 = Math.min(start.row, endCell.row);
+            const row2 = Math.max(start.row, endCell.row);
+            const col1 = Math.min(start.col, endCell.col);
+            const col2 = Math.max(start.col, endCell.col);
+            const result = {
+                kind: "cells",
+                start: { ...start, row: row1, col: col1, text: formatAddress(row1, col1) },
+                end: { ...endCell, row: row2, col: col2, text: formatAddress(row2, col2) },
+            };
+            if (sheetName !== undefined) {
+                result.sheetName = sheetName;
+            }
+            return result;
+        }
+        case "row": {
+            if (end.kind !== "row") {
+                throw new Error(`Range endpoints must use the same reference type: ${raw}`);
+            }
+            const endRow = end;
+            const row1 = Math.min(start.row, endRow.row);
+            const row2 = Math.max(start.row, endRow.row);
+            const result = {
+                kind: "rows",
+                start: { ...start, row: row1, text: `${row1 + 1}` },
+                end: { ...endRow, row: row2, text: `${row2 + 1}` },
+            };
+            if (sheetName !== undefined) {
+                result.sheetName = sheetName;
+            }
+            return result;
+        }
+        case "col": {
+            if (end.kind !== "col") {
+                throw new Error(`Range endpoints must use the same reference type: ${raw}`);
+            }
+            const endColumn = end;
+            const col1 = Math.min(start.col, endColumn.col);
+            const col2 = Math.max(start.col, endColumn.col);
+            const result = {
+                kind: "cols",
+                start: { ...start, col: col1, text: indexToColumn(col1) },
+                end: { ...endColumn, col: col2, text: indexToColumn(col2) },
+            };
+            if (sheetName !== undefined) {
+                result.sheetName = sheetName;
+            }
+            return result;
+        }
+    }
+}
+export function toQualifiedAddress(sheetName, addr) {
+    return `${sheetName}!${parseCellAddress(addr, sheetName).text}`;
+}
+export function formatRangeAddress(range) {
+    const prefix = range.sheetName ? `${quoteSheetNameIfNeeded(range.sheetName)}!` : "";
+    return `${prefix}${range.start.text}:${range.end.text}`;
+}
+function parseReference(raw, defaultSheetName) {
+    const trimmed = raw.trim();
+    const qualified = QUALIFIED_RE.exec(trimmed);
+    if (!qualified) {
+        throw new Error(`Invalid reference: ${raw}`);
+    }
+    const [, quotedSheet, plainSheet, refPart] = qualified;
+    const sheetName = quotedSheet?.replaceAll("''", "'") ?? plainSheet ?? defaultSheetName;
+    const normalizedRefPart = refPart.toUpperCase();
+    const cellMatch = CELL_RE.exec(normalizedRefPart);
+    if (cellMatch) {
+        const result = {
+            kind: "cell",
+            col: columnToIndex(cellMatch[1]),
+            row: Number.parseInt(cellMatch[2], 10) - 1,
+            text: `${cellMatch[1]}${cellMatch[2]}`,
+        };
+        if (sheetName !== undefined) {
+            result.sheetName = sheetName;
+        }
+        return result;
+    }
+    const columnMatch = COLUMN_RE.exec(normalizedRefPart);
+    if (columnMatch) {
+        const result = {
+            kind: "col",
+            col: columnToIndex(columnMatch[1]),
+            text: columnMatch[1],
+        };
+        if (sheetName !== undefined) {
+            result.sheetName = sheetName;
+        }
+        return result;
+    }
+    const rowMatch = ROW_RE.exec(refPart);
+    if (rowMatch) {
+        const result = {
+            kind: "row",
+            row: Number.parseInt(rowMatch[1], 10) - 1,
+            text: rowMatch[1],
+        };
+        if (sheetName !== undefined) {
+            result.sheetName = sheetName;
+        }
+        return result;
+    }
+    throw new Error(`Invalid reference: ${raw}`);
+}
+function quoteSheetNameIfNeeded(sheetName) {
+    return /^[A-Za-z0-9_.$]+$/.test(sheetName) ? sheetName : `'${sheetName.replaceAll("'", "''")}'`;
+}
+//# sourceMappingURL=addressing.js.map

package/dist/addressing.js.map

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

package/dist/ast.d.ts

@@ -0,0 +1,74 @@
+export type FormulaNode = NumberLiteralNode | BooleanLiteralNode | StringLiteralNode | ErrorLiteralNode | NameRefNode | StructuredRefNode | CellRefNode | SpillRefNode | RowRefNode | ColumnRefNode | RangeRefNode | UnaryExprNode | BinaryExprNode | CallExprNode | InvokeExprNode;
+export interface NumberLiteralNode {
+    kind: "NumberLiteral";
+    value: number;
+}
+export interface BooleanLiteralNode {
+    kind: "BooleanLiteral";
+    value: boolean;
+}
+export interface StringLiteralNode {
+    kind: "StringLiteral";
+    value: string;
+}
+export interface ErrorLiteralNode {
+    kind: "ErrorLiteral";
+    code: number;
+}
+export interface NameRefNode {
+    kind: "NameRef";
+    name: string;
+}
+export interface StructuredRefNode {
+    kind: "StructuredRef";
+    tableName: string;
+    columnName: string;
+}
+export interface CellRefNode {
+    kind: "CellRef";
+    ref: string;
+    sheetName?: string;
+}
+export interface SpillRefNode {
+    kind: "SpillRef";
+    ref: string;
+    sheetName?: string;
+}
+export interface RowRefNode {
+    kind: "RowRef";
+    ref: string;
+    sheetName?: string;
+}
+export interface ColumnRefNode {
+    kind: "ColumnRef";
+    ref: string;
+    sheetName?: string;
+}
+export interface RangeRefNode {
+    kind: "RangeRef";
+    refKind: "cells" | "rows" | "cols";
+    start: string;
+    end: string;
+    sheetName?: string;
+}
+export interface UnaryExprNode {
+    kind: "UnaryExpr";
+    operator: "+" | "-";
+    argument: FormulaNode;
+}
+export interface BinaryExprNode {
+    kind: "BinaryExpr";
+    operator: "+" | "-" | "*" | "/" | "^" | "&" | "=" | "<>" | ">" | ">=" | "<" | "<=";
+    left: FormulaNode;
+    right: FormulaNode;
+}
+export interface CallExprNode {
+    kind: "CallExpr";
+    callee: string;
+    args: FormulaNode[];
+}
+export interface InvokeExprNode {
+    kind: "InvokeExpr";
+    callee: FormulaNode;
+    args: FormulaNode[];
+}

package/dist/ast.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=ast.js.map

package/dist/ast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ast.js","sourceRoot":"","sources":["../src/ast.ts"],"names":[],"mappings":""}

package/dist/binder.d.ts

@@ -0,0 +1,13 @@
+import { BuiltinId, FormulaMode } from "@bilig/protocol";
+import type { FormulaNode } from "./ast.js";
+export interface BoundFormula {
+    ast: FormulaNode;
+    deps: string[];
+    symbolicNames: string[];
+    symbolicTables: string[];
+    symbolicSpills: string[];
+    mode: FormulaMode;
+}
+export declare function bindFormula(ast: FormulaNode): BoundFormula;
+export declare function isBuiltinAvailable(name: string): boolean;
+export declare function encodeBuiltin(name: string): BuiltinId;