@puzzle-ui/seo 0.0.0-stage → 0.5.0

package/dist/robots/generate.js

@@ -0,0 +1,86 @@
+import { normalizeSeoUrl } from "../urls/normalize.js";
+// 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 {
+		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) => 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: []
+	};
+};
+export { generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions };
+
+//# sourceMappingURL=generate.js.map

package/dist/robots/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","names":[],"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":";;AASA,MAAM,gBACJ,MACA,UAC4B;CAC5B,MAAM,SAAkC,CAAC;CAEzC,MAAM,SAAS,MAAM,QAAQ,KAAK,SAAS,IACvC,KAAK,YACL,CAAC,KAAK,SAAS;CAEnB,IACE,OAAO,WAAW,KAClB,OAAO,MAAM,UAAU,CAAC,MAAM,KAAK,KAAK,SAAS,KAAK,KAAK,CAAC,GAE5D,OAAO,KAAK;EACV,MAAM;EACN,SACE;EACF,MAAM,SAAS,MAAM;CACvB,CAAC;CAGH,IACE,KAAK,eAAe,KAAA,MACnB,CAAC,OAAO,SAAS,KAAK,UAAU,KAAK,KAAK,aAAa,IAExD,OAAO,KAAK;EACV,MAAM;EACN,SAAS;EACT,MAAM,SAAS,MAAM;CACvB,CAAC;CAGH,KAAK,MAAM,CAAC,MAAM,UAAU,CAC1B,CAAC,SAAS,KAAK,KAAK,GACpB,CAAC,YAAY,KAAK,QAAQ,CAC5B,GAAY;EACV,IAAI,CAAC,OACH;EAGF,KAAK,MAAM,QAAQ,OACjB,IAAI,CAAC,KAAK,WAAW,GAAG,KAAK,SAAS,KAAK,IAAI,GAC7C,OAAO,KAAK;GACV,MAAM;GACN,SAAS,GAAG,KAAK;GACjB,MAAM,SAAS,MAAM,GAAG;EAC1B,CAAC;CAGP;CAEA,OAAO;AACT;AAEA,MAAa,yBACX,YAC4B;CAC5B,MAAM,SAAkC,CAAC;CAEzC,IAAI,CAAC,QAAQ,MAAM,QACjB,OAAO,KAAK;EACV,MAAM;EACN,SAAS;CACX,CAAC;CAGH,QAAQ,MAAM,SAAS,MAAM,UAAU;EACrC,OAAO,KAAK,GAAG,aAAa,MAAM,KAAK,CAAC;CAC1C,CAAC;CAED,KAAK,MAAM,WAAW,MAAM,QAAQ,QAAQ,OAAO,IAC/C,QAAQ,UACR,QAAQ,UACN,CAAC,QAAQ,OAAO,IAChB,CAAC,GACL,IAAI;EACF,gBAAgB,OAAO;CACzB,QAAQ;EACN,OAAO,KAAK;GACV,MAAM;GACN,SAAS,wBAAwB,QAAQ;EAC3C,CAAC;CACH;CAGF,IAAI,QAAQ,QAAQ,SAAS,KAAK,QAAQ,IAAI,GAC5C,OAAO,KAAK;EACV,MAAM;EACN,SAAS;CACX,CAAC;CAGH,OAAO;AACT;AAEA,MAAM,iBAAiB,SAA+B;CAKpD,MAAM,SAJS,MAAM,QAAQ,KAAK,SAAS,IACvC,KAAK,YACL,CAAC,KAAK,SAAS,EAAA,CAEE,KAAK,UAAU,eAAe,MAAM,KAAK,GAAG;CAEjE,KAAK,MAAM,QAAQ,KAAK,SAAS,CAAC,GAChC,MAAM,KAAK,UAAU,MAAM;CAG7B,KAAK,MAAM,QAAQ,KAAK,YAAY,CAAC,GACnC,MAAM,KAAK,aAAa,MAAM;CAGhC,IAAI,KAAK,eAAe,KAAA,GACtB,MAAM,KAAK,gBAAgB,KAAK,YAAY;CAG9C,OAAO;AACT;AAEA,MAAa,sBAAsB,YAAmC;CACpE,MAAM,SAAS,sBAAsB,OAAO;CAE5C,IAAI,OAAO,SAAS,GAClB,MAAM,IAAI,MACR,iCAAiC,OAC9B,KAAK,UAAU,MAAM,OAAO,CAAC,CAC7B,KAAK,GAAG,GACb;CAGF,MAAM,SAAS,QAAQ,MAAM,IAAI,aAAa;CAE9C,MAAM,QAAkB,CAAC;CAEzB,OAAO,SAAS,OAAO,UAAU;EAC/B,IAAI,QAAQ,GACV,MAAM,KAAK,EAAE;EAGf,MAAM,KAAK,GAAG,KAAK;CACrB,CAAC;CAED,MAAM,WAAW,CACf,GAAG,IAAI,KACJ,MAAM,QAAQ,QAAQ,OAAO,IAC1B,QAAQ,UACR,QAAQ,UACN,CAAC,QAAQ,OAAO,IAChB,CAAC,EAAA,CACL,KAAK,QAAQ,gBAAgB,GAAG,CAAC,CACrC,CACF,CAAC,CAAC,KAAK;CAEP,IAAI,SAAS,SAAS,GAAG;EACvB,MAAM,KAAK,EAAE;EAEb,KAAK,MAAM,WAAW,UACpB,MAAM,KAAK,YAAY,SAAS;CAEpC;CAEA,IAAI,QAAQ,MACV,MAAM,KAAK,SAAS,QAAQ,MAAM;CAGpC,OAAO,GAAG,MAAM,KAAK,IAAI,EAAE;AAC7B;AAEA,MAAa,qBAAqB,YAAyC;CACzE,MAAM,SAAS,sBAAsB,OAAO;CAE5C,IAAI,OAAO,SAAS,GAClB,OAAO;EACL,SAAS;EACT;CACF;CAGF,OAAO;EACL,SAAS,mBAAmB,OAAO;EACnC,QAAQ,CAAC;CACX;AACF"}

package/dist/robots/index.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_generate = require("./generate.cjs");
+exports.generateRobotsTxt = require_generate.generateRobotsTxt;
+exports.serializeRobotsTxt = require_generate.serializeRobotsTxt;
+exports.validateRobotsOptions = require_generate.validateRobotsOptions;

package/dist/robots/index.d.cts

@@ -0,0 +1,3 @@
+import { RobotsDirective, RobotsOptions, RobotsPolicy, RobotsResult, RobotsRule, RobotsValidationIssue } from "./types.cjs";
+import { generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions } from "./generate.cjs";
+export { type RobotsDirective, type RobotsOptions, type RobotsPolicy, type RobotsResult, type RobotsRule, type RobotsValidationIssue, generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions };

package/dist/robots/index.d.ts

@@ -0,0 +1,3 @@
+import { RobotsDirective, RobotsOptions, RobotsPolicy, RobotsResult, RobotsRule, RobotsValidationIssue } from "./types.js";
+import { generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions } from "./generate.js";
+export { type RobotsDirective, type RobotsOptions, type RobotsPolicy, type RobotsResult, type RobotsRule, type RobotsValidationIssue, generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions };

package/dist/robots/index.js

@@ -0,0 +1 @@
+export { generateRobotsTxt, serializeRobotsTxt, validateRobotsOptions } from "./generate.js";

package/dist/robots/types.d.cts

@@ -0,0 +1,27 @@
+export type RobotsDirective = "all" | "none" | "index" | "noindex" | "follow" | "nofollow" | "noarchive" | "nosnippet" | "notranslate" | "noimageindex";
+export interface RobotsRule {
+  userAgent: string | string[];
+  allow?: string[];
+  disallow?: string[];
+  crawlDelay?: number;
+}
+export interface RobotsOptions {
+  rules: RobotsRule[];
+  sitemap?: string | string[];
+  host?: string;
+}
+export interface RobotsPolicy {
+  directives: RobotsDirective[];
+  maxSnippet?: number;
+  maxImagePreview?: "none" | "standard" | "large";
+  maxVideoPreview?: number;
+}
+export interface RobotsResult {
+  content: string;
+  issues: RobotsValidationIssue[];
+}
+export interface RobotsValidationIssue {
+  code: string;
+  message: string;
+  path?: string;
+}

package/dist/robots/types.d.ts

@@ -0,0 +1,27 @@
+export type RobotsDirective = "all" | "none" | "index" | "noindex" | "follow" | "nofollow" | "noarchive" | "nosnippet" | "notranslate" | "noimageindex";
+export interface RobotsRule {
+  userAgent: string | string[];
+  allow?: string[];
+  disallow?: string[];
+  crawlDelay?: number;
+}
+export interface RobotsOptions {
+  rules: RobotsRule[];
+  sitemap?: string | string[];
+  host?: string;
+}
+export interface RobotsPolicy {
+  directives: RobotsDirective[];
+  maxSnippet?: number;
+  maxImagePreview?: "none" | "standard" | "large";
+  maxVideoPreview?: number;
+}
+export interface RobotsResult {
+  content: string;
+  issues: RobotsValidationIssue[];
+}
+export interface RobotsValidationIssue {
+  code: string;
+  message: string;
+  path?: string;
+}

package/dist/schema/create-registry.cjs

@@ -0,0 +1,12 @@
+const require_schemaorg = require("./generated/schemaorg.cjs");
+const require_registry = require("./registry.cjs");
+// src/schema/create-registry.ts
+const createDefaultSchemaRegistry = (options = {}) => {
+	return require_registry.createSchemaRegistry({
+		...options,
+		generated: require_schemaorg.generatedSchemaDefinitions
+	});
+};
+exports.createDefaultSchemaRegistry = createDefaultSchemaRegistry;
+
+//# sourceMappingURL=create-registry.cjs.map

package/dist/schema/create-registry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-registry.cjs","names":["createSchemaRegistry","generatedSchemaDefinitions"],"sources":["../../src/schema/create-registry.ts"],"sourcesContent":["import { generatedSchemaDefinitions } from \"./generated\";\nimport { createSchemaRegistry } from \"./registry\";\nimport type {\n  SchemaDefinition,\n  SchemaRegistry,\n  SchemaRegistryOptions,\n} from \"./types\";\n\nexport const createDefaultSchemaRegistry = (\n  options: Omit<SchemaRegistryOptions, \"generated\"> = {},\n): SchemaRegistry => {\n  return createSchemaRegistry({\n    ...options,\n    generated:\n      generatedSchemaDefinitions as unknown as readonly SchemaDefinition[],\n  });\n};\n"],"mappings":";;;AAQA,MAAa,+BACX,UAAoD,CAAC,MAClC;CACnB,OAAOA,iBAAAA,qBAAqB;EAC1B,GAAG;EACH,WACEC,kBAAAA;CACJ,CAAC;AACH"}

package/dist/schema/create-registry.d.cts

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

package/dist/schema/create-registry.d.ts

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

package/dist/schema/create-registry.js

@@ -0,0 +1,12 @@
+import { generatedSchemaDefinitions } from "./generated/schemaorg.js";
+import { createSchemaRegistry } from "./registry.js";
+// src/schema/create-registry.ts
+const createDefaultSchemaRegistry = (options = {}) => {
+	return createSchemaRegistry({
+		...options,
+		generated: generatedSchemaDefinitions
+	});
+};
+export { createDefaultSchemaRegistry };
+
+//# sourceMappingURL=create-registry.js.map

package/dist/schema/create-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-registry.js","names":[],"sources":["../../src/schema/create-registry.ts"],"sourcesContent":["import { generatedSchemaDefinitions } from \"./generated\";\nimport { createSchemaRegistry } from \"./registry\";\nimport type {\n  SchemaDefinition,\n  SchemaRegistry,\n  SchemaRegistryOptions,\n} from \"./types\";\n\nexport const createDefaultSchemaRegistry = (\n  options: Omit<SchemaRegistryOptions, \"generated\"> = {},\n): SchemaRegistry => {\n  return createSchemaRegistry({\n    ...options,\n    generated:\n      generatedSchemaDefinitions as unknown as readonly SchemaDefinition[],\n  });\n};\n"],"mappings":";;;AAQA,MAAa,+BACX,UAAoD,CAAC,MAClC;CACnB,OAAO,qBAAqB;EAC1B,GAAG;EACH,WACE;CACJ,CAAC;AACH"}

package/dist/schema/generated/index.d.cts

@@ -0,0 +1,2 @@
+import { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, SchemaOrgPropertyNames, generatedSchemaDefinitions } from "./schemaorg.cjs";
+export { SCHEMAORG_SOURCE_HASH, SCHEMAORG_VERSION, type SchemaOrgPropertyNames, generatedSchemaDefinitions };