@anker-in/headless-ui 1.1.33 → 1.1.34-alpha.1768461697532

package/dist/esm/biz-components/IPRedirect/useDetectedRegionRedirect.d.ts

@@ -0,0 +1,51 @@
+import type { RegionConfig } from './type.js';
+export interface UseDetectedRegionRedirectOptions {
+    /**
+     * 检测到的地区代码（从 useIPRedirect 的 onDetectRegion 返回）
+     */
+    detectedRegion: string | null;
+    /**
+     * 当前站点的地区代码
+     */
+    currentRegionCode: string;
+    /**
+     * 地区配置列表
+     */
+    regions: RegionConfig[];
+    /**
+     * 白名单路径（在白名单中不执行跳转）
+     */
+    excludePaths?: string[];
+    /**
+     * 当前路径
+     */
+    pathname?: string;
+    /**
+     * 用户是否手动关闭了横幅（关闭横幅后不再自动跳转）
+     */
+    userDismissedBanner?: boolean;
+    /**
+     * 自动跳转处理函数
+     */
+    onRedirect: (region: RegionConfig, isCookieRedirect?: boolean) => void | Promise<void>;
+}
+/**
+ * IP 检测地区跳转监听 Hook
+ *
+ * 监听 IP 检测到的推荐地区（来自 useIPRedirect 的 detectedRegion），
+ * 如果检测到的地区与当前地区不匹配，自动跳转到推荐地区
+ *
+ * @example
+ * ```tsx
+ * useDetectedRegionRedirect({
+ *   detectedRegion,        // 从 useIPRedirect 获取
+ *   currentRegionCode,
+ *   regions,
+ *   excludePaths,
+ *   pathname,
+ *   userDismissedBanner,
+ *   onRedirect: handleAutoRedirect,  // 从 useAutoRedirect 获取
+ * })
+ * ```
+ */
+export declare function useDetectedRegionRedirect(options: UseDetectedRegionRedirectOptions): void;

package/dist/esm/biz-components/IPRedirect/useDetectedRegionRedirect.js

@@ -0,0 +1,2 @@
+import{useEffect as R}from"react";import{isPathInWhitelist as f}from"./utils.js";function p(c){const{detectedRegion:e,currentRegionCode:i,regions:t,excludePaths:n=[],pathname:o="",userDismissedBanner:r=!1,onRedirect:s}=c;R(()=>{if(f(o,n)||r||!e||e===i)return;const d=t.find(g=>g.code===e);d&&s(d)},[e,i,t,r,s,o,n])}export{p as useDetectedRegionRedirect};
+//# sourceMappingURL=useDetectedRegionRedirect.js.map

package/dist/esm/biz-components/IPRedirect/useDetectedRegionRedirect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/biz-components/IPRedirect/useDetectedRegionRedirect.tsx"],
+  "sourcesContent": ["import { useEffect } from 'react'\nimport { isPathInWhitelist } from './utils.js'\nimport type { RegionConfig } from './type.js'\n\nexport interface UseDetectedRegionRedirectOptions {\n  /**\n   * \u68C0\u6D4B\u5230\u7684\u5730\u533A\u4EE3\u7801\uFF08\u4ECE useIPRedirect \u7684 onDetectRegion \u8FD4\u56DE\uFF09\n   */\n  detectedRegion: string | null\n\n  /**\n   * \u5F53\u524D\u7AD9\u70B9\u7684\u5730\u533A\u4EE3\u7801\n   */\n  currentRegionCode: string\n\n  /**\n   * \u5730\u533A\u914D\u7F6E\u5217\u8868\n   */\n  regions: RegionConfig[]\n\n  /**\n   * \u767D\u540D\u5355\u8DEF\u5F84\uFF08\u5728\u767D\u540D\u5355\u4E2D\u4E0D\u6267\u884C\u8DF3\u8F6C\uFF09\n   */\n  excludePaths?: string[]\n\n  /**\n   * \u5F53\u524D\u8DEF\u5F84\n   */\n  pathname?: string\n\n  /**\n   * \u7528\u6237\u662F\u5426\u624B\u52A8\u5173\u95ED\u4E86\u6A2A\u5E45\uFF08\u5173\u95ED\u6A2A\u5E45\u540E\u4E0D\u518D\u81EA\u52A8\u8DF3\u8F6C\uFF09\n   */\n  userDismissedBanner?: boolean\n\n  /**\n   * \u81EA\u52A8\u8DF3\u8F6C\u5904\u7406\u51FD\u6570\n   */\n  onRedirect: (region: RegionConfig, isCookieRedirect?: boolean) => void | Promise<void>\n}\n\n/**\n * IP \u68C0\u6D4B\u5730\u533A\u8DF3\u8F6C\u76D1\u542C Hook\n *\n * \u76D1\u542C IP \u68C0\u6D4B\u5230\u7684\u63A8\u8350\u5730\u533A\uFF08\u6765\u81EA useIPRedirect \u7684 detectedRegion\uFF09\uFF0C\n * \u5982\u679C\u68C0\u6D4B\u5230\u7684\u5730\u533A\u4E0E\u5F53\u524D\u5730\u533A\u4E0D\u5339\u914D\uFF0C\u81EA\u52A8\u8DF3\u8F6C\u5230\u63A8\u8350\u5730\u533A\n *\n * @example\n * ```tsx\n * useDetectedRegionRedirect({\n *   detectedRegion,        // \u4ECE useIPRedirect \u83B7\u53D6\n *   currentRegionCode,\n *   regions,\n *   excludePaths,\n *   pathname,\n *   userDismissedBanner,\n *   onRedirect: handleAutoRedirect,  // \u4ECE useAutoRedirect \u83B7\u53D6\n * })\n * ```\n */\nexport function useDetectedRegionRedirect(options: UseDetectedRegionRedirectOptions): void {\n  const {\n    detectedRegion,\n    currentRegionCode,\n    regions,\n    excludePaths = [],\n    pathname = '',\n    userDismissedBanner = false,\n    onRedirect,\n  } = options\n\n  useEffect(() => {\n    // \u767D\u540D\u5355\u68C0\u67E5\uFF1A\u5982\u679C\u5F53\u524D URL/\u8DEF\u5F84\u5728\u767D\u540D\u5355\u4E2D\uFF0C\u4E0D\u6267\u884C\u81EA\u52A8\u8DF3\u8F6C\n    const inWhitelist = isPathInWhitelist(pathname, excludePaths)\n\n    if (inWhitelist) {\n      return\n    }\n\n    // \u5982\u679C\u7528\u6237\u5DF2\u624B\u52A8\u5173\u95ED\u6A2A\u5E45\uFF0C\u4E0D\u518D\u81EA\u52A8\u8DF3\u8F6C\n    if (userDismissedBanner) {\n      return\n    }\n\n    // \u5982\u679C\u6CA1\u6709\u68C0\u6D4B\u5230\u5730\u533A\uFF0C\u6216\u5730\u533A\u5339\u914D\uFF0C\u4E0D\u5904\u7406\n    if (!detectedRegion || detectedRegion === currentRegionCode) {\n      return\n    }\n\n    // \u83B7\u53D6\u76EE\u6807\u5730\u533A\u4FE1\u606F\u5E76\u81EA\u52A8\u8DF3\u8F6C\n    const targetRegion = regions.find(r => r.code === detectedRegion)\n\n    if (targetRegion) {\n      // \u8C03\u7528\u81EA\u52A8\u8DF3\u8F6C\u903B\u8F91\uFF08\u4FDD\u7559\u5F53\u524D\u8DEF\u5F84\uFF09\n      onRedirect(targetRegion)\n    }\n  }, [detectedRegion, currentRegionCode, regions, userDismissedBanner, onRedirect, pathname, excludePaths])\n}\n"],
+  "mappings": "AAAA,OAAS,aAAAA,MAAiB,QAC1B,OAAS,qBAAAC,MAAyB,aA2D3B,SAASC,EAA0BC,EAAiD,CACzF,KAAM,CACJ,eAAAC,EACA,kBAAAC,EACA,QAAAC,EACA,aAAAC,EAAe,CAAC,EAChB,SAAAC,EAAW,GACX,oBAAAC,EAAsB,GACtB,WAAAC,CACF,EAAIP,EAEJH,EAAU,IAAM,CAcd,GAZoBC,EAAkBO,EAAUD,CAAY,GAOxDE,GAKA,CAACL,GAAkBA,IAAmBC,EACxC,OAIF,MAAMM,EAAeL,EAAQ,KAAKM,GAAKA,EAAE,OAASR,CAAc,EAE5DO,GAEFD,EAAWC,CAAY,CAE3B,EAAG,CAACP,EAAgBC,EAAmBC,EAASG,EAAqBC,EAAYF,EAAUD,CAAY,CAAC,CAC1G",
+  "names": ["useEffect", "isPathInWhitelist", "useDetectedRegionRedirect", "options", "detectedRegion", "currentRegionCode", "regions", "excludePaths", "pathname", "userDismissedBanner", "onRedirect", "targetRegion", "r"]
+}

package/dist/esm/biz-components/IPRedirect/useIPRedirect.d.ts

@@ -0,0 +1,42 @@
+import type { RegionConfig } from './type.js';
+export type UseIPRedirectOptions = {
+    /** Cookie 名称,默认为 'user_region' */
+    cookieName?: string;
+    /** Cookie 过期天数,默认为 90 天 */
+    cookieExpireDays?: number;
+    /** 地区配置列表 */
+    regions: RegionConfig[];
+    /** 当前站点的地区代码（如 'US', 'CN' 等），用于判断是否需要跳转。强烈建议提供此参数以防止无限跳转 */
+    currentRegionCode?: string;
+    /** 可选的地区检测回调函数,返回检测到的地区代码。如不需要自动检测,可不传此参数 */
+    onDetectRegion?: () => Promise<string | null>;
+    /** 是否自动显示弹窗,默认为 true */
+    autoShow?: boolean;
+    /** 白名单列表，这些 URL/路径不会触发 IP 跳转和横幅显示。支持完整 URL（如 'https://www.anker.com/prime-2025'）、路径（如 '/checkout'）和通配符（如 '/checkout/*' 或 'https://www.anker.com/campaign/*'） */
+    excludePaths?: string[];
+    /** 当前页面路径（用于白名单检查） */
+    currentPath?: string;
+    /** 当前页面完整 URL（用于白名单检查） */
+    currentUrl?: string;
+};
+export type UseIPRedirectReturn = {
+    /** 是否显示地区选择弹窗 */
+    isOpen: boolean;
+    /** 设置弹窗显示状态 */
+    setIsOpen: (open: boolean) => void;
+    /** 用户已保存的地区代码 */
+    savedRegion: string | null;
+    /** 检测到的用户地区代码 */
+    detectedRegion: string | null;
+    /** 保存用户选择的地区 */
+    saveRegion: (regionCode: string, languageCode?: string) => void;
+    /** 清除已保存的地区选择 */
+    clearRegion: () => void;
+    /** 根据地区代码获取地区配置 */
+    getRegionByCode: (code: string) => RegionConfig | undefined;
+};
+/**
+ * 地区选择 Hook
+ * 用于管理用户地区选择和 Cookie 存储
+ */
+export declare function useIPRedirect(options: UseIPRedirectOptions): UseIPRedirectReturn;

package/dist/esm/biz-components/IPRedirect/useIPRedirect.js

@@ -0,0 +1,2 @@
+import{useState as R,useEffect as x,useCallback as S}from"react";import f from"js-cookie";function _(c,t,r){return!t||t.length===0?!1:t.some(n=>{if(n.startsWith("http://")||n.startsWith("https://")){if(!r)return!1;if(n.includes("*")){const i=n.replace(/\*/g,".*").replace(/\//g,"\\/");return new RegExp(`^${i}$`).test(r)}return r===n}if(n.includes("*")){const i=n.replace(/\*/g,".*");return new RegExp(`^${i}$`).test(c)}return c===n})}function b(c){const{cookieName:t="user_region",cookieExpireDays:r=90,regions:n,currentRegionCode:i,onDetectRegion:s,autoShow:a=!0,excludePaths:p=[],currentPath:m="",currentUrl:h=""}=c,[v,l]=R(!1),[u,d]=R(null),[P,y]=R(null);x(()=>{const e=f.get(t);e&&d(e)},[t]);const w=S((e,g)=>{const o=g?`v1_${e}_${g}`:`v1_${e}`;f.set(t,o,{expires:r}),d(e)},[t,r]);return x(()=>{if(_(m,p,h))return;const e=new URLSearchParams(window.location.search);if(e.get("_region_selected")){sessionStorage.setItem(`${t}_redirected`,"true"),e.delete("_region_selected");const o=window.location.pathname+(e.toString()?"?"+e.toString():"")+window.location.hash;window.history.replaceState({},"",o)}u||sessionStorage.getItem(`${t}_redirected`)||s&&s().then(o=>{o&&(y(o),i?o!==i&&a&&l(!0):a&&l(!0))})},[s,u,a,i,w,t,m,p,h]),{isOpen:v,setIsOpen:l,savedRegion:u,detectedRegion:P,saveRegion:w,clearRegion:()=>{f.remove(t),d(null)},getRegionByCode:e=>n.find(g=>g.code===e)}}export{b as useIPRedirect};
+//# sourceMappingURL=useIPRedirect.js.map

package/dist/esm/biz-components/IPRedirect/useIPRedirect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/biz-components/IPRedirect/useIPRedirect.ts"],
+  "sourcesContent": ["import { useState, useEffect, useCallback } from 'react'\nimport Cookies from 'js-cookie'\nimport type { RegionConfig } from './type.js'\n\nexport type UseIPRedirectOptions = {\n  /** Cookie \u540D\u79F0,\u9ED8\u8BA4\u4E3A 'user_region' */\n  cookieName?: string\n  /** Cookie \u8FC7\u671F\u5929\u6570,\u9ED8\u8BA4\u4E3A 90 \u5929 */\n  cookieExpireDays?: number\n  /** \u5730\u533A\u914D\u7F6E\u5217\u8868 */\n  regions: RegionConfig[]\n  /** \u5F53\u524D\u7AD9\u70B9\u7684\u5730\u533A\u4EE3\u7801\uFF08\u5982 'US', 'CN' \u7B49\uFF09\uFF0C\u7528\u4E8E\u5224\u65AD\u662F\u5426\u9700\u8981\u8DF3\u8F6C\u3002\u5F3A\u70C8\u5EFA\u8BAE\u63D0\u4F9B\u6B64\u53C2\u6570\u4EE5\u9632\u6B62\u65E0\u9650\u8DF3\u8F6C */\n  currentRegionCode?: string\n  /** \u53EF\u9009\u7684\u5730\u533A\u68C0\u6D4B\u56DE\u8C03\u51FD\u6570,\u8FD4\u56DE\u68C0\u6D4B\u5230\u7684\u5730\u533A\u4EE3\u7801\u3002\u5982\u4E0D\u9700\u8981\u81EA\u52A8\u68C0\u6D4B,\u53EF\u4E0D\u4F20\u6B64\u53C2\u6570 */\n  onDetectRegion?: () => Promise<string | null>\n  /** \u662F\u5426\u81EA\u52A8\u663E\u793A\u5F39\u7A97,\u9ED8\u8BA4\u4E3A true */\n  autoShow?: boolean\n  /** \u767D\u540D\u5355\u5217\u8868\uFF0C\u8FD9\u4E9B URL/\u8DEF\u5F84\u4E0D\u4F1A\u89E6\u53D1 IP \u8DF3\u8F6C\u548C\u6A2A\u5E45\u663E\u793A\u3002\u652F\u6301\u5B8C\u6574 URL\uFF08\u5982 'https://www.anker.com/prime-2025'\uFF09\u3001\u8DEF\u5F84\uFF08\u5982 '/checkout'\uFF09\u548C\u901A\u914D\u7B26\uFF08\u5982 '/checkout/*' \u6216 'https://www.anker.com/campaign/*'\uFF09 */\n  excludePaths?: string[]\n  /** \u5F53\u524D\u9875\u9762\u8DEF\u5F84\uFF08\u7528\u4E8E\u767D\u540D\u5355\u68C0\u67E5\uFF09 */\n  currentPath?: string\n  /** \u5F53\u524D\u9875\u9762\u5B8C\u6574 URL\uFF08\u7528\u4E8E\u767D\u540D\u5355\u68C0\u67E5\uFF09 */\n  currentUrl?: string\n}\n\nexport type UseIPRedirectReturn = {\n  /** \u662F\u5426\u663E\u793A\u5730\u533A\u9009\u62E9\u5F39\u7A97 */\n  isOpen: boolean\n  /** \u8BBE\u7F6E\u5F39\u7A97\u663E\u793A\u72B6\u6001 */\n  setIsOpen: (open: boolean) => void\n  /** \u7528\u6237\u5DF2\u4FDD\u5B58\u7684\u5730\u533A\u4EE3\u7801 */\n  savedRegion: string | null\n  /** \u68C0\u6D4B\u5230\u7684\u7528\u6237\u5730\u533A\u4EE3\u7801 */\n  detectedRegion: string | null\n  /** \u4FDD\u5B58\u7528\u6237\u9009\u62E9\u7684\u5730\u533A */\n  saveRegion: (regionCode: string, languageCode?: string) => void\n  /** \u6E05\u9664\u5DF2\u4FDD\u5B58\u7684\u5730\u533A\u9009\u62E9 */\n  clearRegion: () => void\n  /** \u6839\u636E\u5730\u533A\u4EE3\u7801\u83B7\u53D6\u5730\u533A\u914D\u7F6E */\n  getRegionByCode: (code: string) => RegionConfig | undefined\n}\n\n/**\n * \u68C0\u67E5\u5F53\u524D\u8DEF\u5F84\u662F\u5426\u5728\u767D\u540D\u5355\u4E2D\n * \u652F\u6301\u5B8C\u6574 URL \u5339\u914D\uFF08\u5982 https://www.anker.com/prime-2025\uFF09\n * \u4E5F\u652F\u6301\u8DEF\u5F84\u5339\u914D\uFF08\u5982 /prime-2025\uFF09\n */\nfunction isPathExcluded(currentPath: string, excludePaths: string[], currentUrl?: string): boolean {\n  if (!excludePaths || excludePaths.length === 0) {\n    return false\n  }\n\n  return excludePaths.some(pattern => {\n    // \u5982\u679C pattern \u662F\u5B8C\u6574 URL\uFF08\u4EE5 http:// \u6216 https:// \u5F00\u5934\uFF09\n    if (pattern.startsWith('http://') || pattern.startsWith('https://')) {\n      if (!currentUrl) return false\n\n      // \u652F\u6301\u901A\u914D\u7B26 * \u5339\u914D\u5B8C\u6574 URL\n      if (pattern.includes('*')) {\n        const regexPattern = pattern.replace(/\\*/g, '.*').replace(/\\//g, '\\\\/')\n        const regex = new RegExp(`^${regexPattern}$`)\n        return regex.test(currentUrl)\n      }\n      // \u7CBE\u786E\u5339\u914D\u5B8C\u6574 URL\n      return currentUrl === pattern\n    }\n\n    // \u5426\u5219\u4F5C\u4E3A\u8DEF\u5F84\u5339\u914D\n    // \u652F\u6301\u901A\u914D\u7B26 * \u5339\u914D\n    if (pattern.includes('*')) {\n      const regexPattern = pattern.replace(/\\*/g, '.*')\n      const regex = new RegExp(`^${regexPattern}$`)\n      return regex.test(currentPath)\n    }\n    // \u7CBE\u786E\u5339\u914D\n    return currentPath === pattern\n  })\n}\n\n/**\n * \u5730\u533A\u9009\u62E9 Hook\n * \u7528\u4E8E\u7BA1\u7406\u7528\u6237\u5730\u533A\u9009\u62E9\u548C Cookie \u5B58\u50A8\n */\nexport function useIPRedirect(options: UseIPRedirectOptions): UseIPRedirectReturn {\n  const {\n    cookieName = 'user_region',\n    cookieExpireDays = 90,\n    regions,\n    currentRegionCode,\n    onDetectRegion,\n    autoShow = true,\n    excludePaths = [],\n    currentPath = '',\n    currentUrl = '',\n  } = options\n\n  const [isOpen, setIsOpen] = useState(false)\n  const [savedRegion, setSavedRegion] = useState<string | null>(null)\n  const [detectedRegion, setDetectedRegion] = useState<string | null>(null)\n\n  // \u4ECE Cookie \u8BFB\u53D6\u5DF2\u4FDD\u5B58\u7684\u5730\u533A\n  useEffect(() => {\n    const saved = Cookies.get(cookieName)\n    if (saved) {\n      setSavedRegion(saved)\n    }\n  }, [cookieName])\n\n  // \u4FDD\u5B58\u7528\u6237\u9009\u62E9\u7684\u5730\u533A\n  const saveRegion = useCallback(\n    (regionCode: string, languageCode?: string) => {\n      // \u683C\u5F0F\uFF1Av1_\u56FD\u5BB6_\u8BED\u8A00\uFF08\u5982 v1_CA_EN\uFF09\n      // \u5982\u679C\u6CA1\u6709\u63D0\u4F9B languageCode\uFF0C\u4F7F\u7528 regionCode\uFF08\u5411\u540E\u517C\u5BB9\uFF09\n      const cookieValue = languageCode ? `v1_${regionCode}_${languageCode}` : `v1_${regionCode}`\n      Cookies.set(cookieName, cookieValue, { expires: cookieExpireDays })\n      setSavedRegion(regionCode)\n    },\n    [cookieName, cookieExpireDays]\n  )\n\n  // \u68C0\u6D4B\u7528\u6237\u5730\u533A\n  useEffect(() => {\n    // \u767D\u540D\u5355\u68C0\u67E5\uFF1A\u5982\u679C\u5F53\u524D URL/\u8DEF\u5F84\u5728\u767D\u540D\u5355\u4E2D\uFF0C\u4E0D\u6267\u884C\u4EFB\u4F55\u68C0\u6D4B\u548C\u8DF3\u8F6C\n    if (isPathExcluded(currentPath, excludePaths, currentUrl)) {\n      return\n    }\n\n    // \u68C0\u67E5 URL \u53C2\u6570\uFF0C\u5982\u679C\u5B58\u5728 _region_selected \u6807\u8BB0\uFF0C\u6E05\u7406\u6389\u5E76\u6807\u8BB0\u672C\u6B21\u4F1A\u8BDD\u5DF2\u8DF3\u8F6C\n    const urlParams = new URLSearchParams(window.location.search)\n    const wasRedirected = urlParams.get('_region_selected')\n\n    if (wasRedirected) {\n      // \u6E05\u7406 URL \u53C2\u6570\uFF0C\u4F46\u4E0D\u4FDD\u5B58 Cookie\n      // \u4F7F\u7528 sessionStorage \u8BB0\u5F55\u672C\u6B21\u4F1A\u8BDD\u5DF2\u8DF3\u8F6C\uFF0C\u907F\u514D\u5237\u65B0\u540E\u518D\u6B21\u8DF3\u8F6C\n      sessionStorage.setItem(`${cookieName}_redirected`, 'true')\n      urlParams.delete('_region_selected')\n      const newUrl =\n        window.location.pathname + (urlParams.toString() ? '?' + urlParams.toString() : '') + window.location.hash\n      window.history.replaceState({}, '', newUrl)\n    }\n\n    // \u5982\u679C\u5DF2\u6709\u4FDD\u5B58\u7684\u5730\u533A\u9009\u62E9\uFF0C\u4E0D\u518D\u68C0\u6D4B\n    if (savedRegion) {\n      return\n    }\n\n    // \u5982\u679C\u672C\u6B21\u4F1A\u8BDD\u5DF2\u7ECF\u8DF3\u8F6C\u8FC7\uFF0C\u4E0D\u518D\u68C0\u6D4B\n    if (sessionStorage.getItem(`${cookieName}_redirected`)) {\n      return\n    }\n\n    // \u6267\u884C IP \u68C0\u6D4B\n    if (onDetectRegion) {\n      onDetectRegion().then(detected => {\n        if (detected) {\n          setDetectedRegion(detected)\n\n          // \u5173\u952E\u5224\u65AD\uFF1A\u53EA\u6709\u5F53\u68C0\u6D4B\u5230\u7684\u5730\u533A\u4E0E\u5F53\u524D\u7AD9\u70B9\u4E0D\u540C\u65F6\u624D\u663E\u793A\u5F39\u7A97\n          if (currentRegionCode) {\n            if (detected !== currentRegionCode) {\n              if (autoShow) {\n                setIsOpen(true)\n              }\n            }\n            // \uD83D\uDD27 \u5982\u679C\u68C0\u6D4B\u5230\u7684\u5730\u533A\u4E0E\u5F53\u524D\u7AD9\u70B9\u5339\u914D\uFF0C\u4E0D\u4FDD\u5B58 Cookie\n            // Cookie \u53EA\u5728\u4EE5\u4E0B\u60C5\u51B5\u4FDD\u5B58\uFF1A\n            // 1. \u7528\u6237\u4ECE\u5176\u4ED6\u7AD9\u70B9\u8DF3\u8F6C\u8FC7\u6765\uFF08URL \u5E26 _region_selected \u53C2\u6570\uFF09\n            // 2. \u7528\u6237\u70B9\u51FB \"Stay Here\" \u6309\u94AE\u624B\u52A8\u4FDD\u5B58\n          } else {\n            // \u5982\u679C\u6CA1\u6709\u63D0\u4F9B currentRegionCode\uFF0C\u4F7F\u7528\u65E7\u7684\u884C\u4E3A\uFF08\u603B\u662F\u663E\u793A\u5F39\u7A97\uFF09\n            if (autoShow) {\n              setIsOpen(true)\n            }\n          }\n        }\n      })\n    }\n  }, [\n    onDetectRegion,\n    savedRegion,\n    autoShow,\n    currentRegionCode,\n    saveRegion,\n    cookieName,\n    currentPath,\n    excludePaths,\n    currentUrl,\n  ])\n\n  // \u6E05\u9664\u5DF2\u4FDD\u5B58\u7684\u5730\u533A\u9009\u62E9\n  const clearRegion = () => {\n    Cookies.remove(cookieName)\n    setSavedRegion(null)\n  }\n\n  // \u6839\u636E\u5730\u533A\u4EE3\u7801\u83B7\u53D6\u5730\u533A\u914D\u7F6E\n  const getRegionByCode = (code: string) => {\n    return regions.find(region => region.code === code)\n  }\n\n  return {\n    isOpen,\n    setIsOpen,\n    savedRegion,\n    detectedRegion,\n    saveRegion,\n    clearRegion,\n    getRegionByCode,\n  }\n}\n"],
+  "mappings": "AAAA,OAAS,YAAAA,EAAU,aAAAC,EAAW,eAAAC,MAAmB,QACjD,OAAOC,MAAa,YA8CpB,SAASC,EAAeC,EAAqBC,EAAwBC,EAA8B,CACjG,MAAI,CAACD,GAAgBA,EAAa,SAAW,EACpC,GAGFA,EAAa,KAAKE,GAAW,CAElC,GAAIA,EAAQ,WAAW,SAAS,GAAKA,EAAQ,WAAW,UAAU,EAAG,CACnE,GAAI,CAACD,EAAY,MAAO,GAGxB,GAAIC,EAAQ,SAAS,GAAG,EAAG,CACzB,MAAMC,EAAeD,EAAQ,QAAQ,MAAO,IAAI,EAAE,QAAQ,MAAO,KAAK,EAEtE,OADc,IAAI,OAAO,IAAIC,CAAY,GAAG,EAC/B,KAAKF,CAAU,CAC9B,CAEA,OAAOA,IAAeC,CACxB,CAIA,GAAIA,EAAQ,SAAS,GAAG,EAAG,CACzB,MAAMC,EAAeD,EAAQ,QAAQ,MAAO,IAAI,EAEhD,OADc,IAAI,OAAO,IAAIC,CAAY,GAAG,EAC/B,KAAKJ,CAAW,CAC/B,CAEA,OAAOA,IAAgBG,CACzB,CAAC,CACH,CAMO,SAASE,EAAcC,EAAoD,CAChF,KAAM,CACJ,WAAAC,EAAa,cACb,iBAAAC,EAAmB,GACnB,QAAAC,EACA,kBAAAC,EACA,eAAAC,EACA,SAAAC,EAAW,GACX,aAAAX,EAAe,CAAC,EAChB,YAAAD,EAAc,GACd,WAAAE,EAAa,EACf,EAAII,EAEE,CAACO,EAAQC,CAAS,EAAInB,EAAS,EAAK,EACpC,CAACoB,EAAaC,CAAc,EAAIrB,EAAwB,IAAI,EAC5D,CAACsB,EAAgBC,CAAiB,EAAIvB,EAAwB,IAAI,EAGxEC,EAAU,IAAM,CACd,MAAMuB,EAAQrB,EAAQ,IAAIS,CAAU,EAChCY,GACFH,EAAeG,CAAK,CAExB,EAAG,CAACZ,CAAU,CAAC,EAGf,MAAMa,EAAavB,EACjB,CAACwB,EAAoBC,IAA0B,CAG7C,MAAMC,EAAcD,EAAe,MAAMD,CAAU,IAAIC,CAAY,GAAK,MAAMD,CAAU,GACxFvB,EAAQ,IAAIS,EAAYgB,EAAa,CAAE,QAASf,CAAiB,CAAC,EAClEQ,EAAeK,CAAU,CAC3B,EACA,CAACd,EAAYC,CAAgB,CAC/B,EAGA,OAAAZ,EAAU,IAAM,CAEd,GAAIG,EAAeC,EAAaC,EAAcC,CAAU,EACtD,OAIF,MAAMsB,EAAY,IAAI,gBAAgB,OAAO,SAAS,MAAM,EAG5D,GAFsBA,EAAU,IAAI,kBAAkB,EAEnC,CAGjB,eAAe,QAAQ,GAAGjB,CAAU,cAAe,MAAM,EACzDiB,EAAU,OAAO,kBAAkB,EACnC,MAAMC,EACJ,OAAO,SAAS,UAAYD,EAAU,SAAS,EAAI,IAAMA,EAAU,SAAS,EAAI,IAAM,OAAO,SAAS,KACxG,OAAO,QAAQ,aAAa,CAAC,EAAG,GAAIC,CAAM,CAC5C,CAGIV,GAKA,eAAe,QAAQ,GAAGR,CAAU,aAAa,GAKjDI,GACFA,EAAe,EAAE,KAAKe,GAAY,CAC5BA,IACFR,EAAkBQ,CAAQ,EAGtBhB,EACEgB,IAAahB,GACXE,GACFE,EAAU,EAAI,EASdF,GACFE,EAAU,EAAI,EAItB,CAAC,CAEL,EAAG,CACDH,EACAI,EACAH,EACAF,EACAU,EACAb,EACAP,EACAC,EACAC,CACF,CAAC,EAaM,CACL,OAAAW,EACA,UAAAC,EACA,YAAAC,EACA,eAAAE,EACA,WAAAG,EACA,YAhBkB,IAAM,CACxBtB,EAAQ,OAAOS,CAAU,EACzBS,EAAe,IAAI,CACrB,EAcE,gBAXuBW,GAChBlB,EAAQ,KAAKmB,GAAUA,EAAO,OAASD,CAAI,CAWpD,CACF",
+  "names": ["useState", "useEffect", "useCallback", "Cookies", "isPathExcluded", "currentPath", "excludePaths", "currentUrl", "pattern", "regexPattern", "useIPRedirect", "options", "cookieName", "cookieExpireDays", "regions", "currentRegionCode", "onDetectRegion", "autoShow", "isOpen", "setIsOpen", "savedRegion", "setSavedRegion", "detectedRegion", "setDetectedRegion", "saved", "saveRegion", "regionCode", "languageCode", "cookieValue", "urlParams", "newUrl", "detected", "code", "region"]
+}

package/dist/esm/biz-components/IPRedirect/useRedirectBanner.d.ts

@@ -0,0 +1,108 @@
+import type { RegionConfig } from './type.js';
+export interface UseRedirectBannerOptions {
+    /**
+     * 地理位置信息
+     */
+    geo?: {
+        country?: {
+            code?: string;
+        };
+    };
+    /**
+     * 地区配置列表
+     */
+    regions: RegionConfig[];
+    /**
+     * 国家到地区的映射
+     */
+    countryToRegionMap: Record<string, string>;
+    /**
+     * 当前站点的地区代码
+     */
+    currentRegionCode: string;
+    /**
+     * 当前路径
+     */
+    pathname: string;
+    /**
+     * 白名单路径（在白名单中不显示横幅）
+     */
+    excludePaths?: string[];
+    /**
+     * 保存地区选择的函数
+     */
+    saveRegion: (regionCode: string, languageCode?: string) => void;
+    /**
+     * 打开地区选择弹窗的函数
+     */
+    setModalOpen: (open: boolean) => void;
+}
+export interface UseRedirectBannerReturn {
+    /**
+     * 横幅是否可见
+     */
+    bannerVisible: boolean;
+    /**
+     * 设置横幅可见性
+     */
+    setBannerVisible: (visible: boolean) => void;
+    /**
+     * 推荐的地区信息
+     */
+    recommendedRegion: (RegionConfig & {
+        userCountry?: string;
+    }) | null;
+    /**
+     * 用户是否手动关闭了横幅
+     */
+    userDismissedBanner: boolean;
+    /**
+     * 设置用户已关闭横幅的状态
+     */
+    setUserDismissedBanner: (dismissed: boolean) => void;
+    /**
+     * "留在这里"按钮处理函数
+     */
+    handleStayHere: () => void;
+    /**
+     * "切换站点"按钮处理函数
+     */
+    handleSwitchSite: () => void;
+}
+/**
+ * 地区重定向横幅控制 Hook
+ *
+ * 自动检测用户是否被重定向，并显示提示横幅
+ * 提供"留在这里"和"切换站点"的交互
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   bannerVisible,
+ *   setBannerVisible,
+ *   recommendedRegion,
+ *   handleStayHere,
+ *   handleSwitchSite,
+ * } = useRedirectBanner({
+ *   geo,
+ *   regions,
+ *   countryToRegionMap,
+ *   currentRegionCode,
+ *   pathname,
+ *   excludePaths,
+ *   saveRegion,
+ *   setModalOpen,
+ * })
+ *
+ * return (
+ *   <RegionBanner
+ *     visible={bannerVisible}
+ *     onVisibleChange={setBannerVisible}
+ *     onStayHere={handleStayHere}
+ *     onSwitchSite={handleSwitchSite}
+ *     recommendedRegion={recommendedRegion}
+ *   />
+ * )
+ * ```
+ */
+export declare function useRedirectBanner(options: UseRedirectBannerOptions): UseRedirectBannerReturn;

package/dist/esm/biz-components/IPRedirect/useRedirectBanner.js

@@ -0,0 +1,2 @@
+import{useState as i,useEffect as _,useCallback as R}from"react";import{isPathInWhitelist as I}from"./utils.js";function x(p){const{geo:o,regions:e,countryToRegionMap:s,currentRegionCode:t,pathname:d,excludePaths:a=[],saveRegion:c,setModalOpen:g}=p,[v,r]=i(!1),[C,y]=i(null),[S,u]=i(!1);_(()=>{if(typeof window>"u")return;if(sessionStorage.getItem("auto_redirected")==="true"&&o?.country?.code){if(I(d,a)){sessionStorage.removeItem("auto_redirected"),sessionStorage.removeItem("auto_redirect_from");return}sessionStorage.removeItem("auto_redirected"),sessionStorage.removeItem("auto_redirect_from");const n=o.country.code.toUpperCase(),l=s[n];if(l){const f=e.find(B=>B.code===l);f&&(y({...f,userCountry:n}),r(!0))}}},[o,s,e,d,a]);const b=R(()=>{const m=e.find(n=>n.code===t);c(t,m?.languageCode),typeof window<"u"&&(sessionStorage.removeItem("auto_redirected"),sessionStorage.removeItem("auto_redirect_from")),u(!0),r(!1)},[c,t,e]),h=R(()=>{g(!0)},[g]);return{bannerVisible:v,setBannerVisible:r,recommendedRegion:C,userDismissedBanner:S,setUserDismissedBanner:u,handleStayHere:b,handleSwitchSite:h}}export{x as useRedirectBanner};
+//# sourceMappingURL=useRedirectBanner.js.map

package/dist/esm/biz-components/IPRedirect/useRedirectBanner.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/biz-components/IPRedirect/useRedirectBanner.tsx"],
+  "sourcesContent": ["import { useState, useEffect, useCallback } from 'react'\nimport { isPathInWhitelist } from './utils.js'\nimport type { RegionConfig } from './type.js'\n\nexport interface UseRedirectBannerOptions {\n  /**\n   * \u5730\u7406\u4F4D\u7F6E\u4FE1\u606F\n   */\n  geo?: {\n    country?: {\n      code?: string\n    }\n  }\n\n  /**\n   * \u5730\u533A\u914D\u7F6E\u5217\u8868\n   */\n  regions: RegionConfig[]\n\n  /**\n   * \u56FD\u5BB6\u5230\u5730\u533A\u7684\u6620\u5C04\n   */\n  countryToRegionMap: Record<string, string>\n\n  /**\n   * \u5F53\u524D\u7AD9\u70B9\u7684\u5730\u533A\u4EE3\u7801\n   */\n  currentRegionCode: string\n\n  /**\n   * \u5F53\u524D\u8DEF\u5F84\n   */\n  pathname: string\n\n  /**\n   * \u767D\u540D\u5355\u8DEF\u5F84\uFF08\u5728\u767D\u540D\u5355\u4E2D\u4E0D\u663E\u793A\u6A2A\u5E45\uFF09\n   */\n  excludePaths?: string[]\n\n  /**\n   * \u4FDD\u5B58\u5730\u533A\u9009\u62E9\u7684\u51FD\u6570\n   */\n  saveRegion: (regionCode: string, languageCode?: string) => void\n\n  /**\n   * \u6253\u5F00\u5730\u533A\u9009\u62E9\u5F39\u7A97\u7684\u51FD\u6570\n   */\n  setModalOpen: (open: boolean) => void\n}\n\nexport interface UseRedirectBannerReturn {\n  /**\n   * \u6A2A\u5E45\u662F\u5426\u53EF\u89C1\n   */\n  bannerVisible: boolean\n\n  /**\n   * \u8BBE\u7F6E\u6A2A\u5E45\u53EF\u89C1\u6027\n   */\n  setBannerVisible: (visible: boolean) => void\n\n  /**\n   * \u63A8\u8350\u7684\u5730\u533A\u4FE1\u606F\n   */\n  recommendedRegion: (RegionConfig & { userCountry?: string }) | null\n\n  /**\n   * \u7528\u6237\u662F\u5426\u624B\u52A8\u5173\u95ED\u4E86\u6A2A\u5E45\n   */\n  userDismissedBanner: boolean\n\n  /**\n   * \u8BBE\u7F6E\u7528\u6237\u5DF2\u5173\u95ED\u6A2A\u5E45\u7684\u72B6\u6001\n   */\n  setUserDismissedBanner: (dismissed: boolean) => void\n\n  /**\n   * \"\u7559\u5728\u8FD9\u91CC\"\u6309\u94AE\u5904\u7406\u51FD\u6570\n   */\n  handleStayHere: () => void\n\n  /**\n   * \"\u5207\u6362\u7AD9\u70B9\"\u6309\u94AE\u5904\u7406\u51FD\u6570\n   */\n  handleSwitchSite: () => void\n}\n\n/**\n * \u5730\u533A\u91CD\u5B9A\u5411\u6A2A\u5E45\u63A7\u5236 Hook\n *\n * \u81EA\u52A8\u68C0\u6D4B\u7528\u6237\u662F\u5426\u88AB\u91CD\u5B9A\u5411\uFF0C\u5E76\u663E\u793A\u63D0\u793A\u6A2A\u5E45\n * \u63D0\u4F9B\"\u7559\u5728\u8FD9\u91CC\"\u548C\"\u5207\u6362\u7AD9\u70B9\"\u7684\u4EA4\u4E92\n *\n * @example\n * ```tsx\n * const {\n *   bannerVisible,\n *   setBannerVisible,\n *   recommendedRegion,\n *   handleStayHere,\n *   handleSwitchSite,\n * } = useRedirectBanner({\n *   geo,\n *   regions,\n *   countryToRegionMap,\n *   currentRegionCode,\n *   pathname,\n *   excludePaths,\n *   saveRegion,\n *   setModalOpen,\n * })\n *\n * return (\n *   <RegionBanner\n *     visible={bannerVisible}\n *     onVisibleChange={setBannerVisible}\n *     onStayHere={handleStayHere}\n *     onSwitchSite={handleSwitchSite}\n *     recommendedRegion={recommendedRegion}\n *   />\n * )\n * ```\n */\nexport function useRedirectBanner(options: UseRedirectBannerOptions): UseRedirectBannerReturn {\n  const {\n    geo,\n    regions,\n    countryToRegionMap,\n    currentRegionCode,\n    pathname,\n    excludePaths = [],\n    saveRegion,\n    setModalOpen,\n  } = options\n\n  const [bannerVisible, setBannerVisible] = useState(false)\n  const [recommendedRegion, setRecommendedRegion] = useState<(RegionConfig & { userCountry?: string }) | null>(null)\n  const [userDismissedBanner, setUserDismissedBanner] = useState(false)\n\n  // \u68C0\u67E5\u662F\u5426\u662F\u81EA\u52A8\u8DF3\u8F6C\u8FC7\u6765\u7684\uFF0C\u5982\u679C\u662F\u5219\u663E\u793A\u6A2A\u5E45\n  useEffect(() => {\n    if (typeof window === 'undefined') return\n\n    const autoRedirected = sessionStorage.getItem('auto_redirected')\n\n    if (autoRedirected === 'true' && geo?.country?.code) {\n      // \u68C0\u67E5\u5F53\u524D\u8DEF\u5F84\u662F\u5426\u5728\u767D\u540D\u5355\u4E2D\n      if (isPathInWhitelist(pathname, excludePaths)) {\n        // \u5728\u767D\u540D\u5355\u4E2D\uFF0C\u6E05\u9664\u6807\u8BB0\u4F46\u4E0D\u663E\u793A\u6A2A\u5E45\n        sessionStorage.removeItem('auto_redirected')\n        sessionStorage.removeItem('auto_redirect_from')\n        return\n      }\n\n      // \u6E05\u9664\u6807\u8BB0\uFF08\u53EA\u663E\u793A\u4E00\u6B21\uFF09\n      sessionStorage.removeItem('auto_redirected')\n      sessionStorage.removeItem('auto_redirect_from')\n\n      // \u8BBE\u7F6E\u63A8\u8350\u7684\u5730\u533A\u4FE1\u606F\n      const userCountry = geo.country.code.toUpperCase()\n      const recommendedRegionCode = countryToRegionMap[userCountry]\n\n      // \u53EA\u6709\u5728\u7528\u6237\u7684\u56FD\u5BB6\u6709\u6620\u5C04\u914D\u7F6E\u65F6\u624D\u663E\u793A\u6A2A\u5E45\n      if (recommendedRegionCode) {\n        const targetRegion = regions.find(r => r.code === recommendedRegionCode)\n        if (targetRegion) {\n          setRecommendedRegion({\n            ...targetRegion,\n            userCountry,\n          })\n          // \u663E\u793A\u6A2A\u5E45\n          setBannerVisible(true)\n        }\n      }\n    }\n  }, [geo, countryToRegionMap, regions, pathname, excludePaths])\n\n  // \"\u7559\u5728\u8FD9\u91CC\"\u6309\u94AE\u5904\u7406\n  const handleStayHere = useCallback(() => {\n    // \u67E5\u627E\u5F53\u524D\u5730\u533A\u7684\u8BED\u8A00\u4EE3\u7801\n    const currentRegion = regions.find(r => r.code === currentRegionCode)\n\n    // \u4FDD\u5B58\u7528\u6237\u9009\u62E9\u5230 cookie\uFF08\u5305\u542B\u8BED\u8A00\u4EE3\u7801\uFF09\n    saveRegion(currentRegionCode, currentRegion?.languageCode)\n\n    // \u6E05\u9664 sessionStorage \u6807\u8BB0\uFF08\u5982\u679C\u6709\uFF09\n    if (typeof window !== 'undefined') {\n      sessionStorage.removeItem('auto_redirected')\n      sessionStorage.removeItem('auto_redirect_from')\n    }\n\n    // \u6807\u8BB0\u7528\u6237\u5DF2\u624B\u52A8\u5173\u95ED\u6A2A\u5E45\n    setUserDismissedBanner(true)\n\n    // \u9690\u85CF\u6A2A\u5E45\n    setBannerVisible(false)\n  }, [saveRegion, currentRegionCode, regions])\n\n  // \"\u5207\u6362\u7AD9\u70B9\"\u6309\u94AE\u5904\u7406\n  const handleSwitchSite = useCallback(() => {\n    // \u6253\u5F00\u5F39\u7A97\u8BA9\u7528\u6237\u9009\u62E9\u5730\u533A\n    setModalOpen(true)\n  }, [setModalOpen])\n\n  return {\n    bannerVisible,\n    setBannerVisible,\n    recommendedRegion,\n    userDismissedBanner,\n    setUserDismissedBanner,\n    handleStayHere,\n    handleSwitchSite,\n  }\n}\n"],
+  "mappings": "AAAA,OAAS,YAAAA,EAAU,aAAAC,EAAW,eAAAC,MAAmB,QACjD,OAAS,qBAAAC,MAAyB,aA0H3B,SAASC,EAAkBC,EAA4D,CAC5F,KAAM,CACJ,IAAAC,EACA,QAAAC,EACA,mBAAAC,EACA,kBAAAC,EACA,SAAAC,EACA,aAAAC,EAAe,CAAC,EAChB,WAAAC,EACA,aAAAC,CACF,EAAIR,EAEE,CAACS,EAAeC,CAAgB,EAAIf,EAAS,EAAK,EAClD,CAACgB,EAAmBC,CAAoB,EAAIjB,EAA2D,IAAI,EAC3G,CAACkB,EAAqBC,CAAsB,EAAInB,EAAS,EAAK,EAGpEC,EAAU,IAAM,CACd,GAAI,OAAO,OAAW,IAAa,OAInC,GAFuB,eAAe,QAAQ,iBAAiB,IAExC,QAAUK,GAAK,SAAS,KAAM,CAEnD,GAAIH,EAAkBO,EAAUC,CAAY,EAAG,CAE7C,eAAe,WAAW,iBAAiB,EAC3C,eAAe,WAAW,oBAAoB,EAC9C,MACF,CAGA,eAAe,WAAW,iBAAiB,EAC3C,eAAe,WAAW,oBAAoB,EAG9C,MAAMS,EAAcd,EAAI,QAAQ,KAAK,YAAY,EAC3Ce,EAAwBb,EAAmBY,CAAW,EAG5D,GAAIC,EAAuB,CACzB,MAAMC,EAAef,EAAQ,KAAKgB,GAAKA,EAAE,OAASF,CAAqB,EACnEC,IACFL,EAAqB,CACnB,GAAGK,EACH,YAAAF,CACF,CAAC,EAEDL,EAAiB,EAAI,EAEzB,CACF,CACF,EAAG,CAACT,EAAKE,EAAoBD,EAASG,EAAUC,CAAY,CAAC,EAG7D,MAAMa,EAAiBtB,EAAY,IAAM,CAEvC,MAAMuB,EAAgBlB,EAAQ,KAAKgB,GAAKA,EAAE,OAASd,CAAiB,EAGpEG,EAAWH,EAAmBgB,GAAe,YAAY,EAGrD,OAAO,OAAW,MACpB,eAAe,WAAW,iBAAiB,EAC3C,eAAe,WAAW,oBAAoB,GAIhDN,EAAuB,EAAI,EAG3BJ,EAAiB,EAAK,CACxB,EAAG,CAACH,EAAYH,EAAmBF,CAAO,CAAC,EAGrCmB,EAAmBxB,EAAY,IAAM,CAEzCW,EAAa,EAAI,CACnB,EAAG,CAACA,CAAY,CAAC,EAEjB,MAAO,CACL,cAAAC,EACA,iBAAAC,EACA,kBAAAC,EACA,oBAAAE,EACA,uBAAAC,EACA,eAAAK,EACA,iBAAAE,CACF,CACF",
+  "names": ["useState", "useEffect", "useCallback", "isPathInWhitelist", "useRedirectBanner", "options", "geo", "regions", "countryToRegionMap", "currentRegionCode", "pathname", "excludePaths", "saveRegion", "setModalOpen", "bannerVisible", "setBannerVisible", "recommendedRegion", "setRecommendedRegion", "userDismissedBanner", "setUserDismissedBanner", "userCountry", "recommendedRegionCode", "targetRegion", "r", "handleStayHere", "currentRegion", "handleSwitchSite"]
+}

package/dist/esm/biz-components/IPRedirect/useRegionRedirectManager.d.ts

@@ -0,0 +1,152 @@
+import type { RegionConfig } from './type.js';
+export interface UseRegionRedirectManagerOptions {
+    /**
+     * 地理位置信息
+     */
+    geo?: {
+        country?: {
+            code?: string;
+        };
+    };
+    /**
+     * 地区配置列表
+     */
+    regions: RegionConfig[];
+    /**
+     * 国家到地区的映射
+     */
+    countryToRegionMap: Record<string, string>;
+    /**
+     * 地区代码到路径前缀的映射
+     */
+    regionToPathMap: Record<string, string>;
+    /**
+     * 当前站点的地区代码
+     */
+    currentRegionCode: string;
+    /**
+     * 当前站点的 locale
+     */
+    locale?: string;
+    /**
+     * 当前路径
+     */
+    pathname: string;
+    /**
+     * 当前完整 URL
+     */
+    currentUrl?: string;
+    /**
+     * 白名单路径（在白名单中不跳转）
+     */
+    excludePaths?: string[];
+    /**
+     * Cookie 名称
+     * @default 'user_region'
+     */
+    cookieName?: string;
+    /**
+     * Cookie 过期天数
+     * @default 90
+     */
+    cookieExpireDays?: number;
+    /**
+     * 是否检查目标站点页面存在
+     * @default true
+     */
+    checkPageExists?: boolean;
+    /**
+     * 页面存在检查的 API 端点
+     * @default '/api/check-page-exists'
+     */
+    checkPageApiEndpoint?: string;
+    /**
+     * 地区检测回调
+     */
+    onDetectRegion?: (geo: any) => Promise<any>;
+}
+export interface UseRegionRedirectManagerReturn {
+    /**
+     * 地区选择弹窗是否打开
+     */
+    isRegionModalOpen: boolean;
+    /**
+     * 设置地区选择弹窗状态
+     */
+    setRegionModalOpen: (open: boolean) => void;
+    /**
+     * 保存地区选择
+     */
+    saveRegion: (regionCode: string, languageCode?: string) => void;
+    /**
+     * 保存的地区信息
+     */
+    savedRegion: any;
+    /**
+     * 检测到的地区信息
+     */
+    detectedRegion: any;
+    /**
+     * 横幅是否可见
+     */
+    bannerVisible: boolean;
+    /**
+     * 设置横幅可见性
+     */
+    setBannerVisible: (visible: boolean) => void;
+    /**
+     * 推荐的地区信息
+     */
+    recommendedRegion: (RegionConfig & {
+        userCountry?: string;
+    }) | null;
+    /**
+     * 用户是否手动关闭了横幅
+     */
+    userDismissedBanner: boolean;
+    /**
+     * "留在这里"按钮处理函数
+     */
+    handleStayHere: () => void;
+    /**
+     * "切换站点"按钮处理函数
+     */
+    handleSwitchSite: () => void;
+    /**
+     * 手动选择地区的回调
+     */
+    handleRegionSelect: (region: RegionConfig) => void;
+}
+/**
+ * 统一的地区重定向管理 Hook
+ *
+ * 整合了以下功能：
+ * - IP 检测和地区推荐
+ * - Cookie 偏好记忆
+ * - 自动跳转处理
+ * - 横幅显示管理
+ * - 地区选择交互
+ *
+ * @example
+ * ```tsx
+ * const {
+ *   isRegionModalOpen,
+ *   setRegionModalOpen,
+ *   bannerVisible,
+ *   recommendedRegion,
+ *   handleStayHere,
+ *   handleSwitchSite,
+ *   handleRegionSelect,
+ * } = useRegionRedirectManager({
+ *   geo,
+ *   regions,
+ *   countryToRegionMap,
+ *   regionToPathMap,
+ *   currentRegionCode,
+ *   locale,
+ *   pathname,
+ *   excludePaths,
+ * })
+ * ```
+ */
+export declare function useRegionRedirectManager(options: UseRegionRedirectManagerOptions): UseRegionRedirectManagerReturn;

package/dist/esm/biz-components/IPRedirect/useRegionRedirectManager.js

@@ -0,0 +1,2 @@
+import{useCallback as E}from"react";import{useIPRedirect as U}from"./useIPRedirect.js";import{useAutoRedirect as B}from"./useAutoRedirect.js";import{useRedirectBanner as A}from"./useRedirectBanner.js";import{useSavedRegionRedirect as T}from"./useSavedRegionRedirect.js";import{useDetectedRegionRedirect as V}from"./useDetectedRegionRedirect.js";function q(l){const{geo:r,regions:e,countryToRegionMap:p,regionToPathMap:u,currentRegionCode:n,locale:m,pathname:o,currentUrl:h,excludePaths:i=[],cookieName:f="user_region",cookieExpireDays:b=90,checkPageExists:y=!0,checkPageApiEndpoint:M="/api/check-page-exists",onDetectRegion:a}=l,{isOpen:v,setIsOpen:s,saveRegion:t,savedRegion:g,detectedRegion:c}=U({regions:e,currentRegionCode:n,cookieName:f,cookieExpireDays:b,autoShow:!1,onDetectRegion:a?()=>a(r):void 0,excludePaths:i,currentPath:o,currentUrl:h}),{handleAutoRedirect:d}=B({regions:e,regionToPathMap:u,geo:r,locale:m,checkPageExists:y,checkPageApiEndpoint:M}),{bannerVisible:C,setBannerVisible:P,recommendedRegion:k,userDismissedBanner:x,handleStayHere:S,handleSwitchSite:O}=A({geo:r,regions:e,countryToRegionMap:p,currentRegionCode:n,pathname:o,excludePaths:i,saveRegion:t,setModalOpen:s});T({savedRegion:g,currentRegionCode:n,regions:e,excludePaths:i,pathname:o,onRedirect:d}),V({detectedRegion:c,currentRegionCode:n,regions:e,excludePaths:i,pathname:o,onRedirect:d});const D=E(R=>{t(R.code,R.languageCode)},[t]);return{isRegionModalOpen:v,setRegionModalOpen:s,saveRegion:t,savedRegion:g,detectedRegion:c,bannerVisible:C,setBannerVisible:P,recommendedRegion:k,userDismissedBanner:x,handleStayHere:S,handleSwitchSite:O,handleRegionSelect:D}}export{q as useRegionRedirectManager};
+//# sourceMappingURL=useRegionRedirectManager.js.map

package/dist/esm/biz-components/IPRedirect/useRegionRedirectManager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/biz-components/IPRedirect/useRegionRedirectManager.tsx"],
+  "sourcesContent": ["import { useCallback } from 'react'\nimport { useIPRedirect } from './useIPRedirect.js'\nimport { useAutoRedirect } from './useAutoRedirect.js'\nimport { useRedirectBanner } from './useRedirectBanner.js'\nimport { useSavedRegionRedirect } from './useSavedRegionRedirect.js'\nimport { useDetectedRegionRedirect } from './useDetectedRegionRedirect.js'\nimport type { RegionConfig } from './type.js'\n\nexport interface UseRegionRedirectManagerOptions {\n  /**\n   * \u5730\u7406\u4F4D\u7F6E\u4FE1\u606F\n   */\n  geo?: {\n    country?: {\n      code?: string\n    }\n  }\n\n  /**\n   * \u5730\u533A\u914D\u7F6E\u5217\u8868\n   */\n  regions: RegionConfig[]\n\n  /**\n   * \u56FD\u5BB6\u5230\u5730\u533A\u7684\u6620\u5C04\n   */\n  countryToRegionMap: Record<string, string>\n\n  /**\n   * \u5730\u533A\u4EE3\u7801\u5230\u8DEF\u5F84\u524D\u7F00\u7684\u6620\u5C04\n   */\n  regionToPathMap: Record<string, string>\n\n  /**\n   * \u5F53\u524D\u7AD9\u70B9\u7684\u5730\u533A\u4EE3\u7801\n   */\n  currentRegionCode: string\n\n  /**\n   * \u5F53\u524D\u7AD9\u70B9\u7684 locale\n   */\n  locale?: string\n\n  /**\n   * \u5F53\u524D\u8DEF\u5F84\n   */\n  pathname: string\n\n  /**\n   * \u5F53\u524D\u5B8C\u6574 URL\n   */\n  currentUrl?: string\n\n  /**\n   * \u767D\u540D\u5355\u8DEF\u5F84\uFF08\u5728\u767D\u540D\u5355\u4E2D\u4E0D\u8DF3\u8F6C\uFF09\n   */\n  excludePaths?: string[]\n\n  /**\n   * Cookie \u540D\u79F0\n   * @default 'user_region'\n   */\n  cookieName?: string\n\n  /**\n   * Cookie \u8FC7\u671F\u5929\u6570\n   * @default 90\n   */\n  cookieExpireDays?: number\n\n  /**\n   * \u662F\u5426\u68C0\u67E5\u76EE\u6807\u7AD9\u70B9\u9875\u9762\u5B58\u5728\n   * @default true\n   */\n  checkPageExists?: boolean\n\n  /**\n   * \u9875\u9762\u5B58\u5728\u68C0\u67E5\u7684 API \u7AEF\u70B9\n   * @default '/api/check-page-exists'\n   */\n  checkPageApiEndpoint?: string\n\n  /**\n   * \u5730\u533A\u68C0\u6D4B\u56DE\u8C03\n   */\n  onDetectRegion?: (geo: any) => Promise<any>\n}\n\nexport interface UseRegionRedirectManagerReturn {\n  /**\n   * \u5730\u533A\u9009\u62E9\u5F39\u7A97\u662F\u5426\u6253\u5F00\n   */\n  isRegionModalOpen: boolean\n\n  /**\n   * \u8BBE\u7F6E\u5730\u533A\u9009\u62E9\u5F39\u7A97\u72B6\u6001\n   */\n  setRegionModalOpen: (open: boolean) => void\n\n  /**\n   * \u4FDD\u5B58\u5730\u533A\u9009\u62E9\n   */\n  saveRegion: (regionCode: string, languageCode?: string) => void\n\n  /**\n   * \u4FDD\u5B58\u7684\u5730\u533A\u4FE1\u606F\n   */\n  savedRegion: any\n\n  /**\n   * \u68C0\u6D4B\u5230\u7684\u5730\u533A\u4FE1\u606F\n   */\n  detectedRegion: any\n\n  /**\n   * \u6A2A\u5E45\u662F\u5426\u53EF\u89C1\n   */\n  bannerVisible: boolean\n\n  /**\n   * \u8BBE\u7F6E\u6A2A\u5E45\u53EF\u89C1\u6027\n   */\n  setBannerVisible: (visible: boolean) => void\n\n  /**\n   * \u63A8\u8350\u7684\u5730\u533A\u4FE1\u606F\n   */\n  recommendedRegion: (RegionConfig & { userCountry?: string }) | null\n\n  /**\n   * \u7528\u6237\u662F\u5426\u624B\u52A8\u5173\u95ED\u4E86\u6A2A\u5E45\n   */\n  userDismissedBanner: boolean\n\n  /**\n   * \"\u7559\u5728\u8FD9\u91CC\"\u6309\u94AE\u5904\u7406\u51FD\u6570\n   */\n  handleStayHere: () => void\n\n  /**\n   * \"\u5207\u6362\u7AD9\u70B9\"\u6309\u94AE\u5904\u7406\u51FD\u6570\n   */\n  handleSwitchSite: () => void\n\n  /**\n   * \u624B\u52A8\u9009\u62E9\u5730\u533A\u7684\u56DE\u8C03\n   */\n  handleRegionSelect: (region: RegionConfig) => void\n}\n\n/**\n * \u7EDF\u4E00\u7684\u5730\u533A\u91CD\u5B9A\u5411\u7BA1\u7406 Hook\n *\n * \u6574\u5408\u4E86\u4EE5\u4E0B\u529F\u80FD\uFF1A\n * - IP \u68C0\u6D4B\u548C\u5730\u533A\u63A8\u8350\n * - Cookie \u504F\u597D\u8BB0\u5FC6\n * - \u81EA\u52A8\u8DF3\u8F6C\u5904\u7406\n * - \u6A2A\u5E45\u663E\u793A\u7BA1\u7406\n * - \u5730\u533A\u9009\u62E9\u4EA4\u4E92\n *\n * @example\n * ```tsx\n * const {\n *   isRegionModalOpen,\n *   setRegionModalOpen,\n *   bannerVisible,\n *   recommendedRegion,\n *   handleStayHere,\n *   handleSwitchSite,\n *   handleRegionSelect,\n * } = useRegionRedirectManager({\n *   geo,\n *   regions,\n *   countryToRegionMap,\n *   regionToPathMap,\n *   currentRegionCode,\n *   locale,\n *   pathname,\n *   excludePaths,\n * })\n * ```\n */\nexport function useRegionRedirectManager(options: UseRegionRedirectManagerOptions): UseRegionRedirectManagerReturn {\n  const {\n    geo,\n    regions,\n    countryToRegionMap,\n    regionToPathMap,\n    currentRegionCode,\n    locale,\n    pathname,\n    currentUrl,\n    excludePaths = [],\n    cookieName = 'user_region',\n    cookieExpireDays = 90,\n    checkPageExists = true,\n    checkPageApiEndpoint = '/api/check-page-exists',\n    onDetectRegion,\n  } = options\n\n  // 1. \u6838\u5FC3 IP \u68C0\u6D4B Hook\n  const {\n    isOpen: isRegionModalOpen,\n    setIsOpen: setRegionModalOpen,\n    saveRegion,\n    savedRegion,\n    detectedRegion,\n  } = useIPRedirect({\n    regions,\n    currentRegionCode,\n    cookieName,\n    cookieExpireDays,\n    autoShow: false,\n    onDetectRegion: onDetectRegion ? () => onDetectRegion(geo) : undefined,\n    excludePaths,\n    currentPath: pathname,\n    currentUrl,\n  })\n\n  // 2. \u81EA\u52A8\u8DF3\u8F6C\u5904\u7406 Hook\n  const { handleAutoRedirect } = useAutoRedirect({\n    regions,\n    regionToPathMap,\n    geo,\n    locale,\n    checkPageExists,\n    checkPageApiEndpoint,\n  })\n\n  // 3. \u6A2A\u5E45\u7BA1\u7406 Hook\n  const { bannerVisible, setBannerVisible, recommendedRegion, userDismissedBanner, handleStayHere, handleSwitchSite } =\n    useRedirectBanner({\n      geo,\n      regions,\n      countryToRegionMap,\n      currentRegionCode,\n      pathname,\n      excludePaths,\n      saveRegion,\n      setModalOpen: setRegionModalOpen,\n    })\n\n  // 4. Cookie \u504F\u597D\u76D1\u542C Hook\uFF08\u81EA\u52A8\u6267\u884C\uFF09\n  useSavedRegionRedirect({\n    savedRegion,\n    currentRegionCode,\n    regions,\n    excludePaths,\n    pathname,\n    onRedirect: handleAutoRedirect,\n  })\n\n  // 5. IP \u68C0\u6D4B\u76D1\u542C Hook\uFF08\u81EA\u52A8\u6267\u884C\uFF09\n  useDetectedRegionRedirect({\n    detectedRegion,\n    currentRegionCode,\n    regions,\n    excludePaths,\n    pathname,\n    onRedirect: handleAutoRedirect,\n  })\n\n  // \u624B\u52A8\u9009\u62E9\u5730\u533A\u7684\u56DE\u8C03\n  const handleRegionSelect = useCallback(\n    (region: RegionConfig) => {\n      // \u4FDD\u5B58\u7528\u6237\u9009\u62E9\u7684\u5730\u533A\u5230 cookie\uFF08\u5305\u542B\u8BED\u8A00\u4EE3\u7801\uFF09\n      saveRegion(region.code, region.languageCode)\n      // \u8DF3\u8F6C\u903B\u8F91\u7531 RegionSelectorModal \u5185\u90E8\u5904\u7406\uFF08autoRedirect + redirectToHomepage\uFF09\n    },\n    [saveRegion]\n  )\n\n  return {\n    isRegionModalOpen,\n    setRegionModalOpen,\n    saveRegion,\n    savedRegion,\n    detectedRegion,\n    bannerVisible,\n    setBannerVisible,\n    recommendedRegion,\n    userDismissedBanner,\n    handleStayHere,\n    handleSwitchSite,\n    handleRegionSelect,\n  }\n}\n"],
+  "mappings": "AAAA,OAAS,eAAAA,MAAmB,QAC5B,OAAS,iBAAAC,MAAqB,qBAC9B,OAAS,mBAAAC,MAAuB,uBAChC,OAAS,qBAAAC,MAAyB,yBAClC,OAAS,0BAAAC,MAA8B,8BACvC,OAAS,6BAAAC,MAAiC,iCAiLnC,SAASC,EAAyBC,EAA0E,CACjH,KAAM,CACJ,IAAAC,EACA,QAAAC,EACA,mBAAAC,EACA,gBAAAC,EACA,kBAAAC,EACA,OAAAC,EACA,SAAAC,EACA,WAAAC,EACA,aAAAC,EAAe,CAAC,EAChB,WAAAC,EAAa,cACb,iBAAAC,EAAmB,GACnB,gBAAAC,EAAkB,GAClB,qBAAAC,EAAuB,yBACvB,eAAAC,CACF,EAAId,EAGE,CACJ,OAAQe,EACR,UAAWC,EACX,WAAAC,EACA,YAAAC,EACA,eAAAC,CACF,EAAIzB,EAAc,CAChB,QAAAQ,EACA,kBAAAG,EACA,WAAAK,EACA,iBAAAC,EACA,SAAU,GACV,eAAgBG,EAAiB,IAAMA,EAAeb,CAAG,EAAI,OAC7D,aAAAQ,EACA,YAAaF,EACb,WAAAC,CACF,CAAC,EAGK,CAAE,mBAAAY,CAAmB,EAAIzB,EAAgB,CAC7C,QAAAO,EACA,gBAAAE,EACA,IAAAH,EACA,OAAAK,EACA,gBAAAM,EACA,qBAAAC,CACF,CAAC,EAGK,CAAE,cAAAQ,EAAe,iBAAAC,EAAkB,kBAAAC,EAAmB,oBAAAC,EAAqB,eAAAC,EAAgB,iBAAAC,CAAiB,EAChH9B,EAAkB,CAChB,IAAAK,EACA,QAAAC,EACA,mBAAAC,EACA,kBAAAE,EACA,SAAAE,EACA,aAAAE,EACA,WAAAQ,EACA,aAAcD,CAChB,CAAC,EAGHnB,EAAuB,CACrB,YAAAqB,EACA,kBAAAb,EACA,QAAAH,EACA,aAAAO,EACA,SAAAF,EACA,WAAYa,CACd,CAAC,EAGDtB,EAA0B,CACxB,eAAAqB,EACA,kBAAAd,EACA,QAAAH,EACA,aAAAO,EACA,SAAAF,EACA,WAAYa,CACd,CAAC,EAGD,MAAMO,EAAqBlC,EACxBmC,GAAyB,CAExBX,EAAWW,EAAO,KAAMA,EAAO,YAAY,CAE7C,EACA,CAACX,CAAU,CACb,EAEA,MAAO,CACL,kBAAAF,EACA,mBAAAC,EACA,WAAAC,EACA,YAAAC,EACA,eAAAC,EACA,cAAAE,EACA,iBAAAC,EACA,kBAAAC,EACA,oBAAAC,EACA,eAAAC,EACA,iBAAAC,EACA,mBAAAC,CACF,CACF",
+  "names": ["useCallback", "useIPRedirect", "useAutoRedirect", "useRedirectBanner", "useSavedRegionRedirect", "useDetectedRegionRedirect", "useRegionRedirectManager", "options", "geo", "regions", "countryToRegionMap", "regionToPathMap", "currentRegionCode", "locale", "pathname", "currentUrl", "excludePaths", "cookieName", "cookieExpireDays", "checkPageExists", "checkPageApiEndpoint", "onDetectRegion", "isRegionModalOpen", "setRegionModalOpen", "saveRegion", "savedRegion", "detectedRegion", "handleAutoRedirect", "bannerVisible", "setBannerVisible", "recommendedRegion", "userDismissedBanner", "handleStayHere", "handleSwitchSite", "handleRegionSelect", "region"]
+}

package/dist/esm/biz-components/IPRedirect/useSavedRegionRedirect.d.ts

@@ -0,0 +1,51 @@
+import type { RegionConfig } from './type.js';
+export interface UseSavedRegionRedirectOptions {
+    /**
+     * 从 cookie 中读取的已保存地区信息（格式：'DE:de'）
+     */
+    savedRegion: string | null;
+    /**
+     * 当前站点的地区代码
+     */
+    currentRegionCode: string;
+    /**
+     * 地区配置列表
+     */
+    regions: RegionConfig[];
+    /**
+     * 白名单路径（在白名单中不执行跳转）
+     */
+    excludePaths?: string[];
+    /**
+     * 当前路径
+     */
+    pathname?: string;
+    /**
+     * 用户是否手动关闭了横幅（关闭横幅后不再自动跳转）
+     */
+    userDismissedBanner?: boolean;
+    /**
+     * 自动跳转处理函数
+     */
+    onRedirect: (region: RegionConfig, isCookieRedirect?: boolean) => void | Promise<void>;
+}
+/**
+ * Cookie 保存地区跳转监听 Hook
+ *
+ * 监听用户之前保存的地区偏好（存储在 cookie 中），
+ * 如果保存的地区与当前地区不匹配，自动跳转到保存的地区
+ *
+ * @example
+ * ```tsx
+ * useSavedRegionRedirect({
+ *   savedRegion,           // 从 useIPRedirect 获取
+ *   currentRegionCode,
+ *   regions,
+ *   excludePaths,
+ *   pathname,
+ *   userDismissedBanner,
+ *   onRedirect: handleAutoRedirect,  // 从 useAutoRedirect 获取
+ * })
+ * ```
+ */
+export declare function useSavedRegionRedirect(options: UseSavedRegionRedirectOptions): void;

package/dist/esm/biz-components/IPRedirect/useSavedRegionRedirect.js

@@ -0,0 +1,2 @@
+import{useEffect as f}from"react";import{isPathInWhitelist as u,parseRegionCookie as p}from"./utils.js";function C(R){const{savedRegion:e,currentRegionCode:i,regions:n,excludePaths:o=[],pathname:r="",userDismissedBanner:t=!1,onRedirect:s}=R;f(()=>{if(u(r,o)||t||!e)return;const d=p(e);if(!d)return;const{regionCode:g}=d;if(g===i)return;const a=n.find(c=>c.code===g);a&&s(a,!0)},[e,i,n,t,s,r,o])}export{C as useSavedRegionRedirect};
+//# sourceMappingURL=useSavedRegionRedirect.js.map

package/dist/esm/biz-components/IPRedirect/useSavedRegionRedirect.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/biz-components/IPRedirect/useSavedRegionRedirect.tsx"],
+  "sourcesContent": ["import { useEffect } from 'react'\nimport { isPathInWhitelist, parseRegionCookie } from './utils.js'\nimport type { RegionConfig } from './type.js'\n\nexport interface UseSavedRegionRedirectOptions {\n  /**\n   * \u4ECE cookie \u4E2D\u8BFB\u53D6\u7684\u5DF2\u4FDD\u5B58\u5730\u533A\u4FE1\u606F\uFF08\u683C\u5F0F\uFF1A'DE:de'\uFF09\n   */\n  savedRegion: string | null\n\n  /**\n   * \u5F53\u524D\u7AD9\u70B9\u7684\u5730\u533A\u4EE3\u7801\n   */\n  currentRegionCode: string\n\n  /**\n   * \u5730\u533A\u914D\u7F6E\u5217\u8868\n   */\n  regions: RegionConfig[]\n\n  /**\n   * \u767D\u540D\u5355\u8DEF\u5F84\uFF08\u5728\u767D\u540D\u5355\u4E2D\u4E0D\u6267\u884C\u8DF3\u8F6C\uFF09\n   */\n  excludePaths?: string[]\n\n  /**\n   * \u5F53\u524D\u8DEF\u5F84\n   */\n  pathname?: string\n\n  /**\n   * \u7528\u6237\u662F\u5426\u624B\u52A8\u5173\u95ED\u4E86\u6A2A\u5E45\uFF08\u5173\u95ED\u6A2A\u5E45\u540E\u4E0D\u518D\u81EA\u52A8\u8DF3\u8F6C\uFF09\n   */\n  userDismissedBanner?: boolean\n\n  /**\n   * \u81EA\u52A8\u8DF3\u8F6C\u5904\u7406\u51FD\u6570\n   */\n  onRedirect: (region: RegionConfig, isCookieRedirect?: boolean) => void | Promise<void>\n}\n\n/**\n * Cookie \u4FDD\u5B58\u5730\u533A\u8DF3\u8F6C\u76D1\u542C Hook\n *\n * \u76D1\u542C\u7528\u6237\u4E4B\u524D\u4FDD\u5B58\u7684\u5730\u533A\u504F\u597D\uFF08\u5B58\u50A8\u5728 cookie \u4E2D\uFF09\uFF0C\n * \u5982\u679C\u4FDD\u5B58\u7684\u5730\u533A\u4E0E\u5F53\u524D\u5730\u533A\u4E0D\u5339\u914D\uFF0C\u81EA\u52A8\u8DF3\u8F6C\u5230\u4FDD\u5B58\u7684\u5730\u533A\n *\n * @example\n * ```tsx\n * useSavedRegionRedirect({\n *   savedRegion,           // \u4ECE useIPRedirect \u83B7\u53D6\n *   currentRegionCode,\n *   regions,\n *   excludePaths,\n *   pathname,\n *   userDismissedBanner,\n *   onRedirect: handleAutoRedirect,  // \u4ECE useAutoRedirect \u83B7\u53D6\n * })\n * ```\n */\nexport function useSavedRegionRedirect(options: UseSavedRegionRedirectOptions): void {\n  const {\n    savedRegion,\n    currentRegionCode,\n    regions,\n    excludePaths = [],\n    pathname = '',\n    userDismissedBanner = false,\n    onRedirect,\n  } = options\n\n  useEffect(() => {\n    // \u767D\u540D\u5355\u68C0\u67E5\uFF1A\u5982\u679C\u5F53\u524D URL/\u8DEF\u5F84\u5728\u767D\u540D\u5355\u4E2D\uFF0C\u4E0D\u6267\u884C\u81EA\u52A8\u8DF3\u8F6C\n    if (isPathInWhitelist(pathname, excludePaths)) {\n      return\n    }\n\n    // \u5982\u679C\u7528\u6237\u5DF2\u7ECF\u624B\u52A8\u5173\u95ED\u6A2A\u5E45\uFF0C\u4E0D\u518D\u81EA\u52A8\u8DF3\u8F6C\n    if (userDismissedBanner) {\n      return\n    }\n\n    // \u5982\u679C\u6CA1\u6709\u4FDD\u5B58\u7684\u5730\u533A\u504F\u597D\uFF0C\u4E0D\u5904\u7406\n    if (!savedRegion) {\n      return\n    }\n\n    // \u89E3\u6790 cookie \u4E2D\u4FDD\u5B58\u7684\u5730\u533A\u4EE3\u7801\n    const parsed = parseRegionCookie(savedRegion)\n    if (!parsed) {\n      return\n    }\n\n    const { regionCode: savedRegionCode } = parsed\n\n    // \u5982\u679C\u4FDD\u5B58\u7684\u5730\u533A\u4E0E\u5F53\u524D\u5730\u533A\u5339\u914D\uFF0C\u4E0D\u5904\u7406\n    if (savedRegionCode === currentRegionCode) {\n      return\n    }\n\n    // \u67E5\u627E\u4FDD\u5B58\u7684\u5730\u533A\u914D\u7F6E\n    const targetRegion = regions.find(r => r.code === savedRegionCode)\n    if (!targetRegion) {\n      return\n    }\n\n    // \u4F7F\u7528 onRedirect \u8DF3\u8F6C\uFF08\u590D\u7528\u9875\u9762\u68C0\u67E5\u548C UTM \u5904\u7406\u903B\u8F91\uFF09\n    onRedirect(targetRegion, true)\n  }, [savedRegion, currentRegionCode, regions, userDismissedBanner, onRedirect, pathname, excludePaths])\n}\n"],
+  "mappings": "AAAA,OAAS,aAAAA,MAAiB,QAC1B,OAAS,qBAAAC,EAAmB,qBAAAC,MAAyB,aA2D9C,SAASC,EAAuBC,EAA8C,CACnF,KAAM,CACJ,YAAAC,EACA,kBAAAC,EACA,QAAAC,EACA,aAAAC,EAAe,CAAC,EAChB,SAAAC,EAAW,GACX,oBAAAC,EAAsB,GACtB,WAAAC,CACF,EAAIP,EAEJJ,EAAU,IAAM,CAYd,GAVIC,EAAkBQ,EAAUD,CAAY,GAKxCE,GAKA,CAACL,EACH,OAIF,MAAMO,EAASV,EAAkBG,CAAW,EAC5C,GAAI,CAACO,EACH,OAGF,KAAM,CAAE,WAAYC,CAAgB,EAAID,EAGxC,GAAIC,IAAoBP,EACtB,OAIF,MAAMQ,EAAeP,EAAQ,KAAKQ,GAAKA,EAAE,OAASF,CAAe,EAC5DC,GAKLH,EAAWG,EAAc,EAAI,CAC/B,EAAG,CAACT,EAAaC,EAAmBC,EAASG,EAAqBC,EAAYF,EAAUD,CAAY,CAAC,CACvG",
+  "names": ["useEffect", "isPathInWhitelist", "parseRegionCookie", "useSavedRegionRedirect", "options", "savedRegion", "currentRegionCode", "regions", "excludePaths", "pathname", "userDismissedBanner", "onRedirect", "parsed", "savedRegionCode", "targetRegion", "r"]
+}