@axewo/fin-micro 1.0.0 → 2.0.1

package/dist/types/layout/StandaloneShell.vue.d.ts

@@ -0,0 +1,40 @@
+import { ShellBrand, ShellMenuItem } from './types';
+/** 独立外壳仅展示路由适配结果；不创建 router、认证或 bridge，也不自行判断嵌入环境。 */
+type __VLS_Props = {
+    title: string;
+    menus: readonly ShellMenuItem[];
+    activeMenu: string;
+    brand?: ShellBrand;
+};
+/** 导航由项目处理并捕获失败；重置选中项，以真实路由而非点击结果为准。 */
+declare function navigate(path: string): Promise<void>;
+declare function __VLS_template(): {
+    attrs: Partial<{}>;
+    slots: {
+        brand?(_: {
+            brand: ShellBrand;
+        }): any;
+        'header-actions'?(_: {}): any;
+        sidebar?(_: {
+            menus: readonly ShellMenuItem[];
+            navigate: typeof navigate;
+        }): any;
+        default?(_: {}): any;
+        'workspace-overlay'?(_: {}): any;
+    };
+    refs: {};
+    rootEl: HTMLDivElement;
+};
+type __VLS_TemplateResult = ReturnType<typeof __VLS_template>;
+declare const __VLS_component: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    navigate: (path: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onNavigate?: ((path: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, __VLS_TemplateResult["slots"]>;
+export default _default;
+type __VLS_WithTemplateSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/types/layout/index.d.ts

@@ -0,0 +1,5 @@
+export { default as HostShell } from './HostShell.vue';
+export { default as StandaloneShell } from './StandaloneShell.vue';
+export type { ShellBrand, ShellMenuItem, HostShellProps, HostShellActions, HostShellSlots } from './types';
+/** 公共外壳模板协议，用于发布前避免新模板与旧 dist 混装。 */
+export declare const layoutProtocol = 1;

package/dist/types/layout/types.d.ts

@@ -0,0 +1,65 @@
+import { Component, VNode } from 'vue';
+import { MicroApp, MicroMenu, MicroTab, NavigationOperation } from '../sdk';
+/** 公共外壳品牌配置；只改变展示，不注册应用、路由或认证能力。 */
+export interface ShellBrand {
+    /** 产品名称。 */
+    title?: string;
+    /** 左上角短标识；复杂 Logo 请使用 brand 插槽。 */
+    mark?: string;
+    /** 面包屑前缀。 */
+    workspaceTitle?: string;
+}
+/** 独立应用菜单；由项目本地 router meta 转换，不是宿主权限凭据。 */
+export interface ShellMenuItem {
+    /** 已解析的应用内完整路径，仅作为导航事件参数。 */
+    path: string;
+    title: string;
+    icon?: Component;
+    children: readonly ShellMenuItem[];
+}
+/** HostShell 输入全部来自项目唯一的核心状态；外壳不创建 host、router 或 session。 */
+export interface HostShellProps {
+    apps: readonly MicroApp[];
+    tabs: readonly MicroTab[];
+    activeKey?: string;
+    userName: string;
+    pending?: boolean;
+    notice?: string;
+    brand?: ShellBrand;
+    /** 可选受控折叠状态；未传入时仅在当前组件内维护展示状态。 */
+    collapsed?: boolean;
+    /** 项目固定页签规则；仅控制按钮，真正的操作约束仍必须由核心适配器实施。 */
+    isFixedTab?: (tab: MicroTab) => boolean;
+}
+/** 所有插槽动作只发出事件；调用方必须继续通过原有授权和异步离页事务处理。 */
+export interface HostShellActions {
+    open: (appId: string, menu: MicroMenu) => void;
+    operate: (operation: NavigationOperation) => void;
+    logout: () => void;
+    profile: () => void;
+    toggleCollapsed: () => void;
+}
+/** 替换整个区域表示自行维护该区域；未覆盖区域仍使用库内默认组件。 */
+export interface HostShellSlots {
+    default: (scope: {
+        active?: MicroTab;
+    }) => VNode[];
+    brand?: (scope: {
+        brand: ShellBrand;
+    }) => VNode[];
+    'header-actions'?: (scope: HostShellActions) => VNode[];
+    header?: (scope: HostShellActions & {
+        active?: MicroTab;
+        collapsed: boolean;
+        pending: boolean;
+    }) => VNode[];
+    sidebar?: (scope: HostShellActions & {
+        active?: MicroTab;
+        collapsed: boolean;
+        pending: boolean;
+    }) => VNode[];
+    tabs?: (scope: HostShellActions & {
+        active?: MicroTab;
+        pending: boolean;
+    }) => VNode[];
+}

package/dist/types/runtime/lifecycle.d.ts

@@ -13,7 +13,7 @@ export interface WujieLifecycleOptions {
  */
 export declare function isMicroFrontend(): boolean;
 /**
- * 注册 Wujie 全局回调和 unload 清理；嵌入时通知 Wujie，独立时自动挂载。
+ * 注册 Wujie 全局回调和 pagehide 清理；嵌入时通知 Wujie，独立时自动挂载。
  * 重复 setup 释放旧注册；返回的 dispose 幂等，可交给 import.meta.hot.dispose。
  * 错误通过 console.error 报告（Wujie 可能忽略返回值），显式全局调用也可等待 Promise 接收失败。
  * 卸载不等待挂起的 mount；新挂载等待上轮 unmount，旧 mount 的迟到结果不再触发清理。

package/dist/types/sdk/index.d.ts

@@ -5,6 +5,8 @@ export interface MicroMenu {
     menuId: string;
     /** 菜单展示名称，同时作为入口页签的默认标题。 */
     name: string;
+    /** 可选展示图标标识（如 HomeFilled、User、Folder、List）；仅布局层解析，不接收组件、HTML 或 URL。 */
+    icon?: string;
     /** 子菜单；分组不允许同时配置 target。 */
     children?: readonly MicroMenu[];
     /** 入口导航信息；tabId 仍须在整个宿主唯一。 */
@@ -20,16 +22,26 @@ export interface MicroMenuRoute {
     /** 该应用内可导航叶节点的 menuId。 */
     menuId: string;
 }
-/** 宿主登记的应用元信息；entry 必须为 HTTP(S) 地址，菜单配置在创建宿主时递归复制冻结。 */
-export interface MicroApp {
+/** 应用公共元信息；菜单配置在创建宿主时递归复制冻结。 */
+interface MicroAppMetadata {
     appId: string;
     name: string;
-    entry: string;
     /** 可选多级菜单；不配置时保持原有无菜单导航行为。 */
     menus?: readonly MicroMenu[];
     /** 隐藏页面的菜单归属规则；入口 target 路径也自动参与匹配。 */
     menuRoutes?: readonly MicroMenuRoute[];
 }
+/**
+ * 明确区分远端与宿主本地应用；省略 kind 保持原有远端协议，entry 必须为 HTTP(S)。
+ * local 只登记导航身份，不具有执行地址；由宿主自己的 SFC 容器渲染，不能交给 Wujie。
+ */
+export type MicroApp = MicroAppMetadata & ({
+    kind?: 'remote';
+    entry: string;
+} | {
+    kind: 'local';
+    entry?: never;
+});
 /** 打开页面的导航元信息；tabId 在宿主内唯一，route 为应用内绝对路径，不应存放敏感信息。 */
 export interface OpenTab {
     appId: string;
@@ -154,8 +166,12 @@ export type NavigationOperation =
     type: 'open';
     input: OpenTab;
 } | {
-    type: 'activate' | 'refresh' | 'close';
+    type: 'activate' | 'refresh';
     target: TabRef;
+} | {
+    type: 'close';
+    target: TabRef;
+    closeFallback?: TabRef;
 } | {
     type: 'closeMany';
     scope: 'all' | 'others' | 'left' | 'right';
@@ -166,6 +182,8 @@ export type NavigationOperation =
      * 排除项不参与关闭确认，不会扩大页面 SDK 的应用权限；省略时完全保持原有范围选择行为。
      */
     exclude?: readonly TabRef[];
+    /** 活动页被关闭时优先激活仍存活的指定生命周期；不存在时沿用相邻页回落，不创建页面。 */
+    closeFallback?: TabRef;
 } | {
     type: 'back';
     target?: TabRef;
@@ -326,6 +344,48 @@ export declare function createTokenCapability(options: {
     apps: readonly string[];
     handler(context: HostCallContext): Promise<TokenResult>;
 };
+/** 单窗口宿主签发的不透明请求票据；只作内存关联，不含 Token，不得序列化或持久化。 */
+export interface AuthRequestTicket {
+    readonly request: string;
+}
+/** 正式登录失效能力契约；与 getToken 同样必须显式注册并配置可信应用白名单。 */
+export interface AuthCapabilities extends TokenCapabilities {
+    /** 请求发送前签发原对象票据；只关联宿主私有版本，不接受子应用自报版本或身份。 */
+    beginAuthRequest(): AuthRequestTicket;
+    /**
+     * 上报该请求的认证失效；首次有效上报同步撤销会话并返回 true。
+     * 伪造、复制、跨应用、已消费或旧版本票据返回 false；能力越权及生命周期释放仍由 callHost 拒绝。
+     * 本返回值不是业务请求结果，不得据此自动重发请求或恢复身份。
+     */
+    reportAuthFailure(ticket: AuthRequestTicket): boolean;
+}
+/**
+ * 创建会话失效协调能力，复用现有 callHost 白名单与生命周期，不建立事件总线。
+ * @param options apps 是可信应用白名单；getRevision 必须读取宿主私有版本，每次身份/凭据变化递增。
+ * invalidate 必须同步撤销身份并推进版本，不能等待 beforeLeave 或远程注销；抛错仍由 core 隔离。
+ * @returns 两个正式能力配置；票据同时绑定可信 context.appId、对象身份和私有版本，不接受子应用自报 revision。
+ * @remarks 仅支持同窗口对象桥，白名单不是 XSS 沙箱；后台仍须鉴权，不自动刷新 Token 或重放请求。
+ */
+export declare function createAuthFailureCapabilities(options: {
+    apps: readonly string[];
+    getRevision(): number;
+    invalidate(): void;
+}): {
+    beginAuthRequest: {
+        apps: readonly string[];
+        handler(context: HostCallContext): AuthRequestTicket;
+    };
+    reportAuthFailure: {
+        apps: readonly string[];
+        handler(context: HostCallContext, ticket: AuthRequestTicket): boolean;
+    };
+};
+/** 未登录或空权限输入一律拒绝；权限名区分大小写，不进行通配符或隐式角色映射。 */
+export declare function hasPermission(session: SessionInput | null | undefined, permission: string): boolean;
+/** 至少一个明确权限匹配才允许；空数组拒绝，不将空条件解释成公共访问。 */
+export declare function hasAny(session: SessionInput | null | undefined, permissions: readonly string[]): boolean;
+/** 所有明确权限均匹配才允许；空数组或包含空权限名均拒绝。 */
+export declare function hasAll(session: SessionInput | null | undefined, permissions: readonly string[]): boolean;
 /** Wujie 注入约定；可显式传入测试窗口，SDK 本身不导入 Wujie。 */
 export interface MicroWindow extends Window {
     $wujie?: {
@@ -336,3 +396,4 @@ export interface MicroWindow extends Window {
 }
 /** 获取 target 上的桥；默认浏览器 window，独立运行或 Node/SSR 无 window 时返回 undefined，不创建宿主。 */
 export declare function getMicroBridge<C extends CapabilityContract<C> = HostCapabilities>(target?: MicroWindow): AppBridge<C> | undefined;
+export {};

package/dist/types/vue/index.d.ts

@@ -1,7 +1,18 @@
-import { PropType } from 'vue';
+import { PropType, MaybeRefOrGetter } from 'vue';
+import { SessionSnapshot, AppBridge, MicroTab, PageSDK, CapabilityContract } from '../sdk';
 import { MicroHost } from '../core';
 import { MicroRuntime } from '../runtime';
-import { AppBridge, MicroTab, PageSDK, CapabilityContract } from '../sdk';
+/**
+ * 根据响应式公开会话消费权限；不读取 Token、不绕过核心准入或后台鉴权。
+ * @param session 当前 SessionSnapshot 的 ref/getter，未连接或未登录安全拒绝。
+ * @returns 三种判断函数；在 computed/模板中调用会追踪最新权限，can 用于直接生成权限计算值。
+ */
+export declare function usePermission(session: MaybeRefOrGetter<SessionSnapshot | null | undefined>): {
+    hasPermission: (permission: string) => boolean;
+    hasAny: (permissions: readonly string[]) => boolean;
+    hasAll: (permissions: readonly string[]) => boolean;
+    can: (permission: MaybeRefOrGetter<string>) => import('vue').ComputedRef<boolean>;
+};
 export { useMicroTab } from './tab-context';
 export { MicroRouteView, type MicroRouteErrorCode } from './router-view';
 /** 应用共享容器：appId 对应一个 runtime 实例；挂载失败显示错误，组件卸载触发异步 unmount。不是页级缓存组件，不应在每次切 tab 时销毁。 */

package/dist/types/vue/router-view-impl.d.ts

@@ -8,7 +8,7 @@ import { MicroRouteErrorCode } from './router-view';
  *
  * 这里只解析与加载页面，不启动导航事务、不执行 Vue Router 导航守卫、不修改宿主页签和权限。
  * redirect 不替代宿主 canOpen；业务必须保证重定向目标属于该应用已授权页面，鉴权仍由宿主/core 负责。
- * 页面定位等价于从 START_LOCATION 发起解析：相对 redirect 以应用根为基准，函数 redirect 的 from 为 START_LOCATION。
+ * 页面定位等价于从 START_LOCATION 发起解析：相对 redirect 以应用根为基准，函数 redirect 按公开契约只接收目标 route。
  * 建议 redirect 使用绝对 path 或 name；不会把其他页签的全局 currentRoute 当作本页的导航来源。
  * 页面跳转和离页确认应使用页面 SDK；不要通过 RouterLink/router.push 把全局路由当作宿主页签导航。
  * 懒加载无法取消网络请求；卸载后忽略迟到结果，不再写入组件状态。模块加载后的组件 setup/render 异常由 Vue 错误边界处理。

package/dist/types/watermark/FinWatermark.vue.d.ts

@@ -0,0 +1,16 @@
+import { WatermarkConfig } from './config';
+/**
+ * 仅叠加水印，不包装业务 DOM。直接父容器必须是 position:relative 的稳定视口。
+ * 防篡改只提高常见删除/样式修改成本，不是安全边界；祖先隐藏或脚本被停用无法保证恢复。
+ */
+type __VLS_Props = {
+    config?: WatermarkConfig;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    error: (error: Error) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onError?: ((error: Error) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    layer: HTMLDivElement;
+}, HTMLDivElement>;
+export default _default;

package/dist/types/watermark/config.d.ts

@@ -0,0 +1,36 @@
+/** 水印配置；接口接入方应只传业务文字，不传 Token 等敏感凭据。 */
+export interface WatermarkConfig {
+    /** 是否绘制；默认开启，禁用会清理观察器和检查定时器。 */
+    enabled?: boolean;
+    /** 自定义文字或多行文字；最多四行，每行最多 120 字。 */
+    text?: string | readonly string[];
+    /** Canvas 文字颜色；默认 #64748b。 */
+    color?: string;
+    /** 文字透明度，范围 0～1。 */
+    opacity?: number;
+    /** 顺时针旋转角度，范围 -180～180。 */
+    rotate?: number;
+    /** 字号，单位 px，范围 10～64。 */
+    fontSize?: number;
+    /** Canvas 字体族；不接受 CSS 声明串。 */
+    fontFamily?: string;
+    /** 水平、垂直文字间距，单位 px，范围 16～600；越小越密。 */
+    gap?: readonly [number, number];
+}
+/** 标准化后的不可变快照，不跨组件共享可变配置。 */
+export interface NormalizedWatermarkConfig {
+    enabled: boolean;
+    text: readonly string[];
+    color: string;
+    opacity: number;
+    rotate: number;
+    fontSize: number;
+    fontFamily: string;
+    gap: readonly [number, number];
+}
+/**
+ * 将前端或接口配置转换为有界快照；非法数字使用默认值，超范围数字截断。
+ * @param input 可选的水印配置；运行时 null/非法对象也安全降级。
+ * @returns 不可变配置，文字/间距复制后冻结；不操作 DOM，不抛校验异常。
+ */
+export declare function normalizeWatermarkConfig(input?: WatermarkConfig | null): NormalizedWatermarkConfig;

package/dist/types/watermark/index.d.ts

@@ -0,0 +1,4 @@
+/** 可选水印子路径；核心入口不加载 Canvas、Vue 展示组件或观察器。 */
+export { default as FinWatermark } from './FinWatermark.vue';
+export { normalizeWatermarkConfig } from './config';
+export type { WatermarkConfig, NormalizedWatermarkConfig } from './config';

package/dist/vue.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue"),s=Symbol("micro-tab");function d(){const t=e.inject(s);if(!t)throw new Error("useMicroTab 必须在 MicroTabCache 内调用");return t}const m=e.defineComponent({name:"MicroRouteView",props:{name:{type:String,default:"default"}},slots:Object,setup(t,{slots:n}){const i=d(),a=e.shallowRef(),r=e.shallowRef(!1);let u=!1,c=!1;async function o(){if(!(u||c)){c=!0,r.value=!1;try{const l=await Promise.resolve().then(()=>require("./router-view-impl-CgLEalx4.cjs"));u||(a.value=l.MicroRouteViewImpl)}catch{u||(r.value=!0)}finally{c=!1}}}return e.onBeforeUnmount(()=>{u=!0}),o(),()=>{var l,f;return a.value?e.h(a.value,{name:t.name},n):r.value?((l=n.error)==null?void 0:l.call(n,{tab:i,code:"LOAD_FAILED",retry:o}))??e.h("div",{role:"alert","data-micro-route-error":"LOAD_FAILED"},[e.h("p","页面加载失败（LOAD_FAILED）"),e.h("button",{type:"button",onClick:o},"重新加载")]):((f=n.loading)==null?void 0:f.call(n,{tab:i}))??e.h("p",{role:"status"},"页面加载中…")}}}),h=e.defineComponent({name:"MicroAppContainer",props:{appId:{type:String,required:!0},runtime:{type:Object,required:!0},retryDisabled:Boolean},setup(t){const n=e.shallowRef(),i=e.shallowRef(""),a=e.shallowRef(!1);let r=!1;async function u(c=!1){if(!(r||a.value||!c&&t.retryDisabled)){a.value=!0,i.value="";try{await t.runtime.mount(t.appId,n.value)}catch(o){r||(i.value=String(o))}finally{r||(a.value=!1)}}}return e.onMounted(()=>{u(!0)}),e.onBeforeUnmount(()=>{r=!0,t.runtime.unmount(t.appId).catch(console.error)}),()=>e.h("section",{style:{height:"100%",minHeight:"420px"},"aria-busy":a.value},[i.value?e.h("div",{role:"alert"},[e.h("p",i.value),e.h("button",{type:"button",disabled:t.retryDisabled||a.value,onClick:()=>{u()}},"重新加载")]):null,a.value?e.h("p",{role:"status"},"子应用加载中…"):null,e.h("div",{ref:n,style:{height:"100%",minHeight:"420px"}})])}});function v(t){const n=e.shallowRef(t.getState()),i=t.subscribe(a=>{n.value=a});return e.onBeforeUnmount(i),n}const b=e.defineComponent({name:"MicroTabBoundary",props:{tab:{type:Object,required:!0},active:Boolean},setup(t,{slots:n}){const i=Object.freeze({...t.tab});e.provide(s,i);const a=e.defineComponent({name:"MicroTabContent",setup:()=>()=>{var r;return(r=n.default)==null?void 0:r.call(n,{tab:i})}});return()=>e.h("section",{hidden:!t.active,"data-micro-tab":i.key},[e.h(e.KeepAlive,null,{default:()=>t.active?e.h(a):null})])}}),p=e.defineComponent({name:"MicroTabCache",props:{tabs:{type:Array,required:!0},activeKey:String,max:{type:Number,default:20}},setup(t,{slots:n}){const i=e.shallowRef([]);return e.watch(()=>[t.tabs,t.activeKey,t.max],()=>{const a=new Set(t.tabs.map(o=>o.key));let r=i.value.filter(o=>a.has(o.key));const u=t.tabs.find(o=>o.key===t.activeKey);u&&(r=[...r.filter(o=>o.key!==u.key),u]);const c=Number.isFinite(t.max)?Math.max(1,Math.floor(t.max)):20;for(;r.length>c;){const o=r.findIndex(l=>l.key!==t.activeKey);if(o<0)break;r.splice(o,1)}i.value=r},{immediate:!0,flush:"sync"}),()=>i.value.map(a=>e.h(b,{key:a.key,tab:a,active:a.key===t.activeKey},n))}});function M(t,n,i=console.error){let a=!1,r,u=!1,c=0;async function o(){if(!u){u=!0;try{let f=-1;for(;!a&&r&&f!==c;){f=c;try{await n.replace(r.route,r)}catch(y){i(y)}}}finally{u=!1}}}const l=t.ready(f=>{r=f,c++,o()});return()=>{a=!0,l()}}function w(t,n){const i=t.page(n.key);return e.onBeforeUnmount(i.dispose),i}exports.MicroAppContainer=h;exports.MicroRouteView=m;exports.MicroTabCache=p;exports.connectMicroRouter=M;exports.useMicroHost=v;exports.useMicroPage=w;exports.useMicroTab=d;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("vue"),f=require("./sdk.cjs"),d=Symbol("micro-tab");function m(){const t=e.inject(d);if(!t)throw new Error("useMicroTab 必须在 MicroTabCache 内调用");return t}const y=e.defineComponent({name:"MicroRouteView",props:{name:{type:String,default:"default"}},slots:Object,setup(t,{slots:n}){const i=m(),a=e.shallowRef(),r=e.shallowRef(!1);let u=!1,c=!1;async function o(){if(!(u||c)){c=!0,r.value=!1;try{const l=await Promise.resolve().then(()=>require("./router-view-impl-BvOToV_Z.cjs"));u||(a.value=l.MicroRouteViewImpl)}catch{u||(r.value=!0)}finally{c=!1}}}return e.onBeforeUnmount(()=>{u=!0}),o(),()=>{var l,s;return a.value?e.h(a.value,{name:t.name},n):r.value?((l=n.error)==null?void 0:l.call(n,{tab:i,code:"LOAD_FAILED",retry:o}))??e.h("div",{role:"alert","data-micro-route-error":"LOAD_FAILED"},[e.h("p","页面加载失败（LOAD_FAILED）"),e.h("button",{type:"button",onClick:o},"重新加载")]):((s=n.loading)==null?void 0:s.call(n,{tab:i}))??e.h("p",{role:"status"},"页面加载中…")}}});function v(t){return{hasPermission:n=>f.hasPermission(e.toValue(t),n),hasAny:n=>f.hasAny(e.toValue(t),n),hasAll:n=>f.hasAll(e.toValue(t),n),can:n=>e.computed(()=>f.hasPermission(e.toValue(t),e.toValue(n)))}}const b=e.defineComponent({name:"MicroAppContainer",props:{appId:{type:String,required:!0},runtime:{type:Object,required:!0},retryDisabled:Boolean},setup(t){const n=e.shallowRef(),i=e.shallowRef(""),a=e.shallowRef(!1);let r=!1;async function u(c=!1){if(!(r||a.value||!c&&t.retryDisabled)){a.value=!0,i.value="";try{await t.runtime.mount(t.appId,n.value)}catch{r||(i.value="子应用加载失败，请重试或联系管理员")}finally{r||(a.value=!1)}}}return e.onMounted(()=>{u(!0)}),e.onBeforeUnmount(()=>{r=!0,t.runtime.unmount(t.appId).catch(()=>console.error("[fin-micro] 子应用资源释放失败"))}),()=>e.h("section",{style:{height:"100%",minHeight:"420px"},"aria-busy":a.value},[i.value?e.h("div",{role:"alert"},[e.h("p",i.value),e.h("button",{type:"button",disabled:t.retryDisabled||a.value,onClick:()=>{u()}},"重新加载")]):null,a.value?e.h("p",{role:"status"},"子应用加载中…"):null,e.h("div",{ref:n,style:{height:"100%",minHeight:"420px"}})])}});function p(t){const n=e.shallowRef(t.getState()),i=t.subscribe(a=>{n.value=a});return e.onBeforeUnmount(i),n}const M=e.defineComponent({name:"MicroTabBoundary",props:{tab:{type:Object,required:!0},active:Boolean},setup(t,{slots:n}){const i=Object.freeze({...t.tab});e.provide(d,i);const a=e.defineComponent({name:"MicroTabContent",setup:()=>()=>{var r;return(r=n.default)==null?void 0:r.call(n,{tab:i})}});return()=>e.h("section",{hidden:!t.active,"data-micro-tab":i.key},[e.h(e.KeepAlive,null,{default:()=>t.active?e.h(a):null})])}}),w=e.defineComponent({name:"MicroTabCache",props:{tabs:{type:Array,required:!0},activeKey:String,max:{type:Number,default:20}},setup(t,{slots:n}){const i=e.shallowRef([]);return e.watch(()=>[t.tabs,t.activeKey,t.max],()=>{const a=new Set(t.tabs.map(o=>o.key));let r=i.value.filter(o=>a.has(o.key));const u=t.tabs.find(o=>o.key===t.activeKey);u&&(r=[...r.filter(o=>o.key!==u.key),u]);const c=Number.isFinite(t.max)?Math.max(1,Math.floor(t.max)):20;for(;r.length>c;){const o=r.findIndex(l=>l.key!==t.activeKey);if(o<0)break;r.splice(o,1)}i.value=r},{immediate:!0,flush:"sync"}),()=>i.value.map(a=>e.h(M,{key:a.key,tab:a,active:a.key===t.activeKey},n))}});function g(t,n,i=()=>console.error("[fin-micro] 路由同步失败")){let a=!1,r,u=!1,c=0;async function o(){if(!u){u=!0;try{let s=-1;for(;!a&&r&&s!==c;){s=c;try{await n.replace(r.route,r)}catch(h){try{i(h)}catch{}}}}finally{u=!1}}}const l=t.ready(s=>{r=s,c++,o()});return()=>{a=!0,l()}}function k(t,n){const i=t.page(n.key);return e.onBeforeUnmount(i.dispose),i}exports.MicroAppContainer=b;exports.MicroRouteView=y;exports.MicroTabCache=w;exports.connectMicroRouter=g;exports.useMicroHost=p;exports.useMicroPage=k;exports.useMicroTab=m;exports.usePermission=v;

package/dist/vue.mjs

@@ -1,22 +1,23 @@
-import { inject as b, defineComponent as s, shallowRef as d, onBeforeUnmount as y, h as u, onMounted as p, provide as h, KeepAlive as M, watch as g } from "vue";
-const m = Symbol("micro-tab");
-function k() {
-  const e = b(m);
+import { inject as p, defineComponent as y, shallowRef as d, onBeforeUnmount as m, h as u, onMounted as M, provide as g, KeepAlive as k, watch as A, computed as w, toValue as s } from "vue";
+import { hasPermission as v, hasAll as x, hasAny as C } from "./sdk.mjs";
+const b = Symbol("micro-tab");
+function D() {
+  const e = p(b);
   if (!e) throw new Error("useMicroTab 必须在 MicroTabCache 内调用");
   return e;
 }
-const A = s({
+const O = y({
   name: "MicroRouteView",
   props: { name: { type: String, default: "default" } },
   slots: Object,
   setup(e, { slots: t }) {
-    const r = k(), a = d(), n = d(!1);
+    const r = D(), a = d(), n = d(!1);
     let o = !1, c = !1;
     async function i() {
       if (!(o || c)) {
         c = !0, n.value = !1;
         try {
-          const l = await import("./router-view-impl-C1KG6mxu.mjs");
+          const l = await import("./router-view-impl-B1NzCGKV.mjs");
           o || (a.value = l.MicroRouteViewImpl);
         } catch {
           o || (n.value = !0);
@@ -25,7 +26,7 @@ const A = s({
         }
       }
     }
-    return y(() => {
+    return m(() => {
       o = !0;
     }), i(), () => {
       var l, f;
@@ -35,7 +36,16 @@ const A = s({
       ]) : ((f = t.loading) == null ? void 0 : f.call(t, { tab: r })) ?? u("p", { role: "status" }, "页面加载中…");
     };
   }
-}), C = s({
+});
+function L(e) {
+  return {
+    hasPermission: (t) => v(s(e), t),
+    hasAny: (t) => C(s(e), t),
+    hasAll: (t) => x(s(e), t),
+    can: (t) => w(() => v(s(e), s(t)))
+  };
+}
+const S = y({
   name: "MicroAppContainer",
   props: {
     appId: { type: String, required: !0 },
@@ -50,17 +60,17 @@ const A = s({
         a.value = !0, r.value = "";
         try {
           await e.runtime.mount(e.appId, t.value);
-        } catch (i) {
-          n || (r.value = String(i));
+        } catch {
+          n || (r.value = "子应用加载失败，请重试或联系管理员");
         } finally {
           n || (a.value = !1);
         }
       }
     }
-    return p(() => {
+    return M(() => {
       o(!0);
-    }), y(() => {
-      n = !0, e.runtime.unmount(e.appId).catch(console.error);
+    }), m(() => {
+      n = !0, e.runtime.unmount(e.appId).catch(() => console.error("[fin-micro] 子应用资源释放失败"));
     }), () => u("section", { style: { height: "100%", minHeight: "420px" }, "aria-busy": a.value }, [
       r.value ? u("div", { role: "alert" }, [
         u("p", r.value),
@@ -73,13 +83,13 @@ const A = s({
     ]);
   }
 });
-function D(e) {
+function j(e) {
   const t = d(e.getState()), r = e.subscribe((a) => {
     t.value = a;
   });
-  return y(r), t;
+  return m(r), t;
 }
-const w = s({
+const T = y({
   name: "MicroTabBoundary",
   props: {
     tab: { type: Object, required: !0 },
@@ -87,16 +97,16 @@ const w = s({
   },
   setup(e, { slots: t }) {
     const r = Object.freeze({ ...e.tab });
-    h(m, r);
-    const a = s({ name: "MicroTabContent", setup: () => () => {
+    g(b, r);
+    const a = y({ name: "MicroTabContent", setup: () => () => {
       var n;
       return (n = t.default) == null ? void 0 : n.call(t, { tab: r });
     } });
     return () => u("section", { hidden: !e.active, "data-micro-tab": r.key }, [
-      u(M, null, { default: () => e.active ? u(a) : null })
+      u(k, null, { default: () => e.active ? u(a) : null })
     ]);
   }
-}), T = s({
+}), B = y({
   name: "MicroTabCache",
   props: {
     tabs: { type: Array, required: !0 },
@@ -105,7 +115,7 @@ const w = s({
   },
   setup(e, { slots: t }) {
     const r = d([]);
-    return g(() => [e.tabs, e.activeKey, e.max], () => {
+    return A(() => [e.tabs, e.activeKey, e.max], () => {
       const a = new Set(e.tabs.map((i) => i.key));
       let n = r.value.filter((i) => a.has(i.key));
       const o = e.tabs.find((i) => i.key === e.activeKey);
@@ -117,14 +127,14 @@ const w = s({
         n.splice(i, 1);
       }
       r.value = n;
-    }, { immediate: !0, flush: "sync" }), () => r.value.map((a) => u(w, {
+    }, { immediate: !0, flush: "sync" }), () => r.value.map((a) => u(T, {
       key: a.key,
       tab: a,
       active: a.key === e.activeKey
     }, t));
   }
 });
-function I(e, t, r = console.error) {
+function R(e, t, r = () => console.error("[fin-micro] 路由同步失败")) {
   let a = !1, n, o = !1, c = 0;
   async function i() {
     if (!o) {
@@ -135,8 +145,11 @@ function I(e, t, r = console.error) {
           f = c;
           try {
             await t.replace(n.route, n);
-          } catch (v) {
-            r(v);
+          } catch (h) {
+            try {
+              r(h);
+            } catch {
+            }
           }
         }
       } finally {
@@ -151,16 +164,17 @@ function I(e, t, r = console.error) {
     a = !0, l();
   };
 }
-function K(e, t) {
+function q(e, t) {
   const r = e.page(t.key);
-  return y(r.dispose), r;
+  return m(r.dispose), r;
 }
 export {
-  C as MicroAppContainer,
-  A as MicroRouteView,
-  T as MicroTabCache,
-  I as connectMicroRouter,
-  D as useMicroHost,
-  K as useMicroPage,
-  k as useMicroTab
+  S as MicroAppContainer,
+  O as MicroRouteView,
+  B as MicroTabCache,
+  R as connectMicroRouter,
+  j as useMicroHost,
+  q as useMicroPage,
+  D as useMicroTab,
+  L as usePermission
 };

package/dist/watermark.cjs

@@ -0,0 +1,2 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const f=require("vue");function y(s,e,u,m){return typeof s=="number"&&Number.isFinite(s)?Math.min(m,Math.max(u,s)):e}function F(s){var r,i;const e=s&&typeof s=="object"?s:{},m=(typeof e.text=="string"?e.text.split(`
+`):Array.isArray(e.text)?e.text:["内部资料"]).filter(l=>typeof l=="string").slice(0,4).map(l=>l.slice(0,120)),c=typeof e.fontFamily=="string"&&e.fontFamily.length<=160&&!/[;{}\\\n\r]/.test(e.fontFamily)?e.fontFamily:"sans-serif";return Object.freeze({enabled:e.enabled!==!1,text:Object.freeze(m),color:typeof e.color=="string"&&e.color.length<=80?e.color:"#64748b",opacity:y(e.opacity,.12,0,1),rotate:y(e.rotate,-22,-180,180),fontSize:y(e.fontSize,16,10,64),fontFamily:c,gap:Object.freeze([y((r=e.gap)==null?void 0:r[0],100,16,600),y((i=e.gap)==null?void 0:i[1],80,16,600)])})}const D=f.defineComponent({__name:"FinWatermark",props:{config:{}},emits:["error"],setup(s,{emit:e}){const u=s,m=e,c=f.ref();let r=null,i,l,g="",d=!1,M=!1;function A(){i==null||i.disconnect(),i=void 0,l!==void 0&&clearInterval(l),l=void 0}function W(t){var O;const a=F(u.config),o=t.ownerDocument.createElement("canvas"),n=o.getContext("2d");if(!n)throw new Error("当前环境不支持 Canvas 2D，无法绘制水印。");const b=`${a.fontSize}px ${a.fontFamily}`;n.font=b;const p=Math.min(1e3,Math.max(1,...a.text.map(T=>n.measureText(T).width))),x=a.fontSize*1.5,w=Math.max(1,a.text.length)*x,h=a.rotate*Math.PI/180,z=Math.ceil(Math.abs(p*Math.cos(h))+Math.abs(w*Math.sin(h))+a.gap[0]),S=Math.ceil(Math.abs(p*Math.sin(h))+Math.abs(w*Math.cos(h))+a.gap[1]),v=Math.min(2,Math.max(1,((O=t.ownerDocument.defaultView)==null?void 0:O.devicePixelRatio)??1));o.width=Math.ceil(z*v),o.height=Math.ceil(S*v),n.scale(v,v),n.translate(z/2,S/2),n.rotate(h),n.font=b,n.fillStyle="#64748b",n.fillStyle=a.color,n.globalAlpha=a.opacity,n.textAlign="center",n.textBaseline="middle",a.text.forEach((T,j)=>n.fillText(T,0,(j-(a.text.length-1)/2)*x,1e3));const E=o.toDataURL("image/png");if(!E.startsWith("data:image/png"))throw new Error("Canvas 未生成有效水印图像。");return{url:E,width:z,height:S}}function _(t){i==null||i.observe(t,{attributes:!0}),r&&(i==null||i.observe(r,{childList:!0}))}function k(){var a;const t=c.value;if(!(!d||M||!t||!r)){M=!0,i==null||i.disconnect();try{t.parentNode!==r&&r.appendChild(t),t.style.cssText!==g&&(t.style.cssText=g),t.className&&t.removeAttribute("class"),t.hasAttribute("hidden")&&t.removeAttribute("hidden"),t.setAttribute("aria-hidden","true");const o=(a=t.ownerDocument.defaultView)==null?void 0:a.getComputedStyle(t);o&&(o.display==="none"||o.visibility!=="visible"||Number(o.opacity)===0)&&(t.style.cssText=g)}finally{M=!1,d&&_(t)}}}function C(){var o;A();const t=c.value;if(!t||!d)return;t.style.cssText="display:none !important;";const a=F(u.config);if(!(!a.enabled||!a.text.some(Boolean)))try{const n=W(t),b={position:"absolute",inset:"0",width:"100%",height:"100%",margin:"0",padding:"0",border:"0",display:"block",visibility:"visible",opacity:"1","pointer-events":"none","z-index":"2000",transform:"none",filter:"none","clip-path":"none","background-color":"transparent","background-image":`url("${n.url}")`,"background-size":`${n.width}px ${n.height}px`,"background-repeat":"repeat","background-position":"0 0","box-sizing":"border-box"};t.style.cssText="";for(const[x,w]of Object.entries(b))t.style.setProperty(x,w,"important");g=t.style.cssText;const p=(o=t.ownerDocument.defaultView)==null?void 0:o.MutationObserver;p&&(i=new p(k)),k(),l=setInterval(k,1e3)}catch(n){t.style.cssText="display:none !important;",m("error",n instanceof Error?n:new Error("水印绘制失败。")),console.warn("[fin-micro/watermark] 水印绘制失败，本次检查已停止。",n)}}return f.onMounted(()=>{var t;d=!0,r=((t=c.value)==null?void 0:t.parentElement)??null,C()}),f.watch(()=>u.config,C,{deep:!0}),f.onBeforeUnmount(()=>{var t;d=!1,A(),(t=c.value)==null||t.remove(),r=null}),(t,a)=>(f.openBlock(),f.createElementBlock("div",{ref_key:"layer",ref:c,"aria-hidden":"true","data-fin-watermark":""},null,512))}});exports.FinWatermark=D;exports.normalizeWatermarkConfig=F;