@bilig/workbook 0.42.0

package/dist/find.js

@@ -0,0 +1,353 @@
+import { formatAddress, parseCellAddress } from '@bilig/formula';
+import { isLiteralInput } from '@bilig/protocol';
+const WORKBOOK_ROW_OPERATORS = ['eq', 'neq', 'contains', 'startsWith', 'gt', 'gte', 'lt', 'lte'];
+const WORKBOOK_ROW_OPERATOR_SET = new Set(WORKBOOK_ROW_OPERATORS);
+function hasOwnString(value, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor !== undefined && typeof descriptor.value === 'string';
+}
+function hasOwnFunction(value, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor !== undefined && typeof descriptor.value === 'function';
+}
+const WORKBOOK_REF_KINDS = new Set(['range', 'name', 'table', 'column', 'rows']);
+function hasValidBaseRef(value) {
+    return hasOwnString(value, 'kind') && WORKBOOK_REF_KINDS.has(value.kind) && hasOwnString(value, 'id') && hasOwnString(value, 'label');
+}
+function hasOptionalString(value, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor === undefined || typeof descriptor.value === 'string';
+}
+function hasOptionalStringArray(value, key) {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    return descriptor === undefined || (Array.isArray(descriptor.value) && descriptor.value.every((entry) => typeof entry === 'string'));
+}
+function isCellRangeRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        hasOwnString(value, 'sheetName') &&
+        hasOwnString(value, 'startAddress') &&
+        hasOwnString(value, 'endAddress'));
+}
+function isWorkbookTableRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        hasValidBaseRef(value) &&
+        value.kind === 'table' &&
+        hasOptionalString(value, 'name') &&
+        hasOptionalString(value, 'sheetName') &&
+        hasOptionalStringArray(value, 'headers') &&
+        hasOwnFunction(value, 'column'));
+}
+function isWorkbookRowsRef(value) {
+    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value) || value.kind !== 'rows' || !hasOwnFunction(value, 'column')) {
+        return false;
+    }
+    const where = Object.getOwnPropertyDescriptor(value, 'where')?.value;
+    if (typeof where !== 'object' ||
+        where === null ||
+        !hasOwnString(where, 'column') ||
+        !isWorkbookRowOperator(Object.getOwnPropertyDescriptor(where, 'op')?.value) ||
+        !isLiteralInput(Object.getOwnPropertyDescriptor(where, 'value')?.value)) {
+        return false;
+    }
+    const table = Object.getOwnPropertyDescriptor(value, 'table')?.value;
+    return hasOptionalString(value, 'sheetName') && (table === undefined || isWorkbookTableRef(table));
+}
+function isWorkbookColumnRef(value) {
+    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value) || value.kind !== 'column' || !hasOwnString(value, 'name')) {
+        return false;
+    }
+    const table = Object.getOwnPropertyDescriptor(value, 'table')?.value;
+    const rows = Object.getOwnPropertyDescriptor(value, 'rows')?.value;
+    return isWorkbookTableRef(table) && (rows === undefined || isWorkbookRowsRef(rows));
+}
+export function isWorkbookRef(value) {
+    if (typeof value !== 'object' || value === null || !hasValidBaseRef(value)) {
+        return false;
+    }
+    switch (value.kind) {
+        case 'range':
+            return isCellRangeRef(Object.getOwnPropertyDescriptor(value, 'range')?.value);
+        case 'name':
+            return hasOwnString(value, 'name');
+        case 'table':
+            return isWorkbookTableRef(value);
+        case 'column':
+            return isWorkbookColumnRef(value);
+        case 'rows':
+            return isWorkbookRowsRef(value);
+    }
+}
+export function collectWorkbookRefs(value) {
+    const refs = [];
+    const seenRefs = new Set();
+    const seenObjects = new WeakSet();
+    function pushRef(ref) {
+        const key = `${ref.kind}:${ref.id}`;
+        if (!seenRefs.has(key)) {
+            seenRefs.add(key);
+            refs.push(ref);
+        }
+    }
+    function visit(current) {
+        if (current === null || current === undefined || typeof current !== 'object') {
+            return;
+        }
+        if (seenObjects.has(current)) {
+            return;
+        }
+        seenObjects.add(current);
+        if (isWorkbookRef(current)) {
+            pushRef(current);
+            if (current.kind === 'column') {
+                visit(current.rows);
+                visit(current.table);
+            }
+            if (current.kind === 'rows') {
+                visit(current.table);
+            }
+            return;
+        }
+        if (Array.isArray(current)) {
+            current.forEach(visit);
+            return;
+        }
+        Object.values(current).forEach(visit);
+    }
+    visit(value);
+    return refs;
+}
+function cleanIdPart(value) {
+    const cleaned = value
+        .trim()
+        .replaceAll(/[^A-Za-z0-9_]+/g, '_')
+        .replace(/^_+|_+$/g, '');
+    return cleaned === '' ? 'ref' : cleaned;
+}
+function requiredSelectorText(value, field) {
+    if (typeof value !== 'string') {
+        throw new Error(`Workbook selector ${field} must be a string`);
+    }
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        throw new Error(`Workbook selector ${field} cannot be empty`);
+    }
+    return trimmed;
+}
+function optionalSelectorText(value, field) {
+    if (value === undefined) {
+        return undefined;
+    }
+    return requiredSelectorText(value, field);
+}
+function normalizeHeaders(headers) {
+    if (headers === undefined) {
+        return undefined;
+    }
+    if (!Array.isArray(headers)) {
+        throw new Error('Workbook table headers must be an array');
+    }
+    if (headers.length === 0) {
+        throw new Error('Workbook table headers cannot be empty');
+    }
+    return headers.map((header) => requiredSelectorText(header, 'table header'));
+}
+function normalizeCellAddress(value, field) {
+    const raw = requiredSelectorText(value, field);
+    try {
+        const parsed = parseCellAddress(raw);
+        if (parsed.sheetName !== undefined) {
+            throw new Error('qualified');
+        }
+        return {
+            row: parsed.row,
+            col: parsed.col,
+            text: formatAddress(parsed.row, parsed.col),
+        };
+    }
+    catch {
+        throw new Error(`Workbook range ${field} is invalid: ${raw}`);
+    }
+}
+function assertRangeOrder(start, end) {
+    if (end.row < start.row || end.col < start.col) {
+        throw new Error('Workbook range endAddress must not be before startAddress');
+    }
+}
+function isWorkbookRowOperator(value) {
+    return typeof value === 'string' && WORKBOOK_ROW_OPERATOR_SET.has(value);
+}
+function normalizeRowOperator(value) {
+    if (!isWorkbookRowOperator(value)) {
+        throw new Error(`Unsupported workbook row operator: ${String(value)}`);
+    }
+    return value;
+}
+function normalizeRowsValue(value) {
+    if (!isLiteralInput(value)) {
+        throw new Error('Workbook rows selector value must be a finite JSON literal');
+    }
+    return value;
+}
+function literalIdPart(value) {
+    const source = JSON.stringify(value) ?? 'null';
+    let encoded = '';
+    for (const char of source) {
+        encoded += /[A-Za-z0-9]/.test(char) ? char : `_${char.charCodeAt(0).toString(16)}`;
+    }
+    return cleanIdPart(`${typeof value}_${encoded}`);
+}
+function literalLabel(value) {
+    return JSON.stringify(value);
+}
+function hideHelper(target, key) {
+    Object.defineProperty(target, key, {
+        enumerable: false,
+    });
+}
+function rangeLabel(range) {
+    return range.startAddress === range.endAddress
+        ? `${range.sheetName}!${range.startAddress}`
+        : `${range.sheetName}!${range.startAddress}:${range.endAddress}`;
+}
+export function normalizeRangeRef(input) {
+    if ('startAddress' in input) {
+        const sheetName = requiredSelectorText(input.sheetName, 'sheet name');
+        const start = normalizeCellAddress(input.startAddress, 'startAddress');
+        const end = normalizeCellAddress(input.endAddress ?? input.startAddress, 'endAddress');
+        assertRangeOrder(start, end);
+        return {
+            sheetName,
+            startAddress: start.text,
+            endAddress: end.text,
+        };
+    }
+    if ('address' in input) {
+        const sheetName = requiredSelectorText(input.sheetName, 'sheet name');
+        const address = normalizeCellAddress(input.address, 'address');
+        return {
+            sheetName,
+            startAddress: address.text,
+            endAddress: address.text,
+        };
+    }
+    throw new Error('Workbook range selector must include address or startAddress');
+}
+export function createWorkbookTableRef(options) {
+    const tableName = optionalSelectorText(options.name, 'table name');
+    const sheetName = optionalSelectorText(options.sheetName, 'sheet name');
+    const headers = normalizeHeaders(options.headers);
+    if (tableName === undefined && sheetName === undefined && headers === undefined) {
+        throw new Error('Workbook table selector needs a name, sheet name, or headers');
+    }
+    const id = cleanIdPart(['table', sheetName, tableName, ...(headers ?? [])].filter(Boolean).join('_'));
+    const label = tableName ?? (headers ? `table with ${headers.join(', ')}` : `${sheetName} table`);
+    const table = {
+        kind: 'table',
+        id,
+        label,
+        ...(tableName !== undefined ? { name: tableName } : {}),
+        ...(sheetName !== undefined ? { sheetName } : {}),
+        ...(headers !== undefined ? { headers: Object.freeze([...headers]) } : {}),
+        column(name) {
+            return createWorkbookColumnRef({ table, name });
+        },
+    };
+    hideHelper(table, 'column');
+    return Object.freeze(table);
+}
+export function createWorkbookColumnRef(options) {
+    const name = requiredSelectorText(options.name, 'column name');
+    const ownerId = options.rows?.id ?? options.table.id;
+    const ownerLabel = options.rows?.label ?? options.table.label;
+    const column = {
+        kind: 'column',
+        id: cleanIdPart(`${ownerId}_${name}`),
+        label: `${ownerLabel}.${name}`,
+        table: options.table,
+        ...(options.rows !== undefined ? { rows: options.rows } : {}),
+        name,
+    };
+    return Object.freeze(column);
+}
+export function createWorkbookRangeRef(input) {
+    const range = normalizeRangeRef(input);
+    return Object.freeze({
+        kind: 'range',
+        id: cleanIdPart(`range_${range.sheetName}_${range.startAddress}_${range.endAddress}`),
+        label: rangeLabel(range),
+        range: Object.freeze(range),
+    });
+}
+export function createWorkbookNameRef(name) {
+    const normalizedName = requiredSelectorText(name, 'name');
+    return Object.freeze({
+        kind: 'name',
+        id: cleanIdPart(`name_${normalizedName}`),
+        label: normalizedName,
+        name: normalizedName,
+    });
+}
+export function createWorkbookRowsRef(options) {
+    const sheetName = optionalSelectorText(options.sheetName, 'sheet name');
+    if (options.table === undefined && sheetName === undefined) {
+        throw new Error('Workbook rows selector requires a table or sheet name');
+    }
+    const where = {
+        column: requiredSelectorText(options.where.column, 'row column'),
+        op: normalizeRowOperator(options.where.op),
+        value: normalizeRowsValue(options.where.value),
+    };
+    const ownerId = options.table?.id ?? sheetName;
+    const ownerLabel = options.table?.label ?? sheetName;
+    const rows = {
+        kind: 'rows',
+        id: cleanIdPart(`${ownerId}_${where.column}_${where.op}_${literalIdPart(where.value)}`),
+        label: `${ownerLabel} rows where ${where.column} ${where.op} ${literalLabel(where.value)}`,
+        ...(sheetName !== undefined ? { sheetName } : {}),
+        ...(options.table !== undefined ? { table: options.table } : {}),
+        where: Object.freeze(where),
+        column(name) {
+            if (rows.table === undefined) {
+                throw new Error('Rows column selection requires a table-backed row selector');
+            }
+            return createWorkbookColumnRef({ table: rows.table, rows, name });
+        },
+    };
+    hideHelper(rows, 'column');
+    return Object.freeze(rows);
+}
+export function findTable(options) {
+    return createWorkbookTableRef(options);
+}
+export function findColumn(options) {
+    return createWorkbookColumnRef(options);
+}
+export function findRange(input) {
+    return createWorkbookRangeRef(input);
+}
+export function findName(name) {
+    return createWorkbookNameRef(name);
+}
+export function findRows(options) {
+    return createWorkbookRowsRef(options);
+}
+export function createWorkbookFindApi() {
+    return {
+        findTable,
+        findColumn,
+        findRange,
+        findName,
+        findRows,
+    };
+}
+export const find = Object.freeze({
+    ...createWorkbookFindApi(),
+    table: findTable,
+    column: findColumn,
+    range: findRange,
+    name: findName,
+    rows: findRows,
+});
+//# sourceMappingURL=find.js.map

package/dist/find.js.map

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

package/dist/formula.d.ts

@@ -0,0 +1,25 @@
+import type { WorkbookRef } from './find.js';
+export interface WorkbookFormulaExpression {
+    readonly kind: 'formula';
+    readonly source: string;
+    readonly inputs: readonly WorkbookRef[];
+}
+export interface WorkbookRawFormulaOptions {
+    readonly inputs?: readonly WorkbookRef[];
+}
+export type WorkbookFormulaOperand = WorkbookFormulaExpression | WorkbookRef | string | number | boolean;
+declare function call(name: string, args: readonly WorkbookFormulaOperand[]): WorkbookFormulaExpression;
+export declare const formula: {
+    readonly raw: (source: string, options?: WorkbookRawFormulaOptions) => WorkbookFormulaExpression;
+    readonly source: (expression: WorkbookFormulaOperand) => string;
+    readonly inputs: (expression: WorkbookFormulaOperand) => readonly WorkbookRef[];
+    readonly ref: (ref: WorkbookRef) => WorkbookFormulaExpression;
+    readonly text: (value: string) => WorkbookFormulaExpression;
+    readonly call: typeof call;
+    readonly add: (left: WorkbookFormulaOperand, right: WorkbookFormulaOperand) => WorkbookFormulaExpression;
+    readonly subtract: (left: WorkbookFormulaOperand, right: WorkbookFormulaOperand) => WorkbookFormulaExpression;
+    readonly multiply: (left: WorkbookFormulaOperand, right: WorkbookFormulaOperand) => WorkbookFormulaExpression;
+    readonly divide: (left: WorkbookFormulaOperand, right: WorkbookFormulaOperand) => WorkbookFormulaExpression;
+    readonly sum: (...args: readonly WorkbookFormulaOperand[]) => WorkbookFormulaExpression;
+};
+export {};

package/dist/formula.js

@@ -0,0 +1,135 @@
+import { normalizeFormulaFunctionName, parseFormula } from '@bilig/formula';
+function normalizeFormulaSource(source) {
+    const trimmed = source.trim();
+    if (trimmed === '') {
+        throw new Error('Formula source cannot be empty');
+    }
+    const normalized = trimmed.startsWith('=') ? trimmed.slice(1) : trimmed;
+    parseFormula(normalized);
+    return normalized;
+}
+function uniqueRefs(refs) {
+    const seen = new Set();
+    const unique = [];
+    for (const ref of refs) {
+        const key = `${ref.kind}:${ref.id}`;
+        if (seen.has(key)) {
+            continue;
+        }
+        seen.add(key);
+        unique.push(ref);
+    }
+    return unique;
+}
+function createFormulaExpression(source, inputs = []) {
+    return {
+        kind: 'formula',
+        source: normalizeFormulaSource(source),
+        inputs: uniqueRefs(inputs),
+    };
+}
+function isFormulaExpression(value) {
+    return typeof value === 'object' && value !== null && 'kind' in value && value.kind === 'formula';
+}
+function isWorkbookRef(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'kind' in value &&
+        typeof value.kind === 'string' &&
+        value.kind !== 'formula' &&
+        'id' in value &&
+        typeof value.id === 'string');
+}
+function quoteSheetName(sheetName) {
+    return /^[A-Za-z_][A-Za-z0-9_]*$/.test(sheetName) ? sheetName : `'${sheetName.replaceAll("'", "''")}'`;
+}
+function formatRangeRef(range) {
+    const sheet = quoteSheetName(range.sheetName);
+    return range.startAddress === range.endAddress ? `${sheet}!${range.startAddress}` : `${sheet}!${range.startAddress}:${range.endAddress}`;
+}
+function placeholderRefSource(ref) {
+    return `__bilig_ref_${ref.id.replaceAll(/[^A-Za-z0-9_]+/g, '_')}`;
+}
+function refSource(ref) {
+    if (ref.kind === 'range') {
+        return formatRangeRef(ref.range);
+    }
+    if (ref.kind === 'name') {
+        return ref.name;
+    }
+    if (ref.kind === 'column' && ref.rows === undefined && ref.table.name) {
+        return `${ref.table.name}[${ref.name}]`;
+    }
+    return placeholderRefSource(ref);
+}
+function operandSource(operand) {
+    if (isFormulaExpression(operand)) {
+        return operand.source;
+    }
+    if (isWorkbookRef(operand)) {
+        return refSource(operand);
+    }
+    if (typeof operand === 'number') {
+        if (!Number.isFinite(operand)) {
+            throw new Error('Formula numbers must be finite');
+        }
+        return String(operand);
+    }
+    if (typeof operand === 'boolean') {
+        return operand ? 'TRUE()' : 'FALSE()';
+    }
+    return operand;
+}
+function operandInputs(operand) {
+    if (isFormulaExpression(operand)) {
+        return operand.inputs;
+    }
+    if (isWorkbookRef(operand)) {
+        return [operand];
+    }
+    return [];
+}
+function collectInputs(args) {
+    return uniqueRefs(args.flatMap((arg) => operandInputs(arg)));
+}
+function binary(left, operator, right) {
+    return createFormulaExpression(`(${operandSource(left)})${operator}(${operandSource(right)})`, collectInputs([left, right]));
+}
+function call(name, args) {
+    const callee = normalizeFormulaFunctionName(name);
+    return createFormulaExpression(`${callee}(${args.map(operandSource).join(',')})`, collectInputs(args));
+}
+export const formula = {
+    raw(source, options = {}) {
+        return createFormulaExpression(source, options.inputs ?? []);
+    },
+    source(expression) {
+        return normalizeFormulaSource(operandSource(expression));
+    },
+    inputs(expression) {
+        return operandInputs(expression);
+    },
+    ref(ref) {
+        return createFormulaExpression(refSource(ref), [ref]);
+    },
+    text(value) {
+        return createFormulaExpression(`"${value.replaceAll('"', '""')}"`);
+    },
+    call,
+    add(left, right) {
+        return binary(left, '+', right);
+    },
+    subtract(left, right) {
+        return binary(left, '-', right);
+    },
+    multiply(left, right) {
+        return binary(left, '*', right);
+    },
+    divide(left, right) {
+        return binary(left, '/', right);
+    },
+    sum(...args) {
+        return call('SUM', args);
+    },
+};
+//# sourceMappingURL=formula.js.map

package/dist/formula.js.map

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

package/dist/guards.d.ts

@@ -0,0 +1,5 @@
+import type { EngineOp, EngineOpBatch, WorkbookOp } from './ops.js';
+export declare function isWorkbookOp(value: unknown): value is WorkbookOp;
+export declare function isEngineOp(value: unknown): value is EngineOp;
+export declare function isEngineOps(value: unknown): value is EngineOp[];
+export declare function isEngineOpBatch(value: unknown): value is EngineOpBatch;