@nocturnium/svelte-ide 1.0.0-rc.1

package/dist/types/agents.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Agent-related type definitions
+ * For multi-agent coordination and presence/visibility in the editor
+ */
+import type { CursorPosition } from './editor';
+export type AgentStatus = 'online' | 'offline' | 'busy' | 'error' | 'stalled';
+export type AgentType = 'coder' | 'reviewer' | 'tester' | 'architect' | 'coordinator';
+export interface Agent {
+    id: string;
+    name: string;
+    type: AgentType;
+    status: AgentStatus;
+    capabilities: AgentCapability[];
+    currentTask?: AgentTask;
+    workspaceId: string;
+    joinedAt: string;
+    lastActivity: string;
+    avatar?: string;
+    color?: string;
+}
+export type AgentCapability = 'code_generation' | 'code_review' | 'testing' | 'refactoring' | 'documentation' | 'architecture' | 'debugging';
+export interface AgentTask {
+    id: string;
+    description: string;
+    startedAt: string;
+    estimatedDuration?: number;
+    progress: AgentProgress;
+    files: string[];
+}
+export interface AgentProgress {
+    phase: 'planning' | 'implementing' | 'testing' | 'reviewing' | 'complete';
+    percentage: number;
+    tokensUsed: number;
+    stepsCompleted: number;
+    totalSteps?: number;
+    toolCalls: number;
+    filesModified: number;
+    lastUpdate: string;
+}
+export type TeamEvent = WorkStartedEvent | FileModifiedEvent | AgentJoinedEvent | AgentLeftEvent | AgentBlockedEvent | AgentConflictEvent | TaskCompletedEvent | ProgressUpdateEvent;
+export interface BaseTeamEvent {
+    id: string;
+    timestamp: string;
+    workspaceId: string;
+    agentId: string;
+    agent: Agent;
+}
+export interface WorkStartedEvent extends BaseTeamEvent {
+    type: 'work_started';
+    task: AgentTask;
+}
+export interface FileModifiedEvent extends BaseTeamEvent {
+    type: 'file_modified';
+    path: string;
+    operation: 'create' | 'update' | 'delete' | 'rename';
+    lockAcquired: boolean;
+    linesAdded?: number;
+    linesRemoved?: number;
+}
+export interface AgentJoinedEvent extends BaseTeamEvent {
+    type: 'agent_joined';
+}
+export interface AgentLeftEvent extends BaseTeamEvent {
+    type: 'agent_left';
+    reason?: string;
+}
+export interface AgentBlockedEvent extends BaseTeamEvent {
+    type: 'blocked';
+    reason: string;
+    blockedBy?: string;
+    blockedFiles: string[];
+}
+export interface AgentConflictEvent extends BaseTeamEvent {
+    type: 'conflict';
+    path: string;
+    conflictWith: string;
+    resolution: 'pending' | 'resolved' | 'escalated';
+}
+export interface TaskCompletedEvent extends BaseTeamEvent {
+    type: 'task_completed';
+    task: AgentTask;
+    result: 'success' | 'failure' | 'partial';
+    summary: string;
+}
+export interface ProgressUpdateEvent extends BaseTeamEvent {
+    type: 'progress_update';
+    progress: AgentProgress;
+}
+export type ActivityType = 'message' | 'action' | 'error' | 'milestone' | 'system';
+export type ActivitySeverity = 'info' | 'warning' | 'error' | 'success';
+export interface AgentActivity {
+    id: string;
+    agentId: string;
+    agent: Agent;
+    timestamp: string;
+    type: ActivityType;
+    content: string;
+    metadata?: ActivityMetadata;
+}
+export interface ActivityMetadata {
+    files?: string[];
+    duration?: number;
+    severity?: ActivitySeverity;
+    actionable?: boolean;
+    actionLabel?: string;
+    actionCallback?: () => void;
+}
+export interface AgentCursor {
+    agentId: string;
+    agent: Agent;
+    filePath: string;
+    position: CursorPosition;
+    selection?: CursorSelection;
+    lastUpdate: string;
+}
+export interface CursorSelection {
+    start: CursorPosition;
+    end: CursorPosition;
+}
+export type AgentFilter = AgentStatus | 'all';
+export type AgentViewMode = 'grid' | 'list' | 'compact';
+export interface AgentFilterOptions {
+    status?: AgentFilter;
+    type?: AgentType | 'all';
+    hasTask?: boolean;
+    workingOnFile?: string;
+}

package/dist/types/agents.js

@@ -0,0 +1,5 @@
+/**
+ * Agent-related type definitions
+ * For multi-agent coordination and presence/visibility in the editor
+ */
+export {};

package/dist/types/ai.d.ts

@@ -0,0 +1,137 @@
+/**
+ * AI Assistant type definitions
+ */
+export type AIRole = 'user' | 'assistant' | 'system' | 'tool';
+export interface AIMessage {
+    id: string;
+    role: AIRole;
+    content: string;
+    timestamp: Date;
+    /** Tool calls made by the assistant */
+    toolCalls?: AIToolCall[];
+    /** Result from a tool execution */
+    toolResult?: AIToolResult;
+    /** Streaming state */
+    isStreaming?: boolean;
+    /** Error if message failed */
+    error?: string;
+    /** Metadata like tokens used */
+    metadata?: AIMessageMetadata;
+}
+export interface AIToolCall {
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+}
+export interface AIToolResult {
+    toolCallId: string;
+    result: unknown;
+    error?: string;
+}
+export interface AIMessageMetadata {
+    model?: string;
+    tokensUsed?: number;
+    latencyMs?: number;
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'error';
+}
+export interface AIConversation {
+    id: string;
+    title: string;
+    messages: AIMessage[];
+    createdAt: Date;
+    updatedAt: Date;
+    /** Context attached to this conversation */
+    context?: AIContext;
+}
+export interface AIContext {
+    /** Currently open files */
+    openFiles?: string[];
+    /** Selected text from editor */
+    selection?: {
+        path: string;
+        content: string;
+        startLine: number;
+        endLine: number;
+    };
+    /** Workspace metadata */
+    workspace?: {
+        id: string;
+        name: string;
+        rootPath: string;
+    };
+    /** Custom context from plugins */
+    custom?: Record<string, unknown>;
+}
+/**
+ * AI Tool definition for registration
+ */
+export interface AITool {
+    name: string;
+    description: string;
+    parameters: AIToolParameters;
+    handler: AIToolHandler;
+}
+export interface AIToolParameters {
+    type: 'object';
+    properties: Record<string, AIToolProperty>;
+    required?: string[];
+}
+export interface AIToolProperty {
+    type: 'string' | 'number' | 'boolean' | 'array' | 'object';
+    description?: string;
+    enum?: string[];
+    items?: AIToolProperty;
+    properties?: Record<string, AIToolProperty>;
+}
+export type AIToolHandler = (args: Record<string, unknown>, context: AIContext) => Promise<unknown>;
+/**
+ * AI Panel configuration
+ */
+export interface AIPanelConfig {
+    /** API endpoint for chat */
+    endpoint?: string;
+    /** Model to use */
+    model?: string;
+    /** System prompt */
+    systemPrompt?: string;
+    /** Available tools */
+    tools?: AITool[];
+    /** Max tokens for response */
+    maxTokens?: number;
+    /** Temperature for response */
+    temperature?: number;
+    /** Enable streaming responses */
+    streaming?: boolean;
+    /** Custom headers for API requests */
+    headers?: Record<string, string>;
+}
+/**
+ * AI Suggestion for code completion or inline hints
+ */
+export interface AISuggestion {
+    id: string;
+    type: 'completion' | 'refactor' | 'fix' | 'explain';
+    content: string;
+    description?: string;
+    range?: {
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    };
+    confidence?: number;
+}
+/**
+ * AI editing session for collaborative editing
+ */
+export interface AIEditSession {
+    id: string;
+    conversationId: string;
+    filePath: string;
+    status: 'pending' | 'editing' | 'reviewing' | 'applied' | 'rejected';
+    originalContent: string;
+    proposedContent?: string;
+    diff?: string;
+    startedAt: Date;
+    completedAt?: Date;
+}

package/dist/types/ai.js

@@ -0,0 +1,4 @@
+/**
+ * AI Assistant type definitions
+ */
+export {};

package/dist/types/crdt.d.ts

@@ -0,0 +1,222 @@
+/**
+ * CRDT (Conflict-free Replicated Data Types) type definitions
+ * for collaborative editing with users and AI
+ */
+export interface CollaborationConfig {
+    /** WebSocket server URL for Yjs sync */
+    serverUrl: string;
+    /** Room/document identifier */
+    roomId: string;
+    /** Current user information */
+    user: CollaborationUser;
+    /** Enable awareness (cursors, selections) */
+    awareness?: boolean;
+    /** Reconnection settings */
+    reconnect?: {
+        maxRetries: number;
+        baseDelay: number;
+        maxDelay: number;
+    };
+}
+export interface CollaborationUser {
+    id: string;
+    name: string;
+    color: string;
+    /** Whether this is an AI participant */
+    isAI?: boolean;
+    /** Avatar URL or initials */
+    avatar?: string;
+}
+export interface CollaborationState {
+    /** Connection status */
+    status: 'connecting' | 'connected' | 'disconnected' | 'error';
+    /** Error message if status is 'error' */
+    error?: string;
+    /** Connected users in the room */
+    users: CollaborationUser[];
+    /** Synced document state */
+    synced: boolean;
+    /** Pending local changes */
+    pendingChanges: number;
+}
+export interface CollaboratorCursor {
+    userId: string;
+    user: CollaborationUser;
+    position: {
+        line: number;
+        column: number;
+    };
+    selection?: {
+        anchor: {
+            line: number;
+            column: number;
+        };
+        head: {
+            line: number;
+            column: number;
+        };
+    };
+    lastActivity: Date;
+}
+export interface CollaboratorAwareness {
+    userId: string;
+    user: CollaborationUser;
+    cursor?: CollaboratorCursor['position'];
+    selection?: CollaboratorCursor['selection'];
+    /** Currently viewing file */
+    viewingFile?: string;
+    /** Currently editing file */
+    editingFile?: string;
+    /** Idle/active state */
+    state: 'active' | 'idle' | 'away';
+}
+/**
+ * Document operation for CRDT sync
+ */
+export interface DocumentOperation {
+    type: 'insert' | 'delete' | 'retain';
+    position?: number;
+    content?: string;
+    length?: number;
+    attributes?: Record<string, unknown>;
+}
+/**
+ * Snapshot of document state at a point in time
+ */
+export interface DocumentSnapshot {
+    id: string;
+    documentId: string;
+    content: string;
+    version: number;
+    createdAt: Date;
+    createdBy: CollaborationUser;
+    /** Reason for snapshot */
+    reason?: 'manual' | 'auto' | 'ai_edit' | 'checkpoint';
+}
+/**
+ * AI collaboration session
+ */
+export interface AICollaborationSession {
+    id: string;
+    documentId: string;
+    status: 'pending' | 'active' | 'paused' | 'completed' | 'cancelled';
+    /** AI user participating in this session */
+    aiUser: CollaborationUser;
+    /** Human users in the session */
+    humanUsers: CollaborationUser[];
+    /** What the AI is currently doing */
+    currentTask?: string;
+    /** Proposed changes waiting for approval */
+    pendingChanges?: AIProposedChange[];
+    startedAt: Date;
+    updatedAt: Date;
+}
+export interface AIProposedChange {
+    id: string;
+    sessionId: string;
+    type: 'insert' | 'delete' | 'replace';
+    range: {
+        startLine: number;
+        startColumn: number;
+        endLine: number;
+        endColumn: number;
+    };
+    originalContent: string;
+    proposedContent: string;
+    explanation?: string;
+    status: 'pending' | 'approved' | 'rejected' | 'modified';
+    reviewedBy?: string;
+    reviewedAt?: Date;
+}
+/**
+ * Conflict resolution strategy
+ */
+export type ConflictResolution = 'last_write_wins' | 'first_write_wins' | 'manual' | 'ai_assisted';
+/**
+ * Undo/Redo manager for CRDT
+ */
+export interface UndoManager {
+    canUndo: boolean;
+    canRedo: boolean;
+    undoStack: UndoItem[];
+    redoStack: UndoItem[];
+}
+export interface UndoItem {
+    id: string;
+    operations: DocumentOperation[];
+    userId: string;
+    timestamp: Date;
+    description?: string;
+}
+/**
+ * Presence information for real-time collaboration
+ */
+export interface PresenceState {
+    [clientId: string]: CollaboratorAwareness;
+}
+/**
+ * Events emitted by the collaboration system
+ */
+export type CollaborationEvent = {
+    type: 'connected';
+    users: CollaborationUser[];
+} | {
+    type: 'disconnected';
+    reason?: string;
+} | {
+    type: 'user_joined';
+    user: CollaborationUser;
+} | {
+    type: 'user_left';
+    userId: string;
+} | {
+    type: 'cursor_moved';
+    cursor: CollaboratorCursor;
+} | {
+    type: 'selection_changed';
+    userId: string;
+    selection: CollaboratorCursor['selection'];
+} | {
+    type: 'document_changed';
+    operations: DocumentOperation[];
+    origin: string;
+} | {
+    type: 'sync_complete';
+    version: number;
+} | {
+    type: 'conflict';
+    operations: DocumentOperation[];
+    resolution: ConflictResolution;
+} | {
+    type: 'ai_edit_started';
+    session: AICollaborationSession;
+} | {
+    type: 'ai_edit_proposed';
+    change: AIProposedChange;
+} | {
+    type: 'ai_edit_completed';
+    sessionId: string;
+} | {
+    type: 'snapshot_created';
+    snapshot: DocumentSnapshot;
+};
+export type CollaborationEventHandler = (event: CollaborationEvent) => void;
+/**
+ * Options for Yjs document initialization
+ */
+export interface YjsDocumentOptions {
+    /** Document ID for multi-document support */
+    documentId: string;
+    /** Initial content if document is new */
+    initialContent?: string;
+    /** Enable undo manager */
+    undoManager?: boolean;
+    /** Capture timeout for undo grouping (ms) */
+    undoCaptureTimeout?: number;
+    /** Enable persistence */
+    persistence?: {
+        enabled: boolean;
+        /** IndexedDB database name */
+        dbName?: string;
+    };
+}

package/dist/types/crdt.js

@@ -0,0 +1,5 @@
+/**
+ * CRDT (Conflict-free Replicated Data Types) type definitions
+ * for collaborative editing with users and AI
+ */
+export {};

package/dist/types/editor.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Editor-related type definitions
+ */
+export interface EditorTab {
+    id: string;
+    path: string;
+    name: string;
+    content: string;
+    language: string;
+    isDirty: boolean;
+    cursorPosition?: CursorPosition;
+    scrollPosition?: ScrollPosition;
+    /** Indicates if this tab is being edited by AI */
+    aiEditing?: boolean;
+    /** Version for CRDT conflict resolution */
+    version?: number;
+}
+export interface CursorPosition {
+    line: number;
+    column: number;
+}
+export interface ScrollPosition {
+    top: number;
+    left: number;
+}
+export interface EditorPreferences {
+    fontSize: number;
+    fontFamily: string;
+    tabSize: number;
+    insertSpaces: boolean;
+    wordWrap: 'off' | 'on' | 'wordWrapColumn';
+    wordWrapColumn: number;
+    lineNumbers: 'on' | 'off' | 'relative';
+    minimap: boolean;
+    bracketMatching: boolean;
+    autoCloseBrackets: boolean;
+    highlightActiveLine: boolean;
+    renderWhitespace: 'none' | 'boundary' | 'all';
+    theme: string;
+}
+export type SplitMode = 'none' | 'horizontal' | 'vertical';
+export interface EditorSelection {
+    anchor: CursorPosition;
+    head: CursorPosition;
+}
+export interface EditorViewState {
+    cursorPosition: CursorPosition;
+    scrollPosition: ScrollPosition;
+    selections: EditorSelection[];
+    foldedRanges: number[];
+}
+export declare const DEFAULT_EDITOR_PREFERENCES: EditorPreferences;

package/dist/types/editor.js

@@ -0,0 +1,18 @@
+/**
+ * Editor-related type definitions
+ */
+export const DEFAULT_EDITOR_PREFERENCES = {
+    fontSize: 14,
+    fontFamily: 'JetBrains Mono',
+    tabSize: 2,
+    insertSpaces: false,
+    wordWrap: 'off',
+    wordWrapColumn: 80,
+    lineNumbers: 'on',
+    minimap: false,
+    bracketMatching: true,
+    autoCloseBrackets: true,
+    highlightActiveLine: true,
+    renderWhitespace: 'none',
+    theme: 'nocturnium'
+};

package/dist/types/events.d.ts

@@ -0,0 +1,133 @@
+/**
+ * IDE Event system type definitions
+ */
+export interface IDEEvent<T = unknown> {
+    type: IDEEventType;
+    payload: T;
+    timestamp: number;
+    source?: string;
+}
+export type IDEEventType = 'file:open' | 'file:close' | 'file:save' | 'file:create' | 'file:delete' | 'file:rename' | 'file:move' | 'editor:change' | 'editor:cursor' | 'editor:selection' | 'editor:focus' | 'editor:blur' | 'editor:scroll' | 'tab:open' | 'tab:close' | 'tab:switch' | 'tab:reorder' | 'search:query' | 'search:result' | 'search:navigate' | 'command:execute' | 'command:register' | 'command:unregister' | 'panel:toggle' | 'panel:resize' | 'panel:focus' | 'layout:change' | 'layout:reset' | 'ai:message' | 'ai:tool_call' | 'ai:edit_start' | 'ai:edit_complete' | 'ai:suggestion' | 'collab:connect' | 'collab:disconnect' | 'collab:user_join' | 'collab:user_leave' | 'collab:cursor' | 'collab:sync' | 'plugin:load' | 'plugin:unload' | 'plugin:error' | 'plugin:message';
+export interface IDEAction {
+    id: string;
+    label: string;
+    description?: string;
+    icon?: string;
+    keybinding?: string[];
+    when?: string;
+    handler: () => void | Promise<void>;
+}
+export interface IDECommand extends IDEAction {
+    category?: string;
+}
+export interface IDEKeybinding {
+    keys: string[];
+    command: string;
+    when?: string;
+    args?: Record<string, unknown>;
+}
+/**
+ * Event bus for IDE-wide communication
+ */
+export interface EventBus {
+    emit<T>(type: IDEEventType, payload: T): void;
+    on<T>(type: IDEEventType, handler: (event: IDEEvent<T>) => void): () => void;
+    once<T>(type: IDEEventType, handler: (event: IDEEvent<T>) => void): () => void;
+    off(type: IDEEventType, handler: (event: IDEEvent) => void): void;
+}
+/**
+ * File event payloads
+ */
+export interface FileOpenPayload {
+    path: string;
+    content?: string;
+    language?: string;
+}
+export interface FileClosePayload {
+    path: string;
+    saved: boolean;
+}
+export interface FileSavePayload {
+    path: string;
+    content: string;
+}
+export interface FileCreatePayload {
+    path: string;
+    isDirectory: boolean;
+    content?: string;
+}
+export interface FileDeletePayload {
+    path: string;
+    isDirectory: boolean;
+}
+export interface FileRenamePayload {
+    oldPath: string;
+    newPath: string;
+}
+/**
+ * Editor event payloads
+ */
+export interface EditorChangePayload {
+    path: string;
+    content: string;
+    changes: {
+        from: number;
+        to: number;
+        insert: string;
+    }[];
+}
+export interface EditorCursorPayload {
+    path: string;
+    line: number;
+    column: number;
+}
+export interface EditorSelectionPayload {
+    path: string;
+    selections: {
+        anchor: {
+            line: number;
+            column: number;
+        };
+        head: {
+            line: number;
+            column: number;
+        };
+    }[];
+}
+/**
+ * Command event payloads
+ */
+export interface CommandExecutePayload {
+    commandId: string;
+    args?: Record<string, unknown>;
+    source?: 'keybinding' | 'menu' | 'palette' | 'api';
+}
+/**
+ * AI event payloads
+ */
+export interface AIMessagePayload {
+    conversationId: string;
+    messageId: string;
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+}
+export interface AIEditPayload {
+    conversationId: string;
+    path: string;
+    type: 'start' | 'progress' | 'complete' | 'cancel';
+    content?: string;
+}
+/**
+ * Collaboration event payloads
+ */
+export interface CollabUserPayload {
+    userId: string;
+    userName: string;
+    isAI?: boolean;
+}
+export interface CollabCursorPayload {
+    userId: string;
+    path: string;
+    line: number;
+    column: number;
+}