docs: 基础路径配置

Author: cloudcome

docs/src/dts/env.d.ts

@@ -0,0 +1,14 @@
+namespace NodeJS {
+  interface ProcessEnv {
+    /**
+     * @see https://nodejs.org/api/process.html#processenv
+     */
+    NODE_ENV: 'development' | 'production' | 'test';
+
+    /**
+     * vite 应用基础路径
+     * Github deploy action
+     */
+    VITE_APP_BASENAME?: string;
+  }
+}

docs/src/dts/globals.d.ts

@@ -0,0 +1,15 @@
+declare global {
+  /**
+   * package name
+   * defined in vite.config.mts
+   */
+  export const PKG_NAME: string;
+
+  /**
+   * package version
+   * defined in vite.config.mts
+   */
+  export const PKG_VERSION: string;
+}
+
+export {};

docs/src/dts/process.env.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="vite/client" />
+
+interface ImportMetaEnv {
+  // readonly VITE_APP_TITLE: string;
+}
+
+interface ImportMeta {
+  readonly env: ImportMetaEnv;
+}

docs/src/dts/vite.d.ts

@@ -6,11 +6,9 @@ import 'virtual:uno.css';
 import 'virtual:svg-icons-register';
 import App from './App';
 
-const basename = process.env.VITE_APP_BASENAME || '/';
-
 ReactDOM.createRoot(document.getElementById('root')!).render(
   <StrictMode>
-    <HashRouter basename={basename}>
+    <HashRouter basename={import.meta.env.BASE_URL}>
       <App />
     </HashRouter>
   </StrictMode>,

docs/src/main.tsx

@@ -6,7 +6,7 @@
     "module": "ESNext",
     "moduleResolution": "Node",
     "resolveJsonModule": true,
-    "types": ["vite/client"],
+    "types": [],
     "allowImportingTsExtensions": true,
     "allowJs": true,
     "strict": true,

docs/tsconfig.json

@@ -11,52 +11,54 @@ import uno from 'unocss/vite';
 import { defineConfig } from 'vite';
 import { createSvgIconsPlugin } from 'vite-plugin-svg-icons';
 import { ViteMinifyPlugin } from 'vite-plugin-minify';
-import { reactPages } from '../src';
+import { reactPages } from 'unplugin-react-pages';
 import pkg from './package.json';
 
-export default defineConfig({
-  base: process.env.VITE_APP_BASENAME || '/',
-  server: {
-    port: 15170,
-  },
-  define: {
-    'process.env.PKG_NAME': JSON.stringify(pkg.name),
-    'process.env.PKG_VERSION': JSON.stringify(pkg.version),
-  },
-  plugins: [
-    // plugins
-    react(),
-    mdx({
-      rehypePlugins: [
-        //
-        [
-          rehypeHighlight,
-          {
-            detect: true,
-          } as Parameters<typeof rehypeHighlight>[0],
+export default defineConfig((config) => {
+  return {
+    base: process.env.VITE_APP_BASENAME || '/',
+    server: {
+      port: 15170,
+    },
+    define: {
+      PKG_NAME: JSON.stringify(config.mode === 'test' ? 'pkg-name-for-test' : pkg.name),
+      PKG_VERSION: JSON.stringify(config.mode === 'test' ? 'pkg-version-for-test' : pkg.version),
+    },
+    plugins: [
+      // plugins
+      react(),
+      mdx({
+        rehypePlugins: [
+          //
+          [
+            rehypeHighlight,
+            {
+              detect: true,
+            } as Parameters<typeof rehypeHighlight>[0],
+          ],
         ],
-      ],
-    }),
-    uno(),
-    createSvgIconsPlugin({
-      iconDirs: [path.resolve('src/icons')],
-      symbolId: 'icon-[dir]/[name]',
-    }),
-    ViteMinifyPlugin({
-      minifyCSS: true,
-      minifyJS: true,
-      minifyURLs: true,
-      removeComments: true,
-      collapseWhitespace: true,
-      removeScriptTypeAttributes: true,
-      removeStyleLinkTypeAttributes: true,
-    }),
-    reactPages.vite({
-      debug: true,
-      logLevel: 'info',
-      fileNames: {
-        page: ['page.mdx', 'page.tsx'],
-      },
-    }),
-  ],
+      }),
+      uno(),
+      createSvgIconsPlugin({
+        iconDirs: [path.resolve('src/icons')],
+        symbolId: 'icon-[dir]/[name]',
+      }),
+      ViteMinifyPlugin({
+        minifyCSS: true,
+        minifyJS: true,
+        minifyURLs: true,
+        removeComments: true,
+        collapseWhitespace: true,
+        removeScriptTypeAttributes: true,
+        removeStyleLinkTypeAttributes: true,
+      }),
+      reactPages.vite({
+        debug: true,
+        logLevel: 'info',
+        fileNames: {
+          page: ['page.mdx', 'page.tsx'],
+        },
+      }),
+    ],
+  };
 });