@windrun-huaiin/third-ui 30.0.0 → 31.0.0

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

@@ -2,30 +2,30 @@ import { FINGERPRINT_HEADER_NAME, isValidFingerprintId, FINGERPRINT_COOKIE_NAME
 
 /**
  * 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(FINGERPRINT_HEADER_NAME)
         : headers[FINGERPRINT_HEADER_NAME];
     if (headerValue && isValidFingerprintId(headerValue)) {
         return headerValue;
     }
-    // 2. 从cookie中获取
+    // 2. Read from cookie.
     if (cookies) {
         const cookieValue = cookies[FINGERPRINT_COOKIE_NAME];
         if (cookieValue && isValidFingerprintId(cookieValue)) {
             return cookieValue;
         }
     }
-    // 3. 从query参数中获取
+    // 3. Read from query parameters.
     if (query) {
         const queryValue = query.fingerprint_id || query.fp_id;
         if (queryValue && isValidFingerprintId(queryValue)) {
@@ -35,20 +35,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) {
@@ -59,7 +59,7 @@ function extractFingerprintFromNextRequest(request) {
             }
         });
     }
-    // 尝试从URL query参数获取
+    // Try URL query parameters.
     const url = new URL(request.url);
     const query = {};
     url.searchParams.forEach((value, key) => {
@@ -68,8 +68,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

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

@@ -1,6 +1,6 @@
 /**
  * Fingerprint Shared Utilities
- * 客户端和服务端共享的常量、类型和验证逻辑
+ * Shared constants, types, and validation logic for client and server.
  */
 export declare const FINGERPRINT_STORAGE_KEY = "__x_fingerprint_id";
 export declare const FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = "__x_fingerprint_debug_override";
@@ -12,8 +12,8 @@ export declare const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = "__x_first_touch";
 export declare const FINGERPRINT_FIRST_TOUCH_HEADER = "x-first-touch";
 export declare const FINGERPRINT_DEBUG_PREFIX = "fp_test_dbg_";
 /**
- * 验证fingerprint ID格式
- * 可以在客户端和服务端使用
+ * Validate fingerprint ID format.
+ * Safe to use on both client and server.
  */
 export declare function isValidFingerprintId(fingerprintId: string): boolean;
 export declare function isDebugFingerprintId(fingerprintId: string | null | undefined): boolean;

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

@@ -2,9 +2,9 @@
 
 /**
  * Fingerprint Shared Utilities
- * 客户端和服务端共享的常量、类型和验证逻辑
+ * Shared constants, types, and validation logic for client and server.
  */
-// Fingerprint ID的存储键和header名
+// Storage keys and header names for fingerprint IDs.
 const FINGERPRINT_STORAGE_KEY = '__x_fingerprint_id';
 const FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = '__x_fingerprint_debug_override';
 const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id-v8';
@@ -15,17 +15,17 @@ const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
 const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 /**
- * 验证fingerprint ID格式
- * 可以在客户端和服务端使用
+ * Validate fingerprint ID format.
+ * Safe to use on both client and server.
  */
 function isValidFingerprintId(fingerprintId) {
     if (!fingerprintId)
         return false;
-    // 支持多种格式：
-    // - fp_ + FingerprintJS visitorId (变长字符串)
-    // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
-    // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-    // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+    // Supported formats:
+    // - fp_ + FingerprintJS visitorId with variable length.
+    // - fp_fallback_ + timestamp + random string for client fallback.
+    // - fp_server_ + timestamp + random string for server fallback.
+    // - fp_test_dbg_ + timestamp + random string for debug concurrency tests.
     return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
 }
 function isDebugFingerprintId(fingerprintId) {
@@ -34,7 +34,7 @@ function isDebugFingerprintId(fingerprintId) {
     }
     return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
-// 常量导出
+// Exported constants.
 const FINGERPRINT_CONSTANTS = {
     STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
     DEBUG_OVERRIDE_STORAGE_KEY: FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,

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

@@ -1,8 +1,8 @@
 /**
  * Fingerprint Shared Utilities
- * 客户端和服务端共享的常量、类型和验证逻辑
+ * Shared constants, types, and validation logic for client and server.
  */
-// Fingerprint ID的存储键和header名
+// Storage keys and header names for fingerprint IDs.
 const FINGERPRINT_STORAGE_KEY = '__x_fingerprint_id';
 const FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY = '__x_fingerprint_debug_override';
 const FINGERPRINT_HEADER_NAME = 'x-fingerprint-id-v8';
@@ -13,17 +13,17 @@ const FINGERPRINT_FIRST_TOUCH_COOKIE_NAME = '__x_first_touch';
 const FINGERPRINT_FIRST_TOUCH_HEADER = 'x-first-touch';
 const FINGERPRINT_DEBUG_PREFIX = 'fp_test_dbg_';
 /**
- * 验证fingerprint ID格式
- * 可以在客户端和服务端使用
+ * Validate fingerprint ID format.
+ * Safe to use on both client and server.
  */
 function isValidFingerprintId(fingerprintId) {
     if (!fingerprintId)
         return false;
-    // 支持多种格式：
-    // - fp_ + FingerprintJS visitorId (变长字符串)
-    // - fp_fallback_ + 时间戳_随机字符串 (客户端降级方案)
-    // - fp_server_ + 时间戳_随机字符串 (服务端降级)
-    // - fp_test_dbg_ + 时间戳_随机字符串 (调试并发测试)
+    // Supported formats:
+    // - fp_ + FingerprintJS visitorId with variable length.
+    // - fp_fallback_ + timestamp + random string for client fallback.
+    // - fp_server_ + timestamp + random string for server fallback.
+    // - fp_test_dbg_ + timestamp + random string for debug concurrency tests.
     return /^fp(_fallback|_server|_test_dbg)?_[a-zA-Z0-9_]+$/.test(fingerprintId);
 }
 function isDebugFingerprintId(fingerprintId) {
@@ -32,7 +32,7 @@ function isDebugFingerprintId(fingerprintId) {
     }
     return fingerprintId.startsWith(FINGERPRINT_DEBUG_PREFIX);
 }
-// 常量导出
+// Exported constants.
 const FINGERPRINT_CONSTANTS = {
     STORAGE_KEY: FINGERPRINT_STORAGE_KEY,
     DEBUG_OVERRIDE_STORAGE_KEY: FINGERPRINT_DEBUG_OVERRIDE_STORAGE_KEY,

package/dist/clerk/fingerprint/types.d.ts

@@ -1,6 +1,5 @@
 /**
  * Fingerprint System Types
- * 指纹识别系统的类型定义
  */
 export interface XUser {
     userId: string;

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

@@ -11,7 +11,7 @@ var fingerprintShared = require('./fingerprint-shared.js');
  * Accepts configuration to customize API endpoint and behavior
  */
 function useFingerprint(config) {
-    // 服务端渲染检查
+    // Server-side rendering guard.
     if (typeof window === 'undefined') {
         return {
             fingerprintId: null,
@@ -39,7 +39,7 @@ function useFingerprint(config) {
         setError(null);
     }, []);
     /**
-     * 第一阶段：初始化fingerprint ID
+     * Phase 1: initialize fingerprint ID.
      */
     const initializeFingerprintId = React.useCallback(() => tslib.__awaiter(this, void 0, void 0, function* () {
         try {
@@ -56,7 +56,7 @@ function useFingerprint(config) {
         }
     }), []);
     /**
-     * 第二阶段：初始化匿名用户
+     * Phase 2: initialize anonymous user.
      */
     const initializeAnonymousUser = React.useCallback(() => tslib.__awaiter(this, void 0, void 0, function* () {
         var _a;
@@ -117,7 +117,7 @@ function useFingerprint(config) {
         }
     }), [fingerprintId, config.apiEndpoint, isInitialized]);
     /**
-     * 刷新用户数据 - 使用POST请求（后端支持upsert逻辑）
+     * Refresh user data with a POST request; the backend supports upsert semantics.
      */
     const refreshUserData = React.useCallback(() => tslib.__awaiter(this, void 0, void 0, function* () {
         if (!fingerprintId) {
@@ -150,7 +150,7 @@ function useFingerprint(config) {
             setError(err instanceof Error ? err.message : 'Unknown error');
         }
     }), [fingerprintId, config.apiEndpoint]);
-    // 第一阶段：页面加载完成后生成指纹ID
+    // Phase 1: generate fingerprint ID after page load.
     React.useEffect(() => {
         const initFingerprint = () => tslib.__awaiter(this, void 0, void 0, function* () {
             setIsLoading(true);
@@ -159,11 +159,11 @@ function useFingerprint(config) {
         });
         initFingerprint();
     }, [initializeFingerprintId]);
-    // 第二阶段：有指纹ID后直接初始化用户（后端支持upsert逻辑）
+    // Phase 2: initialize the user once a fingerprint ID is available; the backend supports upsert semantics.
     React.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]);
     return {

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

@@ -9,7 +9,7 @@ import { FINGERPRINT_SOURCE_REFER, isValidFingerprintId, isDebugFingerprintId }
  * Accepts configuration to customize API endpoint and behavior
  */
 function useFingerprint(config) {
-    // 服务端渲染检查
+    // Server-side rendering guard.
     if (typeof window === 'undefined') {
         return {
             fingerprintId: null,
@@ -37,7 +37,7 @@ function useFingerprint(config) {
         setError(null);
     }, []);
     /**
-     * 第一阶段：初始化fingerprint ID
+     * Phase 1: initialize fingerprint ID.
      */
     const initializeFingerprintId = useCallback(() => __awaiter(this, void 0, void 0, function* () {
         try {
@@ -54,7 +54,7 @@ function useFingerprint(config) {
         }
     }), []);
     /**
-     * 第二阶段：初始化匿名用户
+     * Phase 2: initialize anonymous user.
      */
     const initializeAnonymousUser = useCallback(() => __awaiter(this, void 0, void 0, function* () {
         var _a;
@@ -115,7 +115,7 @@ function useFingerprint(config) {
         }
     }), [fingerprintId, config.apiEndpoint, isInitialized]);
     /**
-     * 刷新用户数据 - 使用POST请求（后端支持upsert逻辑）
+     * Refresh user data with a POST request; the backend supports upsert semantics.
      */
     const refreshUserData = useCallback(() => __awaiter(this, void 0, void 0, function* () {
         if (!fingerprintId) {
@@ -148,7 +148,7 @@ function useFingerprint(config) {
             setError(err instanceof Error ? err.message : 'Unknown error');
         }
     }), [fingerprintId, config.apiEndpoint]);
-    // 第一阶段：页面加载完成后生成指纹ID
+    // Phase 1: generate fingerprint ID after page load.
     useEffect(() => {
         const initFingerprint = () => __awaiter(this, void 0, void 0, function* () {
             setIsLoading(true);
@@ -157,11 +157,11 @@ function useFingerprint(config) {
         });
         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]);
     return {

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

@@ -1,6 +1,6 @@
 /**
  * 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 declare function SignInWithFingerprint(): import("react/jsx-runtime").JSX.Element;

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

@@ -5,29 +5,30 @@ var tslib = require('tslib');
 var jsxRuntime = require('react/jsx-runtime');
 var nextjs = require('@clerk/nextjs');
 var React = require('react');
+var clerkAuthAppearance = require('./clerk-auth-appearance.js');
 var fingerprintProvider = require('./fingerprint/fingerprint-provider.js');
 
 /**
  * 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.
  */
 function SignInWithFingerprint() {
     const fingerprintContext = fingerprintProvider.useFingerprintContextSafe();
-    // 如果没有fingerprint context，使用默认值
+    // Use defaults when fingerprint context is unavailable.
     const { fingerprintId = null, xUser = null, isInitialized = false, initializeAnonymousUser = () => tslib.__awaiter(this, void 0, void 0, function* () { }) } = fingerprintContext || {};
-    // 准备传递给Clerk的metadata，包含匿名用户信息
+    // Prepare Clerk metadata with anonymous user information.
     const unsafeMetadata = {
         user_id: (xUser === null || xUser === void 0 ? void 0 : xUser.userId) || null,
         fingerprint_id: fingerprintId || null,
     };
-    // 确保匿名用户已初始化
+    // Ensure the anonymous user has been initialized.
     React.useEffect(() => {
         if (!isInitialized && fingerprintId) {
             initializeAnonymousUser();
         }
     }, [fingerprintId, isInitialized, initializeAnonymousUser]);
-    return jsxRuntime.jsx(nextjs.SignIn, { unsafeMetadata: unsafeMetadata });
+    return jsxRuntime.jsx(nextjs.SignIn, { appearance: clerkAuthAppearance.clerkAuthPageAppearance, unsafeMetadata: unsafeMetadata });
 }
 
 exports.SignInWithFingerprint = SignInWithFingerprint;

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

@@ -3,29 +3,30 @@ import { __awaiter } from 'tslib';
 import { jsx } from 'react/jsx-runtime';
 import { SignIn } from '@clerk/nextjs';
 import { useEffect } from 'react';
+import { clerkAuthPageAppearance } from './clerk-auth-appearance.mjs';
 import { useFingerprintContextSafe } from './fingerprint/fingerprint-provider.mjs';
 
 /**
  * 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.
  */
 function SignInWithFingerprint() {
     const fingerprintContext = useFingerprintContextSafe();
-    // 如果没有fingerprint context，使用默认值
+    // Use defaults when fingerprint context is unavailable.
     const { fingerprintId = null, xUser = null, isInitialized = false, initializeAnonymousUser = () => __awaiter(this, void 0, void 0, function* () { }) } = fingerprintContext || {};
-    // 准备传递给Clerk的metadata，包含匿名用户信息
+    // Prepare Clerk metadata with anonymous user information.
     const unsafeMetadata = {
         user_id: (xUser === null || xUser === void 0 ? void 0 : xUser.userId) || null,
         fingerprint_id: fingerprintId || null,
     };
-    // 确保匿名用户已初始化
+    // Ensure the anonymous user has been initialized.
     useEffect(() => {
         if (!isInitialized && fingerprintId) {
             initializeAnonymousUser();
         }
     }, [fingerprintId, isInitialized, initializeAnonymousUser]);
-    return jsx(SignIn, { unsafeMetadata: unsafeMetadata });
+    return jsx(SignIn, { appearance: clerkAuthPageAppearance, unsafeMetadata: unsafeMetadata });
 }
 
 export { SignInWithFingerprint };

package/dist/clerk/signup-button-with-fingerprint-client.js

@@ -5,24 +5,25 @@ var tslib = require('tslib');
 var jsxRuntime = require('react/jsx-runtime');
 var nextjs = require('@clerk/nextjs');
 var React = require('react');
+var clerkAuthAppearance = require('./clerk-auth-appearance.js');
 var fingerprintProvider = require('./fingerprint/fingerprint-provider.js');
 
 function SignUpButtonWithFingerprint({ mode, signUp, }) {
     if (mode === 'redirect') {
         return (
-        // 重定向模式则直接跳转到自定义注册页面
+        // Redirect mode navigates directly to the custom sign-up page.
         jsxRuntime.jsx(nextjs.SignUpButton, { children: jsxRuntime.jsx("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", children: signUp }) }));
     }
-    // 弹框模式则需要自定义注册按钮
+    // Modal mode requires a custom sign-up button.
     const fingerprintContext = fingerprintProvider.useFingerprintContextSafe();
-    // 如果没有fingerprint context，使用默认值
+    // Use defaults when fingerprint context is unavailable.
     const { fingerprintId = null, xUser = null, isInitialized = false, initializeAnonymousUser = () => tslib.__awaiter(this, void 0, void 0, function* () { }) } = fingerprintContext || {};
     const userId = (xUser === null || xUser === void 0 ? void 0 : xUser.userId) || null;
     const unsafeMetadata = {
         user_id: userId,
         fingerprint_id: fingerprintId || null,
     };
-    // 确保匿名用户已初始化
+    // Ensure the anonymous user has been initialized.
     React.useEffect(() => {
         if (!isInitialized && fingerprintId) {
             initializeAnonymousUser();
@@ -31,6 +32,7 @@ function SignUpButtonWithFingerprint({ mode, signUp, }) {
     const { openSignUp } = nextjs.useClerk();
     const handleClick = () => {
         openSignUp({
+            appearance: clerkAuthAppearance.clerkAuthModalAppearance,
             unsafeMetadata,
         });
     };

package/dist/clerk/signup-button-with-fingerprint-client.mjs

@@ -3,24 +3,25 @@ import { __awaiter } from 'tslib';
 import { jsx } from 'react/jsx-runtime';
 import { SignUpButton, useClerk } from '@clerk/nextjs';
 import { useEffect } from 'react';
+import { clerkAuthModalAppearance } from './clerk-auth-appearance.mjs';
 import { useFingerprintContextSafe } from './fingerprint/fingerprint-provider.mjs';
 
 function SignUpButtonWithFingerprint({ mode, signUp, }) {
     if (mode === 'redirect') {
         return (
-        // 重定向模式则直接跳转到自定义注册页面
+        // Redirect mode navigates directly to the custom sign-up page.
         jsx(SignUpButton, { children: jsx("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", children: signUp }) }));
     }
-    // 弹框模式则需要自定义注册按钮
+    // 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, isInitialized = false, initializeAnonymousUser = () => __awaiter(this, void 0, void 0, function* () { }) } = fingerprintContext || {};
     const userId = (xUser === null || xUser === void 0 ? void 0 : xUser.userId) || null;
     const unsafeMetadata = {
         user_id: userId,
         fingerprint_id: fingerprintId || null,
     };
-    // 确保匿名用户已初始化
+    // Ensure the anonymous user has been initialized.
     useEffect(() => {
         if (!isInitialized && fingerprintId) {
             initializeAnonymousUser();
@@ -29,6 +30,7 @@ function SignUpButtonWithFingerprint({ mode, signUp, }) {
     const { openSignUp } = useClerk();
     const handleClick = () => {
         openSignUp({
+            appearance: clerkAuthModalAppearance,
             unsafeMetadata,
         });
     };

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

@@ -1,6 +1,6 @@
 /**
  * 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 declare function SignUpWithFingerprint(): import("react/jsx-runtime").JSX.Element;

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

@@ -5,29 +5,30 @@ var tslib = require('tslib');
 var jsxRuntime = require('react/jsx-runtime');
 var nextjs = require('@clerk/nextjs');
 var React = require('react');
+var clerkAuthAppearance = require('./clerk-auth-appearance.js');
 var fingerprintProvider = require('./fingerprint/fingerprint-provider.js');
 
 /**
  * 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.
  */
 function SignUpWithFingerprint() {
     const fingerprintContext = fingerprintProvider.useFingerprintContextSafe();
-    // 如果没有fingerprint context，使用默认值
+    // Use defaults when fingerprint context is unavailable.
     const { fingerprintId = null, xUser = null, isInitialized = false, initializeAnonymousUser = () => tslib.__awaiter(this, void 0, void 0, function* () { }) } = fingerprintContext || {};
-    // 准备传递给Clerk的metadata，包含匿名用户信息
+    // Prepare Clerk metadata with anonymous user information.
     const unsafeMetadata = {
         user_id: (xUser === null || xUser === void 0 ? void 0 : xUser.userId) || null,
         fingerprint_id: fingerprintId || null,
     };
-    // 确保匿名用户已初始化
+    // Ensure the anonymous user has been initialized.
     React.useEffect(() => {
         if (!isInitialized && fingerprintId) {
             initializeAnonymousUser();
         }
     }, [fingerprintId, isInitialized, initializeAnonymousUser]);
-    return jsxRuntime.jsx(nextjs.SignUp, { unsafeMetadata: unsafeMetadata });
+    return jsxRuntime.jsx(nextjs.SignUp, { appearance: clerkAuthAppearance.clerkAuthPageAppearance, unsafeMetadata: unsafeMetadata });
 }
 
 exports.SignUpWithFingerprint = SignUpWithFingerprint;

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

@@ -3,29 +3,30 @@ import { __awaiter } from 'tslib';
 import { jsx } from 'react/jsx-runtime';
 import { SignUp } from '@clerk/nextjs';
 import { useEffect } from 'react';
+import { clerkAuthPageAppearance } from './clerk-auth-appearance.mjs';
 import { useFingerprintContextSafe } from './fingerprint/fingerprint-provider.mjs';
 
 /**
  * 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.
  */
 function SignUpWithFingerprint() {
     const fingerprintContext = useFingerprintContextSafe();
-    // 如果没有fingerprint context，使用默认值
+    // Use defaults when fingerprint context is unavailable.
     const { fingerprintId = null, xUser = null, isInitialized = false, initializeAnonymousUser = () => __awaiter(this, void 0, void 0, function* () { }) } = fingerprintContext || {};
-    // 准备传递给Clerk的metadata，包含匿名用户信息
+    // Prepare Clerk metadata with anonymous user information.
     const unsafeMetadata = {
         user_id: (xUser === null || xUser === void 0 ? void 0 : xUser.userId) || null,
         fingerprint_id: fingerprintId || null,
     };
-    // 确保匿名用户已初始化
+    // Ensure the anonymous user has been initialized.
     useEffect(() => {
         if (!isInitialized && fingerprintId) {
             initializeAnonymousUser();
         }
     }, [fingerprintId, isInitialized, initializeAnonymousUser]);
-    return jsx(SignUp, { unsafeMetadata: unsafeMetadata });
+    return jsx(SignUp, { appearance: clerkAuthPageAppearance, unsafeMetadata: unsafeMetadata });
 }
 
 export { SignUpWithFingerprint };

package/dist/fuma/fuma-page-genarator.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode, ReactElement } from 'react';
+import { ReactElement } from 'react';
 import type { LLMCopyButtonProps, LLMCopyButton } from './mdx/toc-base';
 export type FumaPageTocRenderMode = 'portable-clerk' | 'fumadocs-clerk' | 'fumadocs-normal';
 interface FumaPageParams {
@@ -8,10 +8,6 @@ interface FumaPageParams {
     mdxSourceDir: string;
     githubBaseUrl?: string;
     copyButtonComponent?: ReactElement<LLMCopyButtonProps, typeof LLMCopyButton>;
-    siteIcon: ReactNode;
-    FallbackPage: React.ComponentType<{
-        siteIcon: ReactNode;
-    }>;
     supportedLocales?: string[];
     showBreadcrumb?: boolean;
     showTableOfContent?: boolean;
@@ -20,7 +16,7 @@ interface FumaPageParams {
     localePrefixAsNeeded?: boolean;
     defaultLocale?: string;
 }
-export declare function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales, showBreadcrumb, showTableOfContent, tocRenderMode, showTableOfContentPopover, localePrefixAsNeeded, defaultLocale, }: FumaPageParams): {
+export declare function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, supportedLocales, showBreadcrumb, showTableOfContent, tocRenderMode, showTableOfContentPopover, localePrefixAsNeeded, defaultLocale, }: FumaPageParams): {
     Page: ({ params }: {
         params: Promise<{
             locale: string;

package/dist/fuma/fuma-page-genarator.js

@@ -6,10 +6,11 @@ var page = require('fumadocs-ui/page');
 var React = require('react');
 var tocFooterWrapper = require('./mdx/toc-footer-wrapper.js');
 var utils = require('@windrun-huaiin/lib/utils');
+var navigation = require('next/navigation');
 var tocClerkPortable = require('./mdx/toc-clerk-portable.js');
 var lib = require('@windrun-huaiin/base-ui/lib');
 
-function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, siteIcon, FallbackPage, supportedLocales = ['en'], showBreadcrumb = true, showTableOfContent = true, tocRenderMode = 'portable-clerk', showTableOfContentPopover = false, localePrefixAsNeeded = true, defaultLocale = 'en', }) {
+function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSourceDir, githubBaseUrl, copyButtonComponent, supportedLocales = ['en'], showBreadcrumb = true, showTableOfContent = true, tocRenderMode = 'portable-clerk', showTableOfContentPopover = false, localePrefixAsNeeded = true, defaultLocale = 'en', }) {
     var _a;
     const isLocalMdDebugEnabled = ((_a = process.env.LOCAL_MD_DEBUG) === null || _a === void 0 ? void 0 : _a.toLowerCase()) === 'true';
     const now = () => (typeof performance !== 'undefined' ? performance.now() : Date.now());
@@ -49,7 +50,7 @@ function createFumaPage({ sourceKey, mdxContentSource, getMDXComponents, mdxSour
                 totalElapsedMs: durationMs(pageStartedAt),
             });
             if (!page$1) {
-                return (jsxRuntime.jsx(page.DocsPage, { full: true, breadcrumb: { enabled: false }, footer: { enabled: false }, tableOfContent: { enabled: false }, tableOfContentPopover: { enabled: false }, className: "max-w-none px-0 py-0", children: jsxRuntime.jsx(FallbackPage, { siteIcon: siteIcon }) }));
+                navigation.notFound();
             }
             const path = githubBaseUrl ? `${mdxSourceDir}/${page$1.path}` : undefined;
             const tocFooterElement = (jsxRuntime.jsx(tocFooterWrapper.TocFooterWrapper, { lastModified: page$1.data.date, copyButtonComponent: copyButtonComponent