@ybais/create-ybais-app 0.2.0

package/template/pnpm-workspace.yaml

@@ -0,0 +1,7 @@
+# 单包应用也可使用此文件声明 pnpm 策略（非 monorepo packages 列表）
+allowBuilds:
+  core-js: true
+
+minimumReleaseAgeExclude:
+  - "@vitejs/plugin-legacy@8.2.2"
+  - sonner@2.0.8

package/template/postcss.config.js

@@ -0,0 +1,24 @@
+export default {
+  plugins: {
+    // 0. Tailwind CSS 必须置于顶部优先编译
+    tailwindcss: {},
+    // 1. 自动添加浏览器前缀（iOS 12 强烈依赖 -webkit- 前缀）
+    autoprefixer: {
+      overrideBrowserslist: [
+        "iOS >= 12",
+        "Android >= 7",
+        "Chrome >= 55",
+        "Safari >= 12",
+      ],
+    },
+    // 2. 将 px 自动按比例转换为 vw 实现移动端自适应
+    "postcss-px-to-viewport-8-plugin": {
+      viewportWidth: 375, // 设计稿宽度（以 375px 移动端逻辑像素为基准）
+      unitPrecision: 5, // 保留 5 位小数
+      viewportUnit: "vw", // 转换目标单位
+      selectorBlackList: [".ignore", ".hairlines"], // 忽略转换的 CSS 类名
+      minPixelValue: 1, // 小于等于 1px 不做转换
+      mediaQuery: false, // 是否在 @media 查询中转换
+    },
+  },
+};

package/template/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="48" height="46" fill="none" viewBox="0 0 48 46"><path fill="#863bff" d="M25.946 44.938c-.664.845-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.287c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.497 0-3.578-1.842-3.578H1.237c-.92 0-1.456-1.04-.92-1.788L10.013.474c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.579 1.842 3.579h11.377c.943 0 1.473 1.088.89 1.83L25.947 44.94z" style="fill:#863bff;fill:color(display-p3 .5252 .23 1);fill-opacity:1"/><mask id="a" width="48" height="46" x="0" y="0" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#000" d="M25.842 44.938c-.664.844-2.021.375-2.021-.698V33.937a2.26 2.26 0 0 0-2.262-2.262H10.183c-.92 0-1.456-1.04-.92-1.788l7.48-10.471c1.07-1.498 0-3.579-1.842-3.579H1.133c-.92 0-1.456-1.04-.92-1.787L9.91.473c.214-.297.556-.474.92-.474h28.894c.92 0 1.456 1.04.92 1.788l-7.48 10.471c-1.07 1.498 0 3.578 1.842 3.578h11.377c.943 0 1.473 1.088.89 1.832L25.843 44.94z" style="fill:#000;fill-opacity:1"/></mask><g mask="url(#a)"><g filter="url(#b)"><ellipse cx="5.508" cy="14.704" fill="#ede6ff" rx="5.508" ry="14.704" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -4.47 31.516)"/></g><g filter="url(#c)"><ellipse cx="10.399" cy="29.851" fill="#ede6ff" rx="10.399" ry="29.851" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -39.328 7.883)"/></g><g filter="url(#d)"><ellipse cx="5.508" cy="30.487" fill="#7e14ff" rx="5.508" ry="30.487" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -25.913 -14.639)scale(1 -1)"/></g><g filter="url(#e)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.814 -32.644 -3.334)scale(1 -1)"/></g><g filter="url(#f)"><ellipse cx="5.508" cy="30.599" fill="#7e14ff" rx="5.508" ry="30.599" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="matrix(.00324 1 1 -.00324 -34.34 30.47)"/></g><g filter="url(#g)"><ellipse cx="14.072" cy="22.078" fill="#ede6ff" rx="14.072" ry="22.078" style="fill:#ede6ff;fill:color(display-p3 .9275 .9033 1);fill-opacity:1" transform="rotate(93.35 24.506 48.493)scale(-1 1)"/></g><g filter="url(#h)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#i)"><ellipse cx="3.47" cy="21.501" fill="#7e14ff" rx="3.47" ry="21.501" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(89.009 28.708 47.59)scale(-1 1)"/></g><g filter="url(#j)"><ellipse cx=".387" cy="8.972" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(39.51 .387 8.972)"/></g><g filter="url(#k)"><ellipse cx="47.523" cy="-6.092" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 47.523 -6.092)"/></g><g filter="url(#l)"><ellipse cx="41.412" cy="6.333" fill="#47bfff" rx="5.971" ry="9.665" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 41.412 6.333)"/></g><g filter="url(#m)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#n)"><ellipse cx="-1.879" cy="38.332" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 -1.88 38.332)"/></g><g filter="url(#o)"><ellipse cx="35.651" cy="29.907" fill="#7e14ff" rx="4.407" ry="29.108" style="fill:#7e14ff;fill:color(display-p3 .4922 .0767 1);fill-opacity:1" transform="rotate(37.892 35.651 29.907)"/></g><g filter="url(#p)"><ellipse cx="38.418" cy="32.4" fill="#47bfff" rx="5.971" ry="15.297" style="fill:#47bfff;fill:color(display-p3 .2799 .748 1);fill-opacity:1" transform="rotate(37.892 38.418 32.4)"/></g></g><defs><filter id="b" width="60.045" height="41.654" x="-19.77" y="16.149" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="c" width="90.34" height="51.437" x="-54.613" y="-7.533" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="d" width="79.355" height="29.4" x="-49.64" y="2.03" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="e" width="79.579" height="29.4" x="-45.045" y="20.029" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="f" width="79.579" height="29.4" x="-43.513" y="21.178" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="g" width="74.749" height="58.852" x="15.756" y="-17.901" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="7.659"/></filter><filter id="h" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="i" width="61.377" height="25.362" x="23.548" y="2.284" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="j" width="56.045" height="63.649" x="-27.636" y="-22.853" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="k" width="54.814" height="64.646" x="20.116" y="-38.415" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="l" width="33.541" height="35.313" x="24.641" y="-11.323" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="m" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="n" width="54.814" height="64.646" x="-29.286" y="6.009" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="o" width="54.814" height="64.646" x="8.244" y="-2.416" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter><filter id="p" width="39.409" height="43.623" x="18.713" y="10.588" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_2002_17158" stdDeviation="4.596"/></filter></defs></svg>

package/template/scripts/run-build.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { runMise } from "./with-mise.mjs";
+
+// 自动 trust 本项目配置后执行 mise 构建任务（用户无需改 mise.toml / 手动 trust）
+runMise(["run", "build"]);

package/template/scripts/setup-mise.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+/**
+ * pnpm install 后轻量准备：若已安装 mise，则自动 trust + 安装工具链。
+ * 未安装 mise 时静默跳过（开发可用系统 Node；构建时会给出友好提示）。
+ */
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+function findMise() {
+  const fromPath = spawnSync("mise", ["--version"], {
+    encoding: "utf8",
+    shell: process.platform === "win32",
+  });
+  if (fromPath.status === 0) return "mise";
+
+  for (const candidate of [
+    "/opt/homebrew/bin/mise",
+    "/usr/local/bin/mise",
+    path.join(process.env.HOME ?? "", ".local/bin/mise"),
+  ]) {
+    if (candidate && fs.existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+
+const mise = findMise();
+if (!mise) {
+  process.exit(0);
+}
+
+spawnSync(mise, ["trust", root], {
+  cwd: root,
+  stdio: "ignore",
+  shell: process.platform === "win32",
+});
+
+spawnSync(mise, ["install"], {
+  cwd: root,
+  stdio: "inherit",
+  shell: process.platform === "win32",
+});
+
+process.exit(0);

package/template/scripts/with-mise.mjs

@@ -0,0 +1,107 @@
+#!/usr/bin/env node
+/**
+ * 无感调用 mise：自动信任本项目 mise.toml，再执行给定子命令。
+ * 用户日常只需跑 pnpm scripts，无需手动 mise trust / 改配置。
+ */
+import { spawnSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const root = path.resolve(path.dirname(__filename), "..");
+
+function findMise() {
+  const fromPath = spawnSync("mise", ["--version"], {
+    encoding: "utf8",
+    shell: process.platform === "win32",
+  });
+  if (fromPath.status === 0) {
+    return "mise";
+  }
+
+  const candidates = [
+    "/opt/homebrew/bin/mise",
+    "/usr/local/bin/mise",
+    path.join(process.env.HOME ?? "", ".local/bin/mise"),
+  ];
+  for (const candidate of candidates) {
+    if (candidate && fs.existsSync(candidate)) {
+      return candidate;
+    }
+  }
+  return null;
+}
+
+export function printMiseMissing() {
+  console.error(`
+[ybais] 未检测到 mise，但本项目的 \`pnpm build\` 依赖它（按 Git 分支选择 test/prod）。
+
+请安装后重试（安装后无需改任何 mise 配置，直接 pnpm build 即可）：
+
+  curl https://mise.run | sh
+
+或 macOS：
+
+  brew install mise
+
+安装后重新打开终端，再执行：
+
+  pnpm build
+`);
+}
+
+/**
+ * @param {string[]} miseArgs mise 子命令参数，如 ["run", "build"]
+ * @param {{ installTools?: boolean }} [opts]
+ */
+export function runMise(miseArgs, opts = {}) {
+  const mise = findMise();
+  if (!mise) {
+    printMiseMissing();
+    process.exit(1);
+  }
+
+  spawnSync(mise, ["trust", root], {
+    cwd: root,
+    stdio: "ignore",
+    shell: process.platform === "win32",
+  });
+
+  if (opts.installTools) {
+    const install = spawnSync(mise, ["install"], {
+      cwd: root,
+      stdio: "inherit",
+      shell: process.platform === "win32",
+    });
+    if (install.status !== 0) {
+      process.exit(install.status ?? 1);
+    }
+  }
+
+  const result = spawnSync(mise, miseArgs, {
+    cwd: root,
+    stdio: "inherit",
+    shell: process.platform === "win32",
+  });
+  process.exit(result.status ?? 1);
+}
+
+const isMain =
+  process.argv[1] !== undefined &&
+  path.resolve(process.argv[1]) === __filename;
+
+if (isMain) {
+  const args = process.argv.slice(2);
+  if (args.length === 0) {
+    console.error(
+      "Usage: node scripts/with-mise.mjs [--install-tools] <mise-args...>",
+    );
+    process.exit(1);
+  }
+  if (args[0] === "--install-tools") {
+    runMise(args.slice(1), { installTools: true });
+  } else {
+    runMise(args, { installTools: false });
+  }
+}

package/template/src/api/alova.d.ts

@@ -0,0 +1,7 @@
+import type { MethodMeta } from "@ybais/alova";
+
+declare module "alova" {
+  interface AlovaCustomTypes {
+    meta: MethodMeta;
+  }
+}

package/template/src/api/alova.ts

@@ -0,0 +1,50 @@
+/**
+ * 应用侧 Alova 装配：读取 Vite env，注入 bridge / error-guard。
+ */
+import { createYbaisAlova } from "@ybais/alova";
+import { goLogin } from "@ybais/bridge";
+import { reportError } from "@ybais/error-guard";
+
+export const API_BASE_URL = import.meta.env.DEV
+  ? "/proxyApi"
+  : import.meta.env.VITE_API_BASE_URL;
+
+export const CRYPTO_APP_KEY = import.meta.env.VITE_CRYPTO_APP_KEY;
+export const CRYPTO_APP_SECRET = import.meta.env.VITE_CRYPTO_APP_SECRET;
+
+export const alovaInstance = createYbaisAlova({
+  baseURL: API_BASE_URL,
+  cryptoAppKey: CRYPTO_APP_KEY,
+  cryptoAppSecret: CRYPTO_APP_SECRET,
+  reportError,
+  onAuthFail: () => {
+    void goLogin().catch(() => {
+      // 浏览器无 Bridge：忽略，由业务页自行引导登录
+    });
+  },
+});
+
+export {
+  ApiError,
+  TokenBootstrap,
+  applyBusinessCodeHandlers,
+  businessCodeHandlers,
+  BUSINESS_CODE_HANDLER_COOLDOWN_MS,
+  getToken,
+  isApiSuccess,
+  removeToken,
+  resetBusinessCodeHandlerCooldown,
+  setToken,
+  showApiError,
+  SUCCESS_CODE,
+  syncTokenFromUrl,
+  TOKEN_STORAGE_KEY,
+  unwrapApiResponse,
+} from "@ybais/alova";
+
+export type {
+  ApiResponse,
+  BusinessCodeHandler,
+  MethodMeta,
+  UnwrapApiResponseOptions,
+} from "@ybais/alova";

package/template/src/api/index.ts

@@ -0,0 +1,8 @@
+/**
+ * 按业务模块拆分 method 函数，每个函数返回 method 实例。
+ * 示例：
+ *   export const getUserInfo = (id: number) =>
+ *     alovaInstance.Get<UserInfo>(`/user/${id}`);
+ */
+
+export * from "./qiniu";

package/template/src/api/qiniu.ts

@@ -0,0 +1,8 @@
+import { alovaInstance } from "@/api/alova";
+
+export const fetchQiniuToken = () => {
+  return alovaInstance.Post<{
+    token: string;
+    domain: string;
+  }>("/api/upload/getToken");
+};

package/template/src/api/uploader.ts

@@ -0,0 +1,25 @@
+/**
+ * 七牛上传单例：token API + AES 来自本应用 env。
+ */
+import { createUploader } from "@ybais/qiniu-upload";
+import { fetchQiniuToken } from "@/api/qiniu";
+
+export const uploader = createUploader({
+  fetchToken: () => fetchQiniuToken(),
+  aesKey: import.meta.env.VITE_QINIU_AES_KEY ?? "",
+  aesIv: import.meta.env.VITE_QINIU_AES_IV ?? "",
+});
+
+export {
+  compressQiniuImageUrl,
+  dataURLtoFile,
+  createUploader,
+  Uploader,
+} from "@ybais/qiniu-upload";
+
+export type {
+  CreateUploaderOptions,
+  FetchQiniuTokenResult,
+  UploadOptions,
+  UploadResult,
+} from "@ybais/qiniu-upload";

package/template/src/components/NotFoundComponent/index.tsx

@@ -0,0 +1,48 @@
+import { goBack } from "@ybais/bridge";
+import { router } from "@/router";
+import { Link } from "@tanstack/react-router";
+
+/**
+ * 路由未匹配时的 404 页（挂到 root `notFoundComponent`）
+ */
+export function NotFoundComponent() {
+  const handleGoBack = () => {
+    // App 内走原生 goBack；浏览器无 Bridge 时 reject，回退到路由 history
+    void goBack().catch(() => {
+      router.history.back();
+    });
+  };
+
+  return (
+    <div className="min-h-screen flex flex-col items-center justify-center bg-slate-50 px-6 py-10 text-center">
+      <div className="w-full max-w-md rounded-2xl bg-white px-5 py-6 shadow-sm ring-1 ring-slate-200">
+        <p className="text-sm font-medium text-slate-400">404</p>
+        <h1 className="mt-2 text-lg font-semibold text-slate-900">
+          页面不存在
+        </h1>
+        <p className="mt-3 text-sm leading-relaxed text-slate-600">
+          你访问的页面无效或已被移除，请返回首页继续使用。
+        </p>
+
+        <div className="mt-6 flex flex-col sm:flex-row sm:justify-center">
+          <Link
+            to="/"
+            replace
+            className="rounded-xl bg-slate-900 px-4 py-2.5 text-sm font-medium text-white active:opacity-80"
+          >
+            返回首页
+          </Link>
+          <button
+            type="button"
+            className="mt-2 rounded-xl bg-slate-100 px-4 py-2.5 text-sm font-medium text-slate-800 active:opacity-80 sm:mt-0 sm:ml-2"
+            onClick={handleGoBack}
+          >
+            返回上一页
+          </button>
+        </div>
+      </div>
+    </div>
+  );
+}
+
+export default NotFoundComponent;

package/template/src/components/RouterErrorComponent/index.tsx

@@ -0,0 +1,27 @@
+import { type ErrorReport, FallbackPage } from "@ybais/error-guard";
+
+export function RouterErrorComponent({
+  error,
+  reset,
+}: {
+  error: unknown;
+  reset: () => void;
+}) {
+  const err = error instanceof Error ? error : new Error(String(error));
+  const report: ErrorReport = {
+    kind: "page",
+    message: err.message || "路由渲染失败",
+    error,
+    stack: err.stack,
+    fatal: true,
+    timestamp: Date.now(),
+  };
+
+  return (
+    <FallbackPage
+      report={report}
+      onRetry={reset}
+      onReload={() => window.location.reload()}
+    />
+  );
+}

package/template/src/components/index.ts

@@ -0,0 +1,2 @@
+export * from "./RouterErrorComponent";
+export * from "./NotFoundComponent";

package/template/src/lib/README.md

@@ -0,0 +1,17 @@
+# lib 装配说明
+
+可复用基础设施已拆为 `@ybais/*` 包，本目录**不再**放置实现代码。
+
+| 能力 | 包 / 装配入口 |
+|------|----------------|
+| Bridge | `@ybais/bridge` / `@ybais/bridge/react` |
+| Clipboard | `@ybais/clipboard` / `@ybais/clipboard/react` |
+| Center toast | `@ybais/center-toast`（样式：`@ybais/center-toast/style.css`） |
+| Crypto | `@ybais/crypto` |
+| Error guard | `@ybais/error-guard` |
+| Alova | `@ybais/alova` + 本应用 [`src/api/alova.ts`](../api/alova.ts) |
+| Qiniu | `@ybais/qiniu-upload` + [`src/api/uploader.ts`](../api/uploader.ts) |
+| Updater | `@ybais/updater` |
+| VConsole | `@ybais/vconsole` |
+
+业务工具（如 `cn`）放在 `@/utils`，不要写回本目录。

package/template/src/main.tsx

@@ -0,0 +1,64 @@
+import { StrictMode } from "react";
+import { createRoot } from "react-dom/client";
+import { RouterProvider } from "@tanstack/react-router";
+import { configureBridge } from "@ybais/bridge";
+import {
+  ErrorGuardProvider,
+  reportDebug,
+  setupErrorGuard,
+} from "@ybais/error-guard";
+import { startUpdater } from "@ybais/updater";
+import { TokenBootstrap } from "@/api/alova";
+// @@vconsole
+// 仅 test 静态可达，便于 prod 构建剔除整个模块
+if (import.meta.env.VITE_APP_ENV === "test") {
+  void import("@ybais/vconsole").then((m) =>
+    m.setupVConsole({
+      appEnv: import.meta.env.VITE_APP_ENV,
+      gitBranch: import.meta.env.VITE_GIT_BRANCH,
+      isDev: import.meta.env.DEV,
+    }),
+  );
+}
+// @@/vconsole
+
+import { router } from "./router";
+
+import "./styles/index.css";
+import "@ybais/center-toast/style.css";
+
+configureBridge({
+  onUnavailable: (error, context) => {
+    reportDebug(`原生能力不可用：${context.method}`, {
+      source: "bridge",
+      error,
+      detail: {
+        method: context.method,
+        reason: context.reason,
+        params: context.params,
+      },
+      description: "浏览器预览属预期，真机 WebView 可用",
+    });
+  },
+});
+
+setupErrorGuard({
+  isDev: import.meta.env.DEV,
+});
+startUpdater({
+  isProd: import.meta.env.PROD,
+});
+
+const rootElement = document.getElementById("root")!;
+if (!rootElement.innerHTML) {
+  const root = createRoot(rootElement);
+  root.render(
+    <StrictMode>
+      <ErrorGuardProvider>
+        <TokenBootstrap>
+          <RouterProvider router={router} />
+        </TokenBootstrap>
+      </ErrorGuardProvider>
+    </StrictMode>,
+  );
+}

package/template/src/routeTree.gen.ts

@@ -0,0 +1,59 @@
+/* eslint-disable */
+
+// @ts-nocheck
+
+// noinspection JSUnusedGlobalSymbols
+
+// This file was automatically generated by TanStack Router.
+// You should NOT make any changes in this file as it will be overwritten.
+// Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
+
+import { Route as rootRouteImport } from './routes/__root'
+import { Route as IndexRouteImport } from './routes/index'
+
+const IndexRoute = IndexRouteImport.update({
+  id: '/',
+  path: '/',
+  getParentRoute: () => rootRouteImport,
+} as any)
+
+export interface FileRoutesByFullPath {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesByTo {
+  '/': typeof IndexRoute
+}
+export interface FileRoutesById {
+  __root__: typeof rootRouteImport
+  '/': typeof IndexRoute
+}
+export interface FileRouteTypes {
+  fileRoutesByFullPath: FileRoutesByFullPath
+  fullPaths: '/'
+  fileRoutesByTo: FileRoutesByTo
+  to: '/'
+  id: '__root__' | '/'
+  fileRoutesById: FileRoutesById
+}
+export interface RootRouteChildren {
+  IndexRoute: typeof IndexRoute
+}
+
+declare module '@tanstack/react-router' {
+  interface FileRoutesByPath {
+    '/': {
+      id: '/'
+      path: '/'
+      fullPath: '/'
+      preLoaderRoute: typeof IndexRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+  }
+}
+
+const rootRouteChildren: RootRouteChildren = {
+  IndexRoute: IndexRoute,
+}
+export const routeTree = rootRouteImport
+  ._addFileChildren(rootRouteChildren)
+  ._addFileTypes<FileRouteTypes>()

package/template/src/router.ts

@@ -0,0 +1,10 @@
+import { createRouter } from "@tanstack/react-router";
+import { routeTree } from "./routeTree.gen";
+
+declare module "@tanstack/react-router" {
+  interface Register {
+    router: typeof router;
+  }
+}
+
+export const router = createRouter({ routeTree });

package/template/src/routes/__root.tsx

@@ -0,0 +1,10 @@
+import { NotFoundComponent, RouterErrorComponent } from "@/components";
+import { createRootRoute, Outlet } from "@tanstack/react-router";
+
+const RootLayout = () => <Outlet />;
+
+export const Route = createRootRoute({
+  component: RootLayout,
+  errorComponent: RouterErrorComponent,
+  notFoundComponent: NotFoundComponent,
+});

package/template/src/routes/index.tsx

@@ -0,0 +1,39 @@
+import { startRpCheck } from "@ybais/bridge";
+import { useCopyText } from "@ybais/clipboard/react";
+import { cn } from "@/utils/cn";
+import { createFileRoute } from "@tanstack/react-router";
+
+export const Route = createFileRoute("/")({
+  component: Index,
+});
+
+function Index() {
+  const { copy, copied, } = useCopyText();
+
+  return (
+    <div className="p-2">
+      <h3 className="mb-2">Welcome Home!</h3>
+
+      <div className="space-x-3">
+        <button
+          className="bg-blue-500 text-white p-2 rounded-md text-sm"
+          type="button"
+          onClick={startRpCheck}
+        >
+          Click me
+        </button>
+
+        <button
+          className={cn(
+            "text-white p-2 rounded-md text-sm",
+            copied ? "bg-emerald-600" : "bg-green-500",
+          )}
+          type="button"
+          onClick={() => void copy("啊就打算建档立卡随机掉落空间")}
+        >
+          {copied ? "🎉复制成功🎉" : "点击复制"}
+        </button>
+      </div>
+    </div>
+  );
+}

package/template/src/styles/index.css

@@ -0,0 +1,42 @@
+@import "./variant.css";
+@import "./webview-compat.css";
+
+@tailwind base;
+@tailwind components;
+@tailwind utilities;
+
+/* 移动端全局常规行为控制 */
+html,
+body {
+  margin: 0;
+  padding: 0;
+  width: 100%;
+  height: 100%;
+  /* 禁用全局点击灰色高亮框 */
+  -webkit-tap-highlight-color: transparent;
+  /* 禁用全局文本选中（如果部分内容需复制，可在对应组件上单独覆盖为 text） */
+  -webkit-user-select: none;
+  user-select: none;
+  /* 开启平滑弹性滚动 */
+  -webkit-overflow-scrolling: touch;
+}
+
+/* 全局样式中禁用文本意外选中与默认 touch 反馈 */
+body {
+  -webkit-touch-callout: none;
+  -webkit-user-select: none;
+  user-select: none;
+  -webkit-tap-highlight-color: transparent;
+}
+
+/* 允许输入框等交互元素可选中 */
+input,
+textarea {
+  -webkit-user-select: auto;
+  user-select: auto;
+}
+
+#root {
+  width: 100%;
+  min-height: 100%;
+}