@umituz/web-seo 2.0.21 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (103) hide show
  1. package/dist/domains/seo/components/JsonLd.d.ts +7 -6
  2. package/dist/domains/seo/components/JsonLd.js +26 -77
  3. package/dist/domains/seo/components/SEO.d.ts +7 -0
  4. package/dist/domains/seo/components/SEO.js +10 -33
  5. package/dist/domains/seo/core/constants.d.ts +15 -0
  6. package/dist/domains/seo/core/constants.js +15 -0
  7. package/dist/domains/seo/core/deep-equal.d.ts +8 -0
  8. package/dist/domains/seo/core/deep-equal.js +28 -0
  9. package/dist/domains/seo/core/dom-queue.d.ts +10 -0
  10. package/dist/domains/seo/core/dom-queue.js +37 -0
  11. package/dist/domains/seo/core/escape.d.ts +12 -0
  12. package/dist/domains/seo/core/escape.js +41 -0
  13. package/dist/domains/seo/core/hash.d.ts +9 -0
  14. package/dist/domains/seo/core/hash.js +29 -0
  15. package/dist/domains/seo/core/init.d.ts +15 -2
  16. package/dist/domains/seo/core/init.js +38 -18
  17. package/dist/domains/seo/core/seo-strategies.d.ts +29 -0
  18. package/dist/domains/seo/core/seo-strategies.js +694 -0
  19. package/dist/domains/seo/core/seo-strategy.d.ts +37 -0
  20. package/dist/domains/seo/core/seo-strategy.js +14 -0
  21. package/dist/domains/seo/hooks/useJsonLd.d.ts +6 -7
  22. package/dist/domains/seo/hooks/useJsonLd.js +27 -61
  23. package/dist/domains/seo/hooks/useSEO.d.ts +6 -0
  24. package/dist/domains/seo/hooks/useSEO.js +7 -29
  25. package/dist/domains/seo/ssr/helmet.d.ts +25 -0
  26. package/dist/domains/seo/ssr/helmet.js +23 -0
  27. package/dist/domains/seo/ssr/index.d.ts +10 -0
  28. package/dist/domains/seo/ssr/index.js +8 -0
  29. package/dist/domains/seo/ssr/renderer.d.ts +11 -36
  30. package/dist/domains/seo/ssr/renderer.js +51 -285
  31. package/dist/domains/seo/ssr/serializer.d.ts +5 -60
  32. package/dist/domains/seo/ssr/serializer.js +26 -166
  33. package/dist/domains/seo/types/index.d.ts +0 -4
  34. package/dist/domains/seo/types/schema.d.ts +22 -1
  35. package/dist/domains/seo/utils/dom/dom-context.d.ts +13 -0
  36. package/dist/domains/seo/utils/dom/dom-context.js +62 -0
  37. package/dist/domains/seo/utils/dom/dom-mutator.d.ts +31 -0
  38. package/dist/domains/seo/utils/dom/dom-mutator.js +89 -0
  39. package/dist/domains/seo/utils/dom/index.d.ts +1 -0
  40. package/dist/domains/seo/utils/dom/index.js +1 -0
  41. package/dist/domains/seo/utils/index.d.ts +3 -4
  42. package/dist/domains/seo/utils/index.js +3 -5
  43. package/dist/domains/seo/utils/schema-generators/base.d.ts +25 -0
  44. package/dist/domains/seo/utils/schema-generators/base.js +50 -0
  45. package/dist/domains/seo/utils/schema-generators/factory.d.ts +27 -0
  46. package/dist/domains/seo/utils/schema-generators/factory.js +49 -0
  47. package/dist/domains/seo/utils/schema-generators/generators/article.d.ts +4 -0
  48. package/dist/domains/seo/utils/schema-generators/generators/article.js +39 -0
  49. package/dist/domains/seo/utils/schema-generators/generators/breadcrumb.d.ts +6 -0
  50. package/dist/domains/seo/utils/schema-generators/generators/breadcrumb.js +18 -0
  51. package/dist/domains/seo/utils/schema-generators/generators/course.d.ts +3 -0
  52. package/dist/domains/seo/utils/schema-generators/generators/course.js +70 -0
  53. package/dist/domains/seo/utils/schema-generators/generators/faq.d.ts +3 -0
  54. package/dist/domains/seo/utils/schema-generators/generators/faq.js +21 -0
  55. package/dist/domains/seo/utils/schema-generators/generators/local-business.d.ts +3 -0
  56. package/dist/domains/seo/utils/schema-generators/generators/local-business.js +45 -0
  57. package/dist/domains/seo/utils/schema-generators/generators/organization.d.ts +3 -0
  58. package/dist/domains/seo/utils/schema-generators/generators/organization.js +25 -0
  59. package/dist/domains/seo/utils/schema-generators/generators/person.d.ts +3 -0
  60. package/dist/domains/seo/utils/schema-generators/generators/person.js +27 -0
  61. package/dist/domains/seo/utils/schema-generators/generators/product.d.ts +3 -0
  62. package/dist/domains/seo/utils/schema-generators/generators/product.js +40 -0
  63. package/dist/domains/seo/utils/schema-generators/generators/video.d.ts +3 -0
  64. package/dist/domains/seo/utils/schema-generators/generators/video.js +23 -0
  65. package/dist/domains/seo/utils/schema-generators/generators/website.d.ts +3 -0
  66. package/dist/domains/seo/utils/schema-generators/generators/website.js +30 -0
  67. package/dist/domains/seo/utils/schema-generators/index.d.ts +15 -2
  68. package/dist/domains/seo/utils/schema-generators/index.js +13 -2
  69. package/dist/domains/seo/utils/schema-generators/types.d.ts +142 -0
  70. package/dist/domains/seo/utils/schema-generators/types.js +5 -0
  71. package/dist/domains/seo/utils/validation/hreflang-validator.d.ts +7 -0
  72. package/dist/domains/seo/utils/validation/hreflang-validator.js +13 -0
  73. package/dist/domains/seo/utils/validation/image-validator.d.ts +7 -0
  74. package/dist/domains/seo/utils/validation/image-validator.js +24 -0
  75. package/dist/domains/seo/utils/validation/index.d.ts +10 -2
  76. package/dist/domains/seo/utils/validation/index.js +10 -2
  77. package/dist/domains/seo/utils/validation/jsonld-validator.d.ts +9 -0
  78. package/dist/domains/seo/utils/validation/jsonld-validator.js +74 -0
  79. package/dist/domains/seo/utils/validation/language-code.d.ts +7 -0
  80. package/dist/domains/seo/utils/validation/language-code.js +8 -0
  81. package/dist/domains/seo/utils/validation/length-validator.d.ts +10 -0
  82. package/dist/domains/seo/utils/validation/length-validator.js +40 -0
  83. package/dist/domains/seo/utils/validation/seo-auditor.d.ts +17 -0
  84. package/dist/domains/seo/utils/validation/seo-auditor.js +144 -0
  85. package/dist/domains/seo/utils/validation/text-helpers.d.ts +7 -0
  86. package/dist/domains/seo/utils/validation/text-helpers.js +12 -0
  87. package/dist/domains/seo/utils/validation/url-validator.d.ts +8 -0
  88. package/dist/domains/seo/utils/validation/url-validator.js +26 -0
  89. package/dist/domains/seo/vite/index.d.ts +6 -4
  90. package/dist/domains/seo/vite/index.js +5 -3
  91. package/dist/domains/seo/vite/plugin.d.ts +3 -55
  92. package/dist/domains/seo/vite/plugin.js +28 -186
  93. package/dist/domains/seo/vite/presets.d.ts +14 -0
  94. package/dist/domains/seo/vite/presets.js +33 -0
  95. package/dist/domains/seo/vite/robots-generator.d.ts +9 -0
  96. package/dist/domains/seo/vite/robots-generator.js +36 -0
  97. package/dist/domains/seo/vite/sitemap-generator.d.ts +15 -0
  98. package/dist/domains/seo/vite/sitemap-generator.js +56 -0
  99. package/dist/domains/seo/vite/types.d.ts +29 -0
  100. package/dist/domains/seo/vite/types.js +4 -0
  101. package/dist/index.d.ts +8 -7
  102. package/dist/index.js +7 -6
  103. package/package.json +1 -1
@@ -0,0 +1,56 @@
1
+ /**
2
+ * Sitemap XML generation.
3
+ */
4
+ import * as fs from "fs";
5
+ import * as path from "path";
6
+ const escapeXML = (str) => str
7
+ .replace(/&/g, "&")
8
+ .replace(/</g, "&lt;")
9
+ .replace(/>/g, "&gt;")
10
+ .replace(/"/g, "&quot;")
11
+ .replace(/'/g, "&apos;");
12
+ export const generateSitemapXML = (urls) => {
13
+ const urlElements = urls
14
+ .map((url) => ` <url>
15
+ <loc>${escapeXML(url.loc)}</loc>
16
+ ${url.lastmod ? `<lastmod>${url.lastmod}</lastmod>` : ""}
17
+ ${url.changefreq ? `<changefreq>${url.changefreq}</changefreq>` : ""}
18
+ ${url.priority !== undefined ? `<priority>${url.priority}</priority>` : ""}
19
+ </url>`)
20
+ .join("\n");
21
+ return `<?xml version="1.0" encoding="UTF-8"?>
22
+ <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
23
+ ${urlElements}
24
+ </urlset>`;
25
+ };
26
+ /**
27
+ * Walk the build output and collect every directory that produced an
28
+ * `index.html`. Each one becomes a sitemap entry.
29
+ */
30
+ export const discoverRoutesFromBuild = (outDir) => {
31
+ const routes = new Set("/");
32
+ const traverse = (dir, basePath = "") => {
33
+ let files;
34
+ try {
35
+ files = fs.readdirSync(dir);
36
+ }
37
+ catch (error) {
38
+ if (error.code !== "ENOENT") {
39
+ console.warn(`[vite-plugin-seo] Could not traverse ${dir}:`, error);
40
+ }
41
+ return;
42
+ }
43
+ for (const file of files) {
44
+ const fullPath = path.join(dir, file);
45
+ const stat = fs.statSync(fullPath);
46
+ if (stat.isDirectory()) {
47
+ traverse(fullPath, path.join(basePath, file));
48
+ }
49
+ else if (file === "index.html") {
50
+ routes.add(basePath || "/");
51
+ }
52
+ }
53
+ };
54
+ traverse(outDir);
55
+ return Array.from(routes);
56
+ };
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Public types for the Vite plugin.
3
+ */
4
+ export interface ViteSEOPluginOptions {
5
+ /** Base URL of your site (e.g., https://example.com) */
6
+ siteUrl: string;
7
+ /** Array of routes to include in sitemap */
8
+ routes?: string[];
9
+ /** Automatically discover routes from build output */
10
+ discoverRoutes?: boolean;
11
+ /** Sitemap options */
12
+ sitemap?: {
13
+ filename?: string;
14
+ changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
15
+ priority?: number;
16
+ lastmod?: string;
17
+ };
18
+ /** Robots.txt options */
19
+ robotsTxt?: {
20
+ filename?: string;
21
+ userAgent?: string | Record<string, string[]>;
22
+ disallow?: string | string[];
23
+ allow?: string | string[];
24
+ sitemap?: string;
25
+ crawlDelay?: number;
26
+ };
27
+ /** Suppress console output */
28
+ silent?: boolean;
29
+ }
@@ -0,0 +1,4 @@
1
+ /**
2
+ * Public types for the Vite plugin.
3
+ */
4
+ export {};
package/dist/index.d.ts CHANGED
@@ -3,10 +3,11 @@ export { JsonLd } from "./domains/seo/components/JsonLd.js";
3
3
  export { useSEO } from "./domains/seo/hooks/useSEO.js";
4
4
  export { useJsonLd } from "./domains/seo/hooks/useJsonLd.js";
5
5
  export { initSEO } from "./domains/seo/core/init.js";
6
- export { updateSEO, clearSEO, getCurrentSEOState } from "./domains/seo/utils/dom.js";
7
- export { generateArticleSchema, generateProductSchema, generateOrganizationSchema, generateLocalBusinessSchema, generateBreadcrumbSchema, generateFAQSchema, generateWebSiteSchema, generatePersonSchema, generateVideoSchema, } from "./domains/seo/utils/schema-generators/schema.js";
8
- export { validateSEO, auditSEO, isValidUrl, validateUrl, validateTitleLength, validateDescriptionLength, validateOpenGraphImage, validateHreflangEntry, truncateForSEO, generateSlug, } from "./domains/seo/utils/validation/validators.js";
9
- export { renderSEO, generateHead, extractSEOData, hydrateSEO, renderAsHelmet, } from "./domains/seo/ssr/renderer.js";
10
- export { serializeSEO, deserializeSEO, serializeSEOToBase64, deserializeSEOFromBase64, compressSEO, serializeSEOToQueryString, deserializeSEOFromQueryString, safeDeserializeSEO, } from "./domains/seo/ssr/serializer.js";
11
- export type { MetaTag, LinkTag, ScriptTag, SEOptions, SEOConfig, RobotsMeta, RobotsDirective, HreflangEntry, PreloadHint, PreconnectOrigin, DnsPrefetchDomain, ArticleMeta, ProductMeta, BreadcrumbItem, OpenGraphImage, SEOValidationResult, } from "./domains/seo/types/index.js";
12
- export type { JsonLdTypes, ArticleJsonLd, ProductJsonLd, OrganizationJsonLd, LocalBusinessJsonLd, BreadcrumbJsonLd, FAQJsonLd, WebSiteJsonLd, PersonJsonLd, VideoJsonLd, SchemaType, SchemaGeneratorOptions, } from "./domains/seo/types/schema.js";
6
+ export { updateSEO, clearSEO, getCurrentSEOState } from "./domains/seo/utils/dom/index.js";
7
+ export { generateArticleSchema, generateProductSchema, generateOrganizationSchema, generateLocalBusinessSchema, generateBreadcrumbSchema, generateFAQSchema, generateWebSiteSchema, generatePersonSchema, generateVideoSchema, generateCourseSchema, schemaFactory, } from "./domains/seo/utils/schema-generators/index.js";
8
+ export { validateSEO, auditSEO, isValidUrl, validateUrl, validateTitleLength, validateDescriptionLength, validateOpenGraphImage, validateHreflangEntry, truncateToTitle, truncateToDescription, generateSlug, } from "./domains/seo/utils/validation/index.js";
9
+ export { renderSEO, generateHead, extractSEOData, hydrateSEO, renderAsHelmet, serializeSEO, deserializeSEO, serializeSEOToBase64, deserializeSEOFromBase64, safeDeserializeSEO, } from "./domains/seo/ssr/index.js";
10
+ export type { MetaTag, LinkTag, SEOptions, SEOConfig, RobotsMeta, RobotsDirective, HreflangEntry, PreloadHint, PreconnectOrigin, DnsPrefetchDomain, ArticleMeta, ProductMeta, BreadcrumbItem, OpenGraphImage, SEOValidationResult, } from "./domains/seo/types/index.js";
11
+ export type { JsonLdTypes, ArticleJsonLd, ProductJsonLd, OrganizationJsonLd, LocalBusinessJsonLd, BreadcrumbJsonLd, FAQJsonLd, WebSiteJsonLd, PersonJsonLd, VideoJsonLd, CourseJsonLd, CourseInstance, SchemaType, SchemaGeneratorOptions, } from "./domains/seo/types/schema.js";
12
+ export type { ArticleSchemaInput, ProductSchemaInput, OrganizationSchemaInput, LocalBusinessSchemaInput, FAQItemInput, WebSiteSchemaInput, PersonSchemaInput, VideoSchemaInput, CourseSchemaInput, CourseInstanceInput, } from "./domains/seo/utils/schema-generators/types.js";
13
+ export type { SchemaKind } from "./domains/seo/utils/schema-generators/factory.js";
package/dist/index.js CHANGED
@@ -8,10 +8,11 @@ export { JsonLd } from "./domains/seo/components/JsonLd.js";
8
8
  export { useSEO } from "./domains/seo/hooks/useSEO.js";
9
9
  export { useJsonLd } from "./domains/seo/hooks/useJsonLd.js";
10
10
  export { initSEO } from "./domains/seo/core/init.js";
11
- // Utils
12
- export { updateSEO, clearSEO, getCurrentSEOState } from "./domains/seo/utils/dom.js";
13
- export { generateArticleSchema, generateProductSchema, generateOrganizationSchema, generateLocalBusinessSchema, generateBreadcrumbSchema, generateFAQSchema, generateWebSiteSchema, generatePersonSchema, generateVideoSchema, } from "./domains/seo/utils/schema-generators/schema.js";
14
- export { validateSEO, auditSEO, isValidUrl, validateUrl, validateTitleLength, validateDescriptionLength, validateOpenGraphImage, validateHreflangEntry, truncateForSEO, generateSlug, } from "./domains/seo/utils/validation/validators.js";
11
+ // DOM operations
12
+ export { updateSEO, clearSEO, getCurrentSEOState } from "./domains/seo/utils/dom/index.js";
13
+ // Schema generators
14
+ export { generateArticleSchema, generateProductSchema, generateOrganizationSchema, generateLocalBusinessSchema, generateBreadcrumbSchema, generateFAQSchema, generateWebSiteSchema, generatePersonSchema, generateVideoSchema, generateCourseSchema, schemaFactory, } from "./domains/seo/utils/schema-generators/index.js";
15
+ // Validators + text helpers
16
+ export { validateSEO, auditSEO, isValidUrl, validateUrl, validateTitleLength, validateDescriptionLength, validateOpenGraphImage, validateHreflangEntry, truncateToTitle, truncateToDescription, generateSlug, } from "./domains/seo/utils/validation/index.js";
15
17
  // SSR
16
- export { renderSEO, generateHead, extractSEOData, hydrateSEO, renderAsHelmet, } from "./domains/seo/ssr/renderer.js";
17
- export { serializeSEO, deserializeSEO, serializeSEOToBase64, deserializeSEOFromBase64, compressSEO, serializeSEOToQueryString, deserializeSEOFromQueryString, safeDeserializeSEO, } from "./domains/seo/ssr/serializer.js";
18
+ export { renderSEO, generateHead, extractSEOData, hydrateSEO, renderAsHelmet, serializeSEO, deserializeSEO, serializeSEOToBase64, deserializeSEOFromBase64, safeDeserializeSEO, } from "./domains/seo/ssr/index.js";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@umituz/web-seo",
3
- "version": "2.0.21",
3
+ "version": "2.1.0",
4
4
  "description": "Comprehensive SEO solution for React Vite applications with structured data, performance hints, and build-time optimization",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",