@qlover/create-app 0.1.11 → 0.1.14

package/package.json

@@ -1,20 +1,18 @@
 {
   "name": "@qlover/create-app",
-  "version": "0.1.11",
+  "version": "0.1.14",
   "type": "module",
   "private": false,
-  "main": "./dist/es/index.js",
-  "module": "./dist/es/index.js",
-  "types": "./dist/es/index.d.ts",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
+    "./package.json": "./package.json",
     ".": {
-      "import": "./dist/es/index.js",
-      "require": "./dist/cjs/index.js",
-      "types": "./dist/es/index.d.ts"
-    },
-    "./cjs/*": "./dist/cjs/*",
-    "./es/*": "./dist/es/*",
-    "./package.json": "./package.json"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
   },
   "files": [
     "dist",
@@ -26,11 +24,10 @@
     "CHANGELOG.md"
   ],
   "bin": {
-    "create-app": "./bin/create-app.js"
+    "create-app": "bin/create-app.js"
   },
   "scripts": {
     "build": "rollup -c",
-    "test": "jest",
     "create:app:build": "npm run build && npm run create:app",
     "create:app": "node ./bin/create-app.js"
   },
@@ -50,12 +47,16 @@
   "publishConfig": {
     "access": "public"
   },
+  "devDependencies": {
+    "@qlover/env-loader": "^0.0.1"
+  },
   "dependencies": {
-    "@qlover/fe-utils": "latest",
-    "@qlover/scripts-context": "latest",
+    "@qlover/fe-corekit": "^1.2.2",
+    "@qlover/scripts-context": "^0.0.8",
     "commander": "^13.1.0",
     "ignore": "^7.0.3",
     "inquirer": "^12.3.2",
-    "ora": "^8.1.1"
+    "ora": "^8.1.1",
+    "lodash": "^4.17.21"
   }
 }

package/templates/node-lib/bin/test.js

@@ -10,7 +10,7 @@ function programArgs() {
       'Do not touch or write anything, but show the commands'
     )
     .option('-V, --verbose', 'Show more information')
-    .option('-n, --name <name>', 'The name of the test')
+    .option('-n, --name <name>', 'The name of the test');
   // parse arguments
   program.parse();
 

package/templates/node-lib/package.json

@@ -46,8 +46,8 @@
     "run:command": "node bin/test.js"
   },
   "devDependencies": {
-    "@qlover/env-loader": "latest",
-    "@qlover/fe-standard": "latest",
+    "@qlover/env-loader": "workspace:*",
+    "@qlover/fe-standard": "workspace:*",
     "@qlover/scripts-context": "latest",
     "@release-it/conventional-changelog": "^8.0.1",
     "@rollup/plugin-commonjs": "^28.0.1",

package/templates/node-lib/rollup.config.js

@@ -9,7 +9,7 @@ import { readFileSync, rmSync } from 'fs';
 import { Env } from '@qlover/env-loader';
 
 const pkg = JSON.parse(readFileSync('./package.json'), 'utf-8');
-const env = Env.searchEnv({ logger: console });
+const env = Env.searchEnv();
 const isProduction = env.get('NODE_ENV') === 'production';
 const buildDir = 'dist';
 
@@ -44,7 +44,6 @@ function createPlugin(minify) {
 
 function cleanBuildDir() {
   rmSync(buildDir, { recursive: true, force: true });
-  console.log(`${buildDir} cleaned`);
 }
 
 cleanBuildDir();

package/templates/pack-app/package.json

@@ -31,7 +31,7 @@
   },
   "devDependencies": {
     "@qlover/fe-scripts": "latest",
-    "@qlover/fe-standard": "latest",
+    "@qlover/fe-standard": "workspace:*",
     "@qlover/fe-utils": "latest",
     "@qlover/fe-release": "latest",
     "@rollup/plugin-commonjs": "^28.0.1",

package/templates/react-app/.env

@@ -1,3 +1,24 @@
+NODE_ENV=production
+
+# ci
+NPM_TOKEN=
+GITHUB_TOKEN=
+
+# fe-scripts
+FE_RELEASE_BRANCH=master
+FE_RELEASE=false
+FE_RELEASE_ENV=production
+
+# ===== build
+VITE_PUBLIC_PATH=
 VITE_SERVER_PORT=3200
-VITE_OPENAI_API_URL=
-VITE_OPENAI_API_KEY=
+
+# ===== app config
+VITE_USER_TOKEN_STORAGE_KEY=fe_user_token
+VITE_OPEN_AI_MODELS='["gpt-4o-mini","gpt-3.5-turbo","gpt-3.5-turbo-2","gpt-4","gpt-4-32k"]'
+VITE_OPEN_AI_BASE_URL=https://api.openai.com/v1
+VITE_OPEN_AI_TOKEN=sk-proj-1234567890
+VITE_OPEN_AI_TOKEN_PREFIX=Bearer
+VITE_OPEN_AI_REQUIRE_TOKEN=true
+VITE_LOGIN_USER=admin
+VITE_LOGIN_PASSWORD=123456

package/templates/react-app/.env.local

@@ -0,0 +1,24 @@
+NODE_ENV=local
+
+# ci
+NPM_TOKEN=
+GITHUB_TOKEN=
+
+# fe-scripts
+FE_RELEASE_BRANCH=master
+FE_RELEASE=false
+FE_RELEASE_ENV=production
+
+# ===== build
+VITE_PUBLIC_PATH=
+VITE_SERVER_PORT=3200
+
+# ===== app config
+VITE_USER_TOKEN_STORAGE_KEY=fe_user_token
+VITE_OPEN_AI_MODELS='["gpt-4o-mini","gpt-3.5-turbo","gpt-3.5-turbo-2","gpt-4","gpt-4-32k"]'
+VITE_OPEN_AI_BASE_URL=https://openai-proxy.brain.loocaa.com:1443/v1/
+VITE_OPEN_AI_TOKEN=DlJYSkMVj1x4zoe8jZnjvxfHG6z5yGxK
+VITE_OPEN_AI_TOKEN_PREFIX=Bearer
+VITE_OPEN_AI_REQUIRE_TOKEN=true
+VITE_LOGIN_USER=admin
+VITE_LOGIN_PASSWORD=123456

package/templates/react-app/config/common.ts

@@ -0,0 +1,3 @@
+export const envPrefix = 'VITE_';
+
+export const browserGlobalsName = 'feGlobals';

package/templates/react-app/lib/bootstrap/Bootstrap.ts

@@ -0,0 +1,36 @@
+import type { IOCContainerInterface } from './IOCContainerInterface';
+import { SyncExecutor } from '@qlover/fe-utils';
+import { BootstrapExecutorPlugin } from './BootstrapExecutorPlugin';
+
+export class Bootstrap extends SyncExecutor {
+  constructor(private IOCContainer: IOCContainerInterface) {
+    super();
+  }
+
+  getIOCContainer(): IOCContainerInterface {
+    return this.IOCContainer;
+  }
+
+  use(plugin: BootstrapExecutorPlugin | BootstrapExecutorPlugin[]): this {
+    if (Array.isArray(plugin)) {
+      plugin.forEach((p) => super.use(p));
+      return this;
+    }
+
+    super.use(plugin);
+
+    return this;
+  }
+
+  start(root: unknown): void {
+    this.exec({ root, ioc: this.IOCContainer }, () => {
+      // nothing to do
+    });
+  }
+
+  startNoError(root: unknown): void {
+    this.execNoError({ root, ioc: this.IOCContainer }, () => {
+      // nothing to do
+    });
+  }
+}

package/templates/react-app/lib/bootstrap/BootstrapExecutorPlugin.ts

@@ -0,0 +1,20 @@
+import { IOCContainerInterface } from './IOCContainerInterface';
+import { ExecutorContext, ExecutorPlugin } from '@qlover/fe-utils';
+
+export type BootstrapArgs = {
+  /**
+   * starup global object
+   *
+   * maybe window or globalThis
+   */
+  root: unknown;
+  /**
+   * IOC container
+   */
+  ioc: IOCContainerInterface;
+};
+
+export interface BootstrapExecutorPlugin
+  extends ExecutorPlugin<BootstrapArgs> {}
+
+export type BootstrapContext = ExecutorContext<BootstrapArgs>;

package/templates/react-app/lib/bootstrap/IOCContainerInterface.ts

@@ -0,0 +1,33 @@
+/**
+ * IOC container
+ *
+ */
+export interface IOCContainerInterface {
+  /**
+   * configure IOC container
+   *
+   * eg. may need to manually bind implementation classes
+   */
+  configure(): void;
+  configure<Container>(registers?: IOCRegisterInterface<Container>[]): void;
+
+  /**
+   * bind instance
+   *
+   * @param serviceIdentifier
+   * @param value
+   */
+  bind<T>(serviceIdentifier: unknown, value: T): void;
+
+  /**
+   * get instance
+   *
+   * @param serviceIdentifier
+   * @returns
+   */
+  get<T>(serviceIdentifier: unknown): T;
+}
+
+export interface IOCRegisterInterface<T> {
+  register(container: T, thisArg: IOCContainerInterface): void;
+}

package/templates/react-app/lib/bootstrap/IOCManagerInterface.ts

@@ -0,0 +1,12 @@
+import type { IOCContainerInterface } from './IOCContainerInterface';
+
+export interface IOCManagerInterface {
+  get<T>(identifier: unknown): T;
+
+  /**
+   * implement IOC container
+   */
+  implement(container: IOCContainerInterface): void;
+
+  get implemention(): IOCContainerInterface | null;
+}

package/templates/react-app/lib/bootstrap/index.ts

@@ -0,0 +1,7 @@
+export * from './Bootstrap';
+export * from './BootstrapExecutorPlugin';
+export * from './plugins/InjectIOC';
+export * from './plugins/InjectEnv';
+export * from './plugins/InjectGlobal';
+export * from './IOCContainerInterface';
+export * from './IOCManagerInterface';

package/templates/react-app/lib/bootstrap/plugins/InjectEnv.ts

@@ -0,0 +1,61 @@
+import type { BootstrapExecutorPlugin } from '../BootstrapExecutorPlugin';
+
+export interface EnvConfigInterface {
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  [key: string]: any;
+}
+
+export class InjectEnv implements BootstrapExecutorPlugin {
+  readonly pluginName = 'InjectEnv';
+
+  constructor(
+    private target: EnvConfigInterface,
+    private source: Record<string, unknown>,
+    private envPrefix: string = '',
+    private envWhiteList: string[] = ['env', 'userNodeEnv']
+  ) {}
+
+  static isJSONString(value: string): boolean {
+    return (
+      typeof value === 'string' &&
+      value !== '' &&
+      (value === 'true' ||
+        value === 'false' ||
+        value.startsWith('{') ||
+        value.startsWith('['))
+    );
+  }
+
+  env<D>(key: string, defaultValue?: D): D {
+    // transform key to env key
+    const formattedKey = key.replace(/([a-z])([A-Z])/g, '$1_$2').toUpperCase();
+
+    const envKey = `${this.envPrefix}${formattedKey}`;
+    const value = this.source[envKey];
+    // if it is a json string, parse it
+    if (typeof value === 'string' && InjectEnv.isJSONString(value)) {
+      return JSON.parse(value);
+    }
+
+    return (value ?? defaultValue) as D;
+  }
+
+  inject(config: EnvConfigInterface): void {
+    for (const key in config) {
+      if (this.envWhiteList.includes(key)) {
+        continue;
+      }
+
+      const value = config[key as keyof typeof config];
+
+      config[key as keyof typeof config] = this.env(key, value);
+    }
+  }
+
+  onBefore(): void {
+    this.inject(this.target);
+
+    // transform readonly to writable
+    Object.freeze(this.target);
+  }
+}

package/templates/react-app/lib/bootstrap/plugins/InjectGlobal.ts

@@ -0,0 +1,36 @@
+import type { ExecutorContext } from '@qlover/fe-utils';
+import type {
+  BootstrapArgs,
+  BootstrapExecutorPlugin
+} from '../BootstrapExecutorPlugin';
+
+export class InjectGlobal implements BootstrapExecutorPlugin {
+  readonly pluginName = 'InjectGlobal';
+
+  constructor(
+    private sources: Record<string, unknown>,
+    private target?: string | Record<string, unknown>
+  ) {}
+
+  onBefore(context: ExecutorContext<BootstrapArgs>): void {
+    // if target is provided, inject globals to target
+    if (typeof this.target === 'string') {
+      Object.assign(context.parameters.root!, {
+        [this.target]: Object.freeze(Object.assign({}, this.sources))
+      });
+      return;
+    }
+
+    const target = this.target || context.parameters.root;
+
+    if (typeof target !== 'object' || target === null) {
+      throw new Error('target must be an object');
+    }
+
+    // inject globals to root
+    for (const key in this.sources) {
+      const element = this.sources[key];
+      Object.assign(target, { [key]: element });
+    }
+  }
+}

package/templates/react-app/lib/bootstrap/plugins/InjectIOC.ts

@@ -0,0 +1,24 @@
+import type { IOCRegisterInterface } from '../IOCContainerInterface';
+import type { IOCManagerInterface } from '../IOCManagerInterface';
+import type {
+  BootstrapContext,
+  BootstrapExecutorPlugin
+} from '../BootstrapExecutorPlugin';
+import { Container } from 'inversify';
+
+export class InjectIOC implements BootstrapExecutorPlugin {
+  readonly pluginName = 'InjectIOC';
+
+  constructor(
+    private IOC: IOCManagerInterface,
+    private registeres: IOCRegisterInterface<Container>[]
+  ) {}
+
+  onBefore(context: BootstrapContext): void {
+    const { ioc } = context.parameters;
+    this.IOC.implement(ioc);
+
+    // maybe runtimes configure
+    ioc.configure(this.registeres);
+  }
+}

package/templates/react-app/lib/env-config/injectPkgConfig.ts

@@ -0,0 +1,11 @@
+export function injectPkgConfig(
+  options: [string, string][],
+  envPrefix: string = ''
+) {
+  options.forEach(([key, value]) => {
+    const envKey = `${envPrefix}${key}`;
+    if (!process.env[envKey]) {
+      process.env[envKey] = value;
+    }
+  });
+}

package/templates/react-app/lib/openAiApi/OpenAIClient.ts

@@ -25,7 +25,7 @@ export interface OpenAIChatParmas {
 
 export type OpenAIAargs = {
   commonPluginConfig: RequestCommonPluginConfig;
-  models: readonly string[];
+  models: string[];
 };
 
 export type OpenAIClientConfig = Partial<RequestAdapterFetchConfig> &

package/templates/react-app/lib/router-loader/Page.ts

@@ -48,15 +48,19 @@ export type LoadProps = {
   Provider?: React.ComponentType<PropsWithChildren<RouteMeta>>;
 };
 
-
-type ComponentValue = React.ComponentType<unknown> | LazyExoticComponent<React.ComponentType<unknown>>;
+type ComponentValue =
+  | React.ComponentType<unknown>
+  | LazyExoticComponent<React.ComponentType<unknown>>;
 
 export type ComponentMaps = {
   /**
    * key: ./xxx/bbb.(jsx,js,tsx,ts)
    */
-  [key: string]: ComponentValue | (() => Promise<ComponentValue>) | (() => ComponentValue);
-}
+  [key: string]:
+    | ComponentValue
+    | (() => Promise<ComponentValue>)
+    | (() => ComponentValue);
+};
 
 // new RouterManager({
 //   routes: [],

package/templates/react-app/lib/router-loader/RouterLoader.ts

@@ -11,7 +11,7 @@ type RouteComponentType<T = unknown> =
 export type RouteConfigValue = Omit<RouteObject, 'element' | 'children'> & {
   /**
    * 路径
-   * 
+   *
    * FIXME: support `ReactNode`
    */
   element?: string;

package/templates/react-app/package.json

@@ -56,11 +56,13 @@
     "i18next": "^24.2.0",
     "i18next-browser-languagedetector": "^8.0.2",
     "i18next-http-backend": "^3.0.1",
+    "inversify": "^7.1.0",
     "lodash": "^4.17.21",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
     "react-i18next": "^15.2.0",
-    "react-router-dom": "^7.1.5"
+    "react-router-dom": "^7.1.5",
+    "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
     "@eslint/js": "^9.11.1",