@quicktvui/web-cli 1.0.8 → 2.1.0

package/lib/HotReloader.js

@@ -0,0 +1,142 @@
+/**
+ * HotReloader - 基于 SSE 的热更新管理
+ *
+ * 职责：
+ *   1. 管理 SSE 客户端连接
+ *   2. 接收文件变化事件，推送更新通知
+ *   3. 支持 full-reload 和 bundle-update 两种更新模式
+ */
+
+const signale = require('signale')
+
+class HotReloader {
+  constructor() {
+    this.clients = new Set()
+    this.lastEventType = null
+    this.lastEventData = null
+  }
+
+  /**
+   * 处理 SSE 连接请求
+   */
+  handleSSE(req, res) {
+    res.writeHead(200, {
+      'Content-Type': 'text/event-stream',
+      'Cache-Control': 'no-cache',
+      Connection: 'keep-alive',
+      'Access-Control-Allow-Origin': '*',
+    })
+
+    // 发送初始连接成功消息
+    res.write(`data: ${JSON.stringify({ type: 'connected', timestamp: Date.now() })}\n\n`)
+
+    // 如果有最近的事件，立即发送
+    if (this.lastEventType) {
+      res.write(`data: ${JSON.stringify({ type: this.lastEventType, ...this.lastEventData })}\n\n`)
+    }
+
+    this.clients.add(res)
+
+    // 心跳保活
+    const heartbeat = setInterval(() => {
+      res.write(`:heartbeat\n\n`)
+    }, 15000)
+
+    req.on('close', () => {
+      clearInterval(heartbeat)
+      this.clients.delete(res)
+    })
+  }
+
+  /**
+   * 通知所有客户端 bundle 更新
+   */
+  notifyBundleUpdate(data = {}) {
+    const event = {
+      type: 'bundle-update',
+      timestamp: Date.now(),
+      ...data,
+    }
+
+    this.lastEventType = 'bundle-update'
+    this.lastEventData = data
+
+    this._broadcast(event)
+    signale.info(`[HotReloader] 通知 ${this.clients.size} 个客户端: bundle-update`)
+  }
+
+  /**
+   * 通知所有客户端整页刷新
+   */
+  notifyFullReload(reason = 'file changed') {
+    const event = {
+      type: 'full-reload',
+      timestamp: Date.now(),
+      reason,
+    }
+
+    this.lastEventType = 'full-reload'
+    this.lastEventData = { reason }
+
+    this._broadcast(event)
+    signale.info(`[HotReloader] 通知 ${this.clients.size} 个客户端: full-reload`)
+  }
+
+  /**
+   * 通知构建状态变化
+   */
+  notifyBuildStatus(status, message = '') {
+    const event = {
+      type: 'build-status',
+      status,
+      message,
+      timestamp: Date.now(),
+    }
+
+    this._broadcast(event)
+  }
+
+  /**
+   * 广播事件到所有客户端
+   */
+  _broadcast(event) {
+    const data = `data: ${JSON.stringify(event)}\n\n`
+    const disconnected = []
+
+    for (const client of this.clients) {
+      try {
+        client.write(data)
+      } catch (e) {
+        disconnected.push(client)
+      }
+    }
+
+    // 清理断开的连接
+    for (const client of disconnected) {
+      this.clients.delete(client)
+    }
+  }
+
+  /**
+   * 获取当前连接数
+   */
+  getClientCount() {
+    return this.clients.size
+  }
+
+  /**
+   * 关闭所有连接
+   */
+  close() {
+    for (const client of this.clients) {
+      try {
+        client.end()
+      } catch (e) {
+        // 忽略关闭错误
+      }
+    }
+    this.clients.clear()
+  }
+}
+
+module.exports = HotReloader

package/lib/index.js

@@ -1,5 +1,5 @@
 /**
- * QuickTVUI Web CLI
+ * QuickTVUI Web CLI v2
  * 主入口 - 提供编程接口
  */
 
@@ -23,144 +23,74 @@ function findProjectRoot(startDir = process.cwd()) {
 }
 
 /**
- * 检测 web renderer 类型
+ * 检测项目的 dev 脚本
  */
-function detectWebRendererType(projectRoot) {
-  if (fs.existsSync(path.join(projectRoot, 'src/web/index.js'))) {
-    return 'local'
-  }
-  try {
-    const projectPkg = require(path.join(projectRoot, 'package.json'))
-    const deps = { ...projectPkg?.dependencies, ...projectPkg?.devDependencies }
-    if (deps['@quicktvui/web-renderer']) {
-      return 'package'
+function detectDevScript(pkg, scriptName) {
+  const scripts = pkg.scripts || {}
+  const candidates = [scriptName, 'dev', 'dev:android', 'build:dev']
+  for (const name of candidates) {
+    if (name && scripts[name]) {
+      return { name, script: scripts[name] }
     }
-  } catch (e) {}
-  return 'package'
+  }
+  return null
 }
 
 /**
- * 生成 web 入口内容
+ * 检测 dist/dev 目录下的 bundle 入口
  */
-function generateWebEntryContent(projectRoot, mainEntry) {
-  const mainPath =
-    './' + path.relative(projectRoot, path.resolve(projectRoot, mainEntry)).replace(/\\/g, '/')
-  const type = detectWebRendererType(projectRoot)
-
-  if (type === 'local') {
-    return getLocalEntryContent(mainPath)
+function detectDevBundle(projectRoot) {
+  const distDir = path.join(projectRoot, 'dist', 'dev')
+  if (!fs.existsSync(distDir)) return null
+
+  // 优先查找 index.bundle (v2 dev 模式)
+  const indexPath = path.join(distDir, 'index.bundle')
+  if (fs.existsSync(indexPath)) {
+    const stat = fs.statSync(indexPath)
+    return {
+      entry: 'index.bundle',
+      path: indexPath,
+      size: stat.size,
+      urlPath: '/dist/dev/index.bundle',
+    }
   }
-  return getPackageEntryContent(mainPath)
-}
-
-function getLocalEntryContent(mainPath) {
-  return `// @quicktvui/web-cli - auto-generated entry (local)
-console.log('[Web Renderer] === Starting initialization ===')
-
-import { initAsyncLocalStorage } from '../src/web/core/asyncLocalStorage'
-initAsyncLocalStorage()
-
-import { initAutoProxy } from '../src/web/core/autoProxy'
-initAutoProxy()
-
-global.__WEB_COMPONENTS__ = global.__WEB_COMPONENTS__ || {}
-
-import { setupSceneBuilder } from '../src/web/core/SceneBuilder'
-setupSceneBuilder()
-
-import { createWebEngine, startWebEngine, APP_NAME } from '../src/web'
-const engine = createWebEngine()
-
-import { applyAllPatches } from '../src/web/core/patches'
-applyAllPatches(engine)
-
-import { TVFocusManager } from '../src/web/core/TVFocusManager'
-const focusManager = new TVFocusManager()
-global.__TV_FOCUS_MANAGER__ = focusManager
-
-setupAppRegisterProxy()
-
-console.log('[Web Renderer] Importing main module...')
-import '${mainPath}'
 
-console.log('[Web Renderer] Starting engine...')
-startWebEngine(engine, APP_NAME)
-console.log('[Web Renderer] === Initialization complete ===')
-
-function setupAppRegisterProxy() {
-  global.__GLOBAL__ = global.__GLOBAL__ || {}
-  const appRegister = {}
-  let lifecycleDone = false
-  global.__GLOBAL__.appRegister = new Proxy(appRegister, {
-    set(t, name, entry) {
-      const run = entry.run
-      if (typeof run === 'function') {
-        entry.run = function(p) {
-          const r = run.call(this, normalize(p))
-          setupLifecycle()
-          return r
-        }
-      }
-      t[name] = entry
-      return true
-    },
-    get(t, p) { return t[p] }
-  })
-}
-
-function normalize(p) {
-  if (!p) return p
-  const r = { ...p }
-  if (r.location) {
-    if (typeof r.location === 'string') {
-      if (r.location !== '/') r.path = r.location
-      delete r.location
-    } else if (typeof r.location === 'object') {
-      if (r.location.name) r.name = r.location.name
-      else if (r.location.path) r.path = r.location.path
-      delete r.location
+  // 兼容 index.android.js (v1 模式)
+  const androidPath = path.join(distDir, 'index.android.js')
+  if (fs.existsSync(androidPath)) {
+    const stat = fs.statSync(androidPath)
+    return {
+      entry: 'index.android.js',
+      path: androidPath,
+      size: stat.size,
+      urlPath: '/dist/dev/index.android.js',
     }
   }
-  return r
-}
 
-function setupLifecycle() {
-  if (lifecycleDone) return
-  lifecycleDone = true
-  setTimeout(() => {
-    const app = document.getElementById('root')?.__vue_app__ || document.getElementById('app')?.__vue_app__
-    const router = app?.config?.globalProperties?.$router
-    if (router) {
-      global.__ES_ROUTER__ = router
-      if (router.options?.main && !router.options?.routes?.some(r => r.path === '/')) {
-        router.addRoute({ path: '/', redirect: { name: router.options.main } })
-      }
-    }
-  }, 150)
-}
-`
+  return null
 }
 
-function getPackageEntryContent(mainPath) {
-  return `// @quicktvui/web-cli - auto-generated entry (package)
-console.log('[Web Renderer] === Starting initialization ===')
-
-import { initWebRenderer, startWebRenderer } from '@quicktvui/web-renderer'
-
-initWebRenderer()
-
-console.log('[Web Renderer] Importing main module...')
-import '${mainPath}'
-
-console.log('[Web Renderer] Starting engine...')
-startWebRenderer()
-console.log('[Web Renderer] === Initialization complete ===')
-`
+/**
+ * 检测 web renderer 类型（v1 兼容）
+ */
+function detectWebRendererType(projectRoot) {
+  if (fs.existsSync(path.join(projectRoot, 'src/web/index.js'))) {
+    return 'local'
+  }
+  try {
+    const projectPkg = require(path.join(projectRoot, 'package.json'))
+    const deps = { ...projectPkg?.dependencies, ...projectPkg?.devDependencies }
+    if (deps['@quicktvui/web-renderer']) {
+      return 'package'
+    }
+  } catch (e) {}
+  return 'package'
 }
 
 module.exports = {
   version: pkg.version,
   findProjectRoot,
+  detectDevScript,
+  detectDevBundle,
   detectWebRendererType,
-  generateWebEntryContent,
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@quicktvui/web-cli",
-  "version": "1.0.8",
-  "description": "CLI tool for QuickTVUI web development - zero configuration",
+  "version": "2.1.0",
+  "description": "CLI tool for QuickTVUI web development v2 - delegate build & bundle loading",
   "author": "QuickTVUI Team",
   "license": "Apache-2.0",
   "bin": {
@@ -21,28 +21,51 @@
     "hippy"
   ],
   "dependencies": {
+    "chokidar": "^3.5.3",
     "minimist": "^1.2.8",
     "shelljs": "^0.10.0",
-    "signale": "^1.4.0",
-    "webpack-merge": "^6.0.0",
-    "@quicktvui/web-renderer": "^1.0.26",
-    "scope-loader": "^1.0.3",
-    "chokidar": "^3.5.3",
-    "rimraf": "^5.0.0"
+    "signale": "^1.4.0"
   },
   "peerDependencies": {
-    "webpack": "^5.89.0",
-    "webpack-cli": "^5.1.0",
-    "webpack-dev-server": "^4.15.0",
-    "vue-loader": "^17.0.0",
-    "html-webpack-plugin": "^5.5.0",
-    "@babel/core": "^7.23.0",
-    "babel-loader": "^9.1.0",
-    "ts-loader": "^9.4.0",
-    "vue": "^3.0.0",
-    "regenerator-runtime": "^0.14.0"
+    "vue": "^3.0.0"
   },
   "peerDependenciesMeta": {
+    "webpack": {
+      "optional": true
+    },
+    "webpack-cli": {
+      "optional": true
+    },
+    "webpack-dev-server": {
+      "optional": true
+    },
+    "vue-loader": {
+      "optional": true
+    },
+    "html-webpack-plugin": {
+      "optional": true
+    },
+    "@babel/core": {
+      "optional": true
+    },
+    "babel-loader": {
+      "optional": true
+    },
+    "ts-loader": {
+      "optional": true
+    },
+    "regenerator-runtime": {
+      "optional": true
+    },
+    "webpack-merge": {
+      "optional": true
+    },
+    "@quicktvui/web-renderer": {
+      "optional": true
+    },
+    "scope-loader": {
+      "optional": true
+    },
     "less-loader": {
       "optional": true
     },
@@ -59,4 +82,4 @@
   "engines": {
     "node": ">=16.0.0"
   }
-}
+}