@pagefront/lint-commerce 0.9.0 → 0.11.0

package/README.md

@@ -26,9 +26,11 @@ lint with their own catalogue, dispatched by sheet type.
 
 ## Catalogue
 
-Catalogue 0.14.0, targeting format 0.9: 55 product rules (`PDP-E-001` to
-`PDP-E-015`, `PDP-W-001` to `PDP-W-039`, `PDP-I-001`) and 7 organization
-rules (`ORG-E-001`, `ORG-W-001` to `ORG-W-006`), each defined in
+Catalogue 0.15.0, supporting commerce release 0.3.0 (Product Sheet spec
+0.9.0, Organization Sheet spec 0.3.0) and the legacy draft line (format
+0.9): 56 product rules (`PDP-E-001` to `PDP-E-016`, `PDP-W-001` to
+`PDP-W-039`, `PDP-I-001`) and 9 organization rules (`ORG-E-001` to
+`ORG-E-003`, `ORG-W-001` to `ORG-W-006`), 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.
@@ -120,29 +122,65 @@ prices, bounds and base prices no longer accept a negative amount.
 - `PDP-W-039` — size advice carries a `description` and no
   `sizeAdjustment` beside a sizing dimension
 
+Added in 0.10.0 (catalogue 0.15.0), with commerce release 0.3.0 and the
+[versioning scheme](https://github.com/themachineweb/pagefront/blob/main/commerce/spec/releases.md)
+that replaces format versions:
+
+- Sheets carry `release` in place of `format_version`, and `$schema` names
+  the sheet-spec version (`product/v0.9.0.json`, `organization/v0.3.0.json`).
+  Sheets carrying `format_version` are the legacy draft line and keep
+  validating against the bundled legacy schemas.
+- `PDP-E-002` becomes "Release / schema mismatch": `$schema` must name the
+  sheet-spec version the release manifest maps the declared `release` to.
+  On legacy sheets it compares `format_version` with `$schema`, as before.
+  `ORG-E-003` is the same check for Organization Sheets.
+- `PDP-E-016` and `ORG-E-002` — a sheet carries both `format_version` and
+  `release`
+- **Breaking:** the report carries `release` (the value the sheet declares;
+  a legacy sheet's `format_version` value) and `sheet_spec_version` (parsed
+  from `$schema`) in place of `spec_version`. Requires
+  `@pagefront/lint-core` 0.2.0.
+- New exports: `detectSheetLine`, `RELEASE_MANIFEST`, `KNOWN_RELEASES`,
+  `sheetSpecVersionFor`.
+
+Changed in 0.11.0 (catalogue 0.15.0, unchanged):
+
+- Layer 1 validates a sheet against the published schema its `$schema`
+  names. The package bundles every file in the repository's frozen schema
+  store (`commerce/schemas/`) at build time, with the release manifest;
+  nothing is embedded by hand.
+- A `$schema` naming no bundled schema fails Layer 1 with one error. In
+  0.10.0 the schema was chosen from the envelope field, so a release
+  sheet pointing at another version passed Layer 1 and fired `PDP-E-002`;
+  it now fails Layer 1 against the schema it names.
+- New exports: `CURRENT_RELEASE`, `schemaUrlFor`, `BUNDLED_SCHEMA_IDS`.
+
 ## API
 
 The public surface — everything importable from the package root, and
-nothing else (the bundled schema and the individual rule modules are
+nothing else (the bundled schemas and the individual rule modules are
 internal):
 
 - `validateAndLint(input: unknown, options?: LintOptions)` — the CLI's
-  own pipeline as a function: Layer 1 against the bundled schema for
-  the document's page type, then Layer 2 against that page type's
-  catalogue. Product sheets route to the product schema and catalogue,
-  Commerce Organization Sheets to the organization ones (see
-  `detectSheetType`). Returns
+  own pipeline as a function: Layer 1 against the published schema the
+  document's `$schema` names, then Layer 2 against its page type's
+  catalogue (see `detectSheetType`). Returns
   `{ layer: 1, schemaErrors: SchemaError[] }` or
-  `{ layer: 2, report: Report }`. The bundled schemas are the current
-  format version; a document declaring another `format_version` fails
-  Layer 1 by design. Layer 1 runs validators compiled ahead of time at
+  `{ layer: 2, report: Report }`. The package bundles every published
+  schema, on both lines: the sheet-spec versions of each release and the
+  legacy format 0.9 schemas. A `$schema` naming a version the package
+  does not bundle fails Layer 1 with a single error at `/$schema`
+  (keyword `$schema`); the document is not validated against another
+  version. A document with no `$schema` is validated against the schema
+  its `release` or `format_version` leads to.
+  Layer 1 runs validators compiled ahead of time at
   package build, so the pipeline needs no runtime code generation and
   runs under Cloudflare Workers and strict Content Security Policies.
 - `lintSheet(sheet: Sheet, options?: LintOptions): Report` — Layer 2
   only, for input you have already schema-validated. Dispatches to the
   page type's catalogue the same way.
 - `validateOrganizationSheet(input: unknown)` — Layer 1 only, against
-  the bundled Commerce Organization Sheet schema. Returns
+  the Commerce Organization Sheet schema the document names. Returns
   `{ valid: true }` or `{ valid: false, schemaErrors: SchemaError[] }`.
 - `detectSheetType(sheet: Sheet): SheetType` — the page-type dispatch:
   `"organization"` when the envelope `$schema` path contains
@@ -211,6 +249,12 @@ await writeFile("report.html", renderHtml(report));
 
 ## Versioning
 
+This package has its own semver, separate from the rule catalogue's
+(`catalogue_version` in every report) and from the commerce release and
+sheet-spec versions a sheet declares (`release` and `sheet_spec_version`
+in every report). The scheme is in
+[`releases.md`](https://github.com/themachineweb/pagefront/blob/main/commerce/spec/releases.md).
+
 Pre-1.0: minor versions may break the API. The surface listed above is
 what versioning tracks — imports that reach past it (`dist/` paths,
 rule modules) are internal and may change without notice in any

package/dist/catalogue.js

@@ -1,3 +1,4 @@
+import { KNOWN_RELEASES } from "./releases.js";
 import { pdpE001 } from "./rules/pdp-e-001.js";
 import { pdpE002 } from "./rules/pdp-e-002.js";
 import { pdpE003 } from "./rules/pdp-e-003.js";
@@ -13,6 +14,7 @@ import { pdpE012 } from "./rules/pdp-e-012.js";
 import { pdpE013 } from "./rules/pdp-e-013.js";
 import { pdpE014 } from "./rules/pdp-e-014.js";
 import { pdpE015 } from "./rules/pdp-e-015.js";
+import { pdpE016 } from "./rules/pdp-e-016.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";
@@ -62,7 +64,7 @@ import { pdpI001 } from "./rules/pdp-i-001.js";
  */
 export const commerceCatalogue = {
     vertical: "commerce",
-    formatVersion: "0.9",
-    catalogueVersion: "0.14.0",
-    rules: [pdpE001, pdpE002, pdpE003, pdpE004, pdpE005, pdpE006, pdpE007, pdpE008, pdpE009, pdpE010, pdpE011, pdpE012, pdpE013, pdpE014, pdpE015, 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],
+    releases: KNOWN_RELEASES,
+    catalogueVersion: "0.15.0",
+    rules: [pdpE001, pdpE002, pdpE003, pdpE004, pdpE005, pdpE006, pdpE007, pdpE008, pdpE009, pdpE010, pdpE011, pdpE012, pdpE013, pdpE014, pdpE015, pdpE016, 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],
 };

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

@@ -0,0 +1,22 @@
+export declare const RELEASE_MANIFEST: {
+    readonly $comment: "The commerce release manifest: each release and the member versions it bundles. Consumed by the linter; the human-readable form is releases.md.";
+    readonly vertical: "commerce";
+    readonly schema_url_template: "https://themachineweb.org/pagefront/spec/commerce/{sheet}/v{version}.json";
+    readonly releases: readonly [{
+        readonly release: "0.3.0";
+        readonly date: "2026-10-01";
+        readonly vocabulary: "0.3.0";
+        readonly sheets: {
+            readonly product: "0.9.0";
+            readonly organization: "0.3.0";
+        };
+    }];
+    readonly legacy: {
+        readonly envelope_field: "format_version";
+        readonly format_versions: readonly ["0.9"];
+        readonly schemas: {
+            readonly product: "https://themachineweb.org/pagefront/spec/commerce/product/v0.9.json";
+            readonly organization: "https://themachineweb.org/pagefront/spec/commerce/organization/v0.9.json";
+        };
+    };
+};

package/dist/generated/release-manifest.js

@@ -0,0 +1,27 @@
+// Generated by scripts/bundle-schemas.mjs; do not edit, do not commit.
+export const RELEASE_MANIFEST = {
+    "$comment": "The commerce release manifest: each release and the member versions it bundles. Consumed by the linter; the human-readable form is releases.md.",
+    "vertical": "commerce",
+    "schema_url_template": "https://themachineweb.org/pagefront/spec/commerce/{sheet}/v{version}.json",
+    "releases": [
+        {
+            "release": "0.3.0",
+            "date": "2026-10-01",
+            "vocabulary": "0.3.0",
+            "sheets": {
+                "product": "0.9.0",
+                "organization": "0.3.0"
+            }
+        }
+    ],
+    "legacy": {
+        "envelope_field": "format_version",
+        "format_versions": [
+            "0.9"
+        ],
+        "schemas": {
+            "product": "https://themachineweb.org/pagefront/spec/commerce/product/v0.9.json",
+            "organization": "https://themachineweb.org/pagefront/spec/commerce/organization/v0.9.json"
+        }
+    }
+};

package/dist/generated/schema-ids.d.ts

@@ -0,0 +1 @@
+export declare const SCHEMA_IDS: readonly string[];

package/dist/generated/schema-ids.js

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

package/dist/generated/schema-properties.d.ts

@@ -0,0 +1 @@
+export declare const DATA_BLOCK_PROPERTIES: readonly string[];

package/dist/{schema-properties.js → generated/schema-properties.js}

@@ -1,12 +1,4 @@
-/**
- * The data-block property inventory for PDP-I-001, derived from the
- * Pagefront JSON Schema (commerce/spec/product.json, format 0.9) —
- * the normative property inventory per the catalogue's Definitions
- * section. Generated from `$defs.dataBlock.properties`; the
- * inventory drift test (test/inventory.test.mjs) fails when the
- * schema and this list diverge. Regenerate on schema change, in the
- * same catalogue-versioned change.
- */
+// Generated by scripts/bundle-schemas.mjs; do not edit, do not commit.
 export const DATA_BLOCK_PROPERTIES = [
     "@context",
     "@id",
@@ -64,5 +56,5 @@ export const DATA_BLOCK_PROPERTIES = [
     "variesBy",
     "video",
     "weight",
-    "width",
+    "width"
 ];

package/dist/generated/schemas.d.ts

@@ -0,0 +1 @@
+export declare const SCHEMAS: Readonly<Record<string, Record<string, unknown>>>;