@windrun-huaiin/third-ui 30.1.0 → 31.0.0

package/dist/clerk/fingerprint/fingerprint-client.d.ts

@@ -1,7 +1,7 @@
 /**
  * Fingerprint Client Utilities
- * 客户端专用的指纹生成和管理逻辑
- * 只能在浏览器环境中使用
+ * Client-only fingerprint generation and management logic.
+ * Must be used only in browser environments.
  */
 type FirstTouchData = {
     landingUrl?: string;
@@ -25,29 +25,29 @@ type FirstTouchData = {
 };
 export declare function getOrCreateFirstTouchData(): FirstTouchData | null;
 /**
- * 生成基于真实浏览器特征的fingerprint ID
- * 使用 FingerprintJS 收集浏览器特征并生成唯一标识
+ * Generate a fingerprint ID from real browser characteristics.
+ * Uses FingerprintJS to collect browser signals and create a stable identifier.
  */
 export declare function generateFingerprintId(): Promise<string>;
 /**
- * 获取当前的fingerprint ID
+ * Get the current fingerprint ID.
  */
 export declare function getFingerprintId(): string | null;
 /**
- * 设置fingerprint ID到存储
+ * Store a fingerprint ID.
  */
 export declare function setFingerprintId(fingerprintId: string): void;
 /**
- * 清除fingerprint ID
+ * Clear the fingerprint ID.
  */
 export declare function clearFingerprintId(): void;
 /**
- * 获取或生成fingerprint ID
- * 如果不存在则自动生成新的
+ * Get or generate a fingerprint ID.
+ * Automatically creates one when none exists.
  */
 export declare function getOrGenerateFingerprintId(): Promise<string>;
 /**
- * 创建包含fingerprint ID的fetch headers
+ * Create fetch headers containing the fingerprint ID.
  */
 export declare function createFingerprintHeaders(): Promise<Record<string, string>>;
 /**

package/dist/clerk/fingerprint/fingerprint-client.js

@@ -6,28 +6,28 @@ var fingerprintShared = require('./fingerprint-shared.js');
 
 /**
  * Fingerprint Client Utilities
- * 客户端专用的指纹生成和管理逻辑
- * 只能在浏览器环境中使用
+ * Client-only fingerprint generation and management logic.
+ * Must be used only in browser environments.
  */
 const FIRST_TOUCH_MAX_LENGTH = 2048;
 const FIRST_TOUCH_COOKIE_DAYS = 30;
 /**
- * 检查浏览器存储（localStorage 和 cookie）中的指纹 ID
- * 返回有效的 ID 或 null
+ * Check fingerprint ID in browser storage, including localStorage and cookies.
+ * Returns a valid ID or null.
  */
 function checkStoredFingerprintId() {
     if (typeof window === 'undefined') {
         return null;
     }
-    // 优先检查 localStorage
+    // Prefer localStorage.
     const localStorageId = getLocalStorageValue(fingerprintShared.FINGERPRINT_STORAGE_KEY);
     if (localStorageId && fingerprintShared.isValidFingerprintId(localStorageId)) {
         return localStorageId;
     }
-    // 检查 cookie
+    // Check cookies.
     const cookieId = getCookieValue(fingerprintShared.FINGERPRINT_COOKIE_NAME);
     if (cookieId && fingerprintShared.isValidFingerprintId(cookieId)) {
-        // 同步到 localStorage
+        // Sync back to localStorage.
         setLocalStorageValue(fingerprintShared.FINGERPRINT_STORAGE_KEY, cookieId);
         return cookieId;
     }
@@ -152,32 +152,32 @@ function getOrCreateFirstTouchData() {
     return created;
 }
 /**
- * 生成基于真实浏览器特征的fingerprint ID
- * 使用 FingerprintJS 收集浏览器特征并生成唯一标识
+ * Generate a fingerprint ID from real browser characteristics.
+ * Uses FingerprintJS to collect browser signals and create a stable identifier.
  */
 function generateFingerprintId() {
     return tslib.__awaiter(this, void 0, void 0, function* () {
         if (typeof window === 'undefined') {
             throw new Error('generateFingerprintId can only be used in browser environment');
         }
-        // 检查现有 ID
+        // Check for an existing ID.
         const existingId = checkStoredFingerprintId();
         if (existingId) {
             return existingId;
         }
         try {
-            // 使用 FingerprintJS 生成指纹
+            // Generate a fingerprint with FingerprintJS.
             const fp = yield FingerprintJS.load();
             const result = yield fp.get();
             const fingerprintId = `fp_${result.visitorId}`;
-            // 存储到 localStorage 和 cookie
+            // Store in localStorage and cookies.
             setLocalStorageValue(fingerprintShared.FINGERPRINT_STORAGE_KEY, fingerprintId);
             setCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
             return fingerprintId;
         }
         catch (error) {
             console.warn('Failed to generate fingerprint with FingerprintJS:', error);
-            // 降级方案：生成基于时间戳和随机数的 ID
+            // Fallback: generate an ID from timestamp and randomness.
             const fallbackId = `fp_fallback_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
             setLocalStorageValue(fingerprintShared.FINGERPRINT_STORAGE_KEY, fallbackId);
             setCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME, fallbackId, 365);
@@ -186,13 +186,13 @@ function generateFingerprintId() {
     });
 }
 /**
- * 获取当前的fingerprint ID
+ * Get the current fingerprint ID.
  */
 function getFingerprintId() {
     return checkStoredFingerprintId();
 }
 /**
- * 设置fingerprint ID到存储
+ * Store a fingerprint ID.
  */
 function setFingerprintId(fingerprintId) {
     if (typeof window === 'undefined') {
@@ -205,7 +205,7 @@ function setFingerprintId(fingerprintId) {
     setCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
 }
 /**
- * 清除fingerprint ID
+ * Clear the fingerprint ID.
  */
 function clearFingerprintId() {
     if (typeof window === 'undefined') {
@@ -215,8 +215,8 @@ function clearFingerprintId() {
     deleteCookie(fingerprintShared.FINGERPRINT_COOKIE_NAME);
 }
 /**
- * 获取或生成fingerprint ID
- * 如果不存在则自动生成新的
+ * Get or generate a fingerprint ID.
+ * Automatically creates one when none exists.
  */
 function getOrGenerateFingerprintId() {
     return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -228,7 +228,7 @@ function getOrGenerateFingerprintId() {
     });
 }
 /**
- * 创建包含fingerprint ID的fetch headers
+ * Create fetch headers containing the fingerprint ID.
  */
 function createFingerprintHeaders() {
     return tslib.__awaiter(this, void 0, void 0, function* () {
@@ -259,7 +259,7 @@ function createFingerprintFetch() {
         return fetch(url, Object.assign(Object.assign({}, init), { headers }));
     });
 }
-// Cookie 辅助函数 (私有)
+// Private cookie helpers.
 function getCookieValue(name) {
     var _a;
     if (typeof document === 'undefined') {

package/dist/clerk/fingerprint/fingerprint-client.mjs

@@ -4,28 +4,28 @@ import { FINGERPRINT_STORAGE_KEY, FINGERPRINT_COOKIE_NAME, isValidFingerprintId,
 
 /**
  * Fingerprint Client Utilities
- * 客户端专用的指纹生成和管理逻辑
- * 只能在浏览器环境中使用
+ * Client-only fingerprint generation and management logic.
+ * Must be used only in browser environments.
  */
 const FIRST_TOUCH_MAX_LENGTH = 2048;
 const FIRST_TOUCH_COOKIE_DAYS = 30;
 /**
- * 检查浏览器存储（localStorage 和 cookie）中的指纹 ID
- * 返回有效的 ID 或 null
+ * Check fingerprint ID in browser storage, including localStorage and cookies.
+ * Returns a valid ID or null.
  */
 function checkStoredFingerprintId() {
     if (typeof window === 'undefined') {
         return null;
     }
-    // 优先检查 localStorage
+    // Prefer localStorage.
     const localStorageId = getLocalStorageValue(FINGERPRINT_STORAGE_KEY);
     if (localStorageId && isValidFingerprintId(localStorageId)) {
         return localStorageId;
     }
-    // 检查 cookie
+    // Check cookies.
     const cookieId = getCookieValue(FINGERPRINT_COOKIE_NAME);
     if (cookieId && isValidFingerprintId(cookieId)) {
-        // 同步到 localStorage
+        // Sync back to localStorage.
         setLocalStorageValue(FINGERPRINT_STORAGE_KEY, cookieId);
         return cookieId;
     }
@@ -150,32 +150,32 @@ function getOrCreateFirstTouchData() {
     return created;
 }
 /**
- * 生成基于真实浏览器特征的fingerprint ID
- * 使用 FingerprintJS 收集浏览器特征并生成唯一标识
+ * Generate a fingerprint ID from real browser characteristics.
+ * Uses FingerprintJS to collect browser signals and create a stable identifier.
  */
 function generateFingerprintId() {
     return __awaiter(this, void 0, void 0, function* () {
         if (typeof window === 'undefined') {
             throw new Error('generateFingerprintId can only be used in browser environment');
         }
-        // 检查现有 ID
+        // Check for an existing ID.
         const existingId = checkStoredFingerprintId();
         if (existingId) {
             return existingId;
         }
         try {
-            // 使用 FingerprintJS 生成指纹
+            // Generate a fingerprint with FingerprintJS.
             const fp = yield FingerprintJS.load();
             const result = yield fp.get();
             const fingerprintId = `fp_${result.visitorId}`;
-            // 存储到 localStorage 和 cookie
+            // Store in localStorage and cookies.
             setLocalStorageValue(FINGERPRINT_STORAGE_KEY, fingerprintId);
             setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
             return fingerprintId;
         }
         catch (error) {
             console.warn('Failed to generate fingerprint with FingerprintJS:', error);
-            // 降级方案：生成基于时间戳和随机数的 ID
+            // Fallback: generate an ID from timestamp and randomness.
             const fallbackId = `fp_fallback_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
             setLocalStorageValue(FINGERPRINT_STORAGE_KEY, fallbackId);
             setCookie(FINGERPRINT_COOKIE_NAME, fallbackId, 365);
@@ -184,13 +184,13 @@ function generateFingerprintId() {
     });
 }
 /**
- * 获取当前的fingerprint ID
+ * Get the current fingerprint ID.
  */
 function getFingerprintId() {
     return checkStoredFingerprintId();
 }
 /**
- * 设置fingerprint ID到存储
+ * Store a fingerprint ID.
  */
 function setFingerprintId(fingerprintId) {
     if (typeof window === 'undefined') {
@@ -203,7 +203,7 @@ function setFingerprintId(fingerprintId) {
     setCookie(FINGERPRINT_COOKIE_NAME, fingerprintId, 365);
 }
 /**
- * 清除fingerprint ID
+ * Clear the fingerprint ID.
  */
 function clearFingerprintId() {
     if (typeof window === 'undefined') {
@@ -213,8 +213,8 @@ function clearFingerprintId() {
     deleteCookie(FINGERPRINT_COOKIE_NAME);
 }
 /**
- * 获取或生成fingerprint ID
- * 如果不存在则自动生成新的
+ * Get or generate a fingerprint ID.
+ * Automatically creates one when none exists.
  */
 function getOrGenerateFingerprintId() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -226,7 +226,7 @@ function getOrGenerateFingerprintId() {
     });
 }
 /**
- * 创建包含fingerprint ID的fetch headers
+ * Create fetch headers containing the fingerprint ID.
  */
 function createFingerprintHeaders() {
     return __awaiter(this, void 0, void 0, function* () {
@@ -257,7 +257,7 @@ function createFingerprintFetch() {
         return fetch(url, Object.assign(Object.assign({}, init), { headers }));
     });
 }
-// Cookie 辅助函数 (私有)
+// Private cookie helpers.
 function getCookieValue(name) {
     var _a;
     if (typeof document === 'undefined') {

package/dist/clerk/fingerprint/fingerprint-provider.d.ts

@@ -2,7 +2,7 @@ import React from 'react';
 import type { FingerprintContextType, FingerprintProviderProps } from './types';
 /**
  * Fingerprint Provider Component
- * 为应用提供fingerprint和匿名用户管理功能
+ * Provides fingerprint and anonymous user management for the application.
  */
 export declare function FingerprintProvider({ children, config }: FingerprintProviderProps): import("react/jsx-runtime").JSX.Element;
 /**
@@ -11,7 +11,7 @@ export declare function FingerprintProvider({ children, config }: FingerprintPro
 export declare function useFingerprintContext(): FingerprintContextType;
 /**
  * Safe hook to use fingerprint context - returns null if no provider
- * 安全版本的fingerprint context hook - 如果没有Provider则返回null
+ * Returns null when no provider is available.
  */
 export declare function useFingerprintContextSafe(): FingerprintContextType | null;
 /**
@@ -20,6 +20,6 @@ export declare function useFingerprintContextSafe(): FingerprintContextType | nu
  */
 export declare function withFingerprint<P extends object>(Component: React.ComponentType<P>, config: FingerprintProviderProps['config']): (props: P) => import("react/jsx-runtime").JSX.Element;
 /**
- * 组件：显示用户状态和积分信息（用于调试）
+ * Component for displaying user status and credit information for debugging.
  */
 export declare function FingerprintStatus(): import("react/jsx-runtime").JSX.Element;

package/dist/clerk/fingerprint/fingerprint-provider.js

@@ -23,7 +23,7 @@ function useFingerprintStatusTranslations() {
 }
 /**
  * Fingerprint Provider Component
- * 为应用提供fingerprint和匿名用户管理功能
+ * Provides fingerprint and anonymous user management for the application.
  */
 function FingerprintProvider({ children, config }) {
     const fingerprintData = useFingerprint.useFingerprint(config);
@@ -41,7 +41,7 @@ function useFingerprintContext() {
 }
 /**
  * Safe hook to use fingerprint context - returns null if no provider
- * 安全版本的fingerprint context hook - 如果没有Provider则返回null
+ * Returns null when no provider is available.
  */
 function useFingerprintContextSafe() {
     const context = React.useContext(FingerprintContext);
@@ -57,7 +57,7 @@ function withFingerprint(Component, config) {
     };
 }
 /**
- * 组件：显示用户状态和积分信息（用于调试）
+ * Component for displaying user status and credit information for debugging.
  */
 function FingerprintStatus() {
     const translations = useFingerprintStatusTranslations();
@@ -275,8 +275,8 @@ function FingerprintStatus() {
                                                     { label: translations.labels.priceId, value: jsxRuntime.jsx(ui.CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.priceId) || '' }) },
                                                 ] })] })) : (jsxRuntime.jsxs("div", { className: "space-y-3 rounded-xl border border-slate-200/70 bg-white/85 p-4 shadow-sm dark:border-white/12 dark:bg-slate-900/45", children: [jsxRuntime.jsx(PanelHeader, { icon: jsxRuntime.jsx(icons.DatabaseZapIcon, { className: "size-4" }), title: translations.sections.concurrentBaseInfo, rightInfo: jsxRuntime.jsx(StatusTag, { value: isRunningTest ? translations.status.pending : translations.status.idle, translations: translations }) }), jsxRuntime.jsxs("div", { className: "space-y-2 text-xs text-slate-500 dark:text-slate-300", children: [jsxRuntime.jsxs("div", { className: "flex items-center justify-between gap-3", children: [jsxRuntime.jsx("span", { className: "text-slate-400 dark:text-slate-500", children: translations.labels.realBrowser }), jsxRuntime.jsx(ui.CopyableText, { text: fingerprintId || '' })] }), jsxRuntime.jsxs("div", { className: "space-y-1", children: [jsxRuntime.jsx("span", { className: "text-slate-400 dark:text-slate-500", children: translations.labels.testOverride }), jsxRuntime.jsxs("div", { className: "flex items-center gap-2 py-1", children: [jsxRuntime.jsx("div", { className: "min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100", children: jsxRuntime.jsx(ui.CopyableText, { text: activeDebugFingerprintId || '' }) }), jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: regenerateTestFingerprint, "aria-label": translations.actions.generateNewTestFingerprintAriaLabel, className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsxRuntime.jsx(icons.RefreshCcwIcon, { className: "size-4" }) })] })] })] }), jsxRuntime.jsxs("div", { className: "grid grid-cols-1 gap-2 sm:grid-cols-2", children: [jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: runContextParallelInitTest, className: utils.cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', themedGhostButtonClass), children: translations.actions.frontendPreventionTest }), jsxRuntime.jsx("button", { type: "button", disabled: isRunningTest, onClick: runRawParallelPostTest, className: utils.cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold text-white shadow-sm transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', 'border-transparent', lib.themeButtonGradientClass, lib.themeButtonGradientHoverClass), children: translations.actions.backendIdempotencyTest })] }), jsxRuntime.jsx("div", { className: "rounded-lg border border-dashed border-slate-200 bg-slate-50/80 p-3 dark:border-white/10 dark:bg-slate-950/50", children: jsxRuntime.jsx("pre", { className: "overflow-x-auto whitespace-pre-wrap break-all font-mono text-[11px] leading-5 text-slate-600 dark:text-slate-300", children: testResult || translations.placeholders.noTestExecutedYet }) })] })), error && (jsxRuntime.jsxs("div", { className: "flex items-start justify-between gap-3 rounded-xl border border-amber-200 bg-amber-50 p-3 text-xs text-amber-600 shadow-sm dark:border-amber-500/40 dark:bg-amber-500/10 dark:text-amber-200", children: [jsxRuntime.jsxs("div", { className: "flex items-start gap-2", children: [jsxRuntime.jsx(icons.XIcon, { className: "mt-0.5 size-4 shrink-0" }), jsxRuntime.jsx("span", { children: error })] }), jsxRuntime.jsx("button", { type: "button", "aria-label": translations.actions.dismissErrorAriaLabel, onClick: clearError, className: "shrink-0 rounded-full p-1 text-amber-500 transition hover:bg-amber-100 hover:text-amber-700 dark:text-amber-200 dark:hover:bg-amber-500/10 dark:hover:text-amber-100", children: jsxRuntime.jsx(icons.XIcon, { className: "size-4" }) })] }))] })] })] }))] }));
 }
-/* ==================== 新增辅助组件 ==================== */
-// 标题行：左侧图标+标题，右侧信息（右对齐）
+/* ==================== Helper Components ==================== */
+// Header row with icon and title on the left, right-aligned metadata on the right.
 function PanelHeader({ icon, title, rightInfo }) {
     return (jsxRuntime.jsxs("div", { className: "flex items-center justify-between mb-3", children: [jsxRuntime.jsxs("div", { className: "flex items-center gap-2 text-sm font-semibold text-slate-700 dark:text-slate-100", children: [jsxRuntime.jsx("span", { className: "flex size-6 items-center justify-center rounded-full bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-300", children: icon }), jsxRuntime.jsx("span", { className: utils.cn("rounded-full bg-purple-100 px-2 py-1 text-xs font-bold", lib.themeIconColor), children: title })] }), jsxRuntime.jsx("span", { className: "text-sm font-medium text-slate-600 dark:text-slate-300", children: rightInfo })] }));
 }
@@ -319,17 +319,17 @@ function StatusTag({ value, translations, }) {
         return jsxRuntime.jsx("span", { className: "text-slate-400", children: translations.placeholders.none });
     const normalized = value.toLowerCase();
     const colorMap = {
-        // 绿色：正常/活跃
+        // Green: normal or active.
         registered: 'bg-green-100 text-green-700 dark:bg-green-500/20 dark:text-green-300',
         active: 'bg-green-100 text-green-700 dark:bg-green-500/20 dark:text-green-300',
         trialing: 'bg-green-100 text-green-700 dark:bg-green-500/20 dark:text-green-300',
-        // 灰色：失效/删除
+        // Gray: inactive or deleted.
         canceled: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         frozen: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         deleted: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         expired: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         past_due: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
-        // 橙色：待处理/异常
+        // Amber: pending or exceptional states.
         pending: 'bg-amber-100 text-amber-700 dark:bg-amber-500/20 dark:text-amber-300',
         failed: 'bg-amber-100 text-amber-700 dark:bg-amber-500/20 dark:text-amber-300',
         unpaid: 'bg-amber-100 text-amber-700 dark:bg-amber-500/20 dark:text-amber-300',

package/dist/clerk/fingerprint/fingerprint-provider.mjs

@@ -21,7 +21,7 @@ function useFingerprintStatusTranslations() {
 }
 /**
  * Fingerprint Provider Component
- * 为应用提供fingerprint和匿名用户管理功能
+ * Provides fingerprint and anonymous user management for the application.
  */
 function FingerprintProvider({ children, config }) {
     const fingerprintData = useFingerprint(config);
@@ -39,7 +39,7 @@ function useFingerprintContext() {
 }
 /**
  * Safe hook to use fingerprint context - returns null if no provider
- * 安全版本的fingerprint context hook - 如果没有Provider则返回null
+ * Returns null when no provider is available.
  */
 function useFingerprintContextSafe() {
     const context = useContext(FingerprintContext);
@@ -55,7 +55,7 @@ function withFingerprint(Component, config) {
     };
 }
 /**
- * 组件：显示用户状态和积分信息（用于调试）
+ * Component for displaying user status and credit information for debugging.
  */
 function FingerprintStatus() {
     const translations = useFingerprintStatusTranslations();
@@ -273,8 +273,8 @@ function FingerprintStatus() {
                                                     { label: translations.labels.priceId, value: jsx(CopyableText, { text: (xSubscription === null || xSubscription === void 0 ? void 0 : xSubscription.priceId) || '' }) },
                                                 ] })] })) : (jsxs("div", { className: "space-y-3 rounded-xl border border-slate-200/70 bg-white/85 p-4 shadow-sm dark:border-white/12 dark:bg-slate-900/45", children: [jsx(PanelHeader, { icon: jsx(DatabaseZapIcon, { className: "size-4" }), title: translations.sections.concurrentBaseInfo, rightInfo: jsx(StatusTag, { value: isRunningTest ? translations.status.pending : translations.status.idle, translations: translations }) }), jsxs("div", { className: "space-y-2 text-xs text-slate-500 dark:text-slate-300", children: [jsxs("div", { className: "flex items-center justify-between gap-3", children: [jsx("span", { className: "text-slate-400 dark:text-slate-500", children: translations.labels.realBrowser }), jsx(CopyableText, { text: fingerprintId || '' })] }), jsxs("div", { className: "space-y-1", children: [jsx("span", { className: "text-slate-400 dark:text-slate-500", children: translations.labels.testOverride }), jsxs("div", { className: "flex items-center gap-2 py-1", children: [jsx("div", { className: "min-w-0 flex-1 rounded-lg border border-slate-200 bg-white px-3 py-2 font-mono text-[0.5rem] sm:text-[0.625rem] md:text-xs leading-tight text-slate-700 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100", children: jsx(CopyableText, { text: activeDebugFingerprintId || '' }) }), jsx("button", { type: "button", disabled: isRunningTest, onClick: regenerateTestFingerprint, "aria-label": translations.actions.generateNewTestFingerprintAriaLabel, className: "inline-flex size-9 items-center justify-center rounded-lg border border-slate-200 bg-slate-50 text-slate-700 transition hover:border-slate-300 hover:bg-slate-100 disabled:cursor-not-allowed disabled:opacity-50 dark:border-white/10 dark:bg-slate-950 dark:text-slate-100 dark:hover:bg-slate-900", children: jsx(RefreshCcwIcon, { className: "size-4" }) })] })] })] }), jsxs("div", { className: "grid grid-cols-1 gap-2 sm:grid-cols-2", children: [jsx("button", { type: "button", disabled: isRunningTest, onClick: runContextParallelInitTest, className: cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', themedGhostButtonClass), children: translations.actions.frontendPreventionTest }), jsx("button", { type: "button", disabled: isRunningTest, onClick: runRawParallelPostTest, className: cn('shrink-0 rounded-full border px-3 py-2 text-xs font-semibold text-white shadow-sm transition-all duration-200 disabled:cursor-not-allowed disabled:opacity-50', 'border-transparent', themeButtonGradientClass, themeButtonGradientHoverClass), children: translations.actions.backendIdempotencyTest })] }), jsx("div", { className: "rounded-lg border border-dashed border-slate-200 bg-slate-50/80 p-3 dark:border-white/10 dark:bg-slate-950/50", children: jsx("pre", { className: "overflow-x-auto whitespace-pre-wrap break-all font-mono text-[11px] leading-5 text-slate-600 dark:text-slate-300", children: testResult || translations.placeholders.noTestExecutedYet }) })] })), error && (jsxs("div", { className: "flex items-start justify-between gap-3 rounded-xl border border-amber-200 bg-amber-50 p-3 text-xs text-amber-600 shadow-sm dark:border-amber-500/40 dark:bg-amber-500/10 dark:text-amber-200", children: [jsxs("div", { className: "flex items-start gap-2", children: [jsx(XIcon, { className: "mt-0.5 size-4 shrink-0" }), jsx("span", { children: error })] }), jsx("button", { type: "button", "aria-label": translations.actions.dismissErrorAriaLabel, onClick: clearError, className: "shrink-0 rounded-full p-1 text-amber-500 transition hover:bg-amber-100 hover:text-amber-700 dark:text-amber-200 dark:hover:bg-amber-500/10 dark:hover:text-amber-100", children: jsx(XIcon, { className: "size-4" }) })] }))] })] })] }))] }));
 }
-/* ==================== 新增辅助组件 ==================== */
-// 标题行：左侧图标+标题，右侧信息（右对齐）
+/* ==================== Helper Components ==================== */
+// Header row with icon and title on the left, right-aligned metadata on the right.
 function PanelHeader({ icon, title, rightInfo }) {
     return (jsxs("div", { className: "flex items-center justify-between mb-3", children: [jsxs("div", { className: "flex items-center gap-2 text-sm font-semibold text-slate-700 dark:text-slate-100", children: [jsx("span", { className: "flex size-6 items-center justify-center rounded-full bg-slate-100 text-slate-600 dark:bg-slate-800 dark:text-slate-300", children: icon }), jsx("span", { className: cn("rounded-full bg-purple-100 px-2 py-1 text-xs font-bold", themeIconColor), children: title })] }), jsx("span", { className: "text-sm font-medium text-slate-600 dark:text-slate-300", children: rightInfo })] }));
 }
@@ -317,17 +317,17 @@ function StatusTag({ value, translations, }) {
         return jsx("span", { className: "text-slate-400", children: translations.placeholders.none });
     const normalized = value.toLowerCase();
     const colorMap = {
-        // 绿色：正常/活跃
+        // Green: normal or active.
         registered: 'bg-green-100 text-green-700 dark:bg-green-500/20 dark:text-green-300',
         active: 'bg-green-100 text-green-700 dark:bg-green-500/20 dark:text-green-300',
         trialing: 'bg-green-100 text-green-700 dark:bg-green-500/20 dark:text-green-300',
-        // 灰色：失效/删除
+        // Gray: inactive or deleted.
         canceled: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         frozen: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         deleted: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         expired: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
         past_due: 'bg-slate-100 text-slate-600 dark:bg-slate-700 dark:text-slate-400',
-        // 橙色：待处理/异常
+        // Amber: pending or exceptional states.
         pending: 'bg-amber-100 text-amber-700 dark:bg-amber-500/20 dark:text-amber-300',
         failed: 'bg-amber-100 text-amber-700 dark:bg-amber-500/20 dark:text-amber-300',
         unpaid: 'bg-amber-100 text-amber-700 dark:bg-amber-500/20 dark:text-amber-300',

package/dist/clerk/fingerprint/fingerprint-server.d.ts

@@ -1,23 +1,23 @@
 /**
  * Fingerprint Server Utilities
- * 服务端专用的指纹ID提取和验证逻辑
- * 可以安全地在服务端使用，不依赖浏览器API或FingerprintJS
+ * Server-only fingerprint ID extraction and validation logic.
+ * Safe for server usage without browser APIs or FingerprintJS.
  */
 /**
- * 从请求中提取fingerprint ID
- * 优先级：header > cookie > query参数
- * 可以安全地在服务端使用
+ * Extract fingerprint ID from a request.
+ * Priority: header > cookie > query parameter.
+ * Safe to use on the server.
  */
 export declare function extractFingerprintId(headers: Headers | Record<string, string>, cookies?: Record<string, string>, query?: Record<string, string | undefined>): string | null;
 /**
- * 生成服务端降级fingerprint ID
- * 当客户端无法生成fingerprint时使用
- * 可以安全地在服务端使用
+ * Generate a server-side fallback fingerprint ID.
+ * Used when the client cannot generate a fingerprint.
+ * Safe to use on the server.
  */
 export declare function generateServerFingerprintId(): string;
 /**
- * 从Next.js Request对象中提取fingerprint ID
- * 便捷方法，适用于Next.js API路由
+ * Extract fingerprint ID from a Next.js Request object.
+ * Convenience helper for Next.js API routes.
  */
 export declare function extractFingerprintFromNextRequest(request: Request): string | null;
 type NextHeadersLike = Pick<Headers, 'forEach'>;
@@ -28,8 +28,8 @@ type NextCookiesLike = {
     }>;
 };
 /**
- * 从Next.js runtime提供的headers/cookies实例里提取fingerprint ID
- * 供App Router服务端组件和Server Actions直接复用
+ * Extract fingerprint ID from Next.js runtime headers/cookies stores.
+ * Reusable in App Router server components and Server Actions.
  */
 export declare function extractFingerprintFromNextStores(params: {
     headers: NextHeadersLike;

package/dist/clerk/fingerprint/fingerprint-server.js

@@ -4,30 +4,30 @@ var fingerprintShared = require('./fingerprint-shared.js');
 
 /**
  * Fingerprint Server Utilities
- * 服务端专用的指纹ID提取和验证逻辑
- * 可以安全地在服务端使用，不依赖浏览器API或FingerprintJS
+ * Server-only fingerprint ID extraction and validation logic.
+ * Safe for server usage without browser APIs or FingerprintJS.
  */
 /**
- * 从请求中提取fingerprint ID
- * 优先级：header > cookie > query参数
- * 可以安全地在服务端使用
+ * Extract fingerprint ID from a request.
+ * Priority: header > cookie > query parameter.
+ * Safe to use on the server.
  */
 function extractFingerprintId(headers, cookies, query) {
-    // 1. 从header中获取
+    // 1. Read from header.
     const headerValue = headers instanceof Headers
         ? headers.get(fingerprintShared.FINGERPRINT_HEADER_NAME)
         : headers[fingerprintShared.FINGERPRINT_HEADER_NAME];
     if (headerValue && fingerprintShared.isValidFingerprintId(headerValue)) {
         return headerValue;
     }
-    // 2. 从cookie中获取
+    // 2. Read from cookie.
     if (cookies) {
         const cookieValue = cookies[fingerprintShared.FINGERPRINT_COOKIE_NAME];
         if (cookieValue && fingerprintShared.isValidFingerprintId(cookieValue)) {
             return cookieValue;
         }
     }
-    // 3. 从query参数中获取
+    // 3. Read from query parameters.
     if (query) {
         const queryValue = query.fingerprint_id || query.fp_id;
         if (queryValue && fingerprintShared.isValidFingerprintId(queryValue)) {
@@ -37,20 +37,20 @@ function extractFingerprintId(headers, cookies, query) {
     return null;
 }
 /**
- * 生成服务端降级fingerprint ID
- * 当客户端无法生成fingerprint时使用
- * 可以安全地在服务端使用
+ * Generate a server-side fallback fingerprint ID.
+ * Used when the client cannot generate a fingerprint.
+ * Safe to use on the server.
  */
 function generateServerFingerprintId() {
     return `fp_server_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
 }
 /**
- * 从Next.js Request对象中提取fingerprint ID
- * 便捷方法，适用于Next.js API路由
+ * Extract fingerprint ID from a Next.js Request object.
+ * Convenience helper for Next.js API routes.
  */
 function extractFingerprintFromNextRequest(request) {
     const headers = request.headers;
-    // 尝试从cookies获取（需要解析cookie header）
+    // Try cookies by parsing the cookie header.
     const cookieHeader = headers.get('cookie');
     const cookies = {};
     if (cookieHeader) {
@@ -61,7 +61,7 @@ function extractFingerprintFromNextRequest(request) {
             }
         });
     }
-    // 尝试从URL query参数获取
+    // Try URL query parameters.
     const url = new URL(request.url);
     const query = {};
     url.searchParams.forEach((value, key) => {
@@ -70,8 +70,8 @@ function extractFingerprintFromNextRequest(request) {
     return extractFingerprintId(headers, cookies, query);
 }
 /**
- * 从Next.js runtime提供的headers/cookies实例里提取fingerprint ID
- * 供App Router服务端组件和Server Actions直接复用
+ * Extract fingerprint ID from Next.js runtime headers/cookies stores.
+ * Reusable in App Router server components and Server Actions.
  */
 function extractFingerprintFromNextStores(params) {
     const cookieMap = params.cookies