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

package/lib/prerender/index.js

@@ -0,0 +1,519 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "PrerenderVM", {
+  enumerable: true,
+  get: function () {
+    return _PrerenderVM.default;
+  }
+});
+Object.defineProperty(exports, "TemplateSerializer", {
+  enumerable: true,
+  get: function () {
+    return _TemplateSerializer.default;
+  }
+});
+exports.prerender = prerender;
+exports.watchChange = watchChange;
+var _fsExtra = _interopRequireDefault(require("fs-extra"));
+var _path = _interopRequireDefault(require("path"));
+var _sharedUtils = require("@aiot-toolkit/shared-utils");
+var _PrerenderVM = _interopRequireDefault(require("./PrerenderVM"));
+var _TemplateSerializer = _interopRequireDefault(require("./TemplateSerializer"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/** Cache: deviceType -> entryKey -> true (avoids re-prerendering same page per device) */
+let prerenderEntryKeyCache = {};
+/** Cache: resourcePath$$name -> true (avoids re-prerendering same component) */
+let preRenderCache = {};
+/** Cache: page path -> true (tracks pages whose css.json has been written) */
+let cssCache = {};
+
+/**
+ * Skip rules: app and services should not be prerendered
+ */
+function shouldSkip(name) {
+  return name === 'app' || name === 'services';
+}
+
+/**
+ * Recursively find and prerender sub-components (import nodes).
+ * Tracks ancestors to detect circular dependencies.
+ */
+function processSubComponents(node, buildPath, sourcePath, deviceType, prerenderSubComp, vm, serializer, onLog, ancestors) {
+  if (!prerenderSubComp) return;
+  if (node.import) {
+    const compPath = node.import;
+    const cacheKey = `${buildPath}$$${compPath}`;
+    if (!preRenderCache[cacheKey]) {
+      prerenderPage(compPath, buildPath, sourcePath, deviceType, prerenderSubComp, vm, serializer, onLog, ancestors);
+    }
+  }
+  if (node.children) {
+    for (const child of node.children) {
+      processSubComponents(child, buildPath, sourcePath, deviceType, prerenderSubComp, vm, serializer, onLog, ancestors);
+    }
+  }
+}
+
+/**
+ * Prerender a single page/component entry.
+ * @param ancestors - Set of ancestor component paths for circular dependency detection
+ */
+function prerenderPage(page, buildPath, sourcePath, deviceType, prerenderSubComp, vm, serializer, onLog, ancestors) {
+  // Skip app and services
+  const name = page.split('/')[0];
+  if (shouldSkip(name)) return;
+
+  // Circular dependency detection
+  if (ancestors?.has(page)) {
+    onLog?.([{
+      level: _sharedUtils.Loglevel.WARN,
+      message: [`prerender: circular dependency detected for ${page}, skip`]
+    }]);
+    return;
+  }
+
+  // Check component-level cache
+  const cacheKey = `${buildPath}$$${page}`;
+  if (preRenderCache[cacheKey]) return;
+  preRenderCache[cacheKey] = true;
+
+  // Check device-level entry cache
+  if (!prerenderEntryKeyCache[deviceType]) {
+    prerenderEntryKeyCache[deviceType] = {};
+  }
+  if (prerenderEntryKeyCache[deviceType][page]) return;
+  prerenderEntryKeyCache[deviceType][page] = true;
+
+  // Load sub-component JS
+  const jsPath = _path.default.join(buildPath, `${page}.js`);
+  if (!_fsExtra.default.existsSync(jsPath)) {
+    onLog?.([{
+      level: _sharedUtils.Loglevel.WARN,
+      message: [`prerender: ${jsPath} not found, skip`]
+    }]);
+    return;
+  }
+  const jsCode = _fsExtra.default.readFileSync(jsPath, 'utf-8');
+  const {
+    tree,
+    styles
+  } = vm.execute(jsCode, onLog);
+  if (!tree) {
+    onLog?.([{
+      level: _sharedUtils.Loglevel.WARN,
+      message: [`prerender: failed to render ${page}, skip`]
+    }]);
+    return;
+  }
+
+  // Build css.json
+  const styleIds = Object.keys(styles).map(Number);
+  const mainStyleId = tree.styleObjectId ?? styleIds[styleIds.length - 1];
+  let cssJson = serializer.serializeCss(styles);
+
+  // Fix css.json keys: replace default "0" with actual styleObjectId from JS
+  const styleIdMatches = [...jsCode.matchAll(/let \$style\$(\d+)/g)];
+  if (styleIdMatches.length > 0 && cssJson['0']) {
+    const fixedCss = {};
+    const cssKeys = Object.keys(cssJson);
+    for (let i = 0; i < cssKeys.length; i++) {
+      const newId = styleIdMatches[i] ? styleIdMatches[i][1] : cssKeys[i];
+      fixedCss[newId] = cssJson[cssKeys[i]];
+    }
+    cssJson = fixedCss;
+  }
+
+  // Merge all styleSheets for class -> style resolution
+  // Use css.json (generated by WrapPlugin) which has the actual style data
+  const mergedSheet = {};
+  const pageCssPath = _path.default.join(_path.default.dirname(jsPath), `${_path.default.basename(page)}.css.json`);
+  if (_fsExtra.default.existsSync(pageCssPath)) {
+    const cssData = _fsExtra.default.readJSONSync(pageCssPath);
+    for (const sheet of Object.values(cssData)) {
+      if (sheet && typeof sheet === 'object') {
+        Object.assign(mergedSheet, sheet);
+      }
+    }
+  } else {
+    for (const sheet of Object.values(styles)) {
+      Object.assign(mergedSheet, sheet);
+    }
+  }
+
+  // Serialize template.json
+  const templateJson = serializer.serializeTemplate(tree, mergedSheet, mainStyleId);
+
+  // Add import paths to custom component nodes
+  const importsPath = jsPath.replace(/\.js$/, '.imports.json');
+  let importMap = {};
+  if (_fsExtra.default.existsSync(importsPath)) {
+    importMap = _fsExtra.default.readJSONSync(importsPath);
+    addImportPaths(templateJson, importMap);
+    _fsExtra.default.removeSync(importsPath); // Clean up the temp file
+  }
+
+  // Write files
+  const dir = _path.default.dirname(jsPath);
+  const baseName = _path.default.basename(page);
+  const templatePath = _path.default.join(dir, `${baseName}.template.json`);
+  const cssPath = _path.default.join(dir, `${baseName}.css.json`);
+  _fsExtra.default.ensureDirSync(dir);
+  _fsExtra.default.writeJSONSync(templatePath, templateJson, {
+    spaces: 2
+  });
+  // Only write css.json if it doesn't already have content (WrapPlugin may have generated it)
+  if (!_fsExtra.default.existsSync(cssPath) || _fsExtra.default.readFileSync(cssPath, 'utf-8').trim() === '{}') {
+    _fsExtra.default.writeJSONSync(cssPath, cssJson, {
+      spaces: 2
+    });
+  }
+  cssCache[page] = true;
+
+  // Generate template.json for sub-components from VM's component registry
+  for (const [compName, compImportPath] of Object.entries(importMap)) {
+    const compTemplatePath = _path.default.join(buildPath, `${compImportPath}.template.json`);
+    if (_fsExtra.default.existsSync(compTemplatePath)) continue;
+
+    // Get sub-component templates from the VM (they were registered during $app_define$ execution)
+    const subTemplates = vm.getSubComponentTemplates();
+    const compDefineId = `@app-component/${compName}`;
+    const subData = subTemplates.get(compDefineId);
+    if (subData?.tree) {
+      // Get the correct styleObjectId from the css.json (matches the JS $style$<id>)
+      const cssJsonContent = _fsExtra.default.existsSync(cssPath) ? _fsExtra.default.readJSONSync(cssPath) : cssJson;
+      const cssKeys = Object.keys(cssJsonContent).map(Number);
+      // The sub-component's styleObjectId is the one that's NOT the main page's
+      const subStyleId = cssKeys.find(k => k !== mainStyleId) || cssKeys[0] || 0;
+      const subMergedSheet = {};
+      if (cssJsonContent[String(subStyleId)]) {
+        Object.assign(subMergedSheet, cssJsonContent[String(subStyleId)]);
+      }
+      const subTemplateJson = serializer.serializeTemplate(subData.tree, subMergedSheet, subStyleId);
+      _fsExtra.default.ensureDirSync(_path.default.dirname(compTemplatePath));
+      _fsExtra.default.writeJSONSync(compTemplatePath, subTemplateJson, {
+        spaces: 2
+      });
+    }
+  }
+  onLog?.([{
+    level: _sharedUtils.Loglevel.SUCCESS,
+    message: [`prerender: ${page} -> template.json + css.json`]
+  }]);
+
+  // Recursively prerender sub-components
+  const nextAncestors = new Set(ancestors);
+  nextAncestors.add(page);
+  processSubComponents(tree, buildPath, sourcePath, deviceType, prerenderSubComp, vm, serializer, onLog, nextAncestors);
+}
+
+/**
+ * 预渲染 app.ux 的全局样式，生成 app.css.json
+ * app.ux 只有样式没有模板，因此只需提取 styles 并写入 css.json
+ */
+function prerenderAppCss(buildPath, vm, serializer, onLog) {
+  const appJsPath = _path.default.join(buildPath, 'app.js');
+  if (!_fsExtra.default.existsSync(appJsPath)) return;
+  const jsCode = _fsExtra.default.readFileSync(appJsPath, 'utf-8');
+  const {
+    styles
+  } = vm.execute(jsCode, onLog);
+  const styleIds = Object.keys(styles);
+  if (!styleIds.length) return;
+  let cssJson = serializer.serializeCss(styles);
+
+  // Fix css.json keys: replace default "0" with actual styleObjectId from JS
+  const styleIdMatch = jsCode.match(/let \$style\$(\d+)/);
+  if (styleIdMatch && cssJson['0']) {
+    cssJson = {
+      [styleIdMatch[1]]: cssJson['0']
+    };
+  }
+  const cssPath = _path.default.join(buildPath, 'app.css.json');
+  // Only write if not already generated by WrapPlugin
+  if (!_fsExtra.default.existsSync(cssPath) || _fsExtra.default.readFileSync(cssPath, 'utf-8').trim() === '{}') {
+    _fsExtra.default.writeJSONSync(cssPath, cssJson, {
+      spaces: 2
+    });
+  }
+
+  // Strip style array from app.js (replace with @info reference)
+  stripStyleFromFile(appJsPath);
+  onLog?.([{
+    level: _sharedUtils.Loglevel.SUCCESS,
+    message: ['prerender: app -> app.css.json']
+  }]);
+}
+
+/**
+ * 预渲染入口
+ *
+ * 读取编译后的 JS 产物，在 VM 沙箱中执行模板函数，
+ * 将静态 DOM 结构序列化为 .template.json + .css.json
+ * 支持子组件递归预渲染和多级缓存
+ */
+async function prerender(option, onLog) {
+  const {
+    buildPath,
+    sourcePath,
+    pages,
+    prerenderSubComp = true,
+    deviceTypes
+  } = option;
+  const vm = new _PrerenderVM.default();
+  const serializer = new _TemplateSerializer.default();
+  const types = deviceTypes?.length ? deviceTypes : ['default'];
+  for (const deviceType of types) {
+    for (const page of pages) {
+      prerenderPage(page, buildPath, sourcePath, deviceType, prerenderSubComp, vm, serializer, onLog, new Set());
+    }
+  }
+
+  // Generate app.css.json for global styles defined in app.ux
+  prerenderAppCss(buildPath, vm, serializer, onLog);
+
+  // Strip $app_template$ from JS files (template is now in template.json)
+  stripTemplatesFromJs(buildPath, pages, onLog);
+}
+
+/**
+ * Remove $app_template$ variable and module.exports.template assignment from JS files.
+ * After prerender generates template.json, the template function is no longer needed in JS.
+ */
+function stripTemplatesFromJs(buildPath, pages, onLog) {
+  for (const page of pages) {
+    const jsPath = _path.default.join(buildPath, `${page}.js`);
+    if (!_fsExtra.default.existsSync(jsPath)) continue;
+
+    // Only strip if template.json was generated for this page
+    const templateJsonPath = _path.default.join(_path.default.dirname(jsPath), `${_path.default.basename(page)}.template.json`);
+    if (!_fsExtra.default.existsSync(templateJsonPath)) continue;
+    let code = _fsExtra.default.readFileSync(jsPath, 'utf-8');
+    let modified = false;
+
+    // Remove all occurrences of: var $app_template$ = function(vm) { ... };
+    while (true) {
+      const templateStart = code.indexOf('var $app_template$');
+      if (templateStart === -1) break;
+      let end = templateStart;
+      let depth = 0;
+      let started = false;
+      for (let i = templateStart; i < code.length; i++) {
+        if (code[i] === '{') {
+          depth++;
+          started = true;
+        } else if (code[i] === '}') {
+          depth--;
+        }
+        if (started && depth === 0) {
+          end = code.indexOf(';', i);
+          if (end === -1) end = i;else end = end + 1;
+          break;
+        }
+      }
+      code = code.slice(0, templateStart) + code.slice(end);
+      modified = true;
+    }
+
+    // Remove: module.exports.template = $app_template$; or $app_module$.exports.template = $app_template$;
+    const newCode = code.replace(/\s*(?:module|\$app_module\$)\.exports\.template\s*=\s*\$app_template\$;?\s*/g, '\n');
+    if (newCode !== code) {
+      code = newCode;
+      modified = true;
+    }
+
+    // Replace $app_style$ or $app_style_<id>$ arrays with @info reference
+    while (true) {
+      const styleMatch = code.match(/var \$app_style_?(\d*)\$/);
+      if (!styleMatch) break;
+      const styleStart = code.indexOf(styleMatch[0]);
+      const eqIdx = code.indexOf('=', styleStart);
+      if (eqIdx === -1) break;
+
+      // Find the opening [ or {
+      let openIdx = -1;
+      let openChar = '';
+      let closeChar = '';
+      for (let i = eqIdx + 1; i < code.length; i++) {
+        if (code[i] === '[') {
+          openIdx = i;
+          openChar = '[';
+          closeChar = ']';
+          break;
+        }
+        if (code[i] === '{') {
+          openIdx = i;
+          openChar = '{';
+          closeChar = '}';
+          break;
+        }
+      }
+      if (openIdx === -1) break;
+
+      // Find matching close
+      let depth = 0;
+      let closeIdx = -1;
+      let inStr = null;
+      let esc = false;
+      for (let i = openIdx; 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 === openChar) depth++;else if (ch === closeChar) {
+          depth--;
+          if (depth === 0) {
+            closeIdx = i;
+            break;
+          }
+        }
+      }
+      if (closeIdx === -1) break;
+
+      // Find the styleObjectId from the variable name ($app_style_<id>$)
+      const varId = styleMatch[1];
+      let styleId = varId;
+      if (!styleId) {
+        const idM = code.match(/let \$style\$(\d+)/);
+        styleId = idM ? idM[1] : '0';
+      }
+
+      // Find semicolon after
+      let semiIdx = code.indexOf(';', closeIdx);
+      if (semiIdx === -1) semiIdx = closeIdx;
+      code = code.slice(0, eqIdx + 1) + ` {"@info":{"styleObjectId":${styleId}}}` + code.slice(semiIdx);
+      modified = true;
+      break; // Only one $app_style$ per component block typically
+    }
+    if (modified) {
+      _fsExtra.default.writeFileSync(jsPath, code);
+    }
+  }
+}
+
+/**
+ * Replace $app_style$ array with @info reference in a JS file
+ */
+function stripStyleFromFile(jsPath) {
+  let code = _fsExtra.default.readFileSync(jsPath, 'utf-8');
+  const styleStart = code.indexOf('var $app_style$');
+  if (styleStart === -1) return;
+  const eqIdx = code.indexOf('=', styleStart);
+  if (eqIdx === -1) return;
+
+  // Find opening [ or {
+  let openIdx = -1,
+    openChar = '',
+    closeChar = '';
+  for (let i = eqIdx + 1; i < code.length; i++) {
+    if (code[i] === '[') {
+      openIdx = i;
+      openChar = '[';
+      closeChar = ']';
+      break;
+    }
+    if (code[i] === '{') {
+      openIdx = i;
+      openChar = '{';
+      closeChar = '}';
+      break;
+    }
+  }
+  if (openIdx === -1) return;
+
+  // Find matching close with brace counting
+  let depth = 0,
+    inStr = null,
+    esc = false,
+    closeIdx = -1;
+  for (let i = openIdx; 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 === openChar) depth++;else if (ch === closeChar) {
+      depth--;
+      if (depth === 0) {
+        closeIdx = i;
+        break;
+      }
+    }
+  }
+  if (closeIdx === -1) return;
+
+  // Get styleObjectId from the $style$ variable
+  const idMatch = code.match(/let \$style\$(\d+)/);
+  const styleId = idMatch ? idMatch[1] : '0';
+  let semiIdx = code.indexOf(';', closeIdx);
+  if (semiIdx === -1) semiIdx = closeIdx;
+  code = code.slice(0, eqIdx + 1) + ` {"@info":{"styleObjectId":${styleId}}}` + code.slice(semiIdx);
+  _fsExtra.default.writeFileSync(jsPath, code);
+}
+
+/**
+ * Add import paths to custom component nodes in template.json
+ */
+function addImportPaths(node, importMap) {
+  if (!node) return;
+  if (importMap[node.type]) {
+    node.import = importMap[node.type];
+  }
+  if (node.children) {
+    for (const child of node.children) {
+      addImportPaths(child, importMap);
+    }
+  }
+}
+
+/**
+ * Clear prerender caches for watch mode.
+ * - No args or empty array: full clear (e.g. style file changed)
+ * - With page paths: incremental clear for those pages only
+ */
+function watchChange(changedPages) {
+  if (!changedPages || changedPages.length === 0) {
+    prerenderEntryKeyCache = {};
+    preRenderCache = {};
+    cssCache = {};
+    return;
+  }
+  for (const page of changedPages) {
+    for (const deviceEntries of Object.values(prerenderEntryKeyCache)) {
+      delete deviceEntries[page];
+    }
+    for (const key of Object.keys(preRenderCache)) {
+      if (key.endsWith(`$$${page}`)) {
+        delete preRenderCache[key];
+      }
+    }
+    delete cssCache[page];
+  }
+}

package/lib/prerender/interface/IPrerenderOption.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 预渲染配置
+ */
+export default interface IPrerenderOption {
+    /** 编译产物目录（绝对路径） */
+    buildPath: string;
+    /** 源码目录（绝对路径） */
+    sourcePath: string;
+    /** 页面入口列表，相对 buildPath，如 ['pages/Demo/index'] */
+    pages: string[];
+    /** 是否递归预渲染子组件，默认 true */
+    prerenderSubComp?: boolean;
+    /** 设备类型列表，来自 manifest.json deviceTypeList，默认 ['default'] */
+    deviceTypes?: string[];
+}

package/lib/prerender/interface/IPrerenderOption.js

@@ -0,0 +1 @@
+"use strict";

package/lib/utils/BeforeCompileUtils.d.ts

@@ -10,7 +10,7 @@ declare class BeforeCompileUtils {
      * @param fileList
      * @returns
      */
-    static getEntries: PreWork;
+    static getEntries: PreWork<IJavascriptCompileOption>;
     static clean: PreWork;
     /**
      * 获取项目的全局样式变量配置

package/lib/utils/BeforeCompileUtils.js

@@ -11,6 +11,7 @@ var _path = _interopRequireDefault(require("path"));
 var _TranslateCache = _interopRequireDefault(require("@aiot-toolkit/parser/lib/ux/translate/vela/TranslateCache"));
 var _UxFileUtils = _interopRequireDefault(require("./ux/UxFileUtils"));
 var _IManifest = require("../compiler/javascript/vela/interface/IManifest");
+var _UxUtil = _interopRequireDefault(require("@aiot-toolkit/parser/lib/ux/utils/UxUtil"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 const BinaryPlugin = require('@aiot-toolkit/parser/lib/ux/translate/vela/protobuf/BinaryPlugin');
 
@@ -28,7 +29,8 @@ class BeforeCompileUtils {
     const {
       context,
       compilerOption,
-      compilation
+      compilation,
+      onLog
     } = params;
     const {
       projectPath
@@ -45,8 +47,11 @@ class BeforeCompileUtils {
     let serviceList = [];
     const {
       router,
-      services
+      services,
+      widgetProvider
     } = manifestContent;
+    // 存储widgetProvider
+    let widgetProviderList = [];
     if (router) {
       const {
         pages,
@@ -62,12 +67,14 @@ class BeforeCompileUtils {
             entryList.push(_path.default.join(entryDir, entry));
           } else {
             // 路径不存在
-            _sharedUtils.ColorConsole.throw(`### manifest ### path '${_path.default.join(entryDir, entryPages.join(' | '))}' does not exist`);
+            onLog?.([{
+              level: _sharedUtils.Loglevel.THROW,
+              message: ['### manifest ### path', {
+                word: _path.default.join(entryDir, entryPages.join(' | '))
+              }, 'does not exist']
+            }]);
           }
         });
-      } else {
-        // 没有pages配置
-        _sharedUtils.ColorConsole.throw(`### manifest ### No pages configuration`);
       }
       //获取轻卡路由
       if (widgets) {
@@ -78,23 +85,59 @@ class BeforeCompileUtils {
             if (_fsExtra.default.existsSync(cardPath)) {
               liteCardList.push(card + _path.default.posix.sep + cardContent.component);
             } else {
-              // 报错
-              _sharedUtils.ColorConsole.throw(`### manifest ### lite card path '${cardPath}' does not exist`);
+              onLog?.([{
+                level: _sharedUtils.Loglevel.THROW,
+                message: [`### manifest ### lite card path`, {
+                  word: cardPath
+                }, `does not exist`]
+              }]);
             }
           }
         });
       }
     } else {
       // 没有router配置
-      _sharedUtils.ColorConsole.throw(`### manifest ### No router configuration`);
+      onLog?.([{
+        level: _sharedUtils.Loglevel.THROW,
+        message: ['### manifest ### No router configuration']
+      }]);
+    }
+
+    // e2e测试入口
+    if (compilerOption?.enableE2e && compilerOption?.e2eConfigPath) {
+      const e2eConfig = _UxUtil.default.getE2eConfig({
+        projectPath: context.projectPath,
+        e2eConfigPath: compilerOption.e2eConfigPath
+      });
+      entryList.push(_path.default.join(e2eConfig.dir, e2eConfig.entry.path));
     }
     if (services) {
       serviceList = Array.isArray(services) ? services : Object.values(services);
     }
+    if (widgetProvider) {
+      const EXTENSION_JS = '.js';
+      for (const providerItem of widgetProvider) {
+        const {
+          path
+        } = providerItem;
+        const itemPath = _path.default.join(srcPath, path + EXTENSION_JS);
+        if (_fsExtra.default.existsSync(itemPath)) {
+          widgetProviderList.push(path + EXTENSION_JS);
+        } else {
+          onLog?.([{
+            level: _sharedUtils.Loglevel.THROW,
+            message: ['### manifest ### widgetProvider path', {
+              word: itemPath
+            }, 'does not exist']
+          }]);
+        }
+      }
+    }
     if (compilation) {
       compilation['entries'] = entryList;
       compilation['liteCards'] = liteCardList;
       compilation['services'] = serviceList;
+      context['widgetProvider'] = widgetProviderList;
     }
     return Promise.resolve();
   };

package/lib/utils/ux/ManifestSchema.js

@@ -69,7 +69,6 @@ const ManifestSchema = {
     router: {
       // TODO 更详细的后台运行配置信息，
       type: 'object',
-      required: ['entry', 'pages'],
       properties: {
         entry: {
           type: 'string'

package/lib/utils/ux/UxFileUtils.js

@@ -67,7 +67,7 @@ class UxFileUtils {
         entry,
         pages
       } = jsonData.router;
-      if (!pages[entry]) {
+      if (entry && !pages?.[entry]) {
         errors.push(new TypeError(`router.entry content:  ${entry}, is missing in router.pages`));
       }
     }