feat(base-formula): add name-to-id resolver with dependency extraction

This commit is contained in:
Philipinho
2026-04-23 23:46:52 +01:00
parent d8c96089b1
commit 216a4a99e1
4 changed files with 121 additions and 1 deletions
@@ -1,4 +1,4 @@
import { parseRaw } from "@docmost/base-formula/server";
import { parseRaw, resolve } from "@docmost/base-formula/server";
import type { RawFormulaAST } from "@docmost/base-formula/server";
describe("parseRaw", () => {
@@ -112,3 +112,52 @@ describe("parseRaw", () => {
expect(() => parseRaw("prop()")).toThrow();
});
});
describe("resolve", () => {
const names = new Map([
["Price", "prop_price"],
["Qty", "prop_qty"],
]);
it("replaces propName with prop (id)", () => {
const raw = parseRaw('prop("Price")');
const out = resolve(raw, names);
expect(out.ast).toEqual({ t: "prop", id: "prop_price" });
expect(out.dependencies).toEqual(["prop_price"]);
});
it("walks into nested structures", () => {
const raw = parseRaw('prop("Price") * prop("Qty")');
const out = resolve(raw, names);
expect(out.ast).toEqual({
t: "op", op: "*", args: [
{ t: "prop", id: "prop_price" },
{ t: "prop", id: "prop_qty" },
],
});
expect([...out.dependencies].sort()).toEqual(["prop_price", "prop_qty"]);
});
it("dedupes dependencies", () => {
const raw = parseRaw('prop("Price") + prop("Price")');
const out = resolve(raw, names);
expect(out.dependencies).toEqual(["prop_price"]);
});
it("throws UNKNOWN_PROPERTY with a span", () => {
const raw = parseRaw('prop("Nope")');
try {
resolve(raw, names);
fail("expected throw");
} catch (e: any) {
expect(e.errors[0].code).toBe("UNKNOWN_PROPERTY");
expect(e.errors[0].message).toContain("Nope");
}
});
it("handles if/and/or/call", () => {
const raw = parseRaw('if(prop("Price") > 0, prop("Qty"), 0)');
const out = resolve(raw, names);
expect(out.ast.t).toBe("if");
});
});