@uwmd/core 1.1.0

package/dist/valuation.js

@@ -0,0 +1,34 @@
+// Deterministic income-approach footing — when the valuation block carries an
+// income_approach with a chosen NOI and applied cap rate, the indicated value
+// (and its delta to purchase price) foot from them: value = NOI / cap rate. One
+// source of truth so the editor, CLI, and Excel converter never disagree
+// (invariant #4); plain arithmetic, not AI math (invariant #1).
+//
+// Scope is deliberately narrow and self-contained: only the relationships that
+// live entirely inside the valuation block are footed. The NOI to capitalize is
+// the underwriter's stored choice (`income_approach.noi_used`), not pulled from
+// another section, and per-unit / per-sqft values (which need the property
+// section) are left as inputs. Blocks without an income_approach (e.g. a flat
+// office appraisal block) simply foot nothing.
+import { collector, numOrNull } from './derived.js';
+const num = numOrNull;
+const isObj = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+/** Foot a valuation content block. Pure: never mutates `content`. */
+export function deriveValuation(content) {
+    const c = collector();
+    const ia = isObj(content['income_approach']) ? content['income_approach'] : null;
+    if (!ia)
+        return { fields: c.fields };
+    const noi = num(ia['noi_used']);
+    const cap = num(ia['cap_rate_applied']);
+    if (noi == null || cap == null || cap <= 0)
+        return { fields: c.fields };
+    const indicated = noi / cap;
+    c.add('income_approach.indicated_value', 'Indicated Value (income approach)', 'currency', indicated);
+    const purchase = num(content['purchase_price']);
+    if (purchase != null && purchase > 0) {
+        c.add('uw_value_vs_purchase_price_pct', 'UW Value vs. Purchase Price', 'rate', indicated / purchase - 1);
+    }
+    return { fields: c.fields };
+}
+//# sourceMappingURL=valuation.js.map

package/dist/valuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valuation.js","sourceRoot":"","sources":["../src/valuation.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAChF,yEAAyE;AACzE,gEAAgE;AAChE,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,2EAA2E;AAC3E,8EAA8E;AAC9E,+CAA+C;AAE/C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAqB,MAAM,cAAc,CAAC;AAIvE,MAAM,GAAG,GAAG,SAAS,CAAC;AACtB,MAAM,KAAK,GAAG,CAAC,CAAU,EAAY,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAMjG,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,OAAY;IAC1C,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAErC,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACxC,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;IAExE,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;IAC5B,CAAC,CAAC,GAAG,CAAC,iCAAiC,EAAE,mCAAmC,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAErG,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAChD,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACrC,CAAC,CAAC,GAAG,CACH,gCAAgC,EAChC,6BAA6B,EAC7B,MAAM,EACN,SAAS,GAAG,QAAQ,GAAG,CAAC,CACzB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@uwmd/core",
+  "version": "1.1.0",
+  "description": "Reference implementation of the UW Markdown standard — parser, validator, renderer, and CLI for .uw.md underwriting files.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jaredmaxey/uw-markdown.git",
+    "directory": "packages/uwmd-core"
+  },
+  "homepage": "https://uwmd.org",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/browser.js",
+      "types": "./dist/browser.d.ts"
+    },
+    "./cli": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "!dist/**/*.test.*",
+    "!dist/**/*.property.test.*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "parse": "node dist/cli.js parse",
+    "validate": "node dist/cli.js validate",
+    "summary": "node dist/cli.js summary",
+    "prepublishOnly": "npm run build && npm test && npm --prefix ../.. run conformance && npm --prefix ../.. run validate-schemas"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^3.2.6",
+    "fast-check": "^3.23.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.2.6"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "@anthropic-ai/sdk": "^0.91.1",
+    "fast-xml-parser": "^5.10.1",
+    "fflate": "^0.8.3"
+  }
+}