@puzzle-ui/seo 0.0.0-stage → 0.5.0

package/dist/schema/index.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_registry = require("./registry.cjs");
+const require_create_registry = require("./create-registry.cjs");
+const require_validate = require("./validate.cjs");
+const require_schemaorg = require("./generated/schemaorg.cjs");
+exports.SCHEMAORG_SOURCE_HASH = require_schemaorg.SCHEMAORG_SOURCE_HASH;
+exports.SCHEMAORG_VERSION = require_schemaorg.SCHEMAORG_VERSION;
+exports.createDefaultSchemaRegistry = require_create_registry.createDefaultSchemaRegistry;
+exports.createSchemaRegistry = require_registry.createSchemaRegistry;
+exports.generatedSchemaDefinitions = require_schemaorg.generatedSchemaDefinitions;
+exports.validateSchemaNode = require_validate.validateSchemaNode;

package/dist/schema/index.d.cts

@@ -0,0 +1,7 @@
+import { SchemaDefinition, SchemaDefinitionCollection, SchemaDefinitionSource, SchemaEnumerationValue, SchemaExtension, SchemaPropertyDefinition, SchemaPropertyType, SchemaReference, SchemaRegistry, SchemaRegistryConflict, SchemaRegistryOptions, SchemaRegistryProvider, SchemaValidationOptions } from "./types.cjs";
+import { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, generatedSchemaDefinitions } from "./generated/schemaorg.cjs";
+import { createSchemaRegistry } from "./registry.cjs";
+import { createDefaultSchemaRegistry } from "./create-registry.cjs";
+import { validateSchemaNode } from "./validate.cjs";
+import "./generated/index.cjs";
+export { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, type SchemaDefinition, type SchemaDefinitionCollection, type SchemaDefinitionSource, type SchemaEnumerationValue, type SchemaExtension, type SchemaPropertyDefinition, type SchemaPropertyType, type SchemaReference, type SchemaRegistry, type SchemaRegistryConflict, type SchemaRegistryOptions, type SchemaRegistryProvider, type SchemaValidationOptions, createDefaultSchemaRegistry, createSchemaRegistry, generatedSchemaDefinitions, validateSchemaNode };

package/dist/schema/index.d.ts

@@ -0,0 +1,6 @@
+import { SchemaDefinition, SchemaDefinitionCollection, SchemaDefinitionSource, SchemaEnumerationValue, SchemaExtension, SchemaPropertyDefinition, SchemaPropertyType, SchemaReference, SchemaRegistry, SchemaRegistryConflict, SchemaRegistryOptions, SchemaRegistryProvider, SchemaValidationOptions } from "./types.js";
+import { createSchemaRegistry } from "./registry.js";
+import { createDefaultSchemaRegistry } from "./create-registry.js";
+import { validateSchemaNode } from "./validate.js";
+import { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, generatedSchemaDefinitions } from "./generated/schemaorg.js";
+export { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, type SchemaDefinition, type SchemaDefinitionCollection, type SchemaDefinitionSource, type SchemaEnumerationValue, type SchemaExtension, type SchemaPropertyDefinition, type SchemaPropertyType, type SchemaReference, type SchemaRegistry, type SchemaRegistryConflict, type SchemaRegistryOptions, type SchemaRegistryProvider, type SchemaValidationOptions, createDefaultSchemaRegistry, createSchemaRegistry, generatedSchemaDefinitions, validateSchemaNode };

package/dist/schema/index.js

@@ -0,0 +1,5 @@
+import { createSchemaRegistry } from "./registry.js";
+import { createDefaultSchemaRegistry } from "./create-registry.js";
+import { validateSchemaNode } from "./validate.js";
+import { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, generatedSchemaDefinitions } from "./generated/schemaorg.js";
+export { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, createDefaultSchemaRegistry, createSchemaRegistry, generatedSchemaDefinitions, validateSchemaNode };

package/dist/schema/registry.cjs

@@ -0,0 +1,194 @@
+// src/schema/registry.ts
+const normalizeType = (type) => {
+	const value = type.trim();
+	if (!value) throw new Error("Schema type cannot be empty.");
+	return /^[A-Za-z][A-Za-z0-9]*$/.test(value) ? `https://schema.org/${value}` : value.replace(/^http:\/\/schema\.org\//, "https://schema.org/");
+};
+const isRdfVocabularyType = (type) => /^https?:\/\/www\.w3\.org\/(1999\/02\/22-rdf-syntax-ns|2000\/01\/rdf-schema)#/.test(type);
+/**
+* Recursively freezes registry-owned objects and arrays.
+*
+* Definitions are normalized into new objects before reaching this function,
+* so freezing them never mutates the caller's original input objects.
+*/
+const deepFreeze = (value) => {
+	if (value === null || typeof value !== "object" || Object.isFrozen(value)) return value;
+	Object.freeze(value);
+	for (const nestedValue of Object.values(value)) deepFreeze(nestedValue);
+	return value;
+};
+const normalizeEnumerationValue = (value) => ({
+	...value,
+	type: normalizeType(value.type)
+});
+const normalizeProperty = (property) => ({
+	...property,
+	expectedTypes: property.expectedTypes?.map(normalizeType),
+	rangeTypes: property.rangeTypes?.map(normalizeType),
+	domainTypes: property.domainTypes?.map(normalizeType),
+	inverseOf: property.inverseOf ? normalizeType(property.inverseOf) : void 0,
+	supersededBy: property.supersededBy ? normalizeType(property.supersededBy) : void 0,
+	type: Array.isArray(property.type) ? property.type.map(normalizeType) : normalizeType(property.type)
+});
+/**
+* Normalizes a definition and assigns its authoritative source.
+*
+* The source is determined by the collection the definition came from,
+* never by the caller-provided source property.
+*/
+const normalizeDefinition = (definition, source) => ({
+	...definition,
+	type: normalizeType(definition.type),
+	source,
+	parentTypes: definition.parentTypes?.map(normalizeType),
+	enumerationValues: definition.enumerationValues?.map(normalizeEnumerationValue),
+	properties: definition.properties?.map(normalizeProperty)
+});
+const deduplicateProperties = (definitions, conflicts) => {
+	for (const definition of definitions) {
+		const seen = /* @__PURE__ */ new Set();
+		definition.properties = definition.properties?.filter((property) => {
+			if (seen.has(property.name)) {
+				conflicts.push({
+					type: definition.type,
+					property: property.name,
+					code: "duplicate-property",
+					message: `Duplicate property ${property.name} on ${definition.type}.`
+				});
+				return false;
+			}
+			seen.add(property.name);
+			return true;
+		});
+	}
+};
+const createSchemaRegistry = (options = {}) => {
+	const generated = (options.generated ?? []).map((definition) => normalizeDefinition(definition, "generated"));
+	const custom = (options.custom ?? []).map((definition) => normalizeDefinition(definition, "custom"));
+	const conflicts = [];
+	const definitions = /* @__PURE__ */ new Map();
+	for (const definition of generated) {
+		if (definitions.has(definition.type)) {
+			conflicts.push({
+				type: definition.type,
+				code: "duplicate-type",
+				message: `Duplicate generated schema type: ${definition.type}`
+			});
+			continue;
+		}
+		definitions.set(definition.type, definition);
+	}
+	for (const definition of custom) {
+		const existing = definitions.get(definition.type);
+		if (existing) {
+			if (!(options.allowGeneratedOverrides === true && existing.source === "generated")) {
+				conflicts.push({
+					type: definition.type,
+					code: "duplicate-type",
+					message: existing.source === "generated" ? `Custom schema type conflicts with generated type: ${definition.type}` : `Duplicate custom schema type: ${definition.type}`
+				});
+				continue;
+			}
+		}
+		definitions.set(definition.type, definition);
+	}
+	deduplicateProperties(definitions.values(), conflicts);
+	for (const extension of options.extensions ?? []) {
+		const type = normalizeType(extension.type);
+		const existing = definitions.get(type);
+		if (!existing) {
+			conflicts.push({
+				type,
+				code: "unknown-parent",
+				message: `Cannot extend unknown schema type: ${type}`
+			});
+			continue;
+		}
+		if (extension.namespace && existing.namespace && extension.namespace !== existing.namespace) {
+			conflicts.push({
+				type,
+				code: "namespace-mismatch",
+				message: `Extension namespace does not match ${type}.`
+			});
+			continue;
+		}
+		const properties = /* @__PURE__ */ new Map();
+		for (const property of existing.properties ?? []) properties.set(property.name, property);
+		const extensionPropertyNames = /* @__PURE__ */ new Set();
+		for (const property of extension.properties) {
+			if (properties.has(property.name) || extensionPropertyNames.has(property.name)) {
+				conflicts.push({
+					type,
+					property: property.name,
+					code: "duplicate-property",
+					message: `Property ${property.name} already exists on ${type}.`
+				});
+				continue;
+			}
+			extensionPropertyNames.add(property.name);
+			properties.set(property.name, normalizeProperty(property));
+		}
+		definitions.set(type, {
+			...existing,
+			properties: [...properties.values()]
+		});
+	}
+	for (const definition of definitions.values()) for (const parentType of definition.parentTypes ?? []) {
+		if (definitions.has(parentType) || isRdfVocabularyType(parentType)) continue;
+		conflicts.push({
+			type: definition.type,
+			code: "unknown-parent",
+			message: `Unknown parent type ${parentType} referenced by ${definition.type}.`
+		});
+	}
+	for (const definition of definitions.values()) deepFreeze(definition);
+	const frozenGenerated = deepFreeze(generated);
+	const frozenCustom = deepFreeze(custom);
+	const collection = deepFreeze({
+		generated: frozenGenerated,
+		custom: frozenCustom
+	});
+	const frozenConflicts = deepFreeze(conflicts);
+	const get = (type) => definitions.get(normalizeType(type));
+	const getAncestors = (type, visited = /* @__PURE__ */ new Set()) => {
+		const definition = get(type);
+		if (!definition) return [];
+		const result = [];
+		for (const parentType of definition.parentTypes ?? []) {
+			if (visited.has(parentType)) continue;
+			visited.add(parentType);
+			const parent = get(parentType);
+			if (!parent) continue;
+			result.push(parent);
+			result.push(...getAncestors(parentType, visited));
+		}
+		return result;
+	};
+	const getProperties = (type, inherited = true) => {
+		const definition = get(type);
+		if (!definition) return [];
+		const properties = /* @__PURE__ */ new Map();
+		if (inherited) for (const ancestor of [...getAncestors(type)].reverse()) for (const property of ancestor.properties ?? []) properties.set(property.name, property);
+		for (const property of definition.properties ?? []) properties.set(property.name, property);
+		return [...properties.values()];
+	};
+	const isTypeOf = (type, expectedType) => {
+		const normalizedType = normalizeType(type);
+		const normalizedExpected = normalizeType(expectedType);
+		return normalizedType === normalizedExpected || getAncestors(normalizedType).some((ancestor) => ancestor.type === normalizedExpected);
+	};
+	return Object.freeze({
+		get,
+		has: (type) => Boolean(get(type)),
+		getAll: () => [...definitions.values()],
+		getProperty: (type, property) => getProperties(type).find((item) => item.name === property),
+		getProperties: (type, options) => getProperties(type, options?.inherited ?? true),
+		getAncestors,
+		isTypeOf,
+		getCollection: () => collection,
+		getConflicts: () => frozenConflicts
+	});
+};
+exports.createSchemaRegistry = createSchemaRegistry;
+
+//# sourceMappingURL=registry.cjs.map

package/dist/schema/registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.cjs","names":[],"sources":["../../src/schema/registry.ts"],"sourcesContent":["import type {\n  SchemaDefinition,\n  SchemaEnumerationValue,\n  SchemaPropertyDefinition,\n  SchemaRegistry,\n  SchemaRegistryConflict,\n  SchemaRegistryOptions,\n} from \"./types\";\n\nconst normalizeType = (type: string): string => {\n  const value = type.trim();\n\n  if (!value) {\n    throw new Error(\"Schema type cannot be empty.\");\n  }\n\n  return /^[A-Za-z][A-Za-z0-9]*$/.test(value)\n    ? `https://schema.org/${value}`\n    : value.replace(/^http:\\/\\/schema\\.org\\//, \"https://schema.org/\");\n};\n\nconst isRdfVocabularyType = (type: string): boolean =>\n  /^https?:\\/\\/www\\.w3\\.org\\/(1999\\/02\\/22-rdf-syntax-ns|2000\\/01\\/rdf-schema)#/.test(\n    type,\n  );\n\n/**\n * Recursively freezes registry-owned objects and arrays.\n *\n * Definitions are normalized into new objects before reaching this function,\n * so freezing them never mutates the caller's original input objects.\n */\nconst deepFreeze = <T>(value: T): T => {\n  if (value === null || typeof value !== \"object\" || Object.isFrozen(value)) {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const nestedValue of Object.values(value)) {\n    deepFreeze(nestedValue);\n  }\n\n  return value;\n};\n\nconst normalizeEnumerationValue = (\n  value: SchemaEnumerationValue,\n): SchemaEnumerationValue => ({\n  ...value,\n  type: normalizeType(value.type),\n});\n\nconst normalizeProperty = (\n  property: SchemaPropertyDefinition,\n): SchemaPropertyDefinition => ({\n  ...property,\n  expectedTypes: property.expectedTypes?.map(normalizeType),\n  rangeTypes: property.rangeTypes?.map(normalizeType),\n  domainTypes: property.domainTypes?.map(normalizeType),\n  inverseOf: property.inverseOf ? normalizeType(property.inverseOf) : undefined,\n  supersededBy: property.supersededBy\n    ? normalizeType(property.supersededBy)\n    : undefined,\n  type: Array.isArray(property.type)\n    ? property.type.map(normalizeType)\n    : normalizeType(property.type),\n});\n\n/**\n * Normalizes a definition and assigns its authoritative source.\n *\n * The source is determined by the collection the definition came from,\n * never by the caller-provided source property.\n */\nconst normalizeDefinition = (\n  definition: SchemaDefinition,\n  source: SchemaDefinition[\"source\"],\n): SchemaDefinition => ({\n  ...definition,\n  type: normalizeType(definition.type),\n  source,\n  parentTypes: definition.parentTypes?.map(normalizeType),\n  enumerationValues: definition.enumerationValues?.map(\n    normalizeEnumerationValue,\n  ),\n  properties: definition.properties?.map(normalizeProperty),\n});\n\nconst deduplicateProperties = (\n  definitions: Iterable<SchemaDefinition>,\n  conflicts: SchemaRegistryConflict[],\n): void => {\n  for (const definition of definitions) {\n    const seen = new Set<string>();\n\n    definition.properties = definition.properties?.filter((property) => {\n      if (seen.has(property.name)) {\n        conflicts.push({\n          type: definition.type,\n          property: property.name,\n          code: \"duplicate-property\",\n          message: `Duplicate property ${property.name} on ${definition.type}.`,\n        });\n\n        return false;\n      }\n\n      seen.add(property.name);\n      return true;\n    });\n  }\n};\n\nexport const createSchemaRegistry = (\n  options: SchemaRegistryOptions = {},\n): SchemaRegistry => {\n  // Collection membership is the source of truth. Ignore any source value\n  // supplied by callers to prevent custom definitions impersonating generated\n  // definitions (or vice versa).\n  const generated = (options.generated ?? []).map((definition) =>\n    normalizeDefinition(definition, \"generated\"),\n  );\n\n  const custom = (options.custom ?? []).map((definition) =>\n    normalizeDefinition(definition, \"custom\"),\n  );\n\n  const conflicts: SchemaRegistryConflict[] = [];\n\n  const definitions = new Map<string, SchemaDefinition>();\n\n  for (const definition of generated) {\n    if (definitions.has(definition.type)) {\n      conflicts.push({\n        type: definition.type,\n        code: \"duplicate-type\",\n        message: `Duplicate generated schema type: ${definition.type}`,\n      });\n\n      continue;\n    }\n\n    definitions.set(definition.type, definition);\n  }\n\n  // Only generated definitions may be overridden, and only when explicitly\n  // enabled. A custom definition can never silently replace another custom\n  // definition, even when allowGeneratedOverrides is true.\n  for (const definition of custom) {\n    const existing = definitions.get(definition.type);\n\n    if (existing) {\n      const canOverrideGenerated =\n        options.allowGeneratedOverrides === true &&\n        existing.source === \"generated\";\n\n      if (!canOverrideGenerated) {\n        conflicts.push({\n          type: definition.type,\n          code: \"duplicate-type\",\n          message:\n            existing.source === \"generated\"\n              ? `Custom schema type conflicts with generated type: ${definition.type}`\n              : `Duplicate custom schema type: ${definition.type}`,\n        });\n\n        continue;\n      }\n    }\n\n    definitions.set(definition.type, definition);\n  }\n\n  // Validate the effective definitions before applying extensions. This also\n  // catches duplicates in definitions that would otherwise be collapsed by\n  // the extension merge operation.\n  deduplicateProperties(definitions.values(), conflicts);\n\n  for (const extension of options.extensions ?? []) {\n    const type = normalizeType(extension.type);\n    const existing = definitions.get(type);\n\n    if (!existing) {\n      conflicts.push({\n        type,\n        code: \"unknown-parent\",\n        message: `Cannot extend unknown schema type: ${type}`,\n      });\n\n      continue;\n    }\n\n    if (\n      extension.namespace &&\n      existing.namespace &&\n      extension.namespace !== existing.namespace\n    ) {\n      conflicts.push({\n        type,\n        code: \"namespace-mismatch\",\n        message: `Extension namespace does not match ${type}.`,\n      });\n\n      continue;\n    }\n\n    const properties = new Map<string, SchemaPropertyDefinition>();\n\n    for (const property of existing.properties ?? []) {\n      properties.set(property.name, property);\n    }\n\n    const extensionPropertyNames = new Set<string>();\n\n    for (const property of extension.properties) {\n      if (\n        properties.has(property.name) ||\n        extensionPropertyNames.has(property.name)\n      ) {\n        conflicts.push({\n          type,\n          property: property.name,\n          code: \"duplicate-property\",\n          message: `Property ${property.name} already exists on ${type}.`,\n        });\n\n        continue;\n      }\n\n      extensionPropertyNames.add(property.name);\n      properties.set(property.name, normalizeProperty(property));\n    }\n\n    definitions.set(type, {\n      ...existing,\n      properties: [...properties.values()],\n    });\n  }\n\n  // Report parent references that cannot be resolved by this registry.\n  // RDF/RDFS meta-classes (e.g. DataType → rdfs:Class) are vocabulary\n  // structure, not Schema.org types, so they are never registered.\n  for (const definition of definitions.values()) {\n    for (const parentType of definition.parentTypes ?? []) {\n      if (definitions.has(parentType) || isRdfVocabularyType(parentType)) {\n        continue;\n      }\n\n      conflicts.push({\n        type: definition.type,\n        code: \"unknown-parent\",\n        message: `Unknown parent type ${parentType} referenced by ${definition.type}.`,\n      });\n    }\n  }\n\n  // Freeze every effective definition after all extensions have been applied.\n  // This includes nested property metadata, enumeration values and arrays.\n  for (const definition of definitions.values()) {\n    deepFreeze(definition);\n  }\n\n  // Keep the generated/custom collections immutable as well. They contain\n  // normalized copies, not references to the caller's original definitions.\n  const frozenGenerated = deepFreeze(generated);\n  const frozenCustom = deepFreeze(custom);\n\n  const collection = deepFreeze({\n    generated: frozenGenerated,\n    custom: frozenCustom,\n  });\n\n  const frozenConflicts = deepFreeze(conflicts);\n\n  const get = (type: string) => definitions.get(normalizeType(type));\n\n  const getAncestors = (\n    type: string,\n    visited = new Set<string>(),\n  ): SchemaDefinition[] => {\n    const definition = get(type);\n\n    if (!definition) {\n      return [];\n    }\n\n    const result: SchemaDefinition[] = [];\n\n    for (const parentType of definition.parentTypes ?? []) {\n      if (visited.has(parentType)) {\n        continue;\n      }\n\n      visited.add(parentType);\n\n      const parent = get(parentType);\n\n      if (!parent) {\n        continue;\n      }\n\n      result.push(parent);\n      result.push(...getAncestors(parentType, visited));\n    }\n\n    return result;\n  };\n\n  const getProperties = (\n    type: string,\n    inherited = true,\n  ): readonly SchemaPropertyDefinition[] => {\n    const definition = get(type);\n\n    if (!definition) {\n      return [];\n    }\n\n    const properties = new Map<string, SchemaPropertyDefinition>();\n\n    if (inherited) {\n      for (const ancestor of [...getAncestors(type)].reverse()) {\n        for (const property of ancestor.properties ?? []) {\n          properties.set(property.name, property);\n        }\n      }\n    }\n\n    for (const property of definition.properties ?? []) {\n      properties.set(property.name, property);\n    }\n\n    return [...properties.values()];\n  };\n\n  const isTypeOf = (type: string, expectedType: string): boolean => {\n    const normalizedType = normalizeType(type);\n    const normalizedExpected = normalizeType(expectedType);\n\n    return (\n      normalizedType === normalizedExpected ||\n      getAncestors(normalizedType).some(\n        (ancestor) => ancestor.type === normalizedExpected,\n      )\n    );\n  };\n\n  return Object.freeze({\n    get,\n    has: (type: string) => Boolean(get(type)),\n    getAll: () => [...definitions.values()],\n\n    getProperty: (type: string, property: string) =>\n      getProperties(type).find((item) => item.name === property),\n\n    getProperties: (type: string, options?: { inherited?: boolean }) =>\n      getProperties(type, options?.inherited ?? true),\n\n    getAncestors,\n\n    isTypeOf,\n\n    getCollection: () => collection,\n\n    getConflicts: () => frozenConflicts,\n  });\n};\n"],"mappings":"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"}

package/dist/schema/registry.d.cts

@@ -0,0 +1,2 @@
+import { SchemaRegistry, SchemaRegistryOptions } from "./types.cjs";
+export declare const createSchemaRegistry: (options?: SchemaRegistryOptions) => SchemaRegistry;

package/dist/schema/registry.d.ts

@@ -0,0 +1,2 @@
+import { SchemaRegistry, SchemaRegistryOptions } from "./types.js";
+export declare const createSchemaRegistry: (options?: SchemaRegistryOptions) => SchemaRegistry;

package/dist/schema/registry.js

@@ -0,0 +1,194 @@
+// src/schema/registry.ts
+const normalizeType = (type) => {
+	const value = type.trim();
+	if (!value) throw new Error("Schema type cannot be empty.");
+	return /^[A-Za-z][A-Za-z0-9]*$/.test(value) ? `https://schema.org/${value}` : value.replace(/^http:\/\/schema\.org\//, "https://schema.org/");
+};
+const isRdfVocabularyType = (type) => /^https?:\/\/www\.w3\.org\/(1999\/02\/22-rdf-syntax-ns|2000\/01\/rdf-schema)#/.test(type);
+/**
+* Recursively freezes registry-owned objects and arrays.
+*
+* Definitions are normalized into new objects before reaching this function,
+* so freezing them never mutates the caller's original input objects.
+*/
+const deepFreeze = (value) => {
+	if (value === null || typeof value !== "object" || Object.isFrozen(value)) return value;
+	Object.freeze(value);
+	for (const nestedValue of Object.values(value)) deepFreeze(nestedValue);
+	return value;
+};
+const normalizeEnumerationValue = (value) => ({
+	...value,
+	type: normalizeType(value.type)
+});
+const normalizeProperty = (property) => ({
+	...property,
+	expectedTypes: property.expectedTypes?.map(normalizeType),
+	rangeTypes: property.rangeTypes?.map(normalizeType),
+	domainTypes: property.domainTypes?.map(normalizeType),
+	inverseOf: property.inverseOf ? normalizeType(property.inverseOf) : void 0,
+	supersededBy: property.supersededBy ? normalizeType(property.supersededBy) : void 0,
+	type: Array.isArray(property.type) ? property.type.map(normalizeType) : normalizeType(property.type)
+});
+/**
+* Normalizes a definition and assigns its authoritative source.
+*
+* The source is determined by the collection the definition came from,
+* never by the caller-provided source property.
+*/
+const normalizeDefinition = (definition, source) => ({
+	...definition,
+	type: normalizeType(definition.type),
+	source,
+	parentTypes: definition.parentTypes?.map(normalizeType),
+	enumerationValues: definition.enumerationValues?.map(normalizeEnumerationValue),
+	properties: definition.properties?.map(normalizeProperty)
+});
+const deduplicateProperties = (definitions, conflicts) => {
+	for (const definition of definitions) {
+		const seen = /* @__PURE__ */ new Set();
+		definition.properties = definition.properties?.filter((property) => {
+			if (seen.has(property.name)) {
+				conflicts.push({
+					type: definition.type,
+					property: property.name,
+					code: "duplicate-property",
+					message: `Duplicate property ${property.name} on ${definition.type}.`
+				});
+				return false;
+			}
+			seen.add(property.name);
+			return true;
+		});
+	}
+};
+const createSchemaRegistry = (options = {}) => {
+	const generated = (options.generated ?? []).map((definition) => normalizeDefinition(definition, "generated"));
+	const custom = (options.custom ?? []).map((definition) => normalizeDefinition(definition, "custom"));
+	const conflicts = [];
+	const definitions = /* @__PURE__ */ new Map();
+	for (const definition of generated) {
+		if (definitions.has(definition.type)) {
+			conflicts.push({
+				type: definition.type,
+				code: "duplicate-type",
+				message: `Duplicate generated schema type: ${definition.type}`
+			});
+			continue;
+		}
+		definitions.set(definition.type, definition);
+	}
+	for (const definition of custom) {
+		const existing = definitions.get(definition.type);
+		if (existing) {
+			if (!(options.allowGeneratedOverrides === true && existing.source === "generated")) {
+				conflicts.push({
+					type: definition.type,
+					code: "duplicate-type",
+					message: existing.source === "generated" ? `Custom schema type conflicts with generated type: ${definition.type}` : `Duplicate custom schema type: ${definition.type}`
+				});
+				continue;
+			}
+		}
+		definitions.set(definition.type, definition);
+	}
+	deduplicateProperties(definitions.values(), conflicts);
+	for (const extension of options.extensions ?? []) {
+		const type = normalizeType(extension.type);
+		const existing = definitions.get(type);
+		if (!existing) {
+			conflicts.push({
+				type,
+				code: "unknown-parent",
+				message: `Cannot extend unknown schema type: ${type}`
+			});
+			continue;
+		}
+		if (extension.namespace && existing.namespace && extension.namespace !== existing.namespace) {
+			conflicts.push({
+				type,
+				code: "namespace-mismatch",
+				message: `Extension namespace does not match ${type}.`
+			});
+			continue;
+		}
+		const properties = /* @__PURE__ */ new Map();
+		for (const property of existing.properties ?? []) properties.set(property.name, property);
+		const extensionPropertyNames = /* @__PURE__ */ new Set();
+		for (const property of extension.properties) {
+			if (properties.has(property.name) || extensionPropertyNames.has(property.name)) {
+				conflicts.push({
+					type,
+					property: property.name,
+					code: "duplicate-property",
+					message: `Property ${property.name} already exists on ${type}.`
+				});
+				continue;
+			}
+			extensionPropertyNames.add(property.name);
+			properties.set(property.name, normalizeProperty(property));
+		}
+		definitions.set(type, {
+			...existing,
+			properties: [...properties.values()]
+		});
+	}
+	for (const definition of definitions.values()) for (const parentType of definition.parentTypes ?? []) {
+		if (definitions.has(parentType) || isRdfVocabularyType(parentType)) continue;
+		conflicts.push({
+			type: definition.type,
+			code: "unknown-parent",
+			message: `Unknown parent type ${parentType} referenced by ${definition.type}.`
+		});
+	}
+	for (const definition of definitions.values()) deepFreeze(definition);
+	const frozenGenerated = deepFreeze(generated);
+	const frozenCustom = deepFreeze(custom);
+	const collection = deepFreeze({
+		generated: frozenGenerated,
+		custom: frozenCustom
+	});
+	const frozenConflicts = deepFreeze(conflicts);
+	const get = (type) => definitions.get(normalizeType(type));
+	const getAncestors = (type, visited = /* @__PURE__ */ new Set()) => {
+		const definition = get(type);
+		if (!definition) return [];
+		const result = [];
+		for (const parentType of definition.parentTypes ?? []) {
+			if (visited.has(parentType)) continue;
+			visited.add(parentType);
+			const parent = get(parentType);
+			if (!parent) continue;
+			result.push(parent);
+			result.push(...getAncestors(parentType, visited));
+		}
+		return result;
+	};
+	const getProperties = (type, inherited = true) => {
+		const definition = get(type);
+		if (!definition) return [];
+		const properties = /* @__PURE__ */ new Map();
+		if (inherited) for (const ancestor of [...getAncestors(type)].reverse()) for (const property of ancestor.properties ?? []) properties.set(property.name, property);
+		for (const property of definition.properties ?? []) properties.set(property.name, property);
+		return [...properties.values()];
+	};
+	const isTypeOf = (type, expectedType) => {
+		const normalizedType = normalizeType(type);
+		const normalizedExpected = normalizeType(expectedType);
+		return normalizedType === normalizedExpected || getAncestors(normalizedType).some((ancestor) => ancestor.type === normalizedExpected);
+	};
+	return Object.freeze({
+		get,
+		has: (type) => Boolean(get(type)),
+		getAll: () => [...definitions.values()],
+		getProperty: (type, property) => getProperties(type).find((item) => item.name === property),
+		getProperties: (type, options) => getProperties(type, options?.inherited ?? true),
+		getAncestors,
+		isTypeOf,
+		getCollection: () => collection,
+		getConflicts: () => frozenConflicts
+	});
+};
+export { createSchemaRegistry };
+
+//# sourceMappingURL=registry.js.map

package/dist/schema/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/schema/registry.ts"],"sourcesContent":["import type {\n  SchemaDefinition,\n  SchemaEnumerationValue,\n  SchemaPropertyDefinition,\n  SchemaRegistry,\n  SchemaRegistryConflict,\n  SchemaRegistryOptions,\n} from \"./types\";\n\nconst normalizeType = (type: string): string => {\n  const value = type.trim();\n\n  if (!value) {\n    throw new Error(\"Schema type cannot be empty.\");\n  }\n\n  return /^[A-Za-z][A-Za-z0-9]*$/.test(value)\n    ? `https://schema.org/${value}`\n    : value.replace(/^http:\\/\\/schema\\.org\\//, \"https://schema.org/\");\n};\n\nconst isRdfVocabularyType = (type: string): boolean =>\n  /^https?:\\/\\/www\\.w3\\.org\\/(1999\\/02\\/22-rdf-syntax-ns|2000\\/01\\/rdf-schema)#/.test(\n    type,\n  );\n\n/**\n * Recursively freezes registry-owned objects and arrays.\n *\n * Definitions are normalized into new objects before reaching this function,\n * so freezing them never mutates the caller's original input objects.\n */\nconst deepFreeze = <T>(value: T): T => {\n  if (value === null || typeof value !== \"object\" || Object.isFrozen(value)) {\n    return value;\n  }\n\n  Object.freeze(value);\n\n  for (const nestedValue of Object.values(value)) {\n    deepFreeze(nestedValue);\n  }\n\n  return value;\n};\n\nconst normalizeEnumerationValue = (\n  value: SchemaEnumerationValue,\n): SchemaEnumerationValue => ({\n  ...value,\n  type: normalizeType(value.type),\n});\n\nconst normalizeProperty = (\n  property: SchemaPropertyDefinition,\n): SchemaPropertyDefinition => ({\n  ...property,\n  expectedTypes: property.expectedTypes?.map(normalizeType),\n  rangeTypes: property.rangeTypes?.map(normalizeType),\n  domainTypes: property.domainTypes?.map(normalizeType),\n  inverseOf: property.inverseOf ? normalizeType(property.inverseOf) : undefined,\n  supersededBy: property.supersededBy\n    ? normalizeType(property.supersededBy)\n    : undefined,\n  type: Array.isArray(property.type)\n    ? property.type.map(normalizeType)\n    : normalizeType(property.type),\n});\n\n/**\n * Normalizes a definition and assigns its authoritative source.\n *\n * The source is determined by the collection the definition came from,\n * never by the caller-provided source property.\n */\nconst normalizeDefinition = (\n  definition: SchemaDefinition,\n  source: SchemaDefinition[\"source\"],\n): SchemaDefinition => ({\n  ...definition,\n  type: normalizeType(definition.type),\n  source,\n  parentTypes: definition.parentTypes?.map(normalizeType),\n  enumerationValues: definition.enumerationValues?.map(\n    normalizeEnumerationValue,\n  ),\n  properties: definition.properties?.map(normalizeProperty),\n});\n\nconst deduplicateProperties = (\n  definitions: Iterable<SchemaDefinition>,\n  conflicts: SchemaRegistryConflict[],\n): void => {\n  for (const definition of definitions) {\n    const seen = new Set<string>();\n\n    definition.properties = definition.properties?.filter((property) => {\n      if (seen.has(property.name)) {\n        conflicts.push({\n          type: definition.type,\n          property: property.name,\n          code: \"duplicate-property\",\n          message: `Duplicate property ${property.name} on ${definition.type}.`,\n        });\n\n        return false;\n      }\n\n      seen.add(property.name);\n      return true;\n    });\n  }\n};\n\nexport const createSchemaRegistry = (\n  options: SchemaRegistryOptions = {},\n): SchemaRegistry => {\n  // Collection membership is the source of truth. Ignore any source value\n  // supplied by callers to prevent custom definitions impersonating generated\n  // definitions (or vice versa).\n  const generated = (options.generated ?? []).map((definition) =>\n    normalizeDefinition(definition, \"generated\"),\n  );\n\n  const custom = (options.custom ?? []).map((definition) =>\n    normalizeDefinition(definition, \"custom\"),\n  );\n\n  const conflicts: SchemaRegistryConflict[] = [];\n\n  const definitions = new Map<string, SchemaDefinition>();\n\n  for (const definition of generated) {\n    if (definitions.has(definition.type)) {\n      conflicts.push({\n        type: definition.type,\n        code: \"duplicate-type\",\n        message: `Duplicate generated schema type: ${definition.type}`,\n      });\n\n      continue;\n    }\n\n    definitions.set(definition.type, definition);\n  }\n\n  // Only generated definitions may be overridden, and only when explicitly\n  // enabled. A custom definition can never silently replace another custom\n  // definition, even when allowGeneratedOverrides is true.\n  for (const definition of custom) {\n    const existing = definitions.get(definition.type);\n\n    if (existing) {\n      const canOverrideGenerated =\n        options.allowGeneratedOverrides === true &&\n        existing.source === \"generated\";\n\n      if (!canOverrideGenerated) {\n        conflicts.push({\n          type: definition.type,\n          code: \"duplicate-type\",\n          message:\n            existing.source === \"generated\"\n              ? `Custom schema type conflicts with generated type: ${definition.type}`\n              : `Duplicate custom schema type: ${definition.type}`,\n        });\n\n        continue;\n      }\n    }\n\n    definitions.set(definition.type, definition);\n  }\n\n  // Validate the effective definitions before applying extensions. This also\n  // catches duplicates in definitions that would otherwise be collapsed by\n  // the extension merge operation.\n  deduplicateProperties(definitions.values(), conflicts);\n\n  for (const extension of options.extensions ?? []) {\n    const type = normalizeType(extension.type);\n    const existing = definitions.get(type);\n\n    if (!existing) {\n      conflicts.push({\n        type,\n        code: \"unknown-parent\",\n        message: `Cannot extend unknown schema type: ${type}`,\n      });\n\n      continue;\n    }\n\n    if (\n      extension.namespace &&\n      existing.namespace &&\n      extension.namespace !== existing.namespace\n    ) {\n      conflicts.push({\n        type,\n        code: \"namespace-mismatch\",\n        message: `Extension namespace does not match ${type}.`,\n      });\n\n      continue;\n    }\n\n    const properties = new Map<string, SchemaPropertyDefinition>();\n\n    for (const property of existing.properties ?? []) {\n      properties.set(property.name, property);\n    }\n\n    const extensionPropertyNames = new Set<string>();\n\n    for (const property of extension.properties) {\n      if (\n        properties.has(property.name) ||\n        extensionPropertyNames.has(property.name)\n      ) {\n        conflicts.push({\n          type,\n          property: property.name,\n          code: \"duplicate-property\",\n          message: `Property ${property.name} already exists on ${type}.`,\n        });\n\n        continue;\n      }\n\n      extensionPropertyNames.add(property.name);\n      properties.set(property.name, normalizeProperty(property));\n    }\n\n    definitions.set(type, {\n      ...existing,\n      properties: [...properties.values()],\n    });\n  }\n\n  // Report parent references that cannot be resolved by this registry.\n  // RDF/RDFS meta-classes (e.g. DataType → rdfs:Class) are vocabulary\n  // structure, not Schema.org types, so they are never registered.\n  for (const definition of definitions.values()) {\n    for (const parentType of definition.parentTypes ?? []) {\n      if (definitions.has(parentType) || isRdfVocabularyType(parentType)) {\n        continue;\n      }\n\n      conflicts.push({\n        type: definition.type,\n        code: \"unknown-parent\",\n        message: `Unknown parent type ${parentType} referenced by ${definition.type}.`,\n      });\n    }\n  }\n\n  // Freeze every effective definition after all extensions have been applied.\n  // This includes nested property metadata, enumeration values and arrays.\n  for (const definition of definitions.values()) {\n    deepFreeze(definition);\n  }\n\n  // Keep the generated/custom collections immutable as well. They contain\n  // normalized copies, not references to the caller's original definitions.\n  const frozenGenerated = deepFreeze(generated);\n  const frozenCustom = deepFreeze(custom);\n\n  const collection = deepFreeze({\n    generated: frozenGenerated,\n    custom: frozenCustom,\n  });\n\n  const frozenConflicts = deepFreeze(conflicts);\n\n  const get = (type: string) => definitions.get(normalizeType(type));\n\n  const getAncestors = (\n    type: string,\n    visited = new Set<string>(),\n  ): SchemaDefinition[] => {\n    const definition = get(type);\n\n    if (!definition) {\n      return [];\n    }\n\n    const result: SchemaDefinition[] = [];\n\n    for (const parentType of definition.parentTypes ?? []) {\n      if (visited.has(parentType)) {\n        continue;\n      }\n\n      visited.add(parentType);\n\n      const parent = get(parentType);\n\n      if (!parent) {\n        continue;\n      }\n\n      result.push(parent);\n      result.push(...getAncestors(parentType, visited));\n    }\n\n    return result;\n  };\n\n  const getProperties = (\n    type: string,\n    inherited = true,\n  ): readonly SchemaPropertyDefinition[] => {\n    const definition = get(type);\n\n    if (!definition) {\n      return [];\n    }\n\n    const properties = new Map<string, SchemaPropertyDefinition>();\n\n    if (inherited) {\n      for (const ancestor of [...getAncestors(type)].reverse()) {\n        for (const property of ancestor.properties ?? []) {\n          properties.set(property.name, property);\n        }\n      }\n    }\n\n    for (const property of definition.properties ?? []) {\n      properties.set(property.name, property);\n    }\n\n    return [...properties.values()];\n  };\n\n  const isTypeOf = (type: string, expectedType: string): boolean => {\n    const normalizedType = normalizeType(type);\n    const normalizedExpected = normalizeType(expectedType);\n\n    return (\n      normalizedType === normalizedExpected ||\n      getAncestors(normalizedType).some(\n        (ancestor) => ancestor.type === normalizedExpected,\n      )\n    );\n  };\n\n  return Object.freeze({\n    get,\n    has: (type: string) => Boolean(get(type)),\n    getAll: () => [...definitions.values()],\n\n    getProperty: (type: string, property: string) =>\n      getProperties(type).find((item) => item.name === property),\n\n    getProperties: (type: string, options?: { inherited?: boolean }) =>\n      getProperties(type, options?.inherited ?? true),\n\n    getAncestors,\n\n    isTypeOf,\n\n    getCollection: () => collection,\n\n    getConflicts: () => frozenConflicts,\n  });\n};\n"],"mappings":"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"}

package/dist/schema/types.d.cts

@@ -0,0 +1,79 @@
+import { JsonObject, SeoNode, SeoNodeId } from "../core/types.cjs";
+export type SchemaDefinitionSource = "generated" | "custom";
+export type SchemaPropertyType = string | string[];
+export interface SchemaEnumerationValue {
+  name: string;
+  type: string;
+  description?: string;
+}
+export interface SchemaPropertyDefinition {
+  name: string;
+  type: SchemaPropertyType;
+  required?: boolean;
+  multiple?: boolean;
+  description?: string;
+  expectedTypes?: string[];
+  domainTypes?: string[];
+  rangeTypes?: string[];
+  inverseOf?: string;
+  supersededBy?: string;
+}
+export interface SchemaDefinition<T extends SeoNode = SeoNode> {
+  name: string;
+  type: string;
+  source: SchemaDefinitionSource;
+  description?: string;
+  properties?: readonly SchemaPropertyDefinition[];
+  parentTypes?: readonly string[];
+  enumerationValues?: readonly SchemaEnumerationValue[];
+  nodeType?: string;
+  namespace?: string;
+  create?: (input: JsonObject) => T;
+}
+export interface SchemaExtension {
+  type: string;
+  namespace?: string;
+  properties: readonly SchemaPropertyDefinition[];
+  description?: string;
+  parentTypes?: readonly string[];
+}
+export interface SchemaReference {
+  id: SeoNodeId | string;
+  type?: string;
+}
+export interface SchemaRegistryProvider {
+  get(type: string): SchemaDefinition | undefined;
+  has(type: string): boolean;
+  getAll(): readonly SchemaDefinition[];
+}
+export interface SchemaValidationOptions {
+  strict?: boolean;
+  allowUnknownProperties?: boolean;
+  validateRequiredProperties?: boolean;
+}
+export interface SchemaDefinitionCollection {
+  generated: readonly SchemaDefinition[];
+  custom: readonly SchemaDefinition[];
+}
+export interface SchemaRegistryConflict {
+  type: string;
+  property?: string;
+  code: "duplicate-type" | "duplicate-property" | "unknown-parent" | "namespace-mismatch";
+  message: string;
+}
+export interface SchemaRegistryOptions {
+  generated?: readonly SchemaDefinition[];
+  custom?: readonly SchemaDefinition[];
+  extensions?: readonly SchemaExtension[];
+  allowGeneratedOverrides?: boolean;
+}
+export interface SchemaRegistry extends SchemaRegistryProvider {
+  getProperty(type: string, property: string): SchemaPropertyDefinition | undefined;
+  getProperties(type: string, options?: {
+    inherited?: boolean;
+  }): readonly SchemaPropertyDefinition[];
+  getAncestors(type: string): readonly SchemaDefinition[];
+  isTypeOf(type: string, expectedType: string): boolean;
+  getCollection(): SchemaDefinitionCollection;
+  getConflicts(): readonly SchemaRegistryConflict[];
+}

package/dist/schema/types.d.ts

@@ -0,0 +1,79 @@
+import { JsonObject, SeoNode, SeoNodeId } from "../core/types.js";
+export type SchemaDefinitionSource = "generated" | "custom";
+export type SchemaPropertyType = string | string[];
+export interface SchemaEnumerationValue {
+  name: string;
+  type: string;
+  description?: string;
+}
+export interface SchemaPropertyDefinition {
+  name: string;
+  type: SchemaPropertyType;
+  required?: boolean;
+  multiple?: boolean;
+  description?: string;
+  expectedTypes?: string[];
+  domainTypes?: string[];
+  rangeTypes?: string[];
+  inverseOf?: string;
+  supersededBy?: string;
+}
+export interface SchemaDefinition<T extends SeoNode = SeoNode> {
+  name: string;
+  type: string;
+  source: SchemaDefinitionSource;
+  description?: string;
+  properties?: readonly SchemaPropertyDefinition[];
+  parentTypes?: readonly string[];
+  enumerationValues?: readonly SchemaEnumerationValue[];
+  nodeType?: string;
+  namespace?: string;
+  create?: (input: JsonObject) => T;
+}
+export interface SchemaExtension {
+  type: string;
+  namespace?: string;
+  properties: readonly SchemaPropertyDefinition[];
+  description?: string;
+  parentTypes?: readonly string[];
+}
+export interface SchemaReference {
+  id: SeoNodeId | string;
+  type?: string;
+}
+export interface SchemaRegistryProvider {
+  get(type: string): SchemaDefinition | undefined;
+  has(type: string): boolean;
+  getAll(): readonly SchemaDefinition[];
+}
+export interface SchemaValidationOptions {
+  strict?: boolean;
+  allowUnknownProperties?: boolean;
+  validateRequiredProperties?: boolean;
+}
+export interface SchemaDefinitionCollection {
+  generated: readonly SchemaDefinition[];
+  custom: readonly SchemaDefinition[];
+}
+export interface SchemaRegistryConflict {
+  type: string;
+  property?: string;
+  code: "duplicate-type" | "duplicate-property" | "unknown-parent" | "namespace-mismatch";
+  message: string;
+}
+export interface SchemaRegistryOptions {
+  generated?: readonly SchemaDefinition[];
+  custom?: readonly SchemaDefinition[];
+  extensions?: readonly SchemaExtension[];
+  allowGeneratedOverrides?: boolean;
+}
+export interface SchemaRegistry extends SchemaRegistryProvider {
+  getProperty(type: string, property: string): SchemaPropertyDefinition | undefined;
+  getProperties(type: string, options?: {
+    inherited?: boolean;
+  }): readonly SchemaPropertyDefinition[];
+  getAncestors(type: string): readonly SchemaDefinition[];
+  isTypeOf(type: string, expectedType: string): boolean;
+  getCollection(): SchemaDefinitionCollection;
+  getConflicts(): readonly SchemaRegistryConflict[];
+}