@qlover/create-app 0.10.0 → 0.10.2

package/CHANGELOG.md

@@ -1,5 +1,150 @@
 # @qlover/create-app
 
+## 0.10.2
+
+### Patch Changes
+
+#### ✨ Features
+
+- **next-app:** enhance internationalization support and layout components ([6da4f10](https://github.com/qlover/fe-base/commit/6da4f10d79e22619d86db938bdd4ae263af0e084)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Added `prettier` configuration to `package.json` for consistent code formatting.
+  - Implemented `generateStaticParams` function in `layout.tsx` to support static rendering with locale parameters.
+  - Introduced `LanguageSwitcher` and `LocaleSwitcher` components for improved language selection.
+  - Refactored `BaseLayout` to streamline layout rendering and removed unused components.
+  - Created `LocaleSwitcherSelect` component for better locale selection handling.
+
+  These changes aim to improve the user experience with enhanced internationalization features and a more organized layout structure.
+
+- **next-app:** refactor layout and enhance IOC integration ([d3de8f6](https://github.com/qlover/fe-base/commit/d3de8f6a8ca7336b0768835523bdbd573053ce6d)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Replaced `ComboProvider` with `BootstrapsProvider` and `IOCProvider` in `layout.tsx` to improve dependency injection and component structure.
+  - Added `register` method to `IOCInterface` for pre-launch dependency registration, enhancing flexibility in SSR environments.
+  - Updated `BootstrapClient` to support registration of dependencies and prevent multiple initializations.
+  - Introduced `useStrictEffect` hook to ensure effects run correctly in React's Strict Mode.
+  - Refactored `BootstrapsProvider` to ensure proper IOC registration before component rendering.
+
+  These changes aim to streamline the application structure and improve the management of dependencies, enhancing overall performance and maintainability.
+
+- **next-app:** enhance internationalization and layout components ([a588f10](https://github.com/qlover/fe-base/commit/a588f104bb3deb9a1c62d6df0e7bc6478a7b9d6d)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Updated `layout.tsx` to fetch messages for the current locale, improving language switch experience and preventing flickering.
+  - Refactored `BaseHeader` and `BaseLayout` components to utilize `useMemo` for better performance and optimized rendering.
+  - Removed deprecated `LocaleSwitcher` and `LocaleSwitcherSelect` components to streamline the codebase.
+  - Added `ThemeSwitcher` and `LogoutButton` to `BaseLayout` for enhanced user interface options.
+
+  These changes aim to improve internationalization support and overall component efficiency in the application.
+
+- **next-app:** add internationalization support and new assets ([ae8831f](https://github.com/qlover/fe-base/commit/ae8831f8f580e6e70abcddc5f30885e7baf22864)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Updated ESLint configuration to include new paths for `manifest.ts` and `*.tsx` files.
+  - Added `favicon.ico` for improved branding and user experience.
+  - Introduced `proxy.ts` for handling locale detection and routing with Next.js middleware.
+  - Created `manifest.ts` to define application metadata and translations.
+  - Added `robots.txt` to guide search engine indexing.
+
+  These changes enhance internationalization capabilities and improve the overall structure of the application.
+
+- **next-app:** enhance internationalization and routing structure ([5f64eb5](https://github.com/qlover/fe-base/commit/5f64eb58083016dfbb6a82eddfa0cac65bc9507b)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Updated ESLint configuration to include new paths for TypeScript files in the `src/pages` directory.
+  - Added a new constant for the application manifest name in `common.ts` to improve localization.
+  - Updated English and Chinese locale files to include the new manifest name key.
+  - Refactored `manifest.ts` to utilize the new constant for application name.
+  - Introduced `AppPageRouteParams` for better handling of route parameters across the application.
+  - Created new `PagesRouteParams` and `RouteParamsnHandlerInterface` for improved routing parameter management.
+
+  These changes enhance the internationalization capabilities and improve the overall routing structure of the application.
+
+- **next-app:** enhance configuration and logging in Next.js application ([181f522](https://github.com/qlover/fe-base/commit/181f52231da7244ab52bfc1ecf4004751f48ed5f)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Added `transpilePackages` to `next.config.ts` for improved package handling.
+  - Introduced logging for successful startup in `BootstrapClient` to aid in debugging.
+  - Enhanced `ClientIOC` with logging during registration to track dependency injection.
+  - Updated `_app.tsx` to include `BootstrapsProvider` and `IOCProvider`, ensuring proper context management.
+  - Simplified the `About` page by removing unused translations and components.
+
+  These changes improve the application's configuration, logging capabilities, and overall structure.
+
+- **next-app:** update ESLint config and streamline TypeScript paths ([a1ee3bd](https://github.com/qlover/fe-base/commit/a1ee3bd911516821c793c82a6ecba91a39a058bc)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Added `manifest.ts` and `proxy.ts` to ESLint configuration for improved linting coverage.
+  - Simplified `transpilePackages` array in `next.config.ts` for better readability.
+  - Cleaned up TypeScript path mappings in `tsconfig.json` for consistency.
+  - Refactored imports in various files to enhance code organization and maintainability.
+
+  These changes enhance the project's configuration and improve code clarity across the application.
+
+- **next-app:** add About page and enhance internationalization support ([49a5108](https://github.com/qlover/fe-base/commit/49a5108800d583f85ce0a97da77fbdbeabcba8c7)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Introduced a new About page with SEO metadata using `ClientSeo`.
+  - Added `page.about.ts` for About page titles, descriptions, and keywords in both English and Chinese.
+  - Updated i18n configuration to include About page translations.
+  - Refactored `PagesRouteParams` to support namespace-specific message loading.
+
+  These changes improve the application's internationalization capabilities and provide a new About page for users.
+
+- **next-app:** enhance internationalization and refactor layout components ([56cca75](https://github.com/qlover/fe-base/commit/56cca75cff33581f2e076598bad95438cefe0605)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Added `AdminI18nProvider` to manage admin-specific i18n messages, improving localization for admin pages.
+  - Refactored layout components to utilize `AppRoutePage`, streamlining the structure and enhancing code clarity.
+  - Updated `login` and `register` pages to incorporate admin titles in translations, ensuring consistency across the application.
+  - Introduced new `LanguageSwitcher`, `LogoutButton`, and `ThemeSwitcher` components for improved user interface options.
+  - Removed deprecated `BaseLayout` and `BaseHeader` components to simplify the codebase.
+
+  These changes enhance the internationalization capabilities and improve the overall layout structure of the application.
+
+- **next-app:** refactor API handling and enhance localization features ([68b81a1](https://github.com/qlover/fe-base/commit/68b81a1346460779b62db860ae80838aa744df66)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Updated `useApiLocales` to true, enabling API-based localization data fetching.
+  - Refactored API routes for locales to utilize `NextApiServer`, improving error handling and response management.
+  - Introduced `AdminLocalesController` and `LocalesController` for better separation of concerns in handling locale-related operations.
+  - Enhanced user authentication routes by integrating `UserController` for streamlined login, registration, and logout processes.
+  - Added new validation and service layers to improve data handling and validation for locales and user operations.
+
+  These changes enhance the application's localization capabilities and improve the overall API structure and error handling.
+
+- **next-app:** enhance validation and refactor controller logic ([edce45d](https://github.com/qlover/fe-base/commit/edce45d0879777a2edd6cd3144762fbff91e76e5)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Updated `ValidatorInterface` to support generic types, allowing for more flexible validation across different data structures.
+  - Refactored `AdminLocalesController` and `UserController` to utilize the updated validation methods, improving error handling and data processing.
+  - Introduced `PaginationParams` type for better pagination handling in `PaginationValidator`.
+  - Enhanced `LocalesValidator` and `LoginValidator` to implement specific data types, ensuring stricter validation rules.
+
+  These changes improve the robustness of data validation and streamline controller logic, enhancing overall application reliability.
+
+- **next-app:** enhance theme management and cookie configuration ([bcfd05d](https://github.com/qlover/fe-base/commit/bcfd05d04a88fd036f1fd15f8227e27c6cc5fe97)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Added `cookiesConfig` for managing cookie attributes, improving cookie handling in the application.
+  - Updated `i18nConfig` to include a new `storageKey` for locale management.
+  - Refactored `RootLayout` to utilize the theme from URL parameters, enhancing user experience with theme persistence.
+  - Introduced `getTheme` methods in `AppPageRouteParams` and `PagesRouteParams` for consistent theme retrieval.
+  - Enhanced `ThemeSwitcher` to save the selected theme in cookies, ensuring user preferences are maintained across sessions.
+
+  These changes improve the application's theme management and cookie handling, enhancing overall user experience.
+
+- **next-app:** enhance theme configuration and localization support ([4101f66](https://github.com/qlover/fe-base/commit/4101f6690fb28daa173688fe8fb779feeb5ea19f)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Updated theme configuration to include `enableSystem` and improved default theme handling.
+  - Added new constants for light theme labels in both English and Chinese locales.
+  - Refactored `getTheme` method to return the first supported theme if no cookie is found.
+  - Enhanced `ThemeSwitcher` component to utilize new theme constants and improve user experience.
+
+  These changes improve theme management and localization, ensuring a more consistent user interface across different themes.
+
+- **next-app:** integrate client rendering and enhance routing functionality ([79f0353](https://github.com/qlover/fe-base/commit/79f0353315bad3a2d648ebe990a3f81d16dc0446)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Added `ClinetRenderProvider` to manage client-side rendering for components, preventing flickering during language switches.
+  - Updated `AdminRootLayout` to wrap `AdminLayout` with `ClinetRenderProvider` for improved rendering control.
+  - Refactored `RouterService` to introduce `replaceHome` method, enhancing navigation capabilities.
+  - Modified `LoginForm` to use `routerService.replaceHome()` for smoother redirection after login.
+  - Introduced `AppBridge` component to establish a connection between the router and navigation bridge, improving routing management.
+  - Added new `scrollbar.css` for custom scrollbar styling and updated CSS imports accordingly.
+
+  These changes enhance the application's rendering performance and routing structure, providing a better user experience.
+
+#### 🐞 Bug Fixes
+
+- **next-app:** update ESLint config and enhance i18n message loading ([dad47dc](https://github.com/qlover/fe-base/commit/dad47dc9ca3f7c7f9c4d5542ed6adfaf38c8567b)) ([#549](https://github.com/qlover/fe-base/pull/549))
+  - Removed `manifest.ts` from ESLint ignore list to ensure proper linting.
+  - Downgraded `eslint-config-next` to version `15.5.0` for compatibility.
+  - Added `defaultNamespaces` to `i18nConfig` for improved message loading.
+  - Introduced `loadMessages` function to handle loading i18n messages from API or JSON files.
+  - Refactored `request.ts` to utilize the new `loadMessages` function for fetching messages.
+  - Updated `PagesRouteParams` to support loading messages with specified namespaces.
+
+  These changes improve the internationalization message handling and ensure consistent linting across the project.
+
+## 0.10.1
+
+### Patch Changes
+
 ## 0.10.0
 
 ### Minor Changes

package/dist/index.cjs

@@ -8,4 +8,4 @@ ${t}`,_n=Object.getOwnPropertyDescriptor(Function.prototype,"toString"),mn=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,l=this.#g(a," "),p=u+i+s+l+`
 `;return this.stop(),this.#u.write(p),this}};function rr(e){return new Ze(e)}async function ur(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=rr(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 bt=require("fs");var P=require("path"),me=require("fs"),fr=h(cr(),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:us,stat:is}=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,fr.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 is(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await us(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"),$D=h(kD(),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,$D.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 UD=["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,bt.existsSync)(r))throw new Error("template path not exit");this.ora=ur,this.context=new WD.ScriptContext("create-app",t),this.subPackages=["node-lib","react-app","next-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 HD.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 UD.includes(t)}async getGeneratorContext(){let t=wt(this.subPackages,UD),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=Pt(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=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=(0,v.join)(D,u);if(!(0,bt.existsSync)(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,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 vt={name:"@qlover/create-app",version:"0.10.0",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:{lint:"eslint src --fix",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 Wl(){let e=new YD.Command;return e.version(vt.version,"-v, --version","Show version").description(vt.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 VD(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Wl(),i=(0,xt.resolve)(e,"./templates"),D=(0,xt.resolve)(e,"./configs");(0,yt.existsSync)(i)||(console.error("Template is empty!"),process.exit(1)),(0,yt.existsSync)(D)||(console.error("Configs is empty!"),process.exit(1)),await new ye({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:D}}).generate()}VD(__dirname).catch(e=>{console.error(e),process.exit(1)});
+`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,fr.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 is(s)).isDirectory())await this.copyFiles(s,a,u,i);else{if(i&&await i(s,a))return;await us(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"),$D=h(kD(),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,$D.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 UD=["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,bt.existsSync)(r))throw new Error("template path not exit");this.ora=ur,this.context=new WD.ScriptContext("create-app",t),this.subPackages=["node-lib","react-app","next-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 HD.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 UD.includes(t)}async getGeneratorContext(){let t=wt(this.subPackages,UD),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=Pt(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=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:D,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=(0,v.join)(D,u);if(!(0,bt.existsSync)(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,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 vt={name:"@qlover/create-app",version:"0.10.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:{lint:"eslint src --fix",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 Wl(){let e=new YD.Command;return e.version(vt.version,"-v, --version","Show version").description(vt.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 VD(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Wl(),i=(0,xt.resolve)(e,"./templates"),D=(0,xt.resolve)(e,"./configs");(0,yt.existsSync)(i)||(console.error("Template is empty!"),process.exit(1)),(0,yt.existsSync)(D)||(console.error("Configs is empty!"),process.exit(1)),await new ye({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:D}}).generate()}VD(__dirname).catch(e=>{console.error(e),process.exit(1)});

package/dist/index.js

@@ -8,4 +8,4 @@ ${t}`,pD=Object.getOwnPropertyDescriptor(Function.prototype,"toString"),hD=Objec
 `))this.#e+=Math.max(1,Math.ceil(Le(n,{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.#n.frames.length,this.#c=t);let{frames:r}=this.#n,u=r[this.#i];this.color&&(u=E[this.color](u));let i=typeof this.#s=="string"&&this.#s!==""?this.#s+" ":"",n=typeof this.text=="string"?" "+this.text:"",o=typeof this.#o=="string"&&this.#o!==""?" "+this.#o:"";return i+u+n+o}clear(){if(!this.#a||!this.#u.isTTY)return this;this.#u.cursorTo(0);for(let t=0;t<this.#D;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.#D=0,this}render(){return this.#F?this:(this.clear(),this.#u.write(this.frame()),this.#D=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??" ",n=t.text??this.text,s=typeof n=="string"?(i?" ":"")+n:"",a=t.suffixText??this.#o,l=this.#g(a," "),p=u+i+s+l+`
 `;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:n}=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(n===void 0?void 0:typeof n=="string"?n:n(s)),s}}import{existsSync as Nn}from"fs";var nr=ue(ir(),1);import{dirname as QD,join as Ze}from"path";import{existsSync as es,readFileSync as ts}from"fs";import{promises as Dr}from"fs";import{existsSync as JD,mkdirSync as ZD}from"fs";var H=class{static ensureDir(t){JD(t)||ZD(t,{recursive:!0})}};var{copyFile:rs,stat:us}=Dr,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(!es(r))return;let n=ts(r,"utf8").split(`
-`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,nr.default)().add(n)}async copyFiles(t,r,u,i){let n=await Dr.readdir(t);await Promise.all(n.map(async o=>{let s=Ze(t,o),a=Ze(r,o);if(u&&u.ignores(o))return;if(H.ensureDir(QD(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}){H.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var jn=ue(In(),1);import{readFileSync as $l,writeFileSync as Ul,existsSync as Wl}from"fs";var _e=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 $l(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){Ul(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let n=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof n=="string"?n:JSON.stringify(n))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,jn.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 n=this.getRealTemplateFilePath(u);return Wl(n)?(this.mergeJSONFile(n,JSON.parse(i)),!0):(this.writeFile(n,i),!0)}return this.writeFile(u,i),!0}return!1}};var Gn=["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(!Nn(r))throw new Error("template path not exit");this.ora=Kt,this.context=new Hl("create-app",t),this.subPackages=["node-lib","react-app","next-app"],this.copyer=new Ce(N(this.context.options.configsRootPath,"_common")),this.compose=new _e}get logger(){return this.context.logger}async steps(t){try{return await Yl.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 Gn.includes(t)}async getGeneratorContext(){let t=mt(this.subPackages,Gn),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=_t(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=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:n,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=N(n,u);if(!Nn(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,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:n}=this.context.options;for(let o of u){let s=N(n,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.10.0",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:{lint:"eslint src --fix",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 Kl(){let e=new zl;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 kn(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Kl(),i=Mn(e,"./templates"),n=Mn(e,"./configs");Ln(i)||(console.error("Template is empty!"),process.exit(1)),Ln(n)||(console.error("Configs is empty!"),process.exit(1)),await new Be({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:n}}).generate()}import{fileURLToPath as Xl}from"url";import{dirname as Jl}from"path";var Zl=Xl(import.meta.url),Ql=Jl(Zl);kn(Ql).catch(e=>{console.error(e),process.exit(1)});
+`).map(o=>o.trim()).filter(o=>o&&!o.startsWith("#"));return(0,nr.default)().add(n)}async copyFiles(t,r,u,i){let n=await Dr.readdir(t);await Promise.all(n.map(async o=>{let s=Ze(t,o),a=Ze(r,o);if(u&&u.ignores(o))return;if(H.ensureDir(QD(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}){H.ensureDir(r);let i=this.getIg();return this.copyFiles(t,r,i,u)}};var jn=ue(In(),1);import{readFileSync as $l,writeFileSync as Ul,existsSync as Wl}from"fs";var _e=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 $l(t,"utf-8")}readJSONFile(t){return JSON.parse(this.readFile(t))}writeFile(t,r){Ul(this.getRealTemplateFilePath(t),r,{encoding:"utf-8"})}replaceFile(t,r){let u=this.readFile(t);return Object.keys(r).forEach(i=>{let n=r[i];u=u.replace(new RegExp(`\\[TPL:${i}\\]`,"g"),typeof n=="string"?n:JSON.stringify(n))}),u}mergeJSONFile(t,r){let u=this.readJSONFile(t),i=(0,jn.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 n=this.getRealTemplateFilePath(u);return Wl(n)?(this.mergeJSONFile(n,JSON.parse(i)),!0):(this.writeFile(n,i),!0)}return this.writeFile(u,i),!0}return!1}};var Gn=["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(!Nn(r))throw new Error("template path not exit");this.ora=Kt,this.context=new Hl("create-app",t),this.subPackages=["node-lib","react-app","next-app"],this.copyer=new Ce(N(this.context.options.configsRootPath,"_common")),this.compose=new _e}get logger(){return this.context.logger}async steps(t){try{return await Yl.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 Gn.includes(t)}async getGeneratorContext(){let t=mt(this.subPackages,Gn),r=await this.steps(t);if(this.isPackageTemplate(r.template)){let u=_t(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=(a,l)=>(this.logger.debug("copyCallback",a,l),this.compose.composeConfigFile(t,a,l)),{configsRootPath:n,config:o}=this.context.options;if(!o){this.logger.debug("no copy config files");return}let s=N(n,u);if(!Nn(s)){this.logger.debug(`Config path not found: ${s}`);return}await this.copyer.copyPaths({sourcePath:s,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:n}=this.context.options;for(let o of u){let s=N(n,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.10.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:{lint:"eslint src --fix",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 Kl(){let e=new zl;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 kn(e=process.cwd()){let{dryRun:t,verbose:r,...u}=Kl(),i=Mn(e,"./templates"),n=Mn(e,"./configs");Ln(i)||(console.error("Template is empty!"),process.exit(1)),Ln(n)||(console.error("Configs is empty!"),process.exit(1)),await new Be({dryRun:t,verbose:r,options:{...u,templateRootPath:i,configsRootPath:n}}).generate()}import{fileURLToPath as Xl}from"url";import{dirname as Jl}from"path";var Zl=Xl(import.meta.url),Ql=Jl(Zl);kn(Ql).catch(e=>{console.error(e),process.exit(1)});

package/dist/templates/next-app/config/IOCIdentifier.ts

@@ -3,7 +3,7 @@ import type { DialogHandler } from '@/base/cases/DialogHandler';
 import type { RouterService } from '@/base/cases/RouterService';
 import type { I18nService } from '@/base/services/I18nService';
 import type { UserService } from '@/base/services/UserService';
-import type { DBBridgeInterface } from '@/server/port/DBBridgeInterface';
+import type { SupabaseBridge } from '@/server/SupabaseBridge';
 import type * as CorekitBridge from '@qlover/corekit-bridge';
 import type * as FeCorekit from '@qlover/fe-corekit';
 import type { LoggerInterface } from '@qlover/logger';
@@ -70,5 +70,5 @@ export interface IOCIdentifierMap {
 export interface IOCIdentifierMapServer {
   [IOCIdentifier.AppConfig]: AppConfig;
   [IOCIdentifier.Logger]: LoggerInterface;
-  [IOCIdentifier.DBBridgeInterface]: DBBridgeInterface;
+  [IOCIdentifier.DBBridgeInterface]: SupabaseBridge;
 }

package/dist/templates/next-app/config/Identifier/common/common.ts

@@ -33,6 +33,13 @@ export const COMMON_DETAIL = 'common:detail';
  */
 export const COMMON_THEME_DEFAULT = 'common:theme__default';
 
+/**
+ * @description Theme switcher light theme label
+ * @localZh 亮色主题
+ * @localEn Light Theme
+ */
+export const COMMON_THEME_LIGHT = 'common:theme__light';
+
 /**
  * @description Theme switcher dark theme label
  * @localZh 暗色主题
@@ -74,3 +81,10 @@ export const COMMON_LOGOUT_DIALOG_CONTENT = 'common:logout__dialog__content';
  * @localEn I18n key format is incorrect
  */
 export const COMMON_I18N_KEY_INVALID = 'common:i18n_key_invalid';
+
+/**
+ * @description manifest name
+ * @localZh 应用名称
+ * @localEn Application Name
+ */
+export const COMMON_MANIFEST_NAME = 'common:manifest__name';

package/dist/templates/next-app/config/Identifier/pages/index.ts

@@ -4,3 +4,4 @@ export * from './page.admin.user';
 export * from './page.home';
 export * from './page.register';
 export * from './page.login';
+export * from './page.about';

package/dist/templates/next-app/config/Identifier/pages/page.about.ts

@@ -0,0 +1,20 @@
+/**
+ * @description About page title
+ * @localZh 关于我们
+ * @localEn About Us
+ */
+export const PAGE_ABOUT_TITLE = 'page_about:title';
+
+/**
+ * @description About page description
+ * @localZh 了解我们的团队和使命
+ * @localEn Learn about our team and mission
+ */
+export const PAGE_ABOUT_DESCRIPTION = 'page_about:description';
+
+/**
+ * @description About page keywords
+ * @localZh 关于我们, 团队, 使命
+ * @localEn About us, team, mission
+ */
+export const PAGE_ABOUT_KEYWORDS = 'page_about:keywords';

package/dist/templates/next-app/config/common.ts

@@ -26,7 +26,7 @@ export const useLocaleRoutes = true;
  * - true: 使用API获取本地化数据，可以在 /admin/locales 页面中对他进行修改
  * - false: 不使用API获取本地化数据，直接使用 `@brain-toolkit/ts2locales` 生成的json数据
  */
-export const useApiLocales = false;
+export const useApiLocales = true;
 
 /**
  * 是否在在 useWarnTranslations 中警告缺失的翻译,而不是抛出错误

package/dist/templates/next-app/config/cookies.ts

@@ -0,0 +1,23 @@
+export const cookiesConfig: Cookies.CookieAttributes = {
+  domain: '',
+  path: '/',
+  expires: 30,
+  /**
+   * httpOnly 必须为 false，否则客户端 JavaScript 无法设置 cookie
+   * httpOnly: true 只能用于服务端设置的 cookie（如认证 token）
+   */
+  httpOnly: false,
+  /**
+   * 是否仅通过 HTTPS 传输
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#secure_cookie_attribute
+   */
+  secure: false,
+  /**
+   * 'strict'：最严格，跨站请求（如从其他网站链接过来）不发送 Cookie
+   * 其他可选值：'lax'（部分允许）、'none'（允许，但需要 secure: true）
+   *
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Cookies#samesite_cookie_attribute
+   */
+  sameSite: 'strict'
+};

package/dist/templates/next-app/config/i18n/AboutI18n.ts

@@ -0,0 +1,14 @@
+import * as i18nKeys from '../Identifier/pages/page.about';
+
+/**
+ * About page i18n interface
+ */
+export type AboutI18nInterface = typeof aboutI18n;
+
+export const aboutI18n = Object.freeze({
+  // basic meta properties
+  title: i18nKeys.PAGE_ABOUT_TITLE,
+  description: i18nKeys.PAGE_ABOUT_DESCRIPTION,
+  content: i18nKeys.PAGE_ABOUT_DESCRIPTION,
+  keywords: i18nKeys.PAGE_ABOUT_KEYWORDS
+});

package/dist/templates/next-app/config/i18n/i18nConfig.ts

@@ -8,7 +8,9 @@ export const i18nConfig = {
   fallbackLng: 'en',
   debug: false,
   supportedLngs: ['en', 'zh'] as const,
-  localeDetection: true
+  localeDetection: true,
+  defaultNamespaces: ['common', 'api'],
+  storageKey: 'NEXT_LOCALE'
 } as const;
 
 export type LocaleType = (typeof i18nConfig.supportedLngs)[number];

package/dist/templates/next-app/config/i18n/index.ts

@@ -4,3 +4,4 @@ export * from './i18nConfig';
 export * from './loginI18n';
 export * from './PageI18nInterface';
 export * from './register18n';
+export * from './AboutI18n';

package/dist/templates/next-app/config/i18n/loginI18n.ts

@@ -8,6 +8,14 @@ import * as i18nKeys from '../Identifier/pages/page.login';
  */
 export type LoginI18nInterface = typeof loginI18n;
 
+/**
+ * Login page i18n namespace
+ *
+ * - /login/page.tsx
+ *
+ */
+export const NS_PAGE_LOGIN = 'page_login';
+
 export const loginI18n = Object.freeze({
   // basic meta properties
   title: i18nKeys.PAGE_LOGIN_TITLE,

package/dist/templates/next-app/config/theme.ts

@@ -5,7 +5,11 @@ import type { ThemeConfig } from 'antd';
  */
 export const themeConfig = {
   domAttribute: 'data-theme',
+  /**
+   * If `enableSystem` is false, the default theme is light
+   */
   defaultTheme: 'system',
+  enableSystem: true,
   target: 'html',
   supportedThemes: ['light', 'dark', 'pink'],
   storageKey: 'fe_theme',

package/dist/templates/next-app/eslint.config.mjs

@@ -192,6 +192,9 @@ const eslintConfig = [
       'src/app/**/not-found.tsx',
       'src/i18n/request.ts',
       'src/middleware.ts',
+      'src/pages/**/*.tsx',
+      'src/app/manifest.ts',
+      'src/proxy.ts',
       '**/*.config.*'
     ],
     rules: {
@@ -200,4 +203,4 @@ const eslintConfig = [
   }
 ];
 
-export default eslintConfig;
+export default eslintConfig;

package/dist/templates/next-app/migrations/schema/UserSchema.ts

@@ -1,4 +1,5 @@
 import { z } from 'zod';
+import type { SafeParseReturnType } from 'zod';
 
 export const UserRole = {
   ADMIN: 0,
@@ -16,9 +17,22 @@ export const userSchema = z.object({
    * 加密的token, 包含token, 过期时间
    */
   credential_token: z.string(),
-  email_confirmed_at: z.number(),
-  created_at: z.number(),
-  updated_at: z.number()
+  email_confirmed_at: z.number().nullable().optional(),
+  created_at: z.string(),
+  updated_at: z.string().nullable().optional()
 });
 
 export type UserSchema = z.infer<typeof userSchema>;
+
+export type UserCredential = {
+  credential_token: string;
+};
+
+export function isWebUserSchema(
+  value: unknown
+): SafeParseReturnType<
+  Omit<UserSchema, 'password'>,
+  Omit<UserSchema, 'password'>
+> {
+  return userSchema.omit({ password: true }).safeParse(value);
+}

package/dist/templates/next-app/next.config.ts

@@ -14,6 +14,7 @@ const nextConfig: NextConfig = {
   turbopack: {
     root: __dirname // 明确指定根目录
   },
+  transpilePackages: ['@qlover/corekit-bridge', '@qlover/fe-corekit'],
   env: {
     APP_ENV: process.env.APP_ENV
   }

package/dist/templates/next-app/package.json

@@ -10,8 +10,8 @@
     "build:staging": "cross-env APP_ENV=staging next build --turbopack",
     "build:prod": "cross-env APP_ENV=production next build --turbopack",
     "start": "next start --port 3101",
-    "lint": "eslint ./src ./config ./make ./migrations",
-    "lint:fix": "eslint ./src ./config ./make ./migrations --ext .ts,.tsx --fix",
+    "lint": "tsc --noEmit && eslint ./src ./config ./make ./migrations",
+    "lint:fix": "tsc --noEmit && eslint ./src ./config ./make ./migrations --ext .ts,.tsx --fix",
     "format": "prettier --write \"**/*.{js,jsx,ts,tsx,json,css,scss,md}\"",
     "format:check": "prettier --check \"**/*.{js,jsx,ts,tsx,json,css,scss,md}\"",
     "fix": "npm run lint:fix && npm run format"
@@ -24,12 +24,12 @@
     "@brain-toolkit/antd-theme-override": "^0.0.3",
     "@brain-toolkit/bridge": "^0.0.1",
     "@brain-toolkit/react-kit": "^0.1.0",
-    "@qlover/corekit-bridge": "^1.6.5",
-    "@qlover/fe-corekit": "^2.1.0",
+    "@qlover/corekit-bridge": "latest",
+    "@qlover/fe-corekit": "latest",
     "@qlover/slice-store-react": "^1.4.1",
-    "@supabase/auth-helpers-nextjs": "^0.10.0",
     "@supabase/ssr": "^0.7.0",
     "@supabase/supabase-js": "^2.57.2",
+    "@types/js-cookie": "^3.0.6",
     "@types/jsonwebtoken": "^9.0.10",
     "antd": "^5.27.1",
     "clsx": "^2.1.1",
@@ -37,7 +37,7 @@
     "inversify": "^7.8.1",
     "jsonwebtoken": "^9.0.2",
     "lodash": "^4.17.21",
-    "next": "15.5.0",
+    "next": "^16.0.3",
     "next-intl": "^4.3.5",
     "next-themes": "^0.4.6",
     "openai": "^5.23.0",
@@ -67,8 +67,16 @@
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-unused-imports": "^4.2.0",
     "prettier": "^3.6.2",
-    "supabase": "^2.40.7",
     "tailwindcss": "^4",
     "typescript": "^5"
+  },
+  "engines": {
+    "node": "^20.17.0 || >=22.9.0",
+    "npm": ">=10.0.0"
+  },
+  "prettier": {
+    "singleQuote": true,
+    "trailingComma": "none",
+    "endOfLine": "lf"
   }
 }

package/dist/templates/next-app/public/locales/en.json

@@ -19,17 +19,22 @@
   "common:create": "Create",
   "common:detail": "Detail",
   "common:theme__default": "Default Theme",
+  "common:theme__light": "Light Theme",
   "common:theme__dark": "Dark Theme",
   "common:theme__pink": "Pink Theme",
   "common:admin__title": "Admin Backend",
   "common:logout__dialog__title": "Logout",
   "common:logout__dialog__content": "Are you sure you want to logout?",
   "common:i18n_key_invalid": "I18n key format is incorrect",
+  "common:manifest__name": "Application Name",
   "common:v:login_params_required": "Not a valid login parameter",
   "common:v:email_invalid": "Invalid email format validation message",
   "common:v:password_min_length": "Password minimum length validation message(6)",
   "common:v:password_max_length": "Password maximum length validation message(50)",
   "common:v:password_special_chars": "Password cannot contain whitespace characters validation message",
+  "page_about:title": "About Us",
+  "page_about:description": "Learn about our team and mission",
+  "page_about:keywords": "About us, team, mission",
   "admin_home:title": "Admin page",
   "admin_home:description": "Admin page",
   "admin_home:keywords": "Admin page",

package/dist/templates/next-app/public/locales/zh.json

@@ -19,17 +19,22 @@
   "common:create": "创建",
   "common:detail": "详情",
   "common:theme__default": "默认主题",
+  "common:theme__light": "亮色主题",
   "common:theme__dark": "暗色主题",
   "common:theme__pink": "粉色主题",
   "common:admin__title": "管理后台",
   "common:logout__dialog__title": "登出",
   "common:logout__dialog__content": "确定要登出吗？",
   "common:i18n_key_invalid": "i18n 键格式不正确",
+  "common:manifest__name": "应用名称",
   "common:v:login_params_required": "不是一个有效的登录参数",
   "common:v:email_invalid": "邮箱格式无效的验证消息",
   "common:v:password_min_length": "密码最小长度验证消息(6)",
   "common:v:password_max_length": "密码最大长度验证消息(50)",
   "common:v:password_special_chars": "密码不能包含空格的验证消息",
+  "page_about:title": "关于我们",
+  "page_about:description": "了解我们的团队和使命",
+  "page_about:keywords": "关于我们, 团队, 使命",
   "admin_home:title": "管理员页面",
   "admin_home:description": "管理员页面",
   "admin_home:keywords": "管理员页面关键词",

package/dist/templates/next-app/src/app/[locale]/admin/AdminI18nProvider.tsx

@@ -0,0 +1,37 @@
+'use client';
+
+import { NextIntlClientProvider, useMessages } from 'next-intl';
+
+/**
+ * Client component wrapper to merge admin i18n messages
+ * NextIntlClientProvider supports nesting and will merge messages from parent provider
+ */
+export function AdminI18nProvider({
+  children,
+  locale,
+  adminMessages
+}: {
+  children: React.ReactNode;
+  locale: string;
+  adminMessages: Record<string, string>;
+}) {
+  // Get existing messages from parent NextIntlClientProvider (includes common, api)
+  const existingMessages = useMessages();
+
+  // Merge admin messages with existing messages
+  // Admin messages will override any existing keys with the same name
+  const mergedMessages = {
+    ...existingMessages,
+    ...adminMessages
+  };
+
+  return (
+    <NextIntlClientProvider
+      data-testid="AdminI18nProvider"
+      locale={locale}
+      messages={mergedMessages}
+    >
+      {children}
+    </NextIntlClientProvider>
+  );
+}