@pagefront/lint-commerce 0.11.0 → 0.12.0

package/dist/organization-catalogue.js

@@ -2,6 +2,7 @@ import { KNOWN_RELEASES } from "./releases.js";
 import { orgE001 } from "./rules/org-e-001.js";
 import { orgE002 } from "./rules/org-e-002.js";
 import { orgE003 } from "./rules/org-e-003.js";
+import { orgE004 } from "./rules/org-e-004.js";
 import { orgW001 } from "./rules/org-w-001.js";
 import { orgW002 } from "./rules/org-w-002.js";
 import { orgW003 } from "./rules/org-w-003.js";
@@ -20,6 +21,6 @@ import { orgW006 } from "./rules/org-w-006.js";
 export const organizationCatalogue = {
     vertical: "commerce",
     releases: KNOWN_RELEASES,
-    catalogueVersion: "0.15.0",
-    rules: [orgE001, orgE002, orgE003, orgW001, orgW002, orgW003, orgW004, orgW005, orgW006],
+    catalogueVersion: "0.16.0",
+    rules: [orgE001, orgE002, orgE003, orgE004, orgW001, orgW002, orgW003, orgW004, orgW005, orgW006],
 };

package/dist/rules/org-e-001.js

@@ -13,5 +13,7 @@ export const orgE001 = {
     messageTemplate: "The Sheet uses `{term}` but `@context` at `{path}` does not declare the `pagefront` prefix, so the term does not resolve to the Pagefront vocabulary.",
     remediation: 'Declare the prefix: `"@context": ["https://schema.org", {"pagefront": "https://themachineweb.org/pagefront/vocabulary/"}]`.',
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "vocabulary.md#how-to-use-this-vocabulary",
 };

package/dist/rules/org-e-002.js

@@ -9,5 +9,7 @@ export const orgE002 = {
     ...BOTH_VERSION_FIELDS,
     check: bothVersionFields,
     introduced: "release 0.3.0",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#the-envelope",
 };

package/dist/rules/org-e-003.js

@@ -9,5 +9,7 @@ export const orgE003 = {
     ...RELEASE_SCHEMA_MISMATCH,
     check: releaseSchemaMismatch("organization"),
     introduced: "release 0.3.0",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#the-envelope",
 };

package/dist/rules/org-e-004.d.ts

@@ -0,0 +1,11 @@
+import type { Rule } from "@pagefront/lint-core";
+/**
+ * ORG-E-004 — Unknown release.
+ * Transcribed from commerce/spec/rules.md (normative); the check is
+ * shared between the two catalogues (release-schema.ts).
+ *
+ * `appliesFrom` is "0.0.0": the rule judges the declared release
+ * itself, so it cannot be gated by it. It never fires on a sheet of a
+ * published release.
+ */
+export declare const orgE004: Rule;

package/dist/rules/org-e-004.js

@@ -0,0 +1,18 @@
+import { UNKNOWN_RELEASE, unknownRelease } from "./release-schema.js";
+/**
+ * ORG-E-004 — Unknown release.
+ * Transcribed from commerce/spec/rules.md (normative); the check is
+ * shared between the two catalogues (release-schema.ts).
+ *
+ * `appliesFrom` is "0.0.0": the rule judges the declared release
+ * itself, so it cannot be gated by it. It never fires on a sheet of a
+ * published release.
+ */
+export const orgE004 = {
+    id: "ORG-E-004",
+    ...UNKNOWN_RELEASE,
+    check: unknownRelease,
+    introduced: "release 0.4.0",
+    appliesFrom: "0.0.0",
+    specReference: "organization.md#the-envelope",
+};

package/dist/rules/org-w-001.js

@@ -27,5 +27,7 @@ export const orgW001 = {
     messageTemplate: "`pagefront:commerceRole` at `{path}` declares `brand_owner`, but the sheet carries no `brand` node.",
     remediation: "Add the `Brand` node with `@id` and `name` — the `Brand.@id` is the identity Product Sheets resolve via `Product.brand`.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#role-discriminator--pagefrontcommercerole",
 };

package/dist/rules/org-w-002.js

@@ -28,5 +28,7 @@ export const orgW002 = {
     messageTemplate: "`pagefront:commerceRole` at `{path}` declares `seller`, but none of `hasMerchantReturnPolicy`, `pagefront:fulfillmentTerms`, `paymentAccepted`, or `location` is present.",
     remediation: "Add the store-wide terms the seller role promises: the return policy, fulfillment terms, payment methods, or physical locations.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#seller-block-seller",
 };

package/dist/rules/org-w-003.js

@@ -26,5 +26,7 @@ export const orgW003 = {
     messageTemplate: "A `brand` node is present at `{path}`, but `pagefront:commerceRole` does not declare `brand_owner`.",
     remediation: "Declare `brand_owner` in `pagefront:commerceRole`, or remove the `brand` node if this sheet is not the brand's sheet.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#role-discriminator--pagefrontcommercerole",
 };

package/dist/rules/org-w-004.js

@@ -28,5 +28,7 @@ export const orgW004 = {
     messageTemplate: "Seller content (`{fields}`) is present at `{path}`, but `pagefront:commerceRole` does not declare `seller`.",
     remediation: "Declare `seller` in `pagefront:commerceRole`, or move the store-wide terms to the seller's own sheet.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#seller-block-seller",
 };

package/dist/rules/org-w-005.js

@@ -50,5 +50,7 @@ export const orgW005 = {
     messageTemplate: "`{field}` at `{path}` carries `{value}`, which does not match the {form}.",
     remediation: "Correct the machine key: `iso6523Code` is `NNNN:register-number` (e.g. `0002:808641435` for a SIREN), `leiCode` is a 20-character ISO 17442 LEI. If no well-formed machine key exists for this register, drop the field and keep the display-form `identifier` — absence is conformant.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#company-registration-identity",
 };

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

@@ -28,5 +28,7 @@ export const orgW006 = {
     messageTemplate: "`pagefront:authorizedResellers` is present at `{path}`, but `pagefront:commerceRole` does not declare `brand_owner`.",
     remediation: "Declare `brand_owner` in `pagefront:commerceRole` if this is the brand's own sheet; otherwise remove the field — only the brand's sheet can state whom the brand authorizes.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#authorized-resellers",
 };

package/dist/rules/pdp-e-001.js

@@ -47,5 +47,7 @@ export const pdpE001 = {
     messageTemplate: "Reference `{value}` at `{path}` does not resolve to any entity in this Sheet.",
     remediation: "Either correct the reference to match an existing `@id`, or add the referenced entity to the Sheet. Same-document references (fragments, bare tokens, or full URLs on this Sheet's own base) must resolve within the Sheet, by exact string match. A pricing block's `configurator.@id` must equal the `@id` declared on the Sheet's `pagefront:configurator`. A full-URL `@id` on another document's base in `isVariantOf` or a `hasVariant` entry is a legitimate cross-Sheet reference (multi-Sheet variant family) and is validated for URL shape only — see PDP-W-021 for the traversal-hint recommendation that accompanies it.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#itemoffered-references",
 };

package/dist/rules/pdp-e-002.js

@@ -9,5 +9,7 @@ export const pdpE002 = {
     ...RELEASE_SCHEMA_MISMATCH,
     check: releaseSchemaMismatch("product"),
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#the-envelope",
 };

package/dist/rules/pdp-e-003.js

@@ -13,5 +13,7 @@ export const pdpE003 = {
     messageTemplate: "The Sheet uses `{term}` but `@context` at `{path}` does not declare the `pagefront` prefix, so the term does not resolve to the Pagefront vocabulary.",
     remediation: 'Declare the prefix: `"@context": ["https://schema.org", {"pagefront": "https://themachineweb.org/pagefront/vocabulary/"}]`.',
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "vocabulary.md#how-to-use-this-vocabulary",
 };

package/dist/rules/pdp-e-004.js

@@ -43,5 +43,7 @@ export const pdpE004 = {
     messageTemplate: "Price specification at `{path}` states `{specPrice}` but its Offer's `price` is `{price}`.",
     remediation: "Make the two amounts equal, or remove the duplicated amount from the specification entry and keep `valueAddedTaxIncluded` (and `priceCurrency`) on it.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#tax-inclusion",
 };

package/dist/rules/pdp-e-005.js

@@ -36,5 +36,7 @@ export const pdpE005 = {
     messageTemplate: "Seller sheet URL at `{path}` is on host `{sheetUrlHost}`; the product sheet is on `{sheetHost}`.",
     remediation: "Publish the seller's organization sheet on the storefront host.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#linking-contract-identity-only",
 };

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

@@ -32,5 +32,7 @@ export const pdpE006 = {
     messageTemplate: "Brand sheet URL at `{path}` is on host `{sheetUrlHost}`; the brand's `@id` is on `{idHost}`.",
     remediation: "Point `pagefront:sheetUrl` at the sheet the brand publishes on its own host, or remove it.",
     introduced: "v0.9",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "organization.md#linking-contract-identity-only",
 };

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

@@ -49,5 +49,7 @@ export const pdpE007 = {
     messageTemplate: "Base configuration at `{path}` {problem}.",
     remediation: "Name exactly one option for every priced dimension, spelled as the configurator's `options` spell it. If a dimension never changes the price, declare `affectsPrice: false` on it and leave it out.",
     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-e-008.js

@@ -37,5 +37,7 @@ export const pdpE008 = {
     messageTemplate: "Modifier for base option `{option}` of `{dimension}` at `{path}` is `{modifier}`; the base option's modifier is `0`.",
     remediation: "Set the base option's modifier to zero and express the other options of the dimension as differences from it. If the modifier is right, `basePrice` is the total of another configuration: correct `baseConfiguration` or `basePrice`.",
     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-e-009.js

@@ -58,5 +58,7 @@ export const pdpE009 = {
     messageTemplate: "Modifier at `{path}` {problem}.",
     remediation: "Spell dimension names and option values as the configurator spells them. Remove modifiers for dimensions that do not change the price, or remove `affectsPrice: false` from a dimension that does.",
     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-e-010.js

@@ -33,5 +33,7 @@ export const pdpE010 = {
     messageTemplate: "Offer `price` at `{path}` is `{price}` but its pricing block's `basePrice` is `{basePrice}`.",
     remediation: "Make the two amounts equal. If `price` is the amount the page shows on load, set `baseConfiguration` to the configuration the page preselects and `basePrice` to its 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-e-011.js

@@ -49,5 +49,7 @@ export const pdpE011 = {
     messageTemplate: "`{bound}` at `{path}` is `{stated}` but the {extreme} non-excluded configuration computed from the pricing block totals `{computed}`.",
     remediation: "Correct the bound, or correct the price list: a missing adjustment, a missing exclusion and a wrong modifier each move the computed band. If the price list is known to have gaps, 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-e-012.js

@@ -28,5 +28,7 @@ export const pdpE012 = {
     messageTemplate: "Offer at `{path}` prices configurator `{value}`, which the offer at `{firstPath}` already prices.",
     remediation: "Keep one pricing block per configurator. Publish each further market's price list in that market's own Sheet.",
     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-e-013.js

@@ -22,5 +22,7 @@ export const pdpE013 = {
     messageTemplate: "Dimension `{dimension}` at `{path}` declares `inputType: \"text\"` and enumerates options.",
     remediation: "Remove `options` from a free-text dimension, or remove `inputType: \"text\"` from a dimension the buyer picks a value in.",
     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-e-014.js

@@ -30,5 +30,7 @@ export const pdpE014 = {
     messageTemplate: "Size adjustment at `{path}` is in `{sizeSystem}` but the Sheet's sizing dimension is in `{dimensionSystem}`.",
     remediation: "State the adjustment in the sizing dimension's system if the merchant states it there. If the merchant's advice is in another system, remove `sizeAdjustment` and keep the merchant's wording in `description`.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#size-guidance-pagefrontsizechart-and-pagefrontsizerecommendation",
 };

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

@@ -87,5 +87,7 @@ export const pdpE015 = {
     messageTemplate: "Amounts mix numbers and strings; use one carrier throughout the Sheet.",
     remediation: "Carry every amount the same way. Decimal strings are recommended when amounts have fractional parts.",
     introduced: "v0.9 (2026-10-01 revision)",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#amounts",
 };

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

@@ -9,5 +9,7 @@ export const pdpE016 = {
     ...BOTH_VERSION_FIELDS,
     check: bothVersionFields,
     introduced: "release 0.3.0",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#the-envelope",
 };

package/dist/rules/pdp-e-017.d.ts

@@ -0,0 +1,2 @@
+import type { Rule } from "@pagefront/lint-core";
+export declare const pdpE017: Rule;

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

@@ -0,0 +1,80 @@
+import { asObject, own, pricedConfiguratorId, pricingBlock, seg } from "./configurator-pricing.js";
+function declaredDimensions(configurator) {
+    const out = new Map();
+    const dimensions = configurator["dimensions"];
+    if (!Array.isArray(dimensions))
+        return out;
+    for (const entry of dimensions) {
+        const d = asObject(entry);
+        if (d === null || typeof d["name"] !== "string" || out.has(d["name"]))
+            continue;
+        const options = d["options"];
+        out.set(d["name"], {
+            values: Array.isArray(options) && options.length > 0
+                ? options.map((option) => own(asObject(option), "value"))
+                : null,
+        });
+    }
+    return out;
+}
+function unresolved(pairs, path, dimensions) {
+    const hits = [];
+    for (const [dimension, value] of Object.entries(asObject(pairs) ?? {})) {
+        const option = JSON.stringify(value);
+        const declared = dimensions.get(dimension);
+        let problem = null;
+        if (declared === undefined) {
+            problem = `the configurator declares no dimension \`${dimension}\``;
+        }
+        else if (declared.values !== null && !declared.values.some((v) => v === value)) {
+            problem = `\`${dimension}\` lists no option \`${option}\``;
+        }
+        if (problem !== null) {
+            hits.push({ path: `${path}${seg(dimension)}`, values: { dimension, option, problem } });
+        }
+    }
+    return hits;
+}
+export const pdpE017 = {
+    id: "PDP-E-017",
+    title: "Configurator reference does not resolve",
+    severity: "error",
+    target: "$.data",
+    check: (match) => {
+        const data = asObject(match.value);
+        const configurator = asObject(own(data, "pagefront:configurator"));
+        if (data === null || configurator === null)
+            return null;
+        const dimensions = declaredDimensions(configurator);
+        const hits = [];
+        const exclusions = configurator["exclusions"];
+        if (Array.isArray(exclusions)) {
+            exclusions.forEach((entry, index) => {
+                hits.push(...unresolved(entry, `${match.path}['pagefront:configurator']['exclusions'][${index}]`, dimensions));
+            });
+        }
+        // An adjustment's `when` refers to the configurator its pricing block
+        // names. A block naming another `@id` is PDP-E-001's finding, and its
+        // references are not resolved against this configurator.
+        const offers = own(data, "offers");
+        if (Array.isArray(offers)) {
+            offers.forEach((offer, offerIndex) => {
+                const block = pricingBlock(offer);
+                if (block === null || !Array.isArray(block["adjustments"]))
+                    return;
+                if (pricedConfiguratorId(block) !== configurator["@id"])
+                    return;
+                block["adjustments"].forEach((adjustment, index) => {
+                    hits.push(...unresolved(asObject(adjustment)?.["when"], `${match.path}['offers'][${offerIndex}]['pagefront:configuratorPricing']['adjustments'][${index}]['when']`, dimensions));
+                });
+            });
+        }
+        return hits.length > 0 ? hits : null;
+    },
+    messageTemplate: "Configuration reference at `{path}` (dimension `{dimension}`, option `{option}`) does not resolve: {problem}.",
+    remediation: "Name a dimension the configurator declares, and write the option exactly as its `value` is written in that dimension's `options`, including its JSON type. Remove an exclusion or adjustment that refers to an option the product no longer offers.",
+    introduced: "release 0.4.0",
+    // The requirement is introduced by release 0.4.0 (Product Sheet spec 0.10.0).
+    appliesFrom: "0.4.0",
+    specReference: "product.md#configurator-pricing-and-price-bands",
+};

package/dist/rules/pdp-e-018.d.ts

@@ -0,0 +1,11 @@
+import type { Rule } from "@pagefront/lint-core";
+/**
+ * PDP-E-018 — Unknown release.
+ * Transcribed from commerce/spec/rules.md (normative); the check is
+ * shared between the two catalogues (release-schema.ts).
+ *
+ * `appliesFrom` is "0.0.0": the rule judges the declared release
+ * itself, so it cannot be gated by it. It never fires on a sheet of a
+ * published release.
+ */
+export declare const pdpE018: Rule;

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

@@ -0,0 +1,18 @@
+import { UNKNOWN_RELEASE, unknownRelease } from "./release-schema.js";
+/**
+ * PDP-E-018 — Unknown release.
+ * Transcribed from commerce/spec/rules.md (normative); the check is
+ * shared between the two catalogues (release-schema.ts).
+ *
+ * `appliesFrom` is "0.0.0": the rule judges the declared release
+ * itself, so it cannot be gated by it. It never fires on a sheet of a
+ * published release.
+ */
+export const pdpE018 = {
+    id: "PDP-E-018",
+    ...UNKNOWN_RELEASE,
+    check: unknownRelease,
+    introduced: "release 0.4.0",
+    appliesFrom: "0.0.0",
+    specReference: "product.md#the-envelope",
+};

package/dist/rules/pdp-i-001.js

@@ -25,5 +25,7 @@ export const pdpI001 = {
     messageTemplate: "Property `{property}` at `{path}` is valid Schema.org but is not explicitly modeled by Pagefront.",
     remediation: "No action required. This finding is informational. If you find yourself using a Schema.org property frequently and would value formal Pagefront modeling for it, consider opening a spec proposal.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#data--schemaorg-json-ld",
 };

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

@@ -18,5 +18,7 @@ export const pdpW001 = {
     messageTemplate: "No images declared at `{path}`.",
     remediation: "Add at least one `ImageObject` to the `data.image` array. The primary image should typically declare role `hero` or `packshot`.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#image-roles",
 };

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

@@ -19,5 +19,7 @@ export const pdpW002 = {
     messageTemplate: "No description at `{path}`.",
     remediation: "Add a `description` field with a 1–3 paragraph prose description of the product. The description should match the Sheet's `inLanguage`.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#required-and-recommended-core-fields",
 };

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

@@ -18,5 +18,7 @@ export const pdpW003 = {
     messageTemplate: "No brand declared at `{path}`.",
     remediation: "Add a `brand` field with a typed `Brand` or `Organization` value, including at minimum `name` and optionally `url`.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#required-and-recommended-core-fields",
 };

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

@@ -26,5 +26,7 @@ export const pdpW004 = {
     messageTemplate: "Offer at `{path}` has `price` but no `priceCurrency`.",
     remediation: "Add a `priceCurrency` field with the ISO 4217 currency code matching the offer's currency.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#offers",
 };

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

@@ -40,5 +40,7 @@ export const pdpW005 = {
     messageTemplate: "Material composition percentages at `{path}` sum to `{sum}`, not approximately 100.",
     remediation: "Verify the composition data. If a material is missing, add it. If the values are correct but the publisher's source data uses percentages for a different denominator, omit `percentage` rather than use a value that doesn't represent a fraction of total composition.",
     introduced: "v0.6",
+    appliesFrom: "0.3.0",
+    appliesToLegacy: true,
     specReference: "product.md#materials-material-and-pagefrontmaterialcomposition",
 };

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",
 };