@windrun-huaiin/third-ui 30.1.0 → 31.0.0

package/src/clerk/fingerprint/use-fingerprint.ts

@@ -21,7 +21,7 @@ import { FINGERPRINT_SOURCE_REFER, isDebugFingerprintId, isValidFingerprintId }
  * Accepts configuration to customize API endpoint and behavior
  */
 export function useFingerprint(config: FingerprintConfig): UseFingerprintResult {
-  // 服务端渲染检查
+  // Server-side rendering guard.
   if (typeof window === 'undefined') {
     return {
       fingerprintId: null,
@@ -51,7 +51,7 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
   }, []);
 
   /**
-   * 第一阶段：初始化fingerprint ID
+   * Phase 1: initialize fingerprint ID.
    */
   const initializeFingerprintId = useCallback(async () => {
     try {
@@ -68,7 +68,7 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
   }, []);
 
   /**
-   * 第二阶段：初始化匿名用户
+   * Phase 2: initialize anonymous user.
    */
   const initializeAnonymousUser = useCallback(async () => {
     if (!fingerprintId) {
@@ -140,7 +140,7 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
   }, [fingerprintId, config.apiEndpoint, isInitialized]);
 
   /**
-   * 刷新用户数据 - 使用POST请求（后端支持upsert逻辑）
+   * Refresh user data with a POST request; the backend supports upsert semantics.
    */
   const refreshUserData = useCallback(async () => {
     if (!fingerprintId) {
@@ -180,7 +180,7 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
     }
   }, [fingerprintId, config.apiEndpoint]);
 
-  // 第一阶段：页面加载完成后生成指纹ID
+  // Phase 1: generate fingerprint ID after page load.
   useEffect(() => {
     const initFingerprint = async () => {
       setIsLoading(true);
@@ -191,11 +191,11 @@ export function useFingerprint(config: FingerprintConfig): UseFingerprintResult
     initFingerprint();
   }, [initializeFingerprintId]);
 
-  // 第二阶段：有指纹ID后直接初始化用户（后端支持upsert逻辑）
+  // Phase 2: initialize the user once a fingerprint ID is available; the backend supports upsert semantics.
   useEffect(() => {
     if (!fingerprintId || isInitialized || isLoading || error || config.autoInitialize === false) return;
     
-    // 直接使用 POST 请求，后端会处理查询-不存在则创建的逻辑
+    // Use POST directly; the backend handles lookup and create-if-missing behavior.
     initializeAnonymousUser();
   }, [fingerprintId, isInitialized, isLoading, error, initializeAnonymousUser, config.autoInitialize]);
 

package/src/clerk/signin-with-fingerprint-client.tsx

@@ -2,17 +2,18 @@
 
 import { SignIn } from '@clerk/nextjs';
 import { useEffect } from 'react';
+import { clerkAuthPageAppearance } from './clerk-auth-appearance';
 import { useFingerprintContextSafe } from './fingerprint/fingerprint-provider';
 
 /**
  * SignIn component with fingerprint awareness
- * 如果没有FingerprintProvider，会优雅降级为普通SignIn组件
- * 如果有FingerprintProvider，会处理fingerprint相关逻辑
+ * Falls back to the standard SignIn component when FingerprintProvider is absent.
+ * Handles fingerprint-related metadata when FingerprintProvider is available.
  */
 export function SignInWithFingerprint() {
   const fingerprintContext = useFingerprintContextSafe();
   
-  // 如果没有fingerprint context，使用默认值
+  // Use defaults when fingerprint context is unavailable.
   const { 
     fingerprintId = null, 
     xUser = null, 
@@ -20,19 +21,18 @@ export function SignInWithFingerprint() {
     initializeAnonymousUser = async () => {}
   } = fingerprintContext || {};
 
-  // 准备传递给Clerk的metadata，包含匿名用户信息
+  // Prepare Clerk metadata with anonymous user information.
   const unsafeMetadata = {
     user_id: xUser?.userId || null, 
     fingerprint_id: fingerprintId || null,
   };
 
-  // 确保匿名用户已初始化
+  // Ensure the anonymous user has been initialized.
   useEffect(() => {
     if (!isInitialized && fingerprintId) {
       initializeAnonymousUser();
     }
   }, [fingerprintId, isInitialized, initializeAnonymousUser]);
 
-  return <SignIn unsafeMetadata={unsafeMetadata} />;
+  return <SignIn appearance={clerkAuthPageAppearance} unsafeMetadata={unsafeMetadata} />;
 }
-

package/src/clerk/signup-button-with-fingerprint-client.tsx

@@ -2,6 +2,7 @@
 
 import { SignUpButton, useClerk } from '@clerk/nextjs';
 import { useEffect } from 'react';
+import { clerkAuthModalAppearance } from './clerk-auth-appearance';
 import { useFingerprintContextSafe } from './fingerprint/fingerprint-provider';
 
 interface SignUpButtonWithFingerprintProps {
@@ -15,7 +16,7 @@ export function SignUpButtonWithFingerprint({
 }: SignUpButtonWithFingerprintProps) {
   if (mode === 'redirect') {
     return (
-      // 重定向模式则直接跳转到自定义注册页面
+      // Redirect mode navigates directly to the custom sign-up page.
       <SignUpButton>
         <button 
           className="w-16 sm:w-20 h-8 sm:h-9 px-1.5 sm:px-2 border border-gray-300 rounded-full hover:bg-gray-100 dark:border-gray-600 dark:hover:bg-gray-800 text-center text-xs sm:text-sm whitespace-nowrap"
@@ -26,10 +27,10 @@ export function SignUpButtonWithFingerprint({
     )
   }
 
-  // 弹框模式则需要自定义注册按钮
+  // Modal mode requires a custom sign-up button.
   const fingerprintContext = useFingerprintContextSafe();
 
-  // 如果没有fingerprint context，使用默认值
+  // Use defaults when fingerprint context is unavailable.
   const { 
     fingerprintId = null, 
     xUser = null, 
@@ -43,7 +44,7 @@ export function SignUpButtonWithFingerprint({
     fingerprint_id: fingerprintId || null,
   };
 
-  // 确保匿名用户已初始化
+  // Ensure the anonymous user has been initialized.
   useEffect(() => {
     if (!isInitialized && fingerprintId) {
       initializeAnonymousUser();
@@ -55,6 +56,7 @@ export function SignUpButtonWithFingerprint({
 
   const handleClick = () => {
     openSignUp({
+      appearance: clerkAuthModalAppearance,
       unsafeMetadata,
     });
   };
@@ -67,4 +69,4 @@ export function SignUpButtonWithFingerprint({
       {signUp}
     </button>
     );
-}
+}

package/src/clerk/signup-with-fingerprint-client.tsx

@@ -2,17 +2,18 @@
 
 import { SignUp } from '@clerk/nextjs';
 import { useEffect } from 'react';
+import { clerkAuthPageAppearance } from './clerk-auth-appearance';
 import { useFingerprintContextSafe } from './fingerprint/fingerprint-provider';
 
 /**
  * SignUp component with fingerprint awareness
- * 如果没有FingerprintProvider，会优雅降级为普通SignUp组件
- * 如果有FingerprintProvider，会处理fingerprint相关逻辑
+ * Falls back to the standard SignUp component when FingerprintProvider is absent.
+ * Handles fingerprint-related metadata when FingerprintProvider is available.
  */
 export function SignUpWithFingerprint() {
   const fingerprintContext = useFingerprintContextSafe();
   
-  // 如果没有fingerprint context，使用默认值
+  // Use defaults when fingerprint context is unavailable.
   const { 
     fingerprintId = null, 
     xUser = null, 
@@ -20,19 +21,18 @@ export function SignUpWithFingerprint() {
     initializeAnonymousUser = async () => {}
   } = fingerprintContext || {};
 
-  // 准备传递给Clerk的metadata，包含匿名用户信息
+  // Prepare Clerk metadata with anonymous user information.
   const unsafeMetadata = {
     user_id: xUser?.userId || null,
     fingerprint_id: fingerprintId || null,
   };
 
-  // 确保匿名用户已初始化
+  // Ensure the anonymous user has been initialized.
   useEffect(() => {
     if (!isInitialized && fingerprintId) {
       initializeAnonymousUser();
     }
   }, [fingerprintId, isInitialized, initializeAnonymousUser]);
 
-  return <SignUp unsafeMetadata={unsafeMetadata} />;
+  return <SignUp appearance={clerkAuthPageAppearance} unsafeMetadata={unsafeMetadata} />;
 }
-

package/src/fuma/base/custom-home-layout.tsx

@@ -11,10 +11,10 @@ import {
   type MobileMenuAction,
 } from './custom-header';
 
-// - bannerHeight/headerHeight 换成你项目期望的 rem 值即可（如果没有 Banner 就把 bannerHeight 设成 0）。
-// - layoutStyle 同时把变量传给 HomeLayout 的 main 元素，这样内容整体会往下错开，不需要 has-banner/no-banner class。
-// - CustomHomeHeader 直接接受 HomeLayout 的各类 props（links、nav、searchToggle、themeSwitch、i18n 等），内部会复用 Fumadocs 原本的导航功能。
-// - Banner 部分仍然可以用你现有的 FumaBannerSuit（或者任何自定义 Banner 组件），因为 Header 是固定定位、z-index 也处理好了，开关只影响 bannerHeight。
+// - Set bannerHeight/headerHeight to the rem values expected by the project. Use bannerHeight = 0 when there is no banner.
+// - layoutStyle passes the variables to HomeLayout's main element, offsetting content without has-banner/no-banner classes.
+// - CustomHomeHeader accepts HomeLayout props such as links, nav, searchToggle, themeSwitch, and i18n, then reuses Fumadocs navigation behavior.
+// - The banner can still use FumaBannerSuit or any custom banner component. Header positioning and z-index are already handled; the toggle only affects bannerHeight.
 
 export interface CustomHomeLayoutProps {
   locale: string;

package/src/fuma/heavy/mermaid.tsx

@@ -179,7 +179,7 @@ export function Mermaid({ chart, title, watermarkEnabled, watermarkText, handDra
   // prevent browser-level zoom (touchpad pinch/shortcut) from taking effect when the dialog is open
   useEffect(() => {
     if (!open) return;
-    // 初次打开时，默认放大到 400%
+    // Init default zoom out 400%
     resetTransform();
     const onGlobalWheel = (ev: WheelEvent) => {
       if (ev.ctrlKey || ev.metaKey) {

package/src/fuma/site-x.tsx

@@ -10,7 +10,6 @@ export type SiteXProps = Omit<HTMLAttributes<HTMLSpanElement>, 'type'> & {
 };
 
 export async function SiteX({ locale, type, namespace, tKey, className, ...props }: SiteXProps) {
-  // 默认命名空间和key
   let ns = namespace;
   let key = tKey;
   if (!ns) {

package/src/main/calendar/calendar-date-range-input.tsx

@@ -29,7 +29,7 @@ export type CalendarDateRangeInputProps = {
 
 type DateRangeInputPressKey = 'clear';
 
-const DEFAULT_PLACEHOLDER = '滑动窗口日期';
+const DEFAULT_PLACEHOLDER = 'Slide pick Date';
 const DEFAULT_RANGE_DAYS = 7;
 const CLEAR_PRESS_FEEDBACK_MS = 180;
 

package/src/main/credit/types.ts

@@ -47,21 +47,21 @@ export interface CreditCTAConfig {
 export type CreditBucketStatus = 'active' | 'expiringSoon' | 'expired';
 
 export interface CreditBucket {
-  /** 业务方自定义的积分类型标识，用于映射翻译或埋点 */
+  /** Business-defined credit type identifier for translation mapping or analytics. */
   kind: string;
-  /** 若提供则使用该名称，否则由组件根据 kind 使用默认翻译 */
+  /** Display name override; otherwise the component uses the default translation for kind. */
   label?: string;
-  /** 当前积分余额 */
+  /** Current credit balance. */
   balance: number;
-  /** 该类型积分的额度上限 */
+  /** Credit limit for this credit type. */
   limit: number;
-  /** 可选状态标签，用于强调过期等状态 */
+  /** Optional status label for highlighting states such as expiration. */
   status?: CreditBucketStatus;
-  /** 积分过期时间（本地时区字符串），用于组件内部推导状态 */
+  /** Credit expiration time as a local time string, used to derive component state. */
   expiresAt?: string;
-  /** 进度百分比（0-100）；未提供时组件按 balance/limit 计算 */
+  /** Progress percentage from 0 to 100; computed from balance/limit when omitted. */
   progressPercent?: number;
-  /** 任何额外说明，如剩余天数、使用限制等 */
+  /** Additional details, such as remaining days or usage limits. */
   description?: string;
 }
 

package/src/main/gallery/gallery-mobile-swiper.tsx

@@ -19,7 +19,6 @@ const swiperThemeStyle = {
 export function GalleryMobileSwiper({ items }: Props) {
   return (
     <div className="block sm:hidden px-4">
-      {/* 外层容器：强制 maxWidth，防止任何溢出 */}
       <div
         className="w-full overflow-hidden"
         style={{ maxWidth: "min(calc(100vw - 48px), 350px)", margin: "0 auto" }}

package/src/main/gallery/gallery-server.tsx

@@ -33,10 +33,10 @@ export async function Gallery({ locale, sectionClassName, button }: GalleryProps
       </h2>
       <p className="text-center max-w-2xl mx-auto mb-16">{data.description}</p>
 
-      {/* 移动端轮播 */}
+      {/* Mobile swiper */}
       <GalleryMobileSwiper items={data.items} />
 
-      {/* 桌面端网格 */}
+      {/* Desktop grid */}
       <GalleryDesktopGrid items={data.items} />
 
       {button && <div className="text-center mx-auto mt-12 max-w-[85vw]">{button}</div>}

package/src/main/money-price/index.ts

@@ -5,6 +5,8 @@ export { MoneyPriceButton } from './money-price-button';
 export type {
   MoneyPriceConfig,
   MoneyPriceData,
+  MoneyPriceAnimeTone,
+  MoneyPriceStrictDiffAnime,
   InitUserContext,
   MoneyPriceInteractiveProps,
   MoneyPriceButtonProps,

package/src/main/money-price/money-price-button.tsx

@@ -44,9 +44,9 @@ export function MoneyPriceButton({
     return 0;
   };
 
-  // OneTime 模式的按钮配置
+  // Button configuration for one-time mode.
   const getOnetimeButtonConfig = () => {
-    // 匿名用户：所有卡片都显示登录按钮
+    // Anonymous users: show the sign-in button on every card.
     if (!isAuthenticated) {
       return {
         text: texts.getStarted,
@@ -57,12 +57,12 @@ export function MoneyPriceButton({
     }
 
     if (subscriptionStatus === UserState.Anonymous) {
-        // 已登录但状态未知 → 视为 FreeUser
+        // Signed in but status unknown: treat as FreeUser.
         console.warn('Clerk is authed OK but user is anonymous!');
         return { text: '', disabled: true, hidden: true };
     }
 
-    // 登录用户：OneTime 模式下所有卡片都显示购买积分按钮
+    // Signed-in users: show the buy-credits button on every card in one-time mode.
     return {
       text: texts.buyCredits || texts.upgrade,
       onClick: () => onAction(planKey, billingType),
@@ -71,9 +71,9 @@ export function MoneyPriceButton({
     };
   };
 
-  // 订阅模式的按钮配置
+  // Button configuration for subscription mode.
   const getSubscriptionButtonConfig = () => {
-    // 匿名用户
+    // Anonymous users.
     if (!isAuthenticated) {
       const getButtonText = () => {
         switch (planKey) {
@@ -96,7 +96,7 @@ export function MoneyPriceButton({
       };
     }
 
-    // 已登录用户
+    // Signed-in users.
     switch (subscriptionStatus) {
       case UserState.FreeUser: {
         if (planTier === 'F1') {
@@ -115,7 +115,7 @@ export function MoneyPriceButton({
       }
 
       case UserState.ProUser: {
-        // 不允许降级到 Free
+        // Do not allow downgrades to Free.
         if (planTier === 'F1') {
           return { hidden: true };
         }
@@ -209,13 +209,13 @@ export function MoneyPriceButton({
       }
 
       default:
-        // 已登录但状态未知 → 视为 FreeUser
+        // Signed in but status unknown: treat as FreeUser.
         console.warn('Clerk is authed OK but user is anonymous!');
         return { text: '', disabled: true, hidden: true };
     }
   };
 
-  // 主要的按钮配置函数
+  // Main button configuration function.
   const getButtonConfig = () => {
     if (billingType === 'onetime') {
       return getOnetimeButtonConfig();

package/src/main/money-price/money-price-config-util.ts

@@ -1,27 +1,27 @@
 /**
  * Money Price Configuration
- * 价格组件配置文件
+ * Pricing component configuration.
  */
 
 import type { MoneyPriceConfig, PaymentProviderConfig, EnhancePricePlan } from './money-price-types';
 
 /**
- * 获取当前激活的支付供应商配置
+ * Get the currently active payment provider configuration.
  *
- * 🔒 安全设计：
- * - util层负责从config中提取激活的provider配置
- * - 只返回提取的结果，不暴露任何config结构
- * - 调用方（应用层）通过wrapper隐藏config对象
+ * Security design:
+ * - The utility layer extracts the active provider configuration from the config.
+ * - Only the extracted result is returned; the full config structure is not exposed.
+ * - Application-level wrappers hide the config object from callers.
  *
- * @param config - MoneyPriceConfig对象（由应用层提供）
- * @returns 当前激活的支付供应商配置
+ * @param config - MoneyPriceConfig object provided by the application layer.
+ * @returns The currently active payment provider configuration.
  */
 export function getActiveProviderConfigUtil(config: MoneyPriceConfig): PaymentProviderConfig {
   const provider = config.activeProvider;
   return config.paymentProviders[provider];
 }
 
-// 辅助函数：获取特定产品的价格信息
+// Helper: get pricing information for a specific product.
 export function getProductPricing(
   productKey: 'F1' | 'P2' | 'U3',
   billingType: string,
@@ -30,10 +30,10 @@ export function getProductPricing(
 ): EnhancePricePlan {
   const providerConfig = config.paymentProviders[provider];
 
-  // 如果是 onetime 类型，尝试从积分包中获取
+  // For one-time billing, try to resolve pricing from credit packs.
   if (billingType === 'onetime') {
     const creditPacks = providerConfig.creditPackProducts;
-    // 直接使用相同的 key：F1->F1, P2->P2, U3->U3
+    // Use the same product key directly: F1 -> F1, P2 -> P2, U3 -> U3.
     if (creditPacks && creditPacks[productKey]) {
       const pack = creditPacks[productKey];
       return {
@@ -45,7 +45,7 @@ export function getProductPricing(
     }
   }
 
-  // 否则从订阅产品中获取
+  // Otherwise resolve pricing from subscription products.
   const products = providerConfig.subscriptionProducts || providerConfig.products;
   if (products && products[productKey] && products[productKey].plans[billingType]) {
     return products[productKey].plans[billingType];
@@ -54,19 +54,19 @@ export function getProductPricing(
   throw new Error(`Product pricing not found for ${productKey} ${billingType}`);
 }
 
-// ============ 安全的util函数 - 只接收简单的映射表参数，不暴露任何config细节 ============
+// ============ Safe utility functions: accept only simple mapping inputs and do not expose config internals ============
 
 /**
- * 根据 priceId 获取对应的积分数量
+ * Get the credit amount for a price ID.
  *
- * 🔒 安全设计：
- * - util层负责解析config，提取所需数据
- * - 只返回查询结果，不暴露任何config结构
- * - 调用方（应用层）通过wrapper隐藏config对象
+ * Security design:
+ * - The utility layer parses the config and extracts only the required data.
+ * - Only the query result is returned; the full config structure is not exposed.
+ * - Application-level wrappers hide the config object from callers.
  *
- * @param priceId - 查询的价格ID
- * @param config - MoneyPriceConfig对象（由应用层提供）
- * @returns 对应的积分数量，或null
+ * @param priceId - Price ID to query.
+ * @param config - MoneyPriceConfig object provided by the application layer.
+ * @returns The matching credit amount, or null.
  */
 export function getCreditsFromPriceIdUtil(
   priceId: string | undefined,
@@ -76,9 +76,9 @@ export function getCreditsFromPriceIdUtil(
     return null;
   }
 
-  // 遍历所有支付提供商
+  // Iterate through all payment providers.
   for (const provider of Object.values(config.paymentProviders)) {
-    // 遍历订阅产品
+    // Iterate through subscription products.
     const subscriptionProducts = (
       provider.subscriptionProducts || provider.products
     ) as Record<string, any>;
@@ -96,7 +96,7 @@ export function getCreditsFromPriceIdUtil(
       }
     }
 
-    // 遍历积分包产品
+    // Iterate through credit pack products.
     const creditPacks = provider.creditPackProducts as Record<string, any>;
     if (creditPacks) {
       for (const pack of Object.values(creditPacks)) {
@@ -112,23 +112,23 @@ export function getCreditsFromPriceIdUtil(
 }
 
 /**
- * 根据查询参数获取价格配置
+ * Get price configuration by query parameters.
  *
- * 支持三种查询方式：
- * 1. 按 priceId 直接查询
- * 2. 按 plan + billingType 查询
- * 3. 按 plan 查询
+ * Supported query modes:
+ * 1. Query directly by priceId.
+ * 2. Query by plan and billingType.
+ * 3. Query by plan.
  *
- * 🔒 安全设计：
- * - util层负责解析config，提取和匹配数据
- * - 只返回查询结果，不暴露任何config结构
- * - 调用方（应用层）通过wrapper隐藏config对象
+ * Security design:
+ * - The utility layer parses the config and extracts only matching data.
+ * - Only the query result is returned; the full config structure is not exposed.
+ * - Application-level wrappers hide the config object from callers.
  *
- * @param priceId - 查询的价格ID（可选）
- * @param plan - 查询的套餐名称如'P2'、'U3'（可选）
- * @param billingType - 查询的计费类型如'monthly'、'yearly'（可选）
- * @param config - MoneyPriceConfig对象（由应用层提供）
- * @returns 匹配的价格配置，包含计算好的元数据（priceName、description、interval）
+ * @param priceId - Optional price ID to query.
+ * @param plan - Optional plan name, such as 'P2' or 'U3'.
+ * @param billingType - Optional billing type, such as 'monthly' or 'yearly'.
+ * @param config - MoneyPriceConfig object provided by the application layer.
+ * @returns The matching price config with derived metadata: priceName, description, and interval.
  */
 export function getPriceConfigUtil(
   priceId: string | undefined,
@@ -136,9 +136,9 @@ export function getPriceConfigUtil(
   billingType: string | undefined,
   config: MoneyPriceConfig
 ): (EnhancePricePlan & { priceName: string; description: string; interval?: string }) | null {
-  // 遍历所有支付提供商
+  // Iterate through all payment providers.
   for (const provider of Object.values(config.paymentProviders)) {
-    // 遍历订阅产品
+    // Iterate through subscription products.
     const subscriptionProducts = (
       provider.subscriptionProducts || provider.products
     ) as Record<string, any>;
@@ -149,8 +149,8 @@ export function getPriceConfigUtil(
           for (const [billingKey, planConfig] of Object.entries(product.plans)) {
             const plan_config = planConfig as any;
 
-            // 匹配逻辑：按优先级尝试
-            // 1. 按priceId精确匹配（优先级最高）
+            // Matching order by priority.
+            // 1. Exact priceId match with highest priority.
             if (priceId && plan_config.priceId === priceId) {
               return {
                 ...plan_config,
@@ -160,7 +160,7 @@ export function getPriceConfigUtil(
               };
             }
 
-            // 2. 按plan和billingType同时匹配
+            // 2. Match by both plan and billingType.
             if (!priceId && plan && billingType) {
               if (productKey === plan && billingKey === billingType) {
                 return {
@@ -172,7 +172,7 @@ export function getPriceConfigUtil(
               }
             }
 
-            // 3. 按plan匹配（billingType为空时）
+            // 3. Match by plan when billingType is empty.
             if (!priceId && !billingType && plan && productKey === plan) {
               return {
                 ...plan_config,
@@ -186,13 +186,13 @@ export function getPriceConfigUtil(
       }
     }
 
-    // 遍历积分包产品
+    // Iterate through credit pack products.
     const creditPacks = provider.creditPackProducts as Record<string, any>;
     if (creditPacks) {
       for (const [packKey, pack] of Object.entries(creditPacks)) {
         const pack_typed = pack as any;
 
-        // 积分包匹配
+        // Credit pack match.
         if (priceId && pack_typed.priceId === priceId) {
           return {
             priceId: pack_typed.priceId,
@@ -205,7 +205,7 @@ export function getPriceConfigUtil(
           };
         }
 
-        // 按plan和onetime匹配
+        // Match by plan and one-time billing.
         if (!priceId && plan && billingType === 'onetime') {
           if (packKey === plan) {
             return {
@@ -220,7 +220,7 @@ export function getPriceConfigUtil(
           }
         }
 
-        // 按plan匹配（billingType为空时也能找到first积分包）
+        // Match by plan; also resolves the first credit pack when billingType is empty.
         if (!priceId && !billingType && plan && packKey === plan) {
           return {
             priceId: pack_typed.priceId,
@@ -237,4 +237,4 @@ export function getPriceConfigUtil(
   }
 
   return null;
-}
+}