@modern-js/create 3.9.3 → 3.10.0

package/dist/index.js

@@ -21,12 +21,13 @@ function getLocaleLanguage() {
     const detector = new I18CLILanguageDetector();
     return detector.detect();
 }
-const CLAUDE_IMPORT = '@AGENTS.md';
 const markers = (name)=>({
         begin: `<!-- BEGIN:${name} -->`,
         end: `<!-- END:${name} -->`
     });
-function applyAgentsMd(targetDir, block, markerName) {
+function applyAgentsMd(options) {
+    const { targetDir, block, markerName } = options;
+    if (!node_fs.existsSync(targetDir)) throw new Error(`target directory does not exist: ${targetDir}`);
     const { begin, end } = markers(markerName);
     const file = node_path.join(targetDir, 'AGENTS.md');
     if (!node_fs.existsSync(file)) {
@@ -46,25 +47,6 @@ function applyAgentsMd(targetDir, block, markerName) {
     node_fs.writeFileSync(file, rest ? `${block}\n\n${rest}` : `${block}\n`, 'utf-8');
     return 'added';
 }
-function applyClaudeMd(targetDir) {
-    const file = node_path.join(targetDir, 'CLAUDE.md');
-    if (!node_fs.existsSync(file)) {
-        node_fs.writeFileSync(file, `${CLAUDE_IMPORT}\n`, 'utf-8');
-        return 'created';
-    }
-    const content = node_fs.readFileSync(file, 'utf-8');
-    if (content.split('\n').some((line)=>line.trim() === CLAUDE_IMPORT)) return 'unchanged';
-    node_fs.writeFileSync(file, `${CLAUDE_IMPORT}\n\n${content.replace(/^\s*/, '')}`, 'utf-8');
-    return 'linked';
-}
-function applyAgentFiles(options) {
-    const { targetDir, block, markerName } = options;
-    if (!node_fs.existsSync(targetDir)) throw new Error(`target directory does not exist: ${targetDir}`);
-    return {
-        agents: applyAgentsMd(targetDir, block, markerName),
-        claude: applyClaudeMd(targetDir)
-    };
-}
 const PKG = '@modern-js/app-tools';
 const DOCS_PATH = 'node_modules/@modern-js/app-tools/docs/';
 const BUNDLED_SINCE = '3.8.0';
@@ -569,7 +551,7 @@ const EN_LOCALE = {
     message: {
         welcome: '🚀 Welcome to Modern.js',
         success: '✨ Created successfully!',
-        agentsMd: '✔ AGENTS.md & CLAUDE.md generated — AI coding agents will pick them up automatically. (--no-agents-md to skip)',
+        agentsMd: '✔ AGENTS.md generated — AI coding agents will read it automatically. (--no-agents-md to skip)',
         nextSteps: '📋 Next steps:',
         step1: 'cd {projectName}',
         step2: 'pnpm install',
@@ -579,7 +561,6 @@ const EN_LOCALE = {
         created: '✔ Created {file}',
         updatedBlock: '✔ Updated the modernjs-agent-rules block in {file}',
         addedBlock: '✔ Added the modernjs-agent-rules block to the top of {file}',
-        linked: '✔ Added the `@AGENTS.md` import to {file}',
         unchanged: '• {file} is already up to date',
         done: '✨ Done — AI coding agents will read {location}.',
         targetNotFound: 'Error: target directory "{dir}" does not exist',
@@ -596,13 +577,13 @@ const EN_LOCALE = {
         optionVersion: '  -v, --version  Display version information',
         optionLang: '  -l, --lang     Set the language (zh or en)',
         optionSub: '  -s, --sub       Mark as a subproject (package in monorepo)',
-        optionNoAgentsMd: '  --no-agents-md  Skip generating AGENTS.md / CLAUDE.md for AI coding agents',
-        optionAgentsMdOnly: '  --agents-md-only  Only add/refresh AGENTS.md / CLAUDE.md in the current project (no scaffolding)',
+        optionNoAgentsMd: '  --no-agents-md  Skip generating AGENTS.md for AI coding agents',
+        optionAgentsMdOnly: '  --agents-md-only  Only add/refresh AGENTS.md in the current project (no scaffolding)',
         examples: '💡 Examples:',
         example1: '  create my-app',
         example2: '  create my-app --lang zh',
         example3: '  create my-app --sub',
-        example4: '  create --agents-md-only   (add/refresh AGENTS.md & CLAUDE.md in an existing project)',
+        example4: '  create --agents-md-only   (add/refresh AGENTS.md in an existing project)',
         moreInfo: '📚 Learn more: https://modernjs.dev'
     },
     version: {
@@ -622,7 +603,7 @@ const ZH_LOCALE = {
     message: {
         welcome: '🚀 欢迎使用 Modern.js',
         success: '✨ 创建成功！',
-        agentsMd: '✔ 已生成 AGENTS.md 和 CLAUDE.md —— AI 编码助手会自动读取。（--no-agents-md 可跳过）',
+        agentsMd: '✔ 已生成 AGENTS.md —— AI 编码助手会自动读取。（--no-agents-md 可跳过）',
         nextSteps: '📋 下一步：',
         step1: 'cd {projectName}',
         step2: 'pnpm install',
@@ -632,7 +613,6 @@ const ZH_LOCALE = {
         created: '✔ 已创建 {file}',
         updatedBlock: '✔ 已更新 {file} 中的 modernjs-agent-rules 块',
         addedBlock: '✔ 已在 {file} 顶部添加 modernjs-agent-rules 块',
-        linked: '✔ 已向 {file} 添加 `@AGENTS.md` 引用',
         unchanged: '• {file} 已是最新',
         done: '✨ 完成 —— AI 编码助手会读取 {location}。',
         targetNotFound: '错误: 目标目录 "{dir}" 不存在',
@@ -649,13 +629,13 @@ const ZH_LOCALE = {
         optionVersion: '  -v, --version  显示版本信息',
         optionLang: '  -l, --lang     设置语言 (zh 或 en)',
         optionSub: '  -s, --sub       标记为子项目（monorepo 中的子包）',
-        optionNoAgentsMd: '  --no-agents-md  跳过生成 AGENTS.md / CLAUDE.md（AI 编码助手指引文件）',
-        optionAgentsMdOnly: '  --agents-md-only  仅为当前项目补齐/更新 AGENTS.md / CLAUDE.md（不创建项目）',
+        optionNoAgentsMd: '  --no-agents-md  跳过生成 AGENTS.md（AI 编码助手指引文件）',
+        optionAgentsMdOnly: '  --agents-md-only  仅为当前项目补齐/更新 AGENTS.md（不创建项目）',
         examples: '💡 示例:',
         example1: '  create my-app',
         example2: '  create my-app --lang zh',
         example3: '  create my-app --sub',
-        example4: '  create --agents-md-only   (为已有项目补齐/更新 AGENTS.md 和 CLAUDE.md)',
+        example4: '  create --agents-md-only   (为已有项目补齐/更新 AGENTS.md)',
         moreInfo: '📚 更多信息: https://modernjs.dev'
     },
     version: {
@@ -674,11 +654,6 @@ const AGENTS_MESSAGES = {
     added: localeKeys.agentsCmd.addedBlock,
     unchanged: localeKeys.agentsCmd.unchanged
 };
-const CLAUDE_MESSAGES = {
-    created: localeKeys.agentsCmd.created,
-    linked: localeKeys.agentsCmd.linked,
-    unchanged: localeKeys.agentsCmd.unchanged
-};
 function runAgentsMd(_templateDir, targetDir) {
     if (!node_fs.existsSync(targetDir)) {
         console.error(i18n.t(localeKeys.agentsCmd.targetNotFound, {
@@ -696,17 +671,14 @@ function runAgentsMd(_templateDir, targetDir) {
         since: "3.8.0"
     }));
     const block = buildBlock(MARKER_NAME);
-    const result = applyAgentFiles({
+    const result = applyAgentsMd({
         targetDir,
         block,
         markerName: MARKER_NAME
     });
-    console.log(i18n.t(AGENTS_MESSAGES[result.agents], {
+    console.log(i18n.t(AGENTS_MESSAGES[result], {
         file: 'AGENTS.md'
     }));
-    console.log(i18n.t(CLAUDE_MESSAGES[result.claude], {
-        file: 'CLAUDE.md'
-    }));
     console.log('');
     console.log(i18n.t(localeKeys.agentsCmd.done, {
         location: DOCS_PATH
@@ -883,19 +855,6 @@ async function main() {
     const targetPackageJson = node_path.join(targetDir, 'package.json');
     const packageJson = JSON.parse(node_fs.readFileSync(targetPackageJson, 'utf-8'));
     packageJson.name = projectName;
-    if (isSubproject) {
-        delete packageJson['lint-staged'];
-        delete packageJson['simple-git-hooks'];
-        if (packageJson.scripts) {
-            delete packageJson.scripts.prepare;
-            delete packageJson.scripts.lint;
-        }
-        if (packageJson.devDependencies) {
-            delete packageJson.devDependencies['lint-staged'];
-            delete packageJson.devDependencies['simple-git-hooks'];
-            delete packageJson.devDependencies['@biomejs/biome'];
-        }
-    }
     node_fs.writeFileSync(targetPackageJson, `${JSON.stringify(packageJson, null, 2)}\n`);
     const dim = '\x1b[2m\x1b[3m';
     const reset = '\x1b[0m';
@@ -913,16 +872,13 @@ function copyTemplate(src, dest, options) {
         recursive: true
     });
     const excludeInSubproject = [
+        '.rstack',
+        '.vscode',
         '.gitignore.handlebars',
-        'biome.json',
+        'rstack.config.mts',
         '.npmrc',
         '.nvmrc',
-        'AGENTS.md',
-        'CLAUDE.md'
-    ];
-    const agentFiles = [
-        'AGENTS.md',
-        'CLAUDE.md'
+        'AGENTS.md'
     ];
     function copyRecursive(srcDir, destDir) {
         const entries = node_fs.readdirSync(srcDir, {
@@ -930,7 +886,7 @@ function copyTemplate(src, dest, options) {
         });
         for (const entry of entries){
             if (options.isSubproject && excludeInSubproject.includes(entry.name)) continue;
-            if (options.noAgentsMd && agentFiles.includes(entry.name)) continue;
+            if (options.noAgentsMd && 'AGENTS.md' === entry.name) continue;
             const srcPath = node_path.join(srcDir, entry.name);
             let destPath = node_path.join(destDir, entry.name);
             if (entry.isDirectory()) {

package/package.json

@@ -19,7 +19,7 @@
   "engines": {
     "node": ">=20"
   },
-  "version": "3.9.3",
+  "version": "3.10.0",
   "main": "./dist/index.js",
   "bin": {
     "create": "./bin/run.js"
@@ -33,11 +33,10 @@
     "bin.js"
   ],
   "devDependencies": {
-    "@rslib/core": "1.0.1",
     "@types/node": "^20",
     "tsx": "^4.23.15",
     "typescript": "^5",
-    "@modern-js/i18n-utils": "3.9.3",
+    "@modern-js/i18n-utils": "3.10.0",
     "@modern-js/rslib": "2.68.10",
     "@scripts/rstest-config": "2.66.0"
   },
@@ -46,8 +45,8 @@
     "access": "public"
   },
   "scripts": {
-    "build": "rslib build",
-    "dev": "rslib build -w",
+    "build": "rs lib",
+    "dev": "rs lib -w",
     "start": "node ./dist/index.js",
     "test": "rstest"
   }

package/template/.rstack/hooks/pre-commit

@@ -0,0 +1,3 @@
+#!/usr/bin/env sh
+
+rs staged

package/template/.vscode/extensions.json

@@ -0,0 +1,3 @@
+{
+  "recommendations": ["rstack.rstack"]
+}

package/template/AGENTS.md

@@ -18,3 +18,11 @@ from memory on Modern.js configuration, APIs or directory conventions.
 - Installing ordinary npm packages (unrelated to Modern.js)
 
 <!-- END:modernjs-agent-rules -->
+
+# Rstack CLI
+
+This project uses Rstack CLI as its JS toolchain:
+
+- Read the docs linked from `node_modules/rstack/docs/llms.txt` when needed
+- Online docs: https://rstack.rs/llms.txt
+- Run `rs -h` for CLI help

package/template/README.md

@@ -10,10 +10,10 @@ pnpm install
 
 ## Get Started
 
-Start the start server:
+Start the development server:
 
 ```bash
-pnpm start
+pnpm dev
 ```
 
 Build the app for production:
@@ -29,4 +29,3 @@ pnpm serve
 ```
 
 For more information, see the [Modern.js documentation](https://modernjs.dev/en).
-

package/template/package.json.handlebars

@@ -5,10 +5,13 @@
     "dev": "modern dev",
     "build": "modern build",
     "serve": "modern serve"{{#unless isSubproject}},
-    "lint": "biome check"{{/unless}}
+    "prepare": "rs hooks",
+    "check": "rs check",
+    "lint": "rs lint",
+    "format": "rs fmt"{{/unless}}
   },
   "engines": {
-    "node": ">=20"
+    "node": "^22.18.0 || >=24.3.0"
   },
   "dependencies": {
     "@modern-js/runtime": "{{version}}",
@@ -18,7 +21,7 @@
   "devDependencies": {
     "@modern-js/app-tools": "{{version}}",
     "@modern-js/tsconfig": "{{version}}"{{#unless isSubproject}},
-    "@biomejs/biome": "1.9.4"{{/unless}},
+    "rstack": "0.8.2"{{/unless}},
     "typescript": "~5.7.3",
     "@types/node": "^20",
     "@types/react": "^19.1.8",

package/template/rstack.config.mts

@@ -0,0 +1,13 @@
+// Configuration guide: https://rstack.rs/config
+import { define } from 'rstack';
+
+define.lint(({ js, ts }) => [js.configs.recommended, ts.configs.recommended]);
+
+define.staged({
+  '*.{js,jsx,ts,tsx,cjs,mjs,cts,mts}': ['rs lint', 'rs fmt'],
+  '*.{md,mdx,json,json5,yml,yaml,css,less,scss,html}': 'rs fmt',
+});
+
+define.fmt({
+  singleQuote: true,
+});

package/template/src/routes/index.css

@@ -2,7 +2,12 @@ html,
 body {
   padding: 0;
   margin: 0;
-  font-family: PingFang SC, Hiragino Sans GB, Microsoft YaHei, Arial, sans-serif;
+  font-family:
+    PingFang SC,
+    Hiragino Sans GB,
+    Microsoft YaHei,
+    Arial,
+    sans-serif;
   background: linear-gradient(to bottom, transparent, #fff) #eceeef;
 }
 
@@ -65,8 +70,14 @@ main {
   padding: 0.6rem 0.9rem;
   font-size: 1.05rem;
   font-family:
-    Menlo, Monaco, Lucida Console, Liberation Mono, DejaVu Sans Mono,
-    Bitstream Vera Sans Mono, Courier New, monospace;
+    Menlo,
+    Monaco,
+    Lucida Console,
+    Liberation Mono,
+    DejaVu Sans Mono,
+    Bitstream Vera Sans Mono,
+    Courier New,
+    monospace;
 }
 
 .container-box .grid {

package/template/tsconfig.json

@@ -1,6 +1,7 @@
 {
   "extends": "@modern-js/tsconfig/base",
   "compilerOptions": {
+    "types": ["@modern-js/app-tools/types"],
     "declaration": false,
     "jsx": "preserve",
     "baseUrl": "./",

package/template/CLAUDE.md

@@ -1 +0,0 @@
-@AGENTS.md

package/template/biome.json

@@ -1,37 +0,0 @@
-{
-  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
-  "vcs": {
-    "enabled": true,
-    "defaultBranch": "main",
-    "clientKind": "git",
-    "useIgnoreFile": true
-  },
-  "formatter": {
-    "enabled": true,
-    "indentStyle": "space"
-  },
-  "javascript": {
-    "formatter": {
-      "quoteStyle": "single",
-      "arrowParentheses": "asNeeded",
-      "jsxQuoteStyle": "double",
-      "lineWidth": 80
-    }
-  },
-  "linter": {
-    "enabled": true,
-    "rules": {
-      "recommended": true,
-      "suspicious": {
-        "noDuplicateFontNames": "off"
-      }
-    }
-  },
-  "organizeImports": {
-    "enabled": true
-  },
-  "files": {
-    "ignoreUnknown": true,
-    "ignore": [".vscode/**/*", "node_modules/**/*", "dist/**/*"]
-  }
-}

package/template/src/modern-app-env.d.ts

@@ -1 +0,0 @@
-/// <reference types='@modern-js/app-tools/types' />