@bilig/workbook 0.59.0 → 0.64.0

package/dist/plan-data.js

@@ -0,0 +1,278 @@
+import { isLiteralInput } from '@bilig/protocol';
+import { describePlan, } from './describe.js';
+import { hydrateWorkbookRef, isWorkbookRefData } from './find.js';
+import { isWorkbookOp } from './guards.js';
+import { isWorkbookActionInput, normalizeWorkbookActionInput } from './input.js';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function hasString(value, key) {
+    return typeof value[key] === 'string';
+}
+function hasOptionalString(value, key) {
+    const entry = value[key];
+    return entry === undefined || typeof entry === 'string';
+}
+function isWorkbookRefDescription(value) {
+    return isWorkbookRefData(value);
+}
+function isFormulaLabelData(value) {
+    return isRecord(value) && hasString(value, 'name') && isWorkbookRefDescription(value['ref']);
+}
+function isFormulaLabelDataArray(value) {
+    return Array.isArray(value) && value.every(isFormulaLabelData);
+}
+function isRefDataArray(value) {
+    return Array.isArray(value) && value.every(isWorkbookRefDescription);
+}
+function isWorkbookActionCommandData(value) {
+    if (!isRecord(value) || !hasString(value, 'kind')) {
+        return false;
+    }
+    switch (value['kind']) {
+        case 'writeFormula':
+            return (isWorkbookRefDescription(value['target']) &&
+                typeof value['formula'] === 'string' &&
+                isRefDataArray(value['inputs']) &&
+                isFormulaLabelDataArray(value['labels']));
+        case 'writeValue':
+            return isWorkbookRefDescription(value['target']) && isLiteralInput(value['value']);
+        case 'format':
+            return (isWorkbookRefDescription(value['target']) &&
+                (value['style'] === undefined || isRecord(value['style'])) &&
+                (value['numberFormat'] === undefined || typeof value['numberFormat'] === 'string' || value['numberFormat'] === null));
+        case 'clear':
+            return isWorkbookRefDescription(value['target']);
+        case 'op':
+            return (isWorkbookOp(value['op']) &&
+                (value['target'] === undefined || isWorkbookRefDescription(value['target'])) &&
+                hasOptionalString(value, 'message'));
+        default:
+            return false;
+    }
+}
+function isChangeData(value) {
+    return (isRecord(value) &&
+        hasString(value, 'kind') &&
+        hasString(value, 'message') &&
+        (value['target'] === undefined || isWorkbookRefDescription(value['target'])));
+}
+function isCheckStatus(value) {
+    return value === 'planned' || value === 'passed' || value === 'failed';
+}
+function isCheckExpectationData(value) {
+    if (!isRecord(value) || !hasString(value, 'kind')) {
+        return false;
+    }
+    switch (value['kind']) {
+        case 'valueEquals':
+            return isLiteralInput(value['value']);
+        case 'formulaEquals':
+            return typeof value['formula'] === 'string' && isRefDataArray(value['inputs']) && isFormulaLabelDataArray(value['labels']);
+        default:
+            return false;
+    }
+}
+function isCheckData(value) {
+    return (isRecord(value) &&
+        isCheckStatus(value['status']) &&
+        hasString(value, 'kind') &&
+        hasString(value, 'message') &&
+        (value['target'] === undefined || isWorkbookRefDescription(value['target'])) &&
+        (value['refs'] === undefined || isRefDataArray(value['refs'])) &&
+        (value['expectation'] === undefined || isCheckExpectationData(value['expectation'])) &&
+        (value['proof'] === undefined || isWorkbookActionInput(value['proof'])));
+}
+export function isPlanData(value) {
+    return (isRecord(value) &&
+        hasString(value, 'modelName') &&
+        hasString(value, 'actionName') &&
+        (value['input'] === undefined || isWorkbookActionInput(value['input'])) &&
+        isRefDataArray(value['refsUsed']) &&
+        Array.isArray(value['commands']) &&
+        value['commands'].every(isWorkbookActionCommandData) &&
+        Array.isArray(value['ops']) &&
+        value['ops'].every(isWorkbookOp) &&
+        Array.isArray(value['changed']) &&
+        value['changed'].every(isChangeData) &&
+        Array.isArray(value['checks']) &&
+        value['checks'].every(isCheckData));
+}
+function planDataIssue(path, message) {
+    return Object.freeze({
+        code: 'invalid_plan_data',
+        path,
+        message,
+    });
+}
+function pushRequiredStringIssue(issues, value, key) {
+    if (typeof value[key] !== 'string') {
+        issues.push(planDataIssue(key, `Workbook plan data ${key} must be a string`));
+    }
+}
+function pushOptionalInputIssue(issues, value) {
+    if (value['input'] !== undefined && !isWorkbookActionInput(value['input'])) {
+        issues.push(planDataIssue('input', 'Workbook plan data input must be JSON-safe'));
+    }
+}
+function pushArrayIssues(issues, value, key, guard, label) {
+    const array = value[key];
+    if (!Array.isArray(array)) {
+        issues.push(planDataIssue(key, `Workbook plan data ${key} must be an array`));
+        return;
+    }
+    array.forEach((entry, index) => {
+        if (!guard(entry)) {
+            issues.push(planDataIssue(`${key}[${index}]`, `Workbook plan data ${label} at ${key}[${index}] is invalid`));
+        }
+    });
+}
+export function checkPlanData(value) {
+    if (!isRecord(value)) {
+        return {
+            status: 'invalid',
+            issues: Object.freeze([planDataIssue('plan', 'Workbook plan data must be an object')]),
+        };
+    }
+    const issues = [];
+    pushRequiredStringIssue(issues, value, 'modelName');
+    pushRequiredStringIssue(issues, value, 'actionName');
+    pushOptionalInputIssue(issues, value);
+    pushArrayIssues(issues, value, 'refsUsed', isWorkbookRefDescription, 'ref');
+    pushArrayIssues(issues, value, 'commands', isWorkbookActionCommandData, 'command');
+    pushArrayIssues(issues, value, 'ops', isWorkbookOp, 'op');
+    pushArrayIssues(issues, value, 'changed', isChangeData, 'change');
+    pushArrayIssues(issues, value, 'checks', isCheckData, 'check');
+    if (issues.length > 0) {
+        return {
+            status: 'invalid',
+            issues: Object.freeze(issues),
+        };
+    }
+    if (!isPlanData(value)) {
+        return {
+            status: 'invalid',
+            issues: Object.freeze([planDataIssue('plan', 'Workbook plan data is invalid')]),
+        };
+    }
+    return {
+        status: 'valid',
+        plan: value,
+        issues: Object.freeze([]),
+    };
+}
+function hydrateRef(ref) {
+    return hydrateWorkbookRef(ref);
+}
+function hydrateFormulaLabel(label) {
+    return Object.freeze({
+        name: label.name,
+        ref: hydrateRef(label.ref),
+    });
+}
+function hydrateCommand(command) {
+    switch (command.kind) {
+        case 'writeFormula':
+            return Object.freeze({
+                kind: 'writeFormula',
+                target: hydrateRef(command.target),
+                formula: command.formula,
+                inputs: Object.freeze(command.inputs.map(hydrateRef)),
+                labels: Object.freeze(command.labels.map(hydrateFormulaLabel)),
+            });
+        case 'writeValue':
+            return Object.freeze({
+                kind: 'writeValue',
+                target: hydrateRef(command.target),
+                value: command.value,
+            });
+        case 'format':
+            return Object.freeze({
+                kind: 'format',
+                target: hydrateRef(command.target),
+                ...(command.style !== undefined ? { style: Object.freeze(structuredClone(command.style)) } : {}),
+                ...(command.numberFormat !== undefined ? { numberFormat: command.numberFormat } : {}),
+            });
+        case 'clear':
+            return Object.freeze({
+                kind: 'clear',
+                target: hydrateRef(command.target),
+            });
+        case 'op':
+            return Object.freeze({
+                kind: 'op',
+                op: Object.freeze(structuredClone(command.op)),
+                ...(command.target !== undefined ? { target: hydrateRef(command.target) } : {}),
+                ...(command.message !== undefined ? { message: command.message } : {}),
+            });
+    }
+}
+function hydrateChange(change) {
+    return Object.freeze({
+        kind: change.kind,
+        ...(change.target !== undefined ? { target: hydrateRef(change.target) } : {}),
+        message: change.message,
+    });
+}
+function hydrateExpectation(expectation) {
+    switch (expectation.kind) {
+        case 'valueEquals':
+            return Object.freeze({
+                kind: 'valueEquals',
+                value: expectation.value,
+            });
+        case 'formulaEquals':
+            return Object.freeze({
+                kind: 'formulaEquals',
+                formula: expectation.formula,
+                inputs: Object.freeze(expectation.inputs.map(hydrateRef)),
+                labels: Object.freeze(expectation.labels.map(hydrateFormulaLabel)),
+            });
+    }
+}
+function hydrateCheck(check) {
+    const proof = check.proof === undefined ? undefined : normalizeWorkbookActionInput(check.proof);
+    return Object.freeze({
+        status: check.status,
+        kind: check.kind,
+        ...(check.target !== undefined ? { target: hydrateRef(check.target) } : {}),
+        ...(check.refs !== undefined ? { refs: Object.freeze(check.refs.map(hydrateRef)) } : {}),
+        message: check.message,
+        ...(check.expectation !== undefined ? { expectation: hydrateExpectation(check.expectation) } : {}),
+        ...(proof !== undefined ? { proof } : {}),
+    });
+}
+function cloneOp(op) {
+    return Object.freeze(structuredClone(op));
+}
+export function toPlanData(plan) {
+    return describePlan(plan);
+}
+export function hydratePlanData(data) {
+    const check = checkPlanData(data);
+    if (check.status === 'invalid') {
+        const [firstIssue] = check.issues;
+        throw new Error(firstIssue === undefined ? 'Workbook plan data is invalid' : `Workbook plan data is invalid: ${firstIssue.message}`);
+    }
+    const plan = check.plan;
+    const refsUsed = Object.freeze(plan.refsUsed.map(hydrateRef));
+    const input = plan.input === undefined ? undefined : normalizeWorkbookActionInput(plan.input);
+    return Object.freeze({
+        modelName: plan.modelName,
+        actionName: plan.actionName,
+        ...(input !== undefined ? { input } : {}),
+        refs: Object.freeze({ refsUsed }),
+        refsUsed,
+        commands: Object.freeze(plan.commands.map(hydrateCommand)),
+        ops: Object.freeze(plan.ops.map(cloneOp)),
+        changed: Object.freeze(plan.changed.map(hydrateChange)),
+        checks: Object.freeze(plan.checks.map(hydrateCheck)),
+    });
+}
+export function isHydratedPlan(value) {
+    return isRecord(value) && isRecord(value['refs']);
+}
+export function executablePlan(plan) {
+    return isHydratedPlan(plan) ? plan : hydratePlanData(plan);
+}
+//# sourceMappingURL=plan-data.js.map

package/dist/plan-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-data.js","sourceRoot":"","sources":["../src/plan-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,EACL,YAAY,GAQb,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAoB,MAAM,WAAW,CAAA;AAEnF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,qBAAqB,EAAE,4BAA4B,EAA4B,MAAM,YAAY,CAAA;AA+B1G,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAA;AACpD,CAAC;AAED,SAAS,SAAS,CAAC,KAA8B,EAAE,GAAW;IAC5D,OAAO,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAA;AACvC,CAAC;AAED,SAAS,iBAAiB,CAAC,KAA8B,EAAE,GAAW;IACpE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,OAAO,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAA;AACzD,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,wBAAwB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAA;AAC9F,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAA;AAChE,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;AACtE,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,QAAQ,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,KAAK,cAAc;YACjB,OAAO,CACL,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACzC,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,QAAQ;gBACpC,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBAC/B,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CACzC,CAAA;QACH,KAAK,YAAY;YACf,OAAO,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QACpF,KAAK,QAAQ;YACX,OAAO,CACL,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACzC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC1D,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,SAAS,IAAI,OAAO,KAAK,CAAC,cAAc,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,CACrH,CAAA;QACH,KAAK,OAAO;YACV,OAAO,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;QAClD,KAAK,IAAI;YACP,OAAO,CACL,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACzB,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC5E,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,CACpC,CAAA;QACH;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC;QAC3B,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC7E,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,CAAA;AACxE,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;QAClD,OAAO,KAAK,CAAA;IACd,CAAC;IACD,QAAQ,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC;QACtB,KAAK,aAAa;YAChB,OAAO,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAA;QACvC,KAAK,eAAe;YAClB,OAAO,OAAO,KAAK,CAAC,SAAS,CAAC,KAAK,QAAQ,IAAI,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,uBAAuB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;QAC5H;YACE,OAAO,KAAK,CAAA;IAChB,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,aAAa,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;QACxB,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC;QAC3B,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,SAAS,IAAI,wBAAwB,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC5E,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC9D,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,SAAS,IAAI,sBAAsB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC;QACpF,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CACxE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,CACL,QAAQ,CAAC,KAAK,CAAC;QACf,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC;QAC7B,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC;QAC9B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACjC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAChC,KAAK,CAAC,UAAU,CAAC,CAAC,KAAK,CAAC,2BAA2B,CAAC;QACpD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QAChC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/B,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;QACpC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC9B,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CACnC,CAAA;AACH,CAAC;AAED,SAAS,aAAa,CAAC,IAAY,EAAE,OAAe;IAClD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,mBAAmB;QACzB,IAAI;QACJ,OAAO;KACR,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,MAA+B,EAAE,KAA8B,EAAE,GAAW;IAC3G,IAAI,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,sBAAsB,GAAG,mBAAmB,CAAC,CAAC,CAAA;IAC/E,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,MAA+B,EAAE,KAA8B;IAC7F,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAC3E,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,4CAA4C,CAAC,CAAC,CAAA;IACnF,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,MAA+B,EAC/B,KAA8B,EAC9B,GAAW,EACX,KAAqC,EACrC,KAAa;IAEb,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAA;IACxB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,sBAAsB,GAAG,mBAAmB,CAAC,CAAC,CAAA;QAC7E,OAAM;IACR,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;QAC7B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,GAAG,IAAI,KAAK,GAAG,EAAE,sBAAsB,KAAK,OAAO,GAAG,IAAI,KAAK,cAAc,CAAC,CAAC,CAAA;QAC9G,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAC,CAAC;SACvF,CAAA;IACH,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,CAAA;IAC1C,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,WAAW,CAAC,CAAA;IACnD,uBAAuB,CAAC,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;IACpD,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACrC,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,wBAAwB,EAAE,KAAK,CAAC,CAAA;IAC3E,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,2BAA2B,EAAE,SAAS,CAAC,CAAA;IAClF,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,CAAC,CAAA;IACzD,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAA;IACjE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,CAAA;IAE9D,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SAC9B,CAAA;IACH,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,+BAA+B,CAAC,CAAC,CAAC;SAChF,CAAA;IACH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,KAAK;QACX,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;KAC1B,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,GAA2B;IAC7C,OAAO,kBAAkB,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAsC;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;KAC3B,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,OAAyC;IAC/D,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,cAAc;YACjB,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,cAAc;gBACpB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;gBAClC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACrD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;aAC/D,CAAC,CAAA;QACJ,KAAK,YAAY;YACf,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;gBAClC,KAAK,EAAE,OAAO,CAAC,KAAK;aACrB,CAAC,CAAA;QACJ,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;gBAClC,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChG,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtF,CAAC,CAAA;QACJ,KAAK,OAAO;YACV,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,OAAO;gBACb,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC;aACnC,CAAC,CAAA;QACJ,KAAK,IAAI;YACP,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,IAAI;gBACV,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;gBAC9C,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvE,CAAC,CAAA;IACN,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAwC;IAC7D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,WAAgD;IAC1E,QAAQ,WAAW,CAAC,IAAI,EAAE,CAAC;QACzB,KAAK,aAAa;YAChB,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,aAAa;gBACnB,KAAK,EAAE,WAAW,CAAC,KAAK;aACzB,CAAC,CAAA;QACJ,KAAK,eAAe;YAClB,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,WAAW,CAAC,OAAO;gBAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBACzD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;aACnE,CAAC,CAAA;IACN,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAqC;IACzD,MAAM,KAAK,GAAoC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IAChI,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,GAAG,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3E,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC1C,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,EAAc;IAC7B,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAA;AAC3C,CAAC;AAED,MAAM,UAAU,UAAU,CAAO,IAA8B;IAC7D,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAA;IACjC,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC/B,MAAM,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,MAAM,CAAA;QACjC,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,kCAAkC,UAAU,CAAC,OAAO,EAAE,CAAC,CAAA;IACtI,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;IACvB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;IAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IAC7F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC;QACjC,QAAQ;QACR,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC1D,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACzC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACvD,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;KACrD,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAO,KAAmC;IACtE,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;AACnD,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,IAAkC;IAElC,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAA;AAC5D,CAAC"}

package/dist/requirements.d.ts

@@ -1,7 +1,9 @@
 import { type WorkbookRefDescription } from './describe.js';
-import type { WorkbookActionPlan } from './model.js';
+import { type WorkbookExecutablePlan } from './plan-data.js';
 export type WorkbookRuntimeRequirementKind = 'apply' | 'read' | 'verify';
 export type WorkbookRuntimeCapability = 'writeFormula' | 'writeValue' | 'format' | 'clear' | 'applyOp' | 'read' | 'verifyCheck';
+export declare const workbookRuntimeRequirementKinds: readonly ["apply", "read", "verify"];
+export declare const workbookRuntimeCapabilities: readonly ["writeFormula", "writeValue", "format", "clear", "applyOp", "read", "verifyCheck"];
 export interface WorkbookRuntimeRequirement {
     readonly kind: WorkbookRuntimeRequirementKind;
     readonly capability: WorkbookRuntimeCapability;
@@ -19,4 +21,49 @@ export interface WorkbookRuntimeRequirements {
     readonly actionName: string;
     readonly requirements: readonly WorkbookRuntimeRequirement[];
 }
-export declare function describeRuntimeRequirements<Refs>(plan: WorkbookActionPlan<Refs>): WorkbookRuntimeRequirements;
+export type WorkbookRuntimeRequirementsIssueCode = 'invalid_runtime_requirements';
+export interface WorkbookRuntimeRequirementsIssue {
+    readonly code: WorkbookRuntimeRequirementsIssueCode;
+    readonly path: string;
+    readonly message: string;
+}
+export type WorkbookRuntimeRequirementsCheckResult = {
+    readonly status: 'valid';
+    readonly requirements: WorkbookRuntimeRequirements;
+    readonly issues: readonly [];
+} | {
+    readonly status: 'invalid';
+    readonly issues: readonly WorkbookRuntimeRequirementsIssue[];
+};
+export type WorkbookRuntimeAdapterIssueCode = 'missing_apply' | 'missing_read' | 'missing_check_verifier';
+export type WorkbookRuntimeAdapterMethod = 'apply' | 'read' | 'verifyChecks';
+export interface WorkbookRuntimeAdapterIssue {
+    readonly code: WorkbookRuntimeAdapterIssueCode;
+    readonly capability: WorkbookRuntimeCapability;
+    readonly method: WorkbookRuntimeAdapterMethod;
+    readonly requirementIndexes: readonly number[];
+    readonly message: string;
+}
+export type WorkbookRuntimeAdapterCheckResult = {
+    readonly status: 'valid';
+    readonly modelName: string;
+    readonly actionName: string;
+    readonly requiredCapabilities: readonly WorkbookRuntimeCapability[];
+    readonly issues: readonly [];
+} | {
+    readonly status: 'invalid';
+    readonly modelName: string;
+    readonly actionName: string;
+    readonly requiredCapabilities: readonly WorkbookRuntimeCapability[];
+    readonly issues: readonly WorkbookRuntimeAdapterIssue[];
+};
+export interface WorkbookRuntimeAdapterCandidate {
+    readonly apply?: unknown;
+    readonly read?: unknown;
+    readonly verifyChecks?: unknown;
+}
+export declare function isWorkbookRuntimeRequirementKind(value: unknown): value is WorkbookRuntimeRequirementKind;
+export declare function isWorkbookRuntimeCapability(value: unknown): value is WorkbookRuntimeCapability;
+export declare function describeRuntimeRequirements<Refs>(plan: WorkbookExecutablePlan<Refs>): WorkbookRuntimeRequirements;
+export declare function checkRuntimeRequirements(value: unknown): WorkbookRuntimeRequirementsCheckResult;
+export declare function checkRuntimeAdapter<Refs>(planOrRequirements: WorkbookExecutablePlan<Refs> | WorkbookRuntimeRequirements, adapter: WorkbookRuntimeAdapterCandidate): WorkbookRuntimeAdapterCheckResult;

package/dist/requirements.js

@@ -1,4 +1,28 @@
 import { describeRef } from './describe.js';
+import { isWorkbookRefData } from './find.js';
+import { hydratePlanData, isHydratedPlan } from './plan-data.js';
+export const workbookRuntimeRequirementKinds = Object.freeze([
+    'apply',
+    'read',
+    'verify',
+]);
+const WORKBOOK_RUNTIME_REQUIREMENT_KIND_SET = new Set(workbookRuntimeRequirementKinds);
+export const workbookRuntimeCapabilities = Object.freeze([
+    'writeFormula',
+    'writeValue',
+    'format',
+    'clear',
+    'applyOp',
+    'read',
+    'verifyCheck',
+]);
+const WORKBOOK_RUNTIME_CAPABILITY_SET = new Set(workbookRuntimeCapabilities);
+export function isWorkbookRuntimeRequirementKind(value) {
+    return typeof value === 'string' && WORKBOOK_RUNTIME_REQUIREMENT_KIND_SET.has(value);
+}
+export function isWorkbookRuntimeCapability(value) {
+    return typeof value === 'string' && WORKBOOK_RUNTIME_CAPABILITY_SET.has(value);
+}
 function describedRef(ref) {
     return ref === undefined ? {} : { target: describeRef(ref) };
 }
@@ -158,7 +182,7 @@ function commandCoveredOpKeys(commands) {
     });
     return keys;
 }
-export function describeRuntimeRequirements(plan) {
+function describeLiveRuntimeRequirements(plan) {
     const requirements = plan.commands.map(commandRequirement);
     const commandCoveredOps = commandCoveredOpKeys(plan.commands);
     plan.ops.forEach((op, opIndex) => {
@@ -191,4 +215,245 @@ export function describeRuntimeRequirements(plan) {
         requirements,
     };
 }
+export function describeRuntimeRequirements(plan) {
+    if (isHydratedPlan(plan)) {
+        return describeLiveRuntimeRequirements(plan);
+    }
+    return describeLiveRuntimeRequirements(hydratePlanData(plan));
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function hasString(value, key) {
+    return typeof value[key] === 'string';
+}
+function hasOptionalString(value, key) {
+    const entry = value[key];
+    return entry === undefined || typeof entry === 'string';
+}
+function hasOptionalIndex(value, key) {
+    const entry = value[key];
+    return entry === undefined || (Number.isInteger(entry) && typeof entry === 'number' && entry >= 0);
+}
+function isWorkbookRefDescription(value) {
+    return isWorkbookRefData(value);
+}
+function isRefDescriptionArray(value) {
+    return Array.isArray(value) && value.every(isWorkbookRefDescription);
+}
+function capabilityMatchesKind(kind, capability) {
+    switch (kind) {
+        case 'apply':
+            return (capability === 'writeFormula' ||
+                capability === 'writeValue' ||
+                capability === 'format' ||
+                capability === 'clear' ||
+                capability === 'applyOp');
+        case 'read':
+            return capability === 'read';
+        case 'verify':
+            return capability === 'verifyCheck';
+    }
+}
+function isRuntimeRequirement(value) {
+    if (!isRecord(value) || !isWorkbookRuntimeRequirementKind(value['kind']) || !isWorkbookRuntimeCapability(value['capability'])) {
+        return false;
+    }
+    return (capabilityMatchesKind(value['kind'], value['capability']) &&
+        hasString(value, 'message') &&
+        hasOptionalIndex(value, 'commandIndex') &&
+        hasOptionalIndex(value, 'checkIndex') &&
+        hasOptionalIndex(value, 'opIndex') &&
+        hasOptionalString(value, 'opKind') &&
+        hasOptionalString(value, 'checkKind') &&
+        (value['target'] === undefined || isWorkbookRefDescription(value['target'])) &&
+        (value['refs'] === undefined || isRefDescriptionArray(value['refs'])));
+}
+function isRuntimeRequirements(value) {
+    return (isRecord(value) &&
+        hasString(value, 'modelName') &&
+        hasString(value, 'actionName') &&
+        Array.isArray(value['requirements']) &&
+        value['requirements'].every(isRuntimeRequirement));
+}
+function isRuntimeRequirementsCandidate(value) {
+    return isRecord(value) && Object.getOwnPropertyDescriptor(value, 'requirements') !== undefined;
+}
+function runtimeRequirementsIssue(path, message) {
+    return Object.freeze({
+        code: 'invalid_runtime_requirements',
+        path,
+        message,
+    });
+}
+function pushRequiredStringIssue(issues, value, key) {
+    if (typeof value[key] !== 'string') {
+        issues.push(runtimeRequirementsIssue(key, `Workbook runtime requirements ${key} must be a string`));
+    }
+}
+function pushOptionalIndexIssue(issues, value, key, path) {
+    if (!hasOptionalIndex(value, key)) {
+        issues.push(runtimeRequirementsIssue(`${path}.${key}`, `Workbook runtime requirement ${key} must be a non-negative integer`));
+    }
+}
+function pushOptionalStringIssue(issues, value, key, path) {
+    if (!hasOptionalString(value, key)) {
+        issues.push(runtimeRequirementsIssue(`${path}.${key}`, `Workbook runtime requirement ${key} must be a string`));
+    }
+}
+function pushRequirementIssues(issues, value, index) {
+    const path = `requirements[${index}]`;
+    if (!isRecord(value)) {
+        issues.push(runtimeRequirementsIssue(path, `Workbook runtime requirement at ${path} must be an object`));
+        return;
+    }
+    const kind = value['kind'];
+    const capability = value['capability'];
+    if (!isWorkbookRuntimeRequirementKind(kind)) {
+        issues.push(runtimeRequirementsIssue(`${path}.kind`, 'Workbook runtime requirement kind is invalid'));
+    }
+    if (!isWorkbookRuntimeCapability(capability)) {
+        issues.push(runtimeRequirementsIssue(`${path}.capability`, 'Workbook runtime requirement capability is invalid'));
+    }
+    if (isWorkbookRuntimeRequirementKind(kind) && isWorkbookRuntimeCapability(capability) && !capabilityMatchesKind(kind, capability)) {
+        issues.push(runtimeRequirementsIssue(`${path}.capability`, `Workbook runtime requirement capability ${capability} does not match kind ${kind}`));
+    }
+    if (!hasString(value, 'message')) {
+        issues.push(runtimeRequirementsIssue(`${path}.message`, 'Workbook runtime requirement message must be a string'));
+    }
+    pushOptionalIndexIssue(issues, value, 'commandIndex', path);
+    pushOptionalIndexIssue(issues, value, 'checkIndex', path);
+    pushOptionalIndexIssue(issues, value, 'opIndex', path);
+    pushOptionalStringIssue(issues, value, 'opKind', path);
+    pushOptionalStringIssue(issues, value, 'checkKind', path);
+    if (value['target'] !== undefined && !isWorkbookRefDescription(value['target'])) {
+        issues.push(runtimeRequirementsIssue(`${path}.target`, 'Workbook runtime requirement target must be workbook ref data'));
+    }
+    const refs = value['refs'];
+    if (refs !== undefined) {
+        if (!Array.isArray(refs)) {
+            issues.push(runtimeRequirementsIssue(`${path}.refs`, 'Workbook runtime requirement refs must be an array'));
+            return;
+        }
+        refs.forEach((ref, refIndex) => {
+            if (!isWorkbookRefDescription(ref)) {
+                issues.push(runtimeRequirementsIssue(`${path}.refs[${refIndex}]`, 'Workbook runtime requirement ref must be workbook ref data'));
+            }
+        });
+    }
+}
+export function checkRuntimeRequirements(value) {
+    if (!isRecord(value)) {
+        return {
+            status: 'invalid',
+            issues: Object.freeze([runtimeRequirementsIssue('requirements', 'Workbook runtime requirements must be an object')]),
+        };
+    }
+    const issues = [];
+    pushRequiredStringIssue(issues, value, 'modelName');
+    pushRequiredStringIssue(issues, value, 'actionName');
+    const requirements = value['requirements'];
+    if (!Array.isArray(requirements)) {
+        issues.push(runtimeRequirementsIssue('requirements', 'Workbook runtime requirements requirements must be an array'));
+    }
+    else {
+        requirements.forEach((requirement, index) => pushRequirementIssues(issues, requirement, index));
+    }
+    if (issues.length > 0) {
+        return {
+            status: 'invalid',
+            issues: Object.freeze(issues),
+        };
+    }
+    if (!isRuntimeRequirements(value)) {
+        return {
+            status: 'invalid',
+            issues: Object.freeze([runtimeRequirementsIssue('requirements', 'Workbook runtime requirements are invalid')]),
+        };
+    }
+    return {
+        status: 'valid',
+        requirements: value,
+        issues: Object.freeze([]),
+    };
+}
+function requirementsFor(input) {
+    if (isRuntimeRequirementsCandidate(input)) {
+        const check = checkRuntimeRequirements(input);
+        if (check.status === 'invalid') {
+            const [firstIssue] = check.issues;
+            throw new Error(firstIssue === undefined
+                ? 'Workbook runtime requirements are invalid'
+                : `Workbook runtime requirements are invalid: ${firstIssue.message}`);
+        }
+        return check.requirements;
+    }
+    return describeRuntimeRequirements(input);
+}
+function pushCapability(capabilities, capability) {
+    if (!capabilities.includes(capability)) {
+        capabilities.push(capability);
+    }
+}
+function requirementIndexesFor(requirements, capability) {
+    return requirements.flatMap((requirement, index) => (requirement.capability === capability ? [index] : []));
+}
+function hasMethod(adapter, method) {
+    return typeof adapter[method] === 'function';
+}
+function adapterIssue(requirements, code, capability, method) {
+    return Object.freeze({
+        code,
+        capability,
+        method,
+        requirementIndexes: Object.freeze(requirementIndexesFor(requirements, capability)),
+        message: `Adapter is missing ${method} for ${capability}`,
+    });
+}
+export function checkRuntimeAdapter(planOrRequirements, adapter) {
+    const requirements = requirementsFor(planOrRequirements);
+    const requiredCapabilities = [];
+    requirements.requirements.forEach((requirement) => {
+        pushCapability(requiredCapabilities, requirement.capability);
+    });
+    const issues = [];
+    const needsApply = requiredCapabilities.some((capability) => capability === 'writeFormula' ||
+        capability === 'writeValue' ||
+        capability === 'format' ||
+        capability === 'clear' ||
+        capability === 'applyOp');
+    if (needsApply && !hasMethod(adapter, 'apply')) {
+        const firstApplyCapability = requiredCapabilities.find((capability) => capability === 'writeFormula' ||
+            capability === 'writeValue' ||
+            capability === 'format' ||
+            capability === 'clear' ||
+            capability === 'applyOp');
+        if (firstApplyCapability !== undefined) {
+            issues.push(adapterIssue(requirements.requirements, 'missing_apply', firstApplyCapability, 'apply'));
+        }
+    }
+    if (requiredCapabilities.includes('read') && !hasMethod(adapter, 'read')) {
+        issues.push(adapterIssue(requirements.requirements, 'missing_read', 'read', 'read'));
+    }
+    if (requiredCapabilities.includes('verifyCheck') && !hasMethod(adapter, 'verifyChecks')) {
+        issues.push(adapterIssue(requirements.requirements, 'missing_check_verifier', 'verifyCheck', 'verifyChecks'));
+    }
+    const shared = {
+        modelName: requirements.modelName,
+        actionName: requirements.actionName,
+        requiredCapabilities: Object.freeze(requiredCapabilities),
+    };
+    if (issues.length > 0) {
+        return {
+            status: 'invalid',
+            ...shared,
+            issues: Object.freeze(issues),
+        };
+    }
+    return {
+        status: 'valid',
+        ...shared,
+        issues: Object.freeze([]),
+    };
+}
 //# sourceMappingURL=requirements.js.map