@uwmd/core 1.1.0

package/dist/packs/excel-emit.js

@@ -0,0 +1,135 @@
+// AST → Excel formula emitter.
+//
+// Takes a Tier-3 safe expression (parsed by @uwmd/core's calc parser) and a
+// map from calc-engine identifier paths to Excel named ranges. Emits an Excel
+// formula string (without the leading "=") that produces the same number Excel
+// would compute via its own engine.
+//
+// This is what unlocks "write a calc once, consume it everywhere": the web
+// editor evaluates the expression directly via `evaluateCalc()`, while
+// @uwmd/excel emits the same expression as an Excel formula that references
+// workbook-scope named ranges. Both produce identical numbers by construction.
+//
+// Identifier mapping rules:
+//   - A calc-engine path like `noi_model.net_operating_income` maps to a
+//     named range like `noi`. The map is keyed on the joined path
+//     (`section.field.subfield`) and supplied by the caller.
+//   - Bare identifiers (no dot path) also look up directly in the map.
+//   - If a path isn't in the map, emission fails with EXCEL-EMIT-PATH.
+//
+// Operator / function coverage:
+//   - Arithmetic +, -, *, / and parentheses → identical syntax in Excel.
+//   - Modulo (%) → MOD(left, right).
+//   - Comparison and ternary → IF(test, then, else).
+//   - Builtins map to their Excel equivalents (SUM, AVERAGE, MIN, MAX, IF,
+//     ROUND, PMT, NPV, IRR). Functions without a clean Excel equivalent
+//     (`coalesce`, `avg` with null handling) raise EXCEL-EMIT-FN.
+import { parseExpression } from '../calc/parser.js';
+export class ExcelEmitError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'ExcelEmitError';
+    }
+}
+const FUNCTION_MAP = {
+    sum: 'SUM',
+    min: 'MIN',
+    max: 'MAX',
+    if: 'IF',
+    round: 'ROUND',
+    pmt: 'PMT',
+    npv: 'NPV',
+    irr: 'IRR',
+    abs: 'ABS',
+    floor: 'FLOOR',
+    ceil: 'CEILING',
+    sqrt: 'SQRT',
+    pow: 'POWER',
+    log: 'LN',
+    exp: 'EXP',
+    fv: 'FV',
+    pv: 'PV',
+    nper: 'NPER',
+};
+/**
+ * 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 function emitFromAst(expr, opts) {
+    switch (expr.kind) {
+        case 'literal':
+            if (expr.value === null)
+                return '""';
+            if (typeof expr.value === 'boolean')
+                return expr.value ? 'TRUE' : 'FALSE';
+            if (typeof expr.value === 'string')
+                return `"${expr.value.replace(/"/g, '""')}"`;
+            return String(expr.value);
+        case 'ident': {
+            const mapped = opts.namedRanges.get(expr.name);
+            if (!mapped) {
+                throw new ExcelEmitError('EXCEL-EMIT-PATH', `No Excel named range for identifier '${expr.name}'.`);
+            }
+            return mapped;
+        }
+        case 'path': {
+            const joined = [expr.head, ...expr.segments].join('.');
+            const mapped = opts.namedRanges.get(joined);
+            if (!mapped) {
+                throw new ExcelEmitError('EXCEL-EMIT-PATH', `No Excel named range for path '${joined}'.`);
+            }
+            return mapped;
+        }
+        case 'unary': {
+            const inner = emitFromAst(expr.operand, opts);
+            if (expr.op === '-')
+                return `-(${inner})`;
+            return `NOT(${inner})`;
+        }
+        case 'binary': {
+            const left = emitFromAst(expr.left, opts);
+            const right = emitFromAst(expr.right, opts);
+            switch (expr.op) {
+                case '+':
+                case '-':
+                case '*':
+                case '/':
+                    return `(${left}${expr.op}${right})`;
+                case '%':
+                    return `MOD(${left},${right})`;
+                case '==': return `(${left}=${right})`;
+                case '!=': return `(${left}<>${right})`;
+                case '<':
+                case '<=':
+                case '>':
+                case '>=':
+                    return `(${left}${expr.op}${right})`;
+                case '&&': return `AND(${left},${right})`;
+                case '||': return `OR(${left},${right})`;
+            }
+            throw new ExcelEmitError('EXCEL-EMIT-OP', 'Unreachable: unhandled binary operator.');
+        }
+        case 'cond': {
+            const test = emitFromAst(expr.test, opts);
+            const consequent = emitFromAst(expr.consequent, opts);
+            const alternate = emitFromAst(expr.else, opts);
+            return `IF(${test},${consequent},${alternate})`;
+        }
+        case 'call': {
+            const xlName = FUNCTION_MAP[expr.name];
+            if (!xlName) {
+                throw new ExcelEmitError('EXCEL-EMIT-FN', `No Excel mapping for function '${expr.name}'.`);
+            }
+            const args = expr.args.map((a) => emitFromAst(a, opts)).join(',');
+            return `${xlName}(${args})`;
+        }
+    }
+}
+/** Convenience: parse + emit in one call. */
+export function emitExcelFormula(formula, opts) {
+    return emitFromAst(parseExpression(formula), opts);
+}
+//# sourceMappingURL=excel-emit.js.map

package/dist/packs/excel-emit.js.map

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

package/dist/packs/index.d.ts

@@ -0,0 +1,13 @@
+import type { ModuleManifest } from '../protocol.js';
+export { MULTIFAMILY_PACK } from './multifamily.js';
+export { OFFICE_PACK } from './office.js';
+export { RETAIL_PACK } from './retail.js';
+export { INDUSTRIAL_PACK } from './industrial.js';
+export { SELF_STORAGE_PACK } from './self-storage.js';
+export { emitFromAst, emitExcelFormula, ExcelEmitError, type ExcelEmitOptions, } from './excel-emit.js';
+/**
+ * Look up the built-in calc pack for an asset class. Returns null when no pack
+ * is registered (callers may fall back to the multifamily pack or skip metrics).
+ */
+export declare function getPackForAssetClass(asset_class: string): ModuleManifest | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/packs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/packs/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAOrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,KAAK,gBAAgB,GACtB,MAAM,iBAAiB,CAAC;AAezB;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAE/E"}

package/dist/packs/index.js

@@ -0,0 +1,37 @@
+// Asset-class calc packs — public surface.
+//
+// A "pack" is a ModuleManifest declaring derived-metric calcs (and, in future
+// versions, validations and view models) for a specific asset class. Packs are
+// the modular unit that lets every tool in the ecosystem (web editor, Excel
+// converter, agents, future viewers) consume the same calc definitions.
+import { MULTIFAMILY_PACK } from './multifamily.js';
+import { OFFICE_PACK } from './office.js';
+import { RETAIL_PACK } from './retail.js';
+import { INDUSTRIAL_PACK } from './industrial.js';
+import { SELF_STORAGE_PACK } from './self-storage.js';
+export { MULTIFAMILY_PACK } from './multifamily.js';
+export { OFFICE_PACK } from './office.js';
+export { RETAIL_PACK } from './retail.js';
+export { INDUSTRIAL_PACK } from './industrial.js';
+export { SELF_STORAGE_PACK } from './self-storage.js';
+export { emitFromAst, emitExcelFormula, ExcelEmitError, } from './excel-emit.js';
+/**
+ * Built-in calc packs keyed by the asset class they target. Mirrors the
+ * defaults REGISTRY in `defaults.ts`. Third-party / module-loaded packs are out
+ * of scope for v1 (see RFC 0003) — these are the compiled-in starter packs.
+ */
+const PACK_REGISTRY = Object.freeze({
+    multifamily: MULTIFAMILY_PACK,
+    office: OFFICE_PACK,
+    retail: RETAIL_PACK,
+    industrial: INDUSTRIAL_PACK,
+    self_storage: SELF_STORAGE_PACK,
+});
+/**
+ * Look up the built-in calc pack for an asset class. Returns null when no pack
+ * is registered (callers may fall back to the multifamily pack or skip metrics).
+ */
+export function getPackForAssetClass(asset_class) {
+    return PACK_REGISTRY[asset_class] ?? null;
+}
+//# sourceMappingURL=index.js.map

package/dist/packs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/packs/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,4EAA4E;AAC5E,wEAAwE;AAGxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,GAEf,MAAM,iBAAiB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,aAAa,GAA6C,MAAM,CAAC,MAAM,CAAC;IAC5E,WAAW,EAAE,gBAAgB;IAC7B,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,UAAU,EAAE,eAAe;IAC3B,YAAY,EAAE,iBAAiB;CAChC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,OAAO,aAAa,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC;AAC5C,CAAC"}

package/dist/packs/industrial.d.ts

@@ -0,0 +1,3 @@
+import type { ModuleManifest } from '../protocol.js';
+export declare const INDUSTRIAL_PACK: ModuleManifest;
+//# sourceMappingURL=industrial.d.ts.map

package/dist/packs/industrial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"industrial.d.ts","sourceRoot":"","sources":["../../src/packs/industrial.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,eAAe,EAAE,cAsG7B,CAAC"}

package/dist/packs/industrial.js

@@ -0,0 +1,115 @@
+// Canonical industrial calc pack.
+//
+// Single source of truth for the industrial derived metrics. Consumed by the
+// web editor (via @uwmd/core/browser), the @uwmd/excel converter (via
+// emitExcelFormula), conformance tests, and any future asset-class viewer.
+// Add a metric here once and every tool picks it up.
+//
+// Each formula is a Tier-3 safe expression evaluable by `evaluateCalc()`
+// against a parsed .uw.md file. Field paths reference the canonical industrial
+// schema (see UW_FORMAT_SPEC §4 and the Ironwood Logistics example).
+//
+// Industrial measures size in rentable building area (`property.rentable_square_feet`)
+// and occupancy in SF (`rent_roll.occupied_sf` / `total_rentable_sf`), like
+// office. Like retail, it carries an `expense_recovery_ratio` metric — industrial
+// is predominantly NNN, so most operating expenses are recovered from tenants.
+export const INDUSTRIAL_PACK = {
+    manifest_version: '1',
+    id: 'org.uwmd.pack.industrial',
+    name: 'Industrial Starter Pack',
+    version: '1.0.0',
+    description: 'Twelve derived metrics for industrial underwriting: cap rate, LTV, LTC, DSCR, debt yield, $/sqft, loan/sqft, NOI/sqft, expense ratio, expense recovery ratio, cash-on-cash, occupancy.',
+    authors: ['UW Markdown Working Group'],
+    license: 'MIT',
+    requires_protocol: '^1.0.0',
+    requires_format: '^1.1.0',
+    requires_tier: 'tier-3-calc-host',
+    asset_classes: ['industrial'],
+    calculations: [
+        {
+            id: 'cap_rate',
+            label: 'Cap Rate',
+            formula: 'noi_model.net_operating_income / valuation.purchase_price',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'ltv',
+            label: 'LTV',
+            formula: 'debt_structure.loan_amount / valuation.purchase_price',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'ltc',
+            label: 'LTC',
+            formula: 'debt_structure.loan_amount / sources_uses.uses.total',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'dscr',
+            label: 'DSCR',
+            formula: 'noi_model.net_operating_income / debt_structure.annual_debt_service',
+            unit: 'x',
+            deterministic: true,
+        },
+        {
+            id: 'debt_yield',
+            label: 'Debt Yield',
+            formula: 'noi_model.net_operating_income / debt_structure.loan_amount',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'price_per_sqft',
+            label: 'Price / SqFt',
+            formula: 'valuation.purchase_price / property.rentable_square_feet',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'loan_per_sqft',
+            label: 'Loan / SqFt',
+            formula: 'debt_structure.loan_amount / property.rentable_square_feet',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'noi_per_sqft',
+            label: 'NOI / SqFt',
+            formula: 'noi_model.net_operating_income / property.rentable_square_feet',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'expense_ratio',
+            label: 'Operating Expense Ratio',
+            formula: 'noi_model.expenses.total_operating_expenses / noi_model.income.effective_gross_income',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'expense_recovery_ratio',
+            label: 'Expense Recovery Ratio',
+            formula: 'noi_model.income.expense_reimbursements / noi_model.expenses.total_operating_expenses',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'cash_on_cash',
+            label: 'Cash-on-Cash',
+            formula: '(noi_model.net_operating_income - debt_structure.annual_debt_service) / sources_uses.sources.sponsor_equity',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'occupancy',
+            label: 'Occupancy',
+            formula: 'rent_roll.occupied_sf / rent_roll.total_rentable_sf',
+            unit: '%',
+            deterministic: true,
+        },
+    ],
+};
+//# sourceMappingURL=industrial.js.map

package/dist/packs/industrial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"industrial.js","sourceRoot":"","sources":["../../src/packs/industrial.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,EAAE;AACF,6EAA6E;AAC7E,sEAAsE;AACtE,2EAA2E;AAC3E,qDAAqD;AACrD,EAAE;AACF,yEAAyE;AACzE,+EAA+E;AAC/E,qEAAqE;AACrE,EAAE;AACF,uFAAuF;AACvF,4EAA4E;AAC5E,kFAAkF;AAClF,+EAA+E;AAI/E,MAAM,CAAC,MAAM,eAAe,GAAmB;IAC7C,gBAAgB,EAAE,GAAG;IACrB,EAAE,EAAE,0BAA0B;IAC9B,IAAI,EAAE,yBAAyB;IAC/B,OAAO,EAAE,OAAO;IAChB,WAAW,EACT,wLAAwL;IAC1L,OAAO,EAAE,CAAC,2BAA2B,CAAC;IACtC,OAAO,EAAE,KAAK;IACd,iBAAiB,EAAE,QAAQ;IAC3B,eAAe,EAAE,QAAQ;IACzB,aAAa,EAAE,kBAAkB;IACjC,aAAa,EAAE,CAAC,YAAY,CAAC;IAC7B,YAAY,EAAE;QACZ;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,2DAA2D;YACpE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,uDAAuD;YAChE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,sDAAsD;YAC/D,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,qEAAqE;YAC9E,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,6DAA6D;YACtE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,gBAAgB;YACpB,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,0DAA0D;YACnE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,4DAA4D;YACrE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,gEAAgE;YACzE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,yBAAyB;YAChC,OAAO,EACL,uFAAuF;YACzF,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,wBAAwB;YAC5B,KAAK,EAAE,wBAAwB;YAC/B,OAAO,EACL,uFAAuF;YACzF,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,cAAc;YACrB,OAAO,EACL,6GAA6G;YAC/G,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,qDAAqD;YAC9D,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;KACF;CACF,CAAC"}

package/dist/packs/multifamily.d.ts

@@ -0,0 +1,3 @@
+import type { ModuleManifest } from '../protocol.js';
+export declare const MULTIFAMILY_PACK: ModuleManifest;
+//# sourceMappingURL=multifamily.d.ts.map

package/dist/packs/multifamily.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multifamily.d.ts","sourceRoot":"","sources":["../../src/packs/multifamily.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,gBAAgB,EAAE,cAwE9B,CAAC"}

package/dist/packs/multifamily.js

@@ -0,0 +1,82 @@
+// Canonical multifamily calc pack.
+//
+// Single source of truth for the eight multifamily derived metrics. Consumed
+// by the web editor (via @uwmd/core/browser), the @uwmd/excel converter (via
+// emitExcelFormula), conformance tests, and any future asset-class viewer.
+// Add a metric here once and every tool picks it up.
+//
+// Each formula is a Tier-3 safe expression evaluable by `evaluateCalc()`
+// against a parsed .uw.md file. Field paths reference the canonical
+// multifamily schema (see UW_FORMAT_SPEC §4 and the Parkview example).
+export const MULTIFAMILY_PACK = {
+    manifest_version: '1',
+    id: 'org.uwmd.pack.multifamily',
+    name: 'Multifamily Starter Pack',
+    version: '1.0.0',
+    description: 'Eight derived metrics for multifamily underwriting: cap rate, LTV, DSCR, debt yield, $/unit, $/sqft, price/unit, cash-on-cash.',
+    authors: ['UW Markdown Working Group'],
+    license: 'MIT',
+    requires_protocol: '^1.0.0',
+    requires_format: '^1.1.0',
+    requires_tier: 'tier-3-calc-host',
+    asset_classes: ['multifamily'],
+    calculations: [
+        {
+            id: 'cap_rate',
+            label: 'Cap Rate',
+            formula: 'noi_model.net_operating_income / valuation.purchase_price',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'ltv',
+            label: 'LTV',
+            formula: 'debt_structure.loan_amount / valuation.purchase_price',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'dscr',
+            label: 'DSCR',
+            formula: 'noi_model.net_operating_income / debt_structure.annual_debt_service',
+            unit: 'x',
+            deterministic: true,
+        },
+        {
+            id: 'debt_yield',
+            label: 'Debt Yield',
+            formula: 'noi_model.net_operating_income / debt_structure.loan_amount',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'price_per_unit',
+            label: 'Price / Unit',
+            formula: 'valuation.purchase_price / property.total_units',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'loan_per_unit',
+            label: 'Loan / Unit',
+            formula: 'debt_structure.loan_amount / property.total_units',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'loan_per_sqft',
+            label: 'Loan / SqFt',
+            formula: 'debt_structure.loan_amount / property.total_nra_sqft',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'cash_on_cash',
+            label: 'Cash-on-Cash',
+            formula: '(noi_model.net_operating_income - debt_structure.annual_debt_service) / sources_uses.sources.equity_sponsor',
+            unit: '%',
+            deterministic: true,
+        },
+    ],
+};
+//# sourceMappingURL=multifamily.js.map

package/dist/packs/multifamily.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"multifamily.js","sourceRoot":"","sources":["../../src/packs/multifamily.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,2EAA2E;AAC3E,qDAAqD;AACrD,EAAE;AACF,yEAAyE;AACzE,oEAAoE;AACpE,uEAAuE;AAIvE,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,gBAAgB,EAAE,GAAG;IACrB,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,0BAA0B;IAChC,OAAO,EAAE,OAAO;IAChB,WAAW,EACT,gIAAgI;IAClI,OAAO,EAAE,CAAC,2BAA2B,CAAC;IACtC,OAAO,EAAE,KAAK;IACd,iBAAiB,EAAE,QAAQ;IAC3B,eAAe,EAAE,QAAQ;IACzB,aAAa,EAAE,kBAAkB;IACjC,aAAa,EAAE,CAAC,aAAa,CAAC;IAC9B,YAAY,EAAE;QACZ;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,2DAA2D;YACpE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,uDAAuD;YAChE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,qEAAqE;YAC9E,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,6DAA6D;YACtE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,gBAAgB;YACpB,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,iDAAiD;YAC1D,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,mDAAmD;YAC5D,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,sDAAsD;YAC/D,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,cAAc;YACrB,OAAO,EACL,6GAA6G;YAC/G,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;KACF;CACF,CAAC"}

package/dist/packs/office.d.ts

@@ -0,0 +1,3 @@
+import type { ModuleManifest } from '../protocol.js';
+export declare const OFFICE_PACK: ModuleManifest;
+//# sourceMappingURL=office.d.ts.map

package/dist/packs/office.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"office.d.ts","sourceRoot":"","sources":["../../src/packs/office.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,cA8FzB,CAAC"}

package/dist/packs/office.js

@@ -0,0 +1,108 @@
+// Canonical office calc pack.
+//
+// Single source of truth for the office derived metrics. Consumed by the web
+// editor (via @uwmd/core/browser), the @uwmd/excel converter (via
+// emitExcelFormula), conformance tests, and any future asset-class viewer.
+// Add a metric here once and every tool picks it up.
+//
+// Each formula is a Tier-3 safe expression evaluable by `evaluateCalc()`
+// against a parsed .uw.md file. Field paths reference the canonical office
+// schema (see UW_FORMAT_SPEC §4 and the Riverside office example).
+//
+// Office differs from multifamily on three field paths: size is measured in
+// rentable square feet (`property.rentable_square_feet`, not `total_units`),
+// sponsor equity is `sources_uses.sources.sponsor_equity` (not `equity_sponsor`),
+// and the NOI model splits income/expenses into nested objects.
+export const OFFICE_PACK = {
+    manifest_version: '1',
+    id: 'org.uwmd.pack.office',
+    name: 'Office Starter Pack',
+    version: '1.0.0',
+    description: 'Eleven derived metrics for office underwriting: cap rate, LTV, LTC, DSCR, debt yield, $/sqft, loan/sqft, NOI/sqft, expense ratio, cash-on-cash, occupancy.',
+    authors: ['UW Markdown Working Group'],
+    license: 'MIT',
+    requires_protocol: '^1.0.0',
+    requires_format: '^1.1.0',
+    requires_tier: 'tier-3-calc-host',
+    asset_classes: ['office'],
+    calculations: [
+        {
+            id: 'cap_rate',
+            label: 'Cap Rate',
+            formula: 'noi_model.net_operating_income / valuation.purchase_price',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'ltv',
+            label: 'LTV',
+            formula: 'debt_structure.loan_amount / valuation.purchase_price',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'ltc',
+            label: 'LTC',
+            formula: 'debt_structure.loan_amount / sources_uses.uses.total',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'dscr',
+            label: 'DSCR',
+            formula: 'noi_model.net_operating_income / debt_structure.annual_debt_service',
+            unit: 'x',
+            deterministic: true,
+        },
+        {
+            id: 'debt_yield',
+            label: 'Debt Yield',
+            formula: 'noi_model.net_operating_income / debt_structure.loan_amount',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'price_per_sqft',
+            label: 'Price / SqFt',
+            formula: 'valuation.purchase_price / property.rentable_square_feet',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'loan_per_sqft',
+            label: 'Loan / SqFt',
+            formula: 'debt_structure.loan_amount / property.rentable_square_feet',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'noi_per_sqft',
+            label: 'NOI / SqFt',
+            formula: 'noi_model.net_operating_income / property.rentable_square_feet',
+            unit: '$',
+            deterministic: true,
+        },
+        {
+            id: 'expense_ratio',
+            label: 'Operating Expense Ratio',
+            formula: 'noi_model.expenses.total_operating_expenses / noi_model.income.effective_gross_income',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'cash_on_cash',
+            label: 'Cash-on-Cash',
+            formula: '(noi_model.net_operating_income - debt_structure.annual_debt_service) / sources_uses.sources.sponsor_equity',
+            unit: '%',
+            deterministic: true,
+        },
+        {
+            id: 'occupancy',
+            label: 'Occupancy',
+            formula: 'rent_roll.occupied_sf / rent_roll.total_rentable_sf',
+            unit: '%',
+            deterministic: true,
+        },
+    ],
+};
+//# sourceMappingURL=office.js.map

package/dist/packs/office.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"office.js","sourceRoot":"","sources":["../../src/packs/office.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,EAAE;AACF,6EAA6E;AAC7E,kEAAkE;AAClE,2EAA2E;AAC3E,qDAAqD;AACrD,EAAE;AACF,yEAAyE;AACzE,2EAA2E;AAC3E,mEAAmE;AACnE,EAAE;AACF,4EAA4E;AAC5E,6EAA6E;AAC7E,kFAAkF;AAClF,gEAAgE;AAIhE,MAAM,CAAC,MAAM,WAAW,GAAmB;IACzC,gBAAgB,EAAE,GAAG;IACrB,EAAE,EAAE,sBAAsB;IAC1B,IAAI,EAAE,qBAAqB;IAC3B,OAAO,EAAE,OAAO;IAChB,WAAW,EACT,4JAA4J;IAC9J,OAAO,EAAE,CAAC,2BAA2B,CAAC;IACtC,OAAO,EAAE,KAAK;IACd,iBAAiB,EAAE,QAAQ;IAC3B,eAAe,EAAE,QAAQ;IACzB,aAAa,EAAE,kBAAkB;IACjC,aAAa,EAAE,CAAC,QAAQ,CAAC;IACzB,YAAY,EAAE;QACZ;YACE,EAAE,EAAE,UAAU;YACd,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,2DAA2D;YACpE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,uDAAuD;YAChE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,sDAAsD;YAC/D,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,MAAM;YACV,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,qEAAqE;YAC9E,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,YAAY;YAChB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,6DAA6D;YACtE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,gBAAgB;YACpB,KAAK,EAAE,cAAc;YACrB,OAAO,EAAE,0DAA0D;YACnE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,aAAa;YACpB,OAAO,EAAE,4DAA4D;YACrE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,YAAY;YACnB,OAAO,EAAE,gEAAgE;YACzE,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,eAAe;YACnB,KAAK,EAAE,yBAAyB;YAChC,OAAO,EACL,uFAAuF;YACzF,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,cAAc;YAClB,KAAK,EAAE,cAAc;YACrB,OAAO,EACL,6GAA6G;YAC/G,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;QACD;YACE,EAAE,EAAE,WAAW;YACf,KAAK,EAAE,WAAW;YAClB,OAAO,EAAE,qDAAqD;YAC9D,IAAI,EAAE,GAAG;YACT,aAAa,EAAE,IAAI;SACpB;KACF;CACF,CAAC"}

package/dist/packs/retail.d.ts

@@ -0,0 +1,3 @@
+import type { ModuleManifest } from '../protocol.js';
+export declare const RETAIL_PACK: ModuleManifest;
+//# sourceMappingURL=retail.d.ts.map

package/dist/packs/retail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retail.d.ts","sourceRoot":"","sources":["../../src/packs/retail.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,eAAO,MAAM,WAAW,EAAE,cAsGzB,CAAC"}