@pagefront/lint-commerce 0.10.0 → 0.11.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/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/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.

package/dist/schema-registry.d.ts

@@ -0,0 +1,29 @@
+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`, and a
+ * sheet is validated against the one its `$schema` names, on either
+ * line. Nothing is substituted: a `$schema` that names no bundled schema
+ * is reported as such, and the sheet is not validated against a
+ * neighbouring version.
+ */
+export type SchemaResolution = {
+    kind: "schema";
+    id: string;
+}
+/** `$schema` is a string that names no schema this package bundles. */
+ | {
+    kind: "unknown";
+    declared: string;
+};
+/**
+ * Resolve the schema for a document. A declared `$schema` is taken at
+ * its word. Without one, the schema is the one the sheet's own
+ * statements lead to: the legacy schema for a sheet on the legacy line,
+ * and for a sheet on the release line the sheet-spec version its
+ * `release` bundles (the current release's when the release is not in
+ * the manifest). `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,35 @@
+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. A declared `$schema` is taken at
+ * its word. Without one, the schema is the one the sheet's own
+ * statements lead to: the legacy schema for a sheet on the legacy line,
+ * and for a sheet on the release line the sheet-spec version its
+ * `release` bundles (the current release's when the release is not in
+ * the manifest). `sheetType` forces the type for callers that validate
+ * one type only.
+ */
+export function resolveSchema(sheet, sheetType) {
+    const declared = sheet.$schema;
+    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]) };
+        return { kind: "unknown", declared };
+    }
+    const type = sheetType ?? detectSheetType(sheet);
+    if (detectSheetLine(sheet) === "legacy")
+        return { kind: "schema", id: legacySchemaUrl(type) };
+    const release = typeof sheet.release === "string" ? sheet.release : CURRENT_RELEASE;
+    const version = sheetSpecVersionFor(release, type) ?? sheetSpecVersionFor(CURRENT_RELEASE, type);
+    return { kind: "schema", id: schemaUrlFor(type, version) };
+}

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>>;