giime 1.1.5 → 1.1.6

package/es/components/src/plugins/message/method.d.ts

@@ -1,22 +1,22 @@
 import type { Message, MessageParams } from 'element-plus';
 export declare const messageTypes: readonly ["success", "info", "warning", "error"];
 export declare const normalizeMessageOptions: (params?: MessageParams) => Partial<{
+    icon?: (string | import("vue").Component) | undefined;
+    type: "error" | "primary" | "success" | "warning" | "info";
+    zIndex: number;
     message: string | import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
         [key: string]: any;
     }> | (() => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
         [key: string]: any;
     }>);
-    type: "error" | "primary" | "success" | "warning" | "info";
+    plain: boolean;
     customClass: string;
     dangerouslyUseHTMLString: boolean;
     duration: number;
-    icon?: (string | import("vue").Component) | undefined;
     onClose?: (() => void) | undefined;
     showClose: boolean;
-    plain: boolean;
     offset: number;
     placement?: ("top" | "bottom" | "top-left" | "top-right" | "bottom-left" | "bottom-right") | undefined;
-    zIndex: number;
     grouping: boolean;
     repeatNum: number;
     appendTo?: string | HTMLElement | undefined;

package/es/constants/key.d.ts

@@ -1,11 +1,20 @@
 import type { Router } from 'vue-router';
 import type { loginDialogProps } from '../components/src/business/loginDialog/loginDialog';
+import type { WatermarkOptions } from '../utils/src/watermark';
 import type { ExtractPublicPropTypes, InjectionKey, Ref } from 'vue';
 export interface ConfigProviderContext {
     env: ImportMetaEnv;
     router?: Router;
     disabledLoginDialog?: boolean;
     disabledRectSelect?: boolean;
+    /**
+     * 是否禁用全局自动水印（默认 false，即自动开启并在 iframe 嵌套时自动隐藏）
+     */
+    disabledWatermark?: boolean;
+    /**
+     * 全局水印自定义配置（传 false 等同于 disabledWatermark: true）
+     */
+    watermark?: WatermarkOptions | boolean;
     /**
      * 关闭 `document.body[data-giime-version]` 写入。
      *

package/es/constants/key.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"key.mjs","sources":["../../../../packages/constants/key.ts"],"sourcesContent":["import type { Router } from 'vue-router';\nimport type { loginDialogProps } from '../components/src/business/loginDialog/loginDialog';\nimport type { ExtractPublicPropTypes, InjectionKey, Ref } from 'vue';\nexport interface ConfigProviderContext {\n  // 用户端环境变量\n  env: ImportMetaEnv;\n  //   用户端路由\n  router?: Router;\n  disabledLoginDialog?: boolean;\n  disabledRectSelect?: boolean;\n  /**\n   * 关闭 `document.body[data-giime-version]` 写入。\n   *\n   * CRX content script 必传 `true` —— 这里的 `document.body` 是宿主页的 body，\n   * 写进去会覆盖宿主页（如果它本身也用 giime）的版本号；关闭插件时宿主页又把它写回去，\n   * 表现为 attribute 在两个版本之间来回跳。\n   */\n  disabledVersionAttr?: boolean;\n  loginDialog?: ExtractPublicPropTypes<typeof loginDialogProps>;\n  /**对消息进行配置 */\n  message?: {\n    plain?: boolean;\n  };\n  /**领域编码 */\n  domainCode?: string;\n  /**场景编码 */\n  sceneCode?: string;\n}\n\nexport const configProviderContextKey: InjectionKey<Ref<ConfigProviderContext>> = Symbol();\n\nexport const INSTALLED_KEY = Symbol('INSTALLED_KEY');\nexport const ImportMetaEnvKey: InjectionKey<ImportMetaEnv> = Symbol('ImportMetaEnvKey');\n\nexport const resetEnvMode = 'VITE_GIIME_MODE';\n"],"names":[],"mappings":"AA6BO,MAAM,2BAAqE,MAAA;AAE3E,MAAM,aAAA,GAAgB,OAAO,eAAe;AAC5C,MAAM,gBAAA,GAAgD,OAAO,kBAAkB;AAE/E,MAAM,YAAA,GAAe;;;;"}
+{"version":3,"file":"key.mjs","sources":["../../../../packages/constants/key.ts"],"sourcesContent":["import type { Router } from 'vue-router';\nimport type { loginDialogProps } from '../components/src/business/loginDialog/loginDialog';\nimport type { WatermarkOptions } from '../utils/src/watermark';\nimport type { ExtractPublicPropTypes, InjectionKey, Ref } from 'vue';\nexport interface ConfigProviderContext {\n  // 用户端环境变量\n  env: ImportMetaEnv;\n  //   用户端路由\n  router?: Router;\n  disabledLoginDialog?: boolean;\n  disabledRectSelect?: boolean;\n  /**\n   * 是否禁用全局自动水印（默认 false，即自动开启并在 iframe 嵌套时自动隐藏）\n   */\n  disabledWatermark?: boolean;\n  /**\n   * 全局水印自定义配置（传 false 等同于 disabledWatermark: true）\n   */\n  watermark?: WatermarkOptions | boolean;\n  /**\n   * 关闭 `document.body[data-giime-version]` 写入。\n   *\n   * CRX content script 必传 `true` —— 这里的 `document.body` 是宿主页的 body，\n   * 写进去会覆盖宿主页（如果它本身也用 giime）的版本号；关闭插件时宿主页又把它写回去，\n   * 表现为 attribute 在两个版本之间来回跳。\n   */\n  disabledVersionAttr?: boolean;\n  loginDialog?: ExtractPublicPropTypes<typeof loginDialogProps>;\n  /**对消息进行配置 */\n  message?: {\n    plain?: boolean;\n  };\n  /**领域编码 */\n  domainCode?: string;\n  /**场景编码 */\n  sceneCode?: string;\n}\n\nexport const configProviderContextKey: InjectionKey<Ref<ConfigProviderContext>> = Symbol();\n\nexport const INSTALLED_KEY = Symbol('INSTALLED_KEY');\nexport const ImportMetaEnvKey: InjectionKey<ImportMetaEnv> = Symbol('ImportMetaEnvKey');\n\nexport const resetEnvMode = 'VITE_GIIME_MODE';\n"],"names":[],"mappings":"AAsCO,MAAM,2BAAqE,MAAA;AAE3E,MAAM,aAAA,GAAgB,OAAO,eAAe;AAC5C,MAAM,gBAAA,GAAgD,OAAO,kBAAkB;AAE/E,MAAM,YAAA,GAAe;;;;"}

package/es/crx/src/login/LoginPrompt.vue.d.ts

@@ -18,8 +18,8 @@ type __VLS_Props = {
     cancelText?: string;
 };
 declare const _default: import("vue").DefineComponent<__VLS_TypePropsToOption<__VLS_Props>, unknown, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
-    confirm: () => void;
     cancel: () => void;
+    confirm: () => void;
 }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<__VLS_TypePropsToOption<__VLS_Props>>> & {
     onCancel?: (() => any) | undefined;
     onConfirm?: (() => any) | undefined;

package/es/giime/index.mjs

@@ -36,6 +36,7 @@ export { integerPattern, moneyPattern, nonNegativeIntegerPattern, nonNegativeNum
 export { base64Pattern, domainPattern, emailPattern, urlPattern } from '../utils/src/regexPatterns/url.mjs';
 export { getTenantType, isGiikin, isGiiktok } from '../utils/src/tenant.mjs';
 export { Clarity } from '../utils/src/clarity/index.mjs';
+export { GIIME_WATERMARK_GLOBAL_SYMBOL, GiimeWatermark, WATERMARK_DOM_CONSTANTS, WATERMARK_MESSAGE_TYPES, Watermark, buildWatermarkText, createWatermark, destroyWatermark, formatWatermarkDate, getWatermarkInstance, hasSameOriginAncestorWatermark, initWatermark, inspectSameOriginAncestors, isInIframe, resolveWatermarkUserId, sanitizeUserId, shouldRenderWatermark, useWatermark } from '../utils/src/watermark/index.mjs';
 export { affixEmits, affixProps } from '../components/src/base/affix/affix.mjs';
 export { GmAffix } from '../components/src/base/affix/index.mjs';
 export { alertEffects, alertEmits, alertProps } from '../components/src/base/alert/alert.mjs';

package/es/giime/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../../../../packages/giime/index.ts"],"sourcesContent":["import installer from './defaults';\nimport './tailwind.css';\nexport * from '@giime/utils';\nexport * from '@giime/components';\nexport * from '@giime/hooks';\n// export * from '@giime/api'; // 用户通过giime/es/api 导入类型\nexport const install = installer.install;\nexport const version = installer.version;\nexport default installer;\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,MAAM,UAAU,SAAA,CAAU;AAC1B,MAAM,UAAU,SAAA,CAAU;;;;"}
+{"version":3,"file":"index.mjs","sources":["../../../../packages/giime/index.ts"],"sourcesContent":["import installer from './defaults';\nimport './tailwind.css';\nexport * from '@giime/utils';\nexport * from '@giime/components';\nexport * from '@giime/hooks';\n// export * from '@giime/api'; // 用户通过giime/es/api 导入类型\nexport const install = installer.install;\nexport const version = installer.version;\nexport default installer;\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAMO,MAAM,UAAU,SAAA,CAAU;AAC1B,MAAM,UAAU,SAAA,CAAU;;;;"}

package/es/giime/makeInstaller.mjs

@@ -2,6 +2,7 @@ import '../constants/index.mjs';
 import { provideGlobalConfig } from '../hooks/base/useGlobalConfig/index.mjs';
 import { createLoginDialog } from '../components/src/business/loginDialog/method.mjs';
 import { createRectSelect } from '../components/src/base/rectSelect/createRectSelect.mjs';
+import { createWatermark } from '../utils/src/watermark/index.mjs';
 import { version } from './version.mjs';
 import { INSTALLED_KEY } from '../constants/key.mjs';
 
@@ -17,6 +18,10 @@ const makeInstaller = (components = []) => {
     if (!options.disabledRectSelect) {
       createRectSelect();
     }
+    if (!options.env?.SSR && !options.disabledWatermark && options.watermark !== false) {
+      const watermarkOptions = typeof options.watermark === "object" ? options.watermark : void 0;
+      createWatermark(watermarkOptions);
+    }
     if (!options.env.SSR && !options.disabledVersionAttr) {
       document?.body?.setAttribute?.("data-giime-version", version);
     }

package/es/giime/makeInstaller.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"makeInstaller.mjs","sources":["../../../../packages/giime/makeInstaller.ts"],"sourcesContent":["import { INSTALLED_KEY } from '@giime/constants';\nimport { provideGlobalConfig } from '@giime/hooks/base/useGlobalConfig';\nimport { createLoginDialog } from '@giime/components/src/business/loginDialog/method';\nimport { createRectSelect } from '@giime/components/src/base/rectSelect/createRectSelect';\nimport { version } from './version';\nimport type { ConfigProviderContext } from '@giime/constants';\nimport type { App, Plugin } from '@vue/runtime-core';\n\nexport const makeInstaller = (components: Plugin[] = []) => {\n  const install = (app: App, options: ConfigProviderContext) => {\n    if (app[INSTALLED_KEY]) return;\n\n    app[INSTALLED_KEY] = true;\n    // console.log(components);\n    components.forEach(c => app.use(c));\n    provideGlobalConfig(options, app, true);\n    if (!options.disabledLoginDialog) {\n      createLoginDialog();\n    }\n    if (!options.disabledRectSelect) {\n      createRectSelect();\n    }\n    // CRX content script 场景下 document.body 是宿主页的 body，写进去会污染宿主页的\n    // data-giime-version，宿主自己卸载 / 切换插件时还会出现版本号反复横跳。\n    // 通过 disabledVersionAttr 显式 opt-out。\n    if (!options.env.SSR && !options.disabledVersionAttr) {\n      document?.body?.setAttribute?.('data-giime-version', version);\n    }\n  };\n\n  return {\n    version,\n    install,\n  };\n};\n"],"names":[],"mappings":";;;;;;;AAQO,MAAM,aAAA,GAAgB,CAAC,UAAA,GAAuB,EAAC,KAAM;AAC1D,EAAA,MAAM,OAAA,GAAU,CAAC,GAAA,EAAU,OAAA,KAAmC;AAC5D,IAAA,IAAI,GAAA,CAAI,aAAa,CAAA,EAAG;AAExB,IAAA,GAAA,CAAI,aAAa,CAAA,GAAI,IAAA;AAErB,IAAA,UAAA,CAAW,OAAA,CAAQ,CAAA,CAAA,KAAK,GAAA,CAAI,GAAA,CAAI,CAAC,CAAC,CAAA;AAClC,IAAA,mBAAA,CAAoB,OAAA,EAAS,KAAK,IAAI,CAAA;AACtC,IAAA,IAAI,CAAC,QAAQ,mBAAA,EAAqB;AAChC,MAAA,iBAAA,EAAkB;AAAA,IACpB;AACA,IAAA,IAAI,CAAC,QAAQ,kBAAA,EAAoB;AAC/B,MAAA,gBAAA,EAAiB;AAAA,IACnB;AAIA,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,GAAA,IAAO,CAAC,QAAQ,mBAAA,EAAqB;AACpD,MAAA,QAAA,EAAU,IAAA,EAAM,YAAA,GAAe,oBAAA,EAAsB,OAAO,CAAA;AAAA,IAC9D;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA;AAAA,GACF;AACF;;;;"}
+{"version":3,"file":"makeInstaller.mjs","sources":["../../../../packages/giime/makeInstaller.ts"],"sourcesContent":["import { INSTALLED_KEY } from '@giime/constants';\nimport { provideGlobalConfig } from '@giime/hooks/base/useGlobalConfig';\nimport { createLoginDialog } from '@giime/components/src/business/loginDialog/method';\nimport { createRectSelect } from '@giime/components/src/base/rectSelect/createRectSelect';\nimport { createWatermark } from '@giime/utils/src/watermark';\nimport { version } from './version';\nimport type { ConfigProviderContext } from '@giime/constants';\nimport type { App, Plugin } from '@vue/runtime-core';\n\nexport const makeInstaller = (components: Plugin[] = []) => {\n  const install = (app: App, options: ConfigProviderContext) => {\n    if (app[INSTALLED_KEY]) return;\n\n    app[INSTALLED_KEY] = true;\n    // console.log(components);\n    components.forEach(c => app.use(c));\n    provideGlobalConfig(options, app, true);\n    if (!options.disabledLoginDialog) {\n      createLoginDialog();\n    }\n    if (!options.disabledRectSelect) {\n      createRectSelect();\n    }\n    if (!options.env?.SSR && !options.disabledWatermark && options.watermark !== false) {\n      const watermarkOptions = typeof options.watermark === 'object' ? options.watermark : undefined;\n      createWatermark(watermarkOptions);\n    }\n    // CRX content script 场景下 document.body 是宿主页的 body，写进去会污染宿主页的\n    // data-giime-version，宿主自己卸载 / 切换插件时还会出现版本号反复横跳。\n    // 通过 disabledVersionAttr 显式 opt-out。\n    if (!options.env.SSR && !options.disabledVersionAttr) {\n      document?.body?.setAttribute?.('data-giime-version', version);\n    }\n  };\n\n  return {\n    version,\n    install,\n  };\n};\n"],"names":[],"mappings":";;;;;;;;AASO,MAAM,aAAA,GAAgB,CAAC,UAAA,GAAuB,EAAC,KAAM;AAC1D,EAAA,MAAM,OAAA,GAAU,CAAC,GAAA,EAAU,OAAA,KAAmC;AAC5D,IAAA,IAAI,GAAA,CAAI,aAAa,CAAA,EAAG;AAExB,IAAA,GAAA,CAAI,aAAa,CAAA,GAAI,IAAA;AAErB,IAAA,UAAA,CAAW,OAAA,CAAQ,CAAA,CAAA,KAAK,GAAA,CAAI,GAAA,CAAI,CAAC,CAAC,CAAA;AAClC,IAAA,mBAAA,CAAoB,OAAA,EAAS,KAAK,IAAI,CAAA;AACtC,IAAA,IAAI,CAAC,QAAQ,mBAAA,EAAqB;AAChC,MAAA,iBAAA,EAAkB;AAAA,IACpB;AACA,IAAA,IAAI,CAAC,QAAQ,kBAAA,EAAoB;AAC/B,MAAA,gBAAA,EAAiB;AAAA,IACnB;AACA,IAAA,IAAI,CAAC,QAAQ,GAAA,EAAK,GAAA,IAAO,CAAC,OAAA,CAAQ,iBAAA,IAAqB,OAAA,CAAQ,SAAA,KAAc,KAAA,EAAO;AAClF,MAAA,MAAM,mBAAmB,OAAO,OAAA,CAAQ,SAAA,KAAc,QAAA,GAAW,QAAQ,SAAA,GAAY,KAAA,CAAA;AACrF,MAAA,eAAA,CAAgB,gBAAgB,CAAA;AAAA,IAClC;AAIA,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAA,CAAI,GAAA,IAAO,CAAC,QAAQ,mBAAA,EAAqB;AACpD,MAAA,QAAA,EAAU,IAAA,EAAM,YAAA,GAAe,oBAAA,EAAsB,OAAO,CAAA;AAAA,IAC9D;AAAA,EACF,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,OAAA;AAAA,IACA;AAAA,GACF;AACF;;;;"}

package/es/giime/version.d.ts

@@ -1 +1 @@
-export declare const version = "1.1.5";
+export declare const version = "1.1.6";

package/es/giime/version.mjs

@@ -1,4 +1,4 @@
-const version = "1.1.5";
+const version = "1.1.6";
 
 export { version };
 //# sourceMappingURL=version.mjs.map

package/es/giime/version.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.mjs","sources":["../../../../packages/giime/version.ts"],"sourcesContent":["export const version = '1.1.5';\n"],"names":[],"mappings":"AAAO,MAAM,OAAA,GAAU;;;;"}
+{"version":3,"file":"version.mjs","sources":["../../../../packages/giime/version.ts"],"sourcesContent":["export const version = '1.1.6';\n"],"names":[],"mappings":"AAAO,MAAM,OAAA,GAAU;;;;"}

package/es/track/__tests__/reliability.test.d.ts

@@ -0,0 +1 @@
+export {};

package/es/track/__tests__/track.test.d.ts

@@ -0,0 +1 @@
+export {};

package/es/track/axios.d.ts

@@ -0,0 +1 @@
+export * from './src/adapters/axios';

package/es/track/html.d.ts

@@ -0,0 +1 @@
+export * from './src/adapters/html';

package/es/track/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @file @giime/track 统一导出入口
+ */
+export * from './src/types';
+export * from './src/utils/id';
+export * from './src/utils/env';
+export * from './src/utils/browser';
+export * from './src/utils/dom';
+export * from './src/core/session';
+export * from './src/core/queue';
+export * from './src/core/tracker';
+export * from './src/core/singleton';
+export * from './src/adapters/vue3';
+export * from './src/adapters/vue2';
+export * from './src/adapters/axios';
+export * from './src/adapters/html';

package/es/track/src/adapters/axios.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @file Axios 接口请求异常采集适配器 (@giime/track/axios)
+ * @description 兼容 Axios 0.x (Vue2) 与 1.x (Vue3)，自动捕获 HTTP 错误、超时及业务码异常，自动忽略 401 登录失效
+ */
+import type { GiimeTracker } from '../core/tracker';
+export interface AttachAxiosOptions {
+    /** 成功业务码（默认支持 0 和 200） */
+    successCodes?: Array<number | string>;
+    /** 忽略上报的 HTTP 状态码或业务码（默认忽略 401 登录过期） */
+    ignoreCodes?: Array<number | string>;
+    /** 指定 Tracker 实例（缺省使用全局单例） */
+    tracker?: GiimeTracker;
+}
+/**
+ * 为 Axios 实例挂载统一请求异常埋点拦截器（幂等防重复挂载）
+ * @param axiosInstance Axios 实例
+ * @param options 拦截配置项
+ */
+export declare const attachAxiosTrack: (axiosInstance: any, options?: AttachAxiosOptions) => void;

package/es/track/src/adapters/html.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @file 商城多页 HTML (商城端 ShopPlus) 适配器与非侵入式双轨并行代理 (@giime/track/html)
+ * @description 100% 兼容商城存量 102 个埋点事件，支持新老 SDK 任意加载顺序零冲突共存
+ */
+import type { GiimeTracker } from '../core/tracker';
+import type { GiimeTrackConfig } from '../types';
+/**
+ * 安装商城 ShopPlus 双轨并行兼容层（支持新老脚本任意先后加载顺序，且修复 window.statistics 拼写 Bug）
+ * @param tracker Tracker 实例
+ */
+export declare const attachShopPlusDualTrackProxy: (tracker: GiimeTracker) => void;
+/**
+ * 初始化 HTML 多页模式埋点 SDK
+ * - 默认值全部为商城端模式（appType: 'shop', source: 'plus', env: 'prod'）
+ * - 也支持管理端 (manage) 的 HTML 项目使用：传入 data-app-type="manage" 或 initHtmlTrack({ appType: 'manage' }) 即可切换
+ * @param customConfig 可选自定义配置
+ */
+export declare const initHtmlTrack: (customConfig?: GiimeTrackConfig) => GiimeTracker;

package/es/track/src/adapters/vue2.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file Vue 2 适配器插件与指令 (@giime/track/vue2)
+ * @description 面向 gtmsfront 等 Vue 2.6 / 2.7 项目，零外部依赖，兼容 Vue CLI 与 Rsbuild 构建及自动翻译场景
+ */
+import type { GiimeTrackConfig } from '../types';
+import { type TrackDirectiveBindingValue } from './vue3';
+/**
+ * Vue 2 自定义埋点指令定义
+ */
+export declare const vTrackVue2Directive: {
+    bind(el: HTMLElement, binding: {
+        value?: TrackDirectiveBindingValue;
+    }): void;
+    inserted(el: HTMLElement, binding: {
+        value?: TrackDirectiveBindingValue;
+    }): void;
+    update(el: HTMLElement, binding: {
+        value?: TrackDirectiveBindingValue;
+    }): void;
+};
+/**
+ * Vue 2 插件配置项
+ */
+export interface TrackVue2PluginOptions extends GiimeTrackConfig {
+    /** Vue Router 3.x 实例 */
+    router?: {
+        afterEach?: (guard: (to: any, from: any) => void) => void;
+    };
+}
+/**
+ * Vue 2 插件安装器 (Vue.use(trackVue2Plugin, options))
+ */
+export declare const trackVue2Plugin: {
+    install(VueCtor: any, options?: TrackVue2PluginOptions): void;
+};

package/es/track/src/adapters/vue3.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @file Vue 3 适配器插件与指令 (@giime/track/vue3)
+ * @description 提供 app.use(trackVue3Plugin) 插件、v-track / v-giime-track 指令、router.afterEach 路由监听及 useGiimeTrack 组合式函数
+ */
+import type { GiimeTracker } from '../core/tracker';
+import type { GiimeTrackConfig } from '../types';
+/**
+ * v-track / v-giime-track 指令绑定值类型
+ */
+export type TrackDirectiveBindingValue = string | {
+    /** 元素稳定标识 elementId */
+    id: string;
+    /** 元素固定名称 elementName */
+    name?: string;
+    /** 元素类型 elementType */
+    type?: string;
+    /** 所属区域容器 containerId */
+    container?: string;
+    /** 关联业务对象类型 resourceType */
+    resourceType?: string;
+    /** 关联业务对象 ID resourceId */
+    resourceId?: string;
+    /** 是否同时开启元素视口曝光监控 */
+    exposure?: boolean;
+};
+/**
+ * 将指令绑定值写入 DOM 元素的 data-giime-* 属性（免疫自动翻译且供捕获委托提取）
+ */
+export declare const applyTrackDirectiveAttributes: (el: HTMLElement, value?: TrackDirectiveBindingValue) => void;
+/**
+ * Vue 3 自定义埋点指令（同时支持 mounted / updated 与 Vue 2 的 bind / update）
+ */
+export declare const vTrackDirective: {
+    mounted(el: HTMLElement, binding: {
+        value?: TrackDirectiveBindingValue;
+    }): void;
+    updated(el: HTMLElement, binding: {
+        value?: TrackDirectiveBindingValue;
+    }): void;
+    bind(el: HTMLElement, binding: {
+        value?: TrackDirectiveBindingValue;
+    }): void;
+    update(el: HTMLElement, binding: {
+        value?: TrackDirectiveBindingValue;
+    }): void;
+};
+/**
+ * Vue 3 插件配置项
+ */
+export interface TrackVue3PluginOptions extends GiimeTrackConfig {
+    /** Vue Router 实例（传入后自动挂载 afterEach 采集路由切换） */
+    router?: {
+        afterEach?: (guard: (to: any, from: any) => void) => void;
+    };
+}
+/**
+ * 绑定 Vue Router (3.x / 4.x) 的 afterEach 钩子（带防重锁）
+ */
+export declare const attachVueRouterTrack: (router: TrackVue3PluginOptions['router'], tracker: GiimeTracker) => void;
+/**
+ * Vue 3 插件安装器
+ */
+export declare const trackVue3Plugin: {
+    install(app: any, options?: TrackVue3PluginOptions): void;
+};
+/**
+ * Vue 3 Composition API 获取全局 Tracker 实例
+ */
+export declare const useGiimeTrack: (config?: GiimeTrackConfig) => GiimeTracker;

package/es/track/src/collectors/click.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file 元素点击全埋点（捕获阶段委托、300ms 防连点、GmButton 去重、愤怒点击检测、多语言原文保留）
+ * @description 严格对齐《单点埋点系统（AI中台).md》3.2 节 elementClick 及会议防口径污染要求
+ */
+import type { GiimeTracker } from '../core/tracker';
+/**
+ * 安装全局元素点击与愤怒点击采集器
+ * @param tracker Tracker 实例
+ */
+export declare const setupClickCollector: (tracker: GiimeTracker) => (() => void);

package/es/track/src/collectors/error.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @file 通用异常事件采集器（errorResourceLoad 资源加载异常 / errorRuntime 前端运行异常 / errorRequest 接口请求异常）
+ * @description
+ * 严格对齐《单点埋点系统（AI中台).md》第 8 章通用异常事件字段定义。
+ * 内置全局 XMLHttpRequest 与 fetch 非侵入式异常监听：
+ * - 宿主项目无需使用或升级 giime，也无需手动修改 axios/request.js，只要引入 @giime/track 即可自动捕获所有接口异常！
+ */
+import type { GiimeTracker } from '../core/tracker';
+/**
+ * 安装全局资源加载、JS 运行时异常、以及 XHR/Fetch 接口请求异常采集器
+ * @param tracker Tracker 实例
+ */
+export declare const setupErrorCollector: (tracker: GiimeTracker) => (() => void);

package/es/track/src/collectors/exposure.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @file 元素视口曝光采集器（基于 IntersectionObserver + MutationObserver 自动监听动态节点）
+ * @description 对齐《单点埋点系统（AI中台).md》3.2 节 elementExposure（记录 visibleRatio 与 exposureDuration）
+ */
+import type { GiimeTracker } from '../core/tracker';
+/**
+ * 原生 Observer 优先；不支持时使用节流滚动、窗口变化和低频检查继续采集曝光。
+ */
+export declare const setupExposureCollector: (tracker: GiimeTracker) => (() => void);

package/es/track/src/collectors/formAndCopy.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file 表单交互（inputFocus / inputBlur / inputChange / optionChange / formSubmit）与内容复制（contentCopyResult）采集器
+ * @description 严格遵循隐私边界：仅采集操作的字段编码 fieldId 与是否有值 hasValue，不默认采集用户输入的敏感原文
+ */
+import type { GiimeTracker } from '../core/tracker';
+/**
+ * 安装表单交互与剪贴板复制采集器
+ * @param tracker Tracker 实例
+ */
+export declare const setupFormAndCopyCollector: (tracker: GiimeTracker) => (() => void);

package/es/track/src/collectors/hover.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file 元素有效悬停（Hover Intent >= 500ms）与鼠标放上去才显示的内容（Tooltip / Popover / Dropdown）采集器
+ * @description 对齐《单点埋点系统（AI中台).md》3.2 节 elementHover 与数据团队“鼠标悬浮到哪、放上去才显示的东西”诉求
+ */
+import type { GiimeTracker } from '../core/tracker';
+/**
+ * 安装元素悬停与悬浮显隐采集器
+ * @param tracker Tracker 实例
+ */
+export declare const setupHoverCollector: (tracker: GiimeTracker) => (() => void);

package/es/track/src/collectors/lifecycle.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @file 页面访问、加载性能、可见状态切换、定时页面心跳（含视区可见元素集合）与页面离开采集器
+ * @description 严格对齐《单点埋点系统（AI中台).md》3.1 节与评审会“新增页面心跳、关联视区具体元素列表”决议
+ */
+import type { GiimeTracker } from '../core/tracker';
+/**
+ * 安装页面生命周期与心跳采集器
+ * @param tracker Tracker 实例
+ */
+export declare const setupLifecycleCollector: (tracker: GiimeTracker) => (() => void);
+/**
+ * 计算当前页面垂直滚动深度百分比 (0 ~ 100)
+ */
+export declare const computeCurrentScrollDepth: () => number;

package/es/track/src/collectors/scrollAndPath.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @file 页面滚动（深度百分比、停顿区域、关联可见元素）与鼠标/手势划过元素轨迹序列（RLE 游程压缩）采集器
+ * @description 对齐《单点埋点系统（AI中台).md》3.2 节 pageScroll 及数据团队“滚动到哪、注意力在哪、鼠标划过哪些元素”诉求
+ */
+import type { GiimeTracker } from '../core/tracker';
+/**
+ * 安装滚动深度与鼠标/手势轨迹采集器
+ * @param tracker Tracker 实例
+ */
+export declare const setupScrollAndPathCollector: (tracker: GiimeTracker) => (() => void);

package/es/track/src/core/pendingStore.d.ts

@@ -0,0 +1,7 @@
+import type { TrackEventRecord } from '../types';
+/** 读取兼容旧版失败池的待确认事件，保留原 eventId */
+export declare const readPendingEvents: () => TrackEventRecord[];
+/** 合并同源待确认事件，仅删除本次已获得 HTTP 确认的记录 */
+export declare const persistPendingEvents: (events: TrackEventRecord[], limit: number, acknowledgedIds?: string[]) => boolean;
+/** 以实际 UTF-8 字节数计算载荷，兼容没有 TextEncoder 的浏览器 */
+export declare const getUtf8ByteLength: (value: string) => number;

package/es/track/src/core/queue.d.ts

@@ -0,0 +1,68 @@
+import type { BrowserContext, GiimeTrackConfig, TrackBatchEnvelope, TrackBatchListener, TrackEventListener, TrackEventRecord } from '../types';
+/** 批量发送与待确认事件管理器 */
+export declare class TrackBatchQueue {
+    private config;
+    private getBrowserContext;
+    private queue;
+    private flushTimer;
+    private retryTimer;
+    private retryDelay;
+    private onlineHandler;
+    private flushPromise;
+    private inFlightEvents;
+    private beaconQueuedIds;
+    private persistenceScheduled;
+    private isDestroyed;
+    private eventListeners;
+    private batchListeners;
+    private sentBatchesHistory;
+    constructor(config: GiimeTrackConfig, getBrowserContext: () => BrowserContext);
+    /** 更新配置并重启常规发送时钟 */
+    updateConfig(nextConfig: Partial<GiimeTrackConfig>): void;
+    /** 待发队列与持久化失败池均由常规时钟检查 */
+    private startFlushTimer;
+    /** 持久化在途与待发事件；成功确认前不删除副本 */
+    private persist;
+    /** 合并同一轮采集的存储写入，避免每个同步事件重复序列化整个队列 */
+    private schedulePersistence;
+    /** 读取未确认副本，避免同一个事件重复进入本实例的内存 / 在途队列 */
+    private restorePending;
+    /** 单条事件入队；容量耗尽时仍按约定保留最近事件 */
+    enqueue(event: TrackEventRecord): void;
+    /** 并发调用共享同一个发送任务；离页时先同步保留副本 */
+    flush(isUnload?: boolean): Promise<boolean>;
+    /** 同时按事件条数与 UTF-8 字节分批，外层仅保留 { events }，将 batchId / sendTime 等收拢到每条 event 内 */
+    private buildEnvelopes;
+    /** 失败退回内存并等待重试；HTTP 确认后只移除本批事件 */
+    private flushCurrentQueue;
+    /** 连续失败有界退避，不依赖 online 事件才能恢复 */
+    private scheduleRetry;
+    /** 传输超时后释放队列；支持 AbortController 时同时终止实际请求 */
+    private sendEnvelope;
+    /**
+     * 获取当前内存队列长度
+     */
+    getQueueLength(): number;
+    /**
+     * 获取当前内存队列快照
+     */
+    getPendingEvents(): TrackEventRecord[];
+    /**
+     * 获取已发送批次历史记录
+     */
+    getSentBatchesHistory(): {
+        envelope: TrackBatchEnvelope;
+        mode: "fetch" | "custom" | "beacon";
+        success: boolean;
+    }[];
+    /**
+     * 订阅单条事件入队通知
+     */
+    onEvent(listener: TrackEventListener): () => void;
+    /**
+     * 订阅批次发送通知
+     */
+    onBatch(listener: TrackBatchListener): () => void;
+    /** 停止定时任务并保留未确认副本 */
+    destroy(): void;
+}

package/es/track/src/core/session.d.ts

@@ -0,0 +1,138 @@
+/**
+ * @file 页面链路、访问会话、前台可见激活时长计时器与商城 ShopPlus 上下文管理器
+ */
+import type { GiimeTrackConfig, ShopPlusContext } from '../types';
+/**
+ * 会话与页面上下文管理器
+ */
+export declare class TrackSessionManager {
+    private config;
+    private uid;
+    /** 连续访问会话标识（原 sessionId，30分钟超时重建，商城端 shop 映射为 eid） */
+    private visitId;
+    /** 页面会话标识（原 pageId，每次进入或刷新页面生成新值） */
+    private sessionId;
+    /** 上一页会话标识（原 prePageId，串联跨页跳转链路） */
+    private preSessionId;
+    private pageKey;
+    private pageName;
+    private functionId;
+    private currentUrl;
+    private currentReferrer;
+    /** 当前页面进入时间戳 */
+    private pageEnterTime;
+    /** 当前可见片段开始计时时间戳（hidden 时为 0） */
+    private visibleSegmentStart;
+    /** 已累计的前台激活可见时长（毫秒） */
+    private accumulatedActiveMs;
+    /** 当前页面心跳序号（从 1 开始） */
+    private heartbeatSeq;
+    /** 本次会话是否命中采样 */
+    private sampled;
+    constructor(config: GiimeTrackConfig);
+    /**
+     * 更新配置
+     */
+    updateConfig(nextConfig: Partial<GiimeTrackConfig>): void;
+    /**
+     * 初始化设备永久标识 uid 与连续访问会话标识 visitId
+     */
+    private initIdentityAndSession;
+    /**
+     * 检查或续期连续访问会话 visitId（超过 30 分钟重建）
+     */
+    refreshOrKeepSession(): string;
+    /**
+     * 根据连续访问会话 ID 的哈希决定是否命中采样（保证同一会话要么全采要么全不采）
+     */
+    private updateSampleDecision;
+    /**
+     * 是否命中采样且总开关开启
+     */
+    isShouldCollect(): boolean;
+    /**
+     * 进入新页面或路由切换时重置页面会话上下文与可见时长计时器
+     */
+    startNewPageContext(options?: {
+        pageKey?: string;
+        pageName?: string;
+        functionId?: string;
+        url?: string;
+        entryType?: string;
+    }): {
+        sessionId: string;
+        preSessionId: string;
+    };
+    /**
+     * 当页面可见状态改变时更新前台激活计时器
+     * @param isVisible 当前是否处于可见状态
+     */
+    onVisibilityChange(isVisible: boolean): number;
+    /**
+     * 获取当前页面累计处于激活且可见状态的时长（毫秒，对齐《单点埋点系统》 activeDuration）
+     */
+    getActiveDurationMs(): number;
+    /**
+     * 获取自进入页面以来的总跨度时长（毫秒，兼容商城 duration 字段）
+     */
+    getTotalElapsedMs(): number;
+    /**
+     * 递增并获取当前页面心跳序号
+     */
+    nextHeartbeatSequence(): number;
+    /**
+     * 获取商城当前购物会话 eid
+     */
+    getShopPlusEid(): string;
+    /**
+     * 获取商城上一次成单会话 preEid
+     */
+    getShopPlusPreEid(): string;
+    /**
+     * 订单创建成功后切分商城购物会话 eid -> preEid（对齐 statistics.[hash].ts 的 removeEid）
+     */
+    cutShopPlusEid(): void;
+    /**
+     * 解析来源标识 source（2026-10-23 评审会决议：商城端 shop 区分老单页 / ShopPlus / 三方 / Shopline / Shopify 等，管理端 manage 默认 ''）
+     */
+    resolveSource(): string;
+    /**
+     * 提取页面模板标识（会议决议：支持商城同一商品链接切换多套皮肤模板归因）
+     */
+    resolveTemplateId(): string;
+    /**
+     * 提取商城 ShopPlus 全量业务上下文（100% 兼容 statistics.[hash].ts 的 getBase 逻辑）
+     */
+    collectShopPlusContext(): ShopPlusContext | null;
+    /**
+     * 提取商城结算页购物车商品 saleId
+     */
+    private extractCheckoutSaleId;
+    /**
+     * 提取商城流量来源 from 参数
+     */
+    private extractShopPlusFrom;
+    /**
+     * 提取商城落地页 queryParams
+     */
+    private extractShopPlusQueryParams;
+    /**
+     * 获取当前快照数据供组装标准事件使用
+     */
+    getSnapshot(): {
+        userId: string;
+        uid: string;
+        source: string;
+        visitId: string;
+        sessionId: string;
+        preSessionId: string;
+        pageKey: string;
+        pageName: string;
+        functionId: string | undefined;
+        moduleId: string | undefined;
+        systemId: string | undefined;
+        url: string;
+        referrer: string;
+        templateId: string;
+    };
+}