@qlover/create-app 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @qlover/create-app
 
+## 0.6.3
+
+### Patch Changes
+
+#### ✨ Features
+
+- **react-app:** add comprehensive documentation for Bootstrap, environment variable injection, global variable injection, and IOC container ([6c9b8e2](https://github.com/qlover/fe-base/commit/6c9b8e220b4b246f4593f25bc6830381157c0744)) ([#473](https://github.com/qlover/fe-base/pull/473))
+  - Introduced detailed documentation for the Bootstrap system, explaining its purpose, implementation, and advantages in managing application initialization logic.
+  - Added sections on environment variable injection, outlining the process and configuration for managing different environments.
+  - Documented the global variable injection mechanism, detailing how core services can be accessed globally within the application.
+  - Included a thorough explanation of the IOC container, its implementation, and best practices for dependency management.
+
+  These additions aim to enhance developer understanding and usability of the framework, promoting best practices in application architecture.
+
+- **react-app:** enhance project documentation and update scripts ([2a07fc8](https://github.com/qlover/fe-base/commit/2a07fc82647b4965121df9c6d70cd5d1841ad2d4)) ([#473](https://github.com/qlover/fe-base/pull/473))
+  - Added a comprehensive English README file to provide an overview of the React app template, including features, requirements, and project structure.
+  - Introduced a new documentation structure with detailed guides on Bootstrap, environment variable injection, global variable injection, and the IOC container.
+  - Updated the existing Chinese README to include links to the new English documentation and expanded sections on development guidelines and core functionalities.
+  - Modified the package.json to include additional directories in the Prettier configuration for improved formatting.
+  - Enhanced CSS files for better readability and maintainability by formatting CSS variables.
+
+  These changes aim to improve developer experience and provide clearer guidance on using the React app template effectively.
+
+#### ♻️ Refactors
+
+- **react-app:** enhance build process and update TypeScript configurations ([c2065b9](https://github.com/qlover/fe-base/commit/c2065b9ac847fb53776b871fc5bf62ac948801b6)) ([#473](https://github.com/qlover/fe-base/pull/473))
+  - Updated the build script in package.json to run linting before building the project.
+  - Modified tsconfig files to exclude node_modules and dist directories, improving TypeScript compilation efficiency.
+  - Introduced a new IOCIdentifier.ts file to centralize dependency identifiers.
+  - Refactored imports across various files to utilize the new IOCIdentifier.
+  - Removed obsolete ApiTransactionInterface and RequestCatcherInterface files to streamline the codebase.
+  - Implemented a new InversifyContainer class for better dependency injection management.
+
+  These changes aim to improve the overall structure, maintainability, and build process of the react-app template.
+
 ## 0.6.2
 
 ### Patch Changes

package/dist/index.cjs

@@ -8,4 +8,4 @@ ${t}`,dn=Object.getOwnPropertyDescriptor(Function.prototype,"toString"),_n=Objec
 `))this.#e+=Math.max(1,Math.ceil(Ye(D,{countAnsiEscapeCodes:!0})/t))}get isEnabled(){return this.#a&&!this.#F}set isEnabled(t){if(typeof t!="boolean")throw new TypeError("The `isEnabled` option must be a boolean");this.#a=t}get isSilent(){return this.#F}set isSilent(t){if(typeof t!="boolean")throw new TypeError("The `isSilent` option must be a boolean");this.#F=t}frame(){let t=Date.now();(this.#i===-1||t-this.#c>=this.interval)&&(this.#i=++this.#i%this.#D.frames.length,this.#c=t);let{frames:r}=this.#D,u=r[this.#i];this.color&&(u=d[this.color](u));let i=typeof this.#s=="string"&&this.#s!==""?this.#s+" ":"",D=typeof this.text=="string"?" "+this.text:"",o=typeof this.#o=="string"&&this.#o!==""?" "+this.#o:"";return i+u+D+o}clear(){if(!this.#a||!this.#u.isTTY)return this;this.#u.cursorTo(0);for(let t=0;t<this.#n;t++)t>0&&this.#u.moveCursor(0,-1),this.#u.clearLine(1);return(this.#l||this.lastIndent!==this.#l)&&this.#u.cursorTo(this.#l),this.lastIndent=this.#l,this.#n=0,this}render(){return this.#F?this:(this.clear(),this.#u.write(this.frame()),this.#n=this.#e,this)}start(t){return t&&(this.text=t),this.#F?this:this.#a?this.isSpinning?this:(this.#t.hideCursor&&$e.hide(this.#u),this.#t.discardStdin&&V.default.stdin.isTTY&&(this.#r=!0,Je.start()),this.render(),this.#f=setInterval(this.render.bind(this),this.interval),this):(this.text&&this.#u.write(`- ${this.text}
 `),this)}stop(){return this.#a?(clearInterval(this.#f),this.#f=void 0,this.#i=0,this.clear(),this.#t.hideCursor&&$e.show(this.#u),this.#t.discardStdin&&V.default.stdin.isTTY&&this.#r&&(Je.stop(),this.#r=!1),this):this}succeed(t){return this.stopAndPersist({symbol:H.success,text:t})}fail(t){return this.stopAndPersist({symbol:H.error,text:t})}warn(t){return this.stopAndPersist({symbol:H.warning,text:t})}info(t){return this.stopAndPersist({symbol:H.info,text:t})}stopAndPersist(t={}){if(this.#F)return this;let r=t.prefixText??this.#s,u=this.#E(r," "),i=t.symbol??" ",D=t.text??this.text,s=typeof D=="string"?(i?" ":"")+D:"",a=t.suffixText??this.#o,f=this.#g(a," "),p=u+i+s+f+`
 `;return this.stop(),this.#u.write(p),this}};function tr(e){return new Ze(e)}async function rr(e,t){let r=typeof e=="function",u=typeof e.then=="function";if(!r&&!u)throw new TypeError("Parameter `action` must be a Function or a Promise");let{successText:i,failText:D}=typeof t=="object"?t:{successText:void 0,failText:void 0},o=tr(t).start();try{let a=await(r?e(o):e);return o.succeed(i===void 0?void 0:typeof i=="string"?i:i(a)),a}catch(s){throw o.fail(D===void 0?void 0:typeof D=="string"?D:D(s)),s}}var HD=require("fs");var P=require("path"),me=require("fs"),cr=h(lr(),1),Dt=require("fs");var de=require("fs"),X=class{static ensureDir(t){(0,de.existsSync)(t)||(0,de.mkdirSync)(t,{recursive:!0})}};var{copyFile:rs,stat:us}=Dt.promises,_e=class e{constructor(t,r=e.IGNORE_FILE){this.ignoreTargetPath=t;this.ignoreFile=r}static IGNORE_FILE=".gitignore.template";getIg(t=this.ignoreTargetPath){let r=(0,P.join)(t,this.ignoreFile);if(!(0,me.existsSync)(r))return;let D=(0,me.readFileSync)(r,"utf8").split(`
-`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,cr.default)().add(D)}async copyFiles(t,r,u,i){let D=await Dt.promises.readdir(t);await Promise.all(D.map(async o=>{let s=(0,P.join)(t,o),a=(0,P.join)(r,o);if(u&&u.ignores(o))return;if(X.ensureDir((0,P.dirname)(a)),(await us(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await rs(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){X.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var L=require("fs"),kD=h(LD(),1),xe=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return(0,L.readFileSync)(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){(0,L.writeFileSync)(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let D=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof D=="string"?D:JSON.stringify(D))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,kD.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let D=this.getRealTemplateFilePath(u);return(0,L.existsSync)(D)?(this.mergeJSONFile(D,JSON.parse(i)),!0):(this.writeFile(D,i),!0)}return this.writeFile(u,i),!0}return!1}};var $D=["pack-app"],ye=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!(0,HD.existsSync)(r))throw new Error("template path not exit");this.ora=rr,this.context=new UD.FeScriptContext(t),this.subPackages=["node-lib","react-app"],this.copyer=new _e((0,v.join)(this.context.options.configsRootPath,"_common")),this.compose=new xe}get logger(){return this.context.logger}async steps(t){try{return await WD.default.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return $D.includes(t)}async getGeneratorContext(){let t=Ot(this.subPackages,$D),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=wt(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=(0,v.join)(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(s,a)=>(this.logger.debug("copyCallback",s,a),this.compose.composeConfigFile(t,s,a)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}await this.copyer.copyPaths({sourcePath:(0,v.join)(D,u),targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:(0,v.join)(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:D}=this.context.options;for(let o of u){let s=(0,v.join)(D,o),a=(0,v.join)(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var bt={name:"@qlover/create-app",version:"0.6.2",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function Ul(){let e=new YD.Command;return e.version(bt.version,"-v, --version","Show version").description(bt.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function Wl(){let{dryRun:e,verbose:t,...r}=Ul(),u=(0,vt.resolve)("./templates"),i=(0,vt.resolve)("./configs");(0,xt.existsSync)(u)||(console.error("Template is empty!"),process.exit(1)),(0,xt.existsSync)(i)||(console.error("Configs is empty!"),process.exit(1)),await new ye({dryRun:e,verbose:t,options:{...r,templateRootPath:u,configsRootPath:i}}).generate()}Wl().catch(e=>{console.error(e),process.exit(1)});
+`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,cr.default)().add(D)}async copyFiles(t,r,u,i){let D=await Dt.promises.readdir(t);await Promise.all(D.map(async o=>{let s=(0,P.join)(t,o),a=(0,P.join)(r,o);if(u&&u.ignores(o))return;if(X.ensureDir((0,P.dirname)(a)),(await us(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await rs(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){X.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var L=require("fs"),kD=h(LD(),1),xe=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return(0,L.readFileSync)(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){(0,L.writeFileSync)(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let D=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof D=="string"?D:JSON.stringify(D))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,kD.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let D=this.getRealTemplateFilePath(u);return(0,L.existsSync)(D)?(this.mergeJSONFile(D,JSON.parse(i)),!0):(this.writeFile(D,i),!0)}return this.writeFile(u,i),!0}return!1}};var $D=["pack-app"],ye=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!(0,HD.existsSync)(r))throw new Error("template path not exit");this.ora=rr,this.context=new UD.FeScriptContext(t),this.subPackages=["node-lib","react-app"],this.copyer=new _e((0,v.join)(this.context.options.configsRootPath,"_common")),this.compose=new xe}get logger(){return this.context.logger}async steps(t){try{return await WD.default.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return $D.includes(t)}async getGeneratorContext(){let t=Ot(this.subPackages,$D),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=wt(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=(0,v.join)(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(s,a)=>(this.logger.debug("copyCallback",s,a),this.compose.composeConfigFile(t,s,a)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}await this.copyer.copyPaths({sourcePath:(0,v.join)(D,u),targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:(0,v.join)(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:D}=this.context.options;for(let o of u){let s=(0,v.join)(D,o),a=(0,v.join)(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var bt={name:"@qlover/create-app",version:"0.6.3",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function Ul(){let e=new YD.Command;return e.version(bt.version,"-v, --version","Show version").description(bt.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function Wl(){let{dryRun:e,verbose:t,...r}=Ul(),u=(0,vt.resolve)("./templates"),i=(0,vt.resolve)("./configs");(0,xt.existsSync)(u)||(console.error("Template is empty!"),process.exit(1)),(0,xt.existsSync)(i)||(console.error("Configs is empty!"),process.exit(1)),await new ye({dryRun:e,verbose:t,options:{...r,templateRootPath:u,configsRootPath:i}}).generate()}Wl().catch(e=>{console.error(e),process.exit(1)});

package/dist/index.js

@@ -8,4 +8,4 @@ ${t}`,cn=Object.getOwnPropertyDescriptor(Function.prototype,"toString"),fn=Objec
 `))this.#e+=Math.max(1,Math.ceil(Le(D,{countAnsiEscapeCodes:!0})/t))}get isEnabled(){return this.#a&&!this.#F}set isEnabled(t){if(typeof t!="boolean")throw new TypeError("The `isEnabled` option must be a boolean");this.#a=t}get isSilent(){return this.#F}set isSilent(t){if(typeof t!="boolean")throw new TypeError("The `isSilent` option must be a boolean");this.#F=t}frame(){let t=Date.now();(this.#i===-1||t-this.#c>=this.interval)&&(this.#i=++this.#i%this.#D.frames.length,this.#c=t);let{frames:r}=this.#D,u=r[this.#i];this.color&&(u=E[this.color](u));let i=typeof this.#s=="string"&&this.#s!==""?this.#s+" ":"",D=typeof this.text=="string"?" "+this.text:"",o=typeof this.#o=="string"&&this.#o!==""?" "+this.#o:"";return i+u+D+o}clear(){if(!this.#a||!this.#u.isTTY)return this;this.#u.cursorTo(0);for(let t=0;t<this.#n;t++)t>0&&this.#u.moveCursor(0,-1),this.#u.clearLine(1);return(this.#l||this.lastIndent!==this.#l)&&this.#u.cursorTo(this.#l),this.lastIndent=this.#l,this.#n=0,this}render(){return this.#F?this:(this.clear(),this.#u.write(this.frame()),this.#n=this.#e,this)}start(t){return t&&(this.text=t),this.#F?this:this.#a?this.isSpinning?this:(this.#t.hideCursor&&je.hide(this.#u),this.#t.discardStdin&&ce.stdin.isTTY&&(this.#r=!0,We.start()),this.render(),this.#f=setInterval(this.render.bind(this),this.interval),this):(this.text&&this.#u.write(`- ${this.text}
 `),this)}stop(){return this.#a?(clearInterval(this.#f),this.#f=void 0,this.#i=0,this.clear(),this.#t.hideCursor&&je.show(this.#u),this.#t.discardStdin&&ce.stdin.isTTY&&this.#r&&(We.stop(),this.#r=!1),this):this}succeed(t){return this.stopAndPersist({symbol:k.success,text:t})}fail(t){return this.stopAndPersist({symbol:k.error,text:t})}warn(t){return this.stopAndPersist({symbol:k.warning,text:t})}info(t){return this.stopAndPersist({symbol:k.info,text:t})}stopAndPersist(t={}){if(this.#F)return this;let r=t.prefixText??this.#s,u=this.#E(r," "),i=t.symbol??" ",D=t.text??this.text,s=typeof D=="string"?(i?" ":"")+D:"",a=t.suffixText??this.#o,f=this.#g(a," "),p=u+i+s+f+`
 `;return this.stop(),this.#u.write(p),this}};function zt(e){return new He(e)}async function Kt(e,t){let r=typeof e=="function",u=typeof e.then=="function";if(!r&&!u)throw new TypeError("Parameter `action` must be a Function or a Promise");let{successText:i,failText:D}=typeof t=="object"?t:{successText:void 0,failText:void 0},o=zt(t).start();try{let a=await(r?e(o):e);return o.succeed(i===void 0?void 0:typeof i=="string"?i:i(a)),a}catch(s){throw o.fail(D===void 0?void 0:typeof D=="string"?D:D(s)),s}}import{existsSync as Hl}from"fs";var Dr=ue(ir(),1);import{dirname as Jn,join as Ze}from"path";import{existsSync as Zn,readFileSync as Qn}from"fs";import{promises as nr}from"fs";import{existsSync as Kn,mkdirSync as Xn}from"fs";var H=class{static ensureDir(t){Kn(t)||Xn(t,{recursive:!0})}};var{copyFile:es,stat:ts}=nr,Ce=class e{constructor(t,r=e.IGNORE_FILE){this.ignoreTargetPath=t;this.ignoreFile=r}static IGNORE_FILE=".gitignore.template";getIg(t=this.ignoreTargetPath){let r=Ze(t,this.ignoreFile);if(!Zn(r))return;let D=Qn(r,"utf8").split(`
-`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,Dr.default)().add(D)}async copyFiles(t,r,u,i){let D=await nr.readdir(t);await Promise.all(D.map(async o=>{let s=Ze(t,o),a=Ze(r,o);if(u&&u.ignores(o))return;if(H.ensureDir(Jn(a)),(await ts(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await es(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){H.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var ID=ue(qD(),1);import{readFileSync as Ll,writeFileSync as kl,existsSync as $l}from"fs";var me=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return Ll(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){kl(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let D=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof D=="string"?D:JSON.stringify(D))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,ID.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let D=this.getRealTemplateFilePath(u);return $l(D)?(this.mergeJSONFile(D,JSON.parse(i)),!0):(this.writeFile(D,i),!0)}return this.writeFile(u,i),!0}return!1}};var jD=["pack-app"],Be=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!Hl(r))throw new Error("template path not exit");this.ora=Kt,this.context=new Ul(t),this.subPackages=["node-lib","react-app"],this.copyer=new Ce(N(this.context.options.configsRootPath,"_common")),this.compose=new me}get logger(){return this.context.logger}async steps(t){try{return await Wl.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return jD.includes(t)}async getGeneratorContext(){let t=_t(this.subPackages,jD),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=mt(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=N(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(s,a)=>(this.logger.debug("copyCallback",s,a),this.compose.composeConfigFile(t,s,a)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}await this.copyer.copyPaths({sourcePath:N(D,u),targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:N(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:D}=this.context.options;for(let o of u){let s=N(D,o),a=N(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var Et={name:"@qlover/create-app",version:"0.6.2",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function zl(){let e=new Vl;return e.version(Et.version,"-v, --version","Show version").description(Et.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function Kl(){let{dryRun:e,verbose:t,...r}=zl(),u=ND("./templates"),i=ND("./configs");GD(u)||(console.error("Template is empty!"),process.exit(1)),GD(i)||(console.error("Configs is empty!"),process.exit(1)),await new Be({dryRun:e,verbose:t,options:{...r,templateRootPath:u,configsRootPath:i}}).generate()}Kl().catch(e=>{console.error(e),process.exit(1)});
+`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,Dr.default)().add(D)}async copyFiles(t,r,u,i){let D=await nr.readdir(t);await Promise.all(D.map(async o=>{let s=Ze(t,o),a=Ze(r,o);if(u&&u.ignores(o))return;if(H.ensureDir(Jn(a)),(await ts(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await es(s,a)}}))}copyPaths({sourcePath:t,targetPath:r,copyCallback:u}){H.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var ID=ue(qD(),1);import{readFileSync as Ll,writeFileSync as kl,existsSync as $l}from"fs";var me=class{constructor(){}isJSONFilePath(t){return t.endsWith(".json")||t.endsWith(".json.template")}isTemplateFilePath(t){return t.endsWith(".template")}getRealTemplateFilePath(t){return t.replace(".template","")}readFile(t){return Ll(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){kl(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let D=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof D=="string"?D:JSON.stringify(D))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,ID.default)(r,u);this.writeFile(t,JSON.stringify(i,null,2))}composeConfigFile(t,r,u){if(this.isTemplateFilePath(r)){let i=this.replaceFile(r,t);if(this.isJSONFilePath(r)&&this.isJSONFilePath(u)){let D=this.getRealTemplateFilePath(u);return $l(D)?(this.mergeJSONFile(D,JSON.parse(i)),!0):(this.writeFile(D,i),!0)}return this.writeFile(u,i),!0}return!1}};var jD=["pack-app"],Be=class{ora;context;subPackages;copyer;compose;constructor(t){let r=t.options?.templateRootPath;if(!r)throw new Error("template path not exit");if(!Hl(r))throw new Error("template path not exit");this.ora=Kt,this.context=new Ul(t),this.subPackages=["node-lib","react-app"],this.copyer=new Ce(N(this.context.options.configsRootPath,"_common")),this.compose=new me}get logger(){return this.context.logger}async steps(t){try{return await Wl.prompt(t)}catch(r){throw r.isTtyError,this.logger.error(r),r}}async action({label:t,task:r}){let u=r();u instanceof Promise||(u=Promise.resolve(u));let i=t;return this.ora(u,i),u}isPackageTemplate(t){return jD.includes(t)}async getGeneratorContext(){let t=_t(this.subPackages,jD),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=mt(this.subPackages),i=await this.steps(u);Object.assign(r,i)}return r.targetPath=N(process.cwd(),r.projectName),r.releasePath=r.releasePath||"src",r}async generate(){let t=await this.getGeneratorContext();if(this.logger.debug("context is:",t,this.context.options.templateRootPath),t.subPackages){await this.action({label:"Generate Directories(subPackages)",task:async()=>{await this.generateTemplateDir(t),await this.generateSubPackages(t),await this.generateConfigs(t,t.targetPath,"_common")}});return}await this.action({label:"Generate Directory",task:async()=>{await this.generateTemplateDir(t),await this.generateConfigs(t,t.targetPath,"_common"),await this.generateConfigs(t,t.targetPath,t.template)}})}async generateConfigs(t,r,u){let i=(s,a)=>(this.logger.debug("copyCallback",s,a),this.compose.composeConfigFile(t,s,a)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}await this.copyer.copyPaths({sourcePath:N(D,u),targetPath:r,copyCallback:i})}generateTemplateDir(t){return this.copyer.copyPaths({sourcePath:N(this.context.options.templateRootPath,t.template),targetPath:t.targetPath})}async generateSubPackages(t){let{packagesNames:r="packages",subPackages:u=[],targetPath:i=""}=t,{templateRootPath:D}=this.context.options;for(let o of u){let s=N(D,o),a=N(i,r,o);this.logger.debug("copy sub package",s,a),await this.copyer.copyPaths({sourcePath:s,targetPath:a})}}};var Et={name:"@qlover/create-app",version:"0.6.3",description:"Create a new app with a single command",private:!1,type:"module",files:["dist","package.json","README.md","CHANGELOG.md"],bin:{"create-app":"dist/index.js"},scripts:{build:"tsup","create:app":"node ./dist/index.js"},repository:{type:"git",url:"git+https://github.com/qlover/fe-base.git",directory:"packages/create-app"},homepage:"https://github.com/qlover/fe-base#readme",keywords:["create-app","fe-scripts","scripts"],author:"qlover",license:"ISC",publishConfig:{access:"public"},devDependencies:{"@qlover/logger":"workspace:*",ignore:"^7.0.3",lodash:"^4.17.21",ora:"^8.1.1"},dependencies:{"@qlover/scripts-context":"workspace:*",commander:"^13.1.0",inquirer:"^12.3.2"}};function zl(){let e=new Vl;return e.version(Et.version,"-v, --version","Show version").description(Et.description).option("-d, --dry-run","Do not touch or write anything, but show the commands").option("-V, --verbose","Show more information").option("--config","Copy config files (default: true)",!0).option("--no-config","Do not copy config files"),e.parse(),e.opts()}async function Kl(){let{dryRun:e,verbose:t,...r}=zl(),u=ND("./templates"),i=ND("./configs");GD(u)||(console.error("Template is empty!"),process.exit(1)),GD(i)||(console.error("Configs is empty!"),process.exit(1)),await new Be({dryRun:e,verbose:t,options:{...r,templateRootPath:u,configsRootPath:i}}).generate()}Kl().catch(e=>{console.error(e),process.exit(1)});

package/dist/templates/react-app/README.en.md

@@ -0,0 +1,257 @@
+# FE-React Template
+
+A modern React frontend project template with integrated practical features and best practices.
+
+[中文](./README.md)
+
+## 🌟 Features
+
+- 🚀 Fast development experience with Vite
+- 🎨 Theme system integrated with Tailwind CSS
+- 🌍 Comprehensive internationalization support (Chinese & English)
+- 🔄 TypeScript-based IOC container
+- 📡 Unified API request handling
+- 🎮 Controller pattern for state management
+- 📦 Package management with pnpm
+- 🧪 Built-in test support
+
+## 🔧 Requirements
+
+- Node.js >= 16
+- pnpm >= 8.0
+
+## 📁 Project Structure
+
+```tree
+├── config/                 # Configuration directory
+│   ├── app.router.json     # Router page configuration
+│   ├── common.ts           # Application common configuration
+│   ├── app.router.json     # Router configuration
+│   ├── i18n.ts             # I18n configuration
+│   └── theme.json          # Theme configuration
+├── lib/                    # Common library directory
+├── public/                 # Static resources directory
+├── src/
+│   ├── base/           # Base code
+│   ├── core/           # Core code
+│   ├── pages/          # Page components
+│   ├── services/       # Service layer
+│   └── uikit/          # UI component library
+└── vite.config.ts      # Vite configuration file
+```
+
+## 🚀 Quick Start
+
+### Install Dependencies
+
+```bash
+pnpm install
+```
+
+### Development Mode
+
+```bash
+pnpm dev
+```
+
+### Build Project
+
+```bash
+pnpm build
+```
+
+### Run Tests
+
+```bash
+pnpm test
+```
+
+## 📚 Documentation Guide
+
+The project provides detailed development documentation covering all major features and best practices:
+
+### Basic Documentation
+- [Project Overview](./docs/en/index.md) - Project introduction and quick start guide
+- [Project Structure](./docs/en/project-structure.md) - Detailed project directory structure explanation
+- [Development Guide](./docs/en/development-guide.md) - Project development specifications and best practices
+- [Environment Configuration](./docs/en/env.md) - Environment variables and configuration management
+- [Global Configuration](./docs/en/global.md) - Application global configuration and settings
+
+### Core Features
+- [Bootstrap Process](./docs/en/bootstrap.md) - Application startup process and lifecycle management
+- [IOC Container](./docs/en/ioc.md) - Dependency injection system usage guide
+- [Router Management](./docs/en/router.md) - Router configuration and page navigation
+- [State Management](./docs/en/store.md) - Application state management solution
+- [Request Handling](./docs/en/request.md) - API request handling mechanism
+
+### Feature Extensions
+- [Internationalization](./docs/en/i18n.md) - Multi-language support and translation management
+- [Theme System](./docs/en/theme.md) - Theme configuration and dark mode support
+- [TypeScript Guide](./docs/en/typescript-guide.md) - TypeScript usage specifications and best practices
+
+## 🔨 Core Features
+
+### IOC Container
+
+- TypeScript-based dependency injection system
+- Support for automatic service registration and dependency management
+- Complete type inference
+
+### Environment Configuration
+
+[Vite Environment Variables and Modes](https://vitejs.dev/guide/env-and-mode.html)
+
+`vite dev` default NODE_ENV is 'development', it will load possible `.env[mode]` files, e.g., .env.local -> .env
+
+`vite build` default NODE_ENV is 'production', it will load possible `.env[mode]` files, e.g., .env.production -> .env
+
+Node.js NODE_ENV only supports development, production, test
+
+This is completely different from mode in vite. Mode can be specified with `--mode` to load different env configurations.
+
+For example:
+
+```bash
+vite dev --mode staging # Load .env.staging
+vite dev --mode local # Load .env.local
+```
+
+### Internationalization Support
+
+- Complete i18n solution based on i18next
+- Support for Chinese (zh) and English (en) language switching
+- Automatic i18n resource generation based on TypeScript comments
+- URL path language detection and switching
+- Built-in language switcher component
+
+### Theme System
+
+- Theme configuration based on Tailwind CSS
+- Support for dark/light mode
+- Custom design token system
+
+### API Integration
+
+The project provides a powerful API request handling mechanism based on a plugin architecture:
+
+#### Request Controller
+
+Use `RequestController` to manage API requests uniformly:
+
+```typescript
+@injectable()
+export class RequestController extends StoreInterface<RequestControllerState> {
+  constructor(
+    @inject(FeApi) private readonly feApi: FeApi,
+    @inject(UserApi) private readonly userApi: UserApi
+  ) {
+    super(createDefaultState);
+  }
+
+  // API call example
+  async onRandomUser() {
+    if (this.state.randomUserState.loading) return;
+
+    this.setState({
+      randomUserState: { loading: true, result: null, error: null }
+    });
+
+    try {
+      const result = await this.userApi.getRandomUser();
+      this.setState({
+        randomUserState: { loading: false, result, error: null }
+      });
+    } catch (error) {
+      this.setState({
+        randomUserState: { loading: false, result: null, error }
+      });
+    }
+  }
+}
+```
+
+### Controller Pattern
+
+Provides multiple out-of-the-box controllers:
+
+- JSONStorageController
+- RequestController
+- RouterController
+- UserController
+- ThemeController
+
+## 🛠️ Development Guide
+
+### API Development Standards
+
+1. Define interfaces in `src/base/apis`
+2. Support for Mock data configuration
+
+### Adding New Pages
+
+1. Create page component in `src/pages`
+2. Update `config/app.router.json`
+3. Add corresponding controller (if needed)
+
+### Build Optimization
+
+The project uses Vite for building and includes the following optimizations:
+
+#### Code Splitting
+
+Automatic intelligent code splitting into the following main chunks:
+
+- react-vendor: React core library
+- antd-core: Ant Design core components
+- antd-basic: Basic UI components
+- antd-advanced: Advanced UI components
+- utils: Utility functions
+- i18n: Internationalization related
+
+#### Build Optimization Configuration
+
+```typescript
+build: {
+  // Chunk size warning limit set to 600kb
+  chunkSizeWarningLimit: 600,
+  // Use terser for code compression
+  minify: 'terser',
+  terserOptions: {
+    compress: {
+      // Remove console output and debugger statements
+      drop_console: true,
+      drop_debugger: true,
+      // Remove specific console function calls
+      pure_funcs: ['console.log', 'console.info', 'console.debug']
+    }
+  }
+}
+```
+
+### Project Configuration
+
+#### Environment Variables
+
+- Use `@qlover/corekit-bridge/vite-env-config` to manage environment variables
+- Automatically inject application name and version information
+- Support for environment variable prefix configuration
+
+#### Style Configuration
+
+- Integrate Tailwind CSS
+- Load Ant Design component styles on demand
+- Support theme mode override
+
+#### Development Server
+
+```bash
+# Default port 3200, configurable via environment variable
+VITE_SERVER_PORT=3000 pnpm dev
+```
+
+#### Test Configuration
+
+- Use Vitest for unit testing
+- Support JSDOM environment
+- Built-in test tool configuration
+``` 

package/dist/templates/react-app/README.md

@@ -2,6 +2,8 @@
 
 一个现代化的 React 前端项目模板，集成了多项实用功能和最佳实践。
 
+[English](./README.en.md)
+
 ## 🌟 特性亮点
 
 - 🚀 基于 Vite 的快速开发体验
@@ -64,6 +66,29 @@ pnpm build
 pnpm test
 ```
 
+## 📚 文档指南
+
+项目提供了详细的开发文档，涵盖了所有主要功能和最佳实践：
+
+### 基础文档
+- [项目概述](./docs/zh/index.md) - 项目整体介绍和快速开始指南
+- [项目结构](./docs/zh/project-structure.md) - 详细的项目目录结构说明
+- [开发指南](./docs/zh/development-guide.md) - 项目开发规范和最佳实践
+- [环境配置](./docs/zh/env.md) - 环境变量和配置管理说明
+- [全局配置](./docs/zh/global.md) - 应用全局配置和设置说明
+
+### 核心功能
+- [启动流程](./docs/zh/bootstrap.md) - 应用启动流程和生命周期管理
+- [IOC容器](./docs/zh/ioc.md) - 依赖注入系统的使用说明
+- [路由管理](./docs/zh/router.md) - 路由配置和页面导航说明
+- [状态管理](./docs/zh/store.md) - 应用状态管理方案说明
+- [请求处理](./docs/zh/request.md) - API 请求处理机制说明
+
+### 功能扩展
+- [国际化](./docs/zh/i18n.md) - 多语言支持和翻译管理
+- [主题系统](./docs/zh/theme.md) - 主题配置和暗色模式支持
+- [TypeScript指南](./docs/zh/typescript-guide.md) - TypeScript 使用规范和最佳实践
+
 ## 🔨 核心功能
 
 ### IOC 容器
@@ -72,15 +97,15 @@ pnpm test
 - 支持服务自动注册和依赖管理
 - 提供完整的类型推导
 
-### env 配置注入
+### 环境配置
 
 [vite 环境变量和模式](https://cn.vite.dev/guide/env-and-mode#env-variables-and-modes)
 
 `vite dev` 默认 NODE_ENV 表示为 development, 他会加载可能的 `.env[mode]` 文件, 比如 .env.local -> .env
 
-`vite build`默认 NODE_ENV 表示为 production, 他会加载可能的 `.env[mode]` 文件, 比如 .env.production -> .env
+`vite build` 默认 NODE_ENV 表示为 production, 他会加载可能的 `.env[mode]` 文件, 比如 .env.production -> .env
 
-Nodejs NODE_ENV 只支持 development,production,test
+Node.js NODE_ENV 只支持 development,production,test
 
 这个和 vite 中的 mode 是完全不一样的, mode 可以根据 `--mode` 指定不同模式，来加载不同的 env 配置
 
@@ -99,127 +124,6 @@ vite dev --mode local # 加载 .env.local
 - URL 路径语言检测和切换
 - 内置语言切换组件
 
-#### 国际化配置
-
-项目使用 `@brain-toolkit/ts2locales` 插件从 TypeScript 注释自动生成国际化资源：
-
-```typescript
-// config/Identifier/I18n.ts
-export const Messages = {
-  /**
-   * @description Home page welcome message
-   * @localZh 欢迎来到主页
-   * @localEn Welcome to the home page
-   */
-  HOME_WELCOME: 'home.welcome',
-
-  /**
-   * @description Get started button text
-   * @localZh 开始使用
-   * @localEn Get Started
-   */
-  HOME_GET_STARTED: 'home.get_started'
-};
-```
-
-Vite 插件配置：
-
-```typescript
-// vite.config.ts
-import ts2Locales from '@brain-toolkit/ts2locales/vite';
-import i18nConfig from './config/i18n';
-
-export default defineConfig({
-  plugins: [
-    ts2Locales({
-      locales: i18nConfig.supportedLngs,
-      options: [
-        {
-          source: './config/Identifier/error.ts',
-          target: './public/locales/{{lng}}/common.json'
-        },
-        {
-          source: './config/Identifier/index.ts',
-          target: './public/locales/{{lng}}/common.json'
-        }
-      ]
-    })
-  ]
-});
-```
-
-#### 国际化服务
-
-项目提供了 `I18nService` 用于管理国际化状态和语言切换：
-
-```typescript
-import { I18nService } from '@/base/services/I18nService';
-
-// 获取当前语言
-const currentLang = I18nService.getCurrentLanguage();
-
-// 切换语言
-await i18nService.changeLanguage('zh');
-```
-
-#### 在组件中使用
-
-```typescript
-import { useBaseRoutePage } from '@/uikit/contexts/BaseRouteContext';
-import * as i18nKeys from '@config/Identifier';
-
-function MyComponent() {
-  const { t } = useBaseRoutePage();
-
-  return (
-    <div>
-      <h1>{t(i18nKeys.HOME_WELCOME)}</h1>
-      <button>{t(i18nKeys.HOME_GET_STARTED)}</button>
-    </div>
-  );
-}
-```
-
-#### 语言切换组件
-
-项目提供了开箱即用的语言切换组件：
-
-```typescript
-import LanguageSwitcher from '@/uikit/components/LanguageSwitcher';
-
-function Header() {
-  return (
-    <header>
-      <LanguageSwitcher />
-    </header>
-  );
-}
-```
-
-#### 最佳实践
-
-1. 国际化标识符管理：
-
-   - 在 `config/Identifier/index.ts` 中集中管理UI文本
-   - 在 `config/Identifier/error.ts` 中集中管理错误信息
-   - 使用有意义的 key 命名（如：'page.home.title'）
-
-2. TypeScript 注释规范：
-
-   - 使用 `@description` 描述文本用途
-   - 使用 `@localZh` 定义中文文本
-   - 使用 `@localEn` 定义英文文本
-
-3. 路由配置：
-
-   - 使用 `LocaleLink` 组件进行页面跳转
-   - URL 格式：`/{lang}/path`（如：'/zh/about'）
-
-4. 组件开发：
-   - 使用 `useBaseRoutePage` hook 获取翻译函数
-   - 从 `@config/Identifier` 引入国际化 key
-   - 避免硬编码文本，始终使用国际化 key
-
 ### 主题系统
 
 - 基于 Tailwind CSS 的主题配置
@@ -266,106 +170,6 @@ export class RequestController extends StoreInterface<RequestControllerState> {
 }
 ```
 
-#### 请求插件系统
-
-项目内置多个实用的请求插件：
-
-1. `FetchURLPlugin`: URL 处理和构建
-2. `RequestCommonPlugin`: 通用请求配置
-3. `ApiMockPlugin`: Mock 数据支持
-4. `FetchAbortPlugin`: 请求中断控制
-5. `RequestLogger`: 请求日志记录
-6. `ApiCatchPlugin`: 统一错误处理
-
-使用示例：
-
-```typescript
-// 配置请求适配器
-const adapter = new RequestAdapter({
-  plugins: [
-    new FetchURLPlugin(),
-    new RequestCommonPlugin(),
-    new ApiMockPlugin(),
-    new FetchAbortPlugin(),
-    new RequestLogger()
-  ]
-});
-
-// 发起请求
-const response = await adapter.request({
-  url: '/api/users',
-  method: 'GET',
-  requestId: 'uniqueId', // 用于中断请求
-  mock: true // 启用 mock 数据
-});
-```
-
-#### 请求调度器
-
-使用 `RequestScheduler` 管理复杂的请求流程：
-
-```typescript
-export class FeApi extends RequestScheduler<RequestConfig> {
-  async getIpInfo() {
-    return this.request<void, IpInfo>({
-      url: '/api/ip',
-      method: 'GET'
-    });
-  }
-}
-```
-
-#### Mock 数据支持
-
-项目支持灵活的 Mock 数据配置：
-
-```typescript
-// 配置 Mock 数据
-const mockConfig = {
-  '/api/users': {
-    GET: () => ({
-      code: 200,
-      data: {
-        id: 1,
-        name: 'John Doe'
-      }
-    })
-  }
-};
-
-// 在请求中使用
-const response = await api.request({
-  url: '/api/users',
-  method: 'GET',
-  mock: true // 启用 mock
-});
-```
-
-#### 最佳实践
-
-1. API 定义：
-
-   - 在 `src/base/apis` 中集中管理 API 定义
-   - 使用 TypeScript 接口定义请求和响应类型
-   - 遵循 RESTful API 设计规范
-
-2. 错误处理：
-
-   - 使用 `ApiCatchPlugin` 统一处理错误
-   - 定义清晰的错误类型和错误码
-   - 提供友好的错误提示
-
-3. 请求状态管理：
-
-   - 使用 `SliceStore` 管理请求状态
-   - 处理加载、成功、错误等状态
-   - 实现请求防抖和节流
-
-4. Mock 数据：
-   - 提供合理的 Mock 数据结构
-   - 支持动态 Mock 数据生成
-   - 便于本地开发和测试
-
 ### 控制器模式
 
 提供多个开箱即用的控制器：
@@ -376,7 +180,7 @@ const response = await api.request({
 - UserController
 - ThemeController
 
-## 📚 开发指南
+## 🛠️ 开发指南
 
 ### API 开发规范
 
@@ -389,12 +193,6 @@ const response = await api.request({
 2. 更新 `config/app.router.json`
 3. 添加对应的控制器（如需要）
 
-### 国际化开发
-
-1. 在 `public/locales` 添加翻译文件
-2. 使用 `useTranslation` hook 进行调用
-3. 支持按需加载语言包
-
 ### 构建优化
 
 项目使用 Vite 进行构建，并进行了以下优化：