create-librex 1.0.1

package/template/vite-plugin-librex.ts

@@ -0,0 +1,293 @@
+/**
+ * vite-plugin-librex — 编译期路由提取插件
+ *
+ * 编译期递归扫描 pages 目录，提取 definePageConfig({...}) 生成
+ * virtual:librex-routes 模块，零 import.meta.glob 运行时开销。
+ */
+import type { Plugin, ViteDevServer } from 'vite'
+import path from 'node:path'
+import fs from 'node:fs'
+
+const ROUTES_MODULE_ID = 'virtual:librex-routes'
+const RESOLVED_ROUTES_MODULE_ID = '\0' + ROUTES_MODULE_ID
+
+interface BrickRouteRecord {
+  path: string
+  name: string
+  title: string
+  icon: string
+  navGroup?: string
+  navOrder?: number
+  permissions: string[]
+  pageDir: string
+  /** pageConfig.ts 文件的绝对路径 */
+  configPath: string
+}
+
+export function vitePluginLibrex(): Plugin {
+  let pagesDir: string = ''
+  let brickRoutes: BrickRouteRecord[] = []
+
+  function scanPages(root: string): { brickRoutes: BrickRouteRecord[] } {
+    const dir = path.resolve(root, 'src/pages')
+    pagesDir = dir
+
+    if (!fs.existsSync(dir)) return { brickRoutes: [] }
+
+    const brickList: BrickRouteRecord[] = []
+
+    /** 递归扫描目录 */
+    function walk(currentDir: string, prefix: string) {
+      const entries = fs.readdirSync(currentDir, { withFileTypes: true })
+
+      const relativeDir = path.relative(dir, currentDir)
+      const pageConfigPath = path.join(currentDir, 'pageConfig.ts')
+
+      // ── pageConfig.ts → Brick 路由 ──
+      if (fs.existsSync(pageConfigPath)) {
+        const relDir = relativeDir.replace(/\\/g, '/')
+        if (!relDir.startsWith('_') && relDir !== 'notFound') {
+          try {
+            const raw = fs.readFileSync(pageConfigPath, 'utf-8')
+            const meta = extractPageConfigMeta(raw)
+            if (meta) {
+              const rawPath = meta.path || (prefix ? `/${prefix.replace(/\\/g, '/')}` : '/')
+              const routePath = rawPath.startsWith('/') ? rawPath : `/${rawPath}`
+              brickList.push({
+                path: routePath,
+                name: routePath.replace(/^\//, '').replace(/\/:?/g, '-'),
+                title: meta.title || path.basename(currentDir),
+                icon: meta.icon || 'file',
+                navGroup: meta.navGroup,
+                navOrder: meta.navOrder,
+                permissions: meta.permissions || [],
+                pageDir: relDir,
+                configPath: pageConfigPath,
+              })
+            }
+          } catch (e) {
+            console.error(`[vite-plugin-librex] 解析 pageConfig 失败: ${pageConfigPath}`, e)
+          }
+        }
+      }
+
+      // 递归子目录
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue
+        if (entry.name.startsWith('_')) continue
+        if (entry.name === 'notFound') continue
+        walk(path.join(currentDir, entry.name), prefix ? `${prefix}/${entry.name}` : entry.name)
+      }
+    }
+
+    walk(dir, '')
+
+    // 排序
+    brickList.sort((a, b) => (a.navOrder ?? 999) - (b.navOrder ?? 999))
+
+    // ── 自动分组 ──
+    autoGroupBrickRoutes(brickList)
+
+    return { brickRoutes: brickList }
+  }
+
+  /** Brick 路由自动分组 */
+  function autoGroupBrickRoutes(r: BrickRouteRecord[]) {
+    for (const route of r) {
+      const lastSlash = route.path.lastIndexOf('/')
+      if (lastSlash <= 0) continue
+      const parentPath = route.path.slice(0, lastSlash)
+      const parent = r.find(rr => rr.path === parentPath)
+      if (!parent) continue
+      const groupName = parent.navGroup || `${parent.icon} ${parent.title}`
+      if (!route.navGroup) route.navGroup = groupName
+      if (!parent.navGroup) parent.navGroup = groupName
+    }
+  }
+
+  function generateRoutesModule(brick: BrickRouteRecord[]): string {
+    const parts: string[] = [
+      '// Auto-generated by vite-plugin-librex — DO NOT EDIT',
+    ]
+
+    // ── Brick 路由 ──
+    parts.push('')
+    parts.push("import { PageContainer } from 'librex'")
+
+    const brickDefs: string[] = []
+    brick.forEach((route, i) => {
+      parts.push(`import __brick_cfg_${i} from '${toFsPath(route.configPath)}'`)
+
+      const metaFields: string[] = [
+        `title: '${escapeStr(route.title)}'`,
+        `icon: '${escapeStr(route.icon)}'`,
+        `pageConfig: __brick_cfg_${i}`,
+        `pageDir: '${escapeStr(route.pageDir)}'`,
+      ]
+      if (route.navGroup) metaFields.push(`navGroup: '${escapeStr(route.navGroup)}'`)
+      if (route.navOrder !== undefined) metaFields.push(`navOrder: ${route.navOrder}`)
+      metaFields.push(`permissions: ${JSON.stringify(route.permissions)}`)
+
+      brickDefs.push(`  { path: '${route.path}', name: '${route.name}', component: PageContainer, meta: { ${metaFields.join(', ')} } }`)
+    })
+
+    parts.push('')
+    parts.push('export const brickRoutes = [')
+    parts.push(brickDefs.join(',\n'))
+    parts.push(']')
+
+    return parts.join('\n')
+  }
+
+  return {
+    name: 'vite-plugin-librex',
+    enforce: 'pre',
+
+    configResolved(config) {
+      const result = scanPages(config.root)
+      brickRoutes = result.brickRoutes
+    },
+
+    resolveId(id) {
+      if (id === ROUTES_MODULE_ID) return RESOLVED_ROUTES_MODULE_ID
+    },
+
+    load(id) {
+      if (id === RESOLVED_ROUTES_MODULE_ID) {
+        return generateRoutesModule(brickRoutes)
+      }
+    },
+
+    configureServer(server: ViteDevServer) {
+      const watchPattern = pagesDir
+        ? path.join(pagesDir, '**/*.{vue,ts}')
+        : 'src/pages/**/*.{vue,ts}'
+
+      const onPageChange = (filePath: string) => {
+        if (!isPageFile(filePath)) return
+        const result = scanPages(server.config.root)
+        brickRoutes = result.brickRoutes
+        reloadVirtualModule(server)
+        server.ws.send({ type: 'full-reload' })
+      }
+
+      server.watcher.on('add', onPageChange)
+      server.watcher.on('change', onPageChange)
+      server.watcher.on('unlink', onPageChange)
+    },
+
+    buildStart() {
+      // routes 已在 configResolved 中初始化
+    },
+  }
+}
+
+function isPageFile(filePath: string): boolean {
+  const normalized = filePath.replace(/\\/g, '/')
+  return /\/pages\/(?!.*(?:\/|^)_)[^/]+(?:\/[^/]+)*\/(?:index\.vue|pageConfig\.ts)$/.test(normalized)
+}
+
+/** 从 .ts 文件中提取 definePageConfig({...}) 元数据 */
+function extractPageConfigMeta(raw: string): Record<string, any> | null {
+  const braced = extractBracedCall(raw, 'definePageConfig')
+  if (!braced) return null
+  const fields = ['title', 'path', 'icon', 'navGroup', 'navOrder', 'permissions']
+  const result = extractMetaFields(braced, fields)
+  return Object.keys(result).length > 0 ? result : null
+}
+
+/**
+ * 从对象字面量文本中提取顶层字段值（不支持嵌套 JSON 解析，仅元数据提取）
+ * 可处理包含 function 体 / 嵌套对象的 definePageConfig({...})。
+ */
+function extractMetaFields(raw: string, fields: string[]): Record<string, any> {
+  const result: Record<string, any> = {}
+  for (const field of fields) {
+    // 匹配 fieldName: value — value 可以是数组、字符串、数字、布尔
+     const patterns = [
+       new RegExp(`["']?${field}["']?\\s*:\\s*(\\[[^\\]]*\\])`, 'm'),   // 数组(先匹配)
+       new RegExp(`["']?${field}["']?\\s*:\\s*["']([^"']*)["']`, 'm'),  // 字符串
+       new RegExp(`["']?${field}["']?\\s*:\\s*(\\d+)`, 'm'),            // 数字
+       new RegExp(`["']?${field}["']?\\s*:\\s*(true|false)`, 'm'),      // 布尔
+     ]
+    for (const re of patterns) {
+      const m = raw.match(re)
+      if (m) {
+        const v = m[1]
+        if (v === 'true') result[field] = true
+        else if (v === 'false') result[field] = false
+        else if (/^\d+$/.test(v)) result[field] = Number(v)
+        else if (v.startsWith('[')) {
+          try { result[field] = JSON.parse(v.replace(/'/g, '"')) } catch (e) { result[field] = []; console.error(`[vite-plugin-librex] JSON.parse 数组字段 ${field} 失败:`, v, e) }
+        } else result[field] = v
+        break
+      }
+    }
+  }
+  return result
+}
+
+/**
+ * 从文本中匹配 defineXxx({...}) 调用并返回花括号内的内容。
+ * 用贪婪匹配 `[\s\S]*` 加括号计数，正确处理 `setPageHooks({...})` 等嵌套。
+ */
+function extractBracedCall(raw: string, fnName: string): string | null {
+  const re = new RegExp(fnName + '\\s*\\(\\s*(\\{)', 'm')
+  const match = raw.match(re)
+  if (!match || match.index === undefined) return null
+
+  let depth = 0
+  let start = match.index + match[0].length - 1 // position of the opening '{'
+  let end = -1
+  let inString: string | null = null
+  let inComment: '//' | '/*' | null = null
+
+  for (let i = start; i < raw.length; i++) {
+    const ch = raw[i]
+    const next = raw[i + 1] || ''
+
+    if (inComment === '//') {
+      if (ch === '\n') inComment = null
+      continue
+    }
+    if (inComment === '/*') {
+      if (ch === '*' && next === '/') inComment = null
+      continue
+    }
+    if (ch === '/' && next === '/') { inComment = '//'; continue }
+    if (ch === '/' && next === '*') { inComment = '/*'; continue }
+
+    if (inString) {
+      if (ch === '\\') { i++; continue } // escape
+      if (ch === inString) inString = null
+      continue
+    }
+    if (ch === "'" || ch === '"' || ch === '`') { inString = ch; continue }
+
+    if (ch === '{') depth++
+    else if (ch === '}') {
+      depth--
+      if (depth === 0) { end = i; break }
+    }
+  }
+
+  if (end === -1) return null
+  return raw.slice(start, end + 1)
+}
+
+function escapeStr(s: string): string {
+  return s.replace(/\\/g, '\\\\').replace(/'/g, "\\'")
+}
+
+function toFsPath(p: string): string {
+  const n = p.replace(/\\/g, '/')
+  return `/@fs${n.startsWith('/') ? '' : '/'}${n}`
+}
+
+function reloadVirtualModule(server: ViteDevServer) {
+  const mod = server.moduleGraph.getModuleById(RESOLVED_ROUTES_MODULE_ID)
+  if (mod) {
+    server.moduleGraph.invalidateModule(mod)
+    server.reloadModule(mod)
+  }
+}

package/template/vite.config.ts

@@ -0,0 +1,35 @@
+import { defineConfig, loadEnv } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import { fileURLToPath, URL } from 'node:url'
+import { vitePluginLibrex } from './vite-plugin-librex'
+
+export default defineConfig(({ mode }) => {
+  const env = loadEnv(mode, process.cwd(), '')
+  return {
+    server: {
+      proxy: {
+        '/api': {
+          target: env.VITE_PROXY_TARGET || 'http://localhost:3000',
+          changeOrigin: true,
+          secure: false,
+        },
+      },
+    },
+    plugins: [
+      vitePluginLibrex(),
+      vue(),
+    ],
+    resolve: {
+      alias: {
+        '@': fileURLToPath(new URL('./src', import.meta.url)),
+      },
+    },
+    css: {
+      preprocessorOptions: {
+        less: {
+          javascriptEnabled: true,
+        },
+      },
+    },
+  }
+})