smart-seo-lite 1.0.0 → 2.0.0

package/dist/Breadcrumbs.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+export interface BreadcrumbItem {
+    name: string;
+    url: string;
+}
+interface BreadcrumbsProps {
+    items: BreadcrumbItem[];
+    separator?: string;
+    className?: string;
+    linkClassName?: string;
+    activeClassName?: string;
+}
+/**
+ * Breadcrumbs - Visual breadcrumb navigation that ALSO auto-injects
+ * valid BreadcrumbList JSON-LD schema. One component, two SEO wins.
+ *
+ * @example
+ * <Breadcrumbs items={[
+ *   { name: "Home", url: "/" },
+ *   { name: "Blog", url: "/blog" },
+ *   { name: "My Post", url: "/blog/my-post" },
+ * ]} />
+ */
+export declare function Breadcrumbs({ items, separator, className, linkClassName, activeClassName, }: BreadcrumbsProps): React.JSX.Element | null;
+export {};

package/dist/SEOAudit.d.ts

@@ -0,0 +1,11 @@
+import React from "react";
+/**
+ * SEOAudit - Dev-only floating widget that scans the current page
+ * and shows a live SEO score with actionable issues.
+ * Automatically disabled in production (NODE_ENV !== "development").
+ *
+ * @example
+ * // Drop it once near the root of your app
+ * <SEOAudit />
+ */
+export declare function SEOAudit(): React.JSX.Element | null;

package/dist/index.d.ts

@@ -1,4 +1,11 @@
 export { useSEO } from "./useSEO";
-export type { SEOProps } from "./useSEO";
+export type { SEOProps, AlternateLocale } from "./useSEO";
 export { Schema } from "./Schema";
 export { SEOImg } from "./SEOImg";
+export { Breadcrumbs } from "./Breadcrumbs";
+export type { BreadcrumbItem } from "./Breadcrumbs";
+export { SEOAudit } from "./SEOAudit";
+export { generateSitemap } from "./sitemap";
+export type { SitemapRoute } from "./sitemap";
+export { generateRobotsTxt } from "./robots";
+export type { RobotsOptions, RobotsRule } from "./robots";

package/dist/index.esm.js

@@ -1,4 +1,4 @@
-import React, { useEffect } from 'react';
+import React, { useEffect, useState } from 'react';
 
 function setMeta(name, content, attr = "name") {
     if (typeof document === "undefined")
@@ -22,6 +22,18 @@ function setLink(rel, href) {
     }
     el.setAttribute("href", href);
 }
+function setAlternateLink(hreflang, href) {
+    if (typeof document === "undefined")
+        return;
+    let el = document.querySelector(`link[rel="alternate"][hreflang="${hreflang}"]`);
+    if (!el) {
+        el = document.createElement("link");
+        el.setAttribute("rel", "alternate");
+        el.setAttribute("hreflang", hreflang);
+        document.head.appendChild(el);
+    }
+    el.setAttribute("href", href);
+}
 /**
  * useSEO - Automatically handles:
  * ✅ title, description
@@ -37,7 +49,8 @@ function setLink(rel, href) {
  *   image: "/banner.png"
  * });
  */
-function useSEO({ title, description, image, url, siteName = "My App", type = "website", twitterHandle, noIndex = false, canonical, keywords = [], }) {
+function useSEO({ title, description, image, url, siteName = "My App", type = "website", twitterHandle, noIndex = false, canonical, keywords = [], alternateLocales = [], }) {
+    const localesKey = alternateLocales.map((l) => `${l.locale}:${l.url}`).join(",");
     useEffect(() => {
         if (typeof document === "undefined")
             return;
@@ -75,7 +88,21 @@ function useSEO({ title, description, image, url, siteName = "My App", type = "w
         // --- Canonical ---
         if (canonicalURL)
             setLink("canonical", canonicalURL);
-    }, [title, description, image, url, siteName, type, twitterHandle, noIndex, canonical, keywords]);
+        // --- Hreflang (multilingual SEO) ---
+        alternateLocales.forEach((alt) => setAlternateLink(alt.locale, alt.url));
+    }, [
+        title,
+        description,
+        image,
+        url,
+        siteName,
+        type,
+        twitterHandle,
+        noIndex,
+        canonical,
+        keywords,
+        localesKey,
+    ]);
 }
 
 function buildSchema(type, data) {
@@ -273,4 +300,258 @@ function SEOImg(_a) {
     return (React.createElement("img", Object.assign({ src: src, alt: resolvedAlt, loading: loading === "auto" ? undefined : loading, width: width, height: height, className: className, style: style }, rest)));
 }
 
-export { SEOImg, Schema, useSEO };
+/**
+ * Breadcrumbs - Visual breadcrumb navigation that ALSO auto-injects
+ * valid BreadcrumbList JSON-LD schema. One component, two SEO wins.
+ *
+ * @example
+ * <Breadcrumbs items={[
+ *   { name: "Home", url: "/" },
+ *   { name: "Blog", url: "/blog" },
+ *   { name: "My Post", url: "/blog/my-post" },
+ * ]} />
+ */
+function Breadcrumbs({ items, separator = "/", className, linkClassName, activeClassName, }) {
+    if (!items || items.length === 0)
+        return null;
+    const schema = {
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        itemListElement: items.map((item, i) => ({
+            "@type": "ListItem",
+            position: i + 1,
+            name: item.name,
+            item: item.url,
+        })),
+    };
+    return (React.createElement(React.Fragment, null,
+        React.createElement("nav", { "aria-label": "Breadcrumb", className: className },
+            React.createElement("ol", { style: {
+                    display: "flex",
+                    flexWrap: "wrap",
+                    alignItems: "center",
+                    listStyle: "none",
+                    padding: 0,
+                    margin: 0,
+                    gap: "8px",
+                } }, items.map((item, i) => {
+                const isLast = i === items.length - 1;
+                return (React.createElement("li", { key: item.url, style: { display: "flex", alignItems: "center", gap: "8px" } },
+                    isLast ? (React.createElement("span", { "aria-current": "page", className: activeClassName }, item.name)) : (React.createElement("a", { href: item.url, className: linkClassName }, item.name)),
+                    !isLast && React.createElement("span", { "aria-hidden": "true" }, separator)));
+            }))),
+        React.createElement("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(schema) } })));
+}
+
+function runAudit() {
+    const issues = [];
+    if (typeof document === "undefined")
+        return issues;
+    // Title
+    const title = document.title;
+    if (!title) {
+        issues.push({ type: "error", message: "Missing <title> tag" });
+    }
+    else if (title.length < 10 || title.length > 60) {
+        issues.push({ type: "warning", message: `Title is ${title.length} chars (ideal: 10-60)` });
+    }
+    else {
+        issues.push({ type: "success", message: "Title length looks good" });
+    }
+    // Meta description
+    const desc = document.querySelector('meta[name="description"]');
+    if (!desc || !desc.content) {
+        issues.push({ type: "error", message: "Missing meta description" });
+    }
+    else if (desc.content.length < 50 || desc.content.length > 160) {
+        issues.push({ type: "warning", message: `Description is ${desc.content.length} chars (ideal: 50-160)` });
+    }
+    else {
+        issues.push({ type: "success", message: "Meta description length looks good" });
+    }
+    // H1 check
+    const h1s = document.querySelectorAll("h1");
+    if (h1s.length === 0) {
+        issues.push({ type: "error", message: "No <h1> found on page" });
+    }
+    else if (h1s.length > 1) {
+        issues.push({ type: "warning", message: `Found ${h1s.length} <h1> tags (should be exactly 1)` });
+    }
+    else {
+        issues.push({ type: "success", message: "Exactly one <h1> found" });
+    }
+    // Image alt text
+    const imgs = document.querySelectorAll("img");
+    const missingAlt = Array.from(imgs).filter((img) => !img.getAttribute("alt"));
+    if (missingAlt.length > 0) {
+        issues.push({ type: "error", message: `${missingAlt.length} image(s) missing alt text` });
+    }
+    else if (imgs.length > 0) {
+        issues.push({ type: "success", message: `All ${imgs.length} images have alt text` });
+    }
+    // Canonical
+    const canonical = document.querySelector('link[rel="canonical"]');
+    if (!canonical) {
+        issues.push({ type: "warning", message: "Missing canonical link" });
+    }
+    else {
+        issues.push({ type: "success", message: "Canonical URL is set" });
+    }
+    // Open Graph
+    const ogTitle = document.querySelector('meta[property="og:title"]');
+    if (!ogTitle) {
+        issues.push({ type: "warning", message: "Missing og:title (Open Graph)" });
+    }
+    else {
+        issues.push({ type: "success", message: "Open Graph tags present" });
+    }
+    // Viewport (mobile SEO)
+    const viewport = document.querySelector('meta[name="viewport"]');
+    if (!viewport) {
+        issues.push({ type: "error", message: "Missing viewport meta tag" });
+    }
+    return issues;
+}
+const colors = {
+    error: "#ff5f57",
+    warning: "#febc2e",
+    success: "#28c840",
+};
+const icons = {
+    error: "✕",
+    warning: "⚠",
+    success: "✓",
+};
+/**
+ * SEOAudit - Dev-only floating widget that scans the current page
+ * and shows a live SEO score with actionable issues.
+ * Automatically disabled in production (NODE_ENV !== "development").
+ *
+ * @example
+ * // Drop it once near the root of your app
+ * <SEOAudit />
+ */
+function SEOAudit() {
+    const [issues, setIssues] = useState([]);
+    const [open, setOpen] = useState(false);
+    useEffect(() => {
+        if (process.env.NODE_ENV !== "development")
+            return;
+        const timer = setTimeout(() => setIssues(runAudit()), 600);
+        return () => clearTimeout(timer);
+    }, []);
+    if (process.env.NODE_ENV !== "development")
+        return null;
+    if (issues.length === 0)
+        return null;
+    const errors = issues.filter((i) => i.type === "error").length;
+    const warnings = issues.filter((i) => i.type === "warning").length;
+    const score = Math.max(0, 100 - errors * 20 - warnings * 8);
+    const scoreColor = score >= 80 ? "#28c840" : score >= 50 ? "#febc2e" : "#ff5f57";
+    return (React.createElement("div", { style: {
+            position: "fixed",
+            bottom: 20,
+            right: 20,
+            zIndex: 999999,
+            fontFamily: "'JetBrains Mono', monospace",
+            fontSize: 13,
+        } },
+        open && (React.createElement("div", { style: {
+                background: "#0d1221",
+                border: "1px solid #1e2a45",
+                borderRadius: 12,
+                padding: 16,
+                width: 320,
+                marginBottom: 12,
+                boxShadow: "0 8px 32px rgba(0,0,0,0.4)",
+                maxHeight: 360,
+                overflowY: "auto",
+            } },
+            React.createElement("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", marginBottom: 12 } },
+                React.createElement("span", { style: { color: "#e8edf8", fontWeight: 700 } }, "SEO Audit"),
+                React.createElement("span", { style: { color: scoreColor, fontWeight: 700 } },
+                    score,
+                    "/100")),
+            issues.map((issue, i) => (React.createElement("div", { key: i, style: {
+                    display: "flex",
+                    gap: 8,
+                    alignItems: "flex-start",
+                    padding: "6px 0",
+                    borderTop: i === 0 ? "none" : "1px solid #1e2a45",
+                    color: "#a8b3c7",
+                    fontSize: 12,
+                    lineHeight: 1.5,
+                } },
+                React.createElement("span", { style: { color: colors[issue.type], flexShrink: 0 } }, icons[issue.type]),
+                React.createElement("span", null, issue.message)))))),
+        React.createElement("button", { onClick: () => setOpen(!open), style: {
+                background: "#0d1221",
+                border: `2px solid ${scoreColor}`,
+                borderRadius: "50%",
+                width: 56,
+                height: 56,
+                color: scoreColor,
+                fontWeight: 700,
+                fontSize: 16,
+                cursor: "pointer",
+                boxShadow: "0 4px 16px rgba(0,0,0,0.4)",
+            }, title: "smart-seo-lite SEO Audit" }, score)));
+}
+
+/**
+ * generateSitemap - Builds a valid sitemap.xml string from a list of routes.
+ * Use this in a Next.js API route, app/sitemap.xml/route.ts, or a build script.
+ *
+ * @example
+ * const xml = generateSitemap("https://myapp.com", [
+ *   { url: "/", priority: 1.0, changeFrequency: "daily" },
+ *   { url: "/about", priority: 0.8 },
+ * ]);
+ */
+function generateSitemap(baseUrl, routes) {
+    const base = baseUrl.replace(/\/$/, "");
+    const urlEntries = routes
+        .map((route) => {
+        const loc = `${base}${route.url.startsWith("/") ? "" : "/"}${route.url}`;
+        const parts = [`    <loc>${loc}</loc>`];
+        if (route.lastModified)
+            parts.push(`    <lastmod>${route.lastModified}</lastmod>`);
+        if (route.changeFrequency)
+            parts.push(`    <changefreq>${route.changeFrequency}</changefreq>`);
+        if (route.priority !== undefined)
+            parts.push(`    <priority>${route.priority}</priority>`);
+        return `  <url>\n${parts.join("\n")}\n  </url>`;
+    })
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urlEntries}\n</urlset>`;
+}
+
+/**
+ * generateRobotsTxt - Builds a valid robots.txt string.
+ * Use this in a Next.js API route, app/robots.txt/route.ts, or a build script.
+ *
+ * @example
+ * const txt = generateRobotsTxt({
+ *   disallow: ["/admin", "/api"],
+ *   sitemap: "https://myapp.com/sitemap.xml",
+ * });
+ */
+function generateRobotsTxt(options = {}) {
+    var _a;
+    const rules = ((_a = options.rules) === null || _a === void 0 ? void 0 : _a.length)
+        ? options.rules
+        : [{ userAgent: options.userAgent, allow: options.allow, disallow: options.disallow }];
+    const lines = [];
+    rules.forEach((rule) => {
+        lines.push(`User-agent: ${rule.userAgent || "*"}`);
+        (rule.allow || []).forEach((path) => lines.push(`Allow: ${path}`));
+        (rule.disallow || []).forEach((path) => lines.push(`Disallow: ${path}`));
+        lines.push("");
+    });
+    if (options.sitemap) {
+        lines.push(`Sitemap: ${options.sitemap}`);
+    }
+    return lines.join("\n").trim();
+}
+
+export { Breadcrumbs, SEOAudit, SEOImg, Schema, generateRobotsTxt, generateSitemap, useSEO };

package/dist/index.js

@@ -24,6 +24,18 @@ function setLink(rel, href) {
     }
     el.setAttribute("href", href);
 }
+function setAlternateLink(hreflang, href) {
+    if (typeof document === "undefined")
+        return;
+    let el = document.querySelector(`link[rel="alternate"][hreflang="${hreflang}"]`);
+    if (!el) {
+        el = document.createElement("link");
+        el.setAttribute("rel", "alternate");
+        el.setAttribute("hreflang", hreflang);
+        document.head.appendChild(el);
+    }
+    el.setAttribute("href", href);
+}
 /**
  * useSEO - Automatically handles:
  * ✅ title, description
@@ -39,7 +51,8 @@ function setLink(rel, href) {
  *   image: "/banner.png"
  * });
  */
-function useSEO({ title, description, image, url, siteName = "My App", type = "website", twitterHandle, noIndex = false, canonical, keywords = [], }) {
+function useSEO({ title, description, image, url, siteName = "My App", type = "website", twitterHandle, noIndex = false, canonical, keywords = [], alternateLocales = [], }) {
+    const localesKey = alternateLocales.map((l) => `${l.locale}:${l.url}`).join(",");
     React.useEffect(() => {
         if (typeof document === "undefined")
             return;
@@ -77,7 +90,21 @@ function useSEO({ title, description, image, url, siteName = "My App", type = "w
         // --- Canonical ---
         if (canonicalURL)
             setLink("canonical", canonicalURL);
-    }, [title, description, image, url, siteName, type, twitterHandle, noIndex, canonical, keywords]);
+        // --- Hreflang (multilingual SEO) ---
+        alternateLocales.forEach((alt) => setAlternateLink(alt.locale, alt.url));
+    }, [
+        title,
+        description,
+        image,
+        url,
+        siteName,
+        type,
+        twitterHandle,
+        noIndex,
+        canonical,
+        keywords,
+        localesKey,
+    ]);
 }
 
 function buildSchema(type, data) {
@@ -275,6 +302,264 @@ function SEOImg(_a) {
     return (React.createElement("img", Object.assign({ src: src, alt: resolvedAlt, loading: loading === "auto" ? undefined : loading, width: width, height: height, className: className, style: style }, rest)));
 }
 
+/**
+ * Breadcrumbs - Visual breadcrumb navigation that ALSO auto-injects
+ * valid BreadcrumbList JSON-LD schema. One component, two SEO wins.
+ *
+ * @example
+ * <Breadcrumbs items={[
+ *   { name: "Home", url: "/" },
+ *   { name: "Blog", url: "/blog" },
+ *   { name: "My Post", url: "/blog/my-post" },
+ * ]} />
+ */
+function Breadcrumbs({ items, separator = "/", className, linkClassName, activeClassName, }) {
+    if (!items || items.length === 0)
+        return null;
+    const schema = {
+        "@context": "https://schema.org",
+        "@type": "BreadcrumbList",
+        itemListElement: items.map((item, i) => ({
+            "@type": "ListItem",
+            position: i + 1,
+            name: item.name,
+            item: item.url,
+        })),
+    };
+    return (React.createElement(React.Fragment, null,
+        React.createElement("nav", { "aria-label": "Breadcrumb", className: className },
+            React.createElement("ol", { style: {
+                    display: "flex",
+                    flexWrap: "wrap",
+                    alignItems: "center",
+                    listStyle: "none",
+                    padding: 0,
+                    margin: 0,
+                    gap: "8px",
+                } }, items.map((item, i) => {
+                const isLast = i === items.length - 1;
+                return (React.createElement("li", { key: item.url, style: { display: "flex", alignItems: "center", gap: "8px" } },
+                    isLast ? (React.createElement("span", { "aria-current": "page", className: activeClassName }, item.name)) : (React.createElement("a", { href: item.url, className: linkClassName }, item.name)),
+                    !isLast && React.createElement("span", { "aria-hidden": "true" }, separator)));
+            }))),
+        React.createElement("script", { type: "application/ld+json", dangerouslySetInnerHTML: { __html: JSON.stringify(schema) } })));
+}
+
+function runAudit() {
+    const issues = [];
+    if (typeof document === "undefined")
+        return issues;
+    // Title
+    const title = document.title;
+    if (!title) {
+        issues.push({ type: "error", message: "Missing <title> tag" });
+    }
+    else if (title.length < 10 || title.length > 60) {
+        issues.push({ type: "warning", message: `Title is ${title.length} chars (ideal: 10-60)` });
+    }
+    else {
+        issues.push({ type: "success", message: "Title length looks good" });
+    }
+    // Meta description
+    const desc = document.querySelector('meta[name="description"]');
+    if (!desc || !desc.content) {
+        issues.push({ type: "error", message: "Missing meta description" });
+    }
+    else if (desc.content.length < 50 || desc.content.length > 160) {
+        issues.push({ type: "warning", message: `Description is ${desc.content.length} chars (ideal: 50-160)` });
+    }
+    else {
+        issues.push({ type: "success", message: "Meta description length looks good" });
+    }
+    // H1 check
+    const h1s = document.querySelectorAll("h1");
+    if (h1s.length === 0) {
+        issues.push({ type: "error", message: "No <h1> found on page" });
+    }
+    else if (h1s.length > 1) {
+        issues.push({ type: "warning", message: `Found ${h1s.length} <h1> tags (should be exactly 1)` });
+    }
+    else {
+        issues.push({ type: "success", message: "Exactly one <h1> found" });
+    }
+    // Image alt text
+    const imgs = document.querySelectorAll("img");
+    const missingAlt = Array.from(imgs).filter((img) => !img.getAttribute("alt"));
+    if (missingAlt.length > 0) {
+        issues.push({ type: "error", message: `${missingAlt.length} image(s) missing alt text` });
+    }
+    else if (imgs.length > 0) {
+        issues.push({ type: "success", message: `All ${imgs.length} images have alt text` });
+    }
+    // Canonical
+    const canonical = document.querySelector('link[rel="canonical"]');
+    if (!canonical) {
+        issues.push({ type: "warning", message: "Missing canonical link" });
+    }
+    else {
+        issues.push({ type: "success", message: "Canonical URL is set" });
+    }
+    // Open Graph
+    const ogTitle = document.querySelector('meta[property="og:title"]');
+    if (!ogTitle) {
+        issues.push({ type: "warning", message: "Missing og:title (Open Graph)" });
+    }
+    else {
+        issues.push({ type: "success", message: "Open Graph tags present" });
+    }
+    // Viewport (mobile SEO)
+    const viewport = document.querySelector('meta[name="viewport"]');
+    if (!viewport) {
+        issues.push({ type: "error", message: "Missing viewport meta tag" });
+    }
+    return issues;
+}
+const colors = {
+    error: "#ff5f57",
+    warning: "#febc2e",
+    success: "#28c840",
+};
+const icons = {
+    error: "✕",
+    warning: "⚠",
+    success: "✓",
+};
+/**
+ * SEOAudit - Dev-only floating widget that scans the current page
+ * and shows a live SEO score with actionable issues.
+ * Automatically disabled in production (NODE_ENV !== "development").
+ *
+ * @example
+ * // Drop it once near the root of your app
+ * <SEOAudit />
+ */
+function SEOAudit() {
+    const [issues, setIssues] = React.useState([]);
+    const [open, setOpen] = React.useState(false);
+    React.useEffect(() => {
+        if (process.env.NODE_ENV !== "development")
+            return;
+        const timer = setTimeout(() => setIssues(runAudit()), 600);
+        return () => clearTimeout(timer);
+    }, []);
+    if (process.env.NODE_ENV !== "development")
+        return null;
+    if (issues.length === 0)
+        return null;
+    const errors = issues.filter((i) => i.type === "error").length;
+    const warnings = issues.filter((i) => i.type === "warning").length;
+    const score = Math.max(0, 100 - errors * 20 - warnings * 8);
+    const scoreColor = score >= 80 ? "#28c840" : score >= 50 ? "#febc2e" : "#ff5f57";
+    return (React.createElement("div", { style: {
+            position: "fixed",
+            bottom: 20,
+            right: 20,
+            zIndex: 999999,
+            fontFamily: "'JetBrains Mono', monospace",
+            fontSize: 13,
+        } },
+        open && (React.createElement("div", { style: {
+                background: "#0d1221",
+                border: "1px solid #1e2a45",
+                borderRadius: 12,
+                padding: 16,
+                width: 320,
+                marginBottom: 12,
+                boxShadow: "0 8px 32px rgba(0,0,0,0.4)",
+                maxHeight: 360,
+                overflowY: "auto",
+            } },
+            React.createElement("div", { style: { display: "flex", alignItems: "center", justifyContent: "space-between", marginBottom: 12 } },
+                React.createElement("span", { style: { color: "#e8edf8", fontWeight: 700 } }, "SEO Audit"),
+                React.createElement("span", { style: { color: scoreColor, fontWeight: 700 } },
+                    score,
+                    "/100")),
+            issues.map((issue, i) => (React.createElement("div", { key: i, style: {
+                    display: "flex",
+                    gap: 8,
+                    alignItems: "flex-start",
+                    padding: "6px 0",
+                    borderTop: i === 0 ? "none" : "1px solid #1e2a45",
+                    color: "#a8b3c7",
+                    fontSize: 12,
+                    lineHeight: 1.5,
+                } },
+                React.createElement("span", { style: { color: colors[issue.type], flexShrink: 0 } }, icons[issue.type]),
+                React.createElement("span", null, issue.message)))))),
+        React.createElement("button", { onClick: () => setOpen(!open), style: {
+                background: "#0d1221",
+                border: `2px solid ${scoreColor}`,
+                borderRadius: "50%",
+                width: 56,
+                height: 56,
+                color: scoreColor,
+                fontWeight: 700,
+                fontSize: 16,
+                cursor: "pointer",
+                boxShadow: "0 4px 16px rgba(0,0,0,0.4)",
+            }, title: "smart-seo-lite SEO Audit" }, score)));
+}
+
+/**
+ * generateSitemap - Builds a valid sitemap.xml string from a list of routes.
+ * Use this in a Next.js API route, app/sitemap.xml/route.ts, or a build script.
+ *
+ * @example
+ * const xml = generateSitemap("https://myapp.com", [
+ *   { url: "/", priority: 1.0, changeFrequency: "daily" },
+ *   { url: "/about", priority: 0.8 },
+ * ]);
+ */
+function generateSitemap(baseUrl, routes) {
+    const base = baseUrl.replace(/\/$/, "");
+    const urlEntries = routes
+        .map((route) => {
+        const loc = `${base}${route.url.startsWith("/") ? "" : "/"}${route.url}`;
+        const parts = [`    <loc>${loc}</loc>`];
+        if (route.lastModified)
+            parts.push(`    <lastmod>${route.lastModified}</lastmod>`);
+        if (route.changeFrequency)
+            parts.push(`    <changefreq>${route.changeFrequency}</changefreq>`);
+        if (route.priority !== undefined)
+            parts.push(`    <priority>${route.priority}</priority>`);
+        return `  <url>\n${parts.join("\n")}\n  </url>`;
+    })
+        .join("\n");
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urlEntries}\n</urlset>`;
+}
+
+/**
+ * generateRobotsTxt - Builds a valid robots.txt string.
+ * Use this in a Next.js API route, app/robots.txt/route.ts, or a build script.
+ *
+ * @example
+ * const txt = generateRobotsTxt({
+ *   disallow: ["/admin", "/api"],
+ *   sitemap: "https://myapp.com/sitemap.xml",
+ * });
+ */
+function generateRobotsTxt(options = {}) {
+    var _a;
+    const rules = ((_a = options.rules) === null || _a === void 0 ? void 0 : _a.length)
+        ? options.rules
+        : [{ userAgent: options.userAgent, allow: options.allow, disallow: options.disallow }];
+    const lines = [];
+    rules.forEach((rule) => {
+        lines.push(`User-agent: ${rule.userAgent || "*"}`);
+        (rule.allow || []).forEach((path) => lines.push(`Allow: ${path}`));
+        (rule.disallow || []).forEach((path) => lines.push(`Disallow: ${path}`));
+        lines.push("");
+    });
+    if (options.sitemap) {
+        lines.push(`Sitemap: ${options.sitemap}`);
+    }
+    return lines.join("\n").trim();
+}
+
+exports.Breadcrumbs = Breadcrumbs;
+exports.SEOAudit = SEOAudit;
 exports.SEOImg = SEOImg;
 exports.Schema = Schema;
+exports.generateRobotsTxt = generateRobotsTxt;
+exports.generateSitemap = generateSitemap;
 exports.useSEO = useSEO;

package/dist/robots.d.ts

@@ -0,0 +1,20 @@
+export interface RobotsRule {
+    userAgent?: string;
+    allow?: string[];
+    disallow?: string[];
+}
+export interface RobotsOptions extends RobotsRule {
+    sitemap?: string;
+    rules?: RobotsRule[];
+}
+/**
+ * generateRobotsTxt - Builds a valid robots.txt string.
+ * Use this in a Next.js API route, app/robots.txt/route.ts, or a build script.
+ *
+ * @example
+ * const txt = generateRobotsTxt({
+ *   disallow: ["/admin", "/api"],
+ *   sitemap: "https://myapp.com/sitemap.xml",
+ * });
+ */
+export declare function generateRobotsTxt(options?: RobotsOptions): string;

package/dist/sitemap.d.ts

@@ -0,0 +1,17 @@
+export interface SitemapRoute {
+    url: string;
+    lastModified?: string;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+}
+/**
+ * generateSitemap - Builds a valid sitemap.xml string from a list of routes.
+ * Use this in a Next.js API route, app/sitemap.xml/route.ts, or a build script.
+ *
+ * @example
+ * const xml = generateSitemap("https://myapp.com", [
+ *   { url: "/", priority: 1.0, changeFrequency: "daily" },
+ *   { url: "/about", priority: 0.8 },
+ * ]);
+ */
+export declare function generateSitemap(baseUrl: string, routes: SitemapRoute[]): string;

package/dist/useSEO.d.ts

@@ -1,3 +1,9 @@
+export interface AlternateLocale {
+    /** Language/region code, e.g. "en-US", "fr", "x-default" */
+    locale: string;
+    /** Fully-qualified URL for that locale's version of the page */
+    url: string;
+}
 export interface SEOProps {
     title?: string;
     description?: string;
@@ -9,6 +15,8 @@ export interface SEOProps {
     noIndex?: boolean;
     canonical?: string;
     keywords?: string[];
+    /** Multilingual SEO: renders <link rel="alternate" hreflang="..."> for each locale */
+    alternateLocales?: AlternateLocale[];
 }
 /**
  * useSEO - Automatically handles:
@@ -25,4 +33,4 @@ export interface SEOProps {
  *   image: "/banner.png"
  * });
  */
-export declare function useSEO({ title, description, image, url, siteName, type, twitterHandle, noIndex, canonical, keywords, }: SEOProps): void;
+export declare function useSEO({ title, description, image, url, siteName, type, twitterHandle, noIndex, canonical, keywords, alternateLocales, }: SEOProps): void;

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "smart-seo-lite",
-  "version": "1.0.0",
-  "type": "module",
-  "description": "Add SEO to your React/Next.js app in 3 lines of code. Auto meta tags, JSON-LD schema, and smart image SEO.",
+  "version": "2.0.0",
+  "description": "Add SEO to your React/Next.js app in 3 lines of code. Auto meta tags, JSON-LD schema, smart image SEO, breadcrumbs, sitemap/robots.txt generators, hreflang support, and a live dev SEO audit widget.",
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
@@ -24,7 +23,13 @@
     "json-ld",
     "twitter-card",
     "canonical",
-    "image-seo"
+    "image-seo",
+    "breadcrumbs",
+    "sitemap",
+    "robots-txt",
+    "hreflang",
+    "seo-audit",
+    "core-web-vitals"
   ],
   "author": "Virendra",
   "license": "MIT",
@@ -34,10 +39,10 @@
   },
   "devDependencies": {
     "@rollup/plugin-typescript": "^11.0.0",
-    "@types/node": "^25.6.0",
-    "@types/react": "^19.2.14",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
     "rollup": "^3.0.0",
-    "tslib": "^2.8.1",
+    "tslib": "^2.6.0",
     "typescript": "^5.0.0"
   },
   "repository": {