@tracepass/dpp-schemas 1.10.2 → 1.10.4

package/README.md

@@ -83,10 +83,12 @@ rather than `required`, with the CELEX of the instrument expected to impose them
 **An obligation does not always apply uniformly across a category.** Where the governing
 instrument distinguishes sub-categories, the field carries `validation.requiredBy` — a map
 from sub-category to `required`, `conditional`, or `notApplicable`. Battery uses the
-Regulation (EU) 2023/1542 split (`EV`, `LMT`, `industrial_gt_2kwh`): everything applies to
-EV batteries, LMT is exempt from the capacity-threshold-for-exhaustion field, and industrial
-batteries are largely conditional on gates such as having a battery management system or
-containing Annex X materials. `conditional` means the instrument compels the field only when
+Regulation (EU) 2023/1542 split (`EV`, `LMT`, `industrial_gt_2kwh`). The capacity threshold
+for exhaustion (Annex XIII point 1(k)) and the state of certified energy are EV-only; the
+remaining-capacity, power, round-trip-efficiency, self-discharge, resistance and throughput
+parameters of Annex VII apply to LMT (and stationary storage) but not to EV. Industrial
+batteries are largely conditional on gates such as being rechargeable, having a battery
+management system, or containing Annex X materials. `conditional` means the instrument compels the field only when
 its stated gate is met — so a passport legitimately leaves it empty otherwise. Fields with no
 `requiredBy` apply to the whole category.
 
@@ -137,7 +139,13 @@ registry:
   "unit": "Ah",
   "validation": { "required": true, "min": 0, "max": null },
   "defaultAccessLevel": "public",
-  "regulationRef": { "article": "Art. 77", "annex": "Annex VI" },
+  "regulationRef": {
+    "article": "Battery Regulation Annex XIII 1(g)",   // human-facing: short name + provision
+    "annex": "Annex XIII",
+    "instrument": "32023R1542",                        // CELEX, machine-facing
+    "provision": "Annex XIII 1(g)",
+    "kind": "legislation"
+  },
   "aiHints": {
     "alternateNames": ["capacity", "nominal capacity", "battery capacity", "Ah rating"],
     "expectedFormat": "Numeric value in Ah",
@@ -286,6 +294,18 @@ runs it on every push:
   validator, EPCIS 2.0 event mapper, and GS1 utilities that consume these specs.
   Apache-2.0, zero dependencies.
 
+Plain-language explainers of the law these specs encode:
+
+- [Article 77 battery passport — Regulation (EU) 2023/1542](https://www.tracepass.eu/regulatory/battery-articles/article-77)
+  — the article behind the `battery` template's required fields.
+- [EU Battery Regulation: the February 2027 compliance guide](https://www.tracepass.eu/resources/eu-battery-regulation-february-2027)
+  — who has to issue a battery passport, and from when.
+- [ESPR delegated acts, category by category](https://www.tracepass.eu/regulatory/delegated-acts)
+  — why most templates carry `anticipated` rather than `required` fields.
+- [Standards are not law](https://www.tracepass.eu/regulatory/standards-are-not-law)
+  — what makes a DPP field mandatory, and what does not.
+- [DPP glossary](https://www.tracepass.eu/glossary) — ESPR, PPWR, delegated act, economic operator, EPCIS.
+
 ## Provenance and limits
 
 These specs are hand-authored from the regulations and the relevant standards, and are

package/instruments.json

@@ -44,7 +44,7 @@
     },
     "32019R1020": {
       "kind": "legislation",
-      "shortName": "Market surveillance",
+      "shortName": "Market Surveillance Regulation",
       "title": "Regulation (EU) 2019/1020 on market surveillance and compliance of products",
       "eli": "http://data.europa.eu/eli/reg/2019/1020/oj",
       "createsDpp": false,
@@ -82,7 +82,7 @@
     },
     "32020R0740": {
       "kind": "legislation",
-      "shortName": "Tyre labelling",
+      "shortName": "Tyre Labelling Regulation",
       "title": "Regulation (EU) 2020/740 on the labelling of tyres with respect to fuel efficiency and other parameters",
       "eli": "http://data.europa.eu/eli/reg/2020/740/oj",
       "createsDpp": false
@@ -96,7 +96,7 @@
     },
     "32017R0821": {
       "kind": "legislation",
-      "shortName": "Conflict Minerals",
+      "shortName": "Conflict Minerals Regulation",
       "title": "Regulation (EU) 2017/821 laying down supply chain due diligence obligations for importers of tin, tantalum, tungsten and gold",
       "eli": "http://data.europa.eu/eli/reg/2017/821/oj",
       "createsDpp": false
@@ -130,7 +130,7 @@
     },
     "32011R1007": {
       "kind": "legislation",
-      "shortName": "Textile labelling",
+      "shortName": "Textile Labelling Regulation",
       "title": "Regulation (EU) 1007/2011 on fibre names and related labelling of textile products",
       "eli": "http://data.europa.eu/eli/reg/2011/1007/oj",
       "createsDpp": false,
@@ -138,7 +138,7 @@
     },
     "32011R1169": {
       "kind": "legislation",
-      "shortName": "Food information",
+      "shortName": "Food Information Regulation",
       "title": "Regulation (EU) 1169/2011 on the provision of food information to consumers",
       "eli": "http://data.europa.eu/eli/reg/2011/1169/oj",
       "createsDpp": false
@@ -349,7 +349,7 @@
     },
     "32011R0305": {
       "kind": "legislation",
-      "shortName": "CPR 2011",
+      "shortName": "CPR (EU) 305/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,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracepass/dpp-schemas",
-  "version": "1.10.2",
+  "version": "1.10.4",
   "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",