@anker-in/headless-ui 1.1.28-alpha.1768202456200 → 1.1.29

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

@@ -1,42 +0,0 @@
-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/cjs/biz-components/IPRedirect/useIPRedirect.js

@@ -1,2 +0,0 @@
-"use strict";var _=Object.create;var l=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var $=Object.getPrototypeOf,k=Object.prototype.hasOwnProperty;var b=(t,e)=>{for(var n in e)l(t,n,{get:e[n],enumerable:!0})},v=(t,e,n,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of I(e))!k.call(t,o)&&o!==n&&l(t,o,{get:()=>e[o],enumerable:!(i=C(e,o))||i.enumerable});return t};var E=(t,e,n)=>(n=t!=null?_($(t)):{},v(e||!t||!t.__esModule?l(n,"default",{value:t,enumerable:!0}):n,t)),O=t=>v(l({},"__esModule",{value:!0}),t);var B={};b(B,{useIPRedirect:()=>D});module.exports=O(B);var s=require("react"),u=E(require("js-cookie"));function U(t,e,n){return!e||e.length===0?!1:e.some(i=>{if(i.startsWith("http://")||i.startsWith("https://")){if(!n)return!1;if(i.includes("*")){const o=i.replace(/\*/g,".*").replace(/\//g,"\\/");return new RegExp(`^${o}$`).test(n)}return n===i}if(i.includes("*")){const o=i.replace(/\*/g,".*");return new RegExp(`^${o}$`).test(t)}return t===i})}function D(t){const{cookieName:e="user_region",cookieExpireDays:n=90,regions:i,currentRegionCode:o,onDetectRegion:c,autoShow:d=!0,excludePaths:m=[],currentPath:h="",currentUrl:w=""}=t,[P,R]=(0,s.useState)(!1),[f,p]=(0,s.useState)(null),[y,S]=(0,s.useState)(null);(0,s.useEffect)(()=>{const r=u.default.get(e);r&&p(r)},[e]);const x=(0,s.useCallback)((r,a)=>{const g=a?`v1_${r}_${a}`:`v1_${r}`;u.default.set(e,g,{expires:n}),p(r)},[e,n]);return(0,s.useEffect)(()=>{if(U(h,m,w))return;const r=new URLSearchParams(window.location.search);if(r.get("_region_selected")){sessionStorage.setItem(`${e}_redirected`,"true"),r.delete("_region_selected");const g=window.location.pathname+(r.toString()?"?"+r.toString():"")+window.location.hash;window.history.replaceState({},"",g)}f||sessionStorage.getItem(`${e}_redirected`)||c&&c().then(g=>{g&&(S(g),o?g!==o&&d&&R(!0):d&&R(!0))})},[c,f,d,o,x,e,h,m,w]),{isOpen:P,setIsOpen:R,savedRegion:f,detectedRegion:y,saveRegion:x,clearRegion:()=>{u.default.remove(e),p(null)},getRegionByCode:r=>i.find(a=>a.code===r)}}
-//# sourceMappingURL=useIPRedirect.js.map

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

@@ -1,7 +0,0 @@
-{
-  "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": "0jBAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,mBAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAiD,iBACjDC,EAAoB,wBA8CpB,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,SAASR,EAAcU,EAAoD,CAChF,KAAM,CACJ,WAAAC,EAAa,cACb,iBAAAC,EAAmB,GACnB,QAAAC,EACA,kBAAAC,EACA,eAAAC,EACA,SAAAC,EAAW,GACX,aAAAV,EAAe,CAAC,EAChB,YAAAD,EAAc,GACd,WAAAE,EAAa,EACf,EAAIG,EAEE,CAACO,EAAQC,CAAS,KAAI,YAAS,EAAK,EACpC,CAACC,EAAaC,CAAc,KAAI,YAAwB,IAAI,EAC5D,CAACC,EAAgBC,CAAiB,KAAI,YAAwB,IAAI,KAGxE,aAAU,IAAM,CACd,MAAMC,EAAQ,EAAAC,QAAQ,IAAIb,CAAU,EAChCY,GACFH,EAAeG,CAAK,CAExB,EAAG,CAACZ,CAAU,CAAC,EAGf,MAAMc,KAAa,eACjB,CAACC,EAAoBC,IAA0B,CAG7C,MAAMC,EAAcD,EAAe,MAAMD,CAAU,IAAIC,CAAY,GAAK,MAAMD,CAAU,GACxF,EAAAF,QAAQ,IAAIb,EAAYiB,EAAa,CAAE,QAAShB,CAAiB,CAAC,EAClEQ,EAAeM,CAAU,CAC3B,EACA,CAACf,EAAYC,CAAgB,CAC/B,EAGA,sBAAU,IAAM,CAEd,GAAIR,EAAeC,EAAaC,EAAcC,CAAU,EACtD,OAIF,MAAMsB,EAAY,IAAI,gBAAgB,OAAO,SAAS,MAAM,EAG5D,GAFsBA,EAAU,IAAI,kBAAkB,EAEnC,CAGjB,eAAe,QAAQ,GAAGlB,CAAU,cAAe,MAAM,EACzDkB,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,CAGIX,GAKA,eAAe,QAAQ,GAAGR,CAAU,aAAa,GAKjDI,GACFA,EAAe,EAAE,KAAKgB,GAAY,CAC5BA,IACFT,EAAkBS,CAAQ,EAGtBjB,EACEiB,IAAajB,GACXE,GACFE,EAAU,EAAI,EASdF,GACFE,EAAU,EAAI,EAItB,CAAC,CAEL,EAAG,CACDH,EACAI,EACAH,EACAF,EACAW,EACAd,EACAN,EACAC,EACAC,CACF,CAAC,EAaM,CACL,OAAAU,EACA,UAAAC,EACA,YAAAC,EACA,eAAAE,EACA,WAAAI,EACA,YAhBkB,IAAM,CACxB,EAAAD,QAAQ,OAAOb,CAAU,EACzBS,EAAe,IAAI,CACrB,EAcE,gBAXuBY,GAChBnB,EAAQ,KAAKoB,GAAUA,EAAO,OAASD,CAAI,CAWpD,CACF",
-  "names": ["useIPRedirect_exports", "__export", "useIPRedirect", "__toCommonJS", "import_react", "import_js_cookie", "isPathExcluded", "currentPath", "excludePaths", "currentUrl", "pattern", "regexPattern", "options", "cookieName", "cookieExpireDays", "regions", "currentRegionCode", "onDetectRegion", "autoShow", "isOpen", "setIsOpen", "savedRegion", "setSavedRegion", "detectedRegion", "setDetectedRegion", "saved", "Cookies", "saveRegion", "regionCode", "languageCode", "cookieValue", "urlParams", "newUrl", "detected", "code", "region"]
-}

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

@@ -1,108 +0,0 @@
-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/cjs/biz-components/IPRedirect/useRedirectBanner.js

@@ -1,2 +0,0 @@
-"use strict";var a=Object.defineProperty;var I=Object.getOwnPropertyDescriptor;var U=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var x=(n,e)=>{for(var o in e)a(n,o,{get:e[o],enumerable:!0})},D=(n,e,o,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let t of U(e))!w.call(n,t)&&t!==o&&a(n,t,{get:()=>e[t],enumerable:!(i=I(e,t))||i.enumerable});return n};var M=n=>D(a({},"__esModule",{value:!0}),n);var V={};x(V,{useRedirectBanner:()=>O});module.exports=M(V);var r=require("react"),v=require("./utils.js");function O(n){const{geo:e,regions:o,countryToRegionMap:i,currentRegionCode:t,pathname:c,excludePaths:g=[],saveRegion:u,setModalOpen:m}=n,[C,d]=(0,r.useState)(!1),[y,S]=(0,r.useState)(null),[b,l]=(0,r.useState)(!1);(0,r.useEffect)(()=>{if(typeof window>"u")return;if(sessionStorage.getItem("auto_redirected")==="true"&&e?.country?.code){if((0,v.isPathInWhitelist)(c,g)){sessionStorage.removeItem("auto_redirected"),sessionStorage.removeItem("auto_redirect_from");return}sessionStorage.removeItem("auto_redirected"),sessionStorage.removeItem("auto_redirect_from"),d(!0);const s=e.country.code.toUpperCase(),R=i[s];if(R){const p=o.find(_=>_.code===R);p&&S({...p,userCountry:s})}}},[e,i,o,c,g]);const h=(0,r.useCallback)(()=>{const f=o.find(s=>s.code===t);u(t,f?.languageCode),typeof window<"u"&&(sessionStorage.removeItem("auto_redirected"),sessionStorage.removeItem("auto_redirect_from")),l(!0),d(!1)},[u,t,o]),B=(0,r.useCallback)(()=>{m(!0)},[m]);return{bannerVisible:C,setBannerVisible:d,recommendedRegion:y,userDismissedBanner:b,setUserDismissedBanner:l,handleStayHere:h,handleSwitchSite:B}}
-//# sourceMappingURL=useRedirectBanner.js.map

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

@@ -1,7 +0,0 @@
-{
-  "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      // \u663E\u793A\u6A2A\u5E45\n      setBannerVisible(true)\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      if (recommendedRegionCode) {\n        const targetRegion = regions.find(r => r.code === recommendedRegionCode)\n        if (targetRegion) {\n          setRecommendedRegion({\n            ...targetRegion,\n            userCountry,\n          })\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": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,uBAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAAiD,iBACjDC,EAAkC,sBA0H3B,SAASH,EAAkBI,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,KAAI,YAAS,EAAK,EAClD,CAACC,EAAmBC,CAAoB,KAAI,YAA2D,IAAI,EAC3G,CAACC,EAAqBC,CAAsB,KAAI,YAAS,EAAK,KAGpE,aAAU,IAAM,CACd,GAAI,OAAO,OAAW,IAAa,OAInC,GAFuB,eAAe,QAAQ,iBAAiB,IAExC,QAAUb,GAAK,SAAS,KAAM,CAEnD,MAAI,qBAAkBI,EAAUC,CAAY,EAAG,CAE7C,eAAe,WAAW,iBAAiB,EAC3C,eAAe,WAAW,oBAAoB,EAC9C,MACF,CAGA,eAAe,WAAW,iBAAiB,EAC3C,eAAe,WAAW,oBAAoB,EAG9CI,EAAiB,EAAI,EAGrB,MAAMK,EAAcd,EAAI,QAAQ,KAAK,YAAY,EAC3Ce,EAAwBb,EAAmBY,CAAW,EAE5D,GAAIC,EAAuB,CACzB,MAAMC,EAAef,EAAQ,KAAKgB,GAAKA,EAAE,OAASF,CAAqB,EACnEC,GACFL,EAAqB,CACnB,GAAGK,EACH,YAAAF,CACF,CAAC,CAEL,CACF,CACF,EAAG,CAACd,EAAKE,EAAoBD,EAASG,EAAUC,CAAY,CAAC,EAG7D,MAAMa,KAAiB,eAAY,IAAM,CAEvC,MAAMC,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,KAAmB,eAAY,IAAM,CAEzCb,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": ["useRedirectBanner_exports", "__export", "useRedirectBanner", "__toCommonJS", "import_react", "import_utils", "options", "geo", "regions", "countryToRegionMap", "currentRegionCode", "pathname", "excludePaths", "saveRegion", "setModalOpen", "bannerVisible", "setBannerVisible", "recommendedRegion", "setRecommendedRegion", "userDismissedBanner", "setUserDismissedBanner", "userCountry", "recommendedRegionCode", "targetRegion", "r", "handleStayHere", "currentRegion", "handleSwitchSite"]
-}

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

@@ -1,152 +0,0 @@
-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/cjs/biz-components/IPRedirect/useRegionRedirectManager.js

@@ -1,2 +0,0 @@
-"use strict";var c=Object.defineProperty;var H=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var N=Object.prototype.hasOwnProperty;var j=(o,e)=>{for(var n in e)c(o,n,{get:e[n],enumerable:!0})},_=(o,e,n,t)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of I(e))!N.call(o,i)&&i!==n&&c(o,i,{get:()=>e[i],enumerable:!(t=H(e,i))||t.enumerable});return o};var q=o=>_(c({},"__esModule",{value:!0}),o);var F={};j(F,{useRegionRedirectManager:()=>z});module.exports=q(F);var h=require("react"),f=require("./useIPRedirect.js"),b=require("./useAutoRedirect.js"),y=require("./useRedirectBanner.js"),M=require("./useSavedRegionRedirect.js"),v=require("./useDetectedRegionRedirect.js");function z(o){const{geo:e,regions:n,countryToRegionMap:t,regionToPathMap:i,currentRegionCode:r,locale:C,pathname:a,currentUrl:P,excludePaths:s=[],cookieName:k="user_region",cookieExpireDays:x=90,checkPageExists:S=!0,checkPageApiEndpoint:O="/api/check-page-exists",onDetectRegion:d}=o,{isOpen:D,setIsOpen:R,saveRegion:g,savedRegion:l,detectedRegion:p}=(0,f.useIPRedirect)({regions:n,currentRegionCode:r,cookieName:k,cookieExpireDays:x,autoShow:!1,onDetectRegion:d?()=>d(e):void 0,excludePaths:s,currentPath:a,currentUrl:P}),{handleAutoRedirect:u}=(0,b.useAutoRedirect)({regions:n,regionToPathMap:i,geo:e,locale:C,checkPageExists:S,checkPageApiEndpoint:O}),{bannerVisible:E,setBannerVisible:U,recommendedRegion:B,userDismissedBanner:A,handleStayHere:T,handleSwitchSite:V}=(0,y.useRedirectBanner)({geo:e,regions:n,countryToRegionMap:t,currentRegionCode:r,pathname:a,excludePaths:s,saveRegion:g,setModalOpen:R});(0,M.useSavedRegionRedirect)({savedRegion:l,currentRegionCode:r,regions:n,excludePaths:s,pathname:a,onRedirect:u}),(0,v.useDetectedRegionRedirect)({detectedRegion:p,currentRegionCode:r,regions:n,excludePaths:s,pathname:a,onRedirect:u});const w=(0,h.useCallback)(m=>{g(m.code,m.languageCode)},[g]);return{isRegionModalOpen:D,setRegionModalOpen:R,saveRegion:g,savedRegion:l,detectedRegion:p,bannerVisible:E,setBannerVisible:U,recommendedRegion:B,userDismissedBanner:A,handleStayHere:T,handleSwitchSite:V,handleRegionSelect:w}}
-//# sourceMappingURL=useRegionRedirectManager.js.map

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

@@ -1,7 +0,0 @@
-{
-  "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": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,8BAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAA4B,iBAC5BC,EAA8B,8BAC9BC,EAAgC,gCAChCC,EAAkC,kCAClCC,EAAuC,uCACvCC,EAA0C,0CAiLnC,SAASP,EAAyBQ,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,KAAI,iBAAc,CAChB,QAAAjB,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,KAAI,mBAAgB,CAC7C,QAAAlB,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,KAChH,qBAAkB,CAChB,IAAAzB,EACA,QAAAC,EACA,mBAAAC,EACA,kBAAAE,EACA,SAAAE,EACA,aAAAE,EACA,WAAAQ,EACA,aAAcD,CAChB,CAAC,KAGH,0BAAuB,CACrB,YAAAE,EACA,kBAAAb,EACA,QAAAH,EACA,aAAAO,EACA,SAAAF,EACA,WAAYa,CACd,CAAC,KAGD,6BAA0B,CACxB,eAAAD,EACA,kBAAAd,EACA,QAAAH,EACA,aAAAO,EACA,SAAAF,EACA,WAAYa,CACd,CAAC,EAGD,MAAMO,KAAqB,eACxBC,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": ["useRegionRedirectManager_exports", "__export", "useRegionRedirectManager", "__toCommonJS", "import_react", "import_useIPRedirect", "import_useAutoRedirect", "import_useRedirectBanner", "import_useSavedRegionRedirect", "import_useDetectedRegionRedirect", "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/cjs/biz-components/IPRedirect/useSavedRegionRedirect.d.ts

@@ -1,51 +0,0 @@
-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/cjs/biz-components/IPRedirect/useSavedRegionRedirect.js

@@ -1,2 +0,0 @@
-"use strict";var s=Object.defineProperty;var m=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var l=(i,e)=>{for(var o in e)s(i,o,{get:e[o],enumerable:!0})},h=(i,e,o,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of v(e))!C.call(i,n)&&n!==o&&s(i,n,{get:()=>e[n],enumerable:!(r=m(e,n))||r.enumerable});return i};var x=i=>h(s({},"__esModule",{value:!0}),i);var S={};l(S,{useSavedRegionRedirect:()=>P});module.exports=x(S);var u=require("react"),t=require("./utils.js");function P(i){const{savedRegion:e,currentRegionCode:o,regions:r,excludePaths:n=[],pathname:d="",userDismissedBanner:g=!1,onRedirect:a}=i;(0,u.useEffect)(()=>{if((0,t.isPathInWhitelist)(d,n)||g||!e)return;const R=(0,t.parseRegionCookie)(e);if(!R)return;const{regionCode:c}=R;if(c===o)return;const f=r.find(p=>p.code===c);f&&a(f,!0)},[e,o,r,g,a,d,n])}
-//# sourceMappingURL=useSavedRegionRedirect.js.map

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

@@ -1,7 +0,0 @@
-{
-  "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": "yaAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,4BAAAE,IAAA,eAAAC,EAAAH,GAAA,IAAAI,EAA0B,iBAC1BC,EAAqD,sBA2D9C,SAASH,EAAuBI,EAA8C,CACnF,KAAM,CACJ,YAAAC,EACA,kBAAAC,EACA,QAAAC,EACA,aAAAC,EAAe,CAAC,EAChB,SAAAC,EAAW,GACX,oBAAAC,EAAsB,GACtB,WAAAC,CACF,EAAIP,KAEJ,aAAU,IAAM,CAYd,MAVI,qBAAkBK,EAAUD,CAAY,GAKxCE,GAKA,CAACL,EACH,OAIF,MAAMO,KAAS,qBAAkBP,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": ["useSavedRegionRedirect_exports", "__export", "useSavedRegionRedirect", "__toCommonJS", "import_react", "import_utils", "options", "savedRegion", "currentRegionCode", "regions", "excludePaths", "pathname", "userDismissedBanner", "onRedirect", "parsed", "savedRegionCode", "targetRegion", "r"]
-}