@puzzle-ui/seo 0.0.0-stage → 0.5.0

package/dist/react/schema-components.js

@@ -0,0 +1,254 @@
+"use client";
+import { createSeoGraphBuilder, stringifySeoGraph } from "../core/graph.js";
+import { createDefaultSchemaRegistry } from "../schema/create-registry.js";
+import { validateSeo } from "../validation/validate.js";
+import { Fragment, createContext, createElement, useContext, useEffect } from "react";
+// src/react/schema-components.tsx
+const defaultRegistry = createDefaultSchemaRegistry();
+const SchemaContext = createContext(null);
+const useSchemaCollector = () => {
+	const collector = useContext(SchemaContext);
+	if (!collector) throw new Error("Puzzle SEO schema components must be rendered inside SeoProvider.");
+	return collector;
+};
+/**
+* Throws when a strict validation report contains errors.
+*/
+const assertSeoValidationReport = (report) => {
+	if (report.mode !== "strict" || report.valid) return;
+	const errors = report.issues.filter((issue) => issue.severity === "error");
+	const messages = errors.map((issue) => `[${issue.source}:${issue.code}] ${issue.message}`);
+	const scope = errors.length > 0 && errors.every((issue) => issue.source === "schema" || issue.source === "registry") ? "schema validation" : "validation";
+	throw new Error(`Puzzle SEO ${scope} failed:\n${messages.join("\n")}`);
+};
+const SchemaGraphOutput = ({ collector }) => {
+	const graph = collector.builder.build();
+	const graphErrors = collector.builder.getIssues().filter((issue) => issue.severity === "error");
+	const report = collector.validation !== false ? validateSeo({
+		graph,
+		metadata: collector.metadata
+	}, {
+		...collector.validation,
+		registry: collector.validation.registry ?? collector.registry,
+		baseUrl: collector.validation.baseUrl ?? collector.config.siteUrl
+	}) : void 0;
+	useEffect(() => {
+		if (report && collector.onValidation) collector.onValidation(report);
+	}, [report, collector.onValidation]);
+	if (graphErrors.length > 0) throw new Error(`Puzzle SEO graph validation failed:\n${graphErrors.map((issue) => issue.message).join("\n")}`);
+	if (report) assertSeoValidationReport(report);
+	if (graph["@graph"].length === 0) return null;
+	const json = stringifySeoGraph(graph, {
+		pretty: false,
+		safe: true,
+		scriptSafe: true,
+		validate: true
+	});
+	return createElement("script", {
+		id: collector.scriptId,
+		type: "application/ld+json",
+		nonce: collector.nonce,
+		dangerouslySetInnerHTML: { __html: json }
+	});
+};
+/**
+* Legacy options are identified by `strict`, the only property that
+* SeoValidationOptions does not share; `mode` always wins when present.
+*/
+const isLegacyValidation = (validation) => "strict" in validation && !("mode" in validation);
+const normalizeValidation = (validation) => {
+	if (validation === false) return false;
+	if (!isLegacyValidation(validation)) return validation;
+	const { strict, ...options } = validation;
+	return {
+		...options,
+		mode: strict ? "strict" : "warn"
+	};
+};
+/**
+* Central SEO provider.
+*
+* Creates an isolated graph builder for every render.
+* All descendant schema components register into this graph.
+*
+* The final JSON-LD script is rendered after the children.
+*/
+const SeoProvider = ({ config, children, scriptId = "puzzle-seo-jsonld", nonce, graphOptions, schemaRegistry, metadata, validation = {}, onValidation }) => {
+	const options = {
+		...graphOptions,
+		baseUrl: graphOptions?.baseUrl ?? config.siteUrl
+	};
+	const normalizedValidation = normalizeValidation(validation);
+	const collector = {
+		config,
+		builder: createSeoGraphBuilder(options),
+		registry: normalizedValidation !== false ? normalizedValidation.registry ?? schemaRegistry ?? defaultRegistry : schemaRegistry ?? defaultRegistry,
+		metadata,
+		validation: normalizedValidation,
+		onValidation,
+		nonce,
+		scriptId
+	};
+	return createElement(SchemaContext.Provider, { value: collector }, createElement(Fragment, null, children, createElement(SchemaGraphOutput, { collector })));
+};
+/**
+* Registers a Schema.org node.
+*
+* All properties are preserved. The graph engine is responsible
+* for normalization, references, deduplication and ID generation.
+*/
+const registerSchema = (collector, type, props) => {
+	const { id, data, ...properties } = props;
+	const node = {
+		...data,
+		...properties,
+		"@type": type
+	};
+	if (id !== void 0) node["@id"] = id;
+	collector.builder.add(node);
+	return null;
+};
+/**
+* Generic Schema.org component.
+*
+* Supports generated Schema.org definitions and custom types.
+*/
+const Schema = ({ type, id, data, properties }) => {
+	const collector = useSchemaCollector();
+	const node = {
+		...data,
+		...properties,
+		"@type": type
+	};
+	if (id !== void 0) node["@id"] = id;
+	collector.builder.add(node);
+	return null;
+};
+/**
+* Registers one or more Schema.org nodes into the central graph.
+*
+* This component never renders its own script element.
+*/
+const SeoJsonLd = ({ data, id, nonce }) => {
+	const collector = useSchemaCollector();
+	if (nonce) {
+		if (collector.nonce && collector.nonce !== nonce) throw new Error("Conflicting CSP nonces were provided to SeoProvider and SeoJsonLd.");
+		collector.nonce = nonce;
+	}
+	if (Array.isArray(data)) {
+		collector.builder.addMany(data);
+		return null;
+	}
+	const value = data;
+	if (typeof value === "object" && value !== null && "@graph" in value && Array.isArray(value["@graph"])) {
+		collector.builder.addMany(value["@graph"]);
+		return null;
+	}
+	if (typeof value !== "object" || value === null || !("@type" in value)) throw new Error("SeoJsonLd requires a Schema.org node or graph.");
+	const node = {
+		...value,
+		...id !== void 0 ? { "@id": id } : {}
+	};
+	collector.builder.add(node);
+	return null;
+};
+/**
+* Explicitly named alias for the central JSON-LD registration component.
+*
+* The script itself is still rendered once by SeoProvider.
+*/
+const SchemaScript = SeoJsonLd;
+/**
+* Registers an existing collection of nodes or a complete graph.
+*
+* This makes it possible to compose graph data from separate modules
+* without creating additional graph builders or JSON-LD scripts.
+*/
+const SchemaGraph = (props) => {
+	const collector = useSchemaCollector();
+	if (props.graph !== void 0) {
+		collector.builder.addMany(props.graph["@graph"]);
+		return null;
+	}
+	collector.builder.addMany(props.nodes);
+	return null;
+};
+/**
+* Registers an entity reference in the central graph.
+*
+* A reference without a matching node becomes a minimal Thing node.
+* When a full node with the same @id is registered elsewhere, the graph
+* engine merges the two nodes.
+*/
+const SchemaReference = ({ id, type = "Thing" }) => {
+	useSchemaCollector().builder.add({
+		"@id": id,
+		"@type": type
+	});
+	return null;
+};
+/**
+* Factory for strongly named Schema.org components.
+*
+* The component type is fixed. Properties are derived from the generated
+* Schema.org registry definitions, including inherited properties.
+*/
+const createSchemaComponent = (type) => {
+	const Component = (props) => {
+		const collector = useSchemaCollector();
+		return registerSchema(collector, type, props);
+	};
+	return Component;
+};
+const LDOrganization = createSchemaComponent("Organization");
+const LDPerson = createSchemaComponent("Person");
+const LDWebSite = createSchemaComponent("WebSite");
+/**
+* Alternative spelling for convenience.
+*/
+const LDWebsite = LDWebSite;
+const LDWebPage = createSchemaComponent("WebPage");
+const LDArticle = createSchemaComponent("Article");
+const LDBlogPosting = createSchemaComponent("BlogPosting");
+const LDBreadcrumbList = createSchemaComponent("BreadcrumbList");
+const LDBreadcrumbs = LDBreadcrumbList;
+const LDProduct = createSchemaComponent("Product");
+const LDOffer = createSchemaComponent("Offer");
+const LDAggregateRating = createSchemaComponent("AggregateRating");
+const LDReview = createSchemaComponent("Review");
+const LDLocalBusiness = createSchemaComponent("LocalBusiness");
+const LDService = createSchemaComponent("Service");
+const LDImageObject = createSchemaComponent("ImageObject");
+const LDVideoObject = createSchemaComponent("VideoObject");
+const LDEvent = createSchemaComponent("Event");
+const LDRecipe = createSchemaComponent("Recipe");
+const LDCourse = createSchemaComponent("Course");
+const LDJobPosting = createSchemaComponent("JobPosting");
+const LDPlace = createSchemaComponent("Place");
+const LDPostalAddress = createSchemaComponent("PostalAddress");
+const LDContactPoint = createSchemaComponent("ContactPoint");
+const LDSearchAction = createSchemaComponent("SearchAction");
+const LDItemList = createSchemaComponent("ItemList");
+const LDSoftwareApplication = createSchemaComponent("SoftwareApplication");
+const LDHowTo = createSchemaComponent("HowTo");
+const LDFaqPage = createSchemaComponent("FAQPage");
+const LDFAQPage = LDFaqPage;
+const LDCollectionPage = createSchemaComponent("CollectionPage");
+const LDProfilePage = createSchemaComponent("ProfilePage");
+/**
+* Exposes the current SEO configuration to descendant components.
+*
+* The returned registration method is scoped to the current provider.
+*/
+const useSeo = () => {
+	const collector = useSchemaCollector();
+	return {
+		config: collector.config,
+		registerNode: (node) => {
+			collector.builder.add(node);
+		}
+	};
+};
+export { LDAggregateRating, LDArticle, LDBlogPosting, LDBreadcrumbList, LDBreadcrumbs, LDCollectionPage, LDContactPoint, LDCourse, LDEvent, LDFAQPage, LDFaqPage, LDHowTo, LDImageObject, LDItemList, LDJobPosting, LDLocalBusiness, LDOffer, LDOrganization, LDPerson, LDPlace, LDPostalAddress, LDProduct, LDProfilePage, LDRecipe, LDReview, LDSearchAction, LDService, LDSoftwareApplication, LDVideoObject, LDWebPage, LDWebSite, LDWebsite, Schema, SchemaGraph, SchemaReference, SchemaScript, SeoJsonLd, SeoProvider, assertSeoValidationReport, normalizeValidation, useSeo };
+
+//# sourceMappingURL=schema-components.js.map

package/dist/react/schema-components.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-components.js","names":[],"sources":["../../src/react/schema-components.tsx"],"sourcesContent":["\"use client\";\n\nimport {\n  createContext,\n  createElement,\n  Fragment,\n  useContext,\n  useEffect,\n} from \"react\";\n\nimport { createSeoGraphBuilder, stringifySeoGraph } from \"../core\";\n\nimport type {\n  SeoGraph,\n  SeoNode,\n  SeoGraphBuilder,\n  SeoGraphBuilderOptions,\n} from \"../core\";\n\nimport { createDefaultSchemaRegistry } from \"../schema\";\n\nimport type { SchemaRegistry, SchemaValidationOptions } from \"../schema\";\n\nimport type { SeoConfig } from \"../context/types\";\n\nimport type {\n  SchemaComponentProps,\n  SchemaComponentType,\n  SchemaGraphProps,\n  SchemaProps,\n  SchemaReferenceProps,\n  SeoJsonLdProps,\n  SeoProviderProps,\n} from \"./types\";\nimport type { ResolvedSeoMetadata } from \"../metadata/types\";\nimport type {\n  SeoValidationOptions,\n  SeoValidationReport,\n} from \"../validation/types\";\nimport { validateSeo } from \"../validation/validate\";\n\ninterface SchemaCollector {\n  config: SeoConfig;\n  builder: SeoGraphBuilder;\n  registry: SchemaRegistry;\n  metadata?: ResolvedSeoMetadata;\n  validation: SeoValidationOptions | false;\n  onValidation?: (report: SeoValidationReport) => void;\n  nonce?: string;\n  scriptId: string;\n}\nconst defaultRegistry = createDefaultSchemaRegistry();\n\nconst SchemaContext = createContext<SchemaCollector | null>(null);\n\nconst useSchemaCollector = (): SchemaCollector => {\n  const collector = useContext(SchemaContext);\n\n  if (!collector) {\n    throw new Error(\n      \"Puzzle SEO schema components must be rendered inside SeoProvider.\",\n    );\n  }\n\n  return collector;\n};\n\n/**\n * Throws when a strict validation report contains errors.\n */\nexport const assertSeoValidationReport = (report: SeoValidationReport): void => {\n  if (report.mode !== \"strict\" || report.valid) {\n    return;\n  }\n\n  const errors = report.issues.filter((issue) => issue.severity === \"error\");\n\n  const messages = errors.map(\n    (issue) => `[${issue.source}:${issue.code}] ${issue.message}`,\n  );\n\n  // Keep the established message when only schema rules failed.\n  const scope =\n    errors.length > 0 &&\n    errors.every(\n      (issue) => issue.source === \"schema\" || issue.source === \"registry\",\n    )\n      ? \"schema validation\"\n      : \"validation\";\n\n  throw new Error(`Puzzle SEO ${scope} failed:\\n${messages.join(\"\\n\")}`);\n};\n\ninterface SchemaGraphOutputProps {\n  collector: SchemaCollector;\n}\n\nconst SchemaGraphOutput = ({ collector }: SchemaGraphOutputProps) => {\n  const graph = collector.builder.build();\n  const graphIssues = collector.builder.getIssues();\n\n  const graphErrors = graphIssues.filter((issue) => issue.severity === \"error\");\n\n  const report =\n    collector.validation !== false\n      ? validateSeo(\n          {\n            graph,\n            metadata: collector.metadata,\n          },\n          {\n            ...collector.validation,\n            registry: collector.validation.registry ?? collector.registry,\n            baseUrl: collector.validation.baseUrl ?? collector.config.siteUrl,\n          },\n        )\n      : undefined;\n\n  useEffect(() => {\n    if (report && collector.onValidation) {\n      collector.onValidation(report);\n    }\n  }, [report, collector.onValidation]);\n\n  if (graphErrors.length > 0) {\n    throw new Error(\n      `Puzzle SEO graph validation failed:\\n${graphErrors\n        .map((issue) => issue.message)\n        .join(\"\\n\")}`,\n    );\n  }\n\n  if (report) {\n    assertSeoValidationReport(report);\n  }\n\n  // Metadata-only validation is supported. An empty graph simply means\n  // that there is no JSON-LD script to render.\n  if (graph[\"@graph\"].length === 0) {\n    return null;\n  }\n\n  const json = stringifySeoGraph(graph, {\n    pretty: false,\n    safe: true,\n    scriptSafe: true,\n    validate: true,\n  });\n\n  return createElement(\"script\", {\n    id: collector.scriptId,\n    type: \"application/ld+json\",\n    nonce: collector.nonce,\n    dangerouslySetInnerHTML: {\n      __html: json,\n    },\n  });\n};\n\n/**\n * Legacy options are identified by `strict`, the only property that\n * SeoValidationOptions does not share; `mode` always wins when present.\n */\nconst isLegacyValidation = (\n  validation: SeoValidationOptions | SchemaValidationOptions,\n): validation is SchemaValidationOptions =>\n  \"strict\" in validation && !(\"mode\" in validation);\n\nexport const normalizeValidation = (\n  validation: SeoValidationOptions | SchemaValidationOptions | false,\n): SeoValidationOptions | false => {\n  if (validation === false) {\n    return false;\n  }\n\n  if (!isLegacyValidation(validation)) {\n    return validation;\n  }\n\n  const { strict, ...options } = validation;\n\n  return {\n    ...options,\n    mode: strict ? \"strict\" : \"warn\",\n  };\n};\n\n/**\n * Props for the internal schema provider. The public SeoProvider resolves\n * page metadata before passing it on, so it arrives here already resolved.\n */\nexport interface SchemaProviderProps extends Omit<\n  SeoProviderProps,\n  \"metadata\"\n> {\n  metadata?: ResolvedSeoMetadata;\n}\n\n/**\n * Central SEO provider.\n *\n * Creates an isolated graph builder for every render.\n * All descendant schema components register into this graph.\n *\n * The final JSON-LD script is rendered after the children.\n */\nexport const SeoProvider = ({\n  config,\n  children,\n  scriptId = \"puzzle-seo-jsonld\",\n  nonce,\n  graphOptions,\n  schemaRegistry,\n  metadata,\n  validation = {},\n  onValidation,\n}: SchemaProviderProps) => {\n  const options: SeoGraphBuilderOptions = {\n    ...graphOptions,\n    baseUrl: graphOptions?.baseUrl ?? config.siteUrl,\n  };\n\n  const normalizedValidation = normalizeValidation(validation);\n\n  const collector: SchemaCollector = {\n    config,\n    builder: createSeoGraphBuilder(options),\n    registry:\n      normalizedValidation !== false\n        ? (normalizedValidation.registry ?? schemaRegistry ?? defaultRegistry)\n        : (schemaRegistry ?? defaultRegistry),\n    metadata,\n    validation: normalizedValidation,\n    onValidation,\n    nonce,\n    scriptId,\n  };\n\n  return createElement(\n    SchemaContext.Provider,\n    {\n      value: collector,\n    },\n    createElement(\n      Fragment,\n      null,\n      children,\n      createElement(SchemaGraphOutput, {\n        collector,\n      }),\n    ),\n  );\n};\n\n/**\n * Registers a Schema.org node.\n *\n * All properties are preserved. The graph engine is responsible\n * for normalization, references, deduplication and ID generation.\n */\nconst registerSchema = <Type extends SchemaComponentType>(\n  collector: SchemaCollector,\n  type: Type,\n  props: SchemaComponentProps<Type>,\n): null => {\n  const { id, data, ...properties } = props;\n\n  const node: Record<string, unknown> = {\n    ...data,\n    ...properties,\n    \"@type\": type,\n  };\n\n  if (id !== undefined) {\n    node[\"@id\"] = id;\n  }\n\n  collector.builder.add(node as SeoNode);\n\n  return null;\n};\n\n/**\n * Generic Schema.org component.\n *\n * Supports generated Schema.org definitions and custom types.\n */\nexport const Schema = ({ type, id, data, properties }: SchemaProps) => {\n  const collector = useSchemaCollector();\n\n  const node: Record<string, unknown> = {\n    ...data,\n    ...properties,\n    \"@type\": type,\n  };\n\n  if (id !== undefined) {\n    node[\"@id\"] = id;\n  }\n\n  collector.builder.add(node as SeoNode);\n\n  return null;\n};\n\n/**\n * Registers one or more Schema.org nodes into the central graph.\n *\n * This component never renders its own script element.\n */\nexport const SeoJsonLd = ({ data, id, nonce }: SeoJsonLdProps) => {\n  const collector = useSchemaCollector();\n\n  if (nonce) {\n    if (collector.nonce && collector.nonce !== nonce) {\n      throw new Error(\n        \"Conflicting CSP nonces were provided to SeoProvider and SeoJsonLd.\",\n      );\n    }\n\n    collector.nonce = nonce;\n  }\n\n  if (Array.isArray(data)) {\n    collector.builder.addMany(data);\n    return null;\n  }\n\n  const value = data as SeoGraph | SeoNode;\n\n  if (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"@graph\" in value &&\n    Array.isArray(value[\"@graph\"])\n  ) {\n    collector.builder.addMany(value[\"@graph\"]);\n    return null;\n  }\n\n  if (typeof value !== \"object\" || value === null || !(\"@type\" in value)) {\n    throw new Error(\"SeoJsonLd requires a Schema.org node or graph.\");\n  }\n\n  const node: SeoNode = {\n    ...value,\n    ...(id !== undefined ? { \"@id\": id } : {}),\n  } as SeoNode;\n\n  collector.builder.add(node);\n\n  return null;\n};\n\n/**\n * Explicitly named alias for the central JSON-LD registration component.\n *\n * The script itself is still rendered once by SeoProvider.\n */\nexport const SchemaScript = SeoJsonLd;\n\n/**\n * Registers an existing collection of nodes or a complete graph.\n *\n * This makes it possible to compose graph data from separate modules\n * without creating additional graph builders or JSON-LD scripts.\n */\nexport const SchemaGraph = (props: SchemaGraphProps) => {\n  const collector = useSchemaCollector();\n\n  if (props.graph !== undefined) {\n    collector.builder.addMany(props.graph[\"@graph\"]);\n    return null;\n  }\n\n  collector.builder.addMany(props.nodes);\n\n  return null;\n};\n\n/**\n * Registers an entity reference in the central graph.\n *\n * A reference without a matching node becomes a minimal Thing node.\n * When a full node with the same @id is registered elsewhere, the graph\n * engine merges the two nodes.\n */\nexport const SchemaReference = ({\n  id,\n  type = \"Thing\",\n}: SchemaReferenceProps) => {\n  const collector = useSchemaCollector();\n\n  collector.builder.add({\n    \"@id\": id,\n    \"@type\": type,\n  });\n\n  return null;\n};\n\n/**\n * Factory for strongly named Schema.org components.\n *\n * The component type is fixed. Properties are derived from the generated\n * Schema.org registry definitions, including inherited properties.\n */\nconst createSchemaComponent = <Type extends SchemaComponentType>(\n  type: Type,\n) => {\n  const Component = (props: SchemaComponentProps<Type>): null => {\n    const collector = useSchemaCollector();\n\n    return registerSchema(collector, type, props);\n  };\n\n  return Component;\n};\n\n// ---------------------------------------------------------------------------\n// Organization / Person\n// ---------------------------------------------------------------------------\n\nexport const LDOrganization = createSchemaComponent(\"Organization\");\n\nexport const LDPerson = createSchemaComponent(\"Person\");\n\n// ---------------------------------------------------------------------------\n// WebSite / WebPage\n// ---------------------------------------------------------------------------\n\nexport const LDWebSite = createSchemaComponent(\"WebSite\");\n\n/**\n * Alternative spelling for convenience.\n */\nexport const LDWebsite = LDWebSite;\n\nexport const LDWebPage = createSchemaComponent(\"WebPage\");\n\n// ---------------------------------------------------------------------------\n// Article / BlogPosting\n// ---------------------------------------------------------------------------\n\nexport const LDArticle = createSchemaComponent(\"Article\");\n\nexport const LDBlogPosting = createSchemaComponent(\"BlogPosting\");\n\n// ---------------------------------------------------------------------------\n// BreadcrumbList\n// ---------------------------------------------------------------------------\n\nexport const LDBreadcrumbList = createSchemaComponent(\"BreadcrumbList\");\n\nexport const LDBreadcrumbs = LDBreadcrumbList;\n\n// ---------------------------------------------------------------------------\n// Product / Offer / AggregateRating / Review\n// ---------------------------------------------------------------------------\n\nexport const LDProduct = createSchemaComponent(\"Product\");\n\nexport const LDOffer = createSchemaComponent(\"Offer\");\n\nexport const LDAggregateRating = createSchemaComponent(\"AggregateRating\");\n\nexport const LDReview = createSchemaComponent(\"Review\");\n\n// ---------------------------------------------------------------------------\n// LocalBusiness / Service\n// ---------------------------------------------------------------------------\n\nexport const LDLocalBusiness = createSchemaComponent(\"LocalBusiness\");\n\nexport const LDService = createSchemaComponent(\"Service\");\n\n// ---------------------------------------------------------------------------\n// ImageObject / VideoObject / Event\n// ---------------------------------------------------------------------------\n\nexport const LDImageObject = createSchemaComponent(\"ImageObject\");\n\nexport const LDVideoObject = createSchemaComponent(\"VideoObject\");\n\nexport const LDEvent = createSchemaComponent(\"Event\");\n\n// ---------------------------------------------------------------------------\n// Additional Schema.org components\n// ---------------------------------------------------------------------------\n\nexport const LDRecipe = createSchemaComponent(\"Recipe\");\n\nexport const LDCourse = createSchemaComponent(\"Course\");\n\nexport const LDJobPosting = createSchemaComponent(\"JobPosting\");\n\nexport const LDPlace = createSchemaComponent(\"Place\");\n\nexport const LDPostalAddress = createSchemaComponent(\"PostalAddress\");\n\nexport const LDContactPoint = createSchemaComponent(\"ContactPoint\");\n\nexport const LDSearchAction = createSchemaComponent(\"SearchAction\");\n\nexport const LDItemList = createSchemaComponent(\"ItemList\");\n\nexport const LDSoftwareApplication = createSchemaComponent(\n  \"SoftwareApplication\",\n);\n\nexport const LDHowTo = createSchemaComponent(\"HowTo\");\n\nexport const LDFaqPage = createSchemaComponent(\"FAQPage\");\n\nexport const LDFAQPage = LDFaqPage;\n\nexport const LDCollectionPage = createSchemaComponent(\"CollectionPage\");\n\nexport const LDProfilePage = createSchemaComponent(\"ProfilePage\");\n\n/**\n * Exposes the current SEO configuration to descendant components.\n *\n * The returned registration method is scoped to the current provider.\n */\nexport const useSeo = () => {\n  const collector = useSchemaCollector();\n\n  return {\n    config: collector.config,\n\n    registerNode: (node: SeoNode) => {\n      collector.builder.add(node);\n    },\n  };\n};\n"],"mappings":"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"}

package/dist/react/types.d.cts

@@ -0,0 +1,81 @@
+import { SeoGraph, SeoGraphBuilderOptions, SeoNode, SeoValidationIssue } from "../core/types.cjs";
+import { SeoConfig, SeoResolvedConfig } from "../context/types.cjs";
+import { ResolvedSeoMetadata, SeoPageMetadata } from "../metadata/types.cjs";
+import { SchemaRegistry, SchemaValidationOptions } from "../schema/types.cjs";
+import { SchemaOrgPropertyNames } from "../schema/generated/schemaorg.cjs";
+import "../schema/generated/index.cjs";
+import { SeoValidationOptions, SeoValidationReport } from "../validation/types.cjs";
+import { ReactNode } from "react";
+export type SchemaComponentType = keyof SchemaOrgPropertyNames;
+export type SchemaValue = string | number | boolean | null | Date | SeoNode | {
+  "@id": string;
+} | readonly SchemaValue[] | {
+  readonly [property: string]: SchemaValue;
+};
+export type SchemaProperties<Type extends SchemaComponentType = "Thing"> = { [Property in SchemaOrgPropertyNames[Type]]?: SchemaValue; };
+export type SchemaComponentProps<Type extends SchemaComponentType = "Thing"> = SchemaProperties<Type> & {
+  id?: string;
+  data?: Readonly<Record<string, SchemaValue>>;
+};
+export interface SchemaProps {
+  type: string;
+  id?: string;
+  data?: Readonly<Record<string, SchemaValue>>;
+  properties?: Readonly<Record<string, SchemaValue>>;
+}
+export interface SchemaReferenceProps {
+  id: string;
+  type?: SchemaComponentType;
+}
+export type SchemaGraphProps = {
+  nodes: readonly SeoNode[];
+  graph?: never;
+} | {
+  graph: SeoGraph;
+  nodes?: never;
+};
+export interface SeoProviderProps {
+  config: SeoConfig;
+  children: ReactNode;
+  metadata?: SeoPageMetadata;
+  scriptId?: string;
+  nonce?: string;
+  graphOptions?: SeoGraphBuilderOptions;
+  schemaRegistry?: SchemaRegistry;
+  /**
+   * Controls validation of the complete SEO output.
+   *
+   * false disables validation.
+   *
+   * Legacy SchemaValidationOptions are still supported.
+   */
+  validation?: SeoValidationOptions | SchemaValidationOptions | false;
+  /**
+   * Receives validation diagnostics after rendering.
+   *
+   * In warn mode the JSON-LD output is still rendered.
+   * In strict mode invalid output throws before rendering.
+   */
+  onValidation?: (report: SeoValidationReport) => void;
+}
+export interface SeoContextValue {
+  config: SeoResolvedConfig;
+  metadata?: ResolvedSeoMetadata;
+  registerNode: (node: SeoNode) => void;
+}
+export interface SeoMetadataProps {
+  metadata: SeoPageMetadata;
+  children?: ReactNode;
+}
+export interface SeoJsonLdProps {
+  data: SeoNode | SeoGraph | readonly SeoNode[];
+  id?: string;
+  nonce?: string;
+}
+export interface SeoHeadProps {
+  children?: ReactNode;
+}
+export interface SeoSchemaValidationError {
+  nodeId?: string;
+  issues: readonly SeoValidationIssue[];
+}

package/dist/react/types.d.ts

@@ -0,0 +1,80 @@
+import { SeoGraph, SeoGraphBuilderOptions, SeoNode, SeoValidationIssue } from "../core/types.js";
+import { SeoConfig, SeoResolvedConfig } from "../context/types.js";
+import { ResolvedSeoMetadata, SeoPageMetadata } from "../metadata/types.js";
+import { SchemaRegistry, SchemaValidationOptions } from "../schema/types.js";
+import { SchemaOrgPropertyNames } from "../schema/generated/schemaorg.js";
+import { SeoValidationOptions, SeoValidationReport } from "../validation/types.js";
+import { ReactNode } from "react";
+export type SchemaComponentType = keyof SchemaOrgPropertyNames;
+export type SchemaValue = string | number | boolean | null | Date | SeoNode | {
+  "@id": string;
+} | readonly SchemaValue[] | {
+  readonly [property: string]: SchemaValue;
+};
+export type SchemaProperties<Type extends SchemaComponentType = "Thing"> = { [Property in SchemaOrgPropertyNames[Type]]?: SchemaValue; };
+export type SchemaComponentProps<Type extends SchemaComponentType = "Thing"> = SchemaProperties<Type> & {
+  id?: string;
+  data?: Readonly<Record<string, SchemaValue>>;
+};
+export interface SchemaProps {
+  type: string;
+  id?: string;
+  data?: Readonly<Record<string, SchemaValue>>;
+  properties?: Readonly<Record<string, SchemaValue>>;
+}
+export interface SchemaReferenceProps {
+  id: string;
+  type?: SchemaComponentType;
+}
+export type SchemaGraphProps = {
+  nodes: readonly SeoNode[];
+  graph?: never;
+} | {
+  graph: SeoGraph;
+  nodes?: never;
+};
+export interface SeoProviderProps {
+  config: SeoConfig;
+  children: ReactNode;
+  metadata?: SeoPageMetadata;
+  scriptId?: string;
+  nonce?: string;
+  graphOptions?: SeoGraphBuilderOptions;
+  schemaRegistry?: SchemaRegistry;
+  /**
+   * Controls validation of the complete SEO output.
+   *
+   * false disables validation.
+   *
+   * Legacy SchemaValidationOptions are still supported.
+   */
+  validation?: SeoValidationOptions | SchemaValidationOptions | false;
+  /**
+   * Receives validation diagnostics after rendering.
+   *
+   * In warn mode the JSON-LD output is still rendered.
+   * In strict mode invalid output throws before rendering.
+   */
+  onValidation?: (report: SeoValidationReport) => void;
+}
+export interface SeoContextValue {
+  config: SeoResolvedConfig;
+  metadata?: ResolvedSeoMetadata;
+  registerNode: (node: SeoNode) => void;
+}
+export interface SeoMetadataProps {
+  metadata: SeoPageMetadata;
+  children?: ReactNode;
+}
+export interface SeoJsonLdProps {
+  data: SeoNode | SeoGraph | readonly SeoNode[];
+  id?: string;
+  nonce?: string;
+}
+export interface SeoHeadProps {
+  children?: ReactNode;
+}
+export interface SeoSchemaValidationError {
+  nodeId?: string;
+  issues: readonly SeoValidationIssue[];
+}

package/dist/react-router/index.cjs

@@ -0,0 +1,13 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_routes = require("../server/routes.cjs");
+// src/react-router/index.ts
+const createReactRouterSeoRoutes = (options) => {
+	const handlers = require_routes.createSeoRouteHandlers(options);
+	return {
+		sitemapLoader: ({ request }) => handlers.sitemap(request),
+		robotsLoader: ({ request }) => handlers.robots(request)
+	};
+};
+exports.createReactRouterSeoRoutes = createReactRouterSeoRoutes;
+
+//# sourceMappingURL=index.cjs.map

package/dist/react-router/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["createSeoRouteHandlers"],"sources":["../../src/react-router/index.ts"],"sourcesContent":["import { createSeoRouteHandlers } from \"../server\";\n\nimport type { SeoRouteOptions } from \"../server\";\n\nexport interface ReactRouterLoaderArgs {\n  request: Request;\n  params: Record<string, string | undefined>;\n  context: unknown;\n}\n\nexport type ReactRouterSeoLoader = (\n  args: ReactRouterLoaderArgs,\n) => Promise<Response>;\n\nexport interface ReactRouterSeoRoutes {\n  /**\n   * Mount on a dynamic root resource route, e.g. /:seoFile.\n   *\n   * Handles the sitemap index and every generated sitemap file.\n   */\n  sitemapLoader: ReactRouterSeoLoader;\n\n  /**\n   * Mount on the static /robots.txt resource route.\n   */\n  robotsLoader: ReactRouterSeoLoader;\n}\n\nexport const createReactRouterSeoRoutes = (\n  options: SeoRouteOptions,\n): ReactRouterSeoRoutes => {\n  const handlers = createSeoRouteHandlers(options);\n\n  return {\n    sitemapLoader: ({ request }) => handlers.sitemap(request),\n    robotsLoader: ({ request }) => handlers.robots(request),\n  };\n};\n"],"mappings":";;;AA4BA,MAAa,8BACX,YACyB;CACzB,MAAM,WAAWA,eAAAA,uBAAuB,OAAO;CAE/C,OAAO;EACL,gBAAgB,EAAE,cAAc,SAAS,QAAQ,OAAO;EACxD,eAAe,EAAE,cAAc,SAAS,OAAO,OAAO;CACxD;AACF"}

package/dist/react-router/index.d.cts

@@ -0,0 +1,21 @@
+import { SeoRouteOptions } from "../server/types.cjs";
+import "../server/index.cjs";
+export interface ReactRouterLoaderArgs {
+  request: Request;
+  params: Record<string, string | undefined>;
+  context: unknown;
+}
+export type ReactRouterSeoLoader = (args: ReactRouterLoaderArgs) => Promise<Response>;
+export interface ReactRouterSeoRoutes {
+  /**
+   * Mount on a dynamic root resource route, e.g. /:seoFile.
+   *
+   * Handles the sitemap index and every generated sitemap file.
+   */
+  sitemapLoader: ReactRouterSeoLoader;
+  /**
+   * Mount on the static /robots.txt resource route.
+   */
+  robotsLoader: ReactRouterSeoLoader;
+}
+export declare const createReactRouterSeoRoutes: (options: SeoRouteOptions) => ReactRouterSeoRoutes;

package/dist/react-router/index.d.ts

@@ -0,0 +1,20 @@
+import { SeoRouteOptions } from "../server/types.js";
+export interface ReactRouterLoaderArgs {
+  request: Request;
+  params: Record<string, string | undefined>;
+  context: unknown;
+}
+export type ReactRouterSeoLoader = (args: ReactRouterLoaderArgs) => Promise<Response>;
+export interface ReactRouterSeoRoutes {
+  /**
+   * Mount on a dynamic root resource route, e.g. /:seoFile.
+   *
+   * Handles the sitemap index and every generated sitemap file.
+   */
+  sitemapLoader: ReactRouterSeoLoader;
+  /**
+   * Mount on the static /robots.txt resource route.
+   */
+  robotsLoader: ReactRouterSeoLoader;
+}
+export declare const createReactRouterSeoRoutes: (options: SeoRouteOptions) => ReactRouterSeoRoutes;

package/dist/react-router/index.js

@@ -0,0 +1,12 @@
+import { createSeoRouteHandlers } from "../server/routes.js";
+// src/react-router/index.ts
+const createReactRouterSeoRoutes = (options) => {
+	const handlers = createSeoRouteHandlers(options);
+	return {
+		sitemapLoader: ({ request }) => handlers.sitemap(request),
+		robotsLoader: ({ request }) => handlers.robots(request)
+	};
+};
+export { createReactRouterSeoRoutes };
+
+//# sourceMappingURL=index.js.map

package/dist/react-router/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/react-router/index.ts"],"sourcesContent":["import { createSeoRouteHandlers } from \"../server\";\n\nimport type { SeoRouteOptions } from \"../server\";\n\nexport interface ReactRouterLoaderArgs {\n  request: Request;\n  params: Record<string, string | undefined>;\n  context: unknown;\n}\n\nexport type ReactRouterSeoLoader = (\n  args: ReactRouterLoaderArgs,\n) => Promise<Response>;\n\nexport interface ReactRouterSeoRoutes {\n  /**\n   * Mount on a dynamic root resource route, e.g. /:seoFile.\n   *\n   * Handles the sitemap index and every generated sitemap file.\n   */\n  sitemapLoader: ReactRouterSeoLoader;\n\n  /**\n   * Mount on the static /robots.txt resource route.\n   */\n  robotsLoader: ReactRouterSeoLoader;\n}\n\nexport const createReactRouterSeoRoutes = (\n  options: SeoRouteOptions,\n): ReactRouterSeoRoutes => {\n  const handlers = createSeoRouteHandlers(options);\n\n  return {\n    sitemapLoader: ({ request }) => handlers.sitemap(request),\n    robotsLoader: ({ request }) => handlers.robots(request),\n  };\n};\n"],"mappings":";;AA4BA,MAAa,8BACX,YACyB;CACzB,MAAM,WAAW,uBAAuB,OAAO;CAE/C,OAAO;EACL,gBAAgB,EAAE,cAAc,SAAS,QAAQ,OAAO;EACxD,eAAe,EAAE,cAAc,SAAS,OAAO,OAAO;CACxD;AACF"}

package/dist/robots/generate.cjs

@@ -0,0 +1,88 @@
+const require_normalize = require("../urls/normalize.cjs");
+// src/robots/generate.ts
+const validateRule = (rule, index) => {
+	const issues = [];
+	const agents = Array.isArray(rule.userAgent) ? rule.userAgent : [rule.userAgent];
+	if (agents.length === 0 || agents.some((agent) => !agent.trim() || /[\r\n]/.test(agent))) issues.push({
+		code: "INVALID_USER_AGENT",
+		message: "Every robots rule requires a non-empty user-agent without newlines.",
+		path: `rules.${index}.userAgent`
+	});
+	if (rule.crawlDelay !== void 0 && (!Number.isFinite(rule.crawlDelay) || rule.crawlDelay < 0)) issues.push({
+		code: "INVALID_CRAWL_DELAY",
+		message: "Crawl-delay must be a non-negative number.",
+		path: `rules.${index}.crawlDelay`
+	});
+	for (const [name, paths] of [["allow", rule.allow], ["disallow", rule.disallow]]) {
+		if (!paths) continue;
+		for (const path of paths) if (!path.startsWith("/") || /[\r\n]/.test(path)) issues.push({
+			code: "INVALID_ROBOTS_PATH",
+			message: `${name} paths must start with / and contain no newlines.`,
+			path: `rules.${index}.${name}`
+		});
+	}
+	return issues;
+};
+const validateRobotsOptions = (options) => {
+	const issues = [];
+	if (!options.rules.length) issues.push({
+		code: "MISSING_RULES",
+		message: "At least one robots rule is required."
+	});
+	options.rules.forEach((rule, index) => {
+		issues.push(...validateRule(rule, index));
+	});
+	for (const sitemap of Array.isArray(options.sitemap) ? options.sitemap : options.sitemap ? [options.sitemap] : []) try {
+		require_normalize.normalizeSeoUrl(sitemap);
+	} catch {
+		issues.push({
+			code: "INVALID_SITEMAP_URL",
+			message: `Invalid sitemap URL: ${sitemap}.`
+		});
+	}
+	if (options.host && /[\r\n]/.test(options.host)) issues.push({
+		code: "INVALID_HOST",
+		message: "Robots host must not contain newlines."
+	});
+	return issues;
+};
+const serializeRule = (rule) => {
+	const lines = (Array.isArray(rule.userAgent) ? rule.userAgent : [rule.userAgent]).map((agent) => `User-agent: ${agent.trim()}`);
+	for (const path of rule.allow ?? []) lines.push(`Allow: ${path}`);
+	for (const path of rule.disallow ?? []) lines.push(`Disallow: ${path}`);
+	if (rule.crawlDelay !== void 0) lines.push(`Crawl-delay: ${rule.crawlDelay}`);
+	return lines;
+};
+const serializeRobotsTxt = (options) => {
+	const issues = validateRobotsOptions(options);
+	if (issues.length > 0) throw new Error(`Invalid robots configuration: ${issues.map((issue) => issue.message).join(" ")}`);
+	const groups = options.rules.map(serializeRule);
+	const lines = [];
+	groups.forEach((group, index) => {
+		if (index > 0) lines.push("");
+		lines.push(...group);
+	});
+	const sitemaps = [...new Set((Array.isArray(options.sitemap) ? options.sitemap : options.sitemap ? [options.sitemap] : []).map((url) => require_normalize.normalizeSeoUrl(url)))].sort();
+	if (sitemaps.length > 0) {
+		lines.push("");
+		for (const sitemap of sitemaps) lines.push(`Sitemap: ${sitemap}`);
+	}
+	if (options.host) lines.push(`Host: ${options.host}`);
+	return `${lines.join("\n")}\n`;
+};
+const generateRobotsTxt = (options) => {
+	const issues = validateRobotsOptions(options);
+	if (issues.length > 0) return {
+		content: "",
+		issues
+	};
+	return {
+		content: serializeRobotsTxt(options),
+		issues: []
+	};
+};
+exports.generateRobotsTxt = generateRobotsTxt;
+exports.serializeRobotsTxt = serializeRobotsTxt;
+exports.validateRobotsOptions = validateRobotsOptions;
+
+//# sourceMappingURL=generate.cjs.map

package/dist/robots/generate.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.cjs","names":["normalizeSeoUrl"],"sources":["../../src/robots/generate.ts"],"sourcesContent":["import { normalizeSeoUrl } from \"../urls\";\n\nimport type {\n  RobotsOptions,\n  RobotsRule,\n  RobotsResult,\n  RobotsValidationIssue,\n} from \"./types\";\n\nconst validateRule = (\n  rule: RobotsRule,\n  index: number,\n): RobotsValidationIssue[] => {\n  const issues: RobotsValidationIssue[] = [];\n\n  const agents = Array.isArray(rule.userAgent)\n    ? rule.userAgent\n    : [rule.userAgent];\n\n  if (\n    agents.length === 0 ||\n    agents.some((agent) => !agent.trim() || /[\\r\\n]/.test(agent))\n  ) {\n    issues.push({\n      code: \"INVALID_USER_AGENT\",\n      message:\n        \"Every robots rule requires a non-empty user-agent without newlines.\",\n      path: `rules.${index}.userAgent`,\n    });\n  }\n\n  if (\n    rule.crawlDelay !== undefined &&\n    (!Number.isFinite(rule.crawlDelay) || rule.crawlDelay < 0)\n  ) {\n    issues.push({\n      code: \"INVALID_CRAWL_DELAY\",\n      message: \"Crawl-delay must be a non-negative number.\",\n      path: `rules.${index}.crawlDelay`,\n    });\n  }\n\n  for (const [name, paths] of [\n    [\"allow\", rule.allow],\n    [\"disallow\", rule.disallow],\n  ] as const) {\n    if (!paths) {\n      continue;\n    }\n\n    for (const path of paths) {\n      if (!path.startsWith(\"/\") || /[\\r\\n]/.test(path)) {\n        issues.push({\n          code: \"INVALID_ROBOTS_PATH\",\n          message: `${name} paths must start with / and contain no newlines.`,\n          path: `rules.${index}.${name}`,\n        });\n      }\n    }\n  }\n\n  return issues;\n};\n\nexport const validateRobotsOptions = (\n  options: RobotsOptions,\n): RobotsValidationIssue[] => {\n  const issues: RobotsValidationIssue[] = [];\n\n  if (!options.rules.length) {\n    issues.push({\n      code: \"MISSING_RULES\",\n      message: \"At least one robots rule is required.\",\n    });\n  }\n\n  options.rules.forEach((rule, index) => {\n    issues.push(...validateRule(rule, index));\n  });\n\n  for (const sitemap of Array.isArray(options.sitemap)\n    ? options.sitemap\n    : options.sitemap\n      ? [options.sitemap]\n      : []) {\n    try {\n      normalizeSeoUrl(sitemap);\n    } catch {\n      issues.push({\n        code: \"INVALID_SITEMAP_URL\",\n        message: `Invalid sitemap URL: ${sitemap}.`,\n      });\n    }\n  }\n\n  if (options.host && /[\\r\\n]/.test(options.host)) {\n    issues.push({\n      code: \"INVALID_HOST\",\n      message: \"Robots host must not contain newlines.\",\n    });\n  }\n\n  return issues;\n};\n\nconst serializeRule = (rule: RobotsRule): string[] => {\n  const agents = Array.isArray(rule.userAgent)\n    ? rule.userAgent\n    : [rule.userAgent];\n\n  const lines = agents.map((agent) => `User-agent: ${agent.trim()}`);\n\n  for (const path of rule.allow ?? []) {\n    lines.push(`Allow: ${path}`);\n  }\n\n  for (const path of rule.disallow ?? []) {\n    lines.push(`Disallow: ${path}`);\n  }\n\n  if (rule.crawlDelay !== undefined) {\n    lines.push(`Crawl-delay: ${rule.crawlDelay}`);\n  }\n\n  return lines;\n};\n\nexport const serializeRobotsTxt = (options: RobotsOptions): string => {\n  const issues = validateRobotsOptions(options);\n\n  if (issues.length > 0) {\n    throw new Error(\n      `Invalid robots configuration: ${issues\n        .map((issue) => issue.message)\n        .join(\" \")}`,\n    );\n  }\n\n  const groups = options.rules.map(serializeRule);\n\n  const lines: string[] = [];\n\n  groups.forEach((group, index) => {\n    if (index > 0) {\n      lines.push(\"\");\n    }\n\n    lines.push(...group);\n  });\n\n  const sitemaps = [\n    ...new Set(\n      (Array.isArray(options.sitemap)\n        ? options.sitemap\n        : options.sitemap\n          ? [options.sitemap]\n          : []\n      ).map((url) => normalizeSeoUrl(url)),\n    ),\n  ].sort();\n\n  if (sitemaps.length > 0) {\n    lines.push(\"\");\n\n    for (const sitemap of sitemaps) {\n      lines.push(`Sitemap: ${sitemap}`);\n    }\n  }\n\n  if (options.host) {\n    lines.push(`Host: ${options.host}`);\n  }\n\n  return `${lines.join(\"\\n\")}\\n`;\n};\n\nexport const generateRobotsTxt = (options: RobotsOptions): RobotsResult => {\n  const issues = validateRobotsOptions(options);\n\n  if (issues.length > 0) {\n    return {\n      content: \"\",\n      issues,\n    };\n  }\n\n  return {\n    content: serializeRobotsTxt(options),\n    issues: [],\n  };\n};\n"],"mappings":"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"}

package/dist/robots/generate.d.cts

@@ -0,0 +1,4 @@
+import { RobotsOptions, RobotsResult, RobotsValidationIssue } from "./types.cjs";
+export declare const validateRobotsOptions: (options: RobotsOptions) => RobotsValidationIssue[];
+export declare const serializeRobotsTxt: (options: RobotsOptions) => string;
+export declare const generateRobotsTxt: (options: RobotsOptions) => RobotsResult;

package/dist/robots/generate.d.ts

@@ -0,0 +1,4 @@
+import { RobotsOptions, RobotsResult, RobotsValidationIssue } from "./types.js";
+export declare const validateRobotsOptions: (options: RobotsOptions) => RobotsValidationIssue[];
+export declare const serializeRobotsTxt: (options: RobotsOptions) => string;
+export declare const generateRobotsTxt: (options: RobotsOptions) => RobotsResult;