ep_vim 0.12.3 → 1.0.0

package/README.md

@@ -19,7 +19,8 @@ A vim-mode plugin for [Etherpad](https://etherpad.org/). Adds modal editing with
 - **Line operations** — `dd`, `cc`, `yy`, `D`, `J` (join), `Y` (yank line)
 - **Registers** — `"a`–`"z` named registers for yank/delete/put, `"_` blackhole register
 - **Put** — `p` / `P` with linewise and characterwise register handling
-- **Editing** — `i` `a` `A` `I` (insert/append), `x`, `X`, `r`, `s`, `S`, `C`, `o`, `O`, `~` (toggle case)
+- **Editing** — `i` `a` `A` `I` (insert/append), `x`, `X`, `r`, `R` (replace mode), `s`, `S`, `C`, `o`, `O`, `~` (toggle case)
+- **Case operators** — `gu{motion}`/`gU{motion}` lowercase/uppercase over motion or text object (e.g. `guiw`, `gUap`); `u`/`U` in visual mode lowercase/uppercase selection
 - **Marks** — `m{a-z}` to set, `'{a-z}` / `` `{a-z} `` to jump
 - **Search** — `/` and `?` forward/backward, `n`/`N` repeat, `*`/`#` search word under cursor
 - **Scrolling** — `zz`/`zt`/`zb` center/top/bottom, `Ctrl+d`/`Ctrl+u` half-page, `Ctrl+f`/`Ctrl+b` full-page (requires ctrl keys enabled)
@@ -30,13 +31,21 @@ A vim-mode plugin for [Etherpad](https://etherpad.org/). Adds modal editing with
 - **Toggle** — toolbar button to enable/disable vim mode, persisted in localStorage; settings panel for system clipboard and ctrl key behavior
 
 ## Differences from vi
-The following are not planned, but PRs are welcome.
+No further features are planned, but PRs are welcome. Notable exclusions in the current implementation are:
 
 - **No command line, macros, or globals** 
 - **No visual block mode**  
 - **No indentation operators** — `>>`, `<<`, and `>` / `<` in visual mode
 - **No increment/decrement** — `Ctrl+a` and `Ctrl+x` 
 
+## Rate limiting
+
+If you encounter rate limit errors, Etherpad's commit rate limiter (default: 10 per second) can be adjusted:
+
+```
+COMMIT_RATE_LIMIT_POINTS=100
+```
+
 ## Installation
 
 From your Etherpad directory run

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ep_vim",
-  "version": "0.12.3",
+  "version": "1.0.0",
   "description": "Vim-mode plugin for Etherpad with modal editing, motions, and operators",
   "author": {
     "name": "Seth Rothschild",

package/static/js/index.js

@@ -227,6 +227,17 @@ const applyOperator = (op, start, end, ctx) => {
   }
 };
 
+const applyCaseOp = (op, start, end, ctx) => {
+  const { editorInfo, rep } = ctx;
+  const before =
+    start[0] < end[0] || (start[0] === end[0] && start[1] <= end[1]);
+  const [s, e] = before ? [start, end] : [end, start];
+  const text = getTextInRange(rep, s, e);
+  const transformed = op === "gu" ? text.toLowerCase() : text.toUpperCase();
+  replaceRange(editorInfo, s, e, transformed);
+  moveBlockCursor(editorInfo, s[0], s[1]);
+};
+
 // --- Command tables ---
 const commands = {
   normal: {},
@@ -236,6 +247,7 @@ const commands = {
 
 // --- Registration helpers ---
 const OPERATORS = ["d", "c", "y"];
+const CASE_OPERATORS = ["gu", "gU"];
 
 const resolveTextObject = (key, type, line, lineText, char, rep) => {
   if (key === "p") {
@@ -302,6 +314,17 @@ const registerMotion = (
       }
     };
   }
+  for (const op of CASE_OPERATORS) {
+    commands.normal[op + key] = (ctx) => {
+      state.desiredColumn = null;
+      const pos = getEndPos(ctx);
+      if (pos) {
+        const endChar = inclusive ? pos.char + 1 : pos.char;
+        applyCaseOp(op, [ctx.line, ctx.char], [pos.line, endChar], ctx);
+        recordCommand(op + key, ctx.count);
+      }
+    };
+  }
 };
 
 const parameterized = {};
@@ -360,6 +383,14 @@ const registerTextObject = (obj, getRange) => {
       };
     }
   }
+  for (const op of CASE_OPERATORS) {
+    for (const type of ["i", "a"]) {
+      commands.normal[`${op}${type}${obj}`] = (ctx) => {
+        const range = getRange(ctx, type);
+        if (range) applyCaseOp(op, range.start, range.end, ctx);
+      };
+    }
+  }
 };
 
 const getVisibleLineRange = (rep) => {
@@ -770,6 +801,60 @@ commands["visual-line"]["~"] = (ctx) => {
   moveBlockCursor(ctx.editorInfo, start[0], start[1]);
 };
 
+commands["visual-char"]["u"] = (ctx) => {
+  const [start, end] = getVisualSelection(
+    "char",
+    state.visualAnchor,
+    state.visualCursor,
+    ctx.rep,
+  );
+  const adjustedEnd = [end[0], end[1] + 1];
+  const text = getTextInRange(ctx.rep, start, adjustedEnd);
+  replaceRange(ctx.editorInfo, start, adjustedEnd, text.toLowerCase());
+  state.mode = "normal";
+  moveBlockCursor(ctx.editorInfo, start[0], start[1]);
+};
+
+commands["visual-char"]["U"] = (ctx) => {
+  const [start, end] = getVisualSelection(
+    "char",
+    state.visualAnchor,
+    state.visualCursor,
+    ctx.rep,
+  );
+  const adjustedEnd = [end[0], end[1] + 1];
+  const text = getTextInRange(ctx.rep, start, adjustedEnd);
+  replaceRange(ctx.editorInfo, start, adjustedEnd, text.toUpperCase());
+  state.mode = "normal";
+  moveBlockCursor(ctx.editorInfo, start[0], start[1]);
+};
+
+commands["visual-line"]["u"] = (ctx) => {
+  const [start, end] = getVisualSelection(
+    "line",
+    state.visualAnchor,
+    state.visualCursor,
+    ctx.rep,
+  );
+  const text = getTextInRange(ctx.rep, start, end);
+  replaceRange(ctx.editorInfo, start, end, text.toLowerCase());
+  state.mode = "normal";
+  moveBlockCursor(ctx.editorInfo, start[0], start[1]);
+};
+
+commands["visual-line"]["U"] = (ctx) => {
+  const [start, end] = getVisualSelection(
+    "line",
+    state.visualAnchor,
+    state.visualCursor,
+    ctx.rep,
+  );
+  const text = getTextInRange(ctx.rep, start, end);
+  replaceRange(ctx.editorInfo, start, end, text.toUpperCase());
+  state.mode = "normal";
+  moveBlockCursor(ctx.editorInfo, start[0], start[1]);
+};
+
 commands["visual-char"]["i"] = () => {
   state.pendingKey = "i";
 };
@@ -850,6 +935,12 @@ commands.normal["O"] = ({ editorInfo, line }) => {
   state.mode = "insert";
 };
 
+commands.normal["R"] = ({ editorInfo, line, char }) => {
+  clearEmptyLineCursor();
+  moveCursor(editorInfo, line, char);
+  state.mode = "replace";
+};
+
 // --- Editing commands ---
 
 commands.normal["r"] = () => {
@@ -1324,7 +1415,7 @@ exports.aceKeyEvent = (_hookName, { evt, rep, editorInfo }) => {
       const [vLine, vChar] = state.visualCursor;
       state.mode = "normal";
       moveBlockCursor(editorInfo, vLine, vChar);
-    } else if (state.mode === "insert") {
+    } else if (state.mode === "insert" || state.mode === "replace") {
       state.mode = "normal";
       const [curLine, curChar] = rep.selStart;
       moveBlockCursor(editorInfo, curLine, Math.max(0, curChar - 1));
@@ -1342,6 +1433,40 @@ exports.aceKeyEvent = (_hookName, { evt, rep, editorInfo }) => {
 
   if (state.mode === "insert") return false;
 
+  if (state.mode === "replace") {
+    if (evt.key === "Backspace") {
+      const [curLine, curChar] = rep.selStart;
+      if (curChar > 0) {
+        moveCursor(editorInfo, curLine, curChar - 1);
+      }
+      evt.preventDefault();
+      return true;
+    }
+    if (evt.key.length === 1 && !evt.ctrlKey && !evt.metaKey) {
+      const [curLine, curChar] = rep.selStart;
+      const curLineText = rep.lines.atIndex(curLine).text;
+      if (curChar < curLineText.length) {
+        replaceRange(
+          editorInfo,
+          [curLine, curChar],
+          [curLine, curChar + 1],
+          evt.key,
+        );
+      } else {
+        replaceRange(
+          editorInfo,
+          [curLine, curChar],
+          [curLine, curChar],
+          evt.key,
+        );
+      }
+      moveCursor(editorInfo, curLine, curChar + 1);
+      evt.preventDefault();
+      return true;
+    }
+    return false;
+  }
+
   if (state.searchMode) {
     if (evt.key === "Enter") {
       state.searchMode = false;

package/static/js/visual.test.js

@@ -184,8 +184,8 @@ describe("visual mode", () => {
     commands.normal["V"](ctx);
 
     assert.equal(state.mode, "visual-line");
-    assert.deepEqual(state.visualAnchor, [0, 0]);
-    assert.deepEqual(state.visualCursor, [0, 0]);
+    assert.deepEqual(state.visualAnchor, [0, 2]);
+    assert.deepEqual(state.visualCursor, [0, 2]);
   });
 
   it("y in visual-line yanks lines", () => {