@puzzle-ui/seo 0.0.0-stage → 0.5.0

package/dist/urls/normalize.cjs

@@ -0,0 +1,65 @@
+// src/urls/normalize.ts
+const normalizeSeoPath = (pathname, trailingSlash = "never") => {
+	const path = pathname.startsWith("/") ? pathname : `/${pathname}`;
+	if (path === "/") return "/";
+	if (trailingSlash === "always") return `${path.replace(/\/+$/, "")}/`;
+	if (trailingSlash === "never") return path.replace(/\/+$/, "");
+	return path;
+};
+const normalizeSeoUrl = (value, options = {}) => {
+	if (typeof value !== "string" || !value.trim()) throw new Error("SEO URL must be a non-empty string.");
+	const baseUrl = options.baseUrl ?? "https://example.com";
+	let url;
+	let base;
+	try {
+		base = new URL(baseUrl);
+		url = new URL(value, base);
+	} catch {
+		throw new Error(`Invalid SEO URL: "${value}".`);
+	}
+	if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error("SEO URLs must use HTTP or HTTPS.");
+	if (url.username || url.password) {
+		if (!options.allowCredentials) throw new Error("SEO URLs must not contain credentials.");
+	}
+	if (options.allowExternal === false && url.origin !== base.origin) throw new Error("External SEO URLs are not allowed.");
+	url.pathname = normalizeSeoPath(url.pathname, options.trailingSlash ?? "never");
+	return url.toString();
+};
+const normalizeSeoOrigin = (value) => {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		throw new Error(`Invalid SEO origin: "${value}".`);
+	}
+	if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error("SEO origins must use HTTP or HTTPS.");
+	if (url.username || url.password) throw new Error("SEO origins must not contain credentials.");
+	return url.origin;
+};
+const isSameSeoOrigin = (first, second) => {
+	try {
+		return new URL(first).origin === new URL(second).origin;
+	} catch {
+		return false;
+	}
+};
+const isValidSeoUrl = (value, baseUrl) => {
+	try {
+		normalizeSeoUrl(value, { baseUrl });
+		return true;
+	} catch {
+		return false;
+	}
+};
+const resolveSeoUrls = (values, options = {}) => {
+	const resolved = values.map((value) => normalizeSeoUrl(value, options));
+	return [...new Set(resolved)].sort((a, b) => a.localeCompare(b));
+};
+exports.isSameSeoOrigin = isSameSeoOrigin;
+exports.isValidSeoUrl = isValidSeoUrl;
+exports.normalizeSeoOrigin = normalizeSeoOrigin;
+exports.normalizeSeoPath = normalizeSeoPath;
+exports.normalizeSeoUrl = normalizeSeoUrl;
+exports.resolveSeoUrls = resolveSeoUrls;
+
+//# sourceMappingURL=normalize.cjs.map

package/dist/urls/normalize.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.cjs","names":[],"sources":["../../src/urls/normalize.ts"],"sourcesContent":["import type { SeoUrl } from \"../core/types\";\nimport type { SeoTrailingSlash } from \"../context/types\";\n\nexport interface NormalizeSeoUrlOptions {\n  baseUrl?: string;\n  trailingSlash?: SeoTrailingSlash;\n  allowExternal?: boolean;\n  allowCredentials?: boolean;\n}\n\nexport const normalizeSeoPath = (\n  pathname: string,\n  trailingSlash: SeoTrailingSlash = \"never\",\n): string => {\n  const path = pathname.startsWith(\"/\") ? pathname : `/${pathname}`;\n\n  if (path === \"/\") {\n    return \"/\";\n  }\n\n  if (trailingSlash === \"always\") {\n    return `${path.replace(/\\/+$/, \"\")}/`;\n  }\n\n  if (trailingSlash === \"never\") {\n    return path.replace(/\\/+$/, \"\");\n  }\n\n  return path;\n};\n\nexport const normalizeSeoUrl = (\n  value: string,\n  options: NormalizeSeoUrlOptions = {},\n): SeoUrl => {\n  if (typeof value !== \"string\" || !value.trim()) {\n    throw new Error(\"SEO URL must be a non-empty string.\");\n  }\n\n  const baseUrl = options.baseUrl ?? \"https://example.com\";\n\n  let url: URL;\n  let base: URL;\n\n  try {\n    base = new URL(baseUrl);\n    url = new URL(value, base);\n  } catch {\n    throw new Error(`Invalid SEO URL: \"${value}\".`);\n  }\n\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n    throw new Error(\"SEO URLs must use HTTP or HTTPS.\");\n  }\n\n  if (url.username || url.password) {\n    if (!options.allowCredentials) {\n      throw new Error(\"SEO URLs must not contain credentials.\");\n    }\n  }\n\n  if (options.allowExternal === false && url.origin !== base.origin) {\n    throw new Error(\"External SEO URLs are not allowed.\");\n  }\n\n  url.pathname = normalizeSeoPath(\n    url.pathname,\n    options.trailingSlash ?? \"never\",\n  );\n\n  return url.toString() as SeoUrl;\n};\n\nexport const normalizeSeoOrigin = (value: string): SeoUrl => {\n  let url: URL;\n\n  try {\n    url = new URL(value);\n  } catch {\n    throw new Error(`Invalid SEO origin: \"${value}\".`);\n  }\n\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n    throw new Error(\"SEO origins must use HTTP or HTTPS.\");\n  }\n\n  if (url.username || url.password) {\n    throw new Error(\"SEO origins must not contain credentials.\");\n  }\n\n  return url.origin as SeoUrl;\n};\n\nexport const isSameSeoOrigin = (first: string, second: string): boolean => {\n  try {\n    return new URL(first).origin === new URL(second).origin;\n  } catch {\n    return false;\n  }\n};\n\nexport const isValidSeoUrl = (value: string, baseUrl?: string): boolean => {\n  try {\n    normalizeSeoUrl(value, { baseUrl });\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nexport const resolveSeoUrls = (\n  values: readonly string[],\n  options: NormalizeSeoUrlOptions = {},\n): SeoUrl[] => {\n  const resolved = values.map((value) => normalizeSeoUrl(value, options));\n\n  return [...new Set(resolved)].sort((a, b) => a.localeCompare(b));\n};\n"],"mappings":";AAUA,MAAa,oBACX,UACA,gBAAkC,YACvB;CACX,MAAM,OAAO,SAAS,WAAW,GAAG,IAAI,WAAW,IAAI;CAEvD,IAAI,SAAS,KACX,OAAO;CAGT,IAAI,kBAAkB,UACpB,OAAO,GAAG,KAAK,QAAQ,QAAQ,EAAE,EAAE;CAGrC,IAAI,kBAAkB,SACpB,OAAO,KAAK,QAAQ,QAAQ,EAAE;CAGhC,OAAO;AACT;AAEA,MAAa,mBACX,OACA,UAAkC,CAAC,MACxB;CACX,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,GAC3C,MAAM,IAAI,MAAM,qCAAqC;CAGvD,MAAM,UAAU,QAAQ,WAAW;CAEnC,IAAI;CACJ,IAAI;CAEJ,IAAI;EACF,OAAO,IAAI,IAAI,OAAO;EACtB,MAAM,IAAI,IAAI,OAAO,IAAI;CAC3B,QAAQ;EACN,MAAM,IAAI,MAAM,qBAAqB,MAAM,GAAG;CAChD;CAEA,IAAI,IAAI,aAAa,WAAW,IAAI,aAAa,UAC/C,MAAM,IAAI,MAAM,kCAAkC;CAGpD,IAAI,IAAI,YAAY,IAAI,UAClB;MAAA,CAAC,QAAQ,kBACX,MAAM,IAAI,MAAM,wCAAwC;CAAA;CAI5D,IAAI,QAAQ,kBAAkB,SAAS,IAAI,WAAW,KAAK,QACzD,MAAM,IAAI,MAAM,oCAAoC;CAGtD,IAAI,WAAW,iBACb,IAAI,UACJ,QAAQ,iBAAiB,OAC3B;CAEA,OAAO,IAAI,SAAS;AACtB;AAEA,MAAa,sBAAsB,UAA0B;CAC3D,IAAI;CAEJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK;CACrB,QAAQ;EACN,MAAM,IAAI,MAAM,wBAAwB,MAAM,GAAG;CACnD;CAEA,IAAI,IAAI,aAAa,WAAW,IAAI,aAAa,UAC/C,MAAM,IAAI,MAAM,qCAAqC;CAGvD,IAAI,IAAI,YAAY,IAAI,UACtB,MAAM,IAAI,MAAM,2CAA2C;CAG7D,OAAO,IAAI;AACb;AAEA,MAAa,mBAAmB,OAAe,WAA4B;CACzE,IAAI;EACF,OAAO,IAAI,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,IAAI,MAAM,CAAC,CAAC;CACnD,QAAQ;EACN,OAAO;CACT;AACF;AAEA,MAAa,iBAAiB,OAAe,YAA8B;CACzE,IAAI;EACF,gBAAgB,OAAO,EAAE,QAAQ,CAAC;EAClC,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,MAAa,kBACX,QACA,UAAkC,CAAC,MACtB;CACb,MAAM,WAAW,OAAO,KAAK,UAAU,gBAAgB,OAAO,OAAO,CAAC;CAEtE,OAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AACjE"}

package/dist/urls/normalize.d.cts

@@ -0,0 +1,14 @@
+import { SeoUrl } from "../core/types.cjs";
+import { SeoTrailingSlash } from "../context/types.cjs";
+export interface NormalizeSeoUrlOptions {
+  baseUrl?: string;
+  trailingSlash?: SeoTrailingSlash;
+  allowExternal?: boolean;
+  allowCredentials?: boolean;
+}
+export declare const normalizeSeoPath: (pathname: string, trailingSlash?: SeoTrailingSlash) => string;
+export declare const normalizeSeoUrl: (value: string, options?: NormalizeSeoUrlOptions) => SeoUrl;
+export declare const normalizeSeoOrigin: (value: string) => SeoUrl;
+export declare const isSameSeoOrigin: (first: string, second: string) => boolean;
+export declare const isValidSeoUrl: (value: string, baseUrl?: string) => boolean;
+export declare const resolveSeoUrls: (values: readonly string[], options?: NormalizeSeoUrlOptions) => SeoUrl[];

package/dist/urls/normalize.d.ts

@@ -0,0 +1,14 @@
+import { SeoUrl } from "../core/types.js";
+import { SeoTrailingSlash } from "../context/types.js";
+export interface NormalizeSeoUrlOptions {
+  baseUrl?: string;
+  trailingSlash?: SeoTrailingSlash;
+  allowExternal?: boolean;
+  allowCredentials?: boolean;
+}
+export declare const normalizeSeoPath: (pathname: string, trailingSlash?: SeoTrailingSlash) => string;
+export declare const normalizeSeoUrl: (value: string, options?: NormalizeSeoUrlOptions) => SeoUrl;
+export declare const normalizeSeoOrigin: (value: string) => SeoUrl;
+export declare const isSameSeoOrigin: (first: string, second: string) => boolean;
+export declare const isValidSeoUrl: (value: string, baseUrl?: string) => boolean;
+export declare const resolveSeoUrls: (values: readonly string[], options?: NormalizeSeoUrlOptions) => SeoUrl[];

package/dist/urls/normalize.js

@@ -0,0 +1,60 @@
+// src/urls/normalize.ts
+const normalizeSeoPath = (pathname, trailingSlash = "never") => {
+	const path = pathname.startsWith("/") ? pathname : `/${pathname}`;
+	if (path === "/") return "/";
+	if (trailingSlash === "always") return `${path.replace(/\/+$/, "")}/`;
+	if (trailingSlash === "never") return path.replace(/\/+$/, "");
+	return path;
+};
+const normalizeSeoUrl = (value, options = {}) => {
+	if (typeof value !== "string" || !value.trim()) throw new Error("SEO URL must be a non-empty string.");
+	const baseUrl = options.baseUrl ?? "https://example.com";
+	let url;
+	let base;
+	try {
+		base = new URL(baseUrl);
+		url = new URL(value, base);
+	} catch {
+		throw new Error(`Invalid SEO URL: "${value}".`);
+	}
+	if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error("SEO URLs must use HTTP or HTTPS.");
+	if (url.username || url.password) {
+		if (!options.allowCredentials) throw new Error("SEO URLs must not contain credentials.");
+	}
+	if (options.allowExternal === false && url.origin !== base.origin) throw new Error("External SEO URLs are not allowed.");
+	url.pathname = normalizeSeoPath(url.pathname, options.trailingSlash ?? "never");
+	return url.toString();
+};
+const normalizeSeoOrigin = (value) => {
+	let url;
+	try {
+		url = new URL(value);
+	} catch {
+		throw new Error(`Invalid SEO origin: "${value}".`);
+	}
+	if (url.protocol !== "http:" && url.protocol !== "https:") throw new Error("SEO origins must use HTTP or HTTPS.");
+	if (url.username || url.password) throw new Error("SEO origins must not contain credentials.");
+	return url.origin;
+};
+const isSameSeoOrigin = (first, second) => {
+	try {
+		return new URL(first).origin === new URL(second).origin;
+	} catch {
+		return false;
+	}
+};
+const isValidSeoUrl = (value, baseUrl) => {
+	try {
+		normalizeSeoUrl(value, { baseUrl });
+		return true;
+	} catch {
+		return false;
+	}
+};
+const resolveSeoUrls = (values, options = {}) => {
+	const resolved = values.map((value) => normalizeSeoUrl(value, options));
+	return [...new Set(resolved)].sort((a, b) => a.localeCompare(b));
+};
+export { isSameSeoOrigin, isValidSeoUrl, normalizeSeoOrigin, normalizeSeoPath, normalizeSeoUrl, resolveSeoUrls };
+
+//# sourceMappingURL=normalize.js.map

package/dist/urls/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","names":[],"sources":["../../src/urls/normalize.ts"],"sourcesContent":["import type { SeoUrl } from \"../core/types\";\nimport type { SeoTrailingSlash } from \"../context/types\";\n\nexport interface NormalizeSeoUrlOptions {\n  baseUrl?: string;\n  trailingSlash?: SeoTrailingSlash;\n  allowExternal?: boolean;\n  allowCredentials?: boolean;\n}\n\nexport const normalizeSeoPath = (\n  pathname: string,\n  trailingSlash: SeoTrailingSlash = \"never\",\n): string => {\n  const path = pathname.startsWith(\"/\") ? pathname : `/${pathname}`;\n\n  if (path === \"/\") {\n    return \"/\";\n  }\n\n  if (trailingSlash === \"always\") {\n    return `${path.replace(/\\/+$/, \"\")}/`;\n  }\n\n  if (trailingSlash === \"never\") {\n    return path.replace(/\\/+$/, \"\");\n  }\n\n  return path;\n};\n\nexport const normalizeSeoUrl = (\n  value: string,\n  options: NormalizeSeoUrlOptions = {},\n): SeoUrl => {\n  if (typeof value !== \"string\" || !value.trim()) {\n    throw new Error(\"SEO URL must be a non-empty string.\");\n  }\n\n  const baseUrl = options.baseUrl ?? \"https://example.com\";\n\n  let url: URL;\n  let base: URL;\n\n  try {\n    base = new URL(baseUrl);\n    url = new URL(value, base);\n  } catch {\n    throw new Error(`Invalid SEO URL: \"${value}\".`);\n  }\n\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n    throw new Error(\"SEO URLs must use HTTP or HTTPS.\");\n  }\n\n  if (url.username || url.password) {\n    if (!options.allowCredentials) {\n      throw new Error(\"SEO URLs must not contain credentials.\");\n    }\n  }\n\n  if (options.allowExternal === false && url.origin !== base.origin) {\n    throw new Error(\"External SEO URLs are not allowed.\");\n  }\n\n  url.pathname = normalizeSeoPath(\n    url.pathname,\n    options.trailingSlash ?? \"never\",\n  );\n\n  return url.toString() as SeoUrl;\n};\n\nexport const normalizeSeoOrigin = (value: string): SeoUrl => {\n  let url: URL;\n\n  try {\n    url = new URL(value);\n  } catch {\n    throw new Error(`Invalid SEO origin: \"${value}\".`);\n  }\n\n  if (url.protocol !== \"http:\" && url.protocol !== \"https:\") {\n    throw new Error(\"SEO origins must use HTTP or HTTPS.\");\n  }\n\n  if (url.username || url.password) {\n    throw new Error(\"SEO origins must not contain credentials.\");\n  }\n\n  return url.origin as SeoUrl;\n};\n\nexport const isSameSeoOrigin = (first: string, second: string): boolean => {\n  try {\n    return new URL(first).origin === new URL(second).origin;\n  } catch {\n    return false;\n  }\n};\n\nexport const isValidSeoUrl = (value: string, baseUrl?: string): boolean => {\n  try {\n    normalizeSeoUrl(value, { baseUrl });\n    return true;\n  } catch {\n    return false;\n  }\n};\n\nexport const resolveSeoUrls = (\n  values: readonly string[],\n  options: NormalizeSeoUrlOptions = {},\n): SeoUrl[] => {\n  const resolved = values.map((value) => normalizeSeoUrl(value, options));\n\n  return [...new Set(resolved)].sort((a, b) => a.localeCompare(b));\n};\n"],"mappings":";AAUA,MAAa,oBACX,UACA,gBAAkC,YACvB;CACX,MAAM,OAAO,SAAS,WAAW,GAAG,IAAI,WAAW,IAAI;CAEvD,IAAI,SAAS,KACX,OAAO;CAGT,IAAI,kBAAkB,UACpB,OAAO,GAAG,KAAK,QAAQ,QAAQ,EAAE,EAAE;CAGrC,IAAI,kBAAkB,SACpB,OAAO,KAAK,QAAQ,QAAQ,EAAE;CAGhC,OAAO;AACT;AAEA,MAAa,mBACX,OACA,UAAkC,CAAC,MACxB;CACX,IAAI,OAAO,UAAU,YAAY,CAAC,MAAM,KAAK,GAC3C,MAAM,IAAI,MAAM,qCAAqC;CAGvD,MAAM,UAAU,QAAQ,WAAW;CAEnC,IAAI;CACJ,IAAI;CAEJ,IAAI;EACF,OAAO,IAAI,IAAI,OAAO;EACtB,MAAM,IAAI,IAAI,OAAO,IAAI;CAC3B,QAAQ;EACN,MAAM,IAAI,MAAM,qBAAqB,MAAM,GAAG;CAChD;CAEA,IAAI,IAAI,aAAa,WAAW,IAAI,aAAa,UAC/C,MAAM,IAAI,MAAM,kCAAkC;CAGpD,IAAI,IAAI,YAAY,IAAI,UAClB;MAAA,CAAC,QAAQ,kBACX,MAAM,IAAI,MAAM,wCAAwC;CAAA;CAI5D,IAAI,QAAQ,kBAAkB,SAAS,IAAI,WAAW,KAAK,QACzD,MAAM,IAAI,MAAM,oCAAoC;CAGtD,IAAI,WAAW,iBACb,IAAI,UACJ,QAAQ,iBAAiB,OAC3B;CAEA,OAAO,IAAI,SAAS;AACtB;AAEA,MAAa,sBAAsB,UAA0B;CAC3D,IAAI;CAEJ,IAAI;EACF,MAAM,IAAI,IAAI,KAAK;CACrB,QAAQ;EACN,MAAM,IAAI,MAAM,wBAAwB,MAAM,GAAG;CACnD;CAEA,IAAI,IAAI,aAAa,WAAW,IAAI,aAAa,UAC/C,MAAM,IAAI,MAAM,qCAAqC;CAGvD,IAAI,IAAI,YAAY,IAAI,UACtB,MAAM,IAAI,MAAM,2CAA2C;CAG7D,OAAO,IAAI;AACb;AAEA,MAAa,mBAAmB,OAAe,WAA4B;CACzE,IAAI;EACF,OAAO,IAAI,IAAI,KAAK,CAAC,CAAC,WAAW,IAAI,IAAI,MAAM,CAAC,CAAC;CACnD,QAAQ;EACN,OAAO;CACT;AACF;AAEA,MAAa,iBAAiB,OAAe,YAA8B;CACzE,IAAI;EACF,gBAAgB,OAAO,EAAE,QAAQ,CAAC;EAClC,OAAO;CACT,QAAQ;EACN,OAAO;CACT;AACF;AAEA,MAAa,kBACX,QACA,UAAkC,CAAC,MACtB;CACb,MAAM,WAAW,OAAO,KAAK,UAAU,gBAAgB,OAAO,OAAO,CAAC;CAEtE,OAAO,CAAC,GAAG,IAAI,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,cAAc,CAAC,CAAC;AACjE"}

package/dist/urls/types.d.cts

@@ -0,0 +1,22 @@
+import { SeoUrl } from "../core/types.cjs";
+import { SeoTrailingSlash } from "../context/types.cjs";
+export interface SeoUrlOptions {
+  baseUrl?: string;
+  trailingSlash?: SeoTrailingSlash;
+  allowExternal?: boolean;
+  allowCredentials?: boolean;
+}
+export interface SeoUrlValidationIssue {
+  code: string;
+  message: string;
+  value?: string;
+}
+export interface SeoUrlResult {
+  url?: SeoUrl;
+  valid: boolean;
+  issues: SeoUrlValidationIssue[];
+}
+export interface SeoOriginOptions {
+  allowSubdomains?: boolean;
+  protocols?: readonly ("http:" | "https:")[];
+}

package/dist/urls/types.d.ts

@@ -0,0 +1,22 @@
+import { SeoUrl } from "../core/types.js";
+import { SeoTrailingSlash } from "../context/types.js";
+export interface SeoUrlOptions {
+  baseUrl?: string;
+  trailingSlash?: SeoTrailingSlash;
+  allowExternal?: boolean;
+  allowCredentials?: boolean;
+}
+export interface SeoUrlValidationIssue {
+  code: string;
+  message: string;
+  value?: string;
+}
+export interface SeoUrlResult {
+  url?: SeoUrl;
+  valid: boolean;
+  issues: SeoUrlValidationIssue[];
+}
+export interface SeoOriginOptions {
+  allowSubdomains?: boolean;
+  protocols?: readonly ("http:" | "https:")[];
+}

package/dist/validation/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_validate = require("./validate.cjs");
+exports.validateSeo = require_validate.validateSeo;
+exports.validateSeoMetadata = require_validate.validateSeoMetadata;
+exports.validateSeoNode = require_validate.validateSeoNode;

package/dist/validation/index.d.cts

@@ -0,0 +1,3 @@
+import { SeoCustomValidator, SeoRichResultProfile, SeoValidationContext, SeoValidationInput, SeoValidationIssue, SeoValidationMode, SeoValidationOptions, SeoValidationReport, SeoValidationSource, SeoValidationSummary } from "./types.cjs";
+import { validateSeo, validateSeoMetadata, validateSeoNode } from "./validate.cjs";
+export { type SeoCustomValidator, type SeoRichResultProfile, type SeoValidationContext, type SeoValidationInput, type SeoValidationIssue, type SeoValidationMode, type SeoValidationOptions, type SeoValidationReport, type SeoValidationSource, type SeoValidationSummary, validateSeo, validateSeoMetadata, validateSeoNode };

package/dist/validation/index.d.ts

@@ -0,0 +1,3 @@
+import { SeoCustomValidator, SeoRichResultProfile, SeoValidationContext, SeoValidationInput, SeoValidationIssue, SeoValidationMode, SeoValidationOptions, SeoValidationReport, SeoValidationSource, SeoValidationSummary } from "./types.js";
+import { validateSeo, validateSeoMetadata, validateSeoNode } from "./validate.js";
+export { type SeoCustomValidator, type SeoRichResultProfile, type SeoValidationContext, type SeoValidationInput, type SeoValidationIssue, type SeoValidationMode, type SeoValidationOptions, type SeoValidationReport, type SeoValidationSource, type SeoValidationSummary, validateSeo, validateSeoMetadata, validateSeoNode };

package/dist/validation/index.js

@@ -0,0 +1 @@
+export { validateSeo, validateSeoMetadata, validateSeoNode } from "./validate.js";

package/dist/validation/types.d.cts

@@ -0,0 +1,75 @@
+import { SeoGraph, SeoNode, SeoValidationIssue as SeoValidationIssue$1 } from "../core/types.cjs";
+import { ResolvedSeoMetadata, SeoPageMetadata } from "../metadata/types.cjs";
+import { SchemaRegistry } from "../schema/types.cjs";
+export type SeoValidationMode = "off" | "warn" | "strict";
+export type SeoValidationSource = "graph" | "schema" | "semantic" | "metadata" | "rich-results" | "registry" | "custom";
+export type SeoRichResultProfile = "article" | "product" | "breadcrumb" | "event" | "recipe" | "job-posting" | "local-business" | "software-application";
+export interface SeoValidationIssue extends SeoValidationIssue$1 {
+  source: SeoValidationSource;
+  suggestion?: string;
+  docsUrl?: string;
+}
+export interface SeoValidationSummary {
+  errors: number;
+  warnings: number;
+  infos: number;
+  total: number;
+}
+export interface SeoValidationReport {
+  valid: boolean;
+  mode: SeoValidationMode;
+  issues: SeoValidationIssue[];
+  summary: SeoValidationSummary;
+}
+export interface SeoValidationContext {
+  graph?: SeoGraph;
+  metadata?: SeoPageMetadata | ResolvedSeoMetadata;
+  registry: SchemaRegistry;
+  mode: SeoValidationMode;
+}
+export type SeoCustomValidator = (context: SeoValidationContext) => readonly SeoValidationIssue[];
+export interface SeoValidationOptions {
+  /**
+   * off: disable validation.
+   * warn: report issues without rejecting output.
+   * strict: treat warnings as errors.
+   */
+  mode?: SeoValidationMode;
+  /**
+   * Schema.org registry.
+   *
+   * Defaults to the generated Puzzle registry.
+   */
+  registry?: SchemaRegistry;
+  /**
+   * Additional Google Rich Results profiles to validate.
+   */
+  profiles?: readonly SeoRichResultProfile[];
+  /**
+   * Custom validation rules.
+   */
+  validators?: readonly SeoCustomValidator[];
+  /**
+   * Validate required Schema.org properties.
+   */
+  validateRequiredProperties?: boolean;
+  /**
+   * Whether references to external entities are permitted.
+   */
+  allowExternalReferences?: boolean;
+  /**
+   * Base URL used for resolving local references.
+   */
+  baseUrl?: string;
+  /**
+   * Whether unknown Schema.org properties are accepted.
+   *
+   * Defaults to true in warn mode and false in strict mode.
+   */
+  allowUnknownProperties?: boolean;
+}
+export interface SeoValidationInput {
+  graph?: SeoGraph;
+  nodes?: readonly SeoNode[];
+  metadata?: SeoPageMetadata | ResolvedSeoMetadata;
+}

package/dist/validation/types.d.ts

@@ -0,0 +1,75 @@
+import { SeoGraph, SeoNode, SeoValidationIssue as SeoValidationIssue$1 } from "../core/types.js";
+import { ResolvedSeoMetadata, SeoPageMetadata } from "../metadata/types.js";
+import { SchemaRegistry } from "../schema/types.js";
+export type SeoValidationMode = "off" | "warn" | "strict";
+export type SeoValidationSource = "graph" | "schema" | "semantic" | "metadata" | "rich-results" | "registry" | "custom";
+export type SeoRichResultProfile = "article" | "product" | "breadcrumb" | "event" | "recipe" | "job-posting" | "local-business" | "software-application";
+export interface SeoValidationIssue extends SeoValidationIssue$1 {
+  source: SeoValidationSource;
+  suggestion?: string;
+  docsUrl?: string;
+}
+export interface SeoValidationSummary {
+  errors: number;
+  warnings: number;
+  infos: number;
+  total: number;
+}
+export interface SeoValidationReport {
+  valid: boolean;
+  mode: SeoValidationMode;
+  issues: SeoValidationIssue[];
+  summary: SeoValidationSummary;
+}
+export interface SeoValidationContext {
+  graph?: SeoGraph;
+  metadata?: SeoPageMetadata | ResolvedSeoMetadata;
+  registry: SchemaRegistry;
+  mode: SeoValidationMode;
+}
+export type SeoCustomValidator = (context: SeoValidationContext) => readonly SeoValidationIssue[];
+export interface SeoValidationOptions {
+  /**
+   * off: disable validation.
+   * warn: report issues without rejecting output.
+   * strict: treat warnings as errors.
+   */
+  mode?: SeoValidationMode;
+  /**
+   * Schema.org registry.
+   *
+   * Defaults to the generated Puzzle registry.
+   */
+  registry?: SchemaRegistry;
+  /**
+   * Additional Google Rich Results profiles to validate.
+   */
+  profiles?: readonly SeoRichResultProfile[];
+  /**
+   * Custom validation rules.
+   */
+  validators?: readonly SeoCustomValidator[];
+  /**
+   * Validate required Schema.org properties.
+   */
+  validateRequiredProperties?: boolean;
+  /**
+   * Whether references to external entities are permitted.
+   */
+  allowExternalReferences?: boolean;
+  /**
+   * Base URL used for resolving local references.
+   */
+  baseUrl?: string;
+  /**
+   * Whether unknown Schema.org properties are accepted.
+   *
+   * Defaults to true in warn mode and false in strict mode.
+   */
+  allowUnknownProperties?: boolean;
+}
+export interface SeoValidationInput {
+  graph?: SeoGraph;
+  nodes?: readonly SeoNode[];
+  metadata?: SeoPageMetadata | ResolvedSeoMetadata;
+}