@vepler/sdk 3.3.0 → 5.28.1

package/src/sdk/models/shared/epcdata.ts

@@ -10,7 +10,7 @@ import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * Certificate type
+ * Which kind of certificate this is: domestic, non-domestic, or a display energy certificate.
  */
 export const CertificateType = {
   Domestic: "domestic",
@@ -18,12 +18,12 @@ export const CertificateType = {
   Dec: "dec",
 } as const;
 /**
- * Certificate type
+ * Which kind of certificate this is: domestic, non-domestic, or a display energy certificate.
  */
 export type CertificateType = OpenEnum<typeof CertificateType>;
 
 /**
- * Current EPC rating band
+ * Energy efficiency band on the current certificate, where A+ and A are the most efficient and G the least.
  */
 export const CurrentRatingBand = {
   APlus: "A+",
@@ -41,78 +41,78 @@ export const CurrentRatingBand = {
   G: "G",
 } as const;
 /**
- * Current EPC rating band
+ * Energy efficiency band on the current certificate, where A+ and A are the most efficient and G the least.
  */
 export type CurrentRatingBand = OpenEnum<typeof CurrentRatingBand>;
 
 /**
- * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+ * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
  */
 export const Co2Unit = {
   TonnesPerYear: "tonnes_per_year",
   KgCo2PerM2PerYear: "kg_co2_per_m2_per_year",
 } as const;
 /**
- * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+ * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
  */
 export type Co2Unit = OpenEnum<typeof Co2Unit>;
 
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export const EnergyConsumptionUnit = {
   KwhPerYear: "kwh_per_year",
   KwhPerM2PerYear: "kwh_per_m2_per_year",
 } as const;
 /**
- * Unit of energyConsumptionCurrent measurement.
+ * The unit `energyConsumptionCurrent` is expressed in.
  */
 export type EnergyConsumptionUnit = OpenEnum<typeof EnergyConsumptionUnit>;
 
 /**
- * Environmental impact, CO2, energy consumption
+ * Environmental impact, carbon dioxide emissions and energy consumption from the certificate.
  */
 export type Emissions = {
   /**
-   * Current annual CO2 emissions. Domestic: tonnes/year. Non-domestic: kg CO2/m²/year (building emission rate). Check co2Unit for the measurement unit.
+   * Annual carbon dioxide emissions at the assessed efficiency. Domestic certificates report tonnes per year and non-domestic certificates report kg CO2 per m² per year; read `co2Unit` for the unit that applies to this record.
    */
   co2Current?: number | null | undefined;
   /**
-   * CO2 intensity per unit floor area (kg CO2/m²/year). Directly reported for domestic (CO2_EMISS_CURR_PER_FLOOR_AREA). For non-domestic, this equals BUILDING_EMISSIONS.
+   * Annual carbon dioxide emissions per square metre of floor area, in kg CO2 per m² per year. On non-domestic certificates this is the building emission rate.
    */
   co2PerFloorArea?: number | null | undefined;
   /**
-   * Achievable CO2 emissions after improvements. Domestic only; null for non-domestic and DECs.
+   * Annual carbon dioxide emissions once the recommended improvements are carried out. Domestic only; null on non-domestic certificates and Display Energy Certificates.
    */
   co2Potential?: number | null | undefined;
   /**
-   * Unit of co2Current measurement. Domestic: tonnes_per_year. Non-domestic/DEC: kg_co2_per_m2_per_year.
+   * The unit `co2Current` is expressed in. Domestic certificates use `tonnes_per_year`; non-domestic certificates and Display Energy Certificates use `kg_co2_per_m2_per_year`.
    */
   co2Unit?: Co2Unit | undefined;
   /**
-   * Current annual energy consumption. Domestic: kWh/year. Non-domestic: kWh/m²/year (PRIMARY_ENERGY_VALUE). Check energyConsumptionUnit for measurement unit.
+   * Annual energy consumption at the assessed efficiency. Domestic certificates report kWh per year and non-domestic certificates report kWh per m² per year; read `energyConsumptionUnit` for the unit that applies to this record.
    */
   energyConsumptionCurrent?: number | null | undefined;
   /**
-   * Achievable energy consumption. Domestic only.
+   * Annual energy consumption once the recommended improvements are carried out. Domestic only.
    */
   energyConsumptionPotential?: number | null | undefined;
   /**
-   * Unit of energyConsumptionCurrent measurement.
+   * The unit `energyConsumptionCurrent` is expressed in.
    */
   energyConsumptionUnit?: EnergyConsumptionUnit | null | undefined;
   /**
-   * Environmental impact score (1-100, higher is better). Domestic only.
+   * Environmental impact score from 1 to 100, where higher is better. Domestic only.
    */
   environmentalScoreCurrent?: number | null | undefined;
   /**
-   * Achievable environmental impact score. Domestic only.
+   * The environmental impact score the property would reach once the recommended improvements are carried out, on the same 1 to 100 scale. Domestic only.
    */
   environmentalScorePotential?: number | null | undefined;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EnergyEfficiency = {
   VeryGood: "very_good",
@@ -122,12 +122,12 @@ export const EnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EnergyEfficiency = OpenEnum<typeof EnergyEfficiency>;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -137,30 +137,30 @@ export const EnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EnvironmentalEfficiency = OpenEnum<typeof EnvironmentalEfficiency>;
 
 /**
- * Air tightness assessment. Scotland only; null for E&W.
+ * The air tightness assessment. Scotland only; null on England and Wales certificates.
  */
 export type AirTightness = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency?: EnergyEfficiency | null | undefined;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?: EnvironmentalEfficiency | null | undefined;
 };
 
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCDataSchemasFabricFloorDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -170,14 +170,14 @@ export const EPCDataSchemasFabricFloorDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataSchemasFabricFloorDataQuality = OpenEnum<
   typeof EPCDataSchemasFabricFloorDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export const EPCDataEnergyEfficiency = {
   VeryGood: "very_good",
@@ -187,12 +187,12 @@ export const EPCDataEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the floor is, on the certificate's five-point scale.
  */
 export type EPCDataEnergyEfficiency = OpenEnum<typeof EPCDataEnergyEfficiency>;
 
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -202,14 +202,14 @@ export const EPCDataEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the floor scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataEnvironmentalEfficiency
 >;
 
 /**
- * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+ * How the ground floor is built, including the cases where another dwelling or premises sits below.
  */
 export const FloorType = {
   Solid: "solid",
@@ -219,12 +219,12 @@ export const FloorType = {
   OtherPremisesBelow: "other_premises_below",
 } as const;
 /**
- * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+ * How the ground floor is built, including the cases where another dwelling or premises sits below.
  */
 export type FloorType = OpenEnum<typeof FloorType>;
 
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export const InsulationType = {
   None: "none",
@@ -240,54 +240,54 @@ export const InsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type if present.
+ * How the floor is insulated, where insulation is present.
  */
 export type InsulationType = OpenEnum<typeof InsulationType>;
 
 /**
- * Ground floor construction and insulation.
+ * The ground floor and its insulation.
  */
 export type Floor = {
   /**
-   * Non-null when source value was corrupted/incomplete.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality?: EPCDataSchemasFabricFloorDataQuality | null | undefined;
   /**
-   * Raw SAP description string.
+   * The assessor's own description of the floor, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the floor is, on the certificate's five-point scale.
    */
   energyEfficiency?: EPCDataEnergyEfficiency | null | undefined;
   /**
-   * Environmental efficiency rating.
+   * How the floor scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?: EPCDataEnvironmentalEfficiency | null | undefined;
   /**
-   * Floor type: solid, suspended_timber, suspended_sealed, another_dwelling_below, other_premises_below.
+   * How the ground floor is built, including the cases where another dwelling or premises sits below.
    */
   floorType?: FloorType | null | undefined;
   /**
-   * Whether insulation status is assumed.
+   * True when the assessor assumed the insulation rather than confirming it.
    */
   insulationAssumed?: boolean | undefined;
   /**
-   * Whether floor insulation is present.
+   * True when the floor is insulated.
    */
   insulationPresent?: boolean | null | undefined;
   /**
-   * Insulation type if present.
+   * How the floor is insulated, where insulation is present.
    */
   insulationType?: InsulationType | null | undefined;
   /**
-   * U-value in W/m²K if reported.
+   * Thermal transmittance (U-value) of the floor, in W/m²K, where the assessment reports one.
    */
   thermalTransmittance?: number | null | undefined;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCDataSchemasEnergyEfficiency = {
   VeryGood: "very_good",
@@ -297,14 +297,14 @@ export const EPCDataSchemasEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -314,26 +314,26 @@ export const EPCDataSchemasEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataSchemasEnvironmentalEfficiency
 >;
 
 /**
- * Heating control system.
+ * How the heating is controlled.
  */
 export type HeatingControls = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency?: EPCDataSchemasEnergyEfficiency | null | undefined;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasEnvironmentalEfficiency
@@ -342,7 +342,7 @@ export type HeatingControls = {
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricEnergyEfficiency = {
   VeryGood: "very_good",
@@ -352,14 +352,14 @@ export const EPCDataSchemasFabricEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -369,26 +369,26 @@ export const EPCDataSchemasFabricEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricEnvironmentalEfficiency
 >;
 
 /**
- * Hot water system.
+ * The hot water system.
  */
 export type HotWater = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency?: EPCDataSchemasFabricEnergyEfficiency | null | undefined;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasFabricEnvironmentalEfficiency
@@ -397,7 +397,7 @@ export type HotWater = {
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricLightingEnergyEfficiency = {
   VeryGood: "very_good",
@@ -407,14 +407,14 @@ export const EPCDataSchemasFabricLightingEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricLightingEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricLightingEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricLightingEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -424,29 +424,29 @@ export const EPCDataSchemasFabricLightingEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricLightingEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricLightingEnvironmentalEfficiency
 >;
 
 /**
- * Lighting system.
+ * The lighting installed.
  */
 export type Lighting = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency?:
     | EPCDataSchemasFabricLightingEnergyEfficiency
     | null
     | undefined;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasFabricLightingEnvironmentalEfficiency
@@ -455,7 +455,7 @@ export type Lighting = {
 };
 
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCDataDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -465,12 +465,12 @@ export const EPCDataDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataDataQuality = OpenEnum<typeof EPCDataDataQuality>;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricMainHeatingEnergyEfficiency = {
   VeryGood: "very_good",
@@ -480,14 +480,14 @@ export const EPCDataSchemasFabricMainHeatingEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the heating system is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricMainHeatingEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricMainHeatingEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How the heating system scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -497,14 +497,14 @@ export const EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the heating system scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency
 >;
 
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export const Fuel = {
   MainsGas: "mains_gas",
@@ -523,12 +523,12 @@ export const Fuel = {
   Other: "other",
 } as const;
 /**
- * Fuel type for this heating system.
+ * The fuel this heating system runs on.
  */
 export type Fuel = OpenEnum<typeof Fuel>;
 
 /**
- * Heat pump type if applicable: air_source, ground_source, water_source.
+ * Where the heat pump draws its heat from, where the system is a heat pump.
  */
 export const HeatPumpType = {
   AirSource: "air_source",
@@ -536,12 +536,12 @@ export const HeatPumpType = {
   WaterSource: "water_source",
 } as const;
 /**
- * Heat pump type if applicable: air_source, ground_source, water_source.
+ * Where the heat pump draws its heat from, where the system is a heat pump.
  */
 export type HeatPumpType = OpenEnum<typeof HeatPumpType>;
 
 /**
- * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+ * What kind of main heating system is installed.
  */
 export const SystemType = {
   BoilerRadiators: "boiler_radiators",
@@ -557,56 +557,56 @@ export const SystemType = {
   NoneAssumed: "none_assumed",
 } as const;
 /**
- * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+ * What kind of main heating system is installed.
  */
 export type SystemType = OpenEnum<typeof SystemType>;
 
 /**
- * Main heating system.
+ * The main heating system.
  */
 export type MainHeating = {
   /**
-   * Non-null when source value was corrupted/incomplete.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality?: EPCDataDataQuality | null | undefined;
   /**
-   * Raw SAP description string.
+   * The assessor's own description of the heating system, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the heating system is, on the certificate's five-point scale.
    */
   energyEfficiency?:
     | EPCDataSchemasFabricMainHeatingEnergyEfficiency
     | null
     | undefined;
   /**
-   * Environmental efficiency rating.
+   * How the heating system scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasFabricMainHeatingEnvironmentalEfficiency
     | null
     | undefined;
   /**
-   * Fuel type for this heating system.
+   * The fuel this heating system runs on.
    */
   fuel?: Fuel | null | undefined;
   /**
-   * Heat pump type if applicable: air_source, ground_source, water_source.
+   * Where the heat pump draws its heat from, where the system is a heat pump.
    */
   heatPumpType?: HeatPumpType | null | undefined;
   /**
-   * Whether this property has multiple heating systems.
+   * True when the certificate records more than one heating system.
    */
   isMultiSystem?: boolean | undefined;
   /**
-   * Heating system type: boiler_radiators, storage_heaters, heat_pump_radiators, etc.
+   * What kind of main heating system is installed.
    */
   systemType?: SystemType | null | undefined;
 };
 
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCDataSchemasDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -616,14 +616,14 @@ export const EPCDataSchemasDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when source value was corrupted/incomplete.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataSchemasDataQuality = OpenEnum<
   typeof EPCDataSchemasDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricRoofEnergyEfficiency = {
   VeryGood: "very_good",
@@ -633,14 +633,14 @@ export const EPCDataSchemasFabricRoofEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the roof is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricRoofEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricRoofEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricRoofEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -650,14 +650,14 @@ export const EPCDataSchemasFabricRoofEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the roof scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricRoofEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricRoofEnvironmentalEfficiency
 >;
 
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export const EPCDataInsulationType = {
   None: "none",
@@ -673,12 +673,12 @@ export const EPCDataInsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type: loft, rafter, none, etc.
+ * How the roof is insulated, if at all.
  */
 export type EPCDataInsulationType = OpenEnum<typeof EPCDataInsulationType>;
 
 /**
- * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+ * How the roof is built, including the cases where another dwelling or premises sits above.
  */
 export const RoofType = {
   Pitched: "pitched",
@@ -689,64 +689,64 @@ export const RoofType = {
   RoofRoom: "roof_room",
 } as const;
 /**
- * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+ * How the roof is built, including the cases where another dwelling or premises sits above.
  */
 export type RoofType = OpenEnum<typeof RoofType>;
 
 /**
- * Roof construction and insulation.
+ * The roof and its insulation.
  */
 export type EPCDataRoof = {
   /**
-   * Non-null when source value was corrupted/incomplete.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality?: EPCDataSchemasDataQuality | null | undefined;
   /**
-   * Raw SAP description string.
+   * The assessor's own description of the roof, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the roof is, on the certificate's five-point scale.
    */
   energyEfficiency?:
     | EPCDataSchemasFabricRoofEnergyEfficiency
     | null
     | undefined;
   /**
-   * Environmental efficiency rating.
+   * How the roof scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasFabricRoofEnvironmentalEfficiency
     | null
     | undefined;
   /**
-   * Whether insulation status is assumed.
+   * True when the assessor assumed the insulation rather than confirming it.
    */
   insulationAssumed?: boolean | undefined;
   /**
-   * Loft insulation depth in millimetres.
+   * Depth of the loft insulation, in millimetres.
    */
   insulationDepthMm?: number | null | undefined;
   /**
-   * Whether roof insulation is present.
+   * True when the roof is insulated.
    */
   insulationPresent?: boolean | null | undefined;
   /**
-   * Insulation type: loft, rafter, none, etc.
+   * How the roof is insulated, if at all.
    */
   insulationType?: EPCDataInsulationType | null | undefined;
   /**
-   * Roof type: pitched, flat, thatched, another_dwelling_above, other_premises_above, roof_room.
+   * How the roof is built, including the cases where another dwelling or premises sits above.
    */
   roofType?: RoofType | null | undefined;
   /**
-   * U-value in W/m²K if reported.
+   * Thermal transmittance (U-value) of the roof, in W/m²K, where the assessment reports one.
    */
   thermalTransmittance?: number | null | undefined;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency = {
   VeryGood: "very_good",
@@ -756,14 +756,14 @@ export const EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -773,28 +773,28 @@ export const EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency =
   OpenEnum<typeof EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency>;
 
 /**
- * Secondary heating system. Null when no secondary heating is present.
+ * Any secondary heating system. Null when the property has none.
  */
 export type SecondaryHeating = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency?:
     | EPCDataSchemasFabricSecondaryHeatingEnergyEfficiency
     | null
     | undefined;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasFabricSecondaryHeatingEnvironmentalEfficiency
@@ -803,7 +803,7 @@ export type SecondaryHeating = {
 };
 
 /**
- * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+ * How the external walls are built.
  */
 export const EPCDataConstruction = {
   Cavity: "cavity",
@@ -821,12 +821,12 @@ export const EPCDataConstruction = {
   CurtainWall: "curtain_wall",
 } as const;
 /**
- * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+ * How the external walls are built.
  */
 export type EPCDataConstruction = OpenEnum<typeof EPCDataConstruction>;
 
 /**
- * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export const EPCDataSchemasFabricDataQuality = {
   TruncatedThermalTransmittance: "truncated_thermal_transmittance",
@@ -836,14 +836,14 @@ export const EPCDataSchemasFabricDataQuality = {
   SourceError: "source_error",
 } as const;
 /**
- * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+ * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
  */
 export type EPCDataSchemasFabricDataQuality = OpenEnum<
   typeof EPCDataSchemasFabricDataQuality
 >;
 
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricWallsEnergyEfficiency = {
   VeryGood: "very_good",
@@ -853,14 +853,14 @@ export const EPCDataSchemasFabricWallsEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient the walls are, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWallsEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricWallsEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricWallsEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -870,14 +870,14 @@ export const EPCDataSchemasFabricWallsEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How the walls score for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWallsEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricWallsEnvironmentalEfficiency
 >;
 
 /**
- * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+ * How the walls are insulated, if at all.
  */
 export const EPCDataSchemasInsulationType = {
   None: "none",
@@ -893,66 +893,66 @@ export const EPCDataSchemasInsulationType = {
   Rafter: "rafter",
 } as const;
 /**
- * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+ * How the walls are insulated, if at all.
  */
 export type EPCDataSchemasInsulationType = OpenEnum<
   typeof EPCDataSchemasInsulationType
 >;
 
 /**
- * External wall construction and insulation.
+ * The external walls and their insulation.
  */
 export type Walls = {
   /**
-   * Wall construction type: cavity, solid_brick, timber_frame, sandstone_or_limestone, etc.
+   * How the external walls are built.
    */
   construction?: EPCDataConstruction | null | undefined;
   /**
-   * Non-null when the source value was corrupted/incomplete. Null = normal quality.
+   * Set when the source value could not be read as recorded, giving the reason. Null when the value came through intact.
    */
   dataQuality?: EPCDataSchemasFabricDataQuality | null | undefined;
   /**
-   * Raw SAP description string from assessor.
+   * The assessor's own description of the walls, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient the walls are, on the certificate's five-point scale.
    */
   energyEfficiency?:
     | EPCDataSchemasFabricWallsEnergyEfficiency
     | null
     | undefined;
   /**
-   * Environmental efficiency rating.
+   * How the walls score for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasFabricWallsEnvironmentalEfficiency
     | null
     | undefined;
   /**
-   * Whether insulation status is assumed by the assessor (true) or confirmed (false).
+   * True when the assessor assumed the insulation rather than confirming it.
    */
   insulationAssumed?: boolean | undefined;
   /**
-   * Whether wall insulation is present.
+   * True when the walls are insulated.
    */
   insulationPresent?: boolean | null | undefined;
   /**
-   * Insulation type: none, filled_cavity, external, internal, as_built, partial, etc.
+   * How the walls are insulated, if at all.
    */
   insulationType?: EPCDataSchemasInsulationType | null | undefined;
   /**
-   * Wall material (e.g. 'brick') where identifiable from description.
+   * The wall material, for example 'brick', where the assessor's description identifies one.
    */
   material?: string | null | undefined;
   /**
-   * U-value in W/m²K if reported. Newer SAP versions report this instead of description text.
+   * Thermal transmittance (U-value) of the walls, in W/m²K, where the assessment reports one.
    */
   thermalTransmittance?: number | null | undefined;
 };
 
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricWindowsEnergyEfficiency = {
   VeryGood: "very_good",
@@ -962,14 +962,14 @@ export const EPCDataSchemasFabricWindowsEnergyEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Energy efficiency rating.
+ * How energy efficient this component is, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWindowsEnergyEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricWindowsEnergyEfficiency
 >;
 
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export const EPCDataSchemasFabricWindowsEnvironmentalEfficiency = {
   VeryGood: "very_good",
@@ -979,29 +979,29 @@ export const EPCDataSchemasFabricWindowsEnvironmentalEfficiency = {
   VeryPoor: "very_poor",
 } as const;
 /**
- * Environmental efficiency rating.
+ * How this component scores for environmental impact, on the certificate's five-point scale.
  */
 export type EPCDataSchemasFabricWindowsEnvironmentalEfficiency = OpenEnum<
   typeof EPCDataSchemasFabricWindowsEnvironmentalEfficiency
 >;
 
 /**
- * Window glazing specification.
+ * The windows and their glazing.
  */
 export type Windows = {
   /**
-   * SAP description string from assessor.
+   * The assessor's own description of this component, as written on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Energy efficiency rating.
+   * How energy efficient this component is, on the certificate's five-point scale.
    */
   energyEfficiency?:
     | EPCDataSchemasFabricWindowsEnergyEfficiency
     | null
     | undefined;
   /**
-   * Environmental efficiency rating.
+   * How this component scores for environmental impact, on the certificate's five-point scale.
    */
   environmentalEfficiency?:
     | EPCDataSchemasFabricWindowsEnvironmentalEfficiency
@@ -1010,68 +1010,69 @@ export type Windows = {
 };
 
 /**
- * Building fabric assessment (domestic only)
+ * Component-by-component assessment of the building, covering walls, roof, floor, windows and more. Domestic certificates only.
  */
 export type Fabric = {
   /**
-   * Air tightness assessment. Scotland only; null for E&W.
+   * The air tightness assessment. Scotland only; null on England and Wales certificates.
    */
   airTightness?: AirTightness | null | undefined;
   /**
-   * Ground floor construction and insulation.
+   * The ground floor and its insulation.
    */
   floor?: Floor | undefined;
   /**
-   * Heating control system.
+   * How the heating is controlled.
    */
   heatingControls?: HeatingControls | undefined;
   /**
-   * Hot water system.
+   * The hot water system.
    */
   hotWater?: HotWater | undefined;
   /**
-   * Lighting system.
+   * The lighting installed.
    */
   lighting?: Lighting | undefined;
   /**
-   * Main heating system.
+   * The main heating system.
    */
   mainHeating?: MainHeating | undefined;
   /**
-   * Roof construction and insulation.
+   * The roof and its insulation.
    */
   roof?: EPCDataRoof | undefined;
   /**
-   * Secondary heating system. Null when no secondary heating is present.
+   * Any secondary heating system. Null when the property has none.
    */
   secondaryHeating?: SecondaryHeating | null | undefined;
   /**
-   * External wall construction and insulation.
+   * The external walls and their insulation.
    */
   walls?: Walls | undefined;
   /**
-   * Window glazing specification.
+   * The windows and their glazing.
    */
   windows?: Windows | undefined;
 };
 
 /**
- * MEES compliance status
+ * Whether the property meets the Minimum Energy Efficiency Standard that governs letting.
  */
 export const MeesCompliance = {
   Compliant: "compliant",
   AtRisk: "at_risk",
   NonCompliant: "non_compliant",
+  NotApplicable: "not_applicable",
   Exempt: "exempt",
   Unknown: "unknown",
 } as const;
 /**
- * MEES compliance status
+ * Whether the property meets the Minimum Energy Efficiency Standard that governs letting.
  */
 export type MeesCompliance = OpenEnum<typeof MeesCompliance>;
 
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export const EPCDataBand = {
   APlus: "A+",
@@ -1089,12 +1090,12 @@ export const EPCDataBand = {
   G: "G",
 } as const;
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export type EPCDataBand = OpenEnum<typeof EPCDataBand>;
 
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export const ScoreType = {
   Sap: "sap",
@@ -1103,30 +1104,30 @@ export const ScoreType = {
   Epi: "epi",
 } as const;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type ScoreType = OpenEnum<typeof ScoreType>;
 
 /**
- * Current energy rating at time of assessment.
+ * The rating the building holds as assessed.
  */
 export type Current = {
   /**
-   * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+   * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
    */
   band?: EPCDataBand | undefined;
   /**
-   * Numeric score. Interpretation depends on scoreType: SAP = 1-100 (higher is better); Asset = kg CO2/m² (lower is better, unbounded); Operational = relative to benchmark (lower is better, unbounded); EPI = kg CO2/m² using Scottish weather data.
+   * Numeric score behind the band, read alongside `scoreType`. A `sap` score runs from 1 to 100 and higher is better. An `asset` score is in kg CO2 per m² and an `operational` score is measured against a benchmark; both are unbounded and lower is better. An `epi` score is in kg CO2 per m² calculated with Scottish weather data.
    */
   score?: number | undefined;
   /**
-   * Discriminator for numeric score interpretation.
+   * Which scale `score` is on. Read it before comparing scores across certificates.
    */
   scoreType?: ScoreType | undefined;
 };
 
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export const EPCDataSchemasBand = {
   APlus: "A+",
@@ -1144,12 +1145,12 @@ export const EPCDataSchemasBand = {
   G: "G",
 } as const;
 /**
- * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+ * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
  */
 export type EPCDataSchemasBand = OpenEnum<typeof EPCDataSchemasBand>;
 
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export const EPCDataScoreType = {
   Sap: "sap",
@@ -1158,48 +1159,48 @@ export const EPCDataScoreType = {
   Epi: "epi",
 } as const;
 /**
- * Discriminator for numeric score interpretation.
+ * Which scale `score` is on. Read it before comparing scores across certificates.
  */
 export type EPCDataScoreType = OpenEnum<typeof EPCDataScoreType>;
 
 /**
- * Achievable rating with recommended improvements. Null for DECs (operational ratings have no potential). E&W non-domestic does not publish a potential rating; Scotland non-domestic does.
+ * The rating the building would reach if the recommended improvements were carried out. Null on Display Energy Certificates, which rate measured use rather than potential, and on England and Wales non-domestic certificates, which do not publish one. Scotland non-domestic does.
  */
 export type Potential = {
   /**
-   * Energy efficiency band. A/A+ is most efficient, G is least. Domestic uses A-G. Non-domestic uses A+-G. Scotland non-domestic also has half-bands (B+, C+, etc.).
+   * Energy efficiency band, where A+ and A are the most efficient and G the least. Domestic certificates use A to G, non-domestic certificates add A+, and Scotland non-domestic certificates also use half-bands such as B+ and C+.
    */
   band?: EPCDataSchemasBand | undefined;
   /**
-   * Numeric score. Interpretation depends on scoreType: SAP = 1-100 (higher is better); Asset = kg CO2/m² (lower is better, unbounded); Operational = relative to benchmark (lower is better, unbounded); EPI = kg CO2/m² using Scottish weather data.
+   * Numeric score behind the band, read alongside `scoreType`. A `sap` score runs from 1 to 100 and higher is better. An `asset` score is in kg CO2 per m² and an `operational` score is measured against a benchmark; both are unbounded and lower is better. An `epi` score is in kg CO2 per m² calculated with Scottish weather data.
    */
   score?: number | undefined;
   /**
-   * Discriminator for numeric score interpretation.
+   * Which scale `score` is on. Read it before comparing scores across certificates.
    */
   scoreType?: EPCDataScoreType | undefined;
 };
 
 /**
- * Full energy rating (current + potential)
+ * Energy rating as assessed, and as it could be with the recommended improvements made.
  */
 export type Rating = {
   /**
-   * Whether the building achieves net-zero carbon. Scotland non-domestic uses 'Carbon Neu' band; mapped to A+ with this flag set to true.
+   * True when the building is rated carbon neutral. Scotland non-domestic certificates record this as a 'Carbon Neu' band, which is published here as band `A+` with this flag set.
    */
   carbonNeutral?: boolean | undefined;
   /**
-   * Current energy rating at time of assessment.
+   * The rating the building holds as assessed.
    */
   current?: Current | undefined;
   /**
-   * Achievable rating with recommended improvements. Null for DECs (operational ratings have no potential). E&W non-domestic does not publish a potential rating; Scotland non-domestic does.
+   * The rating the building would reach if the recommended improvements were carried out. Null on Display Energy Certificates, which rate measured use rather than potential, and on England and Wales non-domestic certificates, which do not publish one. Scotland non-domestic does.
    */
   potential?: Potential | null | undefined;
 };
 
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export const Category = {
   Insulation: "insulation",
@@ -1210,12 +1211,12 @@ export const Category = {
   Lighting: "lighting",
 } as const;
 /**
- * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+ * What kind of improvement the measure is.
  */
 export type Category = OpenEnum<typeof Category>;
 
 /**
- * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+ * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
  */
 export const Co2Impact = {
   Low: "low",
@@ -1223,49 +1224,49 @@ export const Co2Impact = {
   High: "high",
 } as const;
 /**
- * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+ * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
  */
 export type Co2Impact = OpenEnum<typeof Co2Impact>;
 
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export const Currency = {
   Gbp: "GBP",
 } as const;
 /**
- * Currency. All values normalised to GBP.
+ * The currency of the cost figures. Always `GBP`.
  */
 export type Currency = ClosedEnum<typeof Currency>;
 
 /**
- * Structured cost estimate with numeric min/max in GBP. Parsed from 1,054 unique source cost strings (including encoding variants). Use cost.year to apply your own inflation adjustment.
+ * What the measure is estimated to cost, as numeric bounds in GBP. Use `cost.year` as the base year when adjusting for inflation.
  */
 export type Cost = {
   /**
-   * Currency. All values normalised to GBP.
+   * The currency of the cost figures. Always `GBP`.
    */
   currency?: Currency | undefined;
   /**
-   * Raw cost string from source (e.g. '£100 - £350'). Preserved for transparency.
+   * The cost range exactly as the certificate words it, for example '£100 - £350'.
    */
   indicative?: string | null | undefined;
   /**
-   * Upper bound cost estimate (£ GBP).
+   * High end of the estimated cost, in GBP.
    */
   max?: number | null | undefined;
   /**
-   * Lower bound cost estimate (£ GBP).
+   * Low end of the estimated cost, in GBP.
    */
   min?: number | null | undefined;
   /**
-   * Assessment year for this cost estimate. Consumers should apply their own inflation adjustment from this base year.
+   * The year the cost was estimated in. Treat it as the base year when adjusting for inflation.
    */
   year?: number | null | undefined;
 };
 
 /**
- * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+ * Which improvement is recommended, mapped to a standard set of measures.
  */
 export const Measure = {
   WallInsulation: "wall_insulation",
@@ -1310,12 +1311,12 @@ export const Measure = {
   LowEnergyLighting: "low_energy_lighting",
 } as const;
 /**
- * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+ * Which improvement is recommended, mapped to a standard set of measures.
  */
 export type Measure = OpenEnum<typeof Measure>;
 
 /**
- * Payback period classification. Non-domestic only: short, medium, long, other.
+ * How long the measure takes to pay for itself. Non-domestic only.
  */
 export const PaybackType = {
   Short: "short",
@@ -1324,169 +1325,169 @@ export const PaybackType = {
   Other: "other",
 } as const;
 /**
- * Payback period classification. Non-domestic only: short, medium, long, other.
+ * How long the measure takes to pay for itself. Non-domestic only.
  */
 export type PaybackType = OpenEnum<typeof PaybackType>;
 
 /**
- * Projected rating after this measure. Domestic only.
+ * The rating reached once this measure is carried out. Domestic only.
  */
 export type ProjectedRating = {
   /**
-   * Projected energy band after this measure (e.g. 'C').
+   * The energy band the dwelling reaches once this measure is in place, for example 'C'.
    */
   band?: string | null | undefined;
   /**
-   * Projected cumulative SAP score after implementing this and all prior measures.
+   * The SAP score the dwelling reaches with this measure and every measure before it in the sequence.
    */
   energyScore?: number | null | undefined;
   /**
-   * Projected cumulative environmental score.
+   * The environmental impact score the dwelling reaches with this measure and every measure before it.
    */
   environmentalScore?: number | null | undefined;
 };
 
 /**
- * Currency.
+ * The currency of the saving. Always `GBP`.
  */
 export const EPCDataCurrency = {
   Gbp: "GBP",
 } as const;
 /**
- * Currency.
+ * The currency of the saving. Always `GBP`.
  */
 export type EPCDataCurrency = ClosedEnum<typeof EPCDataCurrency>;
 
 /**
- * Estimated annual saving in GBP. Parsed from source typical saving field.
+ * What the measure is estimated to save each year, in GBP.
  */
 export type Saving = {
   /**
-   * Estimated annual saving (£ GBP).
+   * Estimated saving each year, in GBP.
    */
   annual?: number | null | undefined;
   /**
-   * Currency.
+   * The currency of the saving. Always `GBP`.
    */
   currency?: EPCDataCurrency | undefined;
 };
 
 /**
- * Individual improvement recommendation with structured cost/saving values, canonical measure classification, and projected rating impact.
+ * One recommended improvement, with its cost and saving estimates, its standard measure classification, and the rating it would achieve.
  */
 export type Recommendations = {
   /**
-   * Measure category: insulation, glazing, heating, hot_water, renewables, lighting.
+   * What kind of improvement the measure is.
    */
   category?: Category | null | undefined;
   /**
-   * CO2 reduction impact. Scotland non-domestic only: low, medium, high.
+   * How much the measure cuts carbon dioxide emissions. Scotland non-domestic only.
    */
   co2Impact?: Co2Impact | null | undefined;
   /**
-   * Structured cost estimate with numeric min/max in GBP. Parsed from 1,054 unique source cost strings (including encoding variants). Use cost.year to apply your own inflation adjustment.
+   * What the measure is estimated to cost, as numeric bounds in GBP. Use `cost.year` as the base year when adjusting for inflation.
    */
   cost?: Cost | null | undefined;
   /**
-   * Detailed description with guidance text.
+   * The fuller explanation of the measure, as worded on the certificate.
    */
   description?: string | null | undefined;
   /**
-   * Whether this measure is eligible for Green Deal financing. Boolean — not a raw string code.
+   * True when the measure qualifies for Green Deal financing.
    */
   greenDealEligible?: boolean | null | undefined;
   /**
-   * Canonical improvement measure: wall_insulation, condensing_boiler, solar_pv, etc. 40 canonical values covering all SAP standard improvement measures.
+   * Which improvement is recommended, mapped to a standard set of measures.
    */
   measure?: Measure | null | undefined;
   /**
-   * Source measure code. E&W: IMPROVEMENT_ID. Scotland: EPC-prefixed (e.g. EPC-R4).
+   * The code this measure carries on the source certificate. Scottish certificates prefix theirs with 'EPC-', such as 'EPC-R4'.
    */
   measureCode?: string | null | undefined;
   /**
-   * Payback period classification. Non-domestic only: short, medium, long, other.
+   * How long the measure takes to pay for itself. Non-domestic only.
    */
   paybackType?: PaybackType | null | undefined;
   /**
-   * Projected rating after this measure. Domestic only.
+   * The rating reached once this measure is carried out. Domestic only.
    */
   projectedRating?: ProjectedRating | null | undefined;
   /**
-   * Estimated annual saving in GBP. Parsed from source typical saving field.
+   * What the measure is estimated to save each year, in GBP.
    */
   saving?: Saving | null | undefined;
   /**
-   * Priority order. Implementing measures in sequence provides the most cost-effective path.
+   * Position in the recommended order. Carrying the measures out in this order gives the most cost-effective path.
    */
   sequence?: number | undefined;
   /**
-   * Short description of the improvement measure.
+   * The measure in a short line, as worded on the certificate.
    */
   summary?: string | null | undefined;
 };
 
 /**
- * Annual heating costs — current and achievable.
+ * Estimated annual heating cost, as assessed and after improvement.
  */
 export type Heating = {
   /**
-   * Current annual heating cost (£).
+   * Estimated annual heating cost at the assessed efficiency, in GBP.
    */
   current?: number | undefined;
   /**
-   * Achievable annual heating cost (£).
+   * Estimated annual heating cost once the recommended improvements are carried out, in GBP.
    */
   potential?: number | undefined;
 };
 
 /**
- * Annual hot water costs — current and achievable.
+ * Estimated annual hot water cost, as assessed and after improvement.
  */
 export type EPCDataHotWater = {
   /**
-   * Current annual hot water cost (£).
+   * Estimated annual hot water cost at the assessed efficiency, in GBP.
    */
   current?: number | undefined;
   /**
-   * Achievable annual hot water cost (£).
+   * Estimated annual hot water cost once the recommended improvements are carried out, in GBP.
    */
   potential?: number | undefined;
 };
 
 /**
- * Annual lighting costs — current and achievable.
+ * Estimated annual lighting cost, as assessed and after improvement.
  */
 export type EPCDataLighting = {
   /**
-   * Current annual lighting cost (£).
+   * Estimated annual lighting cost at the assessed efficiency, in GBP.
    */
   current?: number | undefined;
   /**
-   * Achievable annual lighting cost (£).
+   * Estimated annual lighting cost once the recommended improvements are carried out, in GBP.
    */
   potential?: number | undefined;
 };
 
 /**
- * Annual running costs in GBP (domestic only)
+ * Estimated annual running costs for heating, hot water and lighting. Domestic certificates only; null for the other types.
  */
 export type RunningCosts = {
   /**
-   * Annual heating costs — current and achievable.
+   * Estimated annual heating cost, as assessed and after improvement.
    */
   heating?: Heating | undefined;
   /**
-   * Annual hot water costs — current and achievable.
+   * Estimated annual hot water cost, as assessed and after improvement.
    */
   hotWater?: EPCDataHotWater | undefined;
   /**
-   * Annual lighting costs — current and achievable.
+   * Estimated annual lighting cost, as assessed and after improvement.
    */
   lighting?: EPCDataLighting | undefined;
 };
 
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export const InspectionStatus = {
   Completed: "completed",
@@ -1496,34 +1497,34 @@ export const InspectionStatus = {
   Unknown: "unknown",
 } as const;
 /**
- * AC inspection commissioning status.
+ * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
  */
 export type InspectionStatus = OpenEnum<typeof InspectionStatus>;
 
 /**
- * Air conditioning details. Non-domestic/DEC only; null for domestic.
+ * The building's air conditioning. Recorded on non-domestic certificates and Display Energy Certificates; null for domestic.
  */
 export type AirConditioning = {
   /**
-   * Estimated AC capacity when actual is unknown (kW).
+   * Estimated capacity of the air conditioning system, in kW, used when the rated capacity is unknown.
    */
   estimatedKwRating?: number | null | undefined;
   /**
-   * AC inspection commissioning status.
+   * Whether an air conditioning inspection has been carried out, commissioned, or is not relevant.
    */
   inspectionStatus?: InspectionStatus | null | undefined;
   /**
-   * Actual AC system capacity (kW).
+   * Rated capacity of the air conditioning system, in kW.
    */
   kwRating?: number | null | undefined;
   /**
-   * Whether AC system is installed.
+   * True when the building has air conditioning.
    */
   present?: boolean | undefined;
 };
 
 /**
- * Electricity tariff type. Domestic only.
+ * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
  */
 export const EnergyTariff = {
   Single: "single",
@@ -1535,12 +1536,12 @@ export const EnergyTariff = {
   Unknown: "unknown",
 } as const;
 /**
- * Electricity tariff type. Domestic only.
+ * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
  */
 export type EnergyTariff = OpenEnum<typeof EnergyTariff>;
 
 /**
- * Corridor heat loss classification. Flats/maisonettes only.
+ * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
  */
 export const HeatLossCorridor = {
   NoCorridor: "no_corridor",
@@ -1548,12 +1549,12 @@ export const HeatLossCorridor = {
   UnheatedCorridor: "unheated_corridor",
 } as const;
 /**
- * Corridor heat loss classification. Flats/maisonettes only.
+ * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
  */
 export type HeatLossCorridor = OpenEnum<typeof HeatLossCorridor>;
 
 /**
- * Normalised primary fuel type. See mainFuelExternal for raw source text.
+ * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
  */
 export const MainFuel = {
   MainsGas: "mains_gas",
@@ -1572,38 +1573,38 @@ export const MainFuel = {
   Other: "other",
 } as const;
 /**
- * Normalised primary fuel type. See mainFuelExternal for raw source text.
+ * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
  */
 export type MainFuel = OpenEnum<typeof MainFuel>;
 
 /**
- * Photovoltaic panel installation.
+ * The solar photovoltaic installation.
  */
 export type Photovoltaic = {
   /**
-   * Whether PV panels are installed.
+   * True when solar photovoltaic panels are installed.
    */
   present?: boolean | undefined;
   /**
-   * Percentage of demand met by PV. Domestic only (PHOTO_SUPPLY field).
+   * The photovoltaic supply figure recorded on the certificate, as a percentage. Domestic only.
    */
   supplyPercentage?: number | null | undefined;
 };
 
 /**
- * On-site renewable energy installations.
+ * Renewable energy generated on site.
  */
 export type Renewables = {
   /**
-   * Free-text renewable sources description. Non-domestic only (RENEWABLE_SOURCES field).
+   * The renewable sources in the assessor's own words. Non-domestic only.
    */
   description?: string | null | undefined;
   /**
-   * Photovoltaic panel installation.
+   * The solar photovoltaic installation.
    */
   photovoltaic?: Photovoltaic | null | undefined;
   /**
-   * Solar thermal (hot water) present. Domestic: from SOLAR_WATER_HEATING_FLAG. Non-domestic: derived from RENEWABLE_SOURCES text.
+   * True when the building has solar thermal panels heating its hot water.
    */
   solarThermal?: boolean | null | undefined;
   /**
@@ -1613,7 +1614,7 @@ export type Renewables = {
 };
 
 /**
- * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+ * How the property is ventilated. Domestic only.
  */
 export const Ventilation = {
   Natural: "natural",
@@ -1621,103 +1622,103 @@ export const Ventilation = {
   MechanicalSupplyAndExtract: "mechanical_supply_and_extract",
 } as const;
 /**
- * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+ * How the property is ventilated. Domestic only.
  */
 export type Ventilation = OpenEnum<typeof Ventilation>;
 
 /**
- * Building energy systems — fuel, heating, renewables
+ * The property's energy systems: fuel, heating controls, ventilation and on-site renewables.
  */
 export type Systems = {
   /**
-   * Air conditioning details. Non-domestic/DEC only; null for domestic.
+   * The building's air conditioning. Recorded on non-domestic certificates and Display Energy Certificates; null for domestic.
    */
   airConditioning?: AirConditioning | null | undefined;
   /**
-   * Electricity tariff type. Domestic only.
+   * The electricity tariff the property is on, including the off-peak arrangements. Domestic only.
    */
   energyTariff?: EnergyTariff | null | undefined;
   /**
-   * Corridor heat loss classification. Flats/maisonettes only.
+   * Whether the dwelling is reached by a corridor and whether that corridor is heated. Recorded for flats and maisonettes only.
    */
   heatLossCorridor?: HeatLossCorridor | null | undefined;
   /**
-   * Normalised primary fuel type. See mainFuelExternal for raw source text.
+   * The main fuel the building uses, mapped to a standard set of categories. `mainFuelExternal` carries the wording used on the certificate.
    */
   mainFuel?: MainFuel | null | undefined;
   /**
-   * Raw fuel type text from source register. E.g. 'mains gas (not community)', 'electricity (7-hour tariff)', 'Natural Gas'.
+   * The fuel exactly as the certificate words it, for example 'mains gas (not community)' or 'electricity (7-hour tariff)'.
    */
   mainFuelExternal?: string | null | undefined;
   /**
-   * Heating control system code. Domestic only.
+   * The heating controls recorded on the certificate, as a source code. Domestic only.
    */
   mainHeatingControls?: string | null | undefined;
   /**
-   * Whether mains gas is connected. Domestic only. Derived from MAINS_GAS_FLAG (Y→true, N→false, blank→null).
+   * True when the property has a mains gas connection. Domestic only; null when the certificate does not say.
    */
   mainsGas?: boolean | null | undefined;
   /**
-   * On-site renewable energy installations.
+   * Renewable energy generated on site.
    */
   renewables?: Renewables | undefined;
   /**
-   * Length of unheated corridor in metres. Flats/maisonettes only.
+   * Length of the unheated corridor, in metres. Recorded for flats and maisonettes only.
    */
   unheatedCorridorLength?: number | null | undefined;
   /**
-   * Mechanical ventilation type. Domestic only. Null means natural ventilation.
+   * How the property is ventilated. Domestic only.
    */
   ventilation?: Ventilation | null | undefined;
 };
 
 export type EPCData = {
   /**
-   * Certificate type
+   * Which kind of certificate this is: domestic, non-domestic, or a display energy certificate.
    */
   certificateType?: CertificateType | null | undefined;
   /**
-   * Current EPC rating band
+   * Energy efficiency band on the current certificate, where A+ and A are the most efficient and G the least.
    */
   currentRatingBand?: CurrentRatingBand | null | undefined;
   /**
-   * Current SAP score (1-100)
+   * Numeric energy score on the current certificate. Read it with `rating.current.scoreType`: a domestic SAP score runs 1 to 100 and higher is better.
    */
   currentRatingScore?: number | null | undefined;
   /**
-   * Environmental impact, CO2, energy consumption
+   * Environmental impact, carbon dioxide emissions and energy consumption from the certificate.
    */
   emissions?: Emissions | null | undefined;
   /**
-   * Building fabric assessment (domestic only)
+   * Component-by-component assessment of the building, covering walls, roof, floor, windows and more. Domestic certificates only.
    */
   fabric?: Fabric | null | undefined;
   /**
-   * Date of most recent EPC assessment
+   * When the property was inspected for this certificate, as an ISO 8601 date.
    */
   inspectionDate?: string | null | undefined;
   /**
-   * MEES compliance status
+   * Whether the property meets the Minimum Energy Efficiency Standard that governs letting.
    */
   meesCompliance?: MeesCompliance | null | undefined;
   /**
-   * Full energy rating (current + potential)
+   * Energy rating as assessed, and as it could be with the recommended improvements made.
    */
   rating?: Rating | null | undefined;
   /**
-   * Improvement recommendations
+   * Improvements the assessor recommended, with their expected effect on the rating.
    */
   recommendations?: Array<Recommendations> | undefined;
   /**
-   * Annual running costs in GBP (domestic only)
+   * Estimated annual running costs for heating, hot water and lighting. Domestic certificates only; null for the other types.
    */
   runningCosts?: RunningCosts | null | undefined;
   /**
-   * Certificate source reference ID
+   * The certificate's own identifier in the register it came from.
    */
   sourceReference?: string | null | undefined;
   /**
-   * Building energy systems — fuel, heating, renewables
+   * The property's energy systems: fuel, heating controls, ventilation and on-site renewables.
    */
   systems?: Systems | null | undefined;
 };