@qlover/create-app 0.0.1

package/templates/fe-react/lib/request-common-plugin/index.ts

@@ -0,0 +1,169 @@
+import { get, isUndefined, set } from 'lodash';
+import {
+  ExecutorPlugin,
+  RequestAdapterConfig,
+  ExecutorContext,
+  RequestAdapterResponse
+} from '@qlover/fe-utils';
+
+export type RequestCommonPluginConfig = {
+  token?: string | (() => string | null);
+
+  /**
+   * token prefix.
+   *
+   * eg. `Bearer xxx`, `Token xxx`
+   */
+  tokenPrefix?: string;
+
+  /**
+   * @default `Authorization`
+   */
+  authKey?: string;
+
+  /**
+   * default request headers
+   */
+  defaultHeaders?: Record<string, string>;
+
+  /**
+   * Whether the token is required.
+   *
+   * if not token provided, throw error.
+   *
+   * @default `false`
+   */
+  requiredToken?: boolean;
+
+  /**
+   * defualt request data
+   */
+  defaultRequestData?: Record<string, unknown>;
+
+  /**
+   * transform request data before sending.
+   *
+   * @param data - request data
+   * @param context - executor context
+   * @returns - request data
+   */
+  requestDataSerializer?: (
+    data: unknown,
+    context: ExecutorContext<RequestAdapterConfig>
+  ) => unknown;
+};
+
+/**
+ * Represents a plugin for handling common request configurations and behaviors.
+ *
+ * The RequestCommonPlugin is designed to manage request headers, token handling,
+ * and data serialization before sending requests. It ensures that the necessary
+ * configurations are applied to each request, enhancing the flexibility and
+ * reusability of request handling in the application.
+ *
+ * Main functions include:
+ * - Appending default headers and token to requests.
+ * - Merging default request data with provided parameters.
+ * - Serializing request data before sending.
+ *
+ * @example
+ * const plugin = new RequestCommonPlugin({
+ *   token: 'your-token',
+ *   tokenPrefix: 'Bearer',
+ *   defaultHeaders: { 'Custom-Header': 'value' },
+ *   requiredToken: true,
+ * });
+ */
+export class RequestCommonPlugin
+  implements ExecutorPlugin<RequestAdapterConfig>
+{
+  readonly pluginName = 'RequestCommonPlugin';
+
+  constructor(readonly config: RequestCommonPluginConfig = {}) {
+    if (config.requiredToken && !config.token) {
+      throw new Error('Token is required!');
+    }
+  }
+
+  onBefore(context: ExecutorContext<RequestAdapterConfig>): void {
+    const {
+      tokenPrefix,
+      defaultHeaders,
+      authKey = 'Authorization',
+      defaultRequestData,
+      requestDataSerializer
+    } = this.config;
+    const { parameters } = context;
+
+    // append default headers
+    parameters.headers = {
+      ...defaultHeaders,
+      ...parameters.headers
+    };
+
+    // append content type header
+    if (
+      !parameters.headers['Content-Type'] &&
+      parameters.responseType === 'json'
+    ) {
+      parameters.headers['Content-Type'] = 'application/json';
+    }
+
+    // append token
+    if (authKey && !parameters.headers[authKey]) {
+      const authToken = this.getAuthToken();
+      const authValue = tokenPrefix ? `${tokenPrefix} ${authToken}` : authToken;
+      if (authValue) {
+        parameters.headers[authKey] = authValue;
+      }
+    }
+
+    // merge defaults request data
+    if (defaultRequestData) {
+      Object.entries(defaultRequestData).forEach(([key, value]) => {
+        const prevValue = get(parameters.data, key);
+        if (isUndefined(prevValue)) {
+          set(parameters.data as Record<string, unknown>, key, value);
+        }
+      });
+    }
+
+    // serialize request data
+    if (requestDataSerializer && parameters.data) {
+      parameters.data = requestDataSerializer(parameters.data, context);
+    }
+  }
+
+  async onSuccess(
+    context: ExecutorContext<RequestAdapterConfig>
+  ): Promise<void> {
+    const { parameters, returnValue } = context;
+    const response = (returnValue as RequestAdapterResponse<unknown, Response>)
+      .data;
+
+    if (response instanceof Response) {
+      switch (parameters.responseType) {
+        case 'json':
+          context.returnValue = await response.json();
+          break;
+        case 'text':
+          context.returnValue = await response.text();
+          break;
+        case 'blob':
+          context.returnValue = await response.blob();
+          break;
+        // FIXME: adapter support `arraybuffer`
+        // @ts-expect-error
+        case 'arrayBuffer':
+        case 'arraybuffer':
+          context.returnValue = await response.arrayBuffer();
+          break;
+      }
+    }
+  }
+
+  getAuthToken(): string {
+    const { token } = this.config;
+    return typeof token === 'function' ? (token() ?? '') : (token ?? '');
+  }
+}

package/templates/fe-react/lib/tw-root10px/index.css

@@ -0,0 +1,4 @@
+:root,
+html {
+  font-size: 10px;
+}

package/templates/fe-react/lib/tw-root10px/index.js

@@ -0,0 +1,178 @@
+import plugin from 'tailwindcss/plugin';
+
+/**
+ * Tailwind CSS 配置 - 10px 根字体大小
+ *
+ * 注意事项：
+ * 1. 所有的 rem 值都基于 10px 计算
+ * 2. 16px = 1.6rem
+ * 3. spacing 中的值需要乘以 1.6 来保持与原来的单位一致
+ *
+ * 由于移动端开发需求，方便计算，重置像素 10px, 将默认 16px 变成 10px
+ *
+ * 但是 tailwind 中的单位间距都是有个 rem 做单位， 16px 变成 10px 基数改变, 需要在原来不变像素上用 10px 基数重写一遍
+ *
+ * @see https://redpixelthemes.com/blog/change-tailwindcss-base-font-size/
+ * @type {import('tailwindcss').Config['theme']}
+ *
+ * @example
+ * // 使用示例
+ * text-base -> 1.6rem -> 16px
+ * p-4 -> 1.6rem -> 16px
+ * w-40 -> 16rem -> 160px
+ */
+const root10pxThemes = {
+  lineHeight: {
+    3: '1.2rem',
+    4: '1.6rem',
+    5: '2.0rem',
+    6: '2.4rem',
+    7: '2.8rem',
+    8: '3.2rem',
+    9: '3.6rem',
+    10: '4.0rem',
+    none: 1,
+    tight: 1.25,
+    snug: 1.375,
+    normal: 1.5,
+    relaxed: 1.625,
+    loose: 2
+  },
+  maxWidth: {
+    xs: '32.0rem',
+    sm: '38.4rem',
+    md: '44.8rem',
+    lg: '51.2rem',
+    xl: '57.6rem',
+    '2xl': '67.2rem',
+    '3xl': '76.8rem',
+    '4xl': '89.6rem',
+    '5xl': '102.4rem',
+    '6xl': '115.2rem',
+    '7xl': '128.0rem'
+  },
+
+  //
+  // 为了兼容之前的写法，在10的倍数上以 16px 作为基准单位计算
+  // 默认是以 4的倍数作为基数计算间距，但是由于 html font-size 变为了 10px
+  // 现在版本从之前的16px -> 10px 整体缩小，所以，这里需要手动将间距放大，去适应以前的环境
+  // TODO： 后期将所有间距调整为基准值， 不使用放大值
+
+  /**
+   * 因为之前版本 root size 为默认 16px,  tailwind 默认就以 16px 为基准设置 spacing
+   *
+   * 而现在版本 root size 为 10px, 为了兼容以前代码, 将所有 spacing 重写
+   *
+   * @see https://tailwindcss.com/docs/customizing-spacing#default-spacing-scale
+   *
+   * 例如：
+   *   以前版本 1 -> 4px -> 0.25rem， 而现在 1 -> 4px -> 0.1rem
+   *   以前版本 4 -> 16px -> 1rem 而现在 4 -> 16px -> 1.6rem
+   *
+   * 注意只是 spaceing 使用这规则，也就是将默认的 px 间距用 10 重新换算一遍，间距并未改变
+   */
+  spacing: {
+    0.5: '0.2rem',
+    1: '0.4rem',
+    1.5: '0.6rem',
+    2: '0.8rem',
+    2.5: '1rem',
+    3: '1.2rem',
+    3.5: '1.4rem',
+    4: '1.6rem',
+    5: '2rem',
+    6: '2.4rem',
+    7: '2.8rem',
+    8: '3.2rem',
+    9: '3.6rem',
+    10: '4rem',
+    11: '4.4rem',
+    12: '4.8rem',
+    14: '5.6rem',
+    16: '6.4rem',
+    20: '8rem',
+    24: '9.6rem',
+    28: '11.2rem',
+    32: '12.8rem',
+    36: '14.4rem',
+    40: '16rem',
+    44: '17.6rem',
+    48: '19.2rem',
+    52: '20.8rem',
+    56: '22.4rem',
+    60: '24rem',
+    64: '25.6rem',
+    72: '28.8rem',
+    80: '32rem',
+    96: '38.4rem'
+  },
+
+  /**
+   * 字体对应 font-size 和 line-height
+   *
+   * @see https://tailwindcss.com/docs/font-size
+   */
+  fontSize: {
+    xxs: ['2rem', '1.2rem'],
+    xs: ['1.2rem', '1.6rem'],
+    sm: ['1.4rem', '2rem'],
+    base: ['1.6rem', '2.4rem'],
+    lg: ['1.8rem', '2.8rem'],
+    xl: ['2rem', '2.8rem'],
+    '2xl': ['2.4rem', '3.2rem'],
+    '3xl': ['3rem', '3.6rem'],
+    '4xl': ['3.6rem', '4rem'],
+    '5xl': ['4.8rem', 1],
+    '6xl': ['6rem', 1],
+    '7xl': ['7.2rem', 1],
+    '8xl': ['9.6rem', 1],
+    '9xl': ['12.8rem', 1],
+    12: ['1.2rem'],
+    14: ['1.4rem'],
+    16: ['1.6rem'],
+    18: ['1.8rem'],
+    20: ['2rem'],
+    22: ['2.2rem'],
+    24: ['2.4rem'],
+    26: ['2.6rem'],
+    32: ['3.2rem'],
+    34: ['3.4rem'],
+    36: ['3.6rem'],
+    40: ['4rem'],
+    46: ['4.6rem'],
+    50: ['5rem'],
+    54: ['5.4rem'],
+    60: ['6rem'],
+    70: ['7rem'],
+    80: ['8rem'],
+    90: ['9rem'],
+    100: ['10rem']
+  },
+
+  screens: {
+    /** @media (min-width: 375px) { ... } */
+    xs: '375px',
+    /** @media (min-width: 640px) { ... } */
+    sm: '640px',
+    /** @media (min-width: 768px) { ... } */
+    md: '768px',
+    /** @media (min-width: 1024px) { ... } */
+    lg: '1024px',
+    /** @media (min-width: 1280px) { ... } */
+    xl: '1280px',
+    /** @media (min-width: 1536px) { ... } */
+    '2xl': '1536px',
+    /** @media (min-width: 1640px) { ... } */
+    '3xl': '1640px',
+    /** @media (min-width: 1920px) { ... } */
+    maxxl: '1920px'
+  }
+};
+
+const root10pxPlugin = plugin(({ addBase }) => {
+  addBase({
+    html: { fontSize: '10px' }
+  });
+});
+
+export default { themes: root10pxThemes, plugin: root10pxPlugin };

package/templates/fe-react/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "fe-react",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "tsc -b && vite build",
+    "lint": "eslint .",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@qlover/fe-utils": "^1.0.19",
+    "@qlover/slice-store-react": "^1.0.8",
+    "i18next": "^24.2.0",
+    "i18next-browser-languagedetector": "^8.0.2",
+    "i18next-http-backend": "^3.0.1",
+    "lodash": "^4.17.21",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "react-i18next": "^15.2.0",
+    "react-router-dom": "6"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.11.1",
+    "@qlover/eslint-plugin-fe-dev": "^0.2.0",
+    "@qlover/fe-scripts": "latest",
+    "@rollup/plugin-alias": "^5.1.1",
+    "@types/lodash": "^4.17.13",
+    "@types/react": "^18.3.11",
+    "@types/react-dom": "^18.3.0",
+    "@types/react-syntax-highlighter": "^15.5.13",
+    "@types/typo-js": "^1.2.2",
+    "@vitejs/plugin-react": "^4.3.2",
+    "@vitejs/plugin-react-swc": "^3.5.0",
+    "autoprefixer": "^10.4.20",
+    "eslint": "^9.15.0",
+    "eslint-plugin-react-hooks": "^5.0.0",
+    "eslint-plugin-react-refresh": "^0.4.14",
+    "globals": "^15.12.0",
+    "postcss": "^8.4.49",
+    "sass-embedded": "^1.79.4",
+    "tailwindcss": "^3.4.16",
+    "typescript": "^5.6.3",
+    "typescript-eslint": "^8.15.0",
+    "vite": "^5.4.8",
+    "vite-plugin-cross-origin-isolation": "^0.1.6"
+  }
+}

package/templates/fe-react/postcss.config.js

@@ -0,0 +1,6 @@
+export default {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+}

package/templates/fe-react/public/locales/en/about.json

@@ -0,0 +1,3 @@
+{
+  "title": "About"
+}

package/templates/fe-react/public/locales/en/common.json

@@ -0,0 +1,6 @@
+{
+  "404.notComponent": "Component not found",
+  "404.notPage": "Page not found",
+  "500.title": "Server Error",
+  "header.theme.label": "Switch Theme"
+}

package/templates/fe-react/public/locales/en/executor.json

@@ -0,0 +1,6 @@
+{
+  "executorDemo": "Executor Demo",
+  "requestTimeout": "Request Timeout",
+  "executorTestPlugin": "Executor Test Plugin",
+  "testPlugin": "Test Plugin"
+}

package/templates/fe-react/public/locales/en/home.json

@@ -0,0 +1,10 @@
+{
+  "welcome": "Welcome to the home page",
+  "description": "A modern frontend utility library collection providing various practical tools and components",
+  "about": "About Us",
+  "about_description": "Learn more about our project and team information",
+  "jsonstorage": "JSONStorage",
+  "jsonstorage_description": "Efficient JSON data storage solution",
+  "request": "Request",
+  "request_description": "A modern frontend utility library collection providing various practical tools and components"
+}

package/templates/fe-react/public/locales/en/jsonStorage.json

@@ -0,0 +1,11 @@
+{
+  "title": "JSONStorage Demo",
+  "title2": "Permanent storage test",
+  "title3": "Expire time test",
+  "title4": "Request Timeout",
+  "format.title": "Test key: ${key}, Random value range: ${min}~${max}",
+  "setRandomValue": "Set random value",
+  "currentValue": "Current value",
+  "ms": "ms",
+  "setExpireTime": "Set random value(with expire time)"
+}

package/templates/fe-react/public/locales/en/login.json

@@ -0,0 +1,7 @@
+{
+  "title": "Login",
+  "email": "Email",
+  "username": "Username",
+  "password": "Password",
+  "login": "Login"
+}

package/templates/fe-react/public/locales/en/request.json

@@ -0,0 +1,15 @@
+{
+  "requestTimeout": "Request Timeout",
+  "helloResult": "Hello result is",
+  "helloError": "Hello error is",
+  "ipInfoResult": "IpInfo result is",
+  "ipInfo": "IpInfo",
+  "randomUser": "RandomUser",
+  "loading": "Loading...",
+  "randomUserResult": "RandomUser result is",
+  "randomUserError": "RandomUser error is",
+  "triggerAbortRequest": "Trigger Abort Request",
+  "stopAbortRequest": "Stop Abort Request",
+  "abortRequestResult": "Abort Request Result",
+  "abortRequestError": "Abort Request Error"
+}

package/templates/fe-react/public/locales/zh/about.json

@@ -0,0 +1,3 @@
+{
+  "title": "关于我们"
+}

package/templates/fe-react/public/locales/zh/common.json

@@ -0,0 +1,7 @@
+{
+  "404.notComponent": "组件不存在",
+  "404.notPage": "页面不存在",
+  "500.title": "服务器错误",
+  "header.theme.label": "切换主题"
+}
+

package/templates/fe-react/public/locales/zh/executor.json

@@ -0,0 +1,7 @@
+{
+  "executorDemo": "执行器 Demo",
+  "requestTimeout": "请求超时",
+  "executorTestPlugin": "执行器 测试插件",
+  "testPlugin": "测试插件"
+}
+

package/templates/fe-react/public/locales/zh/home.json

@@ -0,0 +1,10 @@
+{
+  "welcome": "欢迎来到主页",
+  "description": "一个现代前端实用库集合，提供各种实用工具和组件",
+  "about": "关于我们",
+  "about_description": "了解更多关于我们的项目和团队信息",
+  "jsonstorage": "JSON存储",
+  "jsonstorage_description": "高效的JSON数据存储解决方案",
+  "request": "请求",
+  "request_description": "一个现代前端实用库集合，提供各种实用工具和组件"
+}

package/templates/fe-react/public/locales/zh/jsonStorage.json

@@ -0,0 +1,11 @@
+{
+  "title": "JSONStorage Demo",
+  "title2": "永久存储测试",
+  "title3": "过期时间测试",
+  "title4": "请求超时时间设置",
+  "format.title": "测试 key: ${key}, 随机值范围: ${min}~${max}",
+  "setRandomValue": "设置随机值",
+  "currentValue": "当前值",
+  "ms": "毫秒",
+  "setExpireTime": "设置随机值(带过期时间)"
+}

package/templates/fe-react/public/locales/zh/login.json

@@ -0,0 +1,8 @@
+{
+  "title": "登录",
+  "email": "邮箱",
+  "username": "用户名",
+  "password": "密码",
+  "login": "登录"
+}
+

package/templates/fe-react/public/locales/zh/request.json

@@ -0,0 +1,15 @@
+{
+  "requestTimeout": "请求超时",
+  "helloResult": "Hello 结果是",
+  "helloError": "Hello 错误是",
+  "ipInfoResult": "IpInfo 结果是",
+  "ipInfo": "IpInfo",
+  "randomUser": "随机用户",
+  "loading": "加载中...",
+  "randomUserResult": "随机用户 结果是",
+  "randomUserError": "随机用户 错误是",
+  "triggerAbortRequest": "触发中止请求",
+  "stopAbortRequest": "停止中止请求",
+  "abortRequestResult": "中止请求 结果是",
+  "abortRequestError": "中止请求 错误是"
+}

package/templates/fe-react/public/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path><text x="50" y="50" font-family="Arial" font-size="24" fill="black">fe</text></svg>

package/templates/fe-react/src/App.tsx

@@ -0,0 +1,20 @@
+import './styles/css/index.css';
+import { createBrowserRouter, RouterProvider } from 'react-router-dom';
+import { createFeReactRoutes } from './pages';
+import { I18nService } from '@/services/i18n';
+import { useMemo } from 'react';
+import { routerController } from './containers';
+
+I18nService.init();
+
+function App() {
+  const routerBase = useMemo(() => {
+    const routes = createFeReactRoutes(routerController.getRoutes());
+    const router = createBrowserRouter(routes);
+    return router;
+  }, []);
+
+  return <RouterProvider router={routerBase} />;
+}
+
+export default App;

package/templates/fe-react/src/assets/react.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

package/templates/fe-react/src/components/Loading.tsx

@@ -0,0 +1,41 @@
+/**
+ * Loading component
+ *
+ * @description This component displays a loading indicator. It can be used to indicate loading states either in fullscreen mode or within a specific section of the page.
+ *
+ * @param {boolean} fullscreen - Determines if the loading indicator should cover the entire screen. Defaults to false.
+ *
+ * @returns {JSX.Element} A div element displaying a loading icon.
+ *
+ * @example
+ * <Loading fullscreen={true} />
+ * <Loading fullscreen={false} />
+ */
+export function Loading({ fullscreen = false }: { fullscreen?: boolean }) {
+  return (
+    <div
+      className={`flex justify-center items-center ${fullscreen ? 'fixed inset-0 bg-white bg-opacity-80 z-50' : 'relative'}`}
+    >
+      <svg
+        className="animate-spin h-8 w-8 text-gray-500"
+        xmlns="http://www.w3.org/2000/svg"
+        fill="none"
+        viewBox="0 0 24 24"
+      >
+        <circle
+          className="opacity-25"
+          cx="12"
+          cy="12"
+          r="10"
+          stroke="currentColor"
+          strokeWidth="4"
+        ></circle>
+        <path
+          className="opacity-75"
+          fill="currentColor"
+          d="M4 12a8 8 0 018-8v4a4 4 0 00-4 4H4z"
+        ></path>
+      </svg>
+    </div>
+  );
+}

package/templates/fe-react/src/components/LocaleLink.tsx

@@ -0,0 +1,42 @@
+import { LinkProps, Link as RouterLink, To, useParams } from 'react-router-dom';
+import { ReactNode } from 'react';
+
+interface LocaleLinkProps extends Omit<LinkProps, 'href' | 'to'> {
+  href: string | To;
+  locale?: string;
+  children: ReactNode;
+  defaultLocale?: string;
+  className?: string;
+}
+
+const LocaleLink: React.FC<LocaleLinkProps> = ({
+  href,
+  locale,
+  children,
+  defaultLocale,
+  ...props
+}) => {
+  const { lng } = useParams<{ lng: string }>();
+
+  locale = locale || lng;
+
+  const isDefaultLocale = locale === defaultLocale;
+
+  let localizedHref: string | To;
+  if (typeof href === 'string') {
+    localizedHref = isDefaultLocale ? href : `/${locale}${href}`;
+  } else {
+    localizedHref = {
+      ...href,
+      pathname: isDefaultLocale ? href.pathname : `/${locale}${href.pathname}`
+    };
+  }
+
+  return (
+    <RouterLink {...props} to={localizedHref}>
+      {children}
+    </RouterLink>
+  );
+};
+
+export default LocaleLink;