@pnt-team/pnt-component-frontend 0.0.113 → 0.0.120

package/lib/esm/api/types/index.d.ts

@@ -4,23 +4,31 @@
  * 数据来源: https://api-pnt.intlgame.com
  */
 export interface BusinessSelectListBody {
-    /** 业务接入类型：1-纯SDK，2-LI PASS，3-工作室品牌账号 */
-    business_access_method?: number;
-    /** 业务类型列表：1-正式业务，2-测试业务；SmartLink业务始终不返回 */
+    /** 业务类型列表，仅 game_list、game_list_option 场景支持：1-正式业务，2-测试业务 */
     business_types?: number[];
+    /** 云控类型列表，仅 game_list、game_list_option 场景支持：1-INTL Project，2-LI PASS Project */
+    cloudCtrlType?: number[];
+    /** 集群类型列表，仅 game_list、game_list_option 场景支持：1-公有，2-私有，3-未配置 */
+    clusterTypes?: number[];
     /** 需要返回的字段；未传时使用场景默认字段，仅支持服务端白名单字段 */
     fields?: string[];
-    /** 指定业务ID列表；与 Keyword 同时传入时取交集 */
+    /** 业务ID列表，仅 game_list、game_list_option 场景支持 */
     game_ids?: string[];
     /** 业务ID、中文名称或英文名称的模糊匹配关键字 */
     keyword?: string;
+    /** 登录器类型列表，仅 game_list、game_list_option 场景支持 */
+    lander_type?: number[];
+    /** LI PASS 开关列表，仅 game_list、game_list_option 场景支持：1-开启，2-未开启 */
+    lipSwitches?: number[];
     /** 当前页 */
     pageNum?: number;
     /** 每页条数 */
     pageSize?: number;
-    /** 下拉场景：default-通用业务，sdk-SDK定制，compliance_age-合规年龄，custom_region-自定义合规地域 */
+    /** 平台列表，仅 game_list、game_list_option 场景支持 */
+    platform?: string[];
+    /** 下拉场景：game_list-业务列表，game_list_option-业务选择，compliance_age-合规年龄，custom_region-自定义合规地域，sdk-SDK定制 */
     scene?: string;
-    /** 业务状态列表：3-线上运营，4-接入中，5-中途结项，6-已下线 */
+    /** 业务状态列表，仅 game_list、game_list_option 场景支持：3-线上运营，4-接入中，5-中途结项，6-已下线 */
     statuses?: number[];
     /** 总条数 */
     total?: number;
@@ -34,6 +42,8 @@ export interface BusinessSelectListResponseListItem {
     business_type?: number;
     /** 当前场景是否可创建；仅 compliance_age、custom_region 场景有意义 */
     creatable?: boolean;
+    /** 当前业务是否禁用合规年龄认证；仅 compliance_age 场景有意义 */
+    disabled?: boolean;
     /** 业务ID */
     game_id?: string;
     /** 业务接口开发负责人；SDK场景可返回 */
@@ -79,16 +89,14 @@ export interface BusinessGameInfoHighSecurityDecryptBody {
 }
 export type BusinessGameInfoHighSecurityDecryptResponse = Record<string, unknown>[];
 export interface BusinessRegionQueryBody {
-    /** GameID 目标业务 ID；可选，取值必须 > 0。
-     * 不传时不带任何参数，返回全部国家区域（251 个）；传入时返回该业务最终生效的区域。 */
+    /** GameID 目标业务 ID；取值 > 0 时返回该业务实际生效的国家区域；
+  取值 <= 0 或未传时返回国家区域全量字典；与当前登录业务是否一致不做强校验（跨业务查询合法）。 */
     game_id?: number;
-    /** Search 模糊搜索关键字，按 name_en / name_ch / num_code 匹配；可选，默认空字符串。 */
-    search?: string;
 }
 export interface BusinessRegionQueryResponseRegionListItem {
     /** ID 区域主键 ID。 */
     id?: number;
-    /** IsEEARegion 是否 EEA 区域。 */
+    /** IsEEARegion 是否 EEA 区域，取值：0=否，1=是。 */
     is_eea_region?: number;
     /** IsSecretRegion 是否特殊合规区域，取值：1=默认区域，2=特殊区域。 */
     is_secret_region?: number;
@@ -104,24 +112,6 @@ export interface BusinessRegionQueryResponseRegionListItem {
     region_en?: string;
 }
 export interface BusinessRegionQueryResponse {
-    /** BlackCodes 黑名单数字码列表；base_region_list / business_effective_region_list 返回空数组，business_region_rule_detail 返回真实值。 */
-    black_codes?: string[];
-    /** RegionList 国家区域列表；base_region_list 返回完整字典（或搜索子集），
-  business_effective_region_list 返回业务最终生效结果，business_region_rule_detail 返回完整字典（或搜索子集）。 */
-    region_list?: BusinessRegionQueryResponseRegionListItem[];
-    /** RuleState 业务规则状态，取值见 RuleState* 常量：0=未配置，1=启用，2=停用；
-  仅 business_effective_region_list / business_region_rule_detail 场景返回；base_region_list 场景省略（omitempty）。 */
-    rule_state?: number;
-    /** WhiteCodes 白名单数字码列表；base_region_list / business_effective_region_list 返回空数组，business_region_rule_detail 返回真实值。 */
-    white_codes?: string[];
-}
-export interface BusinessGameInfoGetCustomRegionBody {
-    /** GameID 目标业务 ID */
-    game_id: number;
-    /** Env 环境 */
-    env: number;
-}
-export interface BusinessGameInfoGetCustomRegionResponse {
-    /** RegionList 自定义合规区域列表 */
+    /** RegionList 国家区域列表：未携带 game_id 时为全量字典，携带 game_id 时为该业务实际生效区域；均按 id 升序。 */
     region_list?: BusinessRegionQueryResponseRegionListItem[];
 }

package/lib/esm/components/PntBusinessSelect/index.d.ts

@@ -37,11 +37,6 @@ interface PntBusinessSelectProps {
      * @description 1-正式业务，2-测试业务
      */
     businessTypes?: number[];
-    /**
-     * 业务接入类型筛选
-     * @description 1-纯SDK，2-LI PASS，3-工作室品牌账号
-     */
-    businessAccessMethod?: number;
     /**
      * 标签格式
      * @description name-中文名，name_en-英文名，name_id-中文名（ID），name_en_id-英文名（ID）

package/lib/esm/components/PntBusinessSelect/index.js

@@ -64,7 +64,6 @@ const PntBusinessSelect = props => {
     scene = 'default',
     statuses,
     businessTypes,
-    businessAccessMethod,
     labelFormat = 'name',
     labelField,
     optionLabel,
@@ -143,11 +142,10 @@ const PntBusinessSelect = props => {
     scene,
     statuses,
     business_types: businessTypes,
-    business_access_method: businessAccessMethod,
     fields
   }),
   // eslint-disable-next-line react-hooks/exhaustive-deps
-  [scene, statusesKey, businessTypesKey, businessAccessMethod, pageSize, fieldsKey, pagination]);
+  [scene, statusesKey, businessTypesKey, pageSize, fieldsKey, pagination]);
 
   // ---- 获取数据 ----
   // append=true 为滚动翻页（追加），append=false 为初始化/搜索/重置（替换）

package/lib/esm/components/PntRegionSelect/index.d.ts

@@ -13,15 +13,6 @@ import type { PntRegionSelectProps } from './types';
  *   onChange={(v) => setRegions(v)}
  * />
  *
- * // 自定义合规区域
- * <PntRegionSelect
- *   dataSource="custom"
- *   gameId={gameId}
- *   env={0}
- *   value={regions}
- *   onChange={(v) => setRegions(v)}
- * />
- *
  * // 业务最终生效区域
  * <PntRegionSelect
  *   dataSource="business"

package/lib/esm/components/PntRegionSelect/index.js

@@ -1,5 +1,5 @@
-import { businessGameInfoGetCustomRegion, businessRegionQuery } from "../../api";
-import { usePntConfig } from "../../config";
+import { businessRegionQuery } from "../../api";
+import { usePntConfigOptional } from "../../config";
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { Button, Checkbox, Select } from 'tdesign-react';
 import ImportDialog from "./ImportDialog";
@@ -7,15 +7,25 @@ import "./index.scss";
 import { DEFAULT_TEXTS } from "./types";
 
 /**
- * 将后端区域项归一化为组件内部的 RegionOption
- * @description 后端契约字段均为可选，此处补默认值
+ * 归一化 region_code：纯数字字符串去掉前导零（'012' -> '12'），非数字保持原样
+ * @description 后端详情接口可能返回 '12'，字典接口可能返回 '012'，需统一格式才能匹配
  */
 import { jsx as _jsx } from "react/jsx-runtime";
 import { jsxs as _jsxs } from "react/jsx-runtime";
 import { Fragment as _Fragment } from "react/jsx-runtime";
+const normalizeRegionCode = code => {
+  if (code == null || code === '') return '';
+  const str = String(code);
+  return /^\d+$/.test(str) ? String(Number(str)) : str;
+};
+
+/**
+ * 将后端区域项归一化为组件内部的 RegionOption
+ * @description 后端契约字段均为可选，此处补默认值
+ */
 const toRegionOptions = list => (list || []).map(item => ({
   ...item,
-  region_code: item.region_code ?? '',
+  region_code: normalizeRegionCode(item.region_code),
   region_ch: item.region_ch ?? '',
   region_en: item.region_en ?? ''
 }));
@@ -53,15 +63,6 @@ const getLabelText = (item, format) => {
  *   onChange={(v) => setRegions(v)}
  * />
  *
- * // 自定义合规区域
- * <PntRegionSelect
- *   dataSource="custom"
- *   gameId={gameId}
- *   env={0}
- *   value={regions}
- *   onChange={(v) => setRegions(v)}
- * />
- *
  * // 业务最终生效区域
  * <PntRegionSelect
  *   dataSource="business"
@@ -85,8 +86,8 @@ const PntRegionSelect = props => {
     onChange,
     multiple = true,
     dataSource = 'default',
+    scope = 'business',
     gameId,
-    env = 0,
     options: externalOptions,
     disabled = false,
     placeholder,
@@ -96,6 +97,7 @@ const PntRegionSelect = props => {
     texts: customTexts,
     onLoaded,
     optionDisabled,
+    optionFilter,
     optionTooltip,
     importable = false,
     invertible = false,
@@ -107,9 +109,11 @@ const PntRegionSelect = props => {
     style,
     popupProps
   } = props;
-  const {
-    http
-  } = usePntConfig();
+
+  // 外部受控模式下无需 http，因此使用可选版配置读取
+  const config = usePntConfigOptional();
+  const http = config?.http;
+  const regionQuery = config?.regionQuery;
   const texts = useMemo(() => ({
     ...DEFAULT_TEXTS,
     ...customTexts
@@ -132,37 +136,29 @@ const PntRegionSelect = props => {
   // ---- 获取数据 ----
   const fetchData = useCallback(async () => {
     if (isExternal) return;
+    if (!http) {
+      console.warn('[PntRegionSelect] 未注入 PntProvider.http，无法内部拉取区域数据；请用 <PntProvider> 包裹，或改用外部 options 模式');
+      return;
+    }
     const seq = ++fetchSeqRef.current;
     setLoading(true);
     try {
       let list = [];
-      if (dataSource === 'custom') {
-        if (!gameId) {
-          console.warn('[PntRegionSelect] dataSource="custom" 时必须传入 gameId');
-          return;
-        }
-        const res = await businessGameInfoGetCustomRegion(http, {
-          game_id: Number(gameId),
-          env
-        });
-        if (seq !== fetchSeqRef.current) return;
-        if (res.code === 0 && res.data?.region_list) {
-          list = toRegionOptions(res.data.region_list);
-        }
-      } else if (dataSource === 'business') {
+      const url = scope === 'platform' ? regionQuery?.queryPlatUrl || '/v5/business/region/plat-query?audience=/laas-pnt' : regionQuery?.queryUrl || '/v5/business/region/query?audience=/laas-pnt';
+      if (dataSource === 'business') {
         if (!gameId) {
           console.warn('[PntRegionSelect] dataSource="business" 时必须传入 gameId');
           return;
         }
         const res = await businessRegionQuery(http, {
           game_id: Number(gameId)
-        });
+        }, url);
         if (seq !== fetchSeqRef.current) return;
         if (res.code === 0 && res.data?.region_list) {
           list = toRegionOptions(res.data.region_list);
         }
       } else {
-        const res = await businessRegionQuery(http, {});
+        const res = await businessRegionQuery(http, {}, url);
         if (seq !== fetchSeqRef.current) return;
         if (res.code === 0 && res.data?.region_list) {
           list = toRegionOptions(res.data.region_list);
@@ -177,7 +173,7 @@ const PntRegionSelect = props => {
         setLoading(false);
       }
     }
-  }, [http, dataSource, gameId, env, isExternal]);
+  }, [http, dataSource, gameId, isExternal, scope, regionQuery]);
 
   // ---- 初始加载 ----
   useEffect(() => {
@@ -185,20 +181,29 @@ const PntRegionSelect = props => {
   }, [fetchData]);
 
   // ---- 生效的选项列表 ----
-  const options = useMemo(() => isExternal ? externalOptions : innerOptions, [isExternal, externalOptions, innerOptions]);
+  // 外部传入的 options 也需归一化 region_code（去前导零），否则无法与 valueArr 匹配
+  const options = useMemo(() => (isExternal ? externalOptions : innerOptions).map(item => ({
+    ...item,
+    region_code: normalizeRegionCode(item.region_code)
+  })), [isExternal, externalOptions, innerOptions]);
 
-  // ---- 归一化选中值为数组（兼容单选字符串） ----
+  // ---- 归一化选中值为数组（兼容单选字符串），并去掉前导零与 options 对齐 ----
   const valueArr = useMemo(() => {
     if (value === undefined || value === null || value === '') return [];
-    return Array.isArray(value) ? value.map(String) : [String(value)];
+    const arr = Array.isArray(value) ? value : [value];
+    return arr.map(v => normalizeRegionCode(v));
   }, [value]);
 
-  // ---- 本地搜索过滤 ----
+  // ---- 本地搜索过滤 + optionFilter 自定义过滤 ----
   const filteredOptions = useMemo(() => {
-    if (!searchKeyword) return options;
+    let result = options;
+    if (optionFilter) {
+      result = result.filter(optionFilter);
+    }
+    if (!searchKeyword) return result;
     const kw = searchKeyword.toLowerCase();
-    return options.filter(item => item.region_ch?.toLowerCase().includes(kw) || item.region_en?.toLowerCase().includes(kw) || item.region_code?.toLowerCase().includes(kw));
-  }, [options, searchKeyword]);
+    return result.filter(item => item.region_ch?.toLowerCase().includes(kw) || item.region_en?.toLowerCase().includes(kw) || item.region_code?.toLowerCase().includes(kw));
+  }, [options, searchKeyword, optionFilter]);
 
   // ---- 判断选项是否禁用 ----
   const isOptionDisabled = useCallback(item => {
@@ -259,7 +264,7 @@ const PntRegionSelect = props => {
   // ---- Select onChange ----
   const handleChange = useCallback(val => {
     const values = Array.isArray(val) ? val : val ? [val] : [];
-    const strValues = values.map(String);
+    const strValues = values.map(normalizeRegionCode);
     const selectedOptions = options.filter(o => strValues.includes(o.region_code));
     if (multiple) {
       onChange?.(strValues, selectedOptions);

package/lib/esm/components/PntRegionSelect/types.d.ts

@@ -22,10 +22,8 @@ export interface RegionOption {
  * 数据源类型
  * - default: 全部国家区域（不带任何参数，返回全部 251 个）/api/v5/business/region/query
  * - business: 业务最终生效的区域（必须传 gameId）/api/v5/business/region/query
- * - custom: 自定义合规区域 /v4/business/game_info/get-custom-region
- * - compliance: 合规区域（从业务配置接口获取 compliance_zone）
  */
-export type RegionDataSource = 'default' | 'business' | 'custom' | 'compliance';
+export type RegionDataSource = 'default' | 'business';
 /**
  * 标签格式
  * - name: 中文名
@@ -100,10 +98,14 @@ export interface PntRegionSelectProps {
     multiple?: boolean;
     /** 数据源类型 @default 'default' */
     dataSource?: RegionDataSource;
-    /** 业务ID（dataSource='custom' | 'business' 时必传） */
+    /**
+     * 接口作用域 @default 'business'
+     * - business: 业务级区域查询 /api/v5/business/region/query
+     * - platform: 平台级区域查询 /api/v5/business/region/plat-query
+     */
+    scope?: 'business' | 'platform';
+    /** 业务ID（dataSource='business' 时必传） */
     gameId?: string | number;
-    /** 环境（dataSource='custom' 时必传） @default 0 */
-    env?: number;
     /**
      * 外部受控选项列表（传入后跳过内部请求，直接使用该数据；
      * 适用于选项由父组件获取/过滤的场景）
@@ -125,6 +127,8 @@ export interface PntRegionSelectProps {
     onLoaded?: (options: RegionOption[]) => void;
     /** 自定义选项禁用逻辑 */
     optionDisabled?: (item: RegionOption) => boolean;
+    /** 自定义选项过滤逻辑（内部拉取数据时生效，用于只展示部分区域） */
+    optionFilter?: (item: RegionOption) => boolean;
     /** 自定义选项 tooltip */
     optionTooltip?: (item: RegionOption) => string;
     /**

package/lib/esm/components/PntRegionSelect/types.js

@@ -6,8 +6,6 @@
  * 数据源类型
  * - default: 全部国家区域（不带任何参数，返回全部 251 个）/api/v5/business/region/query
  * - business: 业务最终生效的区域（必须传 gameId）/api/v5/business/region/query
- * - custom: 自定义合规区域 /v4/business/game_info/get-custom-region
- * - compliance: 合规区域（从业务配置接口获取 compliance_zone）
  */
 
 /**

package/lib/esm/config.d.ts

@@ -15,8 +15,8 @@ export interface commonEesType<T> {
  * 任何具备 axios 兼容 post 签名的实例均可注入。
  */
 export interface PntHttpLike {
-    get<T = unknown, R = unknown>(url: string, config?: any): Promise<R>;
-    post<T = unknown, R = unknown, D = unknown>(url: string, data?: D, config?: any): Promise<R>;
+    get<R = unknown>(url: string, config?: any): Promise<R>;
+    post<R = unknown, D = unknown>(url: string, data?: D, config?: any): Promise<R>;
 }
 /**
  * 高敏信息解锁接口配置（可选，全局覆盖）
@@ -37,6 +37,21 @@ export interface PntHighSecurityConfig {
     /** audience 覆盖（默认 /laas-pnt） */
     audience?: string;
 }
+/**
+ * 地区查询接口配置（可选，全局覆盖）
+ */
+export interface PntRegionQueryConfig {
+    /**
+     * 业务级地区查询接口 URL，覆盖默认 /api/v5/business/region/query?audience=/laas-pnt
+     * @description scope='business'（默认）时使用
+     */
+    queryUrl?: string;
+    /**
+     * 平台级地区查询接口 URL，覆盖默认 /api/v5/business/region/plat-query?audience=/laas-pnt
+     * @description scope='platform' 时使用
+     */
+    queryPlatUrl?: string;
+}
 /**
  * 组件库运行时配置：由消费方通过 PntProvider 注入
  */
@@ -45,6 +60,8 @@ export interface PntConfig {
     http: PntHttpLike;
     /** 高敏信息解锁接口全局配置（可选） */
     highSecurity?: PntHighSecurityConfig;
+    /** 地区查询接口全局配置（可选） */
+    regionQuery?: PntRegionQueryConfig;
 }
 /**
  * 配置 Provider：消费方在应用根入口包裹一次即可
@@ -64,3 +81,10 @@ export declare const PntProvider: import("react").Provider<PntConfig | null>;
  * @internal
  */
 export declare const usePntConfig: () => PntConfig;
+/**
+ * 获取组件库运行时配置（可选版本，内部使用）
+ * @description 供「外部受控数据」模式的组件使用：未注入 Provider 时返回 null，
+ *              组件自行降级（不发起内部请求），不抛错
+ * @internal
+ */
+export declare const usePntConfigOptional: () => PntConfig | null;

package/lib/esm/config.js

@@ -15,6 +15,10 @@ import { createContext, useContext } from 'react';
  * 高敏信息解锁接口配置（可选，全局覆盖）
  */
 
+/**
+ * 地区查询接口配置（可选，全局覆盖）
+ */
+
 /**
  * 组件库运行时配置：由消费方通过 PntProvider 注入
  */
@@ -45,4 +49,12 @@ export const usePntConfig = () => {
     throw new Error('[pnt-component-frontend] 未注入配置：请在应用根入口用 <PntProvider value={{ http }}> 包裹');
   }
   return cfg;
-};
+};
+
+/**
+ * 获取组件库运行时配置（可选版本，内部使用）
+ * @description 供「外部受控数据」模式的组件使用：未注入 Provider 时返回 null，
+ *              组件自行降级（不发起内部请求），不抛错
+ * @internal
+ */
+export const usePntConfigOptional = () => useContext(PntContext);

package/lib/esm/index.d.ts

@@ -1,4 +1,4 @@
-export { PntProvider, usePntConfig, type PntConfig, type PntHighSecurityConfig, type PntHttpLike, type commonEesType, } from './config';
+export { PntProvider, usePntConfig, type PntConfig, type PntHighSecurityConfig, type PntHttpLike, type PntRegionQueryConfig, type commonEesType, } from './config';
 export { default as PntImage } from './components/PntImage';
 export { default as PntBusinessSelect } from './components/PntBusinessSelect';
 export { default as PntRegionSelect } from './components/PntRegionSelect';
@@ -7,4 +7,6 @@ export { default as PntSecureBox } from './components/PntSecureBox';
 export { useHighSecurity } from './hooks/useHighSecurity';
 export type { ClearSecurityDataFilter, HighSecurityApiConfig, HighSecurityParamItem, HighSecurityRequestParams, HighSecurityScope, UseHighSecurityOptions, UseHighSecurityResult, } from './hooks/useHighSecurity';
 export { isSecurityData } from './utils';
+export { businessGameInfoHighSecurityDecrypt, businessRegionQuery, businessSelectList, } from './api';
+export type { BusinessRegionQueryBody, BusinessRegionQueryResponse, BusinessRegionQueryResponseRegionListItem, } from './api/types';
 export { default as PntGeneralLayout } from './components/PntGeneralLayout';

package/lib/esm/index.js

@@ -25,5 +25,7 @@ export { default as PntSecureBox } from "./components/PntSecureBox";
 export { useHighSecurity } from "./hooks/useHighSecurity";
 export { isSecurityData } from "./utils";
 
+// ---------- 业务 API（与组件内部共用，供外部受控模式调用） ----------
+export { businessGameInfoHighSecurityDecrypt, businessRegionQuery, businessSelectList } from "./api";
 // ---------- L3 布局组件 ----------
 export { default as PntGeneralLayout } from "./components/PntGeneralLayout";