@fresh-editor/fresh-editor 0.1.97 → 0.1.99

package/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Release Notes
 
+## 0.1.99
+
+### Features
+
+* **Windows Terminal Support**: Full terminal emulation on Windows using ConPTY (Windows 10 1809+). Handles PowerShell DSR cursor queries, prefers PowerShell over cmd.exe, and supports stdin piping (`type file | fresh`).
+
+* **Text Encoding Support**: Detect and convert files in UTF-8, UTF-16 LE/BE, Latin-1, Windows-1252, Windows-1250, GBK, Shift-JIS, EUC-KR, and GB18030. Encoding shown in status bar (clickable to change). "Reload with Encoding..." command in File menu. Confirmation prompt for large files with non-resynchronizable encodings (#488).
+
+* **Encoding Selection in File Browser**: Toggle "Detect Encoding" with Alt+E when opening files. When disabled, prompts for manual encoding selection.
+
+* **Bundle Package Type**: New package type containing multiple languages, plugins, and themes in a single package. Shown with "B" tag in package manager.
+
+* **Space-Separated Fuzzy Search**: Queries with spaces are now split into independent terms, all of which must match. For example, "features groups-view" now matches "/features/groups/groups-view.tsx" (#933).
+
+### Bug Fixes
+
+* Fixed Escape key not closing the manual and keyboard shortcuts pages (#840).
+
+* Fixed scrollbar and mouse wheel scrolling not working with line wrap enabled.
+
+* Fixed scrollbar thumb drag jumping to mouse position instead of following drag movement.
+
+* Fixed AltGr character input not working on Windows (#762).
+
+* Fixed custom themes not appearing in "Select Theme" on macOS due to incorrect config path resolution.
+
+* Fixed LSP servers registered via plugins being disabled by default.
+
+* Fixed language packs being installed to plugins directory instead of languages directory.
+
+* Fixed theme changes not persisting when selecting the default theme.
+
+* Fixed popup positioning not accounting for file explorer width (#898).
+
+* Fixed LSP did_open sending wrong language for multi-language LSP servers.
+
+* Fixed manual LSP start not working when LSP config was disabled; settings now sync immediately.
+
+### Internal
+
+* Refactored config path handling to pass DirectoryContext via call chain instead of static methods.
+
+* Added shadow model property-based tests for TextBuffer.
+
+* Bumped tree-sitter (0.26.5), actions/checkout (v6), actions/upload-pages-artifact (v4) (@dependabot).
+
+---
+
+## 0.1.98
+
+### Features
+
+* **File Explorer Quick Search**: Type to filter files/directories with fuzzy matching. ESC or Backspace clears the search (#892).
+
+* **Sort Lines Command**: New command to alphabetically sort selected lines.
+
+* **Paragraph Selection**: Ctrl+Shift+Up/Down extends selection to previous/next empty line.
+
+* **Local Package Install**: Package manager now supports installing plugins/themes from local file paths (e.g., `/path/to/package`, `~/repos/plugin`).
+
+* **Plugin API**: Added `setLineWrap` for plugins to control line wrapping.
+
+### Bug Fixes
+
+* Fixed data corruption when saving large files with in-place writes.
+
+* Fixed UI hang when loading shortcuts in Open File dialog (#903).
+
+* Fixed file explorer failing to open at root path "/" (#902).
+
+* Fixed Settings UI search results not scrolling properly (#905).
+
+* Fixed multi-cursor cut operations not batching undo correctly.
+
+---
+
 ## 0.1.96
 
 ### Features

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fresh-editor/fresh-editor",
-  "version": "0.1.97",
+  "version": "0.1.99",
   "description": "A modern terminal-based text editor with plugin support",
   "repository": {
     "type": "git",

package/plugins/code-tour.ts

@@ -0,0 +1,397 @@
+/// <reference path="./lib/fresh.d.ts" />
+
+/**
+ * Code Tour Plugin
+ *
+ * A JSON-driven walkthrough system that guides users through a codebase
+ * using visual overlays and explanatory text.
+ *
+ * Usage:
+ * 1. Create a .fresh-tour.json file in your project root
+ * 2. Use "Tour: Load Definition..." command to start a tour
+ * 3. Navigate with Space/Right (next), Backspace/Left (prev), Tab (resume), Esc (exit)
+ */
+
+const editor = getEditor();
+
+// ============================================================================
+// Types
+// ============================================================================
+
+interface OverlayConfig {
+  type: "block" | "line";
+  focus_mode: boolean;
+}
+
+interface TourStep {
+  step_id: number;
+  title: string;
+  file_path: string;
+  lines: [number, number]; // 1-indexed, inclusive
+  explanation: string;
+  overlay_config?: OverlayConfig;
+}
+
+interface TourManifest {
+  $schema?: string;
+  title: string;
+  description: string;
+  schema_version: "1.0";
+  commit_hash?: string;
+  steps: TourStep[];
+}
+
+type TourState =
+  | { kind: "idle" }
+  | { kind: "active"; currentStep: number; isPaused: boolean };
+
+interface TourManager {
+  state: TourState;
+  manifest: TourManifest | null;
+  dockBufferId: number | null;
+  dockSplitId: number | null;
+  contentBufferId: number | null;
+  contentSplitId: number | null;
+  overlayNamespace: string;
+  lastKnownTopByte: number;
+  lastKnownBufferId: number;
+}
+
+// ============================================================================
+// State
+// ============================================================================
+
+const TOUR_NAMESPACE = "code-tour";
+
+const tourManager: TourManager = {
+  state: { kind: "idle" },
+  manifest: null,
+  dockBufferId: null,
+  dockSplitId: null,
+  contentBufferId: null,
+  contentSplitId: null,
+  overlayNamespace: TOUR_NAMESPACE,
+  lastKnownTopByte: 0,
+  lastKnownBufferId: 0,
+};
+
+// ============================================================================
+// Tour Status Updates
+// ============================================================================
+
+const TOUR_POPUP_ID = "code-tour-step";
+
+function showStepPopup(
+  step: TourStep,
+  stepIndex: number,
+  totalSteps: number,
+  fileError?: string
+): void {
+  const manifest = tourManager.manifest;
+  if (!manifest) return;
+
+  const stepInfo = `Step ${stepIndex + 1}/${totalSteps}: ${step.title}`;
+
+  // Build message with explanation
+  let message = step.explanation;
+  if (fileError) {
+    message = `ERROR: ${fileError}\n\n${step.explanation}`;
+  }
+
+  // Build actions based on position
+  const actions: Array<{ id: string; label: string }> = [];
+
+  if (stepIndex > 0) {
+    actions.push({ id: "prev", label: "← Previous" });
+  }
+  if (stepIndex < totalSteps - 1) {
+    actions.push({ id: "next", label: "Next →" });
+  }
+  actions.push({ id: "exit", label: "Exit Tour" });
+
+  editor.showActionPopup({
+    id: TOUR_POPUP_ID,
+    title: stepInfo,
+    message: message,
+    actions: actions,
+  });
+}
+
+// Handle popup button clicks
+interface ActionPopupResultData {
+  popup_id: string;
+  action_id: string;
+}
+
+globalThis.tour_on_action_popup_result = function (data: ActionPopupResultData): void {
+  if (data.popup_id !== TOUR_POPUP_ID) return;
+
+  switch (data.action_id) {
+    case "next":
+      nextStep();
+      break;
+    case "prev":
+      prevStep();
+      break;
+    case "exit":
+      exitTour();
+      break;
+  }
+};
+
+// ============================================================================
+// Overlay Rendering
+// ============================================================================
+
+async function clearTourOverlays(): Promise<void> {
+  // Clear overlays from all open buffers
+  const buffers = editor.listBuffers();
+  for (const buf of buffers) {
+    editor.clearNamespace(buf.id, TOUR_NAMESPACE);
+  }
+}
+
+async function renderStepOverlays(step: TourStep): Promise<void> {
+  const bufferId = editor.findBufferByPath(step.file_path);
+  if (!bufferId) return;
+
+  // Clear previous overlays
+  await clearTourOverlays();
+
+  // Get line positions (convert from 1-indexed to 0-indexed)
+  const startLine = step.lines[0] - 1;
+  const endLine = step.lines[1] - 1;
+
+  const startPos = await editor.getLineStartPosition(startLine);
+  const endPos = await editor.getLineEndPosition(endLine);
+
+  if (startPos === null || endPos === null) {
+    editor.warn(`Tour: Could not get line positions for lines ${step.lines[0]}-${step.lines[1]}`);
+    return;
+  }
+
+  // Add highlight overlay for active lines
+  editor.addOverlay(bufferId, TOUR_NAMESPACE, startPos, endPos, {
+    bg: [42, 74, 106], // Highlighted background color
+    extendToLineEnd: true,
+  });
+
+  // If focus mode is enabled, we could dim surrounding lines
+  // For now, just the highlight is sufficient
+}
+
+// ============================================================================
+// Navigation
+// ============================================================================
+
+async function navigateToStep(stepIndex: number): Promise<void> {
+  if (!tourManager.manifest) return;
+
+  const step = tourManager.manifest.steps[stepIndex];
+  if (!step) return;
+
+  // Check if file exists (fileExists is sync, not async)
+  const fileExists = editor.fileExists(step.file_path);
+
+  if (!fileExists) {
+    // Show error in popup but allow navigation to continue
+    showStepPopup(
+      step,
+      stepIndex,
+      tourManager.manifest.steps.length,
+      "File not found"
+    );
+    return;
+  }
+
+  // Open the file at the starting line
+  editor.openFile(step.file_path, step.lines[0], 1);
+
+  // Wait a bit for the file to open
+  await editor.delay(50);
+
+  // Get the buffer ID after opening
+  const bufferId = editor.findBufferByPath(step.file_path);
+  if (bufferId) {
+    // Center the view on the middle of the highlighted region
+    const middleLine = Math.floor((step.lines[0] + step.lines[1]) / 2) - 1;
+    const splitId = editor.getActiveSplitId();
+    editor.scrollToLineCenter(splitId, bufferId, middleLine);
+
+    // Render overlays
+    await renderStepOverlays(step);
+
+    // Track for detour detection
+    tourManager.lastKnownBufferId = bufferId;
+    const viewport = editor.getViewport();
+    if (viewport) {
+      tourManager.lastKnownTopByte = viewport.topByte;
+    }
+  }
+
+  // Show explanation popup
+  showStepPopup(step, stepIndex, tourManager.manifest.steps.length);
+}
+
+// ============================================================================
+// Tour Lifecycle
+// ============================================================================
+
+async function loadTour(manifestPath: string): Promise<void> {
+  try {
+    // Read and parse manifest
+    const content = editor.readFile(manifestPath);
+    if (!content) {
+      editor.error("Failed to read tour file: " + manifestPath);
+      return;
+    }
+    const manifest: TourManifest = JSON.parse(content);
+
+    // Validate schema version
+    if (manifest.schema_version !== "1.0") {
+      editor.error(`Unsupported tour schema version: ${manifest.schema_version}`);
+      return;
+    }
+
+    // Validate steps
+    if (!manifest.steps || manifest.steps.length === 0) {
+      editor.error("Tour has no steps");
+      return;
+    }
+
+    // Check commit hash if specified
+    if (manifest.commit_hash) {
+      const result = await editor.spawnProcess("git", [
+        "rev-parse",
+        "--short",
+        "HEAD",
+      ]);
+      if (result.exit_code === 0) {
+        const currentCommit = result.stdout.trim();
+        if (!currentCommit.startsWith(manifest.commit_hash) &&
+            !manifest.commit_hash.startsWith(currentCommit)) {
+          editor.warn(
+            `Tour was created for commit ${manifest.commit_hash}, current: ${currentCommit}`
+          );
+        }
+      }
+    }
+
+    // Initialize tour
+    tourManager.manifest = manifest;
+    tourManager.state = { kind: "active", currentStep: 0, isPaused: false };
+
+    // Navigate to first step
+    await navigateToStep(0);
+
+    // Set tour context for keybindings
+    editor.setContext("tour-active", true);
+  } catch (e) {
+    editor.error(`Failed to load tour: ${e}`);
+  }
+}
+
+function exitTour(): void {
+  if (tourManager.state.kind !== "active") return;
+
+  // Clear overlays
+  clearTourOverlays();
+
+  // Reset state
+  tourManager.state = { kind: "idle" };
+  tourManager.manifest = null;
+
+  // Clear context
+  editor.setContext("tour-active", false);
+
+  editor.setStatus("Tour ended");
+}
+
+async function nextStep(): Promise<void> {
+  if (tourManager.state.kind !== "active" || !tourManager.manifest) return;
+
+  const newIndex = tourManager.state.currentStep + 1;
+  if (newIndex >= tourManager.manifest.steps.length) {
+    editor.setStatus("Tour: Already at last step");
+    return;
+  }
+
+  tourManager.state = { ...tourManager.state, currentStep: newIndex, isPaused: false };
+  await navigateToStep(newIndex);
+}
+
+async function prevStep(): Promise<void> {
+  if (tourManager.state.kind !== "active" || !tourManager.manifest) return;
+
+  const newIndex = tourManager.state.currentStep - 1;
+  if (newIndex < 0) {
+    editor.setStatus("Tour: Already at first step");
+    return;
+  }
+
+  tourManager.state = { ...tourManager.state, currentStep: newIndex, isPaused: false };
+  await navigateToStep(newIndex);
+}
+
+// ============================================================================
+// Command Handlers
+// ============================================================================
+
+globalThis.tour_load = async function (): Promise<void> {
+  // Prompt for tour file
+  const result = await editor.prompt("Enter tour file path:", ".fresh-tour.json");
+
+  if (result) {
+    await loadTour(result);
+  }
+};
+
+globalThis.tour_next = async function (): Promise<void> {
+  await nextStep();
+};
+
+globalThis.tour_prev = async function (): Promise<void> {
+  await prevStep();
+};
+
+globalThis.tour_exit = function (): void {
+  exitTour();
+};
+
+// ============================================================================
+// Registration
+// ============================================================================
+
+// Register commands
+editor.registerCommand(
+  "Tour: Load Definition...",
+  "Load a .fresh-tour.json file to start a guided code tour",
+  "tour_load",
+  null
+);
+
+editor.registerCommand(
+  "Tour: Next Step",
+  "Go to the next step in the tour",
+  "tour_next",
+  "tour-active"
+);
+
+editor.registerCommand(
+  "Tour: Previous Step",
+  "Go to the previous step in the tour",
+  "tour_prev",
+  "tour-active"
+);
+
+editor.registerCommand(
+  "Tour: Exit",
+  "Exit the current tour",
+  "tour_exit",
+  "tour-active"
+);
+
+// Subscribe to action popup results for navigation buttons
+editor.on("action_popup_result", "tour_on_action_popup_result");
+
+editor.debug("Code Tour plugin loaded");

package/plugins/lib/fresh.d.ts

@@ -736,6 +736,22 @@ interface EditorAPI {
 	*/
 	getLineStartPosition(line: number): Promise<number | null>;
 	/**
+	* Get the byte offset of the end of a line (0-indexed line number)
+	* Returns the position after the last character of the line (before newline)
+	* Returns null if the line number is out of range
+	*/
+	getLineEndPosition(line: number): Promise<number | null>;
+	/**
+	* Get the total number of lines in the active buffer
+	* Returns null if buffer not found
+	*/
+	getBufferLineCount(): Promise<number | null>;
+	/**
+	* Scroll a split to center a specific line in the viewport
+	* Line is 0-indexed (0 = first line)
+	*/
+	scrollToLineCenter(splitId: number, bufferId: number, line: number): boolean;
+	/**
 	* Find buffer by file path, returns buffer ID or 0 if not found
 	*/
 	findBufferByPath(path: string): number;
@@ -957,10 +973,13 @@ interface EditorAPI {
 	/**
 	* 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
+	* Accepts tokens in the simple format:
+	* {kind: "text"|"newline"|"space"|"break", text: "...", sourceOffset: N, style?: {...}}
+	* 
+	* Also accepts the TypeScript-defined format for backwards compatibility:
+	* {kind: {Text: "..."} | "Newline" | "Space" | "Break", source_offset: N, style?: {...}}
 	*/
-	submitViewTransform(bufferId: number, splitId: number | null, start: number, end: number, tokens: Record<string, unknown>[], LayoutHints?: Record<string, unknown>): boolean;
+	submitViewTransform(bufferId: number, splitId: number | null, start: number, end: number, tokens: Record<string, unknown>[], layoutHints?: Record<string, unknown>): boolean;
 	/**
 	* Clear view transform for a buffer/split
 	*/
@@ -1069,6 +1088,10 @@ interface EditorAPI {
 	*/
 	setLineNumbers(bufferId: number, enabled: boolean): boolean;
 	/**
+	* Enable or disable line wrapping for a buffer/split
+	*/
+	setLineWrap(bufferId: number, splitId: number | null, enabled: boolean): boolean;
+	/**
 	* Create a scroll sync group for anchor-based synchronized scrolling
 	*/
 	createScrollSyncGroup(groupId: number, leftSplit: number, rightSplit: number): boolean;