@aiot-toolkit/aiotpack 2.0.6-beta.9 → 2.1.0-prender.1

package/lib/compiler/javascript/vela/plugin/WrapPlugin.js

@@ -5,81 +5,265 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.default = void 0;
 var _core = require("@rspack/core");
+var _TemplateCompiler = require("../../TemplateCompiler");
 var _webpackSources = require("webpack-sources");
+var _path = _interopRequireDefault(require("path"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 class WrapPlugin {
   constructor(compilerOption) {
     this.compilerOption = compilerOption;
   }
   apply(compiler) {
-    // 给入口文件加上包裹函数
     compiler.hooks.compilation.tap('WrapPlugin', compilation => {
       compilation.hooks.processAssets.tap({
         name: 'WrapPlugin',
         stage: _core.Compilation.PROCESS_ASSETS_STAGE_OPTIMIZE
-      }, () => {
-        this.wrap(compilation);
-      });
+      }, () => this.wrap(compilation));
     });
   }
+  getComponentName(entry) {
+    return _path.default.parse(entry).name;
+  }
+  findMatching(code, start, open, close) {
+    let depth = 0,
+      inStr = null,
+      esc = false;
+    for (let i = start; i < code.length; i++) {
+      const ch = code[i];
+      if (esc) {
+        esc = false;
+        continue;
+      }
+      if (ch === '\\') {
+        esc = true;
+        continue;
+      }
+      if (inStr) {
+        if (ch === inStr) inStr = null;
+        continue;
+      }
+      if (ch === '"' || ch === "'" || ch === '`') {
+        inStr = ch;
+        continue;
+      }
+      if (ch === open) depth++;else if (ch === close) {
+        depth--;
+        if (depth === 0) return i;
+      }
+    }
+    return -1;
+  }
+  /**
+   * Extract keyed modules from rspack's __webpack_modules__ object
+   */
+  extractModules(code) {
+    const idx = code.indexOf('var __webpack_modules__');
+    if (idx === -1) return [{
+      key: '',
+      body: code
+    }];
+    const braceIdx = code.indexOf('{', idx + 23);
+    let openIdx = code.indexOf('(', idx + 23);
+    if (openIdx === -1 || braceIdx !== -1 && braceIdx < openIdx) openIdx = braceIdx;
+    if (openIdx === -1) return [{
+      key: '',
+      body: code
+    }];
+    const closeIdx = code[openIdx] === '(' ? this.findMatching(code, openIdx, '(', ')') : this.findMatching(code, openIdx, '{', '}');
+    if (closeIdx === -1) return [{
+      key: '',
+      body: code
+    }];
+    const inner = code.slice(openIdx + 1, closeIdx);
+    const results = [];
+    let pos = 0;
+    while (pos < inner.length) {
+      const kStart = inner.indexOf('"', pos);
+      if (kStart === -1) break;
+      const kEnd = inner.indexOf('"', kStart + 1);
+      if (kEnd === -1) break;
+      const key = inner.slice(kStart + 1, kEnd);
+      pos = kEnd + 1;
+      const fIdx = inner.indexOf('function', pos);
+      if (fIdx === -1) break;
+      const bOpen = inner.indexOf('{', fIdx);
+      if (bOpen === -1) break;
+      const bClose = this.findMatching(inner, bOpen, '{', '}');
+      if (bClose === -1) break;
+      results.push({
+        key,
+        body: inner.slice(bOpen + 1, bClose).trim()
+      });
+      pos = bClose + 1;
+    }
+    return results.length > 0 ? results : [{
+      key: '',
+      body: code
+    }];
+  }
+  /**
+   * Clean a module body into blueos-pack format component block
+   */
+  buildBlock(body, defineId, styleId) {
+    let s = body;
+    // Remove ALL _interopRequireDefault function definitions FIRST (before unwrapping calls)
+    while (true) {
+      const iIdx = s.indexOf('function _interopRequireDefault');
+      if (iIdx === -1) break;
+      const bStart = s.indexOf('{', iIdx);
+      if (bStart === -1) break;
+      const bEnd = this.findMatching(s, bStart, '{', '}');
+      if (bEnd === -1) break;
+      s = s.slice(0, iIdx) + s.slice(bEnd + 1);
+    }
+    // Then unwrap _interopRequireDefault() calls
+    const interopVars = [];
+    s = s.replace(/_interopRequireDefault\(([^)]+)\)/g, (_, inner) => inner);
+    // Remove .default from interop vars
+    for (const v of interopVars) {
+      s = s.replace(new RegExp(`${v}\\.default\\.`, 'g'), `${v}.`);
+      s = s.replace(new RegExp(`${v}\\.default([^.]|$)`, 'g'), `${v}$1`);
+    }
+    // Remove boilerplate
+    // Replace $app_style$ array with @info reference using unique per-component name
+    const styleIdx = s.indexOf('var $app_style$');
+    if (styleIdx !== -1) {
+      const bi = s.indexOf('[', styleIdx);
+      if (bi !== -1) {
+        const be = this.findMatching(s, bi, '[', ']');
+        if (be !== -1) {
+          let se = s.indexOf(';', be);
+          if (se === -1) se = be;
+          // Remove the entire var $app_style$ line (we use $app_style$<id> instead)
+          s = s.slice(0, styleIdx) + s.slice(se + 1);
+        }
+      }
+    }
+    // Also remove any remaining var $app_style$ = {...} (already @info format)
+    s = s.replace(/var \$app_style\$\s*=[^;]*;\s*/g, '');
+    s = s.replace(/module\.exports[^;]*;\s*/g, '');
+    // Preserve $app_template$ for prerender (will be stripped after template.json is generated)
+    let templateCode = '';
+    const tplIdx = body.indexOf('var $app_template$');
+    if (tplIdx !== -1) {
+      const fnStart = body.indexOf('function', tplIdx);
+      if (fnStart !== -1) {
+        const braceStart = body.indexOf('{', fnStart);
+        if (braceStart !== -1) {
+          const braceEnd = this.findMatching(body, braceStart, '{', '}');
+          if (braceEnd !== -1) {
+            templateCode = body.slice(tplIdx, braceEnd + 1) + ';';
+          }
+        }
+      }
+    }
+    s = s.replace(/\$app_exports\$\[[^\]]*\][^;]*;\s*/g, '');
+    s = s.replace(/var \$app_exports\$[^;]*;\s*/g, '');
+    s = s.replace(/\$app_exports\$\.default[^;]*;\s*/g, '');
+    s = s.replace(/"use strict";\s*/g, '');
+    s = s.replace(/Object\.defineProperty\(exports,\s*"__esModule"[^;]*;\s*/g, '');
+    s = s.replace(/exports\["default"\]\s*=\s*void 0;\s*/g, '');
+    s = s.replace(/const moduleOwn[\s\S]*?}\s*}\s*}\s*/g, '');
+    s = s.replace(/var exports\s*=\s*module\.exports;\s*/g, '');
+    // Remove __webpack_require__ calls (including the var declaration if present)
+    s = s.replace(/(?:var|const|let)\s+\w+\s*=\s*__webpack_require__\([^)]*\);?\s*/g, '');
+    s = s.replace(/__webpack_require__\([^)]*\);?\s*/g, '');
+    // Extract component object
+    let obj = '{}';
+    const m = s.match(/(?:var _default\s*=\s*)?exports\["default"\]\s*=\s*(\{[\s\S]*\}|[\w.]+);?\s*$/);
+    if (m) {
+      obj = m[1];
+      s = s.slice(0, s.indexOf(m[0])).trim();
+    }
+    const lines = [`let $style$${styleId} = {"@info":{"styleObjectId":${styleId}}};`, `const $app_style$${styleId} = $style$${styleId};`, ...(s.trim() ? [s.trim()] : []), ...(templateCode ? [templateCode] : []), `const $app_script$${styleId} = ${obj};`, `$app_define$("${defineId}", [], function($app_require$, $app_exports$, $app_module$) {`, `  $app_module$.exports = $app_script$${styleId}.default || $app_script$${styleId};`, `  $app_module$.exports.style = $app_style$${styleId};`, ...(templateCode ? [`  $app_module$.exports.template = $app_template$;`] : []), `});`];
+    return lines.join('\n');
+  }
   wrap(compilation) {
-    const {
-      enableE2e
-    } = this.compilerOption;
-    // 获取入口文件
     const entrys = Object.keys(compilation.options.entry).map(item => `${item}.js`);
-    // 从chunk找到所有入口文件，添加包裹函数
     entrys.forEach(entry => {
-      if (compilation.assets[entry]) {
-        const source = compilation.assets[entry];
-        const isApp = entry === 'app.js';
-        const createFuncnName = isApp ? 'createAppHandler' : 'createPageHandler';
-        compilation.assets[entry] = new _webpackSources.ConcatSource(`export default function(global, globalThis, window, $app_exports$, $app_evaluate$){
-          var org_app_require = $app_require$;
-        
-          (function(global, globalThis, window, $app_exports$, $app_evaluate$){
-            var setTimeout = global.setTimeout;
-            var setInterval = global.setInterval;
-            var clearTimeout = global.clearTimeout;
-            var clearInterval = global.clearInterval;
-            var $app_require$ = global.$app_require$ || org_app_require
+      if (!compilation.assets[entry]) return;
+      const sourceCode = compilation.assets[entry].source().toString();
+      const isApp = entry === 'app.js';
+      const componentName = this.getComponentName(entry);
+      const bootstrapId = isApp ? '@app-application/app' : `@app-component/${componentName}`;
+      const modules = this.extractModules(sourceCode);
+      // Generate css.json from style arrays before buildBlock replaces them
+      const cssJsonData = {};
+      for (const mod of modules) {
+        const si = mod.body.indexOf('var $app_style$');
+        if (si === -1) continue;
+        const bi = mod.body.indexOf('[', si);
+        if (bi === -1) continue;
+        const be = this.findMatching(mod.body, bi, '[', ']');
+        if (be === -1) continue;
+        try {
+          const styleStr = mod.body.slice(bi, be + 1);
+          const sid = (0, _TemplateCompiler.getStyleObjectId)(mod.key || entry);
+          const cssObj = (0, _TemplateCompiler.parseStyleArray)(styleStr);
+          if (Object.keys(cssObj).length > 0) cssJsonData[String(sid)] = cssObj;
+        } catch {}
+      }
+      const cssJsonPath = entry.replace(/\.js$/, '.css.json');
+      compilation.assets[cssJsonPath] = new _webpackSources.RawSource(JSON.stringify(cssJsonData, null, 2));
+      // Emit component import map for template.json generation
+      const importMap = {};
+      for (const mod of modules) {
+        if (!mod.key.includes('?uxType=') && mod.key !== '' && mod.key.endsWith('.ux')) {
+          const entryM = modules.find(m => m.key.includes('?uxType=') || m.key === '');
+          const escaped = mod.key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+          const nm = entryM?.body.match(new RegExp(`\\$app_exports\\$\\['([^']+)'\\]\\s*=\\s*__webpack_require__\\([^)]*"${escaped}"\\)`));
+          const name = nm ? nm[1] : _path.default.parse(mod.key.replace(/\.ux$/, '')).name.toLowerCase();
+          // Convert "./src/components/Card.ux" to "components/Card"
+          const importPath = mod.key.replace(/^\.\/src\//, '').replace(/\.ux$/, '');
+          importMap[name] = importPath;
+        }
+      }
+      if (Object.keys(importMap).length > 0) {
+        const mapPath = entry.replace(/\.js$/, '.imports.json');
+        compilation.assets[mapPath] = new _webpackSources.RawSource(JSON.stringify(importMap));
+      }
+      const blocks = [];
+      // Find entry module to extract component name mappings
+      const entryMod = modules.find(m => m.key.includes('?uxType=') || m.key === '');
+      for (const mod of modules) {
+        // Check if this entry has non-.ux JS dependencies
+        const hasJsDeps = modules.some(m => m.key && !m.key.endsWith('.ux') && !m.key.includes('?uxType=') && m.key !== '' && !m.key.endsWith('.json'));
 
-            ${enableE2e ? `globalThis = undefined; \n global = typeof window === "undefined" ? global.__proto__  : window;` : ''}
-            var ${createFuncnName} = function() {
-              return `, source, `
-            }
-        
-            return ${createFuncnName}();
-          })(global, globalThis, window, $app_exports$, $app_evaluate$)
-        }`);
+        // If entry has JS dependencies, keep the full rspack output (don't decompose)
+        if (hasJsDeps && modules.length > 1) {
+          // Just wrap the entire rspack output with $app_define$/$app_bootstrap$
+          const styleId = (0, _TemplateCompiler.getStyleObjectId)(entry);
+          const defineId = isApp ? '@app-component/app' : `@app-component/${componentName}`;
+          blocks.push(`let $style$${styleId} = {"@info":{"styleObjectId":${styleId}}};`);
+          blocks.push(`const $app_style$${styleId} = $style$${styleId};`);
+          blocks.push(`$app_define$("${defineId}", [], function($app_require$, $app_exports$, $app_module$) {`);
+          blocks.push(`var exports = $app_module$.exports;`);
+          blocks.push(`var module = $app_module$;`);
+          blocks.push(sourceCode);
+          blocks.push(`$app_module$.exports.style = $app_style$${styleId};`);
+          blocks.push(`});`);
+          break;
+        }
+        // Non-.ux modules (utility JS files) are handled by webpack runtime above
+        if (mod.key && !mod.key.endsWith('.ux') && !mod.key.includes('?uxType=') && mod.key !== '') {
+          continue;
+        }
+        let compName;
+        if (mod.key.includes('?uxType=') || mod.key === '') {
+          compName = componentName;
+        } else {
+          // Find component name from: $app_exports$['name'] = __webpack_require__(/*...*/ "key")
+          const escaped = mod.key.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+          const nm = entryMod?.body.match(new RegExp(`\\$app_exports\\$\\['([^']+)'\\]\\s*=\\s*__webpack_require__\\([^)]*"${escaped}"\\)`));
+          compName = nm ? nm[1] : _path.default.parse(mod.key.replace(/\.ux$/, '')).name.toLowerCase();
+        }
+        const defineId = isApp && mod === entryMod ? '@app-component/app' : `@app-component/${compName}`;
+        const styleId = (0, _TemplateCompiler.getStyleObjectId)(mod.key || entry);
+        blocks.push(this.buildBlock(mod.body, defineId, styleId));
       }
+      blocks.push(`$app_bootstrap$("${bootstrapId}");`);
+      compilation.assets[entry] = new _webpackSources.RawSource(blocks.join('\n') + '\n');
     });
   }
-  translateStyleFunc() {
-    return `
-var $translateStyle$ = function (value) {
-  if (typeof value === 'string') {
-    return Object.fromEntries(
-      value
-        .split(';')
-        .filter((item) => Boolean(item && item.trim()))
-        .map((item) => {
-          const matchs = item.match(/([^:]+):(.*)/);
-          if (matchs && matchs.length > 2) {
-            return [
-              matchs[1]
-                .trim()
-                .replace(/-([a-z])/g, (_, match) => match.toUpperCase()),
-              matchs[2].trim(),
-            ];
-          }
-          return [];
-        })
-    );
-  }
-  return value;
-};
-global.$translateStyle$ = $translateStyle$
-`;
-  }
 }
 var _default = exports.default = WrapPlugin;

package/lib/compiler/javascript/vela/utils/UxCompileUtil.d.ts

@@ -1,4 +1,5 @@
 import { Dictionary } from '@aiot-toolkit/shared-utils';
+import IManifest from '../interface/IManifest';
 declare class UxCompileUtil {
     static readonly DIGEST_ZIP_DIR = "META-INF";
     static clean(dirList: string[]): void;
@@ -7,9 +8,9 @@ declare class UxCompileUtil {
      * @param config 项目配置文件的内容，应为json对象
      * @param codeDir 源码目录
      * @param projectPath 项目目录
-     * @returns {[入口名]:源文件路径}
+     * @returns `{[entryName]:entryPath}`
      */
-    static resolveEntries(config: any, codeDir: string, projectPath: string): Dictionary<string>;
+    static resolveEntries(config: IManifest, codeDir: string, projectPath: string): Dictionary<string>;
     /**
      * 通过无后缀的文件名路径获取存在的文件路径
      *

package/lib/compiler/javascript/vela/utils/UxCompileUtil.js

@@ -36,7 +36,7 @@ class UxCompileUtil {
    * @param config 项目配置文件的内容，应为json对象
    * @param codeDir 源码目录
    * @param projectPath 项目目录
-   * @returns {[入口名]:源文件路径}
+   * @returns `{[entryName]:entryPath}`
    */
   static resolveEntries(config, codeDir, projectPath) {
     const {
@@ -114,11 +114,10 @@ class UxCompileUtil {
     if (Array.isArray(services)) {
       services.forEach(item => {
         const {
-          name,
           path
         } = item;
-        if (name && path) {
-          result['services/' + name] = './src/' + path + `?uxType=${_EntryType.default.APP}`;
+        if (path) {
+          result[path] = './src/' + path + `?uxType=${_EntryType.default.APP}`;
         }
       });
     }
@@ -130,6 +129,15 @@ class UxCompileUtil {
         }
       }
     }
+    // 5. 添加 widget_provider
+    const {
+      widgetProvider
+    } = config;
+    if (widgetProvider?.length) {
+      for (const widgetItem of widgetProvider) {
+        result[widgetItem.path] = './src/' + widgetItem.path;
+      }
+    }
     return result;
   }
 

package/lib/compiler/javascript/vela/utils/VruUtil.d.ts

@@ -0,0 +1,50 @@
+/**
+ * VRU (Vela Union) file format utility.
+ *
+ * Pack/unpack a multi-file binary container used to bundle app resources
+ * inside a release RPK. Format is byte-compatible with vivo's VRU (only
+ * the magic differs: we use 'vela' instead of 'vivo').
+ * Layout:
+ *   0x00-0x0F: 'vela union file\0' (16 bytes magic)
+ *   0x10-0x3F: 48 bytes zero padding
+ *   0x40-0x43: entries-table size (uint32 LE) = header_end - 0xB0
+ *   0x44-0x47: total VRU file size (uint32 LE)
+ *   0x48-0xA7: package name (96 bytes, null-padded UTF-8)
+ *   0xA8-0xAB: 4 bytes zero padding
+ *   0xAC-0xAF: entry count (uint32 LE)
+ *   0xB0-...:  entries table, for each entry:
+ *                4 bytes: filename length (uint32 LE)
+ *                N bytes: filename (UTF-8)
+ *                4 bytes: data offset from start of file (uint32 LE)
+ *                4 bytes: data size (uint32 LE)
+ *   after entries: file data (concatenated in entry order)
+ */
+export interface VruEntry {
+    name: string;
+    data: Buffer;
+}
+export declare class VruUtil {
+    static readonly MAGIC = "vela union file";
+    static readonly PACKAGE_NAME_OFFSET = 72;
+    static readonly PACKAGE_NAME_SIZE = 96;
+    static readonly ENTRY_COUNT_OFFSET = 172;
+    static readonly ENTRIES_TABLE_OFFSET = 176;
+    /**
+     * Pack multiple files into a VRU buffer.
+     * @param entries Array of {name, data} pairs
+     * @param packageName Application package name (max 95 chars)
+     */
+    static pack(entries: VruEntry[], packageName: string): Buffer;
+    /**
+     * Get the VRU filename from a manifest package name.
+     */
+    static getVruName(packageName: string): string;
+    /**
+     * Parse a VRU buffer back into entries + package name.
+     * Useful for round-trip verification and reading existing VRU files.
+     */
+    static unpack(buf: Buffer): {
+        entries: VruEntry[];
+        packageName: string;
+    };
+}

package/lib/compiler/javascript/vela/utils/VruUtil.js

@@ -0,0 +1,128 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.VruUtil = void 0;
+/**
+ * VRU (Vela Union) file format utility.
+ *
+ * Pack/unpack a multi-file binary container used to bundle app resources
+ * inside a release RPK. Format is byte-compatible with vivo's VRU (only
+ * the magic differs: we use 'vela' instead of 'vivo').
+ * Layout:
+ *   0x00-0x0F: 'vela union file\0' (16 bytes magic)
+ *   0x10-0x3F: 48 bytes zero padding
+ *   0x40-0x43: entries-table size (uint32 LE) = header_end - 0xB0
+ *   0x44-0x47: total VRU file size (uint32 LE)
+ *   0x48-0xA7: package name (96 bytes, null-padded UTF-8)
+ *   0xA8-0xAB: 4 bytes zero padding
+ *   0xAC-0xAF: entry count (uint32 LE)
+ *   0xB0-...:  entries table, for each entry:
+ *                4 bytes: filename length (uint32 LE)
+ *                N bytes: filename (UTF-8)
+ *                4 bytes: data offset from start of file (uint32 LE)
+ *                4 bytes: data size (uint32 LE)
+ *   after entries: file data (concatenated in entry order)
+ */
+
+class VruUtil {
+  static MAGIC = 'vela union file';
+  static PACKAGE_NAME_OFFSET = 0x48;
+  static PACKAGE_NAME_SIZE = 96;
+  static ENTRY_COUNT_OFFSET = 0xAC;
+  static ENTRIES_TABLE_OFFSET = 0xB0;
+
+  /**
+   * Pack multiple files into a VRU buffer.
+   * @param entries Array of {name, data} pairs
+   * @param packageName Application package name (max 95 chars)
+   */
+  static pack(entries, packageName) {
+    if (Buffer.byteLength(packageName, 'utf-8') >= VruUtil.PACKAGE_NAME_SIZE) {
+      throw new Error(`Package name too long: ${packageName}`);
+    }
+
+    // Compute table size
+    let tableSize = 0;
+    for (const e of entries) {
+      tableSize += 4 + Buffer.byteLength(e.name, 'utf-8') + 8;
+    }
+    const headerEnd = VruUtil.ENTRIES_TABLE_OFFSET + tableSize;
+
+    // Compute total size
+    let totalSize = headerEnd;
+    for (const e of entries) totalSize += e.data.length;
+    const buf = Buffer.alloc(totalSize);
+    // Magic
+    buf.write(VruUtil.MAGIC, 0, 'utf-8');
+    // 0x40: entries-table size (header_end - 0xB0)
+    buf.writeUInt32LE(tableSize, 0x40);
+    // 0x44: total file size
+    buf.writeUInt32LE(totalSize, 0x44);
+    // 0x48: package name (null-padded)
+    buf.write(packageName, VruUtil.PACKAGE_NAME_OFFSET, 'utf-8');
+    // 0xAC: entry count
+    buf.writeUInt32LE(entries.length, VruUtil.ENTRY_COUNT_OFFSET);
+
+    // Write entries table and accumulate data offsets
+    let entryOffset = VruUtil.ENTRIES_TABLE_OFFSET;
+    let dataOffset = headerEnd;
+    for (const e of entries) {
+      const nameBuf = Buffer.from(e.name, 'utf-8');
+      buf.writeUInt32LE(nameBuf.length, entryOffset);
+      entryOffset += 4;
+      nameBuf.copy(buf, entryOffset);
+      entryOffset += nameBuf.length;
+      buf.writeUInt32LE(dataOffset, entryOffset);
+      entryOffset += 4;
+      buf.writeUInt32LE(e.data.length, entryOffset);
+      entryOffset += 4;
+      e.data.copy(buf, dataOffset);
+      dataOffset += e.data.length;
+    }
+    return buf;
+  }
+
+  /**
+   * Get the VRU filename from a manifest package name.
+   */
+  static getVruName(packageName) {
+    return `${packageName}.vru`;
+  }
+
+  /**
+   * Parse a VRU buffer back into entries + package name.
+   * Useful for round-trip verification and reading existing VRU files.
+   */
+  static unpack(buf) {
+    const magic = buf.slice(0, VruUtil.MAGIC.length).toString('utf-8');
+    if (magic !== VruUtil.MAGIC) {
+      throw new Error(`Invalid VRU magic: expected "${VruUtil.MAGIC}", got "${magic}"`);
+    }
+    const pkgEnd = buf.indexOf(0, VruUtil.PACKAGE_NAME_OFFSET);
+    const packageName = buf.slice(VruUtil.PACKAGE_NAME_OFFSET, pkgEnd >= 0 ? pkgEnd : VruUtil.PACKAGE_NAME_OFFSET + VruUtil.PACKAGE_NAME_SIZE).toString('utf-8');
+    const count = buf.readUInt32LE(VruUtil.ENTRY_COUNT_OFFSET);
+    const entries = [];
+    let offset = VruUtil.ENTRIES_TABLE_OFFSET;
+    for (let i = 0; i < count; i++) {
+      const nameLen = buf.readUInt32LE(offset);
+      offset += 4;
+      const name = buf.slice(offset, offset + nameLen).toString('utf-8');
+      offset += nameLen;
+      const dataOffset = buf.readUInt32LE(offset);
+      offset += 4;
+      const dataSize = buf.readUInt32LE(offset);
+      offset += 4;
+      entries.push({
+        name,
+        data: Buffer.from(buf.slice(dataOffset, dataOffset + dataSize))
+      });
+    }
+    return {
+      entries,
+      packageName
+    };
+  }
+}
+exports.VruUtil = VruUtil;

package/lib/compiler/javascript/vela/utils/ZipUtil.d.ts

@@ -32,6 +32,15 @@ declare class ZipUtil {
      * @returns 生成的 rpk 文件名
      */
     static createRpk(dist: string, param: IJavascriptCompileOption): Promise<string | undefined>;
+    /**
+     * Build the blueos-pack compatible "wrapped release" RPK.
+     * Outer RPK (zip) contains:
+     *   - manifest.json (top-level metadata)
+     *   - logo.<ext> (icon - kept as png since VUG conversion is out of scope)
+     *   - META-INF/CERT (signature)
+     *   - <package>.vru (multi-file VRU containing all build artifacts)
+     */
+    private static createWrappedReleaseRpk;
     private static getFileName;
     private static packageToZipBuffer;
     /**