rkk-next 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rohit Kumar Kundu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,248 @@
+# 🚀 rkk-next
+
+> **SEO, Performance & Routing SDK for Next.js**
+
+[![npm version](https://img.shields.io/npm/v/rkk-next.svg)](https://www.npmjs.com/package/rkk-next)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](./LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
+rkk-next is an opinionated Next.js SDK that helps you build **SEO-optimized**, **blazing fast**, and **scalable** applications with better routing, caching, and performance defaults.
+
+✨ **Built for Next.js Pages Router & App Router**  
+🎯 **Ideal for:** Startups, Landing Pages, Web3 Dashboards, SaaS, Hackathons
+
+## ✨ Features
+
+### 🔍 SEO Optimization
+- ✅ Centralized meta management (OpenGraph, Twitter Cards)
+- ✅ JSON-LD structured data (Schema.org)
+- ✅ Canonical URL handling
+- ✅ SEO-safe defaults & best practices
+
+### ⚡ Routing Optimization
+- ✅ Intelligent route prefetching (hover-based)
+- ✅ Network-aware prefetching
+- ✅ Route change observer with performance metrics
+- ✅ Analytics-ready routing events
+
+### 🚀 Performance Boost
+- ✅ Lazy loading for heavy components
+- ✅ Optimized image wrapper (SEO + performance)
+- ✅ Cache & CDN header presets
+- ✅ Edge-friendly caching strategies
+- ✅ Security headers included
+
+### 📊 Analytics
+- ✅ Web Vitals tracking (LCP, FID, CLS, etc.)
+- ✅ Route navigation analytics
+- ✅ Performance monitoring
+
+📦 Installation
+npm install rkk-next
+
+
+or
+
+yarn add rkk-next
+
+🧠 Basic Usage
+1️⃣ SEO Meta Manager
+import { MetaManager } from "rkk-next";
+
+export default function Home() {
+  return (
+    <>
+      <MetaManager
+        title="Home | My App"
+        description="SEO optimized Next.js app using rkk-next"
+        keywords="Next.js, SEO, Performance"
+        image="/og.png"
+        siteName="My App"
+      />
+
+      <h1>Hello World</h1>
+    </>
+  );
+}
+
+2️⃣ JSON-LD (Schema.org)
+import { JsonLd } from "rkk-next";
+
+<JsonLd
+  type="WebSite"
+  data={{
+    name: "My App",
+    url: "https://myapp.com",
+  }}
+/>
+
+🔗 Smart Routing
+SmartLink (Enhanced next/link)
+import { SmartLink } from "rkk-next";
+
+<SmartLink href="/dashboard">
+  Go to Dashboard
+</SmartLink>
+
+
+✔ Prefetch on hover
+✔ Network-aware
+✔ SEO-safe <a> tag
+
+Route Observer
+import { observeRoutes } from "rkk-next";
+
+observeRoutes((event) => {
+  console.log(event.url, event.duration);
+});
+
+🖼️ Image Optimization
+import { OptimizedImage } from "rkk-next";
+
+<OptimizedImage
+  src="/hero.png"
+  alt="Landing page hero image"
+  width={1200}
+  height={630}
+  priority
+/>
+
+
+✔ SEO-safe alt enforcement
+✔ Responsive sizes
+✔ LCP optimized
+
+💤 Lazy Loading
+import { lazyImport } from "rkk-next";
+
+const Chart = lazyImport(() => import("./Chart"));
+
+export default function Dashboard() {
+  return <Chart />;
+}
+
+🧠 Intelligent Prefetching
+import { prefetchRoute, isFastConnection } from "rkk-next";
+
+prefetchRoute("/dashboard", {
+  condition: isFastConnection,
+});
+
+🗄️ Cache Headers
+
+Use directly inside next.config.js:
+
+const {
+  LONG_TERM_CACHE,
+  EDGE_CACHE,
+  NO_CACHE,
+  applyCache,
+} = require("rkk-next");
+
+module.exports = {
+  async headers() {
+    return [
+      applyCache("/_next/static/:path*", LONG_TERM_CACHE),
+      applyCache("/api/public/:path*", EDGE_CACHE),
+      applyCache("/dashboard/:path*", NO_CACHE),
+    ];
+  },
+};
+
+## 🧩 Supported Next.js Versions
+
+| Feature           | Pages Router | App Router |
+|-------------------|--------------|------------|
+| MetaManager       | ✅          | ✅ (via generateAppMetadata) |
+| JsonLd            | ✅          | ✅         |
+| SmartLink         | ✅          | ⚠️ (use for internal links only) |
+| Routing Observer  | ✅          | ⚠️ (Pages Router recommended) |
+| OptimizedImage    | ✅          | ✅         |
+| Lazy Loading      | ✅          | ✅         |
+| Cache Headers     | ✅          | ✅         |
+| Web Vitals        | ✅          | ✅         |
+
+**Minimum Requirements:**
+- Next.js >= 12.0.0
+- React >= 17.0.0
+- TypeScript >= 4.5.0 (optional but recommended)
+🛠️ Best Practices
+
+Use MetaManager on every page
+
+Avoid lazy loading LCP elements
+
+Use SmartLink for internal navigation
+
+Enable cache headers for static assets
+
+Always provide alt text for images
+
+## 🧑‍💻 Author
+
+**Rohit Kumar Kundu**  
+🎓 B.Tech CSE | Web3 & Next.js Developer  
+🔗 [GitHub](https://github.com/ROHIT8759) | [LinkedIn](https://linkedin.com/in/rohit-kumar-kundu)
+
+## 📚 Documentation
+
+- 📖 [Full Documentation](./docs/DOCS.md)
+- 🚀 [Quick Start Guide](./docs/QUICKSTART.md)
+- 📝 [API Reference](./docs/DOCS.md#api-reference)
+- 💡 [Examples](./examples/)
+
+## 🤝 Contributing
+
+We welcome contributions! See [CONTRIBUTING.md](./docs/CONTRIBUTING.md) for guidelines.
+
+1. Fork the repository
+2. Create your feature branch (`git checkout -b feature/amazing-feature`)
+3. Commit your changes (`git commit -m 'Add amazing feature'`)
+4. Push to the branch (`git push origin feature/amazing-feature`)
+5. Open a Pull Request
+
+## 🚀 Next Steps
+
+- [ ] Add App Router `generateMetadata` helper
+- [ ] Expand Web Vitals analytics integration
+- [ ] Create demo app showcase
+- [ ] Add Lighthouse CI integration
+- [ ] Video tutorials & guides
+
+## 📄 License
+
+MIT License © 2025 [Rohit Kumar Kundu](https://github.com/ROHIT8759)
+
+Free to use, modify, and distribute. See [LICENSE](./LICENSE) for details.
+
+## ⭐ Support the Project
+
+If you find rkk-next helpful:
+
+- ⭐ **Star the repo** on GitHub
+- 🐛 **Report issues** to help improve the SDK
+- 🤝 **Contribute** with PRs and feature ideas
+- 📢 **Share** with other Next.js developers
+- 💬 **Join discussions** and share your use cases
+
+---
+
+**Made with ❤️ for the Next.js community**
+
+[Get Started](./docs/QUICKSTART.md) | [Documentation](./docs/DOCS.md) | [Examples](./examples/) | [Report Issue](https://github.com/ROHIT8759/rkk-next/issues)
+
+NPM publish
+
+If you want, I can now:
+
+✔ Review this README
+
+✔ Add badges (npm, downloads)
+
+✔ Prepare NPM publish checklist
+
+✔ Create example Next.js app
+
+✔ Final SDK audit before release
+
+Just tell me 👍

package/dist/analytics/webVitals.d.ts

@@ -0,0 +1,2 @@
+import { NextWebVitalsMetric } from "next/app";
+export declare function reportWebVitals(metric: NextWebVitalsMetric): void;

package/dist/analytics/webVitals.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportWebVitals = reportWebVitals;
+function reportWebVitals(metric) {
+    const { id, name, value } = metric;
+    console.log("[Vitals]", name, value);
+    // future: send to analytics
+}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./seo/MetaManager";
+export * from "./seo/JsonLd";
+export * from "./seo/defaults";
+export * from "./seo/appMetadata";
+export * from "./routing/SmartLink";
+export * from "./routing/prefetch";
+export * from "./routing/RouteObserver";
+export * from "./performance/ImageOptimizer";
+export * from "./performance/Lazy";
+export * from "./performance/cacheHeaders";
+export * from "./performance/securityHeaders";
+export * from "./analytics/webVitals";

package/dist/index.js

@@ -0,0 +1,32 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// SEO
+__exportStar(require("./seo/MetaManager"), exports);
+__exportStar(require("./seo/JsonLd"), exports);
+__exportStar(require("./seo/defaults"), exports);
+__exportStar(require("./seo/appMetadata"), exports);
+// Routing
+__exportStar(require("./routing/SmartLink"), exports);
+__exportStar(require("./routing/prefetch"), exports);
+__exportStar(require("./routing/RouteObserver"), exports);
+// Performance
+__exportStar(require("./performance/ImageOptimizer"), exports);
+__exportStar(require("./performance/Lazy"), exports);
+__exportStar(require("./performance/cacheHeaders"), exports);
+__exportStar(require("./performance/securityHeaders"), exports);
+// Analytics
+__exportStar(require("./analytics/webVitals"), exports);

package/dist/performance/ImageOptimizer.d.ts

@@ -0,0 +1,16 @@
+import { ImageProps } from "next/image";
+import React from "react";
+export type OptimizedImageProps = ImageProps & {
+    /** Override default quality (1–100) */
+    quality?: number;
+    /** Enable priority loading (LCP images) */
+    priority?: boolean;
+    /** Fallback alt text (SEO safety) */
+    alt: string;
+};
+/**
+ * OptimizedImage
+ * SEO-first wrapper around next/image
+ */
+export declare const OptimizedImage: React.FC<OptimizedImageProps>;
+export default OptimizedImage;

package/dist/performance/ImageOptimizer.js

@@ -0,0 +1,23 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptimizedImage = void 0;
+const image_1 = __importDefault(require("next/image"));
+const react_1 = __importDefault(require("react"));
+/**
+ * OptimizedImage
+ * SEO-first wrapper around next/image
+ */
+const OptimizedImage = ({ quality = 80, priority = false, alt, ...props }) => {
+    if (!alt) {
+        if (process.env.NODE_ENV !== "production") {
+            console.warn("[next-optimize-sdk] OptimizedImage requires alt text for SEO");
+        }
+    }
+    return (react_1.default.createElement(image_1.default, { ...props, alt: alt, quality: quality, priority: priority, loading: priority ? "eager" : "lazy", sizes: props.sizes ||
+            "(max-width: 640px) 100vw, (max-width: 1024px) 50vw, 33vw", placeholder: props.placeholder || "empty" }));
+};
+exports.OptimizedImage = OptimizedImage;
+exports.default = exports.OptimizedImage;

package/dist/performance/Lazy.d.ts

@@ -0,0 +1,19 @@
+import { Loader } from "next/dynamic";
+import React from "react";
+export type LazyOptions<P = {}> = {
+    /** Custom loading component */
+    loading?: React.ComponentType;
+    /** Enable / disable SSR */
+    ssr?: boolean;
+    /** Delay before showing loading component (ms) */
+    delay?: number;
+};
+/**
+ * Lazy-load a React component with Next.js dynamic import
+ * Optimized for performance and bundle size reduction
+ */
+export declare function lazyImport<P = {}>(loader: Loader<P>, options?: LazyOptions<P>): React.ComponentType<P>;
+/**
+ * Simple fallback loading component
+ */
+export declare const DefaultLoader: React.FC;

package/dist/performance/Lazy.js

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DefaultLoader = void 0;
+exports.lazyImport = lazyImport;
+const dynamic_1 = __importDefault(require("next/dynamic"));
+const react_1 = __importDefault(require("react"));
+/**
+ * Lazy-load a React component with Next.js dynamic import
+ * Optimized for performance and bundle size reduction
+ */
+function lazyImport(loader, options = {}) {
+    const { loading: LoadingComponent, ssr = false, delay = 200, } = options;
+    const dynamicOptions = {
+        ssr,
+        loading: LoadingComponent
+            ? () => react_1.default.createElement(LoadingComponent, null)
+            : () => null,
+    };
+    return (0, dynamic_1.default)(loader, dynamicOptions);
+}
+/**
+ * Simple fallback loading component
+ */
+const DefaultLoader = () => (react_1.default.createElement("div", { style: {
+        padding: "1rem",
+        textAlign: "center",
+        opacity: 0.7,
+        fontSize: "0.9rem",
+    } }, "Loading\u2026"));
+exports.DefaultLoader = DefaultLoader;

package/dist/performance/cacheHeaders.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Cache header presets for Next.js
+ * Centralized caching strategy for SEO & performance
+ */
+export type CacheHeader = {
+    key: string;
+    value: string;
+};
+/**
+ * Long-term cache
+ * Best for static assets (JS, CSS, fonts, images)
+ */
+export declare const LONG_TERM_CACHE: CacheHeader[];
+/**
+ * Short-term cache
+ * Best for ISR pages or frequently updated content
+ */
+export declare const SHORT_TERM_CACHE: CacheHeader[];
+/**
+ * No cache
+ * Best for dashboards, auth, user-specific pages
+ */
+export declare const NO_CACHE: CacheHeader[];
+/**
+ * Edge / CDN optimized cache
+ */
+export declare const EDGE_CACHE: CacheHeader[];
+/**
+ * Helper function to apply cache headers
+ * directly inside next.config.js
+ */
+export declare function applyCache(source: string, headers: CacheHeader[]): {
+    source: string;
+    headers: CacheHeader[];
+};

package/dist/performance/cacheHeaders.js

@@ -0,0 +1,65 @@
+"use strict";
+/**
+ * Cache header presets for Next.js
+ * Centralized caching strategy for SEO & performance
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EDGE_CACHE = exports.NO_CACHE = exports.SHORT_TERM_CACHE = exports.LONG_TERM_CACHE = void 0;
+exports.applyCache = applyCache;
+/**
+ * Long-term cache
+ * Best for static assets (JS, CSS, fonts, images)
+ */
+exports.LONG_TERM_CACHE = [
+    {
+        key: "Cache-Control",
+        value: "public, max-age=31536000, immutable",
+    },
+];
+/**
+ * Short-term cache
+ * Best for ISR pages or frequently updated content
+ */
+exports.SHORT_TERM_CACHE = [
+    {
+        key: "Cache-Control",
+        value: "public, max-age=60, stale-while-revalidate=300",
+    },
+];
+/**
+ * No cache
+ * Best for dashboards, auth, user-specific pages
+ */
+exports.NO_CACHE = [
+    {
+        key: "Cache-Control",
+        value: "no-store, no-cache, must-revalidate, proxy-revalidate",
+    },
+    {
+        key: "Pragma",
+        value: "no-cache",
+    },
+    {
+        key: "Expires",
+        value: "0",
+    },
+];
+/**
+ * Edge / CDN optimized cache
+ */
+exports.EDGE_CACHE = [
+    {
+        key: "Cache-Control",
+        value: "public, s-maxage=86400, stale-while-revalidate=604800",
+    },
+];
+/**
+ * Helper function to apply cache headers
+ * directly inside next.config.js
+ */
+function applyCache(source, headers) {
+    return {
+        source,
+        headers,
+    };
+}

package/dist/performance/securityHeaders.d.ts

@@ -0,0 +1,4 @@
+export declare const SECURITY_HEADERS: {
+    key: string;
+    value: string;
+}[];

package/dist/performance/securityHeaders.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SECURITY_HEADERS = void 0;
+exports.SECURITY_HEADERS = [
+    {
+        key: "X-Frame-Options",
+        value: "DENY",
+    },
+    {
+        key: "X-Content-Type-Options",
+        value: "nosniff",
+    },
+    {
+        key: "Referrer-Policy",
+        value: "strict-origin-when-cross-origin",
+    },
+];

package/dist/routing/RouteObserver.d.ts

@@ -0,0 +1,24 @@
+export type RouteChangeEvent = {
+    /** Current route URL */
+    url: string;
+    /** Previous route URL */
+    previousUrl: string;
+    /** Navigation duration in ms */
+    duration: number;
+    /** Timestamp when navigation finished */
+    timestamp: number;
+};
+type RouteObserverCallback = (event: RouteChangeEvent) => void;
+/**
+ * Observe Next.js route changes with performance metrics
+ */
+export declare function observeRoutes(callback: RouteObserverCallback): (() => void) | undefined;
+/**
+ * SEO helper – update document title on route change
+ */
+export declare function observeTitle(titleFormatter: (path: string) => string): void;
+/**
+ * Analytics helper – plug any analytics provider
+ */
+export declare function observeAnalytics(track: (data: RouteChangeEvent) => void): void;
+export {};

package/dist/routing/RouteObserver.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.observeRoutes = observeRoutes;
+exports.observeTitle = observeTitle;
+exports.observeAnalytics = observeAnalytics;
+const router_1 = __importDefault(require("next/router"));
+let previousUrl = "";
+let startTime = 0;
+/**
+ * Observe Next.js route changes with performance metrics
+ */
+function observeRoutes(callback) {
+    if (typeof window === "undefined")
+        return;
+    const handleStart = (url) => {
+        startTime = performance.now();
+    };
+    const handleComplete = (url) => {
+        const duration = performance.now() - startTime;
+        callback({
+            url,
+            previousUrl,
+            duration,
+            timestamp: Date.now(),
+        });
+        previousUrl = url;
+    };
+    router_1.default.events.on("routeChangeStart", handleStart);
+    router_1.default.events.on("routeChangeComplete", handleComplete);
+    return () => {
+        router_1.default.events.off("routeChangeStart", handleStart);
+        router_1.default.events.off("routeChangeComplete", handleComplete);
+    };
+}
+/**
+ * SEO helper – update document title on route change
+ */
+function observeTitle(titleFormatter) {
+    if (typeof window === "undefined")
+        return;
+    observeRoutes(({ url }) => {
+        document.title = titleFormatter(url);
+    });
+}
+/**
+ * Analytics helper – plug any analytics provider
+ */
+function observeAnalytics(track) {
+    observeRoutes(track);
+}

package/dist/routing/SmartLink.d.ts

@@ -0,0 +1,17 @@
+import { LinkProps } from "next/link";
+import React, { AnchorHTMLAttributes } from "react";
+type AnchorProps = AnchorHTMLAttributes<HTMLAnchorElement>;
+export type SmartLinkProps = LinkProps & AnchorProps & {
+    /** Enable intelligent prefetching */
+    prefetchOnHover?: boolean;
+    /** Delay before prefetch (ms) */
+    prefetchDelay?: number;
+    /** Disable prefetch completely */
+    disablePrefetch?: boolean;
+};
+/**
+ * SmartLink
+ * SEO-safe, accessibility-friendly, and performance-optimized
+ */
+export declare const SmartLink: React.FC<SmartLinkProps>;
+export default SmartLink;

package/dist/routing/SmartLink.js

@@ -0,0 +1,62 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartLink = void 0;
+const link_1 = __importDefault(require("next/link"));
+const react_1 = __importStar(require("react"));
+const prefetch_1 = require("./prefetch");
+/**
+ * SmartLink
+ * SEO-safe, accessibility-friendly, and performance-optimized
+ */
+const SmartLink = ({ href, children, prefetchOnHover = true, prefetchDelay = 150, disablePrefetch = false, onMouseEnter, ...props }) => {
+    const handleMouseEnter = (0, react_1.useCallback)((e) => {
+        onMouseEnter === null || onMouseEnter === void 0 ? void 0 : onMouseEnter(e);
+        if (disablePrefetch || !prefetchOnHover)
+            return;
+        if (typeof href === "string" && (0, prefetch_1.isFastConnection)()) {
+            (0, prefetch_1.prefetchRoute)(href, {
+                delay: prefetchDelay,
+            });
+        }
+    }, [href, disablePrefetch, prefetchOnHover, prefetchDelay, onMouseEnter]);
+    return (react_1.default.createElement(link_1.default, { href: href, passHref: true, legacyBehavior: true },
+        react_1.default.createElement("a", { ...props, onMouseEnter: handleMouseEnter }, children)));
+};
+exports.SmartLink = SmartLink;
+exports.default = exports.SmartLink;

package/dist/routing/prefetch.d.ts

@@ -0,0 +1,25 @@
+type PrefetchOptions = {
+    /** Enable or disable prefetch globally */
+    enabled?: boolean;
+    /** Delay before prefetch starts (ms) */
+    delay?: number;
+    /** Only prefetch when user is idle */
+    idleOnly?: boolean;
+    /** Custom condition (e.g. network check) */
+    condition?: () => boolean;
+};
+/**
+ * Intelligent route prefetching for Next.js
+ * Prefetches routes when user intent is detected
+ */
+export declare function prefetchRoute(href: string, options?: PrefetchOptions): void;
+/**
+ * Prefetch multiple routes safely
+ */
+export declare function prefetchRoutes(routes: string[], options?: PrefetchOptions): void;
+/**
+ * Network-aware prefetch condition
+ * Prevents prefetch on slow connections
+ */
+export declare function isFastConnection(): boolean;
+export {};

package/dist/routing/prefetch.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prefetchRoute = prefetchRoute;
+exports.prefetchRoutes = prefetchRoutes;
+exports.isFastConnection = isFastConnection;
+const router_1 = __importDefault(require("next/router"));
+/**
+ * Intelligent route prefetching for Next.js
+ * Prefetches routes when user intent is detected
+ */
+function prefetchRoute(href, options = {}) {
+    const { enabled = true, delay = 200, idleOnly = true, condition, } = options;
+    if (!enabled)
+        return;
+    if (typeof window === "undefined")
+        return;
+    if (condition && !condition())
+        return;
+    const startPrefetch = () => {
+        try {
+            router_1.default.prefetch(href);
+        }
+        catch (err) {
+            console.warn("[next-optimize-sdk] Prefetch failed:", err);
+        }
+    };
+    if (idleOnly && "requestIdleCallback" in window) {
+        window.requestIdleCallback(() => {
+            setTimeout(startPrefetch, delay);
+        });
+    }
+    else {
+        setTimeout(startPrefetch, delay);
+    }
+}
+/**
+ * Prefetch multiple routes safely
+ */
+function prefetchRoutes(routes, options) {
+    routes.forEach((route) => prefetchRoute(route, options));
+}
+/**
+ * Network-aware prefetch condition
+ * Prevents prefetch on slow connections
+ */
+function isFastConnection() {
+    if (typeof navigator === "undefined")
+        return true;
+    const connection = navigator.connection ||
+        navigator.mozConnection ||
+        navigator.webkitConnection;
+    if (!connection)
+        return true;
+    return !["slow-2g", "2g"].includes(connection.effectiveType);
+}

package/dist/seo/JsonLd.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+export type JsonLdProps<T extends object> = {
+    /** Schema.org type (e.g. WebSite, Article, Product, FAQPage) */
+    type: string;
+    /** Schema data object */
+    data: T;
+    /** Optional ID for deduplication */
+    id?: string;
+};
+/**
+ * Generic JSON-LD injector for Next.js
+ * Safe for SSR, SEO-compliant, and reusable
+ */
+export declare function JsonLd<T extends object>({ type, data, id, }: JsonLdProps<T>): React.JSX.Element | null;
+export default JsonLd;

package/dist/seo/JsonLd.js

@@ -0,0 +1,26 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonLd = JsonLd;
+const head_1 = __importDefault(require("next/head"));
+const react_1 = __importDefault(require("react"));
+/**
+ * Generic JSON-LD injector for Next.js
+ * Safe for SSR, SEO-compliant, and reusable
+ */
+function JsonLd({ type, data, id, }) {
+    if (!data)
+        return null;
+    const jsonLd = {
+        "@context": "https://schema.org",
+        "@type": type,
+        ...data,
+    };
+    return (react_1.default.createElement(head_1.default, null,
+        react_1.default.createElement("script", { id: id, type: "application/ld+json", dangerouslySetInnerHTML: {
+                __html: JSON.stringify(jsonLd),
+            } })));
+}
+exports.default = JsonLd;

package/dist/seo/MetaManager.d.ts

@@ -0,0 +1,25 @@
+import React from "react";
+export type MetaManagerProps = {
+    /** Page title */
+    title: string;
+    /** Meta description (important for SEO) */
+    description: string;
+    /** Optional keywords */
+    keywords?: string;
+    /** Canonical URL (auto-generated if not provided) */
+    canonicalUrl?: string;
+    /** Open Graph image URL */
+    image?: string;
+    /** Open Graph type */
+    type?: "website" | "article";
+    /** Robots meta */
+    noIndex?: boolean;
+    /** Site name for Open Graph */
+    siteName?: string;
+    /** Author name */
+    author?: string;
+    /** Twitter username (without @) */
+    twitterHandle?: string;
+};
+export declare const MetaManager: React.FC<MetaManagerProps>;
+export default MetaManager;

package/dist/seo/MetaManager.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetaManager = void 0;
+const head_1 = __importDefault(require("next/head"));
+const router_1 = require("next/router");
+const react_1 = __importDefault(require("react"));
+const MetaManager = ({ title, description, keywords, canonicalUrl, image, type = "website", noIndex = false, siteName = "My Website", author, twitterHandle, }) => {
+    const router = (0, router_1.useRouter)();
+    // Auto canonical URL fallback
+    const canonical = canonicalUrl ||
+        (typeof window !== "undefined"
+            ? `${window.location.origin}${router.asPath}`
+            : "");
+    return (react_1.default.createElement(head_1.default, null,
+        react_1.default.createElement("title", null, title),
+        react_1.default.createElement("meta", { name: "description", content: description }),
+        keywords && react_1.default.createElement("meta", { name: "keywords", content: keywords }),
+        author && react_1.default.createElement("meta", { name: "author", content: author }),
+        react_1.default.createElement("meta", { name: "robots", content: noIndex ? "noindex, nofollow" : "index, follow" }),
+        canonical && react_1.default.createElement("link", { rel: "canonical", href: canonical }),
+        react_1.default.createElement("meta", { property: "og:type", content: type }),
+        react_1.default.createElement("meta", { property: "og:title", content: title }),
+        react_1.default.createElement("meta", { property: "og:description", content: description }),
+        react_1.default.createElement("meta", { property: "og:site_name", content: siteName }),
+        canonical && react_1.default.createElement("meta", { property: "og:url", content: canonical }),
+        image && react_1.default.createElement("meta", { property: "og:image", content: image }),
+        react_1.default.createElement("meta", { name: "twitter:card", content: "summary_large_image" }),
+        twitterHandle && (react_1.default.createElement("meta", { name: "twitter:site", content: `@${twitterHandle}` })),
+        react_1.default.createElement("meta", { name: "twitter:title", content: title }),
+        react_1.default.createElement("meta", { name: "twitter:description", content: description }),
+        image && react_1.default.createElement("meta", { name: "twitter:image", content: image }),
+        react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1" }),
+        react_1.default.createElement("meta", { name: "theme-color", content: "#000000" })));
+};
+exports.MetaManager = MetaManager;
+exports.default = exports.MetaManager;

package/dist/seo/appMetadata.d.ts

@@ -0,0 +1,13 @@
+export declare function generateAppMetadata({ title, description, image, }: {
+    title?: string;
+    description?: string;
+    image?: string;
+}): {
+    title: string;
+    description: string;
+    openGraph: {
+        title: string | undefined;
+        description: string | undefined;
+        images: string[];
+    };
+};

package/dist/seo/appMetadata.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAppMetadata = generateAppMetadata;
+const defaults_1 = require("./defaults");
+function generateAppMetadata({ title, description, image, }) {
+    return {
+        title: title || defaults_1.SEO_DEFAULTS.defaultTitle,
+        description: description || defaults_1.SEO_DEFAULTS.defaultDescription,
+        openGraph: {
+            title,
+            description,
+            images: image ? [image] : [],
+        },
+    };
+}

package/dist/seo/defaults.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Global SEO defaults for next-optimize-sdk
+ * These values can be overridden per page using MetaManager
+ */
+export type SeoDefaults = {
+    siteName: string;
+    titleTemplate: string;
+    defaultTitle: string;
+    defaultDescription: string;
+    defaultKeywords: string;
+    defaultImage: string;
+    siteUrl: string;
+    twitterHandle?: string;
+    themeColor?: string;
+};
+/**
+ * Default SEO configuration
+ * Override this in your app if needed
+ */
+export declare const SEO_DEFAULTS: SeoDefaults;
+/**
+ * Helper to generate full title using template
+ */
+export declare function getSeoTitle(title?: string, template?: string): string;
+/**
+ * Helper to generate canonical URL
+ */
+export declare function getCanonicalUrl(path: string): string;
+/**
+ * Merge custom SEO config with defaults
+ */
+export declare function mergeSeoDefaults(overrides?: Partial<SeoDefaults>): SeoDefaults;

package/dist/seo/defaults.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Global SEO defaults for next-optimize-sdk
+ * These values can be overridden per page using MetaManager
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SEO_DEFAULTS = void 0;
+exports.getSeoTitle = getSeoTitle;
+exports.getCanonicalUrl = getCanonicalUrl;
+exports.mergeSeoDefaults = mergeSeoDefaults;
+/**
+ * Default SEO configuration
+ * Override this in your app if needed
+ */
+exports.SEO_DEFAULTS = {
+    siteName: "My Website",
+    titleTemplate: "%s | My Website",
+    defaultTitle: "My Website",
+    defaultDescription: "A modern, fast, and SEO-optimized Next.js application.",
+    defaultKeywords: "Next.js, SEO, Web Performance, React, Optimization",
+    defaultImage: "/og-image.png",
+    siteUrl: "https://example.com",
+    twitterHandle: "",
+    themeColor: "#000000",
+};
+/**
+ * Helper to generate full title using template
+ */
+function getSeoTitle(title, template = exports.SEO_DEFAULTS.titleTemplate) {
+    if (!title)
+        return exports.SEO_DEFAULTS.defaultTitle;
+    return template.replace("%s", title);
+}
+/**
+ * Helper to generate canonical URL
+ */
+function getCanonicalUrl(path) {
+    if (!path.startsWith("/"))
+        path = `/${path}`;
+    return `${exports.SEO_DEFAULTS.siteUrl}${path}`;
+}
+/**
+ * Merge custom SEO config with defaults
+ */
+function mergeSeoDefaults(overrides = {}) {
+    return {
+        ...exports.SEO_DEFAULTS,
+        ...overrides,
+    };
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "rkk-next",
+  "version": "1.0.0",
+  "description": "SEO, routing and performance optimization SDK for Next.js",
+  "author": "Rohit Kumar Kundu",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ROHIT8759/rkk-next.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ROHIT8759/rkk-next/issues"
+  },
+  "homepage": "https://github.com/ROHIT8759/rkk-next#readme",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Tests coming soon\" && exit 0"
+  },
+  "peerDependencies": {
+    "next": ">=12",
+    "react": ">=17",
+    "react-dom": ">=17"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/react": "^18.2.45",
+    "@types/react-dom": "^18.2.18",
+    "typescript": "^5.3.3"
+  },
+  "keywords": [
+    "nextjs",
+    "seo",
+    "performance",
+    "routing",
+    "optimization",
+    "web-vitals",
+    "sdk",
+    "rkk-next",
+    "react",
+    "meta-tags",
+    "json-ld",
+    "prefetch"
+  ]
+}