@fresh-editor/fresh-editor 0.2.17 → 0.2.18

package/plugins/perl-lsp.ts

@@ -0,0 +1,118 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Perl LSP Helper Plugin
+ *
+ * Server: PerlNavigator (github.com/bscan/PerlNavigator)
+ * VS Code: "Perl Navigator" extension
+ * Neovim: nvim-lspconfig perlnavigator
+ * Alternative: Perl::LanguageServer (cpan, older)
+ * Note: PerlNavigator includes perlcritic and perltidy integration
+ */
+
+interface LspServerErrorData {
+  language: string;
+  server_command: string;
+  error_type: string;
+  message: string;
+}
+
+interface LspStatusClickedData {
+  language: string;
+  has_error: boolean;
+}
+
+interface ActionPopupResultData {
+  popup_id: string;
+  action_id: string;
+}
+
+const INSTALL_COMMANDS = {
+  npm: "npm install -g perlnavigator-server",
+  cpan_alt: "cpanm Perl::LanguageServer",
+};
+
+let perlLspError: { serverCommand: string; message: string } | null = null;
+
+function on_perl_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "perl") {
+    return;
+  }
+
+  editor.debug(`perl-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  perlLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Perl LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Perl LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_perl_lsp_server_error", on_perl_lsp_server_error);
+editor.on("lsp_server_error", "on_perl_lsp_server_error");
+
+function on_perl_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "perl" || !perlLspError) {
+    return;
+  }
+
+  editor.debug("perl-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "perl-lsp-help",
+    title: "Perl Language Server Not Found",
+    message: `"${perlLspError.serverCommand}" (PerlNavigator) provides completion, diagnostics, navigation, and perlcritic/perltidy integration for Perl.\n\nAlternative: Perl::LanguageServer (older, via CPAN).\nVS Code users: Install the "Perl Navigator" extension.\nSee: https://github.com/bscan/PerlNavigator`,
+    actions: [
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_cpan", label: `Copy: ${INSTALL_COMMANDS.cpan_alt}` },
+      { id: "disable", label: "Disable Perl LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_perl_lsp_status_clicked", on_perl_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_perl_lsp_status_clicked");
+
+function on_perl_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "perl-lsp-help") {
+    return;
+  }
+
+  editor.debug(`perl-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_npm":
+      editor.setClipboard(INSTALL_COMMANDS.npm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.npm);
+      break;
+
+    case "copy_cpan":
+      editor.setClipboard(INSTALL_COMMANDS.cpan_alt);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.cpan_alt);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("perl");
+      editor.setStatus("Perl LSP disabled");
+      perlLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`perl-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_perl_lsp_action_result", on_perl_lsp_action_result);
+editor.on("action_popup_result", "on_perl_lsp_action_result");
+
+editor.debug("perl-lsp: Plugin loaded");

package/plugins/php-lsp.ts

@@ -0,0 +1,165 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * PHP LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for PHP LSP server issues.
+ * When phpactor fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects PHP LSP server errors (phpactor)
+ * - Shows popup with install commands (composer, brew)
+ * - Allows copying install commands to clipboard
+ * - Provides option to disable PHP LSP
+ *
+ * Alternatives:
+ * - Intelephense: Feature-rich PHP LSP (https://intelephense.com/) - npm i -g intelephense
+ * - PHPStan: Static analysis tool (https://phpstan.org/)
+ * - Psalm: PHP static analysis (https://psalm.dev/)
+ */
+
+interface LspServerErrorData {
+  language: string;
+  server_command: string;
+  error_type: string;
+  message: string;
+}
+
+interface LspStatusClickedData {
+  language: string;
+  has_error: boolean;
+}
+
+interface ActionPopupResultData {
+  popup_id: string;
+  action_id: string;
+}
+
+// Install commands for PHP LSP server (phpactor)
+// See: https://phpactor.readthedocs.io/en/master/usage/getting-started.html
+const INSTALL_COMMANDS = {
+  composer: "composer global require phpactor/phpactor",
+  brew: "brew install phpactor",
+};
+
+// Alternative LSP server
+const ALT_INSTALL = "npm i -g intelephense";
+
+// Track error state for PHP LSP
+let phpLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for PHP
+ */
+function on_php_lsp_server_error(data: LspServerErrorData): void {
+  // Only handle PHP language errors
+  if (data.language !== "php") {
+    return;
+  }
+
+  editor.debug(`php-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  // Store error state for later reference
+  phpLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  // Show a status message for immediate feedback
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `PHP LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`PHP LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_php_lsp_server_error", on_php_lsp_server_error);
+
+// Register hook for LSP server errors
+editor.on("lsp_server_error", "on_php_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a PHP LSP error
+ */
+function on_php_lsp_status_clicked(
+  data: LspStatusClickedData
+): void {
+  // Only handle PHP language clicks when there's an error
+  if (data.language !== "php" || !phpLspError) {
+    return;
+  }
+
+  editor.debug("php-lsp: Status clicked, showing help popup");
+
+  // Show action popup with install options
+  editor.showActionPopup({
+    id: "php-lsp-help",
+    title: "PHP Language Server Not Found",
+    message: `"${phpLspError.serverCommand}" provides code completion, diagnostics, and navigation for PHP files. Requires PHP and Composer. Copy a command below to install it, or visit https://phpactor.readthedocs.io for details. Alternative: Intelephense (https://intelephense.com/) is a popular Node.js-based PHP LSP.`,
+    actions: [
+      { id: "copy_composer", label: `Copy: ${INSTALL_COMMANDS.composer}` },
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_alt", label: `Alternative: ${ALT_INSTALL}` },
+      { id: "disable", label: "Disable PHP LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_php_lsp_status_clicked", on_php_lsp_status_clicked);
+
+// Register hook for status bar clicks
+editor.on("lsp_status_clicked", "on_php_lsp_status_clicked");
+
+/**
+ * Handle action popup results for PHP LSP help
+ */
+function on_php_lsp_action_result(
+  data: ActionPopupResultData
+): void {
+  // Only handle our popup
+  if (data.popup_id !== "php-lsp-help") {
+    return;
+  }
+
+  editor.debug(`php-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_composer":
+      editor.setClipboard(INSTALL_COMMANDS.composer);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.composer);
+      break;
+
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_alt":
+      editor.setClipboard(ALT_INSTALL);
+      editor.setStatus("Copied: " + ALT_INSTALL);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("php");
+      editor.setStatus("PHP LSP disabled");
+      phpLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      // Just close the popup without action
+      break;
+
+    default:
+      editor.debug(`php-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_php_lsp_action_result", on_php_lsp_action_result);
+
+// Register hook for action popup results
+editor.on("action_popup_result", "on_php_lsp_action_result");
+
+editor.debug("php-lsp: Plugin loaded");

package/plugins/pkg.ts

@@ -231,14 +231,10 @@ interface ParsedPackageUrl {
 // =============================================================================
 
 /**
- * Ensure a directory exists
+ * Ensure a directory exists (cross-platform)
  */
-async function ensureDir(path: string): Promise<boolean> {
-  if (editor.fileExists(path)) {
-    return true;
-  }
-  const result = await editor.spawnProcess("mkdir", ["-p", path]);
-  return result.exit_code === 0;
+function ensureDir(path: string): boolean {
+  return editor.createDir(path);
 }
 
 /**
@@ -395,7 +391,7 @@ async function writeJsonFile(path: string, data: unknown): Promise<boolean> {
 async function syncRegistry(): Promise<void> {
   editor.setStatus("Syncing package registry...");
 
-  await ensureDir(INDEX_DIR);
+  ensureDir(INDEX_DIR);
 
   const sources = getRegistrySources();
   let synced = 0;
@@ -493,7 +489,7 @@ function loadRegistry(type: "plugins" | "themes" | "languages"): RegistryData {
  * Cache registry data locally for offline/fast access
  */
 async function cacheRegistry(): Promise<void> {
-  await ensureDir(CACHE_DIR);
+  ensureDir(CACHE_DIR);
   const sources = getRegistrySources();
 
   for (const source of sources) {
@@ -823,7 +819,7 @@ async function installFromRepo(
   version?: string
 ): Promise<boolean> {
   // Clone to temp directory first to detect package type
-  const tempDir = `/tmp/fresh-pkg-clone-${hashString(repoUrl)}-${Date.now()}`;
+  const tempDir = editor.pathJoin(editor.getTempDir(), `fresh-pkg-clone-${hashString(repoUrl)}-${Date.now()}`);
 
   const cloneArgs = ["clone"];
   if (!version || version === "latest") {
@@ -857,7 +853,7 @@ async function installFromRepo(
     editor.warn(`[pkg] Invalid package '${packageName}': ${validation.error}`);
     editor.setStatus(`Failed to install ${packageName}: ${validation.error}`);
     // Clean up
-    await editor.spawnProcess("rm", ["-rf", tempDir]);
+    editor.removePath(tempDir);
     return false;
   }
 
@@ -877,16 +873,15 @@ async function installFromRepo(
   // Check if already installed in correct location
   if (editor.fileExists(correctTargetDir)) {
     editor.setStatus(`Package '${packageName}' is already installed`);
-    await editor.spawnProcess("rm", ["-rf", tempDir]);
+    editor.removePath(tempDir);
     return false;
   }
 
   // Ensure correct directory exists and move from temp
-  await ensureDir(correctPackagesDir);
-  const moveResult = await editor.spawnProcess("mv", [tempDir, correctTargetDir]);
-  if (moveResult.exit_code !== 0) {
-    editor.setStatus(`Failed to install ${packageName}: ${moveResult.stderr}`);
-    await editor.spawnProcess("rm", ["-rf", tempDir]);
+  ensureDir(correctPackagesDir);
+  if (!editor.renamePath(tempDir, correctTargetDir)) {
+    editor.setStatus(`Failed to install ${packageName}: could not move package to target directory`);
+    editor.removePath(tempDir);
     return false;
   }
 
@@ -976,13 +971,12 @@ async function installFromLocalPath(
   }
 
   // Ensure correct directory exists
-  await ensureDir(correctPackagesDir);
+  ensureDir(correctPackagesDir);
 
   // Copy the directory to correct target
   editor.setStatus(`Copying from ${sourcePath}...`);
-  const copyResult = await editor.spawnProcess("cp", ["-r", sourcePath, correctTargetDir]);
-  if (copyResult.exit_code !== 0) {
-    editor.setStatus(`Failed to copy package: ${copyResult.stderr}`);
+  if (!editor.copyPath(sourcePath, correctTargetDir)) {
+    editor.setStatus(`Failed to copy package from ${sourcePath}`);
     return false;
   }
 
@@ -992,7 +986,7 @@ async function installFromLocalPath(
     editor.warn(`[pkg] Invalid package '${packageName}': ${validation.error}`);
     editor.setStatus(`Failed to install ${packageName}: ${validation.error}`);
     // Clean up the invalid package
-    await editor.spawnProcess("rm", ["-rf", correctTargetDir]);
+    editor.removePath(correctTargetDir);
     return false;
   }
 
@@ -1037,7 +1031,7 @@ async function installFromMonorepo(
   packageName: string,
   version?: string
 ): Promise<boolean> {
-  const tempDir = `/tmp/fresh-pkg-${hashString(parsed.repoUrl)}-${Date.now()}`;
+  const tempDir = editor.pathJoin(editor.getTempDir(), `fresh-pkg-${hashString(parsed.repoUrl)}-${Date.now()}`);
 
   try {
     // Clone the full repo to temp
@@ -1068,7 +1062,7 @@ async function installFromMonorepo(
     const subpathDir = editor.pathJoin(tempDir, parsed.subpath!);
     if (!editor.fileExists(subpathDir)) {
       editor.setStatus(`Subpath '${parsed.subpath}' not found in repository`);
-      await editor.spawnProcess("rm", ["-rf", tempDir]);
+      editor.removePath(tempDir);
       return false;
     }
 
@@ -1077,7 +1071,7 @@ async function installFromMonorepo(
     if (!validation.valid) {
       editor.warn(`[pkg] Invalid package '${packageName}': ${validation.error}`);
       editor.setStatus(`Failed to install ${packageName}: ${validation.error}`);
-      await editor.spawnProcess("rm", ["-rf", tempDir]);
+      editor.removePath(tempDir);
       return false;
     }
 
@@ -1097,19 +1091,18 @@ async function installFromMonorepo(
     // Check if already installed
     if (editor.fileExists(correctTargetDir)) {
       editor.setStatus(`Package '${packageName}' is already installed`);
-      await editor.spawnProcess("rm", ["-rf", tempDir]);
+      editor.removePath(tempDir);
       return false;
     }
 
     // Ensure correct directory exists
-    await ensureDir(correctPackagesDir);
+    ensureDir(correctPackagesDir);
 
     // Copy subdirectory to correct target
     editor.setStatus(`Installing ${packageName} from ${parsed.subpath}...`);
-    const copyResult = await editor.spawnProcess("cp", ["-r", subpathDir, correctTargetDir]);
-    if (copyResult.exit_code !== 0) {
-      editor.setStatus(`Failed to copy package: ${copyResult.stderr}`);
-      await editor.spawnProcess("rm", ["-rf", tempDir]);
+    if (!editor.copyPath(subpathDir, correctTargetDir)) {
+      editor.setStatus(`Failed to copy package from ${parsed.subpath}`);
+      editor.removePath(tempDir);
       return false;
     }
 
@@ -1143,7 +1136,7 @@ async function installFromMonorepo(
     return true;
   } finally {
     // Cleanup temp directory
-    await editor.spawnProcess("rm", ["-rf", tempDir]);
+    editor.removePath(tempDir);
   }
 }
 
@@ -1408,16 +1401,14 @@ async function reinstallPackage(pkg: InstalledPackage): Promise<boolean> {
   }
 
   // Remove old copy
-  const rmResult = await editor.spawnProcess("rm", ["-rf", pkg.path]);
-  if (rmResult.exit_code !== 0) {
-    editor.setStatus(`Failed to remove old copy: ${rmResult.stderr}`);
+  if (!editor.removePath(pkg.path)) {
+    editor.setStatus(`Failed to remove old copy of ${pkg.name}`);
     return false;
   }
 
   // Re-copy from source
-  const copyResult = await editor.spawnProcess("cp", ["-r", sourcePath, pkg.path]);
-  if (copyResult.exit_code !== 0) {
-    editor.setStatus(`Failed to copy from source: ${copyResult.stderr}`);
+  if (!editor.copyPath(sourcePath, pkg.path)) {
+    editor.setStatus(`Failed to copy from source: ${sourcePath}`);
     return false;
   }
 
@@ -1474,13 +1465,8 @@ async function removePackage(pkg: InstalledPackage): Promise<boolean> {
     }
   }
 
-  // Use trash if available, otherwise rm -rf
-  let result = await editor.spawnProcess("trash", [pkg.path]);
-  if (result.exit_code !== 0) {
-    result = await editor.spawnProcess("rm", ["-rf", pkg.path]);
-  }
-
-  if (result.exit_code === 0) {
+  // Remove package directory
+  if (editor.removePath(pkg.path)) {
     // Reload themes if we removed a theme so Select Theme list is updated
     if (pkg.type === "theme") {
       editor.reloadThemes();
@@ -1488,7 +1474,7 @@ async function removePackage(pkg: InstalledPackage): Promise<boolean> {
     editor.setStatus(`Removed ${pkg.name}`);
     return true;
   } else {
-    editor.setStatus(`Failed to remove ${pkg.name}: ${result.stderr}`);
+    editor.setStatus(`Failed to remove ${pkg.name}`);
     return false;
   }
 }
@@ -1608,7 +1594,7 @@ async function installFromLockfile(): Promise<void> {
       }
     } else {
       // Need to clone
-      await ensureDir(PACKAGES_DIR);
+      ensureDir(PACKAGES_DIR);
       const result = await gitCommand(["clone", `${entry.source}`, `${pluginPath}`]);
 
       if (result.exit_code === 0) {

package/plugins/protobuf-lsp.ts

@@ -0,0 +1,144 @@
+/// <reference path="./lib/fresh.d.ts" />
+const editor = getEditor();
+
+/**
+ * Protobuf LSP Helper Plugin
+ *
+ * Provides user-friendly error handling for Protobuf LSP server issues.
+ * When buf fails to start, this plugin shows an actionable
+ * popup with installation instructions.
+ *
+ * Features:
+ * - Detects Protobuf LSP server errors (buf)
+ * - Shows popup with install commands (brew, npm, etc.)
+ * - Provides option to disable Protobuf LSP
+ *
+ * VS Code: "Buf" extension (auto-installs buf CLI), "Protobuf support" by peterj
+ * Neovim: nvim-lspconfig bufls
+ * Alternative: protols (open-source, tree-sitter based, standalone)
+ */
+
+interface LspServerErrorData {
+  language: string;
+  server_command: string;
+  error_type: string;
+  message: string;
+}
+
+interface LspStatusClickedData {
+  language: string;
+  has_error: boolean;
+}
+
+interface ActionPopupResultData {
+  popup_id: string;
+  action_id: string;
+}
+
+// Install commands for Protobuf LSP server (buf)
+// See: https://buf.build/docs/installation
+const INSTALL_COMMANDS = {
+  brew: "brew install bufbuild/buf/buf",
+  npm: "npm i -g @bufbuild/buf",
+  go: "go install github.com/bufbuild/buf/cmd/buf@latest",
+};
+
+// Track error state for Protobuf LSP
+let protobufLspError: { serverCommand: string; message: string } | null = null;
+
+/**
+ * Handle LSP server errors for Protobuf
+ */
+function on_protobuf_lsp_server_error(data: LspServerErrorData): void {
+  if (data.language !== "protobuf") {
+    return;
+  }
+
+  editor.debug(`protobuf-lsp: Server error - ${data.error_type}: ${data.message}`);
+
+  protobufLspError = {
+    serverCommand: data.server_command,
+    message: data.message,
+  };
+
+  if (data.error_type === "not_found") {
+    editor.setStatus(
+      `Protobuf LSP server '${data.server_command}' not found. Click status bar for help.`
+    );
+  } else {
+    editor.setStatus(`Protobuf LSP error: ${data.message}`);
+  }
+}
+registerHandler("on_protobuf_lsp_server_error", on_protobuf_lsp_server_error);
+editor.on("lsp_server_error", "on_protobuf_lsp_server_error");
+
+/**
+ * Handle status bar click when there's a Protobuf LSP error
+ */
+function on_protobuf_lsp_status_clicked(data: LspStatusClickedData): void {
+  if (data.language !== "protobuf" || !protobufLspError) {
+    return;
+  }
+
+  editor.debug("protobuf-lsp: Status clicked, showing help popup");
+
+  editor.showActionPopup({
+    id: "protobuf-lsp-help",
+    title: "Protobuf Language Server Not Found",
+    message: `"${protobufLspError.serverCommand}" (Buf CLI) provides code completion, diagnostics, linting, and formatting for Protocol Buffer files. Copy a command below to install it, or visit https://buf.build/docs/installation for details.`,
+    actions: [
+      { id: "copy_brew", label: `Copy: ${INSTALL_COMMANDS.brew}` },
+      { id: "copy_npm", label: `Copy: ${INSTALL_COMMANDS.npm}` },
+      { id: "copy_go", label: `Copy: ${INSTALL_COMMANDS.go}` },
+      { id: "disable", label: "Disable Protobuf LSP" },
+      { id: "dismiss", label: "Dismiss (ESC)" },
+    ],
+  });
+}
+registerHandler("on_protobuf_lsp_status_clicked", on_protobuf_lsp_status_clicked);
+editor.on("lsp_status_clicked", "on_protobuf_lsp_status_clicked");
+
+/**
+ * Handle action popup results for Protobuf LSP help
+ */
+function on_protobuf_lsp_action_result(data: ActionPopupResultData): void {
+  if (data.popup_id !== "protobuf-lsp-help") {
+    return;
+  }
+
+  editor.debug(`protobuf-lsp: Action selected - ${data.action_id}`);
+
+  switch (data.action_id) {
+    case "copy_brew":
+      editor.setClipboard(INSTALL_COMMANDS.brew);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.brew);
+      break;
+
+    case "copy_npm":
+      editor.setClipboard(INSTALL_COMMANDS.npm);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.npm);
+      break;
+
+    case "copy_go":
+      editor.setClipboard(INSTALL_COMMANDS.go);
+      editor.setStatus("Copied: " + INSTALL_COMMANDS.go);
+      break;
+
+    case "disable":
+      editor.disableLspForLanguage("protobuf");
+      editor.setStatus("Protobuf LSP disabled");
+      protobufLspError = null;
+      break;
+
+    case "dismiss":
+    case "dismissed":
+      break;
+
+    default:
+      editor.debug(`protobuf-lsp: Unknown action: ${data.action_id}`);
+  }
+}
+registerHandler("on_protobuf_lsp_action_result", on_protobuf_lsp_action_result);
+editor.on("action_popup_result", "on_protobuf_lsp_action_result");
+
+editor.debug("protobuf-lsp: Plugin loaded");