@howone/sdk 0.2.19 → 0.2.21

package/dist/index.d.mts

@@ -0,0 +1,973 @@
+import React$1, { Component, ReactNode } from 'react';
+import * as axios from 'axios';
+import { AxiosResponse, AxiosRequestConfig, InternalAxiosRequestConfig, 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$1.FC<FloatingButtonProps>;
+
+/**
+ * 发送验证码请求接口
+ */
+interface SendCodeRequest {
+    /** 邮箱地址 */
+    email: string;
+    /** 来源 URL */
+    from_url: string;
+    /** 应用 ID（可选） */
+    app_id?: string;
+    /** 应用名称（可选） */
+    app_name?: string;
+}
+/**
+ * 发送验证码响应接口
+ */
+interface SendCodeResponse {
+    /** 是否成功 */
+    success: boolean;
+    /** 消息（可选） */
+    message?: string;
+    /** 过期时间（秒）（可选） */
+    expiresIn?: number;
+    /** 状态码（可选，用于处理业务逻辑错误） */
+    code?: number;
+    /** 数据对象（可选，用于处理业务逻辑错误） */
+    data?: {
+        success: boolean;
+        message?: string;
+        code?: number;
+    };
+    /** 追踪 ID（可选） */
+    traceId?: number;
+}
+/**
+ * 邮箱登录请求接口
+ */
+interface EmailLoginRequest {
+    /** 邮箱地址 */
+    email: string;
+    /** 验证码 */
+    code: string;
+    /** 来源 URL */
+    from_url: string;
+    /** 应用 ID（可选） */
+    app_id?: string;
+}
+/**
+ * 邮箱登录响应接口
+ */
+interface EmailLoginResponse {
+    /** 是否成功 */
+    success: boolean;
+    /** JWT token（可选） */
+    token?: string;
+    /** 用户信息（可选） */
+    user?: {
+        email: string;
+        name?: string;
+    };
+    /** 重定向 URL（可选） */
+    redirect_url?: string;
+    /** 消息（可选） */
+    message?: string;
+    /** 状态码（可选，用于处理业务逻辑错误） */
+    code?: number;
+    /** 数据对象（可选，用于处理业务逻辑错误） */
+    data?: {
+        success: boolean;
+        message?: string;
+        code?: number;
+    };
+    /** 追踪 ID（可选） */
+    traceId?: number;
+}
+declare class UnifiedAuthService {
+    private readonly API_BASE_URL;
+    /**
+     * 初始化 Google 登录流程
+     * @returns 包含 token 和用户信息的 Promise
+     */
+    initiateGoogleLogin(): Promise<{
+        token: string;
+        user?: any;
+    }>;
+    /**
+     * 打开 OAuth 认证弹窗
+     * @param authUrl 认证 URL
+     * @returns 包含 token 和用户信息的 Promise
+     */
+    private openOAuthPopup;
+    /**
+     * 初始化 GitHub 登录流程
+     * @returns 包含 token 和用户信息的 Promise
+     */
+    initiateGitHubLogin(): Promise<{
+        token: string;
+        user?: any;
+    }>;
+    /**
+     * 发送邮箱验证码
+     * @param email 邮箱地址
+     * @param appName 应用名称（可选）
+     * @returns 发送结果 Promise
+     */
+    sendEmailVerificationCode(email: string, appName?: string): Promise<SendCodeResponse>;
+    /**
+     * 邮箱验证码登录
+     * @param email 邮箱地址
+     * @param code 验证码
+     * @returns 登录结果 Promise
+     */
+    loginWithEmailCode(email: string, code: string): Promise<EmailLoginResponse>;
+    /**
+     * 获取验证码状态（调试用）
+     * @param email 邮箱地址
+     * @returns 验证码状态 Promise
+     */
+    getCodeStatus(email: string): Promise<any>;
+    private generateAppId;
+    /**
+     * 检查 OAuth 回调
+     * 从 URL 参数中获取 token 和错误信息
+     * @returns 包含 token、用户信息和错误的对象
+     */
+    checkOAuthCallback(): {
+        success: boolean;
+        token?: string;
+        error?: string;
+        user?: any;
+    };
+    /**
+     * 验证 token 是否有效
+     * @param token JWT token
+     * @returns 包含有效状态和用户信息的 Promise
+     */
+    verifyToken(token: string): Promise<{
+        valid: boolean;
+        user?: any;
+    }>;
+    private getSavedAuthData;
+    /**
+     * 保存认证数据到本地存储
+     */
+    private saveAuthData;
+    /**
+     * 退出登录
+     * @param token JWT token
+     */
+    logout(token: string): Promise<void>;
+}
+declare const unifiedAuth: UnifiedAuthService;
+declare const unifiedOAuth: UnifiedAuthService;
+declare function sendEmailVerificationCode(email: string, appName?: string): Promise<SendCodeResponse>;
+declare function loginWithEmailCode(email: string, code: string): Promise<EmailLoginResponse>;
+declare function getCodeStatus(email: string): Promise<any>;
+
+/**
+ * AI Workflow 服务（精简版，仅支持按 ID 的 path 风格执行）
+ *
+ * 说明：模板仅需要一种执行接口，形如 POST {baseUrl}/workflow/{workflowId}/execute
+ */
+interface AIWorkflowResponse {
+    success: boolean;
+    status?: number;
+    output?: Record<string, unknown>;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AIWorkflowClientOptions {
+    baseUrl?: string;
+    apiKey?: string;
+    headers?: Record<string, string>;
+    fetchImpl?: typeof fetch;
+}
+declare class AIWorkflowClient {
+    private readonly baseUrl;
+    private readonly apiKey?;
+    private readonly headers;
+    private readonly fetchImpl;
+    constructor(options?: AIWorkflowClientOptions);
+    private buildHeaders;
+    private safeJson;
+    /**
+     * 按 ID 执行工作流：POST {baseUrl}/workflow/{workflowId}/execute
+     * body: { input, options }
+     */
+    executeWorkflow(workflowId: string, inputs: Record<string, unknown>, options?: Record<string, unknown>): Promise<AIWorkflowResponse | null>;
+}
+declare function createAIWorkflowClient(options?: AIWorkflowClientOptions): AIWorkflowClient;
+declare const aiWorkflow: AIWorkflowClient;
+
+interface RequestInterceptors<T = AxiosResponse> {
+    requestInterceptor?: (config: InternalAxiosRequestConfig) => InternalAxiosRequestConfig;
+    requestInterceptorCatch?: (error: any) => any;
+    responseInterceptor?: (res: T) => T;
+    responseInterceptorCatch?: (error: any) => any;
+}
+interface RequestConfig<T = AxiosResponse> extends AxiosRequestConfig {
+    interceptors?: RequestInterceptors<T>;
+    showLoading?: boolean;
+}
+
+declare class Request {
+    instance: AxiosInstance;
+    interceptors?: RequestInterceptors;
+    abortControllers: Map<string, AbortController>;
+    constructor(config: RequestConfig);
+    cancelRequest(url: string): void;
+    cancelAllRequests(): void;
+    request<T = any>(config: RequestConfig<T>): Promise<T>;
+    get<T = any>(config: RequestConfig<T>): Promise<T>;
+    post<T = any>(config: RequestConfig<T>): Promise<T>;
+    delete<T = any>(config: RequestConfig<T>): Promise<T>;
+    put<T = any>(config: RequestConfig<T>): Promise<T>;
+    patch<T = any>(config: RequestConfig<T>): Promise<T>;
+}
+
+interface AxiosAIWorkflowOptions {
+    baseUrl?: string;
+    basePath?: string;
+    apiKey?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+    requestInstance?: Request;
+    /** 'body' (default) or 'path' for /workflow/{id}/execute */
+    workflowEndpointStyle?: 'body' | 'path';
+}
+/**
+ * Create an AI workflow client backed by the project's Request (axios) wrapper.
+ * If `requestInstance` is provided it will be used directly; otherwise a new Request will be created.
+ */
+declare function createAIWorkflowClientAxios(options?: AxiosAIWorkflowOptions): {
+    executeWorkflow(workflowId: string, inputs: Record<string, unknown>, opts?: Record<string, unknown>): Promise<AIWorkflowResponse>;
+};
+
+type Visibility = 'private' | 'project' | 'public' | 'shared';
+interface Artifact {
+    id: string;
+    ownerId?: string | null;
+    projectId?: string | null;
+    visibility: Visibility;
+    storageUrl: string;
+    thumbnailUrl?: string;
+    input?: any;
+    output?: any;
+    model?: string;
+    metadata?: Record<string, any>;
+    createdAt?: string;
+    likes?: number;
+    stats?: {
+        views?: number;
+    };
+    sharedWith?: string[];
+}
+interface ArtifactCreateInput {
+    storageUrl: string;
+    thumbnailUrl?: string;
+    visibility?: Visibility;
+    metadata?: Record<string, any>;
+    model?: string;
+    ownerId?: string;
+    projectId?: string;
+}
+interface ArtifactListQuery {
+    ownerId?: string;
+    projectId?: string;
+    visibility?: Visibility;
+    limit?: number;
+    cursor?: string;
+}
+interface AccessContext {
+    userId?: string | null;
+    projectId?: string | null;
+    tokenScopes?: string[];
+}
+/**
+ * Basic client-side permission check for an artifact.
+ * Note: final authorization must be enforced on the server. This is a convenience helper.
+ */
+declare function canAccessArtifact(a: Artifact, ctx?: AccessContext): boolean;
+
+declare function createArtifactsClient(req: Request): {
+    create(input: ArtifactCreateInput): Promise<Artifact>;
+    list(query?: ArtifactListQuery): Promise<Artifact[]>;
+    get(id: string): Promise<Artifact>;
+    setVisibility(id: string, visibility: string): Promise<void>;
+    delete(id: string): Promise<void>;
+    canAccessLocal(a: Artifact, ctx: AccessContext): boolean;
+};
+
+declare const AUTH_TOKEN_KEY = "auth_token";
+declare function setToken(token: string | null): void;
+declare function getToken(): string | null;
+declare function parseUserFromToken(token: string | null): {
+    id: string;
+    email: string;
+    name: string;
+    avatar: string;
+} | null;
+declare function isTokenValid(token: string | null): boolean;
+declare function useAuth(): {
+    token: string | null;
+    user: {
+        id: string;
+        email: string;
+        name: string;
+        avatar: string;
+    } | null;
+    isAuthenticated: boolean;
+    logout: () => void;
+};
+type AuthState$1 = {
+    user: ReturnType<typeof parseUserFromToken> | null;
+    isLoading: boolean;
+};
+declare function onAuthStateChanged(cb: (state: AuthState$1) => void): () => void;
+
+type Environment = 'local' | 'dev' | 'prod';
+type envs = {
+    AUTH_ROOT_VALUE: string;
+    baseUrl: string;
+    aiBaseUrl: string;
+};
+declare function setEnvironment(e: Environment): envs;
+declare function getEnvironment(): Environment;
+declare function getEnvs(): envs;
+declare function setDefaultProjectId(id: string | null): void;
+declare function getDefaultProjectId(): string | null;
+declare function getGlobalEnvironment(): Environment | null;
+
+/**
+ * Higher-level factory: createClient
+ * - minimal surface compatible with `createClient({ projectId, authRequired })`
+ * - returns executeWorkflow, request, aiRequest and a tiny auth helper (set/get token)
+ */
+declare function createClient(opts: {
+    projectId: string;
+    env?: 'local' | 'dev' | 'prod';
+    authRequired?: boolean;
+    mode?: "auto" | "standalone" | "embedded";
+    auth?: {
+        mode?: "none" | "managed" | "headless";
+        getToken?: () => Promise<string | null>;
+        tokenInjection?: {
+            allowedOrigins?: string[];
+            waitMs?: number;
+            clearUrlParamsAfterInjectionMs?: number;
+            clearAllUrlParams?: boolean;
+            sensitiveParams?: string[];
+        };
+    };
+}): {
+    projectId: string;
+    request: {
+        instance: axios.AxiosInstance;
+        request: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
+        get: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
+        post: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
+        put: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
+        patch: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
+        delete: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
+        cancelRequest: (url: string) => void;
+        cancelAllRequests: () => void;
+    };
+    aiRequest: Request;
+    workflowRequest: {
+        get: <T = any>(config: RequestConfig<T>) => Promise<T>;
+        post: (config: RequestConfig) => Promise<AxiosResponse<any, any>>;
+        put: <T = any>(config: RequestConfig<T>) => Promise<T>;
+        delete: <T = any>(config: RequestConfig<T>) => Promise<T>;
+        request: <T = any>(config: RequestConfig<T>) => Promise<T>;
+        cancelRequest: (url: string) => void;
+        cancelAllRequests: () => void;
+    };
+    artifacts: {
+        create(input: ArtifactCreateInput): Promise<Artifact>;
+        list(query?: ArtifactListQuery): Promise<Artifact[]>;
+        get(id: string): Promise<Artifact>;
+        setVisibility(id: string, visibility: string): Promise<void>;
+        delete(id: string): Promise<void>;
+    };
+    me: () => Promise<{
+        id: string;
+        email: string;
+        name: string;
+        avatar: string;
+    } | null>;
+    auth: {
+        setToken: (t: string | null) => void;
+        getToken: () => string | null;
+        isAuthenticated: () => boolean;
+        login: (redirect?: string) => void;
+        logout: () => void;
+    };
+    sanitizeUrl: (o?: {
+        clearAll?: boolean;
+        sensitiveParams?: string[];
+    }) => void;
+};
+
+interface LoginFormProps {
+    onLoginSuccess?: () => void;
+    appName?: string;
+    className?: string;
+}
+declare const LoginForm: React$1.FC<LoginFormProps>;
+
+type Theme$1 = "dark" | "light" | "system";
+type HowoneContextValue = {
+    user: ReturnType<typeof parseUserFromToken> | null;
+    token: string | null;
+    isAuthenticated: boolean;
+    logout: () => void;
+};
+interface HowOneProviderProps {
+    children: React$1.ReactNode;
+    autoRedirect?: boolean;
+    showFloatingButton?: boolean;
+    projectId?: string;
+    defaultTheme?: Theme$1;
+    themeStorageKey?: string;
+    forceDefaultTheme?: boolean;
+    redirectOnUnauthenticated?: boolean;
+}
+/**
+ * HowOneProvider - All-in-one application provider
+ *
+ * Includes:
+ * - Authentication management with auto-redirect to auth page
+ * - Theme management (dark/light/system)
+ * - Toast notifications
+ * - Floating button (shows "Login" when unauthenticated)
+ *
+ * @example
+ * ```tsx
+ * <HowOneProvider
+ *   defaultTheme="dark"
+ *   themeStorageKey="my-app-theme"
+ *   showFloatingButton={true}
+ *   redirectOnUnauthenticated={true}
+ * >
+ *   <App />
+ * </HowOneProvider>
+ * ```
+ */
+declare const HowOneProvider: React$1.FC<HowOneProviderProps>;
+declare function useHowoneContext(): HowoneContextValue;
+
+type AuthState = {
+    user: Record<string, unknown> | null;
+    isLoading: boolean;
+};
+declare class HowoneAuthClient {
+    private listeners;
+    private loading;
+    private emit;
+    onAuthStateChanged(listener: (state: AuthState) => void): () => void;
+    login(): void;
+    logout(): void;
+    getUser(): {
+        id: string;
+        email: string;
+        name: string;
+        avatar: string;
+    } | null;
+    setToken(token: string | null): void;
+}
+declare const howone: {
+    auth: HowoneAuthClient;
+};
+
+interface LoadingProps {
+    size?: 'sm' | 'md' | 'lg';
+    text?: string;
+    className?: string;
+    fullScreen?: boolean;
+}
+declare const Loading: React$1.FC<LoadingProps>;
+interface LoadingSpinnerProps {
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+}
+declare const LoadingSpinner: React$1.FC<LoadingSpinnerProps>;
+
+interface ErrorBoundaryState {
+    hasError: boolean;
+    error?: Error;
+    errorInfo?: React$1.ErrorInfo;
+}
+interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: React$1.ComponentType<{
+        error?: Error;
+        retry?: () => 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$1.ErrorInfo): void;
+    handleRetry: () => void;
+    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$1.FC<ErrorFallbackProps>;
+
+type ButtonSize = "sm" | "md" | "lg";
+type ButtonVariant = "solid" | "ghost" | "flat";
+interface ClayxButtonProps extends React$1.ButtonHTMLAttributes<HTMLButtonElement> {
+    isIconOnly?: boolean;
+    size?: ButtonSize;
+    variant?: ButtonVariant;
+    children?: React$1.ReactNode;
+}
+declare const ClayxButton: React$1.FC<ClayxButtonProps>;
+
+declare function showLimitUpgradeToast(message: string, onUpgrade: () => void): void;
+
+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;
+    render?: (closeToast: () => void) => React$1.ReactNode;
+    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;
+};
+
+interface SourceLocation {
+    file: string;
+    line: number;
+    component: string;
+}
+interface ElementSelectionData {
+    sourceLocation: SourceLocation | null;
+    element: {
+        tagName: string;
+        className: string;
+        id: string;
+        text: string;
+    };
+    rect: {
+        top: number;
+        left: number;
+        width: number;
+        height: number;
+    };
+}
+interface ElementSelectorProps {
+    active: boolean;
+    onSelect?: (data: ElementSelectionData) => void;
+    onCancel?: () => void;
+}
+declare const ElementSelector: React$1.FC<ElementSelectorProps>;
+
+interface ElementSelectorProviderProps {
+    children: React$1.ReactNode;
+}
+/**
+ * 元素选择器提供者组件
+ * 监听来自 iframe.js 的自定义事件，自动显示/隐藏元素选择器
+ */
+declare const ElementSelectorProvider: React$1.FC<ElementSelectorProviderProps>;
+
+declare function useIsMobile(): boolean;
+
+declare function useDebounce<T>(value: T, delay: number): T;
+
+interface UseElementSelectorReturn {
+    isSelecting: boolean;
+    selectedElement: ElementSelectionData | null;
+    startSelecting: () => void;
+    stopSelecting: () => void;
+    clearSelection: () => void;
+}
+/**
+ * 元素选择器 Hook
+ * 用于管理元素选择状态和向父窗口发送消息
+ */
+declare function useElementSelector(): UseElementSelectorReturn;
+/**
+ * 向父窗口发送元素选择数据
+ */
+declare function sendElementSelectionToParent(data: ElementSelectionData): void;
+
+/**
+ * 错误处理模块 - 核心类型定义
+ *
+ */
+declare global {
+    interface Window {
+        __AUTO_ENGINEER_INTERACTION_TRAIL__?: UserInteraction[];
+        __AUTO_ENGINEER_ERRORS__?: any[];
+        __SEND_ERROR_TO_PARENT__?: (error: Error | string, details?: any) => void;
+        __FETCH_INTERCEPTED__?: boolean;
+        __XHR_INTERCEPTED__?: boolean;
+        __CONSOLE_INTERCEPTED__?: boolean;
+        __VITE_HMR__?: any;
+        __vite_plugin_react_preamble_installed__?: boolean;
+        __REACT_DEVTOOLS_GLOBAL_HOOK__?: any;
+        React?: any;
+        ReactDOM?: any;
+        Vue?: any;
+        Angular?: any;
+        jQuery?: any;
+        $?: any;
+    }
+}
+type ErrorSeverity = 'critical' | 'high' | 'medium' | 'low';
+type ErrorType = 'runtime' | 'promise' | 'network' | 'resource' | 'console' | 'vite' | 'react' | 'module' | 'unknown';
+interface UserInteraction {
+    type: 'click' | 'input' | 'scroll' | 'navigation' | 'mousemove' | 'focus' | 'blur' | 'resize' | 'submit' | 'visibility' | 'keydown' | 'change' | 'keyup';
+    element?: string;
+    timestamp: number;
+    details?: any;
+}
+interface ViewInfo {
+    title: string;
+    url: string;
+    timestamp: number;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+interface ErrorPayload {
+    message: string;
+    stack?: string;
+    filename?: string;
+    lineno?: number;
+    colno?: number;
+    timestamp: number;
+    type: ErrorType | string;
+    severity: ErrorSeverity;
+    category?: string;
+    userAgent?: string;
+    url?: string;
+    view?: string;
+    userInteractions?: UserInteraction[];
+    networkInfo?: any;
+    details?: any;
+    context?: {
+        source?: string;
+        [key: string]: any;
+    };
+}
+interface SimpleErrorConfig {
+    maxErrors: number;
+    dedupWindow: number;
+    debounceTime: number;
+    reportToParent: boolean;
+    reportToConsole: boolean;
+}
+interface EnhancedErrorConfig {
+    MAX_ERRORS: number;
+    MAX_INTERACTIONS: number;
+    DEDUP_WINDOW: number;
+    DEBOUNCE_TIME: number;
+    CACHE_DURATION: number;
+    SEVERITY_KEYWORDS: {
+        CRITICAL: string[];
+        HIGH: string[];
+        MEDIUM: string[];
+        LOW: string[];
+    };
+    CATEGORY_KEYWORDS: {
+        SYNTAX: string[];
+        NETWORK: string[];
+        RUNTIME: string[];
+        SECURITY: string[];
+        PERFORMANCE: string[];
+        DEVELOPMENT: string[];
+    };
+}
+interface GlobalStateConfig {
+    ALLOWED_ORIGINS: string[];
+    DEBOUNCE_DELAY: number;
+    OVERRIDE_STYLESHEET_ID: string;
+}
+interface SelectorConfig {
+    HIGHLIGHT_COLOR: string;
+    HIGHLIGHT_BORDER_WIDTH: string;
+    HIGHLIGHT_BORDER_STYLE: string;
+    SELECTED_COLOR: string;
+    SELECTED_BORDER_WIDTH: string;
+    TOOLTIP_BACKGROUND: string;
+    TOOLTIP_COLOR: string;
+    TOOLTIP_PADDING: string;
+    TOOLTIP_BORDER_RADIUS: string;
+    TOOLTIP_FONT_SIZE: string;
+    TOOLTIP_Z_INDEX: string;
+    FULL_WIDTH_TOOLTIP_OFFSET: number;
+    highlightClass: string;
+    selectedClass: string;
+    cursor: string;
+}
+interface SelectorState {
+    isActive: boolean;
+    highlightedElement: any;
+    selectedElements: any[];
+    config: SelectorConfig;
+}
+/**
+ * 统一消息类型定义
+ */
+type MessageType = 'ERROR_EVENT' | 'NETWORK_EVENT' | 'CONSOLE_EVENT' | 'SYSTEM_EVENT' | 'ELEMENT_EVENT' | 'SELECTOR_EVENT' | 'COMPONENT_EVENT' | 'STYLE_EVENT' | 'INTERACTION_EVENT' | 'STATE_EVENT';
+interface ErrorStats {
+    totalErrors: number;
+    sentToParent?: number;
+    errorsByCategory?: Record<string, number>;
+    errorsBySeverity?: Record<ErrorSeverity, number>;
+    recentErrors?: ErrorPayload[];
+    jsErrors?: number;
+    networkErrors?: number;
+    consoleErrors?: number;
+    lastErrorTime?: number;
+}
+declare const ERROR_CONFIG: EnhancedErrorConfig;
+declare const GLOBAL_CONFIG: GlobalStateConfig;
+declare const DEFAULT_SELECTOR_CONFIG: SelectorConfig;
+
+interface RefreshResult {
+    success: boolean;
+    clearedCaches?: string[];
+    unregisteredWorkers?: number;
+    clearedStorage?: string[];
+    error?: string;
+}
+
+/**
+ * 统一错误处理器主类
+ * 提供完整的错误处理、交互追踪、元素选择等功能
+ */
+declare class ErrorHandler {
+    private initialized;
+    private errorHistory;
+    private messageSender;
+    private errorTracking;
+    private interactionTracking;
+    private messageBridge;
+    private viteHMRDetector;
+    private hardRefreshManager;
+    private viewDetector;
+    private componentTreeGenerator;
+    private config;
+    constructor(options?: Partial<typeof this.config>);
+    /** ----------------- 主要初始化方法 ----------------- */
+    /**
+     * 初始化错误处理器
+     */
+    init(): void;
+    /**
+     * 初始化核心功能
+     */
+    private initializeCore;
+    /**
+     * 初始化全局状态
+     */
+    private initializeGlobalState;
+    /**
+     * 设置调试端点
+     */
+    private setupDebugEndpoint;
+    /**
+     * 设置模块间的协作
+     */
+    private setupModuleIntegration;
+    /**
+     * 启用功能模块
+     */
+    private enableFeatures;
+    /**
+     * 处理硬刷新逻辑
+     */
+    private handleHardRefreshLogic;
+    /**
+     * 设置视图检测
+     */
+    private setupViewDetection;
+    /**
+     * 发送初始化完成消息
+     */
+    /** ----------------- 公共接口方法 ----------------- */
+    /**
+     * 获取错误统计
+     */
+    getErrorStats(): ErrorStats;
+    /**
+     * 获取交互历史
+     */
+    getInteractionHistory(): UserInteraction[];
+    /**
+     * 获取当前视图信息
+     */
+    getCurrentView(): ViewInfo;
+    /**
+     * 执行硬刷新
+     */
+    performHardRefresh(options?: any): Promise<RefreshResult>;
+    /**
+     * 获取深度序列化的错误历史
+     */
+    getSerializedErrorHistory(): any;
+    /**
+     * 检查是否在 Vite 环境中
+     */
+    isViteEnvironment(): boolean;
+    /**
+     * 更新配置
+     */
+    updateConfig(newConfig: Partial<typeof this.config>): void;
+    /**
+     * 销毁错误处理器
+     */
+    destroy(): void;
+    /**
+     * 检查是否已初始化
+     */
+    isInitialized(): boolean;
+    /**
+     * 报告当前状态
+     */
+    reportStatus(): void;
+}
+
+/**
+ * 简化版错误处理器
+ * 去除所有复杂功能，只保留最基本的错误收集和发送
+ */
+declare class SimpleErrorHandler {
+    private initialized;
+    private sendMessage;
+    /**
+     * 初始化错误处理器
+     */
+    init(): void;
+    /**
+     * 设置错误监听器
+     */
+    private setupErrorListeners;
+    /**
+     * 设置兼容性函数
+     */
+    private setupCompatibility;
+    /**
+     * 发送错误到父窗口
+     */
+    private sendError;
+    /**
+     * 手动捕获错误
+     */
+    captureError(error: Error, details?: any): void;
+}
+
+/**
+ * iframe navigation and element selector utilities
+ * Replaces the standalone iframe.js script
+ */
+declare function customGoBack(): boolean;
+declare function customGoForward(): boolean;
+declare function triggerElementSelection(): void;
+declare function cancelElementSelection(): void;
+/**
+ * Initialize iframe navigation system
+ * Call this once when your app starts
+ */
+declare function initIframeNavigation(): void;
+/**
+ * Public API for iframe navigation
+ */
+declare const iframeNavigation: {
+    /**
+     * Initialize the navigation system
+     */
+    init: typeof initIframeNavigation;
+    /**
+     * Add a page to navigation history
+     */
+    addPage: (url?: string, title?: string) => void;
+    /**
+     * Get current navigation state
+     */
+    getState: () => {
+        canGoBack: boolean;
+        canGoForward: boolean;
+        historyLength: number;
+        currentIndex: number;
+        currentPage: {
+            url: string;
+            title: string;
+            timestamp: number;
+        };
+    };
+    /**
+     * Update navigation state (send to parent)
+     */
+    updateState: () => void;
+    /**
+     * Go back in history
+     */
+    goBack: typeof customGoBack;
+    /**
+     * Go forward in history
+     */
+    goForward: typeof customGoForward;
+};
+/**
+ * Public API for element selector
+ */
+declare const elementSelector: {
+    /**
+     * Start element selection mode
+     */
+    startSelection: typeof triggerElementSelection;
+    /**
+     * Cancel element selection mode
+     */
+    cancel: typeof cancelElementSelection;
+    /**
+     * Check if selector is active
+     */
+    isActive: () => boolean;
+};
+
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxButton, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, type Environment, ErrorBoundary, ErrorHandler, type ErrorPayload, type ErrorSeverity, type ErrorStats, type ErrorType, FloatingButton, GLOBAL_CONFIG, GlobalToastContainer, HowOneProvider, type HowOneProviderProps, Loading, LoadingSpinner, LoginForm, type MessageType, type SelectorState, type SendCodeRequest, type SendCodeResponse, type SimpleErrorConfig, SimpleErrorHandler, type SourceLocation, ThemeProvider, ThemeToggle, type UseElementSelectorReturn, type UserInteraction, type ViewInfo, type Visibility, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, elementSelector, type envs, getCodeStatus, getDefaultProjectId, getEnvironment, getEnvs, getGlobalEnvironment, getToken, howone, iframeNavigation, initIframeNavigation, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, sendElementSelectionToParent, sendEmailVerificationCode, setDefaultProjectId, setEnvironment, setToken, showLimitUpgradeToast, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useElementSelector, useHowoneContext, useIsMobile, useTheme };