docs: 更新文档

deploy.sh

@@ -0,0 +1,40 @@
+#!/bin/bash  
+
+# 确保脚本抛出遇到的错误
+set -e
+
+rm -rf dist
+# 编译代码
+npm run build
+
+# 文心一言提供的脚本
+src_base="examples"  
+target_base="dist"
+
+for src_dir in "$src_base"/ssr-*/dist/client "$src_base"/docs/dist/client; do  
+  if [ -d "$src_dir" ]; then  
+    if [ "$src_dir" = "$src_base/docs/dist/client" ]; then  
+      target_dir="$target_base"  
+    else  
+      ssr_part="${src_dir#$src_base/}"  
+      ssr_part="${ssr_part%/dist/client}"
+      target_dir="$target_base/$ssr_part"  
+    fi  
+    mkdir -p "$target_dir"  
+    cp -r "$src_dir"/* "$target_dir"  
+    echo "Copied $src_dir/* to $target_dir"  
+  fi  
+done
+
+cd dist
+# 如果是发布到自定义域名
+# echo 'www.example.com' > CNAME
+
+git init
+git add -A
+git commit -m 'deploy'
+
+# 如果发布到 https://dp-os.github.io/gez/
+git push -f [email protected]:dp-os/gez.git master:docs
+
+cd -

docs/package.json → examples/docs/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "rspress-doc-template",
+  "name": "docs",
   "version": "1.0.0",
   "private": true,
   "scripts": {

docs/rspress.config.ts → examples/docs/rspress.config.ts

@@ -2,8 +2,9 @@ import * as path from 'node:path';
 import { defineConfig } from 'rspress/config';
 
 export default defineConfig({
-    root: path.join(__dirname, 'docs'),
-    globalStyles: path.join(__dirname, 'styles/index.css'),
+    root: path.join(__dirname, 'src'),
+    outDir: path.join(__dirname, 'dist/client'),
+    globalStyles: path.join(__dirname, 'src/styles/index.css'),
     title: 'Gez',
     description:
         'Gez 是一个基于 Rspack 构建的模块链接（Module Link） 解决方案，通过 importmap 将多服务的模块映射到具有强缓存，基于内容哈希的 URL 中。',

docs/docs/guide/essentials/command.mdx → examples/docs/src/guide/essentials/command.mdx

@@ -2,16 +2,16 @@
 一个典型的命令配置。
 ```json
 {
-  "scripts": {
-    "dev": "gez dev",
-    "build": "npm run build && npm run build:dts && npm run release",
-    "build:ssr": "gez build",
-    "build:dts": "vue-tsc --declaration --emitDeclarationOnly --noEmit false --outDir dist/server/src",
-    "release": "gez release",
-    "preview": "gez preview",
-    "start": "gez start",
-    "postinstall": "gez install"
-  }
+    "scripts": {
+        "dev": "gez dev",
+        "build": "npm run build:ssr && npm run build:dts && npm run release",
+        "build:ssr": "gez build",
+        "build:dts": "vue-tsc --declaration --emitDeclarationOnly --noEmit false --outDir dist/server/src",
+        "release": "gez release",
+        "preview": "gez preview",
+        "start": "gez start",
+        "postinstall": "gez install"
+    }
 }
 ```
 

examples/ssr-html/package.json

@@ -1,13 +1,16 @@
 {
-  "name": "ssr-simple",
+  "name": "ssr-html",
   "version": "0.0.15-alpha.89",
   "main": "index.js",
   "type": "module",
   "scripts": {
     "dev": "gez dev",
-    "build": "gez build",
-    "start": "gez start",
+    "build": "npm run build:ssr && npm run build:dts && npm run release",
+    "build:ssr": "gez build",
+    "build:dts": "tsc --noEmit --outDir dist/server/src",
+    "release": "gez release",
     "preview": "gez preview",
+    "start": "gez start",
     "postinstall": "gez install"
   },
   "author": "",
@@ -17,6 +20,8 @@
     "@gez/core": "workspace:0.0.15-alpha.89"
   },
   "devDependencies": {
+    "@types/node": "22.8.6",
+    "typescript": "^5.2.2",
     "@gez/rspack": "workspace:0.0.15-alpha.89"
   }
-}
+}

examples/ssr-html/src/entry.client.ts

@@ -1,4 +1,6 @@
 const time = document.querySelector('time');
 setInterval(() => {
-    time?.setHTMLUnsafe(new Date().toISOString());
+    if (time) {
+        time.innerText = new Date().toISOString();
+    }
 }, 1000);

examples/ssr-html/tsconfig.json

@@ -0,0 +1,60 @@
+{
+    "compilerOptions": {
+        "isolatedModules": true,
+        "allowJs": false,
+        "experimentalDecorators": true,
+        "resolveJsonModule": true,
+        "types": [
+            "@types/node"
+        ],
+        "target": "ESNext",
+        "module": "ESNext",
+        "importHelpers": false,
+        "declaration": true,
+        "sourceMap": true,
+        "strict": true,
+        "noImplicitAny": false,
+        "noImplicitReturns": false,
+        "noFallthroughCasesInSwitch": true,
+        "noUnusedLocals": false,
+        "noUnusedParameters": false,
+        "moduleResolution": "node",
+        "allowImportingTsExtensions": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "allowSyntheticDefaultImports": true,
+        "forceConsistentCasingInFileNames": true,
+        "noEmit": true,
+        "paths": {
+            "ssr-rspack-vue2/src/*": [
+                "./src/*"
+            ],
+            "ssr-rspack-vue2/*": [
+                "./*"
+            ]
+        }
+    },
+    "include": [
+        "micro",
+        "service",
+        "server",
+        "test",
+        "src",
+        "bin",
+        "**.cjs",
+        "**.js",
+        "**.mjs",
+        "**.ts",
+        "private",
+        "public"
+    ],
+    "exclude": [
+        "dist"
+    ],
+    "vueCompilerOptions": {
+        "extensions": [
+            ".vue"
+        ],
+        "target": 2.7
+    }
+}

examples/ssr-vue2-host/package.json

@@ -5,8 +5,11 @@
     "type": "module",
     "scripts": {
         "dev": "gez dev",
-        "build": "gez build",
-        "build:dts": "vue-tsc --declaration --emitDeclarationOnly --noEmit false --outDir types",
+        "build": "npm run build:ssr && npm run build:dts && npm run release",
+        "build:ssr": "gez build",
+        "build:dts": "vue-tsc --declaration --emitDeclarationOnly --noEmit false --outDir dist/server/src",
+        "release": "gez release",
+        "preview": "gez preview",
         "start": "gez start",
         "postinstall": "gez install"
     },

examples/ssr-vue2-remote/package.json

@@ -5,11 +5,13 @@
     "type": "module",
     "scripts": {
         "dev": "gez dev",
-        "build": "gez build",
-        "build:release": "gez release",
+        "build": "npm run build:ssr && npm run build:dts && npm run release",
+        "build:ssr": "gez build",
         "build:dts": "vue-tsc --declaration --emitDeclarationOnly --noEmit false --outDir dist/server/src",
-        "build:all": "gez build && npm run build:dts && gez release",
-        "start": "gez start"
+        "release": "gez release",
+        "preview": "gez preview",
+        "start": "gez start",
+        "postinstall": "gez install"
     },
     "dependencies": {
         "@gez/core": "workspace:^",

examples/ssr-vue3/package.json

@@ -5,9 +5,13 @@
     "type": "module",
     "scripts": {
         "dev": "gez dev",
-        "build": "gez build",
-        "build:dts": "vue-tsc --declaration --emitDeclarationOnly --noEmit false --outDir types",
-        "start": "gez start"
+        "build": "npm run build:ssr && npm run build:dts && npm run release",
+        "build:ssr": "gez build",
+        "build:dts": "vue-tsc --declaration --emitDeclarationOnly --noEmit false --outDir dist/server/src",
+        "release": "gez release",
+        "preview": "gez preview",
+        "start": "gez start",
+        "postinstall": "gez install"
     },
     "dependencies": {
         "@gez/core": "workspace:^",

package.json

@@ -9,6 +9,7 @@
         "lint:css": "lerna run lint:css",
         "lint:type": "lerna run lint:type",
         "test": "lerna run test",
+        "build": "lerna run build",
         "build:packages": "lerna run build --no-private",
         "release": "npm run build:packages && lerna publish --force-publish --exact"
     },