@puzzle-ui/seo 0.0.0-stage → 0.5.0

package/dist/core/types.d.ts

@@ -0,0 +1,92 @@
+export type Brand<T, Name extends string> = T & {
+  readonly __brand: Name;
+};
+export type SeoUrl = Brand<string, "SeoUrl">;
+export type SeoNodeId = Brand<string, "SeoNodeId">;
+export type SeoLocale = Brand<string, "SeoLocale">;
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+export type JsonObject = {
+  [key: string]: JsonValue;
+};
+export type SeoNodeType = string | string[];
+export interface SeoNode {
+  "@id"?: SeoNodeId | string;
+  "@type": SeoNodeType;
+  "@context"?: string | Record<string, JsonValue>;
+  [key: string]: unknown;
+}
+export interface SeoGraph {
+  "@context"?: string | Record<string, JsonValue>;
+  "@graph": SeoNode[];
+}
+export interface SeoGraphOptions {
+  baseUrl?: string;
+  locale?: SeoLocale | string;
+  context?: string | Record<string, JsonValue>;
+  rootIds?: string[];
+}
+export interface SeoNodeReference {
+  "@id": SeoNodeId | string;
+}
+export interface SeoMetadata {
+  title?: string;
+  description?: string;
+  canonical?: SeoUrl | string;
+  robots?: string;
+}
+export type SeoValidationSeverity = "error" | "warning" | "info";
+export interface SeoValidationIssue {
+  code: string;
+  message: string;
+  severity: SeoValidationSeverity;
+  path?: string;
+  nodeId?: string;
+  property?: string;
+}
+export interface SeoValidationResult {
+  valid: boolean;
+  issues: SeoValidationIssue[];
+}
+export interface SeoSerializationOptions {
+  pretty?: boolean;
+  safe?: boolean;
+  scriptSafe?: boolean;
+}
+export interface SeoSerializationResult {
+  value: string;
+  errors: SeoValidationIssue[];
+}
+export interface SeoReference {
+  id: SeoNodeId | string;
+}
+export interface SeoGraphRoot {
+  id: SeoNodeId | string;
+  primary?: boolean;
+}
+export type SeoGraphConflictStrategy = "deterministic" | "first" | "last" | "error";
+export interface SeoNodeOptions extends SeoGraphOptions {
+  id?: string;
+  type?: string;
+}
+export interface SeoGraphBuilderOptions extends SeoGraphOptions {
+  conflictStrategy?: SeoGraphConflictStrategy;
+  strictReferences?: boolean;
+}
+export interface SeoGraphBuilder {
+  add(node: SeoNode): this;
+  addMany(nodes: readonly SeoNode[]): this;
+  build(): SeoGraph;
+  getIssues(): readonly SeoValidationIssue[];
+}
+export interface SeoGraphValidationOptions {
+  baseUrl?: string;
+  strictReferences?: boolean;
+  allowedExternalReferences?: boolean;
+}
+export interface SeoGraphSerializationOptions extends SeoSerializationOptions {
+  includeContext?: boolean;
+  validate?: boolean;
+}

package/dist/index.cjs

@@ -0,0 +1,96 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_normalize = require("./urls/normalize.cjs");
+const require_context = require("./react/context.cjs");
+const require_graph = require("./core/graph.cjs");
+const require_validate = require("./validation/validate.cjs");
+const require_schema_components = require("./react/schema-components.cjs");
+const require_provider = require("./react/provider.cjs");
+const require_metadata = require("./react/metadata.cjs");
+const require_inspect = require("./testing/inspect.cjs");
+const require_diagnostics = require("./testing/diagnostics.cjs");
+const require_fixture = require("./testing/fixture.cjs");
+const require_xml = require("./sitemap/xml.cjs");
+const require_generate = require("./sitemap/generate.cjs");
+const require_generate$1 = require("./robots/generate.cjs");
+// src/index.ts
+const SchemaReference = require_schema_components.SchemaReference;
+const SeoMetadata = require_metadata.SeoMetadata;
+exports.LDAggregateRating = require_schema_components.LDAggregateRating;
+exports.LDArticle = require_schema_components.LDArticle;
+exports.LDBlogPosting = require_schema_components.LDBlogPosting;
+exports.LDBreadcrumbList = require_schema_components.LDBreadcrumbList;
+exports.LDBreadcrumbs = require_schema_components.LDBreadcrumbs;
+exports.LDCollectionPage = require_schema_components.LDCollectionPage;
+exports.LDContactPoint = require_schema_components.LDContactPoint;
+exports.LDCourse = require_schema_components.LDCourse;
+exports.LDEvent = require_schema_components.LDEvent;
+exports.LDFAQPage = require_schema_components.LDFAQPage;
+exports.LDFaqPage = require_schema_components.LDFaqPage;
+exports.LDHowTo = require_schema_components.LDHowTo;
+exports.LDImageObject = require_schema_components.LDImageObject;
+exports.LDItemList = require_schema_components.LDItemList;
+exports.LDJobPosting = require_schema_components.LDJobPosting;
+exports.LDLocalBusiness = require_schema_components.LDLocalBusiness;
+exports.LDOffer = require_schema_components.LDOffer;
+exports.LDOrganization = require_schema_components.LDOrganization;
+exports.LDPerson = require_schema_components.LDPerson;
+exports.LDPlace = require_schema_components.LDPlace;
+exports.LDPostalAddress = require_schema_components.LDPostalAddress;
+exports.LDProduct = require_schema_components.LDProduct;
+exports.LDProfilePage = require_schema_components.LDProfilePage;
+exports.LDRecipe = require_schema_components.LDRecipe;
+exports.LDReview = require_schema_components.LDReview;
+exports.LDSearchAction = require_schema_components.LDSearchAction;
+exports.LDService = require_schema_components.LDService;
+exports.LDSoftwareApplication = require_schema_components.LDSoftwareApplication;
+exports.LDVideoObject = require_schema_components.LDVideoObject;
+exports.LDWebPage = require_schema_components.LDWebPage;
+exports.LDWebSite = require_schema_components.LDWebSite;
+exports.LDWebsite = require_schema_components.LDWebsite;
+exports.Schema = require_schema_components.Schema;
+exports.SchemaGraph = require_schema_components.SchemaGraph;
+exports.SchemaReference = SchemaReference;
+exports.SchemaScript = require_schema_components.SchemaScript;
+exports.SeoHead = require_metadata.SeoHead;
+exports.SeoJsonLd = require_schema_components.SeoJsonLd;
+exports.SeoMetadata = SeoMetadata;
+exports.SeoProvider = require_provider.SeoProvider;
+exports.assertSeoTest = require_fixture.assertSeoTest;
+exports.buildSeoGraph = require_graph.buildSeoGraph;
+exports.createSeoGraphBuilder = require_graph.createSeoGraphBuilder;
+exports.createSeoNode = require_graph.createSeoNode;
+exports.createSeoTestFixture = require_fixture.createSeoTestFixture;
+exports.createSitemapXml = require_xml.createSitemapXml;
+exports.escapeXml = require_xml.escapeXml;
+exports.formatSeoDiagnostics = require_diagnostics.formatSeoDiagnostics;
+exports.formatSitemapDate = require_xml.formatSitemapDate;
+exports.generateRobotsTxt = require_generate$1.generateRobotsTxt;
+exports.generateSitemap = require_generate.generateSitemap;
+exports.inspectSeoGraph = require_inspect.inspectSeoGraph;
+exports.isSameSeoOrigin = require_normalize.isSameSeoOrigin;
+exports.isValidSeoUrl = require_normalize.isValidSeoUrl;
+exports.mergeSeoNodes = require_graph.mergeSeoNodes;
+exports.normalizeSeoId = require_graph.normalizeSeoId;
+exports.normalizeSeoOrigin = require_normalize.normalizeSeoOrigin;
+exports.normalizeSeoPath = require_normalize.normalizeSeoPath;
+exports.normalizeSeoUrl = require_normalize.normalizeSeoUrl;
+exports.resolveSeoReferences = require_graph.resolveSeoReferences;
+exports.resolveSeoUrls = require_normalize.resolveSeoUrls;
+exports.runSeoTest = require_fixture.runSeoTest;
+exports.serializeRobotsTxt = require_generate$1.serializeRobotsTxt;
+exports.serializeSeoGraph = require_graph.serializeSeoGraph;
+exports.serializeSitemap = require_generate.serializeSitemap;
+exports.serializeSitemapEntry = require_xml.serializeSitemapEntry;
+exports.sitemapByteLength = require_xml.sitemapByteLength;
+exports.stringifySeoGraph = require_graph.stringifySeoGraph;
+exports.useSeo = require_schema_components.useSeo;
+exports.useSeoConfig = require_context.useSeoConfig;
+exports.useSeoMetadata = require_context.useSeoMetadata;
+exports.validateRobotsOptions = require_generate$1.validateRobotsOptions;
+exports.validateSeo = require_validate.validateSeo;
+exports.validateSeoGraph = require_graph.validateSeoGraph;
+exports.validateSeoMetadata = require_validate.validateSeoMetadata;
+exports.validateSeoNode = require_validate.validateSeoNode;
+exports.validateSitemapEntries = require_xml.validateSitemapEntries;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","names":["SchemaReferenceComponent","SeoMetadataComponent"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  SchemaReference as SchemaReferenceComponent,\n  SeoMetadata as SeoMetadataComponent,\n} from \"./react\";\n\nimport type { SeoMetadata as SeoMetadataData } from \"./core\";\n\nimport type { SchemaReference as SchemaReferenceData } from \"./schema\";\n\nexport const SchemaReference = SchemaReferenceComponent;\nexport type SchemaReference = SchemaReferenceData;\n\nexport const SeoMetadata = SeoMetadataComponent;\nexport type SeoMetadata = SeoMetadataData;\n\nexport type { SeoValidationIssue } from \"./core\";\nexport type { SeoValidationIssue as SeoValidationReportIssue } from \"./validation\";\n\nexport * from \"./core\";\n\nexport type * from \"./context\";\nexport type * from \"./schema\";\nexport type * from \"./metadata\";\n\nexport * from \"./validation\";\nexport * from \"./react\";\n\nexport type * from \"./server\";\nexport type * from \"./sitemap\";\nexport type * from \"./robots\";\nexport type * from \"./urls\";\nexport * from \"./testing\";\n\nexport * from \"./sitemap\";\nexport * from \"./robots\";\nexport * from \"./urls\";\n"],"mappings":";;;;;;;;;;;;;;;AASA,MAAa,kBAAkBA,0BAAAA;AAG/B,MAAa,cAAcC,iBAAAA"}

package/dist/index.d.cts

@@ -0,0 +1,48 @@
+import { Brand, JsonObject, JsonPrimitive, JsonValue, SeoGraph, SeoGraphBuilder, SeoGraphBuilderOptions, SeoGraphConflictStrategy, SeoGraphOptions, SeoGraphRoot, SeoGraphSerializationOptions, SeoGraphValidationOptions, SeoLocale, SeoMetadata as SeoMetadata$1, SeoNode, SeoNodeId, SeoNodeOptions, SeoNodeReference, SeoNodeType, SeoReference, SeoSerializationOptions, SeoSerializationResult, SeoUrl, SeoValidationIssue, SeoValidationResult, SeoValidationSeverity } from "./core/types.cjs";
+import { SeoConfig, SeoConfigContext, SeoConfigOverride, SeoDefaultMetadata, SeoResolvedConfig, SeoSiteIdentity, SeoTitleConfig, SeoTrailingSlash } from "./context/types.cjs";
+import { ResolvedSeoMetadata, SeoAlternateLanguage, SeoCanonicalMetadata, SeoDescriptionMetadata, SeoHreflangMetadata, SeoOpenGraphMetadata, SeoPageMetadata, SeoRobotsMetadata, SeoSocialImage, SeoTitleMetadata, SeoTwitterMetadata } from "./metadata/types.cjs";
+import { SchemaDefinition, SchemaDefinitionCollection, SchemaDefinitionSource, SchemaEnumerationValue, SchemaExtension, SchemaPropertyDefinition, SchemaPropertyType, SchemaReference as SchemaReference$1, SchemaRegistry, SchemaRegistryConflict, SchemaRegistryOptions, SchemaRegistryProvider, SchemaValidationOptions } from "./schema/types.cjs";
+import { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, generatedSchemaDefinitions } from "./schema/generated/schemaorg.cjs";
+import { SeoCustomValidator, SeoRichResultProfile, SeoValidationContext, SeoValidationInput, SeoValidationIssue as SeoValidationIssue$1, SeoValidationMode, SeoValidationOptions, SeoValidationReport, SeoValidationSource, SeoValidationSummary } from "./validation/types.cjs";
+import { SchemaComponentProps, SchemaComponentType, SchemaGraphProps, SchemaProperties, SchemaProps, SchemaReferenceProps, SchemaValue, SeoContextValue, SeoHeadProps, SeoJsonLdProps, SeoMetadataProps, SeoProviderProps, SeoSchemaValidationError } from "./react/types.cjs";
+import { useSeoConfig, useSeoMetadata } from "./react/context.cjs";
+import { SeoProvider } from "./react/provider.cjs";
+import { SeoHead, SeoMetadata as SeoMetadata$2 } from "./react/metadata.cjs";
+import { buildSeoGraph, createSeoGraphBuilder, createSeoNode, mergeSeoNodes, normalizeSeoId, resolveSeoReferences, serializeSeoGraph, stringifySeoGraph, validateSeoGraph } from "./core/graph.cjs";
+import "./react/index.cjs";
+import { createSchemaRegistry } from "./schema/registry.cjs";
+import { createDefaultSchemaRegistry } from "./schema/create-registry.cjs";
+import { validateSchemaNode } from "./schema/validate.cjs";
+import "./core/index.cjs";
+import { 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 as SchemaReference$2, SchemaScript, SeoJsonLd, useSeo } from "./react/schema-components.cjs";
+import "./schema/index.cjs";
+import { validateSeo, validateSeoMetadata, validateSeoNode } from "./validation/validate.cjs";
+import "./validation/index.cjs";
+import { isSameSeoOrigin, isValidSeoUrl, normalizeSeoOrigin, normalizeSeoPath, normalizeSeoUrl, resolveSeoUrls } from "./urls/normalize.cjs";
+import { normalizeSeoConfig, resolveSeoUrl } from "./context/config.cjs";
+import "./context/index.cjs";
+import { resolveSeoMetadata, resolveSeoRobots } from "./metadata/resolve.cjs";
+import "./metadata/index.cjs";
+import { RobotsDirective, RobotsOptions, RobotsPolicy, RobotsResult, RobotsRule, RobotsValidationIssue } from "./robots/types.cjs";
+import { SitemapAlternate, SitemapCollection, SitemapEntry, SitemapFile, SitemapGenerationOptions, SitemapImage, SitemapOptions, SitemapResult, SitemapValidationIssue, SitemapVideo } from "./sitemap/types.cjs";
+import { SeoHttpHandler, SeoRequestContext, SeoRobotsHandlerOptions, SeoRouteHandlers, SeoRouteOptions, SeoServerAdapter, SeoServerResult, SeoSitemapHandlerOptions, SeoTextHandler, SeoTextHandlerOptions, SeoTextResponse } from "./server/types.cjs";
+import { createRobotsHandler, createSitemapHandler } from "./server/handlers.cjs";
+import { createSeoRouteHandlers } from "./server/routes.cjs";
+import "./server/index.cjs";
+import { createSitemapXml, escapeXml, formatSitemapDate, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries } from "./sitemap/xml.cjs";
+import { generateSitemap, serializeSitemap } from "./sitemap/generate.cjs";
+import "./sitemap/index.cjs";
+import { generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions } from "./robots/generate.cjs";
+import "./robots/index.cjs";
+import { SeoOriginOptions, SeoUrlOptions, SeoUrlResult, SeoUrlValidationIssue } from "./urls/types.cjs";
+import "./urls/index.cjs";
+import { SeoDiagnosticFormatOptions, SeoGraphInspection, SeoGraphNodeInspection, SeoTestFixture, SeoTestOptions, SeoTestResult } from "./testing/types.cjs";
+import { inspectSeoGraph } from "./testing/inspect.cjs";
+import { formatSeoDiagnostics } from "./testing/diagnostics.cjs";
+import { assertSeoTest, createSeoTestFixture, runSeoTest } from "./testing/fixture.cjs";
+import "./testing/index.cjs";
+export declare const SchemaReference: typeof SchemaReference$2;
+export type SchemaReference = SchemaReference$1;
+export declare const SeoMetadata: typeof SeoMetadata$2;
+export type SeoMetadata = SeoMetadata$1;
+export { type Brand, type JsonObject, type JsonPrimitive, type JsonValue, 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, type ResolvedSeoMetadata, type RobotsDirective, type RobotsOptions, type RobotsPolicy, type RobotsResult, type RobotsRule, type RobotsValidationIssue, type SCHEMAORG_SOURCE_HASH, type SCHEMAORG_VERSION, Schema, type SchemaComponentProps, type SchemaComponentType, type SchemaDefinition, type SchemaDefinitionCollection, type SchemaDefinitionSource, type SchemaEnumerationValue, type SchemaExtension, SchemaGraph, type SchemaGraphProps, type SchemaProperties, type SchemaPropertyDefinition, type SchemaPropertyType, type SchemaProps, type SchemaReferenceProps, type SchemaRegistry, type SchemaRegistryConflict, type SchemaRegistryOptions, type SchemaRegistryProvider, SchemaScript, type SchemaValidationOptions, type SchemaValue, type SeoAlternateLanguage, type SeoCanonicalMetadata, type SeoConfig, type SeoConfigContext, type SeoConfigOverride, type SeoContextValue, type SeoCustomValidator, type SeoDefaultMetadata, type SeoDescriptionMetadata, type SeoDiagnosticFormatOptions, type SeoGraph, type SeoGraphBuilder, type SeoGraphBuilderOptions, type SeoGraphConflictStrategy, type SeoGraphInspection, type SeoGraphNodeInspection, type SeoGraphOptions, type SeoGraphRoot, type SeoGraphSerializationOptions, type SeoGraphValidationOptions, SeoHead, type SeoHeadProps, type SeoHreflangMetadata, type SeoHttpHandler, SeoJsonLd, type SeoJsonLdProps, type SeoLocale, type SeoMetadataProps, type SeoNode, type SeoNodeId, type SeoNodeOptions, type SeoNodeReference, type SeoNodeType, type SeoOpenGraphMetadata, type SeoOriginOptions, type SeoPageMetadata, SeoProvider, type SeoProviderProps, type SeoReference, type SeoRequestContext, type SeoResolvedConfig, type SeoRichResultProfile, type SeoRobotsHandlerOptions, type SeoRobotsMetadata, type SeoRouteHandlers, type SeoRouteOptions, type SeoSchemaValidationError, type SeoSerializationOptions, type SeoSerializationResult, type SeoServerAdapter, type SeoServerResult, type SeoSiteIdentity, type SeoSitemapHandlerOptions, type SeoSocialImage, type SeoTestFixture, type SeoTestOptions, type SeoTestResult, type SeoTextHandler, type SeoTextHandlerOptions, type SeoTextResponse, type SeoTitleConfig, type SeoTitleMetadata, type SeoTrailingSlash, type SeoTwitterMetadata, type SeoUrl, type SeoUrlOptions, type SeoUrlResult, type SeoUrlValidationIssue, type SeoValidationContext, type SeoValidationInput, type SeoValidationIssue, type SeoValidationMode, type SeoValidationOptions, type SeoValidationReport, type SeoValidationIssue$1 as SeoValidationReportIssue, type SeoValidationResult, type SeoValidationSeverity, type SeoValidationSource, type SeoValidationSummary, type SitemapAlternate, type SitemapCollection, type SitemapEntry, type SitemapFile, type SitemapGenerationOptions, type SitemapImage, type SitemapOptions, type SitemapResult, type SitemapValidationIssue, type SitemapVideo, assertSeoTest, buildSeoGraph, type createDefaultSchemaRegistry, type createRobotsHandler, type createSchemaRegistry, createSeoGraphBuilder, createSeoNode, type createSeoRouteHandlers, createSeoTestFixture, type createSitemapHandler, createSitemapXml, escapeXml, formatSeoDiagnostics, formatSitemapDate, generateRobotsTxt, generateSitemap, type generatedSchemaDefinitions, inspectSeoGraph, isSameSeoOrigin, isValidSeoUrl, mergeSeoNodes, type normalizeSeoConfig, normalizeSeoId, normalizeSeoOrigin, normalizeSeoPath, normalizeSeoUrl, type resolveSeoMetadata, resolveSeoReferences, type resolveSeoRobots, type resolveSeoUrl, resolveSeoUrls, runSeoTest, serializeRobotsTxt, serializeSeoGraph, serializeSitemap, serializeSitemapEntry, sitemapByteLength, stringifySeoGraph, useSeo, useSeoConfig, useSeoMetadata, validateRobotsOptions, type validateSchemaNode, validateSeo, validateSeoGraph, validateSeoMetadata, validateSeoNode, validateSitemapEntries };

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import "./react/index.js";
+import { SeoConfig, SeoConfigContext, SeoConfigOverride, SeoDefaultMetadata, SeoResolvedConfig, SeoSiteIdentity, SeoTitleConfig, SeoTrailingSlash } from "./context/types.js";
+import { isSameSeoOrigin, isValidSeoUrl, normalizeSeoOrigin, normalizeSeoPath, normalizeSeoUrl, resolveSeoUrls } from "./urls/normalize.js";
+import { normalizeSeoConfig, resolveSeoUrl } from "./context/config.js";
+import { buildSeoGraph, createSeoGraphBuilder, createSeoNode, mergeSeoNodes, normalizeSeoId, resolveSeoReferences, serializeSeoGraph, stringifySeoGraph, validateSeoGraph } from "./core/graph.js";
+import { ResolvedSeoMetadata, SeoAlternateLanguage, SeoCanonicalMetadata, SeoDescriptionMetadata, SeoHreflangMetadata, SeoOpenGraphMetadata, SeoPageMetadata, SeoRobotsMetadata, SeoSocialImage, SeoTitleMetadata, SeoTwitterMetadata } from "./metadata/types.js";
+import { Brand, JsonObject, JsonPrimitive, JsonValue, SeoGraph, SeoGraphBuilder, SeoGraphBuilderOptions, SeoGraphConflictStrategy, SeoGraphOptions, SeoGraphRoot, SeoGraphSerializationOptions, SeoGraphValidationOptions, SeoLocale, SeoMetadata as SeoMetadata$1, SeoNode, SeoNodeId, SeoNodeOptions, SeoNodeReference, SeoNodeType, SeoReference, SeoSerializationOptions, SeoSerializationResult, SeoUrl, SeoValidationIssue, SeoValidationResult, SeoValidationSeverity } from "./core/types.js";
+import { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, generatedSchemaDefinitions } from "./schema/generated/schemaorg.js";
+import { SchemaDefinition, SchemaDefinitionCollection, SchemaDefinitionSource, SchemaEnumerationValue, SchemaExtension, SchemaPropertyDefinition, SchemaPropertyType, SchemaReference as SchemaReference$1, SchemaRegistry, SchemaRegistryConflict, SchemaRegistryOptions, SchemaRegistryProvider, SchemaValidationOptions } from "./schema/types.js";
+import { SchemaComponentProps, SchemaComponentType, SchemaGraphProps, SchemaProperties, SchemaProps, SchemaReferenceProps, SchemaValue, SeoContextValue, SeoHeadProps, SeoJsonLdProps, SeoMetadataProps, SeoProviderProps, SeoSchemaValidationError } from "./react/types.js";
+import { useSeoConfig, useSeoMetadata } from "./react/context.js";
+import { SeoProvider } from "./react/provider.js";
+import { SeoHead, SeoMetadata as SeoMetadata$2 } from "./react/metadata.js";
+import { createSchemaRegistry } from "./schema/registry.js";
+import { createDefaultSchemaRegistry } from "./schema/create-registry.js";
+import { validateSchemaNode } from "./schema/validate.js";
+import { 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 as SchemaReference$2, SchemaScript, SeoJsonLd, useSeo } from "./react/schema-components.js";
+import { SeoCustomValidator, SeoRichResultProfile, SeoValidationContext, SeoValidationInput, SeoValidationIssue as SeoValidationIssue$1, SeoValidationMode, SeoValidationOptions, SeoValidationReport, SeoValidationSource, SeoValidationSummary } from "./validation/types.js";
+import { validateSeo, validateSeoMetadata, validateSeoNode } from "./validation/validate.js";
+import { resolveSeoMetadata, resolveSeoRobots } from "./metadata/resolve.js";
+import { RobotsDirective, RobotsOptions, RobotsPolicy, RobotsResult, RobotsRule, RobotsValidationIssue } from "./robots/types.js";
+import { SitemapAlternate, SitemapCollection, SitemapEntry, SitemapFile, SitemapGenerationOptions, SitemapImage, SitemapOptions, SitemapResult, SitemapValidationIssue, SitemapVideo } from "./sitemap/types.js";
+import { SeoHttpHandler, SeoRequestContext, SeoRobotsHandlerOptions, SeoRouteHandlers, SeoRouteOptions, SeoServerAdapter, SeoServerResult, SeoSitemapHandlerOptions, SeoTextHandler, SeoTextHandlerOptions, SeoTextResponse } from "./server/types.js";
+import { createRobotsHandler, createSitemapHandler } from "./server/handlers.js";
+import { createSeoRouteHandlers } from "./server/routes.js";
+import { createSitemapXml, escapeXml, formatSitemapDate, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries } from "./sitemap/xml.js";
+import { generateSitemap, serializeSitemap } from "./sitemap/generate.js";
+import { generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions } from "./robots/generate.js";
+import { SeoOriginOptions, SeoUrlOptions, SeoUrlResult, SeoUrlValidationIssue } from "./urls/types.js";
+import { SeoDiagnosticFormatOptions, SeoGraphInspection, SeoGraphNodeInspection, SeoTestFixture, SeoTestOptions, SeoTestResult } from "./testing/types.js";
+import { inspectSeoGraph } from "./testing/inspect.js";
+import { formatSeoDiagnostics } from "./testing/diagnostics.js";
+import { assertSeoTest, createSeoTestFixture, runSeoTest } from "./testing/fixture.js";
+export declare const SchemaReference: typeof SchemaReference$2;
+export type SchemaReference = SchemaReference$1;
+export declare const SeoMetadata: typeof SeoMetadata$2;
+export type SeoMetadata = SeoMetadata$1;
+export { type Brand, type JsonObject, type JsonPrimitive, type JsonValue, 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, type ResolvedSeoMetadata, type RobotsDirective, type RobotsOptions, type RobotsPolicy, type RobotsResult, type RobotsRule, type RobotsValidationIssue, type SCHEMAORG_SOURCE_HASH, type SCHEMAORG_VERSION, Schema, type SchemaComponentProps, type SchemaComponentType, type SchemaDefinition, type SchemaDefinitionCollection, type SchemaDefinitionSource, type SchemaEnumerationValue, type SchemaExtension, SchemaGraph, type SchemaGraphProps, type SchemaProperties, type SchemaPropertyDefinition, type SchemaPropertyType, type SchemaProps, type SchemaReferenceProps, type SchemaRegistry, type SchemaRegistryConflict, type SchemaRegistryOptions, type SchemaRegistryProvider, SchemaScript, type SchemaValidationOptions, type SchemaValue, type SeoAlternateLanguage, type SeoCanonicalMetadata, type SeoConfig, type SeoConfigContext, type SeoConfigOverride, type SeoContextValue, type SeoCustomValidator, type SeoDefaultMetadata, type SeoDescriptionMetadata, type SeoDiagnosticFormatOptions, type SeoGraph, type SeoGraphBuilder, type SeoGraphBuilderOptions, type SeoGraphConflictStrategy, type SeoGraphInspection, type SeoGraphNodeInspection, type SeoGraphOptions, type SeoGraphRoot, type SeoGraphSerializationOptions, type SeoGraphValidationOptions, SeoHead, type SeoHeadProps, type SeoHreflangMetadata, type SeoHttpHandler, SeoJsonLd, type SeoJsonLdProps, type SeoLocale, type SeoMetadataProps, type SeoNode, type SeoNodeId, type SeoNodeOptions, type SeoNodeReference, type SeoNodeType, type SeoOpenGraphMetadata, type SeoOriginOptions, type SeoPageMetadata, SeoProvider, type SeoProviderProps, type SeoReference, type SeoRequestContext, type SeoResolvedConfig, type SeoRichResultProfile, type SeoRobotsHandlerOptions, type SeoRobotsMetadata, type SeoRouteHandlers, type SeoRouteOptions, type SeoSchemaValidationError, type SeoSerializationOptions, type SeoSerializationResult, type SeoServerAdapter, type SeoServerResult, type SeoSiteIdentity, type SeoSitemapHandlerOptions, type SeoSocialImage, type SeoTestFixture, type SeoTestOptions, type SeoTestResult, type SeoTextHandler, type SeoTextHandlerOptions, type SeoTextResponse, type SeoTitleConfig, type SeoTitleMetadata, type SeoTrailingSlash, type SeoTwitterMetadata, type SeoUrl, type SeoUrlOptions, type SeoUrlResult, type SeoUrlValidationIssue, type SeoValidationContext, type SeoValidationInput, type SeoValidationIssue, type SeoValidationMode, type SeoValidationOptions, type SeoValidationReport, type SeoValidationIssue$1 as SeoValidationReportIssue, type SeoValidationResult, type SeoValidationSeverity, type SeoValidationSource, type SeoValidationSummary, type SitemapAlternate, type SitemapCollection, type SitemapEntry, type SitemapFile, type SitemapGenerationOptions, type SitemapImage, type SitemapOptions, type SitemapResult, type SitemapValidationIssue, type SitemapVideo, assertSeoTest, buildSeoGraph, type createDefaultSchemaRegistry, type createRobotsHandler, type createSchemaRegistry, createSeoGraphBuilder, createSeoNode, type createSeoRouteHandlers, createSeoTestFixture, type createSitemapHandler, createSitemapXml, escapeXml, formatSeoDiagnostics, formatSitemapDate, generateRobotsTxt, generateSitemap, type generatedSchemaDefinitions, inspectSeoGraph, isSameSeoOrigin, isValidSeoUrl, mergeSeoNodes, type normalizeSeoConfig, normalizeSeoId, normalizeSeoOrigin, normalizeSeoPath, normalizeSeoUrl, type resolveSeoMetadata, resolveSeoReferences, type resolveSeoRobots, type resolveSeoUrl, resolveSeoUrls, runSeoTest, serializeRobotsTxt, serializeSeoGraph, serializeSitemap, serializeSitemapEntry, sitemapByteLength, stringifySeoGraph, useSeo, useSeoConfig, useSeoMetadata, validateRobotsOptions, type validateSchemaNode, validateSeo, validateSeoGraph, validateSeoMetadata, validateSeoNode, validateSitemapEntries };

package/dist/index.js

@@ -0,0 +1,19 @@
+import { isSameSeoOrigin, isValidSeoUrl, normalizeSeoOrigin, normalizeSeoPath, normalizeSeoUrl, resolveSeoUrls } from "./urls/normalize.js";
+import { useSeoConfig, useSeoMetadata } from "./react/context.js";
+import { buildSeoGraph, createSeoGraphBuilder, createSeoNode, mergeSeoNodes, normalizeSeoId, resolveSeoReferences, serializeSeoGraph, stringifySeoGraph, validateSeoGraph } from "./core/graph.js";
+import { validateSeo, validateSeoMetadata, validateSeoNode } from "./validation/validate.js";
+import { 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 as SchemaReference$1, SchemaScript, SeoJsonLd, useSeo } from "./react/schema-components.js";
+import { SeoProvider } from "./react/provider.js";
+import { SeoHead, SeoMetadata as SeoMetadata$1 } from "./react/metadata.js";
+import { inspectSeoGraph } from "./testing/inspect.js";
+import { formatSeoDiagnostics } from "./testing/diagnostics.js";
+import { assertSeoTest, createSeoTestFixture, runSeoTest } from "./testing/fixture.js";
+import { createSitemapXml, escapeXml, formatSitemapDate, serializeSitemapEntry, sitemapByteLength, validateSitemapEntries } from "./sitemap/xml.js";
+import { generateSitemap, serializeSitemap } from "./sitemap/generate.js";
+import { generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions } from "./robots/generate.js";
+// src/index.ts
+const SchemaReference = SchemaReference$1;
+const SeoMetadata = SeoMetadata$1;
+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, SeoHead, SeoJsonLd, SeoMetadata, SeoProvider, assertSeoTest, buildSeoGraph, createSeoGraphBuilder, createSeoNode, createSeoTestFixture, createSitemapXml, escapeXml, formatSeoDiagnostics, formatSitemapDate, generateRobotsTxt, generateSitemap, inspectSeoGraph, isSameSeoOrigin, isValidSeoUrl, mergeSeoNodes, normalizeSeoId, normalizeSeoOrigin, normalizeSeoPath, normalizeSeoUrl, resolveSeoReferences, resolveSeoUrls, runSeoTest, serializeRobotsTxt, serializeSeoGraph, serializeSitemap, serializeSitemapEntry, sitemapByteLength, stringifySeoGraph, useSeo, useSeoConfig, useSeoMetadata, validateRobotsOptions, validateSeo, validateSeoGraph, validateSeoMetadata, validateSeoNode, validateSitemapEntries };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["SchemaReferenceComponent","SeoMetadataComponent"],"sources":["../src/index.ts"],"sourcesContent":["import {\n  SchemaReference as SchemaReferenceComponent,\n  SeoMetadata as SeoMetadataComponent,\n} from \"./react\";\n\nimport type { SeoMetadata as SeoMetadataData } from \"./core\";\n\nimport type { SchemaReference as SchemaReferenceData } from \"./schema\";\n\nexport const SchemaReference = SchemaReferenceComponent;\nexport type SchemaReference = SchemaReferenceData;\n\nexport const SeoMetadata = SeoMetadataComponent;\nexport type SeoMetadata = SeoMetadataData;\n\nexport type { SeoValidationIssue } from \"./core\";\nexport type { SeoValidationIssue as SeoValidationReportIssue } from \"./validation\";\n\nexport * from \"./core\";\n\nexport type * from \"./context\";\nexport type * from \"./schema\";\nexport type * from \"./metadata\";\n\nexport * from \"./validation\";\nexport * from \"./react\";\n\nexport type * from \"./server\";\nexport type * from \"./sitemap\";\nexport type * from \"./robots\";\nexport type * from \"./urls\";\nexport * from \"./testing\";\n\nexport * from \"./sitemap\";\nexport * from \"./robots\";\nexport * from \"./urls\";\n"],"mappings":";;;;;;;;;;;;;;AASA,MAAa,kBAAkBA;AAG/B,MAAa,cAAcC"}

package/dist/metadata/index.cjs

@@ -0,0 +1,4 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_resolve = require("./resolve.cjs");
+exports.resolveSeoMetadata = require_resolve.resolveSeoMetadata;
+exports.resolveSeoRobots = require_resolve.resolveSeoRobots;

package/dist/metadata/index.d.cts

@@ -0,0 +1,3 @@
+import { ResolvedSeoMetadata, SeoAlternateLanguage, SeoCanonicalMetadata, SeoDescriptionMetadata, SeoHreflangMetadata, SeoOpenGraphMetadata, SeoPageMetadata, SeoRobotsMetadata, SeoSocialImage, SeoTitleMetadata, SeoTwitterMetadata } from "./types.cjs";
+import { resolveSeoMetadata, resolveSeoRobots } from "./resolve.cjs";
+export { type ResolvedSeoMetadata, type SeoAlternateLanguage, type SeoCanonicalMetadata, type SeoDescriptionMetadata, type SeoHreflangMetadata, type SeoOpenGraphMetadata, type SeoPageMetadata, type SeoRobotsMetadata, type SeoSocialImage, type SeoTitleMetadata, type SeoTwitterMetadata, resolveSeoMetadata, resolveSeoRobots };

package/dist/metadata/index.d.ts

@@ -0,0 +1,3 @@
+import { ResolvedSeoMetadata, SeoAlternateLanguage, SeoCanonicalMetadata, SeoDescriptionMetadata, SeoHreflangMetadata, SeoOpenGraphMetadata, SeoPageMetadata, SeoRobotsMetadata, SeoSocialImage, SeoTitleMetadata, SeoTwitterMetadata } from "./types.js";
+import { resolveSeoMetadata, resolveSeoRobots } from "./resolve.js";
+export { type ResolvedSeoMetadata, type SeoAlternateLanguage, type SeoCanonicalMetadata, type SeoDescriptionMetadata, type SeoHreflangMetadata, type SeoOpenGraphMetadata, type SeoPageMetadata, type SeoRobotsMetadata, type SeoSocialImage, type SeoTitleMetadata, type SeoTwitterMetadata, resolveSeoMetadata, resolveSeoRobots };

package/dist/metadata/index.js

@@ -0,0 +1 @@
+export { resolveSeoMetadata, resolveSeoRobots } from "./resolve.js";

package/dist/metadata/resolve.cjs

@@ -0,0 +1,122 @@
+const require_config = require("../context/config.cjs");
+// src/metadata/resolve.ts
+const normalizeLocale = (locale) => {
+	try {
+		const normalized = Intl.getCanonicalLocales(locale)[0];
+		if (!normalized) throw new Error();
+		return normalized;
+	} catch {
+		throw new Error(`Invalid SEO page locale: "${locale}".`);
+	}
+};
+const isSupportedLocale = (locale, config) => config.supportedLocales.includes(locale) || config.supportedLocales.includes(locale.split("-")[0]);
+const resolvePageLocale = (locale, config) => {
+	const resolved = normalizeLocale(locale ?? config.defaultLocale);
+	if (!isSupportedLocale(resolved, config)) throw new Error(`Unsupported SEO page locale "${resolved}". Supported locales: ${config.supportedLocales.join(", ")}.`);
+	return resolved;
+};
+const resolveSafeUrl = (value, config) => {
+	const resolved = require_config.resolveSeoUrl(value, config);
+	const url = new URL(resolved);
+	if (url.username || url.password) throw new Error(`SEO URLs must not contain credentials: "${value}".`);
+	return resolved;
+};
+const resolveTitle = (pageTitle, config) => {
+	const fallback = config.metadata?.title ?? config.defaults?.title ?? config.title?.default ?? config.identity?.name ?? "";
+	const title = pageTitle ?? fallback;
+	if (!title) return "";
+	if (!pageTitle || !config.title?.template) return title;
+	return config.title.template.replace("%s", pageTitle);
+};
+const resolveDescription = (pageDescription, config) => pageDescription ?? config.metadata?.description ?? config.defaults?.description ?? config.identity?.description;
+const resolveSocialImage = (image, config) => {
+	if (image.width !== void 0 && (!Number.isInteger(image.width) || image.width <= 0)) throw new Error("SEO social image width must be a positive integer.");
+	if (image.height !== void 0 && (!Number.isInteger(image.height) || image.height <= 0)) throw new Error("SEO social image height must be a positive integer.");
+	return {
+		...image,
+		url: resolveSafeUrl(image.url, config)
+	};
+};
+const resolveAlternates = (alternates, config) => {
+	if (!alternates?.length) return;
+	const seenLocales = /* @__PURE__ */ new Set();
+	return alternates.map((alternate) => {
+		const locale = alternate.locale === "x-default" ? "x-default" : normalizeLocale(alternate.locale);
+		if (locale !== "x-default" && !isSupportedLocale(locale, config)) throw new Error(`Unsupported hreflang locale "${locale}". Supported locales: ${config.supportedLocales.join(", ")}.`);
+		if (seenLocales.has(locale)) throw new Error(`Duplicate hreflang locale "${locale}".`);
+		seenLocales.add(locale);
+		return {
+			locale,
+			url: resolveSafeUrl(alternate.url, config)
+		};
+	});
+};
+const resolveSeoMetadata = (metadata = {}, config) => {
+	const locale = resolvePageLocale(metadata.locale, config);
+	const title = resolveTitle(metadata.title, config);
+	const description = resolveDescription(metadata.description, config);
+	const canonicalValue = metadata.canonical ?? config.metadata?.canonical ?? config.defaults?.canonical;
+	const canonical = canonicalValue ? resolveSafeUrl(canonicalValue, config) : void 0;
+	const alternates = resolveAlternates(metadata.alternates?.alternates, config);
+	const openGraphImages = metadata.openGraph?.images?.map((image) => resolveSocialImage(image, config));
+	const openGraph = {
+		...metadata.openGraph,
+		title: metadata.openGraph?.title ?? title,
+		description: metadata.openGraph?.description ?? description,
+		type: metadata.openGraph?.type ?? "website",
+		url: metadata.openGraph?.url ? resolveSafeUrl(metadata.openGraph.url, config) : canonical ?? resolveSafeUrl(config.siteUrl, config),
+		siteName: metadata.openGraph?.siteName ?? config.identity?.name,
+		locale: metadata.openGraph?.locale ?? locale.replace("-", "_"),
+		images: openGraphImages
+	};
+	const twitterImages = metadata.twitter?.images ? metadata.twitter.images.map((image) => resolveSafeUrl(image, config)) : openGraphImages?.map((image) => image.url);
+	const twitter = {
+		...metadata.twitter,
+		card: metadata.twitter?.card ?? "summary_large_image",
+		title: metadata.twitter?.title ?? title,
+		description: metadata.twitter?.description ?? description,
+		images: twitterImages,
+		imageAlt: metadata.twitter?.imageAlt ?? openGraphImages?.[0]?.alt
+	};
+	return {
+		...metadata,
+		title,
+		description,
+		canonical,
+		locale,
+		alternates: alternates ? { alternates } : void 0,
+		openGraph,
+		twitter
+	};
+};
+const validatePreviewValue = (name, value) => {
+	if (!Number.isInteger(value) || value < -1) throw new Error(`SEO robots ${name} must be an integer greater than or equal to -1.`);
+};
+const resolveRobotsDirectives = (robots) => {
+	const directives = [robots.index === false ? "noindex" : "index", robots.follow === false ? "nofollow" : "follow"];
+	if (robots.noarchive) directives.push("noarchive");
+	if (robots.nosnippet) directives.push("nosnippet");
+	if (robots.maxSnippet !== void 0) {
+		validatePreviewValue("maxSnippet", robots.maxSnippet);
+		directives.push(`max-snippet:${robots.maxSnippet}`);
+	}
+	if (robots.maxImagePreview !== void 0 && ![
+		"none",
+		"standard",
+		"large"
+	].includes(robots.maxImagePreview)) throw new Error(`Invalid SEO robots maxImagePreview: "${robots.maxImagePreview}".`);
+	if (robots.maxImagePreview) directives.push(`max-image-preview:${robots.maxImagePreview}`);
+	if (robots.maxVideoPreview !== void 0) {
+		validatePreviewValue("maxVideoPreview", robots.maxVideoPreview);
+		directives.push(`max-video-preview:${robots.maxVideoPreview}`);
+	}
+	return directives.join(", ");
+};
+const resolveSeoRobots = (metadata, config) => {
+	if (metadata.robots) return resolveRobotsDirectives(metadata.robots);
+	return config.metadata?.robots ?? config.defaults?.robots;
+};
+exports.resolveSeoMetadata = resolveSeoMetadata;
+exports.resolveSeoRobots = resolveSeoRobots;
+
+//# sourceMappingURL=resolve.cjs.map

package/dist/metadata/resolve.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.cjs","names":["resolveSeoUrl"],"sources":["../../src/metadata/resolve.ts"],"sourcesContent":["import type { SeoLocale, SeoUrl } from \"../core/types\";\n\nimport { resolveSeoUrl } from \"../context/config\";\n\nimport type { SeoResolvedConfig } from \"../context/types\";\n\nimport type {\n  ResolvedSeoMetadata,\n  SeoAlternateLanguage,\n  SeoPageMetadata,\n  SeoRobotsMetadata,\n  SeoSocialImage,\n} from \"./types\";\n\n// ---------------------------------------------------------------------------\n// Locale\n// ---------------------------------------------------------------------------\n\nconst normalizeLocale = (locale: string): SeoLocale => {\n  try {\n    const normalized = Intl.getCanonicalLocales(locale)[0];\n\n    if (!normalized) {\n      throw new Error();\n    }\n\n    return normalized as SeoLocale;\n  } catch {\n    throw new Error(`Invalid SEO page locale: \"${locale}\".`);\n  }\n};\n\n// A regional variant (nl-NL) is supported when its base language (nl) is.\nconst isSupportedLocale = (\n  locale: SeoLocale,\n  config: SeoResolvedConfig,\n): boolean =>\n  config.supportedLocales.includes(locale) ||\n  config.supportedLocales.includes(locale.split(\"-\")[0] as SeoLocale);\n\nconst resolvePageLocale = (\n  locale: string | undefined,\n  config: SeoResolvedConfig,\n): SeoLocale => {\n  const resolved = normalizeLocale(locale ?? config.defaultLocale);\n\n  if (!isSupportedLocale(resolved, config)) {\n    throw new Error(\n      `Unsupported SEO page locale \"${resolved}\". ` +\n        `Supported locales: ${config.supportedLocales.join(\", \")}.`,\n    );\n  }\n\n  return resolved;\n};\n\n// ---------------------------------------------------------------------------\n// URL\n// ---------------------------------------------------------------------------\n\nconst resolveSafeUrl = (value: string, config: SeoResolvedConfig): SeoUrl => {\n  const resolved = resolveSeoUrl(value, config);\n\n  const url = new URL(resolved);\n\n  if (url.username || url.password) {\n    throw new Error(`SEO URLs must not contain credentials: \"${value}\".`);\n  }\n\n  return resolved;\n};\n\n// ---------------------------------------------------------------------------\n// Title\n// ---------------------------------------------------------------------------\n\nconst resolveTitle = (\n  pageTitle: string | undefined,\n  config: SeoResolvedConfig,\n): string => {\n  const fallback =\n    config.metadata?.title ??\n    config.defaults?.title ??\n    config.title?.default ??\n    config.identity?.name ??\n    \"\";\n\n  const title = pageTitle ?? fallback;\n\n  if (!title) {\n    return \"\";\n  }\n\n  if (!pageTitle || !config.title?.template) {\n    return title;\n  }\n\n  return config.title.template.replace(\"%s\", pageTitle);\n};\n\n// ---------------------------------------------------------------------------\n// Description\n// ---------------------------------------------------------------------------\n\nconst resolveDescription = (\n  pageDescription: string | undefined,\n  config: SeoResolvedConfig,\n): string | undefined =>\n  pageDescription ??\n  config.metadata?.description ??\n  config.defaults?.description ??\n  config.identity?.description;\n\n// ---------------------------------------------------------------------------\n// Social images\n// ---------------------------------------------------------------------------\n\nconst resolveSocialImage = (\n  image: SeoSocialImage,\n  config: SeoResolvedConfig,\n): SeoSocialImage => {\n  if (\n    image.width !== undefined &&\n    (!Number.isInteger(image.width) || image.width <= 0)\n  ) {\n    throw new Error(\"SEO social image width must be a positive integer.\");\n  }\n\n  if (\n    image.height !== undefined &&\n    (!Number.isInteger(image.height) || image.height <= 0)\n  ) {\n    throw new Error(\"SEO social image height must be a positive integer.\");\n  }\n\n  return {\n    ...image,\n    url: resolveSafeUrl(image.url, config),\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Hreflang\n// ---------------------------------------------------------------------------\n\nconst resolveAlternates = (\n  alternates: SeoAlternateLanguage[] | undefined,\n  config: SeoResolvedConfig,\n): SeoAlternateLanguage[] | undefined => {\n  if (!alternates?.length) {\n    return undefined;\n  }\n\n  const seenLocales = new Set<string>();\n\n  return alternates.map((alternate) => {\n    const locale =\n      alternate.locale === \"x-default\"\n        ? \"x-default\"\n        : normalizeLocale(alternate.locale);\n\n    if (\n      locale !== \"x-default\" &&\n      !isSupportedLocale(locale as SeoLocale, config)\n    ) {\n      throw new Error(\n        `Unsupported hreflang locale \"${locale}\". ` +\n          `Supported locales: ${config.supportedLocales.join(\", \")}.`,\n      );\n    }\n\n    if (seenLocales.has(locale)) {\n      throw new Error(`Duplicate hreflang locale \"${locale}\".`);\n    }\n\n    seenLocales.add(locale);\n\n    return {\n      locale,\n      url: resolveSafeUrl(alternate.url, config),\n    };\n  });\n};\n\n// ---------------------------------------------------------------------------\n// Metadata\n// ---------------------------------------------------------------------------\n\nexport const resolveSeoMetadata = (\n  metadata: SeoPageMetadata = {},\n  config: SeoResolvedConfig,\n): ResolvedSeoMetadata => {\n  const locale = resolvePageLocale(metadata.locale, config);\n\n  const title = resolveTitle(metadata.title, config);\n\n  const description = resolveDescription(metadata.description, config);\n\n  const canonicalValue =\n    metadata.canonical ??\n    config.metadata?.canonical ??\n    config.defaults?.canonical;\n\n  const canonical = canonicalValue\n    ? resolveSafeUrl(canonicalValue, config)\n    : undefined;\n\n  const alternates = resolveAlternates(metadata.alternates?.alternates, config);\n\n  const openGraphImages = metadata.openGraph?.images?.map((image) =>\n    resolveSocialImage(image, config),\n  );\n\n  const openGraph = {\n    ...metadata.openGraph,\n\n    title: metadata.openGraph?.title ?? title,\n\n    description: metadata.openGraph?.description ?? description,\n\n    type: metadata.openGraph?.type ?? \"website\",\n\n    // og:url is required by Open Graph; fall back to the site root when no page URL is known.\n    url: metadata.openGraph?.url\n      ? resolveSafeUrl(metadata.openGraph.url, config)\n      : (canonical ?? resolveSafeUrl(config.siteUrl, config)),\n\n    siteName: metadata.openGraph?.siteName ?? config.identity?.name,\n\n    locale: metadata.openGraph?.locale ?? locale.replace(\"-\", \"_\"),\n\n    images: openGraphImages,\n  };\n\n  const twitterImages = metadata.twitter?.images\n    ? metadata.twitter.images.map((image) => resolveSafeUrl(image, config))\n    : openGraphImages?.map((image) => image.url);\n\n  const twitter = {\n    ...metadata.twitter,\n\n    card: metadata.twitter?.card ?? (\"summary_large_image\" as const),\n\n    title: metadata.twitter?.title ?? title,\n\n    description: metadata.twitter?.description ?? description,\n\n    images: twitterImages,\n\n    imageAlt: metadata.twitter?.imageAlt ?? openGraphImages?.[0]?.alt,\n  };\n\n  return {\n    ...metadata,\n\n    title,\n    description,\n    canonical,\n    locale,\n\n    alternates: alternates ? { alternates } : undefined,\n\n    openGraph,\n    twitter,\n  };\n};\n\n// ---------------------------------------------------------------------------\n// Robots\n// ---------------------------------------------------------------------------\n\nconst validatePreviewValue = (name: string, value: number): void => {\n  if (!Number.isInteger(value) || value < -1) {\n    throw new Error(\n      `SEO robots ${name} must be an integer greater than or equal to -1.`,\n    );\n  }\n};\n\nconst resolveRobotsDirectives = (robots: SeoRobotsMetadata): string => {\n  const directives = [\n    robots.index === false ? \"noindex\" : \"index\",\n    robots.follow === false ? \"nofollow\" : \"follow\",\n  ];\n\n  if (robots.noarchive) {\n    directives.push(\"noarchive\");\n  }\n\n  if (robots.nosnippet) {\n    directives.push(\"nosnippet\");\n  }\n\n  if (robots.maxSnippet !== undefined) {\n    validatePreviewValue(\"maxSnippet\", robots.maxSnippet);\n\n    directives.push(`max-snippet:${robots.maxSnippet}`);\n  }\n\n  if (\n    robots.maxImagePreview !== undefined &&\n    ![\"none\", \"standard\", \"large\"].includes(robots.maxImagePreview)\n  ) {\n    throw new Error(\n      `Invalid SEO robots maxImagePreview: \"${robots.maxImagePreview}\".`,\n    );\n  }\n\n  if (robots.maxImagePreview) {\n    directives.push(`max-image-preview:${robots.maxImagePreview}`);\n  }\n\n  if (robots.maxVideoPreview !== undefined) {\n    validatePreviewValue(\"maxVideoPreview\", robots.maxVideoPreview);\n\n    directives.push(`max-video-preview:${robots.maxVideoPreview}`);\n  }\n\n  return directives.join(\", \");\n};\n\nexport const resolveSeoRobots = (\n  metadata: SeoPageMetadata,\n  config: SeoResolvedConfig,\n): string | undefined => {\n  if (metadata.robots) {\n    return resolveRobotsDirectives(metadata.robots);\n  }\n\n  return config.metadata?.robots ?? config.defaults?.robots;\n};\n"],"mappings":"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"}

package/dist/metadata/resolve.d.cts

@@ -0,0 +1,4 @@
+import { SeoResolvedConfig } from "../context/types.cjs";
+import { ResolvedSeoMetadata, SeoPageMetadata } from "./types.cjs";
+export declare const resolveSeoMetadata: (metadata: SeoPageMetadata | undefined, config: SeoResolvedConfig) => ResolvedSeoMetadata;
+export declare const resolveSeoRobots: (metadata: SeoPageMetadata, config: SeoResolvedConfig) => string | undefined;

package/dist/metadata/resolve.d.ts

@@ -0,0 +1,4 @@
+import { SeoResolvedConfig } from "../context/types.js";
+import { ResolvedSeoMetadata, SeoPageMetadata } from "./types.js";
+export declare const resolveSeoMetadata: (metadata: SeoPageMetadata | undefined, config: SeoResolvedConfig) => ResolvedSeoMetadata;
+export declare const resolveSeoRobots: (metadata: SeoPageMetadata, config: SeoResolvedConfig) => string | undefined;