nvim-keymap-migrator 1.0.0

package/src/report.js

@@ -0,0 +1,81 @@
+// translation report generator
+
+function formatKeymap(item) {
+  return `${item.lhs ?? "<unknown>"} -> ${item.command ?? item.intent ?? item.raw_rhs ?? "??"}`;
+}
+
+export function generateReport(data = {}) {
+  const target = data.target ?? "unknown";
+  const configPath = data.configPath ?? "unknown";
+  const leader = data.leader ?? "<unknown>";
+  const translated = Array.isArray(data.translated) ? data.translated : [];
+  const pureVim = Array.isArray(data.pureVim) ? data.pureVim : [];
+  const manualPlugin = Array.isArray(data.manualPlugin)
+    ? data.manualPlugin
+    : [];
+  const manualOther = Array.isArray(data.manualOther) ? data.manualOther : [];
+  const unsupported = Array.isArray(data.unsupported) ? data.unsupported : [];
+  const outputs = Array.isArray(data.outputs) ? data.outputs : [];
+  const total = Number.isFinite(data.total)
+    ? data.total
+    : translated.length +
+      pureVim.length +
+      manualPlugin.length +
+      manualOther.length +
+      unsupported.length;
+
+  const lines = [];
+  lines.push("=== nvim-keymap-migrator ===");
+  lines.push(`Target: ${target}`);
+  lines.push(`Config: ${configPath}`);
+  lines.push(`Leader: ${leader}`);
+  lines.push("");
+
+  lines.push(`IDE actions (${translated.length}):`);
+  if (translated.length === 0) {
+    lines.push("  (none)");
+  } else {
+    translated.forEach((item) => lines.push(`  ${formatKeymap(item)}`));
+  }
+  lines.push("");
+
+  lines.push(`Pure Vim mappings (${pureVim.length}):`);
+  if (pureVim.length === 0) {
+    lines.push("  (none)");
+  } else {
+    pureVim.forEach((item) => lines.push(`  ${formatKeymap(item)}`));
+  }
+  lines.push("");
+
+  lines.push(`Manual plugin mappings (${manualPlugin.length}):`);
+  if (manualPlugin.length === 0) {
+    lines.push("  (none)");
+  } else {
+    manualPlugin.forEach((item) => lines.push(`  ${formatKeymap(item)}`));
+  }
+  lines.push("");
+
+  lines.push(`Manual (other) mappings (${manualOther.length}):`);
+  if (manualOther.length === 0) {
+    lines.push("  (none)");
+  } else {
+    manualOther.forEach((item) => lines.push(`  ${formatKeymap(item)}`));
+  }
+  lines.push("");
+
+  lines.push(`Unsupported (no intent) (${unsupported.length}):`);
+  if (unsupported.length === 0) {
+    lines.push("  (none)");
+  } else {
+    unsupported.forEach((item) => lines.push(`  ${formatKeymap(item)}`));
+  }
+  lines.push("");
+
+  if (outputs.length > 0) {
+    lines.push("Outputs:");
+    outputs.forEach((output) => lines.push(`  ${output}`));
+    lines.push("");
+  }
+
+  return `${lines.join("\n")}\n`;
+}

package/src/utils.js

@@ -0,0 +1,36 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = fileURLToPath(new URL("..", import.meta.url));
+const TEMPLATES_DIR = join(ROOT, "templates");
+
+const MODE_TO_MAP = {
+  n: { noremap: "nnoremap", map: "nmap" },
+  i: { noremap: "inoremap", map: "imap" },
+  v: { noremap: "vnoremap", map: "vmap" },
+  x: { noremap: "xnoremap", map: "xmap" },
+  s: { noremap: "snoremap", map: "smap" },
+  o: { noremap: "onoremap", map: "omap" },
+  c: { noremap: "cnoremap", map: "cmap" },
+  t: { noremap: "tnoremap", map: "tmap" },
+};
+
+function truthy(value) {
+  return value === true || value === 1;
+}
+
+function readString(value) {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function loadDefaults() {
+  try {
+    const raw = readFileSync(join(TEMPLATES_DIR, "defaults.json"), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return { keymaps: [] };
+  }
+}
+
+export { ROOT, TEMPLATES_DIR, MODE_TO_MAP, truthy, readString, loadDefaults };

package/templates/aliases.json

@@ -0,0 +1,31 @@
+{
+  "find files": "navigation.find_files",
+  "find file": "navigation.find_files",
+  "find-files": "navigation.find_files",
+  "switch buffer": "navigation.buffers",
+  "buffers": "navigation.buffers",
+  "recent files": "navigation.recent_files",
+  "recent file": "navigation.recent_files",
+  "live grep": "navigation.live_grep",
+  "grep": "navigation.live_grep",
+  "search in file": "navigation.grep_string",
+  "grep string": "navigation.grep_string",
+  "go to definition": "lsp.definition",
+  "goto definition": "lsp.definition",
+  "definition": "lsp.definition",
+  "go to references": "lsp.references",
+  "find references": "lsp.references",
+  "references": "lsp.references",
+  "hover": "lsp.hover",
+  "show hover": "lsp.hover",
+  "rename": "lsp.rename",
+  "code action": "lsp.code_action",
+  "quick fix": "lsp.code_action",
+  "format": "editing.format",
+  "format document": "editing.format",
+  "comment": "editing.comment_toggle",
+  "comment toggle": "editing.comment_toggle",
+  "move line up": "editing.move_line_up",
+  "move line down": "editing.move_line_down",
+  "delete line": "editing.delete_line"
+}

package/templates/defaults.json

@@ -0,0 +1,11 @@
+{
+  "keymaps": [
+    { "lhs": "gd", "mode": "n", "intent": "lsp.definition" },
+    { "lhs": "gD", "mode": "n", "intent": "lsp.declaration" },
+    { "lhs": "gr", "mode": "n", "intent": "lsp.references" },
+    { "lhs": "gi", "mode": "n", "intent": "lsp.implementation" },
+    { "lhs": "<C-k>", "mode": "n", "intent": "lsp.signature_help" },
+    { "lhs": "[d", "mode": "n", "intent": "lsp.diagnostic_prev" },
+    { "lhs": "]d", "mode": "n", "intent": "lsp.diagnostic_next" }
+  ]
+}

package/templates/editing-mappings.json

@@ -0,0 +1,34 @@
+{
+  "editing.format": {
+    "vscode": "editor.action.formatDocument",
+    "intellij": "ReformatCode"
+  },
+  "editing.comment_toggle": {
+    "vscode": "editor.action.commentLine",
+    "intellij": "CommentByLineComment"
+  },
+  "editing.delete_line": {
+    "vscode": "editor.action.deleteLines",
+    "intellij": "EditorDeleteLine"
+  },
+  "editing.move_line_up": {
+    "vscode": "editor.action.moveLinesUpAction",
+    "intellij": "MoveLineUp"
+  },
+  "editing.move_line_down": {
+    "vscode": "editor.action.moveLinesDownAction",
+    "intellij": "MoveLineDown"
+  },
+  "editing.duplicate_line": {
+    "vscode": "editor.action.copyLinesDownAction",
+    "intellij": "DuplicateLines"
+  },
+  "editing.join_lines": {
+    "vscode": "editor.action.joinLines",
+    "intellij": "JoinLines"
+  },
+  "editing.replace_with_yank": {
+    "vscode": "editor.action.clipboardPasteAction",
+    "intellij": "$Paste"
+  }
+}

package/templates/git-mappings.json

@@ -0,0 +1,38 @@
+{
+  "git.fugitive": {
+    "vscode": "git.openRepository",
+    "intellij": "Vcs.ShowVersionControlIntegration"
+  },
+  "git.status": {
+    "vscode": "git.openChange",
+    "intellij": "ActivateVersionControlToolWindow"
+  },
+  "git.push": {
+    "vscode": "git.push",
+    "intellij": "Vcs.Push"
+  },
+  "git.pull": {
+    "vscode": "git.pull",
+    "intellij": "Vcs.Update"
+  },
+  "git.commit": {
+    "vscode": "git.commit",
+    "intellij": "ActivateCommitToolWindow"
+  },
+  "git.add": {
+    "vscode": "git.stage",
+    "intellij": "Vcs.Add"
+  },
+  "git.blame": {
+    "vscode": "git.openFile",
+    "intellij": "Annotate"
+  },
+  "git.diff": {
+    "vscode": "git.openChange",
+    "intellij": "ShowDiff"
+  },
+  "git.log": {
+    "vscode": "git.viewHistory",
+    "intellij": "Vcs.ShowTabbedFileHistory"
+  }
+}

package/templates/lsp-mappings.json

@@ -0,0 +1,62 @@
+{
+  "lsp.definition": {
+    "vscode": "editor.action.revealDefinition",
+    "intellij": "GotoDeclaration"
+  },
+  "lsp.declaration": {
+    "vscode": "editor.action.goToDeclaration",
+    "intellij": "GotoDeclaration"
+  },
+  "lsp.implementation": {
+    "vscode": "editor.action.goToImplementation",
+    "intellij": "GotoImplementation"
+  },
+  "lsp.references": {
+    "vscode": "editor.action.goToReferences",
+    "intellij": "FindUsages"
+  },
+  "lsp.hover": {
+    "vscode": "editor.action.showHover",
+    "intellij": "QuickImplementations"
+  },
+  "lsp.rename": {
+    "vscode": "editor.action.rename",
+    "intellij": "RenameElement"
+  },
+  "lsp.code_action": {
+    "vscode": "editor.action.quickFix",
+    "intellij": "ShowIntentionActions"
+  },
+  "lsp.format": {
+    "vscode": "editor.action.formatDocument",
+    "intellij": "ReformatCode"
+  },
+  "lsp.signature_help": {
+    "vscode": "editor.action.triggerParameterHints",
+    "intellij": "ParameterInfo"
+  },
+  "lsp.type_definition": {
+    "vscode": "editor.action.goToTypeDefinition",
+    "intellij": "GotoTypeDeclaration"
+  },
+  "lsp.add_workspace_folder": {
+    "vscode": "workbench.action.addRootFolder",
+    "intellij": "AddNewProjectToWorkspace"
+  },
+  "lsp.remove_workspace_folder": {
+    "vscode": "workbench.action.removeRootFolder",
+    "intellij": "RemoveProjectFromWorkspace"
+  },
+  "lsp.diagnostic_next": {
+    "vscode": "editor.action.marker.next",
+    "intellij": "GotoNextError"
+  },
+  "lsp.diagnostic_prev": {
+    "vscode": "editor.action.marker.prev",
+    "intellij": "GotoPreviousError"
+  },
+  "lsp.diagnostic_setloclist": {
+    "vscode": "workbench.actions.view.problems",
+    "intellij": "ViewProblems"
+  }
+}

package/templates/navigation-mappings.json

@@ -0,0 +1,50 @@
+{
+  "navigation.file_explorer": {
+    "vscode": "workbench.action.toggleSidebarVisibility",
+    "intellij": "ActivateProjectToolWindow"
+  },
+  "navigation.find_files": {
+    "vscode": "workbench.action.quickOpen",
+    "intellij": "GotoFile"
+  },
+  "navigation.live_grep": {
+    "vscode": "workbench.action.findInFiles",
+    "intellij": "FindInPath"
+  },
+  "navigation.buffers": {
+    "vscode": "workbench.action.showAllEditors",
+    "intellij": "RecentFiles"
+  },
+  "navigation.recent_files": {
+    "vscode": "workbench.action.openRecent",
+    "intellij": "RecentFiles"
+  },
+  "navigation.help_tags": {
+    "vscode": "workbench.action.openDocumentation",
+    "intellij": "HelpTopics"
+  },
+  "navigation.keymaps": {
+    "vscode": "workbench.action.openGlobalKeybindings",
+    "intellij": "KeymapReference"
+  },
+  "navigation.grep_string": {
+    "vscode": "editor.action.search.selection.wildcard",
+    "intellij": "FindWordAtCaret"
+  },
+  "navigation.buffer_search": {
+    "vscode": "editor.actions.findWithArgs",
+    "intellij": "Find"
+  },
+  "navigation.resume_search": {
+    "vscode": "workbench.action.quickOpenNavigateNext",
+    "intellij": "SearchAgain"
+  },
+  "navigation.diagnostics": {
+    "vscode": "workbench.actions.view.problems",
+    "intellij": "ViewProblems"
+  },
+  "navigation.command_history": {
+    "vscode": "workbench.action.openRecent",
+    "intellij": "GotoAction"
+  }
+}