@tracepass/dpp-schemas 1.20.2 → 1.21.0

package/README.md

@@ -139,6 +139,30 @@ This is the one place those dates are kept. Copy that states them (the TracePass
 marketing site checks every sentence against this registry) and the templates' own
 `anticipated` flags follow it.
 
+## Planned acts
+
+`instruments.json` also holds `plannedActs`: acts that are planned but **not adopted**,
+keyed by a stable id (`espr-da-textiles`). Each entry records the act it would be adopted
+under (`framework`, `article`), what it covers (`productGroup`, and `kind`:
+`product-group`, `horizontal` or `procedural`), its planning `stage`, and the planned
+adoption date with its precision:
+
+| Source | `stage` | `planned.precision` |
+|---|---|---|
+| A Have Your Say initiative (`hysId`, `source.kind: hys`) | `planned` or `consultation` | `quarter` (the portal's planned period) |
+| The ESPR working plan COM(2025) 187 only (`source.kind: working_plan`) | `not-scheduled` | `year` |
+| Only the empowering article (`source.kind: act`) | `not-scheduled` | `none` (`date: null`) |
+
+A planned date is the Commission's intention, never an obligation date: render a quarter
+or a year as "planned", never as "from" or "by". When an act is adopted, its entry leaves
+`plannedActs` in the same release that adds the act to `instruments`. `lastChecked` is
+the day the entry was last read against its source. `npm run check:planned` enforces the
+shape, and that a date says no more than its source does.
+
+```js
+import instruments from "@tracepass/dpp-schemas/instruments.json" with { type: "json" };
+```
+
 ## Standards
 
 [`standards.json`](./standards.json) is a registry of the technical standards a field — or
@@ -358,6 +382,8 @@ runs it on every push:
   claims. It catches a field required under an act that mandates nothing, an article
   missing from the act it cites, duplicate fields, and one key with two units. See
   [`audit/README.md`](./audit/README.md).
+- **Planned acts** (`scripts/check-planned-acts.mjs`): every `plannedActs` entry names
+  an instrument it is adopted under, and its planned date matches its source's precision.
 
 ## Recent changes
 

package/instruments.json

@@ -1,5 +1,5 @@
 {
-  "_note": "Canonical registry of the legal instruments and standards a template field may cite. `regulationRef.instrument` must be one of these keys. Every CELEX below was verified to resolve against the EU Publications Office RDF store (cdm:resource_legal_id_celex). Kinds: `legislation` binds; `standard` supports a presumption of conformity but binds nothing; `scheme` is voluntary; `national` is one member state's law; `specification` is not a reference at all.",
+  "_note": "Canonical registry of the legal instruments and standards a template field may cite. `regulationRef.instrument` must be one of these keys. Every CELEX below was verified to resolve against the EU Publications Office RDF store (cdm:resource_legal_id_celex). Kinds: `legislation` binds; `standard` supports a presumption of conformity but binds nothing; `scheme` is voluntary; `national` is one member state's law; `specification` is not a reference at all. `plannedActs` records acts that are planned but not adopted (an ESPR delegated act per product group, the DPP service-provider act, the CPR Art. 75(1) act): planning status and the planned adoption date with its precision (`quarter` from Have Your Say, `year` from the ESPR working plan COM(2025) 187, `none` when no plan states one). A planned date is the Commission's intention, never an obligation date; an entry is removed in the release that adds its adopted act to `instruments`.",
   "instruments": {
     "32023R1542": {
       "kind": "legislation",
@@ -870,6 +870,205 @@
       "annexesVerifiedFrom": "32026R1738"
     }
   },
+  "plannedActs": {
+    "espr-da-iron-steel": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Iron and steel",
+      "stage": "planned",
+      "hysId": 17672,
+      "planned": {
+        "date": "2026-Q4",
+        "precision": "quarter",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "hys",
+        "url": "https://ec.europa.eu/info/law/better-regulation/have-your-say/initiatives/17672"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-da-textiles": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Apparel textiles",
+      "stage": "planned",
+      "hysId": 16116,
+      "planned": {
+        "date": "2027-Q1",
+        "precision": "quarter",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "hys",
+        "url": "https://ec.europa.eu/info/law/better-regulation/have-your-say/initiatives/16116"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-da-aluminium": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Aluminium",
+      "stage": "not-scheduled",
+      "planned": {
+        "date": "2027",
+        "precision": "year",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "working_plan",
+        "document": "COM(2025) 187",
+        "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:52025DC0187"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-da-tyres": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Tyres",
+      "stage": "not-scheduled",
+      "planned": {
+        "date": "2027",
+        "precision": "year",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "working_plan",
+        "document": "COM(2025) 187",
+        "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:52025DC0187"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-da-furniture": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Furniture",
+      "stage": "not-scheduled",
+      "planned": {
+        "date": "2028",
+        "precision": "year",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "working_plan",
+        "document": "COM(2025) 187",
+        "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:52025DC0187"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-da-mattresses": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Mattresses",
+      "stage": "not-scheduled",
+      "planned": {
+        "date": "2029",
+        "precision": "year",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "working_plan",
+        "document": "COM(2025) 187",
+        "url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:52025DC0187"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-horizontal-repairability": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "horizontal",
+      "productGroup": "Horizontal repairability (consumer electronics, small household appliances, light means of transport)",
+      "stage": "planned",
+      "hysId": 17873,
+      "planned": {
+        "date": "2027-Q2",
+        "precision": "quarter",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "hys",
+        "url": "https://ec.europa.eu/info/law/better-regulation/have-your-say/initiatives/17873"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-da-dishwashers": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Household dishwashers",
+      "stage": "planned",
+      "hysId": 17874,
+      "planned": {
+        "date": "2027-Q3",
+        "precision": "quarter",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "hys",
+        "url": "https://ec.europa.eu/info/law/better-regulation/have-your-say/initiatives/17874"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-da-washing-machines": {
+      "framework": "32024R1781",
+      "article": "Art. 4",
+      "kind": "product-group",
+      "productGroup": "Household washing machines and washer-dryers",
+      "stage": "planned",
+      "hysId": 17994,
+      "planned": {
+        "date": "2027-Q3",
+        "precision": "quarter",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "hys",
+        "url": "https://ec.europa.eu/info/law/better-regulation/have-your-say/initiatives/17994"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "espr-dppsp-da": {
+      "framework": "32024R1781",
+      "article": "Art. 11, third subparagraph",
+      "kind": "procedural",
+      "productGroup": "Digital product passport service providers (not a product group)",
+      "stage": "planned",
+      "hysId": 14382,
+      "planned": {
+        "date": "2026-Q4",
+        "precision": "quarter",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "hys",
+        "url": "https://ec.europa.eu/info/law/better-regulation/have-your-say/initiatives/14382"
+      },
+      "lastChecked": "2026-10-09"
+    },
+    "cpr-art75-da": {
+      "framework": "32024R3110",
+      "article": "Art. 75(1)",
+      "kind": "procedural",
+      "productGroup": "Construction products digital product passport system",
+      "stage": "not-scheduled",
+      "planned": {
+        "date": null,
+        "precision": "none",
+        "event": "adoption"
+      },
+      "source": {
+        "kind": "act",
+        "url": "http://data.europa.eu/eli/reg/2024/3110/oj"
+      },
+      "lastChecked": "2026-10-09"
+    }
+  },
   "nonLegislative": {
     "_note": "References that are not EU legislation. A field may cite one, but it must carry the right `kind` so nothing implies a legal obligation.",
     "standard": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracepass/dpp-schemas",
-  "version": "1.20.2",
+  "version": "1.21.0",
   "description": "Machine-readable field specifications for EU Digital Product Passports (ESPR) — 13 product categories, 994 fields, each traced to the article of EU law that mandates it. Pure JSON, no dependencies.",
   "keywords": [
     "digital-product-passport",
@@ -25,7 +25,8 @@
   "exports": {
     ".": "./index.json",
     "./schema.json": "./schema.json",
-    "./templates/*.json": "./templates/*.json"
+    "./templates/*.json": "./templates/*.json",
+    "./instruments.json": "./instruments.json"
   },
   "files": [
     "templates",
@@ -47,10 +48,12 @@
     "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 && npm run test: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 && npm run check:planned && npm run test:planned",
     "check:standards": "node scripts/check-standards.mjs",
     "check:locales": "node scripts/check-locales.mjs",
     "check:audit": "node audit/audit.mjs",
-    "test:audit": "node --test audit/self-test.mjs"
+    "test:audit": "node --test audit/self-test.mjs",
+    "check:planned": "node scripts/check-planned-acts.mjs",
+    "test:planned": "node --test scripts/check-planned-acts.test.mjs"
   }
 }