@tracepass/dpp-schemas 1.1.1 → 1.3.0

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-1004-informational)](#whats-in-here)
+[![Fields](https://img.shields.io/badge/fields-1005-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,12 +39,12 @@ this repository contains.
 
 ## What's in here
 
-Thirteen JSON files, one per product category. **1,004 fields in total. 188 are required by
+Thirteen JSON files, one per product category. **1,005 fields in total. 189 are required by
 an instrument in force; 215 are anticipated under a rule that has not yet been adopted.**
 
 | Category | Fields | Required | Instrument |
 |---|---:|---:|---|
-| `battery` | 119 | 54 | Regulation (EU) 2023/1542 |
+| `battery` | 120 | 55 | Regulation (EU) 2023/1542 |
 | `construction` | 49 | 4 | CPR (EU) 2024/3110 |
 | `detergents` | 87 | 28 | Regulation (EU) 2026/405 |
 | `electronics` | 167 | 4 | ESPR (EU) 2024/1781 |
@@ -59,9 +59,11 @@ an instrument in force; 215 are anticipated under a rule that has not yet been a
 | `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.
+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`).
 
 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
@@ -122,9 +124,22 @@ are `"day"` or `"year"`; absent means `"day"`:
   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.** 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).
+  deadline.** Nine of the thirteen categories are currently `"year"`; the other four
+  carry an exact date.
+
+**`datePrecision` is not the same question as `dateBasis`, and you usually want the
+latter.** Precision asks *how exact is this date*; basis asks *does an adopted
+instrument set it at all*. `dateBasis: "statutory"` means a provision in force fixes
+the date and it can be cited — exactly three categories: `battery` (2027-02-18,
+Reg (EU) 2023/1542 Art. 77(1)), `detergents` (2029-09-23) and `toys` (2030-08-01).
+The other ten are `"indicative"`: no adopted act sets the date, so it is a planning
+target with no legal force.
+
+The two are independent, and `paints-coatings` is why the distinction matters — it has
+`datePrecision: "day"` (2010-01-01 is exact) but `dateBasis: "indicative"`, because the
+Decopaint Directive creates no passport duty at all. An exact date for an obligation
+that does not exist. Filter on `dateBasis`, not on precision, when you need to know
+what is actually mandated.
 
 ```python
 r = template["regulation"]

package/index.json

@@ -7,8 +7,8 @@
   },
   "totals": {
     "categories": 13,
-    "fields": 1004,
-    "requiredFields": 188,
+    "fields": 1005,
+    "requiredFields": 189,
     "anticipatedFields": 215
   },
   "categories": [
@@ -17,14 +17,15 @@
       "label": "Battery",
       "file": "templates/battery.json",
       "version": 4,
-      "fieldCount": 119,
-      "requiredFieldCount": 54,
+      "fieldCount": 120,
+      "requiredFieldCount": 55,
       "anticipatedFieldCount": 11,
       "regulation": {
         "name": "EU Battery Regulation",
         "number": "(EU) 2023/1542",
         "effectiveDate": "2027-02-18",
-        "mandatoryDate": "2027-02-18"
+        "mandatoryDate": "2027-02-18",
+        "dateBasis": "statutory"
       }
     },
     {
@@ -41,7 +42,8 @@
         "effectiveDate": "2029-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2029-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -56,7 +58,8 @@
         "name": "Detergents Regulation",
         "number": "(EU) 2026/405",
         "effectiveDate": "2029-09-23",
-        "mandatoryDate": "2029-09-23"
+        "mandatoryDate": "2029-09-23",
+        "dateBasis": "statutory"
       }
     },
     {
@@ -73,7 +76,8 @@
         "effectiveDate": "2028-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2029-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -90,7 +94,8 @@
         "effectiveDate": "2028-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2030-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -107,7 +112,8 @@
         "effectiveDate": "2029-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2030-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -124,7 +130,8 @@
         "effectiveDate": "2030-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2030-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -141,7 +148,8 @@
         "effectiveDate": "2027-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2030-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -156,7 +164,8 @@
         "name": "Decopaint Directive",
         "number": "2004/42/EC",
         "effectiveDate": "2010-01-01",
-        "mandatoryDate": "2010-01-01"
+        "mandatoryDate": "2010-01-01",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -173,7 +182,8 @@
         "effectiveDate": "2027-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2028-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -190,7 +200,8 @@
         "effectiveDate": "2028-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2029-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     },
     {
@@ -205,7 +216,8 @@
         "name": "Toy Safety Regulation",
         "number": "(EU) 2025/2509",
         "effectiveDate": "2030-08-01",
-        "mandatoryDate": "2030-08-01"
+        "mandatoryDate": "2030-08-01",
+        "dateBasis": "statutory"
       }
     },
     {
@@ -222,7 +234,8 @@
         "effectiveDate": "2028-01-01",
         "datePrecision": "year",
         "mandatoryDate": "2029-01-01",
-        "mandatoryDatePrecision": "year"
+        "mandatoryDatePrecision": "year",
+        "dateBasis": "indicative"
       }
     }
   ]

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@tracepass/dpp-schemas",
-  "version": "1.1.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.",
+  "version": "1.3.0",
+  "description": "Machine-readable field specifications for EU Digital Product Passports (ESPR) \u2014 13 product categories, 1005 fields, each traced to the article of EU law that mandates it. Pure JSON, no dependencies.",
   "keywords": [
     "digital-product-passport",
     "dpp",

package/schema.json

@@ -91,6 +91,15 @@
           ],
           "default": "day",
           "description": "How much of mandatoryDate is real. Same semantics as datePrecision."
+        },
+        "dateBasis": {
+          "type": "string",
+          "enum": [
+            "statutory",
+            "indicative"
+          ],
+          "default": "statutory",
+          "description": "Whether effectiveDate and mandatoryDate rest on an ADOPTED instrument. \"statutory\" = the date is fixed by a provision in force and can be cited (battery: 2027-02-18, Reg (EU) 2023/1542 Art. 77(1)). \"indicative\" = NO adopted act sets it; the value is a planning target taken from the Commission's working plan, and no legal deadline exists for the category yet. Every ESPR (EU) 2024/1781 category is indicative, because ESPR creates DPP obligations only through delegated acts adopted under Art. 4 and none has been adopted for any product group. This is a stronger statement than datePrecision: \"year\" means the day/month are filler, while \"indicative\" means the whole date has no legal force. Never present an indicative date to an end user as a deadline, and never cite it as an obligation."
         }
       }
     },