create-soybean 1.7.0 → 1.7.1

package/template-ubean-client/src/pages/guide.md

@@ -0,0 +1,30 @@
+---
+name: Guide
+head:
+  title: 指南 - @ubean/vue SPA
+  meta:
+    - name: description
+      content: markdown 页面演示
+---
+
+# 指南(markdown 页面)
+
+`markdown: true` 开启后,`pages/**/*.md` 由 `@ubean/markdown`(按需加载)编译为 Vue 组件。
+
+## frontmatter → 页面元数据
+
+- `name: Guide` → 路由名
+- `head.title` → `route.meta.head.title`(插件 `head: true` 提取)
+
+## 支持的语法
+
+- 列表、**加粗**、`行内代码`
+- [内部链接](/about) 与外部链接
+- 表格:
+
+| 特性     | 状态             |
+| -------- | ---------------- |
+| md + mdx | `markdown: true` |
+| 仅 md    | `markdown: 'md'` |
+
+> frontmatter 之外的正文就是页面内容。

package/template-ubean-client/src/pages/index.vue

@@ -0,0 +1,101 @@
+<script setup lang="ts">
+// 全部显式导入 —— 精简内核不提供自动引入。
+// definePage 声明由 @ubean/vue/vite 编译期提取(构建后此调用被剥除)。
+import { ref } from 'vue';
+import { definePage } from '@ubean/vue';
+import { Icon } from '@iconify/vue';
+
+// 文件即路由:pages/index.vue → '/',name 覆盖文件派生的 'Index' 为 'Home'
+definePage({ name: 'Home' });
+
+const mountedAt = ref(new Date().toLocaleTimeString());
+
+const features = [
+  { name: '文件式路由', desc: 'pages/ 目录即路由表,definePage 声明 name/cache/transition —— 全部编译期提取' },
+  { name: 'ubeanVue 插件', desc: 'app.use(ubeanVue, { routes }) — 组件注册 + 缓存播种,一步完成' },
+  { name: '原生 createRouter', desc: '内核不产出 router 工厂,直接用 vue-router createRouter 组装生成的路由表' },
+  {
+    name: '页面缓存 keep-alive',
+    desc: 'definePage({ cache: true }) 声明式播种 + enablePageCache/disablePageCache 运行时控制'
+  },
+  { name: '过渡与重载', desc: 'definePage({ transition }) 页面级过渡 + reloadPage 强制重挂载' },
+  { name: '零负担依赖', desc: '运行时仅 vue + vue-router —— 无 i18n/head/SEO,产物零 node: 模块' }
+];
+</script>
+
+<template>
+  <section>
+    <h1>@ubean/vue 独立 SPA</h1>
+    <p class="subtitle">精简客户端内核:路由 / 页面缓存 / 过渡动画 —— 插件式接入,显式导入</p>
+
+    <Icon icon="lucide:search" />
+
+    <ul class="features">
+      <li v-for="f in features" :key="f.name">
+        <strong>{{ f.name }}</strong>
+        <span>{{ f.desc }}</span>
+      </li>
+    </ul>
+
+    <p class="hint">
+      前往
+      <Link to="/users/1">用户详情</Link>
+      体验 matcher 校验;前往
+      <Link to="/about">关于</Link>
+      查看 reload/transition 控制。外部链接:
+      <Link to="https://vuejs.org">vuejs.org</Link>
+    </p>
+    <p class="mono">App setup 执行于 {{ mountedAt }}</p>
+  </section>
+</template>
+
+<style scoped>
+h1 {
+  font-size: 1.8rem;
+  margin-bottom: 0.5rem;
+}
+
+.subtitle {
+  color: gray;
+  margin-bottom: 1.5rem;
+}
+
+.features {
+  list-style: none;
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+  gap: 0.9rem;
+}
+
+.features li {
+  border: 1px solid rgba(128, 128, 128, 0.25);
+  border-radius: 10px;
+  padding: 0.9rem 1rem;
+  display: flex;
+  flex-direction: column;
+  gap: 0.35rem;
+}
+
+.features strong {
+  font-family: 'SF Mono', ui-monospace, monospace;
+  font-size: 0.9rem;
+}
+
+.features span {
+  font-size: 0.85rem;
+  color: gray;
+  line-height: 1.5;
+}
+
+.hint {
+  margin-top: 1.5rem;
+  font-size: 0.9rem;
+}
+
+.mono {
+  margin-top: 0.75rem;
+  font-family: 'SF Mono', ui-monospace, monospace;
+  font-size: 0.8rem;
+  color: gray;
+}
+</style>

package/template-ubean-client/src/pages/users/[id=numeric].vue

@@ -0,0 +1,80 @@
+<script setup lang="ts">
+// 动态参数 + matcher 语法:文件名 `[id=numeric]` → 路由 `/users/:id` +
+// meta.matchers = { id: 'numeric' };matcher 注册在 src/main.ts
+// (defineMatcher('numeric', ...)),守卫 createMatcherGuard 校验失败重定向 404。
+import { computed } from 'vue';
+import { useRoute } from 'vue-router';
+import { definePage } from '@ubean/vue';
+
+definePage({ name: 'UsersId', head: { title: '用户详情' } });
+
+const route = useRoute();
+// typed-router 生效时 route.params 是全路由参数联合,此处按本页形状窄化。
+const params = route.params as { id?: string };
+const id = computed(() => params.id ?? '');
+
+const users: Record<string, string> = {
+  '1': '索易 Bean',
+  '2': 'Vue Router',
+  '3': 'KeepAlive'
+};
+const name = computed(() => users[id.value] ?? '未知用户');
+</script>
+
+<template>
+  <section>
+    <h1>用户详情</h1>
+    <p class="subtitle">
+      路由
+      <code>/users/:id</code>
+      + matcher
+      <code>[id=numeric]</code>
+    </p>
+    <div class="card">
+      <p>
+        参数 id =
+        <strong class="mono">{{ id }}</strong>
+      </p>
+      <p>
+        用户 =
+        <strong>{{ name }}</strong>
+      </p>
+      <p class="mono">useRoute().fullPath = {{ route.fullPath }}</p>
+    </div>
+    <p class="hint">
+      访问
+      <Link to="/users/abc">/users/abc</Link>
+      触发 matcher 校验失败 → 重定向 NotFound;
+      <Link to="/users">返回列表</Link>
+    </p>
+  </section>
+</template>
+
+<style scoped>
+h1 {
+  font-size: 1.5rem;
+  margin-bottom: 0.5rem;
+}
+.subtitle {
+  color: gray;
+  margin-bottom: 1.25rem;
+  font-size: 0.92rem;
+}
+.card {
+  border: 1px solid rgba(128, 128, 128, 0.3);
+  border-radius: 10px;
+  padding: 1rem 1.25rem;
+}
+.card p {
+  margin: 0.3rem 0;
+}
+.mono {
+  font-family: 'SF Mono', ui-monospace, monospace;
+  font-size: 0.85rem;
+}
+.hint {
+  margin-top: 1.25rem;
+  font-size: 0.88rem;
+  color: gray;
+}
+</style>

package/template-ubean-client/src/pages/users/index.vue

@@ -0,0 +1,56 @@
+<script setup lang="ts">
+// 动态参数列表页:目录内 index.vue → /users(名称 Users)。
+import { definePage } from '@ubean/vue';
+
+definePage({ name: 'Users' });
+
+const users = [
+  { id: 1, name: '索易 Bean' },
+  { id: 2, name: 'Vue Router' },
+  { id: 3, name: 'KeepAlive' }
+];
+</script>
+
+<template>
+  <section>
+    <h1>用户列表</h1>
+    <p class="subtitle">
+      路由
+      <code>/users</code>
+      —— 子页
+      <code>[id=numeric].vue</code>
+      演示动态参数 + matcher
+    </p>
+    <ul class="users">
+      <li v-for="u in users" :key="u.id">
+        <Link :to="`/users/${u.id}`">#{{ u.id }} {{ u.name }}</Link>
+      </li>
+    </ul>
+  </section>
+</template>
+
+<style scoped>
+h1 {
+  font-size: 1.5rem;
+  margin-bottom: 0.5rem;
+}
+.subtitle {
+  color: gray;
+  margin-bottom: 1.25rem;
+  font-size: 0.92rem;
+}
+.users {
+  list-style: none;
+  display: flex;
+  flex-direction: column;
+  gap: 0.5rem;
+}
+.users a {
+  color: #42b883;
+  text-decoration: none;
+  font-weight: 500;
+}
+.users a:hover {
+  text-decoration: underline;
+}
+</style>

package/template-ubean-client/src/typings/globals.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 全局组件类型声明。
+ *
+ * 精简内核不生成 components.d.ts(无构建插件);全局组件
+ * (Link / PageView / SlotView / ClientOnly)由 `ubeanVue` 插件在运行时注册,
+ * 此处手动声明以获得模板类型提示。
+ */
+export {};
+
+declare module 'vue' {
+  export interface GlobalComponents {
+    Link: (typeof import('@ubean/vue'))['Link'];
+    PageView: (typeof import('@ubean/vue'))['PageView'];
+    SlotView: (typeof import('@ubean/vue'))['SlotView'];
+    ClientOnly: (typeof import('@ubean/vue'))['ClientOnly'];
+  }
+}

package/template-ubean-client/tsconfig.json

@@ -0,0 +1,25 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "jsx": "preserve",
+    "jsxImportSource": "vue",
+    "lib": ["DOM", "ESNext"],
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "paths": {
+      "@/*": ["./src/*"]
+    },
+    "types": ["node", "vite/client"],
+    "resolveJsonModule": true,
+    "strict": true,
+    "strictNullChecks": true,
+    "noUnusedLocals": true,
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true,
+    "skipLibCheck": true
+  },
+  "include": ["./**/*.ts", "./**/*.d.ts", "./**/*.vue", "./.ubean/**/*.d.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/template-ubean-client/vite.config.ts

@@ -0,0 +1,20 @@
+import { defineConfig } from 'vite-plus';
+import vue from '@vitejs/plugin-vue';
+import { ubeanVueVite } from '@ubean/vue/vite';
+
+/**
+ * 独立 SPA 构建配置 —— @ubean/vue 精简内核 + 文件式路由:
+ * - 纯 Vite + @vitejs/plugin-vue,无自动引入、无 i18n、无 SSR
+ * - `ubeanVueVite()` 覆盖:
+ *   - 文件路由约定:动态参数 `[id=numeric]`、catch-all `[...slug]`、
+ *     reuse `.reuse.ts`、特殊页 404/loading/error
+ *   - `markdown: true` —— md + mdx 页面(@ubean/markdown 按需加载)
+ *   - `head: true` —— definePage/frontmatter 的 head 提取到 route.meta.head
+ * - 路由实例由 src/main.ts 用 vue-router 原生 createRouter 创建
+ */
+export default defineConfig({
+  resolve: {
+    tsconfigPaths: true
+  },
+  plugins: [vue(), ubeanVueVite({ markdown: true, head: true })]
+});

package/template-vue/.gitignore

@@ -0,0 +1,2 @@
+
+.temp

package/template-vue/_vite-hooks/pre-commit

@@ -0,0 +1 @@
+vp staged

package/template-vue/eslint.config.mjs

@@ -0,0 +1,3 @@
+import { defineConfig } from '@soybeanjs/eslint-config-vue';
+
+export default defineConfig();

package/template-vue/package.json

@@ -4,48 +4,39 @@
   "private": true,
   "type": "module",
   "scripts": {
-    "build": "vite build",
+    "build": "vp build",
     "cleanup": "soy cleanup",
     "commit": "soy git-commit",
-    "dev": "vite",
-    "lint": "oxlint --fix",
-    "fmt": "oxfmt",
-    "prepare": "simple-git-hooks",
-    "preview": "vite preview",
+    "dev": "vp dev",
+    "fmt": "vp fmt",
+    "lint": "vp lint --fix && pnpm lint:vue",
+    "lint:vue": "eslint . --ext .vue --fix",
+    "preview": "vp preview",
     "typecheck": "vue-tsc --noEmit --skipLibCheck",
     "upkg": "soy ncu"
   },
   "dependencies": {
-    "@soybeanjs/ui": "^0.12.4",
-    "@unocss/reset": "^66.6.7",
-    "klona": "^2.0.6",
+    "@soybeanjs/ui": "^0.30.0",
     "pinia": "^3.0.4",
     "vue": "^3.5.30",
     "vue-router": "^5.0.4"
   },
   "devDependencies": {
-    "@soybeanjs/cli": "^1.7.1",
-    "@soybeanjs/unocss-preset": "^0.2.0",
-    "@types/node": "^25.5.0",
+    "@soybeanjs/cli": "^1.8.3",
+    "@soybeanjs/eslint-config-vue": "^0.1.1",
+    "@soybeanjs/oxc-config": "^0.2.6",
+    "@soybeanjs/ui-uno": "^0.30.0",
+    "@types/node": "^26.5.1",
     "@vitejs/plugin-vue": "^6.0.5",
     "@vitejs/plugin-vue-jsx": "^5.1.5",
     "elegant-router": "^1.3.0",
-    "lint-staged": "^16.4.0",
-    "oxfmt": "^0.41.0",
-    "oxlint": "^1.56.0",
-    "simple-git-hooks": "^2.13.1",
-    "typescript": "^5.9.3",
+    "eslint": "^10.10.0",
+    "typescript": "catalog:",
     "unocss": "^66.6.7",
     "unplugin-vue-components": "^31.0.0",
-    "vite": "^8.0.1",
+    "vite": "catalog:",
+    "vite-plus": "catalog:",
     "vue-tsc": "^3.2.6"
   },
-  "simple-git-hooks": {
-    "commit-msg": "pnpm soy git-commit-verify",
-    "pre-commit": "pnpm typecheck && pnpm lint-staged"
-  },
-  "lint-staged": {
-    "*": "oxlint --fix && oxfmt"
-  },
-  "packageManager": "pnpm@10.32.1"
+  "packageManager": "pnpm@12.4.1"
 }

package/template-vue/pnpm-workspace.yaml

@@ -0,0 +1,11 @@
+catalog:
+  vite: npm:@voidzero-dev/vite-plus-core@latest
+  vite-plus: latest
+  typescript: npm:typescript-native-bridge@latest
+overrides:
+  vite: 'catalog:'
+  typescript: 'catalog:'
+shamefullyHoist: true
+allowBuilds:
+  esbuild: false
+minimumReleaseAge: 0

package/template-vue/src/App.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts"></script>
 
 <template>
-  <SConfigProvider>
-    <RouterView />
-  </SConfigProvider>
+  <SCard title="SoybeanUI">
+    <SButton>Hello World</SButton>
+  </SCard>
 </template>

package/template-vue/src/main.ts

@@ -1,16 +1,11 @@
 import { createApp } from 'vue';
-import './plugins/assets';
+import '@soybeanjs/ui/styles.css';
+import 'uno.css';
 import App from './App.vue';
-import { setupRouter } from './router';
-import { setupStore } from './store';
 
 async function setupApp() {
   const app = createApp(App);
 
-  setupStore(app);
-
-  await setupRouter(app);
-
   app.mount('#app');
 }
 

package/template-vue/uno.config.ts

@@ -1,5 +1,5 @@
-import { defineConfig, presetWind3, transformerDirectives, transformerVariantGroup } from 'unocss';
-import { presetSoybean } from '@soybeanjs/unocss-preset';
+import { defineConfig, transformerDirectives, transformerVariantGroup } from 'unocss';
+import { presetUiUnocss } from '@soybeanjs/ui-uno';
 
 export default defineConfig({
   content: {
@@ -8,5 +8,5 @@ export default defineConfig({
     }
   },
   transformers: [transformerDirectives(), transformerVariantGroup()],
-  presets: [presetWind3({ dark: 'class' }), presetSoybean()]
+  presets: [presetUiUnocss()]
 });

package/template-vue/vite.config.ts

@@ -1,13 +1,18 @@
 import { URL, fileURLToPath } from 'node:url';
-import { defineConfig } from 'vite';
+import { defineConfig } from 'vite-plus';
 import Vue from '@vitejs/plugin-vue';
 import VueJsx from '@vitejs/plugin-vue-jsx';
-import UiResolver from '@soybeanjs/ui/resolver';
-import Unocss from 'unocss/vite';
 import Components from 'unplugin-vue-components/vite';
-import ElegantRouter from 'elegant-router/vite';
+import Unocss from 'unocss/vite';
+import { lint, fmt } from '@soybeanjs/oxc-config';
+import UiResolver from '@soybeanjs/ui/resolver';
 
 export default defineConfig({
+  staged: {
+    '*': 'vp check --fix'
+  },
+  fmt,
+  lint,
   resolve: {
     alias: {
       '@': fileURLToPath(new URL('./src', import.meta.url))
@@ -21,8 +26,7 @@ export default defineConfig({
       dts: 'src/typings/components.d.ts',
       types: [{ from: 'vue-router', names: ['RouterLink', 'RouterView'] }],
       resolvers: [UiResolver()]
-    }),
-    ElegantRouter()
+    })
   ],
   server: {
     host: '0.0.0.0',

package/template-vue-lib/_editorconfig

@@ -0,0 +1,11 @@
+# Editor configuration, see http://editorconfig.org
+
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+trim_trailing_whitespace = true
+insert_final_newline = true

package/template-vue-lib/_gitattributes

@@ -0,0 +1,2 @@
+* text=auto
+*.* text eol=lf

package/template-vue-lib/_vite-hooks/pre-commit

@@ -0,0 +1 @@
+vp staged

package/template-vue-lib/eslint.config.mjs

@@ -0,0 +1,3 @@
+import { defineConfig } from '@soybeanjs/eslint-config-vue';
+
+export default defineConfig();

package/template-vue-lib/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "template-vue-lib",
+  "version": "0.0.0",
+  "private": true,
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "vp pack",
+    "cleanup": "soy cleanup",
+    "commit": "soy git-commit",
+    "dev": "vp pack --watch",
+    "fmt": "vp fmt",
+    "lint": "vp lint --fix && pnpm lint:vue",
+    "lint:vue": "eslint . --ext .vue --fix",
+    "play": "vp dev",
+    "publish-pkg": "pnpm publish --access public",
+    "release": "soy release",
+    "test": "vp test",
+    "typecheck": "tsc --noEmit --skipLibCheck",
+    "upkg": "soy ncu"
+  },
+  "devDependencies": {
+    "@soybeanjs/cli": "^1.8.3",
+    "@soybeanjs/eslint-config-vue": "^0.1.1",
+    "@soybeanjs/oxc-config": "^0.2.6",
+    "@types/node": "^26.5.1",
+    "@vue/test-utils": "^2.4.6",
+    "eslint": "^10.10.0",
+    "happy-dom": "^20.8.4",
+    "typescript": "catalog:",
+    "unplugin-vue": "^7.1.1",
+    "unplugin-vue-jsx": "^0.8.1",
+    "vite": "catalog:",
+    "vite-plus": "catalog:",
+    "vue": "^3.5.30",
+    "vue-tsc": "^3.2.6"
+  },
+  "packageManager": "pnpm@12.4.1"
+}

package/template-vue-lib/pnpm-workspace.yaml

@@ -0,0 +1,11 @@
+catalog:
+  vite: npm:@voidzero-dev/vite-plus-core@latest
+  vite-plus: latest
+  typescript: npm:typescript-native-bridge@latest
+overrides:
+  vite: 'catalog:'
+  typescript: 'catalog:'
+shamefullyHoist: true
+allowBuilds:
+  esbuild: false
+minimumReleaseAge: 0

package/template-vue-lib/vite.config.ts

@@ -0,0 +1,33 @@
+import { defineConfig } from 'vite-plus';
+import unpluginVue from 'unplugin-vue/rolldown';
+import vue from 'unplugin-vue/vite';
+import unpluginVueJsx from 'unplugin-vue-jsx/rolldown';
+import { lint, fmt } from '@soybeanjs/oxc-config';
+
+export default defineConfig({
+  staged: {
+    '*': 'vp check --fix'
+  },
+  fmt,
+  lint,
+  resolve: {
+    tsconfigPaths: true
+  },
+  root: './playground',
+  plugins: [vue()],
+  pack: {
+    entry: ['src/index.ts'],
+    platform: 'neutral',
+    deps: {
+      neverBundle: ['vue']
+    },
+    clean: true,
+    dts: {
+      vue: true
+    },
+    plugins: [unpluginVue({ isProduction: true }), unpluginVueJsx()],
+    sourcemap: false,
+    minify: false,
+    fixedExtension: false
+  }
+});

package/template-tsdown/_npmrc

@@ -1 +0,0 @@
-shamefully-hoist=true

package/template-tsdown/_oxfmtrc.json

@@ -1,7 +0,0 @@
-{
-  "$schema": "./node_modules/oxfmt/configuration_schema.json",
-  "printWidth": 120,
-  "singleQuote": true,
-  "trailingComma": "none",
-  "arrowParens": "avoid"
-}

package/template-tsdown/_oxlintrc.json

@@ -1,16 +0,0 @@
-{
-  "$schema": "./node_modules/oxlint/configuration_schema.json",
-  "categories": {
-    "correctness": "error",
-    "suspicious": "error"
-  },
-  "plugins": ["eslint", "typescript", "unicorn", "oxc", "import"],
-  "rules": {
-    "unicorn/consistent-function-scoping": "off",
-    "unicorn/no-array-reverse": "off",
-    "unicorn/no-array-sort": "off",
-    "unicorn/no-empty-file": "off",
-    "import/no-unassigned-import": "off",
-    "unicorn/require-module-specifiers": "off"
-  }
-}