@howone/sdk 0.1.18 → 0.1.20

package/dist/index.d.mts

@@ -1,14 +1,15 @@
-import React, { Component, ReactNode } from 'react';
+import React$1, { Component, ReactNode } from 'react';
 import * as axios from 'axios';
 import { AxiosResponse, InternalAxiosRequestConfig, AxiosRequestConfig, AxiosInstance } from 'axios';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ToastOptions } from 'react-toastify';
 
 interface FloatingButtonProps {
     text?: string;
     onClick?: () => void;
     className?: string;
 }
-declare const FloatingButton: React.FC<FloatingButtonProps>;
+declare const FloatingButton: React$1.FC<FloatingButtonProps>;
 
 /**
  * 统一认证服务
@@ -420,21 +421,50 @@ interface LoginFormProps {
     appName?: string;
     className?: string;
 }
-declare const LoginForm: React.FC<LoginFormProps>;
+declare const LoginForm: React$1.FC<LoginFormProps>;
 
+type Theme$1 = "dark" | "light" | "system";
 type AuthContextValue = {
     user: ReturnType<typeof parseUserFromToken> | null;
     token: string | null;
     isAuthenticated: boolean;
     logout: () => void;
 };
-declare const AuthProvider: React.FC<{
-    children: React.ReactNode;
+interface HowoneProviderProps {
+    children: React$1.ReactNode;
     autoRedirect?: boolean;
     showFloatingButton?: boolean;
     projectId?: string;
-}>;
+    /** 主题相关配置 */
+    defaultTheme?: Theme$1;
+    themeStorageKey?: string;
+    /** 如果为 true，将忽略 localStorage 中的值，始终使用 defaultTheme */
+    forceDefaultTheme?: boolean;
+}
+/**
+ * HowoneProvider - All-in-one application provider
+ *
+ * Includes:
+ * - Authentication management
+ * - Theme management (dark/light/system)
+ * - Toast notifications
+ * - Floating button
+ *
+ * @example
+ * ```tsx
+ * <HowoneProvider
+ *   defaultTheme="dark"
+ *   themeStorageKey="my-app-theme"
+ *   showFloatingButton={true}
+ * >
+ *   <App />
+ * </HowoneProvider>
+ * ```
+ */
+declare const HowoneProvider: React$1.FC<HowoneProviderProps>;
 declare function useAuthContext(): AuthContextValue;
+declare const AuthProvider: React$1.FC<HowoneProviderProps>;
+type AuthProviderProps = HowoneProviderProps;
 
 type AuthState = {
     user: Record<string, unknown> | null;
@@ -465,50 +495,82 @@ interface LoadingProps {
     className?: string;
     fullScreen?: boolean;
 }
-declare const Loading: React.FC<LoadingProps>;
+declare const Loading: React$1.FC<LoadingProps>;
 interface LoadingSpinnerProps {
     size?: 'sm' | 'md' | 'lg';
     className?: string;
 }
-declare const LoadingSpinner: React.FC<LoadingSpinnerProps>;
+declare const LoadingSpinner: React$1.FC<LoadingSpinnerProps>;
 
 interface ErrorBoundaryState {
     hasError: boolean;
     error?: Error;
-    errorInfo?: React.ErrorInfo;
+    errorInfo?: React$1.ErrorInfo;
 }
 interface ErrorBoundaryProps {
     children: ReactNode;
-    fallback?: React.ComponentType<{
+    fallback?: React$1.ComponentType<{
         error?: Error;
         retry?: () => void;
     }>;
-    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
+    onError?: (error: Error, errorInfo: React$1.ErrorInfo) => void;
 }
 declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
     constructor(props: ErrorBoundaryProps);
     static getDerivedStateFromError(error: Error): ErrorBoundaryState;
-    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    componentDidCatch(error: Error, errorInfo: React$1.ErrorInfo): void;
     handleRetry: () => void;
-    render(): string | number | boolean | react_jsx_runtime.JSX.Element | Iterable<React.ReactNode> | null | undefined;
+    render(): string | number | boolean | react_jsx_runtime.JSX.Element | Iterable<React$1.ReactNode> | null | undefined;
 }
 interface ErrorFallbackProps {
     error?: Error;
     retry?: () => void;
 }
-declare const DefaultErrorFallback: React.FC<ErrorFallbackProps>;
+declare const DefaultErrorFallback: React$1.FC<ErrorFallbackProps>;
+
+type Theme = "dark" | "light" | "system";
+type ThemeProviderProps = {
+    children: React.ReactNode;
+    defaultTheme?: Theme;
+    storageKey?: string;
+    forceDefault?: boolean;
+};
+type ThemeProviderState = {
+    theme: Theme;
+    setTheme: (theme: Theme) => void;
+};
+declare function ThemeProvider({ children, defaultTheme, storageKey, forceDefault, ...props }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare const useTheme: () => ThemeProviderState;
+
+interface ThemeToggleProps {
+    className?: string;
+}
+declare function ThemeToggle({ className }: ThemeToggleProps): react_jsx_runtime.JSX.Element;
+
+declare function GlobalToastContainer(): react_jsx_runtime.JSX.Element;
+
+interface ToastParams {
+    title?: string;
+    message?: string;
+    component?: React$1.ReactNode;
+    options?: Partial<ToastOptions>;
+}
+declare const ClayxToast: {
+    success: (params: ToastParams) => void;
+    error: (params: ToastParams) => void;
+    warning: (params: ToastParams) => void;
+    info: (params: ToastParams) => void;
+    default: (params: ToastParams) => void;
+};
 
 declare function useIsMobile(): boolean;
 
 declare function useDebounce<T>(value: T, delay: number): T;
 
 /**
- * Early error handler injector
- * This module provides a runtime function to inject the original
- * `error-handler.js` script into the page. The script is executed
- * as soon as it's injected, providing early capture of runtime and
- * Vite overlay errors for the host app.
+ * 在页面尽早注入错误处理脚本。
+ * 调用时机：应在应用入口尽早执行（例如在 root render 之前）。
  */
 declare function injectEarlyErrorHandler(): void;
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, AuthProvider, type AxiosAIWorkflowOptions, DefaultErrorFallback, type EmailLoginRequest, type EmailLoginResponse, ErrorBoundary, FloatingButton, Loading, LoadingSpinner, LoginForm, type SendCodeRequest, type SendCodeResponse, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, injectEarlyErrorHandler, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useAuthContext, useDebounce, useIsMobile, workflowRequest };
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, AuthProvider, type AuthProviderProps, type AxiosAIWorkflowOptions, ClayxToast, DefaultErrorFallback, type EmailLoginRequest, type EmailLoginResponse, ErrorBoundary, FloatingButton, GlobalToastContainer, HowoneProvider, type HowoneProviderProps, Loading, LoadingSpinner, LoginForm, type SendCodeRequest, type SendCodeResponse, ThemeProvider, ThemeToggle, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, injectEarlyErrorHandler, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useAuthContext, useDebounce, useIsMobile, useTheme, workflowRequest };

package/dist/index.d.ts

@@ -1,14 +1,15 @@
-import React, { Component, ReactNode } from 'react';
+import React$1, { Component, ReactNode } from 'react';
 import * as axios from 'axios';
 import { AxiosResponse, InternalAxiosRequestConfig, AxiosRequestConfig, AxiosInstance } from 'axios';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ToastOptions } from 'react-toastify';
 
 interface FloatingButtonProps {
     text?: string;
     onClick?: () => void;
     className?: string;
 }
-declare const FloatingButton: React.FC<FloatingButtonProps>;
+declare const FloatingButton: React$1.FC<FloatingButtonProps>;
 
 /**
  * 统一认证服务
@@ -420,21 +421,50 @@ interface LoginFormProps {
     appName?: string;
     className?: string;
 }
-declare const LoginForm: React.FC<LoginFormProps>;
+declare const LoginForm: React$1.FC<LoginFormProps>;
 
+type Theme$1 = "dark" | "light" | "system";
 type AuthContextValue = {
     user: ReturnType<typeof parseUserFromToken> | null;
     token: string | null;
     isAuthenticated: boolean;
     logout: () => void;
 };
-declare const AuthProvider: React.FC<{
-    children: React.ReactNode;
+interface HowoneProviderProps {
+    children: React$1.ReactNode;
     autoRedirect?: boolean;
     showFloatingButton?: boolean;
     projectId?: string;
-}>;
+    /** 主题相关配置 */
+    defaultTheme?: Theme$1;
+    themeStorageKey?: string;
+    /** 如果为 true，将忽略 localStorage 中的值，始终使用 defaultTheme */
+    forceDefaultTheme?: boolean;
+}
+/**
+ * HowoneProvider - All-in-one application provider
+ *
+ * Includes:
+ * - Authentication management
+ * - Theme management (dark/light/system)
+ * - Toast notifications
+ * - Floating button
+ *
+ * @example
+ * ```tsx
+ * <HowoneProvider
+ *   defaultTheme="dark"
+ *   themeStorageKey="my-app-theme"
+ *   showFloatingButton={true}
+ * >
+ *   <App />
+ * </HowoneProvider>
+ * ```
+ */
+declare const HowoneProvider: React$1.FC<HowoneProviderProps>;
 declare function useAuthContext(): AuthContextValue;
+declare const AuthProvider: React$1.FC<HowoneProviderProps>;
+type AuthProviderProps = HowoneProviderProps;
 
 type AuthState = {
     user: Record<string, unknown> | null;
@@ -465,50 +495,82 @@ interface LoadingProps {
     className?: string;
     fullScreen?: boolean;
 }
-declare const Loading: React.FC<LoadingProps>;
+declare const Loading: React$1.FC<LoadingProps>;
 interface LoadingSpinnerProps {
     size?: 'sm' | 'md' | 'lg';
     className?: string;
 }
-declare const LoadingSpinner: React.FC<LoadingSpinnerProps>;
+declare const LoadingSpinner: React$1.FC<LoadingSpinnerProps>;
 
 interface ErrorBoundaryState {
     hasError: boolean;
     error?: Error;
-    errorInfo?: React.ErrorInfo;
+    errorInfo?: React$1.ErrorInfo;
 }
 interface ErrorBoundaryProps {
     children: ReactNode;
-    fallback?: React.ComponentType<{
+    fallback?: React$1.ComponentType<{
         error?: Error;
         retry?: () => void;
     }>;
-    onError?: (error: Error, errorInfo: React.ErrorInfo) => void;
+    onError?: (error: Error, errorInfo: React$1.ErrorInfo) => void;
 }
 declare class ErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
     constructor(props: ErrorBoundaryProps);
     static getDerivedStateFromError(error: Error): ErrorBoundaryState;
-    componentDidCatch(error: Error, errorInfo: React.ErrorInfo): void;
+    componentDidCatch(error: Error, errorInfo: React$1.ErrorInfo): void;
     handleRetry: () => void;
-    render(): string | number | boolean | react_jsx_runtime.JSX.Element | Iterable<React.ReactNode> | null | undefined;
+    render(): string | number | boolean | react_jsx_runtime.JSX.Element | Iterable<React$1.ReactNode> | null | undefined;
 }
 interface ErrorFallbackProps {
     error?: Error;
     retry?: () => void;
 }
-declare const DefaultErrorFallback: React.FC<ErrorFallbackProps>;
+declare const DefaultErrorFallback: React$1.FC<ErrorFallbackProps>;
+
+type Theme = "dark" | "light" | "system";
+type ThemeProviderProps = {
+    children: React.ReactNode;
+    defaultTheme?: Theme;
+    storageKey?: string;
+    forceDefault?: boolean;
+};
+type ThemeProviderState = {
+    theme: Theme;
+    setTheme: (theme: Theme) => void;
+};
+declare function ThemeProvider({ children, defaultTheme, storageKey, forceDefault, ...props }: ThemeProviderProps): react_jsx_runtime.JSX.Element;
+declare const useTheme: () => ThemeProviderState;
+
+interface ThemeToggleProps {
+    className?: string;
+}
+declare function ThemeToggle({ className }: ThemeToggleProps): react_jsx_runtime.JSX.Element;
+
+declare function GlobalToastContainer(): react_jsx_runtime.JSX.Element;
+
+interface ToastParams {
+    title?: string;
+    message?: string;
+    component?: React$1.ReactNode;
+    options?: Partial<ToastOptions>;
+}
+declare const ClayxToast: {
+    success: (params: ToastParams) => void;
+    error: (params: ToastParams) => void;
+    warning: (params: ToastParams) => void;
+    info: (params: ToastParams) => void;
+    default: (params: ToastParams) => void;
+};
 
 declare function useIsMobile(): boolean;
 
 declare function useDebounce<T>(value: T, delay: number): T;
 
 /**
- * Early error handler injector
- * This module provides a runtime function to inject the original
- * `error-handler.js` script into the page. The script is executed
- * as soon as it's injected, providing early capture of runtime and
- * Vite overlay errors for the host app.
+ * 在页面尽早注入错误处理脚本。
+ * 调用时机：应在应用入口尽早执行（例如在 root render 之前）。
  */
 declare function injectEarlyErrorHandler(): void;
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, AuthProvider, type AxiosAIWorkflowOptions, DefaultErrorFallback, type EmailLoginRequest, type EmailLoginResponse, ErrorBoundary, FloatingButton, Loading, LoadingSpinner, LoginForm, type SendCodeRequest, type SendCodeResponse, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, injectEarlyErrorHandler, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useAuthContext, useDebounce, useIsMobile, workflowRequest };
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, AuthProvider, type AuthProviderProps, type AxiosAIWorkflowOptions, ClayxToast, DefaultErrorFallback, type EmailLoginRequest, type EmailLoginResponse, ErrorBoundary, FloatingButton, GlobalToastContainer, HowoneProvider, type HowoneProviderProps, Loading, LoadingSpinner, LoginForm, type SendCodeRequest, type SendCodeResponse, ThemeProvider, ThemeToggle, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, injectEarlyErrorHandler, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useAuthContext, useDebounce, useIsMobile, useTheme, workflowRequest };