@tracepass/dpp-schemas 0.5.1 → 1.0.1

package/README.md

@@ -6,12 +6,12 @@
 
 # EU Digital Product Passport — Field Specifications
 
-**Machine-readable field specs for 12 product categories, with every field traced to the article of EU law that mandates it.**
+**Machine-readable field specs for 13 product categories, with every field traced to the article of EU law that mandates it.**
 
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE)
 [![npm](https://img.shields.io/npm/v/@tracepass/dpp-schemas.svg)](https://www.npmjs.com/package/@tracepass/dpp-schemas)
-[![Fields](https://img.shields.io/badge/fields-937-informational)](#whats-in-here)
-[![Categories](https://img.shields.io/badge/categories-12-informational)](#whats-in-here)
+[![Fields](https://img.shields.io/badge/fields-1004-informational)](#whats-in-here)
+[![Categories](https://img.shields.io/badge/categories-13-informational)](#whats-in-here)
 [![Dependencies](https://img.shields.io/badge/dependencies-none-success)](#no-build-step)
 [![Schema](https://img.shields.io/badge/JSON%20Schema-2020--12-orange)](./schema.json)
 
@@ -39,28 +39,31 @@ this repository contains.
 
 ## What's in here
 
-Twelve JSON files, one per product category. **937 fields in total. 302 are required by an instrument in force;
-198 are anticipated under a rule that has not yet been adopted.**
+Thirteen JSON files, one per product category. **1,004 fields in total. 190 are required by
+an instrument in force; 214 are anticipated under a rule that has not yet been adopted.**
 
 | Category | Fields | Required | Instrument |
 |---|---:|---:|---|
 | `battery` | 119 | 54 | Regulation (EU) 2023/1542 |
-| `chemicals` | 96 | 28 | ESPR (EU) 2024/1781 |
-| `construction` | 49 | 43 | CPR (EU) 2024/3110 |
-| `electronics` | 167 | 20 | ESPR (EU) 2024/1781 |
-| `fmcg` | 42 | 11 | ESPR (EU) 2024/1781 |
-| `furniture` | 79 | 27 | ESPR (EU) 2024/1781 |
-| `jewelry` | 52 | 12 | ESPR (EU) 2024/1781 |
+| `construction` | 49 | 4 | CPR (EU) 2024/3110 |
+| `detergents` | 87 | 28 | Regulation (EU) 2026/405 |
+| `electronics` | 167 | 4 | ESPR (EU) 2024/1781 |
+| `fmcg` | 42 | 9 | ESPR (EU) 2024/1781 |
+| `furniture` | 79 | 4 | ESPR (EU) 2024/1781 |
+| `jewelry` | 53 | 3 | ESPR (EU) 2024/1781 |
 | `packaging` | 66 | 9 | PPWR (EU) 2025/40 |
+| `paints-coatings` | 75 | 25 | Directive 2004/42/EC |
 | `steel` | 84 | 29 | ESPR (EU) 2024/1781 |
-| `textile` | 60 | 12 | ESPR (EU) 2024/1781 |
-| `toys` | 28 | 14 | ESPR (EU) 2024/1781 |
-| `tyres` | 95 | 43 | ESPR (EU) 2024/1781 |
-
-Battery is the only category whose obligation is already in force — Regulation (EU)
-2023/1542 Art. 77 applies from 18 February 2027, rather than awaiting a delegated
-act. That is why its `required` count is the highest of the twelve. It is not the
-case that every battery field is required: the template also carries fields that are
+| `textile` | 60 | 5 | ESPR (EU) 2024/1781 |
+| `toys` | 28 | 14 | Regulation (EU) 2025/2509 |
+| `tyres` | 95 | 2 | ESPR (EU) 2024/1781 |
+
+Battery carries the most required fields because Regulation (EU) 2023/1542 Art. 77 sets a
+real statutory date — 18 February 2027 — rather than awaiting a delegated act. The other
+categories with dated obligations are `detergents`, `toys` and `paints-coatings`; the
+remaining nine await an ESPR delegated act and so carry mostly `anticipated` fields.
+
+It is not the case that every battery field is required: the template also carries fields that are
 `anticipated` (pending the carbon-footprint and due-diligence implementing acts) and
 fields that apply only to some battery sub-categories via `validation.requiredBy`.
 
@@ -115,11 +118,13 @@ in from 2027, so `packaging` carries `2027`, not `2026-08-12`.
 Read both dates with their precision marker. `datePrecision` / `mandatoryDatePrecision`
 are `"day"` or `"year"`; absent means `"day"`:
 
-- **`"day"`** — a real statutory date. Battery is `2027-02-18`, set by ESPR Article 77.
+- **`"day"`** — a real statutory date. Battery is `2027-02-18`, set by Regulation (EU)
+  2023/1542 Article 77.
 - **`"year"`** — only the year is known, because the governing delegated or implementing
   act is not yet adopted. The day and month are filler. **Do not render these as a
-  deadline.** Eleven of the twelve categories are currently `"year"`; only battery is
-  `"day"`.
+  deadline.** Nine of the thirteen categories are currently `"year"`. The four with a real
+  statutory date are `battery` (2027-02-18), `detergents` (2029-09-23), `toys`
+  (2030-08-01), and `paints-coatings` (2010-01-01, an instrument long in force).
 
 ```python
 r = template["regulation"]
@@ -186,7 +191,7 @@ npm install @tracepass/dpp-schemas
 ## Validating the specs themselves
 
 [`schema.json`](./schema.json) is a JSON Schema (Draft 2020-12) describing the template
-format. All 12 templates validate against it — which is how the format stays honest.
+format. All 13 templates validate against it — which is how the format stays honest.
 
 ```bash
 pip install jsonschema

package/index.json

@@ -6,10 +6,10 @@
     "url": "https://www.tracepass.eu"
   },
   "totals": {
-    "categories": 12,
-    "fields": 939,
-    "requiredFields": 302,
-    "anticipatedFields": 200
+    "categories": 13,
+    "fields": 1004,
+    "requiredFields": 190,
+    "anticipatedFields": 214
   },
   "categories": [
     {
@@ -27,30 +27,13 @@
         "mandatoryDate": "2027-02-18"
       }
     },
-    {
-      "category": "chemicals",
-      "label": "Chemicals & Paints",
-      "file": "templates/chemicals.json",
-      "version": 2,
-      "fieldCount": 98,
-      "requiredFieldCount": 28,
-      "anticipatedFieldCount": 17,
-      "regulation": {
-        "name": "EU ESPR - Chemicals",
-        "number": "(EU) 2024/1781",
-        "effectiveDate": "2029-09-01",
-        "datePrecision": "year",
-        "mandatoryDate": "2029-09-01",
-        "mandatoryDatePrecision": "year"
-      }
-    },
     {
       "category": "construction",
       "label": "Construction Materials",
       "file": "templates/construction.json",
       "version": 2,
       "fieldCount": 49,
-      "requiredFieldCount": 43,
+      "requiredFieldCount": 4,
       "anticipatedFieldCount": 0,
       "regulation": {
         "name": "Construction Products Regulation",
@@ -61,13 +44,28 @@
         "mandatoryDatePrecision": "year"
       }
     },
+    {
+      "category": "detergents",
+      "label": "Detergents & Surfactants",
+      "file": "templates/detergents.json",
+      "version": 1,
+      "fieldCount": 87,
+      "requiredFieldCount": 28,
+      "anticipatedFieldCount": 17,
+      "regulation": {
+        "name": "Detergents Regulation",
+        "number": "(EU) 2026/405",
+        "effectiveDate": "2029-09-23",
+        "mandatoryDate": "2029-09-23"
+      }
+    },
     {
       "category": "electronics",
       "label": "Electronics",
       "file": "templates/electronics.json",
       "version": 2,
       "fieldCount": 167,
-      "requiredFieldCount": 20,
+      "requiredFieldCount": 4,
       "anticipatedFieldCount": 20,
       "regulation": {
         "name": "EU ESPR - Electronics",
@@ -84,8 +82,8 @@
       "file": "templates/fmcg.json",
       "version": 2,
       "fieldCount": 42,
-      "requiredFieldCount": 11,
-      "anticipatedFieldCount": 4,
+      "requiredFieldCount": 9,
+      "anticipatedFieldCount": 6,
       "regulation": {
         "name": "EU ESPR - FMCG",
         "number": "(EU) 2024/1781",
@@ -101,7 +99,7 @@
       "file": "templates/furniture.json",
       "version": 2,
       "fieldCount": 79,
-      "requiredFieldCount": 27,
+      "requiredFieldCount": 4,
       "anticipatedFieldCount": 26,
       "regulation": {
         "name": "EU ESPR - Furniture",
@@ -117,8 +115,8 @@
       "label": "Jewelry & Precious Metals",
       "file": "templates/jewelry.json",
       "version": 2,
-      "fieldCount": 52,
-      "requiredFieldCount": 12,
+      "fieldCount": 53,
+      "requiredFieldCount": 3,
       "anticipatedFieldCount": 10,
       "regulation": {
         "name": "EU ESPR - Jewelry",
@@ -146,6 +144,21 @@
         "mandatoryDatePrecision": "year"
       }
     },
+    {
+      "category": "paints-coatings",
+      "label": "Paints & Coatings",
+      "file": "templates/paints-coatings.json",
+      "version": 1,
+      "fieldCount": 75,
+      "requiredFieldCount": 25,
+      "anticipatedFieldCount": 12,
+      "regulation": {
+        "name": "Decopaint Directive",
+        "number": "2004/42/EC",
+        "effectiveDate": "2010-01-01",
+        "mandatoryDate": "2010-01-01"
+      }
+    },
     {
       "category": "steel",
       "label": "Iron, Steel & Aluminium",
@@ -169,7 +182,7 @@
       "file": "templates/textile.json",
       "version": 2,
       "fieldCount": 60,
-      "requiredFieldCount": 12,
+      "requiredFieldCount": 5,
       "anticipatedFieldCount": 32,
       "regulation": {
         "name": "EU ESPR - Textiles",
@@ -189,12 +202,10 @@
       "requiredFieldCount": 14,
       "anticipatedFieldCount": 8,
       "regulation": {
-        "name": "EU ESPR - Toys",
-        "number": "(EU) 2024/1781",
-        "effectiveDate": "2030-01-01",
-        "datePrecision": "year",
-        "mandatoryDate": "2030-01-01",
-        "mandatoryDatePrecision": "year"
+        "name": "Toy Safety Regulation",
+        "number": "(EU) 2025/2509",
+        "effectiveDate": "2030-08-01",
+        "mandatoryDate": "2030-08-01"
       }
     },
     {
@@ -203,7 +214,7 @@
       "file": "templates/tyres.json",
       "version": 2,
       "fieldCount": 95,
-      "requiredFieldCount": 43,
+      "requiredFieldCount": 2,
       "anticipatedFieldCount": 27,
       "regulation": {
         "name": "EU ESPR - Tyres",

package/instruments.json

@@ -124,7 +124,9 @@
       "title": "Regulation (EU) 2025/2509 on the safety of toys",
       "eli": "http://data.europa.eu/eli/reg/2025/2509/oj",
       "createsDpp": true,
-      "note": "In force 1 Jan 2026, applies ~2030. This — not ESPR — is the source of the toy passport."
+      "note": "In force 1 Jan 2026 for the notified-body articles (28-44, 49-55); the Regulation applies from 1 Aug 2030. The toy DPP REPLACES the EU declaration of conformity under Directive 2009/48/EC. This — not ESPR — is the source of the toy passport. The Directive remains the operative product-requirement instrument until then and creates no passport.",
+      "dppMandatoryFrom": "2030-08-01",
+      "dppProvision": "Art. 20 (DPP) — applies with the Regulation from 1 Aug 2030"
     },
     "32011R1007": {
       "kind": "legislation",
@@ -223,13 +225,6 @@
       "eli": "http://data.europa.eu/eli/reg/2018/848/oj",
       "createsDpp": false
     },
-    "32009R0661": {
-      "kind": "legislation",
-      "shortName": "General Safety Regulation (vehicles)",
-      "title": "Regulation (EC) 661/2009 concerning type-approval requirements for the general safety of motor vehicles",
-      "eli": "http://data.europa.eu/eli/reg/2009/661/oj",
-      "createsDpp": false
-    },
     "32004R0648": {
       "kind": "legislation",
       "shortName": "Detergents Regulation (2004)",
@@ -259,6 +254,58 @@
       "eli": "http://data.europa.eu/eli/reg/2023/1670/oj",
       "createsDpp": false,
       "note": "Under the OLD Ecodesign Directive 2009/125/EC, not ESPR. Real durability/repairability/spare-parts obligations for smartphones and tablets, but no Digital Product Passport."
+    },
+    "32019R0424": {
+      "kind": "legislation",
+      "shortName": "Server & Data Storage Ecodesign",
+      "title": "Commission Regulation (EU) 2019/424 laying down ecodesign requirements for servers and data storage products",
+      "eli": "http://data.europa.eu/eli/reg/2019/424/oj",
+      "createsDpp": false,
+      "note": "Adopted under the repealed Directive 2009/125/EC and KEPT IN FORCE by ESPR Art. 79 until repealed or replaced by an ESPR delegated act. Source of the PSU efficiency load points (10/20/50/100 % of rated output), power factor, idle-state power and server product-type parameters. Not a passport instrument."
+    },
+    "32013R0952": {
+      "kind": "legislation",
+      "shortName": "Union Customs Code",
+      "title": "Regulation (EU) No 952/2013 laying down the Union Customs Code",
+      "eli": "http://data.europa.eu/eli/reg/2013/952/oj",
+      "createsDpp": false,
+      "note": "Source of non-preferential origin rules (Arts. 59-63) — the basis for a country-of-origin field. Not a passport instrument."
+    },
+    "31987R2658": {
+      "kind": "legislation",
+      "shortName": "Combined Nomenclature",
+      "title": "Council Regulation (EEC) No 2658/87 on the tariff and statistical nomenclature and on the Common Customs Tariff",
+      "eli": "http://data.europa.eu/eli/reg/1987/2658/oj",
+      "createsDpp": false,
+      "note": "Annex I is the CN/TARIC commodity-code list. Both ESPR Art. 8(a) and Detergents Annex VI Part A(f) require the commodity code by reference to it. Not a passport instrument."
+    },
+    "32019R2144": {
+      "kind": "legislation",
+      "shortName": "General Safety Regulation (vehicles)",
+      "title": "Regulation (EU) 2019/2144 on type-approval requirements for the general safety of motor vehicles",
+      "eli": "http://data.europa.eu/eli/reg/2019/2144/oj",
+      "createsDpp": false
+    },
+    "32017R1369": {
+      "kind": "legislation",
+      "shortName": "Energy Labelling Regulation",
+      "title": "Regulation (EU) 2017/1369 setting a framework for energy labelling",
+      "eli": "http://data.europa.eu/eli/reg/2017/1369/oj",
+      "createsDpp": false
+    },
+    "32024R1252": {
+      "kind": "legislation",
+      "shortName": "Critical Raw Materials Act",
+      "title": "Regulation (EU) 2024/1252 establishing a framework for ensuring a secure and sustainable supply of critical raw materials",
+      "eli": "http://data.europa.eu/eli/reg/2024/1252/oj",
+      "createsDpp": false
+    },
+    "32014L0045": {
+      "kind": "legislation",
+      "shortName": "Roadworthiness Testing Directive",
+      "title": "Directive 2014/45/EU on periodic roadworthiness tests for motor vehicles and their trailers",
+      "eli": "http://data.europa.eu/eli/dir/2014/45/oj",
+      "createsDpp": false
     }
   },
   "nonLegislative": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tracepass/dpp-schemas",
-  "version": "0.5.1",
-  "description": "Machine-readable field specifications for EU Digital Product Passports (ESPR) \u2014 12 product categories, 939 fields, each traced to the article of EU law that mandates it. Pure JSON, no dependencies.",
+  "version": "1.0.1",
+  "description": "Machine-readable field specifications for EU Digital Product Passports (ESPR) — 13 product categories, 1004 fields, each traced to the article of EU law that mandates it. Pure JSON, no dependencies.",
   "keywords": [
     "digital-product-passport",
     "dpp",

package/schema.json

@@ -544,7 +544,33 @@
             }
           }
         }
-      }
+      },
+      "allOf": [
+        {
+          "$comment": "Options and dataType must agree. Options on a non-enum field are inert: they render in the CSV template and the picker while nothing validates against them. toys.recyclabilityAssessment shipped for several releases with a full enumOptions set and dataType 'object' — this schema passed it every time, and only the platform's own enum-integrity test caught it.",
+          "if": {
+            "properties": {
+              "enumOptions": {
+                "type": "array",
+                "minItems": 1
+              }
+            },
+            "required": [
+              "enumOptions"
+            ]
+          },
+          "then": {
+            "properties": {
+              "dataType": {
+                "enum": [
+                  "enum",
+                  "multi_enum"
+                ]
+              }
+            }
+          }
+        }
+      ]
     }
   }
 }