@tracepass/dpp-schemas 1.9.0 → 1.10.1

package/README.md

@@ -10,7 +10,7 @@
 
 [![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-972-informational)](#whats-in-here)
+[![Fields](https://img.shields.io/badge/fields-987-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,31 +39,35 @@ this repository contains.
 
 ## What's in here
 
-Thirteen JSON files, one per product category. **972 fields in total. 131 are required by
-an instrument in force; 221 are anticipated under a rule that has not yet been adopted.**
+Thirteen JSON files, one per product category. **987 fields in total. 65 are required by
+a law that creates a passport; 220 are anticipated under a rule that has not yet been adopted.**
+Every other legal duty (on the product, the label, a safety data sheet, a document) is
+recorded per field in `regulationRef.obligations` instead of being marked required.
 
 | Category | Fields | Required | Instrument |
 |---|---:|---:|---|
-| `battery` | 120 | 50 | Regulation (EU) 2023/1542 |
-| `construction` | 49 | 4 | CPR (EU) 2024/3110 |
-| `detergents` | 75 | 12 | Regulation (EU) 2026/405 |
-| `electronics` | 160 | 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` | 64 | 8 | PPWR (EU) 2025/40 |
+| `battery` | 120 | 38 | Regulation (EU) 2023/1542 |
+| `construction` | 49 | 0 | CPR (EU) 2024/3110 |
+| `detergents` | 76 | 12 | Regulation (EU) 2026/405 |
+| `electronics` | 160 | 0 | ESPR (EU) 2024/1781 |
+| `fmcg` | 42 | 0 | ESPR (EU) 2024/1781 |
+| `furniture` | 79 | 0 | ESPR (EU) 2024/1781 |
+| `jewelry` | 53 | 0 | ESPR (EU) 2024/1781 |
+| `packaging` | 64 | 0 | PPWR (EU) 2025/40 |
 | `paints-coatings` | 65 | 0 | Directive 2004/42/EC |
-| `steel` | 84 | 16 | ESPR (EU) 2024/1781 |
-| `textile` | 60 | 5 | ESPR (EU) 2024/1781 |
-| `toys` | 28 | 14 | Regulation (EU) 2025/2509 |
-| `tyres` | 93 | 2 | ESPR (EU) 2024/1781 |
+| `steel` | 84 | 0 | ESPR (EU) 2024/1781 |
+| `textile` | 60 | 0 | ESPR (EU) 2024/1781 |
+| `toys` | 42 | 15 | Regulation (EU) 2025/2509 |
+| `tyres` | 93 | 0 | 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 only
 other categories whose passport duty rests on an adopted instrument are `detergents` and
 `toys` (`dateBasis: "statutory"`); the remaining ten are `"indicative"` — either awaiting
 an ESPR delegated act, or citing an instrument that creates no passport duty at all
-(`paints-coatings`, `packaging`, `construction`).
+(`paints-coatings`, `packaging`, `construction`). Those three passport categories are the only ones
+with required fields; construction's passport points are recorded as obligations
+conditional on the delegated act under Reg (EU) 2024/3110 Art. 75(1).
 
 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 acts, and — per the
@@ -191,11 +195,14 @@ else:
 
 **`regulationRef`** is the reason this data is worth having. Every field says which
 article and annex mandates it, so a compliance report can cite its source rather than
-assert it. A required field's `regulationRef.verification` quotes the operative sentence
-from the act, says where it sits, and states any condition the law attaches (for
-example, the Detergents Regulation's substance list does not bind industrial products).
-Required fields not yet verified against the primary text are listed in
-`audit/unverified-required.json`, which only shrinks.
+assert it. `regulationRef.obligations` lists every law that requires the datum, each with
+the provision, where the law puts it (the passport, the product, the label, a safety data
+sheet, a notification, a document, a customs declaration), any condition, and the
+operative sentence quoted from the act. A field is `required` only when a passport law puts
+it in the passport for every product; a duty elsewhere is recorded, not required. So a
+manufacturer name can be required in the battery passport and, in a category with no
+passport law yet, optional with GPSR Art. 9(6) recorded as the duty to show it on the
+product.
 
 **`label`** is provided in the 24 official EU languages, because ESPR Article 8 requires
 the passport to be available in the language of the member state where the product is

package/index.json

@@ -7,9 +7,9 @@
   },
   "totals": {
     "categories": 13,
-    "fields": 972,
-    "requiredFields": 131,
-    "anticipatedFields": 221
+    "fields": 987,
+    "requiredFields": 65,
+    "anticipatedFields": 220
   },
   "categories": [
     {
@@ -18,7 +18,7 @@
       "file": "templates/battery.json",
       "version": 5,
       "fieldCount": 120,
-      "requiredFieldCount": 50,
+      "requiredFieldCount": 38,
       "anticipatedFieldCount": 16,
       "regulation": {
         "name": "EU Battery Regulation",
@@ -34,7 +34,7 @@
       "file": "templates/construction.json",
       "version": 2,
       "fieldCount": 49,
-      "requiredFieldCount": 4,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 0,
       "regulation": {
         "name": "Construction Products Regulation",
@@ -51,7 +51,7 @@
       "label": "Detergents & Surfactants",
       "file": "templates/detergents.json",
       "version": 1,
-      "fieldCount": 75,
+      "fieldCount": 76,
       "requiredFieldCount": 12,
       "anticipatedFieldCount": 10,
       "regulation": {
@@ -68,7 +68,7 @@
       "file": "templates/electronics.json",
       "version": 2,
       "fieldCount": 160,
-      "requiredFieldCount": 4,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 19,
       "regulation": {
         "name": "EU ESPR - Electronics",
@@ -86,7 +86,7 @@
       "file": "templates/fmcg.json",
       "version": 2,
       "fieldCount": 42,
-      "requiredFieldCount": 9,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 6,
       "regulation": {
         "name": "EU ESPR - FMCG",
@@ -104,7 +104,7 @@
       "file": "templates/furniture.json",
       "version": 2,
       "fieldCount": 79,
-      "requiredFieldCount": 4,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 26,
       "regulation": {
         "name": "EU ESPR - Furniture",
@@ -122,7 +122,7 @@
       "file": "templates/jewelry.json",
       "version": 2,
       "fieldCount": 53,
-      "requiredFieldCount": 3,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 10,
       "regulation": {
         "name": "EU ESPR - Jewelry",
@@ -140,7 +140,7 @@
       "file": "templates/packaging.json",
       "version": 2,
       "fieldCount": 64,
-      "requiredFieldCount": 8,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 29,
       "regulation": {
         "name": "Packaging and Packaging Waste Regulation",
@@ -174,7 +174,7 @@
       "file": "templates/steel.json",
       "version": 2,
       "fieldCount": 84,
-      "requiredFieldCount": 16,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 27,
       "regulation": {
         "name": "EU ESPR - Iron, Steel & Aluminium",
@@ -192,7 +192,7 @@
       "file": "templates/textile.json",
       "version": 2,
       "fieldCount": 60,
-      "requiredFieldCount": 5,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 32,
       "regulation": {
         "name": "EU ESPR - Textiles",
@@ -209,9 +209,9 @@
       "label": "Toys",
       "file": "templates/toys.json",
       "version": 2,
-      "fieldCount": 28,
-      "requiredFieldCount": 14,
-      "anticipatedFieldCount": 8,
+      "fieldCount": 42,
+      "requiredFieldCount": 15,
+      "anticipatedFieldCount": 7,
       "regulation": {
         "name": "Toy Safety Regulation",
         "number": "(EU) 2025/2509",
@@ -226,7 +226,7 @@
       "file": "templates/tyres.json",
       "version": 2,
       "fieldCount": 93,
-      "requiredFieldCount": 2,
+      "requiredFieldCount": 0,
       "anticipatedFieldCount": 26,
       "regulation": {
         "name": "EU ESPR - Tyres",

package/instruments.json

@@ -346,6 +346,21 @@
       "eli": "http://data.europa.eu/eli/reg/2019/2019/oj",
       "createsDpp": false,
       "note": "Under Ecodesign Directive 2009/125/EC. Applies from 1 March 2021. Annex V provides indicative benchmarks; no Digital Product Passport created."
+    },
+    "32011R0305": {
+      "kind": "legislation",
+      "shortName": "CPR 2011",
+      "title": "Regulation (EU) No 305/2011 laying down harmonised conditions for the marketing of construction products",
+      "eli": "http://data.europa.eu/eli/reg/2011/305/oj",
+      "createsDpp": false,
+      "note": "Repealed by Regulation (EU) 2024/3110, but Art. 94 of that Regulation keeps its Articles 4 to 9 and 11 to 18 applying to products under its harmonised standards until 8 January 2040."
+    },
+    "32014L0068": {
+      "kind": "legislation",
+      "shortName": "Pressure Equipment Directive",
+      "title": "Directive 2014/68/EU on the harmonisation of the laws of the Member States relating to the making available on the market of pressure equipment",
+      "eli": "http://data.europa.eu/eli/dir/2014/68/oj",
+      "createsDpp": false
     }
   },
   "nonLegislative": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tracepass/dpp-schemas",
-  "version": "1.9.0",
-  "description": "Machine-readable field specifications for EU Digital Product Passports (ESPR) — 13 product categories, 972 fields, each traced to the article of EU law that mandates it. Pure JSON, no dependencies.",
+  "version": "1.10.1",
+  "description": "Machine-readable field specifications for EU Digital Product Passports (ESPR) — 13 product categories, 987 fields, each traced to the article of EU law that mandates it. Pure JSON, no dependencies.",
   "keywords": [
     "digital-product-passport",
     "dpp",
@@ -46,9 +46,10 @@
     "validate": "python3 -c \"import json,glob,sys;from jsonschema import Draft202012Validator as V;v=V(json.load(open('schema.json')));bad=0\nfor p in sorted(glob.glob('templates/*.json')):\n    e=list(v.iter_errors(json.load(open(p))));bad+=bool(e);print(('FAIL' if e else 'ok  '),p)\n    [print('     ',str(x.absolute_path),x.message[:120]) for x in e[:3]]\nsys.exit(1 if bad else 0)\"",
     "build:index": "node scripts/build-index.mjs",
     "check:index": "node scripts/build-index.mjs --check",
-    "check": "npm run validate && npm run check:index && npm run check:standards && npm run check:locales && npm run check:audit",
+    "check": "npm run validate && npm run check:index && npm run check:standards && npm run check:locales && npm run check:audit && npm run test:audit",
     "check:standards": "node scripts/check-standards.mjs",
     "check:locales": "node scripts/check-locales.mjs",
-    "check:audit": "node audit/audit.mjs"
+    "check:audit": "node audit/audit.mjs",
+    "test:audit": "node --test audit/self-test.mjs"
   }
 }

package/schema.json

@@ -535,34 +535,52 @@
               "uniqueItems": true,
               "description": "Keys into `standards.json` for the technical standards this field relates to (test method, declaration format, identifier scheme). Relating to a standard never makes a field required — only `kind: legislation` can — and naming one is not a claim of conformity."
             },
-            "verification": {
-              "type": [
-                "object",
-                "null"
-              ],
-              "description": "Evidence that the citation was checked against the act's primary text: the operative sentence and where it sits. Required on every `validation.required` field (npm run check:audit enforces it, with a shrinking baseline for fields not yet verified). It records what a reader confirmed, so it is only ever added by reading the act, never generated.",
-              "additionalProperties": false,
-              "required": [
-                "quote",
-                "at"
-              ],
-              "properties": {
-                "quote": {
-                  "type": "string",
-                  "minLength": 20,
-                  "description": "The operative sentence, verbatim from the Official Journal text (ellipses allowed), that imposes the duty this field discharges."
-                },
-                "at": {
-                  "type": "string",
-                  "minLength": 3,
-                  "description": "Where the quote sits, e.g. \"32026R0405 Annex VI Part A(h)\"."
-                },
-                "condition": {
-                  "type": [
-                    "string",
-                    "null"
-                  ],
-                  "description": "The condition the law attaches, when the duty does not bind every product of the category (e.g. \"consumer detergents only; industrial and institutional products use the SDS\"). Null when it binds all."
+            "obligations": {
+              "type": "array",
+              "description": "Every law, verified against its primary text, that requires this datum to exist, and where it puts it. A field is `validation.required` exactly when one entry has carrier `passport` from a law that creates a digital product passport and no condition the template cannot express; other entries record duties elsewhere (on the product, the label, a safety data sheet, a notification, a document, a customs declaration), which make the datum worth having without making it passport-mandatory. Added only by reading the act; npm run check:audit enforces the link to `required`.",
+              "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": [
+                  "instrument",
+                  "provision",
+                  "carrier",
+                  "quote"
+                ],
+                "properties": {
+                  "instrument": {
+                    "type": "string",
+                    "description": "CELEX id, e.g. \"32026R0405\"."
+                  },
+                  "provision": {
+                    "type": "string",
+                    "description": "Where in the act, e.g. \"Annex VI Part A(h)\"."
+                  },
+                  "carrier": {
+                    "type": "string",
+                    "enum": [
+                      "passport",
+                      "product",
+                      "label",
+                      "sds",
+                      "notification",
+                      "document",
+                      "customs"
+                    ],
+                    "description": "Where the law puts the datum: the digital product passport, a marking on the product, its label or packaging, a safety data sheet, a notification to an authority or body, an accompanying document (declaration of conformity, instructions), or a customs declaration."
+                  },
+                  "condition": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "description": "The condition the law attaches when the duty does not bind every product of the category (e.g. \"consumer products only\"); null when it binds all."
+                  },
+                  "quote": {
+                    "type": "string",
+                    "minLength": 5,
+                    "description": "The operative sentence or sub-point, verbatim from the Official Journal text (ellipses allowed). Annex points can be as short as \"the weight;\"."
+                  }
                 }
               }
             }