@gct-paas/core-web 0.1.6-dev.4 → 0.1.6-dev.41

package/es/modules/global-modal/src/BasicModal.vue.d.ts

@@ -64,7 +64,34 @@ declare function __VLS_template(): {
             footerOffset: number;
             visible: boolean;
             fullScreen: boolean;
-        }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        }, true, {}, {}, {
+            overlayScrollbarsComponent: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+                options: {
+                    type: import('vue').PropType<import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | false | null>;
+                    default: null;
+                };
+                handleColor: {
+                    type: StringConstructor;
+                    default: string;
+                };
+            }>, {
+                mergedOptions: import('vue').ComputedRef<false | import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions>;
+                colorStyle: import('vue').ComputedRef<import('vue').CSSProperties | undefined>;
+                setOsRef: (el: unknown) => void;
+            }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+                options: {
+                    type: import('vue').PropType<import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | false | null>;
+                    default: null;
+                };
+                handleColor: {
+                    type: StringConstructor;
+                    default: string;
+                };
+            }>> & Readonly<{}>, {
+                options: false | import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | null;
+                handleColor: string;
+            }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+        } & import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
             P: {};
             B: {};
             D: {};
@@ -448,7 +475,34 @@ declare const __VLS_component: import('vue').DefineComponent<import('vue').Extra
         footerOffset: number;
         visible: boolean;
         fullScreen: boolean;
-    }, true, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+    }, true, {}, {}, {
+        overlayScrollbarsComponent: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+            options: {
+                type: import('vue').PropType<import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | false | null>;
+                default: null;
+            };
+            handleColor: {
+                type: StringConstructor;
+                default: string;
+            };
+        }>, {
+            mergedOptions: import('vue').ComputedRef<false | import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions>;
+            colorStyle: import('vue').ComputedRef<import('vue').CSSProperties | undefined>;
+            setOsRef: (el: unknown) => void;
+        }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+            options: {
+                type: import('vue').PropType<import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | false | null>;
+                default: null;
+            };
+            handleColor: {
+                type: StringConstructor;
+                default: string;
+            };
+        }>> & Readonly<{}>, {
+            options: false | import('../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | null;
+            handleColor: string;
+        }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+    } & import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
         P: {};
         B: {};
         D: {};

package/es/modules/global-modal/src/BasicModal.vue_vue_type_script_setup_true_name_BasicModal_lang.mjs

@@ -5,7 +5,7 @@ import ModalClose_default from "./components/ModalClose.vue.mjs";
 import ModalFooter_default from "./components/ModalFooter.vue.mjs";
 import ModalHeader_default from "./components/ModalHeader.vue.mjs";
 import { useFullScreen } from "./hooks/useModalFullScreen.mjs";
-import { computed, createBlock, createCommentVNode, createSlots, createVNode, defineComponent, getCurrentInstance, mergeProps, nextTick, openBlock, ref, renderSlot, toRef, unref, useAttrs, watch, watchEffect, withCtx } from "vue";
+import { computed, createBlock, createVNode, defineComponent, getCurrentInstance, mergeProps, nextTick, openBlock, ref, renderSlot, toRef, unref, useAttrs, useSlots, watch, watchEffect, withCtx } from "vue";
 import { isFunction, omit } from "lodash-es";
 import { deepMerge, useNamespace } from "@gct-paas/core";
 //#region src/modules/global-modal/src/BasicModal.vue?vue&type=script&setup=true&name=BasicModal&lang.ts
@@ -22,6 +22,7 @@ var BasicModal_vue_vue_type_script_setup_true_name_BasicModal_lang_default = /*
 		"update:visible"
 	],
 	setup(__props, { emit: __emit }) {
+		const slots = useSlots();
 		const attrs = useAttrs();
 		const props = __props;
 		const emit = __emit;
@@ -126,75 +127,59 @@ var BasicModal_vue_vue_type_script_setup_true_name_BasicModal_lang_default = /*
 			handleFullScreen(e);
 		}
 		return (_ctx, _cache) => {
-			return openBlock(), createBlock(unref(GlboalModal_default), mergeProps(getBindValue.value, { onCancel: handleCancel }), createSlots({
-				default: withCtx(() => [
-					_ctx.$slots.closeIcon ? renderSlot(_ctx.$slots, "closeIcon", { key: 0 }) : createCommentVNode("", true),
-					_ctx.$slots.title ? renderSlot(_ctx.$slots, "title", { key: 1 }) : createCommentVNode("", true),
-					_ctx.$slots.footer ? renderSlot(_ctx.$slots, "footer", { key: 2 }) : createCommentVNode("", true),
-					createVNode(ModalWrapper_default, mergeProps({
-						ref_key: "modalWrapperRef",
-						ref: modalWrapperRef,
-						"use-wrapper": getProps.value.useWrapper,
-						"footer-offset": _ctx.wrapperFooterOffset,
-						"full-screen": unref(fullScreenRef),
-						loading: getProps.value.loading,
-						"loading-tip": getProps.value.loadingTip,
-						"min-height": getProps.value.minHeight,
-						height: getWrapperHeight.value,
-						visible: visibleRef.value,
-						"modal-footer-height": _ctx.footer !== void 0 && !_ctx.footer ? 0 : void 0
-					}, unref(omit)(getProps.value.wrapperProps, "visible", "height", "modalFooterHeight"), {
-						onExtHeight: handleExtHeight,
-						onHeightChange: handleHeightChange
-					}), {
-						default: withCtx(() => [renderSlot(_ctx.$slots, "default")]),
-						_: 3
-					}, 16, [
-						"use-wrapper",
-						"footer-offset",
-						"full-screen",
-						"loading",
-						"loading-tip",
-						"min-height",
-						"height",
-						"visible",
-						"modal-footer-height"
-					])
-				]),
-				_: 2
-			}, [
-				!_ctx.$slots.closeIcon ? {
-					name: "closeIcon",
-					fn: withCtx(() => [createVNode(ModalClose_default, {
-						"can-fullscreen": getProps.value.canFullscreen,
-						"full-screen": unref(fullScreenRef),
-						onCancel: handleCancel,
-						onFullscreen: unref(handleFullScreen)
-					}, null, 8, [
-						"can-fullscreen",
-						"full-screen",
-						"onFullscreen"
-					])]),
-					key: "0"
-				} : void 0,
-				!_ctx.$slots.title ? {
-					name: "title",
-					fn: withCtx(() => [createVNode(ModalHeader_default, {
-						"help-message": getProps.value.helpMessage,
-						title: getMergeProps.value.title,
-						onDblclick: handleTitleDbClick
-					}, null, 8, ["help-message", "title"])]),
-					key: "1"
-				} : void 0,
-				!_ctx.$slots.footer ? {
-					name: "footer",
-					fn: withCtx(() => [createVNode(ModalFooter_default, mergeProps(getBindValue.value, {
-						onOk: handleOk,
-						onCancel: handleCancel
-					}), null, 16)]),
-					key: "2"
-				} : void 0
-			]), 1040);
+			return openBlock(), createBlock(unref(GlboalModal_default), mergeProps(getBindValue.value, { onCancel: handleCancel }), {
+				closeIcon: withCtx(() => [unref(slots).closeIcon ? renderSlot(_ctx.$slots, "closeIcon", { key: 0 }) : (openBlock(), createBlock(ModalClose_default, {
+					key: 1,
+					"can-fullscreen": getProps.value.canFullscreen,
+					"full-screen": unref(fullScreenRef),
+					onCancel: handleCancel,
+					onFullscreen: unref(handleFullScreen)
+				}, null, 8, [
+					"can-fullscreen",
+					"full-screen",
+					"onFullscreen"
+				]))]),
+				title: withCtx(() => [unref(slots).title ? renderSlot(_ctx.$slots, "title", { key: 0 }) : (openBlock(), createBlock(ModalHeader_default, {
+					key: 1,
+					"help-message": getProps.value.helpMessage,
+					title: getMergeProps.value.title,
+					onDblclick: handleTitleDbClick
+				}, null, 8, ["help-message", "title"]))]),
+				footer: withCtx(() => [unref(slots).footer ? renderSlot(_ctx.$slots, "footer", { key: 0 }) : (openBlock(), createBlock(ModalFooter_default, mergeProps({ key: 1 }, getBindValue.value, {
+					onOk: handleOk,
+					onCancel: handleCancel
+				}), null, 16))]),
+				default: withCtx(() => [createVNode(ModalWrapper_default, mergeProps({
+					ref_key: "modalWrapperRef",
+					ref: modalWrapperRef,
+					"use-wrapper": getProps.value.useWrapper,
+					"footer-offset": _ctx.wrapperFooterOffset,
+					"full-screen": unref(fullScreenRef),
+					loading: getProps.value.loading,
+					"loading-tip": getProps.value.loadingTip,
+					"min-height": getProps.value.minHeight,
+					height: getWrapperHeight.value,
+					visible: visibleRef.value,
+					"modal-footer-height": _ctx.footer !== void 0 && !_ctx.footer ? 0 : void 0
+				}, unref(omit)(getProps.value.wrapperProps, "visible", "height", "modalFooterHeight"), {
+					onExtHeight: handleExtHeight,
+					onHeightChange: handleHeightChange
+				}), {
+					default: withCtx(() => [renderSlot(_ctx.$slots, "default")]),
+					_: 3
+				}, 16, [
+					"use-wrapper",
+					"footer-offset",
+					"full-screen",
+					"loading",
+					"loading-tip",
+					"min-height",
+					"height",
+					"visible",
+					"modal-footer-height"
+				])]),
+				_: 3
+			}, 16);
 		};
 	}
 });

package/es/modules/global-modal/src/components/ModalClose.vue_vue_type_style_index_0_lang.css

@@ -69,8 +69,6 @@
   margin-left: 27px;
 }
 .gct-basic-modal-close {
-  display: flex;
-  align-items: center;
   height: 95%;
 }
 .gct-basic-modal-close > span {
@@ -86,6 +84,7 @@
 .gct-basic-modal-close span:nth-child(1) {
   display: inline-block;
   padding: 10px;
+  padding-right: 0;
 }
 .gct-basic-modal-close span:nth-child(1):hover {
   color: var(--ant-primary-color);

package/es/modules/global-modal/src/components/ModalWrapper.vue.d.ts

@@ -92,5 +92,32 @@ declare const _default: import('vue').DefineComponent<import('vue').ExtractPropT
     footerOffset: number;
     visible: boolean;
     fullScreen: boolean;
-}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+}, {}, {
+    overlayScrollbarsComponent: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+        options: {
+            type: import('vue').PropType<import('../../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | false | null>;
+            default: null;
+        };
+        handleColor: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>, {
+        mergedOptions: import('vue').ComputedRef<false | import('../../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions>;
+        colorStyle: import('vue').ComputedRef<CSSProperties | undefined>;
+        setOsRef: (el: unknown) => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+        options: {
+            type: import('vue').PropType<import('../../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | false | null>;
+            default: null;
+        };
+        handleColor: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>> & Readonly<{}>, {
+        options: false | import('../../../../components/overlay-scrollbars/gct-overlay-scrollbars').IOsOptions | null;
+        handleColor: string;
+    }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
+}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
 export default _default;

package/es/modules/global-modal/src/components/ModalWrapper.vue_vue_type_script_lang.mjs

@@ -1,9 +1,11 @@
 import { createModalContext } from "../hooks/useModalContext.mjs";
+import { GctOverlayScrollbars } from "../../../../components/overlay-scrollbars/gct-overlay-scrollbars.mjs";
 import { computed, defineComponent, nextTick, onMounted, onUnmounted, ref, unref, watch, watchEffect } from "vue";
 import { useNamespace } from "@gct-paas/core";
 import { useMutationObserver, useWindowSize } from "@vueuse/core";
 var ModalWrapper_vue_vue_type_script_lang_default = defineComponent({
 	name: "ModalWrapper",
+	components: { overlayScrollbarsComponent: GctOverlayScrollbars },
 	inheritAttrs: false,
 	props: {
 		loading: { type: Boolean },
@@ -40,7 +42,6 @@ var ModalWrapper_vue_vue_type_script_lang_default = defineComponent({
 		const minRealHeightRef = ref(0);
 		const ns = useNamespace("basic-modal-wrapper");
 		let realHeight = 0;
-		let stopElResizeFn = () => {};
 		const spinStyle = ref();
 		const { width, height } = useWindowSize();
 		watch([height, width], () => {
@@ -80,9 +81,7 @@ var ModalWrapper_vue_vue_type_script_lang_default = defineComponent({
 			const { modalHeaderHeight, modalFooterHeight } = props;
 			emit("ext-height", modalHeaderHeight + modalFooterHeight);
 		});
-		onUnmounted(() => {
-			stopElResizeFn && stopElResizeFn();
-		});
+		onUnmounted(() => {});
 		async function scrollTop() {
 			nextTick(() => {
 				if (wrapperRef.value) wrapperRef.value.getElement()?.scrollTo(0, 0);

package/es/modules/online-control/content.vue.d.ts

@@ -0,0 +1,8 @@
+type __VLS_Props = {
+    /** 强制登出目标时间戳（毫秒） */
+    startRunTime: number;
+    /** 倒计时结束后的登出回调 */
+    loginOutEvent: () => void;
+};
+declare const _default: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/es/modules/online-control/content.vue.mjs

@@ -0,0 +1,5 @@
+import content_vue_vue_type_script_setup_true_lang_default from "./content.vue_vue_type_script_setup_true_lang.mjs";
+//#region src/modules/online-control/content.vue
+var content_default = content_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { content_default as default };

package/es/modules/online-control/content.vue_vue_type_script_setup_true_lang.mjs

@@ -0,0 +1,48 @@
+import { createElementBlock, defineComponent, onUnmounted, openBlock, ref, toDisplayString } from "vue";
+//#region src/modules/online-control/content.vue?vue&type=script&setup=true&lang.ts
+var _hoisted_1 = { class: "text-[##797A7D]" };
+var content_vue_vue_type_script_setup_true_lang_default = /* @__PURE__ */ defineComponent({
+	__name: "content",
+	props: {
+		startRunTime: {},
+		loginOutEvent: { type: Function }
+	},
+	setup(__props) {
+		/**
+		* 无操作超时倒计时内容组件
+		*
+		* 根据 startRunTime（强制登出目标时间戳）每秒刷新剩余「分 秒」，
+		* 倒计时归零后调用 loginOutEvent 执行登出。
+		*/
+		const props = __props;
+		/** 展示用剩余时间文案，如「 3 分 25 秒」 */
+		const lastTime = ref("");
+		/**
+		* 根据 startRunTime 计算并更新剩余时间
+		*
+		* @returns {boolean} 是否已超时（true 表示应触发登出）
+		*/
+		function setTimer() {
+			const earlyTime = (props.startRunTime - (/* @__PURE__ */ new Date()).getTime()) / 1e3;
+			if (earlyTime < 0) return true;
+			lastTime.value = ` ${Math.floor(earlyTime / 60)} 分 ${Math.floor(earlyTime % 60)} 秒`;
+			return false;
+		}
+		setTimer();
+		/** 每秒刷新倒计时，归零后清除定时器并登出 */
+		const timer = setInterval(() => {
+			if (setTimer()) {
+				clearInterval(timer);
+				props.loginOutEvent();
+			}
+		}, 1e3);
+		onUnmounted(() => {
+			clearInterval(timer);
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createElementBlock("div", _hoisted_1, " 在指定时间间隔内未操作页面，即将在" + toDisplayString(lastTime.value) + "后自动断开连接 ", 1);
+		};
+	}
+});
+//#endregion
+export { content_vue_vue_type_script_setup_true_lang_default as default };

package/es/modules/online-control/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 在线会话控制模块入口
+ *
+ * 提供基于平台安全设置的「无操作自动登出」能力，支持多标签页状态同步。
+ *
+ * @export
+ */
+export { OnlineControl } from './online-control';

package/es/modules/online-control/index.mjs

@@ -0,0 +1 @@
+import "./online-control.mjs";

package/es/modules/online-control/model-control.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 警告弹窗控制器
+ *
+ * @export
+ * @class ModelControl
+ */
+export declare class ModelControl {
+    /** 当前是否有警告弹窗在展示 */
+    static show: boolean;
+    /** ant-design-vue Modal 实例，用于 destroy 关闭 */
+    static modalVm: IObject | null;
+    /**
+     * 展示无操作超时警告弹窗
+     *
+     * startRunTime 传入「强制登出时刻」= startRunTime + earlyAlarm，
+     * 供 content 组件展示剩余分秒倒计时。
+     */
+    static showModel(): void;
+    /**
+     * 关闭警告弹窗
+     *
+     * 由本页用户操作或其他标签页 GCT_SAVELOGIN 消息触发。
+     */
+    static closeModel(): void;
+}

package/es/modules/online-control/model-control.mjs

@@ -0,0 +1,61 @@
+import { GCT_EVENT_TYPE } from "./online-control.const.mjs";
+import content_default from "./content.vue.mjs";
+import { onlineBroadcast } from "./online-broadcast.mjs";
+import { OnlineControl } from "./online-control.mjs";
+import { h } from "vue";
+import { t } from "@gct-paas/core";
+import { Modal as Modal$1 } from "ant-design-vue";
+//#region src/modules/online-control/model-control.ts
+/**
+* 无操作超时警告弹窗控制
+*
+* 负责展示「即将自动断开连接」的 Modal，渲染倒计时内容组件，
+* 并在用户点击「保持登录」时广播同步、恢复活动监听。
+*/
+/**
+* 警告弹窗控制器
+*
+* @export
+* @class ModelControl
+*/
+var ModelControl = class {
+	/** 当前是否有警告弹窗在展示 */
+	static show = false;
+	/** ant-design-vue Modal 实例，用于 destroy 关闭 */
+	static modalVm = null;
+	/**
+	* 展示无操作超时警告弹窗
+	*
+	* startRunTime 传入「强制登出时刻」= startRunTime + earlyAlarm，
+	* 供 content 组件展示剩余分秒倒计时。
+	*/
+	static showModel() {
+		this.show = true;
+		this.modalVm = Modal$1.warning({
+			title: t("sys.tip"),
+			content: () => h(content_default, {
+				startRunTime: OnlineControl.startRunTime + OnlineControl.earlyAlarm * 1e3,
+				loginOutEvent: OnlineControl.loginOutEvent
+			}),
+			okText: t("sys.app.maintainLoginStatus"),
+			onOk() {
+				onlineBroadcast.postMessage({ type: GCT_EVENT_TYPE.GCT_SAVELOGIN });
+				OnlineControl.addListener();
+			}
+		});
+	}
+	/**
+	* 关闭警告弹窗
+	*
+	* 由本页用户操作或其他标签页 GCT_SAVELOGIN 消息触发。
+	*/
+	static closeModel() {
+		this.show = false;
+		if (this.modalVm) {
+			this.modalVm.destroy();
+			this.modalVm = null;
+		}
+	}
+};
+//#endregion
+export { ModelControl };

package/es/modules/online-control/online-broadcast.d.ts

@@ -0,0 +1,2 @@
+/** 全局广播频道实例，频道名见 {@link BROADCAST} */
+export declare const onlineBroadcast: BroadcastChannel;

package/es/modules/online-control/online-broadcast.mjs

@@ -0,0 +1,30 @@
+import { BROADCAST, GCT_EVENT_TYPE } from "./online-control.const.mjs";
+import { ModelControl } from "./model-control.mjs";
+import { OnlineControl } from "./online-control.mjs";
+//#region src/modules/online-control/online-broadcast.ts
+/**
+* 跨标签页会话状态广播
+*
+* 基于 BroadcastChannel 在同源多标签页间同步用户活动、保持登录及登出事件，
+* 确保任一标签页的操作能重置全局无操作倒计时，避免重复弹窗或状态不一致。
+*/
+/** 全局广播频道实例，频道名见 {@link BROADCAST} */
+var onlineBroadcast = new BroadcastChannel(BROADCAST);
+/**
+* 处理其他标签页发来的会话控制消息
+*/
+onlineBroadcast.onmessage = (msg) => {
+	if (msg.data.type === GCT_EVENT_TYPE.GCT_MOUSEMOVE)
+ /** 其他标签页有用户操作，重置本页无操作倒计时 */
+	OnlineControl.startTimer();
+	if (msg.data.type === GCT_EVENT_TYPE.GCT_SAVELOGIN) {
+		/** 其他标签页点击了「保持登录」，关闭本页警告弹窗并恢复监听 */
+		ModelControl.closeModel();
+		OnlineControl.addListener();
+	}
+	if (msg.data.type === GCT_EVENT_TYPE.GCT_LOGINOUT)
+ /** 其他标签页已登出，本页同步跳转至登录页 */
+	location.href = `${location.origin}/paas-front/portal#/login`;
+};
+//#endregion
+export { onlineBroadcast };

package/es/modules/online-control/online-control.const.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 在线会话控制常量定义
+ *
+ * 包含跨标签页广播频道名及消息事件类型枚举。
+ *
+ * @export
+ */
+/** BroadcastChannel 频道名，所有标签页通过该频道同步会话状态 */
+export declare const BROADCAST: string;
+/**
+ * 跨标签页广播消息类型
+ *
+ * @export
+ * @enum {number}
+ */
+export declare enum GCT_EVENT_TYPE {
+    /**
+     * 鼠标/键盘活动事件
+     * 任一标签页检测到用户操作后广播，用于重置各标签页的无操作倒计时
+     */
+    GCT_MOUSEMOVE = "mousemove",
+    /**
+     * 保持登录事件
+     * 用户确认继续登录或初始化监听时广播，用于关闭警告弹窗并恢复监听
+     */
+    GCT_SAVELOGIN = "savelogin",
+    /**
+     * 登出事件
+     * 超时或用户确认登出后广播，各标签页统一跳转至登录页
+     */
+    GCT_LOGINOUT = "loginout"
+}

package/es/modules/online-control/online-control.const.mjs

@@ -0,0 +1,36 @@
+//#region src/modules/online-control/online-control.const.ts
+/**
+* 在线会话控制常量定义
+*
+* 包含跨标签页广播频道名及消息事件类型枚举。
+*
+* @export
+*/
+/** BroadcastChannel 频道名，所有标签页通过该频道同步会话状态 */
+var BROADCAST = "gct-online";
+/**
+* 跨标签页广播消息类型
+*
+* @export
+* @enum {number}
+*/
+var GCT_EVENT_TYPE = /* @__PURE__ */ function(GCT_EVENT_TYPE) {
+	/**
+	* 鼠标/键盘活动事件
+	* 任一标签页检测到用户操作后广播，用于重置各标签页的无操作倒计时
+	*/
+	GCT_EVENT_TYPE["GCT_MOUSEMOVE"] = "mousemove";
+	/**
+	* 保持登录事件
+	* 用户确认继续登录或初始化监听时广播，用于关闭警告弹窗并恢复监听
+	*/
+	GCT_EVENT_TYPE["GCT_SAVELOGIN"] = "savelogin";
+	/**
+	* 登出事件
+	* 超时或用户确认登出后广播，各标签页统一跳转至登录页
+	*/
+	GCT_EVENT_TYPE["GCT_LOGINOUT"] = "loginout";
+	return GCT_EVENT_TYPE;
+}({});
+//#endregion
+export { BROADCAST, GCT_EVENT_TYPE };

package/es/modules/online-control/online-control.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 在线会话控制器
+ *
+ * 根据平台安全设置（无操作保留时长、提前预警时长）监听用户活动，
+ * 超时前弹出警告，倒计时结束后强制登出；多标签页通过 BroadcastChannel 同步状态。
+ *
+ * @export
+ * @class OnlineControl
+ */
+export declare class OnlineControl {
+    /** 警告弹窗应弹出的目标时间戳（毫秒） */
+    static startRunTime: number;
+    /** 无操作保留总时长（秒），来自 securitySetting.noOpRetainHour + noOpRetainMinute */
+    static noOpRetain: number;
+    /** 提前预警时长（秒），弹窗内倒计时即为该时长，来自 earlyAlarmMinute + earlyAlarmSecond */
+    static earlyAlarm: number;
+    /** 轮询检测是否到达预警时间的定时器 ID */
+    static timer: string | number | null;
+    /**
+     * 初始化并开始监听用户活动
+     *
+     * 从平台配置读取安全策略，换算为秒后写入静态字段；
+     * 仅当 noOpRetain > 0 时启用监听，并广播 GCT_SAVELOGIN 同步其他标签页。
+     */
+    static runListener(): void;
+    /**
+     * 注册用户活动监听器
+     *
+     * 监听 mousemove、keydown，并通过 throttleMoverEvent 节流处理；
+     * 立即调用一次 throttleMoverEvent，使首次加载也计入活动并重置倒计时。
+     */
+    static addListener(): void;
+    /**
+     * 启动或重置无操作检测定时器
+     *
+     * 计算 startRunTime = 当前时间 + (noOpRetain - earlyAlarm)，
+     * 即「总无操作时长减去预警时长」后应弹出警告的时刻；
+     * 每 3 秒轮询一次，到达该时刻后触发 emitMoverEvent。
+     *
+     * 跳过条件：timer 未就绪、未配置保留时长、或当前页面在 iframe 内（个别嵌入页不启用）。
+     */
+    static startTimer(): void;
+    /**
+     * 到达无操作阈值，弹出警告弹窗
+     *
+     * 移除活动监听，避免弹窗展示期间重复触发；由 ModelControl 负责 UI 与后续登出。
+     */
+    static emitMoverEvent(): void;
+    /** 移除 document 上的 mousemove / keydown 监听 */
+    static removeListener(): void;
+    /**
+     * 关闭控制器
+     *
+     * 清除轮询定时器并移除活动监听，用于登出或模块卸载场景。
+     */
+    static closeControl(): void;
+    /**
+     * 执行登出
+     *
+     * 仅在警告弹窗仍展示时生效：广播 GCT_LOGINOUT 同步其他标签页，并调用 AuthUtil 登出。
+     */
+    static loginOutEvent(): void;
+}

package/es/modules/online-control/online-control.interface.d.ts

@@ -0,0 +1,21 @@
+import { GCT_EVENT_TYPE } from './online-control.const';
+/**
+ * 跨标签页广播消息体
+ *
+ * @export
+ * @interface BroadcastConfig
+ */
+export interface BroadcastConfig {
+    /**
+     * 消息类型，见 {@link GCT_EVENT_TYPE}
+     *
+     * @type {GCT_EVENT_TYPE}
+     */
+    type: GCT_EVENT_TYPE;
+    /**
+     * 附加数据，当前各事件类型均未使用，预留扩展
+     *
+     * @type {IObject}
+     */
+    data?: IObject;
+}