@fresh-editor/fresh-editor 0.1.86 → 0.1.87

package/plugins/lib/finder.ts

@@ -61,7 +61,7 @@ export interface DisplayEntry {
 export interface SearchSource<T> {
   mode: "search";
   /** Function that returns a ProcessHandle or Promise of results */
-  search: (query: string) => ProcessHandle | Promise<T[]>;
+  search: (query: string) => ProcessHandle<SpawnResult> | Promise<T[]>;
   /** Debounce delay in ms (default: 150) */
   debounceMs?: number;
   /** Minimum query length to trigger search (default: 2) */
@@ -328,7 +328,7 @@ interface PromptState<T> {
   entries: DisplayEntry[];
   lastQuery: string;
   searchVersion: number;
-  currentSearch: ProcessHandle | null;
+  currentSearch: ProcessHandle<SpawnResult> | null;
   pendingKill: Promise<boolean> | null;
   originalSplitId: number | null;
 }
@@ -927,17 +927,17 @@ export class Finder<T> {
         const result = await this.editor.createVirtualBufferInSplit({
           name: "*Preview*",
           mode: this.previewModeName,
-          read_only: true,
+          readOnly: true,
           entries,
           ratio: 0.5,
           direction: "vertical",
-          panel_id: `${this.config.id}-preview`,
-          show_line_numbers: false,
-          editing_disabled: true,
+          panelId: `${this.config.id}-preview`,
+          showLineNumbers: false,
+          editingDisabled: true,
         });
 
-        this.previewState.bufferId = result.buffer_id;
-        this.previewState.splitId = result.split_id ?? null;
+        this.previewState.bufferId = result.bufferId;
+        this.previewState.splitId = result.splitId ?? null;
 
         // Return focus to original split
         if (this.promptState.originalSplitId !== null) {
@@ -1066,19 +1066,19 @@ export class Finder<T> {
       const result = await this.editor.createVirtualBufferInSplit({
         name: `*${this.config.id.charAt(0).toUpperCase() + this.config.id.slice(1)}*`,
         mode: this.modeName,
-        read_only: true,
+        readOnly: true,
         entries,
         ratio,
         direction: "horizontal",
-        panel_id: this.config.id,
-        show_line_numbers: false,
-        show_cursors: true,
-        editing_disabled: true,
+        panelId: this.config.id,
+        showLineNumbers: false,
+        showCursors: true,
+        editingDisabled: true,
       });
 
-      if (result.buffer_id !== null) {
-        this.panelState.bufferId = result.buffer_id;
-        this.panelState.splitId = result.split_id ?? null;
+      if (result.bufferId !== null) {
+        this.panelState.bufferId = result.bufferId;
+        this.panelState.splitId = result.splitId ?? null;
         this.applyPanelHighlighting();
 
         const count = this.panelState.items.length;
@@ -1343,12 +1343,12 @@ export class Finder<T> {
           colors.selected[0],
           colors.selected[1],
           colors.selected[2],
-          -1,
-          -1,
-          -1,
           false,
-          true,
           false,
+          false,
+          undefined,
+          undefined,
+          undefined,
           true
         );
       }
@@ -1363,12 +1363,12 @@ export class Finder<T> {
           colors.title[0],
           colors.title[1],
           colors.title[2],
-          -1,
-          -1,
-          -1,
           false,
           true,
           false,
+          undefined,
+          undefined,
+          undefined,
           false
         );
       }
@@ -1383,12 +1383,12 @@ export class Finder<T> {
           colors.fileHeader[0],
           colors.fileHeader[1],
           colors.fileHeader[2],
-          -1,
-          -1,
-          -1,
           false,
           true,
           false,
+          undefined,
+          undefined,
+          undefined,
           false
         );
       }
@@ -1423,12 +1423,12 @@ export class Finder<T> {
           color[0],
           color[1],
           color[2],
-          -1,
-          -1,
-          -1,
           false,
           true,
           false,
+          undefined,
+          undefined,
+          undefined,
           false
         );
       }
@@ -1443,12 +1443,12 @@ export class Finder<T> {
           colors.help[0],
           colors.help[1],
           colors.help[2],
-          -1,
-          -1,
-          -1,
           false,
           false,
           false,
+          undefined,
+          undefined,
+          undefined,
           false
         );
       }

package/plugins/lib/fresh.d.ts

@@ -37,6 +37,318 @@ type TextPropertyEntry = {
 	*/
 	properties?: Record<string, unknown>;
 };
+type TsCompositeLayoutConfig = {
+	/**
+	* Layout type: "side-by-side", "stacked", or "unified"
+	*/
+	type: string;
+	/**
+	* Width ratios for side-by-side (e.g., [0.5, 0.5])
+	*/
+	ratios: Array<number> | null;
+	/**
+	* Show separator between panes
+	*/
+	showSeparator: boolean;
+	/**
+	* Spacing for stacked layout
+	*/
+	spacing: number | null;
+};
+type TsCompositeSourceConfig = {
+	/**
+	* Buffer ID of the source buffer (required)
+	*/
+	bufferId: number;
+	/**
+	* Label for this pane (e.g., "OLD", "NEW")
+	*/
+	label: string;
+	/**
+	* Whether this pane is editable
+	*/
+	editable: boolean;
+	/**
+	* Style configuration
+	*/
+	style: TsCompositePaneStyle | null;
+};
+type TsCompositePaneStyle = {
+	/**
+	* Background color for added lines (RGB)
+	* Using [u8; 3] instead of (u8, u8, u8) for better rquickjs_serde compatibility
+	*/
+	addBg: [number, number, number] | null;
+	/**
+	* Background color for removed lines (RGB)
+	*/
+	removeBg: [number, number, number] | null;
+	/**
+	* Background color for modified lines (RGB)
+	*/
+	modifyBg: [number, number, number] | null;
+	/**
+	* Gutter style: "line-numbers", "diff-markers", "both", or "none"
+	*/
+	gutterStyle: string | null;
+};
+type TsCompositeHunk = {
+	/**
+	* Starting line in old buffer (0-indexed)
+	*/
+	oldStart: number;
+	/**
+	* Number of lines in old buffer
+	*/
+	oldCount: number;
+	/**
+	* Starting line in new buffer (0-indexed)
+	*/
+	newStart: number;
+	/**
+	* Number of lines in new buffer
+	*/
+	newCount: number;
+};
+type TsCreateCompositeBufferOptions = {
+	/**
+	* Buffer name (displayed in tabs/title)
+	*/
+	name: string;
+	/**
+	* Mode for keybindings
+	*/
+	mode: string;
+	/**
+	* Layout configuration
+	*/
+	layout: TsCompositeLayoutConfig;
+	/**
+	* Source pane configurations
+	*/
+	sources: Array<TsCompositeSourceConfig>;
+	/**
+	* Diff hunks for alignment (optional)
+	*/
+	hunks: Array<TsCompositeHunk> | null;
+};
+type ViewportInfo = {
+	/**
+	* Byte position of the first visible line
+	*/
+	topByte: number;
+	/**
+	* Left column offset (horizontal scroll)
+	*/
+	leftColumn: number;
+	/**
+	* Viewport width
+	*/
+	width: number;
+	/**
+	* Viewport height
+	*/
+	height: number;
+};
+type LayoutHints = {
+	/**
+	* Optional compose width for centering/wrapping
+	*/
+	composeWidth: number | null;
+	/**
+	* Optional column guides for aligned tables
+	*/
+	columnGuides: Array<number> | null;
+};
+type ViewTokenWire = {
+	/**
+	* Source byte offset in the buffer. None for injected content (annotations).
+	*/
+	source_offset: number | null;
+	/**
+	* The token content
+	*/
+	kind: ViewTokenWireKind;
+	/**
+	* Optional styling for injected content (only used when source_offset is None)
+	*/
+	style?: ViewTokenStyle;
+};
+type ViewTokenWireKind = {
+	"Text": string;
+} | "Newline" | "Space" | "Break" | {
+	"BinaryByte": number;
+};
+type ViewTokenStyle = {
+	/**
+	* Foreground color as RGB tuple
+	*/
+	fg: [number, number, number] | null;
+	/**
+	* Background color as RGB tuple
+	*/
+	bg: [number, number, number] | null;
+	/**
+	* Whether to render in bold
+	*/
+	bold: boolean;
+	/**
+	* Whether to render in italic
+	*/
+	italic: boolean;
+};
+type PromptSuggestion = {
+	/**
+	* The text to display
+	*/
+	text: string;
+	/**
+	* Optional description
+	*/
+	description?: string;
+	/**
+	* The value to use when selected (defaults to text if None)
+	*/
+	value?: string;
+	/**
+	* Whether this suggestion is disabled (greyed out, defaults to false)
+	*/
+	disabled?: boolean;
+	/**
+	* Optional keyboard shortcut
+	*/
+	keybinding?: string;
+};
+type DirEntry = {
+	/**
+	* File/directory name
+	*/
+	name: string;
+	/**
+	* True if this is a file
+	*/
+	is_file: boolean;
+	/**
+	* True if this is a directory
+	*/
+	is_dir: boolean;
+};
+type BufferInfo = {
+	/**
+	* Buffer ID
+	*/
+	id: number;
+	/**
+	* File path (if any)
+	*/
+	path: string;
+	/**
+	* Whether the buffer has been modified
+	*/
+	modified: boolean;
+	/**
+	* Length of buffer in bytes
+	*/
+	length: number;
+};
+type JsDiagnostic = {
+	/**
+	* Document URI
+	*/
+	uri: string;
+	/**
+	* Diagnostic message
+	*/
+	message: string;
+	/**
+	* Severity: 1=Error, 2=Warning, 3=Info, 4=Hint, null=unknown
+	*/
+	severity: number | null;
+	/**
+	* Range in the document
+	*/
+	range: JsRange;
+	/**
+	* Source of the diagnostic (e.g., "typescript", "eslint")
+	*/
+	source?: string;
+};
+type JsRange = {
+	/**
+	* Start position
+	*/
+	start: JsPosition;
+	/**
+	* End position
+	*/
+	end: JsPosition;
+};
+type JsPosition = {
+	/**
+	* Zero-indexed line number
+	*/
+	line: number;
+	/**
+	* Zero-indexed character offset
+	*/
+	character: number;
+};
+type ActionSpec = {
+	/**
+	* Action name (e.g., "move_word_right", "delete_line")
+	*/
+	action: string;
+	/**
+	* Number of times to repeat the action (default 1)
+	*/
+	count: number;
+};
+type TsActionPopupAction = {
+	/**
+	* Unique action identifier (returned in ActionPopupResult)
+	*/
+	id: string;
+	/**
+	* Display text for the button (can include command hints)
+	*/
+	label: string;
+};
+type ActionPopupOptions = {
+	/**
+	* Unique identifier for the popup (used in ActionPopupResult)
+	*/
+	id: string;
+	/**
+	* Title text for the popup
+	*/
+	title: string;
+	/**
+	* Body message (supports basic formatting)
+	*/
+	message: string;
+	/**
+	* Action buttons to display
+	*/
+	actions: Array<TsActionPopupAction>;
+};
+type FileExplorerDecoration = {
+	/**
+	* File path to decorate
+	*/
+	path: string;
+	/**
+	* Symbol to display (e.g., "●", "M", "A")
+	*/
+	symbol: string;
+	/**
+	* Color as RGB array (rquickjs_serde requires array, not tuple)
+	*/
+	color: [number, number, number];
+	/**
+	* Priority for display when multiple decorations exist (higher wins)
+	*/
+	priority: number;
+};
 type BackgroundProcessResult = {
 	/**
 	* Unique process ID for later reference
@@ -53,6 +365,46 @@ type BufferSavedDiff = {
 	byte_ranges: Array<[number, number]>;
 	line_ranges: Array<[number, number]> | null;
 };
+type TsCompositeHunk = {
+	/**
+	* Starting line in old buffer (0-indexed)
+	*/
+	oldStart: number;
+	/**
+	* Number of lines in old buffer
+	*/
+	oldCount: number;
+	/**
+	* Starting line in new buffer (0-indexed)
+	*/
+	newStart: number;
+	/**
+	* Number of lines in new buffer
+	*/
+	newCount: number;
+};
+type TsCreateCompositeBufferOptions = {
+	/**
+	* Buffer name (displayed in tabs/title)
+	*/
+	name: string;
+	/**
+	* Mode for keybindings
+	*/
+	mode: string;
+	/**
+	* Layout configuration
+	*/
+	layout: TsCompositeLayoutConfig;
+	/**
+	* Source pane configurations
+	*/
+	sources: Array<TsCompositeSourceConfig>;
+	/**
+	* Diff hunks for alignment (optional)
+	*/
+	hunks: Array<TsCompositeHunk> | null;
+};
 type CreateVirtualBufferInExistingSplitOptions = {
 	/**
 	* Buffer name (displayed in tabs/title)
@@ -185,6 +537,28 @@ type SpawnResult = {
 	*/
 	exit_code: number;
 };
+type PromptSuggestion = {
+	/**
+	* The text to display
+	*/
+	text: string;
+	/**
+	* Optional description
+	*/
+	description?: string;
+	/**
+	* The value to use when selected (defaults to text if None)
+	*/
+	value?: string;
+	/**
+	* Whether this suggestion is disabled (greyed out, defaults to false)
+	*/
+	disabled?: boolean;
+	/**
+	* Optional keyboard shortcut
+	*/
+	keybinding?: string;
+};
 type TextPropertiesAtCursor = Array<Record<string, unknown>>;
 type TsHighlightSpan = {
 	start: number;
@@ -193,6 +567,16 @@ type TsHighlightSpan = {
 	bold: boolean;
 	italic: boolean;
 };
+type VirtualBufferResult = {
+	/**
+	* The created buffer ID
+	*/
+	bufferId: number;
+	/**
+	* The split ID (if created in a new split)
+	*/
+	splitId: number | null;
+};
 /**
 * Main editor API interface
 */
@@ -208,7 +592,7 @@ interface EditorAPI {
 	/**
 	* List all open buffers - returns array of BufferInfo objects
 	*/
-	listBuffers(): unknown;
+	listBuffers(): BufferInfo[];
 	debug(msg: string): void;
 	info(msg: string): void;
 	warn(msg: string): void;
@@ -262,7 +646,7 @@ interface EditorAPI {
 	/**
 	* Get buffer info by ID
 	*/
-	getBufferInfo(bufferId: number): unknown;
+	getBufferInfo(bufferId: number): BufferInfo | null;
 	/**
 	* Get primary cursor info for active buffer
 	*/
@@ -278,12 +662,17 @@ interface EditorAPI {
 	/**
 	* Get viewport info for active buffer
 	*/
-	getViewport(): unknown;
+	getViewport(): ViewportInfo | null;
 	/**
 	* Get the line number (0-indexed) of the primary cursor
 	*/
 	getCursorLine(): number;
 	/**
+	* Get the byte offset of the start of a line (0-indexed line number)
+	* Returns null if the line number is out of range
+	*/
+	getLineStartPosition(line: number): Promise<number | null>;
+	/**
 	* Find buffer by file path, returns buffer ID or 0 if not found
 	*/
 	findBufferByPath(path: string): number;
@@ -371,7 +760,7 @@ interface EditorAPI {
 	/**
 	* Read directory contents (returns array of {name, is_file, is_dir})
 	*/
-	readDir(path: string): unknown;
+	readDir(path: string): DirEntry[];
 	/**
 	* Get current config as JS object
 	*/
@@ -426,12 +815,17 @@ interface EditorAPI {
 	pluginTranslate(pluginName: string, key: string, args?: Record<string, unknown>): string;
 	/**
 	* Create a composite buffer (async)
+	* 
+	* Uses typed CreateCompositeBufferOptions - serde validates field names at runtime
+	* via `deny_unknown_fields` attribute
 	*/
-	createCompositeBuffer(opts: Record<string, unknown>): Promise<number>;
+	createCompositeBuffer(opts: CreateCompositeBufferOptions): Promise<number>;
 	/**
 	* Update alignment hunks for a composite buffer
+	* 
+	* Uses typed Vec<CompositeHunk> - serde validates field names at runtime
 	*/
-	updateCompositeAlignment(bufferId: number, hunks: Record<string, unknown>[]): boolean;
+	updateCompositeAlignment(bufferId: number, hunks: CompositeHunk[]): boolean;
 	/**
 	* Close a composite buffer
 	*/
@@ -462,6 +856,9 @@ interface EditorAPI {
 	removeOverlay(bufferId: number, handle: string): boolean;
 	/**
 	* Submit a view transform for a buffer/split
+	* 
+	* Note: tokens should be ViewTokenWire[], layoutHints should be LayoutHints
+	* These use manual parsing due to complex enum handling
 	*/
 	submitViewTransform(bufferId: number, splitId: number | null, start: number, end: number, tokens: Record<string, unknown>[], LayoutHints?: Record<string, unknown>): boolean;
 	/**
@@ -470,8 +867,10 @@ interface EditorAPI {
 	clearViewTransform(bufferId: number, splitId: number | null): boolean;
 	/**
 	* Set file explorer decorations for a namespace
+	* 
+	* Uses typed Vec<FileExplorerDecoration> - serde validates field names at runtime
 	*/
-	setFileExplorerDecorations(namespace: string, decorations: Record<string, unknown>[]): boolean;
+	setFileExplorerDecorations(namespace: string, decorations: FileExplorerDecoration[]): boolean;
 	/**
 	* Clear file explorer decorations for a namespace
 	*/
@@ -501,6 +900,11 @@ interface EditorAPI {
 	*/
 	addVirtualLine(bufferId: number, position: number, text: string, fgR: number, fgG: number, fgB: number, bgR: number, bgG: number, bgB: number, above: boolean, namespace: string, priority: number): boolean;
 	/**
+	* Show a prompt and wait for user input (async)
+	* Returns the user input or null if cancelled
+	*/
+	prompt(label: string, initialValue: string): Promise<string | null>;
+	/**
 	* Start an interactive prompt
 	*/
 	startPrompt(label: string, promptType: string): boolean;
@@ -509,9 +913,11 @@ interface EditorAPI {
 	*/
 	startPromptWithInitial(label: string, promptType: string, initialValue: string): boolean;
 	/**
-	* Set suggestions for the current prompt (takes array of suggestion objects)
+	* Set suggestions for the current prompt
+	* 
+	* Uses typed Vec<Suggestion> - serde validates field names at runtime
 	*/
-	setPromptSuggestions(suggestionsArr: Record<string, unknown>[]): boolean;
+	setPromptSuggestions(suggestions: Suggestion[]): boolean;
 	/**
 	* Define a buffer mode (takes bindings as array of [key, command] pairs)
 	*/
@@ -578,12 +984,16 @@ interface EditorAPI {
 	removeScrollSyncGroup(groupId: number): boolean;
 	/**
 	* Execute multiple actions in sequence
+	* 
+	* Takes typed ActionSpec array - serde validates field names at runtime
 	*/
-	executeActions(actions: Record<string, unknown>[]): boolean;
+	executeActions(actions: ActionSpec[]): boolean;
 	/**
 	* Show an action popup
+	* 
+	* Takes a typed ActionPopupOptions struct - serde validates field names at runtime
 	*/
-	showActionPopup(opts: Record<string, unknown>): boolean;
+	showActionPopup(opts: ActionPopupOptions): boolean;
 	/**
 	* Disable LSP for a specific language
 	*/
@@ -591,25 +1001,27 @@ interface EditorAPI {
 	/**
 	* Get all diagnostics from LSP
 	*/
-	getAllDiagnostics(): unknown;
+	getAllDiagnostics(): JsDiagnostic[];
 	/**
 	* Get registered event handlers for an event
 	*/
 	getHandlers(eventName: string): string[];
 	/**
-	* Create a virtual buffer in current split (async, returns buffer ID)
+	* Create a virtual buffer in current split (async, returns buffer and split IDs)
 	*/
-	createVirtualBuffer(opts: CreateVirtualBufferOptions): Promise<number>;
+	createVirtualBuffer(opts: CreateVirtualBufferOptions): Promise<VirtualBufferResult>;
 	/**
-	* Create a virtual buffer in a new split (async, returns request_id)
+	* Create a virtual buffer in a new split (async, returns buffer and split IDs)
 	*/
-	createVirtualBufferInSplit(opts: CreateVirtualBufferInSplitOptions): Promise<number>;
+	createVirtualBufferInSplit(opts: CreateVirtualBufferInSplitOptions): Promise<VirtualBufferResult>;
 	/**
-	* Create a virtual buffer in an existing split (async, returns request_id)
+	* Create a virtual buffer in an existing split (async, returns buffer and split IDs)
 	*/
-	createVirtualBufferInExistingSplit(opts: CreateVirtualBufferInExistingSplitOptions): Promise<number>;
+	createVirtualBufferInExistingSplit(opts: CreateVirtualBufferInExistingSplitOptions): Promise<VirtualBufferResult>;
 	/**
 	* Set virtual buffer content (takes array of entry objects)
+	* 
+	* Note: entries should be TextPropertyEntry[] - uses manual parsing for HashMap support
 	*/
 	setVirtualBufferContent(bufferId: number, entriesArr: Record<string, unknown>[]): boolean;
 	/**