@nuasite/llm-enhancements 0.0.57 → 0.0.60

package/dist/types/types.d.ts

@@ -7,12 +7,30 @@ export interface PageMarkdownOptions {
     includeFrontmatter?: boolean;
     /** Enable /.well-known/llm.md endpoint (default: true) */
     llmEndpoint?: boolean | LlmEndpointOptions;
+    /** Enable /llms.txt endpoint (default: true) */
+    llmsTxt?: boolean | LlmsTxtOptions;
 }
 export interface LlmEndpointOptions {
     /** Site name override */
     siteName?: string;
     /** Site description override */
     description?: string;
+    /** Base URL override (defaults to Astro's site config) */
+    baseUrl?: string;
+    /** Additional content to append */
+    additionalContent?: string;
+}
+export interface LlmsTxtOptions {
+    /** Site name override */
+    siteName?: string;
+    /** Site description override */
+    description?: string;
+    /** Base URL override (defaults to Astro's site config) */
+    baseUrl?: string;
+    /** Whether crawling is allowed (default: true) */
+    allowCrawling?: boolean;
+    /** Custom instructions for LLMs */
+    instructions?: string;
     /** Additional content to append */
     additionalContent?: string;
 }
@@ -29,6 +47,7 @@ export interface ResolvedOptions {
     includeStaticPages: boolean;
     includeFrontmatter: boolean;
     llmEndpoint: false | LlmEndpointOptions;
+    llmsTxt: false | LlmsTxtOptions;
 }
 export declare function resolveOptions(options?: PageMarkdownOptions): ResolvedOptions;
 //# sourceMappingURL=types.d.ts.map

package/dist/types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IACnC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAA;CAC1C;AAED,MAAM,WAAW,kBAAkB;IAClC,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,WAAW,EAAE,KAAK,GAAG,kBAAkB,CAAA;CACvC;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,mBAAwB,GAAG,eAAe,CAQjF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IACnC,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,0DAA0D;IAC1D,WAAW,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAA;IAC1C,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,GAAG,cAAc,CAAA;CAClC;AAED,MAAM,WAAW,kBAAkB;IAClC,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,kDAAkD;IAClD,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,mCAAmC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,mCAAmC;IACnC,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,cAAc;IAC9B,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB,EAAE,OAAO,CAAA;IAC3B,kBAAkB,EAAE,OAAO,CAAA;IAC3B,WAAW,EAAE,KAAK,GAAG,kBAAkB,CAAA;IACvC,OAAO,EAAE,KAAK,GAAG,cAAc,CAAA;CAC/B;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE,mBAAwB,GAAG,eAAe,CAUjF"}

package/package.json

@@ -7,14 +7,14 @@
     "README.md",
     "package.json"
   ],
-  "homepage": "https://github.com/nuasite/nuasite/blob/main/packages/page-markdown/README.md",
+  "homepage": "https://github.com/nuasite/nuasite/blob/main/packages/llm-enhancements/README.md",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/nuasite/nuasite.git",
-    "directory": "packages/page-markdown"
+    "directory": "packages/llm-enhancements"
   },
   "license": "Apache-2.0",
-  "version": "0.0.57",
+  "version": "0.0.60",
   "module": "src/index.ts",
   "types": "src/index.ts",
   "type": "module",
@@ -28,7 +28,7 @@
   "peerDependencies": {
     "typescript": "^5",
     "vite": "^6",
-    "@nuasite/cms-marker": "0.0.57"
+    "@nuasite/cms-marker": "0.0.60"
   },
   "peerDependenciesMeta": {
     "@nuasite/cms-marker": {

package/src/build-processor.ts

@@ -54,6 +54,7 @@ export async function processBuildOutput(
 					url: pagePath,
 					type: 'collection',
 					sourcePath: content.file,
+					baseUrl,
 				}, options.includeFrontmatter)
 
 				await writeMarkdownFile(mdPath, markdown)
@@ -80,6 +81,7 @@ export async function processBuildOutput(
 			const markdown = generateMarkdown(output, {
 				url: pagePath,
 				type: 'static',
+				baseUrl,
 			}, options.includeFrontmatter)
 
 			await writeMarkdownFile(mdPath, markdown)

package/src/dev-middleware.ts

@@ -17,6 +17,7 @@ async function generateMarkdownForPath(
 	pagePath: string,
 	host: string,
 	options: ResolvedOptions,
+	baseUrl: string,
 ): Promise<string | null> {
 	// Try collection page first
 	const content = await getCollectionContent(pagePath, options.contentDir)
@@ -26,6 +27,7 @@ async function generateMarkdownForPath(
 			url: pagePath,
 			type: 'collection',
 			sourcePath: content.file,
+			baseUrl,
 		}, options.includeFrontmatter)
 	}
 
@@ -50,6 +52,7 @@ async function generateMarkdownForPath(
 	return generateMarkdown(output, {
 		url: pagePath,
 		type: 'static',
+		baseUrl,
 	}, options.includeFrontmatter)
 }
 
@@ -137,7 +140,7 @@ export function createDevMiddleware(server: ViteDevServer, options: ResolvedOpti
 				res.end(content)
 				return
 			} catch (error) {
-				console.error('[page-markdown] Error generating llms.txt:', error)
+				console.error('[llm-enhancements] Error generating llms.txt:', error)
 			}
 
 			return next()
@@ -164,7 +167,7 @@ export function createDevMiddleware(server: ViteDevServer, options: ResolvedOpti
 				res.end(markdown)
 				return
 			} catch (error) {
-				console.error('[page-markdown] Error generating llm.md:', error)
+				console.error('[llm-enhancements] Error generating llm.md:', error)
 			}
 
 			return next()
@@ -183,7 +186,7 @@ export function createDevMiddleware(server: ViteDevServer, options: ResolvedOpti
 
 		try {
 			const host = req.headers.host || 'localhost:4321'
-			const markdown = await generateMarkdownForPath(pagePath, host, options)
+			const markdown = await generateMarkdownForPath(pagePath, host, options, baseUrl)
 
 			if (markdown) {
 				res.setHeader('Content-Type', 'text/markdown; charset=utf-8')
@@ -192,7 +195,7 @@ export function createDevMiddleware(server: ViteDevServer, options: ResolvedOpti
 				return
 			}
 		} catch (error) {
-			console.error('[page-markdown] Error generating markdown:', error)
+			console.error('[llm-enhancements] Error generating markdown:', error)
 		}
 
 		return next()

package/src/index.ts

@@ -8,14 +8,15 @@ export default function pageMarkdown(options: PageMarkdownOptions = {}): AstroIn
 	let config: AstroConfig
 
 	return {
-		name: 'astro-page-markdown',
+		name: 'astro-llm-enhancements',
 		hooks: {
 			'astro:config:done': ({ config: cfg }) => {
 				config = cfg
 			},
 
 			'astro:server:setup': ({ server, logger }) => {
-				createDevMiddleware(server, resolvedOptions, config)
+				// Cast needed due to Astro's bundled Vite types differing from root vite
+				createDevMiddleware(server as unknown as Parameters<typeof createDevMiddleware>[0], resolvedOptions, config)
 				logger.info('Markdown endpoints enabled')
 			},
 

package/src/markdown-generator.ts

@@ -62,6 +62,8 @@ export interface GenerateOptions {
 	type: 'collection' | 'static'
 	/** Path to source file (for collections) */
 	sourcePath?: string
+	/** Base URL for absolute URL generation (e.g., https://example.com) */
+	baseUrl?: string
 }
 
 /**
@@ -77,9 +79,11 @@ export function generateMarkdown(
 	}
 
 	// Build frontmatter with metadata
+	// Use absolute URL if baseUrl is provided, otherwise use relative path
+	const absoluteUrl = options.baseUrl ? `${options.baseUrl}${options.url}` : options.url
 	const frontmatter: Record<string, unknown> = {
 		...output.frontmatter,
-		url: options.url,
+		url: absoluteUrl,
 		type: options.type,
 		generatedAt: new Date().toISOString(),
 	}