Previous value: -"Notice period required by the lease, in months, e.g. 2; cannot exceed months_remaining. Default 2 if no break fee, else 0"New value: +"Notice period required by the lease, in months, e.g. 2; cannot exceed months_remaining. Default 2 (capped at months_remaining) if no break fee, else 0"

Previous value: -"Deposit amount credited against the cost"New value: +"Deposit credited against the cost, capped at the cost of the path used for net_break_cost"

Previous value: -"Estimated net cost to break the lease after deposit credit (cheaper of the break-clause and no-clause paths, floored at 0)"New value: +"Estimated net cost to break the lease after deposit credit: with a break fee, the cheaper of the break-clause and no-clause paths; with no break fee, the no-clause path. Floored at 0"

Added value: +{
+  "description": "Which path net_break_cost uses: break_clause (notice rent + break fee + re-letting fee) or no_clause (rent until relet + re-letting fee)",
+  "enum": [
+    "break_clause",
+    "no_clause"
+  ],
+  "type": "string"
+}

Previous value: -"Early-termination fee in months' rent"New value: +"Early-termination (break) fee stated in the lease, in months' rent, e.g. 2. Default 0 = no break clause"

Previous value: -"Currency code in ISO 4217 format"New value: +"ISO 4217 currency code used only to label amounts, e.g. USD, GBP, EUR. Default USD"

Previous value: -"Initial deposit amount as a number"New value: +"Security deposit held by the landlord, non-negative amount, e.g. 2200. Default 0"

Previous value: -"Expected months to relett the property as a number"New value: +"Expected months until a replacement tenant moves in, e.g. 0.5 for about two weeks. Default 1"

Previous value: -"True if landlord mitigates damages, false otherwise"New value: +"Whether the landlord must try to re-let and offset rent (duty to mitigate). Default true; false = liable for all remaining rent"

Previous value: -"Monthly rent"New value: +"Current monthly rent as a positive number in the lease currency, e.g. 2200"

Previous value: -"Months left on the lease (including the current one)"New value: +"Months left on the lease including the current month, positive number, e.g. 7"

Previous value: -"Number of months' notice required to terminate the lease"New value: +"Notice period required by the lease, in months, e.g. 2; cannot exceed months_remaining. Default 2 if no break fee, else 0"

Previous value: -"Fee for reletting the property as a number"New value: +"Fixed re-letting/advertising/cleaning fee stated in the lease, non-negative amount, e.g. 300. Default 0"

Added value: +{
+  "description": "Assumptions applied in the estimate (fee, notice, mitigation, deposit)",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

Removed value: -{
-  "description": "The early-termination fee.",
-  "type": "number"
-}

Added value: +{
+  "description": "Itemised cost components of breaking the lease",
+  "properties": {
+    "break_fee": {
+      "description": "Break fee amount (monthly_rent x break_fee_months)",
+      "type": "number"
+    },
+    "deposit_credit": {
+      "description": "Deposit amount credited against the cost",
+      "type": "number"
+    },
+    "reletting_fee": {
+      "description": "Fixed re-letting fee from the lease",
+      "type": "number"
+    },
+    "rent_during_notice": {
+      "description": "Rent owed for the notice period (monthly_rent x notice_months)",
+      "type": "number"
+    },
+    "rent_until_relet_if_liable": {
+      "description": "Rent owed until a replacement tenant is found (or to lease end if the landlord does not mitigate)",
+      "type": "number"
+    }
+  },
+  "required": [
+    "rent_during_notice",
+    "break_fee",
+    "reletting_fee",
+    "rent_until_relet_if_liable",
+    "deposit_credit"
+  ],
+  "type": "object"
+}

Removed value: -{
-  "description": "A detailed breakdown of the costs.",
-  "items": {
-    "properties": {
-      "amount": {
-        "description": "The amount of the cost item.",
-        "type": "number"
-      },
-      "description": {
-        "description": "A description of the cost item.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "description",
-      "amount"
-    ],
-    "type": "object"
-  },
-  "type": "array"
-}

Previous value: -"The currency in which the costs are calculated."New value: +"Currency code the amounts are labelled in"

Removed value: -{
-  "description": "The amount of deposit that will be returned.",
-  "type": "number"
-}

Added value: +{
+  "description": "Informational, not-legal-advice disclaimer to show with the result",
+  "type": "string"
+}

Added value: +{
+  "description": "Estimated net cost to break the lease after deposit credit (cheaper of the break-clause and no-clause paths, floored at 0)",
+  "type": "number"
+}

Added value: +{
+  "description": "Net cost on the no-break-clause path (rent until relet + re-letting fee, less deposit)",
+  "type": "number"
+}

Removed value: -{
-  "description": "The cost of rent during the notice period.",
-  "type": "number"
-}

Removed value: -{
-  "description": "The fee charged by the landlord or agent for re-letting the property.",
-  "type": "number"
-}

Removed value: -{
-  "description": "The estimated rent cost until the property is re-let.",
-  "type": "number"
-}

Added value: +{
+  "description": "Total rent if the lease is kept to term, for comparison",
+  "type": "number"
+}

Removed value: -{
-  "description": "The total cost of breaking the lease.",
-  "type": "number"
-}

Previous value: -[
-  "total_cost",
-  "notice_period_rent",
-  "break_fee",
-  "reletting_fee",
-  "rent_until_relet",
-  "deposit_credit",
-  "currency",
-  "cost_breakdown"
-]New value: +[
+  "currency",
+  "breakdown",
+  "net_break_cost",
+  "net_without_break_clause",
+  "stay_cost",
+  "assumptions",
+  "disclaimer"
+]

Added value: +"Currency code in ISO 4217 format"

Added value: +"Initial deposit amount as a number"

Added value: +"Expected months to relett the property as a number"

Added value: +"True if landlord mitigates damages, false otherwise"

Added value: +"Number of months' notice required to terminate the lease"

Added value: +"Fee for reletting the property as a number"

Previous value: -nullNew value: +{
+  "properties": {
+    "break_fee": {
+      "description": "The early-termination fee.",
+      "type": "number"
+    },
+    "cost_breakdown": {
+      "description": "A detailed breakdown of the costs.",
+      "items": {
+        "properties": {
+          "amount": {
+            "description": "The amount of the cost item.",
+            "type": "number"
+          },
+          "description": {
+            "description": "A description of the cost item.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "description",
+          "amount"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "currency": {
+      "description": "The currency in which the costs are calculated.",
+      "type": "string"
+    },
+    "deposit_credit": {
+      "description": "The amount of deposit that will be returned.",
+      "type": "number"
+    },
+    "notice_period_rent": {
+      "description": "The cost of rent during the notice period.",
+      "type": "number"
+    },
+    "reletting_fee": {
+      "description": "The fee charged by the landlord or agent for re-letting the property.",
+      "type": "number"
+    },
+    "rent_until_relet": {
+      "description": "The estimated rent cost until the property is re-let.",
+      "type": "number"
+    },
+    "total_cost": {
+      "description": "The total cost of breaking the lease.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "total_cost",
+    "notice_period_rent",
+    "break_fee",
+    "reletting_fee",
+    "rent_until_relet",
+    "deposit_credit",
+    "currency",
+    "cost_breakdown"
+  ],
+  "type": "object"
+}