@nuasite/cli 0.16.1 → 0.17.1

package/README.md

@@ -32,10 +32,36 @@ bunx nua build
 }
 ```
 
-`nua-build` runs `astro build` with the default Nua configuration (currently the
+`nua build` runs `astro build` with the default Nua configuration (currently the
 agent summary integration) and surfaces errors with inline source excerpts so
 you can diagnose failures quickly.
 
+### `nua clean`
+
+Ejects your project from the Nua toolchain back to a standard Astro setup:
+
+```bash
+nua clean            # interactive — previews changes, asks for confirmation
+nua clean --dry-run  # show what would change without writing files
+nua clean --yes      # skip confirmation prompt
+```
+
+This rewrites your Astro config and `package.json` so the project no longer
+depends on `@nuasite/*` tooling packages. Specifically it:
+
+- Replaces `@nuasite/nua` with explicit Astro integrations (`mdx`, `sitemap`,
+  `tailwindcss`)
+- Removes `@nuasite/*` tooling dependencies and adds their standard Astro
+  equivalents
+- Updates scripts (`nua build` → `astro build`, etc.)
+- Keeps runtime packages (e.g. `@nuasite/components`) if your source files
+  import them
+- Respects disabled features — if a feature is set to `false` in your Nua
+  config, it will be omitted from the ejected config
+
+After running, follow the printed next-steps: `bun install`, review the
+config, and remove any remaining `@nuasite` tooling imports from source files.
+
 ## Programmatic usage
 
 You can also drive the builder yourself if you need to supply a custom inline

package/dist/index.js

@@ -1,5 +1,381 @@
 #!/usr/bin/env bun
 // @bun
+var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+
+// src/utils.ts
+import { existsSync } from "fs";
+import { join } from "path";
+function findAstroConfig(cwd = process.cwd()) {
+  for (const name of CONFIG_NAMES) {
+    const p = join(cwd, name);
+    if (existsSync(p))
+      return p;
+  }
+  return null;
+}
+var CONFIG_NAMES;
+var init_utils = __esm(() => {
+  CONFIG_NAMES = [
+    "astro.config.ts",
+    "astro.config.mts",
+    "astro.config.mjs",
+    "astro.config.js"
+  ];
+});
+
+// src/clean.ts
+var exports_clean = {};
+__export(exports_clean, {
+  transformPackageJson: () => transformPackageJson,
+  transformConfig: () => transformConfig,
+  removeProperty: () => removeProperty,
+  extractConfigBody: () => extractConfigBody,
+  detectDisabledFeatures: () => detectDisabledFeatures,
+  clean: () => clean
+});
+import { existsSync as existsSync2, readdirSync, readFileSync, writeFileSync } from "fs";
+import { basename, join as join2 } from "path";
+function detectDisabledFeatures(content) {
+  const disabled = new Set;
+  for (const key of FEATURE_KEYS) {
+    if (new RegExp(`\\b${key}\\s*:\\s*false\\b`).test(content)) {
+      disabled.add(key);
+    }
+  }
+  return disabled;
+}
+function findMatchingClose(text, start) {
+  const open = text[start];
+  const close = open === "{" ? "}" : open === "[" ? "]" : ")";
+  let depth = 0;
+  let inString = false;
+  for (let i = start;i < text.length; i++) {
+    const ch = text[i];
+    if (inString) {
+      if (ch === "\\") {
+        i++;
+        continue;
+      }
+      if (ch === inString)
+        inString = false;
+      continue;
+    }
+    if (ch === "'" || ch === '"' || ch === "`") {
+      inString = ch;
+      continue;
+    }
+    if (ch === open)
+      depth++;
+    if (ch === close) {
+      depth--;
+      if (depth === 0)
+        return i;
+    }
+  }
+  return -1;
+}
+function extractConfigBody(content) {
+  const match = content.match(/defineConfig\s*\(\s*\{/);
+  if (!match || match.index === undefined)
+    return "";
+  const openBrace = content.indexOf("{", match.index + "defineConfig".length);
+  const closeBrace = findMatchingClose(content, openBrace);
+  if (closeBrace === -1)
+    return "";
+  return content.slice(openBrace + 1, closeBrace);
+}
+function removeProperty(body, propName) {
+  const regex = new RegExp(`(\\n[ \\t]*)${propName}\\s*:\\s*`);
+  const match = regex.exec(body);
+  if (!match || match.index === undefined)
+    return body;
+  const propLineStart = match.index + 1;
+  const afterMatch = match.index + match[0].length;
+  let i = afterMatch;
+  while (i < body.length && (body[i] === " " || body[i] === "\t"))
+    i++;
+  let valueEnd;
+  if (body[i] === "{" || body[i] === "[") {
+    valueEnd = findMatchingClose(body, i);
+    if (valueEnd === -1)
+      return body;
+    valueEnd++;
+  } else {
+    while (i < body.length && body[i] !== "," && body[i] !== `
+`)
+      i++;
+    valueEnd = i;
+  }
+  let end = valueEnd;
+  while (end < body.length && (body[end] === " " || body[end] === "\t"))
+    end++;
+  if (end < body.length && body[end] === ",")
+    end++;
+  while (end < body.length && (body[end] === " " || body[end] === "\t"))
+    end++;
+  if (end < body.length && body[end] === `
+`)
+    end++;
+  return body.slice(0, propLineStart) + body.slice(end);
+}
+function prependToArrayProperty(lines, property, items) {
+  const pattern = new RegExp(`\\b${property}\\s*:\\s*\\[`);
+  for (let i = 0;i < lines.length; i++) {
+    if (pattern.test(lines[i])) {
+      lines[i] = lines[i].replace(new RegExp(`(\\b${property}\\s*:\\s*\\[)`), `$1${items}, `);
+      return true;
+    }
+  }
+  return false;
+}
+function transformConfig(content, disabled) {
+  const userImports = content.split(`
+`).filter((line) => /^\s*import\s/.test(line)).filter((line) => !line.includes("@nuasite/")).filter((line) => !line.includes("defineConfig"));
+  let body = extractConfigBody(content);
+  body = removeProperty(body, "nua");
+  if (content.includes("@nuasite/nua/integration")) {
+    body = body.replace(/\bnua\s*\([^)]*\)\s*,?\s*/g, "");
+    body = body.replace(/\bintegrations\s*:\s*\[\s*,?\s*\]\s*,?/g, "");
+  }
+  const imports = [`import { defineConfig } from 'astro/config'`];
+  if (!disabled.has("tailwindcss"))
+    imports.push(`import tailwindcss from '@tailwindcss/vite'`);
+  if (!disabled.has("mdx"))
+    imports.push(`import mdx from '@astrojs/mdx'`);
+  if (!disabled.has("sitemap"))
+    imports.push(`import sitemap from '@astrojs/sitemap'`);
+  imports.push(...userImports);
+  const integrationCalls = [];
+  if (!disabled.has("mdx"))
+    integrationCalls.push("mdx()");
+  if (!disabled.has("sitemap"))
+    integrationCalls.push("sitemap()");
+  const bodyLines = body.split(`
+`).filter((line) => line.trim() !== "");
+  const hasIntegrations = bodyLines.some((line) => /^\s*integrations\s*:/.test(line));
+  const hasVite = bodyLines.some((line) => /^\s*vite\s*:/.test(line));
+  if (hasIntegrations && integrationCalls.length > 0) {
+    prependToArrayProperty(bodyLines, "integrations", integrationCalls.join(", "));
+  }
+  if (!disabled.has("tailwindcss") && hasVite) {
+    prependToArrayProperty(bodyLines, "plugins", "tailwindcss()");
+  }
+  const newPropLines = [];
+  if (!disabled.has("tailwindcss") && !hasVite) {
+    newPropLines.push("\tvite: {", "\t\tbuild: {", "\t\t\tsourcemap: true,", "\t\t},", "\t\tplugins: [tailwindcss()],", "\t},");
+  }
+  if (!hasIntegrations && integrationCalls.length > 0) {
+    newPropLines.push(`	integrations: [${integrationCalls.join(", ")}],`);
+  }
+  const allLines = [...bodyLines, ...newPropLines];
+  let result = imports.join(`
+`) + `
+
+`;
+  result += `export default defineConfig({
+`;
+  if (allLines.length > 0) {
+    result += allLines.join(`
+`) + `
+`;
+  }
+  result += `})
+`;
+  return result;
+}
+function transformPackageJson(pkg, disabled, usedRuntimePackages = []) {
+  const result = structuredClone(pkg);
+  const nuaVersion = result.dependencies?.["@nuasite/nua"] ?? result.devDependencies?.["@nuasite/nua"];
+  if (result.scripts) {
+    for (const [key, value] of Object.entries(result.scripts)) {
+      if (typeof value === "string") {
+        result.scripts[key] = value.replace(/\bnua build\b/g, "astro build").replace(/\bnua dev\b/g, "astro dev").replace(/\bnua preview\b/g, "astro preview");
+      }
+    }
+  }
+  for (const field of ["dependencies", "devDependencies", "peerDependencies"]) {
+    if (!result[field])
+      continue;
+    for (const name of NUASITE_TOOLING) {
+      delete result[field][name];
+    }
+    if (Object.keys(result[field]).length === 0) {
+      delete result[field];
+    }
+  }
+  if (!result.dependencies)
+    result.dependencies = {};
+  for (const [name, version] of Object.entries(PACKAGES_TO_ADD)) {
+    if (result.dependencies[name])
+      continue;
+    if (name === "@astrojs/mdx" && disabled.has("mdx"))
+      continue;
+    if (name === "@astrojs/sitemap" && disabled.has("sitemap"))
+      continue;
+    if (name === "@tailwindcss/vite" && disabled.has("tailwindcss"))
+      continue;
+    if (name === "tailwindcss" && disabled.has("tailwindcss"))
+      continue;
+    result.dependencies[name] = version;
+  }
+  for (const name of usedRuntimePackages) {
+    if (!result.dependencies[name]) {
+      result.dependencies[name] = nuaVersion ?? "^0.16.0";
+    }
+  }
+  result.dependencies = Object.fromEntries(Object.entries(result.dependencies).sort(([a], [b]) => a.localeCompare(b)));
+  return result;
+}
+function scanForNuasiteUsage(cwd) {
+  const srcDir = join2(cwd, "src");
+  if (!existsSync2(srcDir))
+    return [];
+  const results = [];
+  try {
+    const files = readdirSync(srcDir, { recursive: true });
+    for (const entry of files) {
+      const fileName = String(entry);
+      if (!/\.(astro|ts|tsx|js|jsx)$/.test(fileName))
+        continue;
+      try {
+        const content = readFileSync(join2(srcDir, fileName), "utf-8");
+        const matches = content.match(/@nuasite\/[\w-]+/g);
+        if (matches) {
+          results.push({
+            file: join2("src", fileName),
+            packages: [...new Set(matches)]
+          });
+        }
+      } catch {}
+    }
+  } catch {}
+  return results;
+}
+async function clean({ cwd = process.cwd(), dryRun = false, yes = false } = {}) {
+  const configPath = findAstroConfig(cwd);
+  if (!configPath) {
+    console.error("No Astro config file found.");
+    process.exit(1);
+  }
+  const configContent = readFileSync(configPath, "utf-8");
+  if (!configContent.includes("@nuasite/nua")) {
+    console.log("This project does not use @nuasite/nua. Nothing to clean.");
+    return;
+  }
+  const pkgPath = join2(cwd, "package.json");
+  if (!existsSync2(pkgPath)) {
+    console.error("No package.json found.");
+    process.exit(1);
+  }
+  const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+  const disabled = detectDisabledFeatures(configContent);
+  const nuasiteUsage = scanForNuasiteUsage(cwd);
+  const configName = basename(configPath);
+  const usedRuntimePackages = new Set;
+  const toolingUsage = [];
+  for (const entry of nuasiteUsage) {
+    const runtime = entry.packages.filter((p) => !NUASITE_TOOLING.includes(p));
+    const tooling = entry.packages.filter((p) => NUASITE_TOOLING.includes(p));
+    for (const p of runtime)
+      usedRuntimePackages.add(p);
+    if (tooling.length > 0) {
+      toolingUsage.push({ file: entry.file, packages: tooling });
+    }
+  }
+  console.log("");
+  console.log("nua clean \u2014 eject to standard Astro project");
+  console.log("");
+  console.log(`  ${configName}`);
+  console.log("    - Replace @nuasite/nua with explicit Astro integrations");
+  console.log("    - Add mdx, sitemap, tailwindcss imports");
+  if (disabled.size > 0) {
+    console.log(`    - Skipping disabled: ${[...disabled].join(", ")}`);
+  }
+  console.log("");
+  console.log("  package.json");
+  console.log("    - Remove @nuasite/* tooling dependencies");
+  if (usedRuntimePackages.size > 0) {
+    console.log(`    - Keep as explicit deps: ${[...usedRuntimePackages].join(", ")}`);
+  }
+  console.log("    - Add standard Astro packages");
+  console.log("    - Update scripts: nua \u2192 astro");
+  if (toolingUsage.length > 0) {
+    console.log("");
+    console.log("  Warning: @nuasite tooling imports found in source files:");
+    for (const { file, packages } of toolingUsage) {
+      console.log(`    ${file} (${packages.join(", ")})`);
+    }
+    console.log("  These will need manual removal.");
+  }
+  if (dryRun) {
+    console.log("");
+    console.log("  (--dry-run: no changes made)");
+    console.log("");
+    return;
+  }
+  if (!yes) {
+    console.log("");
+    const answer = prompt("Proceed? [y/N] ");
+    if (answer?.toLowerCase() !== "y") {
+      console.log("Cancelled.");
+      return;
+    }
+  }
+  const newConfig = transformConfig(configContent, disabled);
+  writeFileSync(configPath, newConfig);
+  console.log(`  Updated ${configName}`);
+  const newPkg = transformPackageJson(pkg, disabled, [...usedRuntimePackages]);
+  writeFileSync(pkgPath, JSON.stringify(newPkg, null, "\t") + `
+`);
+  console.log("  Updated package.json");
+  console.log("");
+  console.log("Next steps:");
+  console.log("  1. bun install");
+  console.log("  2. Review the updated config");
+  console.log("  3. astro dev");
+  if (toolingUsage.length > 0) {
+    console.log("  4. Remove @nuasite tooling imports from source files");
+  }
+  console.log("");
+}
+var FEATURE_KEYS, NUASITE_TOOLING, PACKAGES_TO_ADD;
+var init_clean = __esm(() => {
+  init_utils();
+  FEATURE_KEYS = ["cms", "pageMarkdown", "mdx", "sitemap", "tailwindcss", "checks"];
+  NUASITE_TOOLING = [
+    "@nuasite/nua",
+    "@nuasite/core",
+    "@nuasite/cli",
+    "@nuasite/cms",
+    "@nuasite/llm-enhancements",
+    "@nuasite/checks",
+    "@nuasite/agent-summary"
+  ];
+  PACKAGES_TO_ADD = {
+    astro: "^6.0.2",
+    "@astrojs/check": "^0.9.7",
+    "@astrojs/mdx": "^5.0.0",
+    "@astrojs/rss": "^4.0.17",
+    "@astrojs/sitemap": "^3.7.1",
+    "@tailwindcss/vite": "^4.2.1",
+    tailwindcss: "^4.2.1",
+    typescript: "^5"
+  };
+});
 
 // ../agent-summary/src/agent-summary-integration.ts
 import fs2 from "fs/promises";
@@ -206,34 +582,19 @@ var agentsSummary = () => {
   };
 };
 // src/index.ts
+init_utils();
 import { build as astroBuild, dev, preview } from "astro";
 import { spawn } from "child_process";
-import { existsSync, readFileSync } from "fs";
-import { join } from "path";
+import { readFileSync as readFileSync2 } from "fs";
 var [, , command, ...args] = process.argv;
 function hasNuaIntegration(configPath) {
   try {
-    const content = readFileSync(configPath, "utf-8");
+    const content = readFileSync2(configPath, "utf-8");
     return content.includes("@nuasite/agent-summary") || content.includes("agentsSummary");
   } catch {
     return false;
   }
 }
-function findAstroConfig() {
-  const possibleConfigs = [
-    "astro.config.mjs",
-    "astro.config.js",
-    "astro.config.ts",
-    "astro.config.mts"
-  ];
-  for (const config of possibleConfigs) {
-    const configPath = join(process.cwd(), config);
-    if (existsSync(configPath)) {
-      return configPath;
-    }
-  }
-  return null;
-}
 function proxyToAstroCLI(command2, args2) {
   const astro = spawn("npx", ["astro", command2, ...args2], {
     stdio: "inherit",
@@ -251,10 +612,11 @@ function printUsage() {
   console.log("Usage: nua <command> [options]");
   console.log(`
 Commands:`);
-  console.log("  build   Run astro build with the Nua defaults");
-  console.log("  preview Run astro preview with the Nua defaults");
-  console.log("  dev     Run astro dev with the Nua defaults");
-  console.log("  help    Show this message");
+  console.log("  build    Run astro build with the Nua defaults");
+  console.log("  dev      Run astro dev with the Nua defaults");
+  console.log("  preview  Run astro preview with the Nua defaults");
+  console.log("  clean    Eject to a standard Astro project (remove @nuasite/* deps)");
+  console.log("  help     Show this message");
   console.log(`
 All Astro CLI options are supported.
 `);
@@ -298,6 +660,15 @@ if (canProxyDirectly && command && ["build", "dev", "preview"].includes(command)
       });
       break;
     }
+    case "clean": {
+      const { clean: clean2 } = await Promise.resolve().then(() => (init_clean(), exports_clean));
+      await clean2({
+        cwd: process.cwd(),
+        dryRun: args.includes("--dry-run"),
+        yes: args.includes("--yes") || args.includes("-y")
+      });
+      break;
+    }
     case "help":
     case "--help":
     case "-h":

package/dist/types/clean.d.ts

@@ -0,0 +1,19 @@
+export interface CleanOptions {
+    cwd?: string;
+    dryRun?: boolean;
+    yes?: boolean;
+}
+export type FeatureKey = 'cms' | 'pageMarkdown' | 'mdx' | 'sitemap' | 'tailwindcss' | 'checks';
+export declare function detectDisabledFeatures(content: string): Set<FeatureKey>;
+/**
+ * Extract the text between the outermost { } of defineConfig({ ... })
+ */
+export declare function extractConfigBody(content: string): string;
+/**
+ * Remove a top-level property from an object literal body text.
+ */
+export declare function removeProperty(body: string, propName: string): string;
+export declare function transformConfig(content: string, disabled: Set<FeatureKey>): string;
+export declare function transformPackageJson(pkg: Record<string, any>, disabled: Set<FeatureKey>, usedRuntimePackages?: string[]): Record<string, any>;
+export declare function clean({ cwd, dryRun, yes }?: CleanOptions): Promise<void>;
+//# sourceMappingURL=clean.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../src/clean.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,YAAY;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,GAAG,CAAC,EAAE,OAAO,CAAA;CACb;AAED,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAA;AAyB9F,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,CAQvE;AAsCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAgCrE;AAoBD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,CAiElF;AAED,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,QAAQ,EAAE,GAAG,CAAC,UAAU,CAAC,EACzB,mBAAmB,GAAE,MAAM,EAAO,GAChC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAkDrB;AAkCD,wBAAsB,KAAK,CAAC,EAAE,GAAmB,EAAE,MAAc,EAAE,GAAW,EAAE,GAAE,YAAiB,iBAgGlG"}