@liujitcn/kratos-uni-app-cli 0.0.1

package/README.md

@@ -0,0 +1,38 @@
+# @liujitcn/kratos-uni-app-cli
+
+`@liujitcn/kratos-uni-app-cli` 提供 `kratos-uni-app` 命令，用于创建独立 pnpm workspace、uni-app 宿主和可选本地业务模块。
+
+## 目录结构
+
+```text
+packages/cli
+├── bin/kratos-uni-app.mjs         # 命令行参数解析与可执行入口
+├── src/index.mjs              # workspace 文件生成逻辑
+├── test/scaffold.test.mjs     # 脚手架结构和参数测试
+├── README.md                  # CLI 包职责、参数和生成约束
+└── package.json
+```
+
+CLI 直接由 `src/index.mjs` 生成文件，不依赖外部模板目录。
+
+## 功能
+
+- 创建包含 `apps/uni-app` 的独立 pnpm workspace。
+- 默认接入 core 和 system 包。
+- 使用 `--module` 创建 workspace 内本地模块。
+- 使用 `--with` 安装额外的已发布模块。
+- 校验模块名和包名，目标目录已存在时拒绝覆盖。
+- core、system 和本地模块的 core 依赖版本统一跟随当前 CLI 包版本。
+- 生成的宿主在登录、退出和静默退出后重新加载当前身份的导航配置。
+- 为 workspace 根目录、`apps/uni-app` 和每个本地模块生成同级 `README.md`；每个包含
+  `package.json` 的生成目录都有对应的结构与职责说明。
+
+## 使用
+
+```bash
+pnpm dlx @liujitcn/kratos-uni-app-cli create my-app
+pnpm dlx @liujitcn/kratos-uni-app-cli create my-app --module orders
+pnpm dlx @liujitcn/kratos-uni-app-cli create my-app --with @acme/pay
+```
+
+包构建和脚手架验证命令见 [workspace 文档](../../README.md)。

package/bin/kratos-uni-app.mjs

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+import { scaffoldKratosApp } from '../src/index.mjs'
+
+const args = process.argv.slice(2)
+if (args[0] !== 'create' || !args[1]) {
+  console.error('用法: kratos-uni-app create <目录> [--module <名称>] [--with <包名>]')
+  process.exitCode = 1
+} else {
+  const modules = []
+  const packages = []
+  for (let index = 2; index < args.length; index += 1) {
+    if (args[index] === '--module' && args[index + 1]) modules.push(args[++index])
+    else if (args[index] === '--with' && args[index + 1]) packages.push(args[++index])
+    else throw new Error(`未知参数：${args[index]}`)
+  }
+  scaffoldKratosApp(args[1], { modules, packages })
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@liujitcn/kratos-uni-app-cli",
+  "description": "CLI for scaffolding modular Kratos uni-app workspaces.",
+  "version": "0.0.1",
+  "type": "module",
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "bin": {
+    "kratos-uni-app": "./bin/kratos-uni-app.mjs"
+  },
+  "exports": {
+    ".": "./src/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "pnpm pack --pack-destination ../../dist/npm"
+  }
+}

package/src/index.mjs

@@ -0,0 +1,361 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'
+import { basename, resolve } from 'node:path'
+
+const cliPackage = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'))
+const publicPackageVersion = cliPackage.version
+if (typeof publicPackageVersion !== 'string' || !publicPackageVersion) {
+  throw new Error('CLI package.json 缺少有效版本')
+}
+
+/** 创建独立 Kratos uni-app workspace。 */
+export function scaffoldKratosApp(targetPath, options = {}) {
+  const target = resolve(targetPath)
+  if (existsSync(target)) throw new Error(`目标目录已存在：${target}`)
+  const projectName = basename(target)
+  const modules = [...new Set(options.modules ?? [])]
+  const packages = [...new Set(options.packages ?? [])]
+  modules.forEach(validateModuleName)
+  packages.forEach(validatePackageName)
+  mkdirSync(resolve(target, 'apps/uni-app/src/pages/bootstrap'), { recursive: true })
+  modules.forEach((name) =>
+    mkdirSync(resolve(target, `packages/modules/${name}/src/views`), { recursive: true }),
+  )
+
+  write(target, 'pnpm-workspace.yaml', 'packages:\n  - apps/*\n  - packages/modules/*\n')
+  write(
+    target,
+    'package.json',
+    json({
+      name: projectName,
+      description: `Independent pnpm workspace for ${projectName}.`,
+      private: true,
+      scripts: {
+        'dev:h5': 'pnpm --filter @liujitcn/kratos-uni-app dev:h5',
+        'dev:mp-weixin': 'pnpm --filter @liujitcn/kratos-uni-app dev:mp-weixin',
+        'build:h5': 'pnpm --filter @liujitcn/kratos-uni-app build:h5',
+        'build:mp-weixin': 'pnpm --filter @liujitcn/kratos-uni-app build:mp-weixin',
+      },
+      devDependencies: {
+        '@dcloudio/types': 'latest',
+        '@vue/compiler-sfc': '^3.4.21',
+        '@vue/tsconfig': 'latest',
+        'miniprogram-api-typings': 'latest',
+        typescript: 'latest',
+        'vue-tsc': 'latest',
+      },
+    }),
+  )
+  write(
+    target,
+    'README.md',
+    `# ${projectName}
+
+\`${projectName}\` 是由 \`@liujitcn/kratos-uni-app-cli\` 创建的独立 pnpm workspace，支持 H5 和微信小程序。
+
+## 目录结构
+
+\`\`\`text
+${projectName}
+├── apps/uni-app                 # 私有 uni-app 宿主
+├── packages/modules        # workspace 内本地业务模块
+├── package.json            # 公共命令和开发依赖
+├── pnpm-workspace.yaml     # workspace 包范围
+└── tsconfig.json           # 共享 TypeScript 配置
+\`\`\`
+
+宿主只负责入口、manifest、模块清单和启动；底座能力由 \`@liujitcn/kratos-uni-app-core\` 提供，默认业务页面由 \`@liujitcn/kratos-uni-app-system\` 提供。本地模块通过各自公开入口接入，不跨包相对引用源码。
+
+## 开发
+
+\`\`\`bash
+pnpm install
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+\`\`\`
+
+模块装配入口是 \`apps/uni-app/src/module-manifest.ts\`。新增、删除或调整模块时同步维护该清单，并在模块自己的 README 中记录页面和接口职责。
+`,
+  )
+  const dependencies = {
+    '@liujitcn/kratos-uni-app-core': `^${publicPackageVersion}`,
+    '@liujitcn/kratos-uni-app-system': `^${publicPackageVersion}`,
+    '@dcloudio/uni-app': 'latest',
+    '@dcloudio/uni-components': 'latest',
+    '@dcloudio/uni-h5': 'latest',
+    '@dcloudio/uni-mp-weixin': 'latest',
+    '@dcloudio/uni-ui': 'latest',
+    '@dcloudio/vite-plugin-uni': 'latest',
+    pinia: '^2.0.27',
+    sass: '^1.77.8',
+    vite: '^5.2.8',
+    vue: '^3.4.21',
+    ...Object.fromEntries(modules.map((name) => [`@local/${name}`, 'workspace:*'])),
+    ...Object.fromEntries(packages.map((name) => [name, 'latest'])),
+  }
+  write(
+    target,
+    'apps/uni-app/package.json',
+    json({
+      name: '@liujitcn/kratos-uni-app',
+      description: `Private uni-app host for ${projectName}.`,
+      version: '0.0.1',
+      private: true,
+      type: 'module',
+      scripts: {
+        'dev:h5': 'uni --mode development',
+        'dev:mp-weixin': 'uni -p mp-weixin',
+        'build:h5': 'uni build --mode production',
+        'build:mp-weixin': 'uni build -p mp-weixin --mode production',
+        tsc: 'vue-tsc --noEmit',
+      },
+      dependencies,
+    }),
+  )
+  write(
+    target,
+    'apps/uni-app/README.md',
+    `# @liujitcn/kratos-uni-app
+
+\`apps/uni-app\` 是 \`${projectName}\` 的私有 uni-app 宿主，负责组合模块并提供 H5、微信小程序的构建入口，不承载可复用业务实现。
+
+## 目录结构
+
+\`\`\`text
+apps/uni-app
+├── src
+│   ├── pages/bootstrap      # 固定启动页面
+│   ├── App.vue              # 应用根组件和全局样式入口
+│   ├── main.ts              # Vue 与 Kratos uni-app 启动入口
+│   ├── manifest.json        # uni-app 平台配置
+│   ├── module-manifest.ts   # 唯一模块清单
+│   └── pages.json           # 固定 bootstrap 路由
+├── index.html               # H5 HTML 入口
+├── package.json             # 宿主命令和运行依赖
+└── vite.config.ts           # 模块页面装配与 uni-app 插件
+\`\`\`
+
+## 模块装配
+
+\`src/module-manifest.ts\` 默认注册 core 和 system，并按声明顺序加载本地模块与已发布模块。业务页面、API 和状态应放在所属模块，宿主仅维护组合关系和平台配置。
+
+## 命令
+
+在 workspace 根目录执行：
+
+\`\`\`bash
+pnpm dev:h5
+pnpm dev:mp-weixin
+pnpm build:h5
+pnpm build:mp-weixin
+\`\`\`
+`,
+  )
+  const imports = [
+    "import { coreModule } from '@liujitcn/kratos-uni-app-core/module'",
+    "import systemModule from '@liujitcn/kratos-uni-app-system'",
+    ...modules.map((name, index) => `import localModule${index} from '@local/${name}'`),
+    ...packages.map((name, index) => `import packageModule${index} from '${name}'`),
+  ]
+  const members = [
+    'coreModule',
+    'systemModule',
+    ...modules.map((_, index) => `localModule${index}`),
+    ...packages.map((_, index) => `packageModule${index}`),
+  ]
+  write(
+    target,
+    'apps/uni-app/src/module-manifest.ts',
+    `${imports.join('\n')}\n\nexport const moduleManifest = [${members.join(', ')}]\n`,
+  )
+  write(
+    target,
+    'apps/uni-app/src/pages.json',
+    json({
+      pages: [
+        {
+          path: 'pages/bootstrap/index',
+          style: { navigationStyle: 'custom' },
+        },
+      ],
+    }),
+  )
+  write(
+    target,
+    'apps/uni-app/src/pages/bootstrap/index.vue',
+    `<script setup lang="ts">
+import { onLoad } from '@dcloudio/uni-app'
+import { resolveStaticView } from '@liujitcn/kratos-uni-app-core'
+onLoad((options) => {
+  const route = resolveStaticView('BOOTSTRAP_LOADING') ?? 'pages/status/index'
+  const target = options?.route ? decodeURIComponent(options.route) : 'app/home'
+  uni.reLaunch({ url: \`/\${route}?state=BOOTSTRAP_LOADING&bootstrap=1&route=\${encodeURIComponent(target)}\` })
+})
+</script>
+<template><view /></template>
+`,
+  )
+  write(
+    target,
+    'apps/uni-app/src/main.ts',
+    `import {
+  bootstrapKratosApp,
+  initializeAppNavigation,
+  pinia,
+  registerKratosAppModules,
+  registerUserStoreExtension,
+} from '@liujitcn/kratos-uni-app-core'
+import { createSSRApp } from 'vue'
+import App from './App.vue'
+import { moduleManifest } from './module-manifest'
+
+registerKratosAppModules(moduleManifest)
+registerUserStoreExtension({
+  onLogin: initializeAppNavigation,
+  onLogout: initializeAppNavigation,
+  onSilentLogout: initializeAppNavigation,
+})
+
+export function createApp() {
+  return bootstrapKratosApp({ app: App, createSSRApp, pinia, modules: moduleManifest })
+}
+`,
+  )
+  write(
+    target,
+    'apps/uni-app/src/App.vue',
+    `<script setup lang="ts"></script>
+<style lang="scss">@use '@liujitcn/kratos-uni-app-core/styles/base.scss';</style>
+`,
+  )
+  write(target, 'apps/uni-app/src/uni.scss', "@forward '@liujitcn/kratos-uni-app-core/uni.scss';\n")
+  write(
+    target,
+    'apps/uni-app/src/manifest.json',
+    json({
+      name: projectName,
+      appid: '__UNI__KRATOS_APP',
+      versionName: '1.0.0',
+      versionCode: '100',
+      transformPx: false,
+      'mp-weixin': { appid: '', setting: { urlCheck: false } },
+      h5: { router: { mode: 'hash' } },
+    }),
+  )
+  write(
+    target,
+    'apps/uni-app/index.html',
+    `<!doctype html>
+<html><head><meta charset="UTF-8"><meta name="viewport" content="width=device-width,initial-scale=1,viewport-fit=cover"><title>${projectName}</title></head>
+<body><div id="app"><!--app-html--></div><script type="module" src="/src/main.ts"></script></body></html>
+`,
+  )
+  write(
+    target,
+    'apps/uni-app/vite.config.ts',
+    `import { createKratosUniPlugin, defineConfig, kratosApp } from '@liujitcn/kratos-uni-app-core/vite'
+import { moduleManifest } from './src/module-manifest'
+export default defineConfig({
+  resolve: { preserveSymlinks: true },
+  plugins: [kratosApp({ modules: moduleManifest }), createKratosUniPlugin()],
+})
+`,
+  )
+  write(
+    target,
+    'tsconfig.json',
+    json({
+      extends: '@vue/tsconfig/tsconfig.json',
+      compilerOptions: {
+        allowJs: true,
+        moduleResolution: 'Bundler',
+        skipLibCheck: true,
+        types: ['@dcloudio/types', 'miniprogram-api-typings'],
+      },
+      include: ['apps/**/*.ts', 'apps/**/*.vue', 'packages/**/*.ts'],
+    }),
+  )
+  modules.forEach((name) => {
+    write(
+      target,
+      `packages/modules/${name}/package.json`,
+      json({
+        name: `@local/${name}`,
+        description: `Local Kratos uni-app module for ${name}.`,
+        version: '0.0.1',
+        type: 'module',
+        exports: {
+          '.': {
+            types: './src/index.d.mts',
+            import: './src/index.mjs',
+            default: './src/index.mjs',
+          },
+          './views/*': './src/views/*',
+          './package.json': './package.json',
+        },
+        dependencies: { '@liujitcn/kratos-uni-app-core': `^${publicPackageVersion}` },
+      }),
+    )
+    write(
+      target,
+      `packages/modules/${name}/README.md`,
+      `# @local/${name}
+
+\`@local/${name}\` 是 \`${projectName}\` workspace 内的本地业务模块，通过 \`@liujitcn/kratos-uni-app-core\` 的公开接口接入宿主。
+
+## 目录结构
+
+\`\`\`text
+packages/modules/${name}
+├── src
+│   ├── views               # 模块页面；页面私有组件放在就近 components
+│   ├── index.d.mts         # 模块入口类型
+│   └── index.mjs           # 页面、视图键和图标注册入口
+├── package.json            # 模块名称、依赖和 exports
+└── README.md               # 模块职责与维护说明
+\`\`\`
+
+## 开发约束
+
+- 页面放在 \`src/views\`，并在 \`src/index.mjs\` 的模块定义中登记页面和稳定视图键。
+- 请求、认证、导航和状态能力只通过 \`@liujitcn/kratos-uni-app-core\` 的公开 exports 使用。
+- 页面替换使用稳定视图键，接口不能直接下发任意组件路径。
+- 修改模块后从 workspace 根目录运行对应 H5 或微信小程序命令验证装配结果。
+`,
+    )
+    write(
+      target,
+      `packages/modules/${name}/src/index.mjs`,
+      `import { defineKratosAppModule } from '@liujitcn/kratos-uni-app-core/module'
+export default defineKratosAppModule({ name: '@local/${name}', pages: {}, views: {} })
+`,
+    )
+    write(
+      target,
+      `packages/modules/${name}/src/index.d.mts`,
+      `declare const module: import('@liujitcn/kratos-uni-app-core/module').KratosAppModule
+export default module
+`,
+    )
+  })
+  return target
+}
+
+function validateModuleName(name) {
+  if (!/^[a-z][a-z0-9-]*$/.test(name)) throw new Error(`模块名无效：${name}`)
+}
+
+function validatePackageName(name) {
+  if (!/^(?:@[a-z0-9-]+\/)?[a-z0-9-]+$/.test(name)) throw new Error(`包名无效：${name}`)
+}
+
+function write(root, file, content) {
+  const target = resolve(root, file)
+  mkdirSync(resolve(target, '..'), { recursive: true })
+  writeFileSync(target, content)
+}
+
+function json(value) {
+  return `${JSON.stringify(value, null, 2)}\n`
+}