next-md-negotiate 1.1.0 → 1.1.2

package/README.md

@@ -28,7 +28,7 @@ No new URLs. No duplicate routing. The client just sets an `Accept` header.
 npm install next-md-negotiate
 ```
 
-> Or run `npx next-md-negotiate init` to scaffold the files below automatically.
+> To scaffold everything automatically, run `npx next-md-negotiate init`.
 
 ## Quick start
 
@@ -293,13 +293,13 @@ React component that renders a `<script type="text/llms.txt">` tag to help LLM a
 
 | Prop | Type | Default | Description |
 |---|---|---|---|
-| `message` | `string` | `'This page is available as clean Markdown...'` | The hint text inside the script tag |
+| `message` | `string` | `'You are viewing the HTML version of this page...'` | The hint text inside the script tag |
 
 ### CLI commands
 
 | Command | Description |
 |---|---|
-| `next-md-negotiate init` | Scaffold route handler, config file, and rewrites |
+| `next-md-negotiate init` | Scaffold route handler, config file, and rewrites. Offers to add LLM hints when routes are already defined. Pass `--add-hints` to skip the prompt. |
 | `next-md-negotiate add-hints` | Inject `LlmHint` into page files for all configured routes |
 | `next-md-negotiate remove-hints` | Remove `LlmHint` from page files for all configured routes |
 

package/dist/cli.js

@@ -491,6 +491,23 @@ var x = class {
     }
   }
 };
+var kt = class extends x {
+  get cursor() {
+    return this.value ? 0 : 1;
+  }
+  get _value() {
+    return this.cursor === 0;
+  }
+  constructor(e2) {
+    super(e2, false), this.value = !!e2.initialValue, this.on("userInput", () => {
+      this.value = this._value;
+    }), this.on("confirm", (s) => {
+      this.output.write(import_sisteransi.cursor.move(0, -1)), this.value = s, this.state = "submit", this.close();
+    }), this.on("cursor", () => {
+      this.value = !this.value;
+    });
+  }
+};
 var Wt = class extends x {
   constructor(e2) {
     super(e2, false);
@@ -781,6 +798,33 @@ var X2 = (t) => {
   for (const A of f) for (const w of A) B2.push(w);
   return h && B2.push(g), B2;
 };
+var Re = (t) => {
+  const r = t.active ?? "Yes", s = t.inactive ?? "No";
+  return new kt({ active: r, inactive: s, signal: t.signal, input: t.input, output: t.output, initialValue: t.initialValue ?? true, render() {
+    const i = t.withGuide ?? _.withGuide, a = `${i ? `${import_picocolors.default.gray(d)}
+` : ""}${W2(this.state)}  ${t.message}
+`, o = this.value ? r : s;
+    switch (this.state) {
+      case "submit": {
+        const u = i ? `${import_picocolors.default.gray(d)}  ` : "";
+        return `${a}${u}${import_picocolors.default.dim(o)}`;
+      }
+      case "cancel": {
+        const u = i ? `${import_picocolors.default.gray(d)}  ` : "";
+        return `${a}${u}${import_picocolors.default.strikethrough(import_picocolors.default.dim(o))}${i ? `
+${import_picocolors.default.gray(d)}` : ""}`;
+      }
+      default: {
+        const u = i ? `${import_picocolors.default.cyan(d)}  ` : "", l = i ? import_picocolors.default.cyan(x2) : "";
+        return `${a}${u}${this.value ? `${import_picocolors.default.green(Q2)} ${r}` : `${import_picocolors.default.dim(H2)} ${import_picocolors.default.dim(r)}`}${t.vertical ? i ? `
+${import_picocolors.default.cyan(d)}  ` : `
+` : ` ${import_picocolors.default.dim("/")} `}${this.value ? `${import_picocolors.default.dim(H2)} ${import_picocolors.default.dim(s)}` : `${import_picocolors.default.green(Q2)} ${s}`}
+${l}
+`;
+      }
+    }
+  } }).prompt();
+};
 var R2 = { message: (t = [], { symbol: r = import_picocolors.default.gray(d), secondarySymbol: s = import_picocolors.default.gray(d), output: i = process.stdout, spacing: a = 1, withGuide: o } = {}) => {
   const u = [], l = o ?? _.withGuide, n = l ? s : "", c = l ? `${r}  ` : "", g = l ? `${s}  ` : "";
   for (let p = 0; p < a; p++) u.push(n);
@@ -1223,6 +1267,35 @@ export const mdConfig = [
   // }),
 ];
 `;
+function applyHints(cwd, project, mdConfigPath) {
+  const configContent = readFileSync2(mdConfigPath, "utf-8");
+  const defaultHintText = extractDefaultHintText(configContent);
+  const entries = extractConfigEntries(configContent);
+  if (entries.length === 0) {
+    logWarn("No createMdVersion() entries found in config.");
+    return;
+  }
+  for (const entry of entries) {
+    if (entry.skipHint) {
+      logWarn(`Skipped ${entry.pattern} (skipHint: true)`);
+      continue;
+    }
+    const pageFile = resolvePageFile(cwd, entry.pattern, project.useSrc, project.hasAppDir);
+    if (!pageFile) {
+      logWarn(`Could not find page file for pattern: ${entry.pattern}`);
+      continue;
+    }
+    const content = readFileSync2(pageFile, "utf-8");
+    const hintText = entry.hintText ?? defaultHintText;
+    const updated = injectLlmHint(content, hintText);
+    if (updated === null) {
+      logWarn(`Skipped ${pageFile.replace(cwd + "/", "")} (already has LlmHint)`);
+      continue;
+    }
+    writeFileSync2(pageFile, updated);
+    logSuccess(`Injected LlmHint into ${pageFile.replace(cwd + "/", "")}`);
+  }
+}
 async function runInit(args) {
   const flags = new Set(args);
   const cwd = process.cwd();
@@ -1248,6 +1321,7 @@ async function runInit(args) {
     );
     process.exit(1);
   }
+  let configExisted = false;
   try {
     if (project.hasAppDir) {
       const appDir = join4(cwd, project.useSrc ? "src" : "", "app");
@@ -1275,6 +1349,7 @@ async function runInit(args) {
     const configPath = join4(project.configDir, "md.config.ts");
     if (existsSync3(configPath)) {
       logWarn("Skipped md.config.ts (already exists)");
+      configExisted = true;
     } else {
       writeFileSync2(configPath, MD_CONFIG);
       logSuccess("Created md.config.ts");
@@ -1316,7 +1391,28 @@ async function runInit(args) {
   } else {
     printGenericInstructions();
   }
-  logInfo("Define your routes in md.config.ts");
+  if (flags.has("--add-hints")) {
+    const mdConfigPath = findMdConfig(cwd, project.configDir);
+    if (mdConfigPath) applyHints(cwd, project, mdConfigPath);
+  } else if (isTTY && configExisted) {
+    const mdConfigPath = findMdConfig(cwd, project.configDir);
+    if (mdConfigPath) {
+      const configContent = readFileSync2(mdConfigPath, "utf-8");
+      const entries = extractConfigEntries(configContent);
+      if (entries.length > 0) {
+        const shouldAddHints = await Re({
+          message: "Add LlmHint to your pages for LLM discoverability?",
+          initialValue: false
+        });
+        if (!Ct(shouldAddHints) && shouldAddHints) {
+          applyHints(cwd, project, mdConfigPath);
+        }
+      }
+    }
+  }
+  if (!configExisted) {
+    logInfo("Define your routes in md.config.ts, then run 'npx next-md-negotiate add-hints' for LLM discoverability.");
+  }
   if (isTTY) Le("You're all set!");
 }
 async function runAddHints() {
@@ -1333,33 +1429,7 @@ async function runAddHints() {
     logError("Error: Could not find md.config.ts or md.config.js. Run 'next-md-negotiate init' first.");
     process.exit(1);
   }
-  const configContent = readFileSync2(mdConfigPath, "utf-8");
-  const defaultHintText = extractDefaultHintText(configContent);
-  const entries = extractConfigEntries(configContent);
-  if (entries.length === 0) {
-    logWarn("No createMdVersion() entries found in config.");
-    return;
-  }
-  for (const entry of entries) {
-    if (entry.skipHint) {
-      logWarn(`Skipped ${entry.pattern} (skipHint: true)`);
-      continue;
-    }
-    const pageFile = resolvePageFile(cwd, entry.pattern, project.useSrc, project.hasAppDir);
-    if (!pageFile) {
-      logWarn(`Could not find page file for pattern: ${entry.pattern}`);
-      continue;
-    }
-    const content = readFileSync2(pageFile, "utf-8");
-    const hintText = entry.hintText ?? defaultHintText;
-    const updated = injectLlmHint(content, hintText);
-    if (updated === null) {
-      logWarn(`Skipped ${pageFile.replace(cwd + "/", "")} (already has LlmHint)`);
-      continue;
-    }
-    writeFileSync2(pageFile, updated);
-    logSuccess(`Injected LlmHint into ${pageFile.replace(cwd + "/", "")}`);
-  }
+  applyHints(cwd, project, mdConfigPath);
 }
 async function runRemoveHints() {
   const cwd = process.cwd();

package/dist/index.cjs

@@ -213,7 +213,7 @@ function createNegotiatorFromConfig(handlers, options) {
 
 // src/LlmHint.ts
 var import_react = require("react");
-var DEFAULT_MESSAGE = "This page is available as clean Markdown.\nRe-request this URL with the header: Accept: text/markdown";
+var DEFAULT_MESSAGE = "You are viewing the HTML version of this page. A structured markdown version is available and is significantly smaller and easier to parse. To receive the markdown version, re-request this exact URL with the HTTP header `Accept: text/markdown`. Other pages on this site may also support this content negotiation.";
 function LlmHint(props) {
   return (0, import_react.createElement)("script", {
     type: "text/llms.txt",

package/dist/index.js

@@ -180,7 +180,7 @@ function createNegotiatorFromConfig(handlers, options) {
 
 // src/LlmHint.ts
 import { createElement } from "react";
-var DEFAULT_MESSAGE = "This page is available as clean Markdown.\nRe-request this URL with the header: Accept: text/markdown";
+var DEFAULT_MESSAGE = "You are viewing the HTML version of this page. A structured markdown version is available and is significantly smaller and easier to parse. To receive the markdown version, re-request this exact URL with the HTTP header `Accept: text/markdown`. Other pages on this site may also support this content negotiation.";
 function LlmHint(props) {
   return createElement("script", {
     type: "text/llms.txt",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "next-md-negotiate",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Content negotiation for Next.js - serve Markdown to LLMs, HTML to browsers, from a single URL",
   "type": "module",
   "exports": {