@fresh-editor/fresh-editor 0.1.98 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,103 @@
 # Release Notes
 
+## 0.2.0
+
+### Features
+
+* Experimental **Session Persistence**: Detach from and reattach to editor sessions with full state preservation. Start with `fresh -a <name>` or `fresh -a` (directory-based), detach via File menu or command palette. Sessions persist across terminal disconnections. Use `fresh --cmd session list/kill/attach` and `fresh --cmd session open-file NAME FILES` to manage sessions from the command line. Allows using Fresh across other applications, e.g. yazi edit action triggers a file open in Fresh.
+
+* **Keybinding Editor**: Full-featured editor for customizing keybindings. Search by text or record key, filter by context/source, add/edit/delete bindings with conflict detection and autocomplete. Try menus: Edit..Keybinding Editor, or command palette. Changes are saved in config.json
+
+### Improvements
+
+* **Line Editing**: Move lines up/down and duplicate lines, matching modern editor behavior. Multi-cursor support (@Asuka-Minato).
+
+* **Triple-Click Selection**: Triple-click selects entire line (#597).
+
+* **Vietnamese Localization**: Full Vietnamese (Tiếng Việt) language support.
+
+* **Typst Language Support**: Syntax highlighting and tinymist LSP configuration for `.typ` files (#944).
+
+* **LSP Improvements**:
+  - Per-buffer LSP toggle command to enable/disable LSP for individual files
+  - Default LSP configs for bash, lua, ruby, php, yaml, toml (#946)
+
+### Bug Fixes
+
+* **LSP Document Sync**: Fixed document corruption when LSP servers received didChange after didOpen, and when bulk edits (selection replacement, multi-cursor) bypassed LSP notifications.
+
+* **LSP Completion Popup**: Fixed popup swallowing non-word characters, arrow keys, and other keys. Popup now dismisses correctly allowing keystrokes to pass through (#931)
+
+* **LSP Diagnostics**: Fixed diagnostic gutter markers not appearing on implicit trailing lines with zero-width ranges (clangd-style diagnostics).
+
+* **Line Wrapping**: End/Home keys now navigate by visual line when wrapping is enabled, matching VS Code/Notepad behavior (#979).
+
+* **Syntax Highlighting**: Fixed highlighting lost when saving files without extension (shebang detection) outside working directory (#978).
+
+* **Buffer Settings**: User-configured tab size, indentation, and line numbers now preserved across auto-revert.
+
+* **Terminal Scrollback**: Any character key exits scrollback mode instead of just 'q' (#863).
+
+* **32-bit ARM Build**: Fixed setrlimit type mismatch on ARMv7l platforms (#957).
+
+### Configuration
+
+* Added C++20 module extensions (.cppm, .ixx) for C++ syntax highlighting (#955).
+
+### Documentation
+
+* Added FreeBSD installation note (@lwhsu).
+
+---
+
+## 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

package/README.md

@@ -6,6 +6,8 @@ A terminal-based text editor. [Official Website →](https://sinelaw.github.io/f
 
 **[Contributing](#contributing)**
 
+**[Discord](https://discord.gg/qUutBj9t)**
+
 ## Why?
 
 Why another text editor? Fresh brings the intuitive, conventional UX of editors like VS Code and Sublime Text to the terminal.
@@ -57,9 +59,11 @@ Or, pick your preferred method:
 |----------|--------|
 | macOS | [brew](#brew) |
 | Bazzite/Bluefin/Aurora Linux | [brew](#brew) |
+| Windows | [winget](#windows-winget) |
 | Arch Linux | [AUR](#arch-linux-aur) |
 | Debian/Ubuntu | [.deb](#debianubuntu-deb) |
 | Fedora/RHEL | [.rpm](#fedorarhelopensuse-rpm), [Terra](https://terra.fyralabs.com/) |
+| FreeBSD | [ports / pkg](https://www.freshports.org/editors/fresh) |
 | Linux (any distro) | [AppImage](#appimage), [Flatpak](#flatpak) |
 | All platforms | [Pre-built binaries](#pre-built-binaries) |
 | npm | [npm / npx](#npm) |
@@ -79,6 +83,14 @@ brew tap sinelaw/fresh
 brew install fresh-editor
 ```
 
+### Windows (winget)
+
+```bash
+winget install fresh-editor
+```
+
+Alternatively, Windows users can use [npm](#npm).
+
 ### Arch Linux ([AUR](https://aur.archlinux.org/packages/fresh-editor-bin))
 
 **Binary package (recommended, faster install):**

package/package.json

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

package/plugins/audit_mode.i18n.json

@@ -755,6 +755,69 @@
     "panel.help_export_footer": "ЕКСПОРТ: [E]кспорт до .review/session.md  |  [O]загальний  [r]оновити",
     "debug.loaded": "Плагін рев'ю змін завантажено з підтримкою коментарів"
   },
+  "vi": {
+    "cmd.review_diff": "Xem xét khác biệt",
+    "cmd.review_diff_desc": "Bắt đầu phiên xem xét mã",
+    "cmd.stop_review_diff": "Dừng xem xét",
+    "cmd.stop_review_diff_desc": "Dừng phiên xem xét",
+    "cmd.refresh_review_diff": "Làm mới khác biệt",
+    "cmd.refresh_review_diff_desc": "Làm mới danh sách thay đổi",
+    "cmd.side_by_side_diff": "So sánh song song",
+    "cmd.side_by_side_diff_desc": "Hiển thị khác biệt song song cho tệp hiện tại",
+    "cmd.add_comment": "Xem xét: Thêm nhận xét",
+    "cmd.add_comment_desc": "Thêm nhận xét xem xét cho khối hiện tại",
+    "cmd.approve_hunk": "Xem xét: Duyệt khối",
+    "cmd.approve_hunk_desc": "Đánh dấu khối đã duyệt",
+    "cmd.reject_hunk": "Xem xét: Từ chối khối",
+    "cmd.reject_hunk_desc": "Đánh dấu khối bị từ chối",
+    "cmd.needs_changes": "Xem xét: Cần thay đổi",
+    "cmd.needs_changes_desc": "Đánh dấu khối cần thay đổi",
+    "cmd.question": "Xem xét: Câu hỏi",
+    "cmd.question_desc": "Đánh dấu khối với câu hỏi",
+    "cmd.clear_status": "Xem xét: Xóa trạng thái",
+    "cmd.clear_status_desc": "Xóa trạng thái xem xét của khối",
+    "cmd.overall_feedback": "Xem xét: Phản hồi tổng thể",
+    "cmd.overall_feedback_desc": "Đặt phản hồi tổng thể cho xem xét",
+    "cmd.export_markdown": "Xem xét: Xuất ra Markdown",
+    "cmd.export_markdown_desc": "Xuất xem xét ra .review/session.md",
+    "cmd.export_json": "Xem xét: Xuất ra JSON",
+    "cmd.export_json_desc": "Xuất xem xét ra .review/session.json",
+    "status.refreshing": "Đang làm mới khác biệt xem xét...",
+    "status.updated": "Đã cập nhật khác biệt xem xét. Tìm thấy %{count} khối.",
+    "status.loading_diff": "Đang tải so sánh song song...",
+    "status.not_git_repo": "Không trong kho git",
+    "status.failed_old_version": "Không thể tải phiên bản cũ của tệp",
+    "status.failed_new_version": "Không thể tải phiên bản mới của tệp",
+    "status.diff_summary": "So sánh song song: +%{added} -%{removed} ~%{modified} | 'q' để quay lại",
+    "status.no_hunk_selected": "Chưa chọn khối để nhận xét",
+    "status.comment_added": "Đã thêm nhận xét vào %{line}",
+    "status.comment_cancelled": "Đã hủy nhận xét",
+    "status.hunk_approved": "Đã duyệt khối",
+    "status.hunk_rejected": "Đã từ chối khối",
+    "status.hunk_needs_changes": "Đã đánh dấu khối cần thay đổi",
+    "status.hunk_question": "Đã đánh dấu khối với câu hỏi",
+    "status.hunk_status_cleared": "Đã xóa trạng thái xem xét của khối",
+    "status.feedback_set": "Đã đặt phản hồi tổng thể",
+    "status.feedback_cleared": "Đã xóa phản hồi tổng thể",
+    "status.exported": "Đã xuất xem xét ra %{path}",
+    "status.generating": "Đang tạo luồng khác biệt xem xét...",
+    "status.review_summary": "Xem xét: %{count} khối | [c]nhận xét [a]duyệt [x]từ chối [!]thay đổi [?]câu hỏi [E]xuất",
+    "status.stopped": "Đã dừng chế độ xem xét khác biệt.",
+    "status.no_file_open": "Không có tệp mở - không thể hiển thị khác biệt",
+    "status.failed_git_diff": "Không thể lấy git diff cho tệp",
+    "status.no_changes": "Không có thay đổi trong tệp này",
+    "status.failed_old_new_file": "Không thể tải phiên bản cũ của tệp (tệp có thể là mới)",
+    "prompt.comment": "Nhận xét trên %{line}: ",
+    "prompt.overall_feedback": "Phản hồi tổng thể: ",
+    "panel.no_changes": "Không có thay đổi để xem xét.",
+    "panel.help_review": "XEM XÉT: [c]nhận xét [a]duyệt [x]từ chối [!]thay đổi [?]câu hỏi [u]hoàn tác",
+    "panel.help_stage": "STAGE: [s]tage [d]bỏ | NAV: [n]tiếp [p]trước [Enter]chi tiết [q]thoát",
+    "panel.help_export": "XUẤT: [E] .review/session.md | [O]tổng thể | [r]làm mới",
+    "panel.help_review_footer": "XEM XÉT: [c]nhận xét  [a]duyệt  [x]từ chối  [!]cần thay đổi  [?]câu hỏi  [u]hoàn tác",
+    "panel.help_stage_footer": "STAGE:  [s]tage    [d]bỏ  |  NAV: [n]tiếp [p]trước [Enter]chi tiết  [q]thoát",
+    "panel.help_export_footer": "XUẤT: [E]xuất ra .review/session.md  |  [O]tổng thể  [r]làm mới",
+    "debug.loaded": "Plugin xem xét khác biệt đã tải với hỗ trợ nhận xét"
+  },
   "zh-CN": {
     "cmd.review_diff": "审查差异",
     "cmd.review_diff_desc": "开始代码审查会话",

package/plugins/buffer_modified.i18n.json

@@ -59,6 +59,11 @@
     "status.initialized": "Buffer Modified: ініціалізовано для %{path}",
     "status.cleared_on_save": "Buffer Modified: очищено при збереженні"
   },
+  "vi": {
+    "status.loaded": "Đã tải plugin Buffer Modified",
+    "status.initialized": "Buffer Modified: đã khởi tạo cho %{path}",
+    "status.cleared_on_save": "Buffer Modified: đã xóa khi lưu"
+  },
   "zh-CN": {
     "status.loaded": "Buffer Modified插件已加载",
     "status.initialized": "Buffer Modified: 已为%{path}初始化",

package/plugins/clangd_support.i18n.json

@@ -203,6 +203,23 @@
     "status.config_not_found": "Не вдалося знайти конфігурацію .clangd у робочому просторі",
     "status.file_status": "Статус файлу Clangd: %{status}"
   },
+  "vi": {
+    "cmd.project_setup": "Clangd: Thiết lập Dự án",
+    "cmd.project_setup_desc": "Phân tích trạng thái sẵn sàng clangd C/C++ (compile_commands.json, .clangd)",
+    "cmd.switch_source_header": "Clangd: Chuyển đổi Nguồn/Header",
+    "cmd.switch_source_header_desc": "Nhảy đến cặp header/nguồn sử dụng clangd",
+    "cmd.open_project_config": "Clangd: Mở Cấu hình Dự án",
+    "cmd.open_project_config_desc": "Mở tệp .clangd gần nhất",
+    "status.plugin_loaded": "Đã tải plugin hỗ trợ Clangd (chuyển đổi header + lệnh cấu hình)",
+    "status.no_active_file": "Clangd: không có tệp đang hoạt động để chuyển đổi",
+    "status.unsupported_file_type": "Clangd: loại tệp không được hỗ trợ để chuyển đổi header",
+    "status.opened_corresponding_file": "Clangd: đã mở tệp tương ứng",
+    "status.no_matching_found": "Clangd: không tìm thấy header/nguồn phù hợp",
+    "status.switch_failed": "Clangd chuyển đổi nguồn/header thất bại: %{error}",
+    "status.opened_config": "Đã mở cấu hình .clangd",
+    "status.config_not_found": "Không tìm thấy cấu hình .clangd trong không gian làm việc",
+    "status.file_status": "Trạng thái tệp Clangd: %{status}"
+  },
   "zh-CN": {
     "cmd.project_setup": "Clangd: 项目设置",
     "cmd.project_setup_desc": "分析C/C++ clangd就绪状态 (compile_commands.json, .clangd)",

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/config-schema.json

@@ -186,6 +186,7 @@
         "ru",
         "th",
         "uk",
+        "vi",
         "zh-CN"
       ]
     },

package/plugins/csharp_support.i18n.json

@@ -71,6 +71,12 @@
     "status.restore_failed": "Помилка відновлення NuGet: %{error}",
     "status.restore_error": "Помилка відновлення NuGet: %{error}"
   },
+  "vi": {
+    "status.restoring_packages": "Đang khôi phục gói NuGet cho %{project}...",
+    "status.restore_completed": "Hoàn tất khôi phục NuGet cho %{project}",
+    "status.restore_failed": "Khôi phục NuGet thất bại: %{error}",
+    "status.restore_error": "Lỗi khôi phục NuGet: %{error}"
+  },
   "zh-CN": {
     "status.restoring_packages": "正在为%{project}恢复NuGet包...",
     "status.restore_completed": "%{project}的NuGet恢复已完成",