@fresh-editor/fresh-editor 0.2.21 → 0.2.23

package/plugins/config-schema.json

@@ -42,6 +42,24 @@
         "menu_bar_mnemonics": true,
         "show_tab_bar": true,
         "show_status_bar": true,
+        "status_bar": {
+          "left": [
+            "{filename}",
+            "{cursor}",
+            "{diagnostics}",
+            "{cursor_count}",
+            "{messages}"
+          ],
+          "right": [
+            "{line_ending}",
+            "{encoding}",
+            "{language}",
+            "{lsp}",
+            "{warnings}",
+            "{update}",
+            "{palette}"
+          ]
+        },
         "show_prompt_line": true,
         "show_vertical_scrollbar": true,
         "show_horizontal_scrollbar": false,
@@ -158,17 +176,14 @@
       },
       "default": {}
     },
-    "fallback": {
-      "description": "Fallback configuration for files whose type cannot be detected.\nApplied when no extension, filename, glob, or built-in detection matches.\nUseful for setting a default grammar (e.g., \"bash\") and comment_prefix\nfor unrecognized .conf, .rc, .rules, etc. files.",
-      "anyOf": [
-        {
-          "$ref": "#/$defs/LanguageConfig"
-        },
-        {
-          "type": "null"
-        }
+    "default_language": {
+      "description": "Default language for files whose type cannot be detected.\nMust reference a key in the `languages` map (e.g., \"bash\").\nApplied when no extension, filename, glob, or built-in detection matches.\nThe referenced language's full configuration (grammar, comment_prefix,\ntab_size, etc.) is used for unrecognized files.",
+      "type": [
+        "string",
+        "null"
       ],
-      "default": null
+      "default": null,
+      "x-enum-from": "/languages"
     },
     "lsp": {
       "description": "LSP server configurations by language.\nEach language maps to one or more server configs (multi-LSP support).\nAccepts both single-object and array forms for backwards compatibility.",
@@ -178,6 +193,14 @@
       },
       "default": {}
     },
+    "universal_lsp": {
+      "description": "Universal LSP servers that apply to all languages.\nThese servers run alongside language-specific LSP servers defined in `lsp`.\nKeyed by a unique server name (e.g. \"quicklsp\").",
+      "type": "object",
+      "additionalProperties": {
+        "$ref": "#/$defs/LspLanguageConfig"
+      },
+      "default": {}
+    },
     "warnings": {
       "description": "Warning notification settings",
       "$ref": "#/$defs/WarningsConfig",
@@ -322,6 +345,29 @@
           "default": true,
           "x-section": "Display"
         },
+        "status_bar": {
+          "description": "Status bar layout and element configuration.\nControls which elements appear in the status bar and how they are arranged.",
+          "$ref": "#/$defs/StatusBarConfig",
+          "default": {
+            "left": [
+              "{filename}",
+              "{cursor}",
+              "{diagnostics}",
+              "{cursor_count}",
+              "{messages}"
+            ],
+            "right": [
+              "{line_ending}",
+              "{encoding}",
+              "{language}",
+              "{lsp}",
+              "{warnings}",
+              "{update}",
+              "{palette}"
+            ]
+          },
+          "x-section": "Status Bar"
+        },
         "show_prompt_line": {
           "description": "Whether the prompt line is visible by default.\nThe prompt line is the bottom-most line used for command input, search, file open, etc.\nWhen hidden, the prompt line only appears when a prompt is active.\nCan be toggled at runtime via command palette or keybinding.\nDefault: true",
           "type": "boolean",
@@ -671,6 +717,111 @@
         }
       }
     },
+    "StatusBarConfig": {
+      "description": "Status bar layout and element configuration.\n\nControls which elements appear in the status bar and how they are arranged.\nElements are placed in left and right containers and can be freely reordered.\n\nExample config:\n```json\n{\n  \"status_bar\": {\n    \"left\": [\"{filename}\", \"{cursor:compact}\"],\n    \"right\": [\"{language}\", \"{encoding}\", \"{line_ending}\"]\n  }\n}\n```",
+      "type": "object",
+      "properties": {
+        "left": {
+          "description": "Elements shown on the left side of the status bar.\nDefault: [\"{filename}\", \"{cursor}\", \"{diagnostics}\", \"{cursor_count}\", \"{messages}\"]",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/StatusBarElement"
+          },
+          "default": [
+            "{filename}",
+            "{cursor}",
+            "{diagnostics}",
+            "{cursor_count}",
+            "{messages}"
+          ],
+          "x-section": "Status Bar",
+          "x-dual-list-sibling": "/editor/status_bar/right"
+        },
+        "right": {
+          "description": "Elements shown on the right side of the status bar.\nDefault: [\"{line_ending}\", \"{encoding}\", \"{language}\", \"{lsp}\", \"{warnings}\", \"{update}\", \"{palette}\"]",
+          "type": "array",
+          "items": {
+            "$ref": "#/$defs/StatusBarElement"
+          },
+          "default": [
+            "{line_ending}",
+            "{encoding}",
+            "{language}",
+            "{lsp}",
+            "{warnings}",
+            "{update}",
+            "{palette}"
+          ],
+          "x-section": "Status Bar",
+          "x-dual-list-sibling": "/editor/status_bar/left"
+        }
+      }
+    },
+    "StatusBarElement": {
+      "type": "string",
+      "x-dual-list-options": [
+        {
+          "value": "{filename}",
+          "name": "Filename"
+        },
+        {
+          "value": "{cursor}",
+          "name": "Cursor"
+        },
+        {
+          "value": "{cursor:compact}",
+          "name": "Cursor (compact)"
+        },
+        {
+          "value": "{diagnostics}",
+          "name": "Diagnostics"
+        },
+        {
+          "value": "{cursor_count}",
+          "name": "Cursor Count"
+        },
+        {
+          "value": "{messages}",
+          "name": "Messages"
+        },
+        {
+          "value": "{chord}",
+          "name": "Chord"
+        },
+        {
+          "value": "{line_ending}",
+          "name": "Line Ending"
+        },
+        {
+          "value": "{encoding}",
+          "name": "Encoding"
+        },
+        {
+          "value": "{language}",
+          "name": "Language"
+        },
+        {
+          "value": "{lsp}",
+          "name": "LSP"
+        },
+        {
+          "value": "{warnings}",
+          "name": "Warnings"
+        },
+        {
+          "value": "{update}",
+          "name": "Update"
+        },
+        {
+          "value": "{palette}",
+          "name": "Palette"
+        },
+        {
+          "value": "{clock}",
+          "name": "Clock"
+        }
+      ]
+    },
     "CursorStyle": {
       "description": "Terminal cursor style",
       "type": "string",
@@ -921,11 +1072,6 @@
           ],
           "default": null
         },
-        "highlighter": {
-          "description": "Preferred highlighter backend (auto, tree-sitter, or textmate)",
-          "$ref": "#/$defs/HighlighterPreference",
-          "default": "auto"
-        },
         "textmate_grammar": {
           "description": "Path to custom TextMate grammar file (optional)\nIf specified, this grammar will be used when highlighter is \"textmate\"",
           "type": [
@@ -1029,26 +1175,6 @@
       },
       "x-display-field": "/grammar"
     },
-    "HighlighterPreference": {
-      "description": "Preference for which syntax highlighting backend to use",
-      "oneOf": [
-        {
-          "description": "Use tree-sitter if available, fall back to TextMate",
-          "type": "string",
-          "const": "auto"
-        },
-        {
-          "description": "Force tree-sitter only (no highlighting if unavailable)",
-          "type": "string",
-          "const": "tree-sitter"
-        },
-        {
-          "description": "Force TextMate grammar (skip tree-sitter even if available)",
-          "type": "string",
-          "const": "textmate"
-        }
-      ]
-    },
     "FormatterConfig": {
       "description": "Formatter configuration for a language",
       "type": "object",

package/plugins/git_explorer.ts

@@ -10,12 +10,12 @@ const editor = getEditor();
 const NAMESPACE = "git-explorer";
 
 const COLORS = {
-  added: [80, 250, 123] as [number, number, number],
-  modified: [255, 184, 108] as [number, number, number],
-  deleted: [255, 85, 85] as [number, number, number],
-  renamed: [139, 233, 253] as [number, number, number],
-  untracked: [241, 250, 140] as [number, number, number],
-  conflicted: [255, 121, 198] as [number, number, number],
+  added:      "ui.file_status_added_fg",
+  modified:   "ui.file_status_modified_fg",
+  deleted:    "ui.file_status_deleted_fg",
+  renamed:    "ui.file_status_renamed_fg",
+  untracked:  "ui.file_status_untracked_fg",
+  conflicted: "ui.file_status_conflicted_fg",
 };
 
 const PRIORITY = {
@@ -58,7 +58,7 @@ function parseStatusOutput(output: string, repoRoot: string) {
     .split(separator)
     .map((entry) => entry.replace(/\r$/, ""))
     .filter((entry) => entry.length > 0);
-  const byPath = new Map<string, { path: string; symbol: string; color: [number, number, number]; priority: number }>();
+  const byPath = new Map<string, { path: string; symbol: string; color: string; priority: number }>();
 
   for (let i = 0; i < entries.length; i++) {
     const entry = entries[i];

package/plugins/lib/fresh.d.ts

@@ -156,6 +156,12 @@ type TsCreateCompositeBufferOptions = {
 	* Diff hunks for alignment (optional)
 	*/
 	hunks: Array<TsCompositeHunk> | null;
+	/**
+	* When set, the first render will scroll to center the Nth hunk (0-indexed).
+	* This avoids timing issues with imperative scroll commands that depend on
+	* render-created state (viewport dimensions, view state).
+	*/
+	initialFocusHunk?: number;
 };
 type ViewportInfo = {
 	/**
@@ -393,9 +399,9 @@ type FileExplorerDecoration = {
 	*/
 	symbol: string;
 	/**
-	* Color as RGB array (rquickjs_serde requires array, not tuple)
+	* Color as RGB array or theme key string (e.g., "ui.file_status_added_fg")
 	*/
-	color: [number, number, number];
+	color: OverlayColorSpec;
 	/**
 	* Priority for display when multiple decorations exist (higher wins)
 	*/
@@ -525,6 +531,24 @@ type InlineOverlay = {
 	*/
 	properties?: Record<string, any>;
 };
+type GrammarInfoSnapshot = {
+	/**
+	* The grammar name as used in config files (case-insensitive matching)
+	*/
+	name: string;
+	/**
+	* Where this grammar was loaded from (e.g. "built-in", "plugin (myplugin)")
+	*/
+	source: string;
+	/**
+	* File extensions associated with this grammar
+	*/
+	file_extensions: Array<string>;
+	/**
+	* Optional short name alias (e.g., "bash" for "Bourne Again Shell (bash)")
+	*/
+	short_name: string | null;
+};
 type BackgroundProcessResult = {
 	/**
 	* Unique process ID for later reference
@@ -812,6 +836,10 @@ interface EditorAPI {
 	* List all open buffers - returns array of BufferInfo objects
 	*/
 	listBuffers(): BufferInfo[];
+	/**
+	* List all available grammars with source info - returns array of GrammarInfo objects
+	*/
+	listGrammars(): GrammarInfoSnapshot[];
 	debug(msg: string): void;
 	info(msg: string): void;
 	warn(msg: string): void;
@@ -919,6 +947,17 @@ interface EditorAPI {
 	*/
 	scrollToLineCenter(splitId: number, bufferId: number, line: number): boolean;
 	/**
+	* Scroll any split/panel showing `buffer_id` so `line` is visible.
+	* Unlike `scrollToLineCenter`, this does not require a split id — it
+	* updates every split's viewport whose active buffer is the given
+	* buffer, including inner leaves of a buffer group. Use this from
+	* a panel plugin to keep the user's "selected" row in view after
+	* arrow-key navigation (the plugin's own selection state isn't
+	* automatically reflected in the buffer cursor, so the core-driven
+	* viewport would otherwise stay put).
+	*/
+	scrollBufferToLine(bufferId: number, line: number): boolean;
+	/**
 	* Find buffer by file path, returns buffer ID or 0 if not found
 	*/
 	findBufferByPath(path: string): number;
@@ -1169,6 +1208,20 @@ interface EditorAPI {
 	*/
 	closeCompositeBuffer(bufferId: number): boolean;
 	/**
+	* Force-materialize render-dependent state (like `layoutIfNeeded` in UIKit).
+	* After calling this, commands that depend on view state created during
+	* rendering (e.g., `compositeNextHunk`) will work correctly.
+	*/
+	flushLayout(): boolean;
+	/**
+	* Navigate to the next hunk in a composite buffer
+	*/
+	compositeNextHunk(bufferId: number): boolean;
+	/**
+	* Navigate to the previous hunk in a composite buffer
+	*/
+	compositePrevHunk(bufferId: number): boolean;
+	/**
 	* Request syntax highlights for a buffer range (async)
 	*/
 	getHighlights(bufferId: number, start: number, end: number): Promise<TsHighlightSpan[]>;
@@ -1459,6 +1512,18 @@ interface EditorAPI {
 	*/
 	createVirtualBufferInExistingSplit(opts: CreateVirtualBufferInExistingSplitOptions): Promise<VirtualBufferResult>;
 	/**
+	* Set the content of a panel within a buffer group
+	*/
+	setPanelContent(groupId: number, panelName: string, entriesArr: Record<string, unknown>[]): boolean;
+	/**
+	* Close a buffer group
+	*/
+	closeBufferGroup(groupId: number): boolean;
+	/**
+	* Focus a specific panel within a buffer group
+	*/
+	focusBufferGroupPanel(groupId: number, panelName: string): boolean;
+	/**
 	* Set virtual buffer content (takes array of entry objects)
 	* 
 	* Note: entries should be TextPropertyEntry[] - uses manual parsing for HashMap support

package/plugins/lib/virtual-buffer-factory.ts

@@ -12,6 +12,8 @@ export interface VirtualBufferOptions {
   entries: TextPropertyEntry[];
   /** Whether to show line numbers (default false) */
   showLineNumbers?: boolean;
+  /** Whether to show cursors (default true) */
+  showCursors?: boolean;
   /** Whether editing is disabled (default true) */
   editingDisabled?: boolean;
   /** Whether buffer is read-only (default true) */
@@ -55,6 +57,7 @@ export function createVirtualBufferFactory(editor: EditorAPI) {
         mode,
         entries,
         showLineNumbers = false,
+        showCursors,
         editingDisabled = true,
         readOnly = true,
       } = options;
@@ -65,6 +68,7 @@ export function createVirtualBufferFactory(editor: EditorAPI) {
         readOnly,
         entries,
         showLineNumbers,
+        showCursors,
         editingDisabled,
       });
       return result.bufferId;
@@ -79,6 +83,7 @@ export function createVirtualBufferFactory(editor: EditorAPI) {
         mode,
         entries,
         showLineNumbers = false,
+        showCursors,
         editingDisabled = true,
         readOnly = true,
       } = options;
@@ -90,6 +95,7 @@ export function createVirtualBufferFactory(editor: EditorAPI) {
         entries,
         splitId,
         showLineNumbers,
+        showCursors,
         editingDisabled,
       });
       return result.bufferId;
@@ -106,6 +112,7 @@ export function createVirtualBufferFactory(editor: EditorAPI) {
         ratio = 0.3,
         panelId,
         showLineNumbers = false,
+        showCursors,
         editingDisabled = true,
         readOnly = true,
       } = options;
@@ -118,6 +125,7 @@ export function createVirtualBufferFactory(editor: EditorAPI) {
         ratio,
         panelId,
         showLineNumbers,
+        showCursors,
         editingDisabled,
       });
       return result.bufferId;