@pagefront/lint-commerce 0.12.1 → 0.14.0

package/README.md

@@ -20,17 +20,21 @@ pagefront-lint-commerce <sheet-url-or-path> [options]
 The CLI validates Layer 1 (JSON Schema) first; a failing Sheet gets its
 schema errors on stderr and no report. Exit codes: `0` nothing
 blocking, `1` Layer 1 failure or blocking findings, `2` operational
-failure. Both commerce page types are handled: product sheets and
-Commerce Organization Sheets each validate against their own schema and
-lint with their own catalogue, dispatched by sheet type.
+failure. The three commerce page types are handled: product sheets,
+Commerce Organization Sheets and Commerce Collection Sheets each validate
+against their own schema and lint with their own catalogue, dispatched by
+sheet type.
 
 ## Catalogue
 
-Catalogue 0.16.1, supporting commerce releases 0.4.0 (Product Sheet spec
-0.10.0, Organization Sheet spec 0.4.0) and 0.3.0, and the legacy draft line
-(format 0.9): 58 product rules (`PDP-E-001` to `PDP-E-018`, `PDP-W-001` to
-`PDP-W-039`, `PDP-I-001`) and 10 organization rules (`ORG-E-001` to
-`ORG-E-004`, `ORG-W-001` to `ORG-W-006`), each defined in
+Catalogue 0.20.0, supporting commerce releases 0.5.0 (Product Sheet spec
+0.11.0, Organization Sheet spec 0.5.0, Collection Sheet spec 0.1.0), 0.4.0
+(Product Sheet spec 0.10.0, Organization Sheet spec 0.4.0) and 0.3.0, and the
+legacy draft line (format 0.9): 64 product rules (`PDP-E-001` to `PDP-E-022`, `PDP-W-001` to
+`PDP-W-041`, `PDP-I-001`), 12 organization rules (`ORG-E-001` to
+`ORG-E-004`, `ORG-W-001` to `ORG-W-008`) and 11 collection rules
+(`COL-E-001` to `COL-E-005`, `COL-W-001`, `COL-W-002`, `COL-W-004` to
+`COL-W-007`; `COL-W-003` is reserved), each defined in
 [`rules.md`](https://github.com/themachineweb/pagefront/blob/main/commerce/spec/rules.md)
 with its target, check, message and remediation. Every report carries the
 `catalogue_version` it was produced with.
@@ -174,6 +178,59 @@ Added in 0.12.0 (catalogue 0.16.0), with commerce release 0.4.0. Requires
   `1` is not `"1"`.
 - `PDP-E-018` and `ORG-E-004` — the sheet declares a `release` the release
   manifest does not list. At Layer 1 this is a single error at `/release`.
+- `PDP-E-019`, `PDP-E-020`, `PDP-E-021` and `PDP-W-040` (apply from release
+  0.5.0) — "Where to buy" in the Product Sheet spec: an Offer's
+  `checkoutPageURLTemplate` that is not a string, is not a valid RFC 6570
+  template, names a variable other than `quantity`, or does not expand
+  (with `quantity` set to 1) to an absolute https URL; a template on an
+  Offer with neither `areaServed` nor `eligibleRegion`; an Offer `url` that
+  is not an absolute http or https URL; and an Offer without `url` on a
+  sheet carrying several offers.
+
+Added in 0.13.0 (catalogue 0.17.0), released with commerce release 0.5.0,
+with the Commerce Collection Sheet spec
+([`collection.md`](https://github.com/themachineweb/pagefront/blob/main/commerce/spec/collection.md)):
+
+- A third page type. A sheet whose `$schema` path contains
+  `/spec/commerce/collection/`, or whose data block is a `Collection`
+  carrying `pagefront:collectionKind`, lints with the collection catalogue:
+  `COL-E-001` (member entry without `@id`), `COL-E-002` (kind absent or
+  outside the enum), `COL-E-003` and `COL-E-004` (the envelope's version
+  fields), `COL-E-005` (a `hasPart`, `isPartOf` or `brand` sheet URL off its
+  edge's host), `COL-W-001` (empty `hasPart`), `COL-W-002` (member without
+  `pagefront:sheetUrl`), `COL-W-004` (brand reference and brand kind
+  disagree), `COL-W-005` (parent of another kind), `COL-W-006` (duplicate
+  member).
+- `ORG-W-007` — a `hasOfferCatalog` entry whose `pagefront:sheetUrl` is on
+  another host than the canonical host.
+- Until a release bundles the Collection Sheet spec, Layer 1 reports that
+  the declared release bundles no Collection Sheet schema (one error at
+  `/release`), and a legacy-line sheet of that type that the legacy line has
+  no such schema (at `/format_version`).
+- New export: `collectionCatalogue`. `SheetType` gains `"collection"`.
+
+Added in 0.14.0 (catalogue 0.20.0; catalogues 0.18.0 and 0.19.0 were never
+published on their own). Requires `@pagefront/lint-core` 0.4.0, unchanged.
+
+- `PDP-E-022` (applies from release 0.6.0) — "Unavailable offers
+  without a price" in the Product Sheet spec: a `checkoutPageURLTemplate` on
+  an Offer whose `availability` is `OutOfStock`, `SoldOut` or `Discontinued`.
+  From the same change, `PDP-W-016` is silent on such an Offer, which the
+  spec publishes without a price.
+- `PDP-W-041` (applies from release 0.6.0) — a purchase URL off the
+  canonical host: an Offer's `url`, or its `checkoutPageURLTemplate`
+  expanded with `quantity` set to 1, on another host than the canonical
+  host. The linter cannot see the seller's `pagefront:checkoutHosts`.
+- `ORG-W-008` (applies from release 0.6.0) — `pagefront:checkoutHosts`
+  without the `seller` role, and one finding per entry that is not a bare
+  host (not a string, empty, or carrying a scheme, a path or a port).
+- `COL-W-007` (applies from release 0.5.0) — a parent entry in `isPartOf`
+  without `pagefront:sheetUrl`, or with a blank one: the counterpart of
+  `COL-W-002` for a sheet's parents. A category's parents are category
+  sheets, so the producer that emitted the sheet knows their addresses.
+- The three rules gated to release 0.6.0 wait for that release: the bundled
+  release manifest has no 0.6.0 row yet, and a sheet declaring 0.6.0 fails
+  Layer 1 (`PDP-E-018`, `ORG-E-004`) until it lands.
 
 Changed in 0.12.1 (catalogue 0.16.1):
 
@@ -216,11 +273,13 @@ internal):
   `/spec/commerce/product/` or `/schemas/product/` path likewise wins
   for `"product"`), falling back to a data block whose `@type` is
   `Organization`/`OnlineStore`/`OnlineBusiness` with
-  `pagefront:commerceRole` present; `"product"` otherwise.
-- `commerceCatalogue`, `organizationCatalogue` — the per-page-type
-  catalogue objects (read-only), for direct engine use or
-  introspection. Product rules never run on organization sheets and
-  vice versa.
+  `pagefront:commerceRole` present, or `"collection"` for a
+  `/spec/commerce/collection/` path or a `Collection` data block with
+  `pagefront:collectionKind` present; `"product"` otherwise.
+- `commerceCatalogue`, `organizationCatalogue`, `collectionCatalogue` —
+  the per-page-type catalogue objects (read-only), for direct engine use
+  or introspection. No page type's rules run on another page type's
+  sheets.
 - Types: `SchemaError`, `ValidateAndLintResult`,
   `ValidateOrganizationResult`, `SheetType`, and the core types the
   signatures mention — `Report`, `Finding`, `Summary`, `Severity`,

package/dist/catalogue.js

@@ -17,6 +17,10 @@ import { pdpE015 } from "./rules/pdp-e-015.js";
 import { pdpE016 } from "./rules/pdp-e-016.js";
 import { pdpE017 } from "./rules/pdp-e-017.js";
 import { pdpE018 } from "./rules/pdp-e-018.js";
+import { pdpE019 } from "./rules/pdp-e-019.js";
+import { pdpE020 } from "./rules/pdp-e-020.js";
+import { pdpE021 } from "./rules/pdp-e-021.js";
+import { pdpE022 } from "./rules/pdp-e-022.js";
 import { pdpW001 } from "./rules/pdp-w-001.js";
 import { pdpW002 } from "./rules/pdp-w-002.js";
 import { pdpW003 } from "./rules/pdp-w-003.js";
@@ -56,6 +60,8 @@ import { pdpW036 } from "./rules/pdp-w-036.js";
 import { pdpW037 } from "./rules/pdp-w-037.js";
 import { pdpW038 } from "./rules/pdp-w-038.js";
 import { pdpW039 } from "./rules/pdp-w-039.js";
+import { pdpW040 } from "./rules/pdp-w-040.js";
+import { pdpW041 } from "./rules/pdp-w-041.js";
 import { pdpI001 } from "./rules/pdp-i-001.js";
 /**
  * The commerce product-sheet rule catalogue — the executable form of
@@ -67,6 +73,6 @@ import { pdpI001 } from "./rules/pdp-i-001.js";
 export const commerceCatalogue = {
     vertical: "commerce",
     releases: KNOWN_RELEASES,
-    catalogueVersion: "0.16.1",
-    rules: [pdpE001, pdpE002, pdpE003, pdpE004, pdpE005, pdpE006, pdpE007, pdpE008, pdpE009, pdpE010, pdpE011, pdpE012, pdpE013, pdpE014, pdpE015, pdpE016, pdpE017, pdpE018, pdpW001, pdpW002, pdpW003, pdpW004, pdpW005, pdpW006, pdpW007, pdpW008, pdpW009, pdpW010, pdpW011, pdpW012, pdpW013, pdpW014, pdpW015, pdpW016, pdpW017, pdpW018, pdpW019, pdpW020, pdpW021, pdpW022, pdpW023, pdpW024, pdpW025, pdpW026, pdpW027, pdpW028, pdpW029, pdpW030, pdpW031, pdpW032, pdpW033, pdpW034, pdpW035, pdpW036, pdpW037, pdpW038, pdpW039, pdpI001],
+    catalogueVersion: "0.20.0",
+    rules: [pdpE001, pdpE002, pdpE003, pdpE004, pdpE005, pdpE006, pdpE007, pdpE008, pdpE009, pdpE010, pdpE011, pdpE012, pdpE013, pdpE014, pdpE015, pdpE016, pdpE017, pdpE018, pdpE019, pdpE020, pdpE021, pdpE022, pdpW001, pdpW002, pdpW003, pdpW004, pdpW005, pdpW006, pdpW007, pdpW008, pdpW009, pdpW010, pdpW011, pdpW012, pdpW013, pdpW014, pdpW015, pdpW016, pdpW017, pdpW018, pdpW019, pdpW020, pdpW021, pdpW022, pdpW023, pdpW024, pdpW025, pdpW026, pdpW027, pdpW028, pdpW029, pdpW030, pdpW031, pdpW032, pdpW033, pdpW034, pdpW035, pdpW036, pdpW037, pdpW038, pdpW039, pdpW040, pdpW041, pdpI001],
 };

package/dist/collection-catalogue.d.ts

@@ -0,0 +1,15 @@
+import type { Catalogue } from "@pagefront/lint-core";
+/**
+ * The Commerce Collection Sheet rule catalogue — the executable form
+ * of the "Commerce Collection Sheet rules" section of
+ * commerce/spec/rules.md (normative). It shares rules.md's catalogue
+ * version with the product and organization catalogues: one normative
+ * document, one version, three page-type rule sets dispatched by sheet
+ * type (see sheet-type.ts). No page type's rules run on another page
+ * type's sheets.
+ *
+ * COL-W-003 is reserved in rules.md and awaits implementation: a root
+ * category absent from the organization sheet's `hasOfferCatalog` needs
+ * both sheets, which a single-sheet linter does not have.
+ */
+export declare const collectionCatalogue: Catalogue;

package/dist/collection-catalogue.js

@@ -0,0 +1,31 @@
+import { KNOWN_RELEASES } from "./releases.js";
+import { colE001 } from "./rules/col-e-001.js";
+import { colE002 } from "./rules/col-e-002.js";
+import { colE003 } from "./rules/col-e-003.js";
+import { colE004 } from "./rules/col-e-004.js";
+import { colE005 } from "./rules/col-e-005.js";
+import { colW001 } from "./rules/col-w-001.js";
+import { colW002 } from "./rules/col-w-002.js";
+import { colW004 } from "./rules/col-w-004.js";
+import { colW005 } from "./rules/col-w-005.js";
+import { colW006 } from "./rules/col-w-006.js";
+import { colW007 } from "./rules/col-w-007.js";
+/**
+ * The Commerce Collection Sheet rule catalogue — the executable form
+ * of the "Commerce Collection Sheet rules" section of
+ * commerce/spec/rules.md (normative). It shares rules.md's catalogue
+ * version with the product and organization catalogues: one normative
+ * document, one version, three page-type rule sets dispatched by sheet
+ * type (see sheet-type.ts). No page type's rules run on another page
+ * type's sheets.
+ *
+ * COL-W-003 is reserved in rules.md and awaits implementation: a root
+ * category absent from the organization sheet's `hasOfferCatalog` needs
+ * both sheets, which a single-sheet linter does not have.
+ */
+export const collectionCatalogue = {
+    vertical: "commerce",
+    releases: KNOWN_RELEASES,
+    catalogueVersion: "0.20.0",
+    rules: [colE001, colE002, colE003, colE004, colE005, colW001, colW002, colW004, colW005, colW006, colW007],
+};

package/dist/generated/release-manifest.d.ts

@@ -18,6 +18,15 @@ export declare const RELEASE_MANIFEST: {
             readonly product: "0.10.0";
             readonly organization: "0.4.0";
         };
+    }, {
+        readonly release: "0.5.0";
+        readonly date: "2026-10-18";
+        readonly vocabulary: "0.5.0";
+        readonly sheets: {
+            readonly product: "0.11.0";
+            readonly organization: "0.5.0";
+            readonly collection: "0.1.0";
+        };
     }];
     readonly legacy: {
         readonly envelope_field: "format_version";

package/dist/generated/release-manifest.js

@@ -21,6 +21,16 @@ export const RELEASE_MANIFEST = {
                 "product": "0.10.0",
                 "organization": "0.4.0"
             }
+        },
+        {
+            "release": "0.5.0",
+            "date": "2026-10-18",
+            "vocabulary": "0.5.0",
+            "sheets": {
+                "product": "0.11.0",
+                "organization": "0.5.0",
+                "collection": "0.1.0"
+            }
         }
     ],
     "legacy": {

package/dist/generated/schema-ids.js

@@ -1,9 +1,12 @@
 // Generated by scripts/bundle-schemas.mjs; do not edit, do not commit.
 export const SCHEMA_IDS = [
+    "https://themachineweb.org/pagefront/spec/commerce/collection/v0.1.0.json",
     "https://themachineweb.org/pagefront/spec/commerce/organization/v0.3.0.json",
     "https://themachineweb.org/pagefront/spec/commerce/organization/v0.4.0.json",
+    "https://themachineweb.org/pagefront/spec/commerce/organization/v0.5.0.json",
     "https://themachineweb.org/pagefront/spec/commerce/organization/v0.9.json",
     "https://themachineweb.org/pagefront/spec/commerce/product/v0.10.0.json",
+    "https://themachineweb.org/pagefront/spec/commerce/product/v0.11.0.json",
     "https://themachineweb.org/pagefront/spec/commerce/product/v0.9.0.json",
     "https://themachineweb.org/pagefront/spec/commerce/product/v0.9.json"
 ];