skema-core 0.1.0

package/dist/server.d.mts

@@ -0,0 +1,260 @@
+import { ChildProcess } from 'child_process';
+
+/**
+ * Represents a single DOM element in a selection
+ */
+interface DOMElement {
+    selector: string;
+    tagName: string;
+    elementPath: string;
+    text: string;
+    boundingBox: BoundingBox;
+    cssClasses?: string;
+    attributes?: Record<string, string>;
+}
+/**
+ * Represents a DOM element selection (can contain one or more elements)
+ */
+interface DOMSelection {
+    id: string;
+    selector: string;
+    tagName: string;
+    elementPath: string;
+    text: string;
+    boundingBox: BoundingBox;
+    timestamp: number;
+    pathname: string;
+    cssClasses?: string;
+    attributes?: Record<string, string>;
+    /** User annotation comment */
+    comment?: string;
+    /** Whether this is a multi-element selection */
+    isMultiSelect?: boolean;
+    /** Individual elements when this is a grouped selection */
+    elements?: DOMElement[];
+}
+/**
+ * Bounding box for element positioning
+ */
+interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Viewport information for coordinate calculations
+ */
+interface ViewportInfo {
+    width: number;
+    height: number;
+    scrollX: number;
+    scrollY: number;
+}
+/**
+ * Computed styles for an element
+ */
+interface ElementStyles {
+    fontFamily?: string;
+    fontSize?: string;
+    fontWeight?: string;
+    lineHeight?: string;
+    letterSpacing?: string;
+    textAlign?: string;
+    color?: string;
+    padding?: string;
+    margin?: string;
+    gap?: string;
+    display?: string;
+    flexDirection?: string;
+    alignItems?: string;
+    justifyContent?: string;
+    backgroundColor?: string;
+    borderRadius?: string;
+    border?: string;
+    boxShadow?: string;
+    width?: string;
+    height?: string;
+    maxWidth?: string;
+}
+/**
+ * Nearby element with style context for AI
+ */
+interface NearbyElement {
+    selector: string;
+    tagName: string;
+    text?: string;
+    className?: string;
+    styles?: ElementStyles;
+    tailwindClasses?: string[];
+}
+/**
+ * Project-level style context
+ */
+interface ProjectStyleContext {
+    cssFramework?: 'tailwind' | 'bootstrap' | 'material-ui' | 'chakra' | 'vanilla' | 'css-modules' | 'styled-components' | 'unknown';
+    cssVariables?: Record<string, string>;
+    colorPalette?: string[];
+    baseFontFamily?: string;
+    baseFontSize?: string;
+}
+/**
+ * Drawing annotation from tldraw
+ */
+interface DrawingAnnotation {
+    id: string;
+    type: 'drawing';
+    tool: string;
+    shapes: unknown[];
+    boundingBox: BoundingBox;
+    relatedTo?: string;
+    timestamp: number;
+    /** User annotation comment describing what to build */
+    comment?: string;
+    /** SVG representation of the drawing for AI processing */
+    drawingSvg?: string;
+    /** Base64 PNG image of the drawing for vision AI */
+    drawingImage?: string;
+    /** Extracted text content from text shapes in the drawing */
+    extractedText?: string;
+    /** Grid configuration used for positioning reference */
+    gridConfig?: {
+        color: string;
+        size: number;
+        labels: boolean;
+    };
+    /** Viewport info for relative sizing context */
+    viewport?: ViewportInfo;
+    /** Project-level style context */
+    projectStyles?: ProjectStyleContext;
+    /** Nearby DOM elements that the drawing may relate to */
+    nearbyElements?: NearbyElement[];
+}
+/**
+ * Gesture action annotation
+ */
+interface GestureAnnotation {
+    id: string;
+    type: 'gesture';
+    gesture: 'scribble_delete' | 'circle' | 'rectangle' | 'arrow';
+    target?: string;
+    boundingBox: BoundingBox;
+    timestamp: number;
+}
+/**
+ * Union type for all annotation types
+ */
+type Annotation = {
+    type: 'dom_selection';
+} & DOMSelection | DrawingAnnotation | GestureAnnotation;
+
+/**
+ * Revert changes for an annotation by restoring from snapshot
+ */
+declare function revertAnnotation(annotationId: string, cwd?: string): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Get all tracked annotation IDs
+ */
+declare function getTrackedAnnotations(): string[];
+interface GeminiCLIOptions {
+    /** Working directory for Gemini CLI */
+    cwd?: string;
+    /** API key (defaults to GEMINI_API_KEY env var) */
+    apiKey?: string;
+    /** Auto-approve all tool calls (default: true) */
+    yolo?: boolean;
+    /** Output format (default: 'stream-json') */
+    outputFormat?: 'text' | 'json' | 'stream-json';
+    /** Model to use (default: 'gemini-2.5-flash' for speed) */
+    model?: string;
+    /** Use minimal/fast prompt (default: true) */
+    fastMode?: boolean;
+}
+interface ProjectContext {
+    pathname?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+interface GeminiCLIEvent {
+    type: 'init' | 'message' | 'tool_use' | 'tool_result' | 'error' | 'result' | 'done' | 'debug';
+    timestamp?: string;
+    content?: string;
+    role?: 'user' | 'assistant';
+    tool_name?: string;
+    tool_id?: string;
+    status?: 'success' | 'error';
+    code?: number;
+    [key: string]: unknown;
+}
+/**
+ * Build a prompt for Gemini CLI from an annotation
+ */
+declare function buildPromptFromAnnotation(annotation: Partial<Annotation> & {
+    comment?: string;
+}, projectContext?: ProjectContext, options?: {
+    fastMode?: boolean;
+    visionDescription?: string;
+}): string;
+/**
+ * Spawn Gemini CLI and return an async iterator of events
+ */
+declare function spawnGeminiCLI(prompt: string, options?: GeminiCLIOptions): {
+    process: ChildProcess;
+    events: AsyncIterable<GeminiCLIEvent>;
+};
+/**
+ * Create a streaming response for use in API routes (Next.js, Express, etc.)
+ */
+declare function createGeminiCLIStream(annotation: Partial<Annotation> & {
+    comment?: string;
+}, projectContext?: ProjectContext, options?: GeminiCLIOptions): ReadableStream<Uint8Array>;
+/**
+ * Run Gemini CLI and wait for completion
+ */
+declare function runGeminiCLI(annotation: Partial<Annotation> & {
+    comment?: string;
+}, projectContext?: ProjectContext, options?: GeminiCLIOptions): Promise<{
+    success: boolean;
+    response: string;
+    events: GeminiCLIEvent[];
+}>;
+/**
+ * Next.js App Router POST handler for Gemini CLI
+ *
+ * Usage in your app/api/gemini/route.ts:
+ * ```typescript
+ * export { POST, DELETE } from 'skema-core/server';
+ * ```
+ *
+ * Or with custom options:
+ * ```typescript
+ * import { createGeminiRouteHandler, createRevertRouteHandler } from 'skema-core/server';
+ * export const POST = createGeminiRouteHandler({ cwd: '/custom/path' });
+ * export const DELETE = createRevertRouteHandler({ cwd: '/custom/path' });
+ * ```
+ */
+declare function createGeminiRouteHandler(defaultOptions?: GeminiCLIOptions): (request: Request) => Promise<Response>;
+/**
+ * Next.js App Router DELETE handler for reverting Gemini changes
+ */
+declare function createRevertRouteHandler(defaultOptions?: {
+    cwd?: string;
+}): (request: Request) => Promise<Response>;
+/**
+ * Default POST handler - ready to use in Next.js App Router
+ *
+ * Usage:
+ * ```typescript
+ * // app/api/gemini/route.ts
+ * export { POST, DELETE } from 'skema-core/server';
+ * ```
+ */
+declare const POST: (request: Request) => Promise<Response>;
+declare const DELETE: (request: Request) => Promise<Response>;
+
+export { DELETE, type GeminiCLIEvent, type GeminiCLIOptions, POST, type ProjectContext, buildPromptFromAnnotation, createGeminiCLIStream, createGeminiRouteHandler, createRevertRouteHandler, getTrackedAnnotations, revertAnnotation, runGeminiCLI, spawnGeminiCLI };

package/dist/server.d.ts

@@ -0,0 +1,260 @@
+import { ChildProcess } from 'child_process';
+
+/**
+ * Represents a single DOM element in a selection
+ */
+interface DOMElement {
+    selector: string;
+    tagName: string;
+    elementPath: string;
+    text: string;
+    boundingBox: BoundingBox;
+    cssClasses?: string;
+    attributes?: Record<string, string>;
+}
+/**
+ * Represents a DOM element selection (can contain one or more elements)
+ */
+interface DOMSelection {
+    id: string;
+    selector: string;
+    tagName: string;
+    elementPath: string;
+    text: string;
+    boundingBox: BoundingBox;
+    timestamp: number;
+    pathname: string;
+    cssClasses?: string;
+    attributes?: Record<string, string>;
+    /** User annotation comment */
+    comment?: string;
+    /** Whether this is a multi-element selection */
+    isMultiSelect?: boolean;
+    /** Individual elements when this is a grouped selection */
+    elements?: DOMElement[];
+}
+/**
+ * Bounding box for element positioning
+ */
+interface BoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * Viewport information for coordinate calculations
+ */
+interface ViewportInfo {
+    width: number;
+    height: number;
+    scrollX: number;
+    scrollY: number;
+}
+/**
+ * Computed styles for an element
+ */
+interface ElementStyles {
+    fontFamily?: string;
+    fontSize?: string;
+    fontWeight?: string;
+    lineHeight?: string;
+    letterSpacing?: string;
+    textAlign?: string;
+    color?: string;
+    padding?: string;
+    margin?: string;
+    gap?: string;
+    display?: string;
+    flexDirection?: string;
+    alignItems?: string;
+    justifyContent?: string;
+    backgroundColor?: string;
+    borderRadius?: string;
+    border?: string;
+    boxShadow?: string;
+    width?: string;
+    height?: string;
+    maxWidth?: string;
+}
+/**
+ * Nearby element with style context for AI
+ */
+interface NearbyElement {
+    selector: string;
+    tagName: string;
+    text?: string;
+    className?: string;
+    styles?: ElementStyles;
+    tailwindClasses?: string[];
+}
+/**
+ * Project-level style context
+ */
+interface ProjectStyleContext {
+    cssFramework?: 'tailwind' | 'bootstrap' | 'material-ui' | 'chakra' | 'vanilla' | 'css-modules' | 'styled-components' | 'unknown';
+    cssVariables?: Record<string, string>;
+    colorPalette?: string[];
+    baseFontFamily?: string;
+    baseFontSize?: string;
+}
+/**
+ * Drawing annotation from tldraw
+ */
+interface DrawingAnnotation {
+    id: string;
+    type: 'drawing';
+    tool: string;
+    shapes: unknown[];
+    boundingBox: BoundingBox;
+    relatedTo?: string;
+    timestamp: number;
+    /** User annotation comment describing what to build */
+    comment?: string;
+    /** SVG representation of the drawing for AI processing */
+    drawingSvg?: string;
+    /** Base64 PNG image of the drawing for vision AI */
+    drawingImage?: string;
+    /** Extracted text content from text shapes in the drawing */
+    extractedText?: string;
+    /** Grid configuration used for positioning reference */
+    gridConfig?: {
+        color: string;
+        size: number;
+        labels: boolean;
+    };
+    /** Viewport info for relative sizing context */
+    viewport?: ViewportInfo;
+    /** Project-level style context */
+    projectStyles?: ProjectStyleContext;
+    /** Nearby DOM elements that the drawing may relate to */
+    nearbyElements?: NearbyElement[];
+}
+/**
+ * Gesture action annotation
+ */
+interface GestureAnnotation {
+    id: string;
+    type: 'gesture';
+    gesture: 'scribble_delete' | 'circle' | 'rectangle' | 'arrow';
+    target?: string;
+    boundingBox: BoundingBox;
+    timestamp: number;
+}
+/**
+ * Union type for all annotation types
+ */
+type Annotation = {
+    type: 'dom_selection';
+} & DOMSelection | DrawingAnnotation | GestureAnnotation;
+
+/**
+ * Revert changes for an annotation by restoring from snapshot
+ */
+declare function revertAnnotation(annotationId: string, cwd?: string): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Get all tracked annotation IDs
+ */
+declare function getTrackedAnnotations(): string[];
+interface GeminiCLIOptions {
+    /** Working directory for Gemini CLI */
+    cwd?: string;
+    /** API key (defaults to GEMINI_API_KEY env var) */
+    apiKey?: string;
+    /** Auto-approve all tool calls (default: true) */
+    yolo?: boolean;
+    /** Output format (default: 'stream-json') */
+    outputFormat?: 'text' | 'json' | 'stream-json';
+    /** Model to use (default: 'gemini-2.5-flash' for speed) */
+    model?: string;
+    /** Use minimal/fast prompt (default: true) */
+    fastMode?: boolean;
+}
+interface ProjectContext {
+    pathname?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+}
+interface GeminiCLIEvent {
+    type: 'init' | 'message' | 'tool_use' | 'tool_result' | 'error' | 'result' | 'done' | 'debug';
+    timestamp?: string;
+    content?: string;
+    role?: 'user' | 'assistant';
+    tool_name?: string;
+    tool_id?: string;
+    status?: 'success' | 'error';
+    code?: number;
+    [key: string]: unknown;
+}
+/**
+ * Build a prompt for Gemini CLI from an annotation
+ */
+declare function buildPromptFromAnnotation(annotation: Partial<Annotation> & {
+    comment?: string;
+}, projectContext?: ProjectContext, options?: {
+    fastMode?: boolean;
+    visionDescription?: string;
+}): string;
+/**
+ * Spawn Gemini CLI and return an async iterator of events
+ */
+declare function spawnGeminiCLI(prompt: string, options?: GeminiCLIOptions): {
+    process: ChildProcess;
+    events: AsyncIterable<GeminiCLIEvent>;
+};
+/**
+ * Create a streaming response for use in API routes (Next.js, Express, etc.)
+ */
+declare function createGeminiCLIStream(annotation: Partial<Annotation> & {
+    comment?: string;
+}, projectContext?: ProjectContext, options?: GeminiCLIOptions): ReadableStream<Uint8Array>;
+/**
+ * Run Gemini CLI and wait for completion
+ */
+declare function runGeminiCLI(annotation: Partial<Annotation> & {
+    comment?: string;
+}, projectContext?: ProjectContext, options?: GeminiCLIOptions): Promise<{
+    success: boolean;
+    response: string;
+    events: GeminiCLIEvent[];
+}>;
+/**
+ * Next.js App Router POST handler for Gemini CLI
+ *
+ * Usage in your app/api/gemini/route.ts:
+ * ```typescript
+ * export { POST, DELETE } from 'skema-core/server';
+ * ```
+ *
+ * Or with custom options:
+ * ```typescript
+ * import { createGeminiRouteHandler, createRevertRouteHandler } from 'skema-core/server';
+ * export const POST = createGeminiRouteHandler({ cwd: '/custom/path' });
+ * export const DELETE = createRevertRouteHandler({ cwd: '/custom/path' });
+ * ```
+ */
+declare function createGeminiRouteHandler(defaultOptions?: GeminiCLIOptions): (request: Request) => Promise<Response>;
+/**
+ * Next.js App Router DELETE handler for reverting Gemini changes
+ */
+declare function createRevertRouteHandler(defaultOptions?: {
+    cwd?: string;
+}): (request: Request) => Promise<Response>;
+/**
+ * Default POST handler - ready to use in Next.js App Router
+ *
+ * Usage:
+ * ```typescript
+ * // app/api/gemini/route.ts
+ * export { POST, DELETE } from 'skema-core/server';
+ * ```
+ */
+declare const POST: (request: Request) => Promise<Response>;
+declare const DELETE: (request: Request) => Promise<Response>;
+
+export { DELETE, type GeminiCLIEvent, type GeminiCLIOptions, POST, type ProjectContext, buildPromptFromAnnotation, createGeminiCLIStream, createGeminiRouteHandler, createRevertRouteHandler, getTrackedAnnotations, revertAnnotation, runGeminiCLI, spawnGeminiCLI };