@fresh-editor/fresh-editor 0.1.87 → 0.1.90

package/plugins/git_log.ts

@@ -336,18 +336,11 @@ function applyGitLogHighlighting(): void {
 
     // Highlight section header
     if (line === editor.t("panel.commits_header")) {
-      editor.addOverlay(
-        bufferId,
-        "gitlog",
-        lineStart,
-        lineEnd,
-        colors.header[0],
-        colors.header[1],
-        colors.header[2],
-        true,  // underline
-        true,  // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitlog", lineStart, lineEnd, {
+        fg: colors.header,
+        underline: true,
+        bold: true,
+      });
       byteOffset += line.length + 1;
       continue;
     }
@@ -364,35 +357,19 @@ function applyGitLogHighlighting(): void {
 
     // Highlight entire line if cursor is on it (using selected color with underline)
     if (isCurrentLine) {
-      editor.addOverlay(
-        bufferId,
-        "gitlog",
-        lineStart,
-        lineEnd,
-        colors.selected[0],
-        colors.selected[1],
-        colors.selected[2],
-        true,  // underline to make it visible
-        true,  // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitlog", lineStart, lineEnd, {
+        fg: colors.selected,
+        underline: true,
+        bold: true,
+      });
     }
 
     // Parse the line format: "shortHash (author, relativeDate) subject [refs]"
     // Highlight hash (first 7+ chars until space)
     const hashEnd = commit.shortHash.length;
-    editor.addOverlay(
-      bufferId,
-      "gitlog",
-      lineStart,
-      lineStart + hashEnd,
-      colors.hash[0],
-      colors.hash[1],
-      colors.hash[2],
-      false, // underline
-      false, // bold
-      false  // italic
-    );
+    editor.addOverlay(bufferId, "gitlog", lineStart, lineStart + hashEnd, {
+      fg: colors.hash,
+    });
 
     // Highlight author name (inside parentheses)
     const authorPattern = "(" + commit.author + ",";
@@ -400,18 +377,9 @@ function applyGitLogHighlighting(): void {
     if (authorStartInLine >= 0) {
       const authorStart = lineStart + authorStartInLine + 1; // skip "("
       const authorEnd = authorStart + commit.author.length;
-      editor.addOverlay(
-        bufferId,
-        "gitlog",
-        authorStart,
-        authorEnd,
-        colors.author[0],
-        colors.author[1],
-        colors.author[2],
-        false, // underline
-        false, // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitlog", authorStart, authorEnd, {
+        fg: colors.author,
+      });
     }
 
     // Highlight relative date
@@ -420,18 +388,9 @@ function applyGitLogHighlighting(): void {
     if (dateStartInLine >= 0) {
       const dateStart = lineStart + dateStartInLine + 2; // skip ", "
       const dateEnd = dateStart + commit.relativeDate.length;
-      editor.addOverlay(
-        bufferId,
-        "gitlog",
-        dateStart,
-        dateEnd,
-        colors.date[0],
-        colors.date[1],
-        colors.date[2],
-        false, // underline
-        false, // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitlog", dateStart, dateEnd, {
+        fg: colors.date,
+      });
     }
 
     // Highlight refs (branches/tags) at end of line if present
@@ -449,18 +408,10 @@ function applyGitLogHighlighting(): void {
           refColor = colors.remote;
         }
 
-        editor.addOverlay(
-          bufferId,
-          "gitlog",
-          refsStart,
-          refsEnd,
-          refColor[0],
-          refColor[1],
-          refColor[2],
-          false, // underline
-          true,  // bold (make refs stand out)
-          false  // italic
-        );
+        editor.addOverlay(bufferId, "gitlog", refsStart, refsEnd, {
+          fg: refColor,
+          bold: true,
+        });
       }
     }
 
@@ -621,112 +572,52 @@ function applyCommitDetailHighlighting(): void {
 
     // Highlight diff additions (green)
     if (line.startsWith("+") && !line.startsWith("+++")) {
-      editor.addOverlay(
-        bufferId,
-        "gitdetail",
-        lineStart,
-        lineEnd,
-        colors.diffAdd[0],
-        colors.diffAdd[1],
-        colors.diffAdd[2],
-        false, // underline
-        false, // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitdetail", lineStart, lineEnd, {
+        fg: colors.diffAdd,
+      });
     }
     // Highlight diff deletions (red)
     else if (line.startsWith("-") && !line.startsWith("---")) {
-      editor.addOverlay(
-        bufferId,
-        "gitdetail",
-        lineStart,
-        lineEnd,
-        colors.diffDel[0],
-        colors.diffDel[1],
-        colors.diffDel[2],
-        false, // underline
-        false, // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitdetail", lineStart, lineEnd, {
+        fg: colors.diffDel,
+      });
     }
     // Highlight hunk headers (cyan/blue)
     else if (line.startsWith("@@")) {
-      editor.addOverlay(
-        bufferId,
-        "gitdetail",
-        lineStart,
-        lineEnd,
-        colors.diffHunk[0],
-        colors.diffHunk[1],
-        colors.diffHunk[2],
-        false, // underline
-        true,  // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitdetail", lineStart, lineEnd, {
+        fg: colors.diffHunk,
+        bold: true,
+      });
     }
     // Highlight commit hash in "commit <hash>" line (git show format)
     else if (line.startsWith("commit ")) {
       const hashMatch = line.match(/^commit ([a-f0-9]+)/);
       if (hashMatch) {
         const hashStart = lineStart + 7; // "commit " is 7 chars
-        editor.addOverlay(
-          bufferId,
-          "gitdetail",
-          hashStart,
-          hashStart + hashMatch[1].length,
-          colors.hash[0],
-          colors.hash[1],
-          colors.hash[2],
-          false, // underline
-          true,  // bold
-          false  // italic
-        );
+        editor.addOverlay(bufferId, "gitdetail", hashStart, hashStart + hashMatch[1].length, {
+          fg: colors.hash,
+          bold: true,
+        });
       }
     }
     // Highlight author line
     else if (line.startsWith("Author:")) {
-      editor.addOverlay(
-        bufferId,
-        "gitdetail",
-        lineStart + 8, // "Author: " is 8 chars
-        lineEnd,
-        colors.author[0],
-        colors.author[1],
-        colors.author[2],
-        false, // underline
-        false, // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitdetail", lineStart + 8, lineEnd, {
+        fg: colors.author,
+      });
     }
     // Highlight date line
     else if (line.startsWith("Date:")) {
-      editor.addOverlay(
-        bufferId,
-        "gitdetail",
-        lineStart + 6, // "Date: " is 6 chars (with trailing spaces it's 8)
-        lineEnd,
-        colors.date[0],
-        colors.date[1],
-        colors.date[2],
-        false, // underline
-        false, // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitdetail", lineStart + 6, lineEnd, {
+        fg: colors.date,
+      });
     }
     // Highlight diff file headers
     else if (line.startsWith("diff --git")) {
-      editor.addOverlay(
-        bufferId,
-        "gitdetail",
-        lineStart,
-        lineEnd,
-        colors.header[0],
-        colors.header[1],
-        colors.header[2],
-        false, // underline
-        true,  // bold
-        false  // italic
-      );
+      editor.addOverlay(bufferId, "gitdetail", lineStart, lineEnd, {
+        fg: colors.header,
+        bold: true,
+      });
     }
 
     byteOffset += line.length + 1;
@@ -1080,7 +971,10 @@ function applyFileViewHighlighting(bufferId: number, content: string, filePath:
         inMultilineComment = true;
       }
       if (inMultilineComment) {
-        editor.addOverlay(bufferId, "syntax", lineStart, lineStart + line.length, colors.syntaxComment[0], colors.syntaxComment[1], colors.syntaxComment[2], false, false, true);
+        editor.addOverlay(bufferId, "syntax", lineStart, lineStart + line.length, {
+          fg: colors.syntaxComment,
+          italic: true,
+        });
         if (line.includes("*/")) {
           inMultilineComment = false;
         }
@@ -1099,7 +993,9 @@ function applyFileViewHighlighting(bufferId: number, content: string, filePath:
       }
     }
     if (inMultilineString) {
-      editor.addOverlay(bufferId, "syntax", lineStart, lineStart + line.length, colors.syntaxString[0], colors.syntaxString[1], colors.syntaxString[2], false, false, false);
+      editor.addOverlay(bufferId, "syntax", lineStart, lineStart + line.length, {
+        fg: colors.syntaxString,
+      });
       byteOffset += line.length + 1;
       continue;
     }
@@ -1113,12 +1009,14 @@ function applyFileViewHighlighting(bufferId: number, content: string, filePath:
     }
 
     if (commentStart >= 0) {
-      editor.addOverlay(bufferId, "syntax", lineStart + commentStart, lineStart + line.length, colors.syntaxComment[0], colors.syntaxComment[1], colors.syntaxComment[2], false, false, true);
+      editor.addOverlay(bufferId, "syntax", lineStart + commentStart, lineStart + line.length, {
+        fg: colors.syntaxComment,
+        italic: true,
+      });
     }
 
     // String highlighting (simple: find "..." and '...')
     let i = 0;
-    let stringCount = 0;
     while (i < line.length) {
       const ch = line[i];
       if (ch === '"' || ch === "'") {
@@ -1132,7 +1030,9 @@ function applyFileViewHighlighting(bufferId: number, content: string, filePath:
         if (i < line.length) i++; // Include closing quote
         const end = i;
         if (commentStart < 0 || start < commentStart) {
-          editor.addOverlay(bufferId, "syntax", lineStart + start, lineStart + end, colors.syntaxString[0], colors.syntaxString[1], colors.syntaxString[2], false, false, false);
+          editor.addOverlay(bufferId, "syntax", lineStart + start, lineStart + end, {
+            fg: colors.syntaxString,
+          });
         }
       } else {
         i++;
@@ -1142,25 +1042,30 @@ function applyFileViewHighlighting(bufferId: number, content: string, filePath:
     // Keyword highlighting
     for (const keyword of keywords) {
       const regex = new RegExp(`\\b${keyword}\\b`, "g");
-      let match;
+      let match: RegExpExecArray | null;
       while ((match = regex.exec(line)) !== null) {
         const kwStart = match.index;
         const kwEnd = kwStart + keyword.length;
         // Don't highlight if inside comment
         if (commentStart < 0 || kwStart < commentStart) {
-          editor.addOverlay(bufferId, "syntax", lineStart + kwStart, lineStart + kwEnd, colors.syntaxKeyword[0], colors.syntaxKeyword[1], colors.syntaxKeyword[2], false, true, false);
+          editor.addOverlay(bufferId, "syntax", lineStart + kwStart, lineStart + kwEnd, {
+            fg: colors.syntaxKeyword,
+            bold: true,
+          });
         }
       }
     }
 
     // Number highlighting
     const numberRegex = /\b\d+(\.\d+)?\b/g;
-    let numMatch;
+    let numMatch: RegExpExecArray | null;
     while ((numMatch = numberRegex.exec(line)) !== null) {
       const numStart = numMatch.index;
       const numEnd = numStart + numMatch[0].length;
       if (commentStart < 0 || numStart < commentStart) {
-        editor.addOverlay(bufferId, "syntax", lineStart + numStart, lineStart + numEnd, colors.syntaxNumber[0], colors.syntaxNumber[1], colors.syntaxNumber[2], false, false, false);
+        editor.addOverlay(bufferId, "syntax", lineStart + numStart, lineStart + numEnd, {
+          fg: colors.syntaxNumber,
+        });
       }
     }
 

package/plugins/lib/finder.ts

@@ -1335,62 +1335,26 @@ export class Finder<T> {
 
       // Highlight current line if it's an item line
       if (isCurrentLine && isItemLine && line.trim() !== "") {
-        this.editor.addOverlay(
-          bufferId,
-          namespace,
-          lineStart,
-          lineEnd,
-          colors.selected[0],
-          colors.selected[1],
-          colors.selected[2],
-          false,
-          false,
-          false,
-          undefined,
-          undefined,
-          undefined,
-          true
-        );
+        this.editor.addOverlay(bufferId, namespace, lineStart, lineEnd, {
+          fg: colors.selected,
+          extendToLineEnd: true,
+        });
       }
 
       // Title line
       if (lineNumber === 1) {
-        this.editor.addOverlay(
-          bufferId,
-          namespace,
-          lineStart,
-          lineEnd,
-          colors.title[0],
-          colors.title[1],
-          colors.title[2],
-          false,
-          true,
-          false,
-          undefined,
-          undefined,
-          undefined,
-          false
-        );
+        this.editor.addOverlay(bufferId, namespace, lineStart, lineEnd, {
+          fg: colors.title,
+          bold: true,
+        });
       }
 
       // File header (ends with : but isn't title)
       if (line.endsWith(":") && lineNumber > 1 && !line.startsWith(" ")) {
-        this.editor.addOverlay(
-          bufferId,
-          namespace,
-          lineStart,
-          lineEnd,
-          colors.fileHeader[0],
-          colors.fileHeader[1],
-          colors.fileHeader[2],
-          false,
-          true,
-          false,
-          undefined,
-          undefined,
-          undefined,
-          false
-        );
+        this.editor.addOverlay(bufferId, namespace, lineStart, lineEnd, {
+          fg: colors.fileHeader,
+          bold: true,
+        });
       }
 
       // Severity icon highlighting
@@ -1415,42 +1379,17 @@ export class Finder<T> {
             color = colors.hint;
         }
 
-        this.editor.addOverlay(
-          bufferId,
-          namespace,
-          lineStart,
-          iconEnd,
-          color[0],
-          color[1],
-          color[2],
-          false,
-          true,
-          false,
-          undefined,
-          undefined,
-          undefined,
-          false
-        );
+        this.editor.addOverlay(bufferId, namespace, lineStart, iconEnd, {
+          fg: color,
+          bold: true,
+        });
       }
 
       // Help line (dimmed)
       if (line.startsWith("Enter:") || line.includes("|")) {
-        this.editor.addOverlay(
-          bufferId,
-          namespace,
-          lineStart,
-          lineEnd,
-          colors.help[0],
-          colors.help[1],
-          colors.help[2],
-          false,
-          false,
-          false,
-          undefined,
-          undefined,
-          undefined,
-          false
-        );
+        this.editor.addOverlay(bufferId, namespace, lineStart, lineEnd, {
+          fg: colors.help,
+        });
       }
 
       byteOffset += line.length + 1;

package/plugins/lib/fresh.d.ts

@@ -349,6 +349,16 @@ type FileExplorerDecoration = {
 	*/
 	priority: number;
 };
+type FormatterPackConfig = {
+	/**
+	* Command to run (e.g., "prettier", "rustfmt")
+	*/
+	command: string;
+	/**
+	* Arguments to pass to the formatter
+	*/
+	args: Array<string>;
+};
 type BackgroundProcessResult = {
 	/**
 	* Unique process ID for later reference
@@ -523,6 +533,54 @@ type CreateVirtualBufferOptions = {
 	*/
 	entries?: Array<TextPropertyEntry>;
 };
+type LanguagePackConfig = {
+	/**
+	* Comment prefix for line comments (e.g., "//" or "#")
+	*/
+	commentPrefix: string | null;
+	/**
+	* Block comment start marker (e.g., slash-star)
+	*/
+	blockCommentStart: string | null;
+	/**
+	* Block comment end marker (e.g., star-slash)
+	*/
+	blockCommentEnd: string | null;
+	/**
+	* Whether to use tabs instead of spaces for indentation
+	*/
+	useTabs: boolean | null;
+	/**
+	* Tab size (number of spaces per tab level)
+	*/
+	tabSize: number | null;
+	/**
+	* Whether auto-indent is enabled
+	*/
+	autoIndent: boolean | null;
+	/**
+	* Formatter configuration
+	*/
+	formatter: FormatterPackConfig | null;
+};
+type LspServerPackConfig = {
+	/**
+	* Command to start the LSP server
+	*/
+	command: string;
+	/**
+	* Arguments to pass to the command
+	*/
+	args: Array<string>;
+	/**
+	* Whether to auto-start the server when a matching file is opened
+	*/
+	autoStart: boolean | null;
+	/**
+	* LSP initialization options
+	*/
+	initializationOptions: Record<string, unknown> | null;
+};
 type SpawnResult = {
 	/**
 	* Complete stdout as string
@@ -774,6 +832,29 @@ interface EditorAPI {
 	*/
 	reloadConfig(): void;
 	/**
+	* Reload theme registry from disk
+	* Call this after installing theme packages or saving new themes
+	*/
+	reloadThemes(): void;
+	/**
+	* Register a TextMate grammar file for a language
+	* The grammar will be pending until reload_grammars() is called
+	*/
+	registerGrammar(language: string, grammarPath: string, extensions: string[]): boolean;
+	/**
+	* Register language configuration (comment prefix, indentation, formatter)
+	*/
+	registerLanguageConfig(language: string, config: LanguagePackConfig): boolean;
+	/**
+	* Register an LSP server for a language
+	*/
+	registerLspServer(language: string, config: LspServerPackConfig): boolean;
+	/**
+	* Reload the grammar registry to apply registered grammars
+	* Call this after registering one or more grammars
+	*/
+	reloadGrammars(): void;
+	/**
 	* Get config directory path
 	*/
 	getConfigDir(): string;
@@ -835,9 +916,23 @@ interface EditorAPI {
 	*/
 	getHighlights(bufferId: number, start: number, end: number): Promise<TsHighlightSpan[]>;
 	/**
-	* Add an overlay with styling
+	* Add an overlay with styling options
+	* 
+	* Colors can be specified as RGB arrays `[r, g, b]` or theme key strings.
+	* Theme keys are resolved at render time, so overlays update with theme changes.
+	* 
+	* Theme key examples: "ui.status_bar_fg", "editor.selection_bg", "syntax.keyword"
+	* 
+	* Example usage in TypeScript:
+	* ```typescript
+	* editor.addOverlay(bufferId, "my-namespace", 0, 10, {
+	* fg: "syntax.keyword",           // theme key
+	* bg: [40, 40, 50],               // RGB array
+	* bold: true,
+	* });
+	* ```
 	*/
-	addOverlay(bufferId: number, namespace: string, start: number, end: number, r: number, g: number, b: number, underline?: boolean, bold?: boolean, italic?: boolean, bgR?: number, bgG?: number, bgB?: number, extendToLineEnd?: boolean): boolean;
+	addOverlay(bufferId: number, namespace: string, start: number, end: number, options: Record<string, unknown>): boolean;
 	/**
 	* Clear all overlays in a namespace
 	*/
@@ -867,10 +962,8 @@ 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: FileExplorerDecoration[]): boolean;
+	setFileExplorerDecorations(namespace: string, decorations: Record<string, unknown>[]): boolean;
 	/**
 	* Clear file explorer decorations for a namespace
 	*/
@@ -999,6 +1092,11 @@ interface EditorAPI {
 	*/
 	disableLspForLanguage(language: string): boolean;
 	/**
+	* Set the workspace root URI for a specific language's LSP server
+	* This allows plugins to specify project roots (e.g., directory containing .csproj)
+	*/
+	setLspRootUri(language: string, uri: string): boolean;
+	/**
 	* Get all diagnostics from LSP
 	*/
 	getAllDiagnostics(): JsDiagnostic[];
@@ -1064,4 +1162,25 @@ interface EditorAPI {
 	* Get the current locale
 	*/
 	getCurrentLocale(): string;
+	/**
+	* Load a plugin from a file path (async)
+	*/
+	loadPlugin(path: string): Promise<boolean>;
+	/**
+	* Unload a plugin by name (async)
+	*/
+	unloadPlugin(name: string): Promise<boolean>;
+	/**
+	* Reload a plugin by name (async)
+	*/
+	reloadPlugin(name: string): Promise<boolean>;
+	/**
+	* List all loaded plugins (async)
+	* Returns array of { name: string, path: string, enabled: boolean }
+	*/
+	listPlugins(): Promise<Array<{
+		name: string;
+		path: string;
+		enabled: boolean;
+	}>>;
 }