schemata-validator 0.1.0

package/dist/utils/get-file-content.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Gets the content of the file.
+ * @param file - The file to get the content of.
+ * @return The content of the file.
+ */
+export declare const getFileContent: (file: string) => string;

package/dist/utils/get-file-content.js

@@ -0,0 +1,10 @@
+import fs from "node:fs";
+/**
+ * Gets the content of the file.
+ * @param file - The file to get the content of.
+ * @return The content of the file.
+ */
+export const getFileContent = (file) => {
+    return fs.readFileSync(file, "utf-8");
+};
+//# sourceMappingURL=get-file-content.js.map

package/dist/utils/get-file-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-file-content.js","sourceRoot":"","sources":["../../src/utils/get-file-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE;IACrD,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC,CAAC"}

package/dist/utils/get-files-to-validate.d.ts

@@ -0,0 +1,9 @@
+import type { SchemataValidatorOptions } from "../types.js";
+/**
+ * Gets the files to validate from the specified options.
+ *
+ * The `files` option takes precedence over the other options.
+ * @param [options] - The options to use.
+ * @return An array of the files to validate.
+ */
+export declare const getFilesToValidate: (options?: SchemataValidatorOptions) => Promise<string[]>;

package/dist/utils/get-files-to-validate.js

@@ -0,0 +1,37 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { cwd } from "node:process";
+import { browseFolders } from "./browse-folders.js";
+import { patternToRegex } from "./pattern-to-regex.js";
+/**
+ * Gets the files to validate from the specified options.
+ *
+ * The `files` option takes precedence over the other options.
+ * @param [options] - The options to use.
+ * @return An array of the files to validate.
+ */
+export const getFilesToValidate = async (options = {}) => {
+    const { files, paths, exclude } = options;
+    if (files)
+        return files.map(file => path.resolve(cwd(), file));
+    const excludeRegexps = (exclude ?? []).map(patternToRegex);
+    const folders = (await browseFolders(cwd())).map(async (folder) => {
+        const isFolderExcluded = [...excludeRegexps, /node_modules/].some(regex => regex.test(folder));
+        if (isFolderExcluded || (paths && !paths.some(path => folder.startsWith(`${cwd()}/${path}`)))) {
+            return [];
+        }
+        const files = await fs.readdir(folder);
+        const filesToValidate = [];
+        const extensions = [".html", ".htm"];
+        for (const file of files) {
+            const fileStat = await fs.stat(path.join(folder, file));
+            const isFileExcluded = excludeRegexps.some(regex => regex.test(file));
+            if (fileStat.isFile() && extensions.includes(path.extname(file)) && !isFileExcluded) {
+                filesToValidate.push(path.join(folder, file));
+            }
+        }
+        return filesToValidate;
+    });
+    return (await Promise.all(folders)).filter(folder => folder.length).flat();
+};
+//# sourceMappingURL=get-files-to-validate.js.map

package/dist/utils/get-files-to-validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-files-to-validate.js","sourceRoot":"","sources":["../../src/utils/get-files-to-validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EACrC,UAAoC,EAAE,EACnB,EAAE;IACrB,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC1C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC;IAC/D,MAAM,cAAc,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,MAAM,OAAO,GAAG,CAAC,MAAM,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,EAAC,MAAM,EAAC,EAAE;QAC9D,MAAM,gBAAgB,GAAG,CAAC,GAAG,cAAc,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;QAC/F,IAAI,gBAAgB,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,GAAG,GAAG,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9F,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACrC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YACxD,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YACtE,IAAI,QAAQ,CAAC,MAAM,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpF,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QACD,OAAO,eAAe,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AAC7E,CAAC,CAAC"}

package/dist/utils/parse-args.d.ts

@@ -0,0 +1,7 @@
+import type { SchemataValidatorOptions } from "../types.js";
+/**
+ * Parses the command-line arguments into an object of options.
+ * @param args - The command-line arguments to parse.
+ * @return An object of options.
+ */
+export declare const parseArgs: (args: string[]) => SchemataValidatorOptions;

package/dist/utils/parse-args.js

@@ -0,0 +1,47 @@
+import { AVAILABLE_CLI_FLAGS } from "../constants.js";
+/**
+ * Parses the command-line arguments into an object of options.
+ * @param args - The command-line arguments to parse.
+ * @return An object of options.
+ */
+export const parseArgs = (args) => {
+    if (args.length) {
+        const options = {};
+        const flagMap = Object.entries(AVAILABLE_CLI_FLAGS)
+            .filter(([key]) => key !== "version" && key !== "help")
+            .reduce((map, [key, { flag, alias }]) => {
+            if (flag)
+                map.set(flag, key);
+            if (alias)
+                map.set(alias, key);
+            return map;
+        }, new Map());
+        let currentKey = null;
+        for (const arg of args) {
+            if (arg.startsWith("-")) {
+                const isValidKey = flagMap.has(arg);
+                if (isValidKey) {
+                    currentKey = flagMap.get(arg) ?? null;
+                    if (currentKey) {
+                        if (currentKey === "dryRun")
+                            options[currentKey] = true;
+                        else
+                            options[currentKey] = [];
+                    }
+                }
+            }
+            else {
+                if (currentKey && currentKey in options) {
+                    if (currentKey !== "dryRun") {
+                        const values = options[currentKey] ?? [];
+                        values.push(arg);
+                        options[currentKey] = values;
+                    }
+                }
+            }
+        }
+        return options;
+    }
+    return {};
+};
+//# sourceMappingURL=parse-args.js.map

package/dist/utils/parse-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-args.js","sourceRoot":"","sources":["../../src/utils/parse-args.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAc,EAA4B,EAAE;IACpE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,OAAO,GAA6B,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC;aAChD,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,MAAM,CAAC;aACtD,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;YACtC,IAAI,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAqC,CAAC,CAAC;YAC/D,IAAI,KAAK;gBAAE,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAqC,CAAC,CAAC;YACjE,OAAO,GAAG,CAAC;QACb,CAAC,EAAE,IAAI,GAAG,EAA0C,CAAC,CAAC;QACxD,IAAI,UAAU,GAA0C,IAAI,CAAC;QAC7D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACpC,IAAI,UAAU,EAAE,CAAC;oBACf,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;oBACtC,IAAI,UAAU,EAAE,CAAC;wBACf,IAAI,UAAU,KAAK,QAAQ;4BAAE,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;;4BACnD,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC;oBAChC,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,IAAI,UAAU,IAAI,UAAU,IAAI,OAAO,EAAE,CAAC;oBACxC,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;wBAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;wBACzC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;wBACjB,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC"}

package/dist/utils/pattern-to-regex.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Converts a pattern with globs to a regular expression.
+ * @param pattern - The pattern to convert.
+ * @return The regular expression corresponding to the pattern.
+ */
+export declare const patternToRegex: (pattern: string) => RegExp;

package/dist/utils/pattern-to-regex.js

@@ -0,0 +1,15 @@
+/**
+ * Converts a pattern with globs to a regular expression.
+ * @param pattern - The pattern to convert.
+ * @return The regular expression corresponding to the pattern.
+ */
+export const patternToRegex = (pattern) => {
+    const regex = pattern
+        .replace(/\\/g, "\\\\")
+        .replace(/\//g, "\\/")
+        .replace(/\./g, "\\.")
+        .replace(/\*{2}/g, ".*")
+        .replace(/(?<!\.)\*/g, "[^/]*");
+    return new RegExp(regex);
+};
+//# sourceMappingURL=pattern-to-regex.js.map

package/dist/utils/pattern-to-regex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pattern-to-regex.js","sourceRoot":"","sources":["../../src/utils/pattern-to-regex.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,OAAe,EAAU,EAAE;IACxD,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC;SACvB,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC,CAAC"}

package/dist/utils/prepare-reporting.d.ts

@@ -0,0 +1,8 @@
+import type { ValidationReporting, ValidationResult } from "../types.js";
+/**
+ * Prepares the reporting for the given file.
+ * @param resource - The resource requested for validation.
+ * @param result - The result of the validation.
+ * @return The prepared reporting.
+ */
+export declare const prepareReporting: (resource: string, result: ValidationResult[]) => ValidationReporting;

package/dist/utils/prepare-reporting.js

@@ -0,0 +1,22 @@
+import { cwd } from "node:process";
+/**
+ * Prepares the reporting for the given file.
+ * @param resource - The resource requested for validation.
+ * @param result - The result of the validation.
+ * @return The prepared reporting.
+ */
+export const prepareReporting = (resource, result) => {
+    const reporting = {
+        status: "pass",
+        resource: resource.endsWith(".html") ? resource.replace(`${cwd()}/`, "") : resource
+    };
+    if (result.length) {
+        reporting.result = result;
+        const hasErrorMessages = result.some(resultItem => resultItem.type === "error");
+        if (hasErrorMessages)
+            Object.assign(reporting, { status: "fail" });
+        return reporting;
+    }
+    return reporting;
+};
+//# sourceMappingURL=prepare-reporting.js.map

package/dist/utils/prepare-reporting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-reporting.js","sourceRoot":"","sources":["../../src/utils/prepare-reporting.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,QAAgB,EAChB,MAA0B,EACL,EAAE;IACvB,MAAM,SAAS,GAAwB;QACrC,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ;KACpF,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC;QAC1B,MAAM,gBAAgB,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;QAChF,IAAI,gBAAgB;YAAE,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC"}

package/dist/utils/show-help.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Displays the help content for the CLI.
+ */
+export declare const showHelp: () => void;

package/dist/utils/show-help.js

@@ -0,0 +1,13 @@
+import { displayCliFlags } from "./display-cli-flags.js";
+import { TAB, WORKSPACE_NAME } from "../constants.js";
+/**
+ * Displays the help content for the CLI.
+ */
+export const showHelp = () => {
+    const intro = "Checks validity of Schema.org vocabulary";
+    const usage = `Usage:\n${TAB}${WORKSPACE_NAME} [flags]`;
+    const cliFlags = displayCliFlags();
+    const output = [intro, usage, cliFlags].join("\n".repeat(2));
+    console.log(output);
+};
+//# sourceMappingURL=show-help.js.map

package/dist/utils/show-help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-help.js","sourceRoot":"","sources":["../../src/utils/show-help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAS,EAAE;IACjC,MAAM,KAAK,GAAG,0CAA0C,CAAC;IACzD,MAAM,KAAK,GAAG,WAAW,GAAG,GAAG,cAAc,UAAU,CAAC;IACxD,MAAM,QAAQ,GAAG,eAAe,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC,CAAC"}

package/dist/utils/show-version.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Shows the version of the package.
+ */
+export declare const showVersion: () => void;

package/dist/utils/show-version.js

@@ -0,0 +1,8 @@
+import packageManifest from "../../package.json" with { type: "json" };
+/**
+ * Shows the version of the package.
+ */
+export const showVersion = () => {
+    console.log(packageManifest.version);
+};
+//# sourceMappingURL=show-version.js.map

package/dist/utils/show-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"show-version.js","sourceRoot":"","sources":["../../src/utils/show-version.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,GAAS,EAAE;IACpC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC,CAAC"}

package/dist/validator/schema-graph-validator.d.ts

@@ -0,0 +1,46 @@
+import type { ClassDefinition, PropertyDefinition, SchemaGraph, SchemaNode, SchemaValue, ValidationResult } from "../types.js";
+export declare class SchemaGraphValidator {
+    private readonly schemaGraph;
+    /**
+     * Constructs an instance of the SchemaGraphValidator class.
+     * @param schemaGraph - The schema graph to validate.
+     */
+    constructor(schemaGraph: SchemaGraph);
+    /**
+     * Gets the class definition from the type.
+     * @param type - The type of the class.
+     * @return The class definition if it exists, `null` otherwise.
+     */
+    getClassDefinition(type: string): ClassDefinition | null;
+    /**
+     * Gets the property definition from the property.
+     *
+     * When the property is `id`, the definition is always returned.
+     * @param property - The property.
+     * @return The property definition if it exists, `null` otherwise.
+     */
+    getPropertyDefinition(property: string): PropertyDefinition | null;
+    /**
+     * Gets the extended classes from the type.
+     * @param type - The type of the class.
+     * @return An array of extended classes if they exist, `null` otherwise.
+     */
+    getExtendedClasses(type: string): string[] | null;
+    /**
+     * Validates the schema values.
+     * @param property - The property name.
+     * @param schemaValues - The schema values to validate.
+     * @return An array of validation reports.
+     */
+    validateValues(property: string, schemaValues: SchemaValue[]): ValidationResult[];
+    /**
+     * Validates the schema node.
+     * @param node - The schema node to validate.
+     * @return An array of validation reports.
+     */
+    validateNode(node: SchemaNode): ValidationResult[];
+    /**
+     * Validates the schema graph.
+     */
+    validate(): ValidationResult[];
+}

package/dist/validator/schema-graph-validator.js

@@ -0,0 +1,164 @@
+import classes from "../../data/classes.json" with { type: "json" };
+import properties from "../../data/properties.json" with { type: "json" };
+export class SchemaGraphValidator {
+    schemaGraph;
+    /**
+     * Constructs an instance of the SchemaGraphValidator class.
+     * @param schemaGraph - The schema graph to validate.
+     */
+    constructor(schemaGraph) {
+        this.schemaGraph = schemaGraph;
+    }
+    /**
+     * Gets the class definition from the type.
+     * @param type - The type of the class.
+     * @return The class definition if it exists, `null` otherwise.
+     */
+    getClassDefinition(type) {
+        if (type in classes)
+            return classes[type];
+        return null;
+    }
+    /**
+     * Gets the property definition from the property.
+     *
+     * When the property is `id`, the definition is always returned.
+     * @param property - The property.
+     * @return The property definition if it exists, `null` otherwise.
+     */
+    getPropertyDefinition(property) {
+        if (property === "id")
+            return { isPending: false };
+        if (property in properties)
+            return properties[property];
+        return null;
+    }
+    /**
+     * Gets the extended classes from the type.
+     * @param type - The type of the class.
+     * @return An array of extended classes if they exist, `null` otherwise.
+     */
+    getExtendedClasses(type) {
+        const classesSet = new Set();
+        const classDefinition = this.getClassDefinition(type);
+        if (classDefinition) {
+            const { extends: extendsClasses } = classDefinition;
+            if (extendsClasses) {
+                for (const className of extendsClasses) {
+                    classesSet.add(className);
+                    const extendedClasses = this.getExtendedClasses(className);
+                    if (extendedClasses) {
+                        for (const extendedClass of extendedClasses) {
+                            classesSet.add(extendedClass);
+                        }
+                    }
+                }
+            }
+            return [...classesSet];
+        }
+        return null;
+    }
+    /**
+     * Validates the schema values.
+     * @param property - The property name.
+     * @param schemaValues - The schema values to validate.
+     * @return An array of validation reports.
+     */
+    validateValues(property, schemaValues) {
+        const result = [];
+        const propertyDefinition = this.getPropertyDefinition(property);
+        for (const schemaValue of schemaValues) {
+            const { kind } = schemaValue;
+            const jsonLDPath = kind === "node" ? schemaValue.linkLocation.jsonLDPath : schemaValue.location.jsonLDPath;
+            if (propertyDefinition) {
+                const { isPending, supersededBy } = propertyDefinition;
+                if (supersededBy) {
+                    result.push({
+                        type: "error",
+                        path: jsonLDPath ?? "",
+                        message: `The property \`${property}\` has been superseded: use \`${supersededBy}\` instead.`
+                    });
+                }
+                if (isPending) {
+                    result.push({
+                        type: "warning",
+                        path: jsonLDPath ?? "",
+                        message: `The property \`${property}\` is part of terms which are not yet part of the Schema.org vocabulary. Pending terms are subject to change and should be used with caution.`
+                    });
+                }
+                if (kind === "node") {
+                    const { node } = schemaValue;
+                    const { type } = node;
+                    const { type: typesInPropertyDefinition } = propertyDefinition;
+                    const extendsTypes = this.getExtendedClasses(type)?.some(className => typesInPropertyDefinition?.includes(className));
+                    if (!typesInPropertyDefinition?.includes(type) && !extendsTypes) {
+                        result.push({
+                            type: "error",
+                            path: jsonLDPath ?? "",
+                            message: `\`${type}\` is not a valid type for the property \`${property}\`.`
+                        });
+                    }
+                    result.push(...this.validateNode(node));
+                }
+            }
+            else {
+                result.push({
+                    type: "error",
+                    path: jsonLDPath ?? "",
+                    message: `The property \`${property}\` does not exist in the Schema.org vocabulary.`
+                });
+            }
+        }
+        return result;
+    }
+    /**
+     * Validates the schema node.
+     * @param node - The schema node to validate.
+     * @return An array of validation reports.
+     */
+    validateNode(node) {
+        const { type, location: { jsonLDPath }, properties } = node;
+        const result = [];
+        const classDefinition = this.getClassDefinition(type);
+        if (classDefinition) {
+            const { isPending, supersededBy } = classDefinition;
+            if (supersededBy) {
+                result.push({
+                    type: "error",
+                    path: jsonLDPath ?? "",
+                    message: `The type \`${type}\` has been superseded: use \`${supersededBy}\` instead.`
+                });
+            }
+            if (isPending) {
+                result.push({
+                    type: "warning",
+                    path: jsonLDPath ?? "",
+                    message: `The type \`${type}\` is part of terms which are not yet part of the Schema.org vocabulary. Pending terms are subject to change and should be used with caution.`
+                });
+            }
+            for (const [property, schemaValues] of properties) {
+                result.push(...this.validateValues(property, schemaValues));
+            }
+        }
+        else {
+            result.push({
+                type: "error",
+                path: jsonLDPath ?? "",
+                message: `The type \`${type}\` does not exist in the Schema.org vocabulary.`
+            });
+        }
+        return result;
+    }
+    /**
+     * Validates the schema graph.
+     */
+    validate() {
+        const { roots } = this.schemaGraph;
+        const result = [];
+        for (const root of roots) {
+            result.push(...this.validateNode(root));
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=schema-graph-validator.js.map

package/dist/validator/schema-graph-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-graph-validator.js","sourceRoot":"","sources":["../../src/validator/schema-graph-validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "schemata-validator",
+  "version": "0.1.0",
+  "description": "Check the validity of Schema.org vocabulary used in JSON-LD data",
+  "keywords": [
+    "json-ld",
+    "schema-org",
+    "web-semantic",
+    "validator"
+  ],
+  "homepage": "https://github.com/webdevbynight/schemata-validator",
+  "bugs": {
+    "url": "https://github.com/webdevbynight/schemata-validator/issues"
+  },
+  "author": "Victor Brito (https://victor-brito.dev)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/webdevbynight/schemata-validator.git"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "data",
+    "dist"
+  ],
+  "exports": {
+    "import": "./dist/index.js",
+    "types": "./dist/index.d.ts"
+  },
+  "bin": {
+    "schemata-validator": "./bin/cli.js"
+  },
+  "engines": {
+    "node": "^20.18.3 || ^22.12.0 || ^24.0.0",
+    "npm": ">=10.8.2",
+    "pnpm": ">=10.32.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.8",
+    "@commitlint/cli": "20.5.0",
+    "@commitlint/config-conventional": "20.5.0",
+    "@types/node": "24.12.0",
+    "husky": "9.1.7",
+    "typescript": "5.9.3",
+    "vitest": "4.1.0"
+  },
+  "scripts": {
+    "biome": "biome check --write .",
+    "biome:check": "biome check .",
+    "biome:format": "biome format --write .",
+    "biome:format:check": "biome format .",
+    "biome:lint": "biome lint --write .",
+    "biome:lint:check": "biome lint .",
+    "build": "tsc",
+    "dev": "pnpm tsc:watch & pnpm test:watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "tsc:watch": "tsc --watch --preserveWatchOutput"
+  }
+}