create-krispya 0.5.0 → 0.5.2

package/dist/chunks/index.cjs

@@ -146,10 +146,7 @@ function generateTypescriptConfig(baseTemplateOrParams) {
   const tsConfig = {
     $schema: "https://json.schemastore.org/tsconfig",
     files: [],
-    references: [
-      { path: "./.config/tsconfig.app.json" },
-      { path: "./.config/tsconfig.node.json" }
-    ]
+    references: [{ path: "./.config/tsconfig.app.json" }, { path: "./.config/tsconfig.node.json" }]
   };
   files["tsconfig.json"] = {
     type: "text",
@@ -210,7 +207,8 @@ function generatePackageJson(params) {
     devDependencies,
     peerDependencies,
     scripts,
-    options
+    options,
+    workspaceDependencies
   } = params;
   const files = {};
   const packageManager = options.packageManager ?? "pnpm";
@@ -236,8 +234,14 @@ function generatePackageJson(params) {
     packageJson.files = ["dist"];
   }
   const sortKeys = (obj) => Object.fromEntries(Object.entries(obj).sort(([a], [b]) => a.localeCompare(b)));
+  const allDependencies = { ...dependencies };
+  if (workspaceDependencies && workspaceDependencies.length > 0) {
+    for (const pkgName of workspaceDependencies) {
+      allDependencies[pkgName] = "workspace:*";
+    }
+  }
   packageJson.scripts = scripts;
-  packageJson.dependencies = sortKeys(dependencies);
+  packageJson.dependencies = sortKeys(allDependencies);
   if (Object.keys(devDependencies).length > 0) {
     packageJson.devDependencies = sortKeys(devDependencies);
   }
@@ -252,6 +256,16 @@ function generatePackageJson(params) {
       const majorVersion = pnpmVersion.split(".")[0];
       engines.pnpm = `>=${majorVersion}.0.0`;
       packageJson.packageManager = `pnpm@${pnpmVersion}`;
+    } else if (packageManager === "yarn") {
+      const yarnVersion = options.yarnVersion ?? "4.6.0";
+      const majorVersion = yarnVersion.split(".")[0];
+      engines.yarn = `>=${majorVersion}.0.0`;
+      packageJson.packageManager = `yarn@${yarnVersion}`;
+    } else if (packageManager === "npm") {
+      const npmVersion = options.npmVersion ?? "11.0.0";
+      const majorVersion = npmVersion.split(".")[0];
+      engines.npm = `>=${majorVersion}.0.0`;
+      packageJson.packageManager = `npm@${npmVersion}`;
     }
     if (options.nodeVersion) {
       const majorVersion = options.nodeVersion.split(".")[0];
@@ -281,14 +295,7 @@ function generatePackageJson(params) {
 }
 
 function generateReadme(params) {
-  const {
-    name,
-    baseTemplate,
-    isLibrary,
-    libraryBundler,
-    packageManager,
-    codeSnippets
-  } = params;
+  const { name, baseTemplate, isLibrary, libraryBundler, packageManager, codeSnippets } = params;
   const isVanilla = baseTemplate === "vanilla";
   const isReact = baseTemplate === "react";
   const isR3f = baseTemplate === "r3f";
@@ -652,168 +659,128 @@ function generateViteConfig(params) {
   return { type: "text", content: viteConfigContent };
 }
 
-function generateMonorepo(params) {
-  const {
+function generateAiFiles(files, params) {
+  const { name, packageManager, linter, formatter, aiFiles } = params;
+  const content = getAiInstructionsContent({
     name,
-    linter,
-    formatter,
     packageManager,
-    pnpmVersion,
-    pnpmManageVersions,
-    nodeVersion
-  } = params;
-  const files = {};
-  const isPnpm = packageManager === "pnpm";
-  const devDependencies = {};
-  if (linter === "oxlint") {
-    devDependencies["oxlint"] = "^1.36.0";
-  } else if (linter === "eslint") {
-    devDependencies["eslint"] = "^9.17.0";
-  } else if (linter === "biome") {
-    devDependencies["@biomejs/biome"] = "^1.9.4";
-  }
-  if (formatter === "oxfmt") {
-    devDependencies["oxfmt"] = "^0.21.0";
-  } else if (formatter === "prettier") {
-    devDependencies["prettier"] = "^3.4.2";
-  }
-  const rootPackageJson = {
-    name: "root",
-    version: "0.0.0",
-    private: true,
-    type: "module",
-    scripts: {
-      dev: "pnpm --filter './apps/*' run dev",
-      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 ."
-    },
-    devDependencies
-  };
-  const engines = {};
-  if (isPnpm && pnpmVersion) {
-    const majorVersion = pnpmVersion.split(".")[0];
-    engines.pnpm = `>=${majorVersion}.0.0`;
-    rootPackageJson.packageManager = `pnpm@${pnpmVersion}`;
-  }
-  if (nodeVersion) {
-    const majorVersion = nodeVersion.split(".")[0];
-    engines.node = `>=${majorVersion}.0.0`;
-  }
-  if (Object.keys(engines).length > 0) {
-    rootPackageJson.engines = engines;
-  }
-  files["package.json"] = {
-    type: "text",
-    content: JSON.stringify(rootPackageJson, null, 2)
-  };
-  if (isPnpm) {
-    const workspaceLines = [];
-    if (pnpmManageVersions) {
-      workspaceLines.push("manage-package-manager-versions: true", "");
+    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;
     }
-    workspaceLines.push(
-      "packages:",
-      '  - ".config/*"',
-      '  - "apps/*"',
-      '  - "packages/*"',
-      ""
-    );
-    workspaceLines.push("onlyBuiltDependencies:", "  - esbuild");
-    files["pnpm-workspace.yaml"] = {
-      type: "text",
-      content: workspaceLines.join("\n")
-    };
   }
-  generateTypescriptConfigPackage(files);
-  if (linter === "oxlint") {
-    generateOxlintConfigPackage(files);
-  } else if (linter === "eslint") {
-    files["eslint.config.js"] = {
-      type: "text",
-      content: `export default [
-  // Add your ESLint rules here
-];
-`
-    };
-  } else if (linter === "biome") {
-    const biomeConfig = {
-      $schema: "https://biomejs.dev/schemas/1.9.4/schema.json",
-      vcs: {
-        enabled: true,
-        clientKind: "git",
-        useIgnoreFile: true
-      },
-      linter: {
-        enabled: true,
-        rules: {
-          recommended: true
-        }
-      },
-      formatter: {
-        enabled: formatter === "biome"
-      }
-    };
-    files["biome.json"] = {
-      type: "text",
-      content: JSON.stringify(biomeConfig, null, 2)
-    };
+}
+function getConfigPackagesDescription(linter, formatter) {
+  const packages = ["`@config/typescript`"];
+  if (linter !== "biome") {
+    packages.push(`\`@config/${linter}\``);
   }
-  if (formatter === "oxfmt") {
-    generateOxfmtConfigPackage(files);
-  } else if (formatter === "prettier") {
-    const prettierConfig = {
-      semi: true,
-      singleQuote: false,
-      trailingComma: "es5",
-      printWidth: 100
-    };
-    files[".prettierrc.json"] = {
-      type: "text",
-      content: JSON.stringify(prettierConfig, null, 2)
-    };
+  if (formatter !== "biome" && formatter !== linter) {
+    packages.push(`\`@config/${formatter}\``);
   }
-  files[".gitignore"] = {
-    type: "text",
-    content: ["node_modules", "dist", "*.tsbuildinfo", ".DS_Store"].join("\n")
-  };
-  files[".gitattributes"] = {
-    type: "text",
-    content: `* text=auto eol=lf
-*.{cmd,[cC][mM][dD]} text eol=crlf
-*.{bat,[bB][aA][tT]} text eol=crlf
-`
-  };
-  generateVscodeFiles(files, linter, formatter);
-  files["README.md"] = {
-    type: "text",
-    content: `# ${name}
+  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 monorepo workspace was generated with create-krispya.
+This is a pnpm monorepo workspace generated with \`create-krispya\`.
 
-## Structure
+## Most important rule (package creation)
 
-- \`apps/\` - Applications
-- \`packages/\` - Shared packages and libraries
-- \`.config/\` - Shared configuration packages
+If you need a new app/package for any reason, **ALWAYS** create it with \`create-krispya\` (do not hand-create folders/package.json).
 
-## Development Commands
+### Non-interactive (preferred for agents)
 
-- \`${packageManager} install\` to install all dependencies
-- \`${packageManager} run dev\` to run all applications in development mode
-- \`${packageManager} run build\` to build all packages and applications
-- \`${packageManager} run test\` to run tests across the workspace
-- \`${packageManager} run lint\` to lint all code
-- \`${packageManager} run format\` to format all code
+\`\`\`bash
+${packageManager} create krispya <name> --workspace [options]
+\`\`\`
 
-## Adding Packages
+- 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).
 
-To add a new package to this workspace, run create-krispya from this directory and it will detect the monorepo.
-`
-  };
-  return { files };
+### 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`] = {
@@ -892,123 +859,504 @@ In your package's \`tsconfig.json\`:
   };
   files[`${basePath}/node.json`] = {
     type: "text",
-    content: JSON.stringify(
-      {
-        $schema: "https://json.schemastore.org/tsconfig",
-        extends: "./base.json",
-        compilerOptions: {
-          lib: ["ESNext"]
-        }
-      },
-      null,
-      2
-    )
+    content: JSON.stringify(
+      {
+        $schema: "https://json.schemastore.org/tsconfig",
+        extends: "./base.json",
+        compilerOptions: {
+          lib: ["ESNext"]
+        }
+      },
+      null,
+      2
+    )
+  };
+  files[`${basePath}/react.json`] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        $schema: "https://json.schemastore.org/tsconfig",
+        extends: "./app.json",
+        compilerOptions: {
+          jsx: "react-jsx"
+        }
+      },
+      null,
+      2
+    )
+  };
+}
+function generateOxlintConfigPackage(files) {
+  const basePath = ".config/oxlint";
+  const { rules } = defaultLinterConfig;
+  files[`${basePath}/package.json`] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        name: "@config/oxlint",
+        version: "0.1.0",
+        private: true,
+        files: ["base.json", "react.json"]
+      },
+      null,
+      2
+    )
+  };
+  files[`${basePath}/README.md`] = {
+    type: "text",
+    content: `# \`@config/oxlint\`
+
+Shared oxlint configurations for the monorepo.
+
+## Usage
+
+Run oxlint with a config:
+
+\`\`\`bash
+oxlint -c node_modules/@config/oxlint/base.json
+\`\`\`
+
+## Available Configs
+
+- \`base.json\` - Base linting rules for TypeScript projects
+- \`react.json\` - Extends base with React-specific rules
+`
+  };
+  files[`${basePath}/base.json`] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        $schema: "./node_modules/oxlint/configuration_schema.json",
+        plugins: ["unicorn", "typescript", "oxc"],
+        rules: {
+          "no-unused-vars": [
+            rules.noUnusedVars.level,
+            {
+              argsIgnorePattern: rules.noUnusedVars.argsIgnorePattern,
+              varsIgnorePattern: rules.noUnusedVars.varsIgnorePattern,
+              caughtErrorsIgnorePattern: rules.noUnusedVars.caughtErrorsIgnorePattern
+            }
+          ],
+          "no-useless-escape": "off",
+          "no-unused-expressions": [
+            rules.noUnusedExpressions.level,
+            { allowShortCircuit: rules.noUnusedExpressions.allowShortCircuit }
+          ]
+        },
+        ignorePatterns: defaultLinterConfig.ignorePatterns
+      },
+      null,
+      2
+    )
+  };
+  files[`${basePath}/react.json`] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        $schema: "./node_modules/oxlint/configuration_schema.json",
+        plugins: ["unicorn", "typescript", "oxc", "react"],
+        rules: {
+          "no-unused-vars": [
+            rules.noUnusedVars.level,
+            {
+              argsIgnorePattern: rules.noUnusedVars.argsIgnorePattern,
+              varsIgnorePattern: rules.noUnusedVars.varsIgnorePattern,
+              caughtErrorsIgnorePattern: rules.noUnusedVars.caughtErrorsIgnorePattern
+            }
+          ],
+          "no-useless-escape": "off",
+          "no-unused-expressions": [
+            rules.noUnusedExpressions.level,
+            { allowShortCircuit: rules.noUnusedExpressions.allowShortCircuit }
+          ]
+        },
+        ignorePatterns: defaultLinterConfig.ignorePatterns
+      },
+      null,
+      2
+    )
+  };
+}
+function generateEslintConfigPackage(files) {
+  const basePath = ".config/eslint";
+  files[`${basePath}/package.json`] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        name: "@config/eslint",
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        exports: {
+          "./base": "./base.js",
+          "./react": "./react.js"
+        },
+        files: ["base.js", "react.js"],
+        devDependencies: {
+          "@eslint/js": "^9.17.0",
+          "typescript-eslint": "^8.18.0"
+        }
+      },
+      null,
+      2
+    )
+  };
+  files[`${basePath}/README.md`] = {
+    type: "text",
+    content: `# \`@config/eslint\`
+
+Shared ESLint configurations for the monorepo.
+
+## Usage
+
+In your package's \`eslint.config.js\`:
+
+\`\`\`js
+import base from "@config/eslint/base";
+
+export default [...base];
+\`\`\`
+
+Or for React projects:
+
+\`\`\`js
+import react from "@config/eslint/react";
+
+export default [...react];
+\`\`\`
+
+## Available Configs
+
+- \`base\` - Base linting rules for TypeScript projects
+- \`react\` - Extends base with React-specific rules
+`
+  };
+  files[`${basePath}/base.js`] = {
+    type: "text",
+    content: `import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        {
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_",
+          caughtErrorsIgnorePattern: "^_",
+        },
+      ],
+    },
+  },
+  {
+    ignores: ["dist/**", "node_modules/**"],
+  }
+);
+`
+  };
+  files[`${basePath}/react.js`] = {
+    type: "text",
+    content: `import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+
+export default tseslint.config(
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  {
+    rules: {
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        {
+          argsIgnorePattern: "^_",
+          varsIgnorePattern: "^_",
+          caughtErrorsIgnorePattern: "^_",
+        },
+      ],
+    },
+  },
+  {
+    ignores: ["dist/**", "node_modules/**"],
+  }
+);
+`
+  };
+}
+function generatePrettierConfigPackage(files) {
+  const basePath = ".config/prettier";
+  files[`${basePath}/package.json`] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        name: "@config/prettier",
+        version: "0.1.0",
+        private: true,
+        type: "module",
+        exports: {
+          ".": "./base.json"
+        },
+        files: ["base.json"]
+      },
+      null,
+      2
+    )
+  };
+  files[`${basePath}/README.md`] = {
+    type: "text",
+    content: `# \`@config/prettier\`
+
+Shared Prettier configuration for the monorepo.
+
+## Usage
+
+In your package's \`package.json\`:
+
+\`\`\`json
+{
+  "prettier": "@config/prettier"
+}
+\`\`\`
+
+Or in \`.prettierrc.json\`:
+
+\`\`\`json
+"@config/prettier"
+\`\`\`
+
+## Available Configs
+
+- Default export - Base formatter settings
+`
+  };
+  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
+    )
+  };
+}
+function generateOxfmtConfigPackage(files) {
+  const basePath = ".config/oxfmt";
+  files[`${basePath}/package.json`] = {
+    type: "text",
+    content: JSON.stringify(
+      {
+        name: "@config/oxfmt",
+        version: "0.1.0",
+        private: true,
+        files: ["base.json"]
+      },
+      null,
+      2
+    )
+  };
+  files[`${basePath}/README.md`] = {
+    type: "text",
+    content: `# \`@config/oxfmt\`
+
+Shared oxfmt (formatter) configuration for the monorepo.
+
+## Usage
+
+Run oxfmt with the config:
+
+\`\`\`bash
+oxfmt -c node_modules/@config/oxfmt/base.json --write .
+\`\`\`
+
+## Available Configs
+
+- \`base.json\` - Base formatter settings (Prettier-compatible)
+`
+  };
+  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
+    )
+  };
+}
+
+function generateMonorepo(params) {
+  const {
+    name,
+    linter,
+    formatter,
+    packageManager,
+    pnpmVersion,
+    pnpmManageVersions,
+    nodeVersion,
+    aiFiles
+  } = params;
+  const files = {};
+  const isPnpm = packageManager === "pnpm";
+  const devDependencies = {};
+  if (linter === "oxlint") {
+    devDependencies["oxlint"] = "^1.36.0";
+  } else if (linter === "eslint") {
+    devDependencies["eslint"] = "^9.17.0";
+  } else if (linter === "biome") {
+    devDependencies["@biomejs/biome"] = "^1.9.4";
+  }
+  if (formatter === "oxfmt") {
+    devDependencies["oxfmt"] = "^0.21.0";
+  } else if (formatter === "prettier") {
+    devDependencies["prettier"] = "^3.4.2";
+  }
+  const rootPackageJson = {
+    name: "root",
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    scripts: {
+      dev: "pnpm --filter './apps/*' run dev",
+      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 ."
+    },
+    devDependencies
+  };
+  const engines = {};
+  if (isPnpm && pnpmVersion) {
+    const majorVersion = pnpmVersion.split(".")[0];
+    engines.pnpm = `>=${majorVersion}.0.0`;
+    rootPackageJson.packageManager = `pnpm@${pnpmVersion}`;
+  }
+  if (nodeVersion) {
+    const majorVersion = nodeVersion.split(".")[0];
+    engines.node = `>=${majorVersion}.0.0`;
+  }
+  if (Object.keys(engines).length > 0) {
+    rootPackageJson.engines = engines;
+  }
+  files["package.json"] = {
+    type: "text",
+    content: JSON.stringify(rootPackageJson, null, 2)
   };
-  files[`${basePath}/react.json`] = {
-    type: "text",
-    content: JSON.stringify(
-      {
-        $schema: "https://json.schemastore.org/tsconfig",
-        extends: "./app.json",
-        compilerOptions: {
-          jsx: "react-jsx"
+  if (isPnpm) {
+    const workspaceLines = [];
+    if (pnpmManageVersions) {
+      workspaceLines.push("manage-package-manager-versions: true", "");
+    }
+    workspaceLines.push(
+      "packages:",
+      '  - ".config/*"',
+      '  - "apps/*"',
+      '  - "packages/*"',
+      ""
+    );
+    workspaceLines.push("onlyBuiltDependencies:", "  - esbuild");
+    files["pnpm-workspace.yaml"] = {
+      type: "text",
+      content: workspaceLines.join("\n")
+    };
+  }
+  generateTypescriptConfigPackage(files);
+  if (linter === "oxlint") {
+    generateOxlintConfigPackage(files);
+  } else if (linter === "eslint") {
+    generateEslintConfigPackage(files);
+  } else if (linter === "biome") {
+    const biomeConfig = {
+      $schema: "https://biomejs.dev/schemas/1.9.4/schema.json",
+      vcs: {
+        enabled: true,
+        clientKind: "git",
+        useIgnoreFile: true
+      },
+      linter: {
+        enabled: true,
+        rules: {
+          recommended: true
         }
       },
-      null,
-      2
-    )
+      formatter: {
+        enabled: formatter === "biome"
+      }
+    };
+    files["biome.json"] = {
+      type: "text",
+      content: JSON.stringify(biomeConfig, null, 2)
+    };
+  }
+  if (formatter === "oxfmt") {
+    generateOxfmtConfigPackage(files);
+  } else if (formatter === "prettier") {
+    generatePrettierConfigPackage(files);
+  }
+  files[".gitignore"] = {
+    type: "text",
+    content: ["node_modules", "dist", "*.tsbuildinfo", ".DS_Store"].join("\n")
   };
-}
-function generateOxlintConfigPackage(files) {
-  const basePath = ".config/oxlint";
-  const { rules } = defaultLinterConfig;
-  files[`${basePath}/package.json`] = {
+  files[".gitattributes"] = {
     type: "text",
-    content: JSON.stringify(
-      {
-        name: "@config/oxlint",
-        version: "0.1.0",
-        private: true,
-        files: ["base.json", "react.json"]
-      },
-      null,
-      2
-    )
+    content: `* text=auto eol=lf
+*.{cmd,[cC][mM][dD]} text eol=crlf
+*.{bat,[bB][aA][tT]} text eol=crlf
+`
   };
-  files[`${basePath}/README.md`] = {
+  generateVscodeFiles(files, linter, formatter);
+  files["README.md"] = {
     type: "text",
-    content: `# \`@config/oxlint\`
+    content: `# ${name}
 
-Shared oxlint configurations for the monorepo.
+This monorepo workspace was generated with create-krispya.
 
-## Usage
+## Structure
 
-Run oxlint with a config:
+- \`apps/\` - Applications
+- \`packages/\` - Shared packages and libraries
+- \`.config/\` - Shared configuration packages
 
-\`\`\`bash
-oxlint -c node_modules/@config/oxlint/base.json
-\`\`\`
+## Development Commands
 
-## Available Configs
+- \`${packageManager} install\` to install all dependencies
+- \`${packageManager} run dev\` to run all applications in development mode
+- \`${packageManager} run build\` to build all packages and applications
+- \`${packageManager} run test\` to run tests across the workspace
+- \`${packageManager} run lint\` to lint all code
+- \`${packageManager} run format\` to format all code
 
-- \`base.json\` - Base linting rules for TypeScript projects
-- \`react.json\` - Extends base with React-specific rules
+## Adding Packages
+
+To add a new package to this workspace, run create-krispya from this directory and it will detect the monorepo.
 `
   };
-  files[`${basePath}/base.json`] = {
-    type: "text",
-    content: JSON.stringify(
-      {
-        $schema: "./node_modules/oxlint/configuration_schema.json",
-        plugins: ["unicorn", "typescript", "oxc"],
-        rules: {
-          "no-unused-vars": [
-            rules.noUnusedVars.level,
-            {
-              argsIgnorePattern: rules.noUnusedVars.argsIgnorePattern,
-              varsIgnorePattern: rules.noUnusedVars.varsIgnorePattern,
-              caughtErrorsIgnorePattern: rules.noUnusedVars.caughtErrorsIgnorePattern
-            }
-          ],
-          "no-useless-escape": "off",
-          "no-unused-expressions": [
-            rules.noUnusedExpressions.level,
-            { allowShortCircuit: rules.noUnusedExpressions.allowShortCircuit }
-          ]
-        },
-        ignorePatterns: defaultLinterConfig.ignorePatterns
-      },
-      null,
-      2
-    )
-  };
-  files[`${basePath}/react.json`] = {
-    type: "text",
-    content: JSON.stringify(
-      {
-        $schema: "./node_modules/oxlint/configuration_schema.json",
-        plugins: ["unicorn", "typescript", "oxc", "react"],
-        rules: {
-          "no-unused-vars": [
-            rules.noUnusedVars.level,
-            {
-              argsIgnorePattern: rules.noUnusedVars.argsIgnorePattern,
-              varsIgnorePattern: rules.noUnusedVars.varsIgnorePattern,
-              caughtErrorsIgnorePattern: rules.noUnusedVars.caughtErrorsIgnorePattern
-            }
-          ],
-          "no-useless-escape": "off",
-          "no-unused-expressions": [
-            rules.noUnusedExpressions.level,
-            { allowShortCircuit: rules.noUnusedExpressions.allowShortCircuit }
-          ]
-        },
-        ignorePatterns: defaultLinterConfig.ignorePatterns
-      },
-      null,
-      2
-    )
-  };
+  if (aiFiles && aiFiles.length > 0) {
+    generateAiFiles(files, {
+      name,
+      packageManager,
+      linter,
+      formatter,
+      aiFiles
+    });
+  }
+  return { files };
 }
 function generateVscodeFiles(files, linter, formatter) {
   const recommendations = [];
@@ -1034,8 +1382,12 @@ function generateVscodeFiles(files, linter, formatter) {
       recommendations.push("oxc.oxc-vscode");
     }
     settings["editor.defaultFormatter"] = "oxc.oxc-vscode";
-    settings["[json]"] = { "editor.defaultFormatter": "vscode.json-language-features" };
-    settings["[jsonc]"] = { "editor.defaultFormatter": "vscode.json-language-features" };
+    settings["[json]"] = {
+      "editor.defaultFormatter": "vscode.json-language-features"
+    };
+    settings["[jsonc]"] = {
+      "editor.defaultFormatter": "vscode.json-language-features"
+    };
   } else if (formatter === "prettier") {
     recommendations.push("esbenp.prettier-vscode");
     settings["editor.defaultFormatter"] = "esbenp.prettier-vscode";
@@ -1054,62 +1406,16 @@ function generateVscodeFiles(files, linter, formatter) {
     content: JSON.stringify(settings, null, "	")
   };
 }
-function generateOxfmtConfigPackage(files) {
-  const basePath = ".config/oxfmt";
-  files[`${basePath}/package.json`] = {
-    type: "text",
-    content: JSON.stringify(
-      {
-        name: "@config/oxfmt",
-        version: "0.1.0",
-        private: true,
-        files: ["base.json"]
-      },
-      null,
-      2
-    )
-  };
-  files[`${basePath}/README.md`] = {
-    type: "text",
-    content: `# \`@config/oxfmt\`
-
-Shared oxfmt (formatter) configuration for the monorepo.
-
-## Usage
-
-Run oxfmt with the config:
-
-\`\`\`bash
-oxfmt -c node_modules/@config/oxfmt/base.json --write .
-\`\`\`
-
-## Available Configs
-
-- \`base.json\` - Base formatter settings (Prettier-compatible)
-`
-  };
-  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
-    )
-  };
-}
 
 const monorepo = {
   __proto__: null,
-  generateMonorepo: generateMonorepo
+  generateEslintConfigPackage: generateEslintConfigPackage,
+  generateMonorepo: generateMonorepo,
+  generateOxfmtConfigPackage: generateOxfmtConfigPackage,
+  generateOxlintConfigPackage: generateOxlintConfigPackage,
+  generatePrettierConfigPackage: generatePrettierConfigPackage,
+  generateTypescriptConfigPackage: generateTypescriptConfigPackage,
+  generateVscodeFiles: generateVscodeFiles
 };
 
 function toBiomeLevel(level) {
@@ -1366,10 +1672,7 @@ jobs:
         uses: actions/deploy-pages@v4
 `
   });
-  generator.inject(
-    "readme-start",
-    `A github pages deployment action is configurd.`
-  );
+  generator.inject("readme-start", `A github pages deployment action is configurd.`);
   if (generator.options.githubUserName != null && generator.options.githubRepoName != null) {
     const address = `${generator.options.githubUserName}.github.io/${generator.options.githubRepoName}`;
     generator.inject(
@@ -2041,7 +2344,9 @@ function merge(target, modification) {
 
 async function getLatestNpmVersion(packageName, fallback) {
   try {
-    const response = await fetch(`https://registry.npmjs.org/${packageName}/latest`);
+    const response = await fetch(
+      `https://registry.npmjs.org/${packageName}/latest`
+    );
     const data = await response.json();
     return data.version;
   } catch {
@@ -2051,6 +2356,12 @@ async function getLatestNpmVersion(packageName, fallback) {
 async function getLatestPnpmVersion() {
   return getLatestNpmVersion("pnpm", "10.11.0");
 }
+async function getLatestYarnVersion() {
+  return getLatestNpmVersion("yarn", "4.6.0");
+}
+async function getLatestNpmCliVersion() {
+  return getLatestNpmVersion("npm", "11.0.0");
+}
 async function getLatestNodeVersion() {
   try {
     const response = await fetch("https://nodejs.org/dist/index.json");
@@ -2064,6 +2375,70 @@ async function getLatestNodeVersion() {
     return "22.0.0";
   }
 }
+function validateNameSegment(segment, label) {
+  if (!segment.length) {
+    return `${label} is required`;
+  }
+  if (!/^[a-z0-9-]+$/.test(segment)) {
+    return `${label} must be lowercase and contain only letters, numbers, and hyphens`;
+  }
+  if (segment.startsWith("-") || segment.endsWith("-")) {
+    return `${label} cannot start or end with a hyphen`;
+  }
+  if (segment.includes("--")) {
+    return `${label} cannot contain consecutive hyphens`;
+  }
+  return void 0;
+}
+function validatePackageName(name) {
+  if (!name.length) {
+    return "Package name is required";
+  }
+  if (name.includes("..") || name.includes("\\")) {
+    return "Package name cannot contain path traversal sequences";
+  }
+  if (name.startsWith("@")) {
+    const slashIndex = name.indexOf("/");
+    if (slashIndex === -1) {
+      return "Scoped package name must include a package name after the scope (e.g., @scope/name)";
+    }
+    if (name.indexOf("/", slashIndex + 1) !== -1) {
+      return "Package name can only have one slash for scoped packages";
+    }
+    const scope = name.slice(1, slashIndex);
+    const packageName = name.slice(slashIndex + 1);
+    const scopeError = validateNameSegment(scope, "Scope");
+    if (scopeError) return scopeError;
+    const nameError = validateNameSegment(packageName, "Package name");
+    if (nameError) return nameError;
+    return void 0;
+  }
+  if (name.includes("/")) {
+    return "Unscoped package name cannot contain slashes. Use @scope/name format for scoped packages";
+  }
+  return validateNameSegment(name, "Package name");
+}
+function parseWorkspaceYamlContent(content) {
+  const directories = [];
+  let inPackagesSection = false;
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (trimmed === "packages:") {
+      inPackagesSection = true;
+      continue;
+    }
+    if (inPackagesSection && trimmed && !line.startsWith(" ") && !line.startsWith("	") && !trimmed.startsWith("-")) {
+      break;
+    }
+    if (inPackagesSection && trimmed.startsWith("-")) {
+      const entry = trimmed.slice(1).trim().replace(/^["']|["']$/g, "").replace(/^\.\//, "").replace(/\/\*.*$/, "");
+      if (entry && !entry.startsWith(".")) {
+        directories.push(entry);
+      }
+    }
+  }
+  return directories;
+}
 function generateRandomName() {
   const adjectives = [
     "red",
@@ -2352,7 +2727,8 @@ function generate(options) {
       devDependencies,
       peerDependencies,
       scripts,
-      options: clonedOptions
+      options: clonedOptions,
+      workspaceDependencies: clonedOptions.workspaceDependencies
     }).files
   );
   if (!isMonorepoPackage) {
@@ -2369,11 +2745,22 @@ function generate(options) {
 }
 
 exports.generate = generate;
+exports.generateAiFiles = generateAiFiles;
+exports.generateEslintConfigPackage = generateEslintConfigPackage;
 exports.generateMonorepo = generateMonorepo;
+exports.generateOxfmtConfigPackage = generateOxfmtConfigPackage;
+exports.generateOxlintConfigPackage = generateOxlintConfigPackage;
+exports.generatePrettierConfigPackage = generatePrettierConfigPackage;
 exports.generateRandomName = generateRandomName;
+exports.generateTypescriptConfigPackage = generateTypescriptConfigPackage;
+exports.generateVscodeFiles = generateVscodeFiles;
 exports.getBaseTemplate = getBaseTemplate;
 exports.getLanguageFromTemplate = getLanguageFromTemplate;
 exports.getLatestNodeVersion = getLatestNodeVersion;
+exports.getLatestNpmCliVersion = getLatestNpmCliVersion;
 exports.getLatestNpmVersion = getLatestNpmVersion;
 exports.getLatestPnpmVersion = getLatestPnpmVersion;
+exports.getLatestYarnVersion = getLatestYarnVersion;
 exports.monorepo = monorepo;
+exports.parseWorkspaceYamlContent = parseWorkspaceYamlContent;
+exports.validatePackageName = validatePackageName;