@uwmd/core 1.1.0

package/dist/modules.js

@@ -0,0 +1,322 @@
+// Module loader and registry.
+//
+// v1 modules are declarative ModuleManifest objects. This loader validates the
+// protocol-level shape, checks host compatibility, parses safe-expression
+// formulas, enforces dependency presence, and returns an immutable in-process
+// registry. It deliberately does not perform dynamic imports or introduce new
+// asset-class identifiers; those remain v2/RFC concerns.
+import { parseExpression } from './calc/parser.js';
+import { FORMAT_VERSION, PROTOCOL_VERSION, } from './protocol.js';
+const TIERS = [
+    'tier-1-reader',
+    'tier-2-editor',
+    'tier-3-calc-host',
+    'tier-4-agent-host',
+];
+const ASSET_CLASSES = [
+    'multifamily',
+    'office',
+    'retail',
+    'industrial',
+    'self_storage',
+    'hospitality',
+    'mixed_use',
+    'senior_housing',
+    'student_housing',
+    'land',
+];
+const DEAL_STAGES = [
+    'scope',
+    'screening',
+    'term_sheet',
+    'full_underwrite',
+    'credit_approval',
+    'closing',
+    'monitoring',
+];
+const SEVERITIES = ['error', 'warning', 'info'];
+export class ModuleRegistryError extends Error {
+    errors;
+    constructor(errors) {
+        super(errors.map((e) => `${e.code}: ${e.message}`).join('; '));
+        this.name = 'ModuleRegistryError';
+        this.errors = errors;
+    }
+}
+export function loadModuleManifest(candidate, opts = {}) {
+    const manifest = candidate;
+    const errors = validateModuleManifest(manifest, opts);
+    return errors.length
+        ? { ok: false, errors }
+        : { ok: true, manifest: freezeManifest(manifest), errors: [] };
+}
+export function createModuleRegistry(opts) {
+    const loaded = [];
+    const errors = [];
+    for (const candidate of opts.modules) {
+        const result = loadModuleManifest(candidate, { ...opts, alreadyLoaded: loaded });
+        if (result.ok && result.manifest) {
+            loaded.push(result.manifest);
+        }
+        else {
+            errors.push(...result.errors);
+        }
+    }
+    if (errors.length > 0)
+        throw new ModuleRegistryError(errors);
+    const byId = new Map();
+    const byAssetClassMutable = new Map();
+    for (const manifest of loaded) {
+        byId.set(manifest.id, manifest);
+        for (const assetClass of manifest.asset_classes ?? []) {
+            const bucket = byAssetClassMutable.get(assetClass) ?? [];
+            bucket.push(manifest);
+            byAssetClassMutable.set(assetClass, bucket);
+        }
+    }
+    const byAssetClass = new Map([...byAssetClassMutable.entries()].map(([k, v]) => [k, Object.freeze([...v])]));
+    return Object.freeze({
+        modules: Object.freeze([...loaded]),
+        byId,
+        byAssetClass,
+        calculationsByAssetClass(asset_class) {
+            return [...(byAssetClass.get(asset_class) ?? [])].filter((m) => (m.calculations ?? []).length > 0);
+        },
+    });
+}
+export function getModuleCalculationsForAssetClass(registry, asset_class) {
+    return registry
+        .calculationsByAssetClass(asset_class)
+        .flatMap((m) => m.calculations ?? []);
+}
+function validateModuleManifest(manifest, opts) {
+    const errors = [];
+    if (!isRecord(manifest)) {
+        return [moduleError('PROTO-MOD-001', 'Module manifest must be an object.')];
+    }
+    requireString(errors, manifest, 'manifest_version');
+    requireString(errors, manifest, 'id');
+    requireString(errors, manifest, 'name');
+    requireString(errors, manifest, 'version');
+    requireString(errors, manifest, 'description');
+    requireString(errors, manifest, 'license');
+    requireString(errors, manifest, 'requires_protocol');
+    requireString(errors, manifest, 'requires_format');
+    requireString(errors, manifest, 'requires_tier');
+    if (manifest.manifest_version !== '1') {
+        errors.push(moduleError('PROTO-MOD-002', 'Unsupported module manifest_version.', 'manifest_version'));
+    }
+    if (!/^[a-z0-9]+(?:[._-][a-z0-9]+)*$/.test(String(manifest.id ?? ''))) {
+        errors.push(moduleError('PROTO-MOD-003', 'Module id must match the v1 identifier pattern.', 'id'));
+    }
+    if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/.test(String(manifest.version ?? ''))) {
+        errors.push(moduleError('PROTO-MOD-004', 'Module version must be semver.', 'version'));
+    }
+    if (!Array.isArray(manifest.authors) || manifest.authors.length === 0 || !manifest.authors.every((a) => typeof a === 'string' && a.length > 0)) {
+        errors.push(moduleError('PROTO-MOD-005', 'Module authors must be a non-empty string array.', 'authors'));
+    }
+    if (!TIERS.includes(manifest.requires_tier)) {
+        errors.push(moduleError('PROTO-MOD-006', 'Module requires_tier is not a valid viewer tier.', 'requires_tier'));
+    }
+    if (manifest.asset_classes !== undefined) {
+        if (!Array.isArray(manifest.asset_classes)) {
+            errors.push(moduleError('PROTO-MOD-007', 'asset_classes must be an array.', 'asset_classes'));
+        }
+        else {
+            for (const assetClass of manifest.asset_classes) {
+                if (!ASSET_CLASSES.includes(assetClass)) {
+                    errors.push(moduleError('PROTO-MOD-008', `Unknown v1 asset class: ${assetClass}`, 'asset_classes'));
+                }
+            }
+            if (new Set(manifest.asset_classes).size !== manifest.asset_classes.length) {
+                errors.push(moduleError('PROTO-MOD-009', 'asset_classes must be unique.', 'asset_classes'));
+            }
+        }
+    }
+    if (manifest.deal_stages !== undefined) {
+        if (!Array.isArray(manifest.deal_stages)) {
+            errors.push(moduleError('PROTO-MOD-010', 'deal_stages must be an array.', 'deal_stages'));
+        }
+        else {
+            for (const stage of manifest.deal_stages) {
+                if (!DEAL_STAGES.includes(stage)) {
+                    errors.push(moduleError('PROTO-MOD-011', `Unknown deal stage: ${stage}`, 'deal_stages'));
+                }
+            }
+        }
+    }
+    validateCalculations(errors, manifest);
+    validateValidations(errors, manifest);
+    validateDependencies(errors, manifest, opts.alreadyLoaded ?? []);
+    validateCompatibility(errors, manifest, opts);
+    return errors;
+}
+function validateCalculations(errors, manifest) {
+    if (manifest.calculations === undefined)
+        return;
+    if (!Array.isArray(manifest.calculations)) {
+        errors.push(moduleError('PROTO-MOD-012', 'calculations must be an array.', 'calculations'));
+        return;
+    }
+    const ids = new Set();
+    for (const [idx, calc] of manifest.calculations.entries()) {
+        const pointer = `calculations[${idx}]`;
+        if (!isRecord(calc)) {
+            errors.push(moduleError('PROTO-MOD-013', 'Calculation declaration must be an object.', pointer));
+            continue;
+        }
+        if (typeof calc.id !== 'string' || !/^[a-z][a-z0-9_]*$/.test(calc.id)) {
+            errors.push(moduleError('PROTO-MOD-014', 'Calculation id must match ^[a-z][a-z0-9_]*$.', `${pointer}.id`));
+        }
+        if (ids.has(String(calc.id))) {
+            errors.push(moduleError('PROTO-MOD-015', `Duplicate calculation id: ${String(calc.id)}`, `${pointer}.id`));
+        }
+        ids.add(String(calc.id));
+        if (typeof calc.label !== 'string' || calc.label.length === 0) {
+            errors.push(moduleError('PROTO-MOD-016', 'Calculation label is required.', `${pointer}.label`));
+        }
+        if (typeof calc.formula !== 'string' || calc.formula.length === 0) {
+            errors.push(moduleError('PROTO-MOD-017', 'Calculation formula is required.', `${pointer}.formula`));
+        }
+        else {
+            try {
+                parseExpression(calc.formula);
+            }
+            catch (e) {
+                errors.push(moduleError('PROTO-MOD-018', `Calculation formula does not parse: ${e instanceof Error ? e.message : String(e)}`, `${pointer}.formula`));
+            }
+        }
+        if (calc.deterministic !== true) {
+            errors.push(moduleError('PROTO-MOD-019', 'v1 calculations must declare deterministic: true.', `${pointer}.deterministic`));
+        }
+    }
+}
+function validateValidations(errors, manifest) {
+    if (manifest.validations === undefined)
+        return;
+    if (!Array.isArray(manifest.validations)) {
+        errors.push(moduleError('PROTO-MOD-020', 'validations must be an array.', 'validations'));
+        return;
+    }
+    for (const [idx, rule] of manifest.validations.entries()) {
+        const pointer = `validations[${idx}]`;
+        if (!isRecord(rule)) {
+            errors.push(moduleError('PROTO-MOD-021', 'Validation declaration must be an object.', pointer));
+            continue;
+        }
+        if (typeof rule.code !== 'string' || !/^[A-Z]{2,8}-[A-Z0-9-]+$/.test(rule.code)) {
+            errors.push(moduleError('PROTO-MOD-022', 'Validation code must match the module-code pattern.', `${pointer}.code`));
+        }
+        if (!SEVERITIES.includes(rule.severity)) {
+            errors.push(moduleError('PROTO-MOD-023', 'Validation severity is invalid.', `${pointer}.severity`));
+        }
+        if (typeof rule.message !== 'string' || rule.message.length === 0) {
+            errors.push(moduleError('PROTO-MOD-024', 'Validation message is required.', `${pointer}.message`));
+        }
+        if (typeof rule.rule !== 'string' || rule.rule.length === 0) {
+            errors.push(moduleError('PROTO-MOD-025', 'Validation rule is required.', `${pointer}.rule`));
+        }
+        else {
+            try {
+                parseExpression(rule.rule);
+            }
+            catch (e) {
+                errors.push(moduleError('PROTO-MOD-026', `Validation rule does not parse: ${e instanceof Error ? e.message : String(e)}`, `${pointer}.rule`));
+            }
+        }
+    }
+}
+function validateDependencies(errors, manifest, alreadyLoaded) {
+    const loaded = new Map(alreadyLoaded.map((m) => [m.id, m]));
+    for (const dep of manifest.depends_on ?? []) {
+        const dependency = loaded.get(dep.id);
+        if (!dependency) {
+            errors.push(moduleError('PROTO-MOD-027', `Missing module dependency: ${dep.id}`, 'depends_on'));
+            continue;
+        }
+        if (!versionSatisfies(dependency.version, dep.version)) {
+            errors.push(moduleError('PROTO-MOD-028', `Module dependency ${dep.id}@${dependency.version} does not satisfy ${dep.version}.`, 'depends_on'));
+        }
+    }
+}
+function validateCompatibility(errors, manifest, opts) {
+    const hostTier = opts.hostTier ?? 'tier-3-calc-host';
+    if (TIERS.indexOf(hostTier) < TIERS.indexOf(manifest.requires_tier)) {
+        errors.push(moduleError('PROTO-MOD-029', `Host tier ${hostTier} does not satisfy required tier ${manifest.requires_tier}.`, 'requires_tier'));
+    }
+    const protocolVersion = opts.protocolVersion ?? PROTOCOL_VERSION;
+    if (!versionSatisfies(protocolVersion, manifest.requires_protocol)) {
+        errors.push(moduleError('PROTO-MOD-030', `Host protocol ${protocolVersion} does not satisfy ${manifest.requires_protocol}.`, 'requires_protocol'));
+    }
+    const formatVersion = normalizeFormatVersion(opts.formatVersion ?? FORMAT_VERSION);
+    if (!versionSatisfies(formatVersion, manifest.requires_format)) {
+        errors.push(moduleError('PROTO-MOD-031', `Host format ${formatVersion} does not satisfy ${manifest.requires_format}.`, 'requires_format'));
+    }
+}
+function versionSatisfies(version, range) {
+    const normalizedVersion = normalizeFormatVersion(version);
+    const v = parseSemver(normalizedVersion);
+    if (!v)
+        return false;
+    const trimmed = range.trim();
+    if (trimmed === '*' || trimmed === '')
+        return true;
+    if (trimmed.startsWith('^')) {
+        const base = parseSemver(normalizeFormatVersion(trimmed.slice(1)));
+        return !!base && v.major === base.major && compareSemver(v, base) >= 0;
+    }
+    const comparators = trimmed.split(/\s+/).filter(Boolean);
+    return comparators.every((part) => {
+        const m = /^(>=|>|<=|<|=)?(.+)$/.exec(part);
+        if (!m)
+            return false;
+        const op = m[1] ?? '=';
+        const target = parseSemver(normalizeFormatVersion(m[2] ?? ''));
+        if (!target)
+            return false;
+        const cmp = compareSemver(v, target);
+        switch (op) {
+            case '>': return cmp > 0;
+            case '>=': return cmp >= 0;
+            case '<': return cmp < 0;
+            case '<=': return cmp <= 0;
+            default: return cmp === 0;
+        }
+    });
+}
+function normalizeFormatVersion(version) {
+    return /^\d+\.\d+$/.test(version) ? `${version}.0` : version;
+}
+function parseSemver(version) {
+    const m = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
+    return m ? { major: Number(m[1]), minor: Number(m[2]), patch: Number(m[3]) } : null;
+}
+function compareSemver(a, b) {
+    return a.major - b.major || a.minor - b.minor || a.patch - b.patch;
+}
+function requireString(errors, manifest, key) {
+    if (typeof manifest[key] !== 'string' || manifest[key].length === 0) {
+        errors.push(moduleError('PROTO-MOD-032', `Required string field missing: ${key}`, key));
+    }
+}
+function freezeManifest(manifest) {
+    return Object.freeze({
+        ...manifest,
+        authors: Object.freeze([...(manifest.authors ?? [])]),
+        asset_classes: manifest.asset_classes ? Object.freeze([...manifest.asset_classes]) : undefined,
+        deal_stages: manifest.deal_stages ? Object.freeze([...manifest.deal_stages]) : undefined,
+        sections: manifest.sections ? Object.freeze([...manifest.sections]) : undefined,
+        calculations: manifest.calculations ? Object.freeze([...manifest.calculations]) : undefined,
+        validations: manifest.validations ? Object.freeze([...manifest.validations]) : undefined,
+        view_models: manifest.view_models ? Object.freeze([...manifest.view_models]) : undefined,
+        agent_layers: manifest.agent_layers ? Object.freeze([...manifest.agent_layers]) : undefined,
+        depends_on: manifest.depends_on ? Object.freeze([...manifest.depends_on]) : undefined,
+    });
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function moduleError(code, message, pointer) {
+    return { category: 'module', code, message, ...(pointer ? { pointer } : {}) };
+}
+//# sourceMappingURL=modules.js.map

package/dist/modules.js.map

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

package/dist/negotiation.d.ts

@@ -0,0 +1,19 @@
+import type { RepresentationCapability, RepresentationDirection, RepresentationFidelity } from './protocol.js';
+export interface NegotiationOptions {
+    direction?: RepresentationDirection;
+    minimum_fidelity?: RepresentationFidelity;
+}
+export interface NegotiatedRepresentation {
+    descriptor: RepresentationCapability;
+    media_type: string;
+}
+export declare class RepresentationNegotiationError extends Error {
+    readonly code: string;
+    readonly status: 406 | 415;
+    constructor(code: string, status: 406 | 415, message: string);
+}
+/** Selects a registered representation using HTTP Accept semantics. */
+export declare function negotiateRepresentation(accept: string | undefined, descriptors: readonly RepresentationCapability[], options?: NegotiationOptions): NegotiatedRepresentation;
+/** Resolves a request Content-Type to a readable representation. */
+export declare function resolveInputRepresentation(contentType: string, descriptors: readonly RepresentationCapability[]): NegotiatedRepresentation;
+//# sourceMappingURL=negotiation.d.ts.map

package/dist/negotiation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"negotiation.d.ts","sourceRoot":"","sources":["../src/negotiation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,uBAAuB,CAAC;IACpC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;CAC3C;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,wBAAwB,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,8BAA+B,SAAQ,KAAK;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG,EAAE,OAAO,EAAE,MAAM;CAM7D;AAED,uEAAuE;AACvE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,WAAW,EAAE,SAAS,wBAAwB,EAAE,EAChD,OAAO,GAAE,kBAAuB,GAC/B,wBAAwB,CA6B1B;AAED,oEAAoE;AACpE,wBAAgB,0BAA0B,CACxC,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,SAAS,wBAAwB,EAAE,GAC/C,wBAAwB,CAY1B"}

package/dist/negotiation.js

@@ -0,0 +1,70 @@
+export class RepresentationNegotiationError extends Error {
+    code;
+    status;
+    constructor(code, status, message) {
+        super(`[${code}] ${message}`);
+        this.name = 'RepresentationNegotiationError';
+        this.code = code;
+        this.status = status;
+    }
+}
+/** Selects a registered representation using HTTP Accept semantics. */
+export function negotiateRepresentation(accept, descriptors, options = {}) {
+    const ranges = parseAccept(accept ?? '*/*');
+    const minimum = fidelityRank(options.minimum_fidelity ?? 'view');
+    const candidates = [];
+    descriptors.forEach((descriptor, order) => {
+        if (options.direction && !descriptor.directions.includes(options.direction))
+            return;
+        if (fidelityRank(descriptor.fidelity) < minimum)
+            return;
+        for (const mediaType of descriptor.media_types) {
+            const best = ranges
+                .filter((range) => mediaRangeMatches(range.mediaRange, mediaType))
+                .sort((left, right) => right.specificity - left.specificity || right.q - left.q)[0];
+            if (best && best.q > 0) {
+                candidates.push({ descriptor, media_type: mediaType, q: best.q, specificity: best.specificity, order });
+            }
+        }
+    });
+    const selected = candidates.sort((left, right) => right.q - left.q || right.specificity - left.specificity || left.order - right.order)[0];
+    if (!selected) {
+        throw new RepresentationNegotiationError('REPRESENTATION_NOT_ACCEPTABLE', 406, `No representation satisfies Accept: ${accept ?? '*/*'}.`);
+    }
+    return { descriptor: selected.descriptor, media_type: selected.media_type };
+}
+/** Resolves a request Content-Type to a readable representation. */
+export function resolveInputRepresentation(contentType, descriptors) {
+    const normalized = contentType.split(';', 1)[0]?.trim().toLowerCase();
+    for (const descriptor of descriptors) {
+        if (!descriptor.directions.includes('read'))
+            continue;
+        const mediaType = descriptor.media_types.find((item) => item.toLowerCase() === normalized);
+        if (mediaType)
+            return { descriptor, media_type: mediaType };
+    }
+    throw new RepresentationNegotiationError('REPRESENTATION_UNSUPPORTED_MEDIA_TYPE', 415, `No readable representation owns Content-Type: ${contentType}.`);
+}
+function parseAccept(value) {
+    return value.split(',').map((part) => {
+        const [rawRange = '*/*', ...parameters] = part.trim().split(';');
+        const mediaRange = rawRange.toLowerCase();
+        const qParameter = parameters.find((parameter) => parameter.trim().toLowerCase().startsWith('q='));
+        const parsedQ = qParameter ? Number(qParameter.trim().slice(2)) : 1;
+        const q = Number.isFinite(parsedQ) && parsedQ >= 0 && parsedQ <= 1 ? parsedQ : 0;
+        const specificity = mediaRange === '*/*' ? 0 : mediaRange.endsWith('/*') ? 1 : 2;
+        return { mediaRange, q, specificity };
+    });
+}
+function mediaRangeMatches(range, mediaType) {
+    const normalized = mediaType.toLowerCase();
+    if (range === '*/*')
+        return true;
+    if (range.endsWith('/*'))
+        return normalized.startsWith(`${range.slice(0, -1)}`);
+    return range === normalized;
+}
+function fidelityRank(fidelity) {
+    return { view: 0, model: 1, source: 2 }[fidelity];
+}
+//# sourceMappingURL=negotiation.js.map

package/dist/negotiation.js.map

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

package/dist/opstatement.d.ts

@@ -0,0 +1,9 @@
+import { type DerivedField } from './derived.js';
+type Row = Record<string, unknown>;
+export interface OperatingStatementDerivation {
+    fields: DerivedField[];
+}
+/** Foot an operating-statement content block. Pure: never mutates `content`. */
+export declare function deriveOperatingStatement(content: Row): OperatingStatementDerivation;
+export {};
+//# sourceMappingURL=opstatement.d.ts.map

package/dist/opstatement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opstatement.d.ts","sourceRoot":"","sources":["../src/opstatement.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAwB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvE,KAAK,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAKnC,MAAM,WAAW,4BAA4B;IAC3C,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AA6BD,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,GAAG,GAAG,4BAA4B,CAuCnF"}

package/dist/opstatement.js

@@ -0,0 +1,80 @@
+// Deterministic operating-statement footing — the income/expense line items are
+// the inputs; effective gross income, total operating expenses, NOI, and the
+// ratios foot from them. Same role for the operating_statement section that
+// deriveRentRoll plays for rent_roll: one source of truth so the editor, CLI,
+// and Excel converter never disagree.
+//
+// Conventions (standard CRE underwriting):
+//  - EGI   = GPR − vacancy/credit loss − concessions − loss to lease + other income
+//  - OpEx  = sum of operating expense lines, EXCLUDING capital expenditures and
+//            replacement reserves (both are below-the-line for NOI purposes)
+//  - NOI   = EGI − OpEx
+//  - sub-rollups: other_income.total and utilities.total foot from their breakdowns
+//
+// Per-unit / per-sqft figures depend on the property section and are left as
+// inputs here (this function sees only the operating_statement block).
+import { collector, numOrNull } from './derived.js';
+const num = numOrNull;
+const asObj = (v) => (v !== null && typeof v === 'object' && !Array.isArray(v) ? v : {});
+// Operating-expense lines that sum into total_operating_expenses. Excludes
+// capital_expenditures_actual and replacement_reserves (below the line), the
+// management_fee_pct_egi ratio, and the nested utilities object (added via its
+// own footed total).
+const EXPENSE_LINES = [
+    'real_estate_taxes',
+    'insurance',
+    'management_fees',
+    'payroll_benefits',
+    'repairs_maintenance',
+    'contract_services',
+    'marketing_advertising',
+    'administrative',
+    'professional_fees',
+    'other_expenses',
+];
+/** Sum the numeric values of an object, skipping the listed keys. */
+function sumExcept(obj, skip) {
+    let total = 0;
+    for (const [k, v] of Object.entries(obj)) {
+        if (skip.includes(k))
+            continue;
+        total += num(v) ?? 0;
+    }
+    return total;
+}
+/** Foot an operating-statement content block. Pure: never mutates `content`. */
+export function deriveOperatingStatement(content) {
+    const c = collector();
+    const income = asObj(content['income']);
+    const expenses = asObj(content['expenses']);
+    // Income side.
+    const otherIncome = asObj(income['other_income']);
+    const otherIncomeTotal = sumExcept(otherIncome, ['total']);
+    if (Object.keys(otherIncome).length > 0) {
+        c.add('income.other_income.total', 'Other Income (total)', 'currency', otherIncomeTotal);
+    }
+    const gpr = num(income['gross_potential_rent']) ?? 0;
+    const vacancy = num(income['less_vacancy_credit_loss']) ?? 0;
+    const concessions = num(income['less_concessions']) ?? 0;
+    const lossToLease = num(income['less_loss_to_lease']) ?? 0;
+    const egi = gpr - vacancy - concessions - lossToLease + otherIncomeTotal;
+    c.add('income.vacancy_pct', 'Vacancy %', 'rate', gpr ? vacancy / gpr : null);
+    c.add('income.effective_gross_income', 'Effective Gross Income', 'currency', egi);
+    // Expense side.
+    const utilities = asObj(expenses['utilities']);
+    const utilitiesTotal = sumExcept(utilities, ['total']);
+    if (Object.keys(utilities).length > 0) {
+        c.add('expenses.utilities.total', 'Utilities (total)', 'currency', utilitiesTotal);
+    }
+    let opex = utilitiesTotal;
+    for (const key of EXPENSE_LINES)
+        opex += num(expenses[key]) ?? 0;
+    c.add('expenses.total_operating_expenses', 'Total Operating Expenses', 'currency', opex);
+    // Bottom line.
+    const noi = egi - opex;
+    c.add('net_operating_income', 'Net Operating Income', 'currency', noi);
+    c.add('expense_ratio', 'Expense Ratio', 'rate', egi ? opex / egi : null);
+    c.add('noi_margin', 'NOI Margin', 'rate', egi ? noi / egi : null);
+    return { fields: c.fields };
+}
+//# sourceMappingURL=opstatement.js.map

package/dist/opstatement.js.map

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

package/dist/packs/excel-emit.d.ts

@@ -0,0 +1,21 @@
+import { type Expr } from '../calc/parser.js';
+export interface ExcelEmitOptions {
+    /**
+     * Map from calc-engine path (joined with dots, e.g. `noi_model.net_operating_income`)
+     * to Excel named range (e.g. `noi`). Bare identifiers are looked up by name.
+     */
+    namedRanges: ReadonlyMap<string, string>;
+}
+export declare class ExcelEmitError extends Error {
+    code: 'EXCEL-EMIT-PATH' | 'EXCEL-EMIT-FN' | 'EXCEL-EMIT-OP';
+    constructor(code: 'EXCEL-EMIT-PATH' | 'EXCEL-EMIT-FN' | 'EXCEL-EMIT-OP', message: string);
+}
+/**
+ * Emit an Excel formula (without leading `=`) for a parsed expression.
+ * Throws ExcelEmitError if the expression references a path not in the map
+ * or uses a builtin without a clean Excel equivalent.
+ */
+export declare function emitFromAst(expr: Expr, opts: ExcelEmitOptions): string;
+/** Convenience: parse + emit in one call. */
+export declare function emitExcelFormula(formula: string, opts: ExcelEmitOptions): string;
+//# sourceMappingURL=excel-emit.d.ts.map

package/dist/packs/excel-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"excel-emit.d.ts","sourceRoot":"","sources":["../../src/packs/excel-emit.ts"],"names":[],"mappings":"AA2BA,OAAO,EAAmB,KAAK,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,qBAAa,cAAe,SAAQ,KAAK;IAE9B,IAAI,EAAE,iBAAiB,GAAG,eAAe,GAAG,eAAe;gBAA3D,IAAI,EAAE,iBAAiB,GAAG,eAAe,GAAG,eAAe,EAClE,OAAO,EAAE,MAAM;CAKlB;AAuBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CA0EtE;AAED,6CAA6C;AAC7C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAEhF"}