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

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"]
+}

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

@@ -0,0 +1,222 @@
+/**
+ * 从路径中移除 locale 前缀
+ * @param path - 当前路径（如 '/uk/products/a1234' 或 '/eu-de'）
+ * @param locales - locale 列表（如 ['us', 'uk', 'eu-de', 'ca']）
+ * @returns 去除 locale 后的路径（如 '/products/a1234' 或 '/'）
+ *
+ * @example
+ * removeLocalePrefix('/uk/products/a1234', ['uk', 'us'])
+ * // 返回: '/products/a1234'
+ *
+ * removeLocalePrefix('/eu-de', ['eu-de', 'us'])
+ * // 返回: '/'
+ *
+ * removeLocalePrefix('/products/a1234', ['uk', 'us'])
+ * // 返回: '/products/a1234' (没有匹配的 locale，原样返回)
+ */
+export declare function removeLocalePrefix(path: string, locales: string[]): string;
+/**
+ * 检查 URL 搜索参数中是否包含标准 UTM 参数
+ * （如 utm_source, utm_medium, utm_campaign 等）
+ *
+ * @param searchParams - URL 搜索参数字符串（如 '?utm_source=google&foo=bar'）
+ * @returns 是否包含 UTM 参数
+ *
+ * @example
+ * hasUtmParams('?utm_source=google')
+ * // 返回: true
+ *
+ * hasUtmParams('?utm_medium=cpc&utm_campaign=summer')
+ * // 返回: true
+ *
+ * hasUtmParams('?foo=bar')
+ * // 返回: false
+ *
+ * hasUtmParams('')
+ * // 返回: false
+ */
+export declare function hasUtmParams(searchParams: string): boolean;
+/**
+ * 向 URL 添加 ref 参数
+ *
+ * @param url - 目标 URL（可以是完整 URL 或相对路径）
+ * @param refValue - ref 参数的值
+ * @returns 添加了 ref 参数的 URL
+ *
+ * @example
+ * appendRefParam('https://example.com/products', 'geo_redirect_auto_de')
+ * // 返回: 'https://example.com/products?ref=geo_redirect_auto_de'
+ *
+ * appendRefParam('https://example.com/products?utm_source=google', 'geo_redirect_auto_de')
+ * // 返回: 'https://example.com/products?utm_source=google&ref=geo_redirect_auto_de'
+ *
+ * appendRefParam('/products', 'affiliate_123')
+ * // 返回: '/products?ref=affiliate_123'
+ */
+export declare function appendRefParam(url: string, refValue: string): string;
+/**
+ * 构建地理重定向的 ref 参数值
+ *
+ * @param countryCode - 国家代码（如 'DE', 'US', 'HK'）
+ * @returns 格式化的 ref 参数值（如 'geo_redirect_auto_de'）
+ *
+ * @example
+ * buildGeoRedirectRef('DE')
+ * // 返回: 'geo_redirect_auto_de'
+ *
+ * buildGeoRedirectRef('HK')
+ * // 返回: 'geo_redirect_auto_hk'
+ */
+export declare function buildGeoRedirectRef(countryCode: string): string;
+/**
+ * 构建地区重定向的 ref 参数值（手动切换）
+ *
+ * @param countryCode - 国家代码（如 'DE', 'US', 'HK'）
+ * @returns 格式化的 ref 参数值（如 'geo_redirect_manual_de'）
+ *
+ * @example
+ * buildGeoRedirectRefManual('DE')
+ * // 返回: 'geo_redirect_manual_de'
+ *
+ * buildGeoRedirectRefManual('HK')
+ * // 返回: 'geo_redirect_manual_hk'
+ */
+export declare function buildGeoRedirectRefManual(countryCode: string): string;
+/**
+ * 解析用户地区偏好 cookie 值
+ *
+ * @param cookieValue - Cookie 值（如 'v1_CA_EN' 或 'v1_CA'）
+ * @returns 解析后的地区代码和语言代码，如果格式无效返回 null
+ *
+ * @example
+ * parseRegionCookie('v1_CA_EN')
+ * // 返回: { regionCode: 'CA', languageCode: 'EN' }
+ *
+ * parseRegionCookie('v1_CA')
+ * // 返回: { regionCode: 'CA', languageCode: undefined }
+ *
+ * parseRegionCookie('invalid')
+ * // 返回: null
+ */
+export declare function parseRegionCookie(cookieValue: string): {
+    regionCode: string;
+    languageCode?: string;
+} | null;
+/**
+ * 从 regions 数组自动生成地区代码到路径前缀的映射
+ *
+ * @param regions - 地区配置数组
+ * @param customMap - 可选的自定义映射（优先级高于自动生成）
+ * @returns 地区代码到路径前缀的映射对象
+ *
+ * @example
+ * const regions = [
+ *   { code: 'US', url: 'https://www.anker.com' },
+ *   { code: 'CA', url: 'https://www.anker.com/ca' },
+ *   { code: 'DE', url: 'https://www.anker.com/eu-de' }
+ * ]
+ * generateRegionToPathMap(regions)
+ * // 返回: { US: '', CA: 'ca', DE: 'eu-de' }
+ *
+ * generateRegionToPathMap(regions, { UK: 'uk' })
+ * // 返回: { US: '', CA: 'ca', DE: 'eu-de', UK: 'uk' }
+ */
+export declare function generateRegionToPathMap(regions: Array<{
+    code: string;
+    url: string;
+}>, customMap?: Record<string, string>): Record<string, string>;
+/**
+ * 检查路径/URL 是否在白名单中
+ * 支持：通配符匹配、忽略域名差异、忽略尾部斜杠
+ *
+ * @param path - 当前路径（如 '/ca' 或 '/products/123'）
+ * @param whitelist - 白名单数组（支持路径或完整 URL，支持通配符 *）
+ * @returns 是否在白名单中
+ *
+ * @example
+ * isPathInWhitelist('/ca', ['/ca', '/uk'])
+ * // 返回: true
+ *
+ * isPathInWhitelist('/ca/', ['/ca'])
+ * // 返回: true（忽略尾部斜杠）
+ *
+ * isPathInWhitelist('/products/123', ['/products/*'])
+ * // 返回: true（通配符匹配）
+ *
+ * isPathInWhitelist('/checkout', ['https://www.anker.com/checkout'])
+ * // 返回: true（忽略域名差异）
+ *
+ * isPathInWhitelist('/about', ['/ca', '/uk'])
+ * // 返回: false
+ */
+export declare function isPathInWhitelist(path: string, whitelist: string[]): boolean;
+/**
+ * 验证地区配置的完整性和正确性
+ *
+ * @param options - 验证选项
+ * @param options.regions - 地区配置数组
+ * @param options.countryToRegionMap - 国家到地区的映射
+ * @param options.userCountry - 用户的国家代码（可选）
+ * @returns 验证结果
+ *
+ * @example
+ * const validation = validateRegionConfig({
+ *   regions: [{ code: 'US', ... }, { code: 'CA', ... }],
+ *   countryToRegionMap: { US: 'US', CA: 'CA', HK: 'DE' },
+ *   userCountry: 'HK'
+ * })
+ *
+ * if (validation.valid) {
+ *   console.log('映射的地区:', validation.mappedRegion) // 'DE'
+ * } else {
+ *   console.warn('验证失败:', validation.error)
+ * }
+ */
+export declare function validateRegionConfig(options: {
+    regions?: Array<{
+        code: string;
+        [key: string]: any;
+    }>;
+    countryToRegionMap?: Record<string, string>;
+    userCountry?: string;
+}): {
+    valid: boolean;
+    error?: string;
+    mappedRegion?: string;
+};
+/**
+ * 将 locale 字符串转换为地区代码
+ *
+ * @param locale - 当前 locale（如 'us', 'ca', 'eu-de'）
+ * @param regionToPathMap - 地区代码到路径前缀的映射
+ * @returns 地区代码（如 'US', 'CA', 'DE'）
+ *
+ * @example
+ * const regionToPathMap = { US: '', CA: 'ca', DE: 'eu-de' }
+ *
+ * localeToRegionCode('ca', regionToPathMap)
+ * // 返回: 'CA'
+ *
+ * localeToRegionCode('eu-de', regionToPathMap)
+ * // 返回: 'DE'
+ *
+ * localeToRegionCode('us', regionToPathMap)
+ * // 返回: 'US'
+ *
+ * localeToRegionCode('unknown', regionToPathMap)
+ * // 返回: 'UNKNOWN'（找不到时使用大写形式）
+ */
+export declare function localeToRegionCode(locale: string | null | undefined, regionToPathMap: Record<string, string>): string;
+/**
+ * 从 regionToPathMap 生成所有 locale 列表（用于移除路径前缀）
+ *
+ * @param regionToPathMap - 地区代码到路径前缀的映射
+ * @returns locale 列表（过滤掉空字符串）
+ *
+ * @example
+ * const regionToPathMap = { US: '', CA: 'ca', DE: 'eu-de', UK: 'uk' }
+ *
+ * generateAllLocales(regionToPathMap)
+ * // 返回: ['ca', 'eu-de', 'uk']
+ */
+export declare function generateAllLocales(regionToPathMap: Record<string, string>): string[];

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

@@ -0,0 +1,2 @@
+function u(e,r){for(const n of r)if(e===`/${n}`||e.startsWith(`/${n}/`))return e.substring(`/${n}`.length)||"/";return e}function l(e){return/[?&]utm_/i.test(e)}function d(e,r){const n=e.includes("?")?"&":"?";return`${e}${n}ref=${encodeURIComponent(r)}`}function f(e){return`geo_redirect_auto_${e.toLowerCase()}`}function p(e){return`geo_redirect_manual_${e.toLowerCase()}`}function R(e){if(!e||!e.startsWith("v1_"))return null;const r=e.substring(3).split("_");return r.length===0||!r[0]?null:{regionCode:r[0],languageCode:r[1]}}function C(e,r){const n={};return e&&e.length>0&&e.forEach(o=>{try{const t=new URL(o.url).pathname.replace(/^\//,"").replace(/\/$/,"");n[o.code]=t}catch{n[o.code]=o.code==="US"?"":o.code.toLowerCase()}}),r&&Object.keys(r).length>0&&Object.assign(n,r),n}function x(e,r){if(!r||r.length===0)return!1;const n=t=>t?.endsWith("/")?t.slice(0,-1):t,o=t=>{if(!t)return"";if(t.startsWith("http://")||t.startsWith("https://"))try{return new URL(t).pathname}catch{return t}return t},i=n(e);return r.some(t=>{const g=o(t),s=n(g);if(s.includes("*")){const a=s.replace(/\*/g,".*");return new RegExp(`^${a}$`).test(i)}return i===s})}function h(e){const{regions:r,countryToRegionMap:n,userCountry:o}=e;if(!r||r.length===0)return{valid:!1,error:"\u26A0\uFE0F regions \u672A\u914D\u7F6E\uFF0C\u65E0\u6CD5\u6267\u884C\u5730\u533A\u8DF3\u8F6C"};if(!n||Object.keys(n).length===0)return{valid:!1,error:"\u26A0\uFE0F countryToRegionMap \u672A\u914D\u7F6E\uFF0C\u65E0\u6CD5\u6267\u884C\u5730\u533A\u8DF3\u8F6C"};if(o){const i=o.toUpperCase(),t=n[i];return t?r.some(s=>s.code===t)?{valid:!0,mappedRegion:t}:{valid:!1,error:`\u26A0\uFE0F \u5730\u533A\u4EE3\u7801 ${t} \u5728 regions \u4E2D\u4E0D\u5B58\u5728\uFF0C\u8BF7\u68C0\u67E5\u914D\u7F6E`}:{valid:!1,error:`\u2139\uFE0F \u56FD\u5BB6 ${i} \u672A\u914D\u7F6E\u5730\u533A\u6620\u5C04\uFF0C\u4E0D\u6267\u884C\u8DF3\u8F6C`}}return{valid:!0}}function m(e,r){return e?Object.keys(r).find(o=>r[o]===e.toLowerCase()||o===e.toUpperCase())||e.toUpperCase():"US"}function y(e){return Object.values(e).filter(r=>r!=="")}export{d as appendRefParam,f as buildGeoRedirectRef,p as buildGeoRedirectRefManual,y as generateAllLocales,C as generateRegionToPathMap,l as hasUtmParams,x as isPathInWhitelist,m as localeToRegionCode,R as parseRegionCookie,u as removeLocalePrefix,h as validateRegionConfig};
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/biz-components/IPRedirect/utils.ts"],
+  "sourcesContent": ["/**\n * \u4ECE\u8DEF\u5F84\u4E2D\u79FB\u9664 locale \u524D\u7F00\n * @param path - \u5F53\u524D\u8DEF\u5F84\uFF08\u5982 '/uk/products/a1234' \u6216 '/eu-de'\uFF09\n * @param locales - locale \u5217\u8868\uFF08\u5982 ['us', 'uk', 'eu-de', 'ca']\uFF09\n * @returns \u53BB\u9664 locale \u540E\u7684\u8DEF\u5F84\uFF08\u5982 '/products/a1234' \u6216 '/'\uFF09\n *\n * @example\n * removeLocalePrefix('/uk/products/a1234', ['uk', 'us'])\n * // \u8FD4\u56DE: '/products/a1234'\n *\n * removeLocalePrefix('/eu-de', ['eu-de', 'us'])\n * // \u8FD4\u56DE: '/'\n *\n * removeLocalePrefix('/products/a1234', ['uk', 'us'])\n * // \u8FD4\u56DE: '/products/a1234' (\u6CA1\u6709\u5339\u914D\u7684 locale\uFF0C\u539F\u6837\u8FD4\u56DE)\n */\nexport function removeLocalePrefix(path: string, locales: string[]): string {\n  for (const locale of locales) {\n    if (path === `/${locale}` || path.startsWith(`/${locale}/`)) {\n      return path.substring(`/${locale}`.length) || '/'\n    }\n  }\n  return path\n}\n\n/**\n * \u68C0\u67E5 URL \u641C\u7D22\u53C2\u6570\u4E2D\u662F\u5426\u5305\u542B\u6807\u51C6 UTM \u53C2\u6570\n * \uFF08\u5982 utm_source, utm_medium, utm_campaign \u7B49\uFF09\n *\n * @param searchParams - URL \u641C\u7D22\u53C2\u6570\u5B57\u7B26\u4E32\uFF08\u5982 '?utm_source=google&foo=bar'\uFF09\n * @returns \u662F\u5426\u5305\u542B UTM \u53C2\u6570\n *\n * @example\n * hasUtmParams('?utm_source=google')\n * // \u8FD4\u56DE: true\n *\n * hasUtmParams('?utm_medium=cpc&utm_campaign=summer')\n * // \u8FD4\u56DE: true\n *\n * hasUtmParams('?foo=bar')\n * // \u8FD4\u56DE: false\n *\n * hasUtmParams('')\n * // \u8FD4\u56DE: false\n */\nexport function hasUtmParams(searchParams: string): boolean {\n  return /[?&]utm_/i.test(searchParams)\n}\n\n/**\n * \u5411 URL \u6DFB\u52A0 ref \u53C2\u6570\n *\n * @param url - \u76EE\u6807 URL\uFF08\u53EF\u4EE5\u662F\u5B8C\u6574 URL \u6216\u76F8\u5BF9\u8DEF\u5F84\uFF09\n * @param refValue - ref \u53C2\u6570\u7684\u503C\n * @returns \u6DFB\u52A0\u4E86 ref \u53C2\u6570\u7684 URL\n *\n * @example\n * appendRefParam('https://example.com/products', 'geo_redirect_auto_de')\n * // \u8FD4\u56DE: 'https://example.com/products?ref=geo_redirect_auto_de'\n *\n * appendRefParam('https://example.com/products?utm_source=google', 'geo_redirect_auto_de')\n * // \u8FD4\u56DE: 'https://example.com/products?utm_source=google&ref=geo_redirect_auto_de'\n *\n * appendRefParam('/products', 'affiliate_123')\n * // \u8FD4\u56DE: '/products?ref=affiliate_123'\n */\nexport function appendRefParam(url: string, refValue: string): string {\n  const separator = url.includes('?') ? '&' : '?'\n  return `${url}${separator}ref=${encodeURIComponent(refValue)}`\n}\n\n/**\n * \u6784\u5EFA\u5730\u7406\u91CD\u5B9A\u5411\u7684 ref \u53C2\u6570\u503C\n *\n * @param countryCode - \u56FD\u5BB6\u4EE3\u7801\uFF08\u5982 'DE', 'US', 'HK'\uFF09\n * @returns \u683C\u5F0F\u5316\u7684 ref \u53C2\u6570\u503C\uFF08\u5982 'geo_redirect_auto_de'\uFF09\n *\n * @example\n * buildGeoRedirectRef('DE')\n * // \u8FD4\u56DE: 'geo_redirect_auto_de'\n *\n * buildGeoRedirectRef('HK')\n * // \u8FD4\u56DE: 'geo_redirect_auto_hk'\n */\nexport function buildGeoRedirectRef(countryCode: string): string {\n  return `geo_redirect_auto_${countryCode.toLowerCase()}`\n}\n\n/**\n * \u6784\u5EFA\u5730\u533A\u91CD\u5B9A\u5411\u7684 ref \u53C2\u6570\u503C\uFF08\u624B\u52A8\u5207\u6362\uFF09\n *\n * @param countryCode - \u56FD\u5BB6\u4EE3\u7801\uFF08\u5982 'DE', 'US', 'HK'\uFF09\n * @returns \u683C\u5F0F\u5316\u7684 ref \u53C2\u6570\u503C\uFF08\u5982 'geo_redirect_manual_de'\uFF09\n *\n * @example\n * buildGeoRedirectRefManual('DE')\n * // \u8FD4\u56DE: 'geo_redirect_manual_de'\n *\n * buildGeoRedirectRefManual('HK')\n * // \u8FD4\u56DE: 'geo_redirect_manual_hk'\n */\nexport function buildGeoRedirectRefManual(countryCode: string): string {\n  return `geo_redirect_manual_${countryCode.toLowerCase()}`\n}\n\n/**\n * \u89E3\u6790\u7528\u6237\u5730\u533A\u504F\u597D cookie \u503C\n *\n * @param cookieValue - Cookie \u503C\uFF08\u5982 'v1_CA_EN' \u6216 'v1_CA'\uFF09\n * @returns \u89E3\u6790\u540E\u7684\u5730\u533A\u4EE3\u7801\u548C\u8BED\u8A00\u4EE3\u7801\uFF0C\u5982\u679C\u683C\u5F0F\u65E0\u6548\u8FD4\u56DE null\n *\n * @example\n * parseRegionCookie('v1_CA_EN')\n * // \u8FD4\u56DE: { regionCode: 'CA', languageCode: 'EN' }\n *\n * parseRegionCookie('v1_CA')\n * // \u8FD4\u56DE: { regionCode: 'CA', languageCode: undefined }\n *\n * parseRegionCookie('invalid')\n * // \u8FD4\u56DE: null\n */\nexport function parseRegionCookie(cookieValue: string): {\n  regionCode: string\n  languageCode?: string\n} | null {\n  if (!cookieValue || !cookieValue.startsWith('v1_')) {\n    return null\n  }\n\n  // \u53BB\u9664 'v1_' \u524D\u7F00\n  const parts = cookieValue.substring(3).split('_')\n\n  if (parts.length === 0 || !parts[0]) {\n    return null\n  }\n\n  return {\n    regionCode: parts[0],\n    languageCode: parts[1],\n  }\n}\n\n/**\n * \u4ECE regions \u6570\u7EC4\u81EA\u52A8\u751F\u6210\u5730\u533A\u4EE3\u7801\u5230\u8DEF\u5F84\u524D\u7F00\u7684\u6620\u5C04\n *\n * @param regions - \u5730\u533A\u914D\u7F6E\u6570\u7EC4\n * @param customMap - \u53EF\u9009\u7684\u81EA\u5B9A\u4E49\u6620\u5C04\uFF08\u4F18\u5148\u7EA7\u9AD8\u4E8E\u81EA\u52A8\u751F\u6210\uFF09\n * @returns \u5730\u533A\u4EE3\u7801\u5230\u8DEF\u5F84\u524D\u7F00\u7684\u6620\u5C04\u5BF9\u8C61\n *\n * @example\n * const regions = [\n *   { code: 'US', url: 'https://www.anker.com' },\n *   { code: 'CA', url: 'https://www.anker.com/ca' },\n *   { code: 'DE', url: 'https://www.anker.com/eu-de' }\n * ]\n * generateRegionToPathMap(regions)\n * // \u8FD4\u56DE: { US: '', CA: 'ca', DE: 'eu-de' }\n *\n * generateRegionToPathMap(regions, { UK: 'uk' })\n * // \u8FD4\u56DE: { US: '', CA: 'ca', DE: 'eu-de', UK: 'uk' }\n */\nexport function generateRegionToPathMap(\n  regions: Array<{ code: string; url: string }>,\n  customMap?: Record<string, string>\n): Record<string, string> {\n  const map: Record<string, string> = {}\n\n  // \u4ECE regions \u6570\u7EC4\u81EA\u52A8\u751F\u6210\u6620\u5C04\n  if (regions && regions.length > 0) {\n    regions.forEach(region => {\n      try {\n        const url = new URL(region.url)\n        // \u63D0\u53D6\u8DEF\u5F84\u90E8\u5206\uFF08\u79FB\u9664\u9996\u5C3E\u659C\u6760\uFF09\n        const path = url.pathname.replace(/^\\//, '').replace(/\\/$/, '')\n        map[region.code] = path\n      } catch (e) {\n        // URL \u89E3\u6790\u5931\u8D25\uFF0C\u4F7F\u7528 code \u7684\u5C0F\u5199\u5F62\u5F0F\n        // \u7279\u6B8A\u5904\u7406 US\uFF1A\u4F7F\u7528\u7A7A\u5B57\u7B26\u4E32\n        map[region.code] = region.code === 'US' ? '' : region.code.toLowerCase()\n      }\n    })\n  }\n\n  // \u5408\u5E76\u81EA\u5B9A\u4E49\u6620\u5C04\uFF08\u4F18\u5148\u7EA7\u66F4\u9AD8\uFF09\n  if (customMap && Object.keys(customMap).length > 0) {\n    Object.assign(map, customMap)\n  }\n\n  return map\n}\n\n/**\n * \u68C0\u67E5\u8DEF\u5F84/URL \u662F\u5426\u5728\u767D\u540D\u5355\u4E2D\n * \u652F\u6301\uFF1A\u901A\u914D\u7B26\u5339\u914D\u3001\u5FFD\u7565\u57DF\u540D\u5DEE\u5F02\u3001\u5FFD\u7565\u5C3E\u90E8\u659C\u6760\n *\n * @param path - \u5F53\u524D\u8DEF\u5F84\uFF08\u5982 '/ca' \u6216 '/products/123'\uFF09\n * @param whitelist - \u767D\u540D\u5355\u6570\u7EC4\uFF08\u652F\u6301\u8DEF\u5F84\u6216\u5B8C\u6574 URL\uFF0C\u652F\u6301\u901A\u914D\u7B26 *\uFF09\n * @returns \u662F\u5426\u5728\u767D\u540D\u5355\u4E2D\n *\n * @example\n * isPathInWhitelist('/ca', ['/ca', '/uk'])\n * // \u8FD4\u56DE: true\n *\n * isPathInWhitelist('/ca/', ['/ca'])\n * // \u8FD4\u56DE: true\uFF08\u5FFD\u7565\u5C3E\u90E8\u659C\u6760\uFF09\n *\n * isPathInWhitelist('/products/123', ['/products/*'])\n * // \u8FD4\u56DE: true\uFF08\u901A\u914D\u7B26\u5339\u914D\uFF09\n *\n * isPathInWhitelist('/checkout', ['https://www.anker.com/checkout'])\n * // \u8FD4\u56DE: true\uFF08\u5FFD\u7565\u57DF\u540D\u5DEE\u5F02\uFF09\n *\n * isPathInWhitelist('/about', ['/ca', '/uk'])\n * // \u8FD4\u56DE: false\n */\nexport function isPathInWhitelist(path: string, whitelist: string[]): boolean {\n  if (!whitelist || whitelist.length === 0) {\n    return false\n  }\n\n  // \u8F85\u52A9\u51FD\u6570\uFF1A\u79FB\u9664\u5C3E\u90E8\u659C\u6760\n  const removeTrailingSlash = (str: string): string => {\n    return str?.endsWith('/') ? str.slice(0, -1) : str\n  }\n\n  // \u8F85\u52A9\u51FD\u6570\uFF1A\u4ECE URL \u4E2D\u63D0\u53D6\u8DEF\u5F84\u90E8\u5206\uFF08\u5FFD\u7565\u57DF\u540D\uFF09\n  const extractPath = (urlOrPath: string): string => {\n    if (!urlOrPath) return ''\n\n    // \u5982\u679C\u662F\u5B8C\u6574 URL\uFF0C\u63D0\u53D6\u8DEF\u5F84\u90E8\u5206\n    if (urlOrPath.startsWith('http://') || urlOrPath.startsWith('https://')) {\n      try {\n        const url = new URL(urlOrPath)\n        return url.pathname\n      } catch (e) {\n        return urlOrPath\n      }\n    }\n\n    // \u5426\u5219\u5DF2\u7ECF\u662F\u8DEF\u5F84\uFF0C\u76F4\u63A5\u8FD4\u56DE\n    return urlOrPath\n  }\n\n  // \u6807\u51C6\u5316\u5F53\u524D\u8DEF\u5F84\uFF08\u79FB\u9664\u5C3E\u90E8\u659C\u6760\uFF09\n  const normalizedPath = removeTrailingSlash(path)\n\n  return whitelist.some(pattern => {\n    // \u5982\u679C pattern \u662F\u5B8C\u6574 URL\uFF0C\u53EA\u63D0\u53D6\u8DEF\u5F84\u90E8\u5206\u8FDB\u884C\u6BD4\u8F83\n    const patternPath = extractPath(pattern)\n    const normalizedPatternPath = removeTrailingSlash(patternPath)\n\n    // \u652F\u6301\u901A\u914D\u7B26 * \u5339\u914D\n    if (normalizedPatternPath.includes('*')) {\n      const regexPattern = normalizedPatternPath.replace(/\\*/g, '.*')\n      const regex = new RegExp(`^${regexPattern}$`)\n      return regex.test(normalizedPath)\n    }\n\n    // \u7CBE\u786E\u5339\u914D\u8DEF\u5F84\uFF08\u5FFD\u7565\u5C3E\u90E8\u659C\u6760\uFF0C\u5FFD\u7565\u57DF\u540D\u5DEE\u5F02\uFF09\n    return normalizedPath === normalizedPatternPath\n  })\n}\n\n/**\n * \u9A8C\u8BC1\u5730\u533A\u914D\u7F6E\u7684\u5B8C\u6574\u6027\u548C\u6B63\u786E\u6027\n *\n * @param options - \u9A8C\u8BC1\u9009\u9879\n * @param options.regions - \u5730\u533A\u914D\u7F6E\u6570\u7EC4\n * @param options.countryToRegionMap - \u56FD\u5BB6\u5230\u5730\u533A\u7684\u6620\u5C04\n * @param options.userCountry - \u7528\u6237\u7684\u56FD\u5BB6\u4EE3\u7801\uFF08\u53EF\u9009\uFF09\n * @returns \u9A8C\u8BC1\u7ED3\u679C\n *\n * @example\n * const validation = validateRegionConfig({\n *   regions: [{ code: 'US', ... }, { code: 'CA', ... }],\n *   countryToRegionMap: { US: 'US', CA: 'CA', HK: 'DE' },\n *   userCountry: 'HK'\n * })\n *\n * if (validation.valid) {\n *   console.log('\u6620\u5C04\u7684\u5730\u533A:', validation.mappedRegion) // 'DE'\n * } else {\n *   console.warn('\u9A8C\u8BC1\u5931\u8D25:', validation.error)\n * }\n */\nexport function validateRegionConfig(options: {\n  regions?: Array<{ code: string; [key: string]: any }>\n  countryToRegionMap?: Record<string, string>\n  userCountry?: string\n}): {\n  valid: boolean\n  error?: string\n  mappedRegion?: string\n} {\n  const { regions, countryToRegionMap, userCountry } = options\n\n  // \u68C0\u67E5 regions \u662F\u5426\u914D\u7F6E\n  if (!regions || regions.length === 0) {\n    return {\n      valid: false,\n      error: '\u26A0\uFE0F regions \u672A\u914D\u7F6E\uFF0C\u65E0\u6CD5\u6267\u884C\u5730\u533A\u8DF3\u8F6C',\n    }\n  }\n\n  // \u68C0\u67E5 countryToRegionMap \u662F\u5426\u914D\u7F6E\n  if (!countryToRegionMap || Object.keys(countryToRegionMap).length === 0) {\n    return {\n      valid: false,\n      error: '\u26A0\uFE0F countryToRegionMap \u672A\u914D\u7F6E\uFF0C\u65E0\u6CD5\u6267\u884C\u5730\u533A\u8DF3\u8F6C',\n    }\n  }\n\n  // \u5982\u679C\u63D0\u4F9B\u4E86 userCountry\uFF0C\u9A8C\u8BC1\u6620\u5C04\u5173\u7CFB\n  if (userCountry) {\n    const upperUserCountry = userCountry.toUpperCase()\n    const mappedRegion = countryToRegionMap[upperUserCountry]\n\n    // \u68C0\u67E5\u5F53\u524D\u56FD\u5BB6\u662F\u5426\u6709\u6620\u5C04\n    if (!mappedRegion) {\n      return {\n        valid: false,\n        error: `\u2139\uFE0F \u56FD\u5BB6 ${upperUserCountry} \u672A\u914D\u7F6E\u5730\u533A\u6620\u5C04\uFF0C\u4E0D\u6267\u884C\u8DF3\u8F6C`,\n      }\n    }\n\n    // \u786E\u4FDD\u6620\u5C04\u7684\u5730\u533A\u5728 regions \u4E2D\u5B58\u5728\n    const regionExists = regions.some(r => r.code === mappedRegion)\n    if (!regionExists) {\n      return {\n        valid: false,\n        error: `\u26A0\uFE0F \u5730\u533A\u4EE3\u7801 ${mappedRegion} \u5728 regions \u4E2D\u4E0D\u5B58\u5728\uFF0C\u8BF7\u68C0\u67E5\u914D\u7F6E`,\n      }\n    }\n\n    return {\n      valid: true,\n      mappedRegion,\n    }\n  }\n\n  // \u672A\u63D0\u4F9B userCountry\uFF0C\u53EA\u9A8C\u8BC1\u914D\u7F6E\u5B58\u5728\u6027\n  return {\n    valid: true,\n  }\n}\n\n/**\n * \u5C06 locale \u5B57\u7B26\u4E32\u8F6C\u6362\u4E3A\u5730\u533A\u4EE3\u7801\n *\n * @param locale - \u5F53\u524D locale\uFF08\u5982 'us', 'ca', 'eu-de'\uFF09\n * @param regionToPathMap - \u5730\u533A\u4EE3\u7801\u5230\u8DEF\u5F84\u524D\u7F00\u7684\u6620\u5C04\n * @returns \u5730\u533A\u4EE3\u7801\uFF08\u5982 'US', 'CA', 'DE'\uFF09\n *\n * @example\n * const regionToPathMap = { US: '', CA: 'ca', DE: 'eu-de' }\n *\n * localeToRegionCode('ca', regionToPathMap)\n * // \u8FD4\u56DE: 'CA'\n *\n * localeToRegionCode('eu-de', regionToPathMap)\n * // \u8FD4\u56DE: 'DE'\n *\n * localeToRegionCode('us', regionToPathMap)\n * // \u8FD4\u56DE: 'US'\n *\n * localeToRegionCode('unknown', regionToPathMap)\n * // \u8FD4\u56DE: 'UNKNOWN'\uFF08\u627E\u4E0D\u5230\u65F6\u4F7F\u7528\u5927\u5199\u5F62\u5F0F\uFF09\n */\nexport function localeToRegionCode(locale: string | null | undefined, regionToPathMap: Record<string, string>): string {\n  if (!locale) return 'US'\n\n  // \u67E5\u627E\u5BF9\u5E94\u7684 region code\n  const regionCode = Object.keys(regionToPathMap).find(\n    key => regionToPathMap[key] === locale.toLowerCase() || key === locale.toUpperCase()\n  )\n\n  return regionCode || locale.toUpperCase()\n}\n\n/**\n * \u4ECE regionToPathMap \u751F\u6210\u6240\u6709 locale \u5217\u8868\uFF08\u7528\u4E8E\u79FB\u9664\u8DEF\u5F84\u524D\u7F00\uFF09\n *\n * @param regionToPathMap - \u5730\u533A\u4EE3\u7801\u5230\u8DEF\u5F84\u524D\u7F00\u7684\u6620\u5C04\n * @returns locale \u5217\u8868\uFF08\u8FC7\u6EE4\u6389\u7A7A\u5B57\u7B26\u4E32\uFF09\n *\n * @example\n * const regionToPathMap = { US: '', CA: 'ca', DE: 'eu-de', UK: 'uk' }\n *\n * generateAllLocales(regionToPathMap)\n * // \u8FD4\u56DE: ['ca', 'eu-de', 'uk']\n */\nexport function generateAllLocales(regionToPathMap: Record<string, string>): string[] {\n  return Object.values(regionToPathMap).filter(path => path !== '')\n}\n"],
+  "mappings": "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",
+  "names": ["removeLocalePrefix", "path", "locales", "locale", "hasUtmParams", "searchParams", "appendRefParam", "url", "refValue", "separator", "buildGeoRedirectRef", "countryCode", "buildGeoRedirectRefManual", "parseRegionCookie", "cookieValue", "parts", "generateRegionToPathMap", "regions", "customMap", "map", "region", "isPathInWhitelist", "whitelist", "removeTrailingSlash", "str", "extractPath", "urlOrPath", "normalizedPath", "pattern", "patternPath", "normalizedPatternPath", "regexPattern", "validateRegionConfig", "options", "countryToRegionMap", "userCountry", "upperUserCountry", "mappedRegion", "r", "localeToRegionCode", "regionToPathMap", "key", "generateAllLocales"]
+}