create-krispya 0.5.3 → 0.6.0

package/dist/chunks/index.cjs

@@ -1,6 +1,9 @@
 'use strict';
 
 const color = require('chalk');
+const promises = require('fs/promises');
+const fs = require('fs');
+const path = require('path');
 
 function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
 
@@ -96,6 +99,34 @@ const defaultFormatterConfig = {
   bracketSpacing: true,
   arrowParens: "always"
 };
+const defaultPrettierConfig = {
+  $schema: "https://json.schemastore.org/prettierrc",
+  ...defaultFormatterConfig,
+  overrides: [
+    {
+      files: ["*.json", "**/*.json"],
+      options: { tabWidth: 2 }
+    },
+    {
+      files: ["*.md", "**/*.md"],
+      options: { tabWidth: 2, semi: false }
+    },
+    {
+      files: ["*.yml", "*.yaml", "**/*.yml", "**/*.yaml"],
+      options: { tabWidth: 2, semi: false }
+    }
+  ]
+};
+const defaultOxfmtConfig = {
+  printWidth: defaultFormatterConfig.printWidth,
+  tabWidth: defaultFormatterConfig.tabWidth,
+  useTabs: defaultFormatterConfig.useTabs,
+  semi: defaultFormatterConfig.semi,
+  singleQuote: defaultFormatterConfig.singleQuote,
+  trailingComma: defaultFormatterConfig.trailingComma,
+  bracketSpacing: defaultFormatterConfig.bracketSpacing,
+  arrowParens: defaultFormatterConfig.arrowParens
+};
 const defaultLinterConfig = {
   ignorePatterns: ["dist"],
   rules: {
@@ -112,9 +143,88 @@ const defaultLinterConfig = {
   }
 };
 
+const ALL_AI_PLATFORMS = ["agents", "claude"];
+const AI_PLATFORM_LABELS = {
+  agents: "AGENTS.md",
+  claude: "CLAUDE.md"
+};
+const AI_PLATFORM_HINTS = {
+  agents: "OpenAI, Cursor, Windsurf, etc.",
+  claude: "Claude Code"
+};
+function generateAiFiles(files, params) {
+  const { platforms, isMonorepo, configStrategy, ...rest } = params;
+  if (platforms.length === 0) return;
+  files[".ai/workspace.md"] = {
+    type: "text",
+    content: generateWorkspace({
+      ...rest,
+      isMonorepo: !!isMonorepo,
+      configStrategy: configStrategy ?? "stealth"
+    })
+  };
+  const pointer = "See `.ai/` for project rules.\n";
+  for (const platform of platforms) {
+    const path = platform === "agents" ? "AGENTS.md" : "CLAUDE.md";
+    files[path] = { type: "text", content: pointer };
+  }
+}
+function generateWorkspace(ctx) {
+  const { name, packageManager, linter, formatter, isMonorepo, configStrategy } = ctx;
+  const sections = [
+    `# ${name}`,
+    "",
+    `- **Type:** ${isMonorepo ? "pnpm monorepo" : "standalone project"}`,
+    `- **Package Manager:** ${packageManager}`,
+    `- **Linter:** ${linter}`,
+    `- **Formatter:** ${formatter}`,
+    "",
+    "## Commands",
+    "",
+    `- \`${packageManager} test\` \u2014 run tests`,
+    `- \`${packageManager} build\` \u2014 build`,
+    `- \`${packageManager} lint\` and \`${packageManager} format\` \u2014 run before committing`
+  ];
+  if (isMonorepo) {
+    sections.push(
+      "",
+      "## Structure",
+      "",
+      "- `apps/` \u2014 applications",
+      "- `packages/` \u2014 shared libraries",
+      "- `.config/` \u2014 shared config packages",
+      "",
+      "## Monorepo",
+      "",
+      "- Use `workspace:*` for internal dependencies",
+      `- New packages: \`${packageManager} create krispya <name> --workspace\``
+    );
+  } else if (configStrategy === "root") {
+    sections.push(
+      "",
+      "## Structure",
+      "",
+      "- `src/` \u2014 source code",
+      "- `dist/` \u2014 generated, don't edit",
+      "- Config files (`tsconfig.json`, etc.) are at project root"
+    );
+  } else {
+    sections.push(
+      "",
+      "## Structure",
+      "",
+      "- `src/` \u2014 source code",
+      "- `.config/` \u2014 configs, don't move",
+      "- `dist/` \u2014 generated, don't edit"
+    );
+  }
+  sections.push("");
+  return sections.join("\n");
+}
+
 function generateTypescriptConfig(baseTemplateOrParams) {
   const params = typeof baseTemplateOrParams === "string" ? { baseTemplate: baseTemplateOrParams } : baseTemplateOrParams;
-  const { baseTemplate, useConfigPackage } = params;
+  const { baseTemplate, useConfigPackage, configStrategy = "stealth" } = params;
   const isReact = baseTemplate === "react";
   const isR3f = baseTemplate === "r3f";
   const files = {};
@@ -143,58 +253,113 @@ function generateTypescriptConfig(baseTemplateOrParams) {
     };
     return { files, devDependencies };
   }
-  const tsConfig = {
-    $schema: "https://json.schemastore.org/tsconfig",
-    files: [],
-    references: [{ path: "./.config/tsconfig.app.json" }, { path: "./.config/tsconfig.node.json" }]
-  };
-  files["tsconfig.json"] = {
-    type: "text",
-    content: JSON.stringify(tsConfig, null, 2)
-  };
-  const tsConfigApp = {
-    $schema: "https://json.schemastore.org/tsconfig",
-    compilerOptions: {
-      target: "ESNext",
-      module: "ESNext",
-      moduleResolution: "bundler",
-      lib: ["DOM", "DOM.Iterable", "ESNext"],
-      esModuleInterop: true,
-      allowSyntheticDefaultImports: true,
-      strict: true,
-      skipLibCheck: true,
-      composite: true,
-      rewriteRelativeImportExtensions: true,
-      erasableSyntaxOnly: true,
-      ...isReact || isR3f ? { jsx: "react-jsx" } : {}
-    },
-    include: ["../src", "../tests"]
-  };
-  files[".config/tsconfig.app.json"] = {
-    type: "text",
-    content: JSON.stringify(tsConfigApp, null, 2)
-  };
-  const tsConfigNode = {
-    $schema: "https://json.schemastore.org/tsconfig",
-    compilerOptions: {
-      target: "ESNext",
-      module: "ESNext",
-      moduleResolution: "bundler",
-      lib: ["ESNext"],
-      esModuleInterop: true,
-      allowSyntheticDefaultImports: true,
-      strict: true,
-      skipLibCheck: true,
-      composite: true,
-      rewriteRelativeImportExtensions: true,
-      erasableSyntaxOnly: true
-    },
-    include: ["../*.config.ts", "./*.ts"]
-  };
-  files[".config/tsconfig.node.json"] = {
-    type: "text",
-    content: JSON.stringify(tsConfigNode, null, 2)
-  };
+  if (configStrategy === "stealth") {
+    const tsConfig = {
+      $schema: "https://json.schemastore.org/tsconfig",
+      files: [],
+      references: [{ path: "./.config/tsconfig.app.json" }, { path: "./.config/tsconfig.node.json" }]
+    };
+    files["tsconfig.json"] = {
+      type: "text",
+      content: JSON.stringify(tsConfig, null, 2)
+    };
+    const tsConfigApp = {
+      $schema: "https://json.schemastore.org/tsconfig",
+      compilerOptions: {
+        target: "ESNext",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        lib: ["DOM", "DOM.Iterable", "ESNext"],
+        esModuleInterop: true,
+        allowSyntheticDefaultImports: true,
+        strict: true,
+        skipLibCheck: true,
+        composite: true,
+        rewriteRelativeImportExtensions: true,
+        erasableSyntaxOnly: true,
+        ...isReact || isR3f ? { jsx: "react-jsx" } : {}
+      },
+      include: ["../src", "../tests"]
+    };
+    files[".config/tsconfig.app.json"] = {
+      type: "text",
+      content: JSON.stringify(tsConfigApp, null, 2)
+    };
+    const tsConfigNode = {
+      $schema: "https://json.schemastore.org/tsconfig",
+      compilerOptions: {
+        target: "ESNext",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        lib: ["ESNext"],
+        esModuleInterop: true,
+        allowSyntheticDefaultImports: true,
+        strict: true,
+        skipLibCheck: true,
+        composite: true,
+        rewriteRelativeImportExtensions: true,
+        erasableSyntaxOnly: true
+      },
+      include: ["../*.config.ts", "./*.ts"]
+    };
+    files[".config/tsconfig.node.json"] = {
+      type: "text",
+      content: JSON.stringify(tsConfigNode, null, 2)
+    };
+  } else {
+    const tsConfig = {
+      $schema: "https://json.schemastore.org/tsconfig",
+      files: [],
+      references: [{ path: "./tsconfig.app.json" }, { path: "./tsconfig.node.json" }]
+    };
+    files["tsconfig.json"] = {
+      type: "text",
+      content: JSON.stringify(tsConfig, null, 2)
+    };
+    const tsConfigApp = {
+      $schema: "https://json.schemastore.org/tsconfig",
+      compilerOptions: {
+        target: "ESNext",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        lib: ["DOM", "DOM.Iterable", "ESNext"],
+        esModuleInterop: true,
+        allowSyntheticDefaultImports: true,
+        strict: true,
+        skipLibCheck: true,
+        composite: true,
+        rewriteRelativeImportExtensions: true,
+        erasableSyntaxOnly: true,
+        ...isReact || isR3f ? { jsx: "react-jsx" } : {}
+      },
+      include: ["src", "tests"]
+    };
+    files["tsconfig.app.json"] = {
+      type: "text",
+      content: JSON.stringify(tsConfigApp, null, 2)
+    };
+    const tsConfigNode = {
+      $schema: "https://json.schemastore.org/tsconfig",
+      compilerOptions: {
+        target: "ESNext",
+        module: "ESNext",
+        moduleResolution: "bundler",
+        lib: ["ESNext"],
+        esModuleInterop: true,
+        allowSyntheticDefaultImports: true,
+        strict: true,
+        skipLibCheck: true,
+        composite: true,
+        rewriteRelativeImportExtensions: true,
+        erasableSyntaxOnly: true
+      },
+      include: ["*.config.ts"]
+    };
+    files["tsconfig.node.json"] = {
+      type: "text",
+      content: JSON.stringify(tsConfigNode, null, 2)
+    };
+  }
   return { files, devDependencies };
 }
 
@@ -604,9 +769,12 @@ function generateVscodeFiles$1(params) {
     };
   }
   if (Object.keys(vscodeSettings).length > 0) {
+    const sortedSettings = Object.fromEntries(
+      Object.entries(vscodeSettings).sort(([a], [b]) => a.localeCompare(b))
+    );
     files[".vscode/settings.json"] = {
       type: "text",
-      content: JSON.stringify(vscodeSettings, null, "	")
+      content: JSON.stringify(sortedSettings, null, "	")
     };
   }
   return files;
@@ -659,128 +827,6 @@ function generateViteConfig(params) {
   return { type: "text", content: viteConfigContent };
 }
 
-function generateAiFiles(files, params) {
-  const { name, packageManager, linter, formatter, aiFiles } = params;
-  const content = getAiInstructionsContent({
-    name,
-    packageManager,
-    linter,
-    formatter
-  });
-  for (const fileChoice of aiFiles) {
-    switch (fileChoice) {
-      case "cursor-rules":
-        files[".cursor/rules"] = { type: "text", content };
-        break;
-      case "agents-md":
-        files["AGENTS.md"] = { type: "text", content };
-        break;
-      case "claude-md":
-        files["CLAUDE.md"] = { type: "text", content };
-        break;
-      case "copilot-md":
-        files[".github/copilot-instructions.md"] = { type: "text", content };
-        break;
-    }
-  }
-}
-function getConfigPackagesDescription(linter, formatter) {
-  const packages = ["`@config/typescript`"];
-  if (linter !== "biome") {
-    packages.push(`\`@config/${linter}\``);
-  }
-  if (formatter !== "biome" && formatter !== linter) {
-    packages.push(`\`@config/${formatter}\``);
-  }
-  let description = `- \`.config/\`: shared config packages (${packages.join(", ")})`;
-  if (linter === "biome" || formatter === "biome") {
-    description += "\n- `biome.json`: Biome configuration (root level)";
-  }
-  return description;
-}
-function getAiInstructionsContent(params) {
-  const { name, packageManager, linter, formatter } = params;
-  const configDescription = getConfigPackagesDescription(linter, formatter);
-  return `# ${name}
-
-This is a pnpm monorepo workspace generated with \`create-krispya\`.
-
-## Most important rule (package creation)
-
-If you need a new app/package for any reason, **ALWAYS** create it with \`create-krispya\` (do not hand-create folders/package.json).
-
-### Non-interactive (preferred for agents)
-
-\`\`\`bash
-${packageManager} create krispya <name> --workspace [options]
-\`\`\`
-
-- The package directory will be \`apps/<name>\` (apps) or \`packages/<name>\` (libraries), unless \`--dir\` is provided.
-- Package names default to \`@${name}/<name>\` but you can pass any name (scoped or unscoped).
-
-### Workspace maintenance (non-interactive)
-
-\`\`\`bash
-${packageManager} create krispya --check                                # validate workspace
-${packageManager} create krispya --fix --linter ${linter} --formatter ${formatter}  # fix missing .config packages
-\`\`\`
-
-For non-interactive \`--fix\`, you MUST provide both \`--linter\` and \`--formatter\` flags.
-
-## Package creation options (CLI truth)
-
-| Option | Values | Notes |
-|--------|--------|-------|
-| \`--type\` | app, library | default: app |
-| \`--template\` | vanilla, vanilla-js, react, react-js, r3f, r3f-js | default: vanilla |
-| \`--dir\` | any directory | requires \`--workspace\`; default: \`apps/\` or \`packages/\` |
-| \`--bundler\` | unbuild, tsdown | libraries only; default: unbuild |
-
-### R3F flags (r3f templates only)
-
-\`--drei\` \`--handle\` \`--leva\` \`--postprocessing\` \`--rapier\` \`--xr\` \`--uikit\` \`--offscreen\` \`--zustand\` \`--koota\` \`--triplex\` \`--viverse\`
-
-### Examples
-
-\`\`\`bash
-# React library (@${name}/ui) in packages/ui
-${packageManager} create krispya ui --workspace --type library --template react
-
-# R3F app with physics + controls (@${name}/game) in apps/game
-${packageManager} create krispya game --workspace --type app --template r3f --drei --rapier --leva
-
-# App in a custom directory
-${packageManager} create krispya demo --workspace --type app --template react --dir examples
-\`\`\`
-
-## After creating a package
-
-\`\`\`bash
-${packageManager} install
-\`\`\`
-
-- Use \`"workspace:*"\` for internal deps (e.g. \`"@${name}/ui": "workspace:*"\`).
-
-## Workspace commands
-
-\`\`\`bash
-${packageManager} install          # Install all dependencies
-${packageManager} run dev          # Run all apps in dev mode
-${packageManager} run build        # Build packages then apps
-${packageManager} run test         # Run all tests
-${packageManager} run lint         # Lint with ${linter}
-${packageManager} run format       # Format with ${formatter}
-\`\`\`
-
-## Structure + conventions
-
-- \`apps/\`: applications (\`--type app\`)
-- \`packages/\`: libraries (\`--type library\`)
-${configDescription}
-- TS configs extend \`@config/typescript/*\` (base/app/node/react)
-`;
-}
-
 function generateTypescriptConfigPackage(files) {
   const basePath = ".config/typescript";
   files[`${basePath}/package.json`] = {
@@ -1132,20 +1178,7 @@ Or in \`.prettierrc.json\`:
   };
   files[`${basePath}/base.json`] = {
     type: "text",
-    content: JSON.stringify(
-      {
-        printWidth: defaultFormatterConfig.printWidth,
-        tabWidth: defaultFormatterConfig.tabWidth,
-        useTabs: defaultFormatterConfig.useTabs,
-        semi: defaultFormatterConfig.semi,
-        singleQuote: defaultFormatterConfig.singleQuote,
-        trailingComma: defaultFormatterConfig.trailingComma,
-        bracketSpacing: defaultFormatterConfig.bracketSpacing,
-        arrowParens: defaultFormatterConfig.arrowParens
-      },
-      null,
-      2
-    )
+    content: JSON.stringify(defaultPrettierConfig, null, 2)
   };
 }
 function generateOxfmtConfigPackage(files) {
@@ -1184,20 +1217,7 @@ oxfmt -c node_modules/@config/oxfmt/base.json --write .
   };
   files[`${basePath}/base.json`] = {
     type: "text",
-    content: JSON.stringify(
-      {
-        printWidth: defaultFormatterConfig.printWidth,
-        tabWidth: defaultFormatterConfig.tabWidth,
-        useTabs: defaultFormatterConfig.useTabs,
-        semi: defaultFormatterConfig.semi,
-        singleQuote: defaultFormatterConfig.singleQuote,
-        trailingComma: defaultFormatterConfig.trailingComma,
-        bracketSpacing: defaultFormatterConfig.bracketSpacing,
-        arrowParens: defaultFormatterConfig.arrowParens
-      },
-      null,
-      2
-    )
+    content: JSON.stringify(defaultOxfmtConfig, null, 2)
   };
 }
 
@@ -1210,7 +1230,7 @@ function generateMonorepo(params) {
     pnpmVersion,
     pnpmManageVersions,
     nodeVersion,
-    aiFiles
+    aiPlatforms
   } = params;
   const files = {};
   const isPnpm = packageManager === "pnpm";
@@ -1237,7 +1257,7 @@ function generateMonorepo(params) {
       build: "pnpm --filter './packages/*' run build && pnpm --filter './apps/*' run build",
       test: "pnpm -r run test",
       lint: linter === "oxlint" ? "oxlint ." : linter === "biome" ? "biome check ." : "eslint .",
-      format: formatter === "oxfmt" ? "oxfmt ." : formatter === "biome" ? "biome format . --write" : "prettier --write ."
+      format: formatter === "oxfmt" ? "oxfmt -c .config/oxfmt/base.json ." : formatter === "biome" ? "biome format . --write" : "prettier --config .config/prettier/base.json --write ."
     },
     devDependencies
   };
@@ -1276,11 +1296,43 @@ function generateMonorepo(params) {
       content: workspaceLines.join("\n")
     };
   }
+  files["tsconfig.json"] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        extends: "@config/typescript/base.json",
+        compilerOptions: {
+          noEmit: true
+        },
+        references: []
+      },
+      null,
+      2
+    )
+  };
   generateTypescriptConfigPackage(files);
   if (linter === "oxlint") {
     generateOxlintConfigPackage(files);
+    files["oxlint.json"] = {
+      type: "text",
+      content: JSON.stringify(
+        {
+          $schema: "./node_modules/oxlint/configuration_schema.json",
+          extends: ["@config/oxlint/base.json"]
+        },
+        null,
+        2
+      )
+    };
   } else if (linter === "eslint") {
     generateEslintConfigPackage(files);
+    files["eslint.config.js"] = {
+      type: "text",
+      content: `import base from "@config/eslint/base";
+
+export default [...base];
+`
+    };
   } else if (linter === "biome") {
     const biomeConfig = {
       $schema: "https://biomejs.dev/schemas/1.9.4/schema.json",
@@ -1347,13 +1399,14 @@ This monorepo workspace was generated with create-krispya.
 To add a new package to this workspace, run create-krispya from this directory and it will detect the monorepo.
 `
   };
-  if (aiFiles && aiFiles.length > 0) {
+  if (aiPlatforms && aiPlatforms.length > 0) {
     generateAiFiles(files, {
       name,
       packageManager,
       linter,
       formatter,
-      aiFiles
+      isMonorepo: true,
+      platforms: aiPlatforms
     });
   }
   return { files };
@@ -1425,14 +1478,11 @@ function generateBiome(generator, options) {
   if (options == null || !options.linter && !options.formatter) {
     return;
   }
-  const version = generator.versions.biome ?? "1.9.4";
+  const version = generator.versions.biome ?? "2.0.0";
   generator.addDevDependency("@biomejs/biome", `^${version}`);
   const { rules } = defaultLinterConfig;
   const biomeConfig = {
-    $schema: "https://biomejs.dev/schemas/1.9.4/schema.json",
-    files: {
-      ignore: defaultLinterConfig.ignorePatterns
-    }
+    $schema: `https://biomejs.dev/schemas/${version}/schema.json`
   };
   if (options.linter) {
     biomeConfig.linter = {
@@ -1465,27 +1515,52 @@ function generateBiome(generator, options) {
         arrowParentheses: "always" 
       }
     };
+    biomeConfig.json = {
+      formatter: {
+        indentWidth: 2
+      }
+    };
   } else {
     biomeConfig.formatter = {
       enabled: false
     };
   }
-  generator.addFile("biome.json", {
-    type: "text",
-    content: JSON.stringify(biomeConfig, null, 2)
-  });
-  if (options.linter) {
-    generator.addScript("lint", "biome lint .");
-  }
-  if (options.formatter) {
-    generator.addScript("format", "biome format --write .");
+  const isStealth = generator.isStealthConfig();
+  if (isStealth) {
+    generator.addFile(".config/biome.json", {
+      type: "text",
+      content: JSON.stringify(biomeConfig, null, 2)
+    });
+    if (options.linter) {
+      generator.addScript("lint", "biome lint --config-path .config .");
+    }
+    if (options.formatter) {
+      generator.addScript(
+        "format",
+        "biome format --config-path .config --write ."
+      );
+    }
+    generator.addVscodeSetting("biome.linter.configPath", ".config/biome.json");
+  } else {
+    generator.addFile("biome.json", {
+      type: "text",
+      content: JSON.stringify(biomeConfig, null, 2)
+    });
+    if (options.linter) {
+      generator.addScript("lint", "biome lint .");
+    }
+    if (options.formatter) {
+      generator.addScript("format", "biome format --write .");
+    }
   }
   const roles = [];
   if (options.linter) roles.push("linter");
   if (options.formatter) roles.push("formatter");
   generator.inject(
     "readme-tools",
-    `[Biome](https://biomejs.dev/) - Fast ${roles.join(" and ")} for JavaScript and TypeScript`
+    `[Biome](https://biomejs.dev/) - Fast ${roles.join(
+      " and "
+    )} for JavaScript and TypeScript`
   );
   generator.inject("vscode-extension-suggestion", "biomejs.biome");
   generator.addVscodeSetting("biome.enabled", true);
@@ -1570,11 +1645,23 @@ function generateEslint(generator, options) {
   },`,
     "]"
   ].filter(Boolean).join("\n");
-  generator.addFile("eslint.config.js", {
-    type: "text",
-    content: configContent
-  });
-  generator.addScript("lint", "eslint .");
+  const isStealth = generator.isStealthConfig();
+  if (isStealth) {
+    generator.addFile(".config/eslint.config.js", {
+      type: "text",
+      content: configContent
+    });
+    generator.addScript("lint", "eslint --config .config/eslint.config.js .");
+    generator.addVscodeSetting("eslint.options", {
+      overrideConfigFile: ".config/eslint.config.js"
+    });
+  } else {
+    generator.addFile("eslint.config.js", {
+      type: "text",
+      content: configContent
+    });
+    generator.addScript("lint", "eslint .");
+  }
   generator.inject(
     "readme-tools",
     "[ESLint](https://eslint.org/) - Linter for JavaScript and TypeScript"
@@ -1744,22 +1831,21 @@ function generateOxfmt(generator, options) {
   } else {
     const version = generator.versions.oxfmt ?? "0.1.0";
     generator.addDevDependency("oxfmt", `^${version}`);
-    const oxfmtConfig = {
-      printWidth: defaultFormatterConfig.printWidth,
-      tabWidth: defaultFormatterConfig.tabWidth,
-      useTabs: defaultFormatterConfig.useTabs,
-      semi: defaultFormatterConfig.semi,
-      singleQuote: defaultFormatterConfig.singleQuote,
-      trailingComma: defaultFormatterConfig.trailingComma,
-      bracketSpacing: defaultFormatterConfig.bracketSpacing,
-      arrowParens: defaultFormatterConfig.arrowParens
-    };
-    generator.addFile(".config/oxfmt.json", {
-      type: "text",
-      content: JSON.stringify(oxfmtConfig, null, 2)
-    });
-    generator.addScript("format", "oxfmt -c .config/oxfmt.json --write .");
-    generator.addVscodeSetting("oxc.fmt.configPath", ".config/oxfmt.json");
+    const isStealth = generator.isStealthConfig();
+    if (isStealth) {
+      generator.addFile(".config/oxfmt.json", {
+        type: "text",
+        content: JSON.stringify(defaultOxfmtConfig, null, 2)
+      });
+      generator.addScript("format", "oxfmt -c .config/oxfmt.json --write .");
+      generator.addVscodeSetting("oxc.fmt.configPath", ".config/oxfmt.json");
+    } else {
+      generator.addFile("oxfmt.json", {
+        type: "text",
+        content: JSON.stringify(defaultOxfmtConfig, null, 2)
+      });
+      generator.addScript("format", "oxfmt -c oxfmt.json --write .");
+    }
   }
   generator.inject(
     "readme-tools",
@@ -1773,6 +1859,12 @@ function generateOxfmt(generator, options) {
   generator.addVscodeSetting("[jsonc]", {
     "editor.defaultFormatter": "vscode.json-language-features"
   });
+  generator.addVscodeSetting("[markdown]", {
+    "editor.defaultFormatter": "vscode.markdown-language-features"
+  });
+  generator.addVscodeSetting("[yaml]", {
+    "editor.defaultFormatter": "redhat.vscode-yaml"
+  });
 }
 
 function toOxlintLevel(level) {
@@ -1791,13 +1883,14 @@ function generateOxlint(generator, options) {
   } else {
     const version = generator.versions.oxlint ?? "0.16.0";
     generator.addDevDependency("oxlint", `^${version}`);
+    const isStealth = generator.isStealthConfig();
     const { rules } = defaultLinterConfig;
     const plugins = ["unicorn", "typescript", "oxc"];
     if (isReact) {
       plugins.push("react");
     }
     const oxlintConfig = {
-      $schema: "../node_modules/oxlint/configuration_schema.json",
+      $schema: isStealth ? "../node_modules/oxlint/configuration_schema.json" : "./node_modules/oxlint/configuration_schema.json",
       plugins,
       rules: {
         "no-unused-vars": [
@@ -1816,12 +1909,20 @@ function generateOxlint(generator, options) {
       },
       ignorePatterns: defaultLinterConfig.ignorePatterns
     };
-    generator.addFile(".config/oxlint.json", {
-      type: "text",
-      content: JSON.stringify(oxlintConfig, null, 2)
-    });
-    generator.addScript("lint", "oxlint -c .config/oxlint.json");
-    generator.addVscodeSetting("oxc.configPath", ".config/oxlint.json");
+    if (isStealth) {
+      generator.addFile(".config/oxlint.json", {
+        type: "text",
+        content: JSON.stringify(oxlintConfig, null, 2)
+      });
+      generator.addScript("lint", "oxlint -c .config/oxlint.json");
+      generator.addVscodeSetting("oxc.configPath", ".config/oxlint.json");
+    } else {
+      generator.addFile("oxlint.json", {
+        type: "text",
+        content: JSON.stringify(oxlintConfig, null, 2)
+      });
+      generator.addScript("lint", "oxlint");
+    }
   }
   generator.inject(
     "readme-tools",
@@ -1852,25 +1953,33 @@ function generatePostprocessing(generator, options) {
 function generatePrettier(generator, options) {
   const version = generator.versions.prettier ?? "3.4.2";
   generator.addDevDependency("prettier", `^${version}`);
-  const prettierConfig = {
-    $schema: "https://json.schemastore.org/prettierrc",
-    printWidth: defaultFormatterConfig.printWidth,
-    tabWidth: defaultFormatterConfig.tabWidth,
-    useTabs: defaultFormatterConfig.useTabs,
-    semi: defaultFormatterConfig.semi,
-    singleQuote: defaultFormatterConfig.singleQuote,
-    trailingComma: defaultFormatterConfig.trailingComma,
-    bracketSpacing: defaultFormatterConfig.bracketSpacing,
-    arrowParens: defaultFormatterConfig.arrowParens
-  };
-  generator.addFile(".prettierrc", {
-    type: "text",
-    content: JSON.stringify(prettierConfig, null, 2)
-  });
-  generator.addScript("format", "prettier --write .");
-  generator.inject("readme-tools", "[Prettier](https://prettier.io/) - Opinionated code formatter");
+  const isStealth = generator.isStealthConfig();
+  if (isStealth) {
+    generator.addFile(".config/prettier.json", {
+      type: "text",
+      content: JSON.stringify(defaultPrettierConfig, null, 2)
+    });
+    generator.addScript(
+      "format",
+      "prettier --config .config/prettier.json --write ."
+    );
+    generator.addVscodeSetting("prettier.configPath", ".config/prettier.json");
+  } else {
+    generator.addFile(".prettierrc", {
+      type: "text",
+      content: JSON.stringify(defaultPrettierConfig, null, 2)
+    });
+    generator.addScript("format", "prettier --write .");
+  }
+  generator.inject(
+    "readme-tools",
+    "[Prettier](https://prettier.io/) - Opinionated code formatter"
+  );
   generator.inject("vscode-extension-suggestion", "esbenp.prettier-vscode");
-  generator.addVscodeSetting("editor.defaultFormatter", "esbenp.prettier-vscode");
+  generator.addVscodeSetting(
+    "editor.defaultFormatter",
+    "esbenp.prettier-vscode"
+  );
 }
 
 function generateRapier(generator, options) {
@@ -2120,18 +2229,19 @@ function generateUnbuild(generator) {
   }
   buildConfigLines.push(`  },`);
   buildConfigLines.push(`})`);
-  if (isMonorepo) {
-    generator.addFile(`build.config.${ext}`, {
+  const isStealth = generator.isStealthConfig() && !isMonorepo;
+  if (isStealth) {
+    generator.addFile(`.config/build.config.${ext}`, {
       type: "text",
       content: buildConfigLines.join("\n")
     });
-    generator.addScript("build", "unbuild");
+    generator.addScript("build", `unbuild --config .config/build.config.${ext}`);
   } else {
-    generator.addFile(`.config/build.config.${ext}`, {
+    generator.addFile(`build.config.${ext}`, {
       type: "text",
       content: buildConfigLines.join("\n")
     });
-    generator.addScript("build", `unbuild --config .config/build.config.${ext}`);
+    generator.addScript("build", "unbuild");
   }
   generator.inject(
     "readme-libraries",
@@ -2439,6 +2549,82 @@ function parseWorkspaceYamlContent(content) {
   }
   return directories;
 }
+async function pathExists(path) {
+  try {
+    await promises.access(path, fs.constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function detectLinterFromScript(script) {
+  if (!script) return void 0;
+  if (script.includes("oxlint")) return "oxlint";
+  if (script.includes("eslint")) return "eslint";
+  if (script.includes("biome check") || script.includes("biome lint")) return "biome";
+  return void 0;
+}
+function detectFormatterFromScript(script) {
+  if (!script) return void 0;
+  if (script.includes("prettier")) return "prettier";
+  if (script.includes("oxfmt")) return "oxfmt";
+  if (script.includes("biome format")) return "biome";
+  return void 0;
+}
+async function detectLinterFromConfig(root) {
+  if (await pathExists(path.join(root, ".config/oxlint"))) return "oxlint";
+  if (await pathExists(path.join(root, ".config/eslint"))) return "eslint";
+  if (await pathExists(path.join(root, "biome.json"))) {
+    try {
+      const content = await promises.readFile(path.join(root, "biome.json"), "utf-8");
+      const config = JSON.parse(content);
+      if (config.linter?.enabled !== false) return "biome";
+    } catch {
+      return "biome";
+    }
+  }
+  return void 0;
+}
+async function detectFormatterFromConfig(root) {
+  if (await pathExists(path.join(root, ".config/prettier"))) return "prettier";
+  if (await pathExists(path.join(root, ".config/oxfmt"))) return "oxfmt";
+  if (await pathExists(path.join(root, "biome.json"))) {
+    try {
+      const content = await promises.readFile(path.join(root, "biome.json"), "utf-8");
+      const config = JSON.parse(content);
+      if (config.formatter?.enabled !== false) return "biome";
+    } catch {
+      return "biome";
+    }
+  }
+  return void 0;
+}
+function detectLinterFromDeps(devDeps) {
+  if (!devDeps) return void 0;
+  if (devDeps["@biomejs/biome"]) return "biome";
+  if (devDeps.eslint) return "eslint";
+  if (devDeps.oxlint) return "oxlint";
+  return void 0;
+}
+function detectFormatterFromDeps(devDeps) {
+  if (!devDeps) return void 0;
+  if (devDeps["@biomejs/biome"]) return "biome";
+  if (devDeps.prettier) return "prettier";
+  if (devDeps.oxfmt) return "oxfmt";
+  return void 0;
+}
+async function detectTooling(root) {
+  try {
+    const pkgPath = path.join(root, "package.json");
+    const content = await promises.readFile(pkgPath, "utf-8");
+    const pkg = JSON.parse(content);
+    const linter = detectLinterFromScript(pkg.scripts?.lint) ?? await detectLinterFromConfig(root) ?? detectLinterFromDeps(pkg.devDependencies);
+    const formatter = detectFormatterFromScript(pkg.scripts?.format) ?? await detectFormatterFromConfig(root) ?? detectFormatterFromDeps(pkg.devDependencies);
+    return { linter, formatter };
+  } catch {
+    return { linter: void 0, formatter: void 0 };
+  }
+}
 function generateRandomName() {
   const adjectives = [
     "red",
@@ -2560,7 +2746,8 @@ function generate(options) {
   if (language === "typescript") {
     const tsResult = generateTypescriptConfig({
       baseTemplate,
-      useConfigPackage: clonedOptions.workspaceRoot != null
+      useConfigPackage: clonedOptions.workspaceRoot != null,
+      configStrategy: clonedOptions.configStrategy
     });
     Object.assign(files, tsResult.files);
     Object.assign(devDependencies, tsResult.devDependencies);
@@ -2572,7 +2759,9 @@ function generate(options) {
     build: "vite build"
   };
   if (!isLibrary && (isReact || isR3f)) {
-    codeSnippets["vite-config-import"] = ["import react from '@vitejs/plugin-react'"];
+    codeSnippets["vite-config-import"] = [
+      "import react from '@vitejs/plugin-react'"
+    ];
   }
   if (!isLibrary && isR3f) {
     codeSnippets["import"] = [`import { Canvas } from "@react-three/fiber"`];
@@ -2592,6 +2781,9 @@ function generate(options) {
   const generator = {
     options: clonedOptions,
     versions,
+    isStealthConfig() {
+      return (clonedOptions.configStrategy ?? "stealth") === "stealth";
+    },
     addDependency(name2, semver) {
       dependencies[name2];
       dependencies[name2] = semver;
@@ -2648,7 +2840,10 @@ function generate(options) {
       generateTsdown(generator);
     }
     const packageManager2 = clonedOptions.packageManager ?? "pnpm";
-    generator.addScript("release", `${packageManager2} run build && ${packageManager2} publish`);
+    generator.addScript(
+      "release",
+      `${packageManager2} run build && ${packageManager2} publish`
+    );
   }
   const testing = clonedOptions.testing ?? (isLibrary ? "vitest" : "none");
   if (testing === "vitest") {
@@ -2741,9 +2936,24 @@ function generate(options) {
     };
     files[".gitattributes"] = { type: "text", content: GitAttributes };
   }
+  if (!isMonorepoPackage && clonedOptions.aiPlatforms?.length) {
+    generateAiFiles(files, {
+      name,
+      packageManager: clonedOptions.packageManager ?? "pnpm",
+      linter: clonedOptions.linter ?? "oxlint",
+      formatter: clonedOptions.formatter ?? "prettier",
+      isMonorepo: false,
+      configStrategy: clonedOptions.configStrategy,
+      platforms: clonedOptions.aiPlatforms
+    });
+  }
   return files;
 }
 
+exports.AI_PLATFORM_HINTS = AI_PLATFORM_HINTS;
+exports.AI_PLATFORM_LABELS = AI_PLATFORM_LABELS;
+exports.ALL_AI_PLATFORMS = ALL_AI_PLATFORMS;
+exports.detectTooling = detectTooling;
 exports.generate = generate;
 exports.generateAiFiles = generateAiFiles;
 exports.generateEslintConfigPackage = generateEslintConfigPackage;