@businessdash/sdk 0.9.60

package/dist/errors.js

@@ -0,0 +1,188 @@
+export class BiabApiError extends Error {
+    status;
+    body;
+    path;
+    constructor(input) {
+        super(input.message);
+        this.name = "BiabApiError";
+        this.status = input.status;
+        this.body = input.body;
+        this.path = input.path;
+    }
+}
+export function isBiabPlanGateBody(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const v = value;
+    if (v["available"] !== false)
+        return false;
+    if (v["reason"] !== "plan_required" &&
+        v["reason"] !== "payment_required" &&
+        v["reason"] !== "service_suspended") {
+        return false;
+    }
+    return (typeof v["upgradeUrl"] === "string" && typeof v["message"] === "string");
+}
+/**
+ * Base class for every billing/entitlement rejection. Catch this to
+ * handle "the SDK refused to serve" uniformly; catch one of the three
+ * subclasses (or `instanceof`-narrow on this class) to branch on the
+ * specific reason.
+ */
+export class BiabAccessRejectedError extends Error {
+    reason;
+    upgradeUrl;
+    featureMessage;
+    path;
+    status;
+    constructor(input) {
+        super(input.body.message);
+        this.name = "BiabAccessRejectedError";
+        this.reason = input.body.reason;
+        this.upgradeUrl = input.body.upgradeUrl;
+        this.featureMessage = input.body.message;
+        this.path = input.path;
+        this.status = input.status;
+    }
+}
+/**
+ * Thrown when the org's plan doesn't include the feature the call
+ * needs. The org can resolve this by upgrading (or by adding the
+ * specific feature à la carte once that surface ships).
+ */
+export class BiabFeatureNotEntitledError extends BiabAccessRejectedError {
+    feature;
+    requiredPlan;
+    planDisplayName;
+    constructor(input) {
+        super(input);
+        this.name = "BiabFeatureNotEntitledError";
+        this.feature = input.body.requiredFeature;
+        this.requiredPlan = input.body.requiredPlan;
+        this.planDisplayName = input.body.planDisplayName;
+    }
+}
+/**
+ * Thrown when the org's billing is 0-60 days past-due. Static-data
+ * routes (marketing bundle, sitemap, robots, parallel-page reads,
+ * gallery/blog reads) continue serving normally — interactive ones
+ * (forms, cart, scheduling bookings, chatbot writes) throw this.
+ */
+export class BiabPaymentLapsedError extends BiabAccessRejectedError {
+    daysLapsed;
+    daysUntilSuspension;
+    constructor(input) {
+        super(input);
+        this.name = "BiabPaymentLapsedError";
+        this.daysLapsed = input.body.daysLapsed;
+        this.daysUntilSuspension = input.body.daysUntilSuspension;
+    }
+}
+/**
+ * Thrown when the org's billing has been past-due for more than 60
+ * days. Every SDK call throws this; the consumer's framework-level
+ * page handler should catch it and return HTTP 503 with a "site
+ * temporarily unavailable" page so search engines treat the outage
+ * as temporary. `robots.txt` and `sitemap.xml` separately switch to
+ * suspended-mode bodies (`Disallow: /` / empty) for the same reason.
+ */
+export class BiabServiceSuspendedError extends BiabAccessRejectedError {
+    daysLapsed;
+    constructor(input) {
+        super(input);
+        this.name = "BiabServiceSuspendedError";
+        this.daysLapsed = input.body.daysLapsed;
+    }
+}
+/**
+ * Factory the transport uses to throw the right subclass.
+ */
+export function accessRejectionFromBody(input) {
+    switch (input.body.reason) {
+        case "plan_required":
+            return new BiabFeatureNotEntitledError({
+                body: input.body,
+                path: input.path,
+                status: input.status,
+            });
+        case "payment_required":
+            return new BiabPaymentLapsedError({
+                body: input.body,
+                path: input.path,
+                status: input.status,
+            });
+        case "service_suspended":
+            return new BiabServiceSuspendedError({
+                body: input.body,
+                path: input.path,
+                status: input.status,
+            });
+    }
+}
+export async function unwrapAccess(fn) {
+    try {
+        const data = await fn();
+        return { data, rejected: null };
+    }
+    catch (err) {
+        if (err instanceof BiabFeatureNotEntitledError) {
+            return {
+                data: null,
+                rejected: {
+                    reason: "plan_required",
+                    feature: err.feature,
+                    requiredPlan: err.requiredPlan,
+                    planDisplayName: err.planDisplayName,
+                    upgradeUrl: err.upgradeUrl,
+                    message: err.featureMessage,
+                },
+            };
+        }
+        if (err instanceof BiabPaymentLapsedError) {
+            return {
+                data: null,
+                rejected: {
+                    reason: "payment_required",
+                    daysLapsed: err.daysLapsed,
+                    daysUntilSuspension: err.daysUntilSuspension,
+                    upgradeUrl: err.upgradeUrl,
+                    message: err.featureMessage,
+                },
+            };
+        }
+        if (err instanceof BiabServiceSuspendedError) {
+            return {
+                data: null,
+                rejected: {
+                    reason: "service_suspended",
+                    daysLapsed: err.daysLapsed,
+                    upgradeUrl: err.upgradeUrl,
+                    message: err.featureMessage,
+                },
+            };
+        }
+        throw err;
+    }
+}
+export async function unwrapEntitlement(fn) {
+    try {
+        const data = await fn();
+        return { data, notEntitled: null };
+    }
+    catch (err) {
+        if (err instanceof BiabFeatureNotEntitledError) {
+            return {
+                data: null,
+                notEntitled: {
+                    feature: err.feature,
+                    requiredPlan: err.requiredPlan,
+                    planDisplayName: err.planDisplayName,
+                    upgradeUrl: err.upgradeUrl,
+                    featureMessage: err.featureMessage,
+                },
+            };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/forms-core/autocomplete.d.ts

@@ -0,0 +1,37 @@
+/**
+ * HTML autofill (`autocomplete`) resolution for `<BiabForm>` inputs.
+ *
+ * Browsers autofill an input when it carries a recognized `autocomplete` token
+ * (https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill).
+ * The SDK infers a sensible token per field (so a "Full name" text field gets
+ * `name`, an email field gets `email`, etc.), and lets the consumer:
+ *
+ *   - turn it off globally (`<BiabForm autoComplete={false}>` → every input
+ *     gets `autocomplete="off"`), and
+ *   - override per field (`fieldAutoComplete={{ [fieldId]: "off" | true | token }}`),
+ *
+ * Precedence (highest first): per-field override → schema token (`field.autocomplete`)
+ * → global off → inferred token.
+ */
+import type { FormCoreField } from "./validation.js";
+/** Global + per-field autofill configuration, threaded from `<BiabForm>`. */
+export type AutocompleteConfig = {
+    /** Global default. `false` emits `autocomplete="off"` on every input.
+     *  Defaults to `true` (infer tokens). */
+    enabled?: boolean;
+    /** Per-field overrides keyed by field id: a literal token, `true` (infer),
+     *  or `false` (off). Wins over everything else. */
+    overrides?: Record<string, string | boolean>;
+};
+/**
+ * Best-guess `autocomplete` token for a field from its type, then its key/label.
+ * Returns `undefined` when nothing sensible applies (e.g. a freeform number) so
+ * the attribute can be omitted entirely.
+ */
+export declare function inferAutocompleteToken(field: FormCoreField): string | undefined;
+/**
+ * Resolve the final `autocomplete` attribute value for a field, or `undefined`
+ * to omit it. Applies the precedence documented above.
+ */
+export declare function resolveFieldAutocomplete(field: FormCoreField, config: AutocompleteConfig): string | undefined;
+//# sourceMappingURL=autocomplete.d.ts.map

package/dist/forms-core/autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.d.ts","sourceRoot":"","sources":["../../src/forms-core/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAAG;IAChC;6CACyC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;uDACmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;CAC7C,CAAC;AA6BF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACrC,KAAK,EAAE,aAAa,GAClB,MAAM,GAAG,SAAS,CAcpB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACvC,KAAK,EAAE,aAAa,EACpB,MAAM,EAAE,kBAAkB,GACxB,MAAM,GAAG,SAAS,CAWpB"}

package/dist/forms-core/autocomplete.js

@@ -0,0 +1,82 @@
+/**
+ * HTML autofill (`autocomplete`) resolution for `<BiabForm>` inputs.
+ *
+ * Browsers autofill an input when it carries a recognized `autocomplete` token
+ * (https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill).
+ * The SDK infers a sensible token per field (so a "Full name" text field gets
+ * `name`, an email field gets `email`, etc.), and lets the consumer:
+ *
+ *   - turn it off globally (`<BiabForm autoComplete={false}>` → every input
+ *     gets `autocomplete="off"`), and
+ *   - override per field (`fieldAutoComplete={{ [fieldId]: "off" | true | token }}`),
+ *
+ * Precedence (highest first): per-field override → schema token (`field.autocomplete`)
+ * → global off → inferred token.
+ */
+/** Label/key → token heuristics, in priority order (first match wins). */
+const KEY_TOKEN_MAP = [
+    [/first[\s_-]?name|given[\s_-]?name/i, "given-name"],
+    [/last[\s_-]?name|family[\s_-]?name|surname/i, "family-name"],
+    [/full[\s_-]?name|your[\s_-]?name|^name$|contact[\s_-]?name/i, "name"],
+    [/company|organi[sz]ation|business[\s_-]?name|employer/i, "organization"],
+    [/job[\s_-]?title|position|occupation/i, "organization-title"],
+    [/web[\s_-]?site|homepage|\burl\b/i, "url"],
+    [
+        /address[\s_-]?line[\s_-]?2|apartment|\bapt\b|\bsuite\b|\bunit\b/i,
+        "address-line2",
+    ],
+    [
+        /street|address[\s_-]?line[\s_-]?1|^address1?$|street[\s_-]?address/i,
+        "street-address",
+    ],
+    [/\bcity\b|\btown\b/i, "address-level2"],
+    [/\bstate\b|province|region/i, "address-level1"],
+    [/\bzip\b|postal|post[\s_-]?code/i, "postal-code"],
+    [/\bcountry\b/i, "country-name"],
+    [/birth|\bdob\b/i, "bday"],
+    [
+        /work[\s_-]?phone|office[\s_-]?phone|company[\s_-]?phone|mobile|cell/i,
+        "tel",
+    ],
+];
+/**
+ * Best-guess `autocomplete` token for a field from its type, then its key/label.
+ * Returns `undefined` when nothing sensible applies (e.g. a freeform number) so
+ * the attribute can be omitted entirely.
+ */
+export function inferAutocompleteToken(field) {
+    switch (field.type) {
+        case "email":
+            return "email";
+        case "phone":
+            return "tel";
+        case "url":
+            return "url";
+    }
+    const haystack = `${field.key ?? ""} ${field.label ?? ""}`;
+    for (const [pattern, token] of KEY_TOKEN_MAP) {
+        if (pattern.test(haystack))
+            return token;
+    }
+    return undefined;
+}
+/**
+ * Resolve the final `autocomplete` attribute value for a field, or `undefined`
+ * to omit it. Applies the precedence documented above.
+ */
+export function resolveFieldAutocomplete(field, config) {
+    const override = config.overrides?.[field.id];
+    if (typeof override === "string")
+        return override;
+    if (override === false)
+        return "off";
+    if (override === true)
+        return inferAutocompleteToken(field) ?? "on";
+    if (typeof field.autocomplete === "string" && field.autocomplete) {
+        return field.autocomplete;
+    }
+    if (config.enabled === false)
+        return "off";
+    return inferAutocompleteToken(field);
+}
+//# sourceMappingURL=autocomplete.js.map

package/dist/forms-core/autocomplete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../../src/forms-core/autocomplete.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAcH,0EAA0E;AAC1E,MAAM,aAAa,GAA6C;IAC/D,CAAC,oCAAoC,EAAE,YAAY,CAAC;IACpD,CAAC,4CAA4C,EAAE,aAAa,CAAC;IAC7D,CAAC,4DAA4D,EAAE,MAAM,CAAC;IACtE,CAAC,uDAAuD,EAAE,cAAc,CAAC;IACzE,CAAC,sCAAsC,EAAE,oBAAoB,CAAC;IAC9D,CAAC,kCAAkC,EAAE,KAAK,CAAC;IAC3C;QACC,kEAAkE;QAClE,eAAe;KACf;IACD;QACC,qEAAqE;QACrE,gBAAgB;KAChB;IACD,CAAC,oBAAoB,EAAE,gBAAgB,CAAC;IACxC,CAAC,4BAA4B,EAAE,gBAAgB,CAAC;IAChD,CAAC,iCAAiC,EAAE,aAAa,CAAC;IAClD,CAAC,cAAc,EAAE,cAAc,CAAC;IAChC,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAC1B;QACC,sEAAsE;QACtE,KAAK;KACL;CACD,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACrC,KAAoB;IAEpB,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,OAAO;YACX,OAAO,OAAO,CAAC;QAChB,KAAK,OAAO;YACX,OAAO,KAAK,CAAC;QACd,KAAK,KAAK;YACT,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;IAC3D,KAAK,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,aAAa,EAAE,CAAC;QAC9C,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;IAC1C,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACvC,KAAoB,EACpB,MAA0B;IAE1B,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACrC,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,sBAAsB,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;IAEpE,IAAI,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QAClE,OAAO,KAAK,CAAC,YAAY,CAAC;IAC3B,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC"}

package/dist/forms-core/business-function.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Business-function runtime — the typed layer over the formula engine.
+ *
+ * A business function has typed **inputs** (with required/default) and one or
+ * more typed **outputs** ("exported variables"), each its own expression. This
+ * module runs a function definition end-to-end and *self-corrects*: a missing
+ * optional input falls back to its default; a missing required input or a
+ * bad/null/wrong-type output is flagged per-output (with an optional fallback)
+ * while the other outputs still resolve — it never throws out. Outputs may
+ * reference inputs, prior outputs (declaration order = a mini-pipeline), and
+ * other business functions (composition).
+ *
+ * Pure + isomorphic (no DB, no React). The registry/UI and the form runner build
+ * on this; the SDK mirrors it.
+ */
+import { type EvalOptions, type FormulaObject, type FormulaValue } from "./formula.js";
+export type FnValueType = "number" | "text" | "boolean" | "date" | "object" | "any";
+export interface FnInput {
+    key: string;
+    label?: string;
+    type: FnValueType;
+    required?: boolean;
+    default?: FormulaValue;
+}
+export interface FnOutput {
+    key: string;
+    label?: string;
+    type: FnValueType;
+    /** Expression over inputs / prior outputs / other functions. */
+    formula: string;
+    /** Used when the computed value is missing/invalid for the declared type. */
+    fallback?: FormulaValue;
+}
+export interface BusinessFunctionDef {
+    slug?: string;
+    inputs: FnInput[];
+    outputs: FnOutput[];
+}
+export interface FnIssue {
+    scope: "input" | "output";
+    key: string;
+    reason: string;
+}
+export interface FnRunResult {
+    ok: boolean;
+    /** The exported object — successfully computed outputs (incl. applied fallbacks). */
+    outputs: FormulaObject;
+    issues: FnIssue[];
+}
+/**
+ * Run a business function. `rawInputs` is keyed by input `key`. `options.functions`
+ * supplies other business functions for composition. Never throws.
+ */
+export declare function runBusinessFunction(def: BusinessFunctionDef, rawInputs: Record<string, unknown>, options?: EvalOptions): FnRunResult;
+/** Build the {@link EvalOptions} function map from a set of business functions,
+ *  so formulas can call them by name. Params are the function's input keys (in
+ *  order); a call resolves to the function's FIRST output (single-output
+ *  convenience) — multi-output composition is wired via input bindings, not
+ *  in-formula calls. */
+export declare function functionsToEvalOptions(defs: Record<string, BusinessFunctionDef>): EvalOptions;
+//# sourceMappingURL=business-function.d.ts.map

package/dist/forms-core/business-function.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-function.d.ts","sourceRoot":"","sources":["../../src/forms-core/business-function.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EAKjB,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,WAAW,GACpB,QAAQ,GACR,MAAM,GACN,SAAS,GACT,MAAM,GACN,QAAQ,GACR,KAAK,CAAC;AAET,MAAM,WAAW,OAAO;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IACnC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,EAAE,CAAC;IAClB,OAAO,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACvB,KAAK,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,qFAAqF;IACrF,OAAO,EAAE,aAAa,CAAC;IACvB,MAAM,EAAE,OAAO,EAAE,CAAC;CAClB;AAuDD;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,mBAAmB,EACxB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,OAAO,CAAC,EAAE,WAAW,GACnB,WAAW,CAwDb;AAED;;;;wBAIwB;AACxB,wBAAgB,sBAAsB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GACvC,WAAW,CAWb"}

package/dist/forms-core/business-function.js

@@ -0,0 +1,149 @@
+/**
+ * Business-function runtime — the typed layer over the formula engine.
+ *
+ * A business function has typed **inputs** (with required/default) and one or
+ * more typed **outputs** ("exported variables"), each its own expression. This
+ * module runs a function definition end-to-end and *self-corrects*: a missing
+ * optional input falls back to its default; a missing required input or a
+ * bad/null/wrong-type output is flagged per-output (with an optional fallback)
+ * while the other outputs still resolve — it never throws out. Outputs may
+ * reference inputs, prior outputs (declaration order = a mini-pipeline), and
+ * other business functions (composition).
+ *
+ * Pure + isomorphic (no DB, no React). The registry/UI and the form runner build
+ * on this; the SDK mirrors it.
+ */
+import { isFormulaObjectValue, parseFormula, runFormula, } from "./formula.js";
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}([T ].*)?$/;
+/** Coerce a raw value to a declared type, or return an error reason. */
+function coerce(value, type) {
+    if (type === "any")
+        return { ok: true, value: value };
+    if (type === "object") {
+        if (value && typeof value === "object" && !Array.isArray(value))
+            return { ok: true, value: value };
+        return { ok: false, reason: "expected an object" };
+    }
+    if (type === "number") {
+        const n = typeof value === "number" ? value : Number(value);
+        return Number.isNaN(n)
+            ? { ok: false, reason: "not a number" }
+            : { ok: true, value: n };
+    }
+    if (type === "boolean") {
+        if (typeof value === "boolean")
+            return { ok: true, value };
+        if (value === "true" || value === 1)
+            return { ok: true, value: true };
+        if (value === "false" || value === 0)
+            return { ok: true, value: false };
+        return { ok: false, reason: "not a boolean" };
+    }
+    if (type === "date") {
+        const s = String(value);
+        if (ISO_DATE.test(s) && !Number.isNaN(new Date(s).getTime()))
+            return { ok: true, value: s };
+        return { ok: false, reason: "not a date" };
+    }
+    // text
+    return { ok: true, value: typeof value === "string" ? value : String(value) };
+}
+/** Validate an already-computed value against a declared output type. */
+function matchesType(value, type) {
+    switch (type) {
+        case "any":
+            return true;
+        case "number":
+            return typeof value === "number" && !Number.isNaN(value);
+        case "text":
+            return typeof value === "string";
+        case "boolean":
+            return typeof value === "boolean";
+        case "object":
+            return isFormulaObjectValue(value);
+        case "date":
+            return typeof value === "string" && ISO_DATE.test(value);
+    }
+}
+/**
+ * Run a business function. `rawInputs` is keyed by input `key`. `options.functions`
+ * supplies other business functions for composition. Never throws.
+ */
+export function runBusinessFunction(def, rawInputs, options) {
+    const issues = [];
+    const vars = {};
+    // 1. Coerce inputs (missing optional → default; missing required → issue).
+    for (const input of def.inputs) {
+        const raw = rawInputs[input.key];
+        const missing = raw === undefined || raw === null || raw === "";
+        if (missing) {
+            if (input.default !== undefined) {
+                vars[input.key] = input.default;
+            }
+            else if (input.required) {
+                issues.push({
+                    scope: "input",
+                    key: input.key,
+                    reason: "required value is missing",
+                });
+            }
+            continue;
+        }
+        const c = coerce(raw, input.type);
+        if (c.ok)
+            vars[input.key] = c.value;
+        else
+            issues.push({ scope: "input", key: input.key, reason: c.reason });
+    }
+    // 2. Evaluate each output in order; later outputs can read earlier ones.
+    const outputs = {};
+    for (const out of def.outputs) {
+        const r = runFormula(out.formula, vars, options);
+        if (!r.ok) {
+            if (out.fallback !== undefined) {
+                outputs[out.key] = out.fallback;
+                vars[out.key] = out.fallback;
+            }
+            else {
+                issues.push({ scope: "output", key: out.key, reason: r.error });
+            }
+            continue;
+        }
+        if (!matchesType(r.value, out.type)) {
+            if (out.fallback !== undefined) {
+                outputs[out.key] = out.fallback;
+                vars[out.key] = out.fallback;
+            }
+            else {
+                issues.push({
+                    scope: "output",
+                    key: out.key,
+                    reason: `expected ${out.type}`,
+                });
+            }
+            continue;
+        }
+        outputs[out.key] = r.value;
+        vars[out.key] = r.value;
+    }
+    return { ok: issues.length === 0, outputs, issues };
+}
+/** Build the {@link EvalOptions} function map from a set of business functions,
+ *  so formulas can call them by name. Params are the function's input keys (in
+ *  order); a call resolves to the function's FIRST output (single-output
+ *  convenience) — multi-output composition is wired via input bindings, not
+ *  in-formula calls. */
+export function functionsToEvalOptions(defs) {
+    const functions = {};
+    for (const [name, def] of Object.entries(defs)) {
+        const first = def.outputs[0];
+        if (!first)
+            continue;
+        functions[name] = {
+            params: def.inputs.map((i) => i.key),
+            formula: parseFormula(first.formula),
+        };
+    }
+    return { functions };
+}
+//# sourceMappingURL=business-function.js.map

package/dist/forms-core/business-function.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"business-function.js","sourceRoot":"","sources":["../../src/forms-core/business-function.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAKN,oBAAoB,EACpB,YAAY,EACZ,UAAU,GACV,MAAM,cAAc,CAAC;AA+CtB,MAAM,QAAQ,GAAG,8BAA8B,CAAC;AAEhD,wEAAwE;AACxE,SAAS,MAAM,CACd,KAAc,EACd,IAAiB;IAEjB,IAAI,IAAI,KAAK,KAAK;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAqB,EAAE,CAAC;IACtE,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAC9D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAsB,EAAE,CAAC;QACpD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrB,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE;YACvC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC3B,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,IAAI,OAAO,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAC3D,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACtE,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACxE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC/C,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YAC3D,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO;IACP,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC/E,CAAC;AAED,yEAAyE;AACzE,SAAS,WAAW,CAAC,KAAmB,EAAE,IAAiB;IAC1D,QAAQ,IAAI,EAAE,CAAC;QACd,KAAK,KAAK;YACT,OAAO,IAAI,CAAC;QACb,KAAK,QAAQ;YACZ,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1D,KAAK,MAAM;YACV,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;QAClC,KAAK,SAAS;YACb,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;QACnC,KAAK,QAAQ;YACZ,OAAO,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACpC,KAAK,MAAM;YACV,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAClC,GAAwB,EACxB,SAAkC,EAClC,OAAqB;IAErB,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAgB,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;QAChE,IAAI,OAAO,EAAE,CAAC;YACb,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC;YACjC,CAAC;iBAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC3B,MAAM,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,OAAO;oBACd,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,MAAM,EAAE,2BAA2B;iBACnC,CAAC,CAAC;YACJ,CAAC;YACD,SAAS;QACV,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,CAAC,EAAE;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,yEAAyE;IACzE,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,KAAK,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACX,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,SAAS;QACV,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAChC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;gBAChC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC9B,CAAC;iBAAM,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,QAAQ;oBACf,GAAG,EAAE,GAAG,CAAC,GAAG;oBACZ,MAAM,EAAE,YAAY,GAAG,CAAC,IAAI,EAAE;iBAC9B,CAAC,CAAC;YACJ,CAAC;YACD,SAAS;QACV,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;IACzB,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACrD,CAAC;AAED;;;;wBAIwB;AACxB,MAAM,UAAU,sBAAsB,CACrC,IAAyC;IAEzC,MAAM,SAAS,GAA0C,EAAE,CAAC;IAC5D,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,SAAS,CAAC,IAAI,CAAC,GAAG;YACjB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;YACpC,OAAO,EAAE,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;SACpC,CAAC;IACH,CAAC;IACD,OAAO,EAAE,SAAS,EAAE,CAAC;AACtB,CAAC"}

package/dist/forms-core/calculation.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Calculation/Math form-element runtime — the bridge between a form's
+ * "calculation" field and the Business Functions engine.
+ *
+ * A calculation field computes a value from OTHER fields in the same form,
+ * either by an **inline formula** (mode "formula") or by referencing a saved
+ * **business function** (mode "function"). Input variables are bound to source
+ * fields via `inputMap` (variable name → source field id). The result is the
+ * field's submitted value; for a multi-output function, `outputKey` selects
+ * which exported variable to surface (default: the function's first output).
+ *
+ * Sensitivity: a calculation that references a `sensitive` function MUST run
+ * server-only (its formula/def is never published). This module is pure and
+ * environment-agnostic — the CALLER decides whether to run it (the client skips
+ * sensitive calcs and shows a placeholder; the server always computes the
+ * authoritative value on submit).
+ *
+ * Pure + isomorphic (no DB, no React). The SDK mirrors it.
+ */
+import { type BusinessFunctionDef } from "./business-function.js";
+import { type EvalOptions, type FormulaObject, type FormulaValue } from "./formula.js";
+export interface CalcInputBinding {
+    /** The variable name (formula) or function input key this binding feeds. */
+    variable: string;
+    /** The source field id whose value supplies it. */
+    fieldId: string;
+}
+export interface CalcDisplay {
+    /** Show the computed value live in the rendered form. */
+    show?: boolean;
+    prefix?: string;
+    suffix?: string;
+    /** Fixed decimal places for a numeric result (omit = as-is). */
+    decimals?: number;
+}
+export interface CalculationConfig {
+    mode?: "formula" | "function";
+    /** Inline expression (mode "formula"). Non-sensitive only. */
+    formula?: string;
+    /** Referenced business function id (mode "function"). */
+    functionId?: string;
+    /** Which function output to surface as the value (default: first output). */
+    outputKey?: string;
+    /** Binds variables / function input keys to source field ids. */
+    inputMap?: CalcInputBinding[];
+    display?: CalcDisplay;
+    /** True when it references a sensitive function → compute server-only. */
+    sensitive?: boolean;
+}
+export interface CalcResult {
+    ok: boolean;
+    /** The surfaced value (the chosen output, or the formula result). */
+    value: FormulaValue | null;
+    /** For a function calc, the full exported object. */
+    outputs?: FormulaObject;
+    error?: string;
+}
+export interface CalcContext {
+    /** Saved business functions keyed by id (for mode "function"). */
+    functionsById?: Record<string, BusinessFunctionDef>;
+    /** Eval options exposing other functions for composition (by UPPERCASE slug). */
+    evalOptions?: EvalOptions;
+}
+/** Apply display formatting (prefix/suffix/decimals) for rendering. Pure. */
+export declare function formatCalcValue(value: FormulaValue | null, display?: CalcDisplay): string;
+/**
+ * Compute a calculation field. `resolveField(fieldId)` returns the current
+ * value of a source field. Never throws — returns `{ ok:false, error }` on a
+ * bad config or evaluation error.
+ */
+export declare function computeCalculation(config: CalculationConfig, resolveField: (fieldId: string) => unknown, ctx?: CalcContext): CalcResult;
+//# sourceMappingURL=calculation.d.ts.map

package/dist/forms-core/calculation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calculation.d.ts","sourceRoot":"","sources":["../../src/forms-core/calculation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACN,KAAK,mBAAmB,EAExB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EAGjB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,gBAAgB;IAChC,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC3B,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;IAC9B,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC9B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,UAAU;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,qEAAqE;IACrE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAC;IAC3B,qDAAqD;IACrD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC3B,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACpD,iFAAiF;IACjF,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B;AAYD,6EAA6E;AAC7E,wBAAgB,eAAe,CAC9B,KAAK,EAAE,YAAY,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE,WAAW,GACnB,MAAM,CAeR;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,iBAAiB,EACzB,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,EAC1C,GAAG,GAAE,WAAgB,GACnB,UAAU,CA+CZ"}