@epxing/core 5.3.0-beta.2 → 5.3.0-beta.3

package/src/plugins/frame.js

@@ -1,178 +1,178 @@
-import { publishSharedPackage } from '../shared-packages'
-import * as Vue from 'vue'
-import vuex from 'vuex'
-import router from '@epxing/core/src/router'
-import http from '@epxing/core/src/api'
-import { util, axios } from '@epxing/utils/src'
-import mixins from '@epxing/core/src/mixins'
-import { registerLazyLibrary } from '@epxing/core/src/lazy-library'
-import { isEmpty, isObject, isNil, cloneDeep, isEqual, isMatch, debounce, throttle, assignWith, findLastIndex } from 'lodash-es'
-import cookie from '@epxing/utils/src/storage' // Web Storage 兼容层（js-cookie 同形 API，不读写浏览器 Cookie）
-// window.frame.moment（冻结 ABI）现在是基于 dayjs 的兼容层。远程库拿到的用法面不变，
-// 覆盖不到的 API 会抛自解释错误而不是静默 undefined。
-import moment from '@epxing/utils/src/moment-compat'
-const lodash = {
-  isEmpty,
-  isObject,
-  isNil,
-  isEqual,
-  isMatch,
-  cloneDeep,
-  debounce,
-  throttle,
-  assignWith,
-  findLastIndex
-}
-if (!window.componentLibrary) window.componentLibrary = {}
-// T30b：popup 已 app 化，改在 installFrame 里 app.use(PopupInstall)（不再 module-level Vue.use）
-// T33（关 compat）：原为 **module-level**  —— 在 import 期就把 113 个组件注册到
-// compat 的全局 Vue 上。Vue3 没有全局注册，且此刻 app 还没建（setApp 在 installFrame 里才跑）
-// → 改成**导出安装函数**，由 installFrame(app) 显式调用。
-//
-// 注：Frame.Vue 是给外部消费方（window.frame.Vue）的。Vue3 无 default 导出 →
-// 换成整个 vue 模块命名空间，消费方拿到 { createApp, h, ref, ... }。
-//
-// 按需拆包（epx-frame/core 等六入口）后，本模块只装**工具面**——组件清单不再静态聚合进 core：
-// 聚合壳（src/component.js）与各按需入口在 import 期调 attachFrameComponents() 把各自的组件
-// 表挂进 Frame。聚合流（平台 main.js / createApp / epx-frame "."）语义不变：component.js 的
-// module init 就 attach，晚于工具面、先于任何远程库加载。
-const Frame = { axios, http, util, lodash, moment, cookie, mixins, router, Vue, vuex }
-// window.frame 是远程模块的【冻结 ABI】（ADR-010）：remote bundle / FM_SYSTEM_WEBPACK 远程库
-// 的 vue/vuex/http/util 等运行时依赖全从这里取。契约面与兼容规则见 docs/WINDOW-FRAME-ABI.md。
-// __ABI__ 供远程模块启动时校验（不匹配可提示而非静默错乱）；破坏性变更必须 +1 并走迁移。
-Frame.__ABI__ = 1
-window.frame = Frame
-window['epx-frame'] = Frame
-// rollup/vite 把外置的 'epx-frame' 猜成驼峰全局 epxFrame（连字符包名规则）——补同体别名，
-// 让 Vite 形态的产品远程库（PROJECT-GUIDE.md）免配 globals 直接落位。与上面两个键同一对象。
-window.epxFrame = Frame
-
-// 某个键当前是不是「懒加载自解释 shim」（见下方 attachFrameLazyStubs）。
-// Frame 上除了 shim 不会有别的 accessor 属性，故判有没有 getter 即可。
-function isLazyStub (key) {
-  const d = Object.getOwnPropertyDescriptor(Frame, key)
-  return !!(d && d.get)
-}
-
-// 读某个键的**真身**，不触发 shim 的 getter（不想让内部逻辑自己打出那条给使用者看的 console.error）。
-// shim 表示「还没加载」，所以返回 undefined。
-function peek (key) {
-  const d = Object.getOwnPropertyDescriptor(Frame, key)
-  if (!d || d.get) return undefined
-  return d.value
-}
-
-// 组件表挂载（聚合壳/按需入口在 import 期调用）：已有键不覆盖——工具面与 __ABI__ 优先，
-// 聚合表内部的覆盖序（components 先、工具后）由此保持不变。
-// 例外：懒加载 shim 只是个占位，不算「已有」——整表回退（frame.lazy.js 的 loadFull()）会
-// import 完整的 src/component.js，它在 module init 再 attach 一次全部真身，必须允许它把
-// shim 换成真身，否则「最坏 = 改造前行为」这条兜底会被 shim 自己破坏。
-export function attachFrameComponents (map) {
-  publishSharedPackage('@epxing/component', map)
-  for (const key in map) {
-    if (!(key in Frame) || isLazyStub(key)) Frame[key] = map[key]
-  }
-}
-
-// —— 转懒导出名的自解释 shim ——
-// 组件转为按需加载后，window.frame.<Name> 从「首屏真身」变成 undefined。远程模块若仍写
-// `export default { extends: window.frame.Chart }`，得到的只是一句莫名其妙的
-// `extends: undefined` 报错，看不出跟按需加载有关。给这些名字装个 accessor：读到就打一条
-// 带修复指引的 console.error 并返回 undefined。
-//
-// 两个必须项：
-//   ① configurable: true —— 否则下面 setter 里的 defineProperty（换回数据属性）会抛，
-//      loadComponent() 写回真身的路径直接断掉。
-//   ② 必须同时给 setter —— 本文件是 ESM（严格模式），对「只有 getter」的属性做
-//      Frame[name] = comp 赋值会 TypeError，而 loadComponent()/attachFrameComponents()
-//      写回真身走的正是普通赋值。setter 把自己换成普通数据属性，之后一切如常。
-// 懒加载组件名单（壳层 component.lazy.js 传入）。remote-deps 的「无清单兜底」要用它，
-// 但那边不能 import 本文件（会成环 frame→router→router/config→loadLibrary→remote-deps），
-// 所以经下面的 Frame.ensureAll() 走 window.frame 暴露出去。
-let _lazyNames = []
-
-export function attachFrameLazyStubs (names) {
-  // 合并而非覆盖：目前只有一个调用点，但下面的 for 循环本身是幂等累加的，
-  // 若未来第二个入口再调一次，覆盖会让 ensureAll()/ensureLazy() 静默只剩最后一批。
-  _lazyNames = [...new Set([..._lazyNames, ...(names || [])])]
-  for (const name of names || []) {
-    if (name in Frame) continue // 已是真身（白名单内/已加载过/工具面同名）就别去挡
-    Object.defineProperty(Frame, name, {
-      configurable: true,
-      enumerable: false, // 不进 Object.keys(window.frame)：它还不是能用的东西，别看着像"已经有了"
-      get () {
-        console.error(`[frame] ${name} 已转为按需加载，请先 await window.frame.ensure(['${name}'])`)
-        return undefined
-      },
-      set (value) {
-        Object.defineProperty(Frame, name, { value, writable: true, enumerable: true, configurable: true })
-      }
-    })
-  }
-}
-
-// 通用组件懒加载 resolver 注入点（依赖方向：core 不 import src/，由壳层 component.lazy.js 注入）。
-let _lazyResolver = null
-export function attachFrameLazyResolver (fn) {
-  _lazyResolver = fn
-}
-
-// The designer group is loaded by registration name when a platform page opens.
-// Old remote products can instead synchronously extend the named Frame export
-// while their bundle is evaluated. Make that export available to the remote
-// dependency preloader before it evaluates the bundle.
-const remoteOptionalExports = {
-  PageDesigner: () => import('@platform-optional/designer-lazy').then(m => m.default?.PageDesigner)
-}
-
-// —— ABI 新增键（兼容规则：新增键随时允许、不升 __ABI__）——
-// 远程模块把需要 extends 的组件先 await 出来，之后 window.frame.<Name> 同步可用：
-//   await window.frame.ensure(['Chart'])
-//   export default { extends: window.frame.Chart }
-// 读 Frame[name] 一律走 peek()：直接读会触发懒 shim 的 getter，把那条「请先 ensure()」的
-// 提示打给正在**正确地**调用 ensure() 的人，属噪音。
-Frame.loadComponent = function loadComponent (name) {
-  const current = peek(name)
-  if (current && !current.__asyncLoader) return Promise.resolve(current)
-  if (remoteOptionalExports[name]) {
-    return remoteOptionalExports[name]().then(comp => {
-      if (comp) Frame[name] = comp
-      return comp || null
-    })
-  }
-  if (!_lazyResolver) return Promise.resolve(current)
-  return Promise.resolve(_lazyResolver(name)).then(comp => {
-    if (comp) Frame[name] = comp // 写回 ABI（命中 shim 的 setter → 换成数据属性）：此后同步访问持续有效
-    return comp || peek(name)
-  })
-}
-Frame.ensure = function ensure (names) {
-  const list = Array.isArray(names) ? names : [names]
-  return Promise.all(list.map(n => Frame.loadComponent(n))).then(() => undefined)
-}
-// 备好全部懒加载组件。供 remote-deps 在「远程包没有依赖清单」时兜底用（正确优先于流量）。
-Frame.ensureAll = function ensureAll () {
-  return Frame.ensure([..._lazyNames, ...Object.keys(remoteOptionalExports)])
-}
-// 只 ensure names 里「确实是懒加载」的那些。remote-deps 的精确路径用它——
-// 清单里可能含 epx-frame/utils 等**不在 Frame 上**的导出名（FieldFactory/Config/Meta…），
-// 直接喂给 ensure() 会走 loadComponent → peek() 落空 → 回退整表，把整张聚合组件表拉下来，
-// 反而比不做清单更糟（详见评审 Important-1）。
-Frame.ensureLazy = function ensureLazy (names) {
-  const want = new Set(Array.isArray(names) ? names : [names])
-  return Frame.ensure([..._lazyNames, ...Object.keys(remoteOptionalExports)].filter(n => want.has(n)))
-}
-
-// —— ABI 新增键（同上：新增键随时允许、不升 __ABI__）——
-// 产品/项目远程库的「清单 + 组件按需加载」形态：入口壳求值时把纯数据清单交过来，
-// 平台建 wrapper、发起 import()、统一预取与降级。详见 packages/core/src/lazy-library.js。
-Frame.registerLazyLibrary = function (pkgName, opts) {
-  return registerLazyLibrary(pkgName, opts)
-}
-
-export default Frame
-export function installFrameComponents (app) {
-  // Frame.install 来自 src/component.js 的 attach（聚合流）；纯按需流没有它——
-  // 消费方自行 app.use(epx-frame/components 等入口)，这里安全跳过。
-  if (Frame.install) app.use(Frame)
-}
+import { publishSharedPackage } from '../shared-packages'
+import * as Vue from 'vue'
+import vuex from 'vuex'
+import router from '@epxing/core/src/router'
+import http from '@epxing/core/src/api'
+import { util, axios } from '@epxing/utils/src'
+import mixins from '@epxing/core/src/mixins'
+import { registerLazyLibrary } from '@epxing/core/src/lazy-library'
+import { isEmpty, isObject, isNil, cloneDeep, isEqual, isMatch, debounce, throttle, assignWith, findLastIndex } from 'lodash-es'
+import cookie from '@epxing/utils/src/storage' // Web Storage 兼容层（js-cookie 同形 API，不读写浏览器 Cookie）
+// window.frame.moment（冻结 ABI）现在是基于 dayjs 的兼容层。远程库拿到的用法面不变，
+// 覆盖不到的 API 会抛自解释错误而不是静默 undefined。
+import moment from '@epxing/utils/src/moment-compat'
+const lodash = {
+  isEmpty,
+  isObject,
+  isNil,
+  isEqual,
+  isMatch,
+  cloneDeep,
+  debounce,
+  throttle,
+  assignWith,
+  findLastIndex
+}
+if (!window.componentLibrary) window.componentLibrary = {}
+// T30b：popup 已 app 化，改在 installFrame 里 app.use(PopupInstall)（不再 module-level Vue.use）
+// T33（关 compat）：原为 **module-level**  —— 在 import 期就把 113 个组件注册到
+// compat 的全局 Vue 上。Vue3 没有全局注册，且此刻 app 还没建（setApp 在 installFrame 里才跑）
+// → 改成**导出安装函数**，由 installFrame(app) 显式调用。
+//
+// 注：Frame.Vue 是给外部消费方（window.frame.Vue）的。Vue3 无 default 导出 →
+// 换成整个 vue 模块命名空间，消费方拿到 { createApp, h, ref, ... }。
+//
+// 按需拆包（epx-frame/core 等六入口）后，本模块只装**工具面**——组件清单不再静态聚合进 core：
+// 聚合壳（src/component.js）与各按需入口在 import 期调 attachFrameComponents() 把各自的组件
+// 表挂进 Frame。聚合流（平台 main.js / createApp / epx-frame "."）语义不变：component.js 的
+// module init 就 attach，晚于工具面、先于任何远程库加载。
+const Frame = { axios, http, util, lodash, moment, cookie, mixins, router, Vue, vuex }
+// window.frame 是远程模块的【冻结 ABI】（ADR-010）：remote bundle / FM_SYSTEM_WEBPACK 远程库
+// 的 vue/vuex/http/util 等运行时依赖全从这里取。契约面与兼容规则见 docs/WINDOW-FRAME-ABI.md。
+// __ABI__ 供远程模块启动时校验（不匹配可提示而非静默错乱）；破坏性变更必须 +1 并走迁移。
+Frame.__ABI__ = 1
+window.frame = Frame
+window['epx-frame'] = Frame
+// rollup/vite 把外置的 'epx-frame' 猜成驼峰全局 epxFrame（连字符包名规则）——补同体别名，
+// 让 Vite 形态的产品远程库（PROJECT-GUIDE.md）免配 globals 直接落位。与上面两个键同一对象。
+window.epxFrame = Frame
+
+// 某个键当前是不是「懒加载自解释 shim」（见下方 attachFrameLazyStubs）。
+// Frame 上除了 shim 不会有别的 accessor 属性，故判有没有 getter 即可。
+function isLazyStub (key) {
+  const d = Object.getOwnPropertyDescriptor(Frame, key)
+  return !!(d && d.get)
+}
+
+// 读某个键的**真身**，不触发 shim 的 getter（不想让内部逻辑自己打出那条给使用者看的 console.error）。
+// shim 表示「还没加载」，所以返回 undefined。
+function peek (key) {
+  const d = Object.getOwnPropertyDescriptor(Frame, key)
+  if (!d || d.get) return undefined
+  return d.value
+}
+
+// 组件表挂载（聚合壳/按需入口在 import 期调用）：已有键不覆盖——工具面与 __ABI__ 优先，
+// 聚合表内部的覆盖序（components 先、工具后）由此保持不变。
+// 例外：懒加载 shim 只是个占位，不算「已有」——整表回退（frame.lazy.js 的 loadFull()）会
+// import 完整的 src/component.js，它在 module init 再 attach 一次全部真身，必须允许它把
+// shim 换成真身，否则「最坏 = 改造前行为」这条兜底会被 shim 自己破坏。
+export function attachFrameComponents (map) {
+  publishSharedPackage('@epxing/components', map)
+  for (const key in map) {
+    if (!(key in Frame) || isLazyStub(key)) Frame[key] = map[key]
+  }
+}
+
+// —— 转懒导出名的自解释 shim ——
+// 组件转为按需加载后，window.frame.<Name> 从「首屏真身」变成 undefined。远程模块若仍写
+// `export default { extends: window.frame.Chart }`，得到的只是一句莫名其妙的
+// `extends: undefined` 报错，看不出跟按需加载有关。给这些名字装个 accessor：读到就打一条
+// 带修复指引的 console.error 并返回 undefined。
+//
+// 两个必须项：
+//   ① configurable: true —— 否则下面 setter 里的 defineProperty（换回数据属性）会抛，
+//      loadComponent() 写回真身的路径直接断掉。
+//   ② 必须同时给 setter —— 本文件是 ESM（严格模式），对「只有 getter」的属性做
+//      Frame[name] = comp 赋值会 TypeError，而 loadComponent()/attachFrameComponents()
+//      写回真身走的正是普通赋值。setter 把自己换成普通数据属性，之后一切如常。
+// 懒加载组件名单（壳层 component.lazy.js 传入）。remote-deps 的「无清单兜底」要用它，
+// 但那边不能 import 本文件（会成环 frame→router→router/config→loadLibrary→remote-deps），
+// 所以经下面的 Frame.ensureAll() 走 window.frame 暴露出去。
+let _lazyNames = []
+
+export function attachFrameLazyStubs (names) {
+  // 合并而非覆盖：目前只有一个调用点，但下面的 for 循环本身是幂等累加的，
+  // 若未来第二个入口再调一次，覆盖会让 ensureAll()/ensureLazy() 静默只剩最后一批。
+  _lazyNames = [...new Set([..._lazyNames, ...(names || [])])]
+  for (const name of names || []) {
+    if (name in Frame) continue // 已是真身（白名单内/已加载过/工具面同名）就别去挡
+    Object.defineProperty(Frame, name, {
+      configurable: true,
+      enumerable: false, // 不进 Object.keys(window.frame)：它还不是能用的东西，别看着像"已经有了"
+      get () {
+        console.error(`[frame] ${name} 已转为按需加载，请先 await window.frame.ensure(['${name}'])`)
+        return undefined
+      },
+      set (value) {
+        Object.defineProperty(Frame, name, { value, writable: true, enumerable: true, configurable: true })
+      }
+    })
+  }
+}
+
+// 通用组件懒加载 resolver 注入点（依赖方向：core 不 import src/，由壳层 component.lazy.js 注入）。
+let _lazyResolver = null
+export function attachFrameLazyResolver (fn) {
+  _lazyResolver = fn
+}
+
+// The designer group is loaded by registration name when a platform page opens.
+// Old remote products can instead synchronously extend the named Frame export
+// while their bundle is evaluated. Make that export available to the remote
+// dependency preloader before it evaluates the bundle.
+const remoteOptionalExports = {
+  PageDesigner: () => import('@platform-optional/designer-lazy').then(m => m.default?.PageDesigner)
+}
+
+// —— ABI 新增键（兼容规则：新增键随时允许、不升 __ABI__）——
+// 远程模块把需要 extends 的组件先 await 出来，之后 window.frame.<Name> 同步可用：
+//   await window.frame.ensure(['Chart'])
+//   export default { extends: window.frame.Chart }
+// 读 Frame[name] 一律走 peek()：直接读会触发懒 shim 的 getter，把那条「请先 ensure()」的
+// 提示打给正在**正确地**调用 ensure() 的人，属噪音。
+Frame.loadComponent = function loadComponent (name) {
+  const current = peek(name)
+  if (current && !current.__asyncLoader) return Promise.resolve(current)
+  if (remoteOptionalExports[name]) {
+    return remoteOptionalExports[name]().then(comp => {
+      if (comp) Frame[name] = comp
+      return comp || null
+    })
+  }
+  if (!_lazyResolver) return Promise.resolve(current)
+  return Promise.resolve(_lazyResolver(name)).then(comp => {
+    if (comp) Frame[name] = comp // 写回 ABI（命中 shim 的 setter → 换成数据属性）：此后同步访问持续有效
+    return comp || peek(name)
+  })
+}
+Frame.ensure = function ensure (names) {
+  const list = Array.isArray(names) ? names : [names]
+  return Promise.all(list.map(n => Frame.loadComponent(n))).then(() => undefined)
+}
+// 备好全部懒加载组件。供 remote-deps 在「远程包没有依赖清单」时兜底用（正确优先于流量）。
+Frame.ensureAll = function ensureAll () {
+  return Frame.ensure([..._lazyNames, ...Object.keys(remoteOptionalExports)])
+}
+// 只 ensure names 里「确实是懒加载」的那些。remote-deps 的精确路径用它——
+// 清单里可能含 epx-frame/utils 等**不在 Frame 上**的导出名（FieldFactory/Config/Meta…），
+// 直接喂给 ensure() 会走 loadComponent → peek() 落空 → 回退整表，把整张聚合组件表拉下来，
+// 反而比不做清单更糟（详见评审 Important-1）。
+Frame.ensureLazy = function ensureLazy (names) {
+  const want = new Set(Array.isArray(names) ? names : [names])
+  return Frame.ensure([..._lazyNames, ...Object.keys(remoteOptionalExports)].filter(n => want.has(n)))
+}
+
+// —— ABI 新增键（同上：新增键随时允许、不升 __ABI__）——
+// 产品/项目远程库的「清单 + 组件按需加载」形态：入口壳求值时把纯数据清单交过来，
+// 平台建 wrapper、发起 import()、统一预取与降级。详见 packages/core/src/lazy-library.js。
+Frame.registerLazyLibrary = function (pkgName, opts) {
+  return registerLazyLibrary(pkgName, opts)
+}
+
+export default Frame
+export function installFrameComponents (app) {
+  // Frame.install 来自 src/component.js 的 attach（聚合流）；纯按需流没有它——
+  // 消费方自行 app.use(epx-frame/components 等入口)，这里安全跳过。
+  if (Frame.install) app.use(Frame)
+}

package/src/public-api.js

@@ -14,4 +14,5 @@ export { createFrameRouter, routerConfig } from './router/public'
 export { createEventBus, getEventBus } from './vue.bus'
 export { getApp, setApp, registerComponent, resolveComponent } from './app'
 export { configureRuntime, registerRouteComponents } from './runtime-services'
+export { default as routeComponents } from './route-components'
 export { nav } from './navigation'

package/src/route-components.js

@@ -0,0 +1,7 @@
+import App from './views/App.vue'
+import Module from './views/Module.vue'
+import AppRoleSelect from './views/AppRoleSelect.vue'
+import Error from './views/Error.vue'
+
+// 平台基础路由页面随 core 安装，不要求安装 business。
+export default { App, Module, AppRoleSelect, Error }