@pdtf/schemas 3.6.0-30 → 3.6.0-32

package/docs/sef25-extensions-ui-spec.md

@@ -2,13 +2,24 @@
 
 ## Overview
 
-Three new extension overlays add follow-up questions to existing form sections. Each overlay is loaded by passing its key to `getTransactionSchema(schemaId, overlays)`.
+Extension overlays add follow-up questions to existing form sections. Each overlay is loaded by passing its key to `getTransactionSchema(schemaId, overlays)`.
 
 | Overlay Key | Name | Section | Fields Added |
 |-------------|------|---------|-------------|
 | `sc` | Supply Costs | Water & Drainage | 2 cost fields (private water, private sewerage) |
 | `pc` | Parking Permit Cost | Parking | 1 frequency field |
 | `ph` | Property Hazards | Specialist Issues | 4 Yes/No + details fields |
+| `dk` | Dropped Kerb | Parking | 1 Yes/No field |
+| `rw` | Private Right of Way | Rights & Informal Arrangements | 1 Yes/No + details field |
+| `sd` | Storm/Fire/Flood Damage | Environmental Issues | 1 Yes/No + details field |
+| `lc` | Solar Lease Costs | Utilities (Solar Panels) | 1 cost field (amount + frequency) |
+| `wg` | Warranties & Guarantees | Guarantees & Warranties | Marks 7 warranty categories as required |
+| `dc` | Disputes & Complaints | Disputes & Complaints | Marks hasDisputesAndComplaints required |
+| `ic` | Insurance Claims | Insurance | Marks insuranceClaims required (isInsured=Yes branch) |
+| `hf` | Historical Flooding | Environmental Issues | Marks hasBeenFlooded required |
+| `nd` | Neighbour Development | Notices | Marks neighbourDevelopment required |
+| `mi` | Material Issue | Additional Information | Marks otherMaterialIssue required |
+| `tr` | Title Restrictions | Ownership (Freehold) | Adds titleRestrictions field to freehold branch |
 
 All fields use `sef25Ref` for reference codes.
 
@@ -114,6 +125,172 @@ These follow the identical pattern to existing specialist issues (dry rot, asbes
 
 ---
 
+## 4. Dropped Kerb (`dk`)
+
+**Trigger:** Always shown within Parking section.
+
+**Path:** `propertyPack.parking.droppedKerbAccess`
+
+| Field | Path (relative) | Type | Validation | UI Element |
+|-------|-----------------|------|------------|------------|
+| Dropped kerb? | `droppedKerbAccess.yesNo` | `string` | Required, enum | Yes/No radio |
+
+**Ref:** `K1.1` (yesNo: `K1.1.1`)
+
+---
+
+## 5. Private Right of Way (`rw`)
+
+**Trigger:** Always shown within Rights & Informal Arrangements, alongside the existing public right of way question.
+
+**Path:** `propertyPack.rightsAndInformalArrangements.rightsOrArrangements.privateRightOfWay`
+
+**UI:** Same pattern as `publicRightOfWay` — Yes/No, if Yes show details.
+
+| Field | Path (relative) | Type | Validation | UI Element |
+|-------|-----------------|------|------------|------------|
+| Private ROW? | `privateRightOfWay.yesNo` | `string` | Required, enum | Yes/No radio |
+| Details | `privateRightOfWay.details` | `string` | Required when Yes, minLength 1 | Text input |
+
+**Ref:** `R1.1` (yesNo: `R1.1.1`, details: `R1.1.2`)
+
+### Data shape
+
+```json
+// When "No":
+{ "yesNo": "No" }
+
+// When "Yes":
+{ "yesNo": "Yes", "details": "Description of private right of way..." }
+```
+
+---
+
+## 6. Storm, Fire or Flood Damage (`sd`)
+
+**Trigger:** Always shown within Environmental Issues section.
+
+**Path:** `propertyPack.environmentalIssues.stormFireFloodDamage`
+
+**UI:** Yes/No, if Yes show details. Render under "Environmental & Structural Information" or "Specialist Issues".
+
+| Field | Path (relative) | Type | Validation | UI Element |
+|-------|-----------------|------|------------|------------|
+| Damage? | `stormFireFloodDamage.yesNo` | `string` | Required, enum | Yes/No radio |
+| Details | `stormFireFloodDamage.details` | `string` | Required when Yes, minLength 1 | Text area |
+
+**Ref:** `E1.1` (yesNo: `E1.1.1`, details: `E1.1.2`)
+
+### Data shape
+
+```json
+// When "No":
+{ "yesNo": "No" }
+
+// When "Yes":
+{ "yesNo": "Yes", "details": "Details of storm/fire/flood damage..." }
+```
+
+---
+
+## 7. Solar Panel Lease Costs (`lc`)
+
+**Trigger:** Show when `propertyPack.utilities.solarPanels.panelsOwnedOutright.yesNo` = `"No"` (panels are leased).
+
+**Path:** `propertyPack.utilities.solarPanels.panelsOwnedOutright.associatedCost`
+
+**UI:** Render alongside existing lease details. First ask if there are costs, then show amount and frequency if Yes.
+
+| Field | Path (relative) | Type | Validation | UI Element |
+|-------|-----------------|------|------------|------------|
+| Has costs? | `associatedCost.hasCost` | `string` | Required, enum | Yes/No radio |
+| Amount (£) | `associatedCost.amount` | `number` | Required when Yes | Numeric input |
+| Frequency | `associatedCost.frequency` | `string` | Required when Yes, enum | Dropdown |
+
+**Frequency enum values:** `"Per month"`, `"Per year"`
+
+**Ref:** `S1.1` (hasCost: `S1.1.1`, amount: `S1.1.2`, frequency: `S1.1.3`)
+
+### Data shape
+
+```json
+// When no costs:
+{ "hasCost": "No" }
+
+// When costs exist:
+{ "hasCost": "Yes", "amount": 50, "frequency": "Per month" }
+```
+
+---
+
+## 8. Warranties & Guarantees Upfront (`wg`)
+
+**Trigger:** Always shown when overlay is loaded. Displayed upfront regardless of `hasValidGuaranteesOrWarranties` value.
+
+**Path prefix:** `propertyPack.guaranteesWarrantiesAndIndemnityInsurances`
+
+**UI:** For SEF25 upfront, show all 7 warranty categories as simple Yes/No questions. No details or "Years Remaining" needed at this stage — the law firm picks up details later.
+
+### Fields (all Yes/No only)
+
+| Property | Title | sef25Ref |
+|----------|-------|----------|
+| `newHomeWarranty` | New Home Warranty (NHBC or similar) | W1.1 |
+| `roofingWork` | Roofing work | W1.2 |
+| `dampProofingTreatment` | Damp proofing treatment | W1.3 |
+| `centralHeatingAndorPlumbing` | Central heating and/or plumbing | W1.4 |
+| `electricalRepairOrInstallation` | Electrical repair or installation | W1.5 |
+| `subsidenceWork` | Underpinning or other preventative work / remedial action relating to subsidence | W1.6 |
+| `otherGuarantees` | Other Guarantees or warranties | W1.7 |
+
+**Note:** These fields already exist in the base schema under the `hasValidGuaranteesOrWarranties = "Yes"` branch. The `wg` overlay marks them as required within that branch. The Moverly app shows them upfront for SEF25 users without requiring the parent gate question first.
+
+---
+
+## 9. Upfront Existing Fields
+
+The following existing fields have extension overlays that add `sef25Ref` and `required` arrays, making them selectively available for SEF25 upfront forms.
+
+### Disputes & Complaints (`dc`)
+
+**Path:** `propertyPack.disputesAndComplaints.hasDisputesAndComplaints`
+
+**Ref:** `D1.1` — "Have any disputes or complaints occurred, regarding this property, a property nearby, or their use?"
+
+### Insurance Claims (`ic`)
+
+**Path:** `propertyPack.insurance.insuranceClaims` (inside `isInsured = "Yes"` branch)
+
+**Ref:** `I1.1` — "Have you made any buildings insurance claims?"
+
+**Note:** The field is inside the `isInsured = "Yes"` oneOf branch. The overlay marks it required within that branch.
+
+### Historical Flooding (`hf`)
+
+**Path:** `propertyPack.environmentalIssues.flooding.historicalFlooding.hasBeenFlooded`
+
+**Ref:** `E1.2` — "Has the property been flooded in the last 5 years?"
+
+### Neighbour Development (`nd`)
+
+**Path:** `propertyPack.notices.neighbourDevelopment`
+
+**Ref:** `N1.1` — "Is the seller aware of any proposals to develop property or land nearby?"
+
+### Material Issue (`mi`)
+
+**Path:** `propertyPack.additionalInformation.otherMaterialIssue`
+
+**Ref:** `M1.1` — "Are you aware of any other material issue or information which may affect the average person's decision to proceed?"
+
+### Title Restrictions (`tr`)
+
+**Path:** `propertyPack.ownership.ownershipsToBeTransferred[Freehold].titleRestrictions`
+
+**Ref:** `T1.1` — "Are there any known restrictions on the title?" (Yes/No + details if Yes, modelled on `leaseRestrictions` for leasehold)
+
+---
+
 ## Loading the Extensions
 
 ```js
@@ -121,14 +298,15 @@ import { getTransactionSchema, getValidator } from "@pdtf/schemas";
 
 const schemaId = "https://trust.propdata.org.uk/schemas/v3/pdtf-transaction.json";
 
-// Load with one or more SEF25 extensions
-const schema = getTransactionSchema(schemaId, ["sc", "pc", "ph"]);
+// Load all SEF25 extensions
+const sef25Extensions = ["sc", "pc", "ph", "dk", "rw", "sd", "lc", "wg", "ic", "nd", "mi", "tr"];
+const schema = getTransactionSchema(schemaId, sef25Extensions);
 
 // Or combine with other overlays
-const schema = getTransactionSchema(schemaId, ["baspiV5", "sc", "pc", "ph"]);
+const schema = getTransactionSchema(schemaId, ["baspiV5", ...sef25Extensions]);
 
 // Validate data against the merged schema
-const validator = getValidator(schemaId, ["sc", "pc", "ph"]);
+const validator = getValidator(schemaId, sef25Extensions);
 ```
 
 ---
@@ -144,3 +322,94 @@ const validator = getValidator(schemaId, ["sc", "pc", "ph"]);
 | Damaged electrics | Always (within Specialist Issues) |
 | Flooring/staircase damage | Always (within Specialist Issues) |
 | Areas in poor condition | Always (within Specialist Issues) |
+| Dropped kerb access | Always (within Parking) |
+| Private right of way | Always (within Rights & Informal Arrangements) |
+| Storm/fire/flood damage | Always (within Environmental Issues) |
+| Solar panel lease costs | `panelsOwnedOutright.yesNo` = `"No"` |
+| Warranty categories (7) | Always when `wg` overlay loaded (within Guarantees & Warranties) |
+| Insurance claims | `isInsured.yesNo` = `"Yes"` (via `ic` overlay) |
+| Neighbour development | Always (via `nd` overlay) |
+| Other material issue | Always (via `mi` overlay) |
+| Title restrictions | Always (via `tr` overlay) |
+
+---
+
+## Moverly propertyPackTasks Changes
+
+The following changes are needed in the Moverly app's `propertyPackTasks` configuration to surface the new SEF25 fields in the listing journey.
+
+### Existing tasks to deprecate
+
+The flooding and planning tasks should be stepped up to their parent section level to cover the new sibling fields (`stormFireFloodDamage` and `neighbourDevelopment`).
+
+```js
+// Replace existing flooding task with deprecated version
+{
+  name: "Flooding",
+  path: "/propertyPack/environmentalIssues/flooding",
+  category: "listing",
+  overlay: "nts2023",
+  deprecated: true, // replaced by environmental issues check
+},
+
+// Replace existing planning task with deprecated version
+{
+  name: "Planning and development",
+  path: "/propertyPack/notices/planningApplication",
+  category: "listing",
+  overlay: "nts2023",
+  deprecated: true, // replaced by notices check
+},
+```
+
+### New listing tasks to add
+
+```js
+{
+  name: "Environmental issues",
+  checkName: "sef25-environmentalIssues",
+  path: "/propertyPack/environmentalIssues",
+  category: "listing",
+  overlay: "sd",
+},
+{
+  name: "Notices",
+  checkName: "sef25-notices",
+  path: "/propertyPack/notices",
+  category: "listing",
+  overlay: "nd",
+},
+{
+  name: "Guarantees & warranties",
+  checkName: "sef25-warranties",
+  path: "/propertyPack/guaranteesWarrantiesAndIndemnityInsurances",
+  category: "listing",
+  overlay: "wg",
+},
+{
+  name: "Insurance claims",
+  checkName: "sef25-insurance",
+  path: "/propertyPack/insurance",
+  category: "listing",
+  overlay: "ic",
+},
+{
+  name: "Material information",
+  checkName: "sef25-additionalInformation",
+  path: "/propertyPack/additionalInformation",
+  category: "listing",
+  overlay: "mi",
+},
+```
+
+### Fields covered by existing listing tasks (no new task needed)
+
+| Extension | Covered by |
+|-----------|------------|
+| `dk` (dropped kerb) | Parking |
+| `rw` (private right of way) | Rights and easements |
+| `lc` (solar lease costs) | Electricity |
+| `sc` (supply costs) | Water and drainage |
+| `pc` (parking permit cost) | Parking |
+| `ph` (property hazards) | Specialist issues |
+| `tr` (title restrictions) | Ownership |

package/index.js

@@ -57,6 +57,15 @@ const extensionOverlays = {
   sc: require("./src/schemas/v3/overlays/extensions/sc.json"),
   pc: require("./src/schemas/v3/overlays/extensions/pc.json"),
   ph: require("./src/schemas/v3/overlays/extensions/ph.json"),
+  dk: require("./src/schemas/v3/overlays/extensions/dk.json"),
+  rw: require("./src/schemas/v3/overlays/extensions/rw.json"),
+  sd: require("./src/schemas/v3/overlays/extensions/sd.json"),
+  lc: require("./src/schemas/v3/overlays/extensions/lc.json"),
+  wg: require("./src/schemas/v3/overlays/extensions/wg.json"),
+  ic: require("./src/schemas/v3/overlays/extensions/ic.json"),
+  nd: require("./src/schemas/v3/overlays/extensions/nd.json"),
+  mi: require("./src/schemas/v3/overlays/extensions/mi.json"),
+  tr: require("./src/schemas/v3/overlays/extensions/tr.json"),
 };
 
 const overlaysMap = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdtf/schemas",
-  "version": "3.6.0-30",
+  "version": "3.6.0-32",
   "description": "Property Data Trust Framework Schemas and Utilities",
   "main": "index.js",
   "directories": {