@pagefront/lint-commerce 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -7,10 +7,12 @@
  * `validateOrganizationSheet` (Layer 1 for the Commerce Organization
  * Sheet; no organization catalogue exists yet), the commerce
  * catalogue object, and the types those signatures mention.
- * `product-schema.ts`, `organization-schema.ts`, `legacy-schemas.ts`
- * and the individual rule modules are internal. The release manifest
- * (`RELEASE_MANIFEST`, `sheetSpecVersionFor`) is exported so callers
- * can resolve a release to its sheet-spec versions.
+ * The bundled schemas (`generated/`), the compiled validators and the
+ * individual rule modules are internal. The release manifest
+ * (`RELEASE_MANIFEST`, `sheetSpecVersionFor`, `schemaUrlFor`) and the
+ * list of bundled schema ids (`BUNDLED_SCHEMA_IDS`) are exported so
+ * callers can resolve a release to its sheet-spec versions and tell
+ * which `$schema` values this package validates.
  */
 export { lintSheet } from "./lint-sheet.js";
 export { validateAndLint } from "./validate-and-lint.js";
@@ -21,5 +23,6 @@ export { commerceCatalogue } from "./catalogue.js";
 export { organizationCatalogue } from "./organization-catalogue.js";
 export { detectSheetType, detectSheetLine } from "./sheet-type.js";
 export type { SheetType, SheetLine } from "./sheet-type.js";
-export { RELEASE_MANIFEST, KNOWN_RELEASES, sheetSpecVersionFor } from "./releases.js";
+export { RELEASE_MANIFEST, KNOWN_RELEASES, CURRENT_RELEASE, sheetSpecVersionFor, schemaUrlFor, } from "./releases.js";
+export { SCHEMA_IDS as BUNDLED_SCHEMA_IDS } from "./generated/schema-ids.js";
 export type { Report, Finding, Summary, Severity, LintOptions, Sheet, } from "@pagefront/lint-core";

package/dist/index.js

@@ -7,10 +7,12 @@
  * `validateOrganizationSheet` (Layer 1 for the Commerce Organization
  * Sheet; no organization catalogue exists yet), the commerce
  * catalogue object, and the types those signatures mention.
- * `product-schema.ts`, `organization-schema.ts`, `legacy-schemas.ts`
- * and the individual rule modules are internal. The release manifest
- * (`RELEASE_MANIFEST`, `sheetSpecVersionFor`) is exported so callers
- * can resolve a release to its sheet-spec versions.
+ * The bundled schemas (`generated/`), the compiled validators and the
+ * individual rule modules are internal. The release manifest
+ * (`RELEASE_MANIFEST`, `sheetSpecVersionFor`, `schemaUrlFor`) and the
+ * list of bundled schema ids (`BUNDLED_SCHEMA_IDS`) are exported so
+ * callers can resolve a release to its sheet-spec versions and tell
+ * which `$schema` values this package validates.
  */
 export { lintSheet } from "./lint-sheet.js";
 export { validateAndLint } from "./validate-and-lint.js";
@@ -18,4 +20,5 @@ export { validateOrganizationSheet } from "./validate-organization.js";
 export { commerceCatalogue } from "./catalogue.js";
 export { organizationCatalogue } from "./organization-catalogue.js";
 export { detectSheetType, detectSheetLine } from "./sheet-type.js";
-export { RELEASE_MANIFEST, KNOWN_RELEASES, sheetSpecVersionFor } from "./releases.js";
+export { RELEASE_MANIFEST, KNOWN_RELEASES, CURRENT_RELEASE, sheetSpecVersionFor, schemaUrlFor, } from "./releases.js";
+export { SCHEMA_IDS as BUNDLED_SCHEMA_IDS } from "./generated/schema-ids.js";

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/releases.d.ts

@@ -1,36 +1,22 @@
+import { RELEASE_MANIFEST } from "./generated/release-manifest.js";
 import type { SheetType } from "./sheet-type.js";
 /**
- * The commerce release manifest (commerce/spec/releases.json), bundled
- * verbatim: each release and the member versions it bundles. Generated
- * from the spec file; the drift test (test/releases.test.mjs) fails
- * when the two diverge. Regenerate when a release is cut.
+ * The commerce release manifest (commerce/spec/releases.json): each
+ * release and the member versions it bundles. Bundled at build time by
+ * scripts/bundle-schemas.mjs, so the package always carries the
+ * manifest it was built from.
  */
-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";
-        };
-    };
-};
+export { RELEASE_MANIFEST };
 /** Every release the manifest lists, in manifest order. */
 export declare const KNOWN_RELEASES: readonly string[];
+/** The latest release the manifest lists. */
+export declare const CURRENT_RELEASE: string;
 /**
  * The sheet-spec version a release bundles for a sheet type, or
  * undefined when the manifest does not list the release.
  */
 export declare function sheetSpecVersionFor(release: string, sheetType: SheetType): string | undefined;
+/** The published URL of a sheet spec's JSON Schema, which is also its `$id`. */
+export declare function schemaUrlFor(sheetType: SheetType, version: string): string;
+/** The legacy draft line's schema URL for a sheet type. */
+export declare function legacySchemaUrl(sheetType: SheetType): string;

package/dist/releases.js

@@ -1,37 +1,15 @@
+import { RELEASE_MANIFEST } from "./generated/release-manifest.js";
 /**
- * The commerce release manifest (commerce/spec/releases.json), bundled
- * verbatim: each release and the member versions it bundles. Generated
- * from the spec file; the drift test (test/releases.test.mjs) fails
- * when the two diverge. Regenerate when a release is cut.
+ * The commerce release manifest (commerce/spec/releases.json): each
+ * release and the member versions it bundles. Bundled at build time by
+ * scripts/bundle-schemas.mjs, so the package always carries the
+ * manifest it was built from.
  */
-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"
-        }
-    }
-};
+export { RELEASE_MANIFEST };
 /** Every release the manifest lists, in manifest order. */
 export const KNOWN_RELEASES = RELEASE_MANIFEST.releases.map((r) => r.release);
+/** The latest release the manifest lists. */
+export const CURRENT_RELEASE = KNOWN_RELEASES[KNOWN_RELEASES.length - 1];
 /**
  * The sheet-spec version a release bundles for a sheet type, or
  * undefined when the manifest does not list the release.
@@ -39,3 +17,11 @@ export const KNOWN_RELEASES = RELEASE_MANIFEST.releases.map((r) => r.release);
 export function sheetSpecVersionFor(release, sheetType) {
     return RELEASE_MANIFEST.releases.find((r) => r.release === release)?.sheets[sheetType];
 }
+/** The published URL of a sheet spec's JSON Schema, which is also its `$id`. */
+export function schemaUrlFor(sheetType, version) {
+    return RELEASE_MANIFEST.schema_url_template.replace("{sheet}", sheetType).replace("{version}", version);
+}
+/** The legacy draft line's schema URL for a sheet type. */
+export function legacySchemaUrl(sheetType) {
+    return RELEASE_MANIFEST.legacy.schemas[sheetType];
+}

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

@@ -1,10 +1,11 @@
-import { DATA_BLOCK_PROPERTIES } from "../schema-properties.js";
+import { DATA_BLOCK_PROPERTIES } from "../generated/schema-properties.js";
 /**
  * PDP-I-001 — Property outside Pagefront's modeled set.
  * Transcribed from commerce/spec/rules.md (normative).
  *
  * The modeled set is the JSON Schema's dataBlock property inventory
- * (schema-properties.ts, drift-tested against product.json). The
+ * of the latest released Product Sheet schema (generated at build
+ * time, see scripts/bundle-schemas.mjs). The
  * target `$.data.*` selects top-level data properties by design; any
  * property outside the inventory fires, including unmodeled
  * `pagefront:`-prefixed ones.
@@ -24,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",
 };