skema-core 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -190,11 +190,23 @@ interface AnnotationExport {
 interface SkemaProps {
     /** Whether Skema overlay is enabled */
     enabled?: boolean;
+    /**
+     * WebSocket URL for the Skema daemon (default: ws://localhost:9999)
+     * When provided (or using default), Skema auto-connects and handles AI generation internally.
+     * Set to null to disable auto-connection (useful if providing custom callbacks).
+     */
+    daemonUrl?: string | null;
     /** Callback when annotations change */
     onAnnotationsChange?: (annotations: Annotation[]) => void;
-    /** Callback when a single annotation is submitted - for real-time integrations like Gemini */
+    /**
+     * Callback when a single annotation is submitted.
+     * If not provided and daemonUrl is set, Skema will auto-generate using the daemon.
+     */
     onAnnotationSubmit?: (annotation: Annotation, comment: string) => void;
-    /** Callback when an annotation is deleted - for reverting changes */
+    /**
+     * Callback when an annotation is deleted.
+     * If not provided and daemonUrl is set, Skema will auto-revert using the daemon.
+     */
     onAnnotationDelete?: (annotationId: string) => void;
     /** Keyboard shortcut to toggle Skema (default: Cmd/Ctrl + Shift + E) */
     toggleShortcut?: string;
@@ -202,6 +214,10 @@ interface SkemaProps {
     initialAnnotations?: Annotation[];
     /** Z-index for the overlay (default: 99999) */
     zIndex?: number;
+    /** Whether an annotation is currently being processed (shows loading animation) */
+    isProcessing?: boolean;
+    /** Callback when user cancels an in-progress annotation (clicks X during processing) */
+    onProcessingCancel?: () => void;
 }
 /**
  * Skema mode - determines what tools are available
@@ -243,6 +259,68 @@ interface AnnotationPopupHandle {
 }
 declare const AnnotationPopup: React.ForwardRefExoticComponent<AnnotationPopupProps & React.RefAttributes<AnnotationPopupHandle>>;
 
+type AIProvider = 'gemini' | 'claude';
+interface DaemonState {
+    connected: boolean;
+    provider: AIProvider;
+    availableProviders: AIProvider[];
+    cwd: string;
+}
+interface AIStreamEvent {
+    type: 'init' | 'text' | 'tool_use' | 'tool_result' | 'error' | 'done' | 'debug';
+    content?: string;
+    timestamp: string;
+    provider: AIProvider;
+    raw?: unknown;
+}
+interface UseDaemonOptions {
+    /** WebSocket URL (default: ws://localhost:9999) */
+    url?: string;
+    /** Auto-connect on mount (default: true) */
+    autoConnect?: boolean;
+    /** Reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnect delay in ms (default: 2000) */
+    reconnectDelay?: number;
+}
+interface UseDaemonReturn {
+    /** Current daemon state */
+    state: DaemonState;
+    /** Whether currently generating */
+    isGenerating: boolean;
+    /** Last error message */
+    error: string | null;
+    /** Connect to daemon */
+    connect: () => void;
+    /** Disconnect from daemon */
+    disconnect: () => void;
+    /** Switch AI provider */
+    setProvider: (provider: AIProvider) => Promise<boolean>;
+    /** Generate code from annotation (streaming) */
+    generate: (annotation: Partial<Annotation> & {
+        comment?: string;
+    }, onEvent?: (event: AIStreamEvent) => void) => Promise<{
+        success: boolean;
+        annotationId: string;
+    }>;
+    /** Revert changes for an annotation */
+    revert: (annotationId: string) => Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /** Read a file */
+    readFile: (path: string) => Promise<string>;
+    /** Write a file */
+    writeFile: (path: string, content: string) => Promise<boolean>;
+    /** Run a command */
+    runCommand: (command: string) => Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+}
+declare function useDaemon(options?: UseDaemonOptions): UseDaemonReturn;
+
 /**
  * Generates a unique CSS selector for an element
  */
@@ -353,4 +431,4 @@ declare function getGridCellReference(x: number, y: number, gridSize?: number):
  */
 declare function extractTextFromShapes(shapes: unknown[]): string;
 
-export { type Annotation, type AnnotationExport, AnnotationPopup, type AnnotationPopupHandle, type AnnotationPopupProps, type BoundingBox, type DOMElement, type DOMSelection, type DrawingAnnotation, type ElementStyles, type GestureAnnotation, type NearbyElement, type PendingAnnotation, type ProjectStyleContext, Skema, type SkemaMode, type SkemaProps, type ViewportInfo, addGridToSvg, bboxCenter, bboxDocumentToViewport, bboxFromPoints, bboxIntersects, bboxViewportToDocument, blobToBase64, createDOMSelection, Skema as default, documentToViewport, expandBbox, extractTextFromShapes, generateSelector, getBoundingBox, getElementClasses, getElementPath, getGridCellReference, getViewportInfo, identifyElement, pointInBbox, shouldIgnoreElement, viewportToDocument };
+export { type AIProvider, type AIStreamEvent, type Annotation, type AnnotationExport, AnnotationPopup, type AnnotationPopupHandle, type AnnotationPopupProps, type BoundingBox, type DOMElement, type DOMSelection, type DaemonState, type DrawingAnnotation, type ElementStyles, type GestureAnnotation, type NearbyElement, type PendingAnnotation, type ProjectStyleContext, Skema, type SkemaMode, type SkemaProps, type UseDaemonOptions, type UseDaemonReturn, type ViewportInfo, addGridToSvg, bboxCenter, bboxDocumentToViewport, bboxFromPoints, bboxIntersects, bboxViewportToDocument, blobToBase64, createDOMSelection, Skema as default, documentToViewport, expandBbox, extractTextFromShapes, generateSelector, getBoundingBox, getElementClasses, getElementPath, getGridCellReference, getViewportInfo, identifyElement, pointInBbox, shouldIgnoreElement, useDaemon, viewportToDocument };

package/dist/index.d.ts

@@ -190,11 +190,23 @@ interface AnnotationExport {
 interface SkemaProps {
     /** Whether Skema overlay is enabled */
     enabled?: boolean;
+    /**
+     * WebSocket URL for the Skema daemon (default: ws://localhost:9999)
+     * When provided (or using default), Skema auto-connects and handles AI generation internally.
+     * Set to null to disable auto-connection (useful if providing custom callbacks).
+     */
+    daemonUrl?: string | null;
     /** Callback when annotations change */
     onAnnotationsChange?: (annotations: Annotation[]) => void;
-    /** Callback when a single annotation is submitted - for real-time integrations like Gemini */
+    /**
+     * Callback when a single annotation is submitted.
+     * If not provided and daemonUrl is set, Skema will auto-generate using the daemon.
+     */
     onAnnotationSubmit?: (annotation: Annotation, comment: string) => void;
-    /** Callback when an annotation is deleted - for reverting changes */
+    /**
+     * Callback when an annotation is deleted.
+     * If not provided and daemonUrl is set, Skema will auto-revert using the daemon.
+     */
     onAnnotationDelete?: (annotationId: string) => void;
     /** Keyboard shortcut to toggle Skema (default: Cmd/Ctrl + Shift + E) */
     toggleShortcut?: string;
@@ -202,6 +214,10 @@ interface SkemaProps {
     initialAnnotations?: Annotation[];
     /** Z-index for the overlay (default: 99999) */
     zIndex?: number;
+    /** Whether an annotation is currently being processed (shows loading animation) */
+    isProcessing?: boolean;
+    /** Callback when user cancels an in-progress annotation (clicks X during processing) */
+    onProcessingCancel?: () => void;
 }
 /**
  * Skema mode - determines what tools are available
@@ -243,6 +259,68 @@ interface AnnotationPopupHandle {
 }
 declare const AnnotationPopup: React.ForwardRefExoticComponent<AnnotationPopupProps & React.RefAttributes<AnnotationPopupHandle>>;
 
+type AIProvider = 'gemini' | 'claude';
+interface DaemonState {
+    connected: boolean;
+    provider: AIProvider;
+    availableProviders: AIProvider[];
+    cwd: string;
+}
+interface AIStreamEvent {
+    type: 'init' | 'text' | 'tool_use' | 'tool_result' | 'error' | 'done' | 'debug';
+    content?: string;
+    timestamp: string;
+    provider: AIProvider;
+    raw?: unknown;
+}
+interface UseDaemonOptions {
+    /** WebSocket URL (default: ws://localhost:9999) */
+    url?: string;
+    /** Auto-connect on mount (default: true) */
+    autoConnect?: boolean;
+    /** Reconnect on disconnect (default: true) */
+    autoReconnect?: boolean;
+    /** Reconnect delay in ms (default: 2000) */
+    reconnectDelay?: number;
+}
+interface UseDaemonReturn {
+    /** Current daemon state */
+    state: DaemonState;
+    /** Whether currently generating */
+    isGenerating: boolean;
+    /** Last error message */
+    error: string | null;
+    /** Connect to daemon */
+    connect: () => void;
+    /** Disconnect from daemon */
+    disconnect: () => void;
+    /** Switch AI provider */
+    setProvider: (provider: AIProvider) => Promise<boolean>;
+    /** Generate code from annotation (streaming) */
+    generate: (annotation: Partial<Annotation> & {
+        comment?: string;
+    }, onEvent?: (event: AIStreamEvent) => void) => Promise<{
+        success: boolean;
+        annotationId: string;
+    }>;
+    /** Revert changes for an annotation */
+    revert: (annotationId: string) => Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /** Read a file */
+    readFile: (path: string) => Promise<string>;
+    /** Write a file */
+    writeFile: (path: string, content: string) => Promise<boolean>;
+    /** Run a command */
+    runCommand: (command: string) => Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+}
+declare function useDaemon(options?: UseDaemonOptions): UseDaemonReturn;
+
 /**
  * Generates a unique CSS selector for an element
  */
@@ -353,4 +431,4 @@ declare function getGridCellReference(x: number, y: number, gridSize?: number):
  */
 declare function extractTextFromShapes(shapes: unknown[]): string;
 
-export { type Annotation, type AnnotationExport, AnnotationPopup, type AnnotationPopupHandle, type AnnotationPopupProps, type BoundingBox, type DOMElement, type DOMSelection, type DrawingAnnotation, type ElementStyles, type GestureAnnotation, type NearbyElement, type PendingAnnotation, type ProjectStyleContext, Skema, type SkemaMode, type SkemaProps, type ViewportInfo, addGridToSvg, bboxCenter, bboxDocumentToViewport, bboxFromPoints, bboxIntersects, bboxViewportToDocument, blobToBase64, createDOMSelection, Skema as default, documentToViewport, expandBbox, extractTextFromShapes, generateSelector, getBoundingBox, getElementClasses, getElementPath, getGridCellReference, getViewportInfo, identifyElement, pointInBbox, shouldIgnoreElement, viewportToDocument };
+export { type AIProvider, type AIStreamEvent, type Annotation, type AnnotationExport, AnnotationPopup, type AnnotationPopupHandle, type AnnotationPopupProps, type BoundingBox, type DOMElement, type DOMSelection, type DaemonState, type DrawingAnnotation, type ElementStyles, type GestureAnnotation, type NearbyElement, type PendingAnnotation, type ProjectStyleContext, Skema, type SkemaMode, type SkemaProps, type UseDaemonOptions, type UseDaemonReturn, type ViewportInfo, addGridToSvg, bboxCenter, bboxDocumentToViewport, bboxFromPoints, bboxIntersects, bboxViewportToDocument, blobToBase64, createDOMSelection, Skema as default, documentToViewport, expandBbox, extractTextFromShapes, generateSelector, getBoundingBox, getElementClasses, getElementPath, getGridCellReference, getViewportInfo, identifyElement, pointInBbox, shouldIgnoreElement, useDaemon, viewportToDocument };