@windrun-huaiin/third-ui 30.1.0 → 31.0.0

package/dist/main/credit/types.d.ts

@@ -29,21 +29,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;
 }
 export interface SubscriptionInfo {

package/dist/main/money-price/index.d.ts

@@ -1,4 +1,4 @@
 export { MoneyPriceInteractive } from './money-price-interactive';
 export { MoneyPriceButton } from './money-price-button';
-export type { MoneyPriceConfig, MoneyPriceData, InitUserContext, MoneyPriceInteractiveProps, MoneyPriceButtonProps, PaymentProvider, PaymentProviderConfig, EnhancePricePlan, SubscriptionProductConfig, CreditPackProductConfig, UserContext, } from './money-price-types';
+export type { MoneyPriceConfig, MoneyPriceData, MoneyPriceAnimeTone, MoneyPriceStrictDiffAnime, InitUserContext, MoneyPriceInteractiveProps, MoneyPriceButtonProps, PaymentProvider, PaymentProviderConfig, EnhancePricePlan, SubscriptionProductConfig, CreditPackProductConfig, UserContext, } from './money-price-types';
 export { UserState } from './money-price-types';

package/dist/main/money-price/money-price-button.js

@@ -26,9 +26,9 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
             return billing === 'monthly' ? 2 : 4;
         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,
@@ -38,11 +38,11 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
             };
         }
         if (subscriptionStatus === moneyPriceTypes.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),
@@ -50,9 +50,9 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
             hidden: false
         };
     };
-    // 订阅模式的按钮配置
+    // Button configuration for subscription mode.
     const getSubscriptionButtonConfig = () => {
-        // 匿名用户
+        // Anonymous users.
         if (!isAuthenticated) {
             const getButtonText = () => {
                 switch (planKey) {
@@ -73,7 +73,7 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
                 hidden: false
             };
         }
-        // 已登录用户
+        // Signed-in users.
         switch (subscriptionStatus) {
             case moneyPriceTypes.UserState.FreeUser: {
                 if (planTier === 'F1') {
@@ -91,7 +91,7 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
                 };
             }
             case moneyPriceTypes.UserState.ProUser: {
-                // 不允许降级到 Free
+                // Do not allow downgrades to Free.
                 if (planTier === 'F1') {
                     return { hidden: true };
                 }
@@ -169,12 +169,12 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
                 return { hidden: true };
             }
             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/dist/main/money-price/money-price-button.mjs

@@ -24,9 +24,9 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
             return billing === 'monthly' ? 2 : 4;
         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,
@@ -36,11 +36,11 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
             };
         }
         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),
@@ -48,9 +48,9 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
             hidden: false
         };
     };
-    // 订阅模式的按钮配置
+    // Button configuration for subscription mode.
     const getSubscriptionButtonConfig = () => {
-        // 匿名用户
+        // Anonymous users.
         if (!isAuthenticated) {
             const getButtonText = () => {
                 switch (planKey) {
@@ -71,7 +71,7 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
                 hidden: false
             };
         }
-        // 已登录用户
+        // Signed-in users.
         switch (subscriptionStatus) {
             case UserState.FreeUser: {
                 if (planTier === 'F1') {
@@ -89,7 +89,7 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
                 };
             }
             case UserState.ProUser: {
-                // 不允许降级到 Free
+                // Do not allow downgrades to Free.
                 if (planTier === 'F1') {
                     return { hidden: true };
                 }
@@ -167,12 +167,12 @@ function MoneyPriceButton({ planKey, userContext, billingType, onAuth, onAction,
                 return { hidden: true };
             }
             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/dist/main/money-price/money-price-config-util.d.ts

@@ -1,52 +1,52 @@
 /**
  * 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 declare function getActiveProviderConfigUtil(config: MoneyPriceConfig): PaymentProviderConfig;
 export declare function getProductPricing(productKey: 'F1' | 'P2' | 'U3', billingType: string, provider: string, config: MoneyPriceConfig): EnhancePricePlan;
 /**
- * 根据 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 declare function getCreditsFromPriceIdUtil(priceId: string | undefined, config: MoneyPriceConfig): number | null;
 /**
- * 根据查询参数获取价格配置
+ * 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 declare function getPriceConfigUtil(priceId: string | undefined, plan: string | undefined, billingType: string | undefined, config: MoneyPriceConfig): (EnhancePricePlan & {
     priceName: string;

package/dist/main/money-price/money-price-config-util.js

@@ -2,30 +2,30 @@
 
 /**
  * Money Price Configuration
- * 价格组件配置文件
+ * Pricing component configuration.
  */
 /**
- * 获取当前激活的支付供应商配置
+ * 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.
  */
 function getActiveProviderConfigUtil(config) {
     const provider = config.activeProvider;
     return config.paymentProviders[provider];
 }
-// 辅助函数：获取特定产品的价格信息
+// Helper: get pricing information for a specific product.
 function getProductPricing(productKey, billingType, provider, config) {
     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 {
@@ -36,33 +36,33 @@ function getProductPricing(productKey, billingType, provider, config) {
             };
         }
     }
-    // 否则从订阅产品中获取
+    // 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];
     }
     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.
  */
 function getCreditsFromPriceIdUtil(priceId, config) {
     if (!priceId) {
         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);
         if (subscriptionProducts) {
             for (const product of Object.values(subscriptionProducts)) {
@@ -76,7 +76,7 @@ function getCreditsFromPriceIdUtil(priceId, config) {
                 }
             }
         }
-        // 遍历积分包产品
+        // Iterate through credit pack products.
         const creditPacks = provider.creditPackProducts;
         if (creditPacks) {
             for (const pack of Object.values(creditPacks)) {
@@ -90,46 +90,46 @@ function getCreditsFromPriceIdUtil(priceId, config) {
     return null;
 }
 /**
- * 根据查询参数获取价格配置
+ * 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.
  */
 function getPriceConfigUtil(priceId, plan, billingType, config) {
-    // 遍历所有支付提供商
+    // Iterate through all payment providers.
     for (const provider of Object.values(config.paymentProviders)) {
-        // 遍历订阅产品
+        // Iterate through subscription products.
         const subscriptionProducts = (provider.subscriptionProducts || provider.products);
         if (subscriptionProducts) {
             for (const [productKey, product] of Object.entries(subscriptionProducts)) {
                 if (product.plans) {
                     for (const [billingKey, planConfig] of Object.entries(product.plans)) {
                         const plan_config = planConfig;
-                        // 匹配逻辑：按优先级尝试
-                        // 1. 按priceId精确匹配（优先级最高）
+                        // Matching order by priority.
+                        // 1. Exact priceId match with highest priority.
                         if (priceId && plan_config.priceId === priceId) {
                             return Object.assign(Object.assign({}, plan_config), { priceName: `${productKey} ${billingKey}`, description: `${productKey} plan - ${billingKey} billing`, interval: billingKey === 'yearly' ? 'year' : 'month' });
                         }
-                        // 2. 按plan和billingType同时匹配
+                        // 2. Match by both plan and billingType.
                         if (!priceId && plan && billingType) {
                             if (productKey === plan && billingKey === billingType) {
                                 return Object.assign(Object.assign({}, plan_config), { priceName: `${productKey} ${billingKey}`, description: `${productKey} plan - ${billingKey} billing`, interval: billingKey === 'yearly' ? 'year' : 'month' });
                             }
                         }
-                        // 3. 按plan匹配（billingType为空时）
+                        // 3. Match by plan when billingType is empty.
                         if (!priceId && !billingType && plan && productKey === plan) {
                             return Object.assign(Object.assign({}, plan_config), { priceName: `${productKey} ${billingKey}`, description: `${productKey} plan - ${billingKey} billing`, interval: billingKey === 'yearly' ? 'year' : 'month' });
                         }
@@ -137,12 +137,12 @@ function getPriceConfigUtil(priceId, plan, billingType, config) {
                 }
             }
         }
-        // 遍历积分包产品
+        // Iterate through credit pack products.
         const creditPacks = provider.creditPackProducts;
         if (creditPacks) {
             for (const [packKey, pack] of Object.entries(creditPacks)) {
                 const pack_typed = pack;
-                // 积分包匹配
+                // Credit pack match.
                 if (priceId && pack_typed.priceId === priceId) {
                     return {
                         priceId: pack_typed.priceId,
@@ -154,7 +154,7 @@ function getPriceConfigUtil(priceId, plan, billingType, config) {
                         interval: 'onetime',
                     };
                 }
-                // 按plan和onetime匹配
+                // Match by plan and one-time billing.
                 if (!priceId && plan && billingType === 'onetime') {
                     if (packKey === plan) {
                         return {
@@ -168,7 +168,7 @@ function getPriceConfigUtil(priceId, plan, billingType, config) {
                         };
                     }
                 }
-                // 按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,