@fresh-editor/fresh-editor 0.1.4

package/plugins/todo_highlighter.ts

@@ -0,0 +1,204 @@
+// TypeScript TODO Highlighter Plugin
+// Highlights TODO, FIXME, XXX keywords in source code
+// Uses targeted overlay invalidation for efficient updates on edits
+
+interface HighlightConfig {
+  enabled: boolean;
+  keywords: Array<{
+    word: string;
+    color: [number, number, number];
+  }>;
+}
+
+// Plugin configuration
+const config: HighlightConfig = {
+  enabled: false,  // Start disabled, use Enable or Toggle to activate
+  keywords: [
+    { word: "TODO", color: [255, 200, 50] },     // Yellow
+    { word: "FIXME", color: [255, 100, 100] },   // Red
+    { word: "XXX", color: [255, 150, 50] },      // Orange
+    { word: "HACK", color: [200, 100, 255] },    // Purple
+    { word: "NOTE", color: [100, 200, 255] },    // Blue
+  ],
+};
+
+// Namespace for all TODO highlighter overlays
+const NAMESPACE = "todo";
+
+// Process a single line for keyword highlighting
+function highlightLine(
+  bufferId: number,
+  byteStart: number,
+  content: string
+): void {
+  // Search for keywords
+  for (const keyword of config.keywords) {
+    let searchStart = 0;
+    while (true) {
+      const pos = content.indexOf(keyword.word, searchStart);
+      if (pos === -1) break;
+
+      // Check if it's a whole word (preceded by non-word char or start)
+      const isWordStart = pos === 0 || !/\w/.test(content[pos - 1]);
+      const isWordEnd = pos + keyword.word.length >= content.length ||
+                        !/\w/.test(content[pos + keyword.word.length]);
+
+      if (isWordStart && isWordEnd) {
+        const absoluteStart = byteStart + pos;
+        const absoluteEnd = absoluteStart + keyword.word.length;
+
+        // Add overlay with namespace for efficient batch removal
+        editor.addOverlay(
+          bufferId,
+          NAMESPACE,
+          absoluteStart,
+          absoluteEnd,
+          keyword.color[0],
+          keyword.color[1],
+          keyword.color[2],
+          false  // background color, not underline
+        );
+      }
+
+      searchStart = pos + 1;
+    }
+  }
+}
+
+// Clear highlights for a buffer using namespace
+function clearHighlights(bufferId: number): void {
+  editor.clearNamespace(bufferId, NAMESPACE);
+}
+
+// Handle lines_changed events (batched for efficiency)
+// This is called for lines that need (re)processing
+globalThis.onLinesChanged = function(data: {
+  buffer_id: number;
+  lines: Array<{
+    line_number: number;
+    byte_start: number;
+    byte_end: number;
+    content: string;
+  }>;
+}): void {
+  if (!config.enabled) return;
+
+  // Process all changed lines and create overlays for them
+  for (const line of data.lines) {
+    highlightLine(data.buffer_id, line.byte_start, line.content);
+  }
+};
+
+// Handle buffer content changes - clear only affected overlays
+// The editor will automatically re-send the affected lines via lines_changed
+globalThis.onAfterInsert = function(data: {
+  buffer_id: number;
+  position: number;
+  text: string;
+  affected_start: number;
+  affected_end: number;
+}): void {
+  if (!config.enabled) return;
+
+  // Clear only overlays that overlap with the insertion range
+  // These overlays may now span corrupted content (e.g., "TODO" -> "TOxDO")
+  // The affected lines will be re-sent via lines_changed with correct content
+  editor.clearOverlaysInRange(data.buffer_id, data.affected_start, data.affected_end);
+};
+
+globalThis.onAfterDelete = function(data: {
+  buffer_id: number;
+  start: number;
+  end: number;
+  deleted_text: string;
+  affected_start: number;
+  deleted_len: number;
+}): void {
+  if (!config.enabled) return;
+
+  // Clear overlays that overlapped with the deleted range
+  // Overlays that were entirely within the deleted range are already gone
+  // (their markers were deleted), but overlays that spanned the deletion
+  // boundary may now be incorrect
+  // Use a slightly expanded range to catch boundary cases
+  const clearStart = data.affected_start > 0 ? data.affected_start - 1 : 0;
+  const clearEnd = data.affected_start + 1;
+  editor.clearOverlaysInRange(data.buffer_id, clearStart, clearEnd);
+};
+
+// Handle buffer close events
+globalThis.onBufferClosed = function(data: { buffer_id: number }): void {
+  // No cleanup needed - overlays are automatically cleaned up with the buffer
+};
+
+// Register hooks
+editor.on("lines_changed", "onLinesChanged");
+editor.on("after-insert", "onAfterInsert");
+editor.on("after-delete", "onAfterDelete");
+editor.on("buffer_closed", "onBufferClosed");
+
+// Plugin commands
+globalThis.todoHighlighterEnable = function(): void {
+  config.enabled = true;
+  // Refresh lines so next render processes all visible lines
+  const bufferId = editor.getActiveBufferId();
+  editor.refreshLines(bufferId);
+  editor.setStatus("TODO Highlighter: Enabled");
+};
+
+globalThis.todoHighlighterDisable = function(): void {
+  config.enabled = false;
+  const bufferId = editor.getActiveBufferId();
+  clearHighlights(bufferId);
+  editor.setStatus("TODO Highlighter: Disabled");
+};
+
+globalThis.todoHighlighterToggle = function(): void {
+  config.enabled = !config.enabled;
+  const bufferId = editor.getActiveBufferId();
+  if (config.enabled) {
+    // Refresh lines so next render processes all visible lines
+    editor.refreshLines(bufferId);
+  } else {
+    clearHighlights(bufferId);
+  }
+  editor.setStatus(`TODO Highlighter: ${config.enabled ? "Enabled" : "Disabled"}`);
+};
+
+globalThis.todoHighlighterShowKeywords = function(): void {
+  const keywords = config.keywords.map(k => k.word).join(", ");
+  editor.setStatus(`TODO Keywords: ${keywords}`);
+};
+
+// Register commands
+editor.registerCommand(
+  "TODO Highlighter: Enable",
+  "Enable TODO keyword highlighting",
+  "todoHighlighterEnable",
+  "normal"
+);
+
+editor.registerCommand(
+  "TODO Highlighter: Disable",
+  "Disable TODO keyword highlighting",
+  "todoHighlighterDisable",
+  "normal"
+);
+
+editor.registerCommand(
+  "TODO Highlighter: Toggle",
+  "Toggle TODO keyword highlighting",
+  "todoHighlighterToggle",
+  "normal"
+);
+
+editor.registerCommand(
+  "TODO Highlighter: Show Keywords",
+  "Show currently tracked keywords",
+  "todoHighlighterShowKeywords",
+  "normal"
+);
+
+// Initialization
+editor.setStatus("TODO Highlighter plugin loaded (TypeScript)");
+editor.debug("TODO Highlighter initialized with keywords: " + config.keywords.map(k => k.word).join(", "));

package/plugins/welcome.ts

@@ -0,0 +1,74 @@
+/// <reference path="../types/fresh.d.ts" />
+
+/**
+ * Welcome Plugin
+ * Shows a welcome message and registers demo commands
+ */
+
+// Show welcome message in status bar
+editor.setStatus("Plugins are working! Welcome Plugin loaded successfully!");
+
+// Register commands that use built-in actions
+editor.registerCommand(
+  "Plugin Demo: Open Help",
+  "Open the editor help page (uses built-in action)",
+  "show_help",
+  "normal"
+);
+
+editor.registerCommand(
+  "Plugin Demo: Save File",
+  "Save the current file (uses built-in action)",
+  "save",
+  "normal"
+);
+
+// Register commands with custom TypeScript callbacks
+globalThis.plugin_say_hello = function(): void {
+  editor.insertAtCursor("Hello from TypeScript! The plugin system is working!\n");
+  editor.setStatus("Inserted greeting at cursor position");
+  editor.debug("Plugin callback executed: say_hello");
+};
+
+editor.registerCommand(
+  "Plugin Demo: Say Hello",
+  "Insert a friendly greeting into the buffer",
+  "plugin_say_hello",
+  "normal"
+);
+
+globalThis.plugin_insert_time = function(): void {
+  const time = new Date().toLocaleTimeString();
+  editor.insertAtCursor(`Current time: ${time}\n`);
+  editor.setStatus("Inserted time at cursor position");
+  editor.debug(`Plugin callback executed: insert_time at ${time}`);
+};
+
+editor.registerCommand(
+  "Plugin Demo: Insert Time",
+  "Insert the current time at cursor position",
+  "plugin_insert_time",
+  "normal"
+);
+
+globalThis.plugin_insert_comment = function(): void {
+  editor.insertAtCursor("// This comment was inserted by a TypeScript plugin!\n");
+  editor.setStatus("Comment inserted by plugin");
+  editor.debug("Plugin callback executed: insert_comment");
+};
+
+editor.registerCommand(
+  "Plugin Demo: Insert Comment",
+  "Insert a sample comment at cursor position",
+  "plugin_insert_comment",
+  "normal"
+);
+
+// Debug output
+editor.debug("Welcome plugin initialized successfully!");
+editor.debug("Registered 5 commands - try Ctrl+P to see them!");
+editor.debug("   - 'Plugin Demo: Open Help' - toggles help screen (built-in action)");
+editor.debug("   - 'Plugin Demo: Save File' - saves current file (built-in action)");
+editor.debug("   - 'Plugin Demo: Say Hello' - inserts greeting (TypeScript callback)");
+editor.debug("   - 'Plugin Demo: Insert Time' - inserts current time (TypeScript callback)");
+editor.debug("   - 'Plugin Demo: Insert Comment' - inserts sample comment (TypeScript callback)");

package/run-fresh.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+
+const { run } = require("./binary");
+run("fresh");