nuxt-llms 0.0.2 → 0.1.1

package/README.md

@@ -1,3 +1,5 @@
+![nuxt-llms-social-card](https://github.com/user-attachments/assets/4570398c-0e49-4199-bc30-ab72f6680f4b)
+
 # Nuxt LLMs
 
 [![npm version][npm-version-src]][npm-version-href]
@@ -14,7 +16,7 @@ Nuxt LLMs automatically generates [`llms.txt` markdown documentation](https://ll
 ## Features
 
 - Generates & prerenders `/llms.txt` automatically
-- Generate & prerenders `/llms_full.txt` when enabled
+- Generate & prerenders `/llms-full.txt` when enabled
 - Customizable sections directly from your `nuxt.config.ts`
 - Integrates with Nuxt modules and your application via the runtime hooks system
 
@@ -81,10 +83,10 @@ That's it! You can visit `/llms.txt` to see the generated documentation ✨
     - `title`(required): The title of the link
     - `description`: The description of the link
     - `href`(required): The href of the link
-- `notes`: The notes of the documentation. Notes are a special section which always appears at the end of the documentation. Notes are usefull to add any information about the application or documentation itself.
-- `full`: The `llms_full.txt` configuration. Setting this option will enable the `llms_full.txt` route.
-  - `title`: The title of the llms_full documentation
-  - `description`: The description of the llms_full documentation
+- `notes`: The notes of the documentation. Notes are a special section which always appears at the end of the documentation. Notes are useful to add any information about the application or documentation itself.
+- `full`: The `llms-full.txt` configuration. Setting this option will enable the `llms-full.txt` route.
+  - `title`: The title of the llms-full documentation
+  - `description`: The description of the llms-full documentation
 
 ## Documentation Formats
 
@@ -99,11 +101,11 @@ The `/llms.txt` route generates a concise, structured documentation that follows
 - Links with titles, descriptions, and URLs
 - Optional notes section
 
-### llms_full.txt
+### llms-full.txt
 
-The `/llms_full.txt` route provides a more detailed, free-form documentation format. This is useful to reduce crawler traffic on your application and provide a more detailed documentation to your users and LLMs.
+The `/llms-full.txt` route provides a more detailed, free-form documentation format. This is useful to reduce crawler traffic on your application and provide a more detailed documentation to your users and LLMs.
 
-By default module does not generate the `llms_full.txt` route, you need to enable it by setting `full.title` and `full.description` in your `nuxt.config.ts`.
+By default module does not generate the `llms-full.txt` route, you need to enable it by setting `full.title` and `full.description` in your `nuxt.config.ts`.
 
 ```ts
 export default defineNuxtConfig({
@@ -124,7 +126,7 @@ The module provides a hooks system that allows you to dynamically extend both do
 
 ### Available Hooks
 
-#### `generate:llms(event, options)`
+#### `llms:generate(event, options)`
 
 This hook is called for every request to `/llms.txt`. Use this hook to modify the structured documentation, It allows you to add sections, links, and metadata.
 
@@ -133,9 +135,9 @@ This hook is called for every request to `/llms.txt`. Use this hook to modify th
   - `options`: ModuleOptions - The module options that you can modify to add sections, links, etc.
 
 
-#### `generate:llms_full(event, options, contents)`
+#### `llms:generate:llms-full(event, options, contents)`
 
-This hook is called for every request to `/llms_full.txt`. It allows you to add custom content sections in any format.
+This hook is called for every request to `/llms-full.txt`. It allows you to add custom content sections in any format.
 
 **Parameters:**
   - `event`: H3Event - The current request event
@@ -148,11 +150,9 @@ Create a server plugin in your `server/plugins` directory:
 
 ```ts
 // server/plugins/llms.ts
-import { onLLMsGenerate, onLLMsGenerateFull, llmsHooks } from 'nuxt-llms/runtime'
-
-export default defineNitroPlugin(() => {
+export default defineNitroPlugin((nitroApp) => {
   // Method 1: Using the hooks directly
-  llmsHooks.hook('generate', (event, options) => {
+  nitroApp.hooks.hook('llms:generate', (event, options) => {
     // Add a new section to llms.txt
     options.sections.push({
       title: 'API Documentation',
@@ -168,8 +168,8 @@ export default defineNitroPlugin(() => {
   })
 
   // Method 2: Using the helper function
-  onLLMsGenerateFull((event, options, contents) => {
-    // Add detailed documentation to llms_full.txt
+  nitroApp.hooks.hook('llms:generate:full', (event, options, contents) => {
+    // Add detailed documentation to llms-full.txt
     contents.push(`## API Authentication
 
 ### Bearer Token
@@ -197,8 +197,8 @@ If you're developing a Nuxt module that needs to extend the LLMs documentation:
 1. Create a server plugin in your module:
 ```ts
 // module/runtime/server/plugins/my-module-llms.ts
-export default defineNitroPlugin(() => {
-  onLLMsGenerate((event, options) => {
+export default defineNitroPlugin((nitroApp) => {
+  nitroApp.hooks.hook('llms:generate', (event, options) => {
     options.sections.push({
       title: 'My Module',
       description: 'Documentation for my module features',
@@ -221,6 +221,29 @@ export default defineNuxtModule({
 })
 ```
 
+## Integrations
+
+### Nuxt Content
+
+Nuxt Content ^3.2.0 comes with built-in support for LLMs documentation. You can use `nuxt-llms` with `@nuxt/content` to efficiently write content and documentation for your website and generate LLM-friendly documentation without extra effort. Content module uses `nuxt-llms` hooks and automatically adds all your contents into `llms.txt` and `llms-full.txt` documentation.
+
+All you need is to install both modules and write your content files in the `content` directory.
+
+```ts
+export default defineNuxtConfig({
+  modules: ['nuxt-llms', '@nuxt/content'],
+  llms: {
+    domain: 'https://example.com',
+    title: 'My Application',
+    description: 'My Application Description',
+  },
+})
+```
+
+Checkout the [Nuxt Content documentation](https://content.nuxt.com/docs/usage/content-pages) for more information on how to write your content files.
+
+And checkout the [Nuxt Content llms documentation](https://content.nuxt.com/docs/advanced/llms) for more information on how to customize LLMs contents with `nuxt-llms` and `@nuxt/content`.
+
 ## 💻 Development
 
 - Clone repository

package/dist/module.d.mts

@@ -1,32 +1,7 @@
 import * as _nuxt_schema from '@nuxt/schema';
-
-interface LLMsSection {
-    title: string;
-    description?: string;
-    links?: Array<{
-        title: string;
-        description?: string;
-        href: string;
-    }>;
-}
-interface ModuleOptions {
-    /**
-     * Domain of the documentation
-     */
-    domain: string;
-    /**
-     * Enable the full documentation
-     */
-    full?: {
-        title: string;
-        description: string;
-    };
-    sections: Array<LLMsSection>;
-    title?: string;
-    description?: string;
-    notes?: string[];
-}
+import { ModuleOptions } from '../dist/runtime/types.js';
+export * from '../dist/runtime/types.js';
 
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
-export { type LLMsSection, type ModuleOptions, _default as default };
+export { _default as default };

package/dist/module.d.ts

@@ -1,32 +1,7 @@
 import * as _nuxt_schema from '@nuxt/schema';
-
-interface LLMsSection {
-    title: string;
-    description?: string;
-    links?: Array<{
-        title: string;
-        description?: string;
-        href: string;
-    }>;
-}
-interface ModuleOptions {
-    /**
-     * Domain of the documentation
-     */
-    domain: string;
-    /**
-     * Enable the full documentation
-     */
-    full?: {
-        title: string;
-        description: string;
-    };
-    sections: Array<LLMsSection>;
-    title?: string;
-    description?: string;
-    notes?: string[];
-}
+import { ModuleOptions } from '../dist/runtime/types.js';
+export * from '../dist/runtime/types.js';
 
 declare const _default: _nuxt_schema.NuxtModule<ModuleOptions, ModuleOptions, false>;
 
-export { type LLMsSection, type ModuleOptions, _default as default };
+export { _default as default };

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "Nuxt LLMS",
   "configKey": "llms",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "2.0.0"

package/dist/module.mjs

@@ -30,12 +30,12 @@ const module = defineNuxtModule({
           {
             title: options.full.title,
             description: options.full.description,
-            href: `${options.domain}/llms_full.txt`
+            href: `${options.domain}/llms-full.txt`
           }
         ]
       });
-      addServerHandler({ route: "/llms_full.txt", handler: resolve("./runtime/server/routes/llms_full.txt.get") });
-      addPrerenderRoutes("/llms_full.txt");
+      addServerHandler({ route: "/llms-full.txt", handler: resolve("./runtime/server/routes/llms-full.txt.get") });
+      addPrerenderRoutes("/llms-full.txt");
     }
   }
 });

package/dist/runtime/server/routes/{llms_full.txt.get.js → llms-full.txt.get.js}

@@ -1,20 +1,12 @@
 import { eventHandler, setHeader } from "h3";
 import { llmsHooks } from "nuxt-llms/runtime";
-import { useRuntimeConfig } from "#imports";
+import { useRuntimeConfig, useNitroApp } from "#imports";
 export default eventHandler(async (event) => {
   const options = useRuntimeConfig(event).llms;
   const contents = [];
   const llms = JSON.parse(JSON.stringify(options));
+  await useNitroApp().hooks.callHook("llms:generate:full", event, llms, contents);
   await llmsHooks.callHook("generate:full", event, llms, contents);
-  const document = [
-    `# ${llms.full?.title || "Documentation"}`
-  ];
-  if (llms.description) {
-    document.push(`> ${llms.full?.description}`);
-  }
-  for (const content of contents) {
-    document.push(content);
-  }
-  setHeader(event, "Content-Type", "text/plain");
+  setHeader(event, "Content-Type", "text/plain; charset=utf-8");
   return contents.join("\n\n");
 });

package/dist/runtime/server/routes/llms.txt.get.js

@@ -1,9 +1,10 @@
 import { eventHandler, setHeader } from "h3";
 import { llmsHooks } from "nuxt-llms/runtime";
-import { useRuntimeConfig } from "#imports";
+import { useRuntimeConfig, useNitroApp } from "#imports";
 export default eventHandler(async (event) => {
   const options = useRuntimeConfig(event).llms;
   const llms = JSON.parse(JSON.stringify(options));
+  await useNitroApp().hooks.callHook("llms:generate", event, llms);
   await llmsHooks.callHook("generate", event, llms);
   const document = [
     `# ${llms.title || "Documentation"}`
@@ -28,6 +29,6 @@ export default eventHandler(async (event) => {
       (options.notes || []).map((note) => `- ${note}`).join("\n")
     );
   }
-  setHeader(event, "Content-Type", "text/plain");
+  setHeader(event, "Content-Type", "text/plain; charset=utf-8");
   return document.join("\n\n");
 });

package/dist/runtime/server/utils/hooks.d.ts

@@ -1,15 +1,26 @@
 import type { H3Event } from 'h3';
 import type { ModuleOptions } from 'nuxt-llms';
+import type { NitroRuntimeHooks } from 'nitropack/types';
+/**
+ * @deprecated Custom hooks are deprecated in favor of NitroRuntimeHooks.
+ */
 export interface LLMSHooks {
     'generate': (event: H3Event, options: ModuleOptions) => void;
     'generate:full': (event: H3Event, options: ModuleOptions, contents: string[]) => void;
 }
+/**
+ * @deprecated Custom hooks are deprecated in favor of NitroRuntimeHooks.
+ */
 export declare const llmsHooks: import("hookable").Hookable<LLMSHooks, import("hookable").HookKeys<LLMSHooks>>;
 /**
  * Run a callback when LLMs is being generated.
+ *
+ * @deprecated Use `useNitroApp().hooks.hook('llms:generate', (event, options) => {})` instead
  */
-export declare function onLLMsGenerate(cb: LLMSHooks['generate']): () => void;
+export declare function onLLMsGenerate(cb: NitroRuntimeHooks['llms:generate']): any;
 /**
  * Run a callback when Full LLMs is being generated.
+ *
+ * @deprecated Use `useNitroApp().hooks.hook('llms:generate:full', (event, options, contents) => {})` instead
  */
-export declare function onLLMsGenerateFull(cb: LLMSHooks['generate:full']): () => void;
+export declare function onLLMsGenerateFull(cb: NitroRuntimeHooks['llms:generate:full']): any;

package/dist/runtime/server/utils/hooks.js

@@ -1,8 +1,12 @@
 import { createHooks } from "hookable";
+import { useNitroApp } from "#imports";
 export const llmsHooks = createHooks();
+llmsHooks.beforeEach(() => {
+  console.warn("[nuxt-llms] `llmsHooks` are deprecated and will be removed in future versions. Use `useNitroApp().hooks.hook('llms:generate', (event, options) => {})` instead");
+});
 export function onLLMsGenerate(cb) {
-  return llmsHooks.hook("generate", cb);
+  return useNitroApp().hooks.hook("llms:generate", cb);
 }
 export function onLLMsGenerateFull(cb) {
-  return llmsHooks.hook("generate:full", cb);
+  return useNitroApp().hooks.hook("llms:generate:full", cb);
 }

package/dist/runtime/types.d.ts

@@ -0,0 +1,33 @@
+import type { H3Event } from 'h3';
+declare module 'nitropack/types' {
+    interface NitroRuntimeHooks {
+        'llms:generate': (event: H3Event, options: ModuleOptions) => void;
+        'llms:generate:full': (event: H3Event, options: ModuleOptions, contents: string[]) => void;
+    }
+}
+export interface LLMsSection {
+    title: string;
+    description?: string;
+    links?: Array<{
+        title: string;
+        description?: string;
+        href: string;
+    }>;
+}
+export interface ModuleOptions {
+    /**
+     * Domain of the documentation
+     */
+    domain: string;
+    /**
+     * Enable the full documentation
+     */
+    full?: {
+        title: string;
+        description: string;
+    };
+    sections: Array<LLMsSection>;
+    title?: string;
+    description?: string;
+    notes?: string[];
+}

package/dist/types.d.mts

@@ -1 +1,7 @@
-export { type LLMsSection, type ModuleOptions, default } from './module.js'
+import type { NuxtModule } from '@nuxt/schema'
+
+import type { default as Module } from './module.js'
+
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
+
+export { default } from './module.js'

package/dist/types.d.ts

@@ -1 +1,7 @@
-export { type LLMsSection, type ModuleOptions, default } from './module'
+import type { NuxtModule } from '@nuxt/schema'
+
+import type { default as Module } from './module'
+
+export type ModuleOptions = typeof Module extends NuxtModule<infer O> ? Partial<O> : Record<string, any>
+
+export { default } from './module'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-llms",
-  "version": "0.0.2",
+  "version": "0.1.1",
   "description": "Generate llms.txt documentation for your Nuxt application",
   "repository": {
     "type": "git",
@@ -10,7 +10,7 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/types.d.ts",
+      "types": "./dist/module.d.ts",
       "import": "./dist/module.mjs",
       "require": "./dist/module.cjs"
     },
@@ -21,7 +21,7 @@
     }
   },
   "main": "./dist/module.cjs",
-  "types": "./dist/types.d.ts",
+  "types": "./dist/module.d.ts",
   "files": [
     "dist"
   ],
@@ -39,22 +39,22 @@
     "verify": "npm run dev:prepare && npm run lint && npm run test && npm run typecheck"
   },
   "dependencies": {
-    "@nuxt/kit": "^3.15.4"
+    "@nuxt/kit": "^3.16.1"
   },
   "devDependencies": {
     "nuxt-llms": "link:.",
-    "@nuxt/devtools": "^2.1.0",
-    "@nuxt/eslint-config": "^1.1.0",
+    "@nuxt/devtools": "^2.3.1",
+    "@nuxt/eslint-config": "^1.2.0",
     "@nuxt/module-builder": "^0.8.4",
-    "@nuxt/schema": "^3.15.4",
-    "@nuxt/test-utils": "^3.15.4",
+    "@nuxt/schema": "^3.16.1",
+    "@nuxt/test-utils": "^3.17.2",
     "@types/node": "latest",
-    "changelogen": "^0.5.7",
-    "eslint": "^9.20.1",
-    "nuxt": "^3.15.4",
+    "changelogen": "^0.6.1",
+    "eslint": "^9.23.0",
+    "nuxt": "^3.16.1",
     "typescript": "~5.6.0",
-    "vitest": "^3.0.6",
+    "vitest": "^3.0.9",
     "vue-tsc": "^2.2.2"
   },
-  "packageManager": "pnpm@10.4.1"
+  "packageManager": "pnpm@10.6.5"
 }

package/dist/runtime/server/tsconfig.json

@@ -1,3 +0,0 @@
-{
-  "extends": "../../../.nuxt/tsconfig.server.json",
-}