@bilig/headless 0.9.0 → 0.9.2

package/README.md

@@ -2,6 +2,7 @@
 
 [![npm: @bilig/headless](https://img.shields.io/npm/v/@bilig/headless?label=%40bilig%2Fheadless)](https://www.npmjs.com/package/@bilig/headless)
 [![GitHub](https://img.shields.io/badge/GitHub-proompteng%2Fbilig-blue)](https://github.com/proompteng/bilig)
+[![GitHub Repo stars](https://img.shields.io/github/stars/proompteng/bilig?style=social)](https://github.com/proompteng/bilig/stargazers)
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](../../LICENSE)
 
 `@bilig/headless` is the production-targeted WorkPaper workbook facade for
@@ -45,6 +46,14 @@ Supported scope:
 - The contract is the WorkPaper/headless API exported by this package.
 - Excel-file ingestion belongs to import/export pipelines before data reaches
   `WorkPaper`; this package executes the validated WorkPaper workbook model.
+- XLSX cached-result parity investigations are covered by the repository
+  verifier, not by the published package surface. Use
+  `pnpm workpaper:xlsx-corpus:check -- <xlsx-file-or-directory>` for external
+  corpora, and `pnpm workpaper:xlsx-corpus:fixtures:check` for the checked-in
+  issue #8 reduction corpus. The verifier compares deterministic cached formula
+  results and skips volatile or environment-dependent formulas such as `NOW()`
+  and `CELL("filename")`; unsupported deterministic formulas remain visible as
+  mismatches instead of being silently accepted.
 - Custom function plugins and callback hooks are runtime registrations. Persist
   workbook data with the helpers below, then register custom behavior in
   application code before restore.
@@ -69,6 +78,8 @@ Repository:
 - npm: <https://www.npmjs.com/package/@bilig/headless>
 - runnable example:
   [`examples/headless-workpaper`](../../examples/headless-workpaper)
+- public adoption kit:
+  [`docs/public-adoption-kit.md`](../../docs/public-adoption-kit.md)
 
 Inside this monorepo:
 
@@ -147,6 +158,10 @@ npm start
 Repository CI also runs the same example against packed local runtime packages
 through `pnpm workpaper:smoke:external`.
 
+For a concise evaluator-facing summary with copy-paste npm commands, proof
+links, shareable copy, and overclaim guardrails, use the root
+[`Public Adoption Kit`](../../docs/public-adoption-kit.md).
+
 ## Core Concepts
 
 - `WorkPaper` is the top-level workbook object. Create it with
@@ -157,6 +172,11 @@ through `pnpm workpaper:smoke:external`.
 - A string beginning with `=` is a formula. Other strings are literal text.
   `null` clears a cell.
 - `getCellValue()` returns a computed `CellValue`.
+- `getCellDisplayValue()` returns the formatted user-facing text for a cell,
+  including workbook error text such as `#VALUE!`.
+- `getCellFormulaDiagnostics()` returns structured formula diagnostics for
+  supported error families, including financial cash-flow/date validation for
+  `XIRR()` and `XNPV()`.
 - `getCellFormula()` returns the formula text when the cell is a formula.
 - `getCellSerialized()` returns the persisted cell input shape.
 - Mutation methods return WorkPaper change arrays. Empty arrays are valid when
@@ -194,6 +214,27 @@ workbook.getSheetValues(sheet)
 workbook.getSheetSerialized(sheet)
 ```
 
+Inspect a formula error:
+
+```ts
+const value = workbook.getCellValue(at(7, 1))
+const display = workbook.getCellDisplayValue(at(7, 1))
+const diagnostics = workbook.getCellFormulaDiagnostics(at(7, 1))
+
+console.log(value) // Raw CellValue protocol object
+console.log(display) // "#VALUE!"
+console.log(diagnostics[0]?.code) // e.g. "financial-unsupported-date-coercion"
+```
+
+Finance date inputs:
+
+`XIRR(values, dates, [guess])` and `XNPV(rate, values, dates)` accept numeric
+Excel serial dates in `dates`. Text labels and text date strings are not
+coerced in headless formulas; they evaluate to `#VALUE!`. Use
+`getCellFormulaDiagnostics()` to distinguish invalid date ranges, mismatched
+range dimensions, invalid cash-flow values, missing positive or negative cash
+flows, invalid rates/guesses, and solver non-convergence.
+
 Batch related edits:
 
 ```ts
@@ -203,6 +244,39 @@ const changes = workbook.batch(() => {
 })
 ```
 
+Create and read named expressions:
+
+```ts
+import { WorkPaper, type WorkPaperCellAddress } from '@bilig/headless'
+
+const workbook = WorkPaper.buildFromSheets({
+  Plan: [
+    ['Metric', 'Value'],
+    ['Base revenue', 100],
+    ['Target revenue', null],
+  ],
+})
+
+const sheet = workbook.getSheetId('Plan')
+if (sheet === undefined) {
+  throw new Error('Plan sheet was not created')
+}
+
+const at = (row: number, col: number): WorkPaperCellAddress => ({
+  sheet,
+  row,
+  col,
+})
+
+workbook.addNamedExpression('GrowthRate', 0.15)
+workbook.setCellContents(at(2, 1), '=B2*(1+GrowthRate)')
+
+console.log(workbook.getNamedExpressionValue('GrowthRate')) // CellValue for 0.15
+console.log(workbook.getNamedExpressionFormula('GrowthRate')) // undefined for a scalar name
+console.log(workbook.getCellValue(at(2, 1))) // CellValue for 115
+console.log(workbook.getNamedExpressionValue('MissingName')) // undefined
+```
+
 Move cells inside configured bounds:
 
 ```ts
@@ -236,6 +310,39 @@ const saved = serializeWorkPaperDocument(exportWorkPaperDocument(workbook, { inc
 const restored = createWorkPaperFromDocument(parseWorkPaperDocument(saved))
 ```
 
+Validate a persisted document before restore:
+
+```ts
+import {
+  WorkPaper,
+  createWorkPaperFromDocument,
+  exportWorkPaperDocument,
+  isPersistedWorkPaperDocument,
+  parseWorkPaperDocument,
+  serializeWorkPaperDocument,
+} from '@bilig/headless'
+
+const workbook = WorkPaper.buildFromSheets({
+  Sheet1: [[10, '=A1*2']],
+})
+
+const document = exportWorkPaperDocument(workbook, { includeConfig: true })
+const serialized = serializeWorkPaperDocument(document)
+
+const parsed = parseWorkPaperDocument(serialized)
+if (!isPersistedWorkPaperDocument(parsed)) {
+  throw new Error('Persisted WorkPaper document failed validation')
+}
+
+const restored = createWorkPaperFromDocument(parsed)
+```
+
+`parseWorkPaperDocument()` validates JSON and throws on invalid payloads.
+`isPersistedWorkPaperDocument()` is useful when a service already has an
+unknown parsed object. Custom function implementations, callback hooks, and
+other process state are not persisted; register those in application code before
+restoring the workbook.
+
 ## Persistence Contract
 
 `@bilig/headless` persists:

package/dist/work-paper-formula-diagnostics.d.ts

@@ -0,0 +1,18 @@
+import { type CellValue } from '@bilig/protocol';
+import type { WorkPaperCellAddress, WorkPaperCellRange, WorkPaperFormulaDiagnostic } from './work-paper-types.js';
+interface WorkPaperFormulaDiagnosticHooks {
+    readonly getCellValue: (address: WorkPaperCellAddress) => CellValue;
+    readonly getCellValueFormat: (address: WorkPaperCellAddress) => string | undefined;
+    readonly getCellFormula: (address: WorkPaperCellAddress) => string | undefined;
+    readonly getRangeValues: (range: WorkPaperCellRange) => CellValue[][];
+    readonly getSheetId: (sheetName: string) => number | undefined;
+    readonly getSheetName: (sheetId: number) => string | undefined;
+    readonly simpleCellAddressToString: (address: WorkPaperCellAddress, options?: {
+        includeSheetName?: boolean;
+    }) => string;
+    readonly simpleCellRangeToString: (range: WorkPaperCellRange, options?: {
+        includeSheetName?: boolean;
+    }) => string;
+}
+export declare function collectWorkPaperFormulaDiagnostics(address: WorkPaperCellAddress, hooks: WorkPaperFormulaDiagnosticHooks): WorkPaperFormulaDiagnostic[];
+export {};

package/dist/work-paper-formula-diagnostics.js

@@ -0,0 +1,301 @@
+import { ValueTag, formatCellDisplayValue, formatErrorCode } from '@bilig/protocol';
+import { excelSerialToDateParts, parseCellAddress, parseFormula, parseRangeAddress } from '@bilig/formula';
+function readFinanceFunctionName(callee) {
+    const normalized = callee.toUpperCase();
+    if (normalized === 'XIRR' || normalized === 'XNPV') {
+        return normalized;
+    }
+    return undefined;
+}
+function isFinanceCall(node) {
+    return node.kind === 'CallExpr' && readFinanceFunctionName(node.callee) !== undefined;
+}
+function buildDiagnostic(base, diagnostic) {
+    return {
+        severity: 'error',
+        address: base.address,
+        sheetName: base.sheetName,
+        a1: base.a1,
+        ...(base.formula !== undefined ? { formula: base.formula } : {}),
+        ...(base.functionName !== undefined ? { functionName: base.functionName } : {}),
+        ...(base.errorCode !== undefined ? { errorCode: base.errorCode } : {}),
+        ...(base.errorText !== undefined ? { errorText: base.errorText } : {}),
+        ...diagnostic,
+    };
+}
+function displayValue(value, format) {
+    const rendered = formatCellDisplayValue(value, format);
+    return rendered === '' ? '<blank>' : rendered;
+}
+function describeCellValue(value, format) {
+    switch (value.tag) {
+        case ValueTag.Empty:
+            return 'blank';
+        case ValueTag.Boolean:
+            return `boolean ${value.value ? 'TRUE' : 'FALSE'}`;
+        case ValueTag.String:
+            return `text "${value.value}"`;
+        case ValueTag.Error:
+            return `error ${formatErrorCode(value.code)}`;
+        case ValueTag.Number:
+            return `number ${displayValue(value, format)}`;
+    }
+}
+function resolveRangeNode(node, ownerSheetName, hooks) {
+    if (node.refKind !== 'cells') {
+        return undefined;
+    }
+    const parsed = parseRangeAddress(`${node.start}:${node.end}`, node.sheetName ?? ownerSheetName);
+    if (parsed.kind !== 'cells') {
+        return undefined;
+    }
+    const sheetName = parsed.sheetName ?? ownerSheetName;
+    const sheet = hooks.getSheetId(sheetName);
+    if (sheet === undefined) {
+        return undefined;
+    }
+    const range = {
+        start: { sheet, row: parsed.start.row, col: parsed.start.col },
+        end: { sheet, row: parsed.end.row, col: parsed.end.col },
+    };
+    const matrix = hooks.getRangeValues(range);
+    const values = [];
+    const addresses = [];
+    for (let rowOffset = 0; rowOffset < matrix.length; rowOffset += 1) {
+        const row = matrix[rowOffset] ?? [];
+        for (let colOffset = 0; colOffset < (row.length || range.end.col - range.start.col + 1); colOffset += 1) {
+            values.push(row[colOffset] ?? { tag: ValueTag.Empty });
+            addresses.push({ sheet, row: range.start.row + rowOffset, col: range.start.col + colOffset });
+        }
+    }
+    return {
+        rows: range.end.row - range.start.row + 1,
+        cols: range.end.col - range.start.col + 1,
+        values,
+        addresses,
+        reference: hooks.simpleCellRangeToString(range, { includeSheetName: true }),
+    };
+}
+function resolveCellNode(node, ownerSheetName, hooks) {
+    const parsed = parseCellAddress(node.ref, node.sheetName ?? ownerSheetName);
+    const sheetName = parsed.sheetName ?? ownerSheetName;
+    const sheet = hooks.getSheetId(sheetName);
+    if (sheet === undefined) {
+        return undefined;
+    }
+    const address = { sheet, row: parsed.row, col: parsed.col };
+    return {
+        rows: 1,
+        cols: 1,
+        values: [hooks.getCellValue(address)],
+        addresses: [address],
+        reference: hooks.simpleCellAddressToString(address, { includeSheetName: true }),
+    };
+}
+function resolveCellArgument(node, ownerSheetName, hooks) {
+    if (node?.kind === 'RangeRef') {
+        return resolveRangeNode(node, ownerSheetName, hooks);
+    }
+    if (node?.kind === 'CellRef') {
+        return resolveCellNode(node, ownerSheetName, hooks);
+    }
+    return undefined;
+}
+function resolveScalarNumber(node, ownerSheetName, hooks) {
+    if (node === undefined) {
+        return undefined;
+    }
+    if (node.kind === 'NumberLiteral') {
+        return Number.isFinite(node.value) ? node.value : undefined;
+    }
+    if (node.kind !== 'CellRef') {
+        return undefined;
+    }
+    const resolved = resolveCellNode(node, ownerSheetName, hooks);
+    const value = resolved?.values[0];
+    return value?.tag === ValueTag.Number && Number.isFinite(value.value) ? value.value : undefined;
+}
+function firstInvalidNumber(cells) {
+    for (let index = 0; index < cells.values.length; index += 1) {
+        const value = cells.values[index];
+        if (value.tag !== ValueTag.Number || !Number.isFinite(value.value)) {
+            return { value, address: cells.addresses[index] };
+        }
+    }
+    return undefined;
+}
+function firstInvalidDateSerial(cells) {
+    for (let index = 0; index < cells.values.length; index += 1) {
+        const value = cells.values[index];
+        if (value.tag !== ValueTag.Number) {
+            return { value, address: cells.addresses[index], unsupportedCoercion: value.tag === ValueTag.String };
+        }
+        if (!Number.isFinite(value.value) || excelSerialToDateParts(value.value) === undefined) {
+            return { value, address: cells.addresses[index], unsupportedCoercion: false };
+        }
+    }
+    return undefined;
+}
+function numericValues(cells) {
+    return cells.values.map((value) => (value.tag === ValueTag.Number ? value.value : Number.NaN));
+}
+function dateSerialValues(cells) {
+    return cells.values.map((value) => (value.tag === ValueTag.Number ? Math.trunc(value.value) : Number.NaN));
+}
+function diagnoseFinanceCall(call, base, ownerSheetName, hooks) {
+    const functionName = readFinanceFunctionName(call.callee);
+    if (functionName === undefined) {
+        return [
+            buildDiagnostic(base, {
+                code: 'formula-error',
+                message: `Formula evaluated to ${base.errorText ?? 'an error'}.`,
+            }),
+        ];
+    }
+    const valuesArg = functionName === 'XNPV' ? call.args[1] : call.args[0];
+    const datesArg = functionName === 'XNPV' ? call.args[2] : call.args[1];
+    const values = resolveCellArgument(valuesArg, ownerSheetName, hooks);
+    const dates = resolveCellArgument(datesArg, ownerSheetName, hooks);
+    const financeBase = { ...base, functionName };
+    if (!values || !dates) {
+        return [
+            buildDiagnostic(financeBase, {
+                code: 'financial-invalid-argument',
+                message: `${functionName} diagnostics require direct cell or cell-range cash-flow and date arguments.`,
+            }),
+        ];
+    }
+    if (values.rows !== dates.rows || values.cols !== dates.cols) {
+        return [
+            buildDiagnostic(financeBase, {
+                code: 'financial-mismatched-dimensions',
+                message: `${functionName} values range ${values.reference} is ${values.rows}x${values.cols}, but dates range ${dates.reference} is ${dates.rows}x${dates.cols}.`,
+                references: [values.reference, dates.reference],
+            }),
+        ];
+    }
+    const invalidCashFlow = firstInvalidNumber(values);
+    if (invalidCashFlow) {
+        const cell = hooks.simpleCellAddressToString(invalidCashFlow.address, { includeSheetName: true });
+        return [
+            buildDiagnostic(financeBase, {
+                code: 'financial-invalid-cash-flow',
+                message: `${functionName} cash-flow range ${values.reference} contains ${describeCellValue(invalidCashFlow.value, hooks.getCellValueFormat(invalidCashFlow.address))} at ${cell}; every cash-flow cell must be numeric.`,
+                references: [values.reference, cell],
+            }),
+        ];
+    }
+    const invalidDate = firstInvalidDateSerial(dates);
+    if (invalidDate) {
+        const cell = hooks.simpleCellAddressToString(invalidDate.address, { includeSheetName: true });
+        const code = invalidDate.unsupportedCoercion ? 'financial-unsupported-date-coercion' : 'financial-invalid-date-range';
+        const text = invalidDate.unsupportedCoercion
+            ? `${functionName} date range ${dates.reference} contains ${describeCellValue(invalidDate.value, hooks.getCellValueFormat(invalidDate.address))} at ${cell}. Use numeric Excel serial dates; text date coercion is not supported for headless ${functionName}.`
+            : `${functionName} date range ${dates.reference} contains ${describeCellValue(invalidDate.value, hooks.getCellValueFormat(invalidDate.address))} at ${cell}; dates must be valid numeric Excel serial dates.`;
+        return [
+            buildDiagnostic(financeBase, {
+                code,
+                message: text,
+                references: [dates.reference, cell],
+            }),
+        ];
+    }
+    const cashFlows = numericValues(values);
+    if (!cashFlows.some((value) => value > 0)) {
+        return [
+            buildDiagnostic(financeBase, {
+                code: 'financial-missing-positive-cash-flow',
+                message: `${functionName} cash-flow range ${values.reference} must contain at least one positive value.`,
+                references: [values.reference],
+            }),
+        ];
+    }
+    if (!cashFlows.some((value) => value < 0)) {
+        return [
+            buildDiagnostic(financeBase, {
+                code: 'financial-missing-negative-cash-flow',
+                message: `${functionName} cash-flow range ${values.reference} must contain at least one negative value.`,
+                references: [values.reference],
+            }),
+        ];
+    }
+    const dateSerials = dateSerialValues(dates);
+    const firstDate = dateSerials[0];
+    if (firstDate !== undefined && dateSerials.some((date) => date < firstDate)) {
+        return [
+            buildDiagnostic(financeBase, {
+                code: 'financial-invalid-date-range',
+                message: `${functionName} date range ${dates.reference} contains a date before the first date; XIRR/XNPV require later cash-flow dates to be on or after the first date.`,
+                references: [dates.reference],
+            }),
+        ];
+    }
+    if (functionName === 'XNPV') {
+        const rate = resolveScalarNumber(call.args[0], ownerSheetName, hooks);
+        if (rate === undefined || rate <= -0.999999999) {
+            return [
+                buildDiagnostic(financeBase, {
+                    code: 'financial-invalid-rate',
+                    message: 'XNPV discount rate must be a finite numeric value greater than -100%.',
+                }),
+            ];
+        }
+    }
+    if (functionName === 'XIRR' && call.args[2] !== undefined) {
+        const guess = resolveScalarNumber(call.args[2], ownerSheetName, hooks);
+        if (guess === undefined) {
+            return [
+                buildDiagnostic(financeBase, {
+                    code: 'financial-invalid-rate',
+                    message: 'XIRR optional guess must be a finite numeric value.',
+                }),
+            ];
+        }
+    }
+    return [
+        buildDiagnostic(financeBase, {
+            code: 'financial-nonconvergence',
+            message: `${functionName} inputs are structurally valid, but the solver did not find a valid rate for the supplied cash flows and dates.`,
+            references: [values.reference, dates.reference],
+        }),
+    ];
+}
+export function collectWorkPaperFormulaDiagnostics(address, hooks) {
+    const value = hooks.getCellValue(address);
+    const formula = hooks.getCellFormula(address);
+    if (value.tag !== ValueTag.Error || formula === undefined) {
+        return [];
+    }
+    const sheetName = hooks.getSheetName(address.sheet) ?? String(address.sheet);
+    const a1 = hooks.simpleCellAddressToString(address, { includeSheetName: false });
+    const base = {
+        address,
+        sheetName,
+        a1,
+        formula,
+        errorCode: value.code,
+        errorText: formatErrorCode(value.code),
+    };
+    let parsed;
+    try {
+        parsed = parseFormula(formula);
+    }
+    catch {
+        return [
+            buildDiagnostic(base, {
+                code: 'formula-error',
+                message: `Formula evaluated to ${formatErrorCode(value.code)}.`,
+            }),
+        ];
+    }
+    if (isFinanceCall(parsed)) {
+        return diagnoseFinanceCall(parsed, base, sheetName, hooks);
+    }
+    return [
+        buildDiagnostic(base, {
+            code: 'formula-error',
+            message: `Formula evaluated to ${formatErrorCode(value.code)}.`,
+        }),
+    ];
+}
+//# sourceMappingURL=work-paper-formula-diagnostics.js.map

package/dist/work-paper-formula-diagnostics.js.map

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

package/dist/work-paper-public-surface.d.ts

@@ -2,7 +2,7 @@ import type { SpreadsheetEngine } from '@bilig/core';
 import type { CellValue } from '@bilig/protocol';
 import type { WorkPaperEmitter } from './work-paper-emitter.js';
 import { type InternalFunctionBinding } from './work-paper-function-registry.js';
-import type { RawCellContent, SerializedWorkPaperNamedExpression, WorkPaperAddressMappingAdapter, WorkPaperArrayMappingAdapter, WorkPaperCellAddress, WorkPaperCellRange, WorkPaperColumnSearchAdapter, WorkPaperConfig, WorkPaperDateTime, WorkPaperDependencyGraphAdapter, WorkPaperEvaluatorAdapter, WorkPaperFunctionPluginDefinition, WorkPaperFunctionTranslationsPackage, WorkPaperGraphAdapter, WorkPaperLanguagePackage, WorkPaperLazilyTransformingAstServiceAdapter, WorkPaperLicenseKeyValidityState, WorkPaperRangeMappingAdapter, WorkPaperSheet, WorkPaperSheetMappingAdapter, WorkPaperEngineCounters, WorkPaperDetailedListener, WorkPaperEventName, WorkPaperInternals, WorkPaperListener } from './work-paper-types.js';
+import type { RawCellContent, SerializedWorkPaperNamedExpression, WorkPaperAddressMappingAdapter, WorkPaperArrayMappingAdapter, WorkPaperCellAddress, WorkPaperCellRange, WorkPaperFormulaDiagnostic, WorkPaperColumnSearchAdapter, WorkPaperConfig, WorkPaperDateTime, WorkPaperDependencyGraphAdapter, WorkPaperEvaluatorAdapter, WorkPaperFunctionPluginDefinition, WorkPaperFunctionTranslationsPackage, WorkPaperGraphAdapter, WorkPaperLanguagePackage, WorkPaperLazilyTransformingAstServiceAdapter, WorkPaperLicenseKeyValidityState, WorkPaperRangeMappingAdapter, WorkPaperSheet, WorkPaperSheetMappingAdapter, WorkPaperEngineCounters, WorkPaperDetailedListener, WorkPaperEventName, WorkPaperInternals, WorkPaperListener } from './work-paper-types.js';
 import { WorkPaperCapabilitySurface } from './work-paper-capability-surface.js';
 export declare abstract class WorkPaperPublicSurface extends WorkPaperCapabilitySurface {
     static version: string;
@@ -62,6 +62,8 @@ export declare abstract class WorkPaperPublicSurface extends WorkPaperCapability
     resetPerformanceCounters(): void;
     normalizeFormula(formula: string): string;
     calculateFormula(formula: string, scope?: number): CellValue | CellValue[][];
+    getCellDisplayValue(address: WorkPaperCellAddress): string;
+    getCellFormulaDiagnostics(address: WorkPaperCellAddress): WorkPaperFormulaDiagnostic[];
     getNamedExpressionsFromFormula(formula: string): string[];
     validateFormula(formula: string): boolean;
     getRegisteredFunctionNames(languageCode?: string): string[];

package/dist/work-paper-public-surface.js

@@ -1,6 +1,8 @@
+import { formatCellDisplayValue } from '@bilig/protocol';
 import { checkWorkPaperLicenseKeyValidity, cloneConfig, DEFAULT_CONFIG } from './work-paper-config.js';
 import { numberToWorkPaperDate, numberToWorkPaperDateTime, numberToWorkPaperTime } from './work-paper-date-time.js';
 import { calculateWorkPaperFormula, getWorkPaperNamedExpressionsFromFormula, normalizeWorkPaperFormula, validateWorkPaperFormula, } from './work-paper-formula-analysis.js';
+import { collectWorkPaperFormulaDiagnostics } from './work-paper-formula-diagnostics.js';
 import { getCapturedWorkPaperFunctionPlugin, getCapturedWorkPaperFunctionPlugins, listCapturedWorkPaperFunctionNames, } from './work-paper-function-registry.js';
 import { getRegisteredWorkPaperFunctionPluginById, getRegisteredWorkPaperFunctionPluginsById, readRegisteredWorkPaperLanguage, } from './work-paper-static-registry.js';
 import { DEFAULT_WORKPAPER_CONFIG, getAllWorkPaperStaticFunctionPlugins, getRegisteredWorkPaperStaticFunctionNames, getRegisteredWorkPaperStaticLanguageCodes, getWorkPaperStaticFunctionPlugin, getWorkPaperStaticLanguage, registerWorkPaperStaticFunction, registerWorkPaperStaticFunctionPlugin, registerWorkPaperStaticLanguage, unregisterAllWorkPaperStaticFunctions, unregisterWorkPaperStaticFunction, unregisterWorkPaperStaticFunctionPlugin, unregisterWorkPaperStaticLanguage, workPaperLanguages, WORKPAPER_BUILD_DATE, WORKPAPER_RELEASE_DATE, WORKPAPER_VERSION, } from './work-paper-static-api.js';
@@ -126,6 +128,21 @@ export class WorkPaperPublicSurface extends WorkPaperCapabilitySurface {
             messageOf: (error, fallback) => this.messageOf(error, fallback),
         });
     }
+    getCellDisplayValue(address) {
+        return formatCellDisplayValue(this.getCellValue(address), this.getCellValueFormat(address));
+    }
+    getCellFormulaDiagnostics(address) {
+        return collectWorkPaperFormulaDiagnostics(address, {
+            getCellValue: (target) => this.getCellValue(target),
+            getCellValueFormat: (target) => this.getCellValueFormat(target),
+            getCellFormula: (target) => this.getCellFormula(target),
+            getRangeValues: (range) => this.getRangeValues(range),
+            getSheetId: (sheetName) => this.sheetMapping.getSheetId(sheetName),
+            getSheetName: (sheetId) => this.sheetMapping.getSheetName(sheetId),
+            simpleCellAddressToString: (target, options) => this.simpleCellAddressToString(target, options),
+            simpleCellRangeToString: (range, options) => this.simpleCellRangeToString(range, options),
+        });
+    }
     getNamedExpressionsFromFormula(formula) {
         return getWorkPaperNamedExpressionsFromFormula(formula, { messageOf: (error, fallback) => this.messageOf(error, fallback) });
     }

package/dist/work-paper-public-surface.js.map

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

package/dist/work-paper-types.d.ts

@@ -1,4 +1,4 @@
-import type { CellValue, LiteralInput, RecalcMetrics } from '@bilig/protocol';
+import type { CellValue, ErrorCode, LiteralInput, RecalcMetrics } from '@bilig/protocol';
 import type { EvaluationResult } from '@bilig/formula';
 import type { EngineCounters } from '@bilig/core';
 export type RawCellContent = LiteralInput | string;
@@ -202,6 +202,21 @@ export type WorkPaperDetailedListener<EventName extends WorkPaperEventName> = (p
 export type WorkPaperCellType = 'EMPTY' | 'VALUE' | 'FORMULA' | 'ARRAY';
 export type WorkPaperCellValueType = 'EMPTY' | 'NUMBER' | 'STRING' | 'BOOLEAN' | 'ERROR';
 export type WorkPaperCellValueDetailedType = WorkPaperCellValueType | 'DATE' | 'TIME' | 'DATETIME';
+export type WorkPaperFormulaDiagnosticSeverity = 'error' | 'warning' | 'info';
+export type WorkPaperFormulaDiagnosticCode = 'formula-error' | 'financial-invalid-argument' | 'financial-invalid-cash-flow' | 'financial-unsupported-date-coercion' | 'financial-invalid-date-range' | 'financial-mismatched-dimensions' | 'financial-missing-positive-cash-flow' | 'financial-missing-negative-cash-flow' | 'financial-invalid-rate' | 'financial-nonconvergence';
+export interface WorkPaperFormulaDiagnostic {
+    severity: WorkPaperFormulaDiagnosticSeverity;
+    code: WorkPaperFormulaDiagnosticCode;
+    message: string;
+    address: WorkPaperCellAddress;
+    sheetName: string;
+    a1: string;
+    formula?: string;
+    functionName?: string;
+    errorCode?: ErrorCode;
+    errorText?: string;
+    references?: string[];
+}
 export type WorkPaperDependencyRef = {
     kind: 'cell';
     address: WorkPaperCellAddress;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilig/headless",
-  "version": "0.9.0",
+  "version": "0.9.2",
   "description": "Headless spreadsheet engine and WorkPaper workbook facade for Node services, coding agents, and HyperFormula-style workflows.",
   "keywords": [
     "agent",
@@ -49,9 +49,9 @@
     "build": "rm -rf dist tsconfig.tsbuildinfo && tsc -p tsconfig.json"
   },
   "dependencies": {
-    "@bilig/core": "0.9.0",
-    "@bilig/formula": "0.9.0",
-    "@bilig/protocol": "0.9.0"
+    "@bilig/core": "0.9.2",
+    "@bilig/formula": "0.9.2",
+    "@bilig/protocol": "0.9.2"
   },
   "engines": {
     "node": ">=24.0.0"