@howone/sdk 0.1.27 → 0.1.28

package/dist/index.d.mts

@@ -575,10 +575,63 @@ declare const ClayxToast: {
     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;
+
 /**
  * 错误处理模块 - 核心类型定义
  *
@@ -867,4 +920,4 @@ declare class SimpleErrorHandler {
     captureError(error: Error, details?: any): void;
 }
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, 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, ThemeProvider, ThemeToggle, type UserInteraction, type ViewInfo, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useHowoneContext, useIsMobile, useTheme, workflowRequest };
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, 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, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendElementSelectionToParent, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useElementSelector, useHowoneContext, useIsMobile, useTheme, workflowRequest };

package/dist/index.d.ts

@@ -575,10 +575,63 @@ declare const ClayxToast: {
     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;
+
 /**
  * 错误处理模块 - 核心类型定义
  *
@@ -867,4 +920,4 @@ declare class SimpleErrorHandler {
     captureError(error: Error, details?: any): void;
 }
 
-export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, 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, ThemeProvider, ThemeToggle, type UserInteraction, type ViewInfo, type Visibility, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useHowoneContext, useIsMobile, useTheme, workflowRequest };
+export { type AIWorkflowClientOptions, type AIWorkflowResponse, AUTH_ROOT, AUTH_TOKEN_KEY, type AccessContext, type Artifact, type ArtifactCreateInput, type ArtifactListQuery, type AxiosAIWorkflowOptions, ClayxToast, DEFAULT_SELECTOR_CONFIG, DefaultErrorFallback, ERROR_CONFIG, type ElementSelectionData, ElementSelector, ElementSelectorProvider, type EmailLoginRequest, type EmailLoginResponse, type EnhancedErrorConfig, 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, aiRequest, aiWorkflow, canAccessArtifact, createAIWorkflowClient, createAIWorkflowClientAxios, createArtifactsClient, createClient, getAuthRoot, getCodeStatus, getDefaultProjectId, getToken, howone, isTokenValid, loginWithEmailCode, onAuthStateChanged, parseUserFromToken, request, sendElementSelectionToParent, sendEmailVerificationCode, setAuthRoot, setDefaultProjectId, setToken, unifiedAuth, unifiedOAuth, useAuth, useDebounce, useElementSelector, useHowoneContext, useIsMobile, useTheme, workflowRequest };