@van1s1mys/ai-router-plugin-next 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,70 @@
+# @van1s1mys/ai-router-plugin-next
+
+Next.js plugin for [@van1s1mys/ai-router](https://www.npmjs.com/package/@van1s1mys/ai-router) — wraps the webpack plugin with Next.js-specific defaults.
+
+Auto-scans `app/`, `pages/`, `src/app/`, `src/pages/` and excludes Next.js internals (layouts, loading states, API routes, etc.).
+
+## Install
+
+```bash
+npm install @van1s1mys/ai-router @van1s1mys/ai-router-plugin-next
+```
+
+## Setup
+
+```ts
+// next.config.ts
+import { withAiRouter } from '@van1s1mys/ai-router-plugin-next';
+
+export default withAiRouter({
+  // your Next.js config
+});
+```
+
+```ts
+// app/providers.tsx
+import { SmartRouter } from '@van1s1mys/ai-router';
+import { routes } from 'virtual:ai-router';
+
+const router = new SmartRouter({ routes });
+await router.ready;
+
+const result = await router.search('how much does it cost?');
+```
+
+## Options
+
+```ts
+withAiRouter(nextConfig, {
+  // Override scan directories
+  dirs: ['src/app'],
+
+  // Additional exclusions (merged with Next.js defaults)
+  exclude: ['admin/'],
+
+  // Manual routes merged with scanned ones
+  routes: [
+    { path: '/pricing', title: 'Pricing', description: 'cost, plans, billing' },
+  ],
+});
+```
+
+### Default exclusions
+
+The plugin automatically excludes Next.js internal files:
+
+`_app`, `_document`, `_error`, `layout`, `loading`, `error`, `not-found`, `template`, `default`, `icon`, `apple-icon`, `opengraph-image`, `twitter-image`, `sitemap`, `robots`, `manifest`, `middleware`, `instrumentation`, `global-error`, `route`, `__tests__`, `.test.`, `.spec.`, `api/`
+
+## Route annotations
+
+Add `@ai-route` comments to page files for richer metadata:
+
+```tsx
+// @ai-route title="Pricing" description="plans, cost, billing, subscription"
+
+export default function PricingPage() { ... }
+```
+
+## License
+
+[MIT](../../LICENSE) © [IvanMalkS](https://github.com/IvanMalkS)

package/dist/index.cjs

@@ -74,4 +74,3 @@ function withAiRouter(nextConfig = {}, options) {
 0 && (module.exports = {
   withAiRouter
 });
-//# sourceMappingURL=index.cjs.map

package/dist/index.js

@@ -49,4 +49,3 @@ function withAiRouter(nextConfig = {}, options) {
 export {
   withAiRouter
 };
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,41 +1,41 @@
-{
-  "name": "@van1s1mys/ai-router-plugin-next",
-  "version": "1.0.0",
-  "description": "Next.js plugin for ai-router — auto-scan app/pages dirs and generate route config",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "import": {
-        "types": "./dist/index.d.ts",
-        "default": "./dist/index.js"
-      },
-      "require": {
-        "types": "./dist/index.d.cts",
-        "default": "./dist/index.cjs"
-      }
-    }
-  },
-  "files": [
-    "dist"
-  ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  },
-  "keywords": [
-    "next",
-    "nextjs",
-    "ai-router"
-  ],
-  "license": "MIT",
-  "dependencies": {
-    "@ai-router/shared": "workspace:*",
-    "@van1s1mys/ai-router-plugin-webpack": "workspace:*"
-  },
-  "peerDependencies": {
-    "next": ">=13.0.0"
-  }
-}
+{
+  "name": "@van1s1mys/ai-router-plugin-next",
+  "version": "1.1.0",
+  "description": "Next.js plugin for ai-router — auto-scan app/pages dirs and generate route config",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "keywords": [
+    "next",
+    "nextjs",
+    "ai-router"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@ai-router/shared": "workspace:*",
+    "@van1s1mys/ai-router-plugin-webpack": "workspace:*"
+  },
+  "peerDependencies": {
+    "next": ">=13.0.0"
+  }
+}

package/dist/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Next.js plugin for ai-router.\n *\n * Wraps the webpack plugin with Next.js-specific defaults —\n * automatically scans `app/`, `pages/`, `src/app/`, and `src/pages/`\n * while excluding Next.js internal files (layouts, loading states, API routes, etc.).\n *\n * @example\n * ```js\n * // next.config.js\n * const { withAiRouter } = require('ai-router-plugin-next');\n *\n * module.exports = withAiRouter({\n *   // your Next.js config\n * });\n * ```\n *\n * ```ts\n * // app/providers.tsx\n * import { routes } from 'virtual:ai-router';\n * import { SmartRouter } from 'ai-router';\n *\n * const router = new SmartRouter({ routes });\n * ```\n *\n * @module\n */\n\nimport { AiRouterPlugin } from '@van1s1mys/ai-router-plugin-webpack';\nimport type { PluginOptions } from '@ai-router/shared';\n\nexport type { PluginOptions } from '@ai-router/shared';\n\n/** Minimal webpack config shape used by Next.js. */\ninterface WebpackConfig {\n  plugins?: { apply(compiler: unknown): void }[];\n  [key: string]: unknown;\n}\n\n/** Minimal Next.js `webpack()` context. */\ninterface WebpackContext {\n  dev: boolean;\n  isServer: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Next.js configuration object.\n * Accepts any Next.js config property plus an optional `webpack` function.\n */\ninterface NextConfig {\n  webpack?: (config: WebpackConfig, context: WebpackContext) => WebpackConfig;\n  [key: string]: unknown;\n}\n\n/**\n * Wraps a Next.js config with ai-router route scanning.\n *\n * Injects the {@link AiRouterPlugin} into the webpack config with\n * sensible defaults for Next.js projects. Auto-detects standard\n * directory conventions (`app/`, `pages/`, `src/app/`, `src/pages/`)\n * and excludes framework internals.\n *\n * @param nextConfig - Your existing Next.js configuration.\n * @param options - Override scan directories, exclusions, or provide manual routes.\n *                  Defaults are merged, not replaced.\n * @returns A new Next.js config with the ai-router webpack plugin applied.\n *\n * @example\n * ```js\n * // Basic usage — auto-detects app/ and pages/ directories\n * module.exports = withAiRouter({});\n * ```\n *\n * @example\n * ```js\n * // With manual route overrides\n * module.exports = withAiRouter(nextConfig, {\n *   routes: [\n *     { path: '/pricing', title: 'Pricing', description: 'cost, plans, billing' },\n *   ],\n * });\n * ```\n *\n * @example\n * ```js\n * // Custom directories only\n * module.exports = withAiRouter(nextConfig, {\n *   dirs: ['src/app'],\n * });\n * ```\n */\nexport function withAiRouter(nextConfig: NextConfig = {}, options?: PluginOptions): NextConfig {\n  const pluginOptions: PluginOptions = {\n    dirs: ['app', 'pages', 'src/app', 'src/pages'],\n    exclude: [\n      // Next.js internal files\n      '_app',\n      '_document',\n      '_error',\n      'layout',\n      'loading',\n      'error',\n      'not-found',\n      'template',\n      'default',\n      'icon',\n      'apple-icon',\n      'opengraph-image',\n      'twitter-image',\n      'sitemap',\n      'robots',\n      'manifest',\n      'middleware',\n      'instrumentation',\n      'global-error',\n      'route',       // API routes\n      '__tests__',\n      '.test.',\n      '.spec.',\n      'api/',        // API directory\n    ],\n    ...options,\n  };\n\n  return {\n    ...nextConfig,\n    webpack(config: WebpackConfig, context: WebpackContext) {\n      config.plugins = config.plugins || [];\n      config.plugins.push(new AiRouterPlugin(pluginOptions));\n\n      if (typeof nextConfig.webpack === 'function') {\n        return nextConfig.webpack(config, context);\n      }\n\n      return config;\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BA,sCAA+B;AAgExB,SAAS,aAAa,aAAyB,CAAC,GAAG,SAAqC;AAC7F,QAAM,gBAA+B;AAAA,IACnC,MAAM,CAAC,OAAO,SAAS,WAAW,WAAW;AAAA,IAC7C,SAAS;AAAA;AAAA,MAEP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,IACF;AAAA,IACA,GAAG;AAAA,EACL;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ,QAAuB,SAAyB;AACtD,aAAO,UAAU,OAAO,WAAW,CAAC;AACpC,aAAO,QAAQ,KAAK,IAAI,+CAAe,aAAa,CAAC;AAErD,UAAI,OAAO,WAAW,YAAY,YAAY;AAC5C,eAAO,WAAW,QAAQ,QAAQ,OAAO;AAAA,MAC3C;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * Next.js plugin for ai-router.\n *\n * Wraps the webpack plugin with Next.js-specific defaults —\n * automatically scans `app/`, `pages/`, `src/app/`, and `src/pages/`\n * while excluding Next.js internal files (layouts, loading states, API routes, etc.).\n *\n * @example\n * ```js\n * // next.config.js\n * const { withAiRouter } = require('ai-router-plugin-next');\n *\n * module.exports = withAiRouter({\n *   // your Next.js config\n * });\n * ```\n *\n * ```ts\n * // app/providers.tsx\n * import { routes } from 'virtual:ai-router';\n * import { SmartRouter } from 'ai-router';\n *\n * const router = new SmartRouter({ routes });\n * ```\n *\n * @module\n */\n\nimport { AiRouterPlugin } from '@van1s1mys/ai-router-plugin-webpack';\nimport type { PluginOptions } from '@ai-router/shared';\n\nexport type { PluginOptions } from '@ai-router/shared';\n\n/** Minimal webpack config shape used by Next.js. */\ninterface WebpackConfig {\n  plugins?: { apply(compiler: unknown): void }[];\n  [key: string]: unknown;\n}\n\n/** Minimal Next.js `webpack()` context. */\ninterface WebpackContext {\n  dev: boolean;\n  isServer: boolean;\n  [key: string]: unknown;\n}\n\n/**\n * Next.js configuration object.\n * Accepts any Next.js config property plus an optional `webpack` function.\n */\ninterface NextConfig {\n  webpack?: (config: WebpackConfig, context: WebpackContext) => WebpackConfig;\n  [key: string]: unknown;\n}\n\n/**\n * Wraps a Next.js config with ai-router route scanning.\n *\n * Injects the {@link AiRouterPlugin} into the webpack config with\n * sensible defaults for Next.js projects. Auto-detects standard\n * directory conventions (`app/`, `pages/`, `src/app/`, `src/pages/`)\n * and excludes framework internals.\n *\n * @param nextConfig - Your existing Next.js configuration.\n * @param options - Override scan directories, exclusions, or provide manual routes.\n *                  Defaults are merged, not replaced.\n * @returns A new Next.js config with the ai-router webpack plugin applied.\n *\n * @example\n * ```js\n * // Basic usage — auto-detects app/ and pages/ directories\n * module.exports = withAiRouter({});\n * ```\n *\n * @example\n * ```js\n * // With manual route overrides\n * module.exports = withAiRouter(nextConfig, {\n *   routes: [\n *     { path: '/pricing', title: 'Pricing', description: 'cost, plans, billing' },\n *   ],\n * });\n * ```\n *\n * @example\n * ```js\n * // Custom directories only\n * module.exports = withAiRouter(nextConfig, {\n *   dirs: ['src/app'],\n * });\n * ```\n */\nexport function withAiRouter(nextConfig: NextConfig = {}, options?: PluginOptions): NextConfig {\n  const pluginOptions: PluginOptions = {\n    dirs: ['app', 'pages', 'src/app', 'src/pages'],\n    exclude: [\n      // Next.js internal files\n      '_app',\n      '_document',\n      '_error',\n      'layout',\n      'loading',\n      'error',\n      'not-found',\n      'template',\n      'default',\n      'icon',\n      'apple-icon',\n      'opengraph-image',\n      'twitter-image',\n      'sitemap',\n      'robots',\n      'manifest',\n      'middleware',\n      'instrumentation',\n      'global-error',\n      'route',       // API routes\n      '__tests__',\n      '.test.',\n      '.spec.',\n      'api/',        // API directory\n    ],\n    ...options,\n  };\n\n  return {\n    ...nextConfig,\n    webpack(config: WebpackConfig, context: WebpackContext) {\n      config.plugins = config.plugins || [];\n      config.plugins.push(new AiRouterPlugin(pluginOptions));\n\n      if (typeof nextConfig.webpack === 'function') {\n        return nextConfig.webpack(config, context);\n      }\n\n      return config;\n    },\n  };\n}\n"],"mappings":";AA4BA,SAAS,sBAAsB;AAgExB,SAAS,aAAa,aAAyB,CAAC,GAAG,SAAqC;AAC7F,QAAM,gBAA+B;AAAA,IACnC,MAAM,CAAC,OAAO,SAAS,WAAW,WAAW;AAAA,IAC7C,SAAS;AAAA;AAAA,MAEP;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA;AAAA,IACF;AAAA,IACA,GAAG;AAAA,EACL;AAEA,SAAO;AAAA,IACL,GAAG;AAAA,IACH,QAAQ,QAAuB,SAAyB;AACtD,aAAO,UAAU,OAAO,WAAW,CAAC;AACpC,aAAO,QAAQ,KAAK,IAAI,eAAe,aAAa,CAAC;AAErD,UAAI,OAAO,WAAW,YAAY,YAAY;AAC5C,eAAO,WAAW,QAAQ,QAAQ,OAAO;AAAA,MAC3C;AAEA,aAAO;AAAA,IACT;AAAA,EACF;AACF;","names":[]}