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

package/dist/cjs/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/cjs/biz-components/IPRedirect/useRegionRedirectManager.js

@@ -0,0 +1,2 @@
+"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

@@ -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": "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

@@ -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/cjs/biz-components/IPRedirect/useSavedRegionRedirect.js

@@ -0,0 +1,2 @@
+"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

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

package/dist/cjs/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/cjs/biz-components/IPRedirect/utils.js

@@ -0,0 +1,2 @@
+"use strict";var a=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var l=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var f=(e,r)=>{for(var t in r)a(e,t,{get:r[t],enumerable:!0})},p=(e,r,t,o)=>{if(r&&typeof r=="object"||typeof r=="function")for(let i of l(r))!d.call(e,i)&&i!==t&&a(e,i,{get:()=>r[i],enumerable:!(o=u(r,i))||o.enumerable});return e};var R=e=>p(a({},"__esModule",{value:!0}),e);var W={};f(W,{appendRefParam:()=>h,buildGeoRedirectRef:()=>m,buildGeoRedirectRefManual:()=>y,generateAllLocales:()=>L,generateRegionToPathMap:()=>b,hasUtmParams:()=>x,isPathInWhitelist:()=>v,localeToRegionCode:()=>_,parseRegionCookie:()=>$,removeLocalePrefix:()=>C,validateRegionConfig:()=>U});module.exports=R(W);function C(e,r){for(const t of r)if(e===`/${t}`||e.startsWith(`/${t}/`))return e.substring(`/${t}`.length)||"/";return e}function x(e){return/[?&]utm_/i.test(e)}function h(e,r){const t=e.includes("?")?"&":"?";return`${e}${t}ref=${encodeURIComponent(r)}`}function m(e){return`geo_redirect_auto_${e.toLowerCase()}`}function y(e){return`geo_redirect_manual_${e.toLowerCase()}`}function $(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 b(e,r){const t={};return e&&e.length>0&&e.forEach(o=>{try{const n=new URL(o.url).pathname.replace(/^\//,"").replace(/\/$/,"");t[o.code]=n}catch{t[o.code]=o.code==="US"?"":o.code.toLowerCase()}}),r&&Object.keys(r).length>0&&Object.assign(t,r),t}function v(e,r){if(!r||r.length===0)return!1;const t=n=>n?.endsWith("/")?n.slice(0,-1):n,o=n=>{if(!n)return"";if(n.startsWith("http://")||n.startsWith("https://"))try{return new URL(n).pathname}catch{return n}return n},i=t(e);return r.some(n=>{const g=o(n),s=t(g);if(s.includes("*")){const c=s.replace(/\*/g,".*");return new RegExp(`^${c}$`).test(i)}return i===s})}function U(e){const{regions:r,countryToRegionMap:t,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(!t||Object.keys(t).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(),n=t[i];return n?r.some(s=>s.code===n)?{valid:!0,mappedRegion:n}:{valid:!1,error:`\u26A0\uFE0F \u5730\u533A\u4EE3\u7801 ${n} \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 _(e,r){return e?Object.keys(r).find(o=>r[o]===e.toLowerCase()||o===e.toUpperCase())||e.toUpperCase():"US"}function L(e){return Object.values(e).filter(r=>r!=="")}
+//# sourceMappingURL=utils.js.map

package/dist/cjs/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": ["utils_exports", "__export", "appendRefParam", "buildGeoRedirectRef", "buildGeoRedirectRefManual", "generateAllLocales", "generateRegionToPathMap", "hasUtmParams", "isPathInWhitelist", "localeToRegionCode", "parseRegionCookie", "removeLocalePrefix", "validateRegionConfig", "__toCommonJS", "path", "locales", "locale", "searchParams", "url", "refValue", "separator", "countryCode", "cookieValue", "parts", "regions", "customMap", "map", "region", "whitelist", "removeTrailingSlash", "str", "extractPath", "urlOrPath", "normalizedPath", "pattern", "patternPath", "normalizedPatternPath", "regexPattern", "options", "countryToRegionMap", "userCountry", "upperUserCountry", "mappedRegion", "r", "regionToPathMap", "key"]
+}