@meterapp/vehicle-db 2.8.0 → 2.10.0

package/README.md

@@ -2,7 +2,7 @@
 
 An offline, international vehicle make/model catalog for Node.js and TypeScript. The package combines U.S. model-year data, the UK registered fleet, the European Union's new car and van registration register, the daily-updated Dutch vehicle register, Asian-origin vehicles registered in New Zealand, Malaysian registration transactions, and an Indian manufacturer catalog into one small, zero-dependency API. It never makes runtime network requests.
 
-The current snapshot spans **1990–2027** and includes **1,580 makes**, **36,870 model names**, and **207,953 deduplicated model-year entries** from **7 data sources**.
+The current snapshot spans **1990–2027** and includes **1,599 makes**, **36,998 model names**, and **210,424 deduplicated model-year entries** from **7 data sources**.
 
 The catalog covers seven vehicle types: **Motorcycle**, **Passenger Car**, **Truck**, **Bus**, **Multipurpose Passenger Vehicle (MPV)**, **Auto Rickshaw**, and **Other Vehicle**. The European source adds continental models from Dacia, Cupra, DS, Lynk & Co, Alpine, and the Chinese brands entering Europe such as BYD, MG, Omoda, Xpeng, and Nio, as sold in the EU rather than the UK or U.S. The Dutch register keeps that coverage current: vehicles first registered this year appear within days, so 2026 models such as the BYD Atto 2 and Renault 5 E-Tech are already listed. The Asia-Pacific sources add Japanese domestic and kei models, Chinese EVs, Indian and Korean vehicles, Southeast Asian makes such as Perodua and Proton, and additional motorcycles and commercial vehicles.
 
@@ -29,10 +29,6 @@ import {
   getMakes,
   getModels,
   getAvailableYears,
-  getAvailableYearRanges,
-  getModelAppearanceRanges,
-  getModelRenderGroups,
-  getRepresentativeYear,
 } from "@meterapp/vehicle-db";
 
 // Inspect provenance and coverage before querying.
@@ -111,55 +107,6 @@ const years = getAvailableYears({
   vehicleTypeId: 2,
   sourceId: "nhtsa-vpic",
 });
-
-// Availability and exterior equivalence are intentionally separate.
-const availability = getAvailableYearRanges({ makeId: toyota!.makeId });
-const arteonAppearances = getModelAppearanceRanges({
-  makeId: getMakes().find((make) => make.makeName === "VOLKSWAGEN")!.makeId,
-  modelName: "Arteon",
-});
-
-// Safe cache identity: verified ranges share a representative year; unknown
-// and overlapping transition years return the requested year unchanged.
-const renderYear = getRepresentativeYear({
-  makeId: arteonAppearances[0].makeId,
-  modelName: "Arteon",
-  year: 2018,
-}); // 2019
-```
-
-## Appearance ranges and image reuse
-
-A model being available in consecutive years does **not** prove that its exterior stayed the
-same. `getAvailableYearRanges()` only compresses catalog availability for display. Sourced
-generation/facelift facts live in `data/appearance-ranges.json` and are returned by
-`getModelAppearanceRanges()` with their body style, market, and evidence URL.
-
-`getModelRenderGroups()` turns those facts into a complete cache plan. It groups a year only when
-exactly one verified appearance range covers it. Years with no evidence, and transition years
-covered by two overlapping ranges, remain singleton exact-year groups. `getRepresentativeYear()`
-is the convenience lookup for storage/cache keys and has the same fail-closed behavior.
-
-This split is deliberate. NHTSA vPIC provides model-year and body-class data but no global
-generation identifier; Wikidata is CC0 but generation and facelift coverage is sparse. Broad
-third-party generation dumps commonly carry restrictive or share-alike terms and overlapping
-records, so they are useful for research but are not imported automatically. Verified ranges are
-small, reviewable facts linked to first-party or equivalently authoritative public evidence.
-
-NHTSA wheelbase, dimensions, doors, series, and truck cab/bed fields can rank possible body-family
-matches. They are candidate evidence only: related platforms and trims can still have visibly
-different bodywork. `appearanceId` is intentionally stricter than a derived `body_family_id` and
-is the only grouping allowed to drive render reuse. See CONTRIBUTING for the review criteria.
-
-```typescript
-const volkswagen = getMakes().find((make) => make.makeName === "VOLKSWAGEN")!;
-
-getModelAppearanceRanges({ makeId: volkswagen.makeId, modelName: "Arteon" });
-// Original Arteon: 2017–2020, Fastback, with Volkswagen evidence
-// Updated Arteon:  2020–2026, Fastback, with Volkswagen evidence
-
-getModelRenderGroups({ makeId: volkswagen.makeId, modelName: "Arteon" });
-// 2017–2019 share one render; overlapping 2020 stays exact; 2021–2026 share one render.
 ```
 
 ## Driver search and autocomplete
@@ -286,17 +233,6 @@ getAvailableYears({ makeId: 448, vehicleTypeId: 2, sourceId: "nhtsa-vpic" });
 getAvailableYears({ modelId: 2469, sourceId: "nhtsa-vpic" });
 ```
 
-### Appearance and year-range APIs
-
-- `getAvailableYearRanges(options?): VehicleYearRange[]` compresses consecutive availability
-  years; it makes no exterior-equivalence claim.
-- `getModelAppearanceRanges({ makeId, modelName, year? }): VehicleAppearanceRange[]` returns
-  verified generation/facelift periods and evidence. Overlap is preserved.
-- `getModelRenderGroups({ makeId, modelName, vehicleTypeId?, sourceId? }): VehicleRenderGroup[]`
-  returns safe, non-overlapping cache groups for every available year.
-- `getRepresentativeYear({ makeId, modelName, year, ... }): number` returns the canonical cache
-  year for an unambiguous verified group, otherwise the requested year.
-
 ### `searchVehicles(query, options?): VehicleSearchResult[]`
 
 Import from `@meterapp/vehicle-db/search`. Returns deterministic make and grouped model candidates for free-form input. Options include `year`, `vehicleTypeId`, `sourceId`, `limit` (default 10, maximum 100), and `fuzzy` (default `true`).
@@ -311,7 +247,7 @@ Model results contain `years` and a year-specific `variants` array. Make results
 | [UK DfT/DVLA vehicle licensing statistics](https://www.gov.uk/government/statistical-data-sets/vehicle-licensing-statistics-data-files) | 701 normalized makes across cars, motorcycles, goods vehicles, buses and coaches, and other vehicles; manufacture years 1990–2025 | [Open Government Licence v3.0](https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/) |
 | [Atul Auto product catalog](https://atulauto.co.in/products/) | Current Indian passenger and cargo auto-rickshaw range; catalog years 2024–2026 | Source attribution; factual product names only |
 | [NZTA Motor Vehicle Register](https://www.nzta.govt.nz/resources/new-zealand-motor-vehicle-register-statistics/new-zealand-vehicle-fleet-open-data-sets) | 30,374 Asian-origin car, truck, bus, motorcycle, and moped model-year records from 12 countries of origin; vehicle years 1990–2026 | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
-| [Malaysia JPJ registration transactions](https://data.gov.my/data-catalogue/registration_transactions_car) | 1,756 passenger car, MPV, jeep, pickup, and window-van model/registration-year records; 2024–2026 | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
+| [Malaysia JPJ registration transactions](https://data.gov.my/data-catalogue/registration_transactions_car) | 6,645 passenger car, MPV, jeep, pickup, and window-van model/registration-year records; 2015–2026 | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
 | [EEA CO2 monitoring of new passenger cars and vans](https://www.eea.europa.eu/en/datahub/datahubitem-view/fa8b1229-3db6-495d-b18e-9c9b3267c02b) | 29,939 passenger car (M1) and van (N1) model/registration-year records from 235 makes reported by EU member states, Iceland, and Norway; 2010–2025 | [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) |
 | [Netherlands RDW vehicle register](https://opendata.rdw.nl/Voertuigen/Open-Data-RDW-Gekentekende_voertuigen/m9d7-ebf2) | 73,190 passenger car, commercial vehicle, bus, and motorcycle model/first-admission-year records from 624 makes licensed in the Netherlands; 1990–2026 | [Public domain (RDW Open Data)](https://opendata.rdw.nl/) |
 
@@ -336,10 +272,10 @@ Factory paint availability is not included. The NZTA and Malaysia records contai
 | Years | 1990–2027 |
 | Sources | 7 |
 | Vehicle types | 7 |
-| Makes | 1,580 |
-| Model names | 36,870 |
-| Deduplicated model-year entries | 207,953 |
-| Bundled TypeScript data | 7.17 MB |
+| Makes | 1,599 |
+| Model names | 36,998 |
+| Deduplicated model-year entries | 210,424 |
+| Bundled TypeScript data | 7.25 MB |
 
 ## Refreshing and rebuilding
 
@@ -358,7 +294,7 @@ Refresh either network source independently, then rebuild the combined catalog:
 npm run refresh:uk-dft
 npm run refresh:nhtsa -- --start-year 1990 --end-year 2027
 npm run refresh:nzta-asia-pacific -- --start-year 1990 --end-year 2026
-npm run refresh:malaysia-jpj -- --start-year 2024 --end-year 2026
+npm run refresh:malaysia-jpj -- --start-year 2015 --end-year 2026
 npm run refresh:eea-co2 -- --start-year 2010 --end-year 2026
 npm run refresh:rdw-nl -- --start-year 1990 --end-year 2026
 npm run build:data

package/dist/data.d.ts

@@ -24,20 +24,6 @@ interface CompactData {
     }[];
     modelNames: string[];
     models: [number, number, number, number, number, number][];
-    appearanceRanges: {
-        id: string;
-        make_id: number;
-        make_name: string;
-        model_name: string;
-        label: string;
-        body_style: string;
-        year_from: number;
-        year_to: number;
-        representative_year: number;
-        regions: string[];
-        source_name: string;
-        source_url: string;
-    }[];
 }
 declare const data: CompactData;
 export default data;