@pagefront/lint-commerce 0.11.0 → 0.12.0

package/dist/validate-and-lint.d.ts

@@ -25,12 +25,14 @@ export type ValidateAndLintResult = {
     report: Report;
 };
 /**
- * Layer 1 for one document: validate it against the frozen schema its
- * `$schema` names, or, when it declares none, the schema its own
- * statements lead to (see schema-registry.ts). Returns the errors, empty
- * when the document is valid. A `$schema` naming no bundled schema is a
- * Layer 1 failure of its own, reported at `/$schema` with the keyword
- * `$schema`: the document is not validated against some other version.
+ * Layer 1 for one document: validate it against the frozen schema the
+ * release it declares resolves to (see schema-registry.ts); a legacy
+ * sheet is validated against the schema its `$schema` names. Returns
+ * the errors, empty when the document is valid. A `release` the
+ * manifest does not list is a Layer 1 failure of its own, reported at
+ * `/release` with the keyword `release`; a legacy `$schema` naming no
+ * bundled schema is reported at `/$schema`. In neither case is the
+ * document validated against some other version.
  */
 export declare function schemaErrorsFor(input: unknown, sheetType?: SheetType): SchemaError[];
 /**
@@ -43,9 +45,11 @@ export declare function schemaErrorsFor(input: unknown, sheetType?: SheetType):
  *
  * The package bundles every schema ever published, on both lines: the
  * sheet-spec versions of each release, and the legacy draft line's
- * format 0.9 schemas. A document is validated against the one its
- * `$schema` names. A `$schema` naming a version this package does not
- * bundle fails Layer 1 with a single error saying so.
+ * format 0.9 schemas. A sheet is judged by the release it declares: the
+ * schema is the one that release bundles for the sheet's type, and a
+ * `$schema` that names another one is a Layer 2 finding (PDP-E-002,
+ * ORG-E-003). A release the manifest does not list fails Layer 1 with a
+ * single error saying so.
  *
  * Layer 2 dispatches by page type (see sheet-type.ts): product sheets
  * lint with the product catalogue, Commerce Organization Sheets with

package/dist/validate-and-lint.js

@@ -6,17 +6,28 @@ import { VALIDATORS } from "./schema-validators.js";
 // eval is unavailable, and consumers calling it in a loop pay no
 // compilation cost.
 /**
- * Layer 1 for one document: validate it against the frozen schema its
- * `$schema` names, or, when it declares none, the schema its own
- * statements lead to (see schema-registry.ts). Returns the errors, empty
- * when the document is valid. A `$schema` naming no bundled schema is a
- * Layer 1 failure of its own, reported at `/$schema` with the keyword
- * `$schema`: the document is not validated against some other version.
+ * Layer 1 for one document: validate it against the frozen schema the
+ * release it declares resolves to (see schema-registry.ts); a legacy
+ * sheet is validated against the schema its `$schema` names. Returns
+ * the errors, empty when the document is valid. A `release` the
+ * manifest does not list is a Layer 1 failure of its own, reported at
+ * `/release` with the keyword `release`; a legacy `$schema` naming no
+ * bundled schema is reported at `/$schema`. In neither case is the
+ * document validated against some other version.
  */
 export function schemaErrorsFor(input, sheetType) {
     const envelope = (typeof input === "object" && input !== null ? input : {});
     const resolution = resolveSchema(envelope, sheetType);
-    if (resolution.kind === "unknown") {
+    if (resolution.kind === "unknown-release") {
+        return [
+            {
+                instancePath: "/release",
+                message: `names no release this linter knows: ${resolution.declared}`,
+                keyword: "release",
+            },
+        ];
+    }
+    if (resolution.kind === "unknown-schema") {
         return [
             {
                 instancePath: "/$schema",
@@ -44,9 +55,11 @@ export function schemaErrorsFor(input, sheetType) {
  *
  * The package bundles every schema ever published, on both lines: the
  * sheet-spec versions of each release, and the legacy draft line's
- * format 0.9 schemas. A document is validated against the one its
- * `$schema` names. A `$schema` naming a version this package does not
- * bundle fails Layer 1 with a single error saying so.
+ * format 0.9 schemas. A sheet is judged by the release it declares: the
+ * schema is the one that release bundles for the sheet's type, and a
+ * `$schema` that names another one is a Layer 2 finding (PDP-E-002,
+ * ORG-E-003). A release the manifest does not list fails Layer 1 with a
+ * single error saying so.
  *
  * Layer 2 dispatches by page type (see sheet-type.ts): product sheets
  * lint with the product catalogue, Commerce Organization Sheets with

package/dist/version.d.ts

@@ -5,4 +5,4 @@
  * (test/linter-version.test.mjs) fails when they diverge. Regenerate
  * on version bump.
  */
-export declare const PACKAGE_VERSION = "0.11.0";
+export declare const PACKAGE_VERSION = "0.12.0";

package/dist/version.js

@@ -5,4 +5,4 @@
  * (test/linter-version.test.mjs) fails when they diverge. Regenerate
  * on version bump.
  */
-export const PACKAGE_VERSION = "0.11.0";
+export const PACKAGE_VERSION = "0.12.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pagefront/lint-commerce",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Pagefront commerce linter: the commerce rule catalogue and CLI, on the @pagefront/lint-core engine.",
   "license": "Apache-2.0",
   "repository": {
@@ -39,7 +39,7 @@
     "prepublishOnly": "npm test"
   },
   "dependencies": {
-    "@pagefront/lint-core": "^0.2.0",
+    "@pagefront/lint-core": "^0.3.0",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1"
   },