@pagefront/lint-commerce 0.10.0 → 0.12.0

package/dist/rules/pdp-w-006.js

@@ -27,5 +27,7 @@ export const pdpW006 = {
     messageTemplate: "Certification `{name}` at `{path}` has no scope declared.",
     remediation: "Add a `PropertyValue` to `additionalProperty` with name `scope` and a value drawn from the conventional vocabulary (`yarn`, `fabric`, `finished_product`, `diamond`, `gemstone`, etc.).",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "vocabulary.md#certification-scope",
 };

package/dist/rules/pdp-w-007.js

@@ -25,5 +25,7 @@ export const pdpW007 = {
     messageTemplate: "ProductGroup at `{path}` has only one variant.",
     remediation: "Either add the missing variants to `hasVariant`, or change `@type` to `Product` and model the single variant directly. The `productGroupID` field should be replaced with `productID` or `sku` if switching to Product.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-vs-productgroup-guidance",
 };

package/dist/rules/pdp-w-008.js

@@ -39,5 +39,7 @@ export const pdpW008 = {
     messageTemplate: "Sheet `expires_at` is `{expires_at}`, which is {reason}.",
     remediation: "Set `expires_at` to a sensible window after `generated_at`. For static product catalogs, hours to days; for sheets with live pricing or inventory signals, minutes.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#the-envelope",
 };

package/dist/rules/pdp-w-009.js

@@ -25,5 +25,7 @@ export const pdpW009 = {
     messageTemplate: "ProductGroup at `{path}` has no variants.",
     remediation: "Add variant entries to `hasVariant`. If the product genuinely has no variants, change `@type` to `Product`.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-vs-productgroup-guidance",
 };

package/dist/rules/pdp-w-010.js

@@ -81,5 +81,7 @@ export const pdpW010 = {
     messageTemplate: "Dimension `{dimension}` is declared in both `pagefront:configurator` at `{configurator_path}` and as a variant property at `{variant_path}`.",
     remediation: "Choose one representation. Use the configurator for combinatorial spaces, made-to-order products, or continuous dimensions. Use `ProductGroup` + `hasVariant` for discrete SKU families that ship from inventory.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-vs-productgroup-guidance",
 };

package/dist/rules/pdp-w-011.js

@@ -40,5 +40,7 @@ export const pdpW011 = {
     messageTemplate: "Sheet at `{canonical_url}` appears to be part of a multi-language site but does not declare `pagefront:availableLanguages`.",
     remediation: "Add a `pagefront:availableLanguages` array listing the URLs of sibling sheets in other languages, with their BCP 47 language tags.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#internationalization",
 };

package/dist/rules/pdp-w-012.js

@@ -47,5 +47,7 @@ export const pdpW012 = {
     messageTemplate: "Video at `{path}` with role `{role}` has no caption or transcript.",
     remediation: "Add a `caption` field with a 1–3 sentence summary of the video's content, or a `transcript` field with the full spoken content. For overview and tutorial videos, at least one is strongly recommended.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#accessibility",
 };

package/dist/rules/pdp-w-013.js

@@ -21,5 +21,7 @@ export const pdpW013 = {
     messageTemplate: "Legacy HTTP Schema.org URI `{value}` at `{path}`.",
     remediation: "Change `http://schema.org/...` to `https://schema.org/...`. The value is otherwise unchanged.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#offers",
 };

package/dist/rules/pdp-w-014.js

@@ -65,5 +65,7 @@ export const pdpW014 = {
     messageTemplate: "ProductGroup at `{path}` has `{count}` variants with no declared per-variant `url`s. If each variant is genuinely reachable at its own address — its own page or a variant-selecting parameter — declare it in the variant's `url` field; a fragment `@id` identifies the variant but does not promise it is addressable.",
     remediation: "For each variant entry in `hasVariant`, add a `url` field with the variant's addressable URL — its own page (case 3) or the shared page with its variant-selecting query parameter (case 2). If all variants share the exact same URL with no parameter-based differentiation (case 1), the per-variant `url` field can be omitted.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#per-variant-urls",
 };

package/dist/rules/pdp-w-015.js

@@ -29,5 +29,7 @@ export const pdpW015 = {
     messageTemplate: "Price-on-request at `{path}` declares method `{method}` but no contact channel (`contactUrl`, `contactEmail`, or `contactPhone`).",
     remediation: "Add the contact channel matching the declared method (e.g., `contactUrl` for `authorized_retailer` and `dealer_network`, `contactEmail` for `email`, `contactPhone` for `phone`, `contactUrl` for `quote_form`). If no such channel exists, change `method` to `unspecified`.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#price-on-request-offers",
 };

package/dist/rules/pdp-w-016.js

@@ -26,5 +26,7 @@ export const pdpW016 = {
     messageTemplate: "Offer at `{path}` has commercial structure (availability, priceCurrency) but no price declaration (no `price`, no `priceSpecification`, no `pagefront:priceOnRequest`).",
     remediation: "Add `price` (and confirm `priceCurrency`) if the price was missed during extraction. If the merchant intentionally publishes no price, declare `pagefront:priceOnRequest` with an appropriate `method` and contact channel.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#price-on-request-offers",
 };

package/dist/rules/pdp-w-017.js

@@ -51,5 +51,7 @@ export const pdpW017 = {
     messageTemplate: 'Language tag at `{path}` uses non-canonical case: `"{value}"`. Canonical form is `"{canonical}"`.',
     remediation: "Normalize the tag to canonical BCP 47 case. The semantic meaning is unchanged; only the case differs.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#upstream-equivalent-forms",
 };

package/dist/rules/pdp-w-018.js

@@ -28,5 +28,7 @@ export const pdpW018 = {
     messageTemplate: "Variant at `{path}` has no `url`, but other variants in the same ProductGroup declare one.",
     remediation: "Add a `url` to this variant matching its distinct addressable page state, consistent with its siblings. If this variant genuinely shares the exact same URL as the others with no parameter-based differentiation (case 1 in the spec), the per-variant `url` should instead be omitted from *all* entries so presence is uniform.",
     introduced: "v0.7",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#per-variant-urls",
 };

package/dist/rules/pdp-w-019.js

@@ -45,5 +45,7 @@ export const pdpW019 = {
     messageTemplate: "`pagefront:relatedProduct` entry `{name}` at `{path}` carries an identifier field that is present but empty or non-dereferenceable, so it has no usable structured identifier.",
     remediation: "Supply a real, dereferenceable identifier — a URL-shaped `@id`, or a non-empty `sku`, `gtin`, `gtin13`, or `mpn`. If no structured identifier is available for this reference, it does not meet `pagefront:relatedProduct`'s requirement: move it to Schema.org's native `isRelatedTo` (which carries no identifier requirement) and drop the `relationship` typing.",
     introduced: "v0.7",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#the-structured-identifier-requirement",
 };

package/dist/rules/pdp-w-020.js

@@ -60,5 +60,7 @@ export const pdpW020 = {
     messageTemplate: "Relationship reference `{name}` at `{path}` in `{field}` {problem}.",
     remediation: "Add at least one identifying field — `@id`, `url`, `name`, `sku`, `gtin`, `gtin13`, or `mpn` — so the reference is dereferenceable, displayable, or matchable. If the `@id` was meant to name an entity in this Sheet, correct it to match a declared `@id` or add that entity; if it was meant to point at another product, use the target's full URL.",
     introduced: "v0.7",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#five-patterns-for-product-to-product-relationships",
 };

package/dist/rules/pdp-w-021.js

@@ -49,5 +49,7 @@ export const pdpW021 = {
     messageTemplate: "Variant link `{name}` at `{path}` appears to reference a separate Sheet by `@id` but omits the recommended `sheet_url`; consumers must reach the target Sheet via `url` + `describedby`.",
     remediation: "Add `sheet_url` with the target's Sheet URL — the variant's Sheet URL on a parent `hasVariant` entry, or the parent's Sheet URL on a variant's `isVariantOf`. If you do not emit a separate Sheet for the target (the family is modeled inline in one ProductGroup Sheet), no cross-Sheet link exists and `sheet_url` does not apply.",
     introduced: "v0.7",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#multi-sheet-variant-families",
 };

package/dist/rules/pdp-w-022.js

@@ -21,5 +21,7 @@ export const pdpW022 = {
     messageTemplate: "`pagefront:productHighlights[{index}]` is empty or whitespace-only; highlights must carry the publisher's selling-point text.",
     remediation: "Populate the entry with the highlight text from the merchant's page, or remove the entry. If the pipeline cannot recover the text, drop the entry rather than emitting a placeholder — a shorter honest list beats a ranked list with blanks.",
     introduced: "v0.8",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#product-highlights",
 };

package/dist/rules/pdp-w-023.js

@@ -35,5 +35,7 @@ export const pdpW023 = {
     messageTemplate: "Recall safety notice at `{path}` coexists with offer at `{offerPath}` declaring `InStock`; the recall overrides commercial signals and the offer data likely needs updating.",
     remediation: "Update the offer's `availability` to reflect the corrective measure (typically `Discontinued` or `OutOfStock`). If the recall has been resolved and the product legitimately relisted, remove the stale `pagefront:safetyNotice` entry instead.",
     introduced: "v0.8",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#safety-notices",
 };

package/dist/rules/pdp-w-024.js

@@ -54,5 +54,7 @@ export const pdpW024 = {
     messageTemplate: "`pagefront:legalEntity` entry with role `{role}` at `{path}` declares an organization without an `address`.",
     remediation: "Add the entity's postal address to the `organization`. If no address is available, the entry still identifies the organization but should not be relied on as a regulatory responsible-person declaration.",
     introduced: "v0.8",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#legal-entities",
 };

package/dist/rules/pdp-w-025.js

@@ -31,5 +31,7 @@ export const pdpW025 = {
     messageTemplate: "Feature `{name}` at `{path}` carries value `{value}`, which parses as a number plus a unit.",
     remediation: "Move the numeric part into `value`, express the unit as a `unitCode`, and if the merchant's display formatting matters, carry the original string in `pagefront:presentationValue`.",
     introduced: "v0.8",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#feature-groups",
 };

package/dist/rules/pdp-w-026.js

@@ -27,5 +27,7 @@ export const pdpW026 = {
     messageTemplate: "Safety data sheet at `{path}` declares no `inLanguage`.",
     remediation: "Add the document's BCP 47 language tag as `inLanguage`. If the document is multilingual, declare the primary language.",
     introduced: "v0.8",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#documents",
 };

package/dist/rules/pdp-w-027.js

@@ -43,5 +43,7 @@ export const pdpW027 = {
     messageTemplate: "Question `{name}` at `{path}` has an `acceptedAnswer` with no text.",
     remediation: "Populate `acceptedAnswer.text` with the answer prose, or remove the `acceptedAnswer` (and consider whether an unanswered question belongs in the sheet at all).",
     introduced: "v0.8",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#product-qa",
 };

package/dist/rules/pdp-w-028.js

@@ -25,5 +25,7 @@ export const pdpW028 = {
     messageTemplate: "Offer at `{path}` states a price but not whether value-added tax is included.",
     remediation: "Add a `UnitPriceSpecification` entry mirroring `price` with `valueAddedTaxIncluded` set to `true` or `false`; on an Offer that already uses `priceSpecification`, set the flag on each entry.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#tax-inclusion",
 };

package/dist/rules/pdp-w-029.js

@@ -24,5 +24,7 @@ export const pdpW029 = {
     messageTemplate: "Offer at `{path}` states a price but no region it applies to.",
     remediation: "Declare `areaServed` (or `eligibleRegion`) for the market whose displayed price this is. Where the market cannot be determined from the storefront, stating the tax basis via `valueAddedTaxIncluded` is the higher priority; see \"Tax inclusion.\"",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#tax-inclusion",
 };

package/dist/rules/pdp-w-030.js

@@ -48,5 +48,7 @@ export const pdpW030 = {
     messageTemplate: "Warranty at `{path}` states neither a duration nor a description.",
     remediation: "State the warranty as written in `description`, and add `durationOfWarranty` where a finite length is stated. A lifetime warranty carries `description` (and optionally `name`) with no `durationOfWarranty`.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#warranty",
 };

package/dist/rules/pdp-w-031.js

@@ -31,5 +31,7 @@ export const pdpW031 = {
     messageTemplate: "Seller at `{path}` has an `@id` but no `pagefront:sheetUrl`, and the Offer states no return or shipping terms of its own.",
     remediation: "Add `pagefront:sheetUrl` to the seller reference, or state the terms on the Offer.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#linking-contract-identity-only",
 };

package/dist/rules/pdp-w-032.js

@@ -46,5 +46,7 @@ export const pdpW032 = {
     messageTemplate: "Pricing block at `{path}` {problem}, and `pricing` is not `partial`.",
     remediation: "State the modifier, zero included; for a text dimension, state it under the key `\"*\"`. If the dimension never changes the price, declare `affectsPrice: false` on it. If the price is not known, declare `pricing: \"partial\"`.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-pricing-and-price-bands",
 };

package/dist/rules/pdp-w-033.js

@@ -26,5 +26,7 @@ export const pdpW033 = {
     messageTemplate: "Configurator at `{path}` has priced dimensions but no offer prices it.",
     remediation: "Add an offer carrying `pagefront:configuratorPricing` for this configurator. If no option changes the price, declare `affectsPrice: false` on each dimension.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-pricing-and-price-bands",
 };

package/dist/rules/pdp-w-034.js

@@ -24,5 +24,7 @@ export const pdpW034 = {
     messageTemplate: "Offer price is not linked to the configurator; state which configuration it prices.",
     remediation: "Add `pagefront:configuratorPricing` to the offer: give the configurator an `@id`, reference it, and name the configuration the price is the total of. When only that one total is known, declare `pricing: \"partial\"`.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-pricing-and-price-bands",
 };

package/dist/rules/pdp-w-035.js

@@ -37,5 +37,7 @@ export const pdpW035 = {
     messageTemplate: "basePrice may be a component price, not a configured total.",
     remediation: "Confirm that `basePrice` is what a buyer pays for the whole of `baseConfiguration`. If it is the price of one part, replace it with the configured total and recompute the modifiers as differences from that total.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-pricing-and-price-bands",
 };

package/dist/rules/pdp-w-036.js

@@ -27,5 +27,7 @@ export const pdpW036 = {
     messageTemplate: "Option value should be a stable identifier; put the label in description.",
     remediation: "Replace the value with a lowercase identifier without spaces (`yellow_gold`, `0.5`) and move the label to `description`. Put a unit in the dimension's `note`. Update the pricing block's keys, `baseConfiguration`, `when` and `exclusions` to the new value.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-pricing-and-price-bands",
 };

package/dist/rules/pdp-w-037.js

@@ -33,5 +33,7 @@ export const pdpW037 = {
     messageTemplate: "Option does not look like a size in the declared system.",
     remediation: "Remove the entry if it is a service, and describe the service in the dimension's `note` or in `pagefront:madeToOrderTerms.aftermarketServices`. If it is a size, write it as the system writes it, without the system's name.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-pricing-and-price-bands",
 };

package/dist/rules/pdp-w-038.js

@@ -26,5 +26,7 @@ export const pdpW038 = {
     messageTemplate: "Note reads as page copy; state the fact.",
     remediation: "Restate the note as a fact in the third person: what the merchant offers or recommends, with no \"you\" and no instruction.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#configurator-pricing-and-price-bands",
 };

package/dist/rules/pdp-w-039.js

@@ -25,5 +25,7 @@ export const pdpW039 = {
     messageTemplate: "Size advice at `{path}` could not be stated in the Sheet's sizing system (`{system}`); it is carried as prose only.",
     remediation: "If the merchant states the advice in the sizing dimension's system, add a `sizeAdjustment` in that system. If it does not, no action: do not convert between systems.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#size-guidance-pagefrontsizechart-and-pagefrontsizerecommendation",
 };

package/dist/rules/release-schema.d.ts

@@ -1,16 +1,27 @@
 import type { CheckFn, Rule } from "@pagefront/lint-core";
 import type { SheetType } from "../sheet-type.js";
 /**
- * Release / schema mismatch. On the release line the `$schema` version
- * segment must be the sheet-spec version the release manifest maps the
- * declared `release` and the sheet type to; a release the manifest does
- * not list has no mapping and the rule is silent. On the legacy line
- * the segment must equal `format_version`, as before. Quiet when
- * `$schema` is absent or names no version, and when the sheet carries
- * both fields (the both-fields rule reports that).
+ * Release / schema mismatch. The rule reads `$schema` and is quiet
+ * whenever it is absent, on both lines: whether `$schema` is required is
+ * the schema's own statement (Product Sheet spec 0.10.0 and Organization
+ * Sheet spec 0.4.0 onward), not this rule's. On the release line a
+ * present `$schema` must be the URL of the sheet-spec schema the release
+ * manifest maps the declared `release` and the sheet type to; a release
+ * the manifest does not list has no mapping (the unknown-release rule
+ * reports it). On the legacy line the `$schema` version segment must
+ * equal `format_version`, as before. Quiet when the sheet carries both
+ * fields (the both-fields rule reports that).
  */
 export declare function releaseSchemaMismatch(sheetType: SheetType): CheckFn;
 export declare const RELEASE_SCHEMA_MISMATCH: Pick<Rule, "title" | "severity" | "target" | "messageTemplate" | "remediation">;
 /** A sheet carrying both `format_version` and `release`. */
 export declare const bothVersionFields: CheckFn;
 export declare const BOTH_VERSION_FIELDS: Pick<Rule, "title" | "severity" | "target" | "messageTemplate" | "remediation">;
+/**
+ * Unknown release: the sheet declares a `release` the release manifest
+ * does not list, so no sheet-spec version and no schema can be resolved
+ * for it. Only a string `release` is judged; another JSON type is
+ * Layer 1's concern.
+ */
+export declare const unknownRelease: CheckFn;
+export declare const UNKNOWN_RELEASE: Pick<Rule, "title" | "severity" | "target" | "messageTemplate" | "remediation">;

package/dist/rules/release-schema.js

@@ -1,4 +1,4 @@
-import { sheetSpecVersionFor } from "../releases.js";
+import { KNOWN_RELEASES, schemaUrlFor, sheetSpecVersionFor } from "../releases.js";
 /**
  * Shared checks for the envelope's version fields, used by the product
  * and organization catalogues (PDP-E-002 / ORG-E-003, PDP-E-016 /
@@ -11,39 +11,59 @@ const SHEET_LABEL = {
     organization: "Organization Sheet",
 };
 /**
- * Release / schema mismatch. On the release line the `$schema` version
- * segment must be the sheet-spec version the release manifest maps the
- * declared `release` and the sheet type to; a release the manifest does
- * not list has no mapping and the rule is silent. On the legacy line
- * the segment must equal `format_version`, as before. Quiet when
- * `$schema` is absent or names no version, and when the sheet carries
- * both fields (the both-fields rule reports that).
+ * Release / schema mismatch. The rule reads `$schema` and is quiet
+ * whenever it is absent, on both lines: whether `$schema` is required is
+ * the schema's own statement (Product Sheet spec 0.10.0 and Organization
+ * Sheet spec 0.4.0 onward), not this rule's. On the release line a
+ * present `$schema` must be the URL of the sheet-spec schema the release
+ * manifest maps the declared `release` and the sheet type to; a release
+ * the manifest does not list has no mapping (the unknown-release rule
+ * reports it). On the legacy line the `$schema` version segment must
+ * equal `format_version`, as before. Quiet when the sheet carries both
+ * fields (the both-fields rule reports that).
  */
 export function releaseSchemaMismatch(sheetType) {
     return (_match, ctx) => {
         const { release, format_version: formatVersion, $schema: schema } = ctx.sheet;
         if (typeof schema !== "string")
             return null;
-        const schemaVersion = SCHEMA_VERSION.exec(schema)?.[1];
-        if (schemaVersion === undefined)
-            return null;
         if (release !== undefined && formatVersion !== undefined)
             return null;
+        const schemaVersion = SCHEMA_VERSION.exec(schema)?.[1];
         if (typeof release === "string") {
             const expected = sheetSpecVersionFor(release, sheetType);
-            if (expected === undefined || expected === schemaVersion)
+            if (expected === undefined)
+                return null;
+            const expectedUrl = schemaUrlFor(sheetType, expected);
+            if (schema === expectedUrl)
                 return null;
+            const declared = `\`release\` \`${release}\` bundles ${SHEET_LABEL[sheetType]} spec \`${expected}\``;
+            if (schemaVersion !== undefined && schemaVersion !== expected) {
+                return {
+                    path: "$['release']",
+                    values: {
+                        declared,
+                        found: `\`$schema\` URL declares version \`${schemaVersion}\``,
+                        release,
+                        expected,
+                        schema_version: schemaVersion,
+                    },
+                };
+            }
             return {
                 path: "$['release']",
                 values: {
-                    declared: `\`release\` \`${release}\` bundles ${SHEET_LABEL[sheetType]} spec \`${expected}\``,
+                    declared,
+                    found: `\`$schema\` is not that schema's URL, \`${expectedUrl}\``,
                     release,
                     expected,
-                    schema_version: schemaVersion,
+                    expected_url: expectedUrl,
                 },
             };
         }
         if (formatVersion !== undefined) {
+            if (schemaVersion === undefined)
+                return null;
             const declared = String(formatVersion);
             if (declared === schemaVersion)
                 return null;
@@ -51,6 +71,7 @@ export function releaseSchemaMismatch(sheetType) {
                 path: "$['format_version']",
                 values: {
                     declared: `\`format_version\` is \`${declared}\``,
+                    found: `\`$schema\` URL declares version \`${schemaVersion}\``,
                     format_version: declared,
                     schema_version: schemaVersion,
                 },
@@ -63,7 +84,7 @@ export const RELEASE_SCHEMA_MISMATCH = {
     title: "Release / schema mismatch",
     severity: "error",
     target: "$",
-    messageTemplate: "{declared} but `$schema` URL declares version `{schema_version}`.",
+    messageTemplate: "{declared} but {found}.",
     remediation: "Point `$schema` at the sheet-spec version the declared release bundles (see releases.md), or declare the release that bundles the schema the sheet was written against. On a legacy sheet, align `format_version` and the `$schema` version.",
 };
 /** A sheet carrying both `format_version` and `release`. */
@@ -75,3 +96,22 @@ export const BOTH_VERSION_FIELDS = {
     messageTemplate: "Sheet carries both `format_version` and `release`; a sheet declares one.",
     remediation: "Keep `release` and remove `format_version`. A sheet on the legacy draft line keeps `format_version` alone and its legacy `$schema`.",
 };
+/**
+ * Unknown release: the sheet declares a `release` the release manifest
+ * does not list, so no sheet-spec version and no schema can be resolved
+ * for it. Only a string `release` is judged; another JSON type is
+ * Layer 1's concern.
+ */
+export const unknownRelease = (_match, ctx) => {
+    const { release } = ctx.sheet;
+    if (typeof release !== "string" || KNOWN_RELEASES.includes(release))
+        return null;
+    return { path: "$['release']", values: { release, known: KNOWN_RELEASES.join(", ") } };
+};
+export const UNKNOWN_RELEASE = {
+    title: "Unknown release",
+    severity: "error",
+    target: "$",
+    messageTemplate: "`release` at `{path}` is `{release}`, which is not a release this catalogue knows ({known}).",
+    remediation: "Declare a published commerce release (see releases.md). If the release is newer than this linter, update the linter.",
+};

package/dist/schema-registry.d.ts

@@ -0,0 +1,42 @@
+import type { Sheet } from "@pagefront/lint-core";
+import type { SheetType } from "./sheet-type.js";
+/**
+ * Which frozen schema a sheet is validated against. The package bundles
+ * every schema ever published (commerce/schemas/), keyed by `$id`. A
+ * sheet is judged by the release it declares: on the release line the
+ * schema is the one the release manifest gives for the declared
+ * `release` and the sheet's type, whatever `$schema` says (a `$schema`
+ * that disagrees is PDP-E-002's finding, at Layer 2). Legacy sheets,
+ * which declare no release, keep resolving through their `$schema`.
+ */
+export type SchemaResolution = {
+    kind: "schema";
+    id: string;
+}
+/** `release` names no release in the manifest. */
+ | {
+    kind: "unknown-release";
+    declared: string;
+}
+/** A legacy sheet's `$schema` names no schema this package bundles. */
+ | {
+    kind: "unknown-schema";
+    declared: string;
+};
+/**
+ * Resolve the schema for a document.
+ *
+ * - Release line (`release` present): the sheet-spec version the
+ *   manifest bundles in that release for the sheet's type. The type
+ *   comes from the usual dispatch (`$schema` path, else data-block
+ *   shape), so it does not depend on `$schema` being present.
+ * - Legacy line (`format_version`, no `release`): the schema `$schema`
+ *   names when it is bundled, the legacy schema for the pre-2026-09-08
+ *   identifier or when `$schema` is absent.
+ * - Neither field: the schema `$schema` names when it is bundled, else
+ *   the current release's, whose `required` then reports the missing
+ *   `release`.
+ *
+ * `sheetType` forces the type for callers that validate one type only.
+ */
+export declare function resolveSchema(sheet: Sheet, sheetType?: SheetType): SchemaResolution;

package/dist/schema-registry.js

@@ -0,0 +1,52 @@
+import { SCHEMA_IDS } from "./generated/schema-ids.js";
+import { CURRENT_RELEASE, legacySchemaUrl, schemaUrlFor, sheetSpecVersionFor, } from "./releases.js";
+import { detectSheetLine, detectSheetType } from "./sheet-type.js";
+/**
+ * The identifiers the legacy schemas carried before 2026-09-08
+ * (`…/pagefront/commerce/schemas/<type>/v0.9.json`); sheets declaring
+ * them validate against the legacy schema they became.
+ */
+const FORMER_LEGACY_ID = /^https:\/\/themachineweb\.org\/pagefront\/commerce\/schemas\/(product|organization)\/v0\.9\.json$/;
+/**
+ * Resolve the schema for a document.
+ *
+ * - Release line (`release` present): the sheet-spec version the
+ *   manifest bundles in that release for the sheet's type. The type
+ *   comes from the usual dispatch (`$schema` path, else data-block
+ *   shape), so it does not depend on `$schema` being present.
+ * - Legacy line (`format_version`, no `release`): the schema `$schema`
+ *   names when it is bundled, the legacy schema for the pre-2026-09-08
+ *   identifier or when `$schema` is absent.
+ * - Neither field: the schema `$schema` names when it is bundled, else
+ *   the current release's, whose `required` then reports the missing
+ *   `release`.
+ *
+ * `sheetType` forces the type for callers that validate one type only.
+ */
+export function resolveSchema(sheet, sheetType) {
+    const type = sheetType ?? detectSheetType(sheet);
+    const declared = sheet.$schema;
+    if (sheet.release !== undefined) {
+        // A non-string release is validated against the current schema,
+        // whose `release` pattern rejects it.
+        if (typeof sheet.release !== "string") {
+            return { kind: "schema", id: schemaUrlFor(type, sheetSpecVersionFor(CURRENT_RELEASE, type)) };
+        }
+        const version = sheetSpecVersionFor(sheet.release, type);
+        if (version === undefined)
+            return { kind: "unknown-release", declared: sheet.release };
+        return { kind: "schema", id: schemaUrlFor(type, version) };
+    }
+    if (typeof declared === "string") {
+        if (SCHEMA_IDS.includes(declared))
+            return { kind: "schema", id: declared };
+        const former = FORMER_LEGACY_ID.exec(declared);
+        if (former !== null)
+            return { kind: "schema", id: legacySchemaUrl(former[1]) };
+        if (detectSheetLine(sheet) === "legacy")
+            return { kind: "unknown-schema", declared };
+    }
+    if (detectSheetLine(sheet) === "legacy")
+        return { kind: "schema", id: legacySchemaUrl(type) };
+    return { kind: "schema", id: schemaUrlFor(type, sheetSpecVersionFor(CURRENT_RELEASE, type)) };
+}

package/dist/schema-validators.d.ts

@@ -1,12 +1,11 @@
 /**
- * The Layer 1 validators, compiled ahead of time from the bundled
- * schemas by scripts/compile-validators.mjs into dist/schema-validators.js
- * (the second half of `npm run build`). This declaration is the module's
- * type; the script copies it beside the generated file.
+ * The Layer 1 validators, compiled ahead of time from every bundled
+ * schema (commerce/schemas/) by scripts/compile-validators.mjs into
+ * dist/schema-validators.js (the last step of `npm run build`). This
+ * declaration is the module's type; the script copies it beside the
+ * generated file.
  */
 import type { ValidateFunction } from "ajv";
 
-export const validateProduct: ValidateFunction;
-export const validateOrganization: ValidateFunction;
-export const validateLegacyProduct: ValidateFunction;
-export const validateLegacyOrganization: ValidateFunction;
+/** One validator per bundled schema, keyed by the schema's `$id`. */
+export const VALIDATORS: Readonly<Record<string, ValidateFunction>>;